Espressif 32¶

Packages¶

Frameworks¶

Boards¶

Custom CPU Frequency¶

See board_f_cpu option from Project Configuration File platformio.ini

[env:myenv]
; set frequency to 160MHz
board_f_cpu = 160000000L

Custom FLASH Frequency¶

See board_f_flash option from Project Configuration File platformio.ini. Possible values:

• 40000000L (default)

• 80000000L

[env:myenv]
; set frequency to 80MHz
board_f_flash = 80000000L

Custom FLASH Mode¶

Flash chip interface mode. This parameter is stored in the binary image header, along with the flash size and flash frequency. The ROM bootloader in the ESP chip uses the value of these parameters in order to know how to talk to the flash chip.

See board_flash_mode option from Project Configuration File platformio.ini. Possible values:

• qio

• qout

• dio

• dout

[env:myenv]
board_flash_mode = qio

Custom Upload Speed¶

You can set custom upload speed using upload_speed option from Project Configuration File platformio.ini

[env:myenv]
upload_speed = 9600

Over-the-Air (OTA) update¶

There are 2 options:

• Directly specify platformio run --upload-port in command line

platformio run --target upload --upload-port IP_ADDRESS_HERE or mDNS_NAME.local

• Specify upload_port option in Project Configuration File platformio.ini

[env:myenv]
upload_port = IP_ADDRESS_HERE or mDNS_NAME.local

For example,

• platformio run -t upload --upload-port 192.168.0.255

• platformio run -t upload --upload-port myesp8266.local

[env:myenv]
upload_flags = --port=8266

~/.platformio/packages/tool-espotapy/espota.py -h

Usage: espota.py [options]

Transmit image over the air to the esp8266 module with OTA support.

Options:
  -h, --help            show this help message and exit

  Destination:
    -i ESP_IP, --ip=ESP_IP
                        ESP8266 IP Address.
    -p ESP_PORT, --port=ESP_PORT
                        ESP8266 ota Port. Default 8266

  Authentication:
    -a AUTH, --auth=AUTH
                        Set authentication password.

  Image:
    -f FILE, --file=FILE
                        Image file.
    -s, --spiffs        Use this option to transmit a SPIFFS image and do not
                        flash the module.

  Output:
    -d, --debug         Show debug output. And override loglevel with debug.
    -r, --progress      Show progress output. Does not work for ArduinoIDE

Using Arduino Framework with Staging version¶

PlatformIO will install the latest Arduino Core for ESP32 from https://github.com/espressif/arduino-esp32. The Git should be installed in a system. To update Arduino Core to the latest revision, please open PlatformIO IDE and navigate to PIO Home > Platforms > Updates.

1. Please install PlatformIO IDE

2. Initialize a new project, open Project Configuration File platformio.ini and set platform to https://github.com/platformio/platform-espressif32.git#feature/stage. For example,

   [env:esp32dev]
   platform = https://github.com/platformio/platform-espressif32.git#feature/stage
   board = esp32dev
   framework = arduino
   

3. Try to build project

4. If you see build errors, then try to build this project using the same stage with Arduino IDE

5. If it works with Arduino IDE but doesn’t work with PlatformIO, then please file new issue with attached information:

   • test project/files

   • detailed log of build process from Arduino IDE (please copy it from console to https://hastebin.com)

   • detailed log of build process from PlatformIO Build System (please copy it from console to https://hastebin.com)

Articles¶

• Sep 04, 2017 - Dror Gluska - Looking To The IoT Future With PlatformIO And ESP32

• Aug 23, 2017 - 陳亮 - Develop ESP32 With PlatformIO IDE

Examples¶

All project examples are located in PlatformIO repository Examples for Espressif 32 platform.

• Arduino Blink

• Arduino WiFiScan

• ESP-IDF Hello World

• ESP-IDF HTTP Request