Skip to content

Commit

Permalink
Adding detail for the esptool command line
Browse files Browse the repository at this point in the history
Update common/source/docs/common-esp8266-telemetry.rst

Update common/source/docs/common-esp8266-telemetry.rst

Update common/source/docs/common-esp8266-telemetry.rst

Removed useless backslash

Reformat the doc to add this only for Mac. Linux support will be appreciated

Update gitignore for Mac users

Adding bootlaoder information for the board

Co-Authored-By: Henry Wurzburg <hwurzburg@yahoo.com>
  • Loading branch information
ja and Hwurzburg committed Jul 7, 2023
1 parent ff66e44 commit 9b95228
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 2 deletions.
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -92,3 +92,5 @@
/frontend/blog_posts.json
/frontend/news_posts.json

# Mac file
.DS_Store
26 changes: 24 additions & 2 deletions common/source/docs/common-esp8266-telemetry.rst
Original file line number Diff line number Diff line change
Expand Up @@ -66,15 +66,37 @@ If you are using the Adafruit HUZZAH ESP8266 board and are flashing from a Windo
.. image:: ../../../images/esp8266-telemetry-flash.jpg
:target: ../_images/esp8266-telemetry-flash.jpg

- Mac and Linux users should use the `esptool <https://github.com/espressif/esptool>`__
- Mac users should use the `esptool <https://github.com/espressif/esptool>`__

- First, find the COM of your connected device by using the following command line in the terminal. The USB COM port that the ESP8266 is attached will appear something "/dev/ttyusbserial-A600eto2"

.. code-block:: shell
$ ls /dev/tty\.*
- Next, you need to erase all content in your ESP8266. Put the ESP8266 in bootloader mode, and run this command in your terminal window, replacing the *COM* with the ESP8266 COM port you found previously above

.. code-block:: shell
$ esptool.py --baud 921600 --port COM erase_flash
- Finally, flash the board with the correct expected firmware: Put your device in bootloader mode again, and use the following command, again replacing the *COM* with the port you used in the previous command.

.. code-block:: shell
$ esptool.py --baud 921600 --port COM write_flash --flash_mode dio --flash_size detect 0x0 firmware-XXXX.bin
- Linux users should use the `esptool <https://github.com/espressif/esptool>`__

Changing the Wifi SSID and Password
-----------------------------------

- connect from your PC to the wifi access point (initial access point ID is "ArduPilot", and password is "ardupilot")
- open a browser to `192.168.4.1 <http://192.168.4.1/>`__ and a simple web interface will appear like below
- click on the "Setup" link
- set the "AP SSID" and "AP Password" fields (both must between 8 and 16 characters), push the "Save" button and reboot the device
- set the "AP SSID" and "AP Password" fields (both must be between 8 and 16 characters), push the "Save" button and reboot the device

.. image:: ../../../images/esp8266-telemetry-web-setup.png
:target: ../_images/esp8266-telemetry-web-setup.png
Expand Down

0 comments on commit 9b95228

Please sign in to comment.