ESP32 (MicroPython)

1. Download the ESP32 firmware (for more information and support for other boards, see the firmware download page)

2. Download the esptool for Linux or Windows (for more information, see esptool Git repository) 

3. Extract the downloaded archive and move the downloaded firmware into the extracted esptool folder

4. Open the Terminal (Linux) or Command Prompt (Windows) and navigate to the extracted esptool folder

5. Connect ESP32 to the PC and erase the flash:

./esptool --chip esp32 --port <port> erase_flash

NOTE #1: Replace <port> in the command with the actual port where the ESP32 is connected. On Windows, this might be something like COM4 (or something like /dev/ttyUSB0 on Linux).

NOTE #2: If the command is not recognized on Linux, make the tool executable (for all users):

chmod a+x esptool

6. Finally, program the ESP32 firmware:

./esptool --chip esp32 --port <port> --baud 460800 write_flash -z 0x1000 <.bin_file>

1. Download and install PyCharm Community Edition for Windows or Linux

2. Run PyCharm and select Plugins (from welcome screen) or navigate to "File -> Settings -> Plugins"

3. Search for MicroPython plugin and install it

4. Create a New Project and specify desired project location

5. Navigate to "File -> Settings -> Languages & Frameworks -> MicroPython" and enable MicroPython support

6. Select ESP8266 under "Device type"

7. Under "Device path" enter the actual port where the ESP32 is connected - on Windows, this might be something like COM4 (or something like /dev/ttyUSB0 on Linux)

8. Your project is now ready to run MicroPython code - see the examples below

IMPORTANT NOTE: This example assumes that MicroPython environment has already been set up and a new PyCharm project was created (see Setup MicroPython environment).

Step 1: Run the Python script

1. Connect ESP32 to the PC via USB cable

2. Download the main.zip and ble_advertising.zip packages to your PC and extract the packages

3. Copy main.py and ble_advertising.py into the root of your PyCharm project and double-click on it within the PyCharm IDE

4. Right click on main.py, select Run 'Flash main.py' and confirm

NOTE: In case of any missing libraries, just click on "Fix" button and PyCharm will automatically install them.

5. Right click on ble_advertising.py, select Run 'Flash ble_advertising.py' and confirm

6. After the upload, ESP32 should issue a soft-reboot and begin program execution

NOTE: All debug messages during program execution can be observed using any serial console terminal (baud rate 115200 bps).

Step 2: Using GUI-O application to interact with ESP32

1. Open GUI-O application and navigate to "Settings -> Connections -> Bluetooth LE"

2. Tap "Available devices" to search for ESP32 Bluetooth device

3. Tap "BasicBLE" device and wait for successful connection

4. Close "Settings" and tap GUI-O initialize button from the home screen to try the example

IMPORTANT NOTE: This example assumes that MicroPython environment has already been set up and a new PyCharm project was created (see Setup MicroPython environment).

Step 1: Create tokens for MQTT communication

1. Open GUI-O application and select "Add" from the top-right corner of the home screen

2. Select "IoT (Create device)" and add a new device (specifying arbitrary name and optional user name)

3. After adding a device, note the In and Out tokens which are required in the following step (tokens can be shared via email by pressing the "Share" icon)

Step 2: Modify and run the Python script

1. Connect ESP32 to the PC via USB cable

2. Download the main.zip package to your PC and extract the package

3. Copy main.py into the root of your PyCharm project and double-click on it within the PyCharm IDE

4. Set your router name and password

5. Set the In and Out tokens generated in Step 1

6. You can optionally disable SSL/TLS (this will make the connection insecure and is not recommended)

7. Right click on main.py, select Run 'Flash main.py' and confirm

NOTE: In case of any missing libraries, just click on "Fix" button and PyCharm will automatically install them.

8. After the upload, ESP32 should issue a soft-reboot and begin program execution

NOTE: All debug messages during program execution can be observed using any serial console terminal (baud rate 115200 bps).

Step 3: Using GUI-O application to interact with ESP32

1. Open GUI-O application and select "Connect" from the top-left corner of the home screen

2. Tap on the device created in Step 1

3. Wait for successful connection and try the example

IMPORTANT NOTE: This example assumes that MicroPython environment has already been set up and a new PyCharm project was created (see Setup MicroPython environment).

Step 1: Run the Python script

1. Connect ESP32 to the PC via USB cable

2. Download the main.zip package to your PC and extract the package

3. Copy main.py into the root of your PyCharm project and double-click on it within the PyCharm IDE

4. Right click on main.py, select Run 'Flash main.py' and confirm

NOTE: In case of any missing libraries, just click on "Fix" button and PyCharm will automatically install them.

5. After the upload, ESP32 should issue a soft-reboot and begin program execution

NOTE: All debug messages during program execution can be observed using any serial console terminal (baud rate 115200 bps).

Step 2: Using GUI-O application to interact with ESP32

1. Open GUI-O application and navigate to "Settings -> Connections -> Local"

2. Tap "Add device" icon and set the device name, IP (e.g., 192.168.1.123) and port (e.g., 34567) based on your configuration

3. Tap the created device and wait for successful connection

NOTE: Make sure that your Android device is connected to the same WiFi network as ESP32 device.

4. Close "Settings" and tap GUI-O initialize button from the home screen to try the example