Updated PlatformIO (markdown)

Michael Ingraham 2019-08-20 09:52:39 -04:00
parent c3695697e7
commit 2401d5bb3d
1 changed files with 5 additions and 12 deletions

@ -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. Copy all files from the Tasmota release Source code into your platformIO base folder.
### Change IDE parameters ### 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*. 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.
- *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
## Compile Tasmota ## Compile Tasmota
Select ``Build`` from the menu. 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 <Arduino.h>`` at the top. 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 <Arduino.h>`` at the top.
## Upload Tasmota ## 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 ### Put device into programming 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. 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. 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.
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.
### Perform serial upload ### Perform serial upload
Select ``Upload`` from the menu. Select ``Upload`` from the menu.