platformio.ini

; reticulum-lora-repeater
; ------------------------
; One env per supported hardware target. Each env references a single
; header at include/board/<name>.h via `-include`, so shared source
; files never contain `#if BOARD_MODEL == ...` chains. Adding a new
; board = create a header + add an env block, nothing else.
;
; v0.1 ships Faketec and RAK4631. xiao_nrf52840 is sketched out as
; a commented-out env block + stub header to prove the pattern;
; it doesn't build yet.

[platformio]
default_envs = Faketec

[env]
framework = arduino
monitor_speed = 115200
lib_ldf_mode = deep
build_unflags =
    -std=gnu++11
build_flags =
    -std=gnu++17
    -Wall
    -Wno-unknown-pragmas
    -Iinclude
    -Isrc

; ---------------------------------------------------------------------
; Faketec — Nice!Nano-style nRF52840 ProMicro clone + Ebyte E22-900M30S
; ---------------------------------------------------------------------
; Verified working hardware reference: see the sibling project
; `microReticulum_Faketec_Repeater`. Pin map + TCXO + VEXT quirks
; captured in include/board/Faketec.h.
[env:Faketec]
platform = nordicnrf52
board = nrf52840_dk_adafruit
board_build.partitions = no_ota.csv
board_build.filesystem = littlefs
upload_protocol = nrfutil
extra_scripts = pre:scripts/pre_build.py
build_unflags =
    ${env.build_unflags}
    -fno-exceptions
    -fno-rtti
    --specs=nano.specs
build_flags =
    ${env.build_flags}
    -fexceptions
    -frtti
    --specs=nosys.specs
    -DBOARD_MODEL=BOARD_Faketec
    -include include/board/Faketec.h
    ;
    ; --- Reticulum feature flags (consumed by microReticulum library) ---
    ; RNS_USE_FS enables filesystem I/O inside the RNS library (identity,
    ; announce cache, config) — without it the library silently skips
    ; every file op and transport_identity never persists.
    ; RNS_PERSIST_PATHS turns on path_store write-back so learned routes
    ; survive reboots via microStore segment files.
    -DRNS_USE_FS
    -DRNS_PERSIST_PATHS
    ;
    ; --- Memory tuning (see docs/TROUBLESHOOTING.md) ---
    -DRNS_DEFAULT_ALLOCATOR=RNS_HEAP_POOL_ALLOCATOR
    -DRNS_HEAP_POOL_BUFFER_SIZE=81920           ; 80 KB (reduced from 96 KB for BLE)
    -DUSTORE_USE_INTERNALFS
    -DURTN_PATH_TABLE_MAX_RECS=100              ; consumed at runtime
    -DRNS_PATH_TABLE_SEGMENT_SIZE=8192          ; 6 KB segments
    -DRNS_PATH_TABLE_SEGMENT_COUNT=8            ; 24 KB ring total
lib_deps =
    ${env.lib_deps}
    jgromes/RadioLib @ ^7.3.0
    https://github.com/attermann/microStore.git#e18b827939f44ad500e49d810b62bb627439726b
    https://github.com/attermann/microReticulum.git#5fbdbf37efdbb7b64d447fef0317e7d215986421

; ---------------------------------------------------------------------
; RAK4631 — WisBlock Core nRF52840 + integrated SX1262
; ---------------------------------------------------------------------
; Pin map + TCXO + VEXT quirks captured in include/board/rak4631.h.
; Uses the same pca10056 pin-numbering convention as Faketec
; (board = nrf52840_dk_adafruit) so both headers can share a common
; convention and Radio.cpp stays board-agnostic.
;
; HARDWARE VALIDATION PENDING: no RAK4631 on the bench when this env
; landed. First user to flash should verify RX end-to-end and
; recalibrate batt_mult via the webflasher's CALIBRATE BATTERY flow.
[env:RAK4631]
platform = nordicnrf52
board = nrf52840_dk_adafruit
board_build.partitions = no_ota.csv
board_build.filesystem = littlefs
upload_protocol = nrfutil
extra_scripts = pre:scripts/pre_build.py
build_unflags =
    ${env.build_unflags}
    -fno-exceptions
    -fno-rtti
    --specs=nano.specs
