Skip to content

Commit a97dc38

Browse files
Uploading for the first time docs from @fjansson (#699)
Fixes #688
1 parent 042c6af commit a97dc38

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

docs/install.rst

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,26 @@ Them hit the upload button and your sketch should upload and run.
6565
In some cases the Pico will encounter a hard hang and its USB port will not respond to the auto-reset request. Should this happen, just
6666
follow the initial procedure of holding the BOOTSEL button down while plugging in the Pico to enter the ROM bootloader.
6767

68+
Unable to Upload First Sketch
69+
-----------------------------
70+
If the Arduino IDE has never seen a serial port from a working device (Pico, AVR, or any other serial port), you
71+
may not be able to install using the prior directions because the ``Tools->Port`` menu will be grayed out and
72+
empty. In this case, a special workaround identified by @fjansson in `this issue report <https://github.com/earlephilhower/arduino-pico/issues/688>`_ .
73+
74+
To allow subsequent uploads to automatically work, you will need to manually install a UF2 binary onto the Raspberry Pi Pico one time to
75+
allow it to present a Serial port for the Arduino IDE to detect and save.
76+
77+
Perform the following steps to program a dummy sketch:
78+
79+
1. Open a new, empty sketch (doesn't work with a read-only example sketch).
80+
2. Compile it by pressing the "Verify" checkmark button.
81+
3. Select the ``Sketch -> Export Compiled Binary`` menu. Select a location e.g. the desktop. A folder is created there, containing a file ending in .uf2
82+
4. Copy this file to the Pico's drive, by drag and drop in the Explorer.
83+
84+
The Pico restarts and now now has a serial port. Now the Port menu in Arduino is not gray anymore, select the port there.
85+
After this, normal uploading from the Arduino editor should work.
86+
87+
6888
Windows 7 Driver Notes
6989
----------------------
7090

0 commit comments

Comments
 (0)