badge_2024_arduino

Arduino support code for the Fri3dcamp 2024 badge

Arduino library for the Fri3d Camp 2024 Badge

This repository contains C++ examples for the Fri3d Camp 2024 badge, to be used with the Arduino IDE or other editors like Visual Studio Code that support Arduino libraries (PlatformIO).

If you prefer Python over C++, check out the MicroPython repository

Arduino IDE Settings

The badge carries an ESP32-S3 chip, so we need to install support for the ESP32 boards.

Add ESP32-S3 board to your Arduino IDE

In your Arduino IDE, open File>Preferences
Enter https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json into the “Additional Board Manager URLs” field
Open Tools>Board>Board Manager
Search for the esp32 boards from Espressif Systems and install the version 2.0.14.

Uploading firmware using Arduino IDE

Under Tools>Board>... select ..>ESP32 Arduino>ESP32S3 Dev Module
Under Tools>USB CDC On Boot>... select Enabled to enable the serial port
Under Tools>Flash Size>... select 16 MB
Under Tools>PSRAM>... select OPI PSRAM
Connect the badge to your computer with a USB-C cable
Select the correct USB port under Tools>Port (on a Mac it's along the lines of /dev/cu.usbserial-FFFFFFFF)
Compile and upload the code with Sketch>Upload
Change and mix the examples and have fun!

PlatformIO settings

Following settings can be used. Write following lines of code in platformio.ini

platform = espressif32@^6.3.2
board = esp32-s3-devkitc-1

; Configure options for the N16R8V variant
board_build.arduino.memory_type = qio_opi 
board_build.partitions = default_16MB.csv
board_upload.flash_size = 16MB

framework = arduino
monitor_speed = 115200

build_flags =
    ; N16R8V has PSRAM
   -D BOARD_HAS_PSRAM 
    ; necessary for serial port
   -D ARDUINO_USB_CDC_ON_BOOT=1

Gotchas

Normally the badge automatically goes into bootloader mode. If it doesn't (you might see the error "The chip needs to be in download mode."), you can do it manually: press and hold the start button, press the reset button, then release the start button. You can do this before uploading the firmware at any moment. After uploading press reset again. In case you have a serial monitor, close and open it again.

FedericoBusero / badge_2024_arduino