Skip to content

2. Get Started

Elizabeth Esparza edited this page Nov 20, 2024 · 24 revisions

Bootloader mode

Bootloader mode is useful when the board is not working fine and the firmware must be flashed. Enter bootloader mode by following the button sequence:

  • Press and hold the BOOT button
  • Press and release the RST button
  • Release the BOOT button

How to update Minino firmware

It is recommended to keep your Minino updated to ensure its correct functionality. The firmware can be updated manually with a computer our through OTA updates, please read below the instructions for each method.

Using the console

Important

esptool.py is required.

To update your Minino firmware, follow these steps:

  1. Download the latest firmware from the releases, make sure to download the one that has the build_files.zip file.

  2. Extract the build_files.zip file.

  3. Open a terminal and navigate to the extracted folder. Make sure you see the following files:

bootloader/
minino.bin
partition_table/
  1. Connect your Minino to your computer using a USB cable and enter bootloader mode. Then check the port it is connected to.

    • Windows: check it in the Device Manager under Ports section.
    • Linux: check it with the ls /dev/ttyUSB* or ls /dev/ttyACM* command.
    • macOS: check it with the ls /dev/cu.usb* command.
  2. Run the following command to flash the firmware:

Important

Replace {PORT} with the port your Minino is connected to.

python3 -m esptool --chip esp32c6 -b 460800  --port {PORT} --before default_reset --after hard_reset write_flash --flash_mode dio --flash_size 8MB --flash_freq 80m 0x0 bootloader/bootloader.bin 0xa0000 minino.bin 0x8000 partition_table/partition-table.bin 0x15000 ota_data_initial.bin

Over The Air (OTA) update

  1. Download the latest firmware from the releases, make sure to download the one that has the build_files.zip file.

  2. Extract the build_files.zip file.

  1. In your Minino go to About > Update.

  2. Connect your device to the Wi-Fi access point created by your Minino. The SSID should be minino_ap, and the password Cats1234.

  1. Once connected, open a web browser and write in your web browser search bar: 192.168.0.1. Select the minino.bin file from the extracted folder and then click Update Firmware.

Note

If your web browser redirects you to a non-existing webpage, try using an incognito window, a different web browser or delete the cookies and website data before trying again.

ESP Tool (Web) update

  1. Download the latest firmware from the releases section, make sure to download the one that has the build_files.zip file.

  2. Extract the build_files.zip file.

  3. Open your web browser and go to ESP Tool.

  4. Connect your Minino to your computer using a USB cable and enter bootloader mode.

  5. Once on the page, in the baud rate, select 460800 and click on the “Connect” button.

  1. You will see a pop-up window asking you to select the port where Minino is detected on. Choose the one labeled “USB JTAG/serial debug unit”.

  1. Once Minino is connected, the website will display “Flash Address” fields, add three more fields by clicking the “Add File” button.

  2. Click on “Select File” and look for the files in the build_files folder. You must match the files and addresses according to the following table:

Flash Address File
0x0 bootloader.bin
0xa0000 minino.bin
0x8000 partition-table.bin
0x15000 ota_data_initial.bin
  1. Once you have all the files, click on “Program”. Wait until the process ends, or you read the message “Leaving...” in the output console.

  1. When the program is finished, click on the “Disconnect” button.
  2. Reset Minino.