Skip to content
Marco Massarelli edited this page Aug 9, 2020 · 2 revisions

Quickstart (TinyPICO)

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

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.

Install USB-to-UART bridge drivers

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.

Install esptool.py

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.

Connect your TinyPICO

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.

Download the Ugo-ESP32 firmware

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!):

Flash the TinyPICO

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.

Configure 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.

Credits

A huge thanks to:

Shoutout to everyone working on the libraries used for this project:

License

This software is licensed under the APACHE 2.0 License. See the license file for details.