diff --git a/Esptool.md b/Esptool.md index 4032eed8..525c3c6b 100644 --- a/Esptool.md +++ b/Esptool.md @@ -1,5 +1,7 @@ How to setup and configure Esptool for Tasmota upload. +The information below is for the Python version of esptool - If you want to use the Windows/Linux/OSX(MAC) executable version of esptool (as would be included in Arduino ESP8266 cores) then please go to the [esptool executable (non-python)](https://github.com/arendst/Sonoff-Tasmota/wiki/Esptool/_edit#esptool-executable-windows--linux) section at the bottom. + ## Download Esptool If you do not have an installed copy of Python 2.x or 3.x download and install it from https://www.python.org/. @@ -60,3 +62,32 @@ NOTE1: When the command completes the device is out of firmware upload mode! NOTE2: For a proper device initialization after first firmware upload power down and power up the device. +### ESPTOOL Executable (Windows & Linux) + +The executable version of esptool is maintained by Ivan Grokhotkov and releases are kept at [https://github.com/igrr/esptool-ck/releases](https://github.com/igrr/esptool-ck/releases) + +### Download and Install + +For the purpose of simplicity only the Windows version will be explained here, but the command and parameters are the same for Windows, Linux and MAC/OSX. + +Download the latest release from [https://github.com/igrr/esptool-ck/releases](https://github.com/igrr/esptool-ck/releases) and extract the compressed file to a known location. + +### Download Sonoff-Tasmota + +Download the latest Tasmota release firmware file sonoff.bin from [https://github.com/arendst/Sonoff-Tasmota/releases](https://github.com/arendst/Sonoff-Tasmota/releases) to a known folder (The same folder as where you have the esptool executable will work well for this process to be simpler) + +If you want features from the current development codebase which has not been included in the last release please download sonoff.bin from [http://thehackbox.org/tasmota/](http://thehackbox.org/tasmota/) to a known folder (The same folder as where you have the esptool executable will work well for this process to be simpler) + +The information posted further up in this Wiki for placing the device into bootload / firmware upgrade mode may be followed as this process does not change irrespective whether you use the Python or executable version of esptool. + +Once the device is in firmware upload mode the following commands are recommended for completion of the firmware flashing. + +Erase the flash completely with the following command (substituting the COM port for the one which was used on your computer) + +`esptool -cp COM3 -cb 115200 -ce -v` + +Once the erase is complete, reset your device back into programming mode and then upload the firmware using the following command + +esptool -cp COM3 -cb 115200 -bm dout -cf sonoff.bin -v + +