platformio.ini

[platformio]
default_envs = waveshare_esp32s3_matrix
build_cache_dir = .pio/cache
extra_configs = 
    factory_settings.ini

[env:native]
platform = native
test_framework = unity
test_build_src = no
build_src_filter =
    -<*>
    +<native/**>
build_flags = 
    -DUNIT_TEST 
    -DNATIVE_BUILD
    -std=gnu++17
    -I test/stubs
    -I test/stubs/mocks
    -I lib/framework
    -I lib/framework/security
    -I lib/ArduinoJson/src
lib_deps = 
    throwtheswitch/Unity @ ^2.6.0
lib_compat_mode = off
lib_ignore = 
    WS2812FX
    Adafruit NeoPixel
    matrix_service
    keyboard_service
    airmouse_service
    QMI8658_IMU
    USB_Driver
    esp_http_server
    PsychicHttp
    framework
    NimBLE-Arduino

[env:native_coverage]
extends = env:native
build_flags =
    ${env:native.build_flags}
    -O0
extra_scripts =
    pre:scripts/pio/native_coverage.py

[env:waveshare_esp32s3_matrix]
; PURE ARDUINO FRAMEWORK
platform = https://github.com/pioarduino/platform-espressif32/releases/download/55.03.32/platform-espressif32.zip
framework = arduino
board = waveshare_esp32s3_matrix
board_build.mcu = esp32s3
board_build.f_cpu = 240000000L
lib_ldf_mode = chain
build_src_filter =
    +<*>
    -<native/**>

; Flash size is now handled by board definition (4MB)
; Custom partition: ~3.5 MB app class (3,502,080 B) + 512 KB LittleFS + 64 KB coredump
board_build.partitions = partitions/partitions_s3.csv

; DTR/RTS mode switch:
;   1 = normal PlatformIO Serial Monitor usage. Keep DTR/RTS asserted so
;       TinyUSB CDC is treated as connected and runtime logs continue to flow
;       after the app switches esp_log output to USBSerial.
;   0 = passive monitor mode for deep-sleep / RTC diagnostics. Use this when
;       opening the monitor must NOT toggle line state, but expect post-USB
;       runtime logs to disappear because CDC may remain "disconnected".
monitor_dtr = 1
monitor_rts = 1
; Use 'direct' filter to pass ANSI escape codes through to the terminal
monitor_filters = direct, send_on_enter

lib_deps =
    plageoj/UrlEncode @ ^1.0.1

build_flags =
   ${factory_settings.build_flags}
   -DBOARD_HAS_PSRAM
   ; Exclude unused BusIO (no OLED/I2C display)
   -DADAFRUIT_GFX_NO_BUSIO
   -DCA_USE_LITTLEFS
   -DEMBED_WWW
   -DAPP_NAME=\"MatrixHub\"
   -DAPP_VERSION=\"1.0.1\"
   -DCORE_DEBUG_LEVEL=3
   -DARDUINO_USB_MODE=0
   -DARDUINO_USB_CDC_ON_BOOT=0
   -I src/config

   -DCONFIG_ESP_COEX_SW_COEXIST_ENABLE=1
   ; Force mbedTLS to use PSRAM
   -DCONFIG_MBEDTLS_EXTERNAL_MEM_ALLOC=1
   ; Enable Dynamic RAM usage for mbedTLS (Critical for SvelteKit)
   -DCONFIG_MBEDTLS_DYNAMIC_BUFFER=1
   -DCONFIG_MBEDTLS_DYNAMIC_FREE_PEER_CERT=1
   -DCONFIG_MBEDTLS_ASYMMETRIC_CONTENT_LEN=1
   ; 4KB TLS fragments are enough for HTTPS server/client traffic here and leave
   ; noticeably more heap headroom than the previous 8KB profile.
   -DCONFIG_MBEDTLS_SSL_IN_CONTENT_LEN=4096
   -DCONFIG_MBEDTLS_SSL_OUT_CONTENT_LEN=4096
   ; Allow C++ new to use PSRAM
   -DCONFIG_SPIRAM_USE_MALLOC=1
   ; Enable Telegram Certificate Verification
   -DTELEGRAM_TLS_VERIFY=1
   ; Enable HTTPS Server
   -DCONFIG_ESP_HTTPS_SERVER_ENABLE=1
   ; Link Manual Vendor Component (CSI Gain Control)
   -I src/wifisensing/csi/vendor
   -L src/wifisensing/csi/vendor/lib
   -lesp_csi_gain_ctrl
   ; Optimization: Allow static BSS in PSRAM (e.g. LOG::RingBuffer)
   -DCONFIG_SPIRAM_ALLOW_BSS_SEG_EXTERNAL_MEMORY=1
   ; Optimization: Disable unused USB classes to save DRAM buffers
   -DARDUINO_USB_MSC_ON_BOOT=0
   -DARDUINO_USB_DFU_ON_BOOT=0
   ; Coredump activation
   -DCONFIG_ESP_COREDUMP_ENABLE_TO_FLASH=1
   -DCONFIG_ESP_COREDUMP_DATA_FORMAT_ELF=1
   -DCONFIG_ESP_COREDUMP_CHECKSUM_CRC32=1

build_unflags =
   -DARDUINO_USB_MODE
   -DARDUINO_USB_CDC_ON_BOOT

; S3 Native USB speed
upload_speed = 921600
monitor_speed = 115200

; Native USB upload reset:
;   Touch the app's TinyUSB CDC port at 1200 baud, then wait for the ROM
;   bootloader port. This keeps HID composite mode enabled while avoiding the
;   manual BOOT/RESET dance when the current firmware exposes CDC.
board_upload.use_1200bps_touch = true
board_upload.wait_for_upload_port = true

extra_scripts = 
    pre:scripts/build/build_interface.py
    post:scripts/build/save_elf.py

[env:waveshare_esp32s3_matrix_dev]
extends = env:waveshare_esp32s3_matrix
custom_skip_ui = yes