Skip to content

Commit 3fefbd7

Browse files
Add note about needing 0.4 esp8266fs uploader
Update the docs to point to the later version of the 8266 sketch data uploader and inform existing users of the need to upgrade. Fixes esp8266#5845
1 parent 882d5ba commit 3fefbd7

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed

doc/filesystem.rst

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,11 +107,18 @@ Uploading files to file system
107107
menu item to *Tools* menu for uploading the contents of sketch data
108108
directory into ESP8266 flash file system.
109109

110-
- Download the tool: https://github.com/esp8266/arduino-esp8266fs-plugin/releases/download/0.3.0/ESP8266FS-0.3.0.zip.
110+
**Warning**: Due to the move from the obsolete esptool-ck.exe to the
111+
supported esptool.py upload tool, upgraders from pre 2.5.1 will need to
112+
update the ESP8266FS tool referenced below to 0.4.0 or later. Prior versions
113+
will fail with a "esptool not found" error because they don't know how to
114+
use esptool.py.
115+
116+
- Download the tool: https://github.com/esp8266/arduino-esp8266fs-plugin/releases/download/0.4.0/ESP8266FS-0.4.0.zip
111117
- In your Arduino sketchbook directory, create ``tools`` directory if
112118
it doesn't exist yet
113119
- Unpack the tool into ``tools`` directory (the path will look like
114120
``<home_dir>/Arduino/tools/ESP8266FS/tool/esp8266fs.jar``)
121+
If upgrading, overwrite the existing JAR file with the newer version.
115122
- Restart Arduino IDE
116123
- Open a sketch (or create a new one and save it)
117124
- Go to sketch directory (choose Sketch > Show Sketch Folder)

0 commit comments

Comments
 (0)