platformio.ini

; Escape Hatch — minimal X3/X4 SD-card firmware flasher.
;
; Machine-specific SDK symlink paths live in platformio.local.ini (which
; overrides [base].lib_deps), exactly like the crosspoint-reader project. The
; relative symlink:// paths below assume a sibling/submodule freeink-sdk
; checkout; the local override points them at a working copy you iterate on.

[platformio]
default_envs = default
build_cache_dir = .cache
extra_configs = platformio.local.ini

[base]
platform = https://github.com/pioarduino/platform-espressif32/releases/download/55.03.37/platform-espressif32.zip
board = esp32-c3-devkitm-1
framework = arduino
monitor_speed = 115200
upload_speed = 921600

; Match the device's existing 16MB / dual-OTA layout so the stock bootloader and
; otadata pick up whatever we flash. Upload lands the app at the ota_0 offset.
board_upload.flash_size = 16MB
board_upload.maximum_size = 16777216
board_upload.offset_address = 0x10000
board_build.flash_mode = dio
board_build.flash_size = 16MB
board_build.partitions = partitions.csv

build_flags =
  -DARDUINO_USB_MODE=1
  -DARDUINO_USB_CDC_ON_BOOT=1
  -DEINK_DISPLAY_SINGLE_BUFFER_MODE=1
  -std=gnu++2a
  -fno-exceptions

build_unflags =
  -std=gnu++11
  -fexceptions

; Default (committed) dependency paths. platformio.local.ini replaces this whole
; block with absolute symlinks to a locally-checked-out freeink-sdk.
lib_deps =
  BoardConfig=symlink://freeink-sdk/libs/hardware/BoardConfig
  EInkDisplay=symlink://freeink-sdk/libs/display/FreeInkDisplay
  InputManager=symlink://freeink-sdk/libs/hardware/InputManager
  SDCardManager=symlink://freeink-sdk/libs/hardware/SDCardManager
  PowerManager=symlink://freeink-sdk/libs/hardware/PowerManager
  BatteryMonitor=symlink://freeink-sdk/libs/hardware/BatteryMonitor
  FreeInkUI=symlink://freeink-sdk/libs/ui/FreeInkUI
  XteinkDetect=symlink://freeink-sdk/libs/hardware/XteinkDetect
  RecoveryBoot=symlink://freeink-sdk/libs/hardware/RecoveryBoot

; ESP32-C3 dual-device binary: X3 + X4 compiled in, chosen at runtime by the
; XteinkDetect I2C fingerprint.
[env:default]
extends = base
build_flags =
  ${base.build_flags}
  -DFREEINK_DEVICE_X4=1
  -DFREEINK_DEVICE_X3=1

; ESP32-S3 Xteink X4 Pro: single-device binary (no runtime C3 detect). Flags
; match crosspoint-reader's [env:x4pro] so the same SDK capabilities light up:
; FREEINK_DEVICE_X4PRO auto-enables CAP_TOUCH (GT911, incl. the capacitive
; Home key) and CAP_FRONTLIGHT; SD is native SDMMC via SdFat's block-device
; interface; FREEINK_FRONTLIGHT_LS keeps the frontlight PWM alive in light
; sleep (inert here until a frontlight consumer is added, kept for parity).
[env:x4pro]
extends = base
board = esp32-s3-devkitc1-n16r8
board_build.mcu = esp32s3
build_flags =
  ${base.build_flags}
  -DBOARD_HAS_PSRAM
  -DFREEINK_DEVICE_X4PRO=1
  -DUSE_BLOCK_DEVICE_INTERFACE=1
  -DFREEINK_FRONTLIGHT_LS