@@ -114,19 +114,17 @@ Several pico-ice-sdk [examples](https://github.com/tinyvision-ai-inc/pico-ice-sd
114114On Windows, you can run these examples from the cygwin environment,
115115under which you can navigate to the example repositories and try them.
116116
117- If you used `apio` to install OSS CAD Suite,
118- then you can use the APIO install directory as well:
119- `export OSS_CAD_SUITE="$HOME/.apio/packages/tools-oss-cad-suite/"`.
120117
121118
122- ## F.A.Q.
119+ You can access the utilities directly from a shell environment after adding the
120+ `$OSS_CAD_SUITE` to the `$PATH`.
123121
124- ### Q: Why is specifying the OSS_CAD_SUITE directory needed?
122+ If you used `apio` to install OSS CAD Suite:
125123
126- APIO installs OSS-CAD-Suite, but it is not possible to directly call the commands from the shell environment
127- so it is needed to provide the full path to the binaries to execute them.
128-
129- With OSS-CAD-Suite, there is a script to source in the current shell environment to avoid this, but if the user forgets, then nothing works.
124+ ```
125+ export OSS_CAD_SUITE="$HOME/.apio/packages/tools-oss-cad-suite"
126+ export PATH="$PATH:$OSS_CAD_SUITE/bin"
127+ ```
130128
131129
132130## Troubleshooting
@@ -159,6 +157,33 @@ This error might occur when a communication error occurs.
159157- On Linux operating system, it might need to be allowed with an udev rule,
160158 or `dfu-util` might need to be run as super user.
161159
160+ To create an udev rule, add a file named `/etc/udev/rules.d/99-pico-ice.rules` with this content:
161+
162+ ```
163+ SUBSYSTEM=="usb", ATTRS{idVendor}=="1209", ATTRS{idProduct}=="b1c0", MODE="0666"
164+ ```
165+
166+ Then reboot or run the following commands:
167+
168+ ```
169+ sudo udevadm control --reload-rules
170+ sudo udevadm trigger
171+ ```
172+
173+ ### dfu-util has multiple devices
174+
175+ For devices with multiple DFU devices connected, the `--device 1209:b1c0` flag is needed:
176+
177+ ```
178+ dfu-util --reset --alt 0 --download rgb_blink.bin --device 1209: b1c0
179+ ```
180+
181+ Alternatively, the `dfu-util --list` result will allow selecting a device per number:
182+
183+ ```
184+ dfu-util --reset --alt 0 --download rgb_blink.bin --devnum 0
185+ ```
186+
162187### dfu-util is stuck while uploading before anything could be sent
163188
164189This could be due that there was no response from the flash chip, and the RP2040 is endlessy waiting the write confirmation.
0 commit comments