diff --git a/Flashing.md b/Flashing.md index 4bde92ee..29f02638 100644 --- a/Flashing.md +++ b/Flashing.md @@ -5,29 +5,35 @@ Once you have followed [Hardware preparation](Hardware-preparation), your device Optionally, you may want to back up the device manufacturer's firmware. To do so, you must use esptool. Refer to the [instructions below](#optional-backup-firmware). # Tasmota PyFlasher -NodeMCU PyFlasher is an easy to use GUI flasher based on [esptool.py](https://github.com/espressif/esptool) and is our recommended tool for a quick and easy flash. + +Tasmota PyFlasher is specifically designed for use with Tasmota binaries with an easy to use GUI. It is based on [NodeMcu Pyflasher](https://github.com/marcelstoer/nodemcu-pyflasher) and [esptool.py](https://github.com/espressif/esptool). -Download the [latest release](https://github.com/tasmota/tasmota-pyflasher/releases) for your platform (Windows or Mac). Double click the downloaded file and it'll start, no installation required. +Download the [latest release](https://github.com/tasmota/tasmota-pyflasher/releases) for your platform (currently only Windows). Double click the downloaded file and it'll start, no installation required. Simple and fast... -![NodeMCU PyFlasher Screenshot](https://user-images.githubusercontent.com/5904370/55689926-2a820100-598b-11e9-8153-9a327b216d0d.png) +![Tasmota PyFlasher UI](https://user-images.githubusercontent.com/5904370/68957676-d2399a00-07ca-11ea-9a21-3ef2fb7d4349.png) -1. Select **Serial port** (COM# port) where your serial-to-USB or NodeMCU/D1 mini is connected. Leave on auto-select if not sure. -2. **Browse** to the binary you downloaded. -3. Set **Baud rate** to **115200** and **Flash mode** to **DOUT**. **Erase flash** to **yes, wipes all data** if it is the first time flashing Tasmota on the device or you're experiencing issues with the existing flash. If you're upgrading Tasmota set to **no**. -4. Click **Flash NodeMCU** (yes, slightly misleading) and watch the progress in the dialog window. +1. Connect your device to the serial-to-USB adapter or plug in NodeMCU/D1 mini. +2. Select the correct **Serial port** (COM# port). Leave on auto-select if not sure. +3. **Browse** to the Tasmota firmware binary you downloaded or compiled. -If the flash was successful the window will display: +:red_circle: Set **Erase flash** to **yes, wipe all data!!!** if it is the first time flashing Tasmota on the device or you're experiencing issues with the existing flash and need to do a full erase. +**If you're upgrading an already flashed Tasmota and wish to keep your settings, set it to *no*.** + +4. Click **Flash Tasmota** and wait until done. + +If the flash was successful the _Console_ window will display: ![Flash succeeded](https://user-images.githubusercontent.com/5904370/55690010-489c3100-598c-11e9-8135-e44469037e11.png) -Unplug your serial programming adapter or your device and plug it back in or connect to another power source. Your device is now ready for [Initial configuration](Initial-Configuration). **For proper device initialization after the firmware upload completes, power down and power up the device.** +Unplug your serial programming adapter or device and plug it back in or connect to another power source. Your device is now ready for [Initial configuration](Initial-Configuration). **For proper device initialization after the firmware upload completes, power down and power up the device.** ### Common mistakes Message `COM# failed to connect: Failed to connect to Espressif device: Timed out waiting for packet header` means your device is not connected (recheck COM port number and USB cable) or not in flash mode (retry flash mode procedure for your device). Sometimes a "successful" flash will still result in a device that does not function as expected. If your device exhibits strange behaviors, we recommend that you use esptool.py to erase the flash as described below. And, if you are using esptool.py for erasing, you might as well upload the firmware that way as well. But definitely erase using esptool.py. -# Esptool.py + +# esptool.py Esptool is the official tool for flashing ESP8266 chips and is the most reliable.