diff --git a/PlatformIO.md b/PlatformIO.md index e956a2fb..df7cc8ad 100644 --- a/PlatformIO.md +++ b/PlatformIO.md @@ -14,10 +14,7 @@ Download the latest Tasmota release Source code from https://github.com/arendst/ Copy all files from the Tasmota release Source code into your platformIO base folder. ### Change IDE parameters -The default environment configuration generates multiple firmware variants. To build and/or flash exactly one of these, uncomment one of the *env_default* lines in file *platformio.ini*. -- *sonoff.bin* - the default firmware for all devices -- *sonoff-minimal.bin* - is interim firmware to be used when the above firmware images become too big to fit as OTA or web upload; installing this one first and THEN uploading the desired *sonoff.bin* allows for future firmware size growth over the OTA file limit of 1/2 flash size. -- *sonoff-sensors* - is a version with most common used sensors enabled +The default environment configuration can be used to easily generate Tasmota firmware variants (sonoff, sensors, display, etc.). If you're not sure which binary is the right one for you, consult the [builds table](Builds) or just start with [sonoff.bin](http://thehackbox.org/tasmota/release/sonoff.bin). To build and/or flash exactly one of these, uncomment (i.e., remove the leading `;`) the *env_default* line for the variant you need. To compile more than one binary variant, uncomment all of the desired *env_default* lines in the *platformio.ini* file. ## Compile Tasmota Select ``Build`` from the menu. @@ -25,16 +22,12 @@ Select ``Build`` from the menu. Note that where the Arduino IDE automatically includes the main Arduino library, you may need to manually do this when using PlatformIO. In your main ``.cpp`` file, add ``#include `` at the top. ## Upload Tasmota -PlatformIO uses the serial interface to upload the firmware to your device. On Windows these interfaces are named COM1, COM2 etc. On Linux these interfaces are called /dev/ttyUSB0, /dev/ttyUSB1 etc. +PlatformIO uses the serial interface to upload the firmware to your device. On Windows these interfaces are named COM ports (COM1, COM2, etc.). On Linux these interfaces are named [TTY ports](https://unix.stackexchange.com/questions/144029/command-to-determine-ports-of-a-device-like-dev-ttyusb0) (e.g., /dev/ttyUSB0, /dev/ttyUSB1, etc.). -### Put device in firmware upload mode -When performing a firmware upload do **not connect the device to AC** but use the power supply provided by your (FTDI type) serial interface. +### Put device into programming mode +When performing a firmware upload do **not connect the device to AC**. Use a 3.3v DC power supply such as that provided by your serial programming adapter. -Put the device in firmware upload mode by grounding pin GPIO00 while applying power. - -Grounding pin GPIO00 can often be achieved by pressing button 1 on the Sonoff device or using a wire between GPIO00 and Gnd if the button is not available. Deviations may apply. - -Connect the serial interface of your PC to the device while GPIO00 to Gnd. +Put the device in programming mode by grounding pin GPIO0 and then applying power (e.g., connecting your computer to the serial adapter). Grounding pin GPIO0 can often be achieved by pressing the button on the device or using a wire between GPIO0 and GND if the button is not available. Deviations may apply. ### Perform serial upload Select ``Upload`` from the menu.