build_flags =
    ${env.build_flags}
    -fexceptions
    -frtti
    --specs=nosys.specs
    -DBOARD_MODEL=BOARD_RAK4631
    -include include/board/rak4631.h
    ;
    ; --- Reticulum feature flags (same as Faketec) ---
    -DRNS_USE_FS
    -DRNS_PERSIST_PATHS
    ;
    ; --- Memory tuning (same as Faketec — both boards are nRF52840 with
    ;     256 KB RAM / 1 MB flash, identical budget) ---
    -DRNS_DEFAULT_ALLOCATOR=RNS_HEAP_POOL_ALLOCATOR
    -DRNS_HEAP_POOL_BUFFER_SIZE=98304
    -DUSTORE_USE_INTERNALFS
    -DURTN_PATH_TABLE_MAX_RECS=100
    -DRNS_PATH_TABLE_SEGMENT_SIZE=8192
    -DRNS_PATH_TABLE_SEGMENT_COUNT=8
lib_deps =
    ${env.lib_deps}
    jgromes/RadioLib @ ^7.3.0
    https://github.com/attermann/microStore.git#e18b827939f44ad500e49d810b62bb627439726b
    https://github.com/attermann/microReticulum.git#5fbdbf37efdbb7b64d447fef0317e7d215986421

; ---------------------------------------------------------------------
; XIAO_nRF52840 — Seeed XIAO nRF52840 Kit (MCU + Wio-SX1262 daughter)
; ---------------------------------------------------------------------
; Pin map in include/board/xiao_nrf52840.h, derived from Meshtastic's
; seeed_xiao_nrf52840_kit variant (commit 9322bcdb). Uses pca10056
; pin numbering (board = nrf52840_dk_adafruit) same as Faketec/RAK4631.
[env:XIAO_nRF52840]
platform = nordicnrf52
; Custom board JSON in boards/ with S140 v7.3.0 fwid + linker script
; at 0x27000. Required because the XIAO ships with S140 v7.3.0 while
; nrf52840_dk_adafruit targets S140 v6.1.1 (app at 0x26000).
board = xiao_nrf52840
board_build.partitions = no_ota.csv
board_build.filesystem = littlefs
upload_protocol = nrfutil
extra_scripts = pre:scripts/pre_build.py
build_unflags =
    ${env.build_unflags}
    -fno-exceptions
    -fno-rtti
    --specs=nano.specs
build_flags =
    ${env.build_flags}
    -fexceptions
    -frtti
    --specs=nosys.specs
    -DBOARD_MODEL=BOARD_XIAO_NRF52840
    -include include/board/xiao_nrf52840.h
    ;
    ; --- Reticulum feature flags (same as Faketec/RAK4631) ---
    -DRNS_USE_FS
    -DRNS_PERSIST_PATHS
    ;
    ; --- Memory tuning (same nRF52840, same budget) ---
    -DRNS_DEFAULT_ALLOCATOR=RNS_HEAP_POOL_ALLOCATOR
    -DRNS_HEAP_POOL_BUFFER_SIZE=98304
    -DUSTORE_USE_INTERNALFS
    -DURTN_PATH_TABLE_MAX_RECS=100
    -DRNS_PATH_TABLE_SEGMENT_SIZE=8192
    -DRNS_PATH_TABLE_SEGMENT_COUNT=8
lib_deps =
    ${env.lib_deps}
    jgromes/RadioLib @ ^7.3.0
    https://github.com/attermann/microStore.git#e18b827939f44ad500e49d810b62bb627439726b
    https://github.com/attermann/microReticulum.git#5fbdbf37efdbb7b64d447fef0317e7d215986421

; ---------------------------------------------------------------------
; Heltec_T114 — Heltec Mesh Node T114 (nRF52840 + SX1262 + TFT)
; ---------------------------------------------------------------------
[env:Heltec_T114]
platform = nordicnrf52
board = nrf52840_dk_adafruit
board_build.partitions = no_ota.csv
board_build.filesystem = littlefs
upload_protocol = nrfutil
extra_scripts = pre:scripts/pre_build.py
build_unflags =
    ${env.build_unflags}
    -fno-exceptions
    -fno-rtti
    --specs=nano.specs
build_flags =
    ${env.build_flags}
    -fexceptions
    -frtti
    --specs=nosys.specs
    -DBOARD_MODEL=BOARD_HELTEC_T114
    -include include/board/heltec_t114.h
    -DRNS_USE_FS
    -DRNS_PERSIST_PATHS
    -DRNS_DEFAULT_ALLOCATOR=RNS_HEAP_POOL_ALLOCATOR
    -DRNS_HEAP_POOL_BUFFER_SIZE=98304
    -DUSTORE_USE_INTERNALFS
    -DURTN_PATH_TABLE_MAX_RECS=100
    -DRNS_PATH_TABLE_SEGMENT_SIZE=8192
    -DRNS_PATH_TABLE_SEGMENT_COUNT=8
