platformio.ini

; PlatformIO Project Configuration File for ESP32-RAKFlasher
; Remote firmware management system for RAK4631 (nRF52840) modules
;
; Build: pio run
; Upload: pio run --target upload
; Upload filesystem: pio run --target uploadfs
; Monitor: pio device monitor

[env:seeed_xiao_esp32s3]
platform = espressif32
board = seeed_xiao_esp32s3
framework = arduino

; Serial monitor settings
monitor_speed = 115200
monitor_filters = esp32_exception_decoder

; Filesystem configuration
board_build.filesystem = littlefs
board_build.partitions = partitions_8mb.csv

; Flash settings for 8MB flash
board_build.flash_mode = qio
board_build.flash_size = 8MB

; Build flags
build_flags =
    -DCORE_DEBUG_LEVEL=3
    -DARDUINOJSON_USE_LONG_LONG=1
    -DARDUINOJSON_ENABLE_STD_STRING=1
    -DPB_ENABLE_MALLOC=1
    -DPB_FIELD_32BIT=1
    -DBOARD_HAS_PSRAM
    -mfix-esp32-psram-cache-issue

; Exclude built-in WebServer to avoid conflicts with ESPAsyncWebServer
lib_ignore =
    WebServer

; Library dependencies
; Version pinning ensures stability and documented compatibility
lib_deps =
    # ESPAsyncWebServer for non-blocking web server and WebSocket support
    # Repository: https://github.com/esp32async/ESPAsyncWebServer
    https://github.com/mathieucarbou/ESPAsyncWebServer.git#v3.3.15

    # ArduinoJson v7 for efficient JSON parsing/serialization
    # Breaking changes from v6: new API, see https://arduinojson.org/v7/
    bblanchon/ArduinoJson@^7.2.0

    # Nanopb for lightweight Protocol Buffers (Meshtastic communication)
    # Repository: https://github.com/nanopb/nanopb
    nanopb/Nanopb@^0.4.9

; Pre-build scripts:
;   version_increment.py — auto-increment build number
;   embed_webui.py — embed web UI files as gzipped PROGMEM arrays
extra_scripts =
    pre:tools/version_increment.py
    pre:tools/embed_webui.py

; Upload settings
upload_speed = 921600