platformio.ini

; echolocation firmware — M5Stack CoreS3
;
; USB HID keyboard mode (ARDUINO_USB_MODE=0) uses the USB-C port as a composite
; keyboard + serial device. Auto-reset into the bootloader often fails in this mode.
;
; If upload fails with "Failed to connect to ESP32-S3: No serial data received":
;   1. Close the Serial Monitor (it locks the port).
;   2. Long-press the RST button on the bottom until the screen goes blank.
;   3. Run upload again within a few seconds.
;   4. If it still fails, unplug USB, plug back in, repeat step 2, then upload.
;
; Use a data-capable USB-C cable directly to the Mac (not through a hub).
;
; Bluetooth debug build (USB serial only, no HID keyboard to the computer):
;   pio run -e m5stack-cores3-ble-debug -t upload
;   pio device monitor -b 115200

[platformio]
default_envs = m5stack-cores3
src_dir = src
include_dir = include

[env:m5stack-cores3]
platform = espressif32@6.9.0
board = m5stack-cores3
framework = arduino
upload_speed = 921600
monitor_speed = 115200
board_upload.use_1200bps_touch = true
board_upload.wait_for_upload_port = true
build_unflags =
    -DARDUINO_USB_MODE=1
build_flags =
    -DESP32S3
    -DBOARD_HAS_PSRAM
    -DARDUINO_USB_MODE=0
    -DARDUINO_USB_CDC_ON_BOOT=1
    -DARDUINO_M5STACK_CORES3=1
    -DLV_CONF_PATH='"${platformio.include_dir}/lv_conf.h"'
lib_deps =
    m5stack/M5Unified@^0.2.2
    m5stack/M5GFX@^0.2.2
    lvgl/lvgl@^9.1.0
    https://github.com/felis/USB_Host_Shield_2.0.git

[env:m5stack-cores3-ble-debug]
extends = env:m5stack-cores3
build_unflags =
    -DARDUINO_USB_MODE=0
build_flags =
    ${env:m5stack-cores3.build_flags}
    -DARDUINO_USB_MODE=1
    -DECHOLOCATION_BLE_DEBUG=1