diff --git a/docs/boards/asterix/index.md b/docs/boards/asterix/index.md index eb7978dde..09dd86ba0 100644 --- a/docs/boards/asterix/index.md +++ b/docs/boards/asterix/index.md @@ -53,10 +53,69 @@ Do not use any adapter that does not operate at 1.8V, or there is a **risk of da - L: connected - R: disconnected +### Core B2B v2 Setup -### Usage and tips +Before plugging in the B2B board, make sure that your user is added to the `dialout` and `plugdev` groups. + +To check your groups, enter the following command: +```bash +groups ${USER} +``` + +If the `dialout` or `plugdev` group is missing, add your user to a group using this command (replace `{your_group}` by the group name, either `dialout` or `plugdev`): +```bash +sudo gpasswd --add ${USER} {your_group} +``` + +Logout then log back in to your user session. + +Create a file named `60-picotool.rules`and copy the following content: +``` +# Copy this file to /etc/udev/rules.d/ +# You can reload the udev rules with "udevadm control --reload" + +SUBSYSTEM=="usb", \ + ATTRS{idVendor}=="2e8a", \ + ATTRS{idProduct}=="0003", \ + TAG+="uaccess", \ + MODE="660", \ + GROUP="plugdev" +SUBSYSTEM=="usb", \ + ATTRS{idVendor}=="2e8a", \ + ATTRS{idProduct}=="0009", \ + TAG+="uaccess", \ + MODE="660", \ + GROUP="plugdev" +SUBSYSTEM=="usb", \ + ATTRS{idVendor}=="2e8a", \ + ATTRS{idProduct}=="000a", \ + TAG+="uaccess", \ + MODE="660", \ + GROUP="plugdev" +SUBSYSTEM=="usb", \ + ATTRS{idVendor}=="2e8a", \ + ATTRS{idProduct}=="000c", \ + TAG+="uaccess", \ + MODE="660", \ + GROUP="plugdev" +SUBSYSTEM=="usb", \ + ATTRS{idVendor}=="2e8a", \ + ATTRS{idProduct}=="000f", \ + TAG+="uaccess", \ + MODE="660", \ + GROUP="plugdev" +``` -After receiving your Firmware Dev Kit, please update the firmware on the board to the [latest release](https://github.com/coredevices/asterix_b2b2_fw/releases). +Move this file into the folder located at `/etc/udev/rules.d/`. Replace the file if it already exists. + +Enter the following command to reload the rules: +```bash +udevadm control --reload && udevadm trigger +``` + +Do not plug the board in just yet. Update the board firmware by following the procedure described [here](https://github.com/coredevices/asterix_b2b2_fw/releases) + +### Usage and tips When using the built-in programmer and USB-UART converter, make sure to place switches (3) and (4) to the right, as shown in the picture below. It is also recommended to provide VUSB while programming so that the watch is always programmable regardless of the battery level. @@ -69,6 +128,9 @@ Correct orientation of the switches when using built-in programmer, USB-UART con - Please make sure to connect the B2Bv2 board in the **EXACT** way detailed in this document. If you connect it in any other orientation, your watch will be rendered unusable. You have been warned. +- You can check the path of the serial adapter by reading the output of `dmesg`. + There should be a line stating the `tty*` allocated, most likely stating `ttyACM0`. + In that case, you should use `/dev/ttyACM0`. - If you are having trouble programming your watch, check the orientation of the switches. Sometimes they accidentally get switched to the wrong side during shipping. - If your serial console is showing text but not accepting input, then your connector is likely not seated correctly.