-
Notifications
You must be signed in to change notification settings - Fork 2
Home
If you just want to flash your TinyPICO with the latest stable Ugo-ESP32 firmware follow the instructions below. Make sure to check the other wiki sections if you want to set up your dev environment to build Ugo-ESP32 from source.
Before you start, you need to make sure your system has Python >= 3.4 installed, which should come packaged with the pip
package manager. Running python --version
and pip --version
in your terminal / shell of choice should be enough to confirm.
In order for your system to recognize and talk to the TinyPICO board, you need to install the correct USB-to-UART bridge drivers. These drivers are maintained by Silicon Labs, so head to their downloads page and obtain the VCP that's right for your operating system. Once you have installed your drivers, it's never a bad idea to restart your system.
In order to flash a binary image to your TinyPICO, you will need esptool.py
. The latest stable esptool.py
release can be installed from pypi via pip
:
$ pip install esptool
With some Python installations this may not work and you'll receive an error, try python -m pip install esptool
.
After installing, you will have esptool.py
installed into the default Python executables directory and you should be able to run it with the command esptool.py
.
It might sound obvious, but this is the time to connect your TinyPICO to your system with a USB cable. To simplify the usage of esptool.py
, make sure you only have one TinyPICO or ESP-based board connected to your system, and the tool will recognize it automatically after cycling through all the connected devices.
There are two files that are necessary for Ugo-ESP32. One is firmware.bin
, which contains the code for your TinyPICO, and one is spiffs.bin
, which contains the files required by the code (e.g. the web pages). Make sure to get both.
You can find the latest stable firmware versions at the links below:
If you like to live dangerously, you can find the latest build at the following links (not recommended!):
Now you are ready to flash the files you just downloaded. The command below uses esptool.py
to do just that:
$ esptool.py write_flash 0x00001000 firmware.bin
$ esptool.py write_flash 0x00290000 spiffs.bin
WARNING: flashing the spiffs.bin
image will overwrite whatever configuration you already had for your Ugo-ESP32.
You are done! You can now press any button, and the Ugo-ESP32 should enter configuration mode.
Just connect to the WiFi network created by your Ugo-ESP32, e.g. Ugo_123ABC
and fill in your network details and other options.
A huge thanks to:
- @mcer12 for the original Hugo-ESP8266 concept
Shoutout to everyone working on the libraries used for this project:
This software is licensed under the APACHE 2.0 License. See the license file for details.