mirrors
/
Tasmota
mirror of https://github.com/arendst/Tasmota.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Tasmota-PyFlasher

blakadder 2019-11-15 17:25:49 +01:00
parent 68cbb4e8d1
commit 0759fa72ec
1 changed files with 16 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
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). 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 # 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. <img src="https://raw.githubusercontent.com/tasmota/tasmota-pyflasher/v1/images/splash.png" width=300 align=right></img>
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. 1. Connect your device to the serial-to-USB adapter or plug in NodeMCU/D1 mini.
2. **Browse** to the binary you downloaded. 2. Select the correct **Serial port** (COM# port). Leave on auto-select if not sure.
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**. 3. **Browse** to the Tasmota firmware binary you downloaded or compiled.
4. Click **Flash NodeMCU** (yes, slightly misleading) and watch the progress in the dialog window.
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) ![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 ### 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). 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. 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.
# <a id="esptool"></a>Esptool.py <a id="esptool"></a>
# esptool.py
Esptool is the official tool for flashing ESP8266 chips and is the most reliable. Esptool is the official tool for flashing ESP8266 chips and is the most reliable.