lib_deps =
    ${env.lib_deps}
    jgromes/RadioLib @ ^7.3.0
    https://github.com/attermann/microStore.git#e18b827939f44ad500e49d810b62bb627439726b
    https://github.com/attermann/microReticulum.git#5fbdbf37efdbb7b64d447fef0317e7d215986421

; ---------------------------------------------------------------------
; T-Echo — LilyGO T-Echo (nRF52840 + SX1262 + GPS + e-paper)
; ---------------------------------------------------------------------
; The RNode nRF52 target named in issue #2. Ships with SoftDevice
; S140 v6.1.1 — identical to nrf52840_dk_adafruit — so no custom board
; JSON or linker is needed (unlike XIAO_nRF52840). Pin map in
; include/board/techo.h; SX1262 SPI pinout is identical to Heltec_T114.
;
; HARDWARE VALIDATION PENDING: no T-Echo on the bench when this env
; landed. First user to flash should verify RX end-to-end and
; recalibrate batt_mult via the webflasher's CALIBRATE BATTERY flow.
[env:T-Echo]
platform = nordicnrf52
board = nrf52840_dk_adafruit
board_build.partitions = no_ota.csv
board_build.filesystem = littlefs
upload_protocol = nrfutil
extra_scripts = pre:scripts/pre_build.py
build_unflags =
    ${env.build_unflags}
    -fno-exceptions
    -fno-rtti
    --specs=nano.specs
build_flags =
    ${env.build_flags}
    -fexceptions
    -frtti
    --specs=nosys.specs
    -DBOARD_MODEL=BOARD_TECHO
    -include include/board/techo.h
    -DRNS_USE_FS
    -DRNS_PERSIST_PATHS
    -DRNS_DEFAULT_ALLOCATOR=RNS_HEAP_POOL_ALLOCATOR
    -DRNS_HEAP_POOL_BUFFER_SIZE=98304
    -DUSTORE_USE_INTERNALFS
    -DURTN_PATH_TABLE_MAX_RECS=100
    -DRNS_PATH_TABLE_SEGMENT_SIZE=8192
    -DRNS_PATH_TABLE_SEGMENT_COUNT=8
lib_deps =
    ${env.lib_deps}
    jgromes/RadioLib @ ^7.3.0
    https://github.com/attermann/microStore.git#e18b827939f44ad500e49d810b62bb627439726b
    https://github.com/attermann/microReticulum.git#5fbdbf37efdbb7b64d447fef0317e7d215986421

; ---------------------------------------------------------------------
; RAK3401 — RAK3401 1-Watt (WisBlock nRF52840 + SX1262 + 1W PA)
; ---------------------------------------------------------------------
[env:RAK3401]
platform = nordicnrf52
board = nrf52840_dk_adafruit
board_build.partitions = no_ota.csv
board_build.filesystem = littlefs
upload_protocol = nrfutil
extra_scripts = pre:scripts/pre_build.py
build_unflags =
    ${env.build_unflags}
    -fno-exceptions
    -fno-rtti
    --specs=nano.specs
build_flags =
    ${env.build_flags}
    -fexceptions
    -frtti
    --specs=nosys.specs
    -DBOARD_MODEL=BOARD_RAK3401
    -include include/board/rak3401.h
    -DRNS_USE_FS
    -DRNS_PERSIST_PATHS
    -DRNS_DEFAULT_ALLOCATOR=RNS_HEAP_POOL_ALLOCATOR
    -DRNS_HEAP_POOL_BUFFER_SIZE=98304
    -DUSTORE_USE_INTERNALFS
    -DURTN_PATH_TABLE_MAX_RECS=100
    -DRNS_PATH_TABLE_SEGMENT_SIZE=8192
    -DRNS_PATH_TABLE_SEGMENT_COUNT=8
lib_deps =
    ${env.lib_deps}
    jgromes/RadioLib @ ^7.3.0
    https://github.com/attermann/microStore.git#e18b827939f44ad500e49d810b62bb627439726b
    https://github.com/attermann/microReticulum.git#5fbdbf37efdbb7b64d447fef0317e7d215986421

; ---------------------------------------------------------------------
; native — host-side unit tests for Config parsing etc.
; ---------------------------------------------------------------------
[env:native]
platform = native
framework =
test_framework = unity
build_flags =
    -std=gnu++17
    -Wall
    -Iinclude
    -Isrc
    -DNATIVE_BUILD