Skip to content

Commit cf22606

Browse files
committed
Document special upload procedure in UNO R4 WiFi HID tutorial
When an UNO R4 WiFi board is running a sketch that uses the HID capabilities, the port address changes during the upload. Since this change does not occur under other conditions, the platform is not configured to handle such a change. This causes uploads via the standard procedure to fail under these conditions. Since adjusting the configuration to allow reliable uploads under any conditions would have harmful side effects, the decision was made to leave the configuration as it is now. The upload can be accomplished reliably if the user performs a double reset before uploading, but this fact was not documented in the tutorial about the board's HID capabilities. The missing documentation is hereby added to the tutorial.
1 parent 02ecd75 commit cf22606

File tree

1 file changed

+12
-0
lines changed
  • content/hardware/02.hero/boards/uno-r4-wifi/tutorials/usb-hid

1 file changed

+12
-0
lines changed

Diff for: content/hardware/02.hero/boards/uno-r4-wifi/tutorials/usb-hid/usb-hid.md

+12
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,18 @@ To turn your board into an HID, you can use the **keyboard/mouse** API that is b
3636
- [Keyboard](https://www.arduino.cc/reference/en/language/functions/usb/keyboard/)
3737
- [Mouse](https://www.arduino.cc/reference/en/language/functions/usb/mouse/)
3838

39+
## Sketch Upload Interference
40+
41+
As a consequence of the multi-processor design of the UNO R4 WiFi board, uploads may fail with a "`No device found on ...`" error when the board is running a sketch that uses the HID capabilities.
42+
43+
For this reason, you should use the following procedure to upload under these conditions:
44+
45+
**1.** Press and release the button marked "**RESET**" on the board quickly twice. The LED marked "**L**" on the board should now be pulsing.
46+
47+
**2.** Select the port of the board from the menu in Arduino IDE. The port might have changed after the previous step, so make sure to verify that it is selected.
48+
49+
**3.** Upload your sketch as usual.
50+
3951
## Keyboard
4052

4153
To use keyboard functionalities, we need to include the library at the top of our sketch. The Keyboard class contains several methods that are useful to emulate a keyboard.

0 commit comments

Comments
 (0)