platformio.ini

; PlatformIO Project Configuration File
;
;   Build options: build flags, source filter
;   Upload options: custom upload port, speed and extra flags
;   Library options: dependencies, extra library storages
;   Advanced options: extra scripting
;
; Please visit documentation for the other options and examples
; https://docs.platformio.org/page/projectconf.html

[platformio]
description = MoonLight ; 💫
data_dir = data
extra_configs = 
	factory_settings.ini
	features.ini
	firmware/*.ini ; 🌙  inspired by meshtastic, actual board definitions are in /firmware
; default_envs = esp32-d0, esp32-d0-16mb, esp32-c3-devkitm-1, esp32-c3-supermini

; 🌙 See /firmware folder for all the envs!!!
; =======================================

[env]
framework = arduino ;espidf will not work as libs rely on arduino (e.g. PhysicHTTP, ...)
; https://github.com/platformio/platform-espressif32/releases
; platform = espressif32 @ 6.10.0 ;Jan 2025, ESP-IDF v4.4.7-dirty / Arduino v2.0.17
; platform = espressif32 @ 6.11.0 ; June 2025, ESP-IDF v4.4.7-dirty / Arduino v2.0.17 latest v4.4.7-dirty ! framework-arduinoespressif32 @ ~3.20017.0
; v4 -> v5 flash size from 1955 to 2238 KB on S3 ! esp32 > 100%...
; v5 resulting in FastLED hickups on all listed versions:
; platform = https://github.com/pioarduino/platform-espressif32/releases/download/2024.07.00/platform-espressif32.zip ; Jul 15, 2024 espressif Arduino core 3.0.2 / IDF 5.1.4: error: no matching function for call to 'NetworkClientSecure::setCACertBundle(const uint8_t [], int)'
; platform = https://github.com/pioarduino/platform-espressif32/releases/download/53.03.10/platform-espressif32.zip ; Dec 16, 2024 Arduino core 3.1.0 based on IDF 5.3.2.241210
; platform = https://github.com/pioarduino/platform-espressif32/releases/download/53.03.11/platform-espressif32.zip ; Jan 19, 2025 Arduino core 3.1.1 based on IDF 5.3.2.241224
; platform = https://github.com/pioarduino/platform-espressif32/releases/download/54.03.20/platform-espressif32.zip ; March 28, 2025 Latest release! ESP-IDF v5.4.1-1-g2f7dcd862a-dirty / Arduino v3.2.0
; platform = https://github.com/pioarduino/platform-espressif32/releases/download/53.03.13/platform-espressif32.zip ; June 2025 not 54.03? used in latest upstream ESP-IDF v5.3.2-584-g489d7a2b3a-dirty / Arduino v3.1.3
; platform = https://github.com/pioarduino/platform-espressif32/releases/download/54.03.20/platform-espressif32.zip ; latest FastLED see https://github.com/FastLED/FastLED/issues/1903 ESP-IDF v5.4.1-1-g2f7dcd862a-dirty / Arduino v3.2.0  
;                    Parallel LED Driver crashes on this
; platform = https://github.com/pioarduino/platform-espressif32/releases/download/54.03.21/platform-espressif32.zip ; latest sveltekit
                    ; installed https://github.com/espressif/esp32-arduino-lib-builder/releases/download/idf-release_v5.4/esp32-arduino-libs-idf-release_v5.4-858a988d-v1.zip at 20250814
; platform = https://github.com/pioarduino/platform-espressif32/releases/download/55.03.30-2/platform-espressif32.zip ; Aug 16
              ; platform = https://github.com/pioarduino/platform-espressif32/releases/download/stable/platform-espressif32.zip
              ; https://github.com/espressif/esp32-arduino-lib-builder/releases/download/idf-release_v5.5/esp32-arduino-libs-idf-release_v5.5-b66b5448-v1.zip

; platform = espressif32 @ 6.12.0 ... check https://github.com/platformio/platform-espressif32/releases

;; select arduino-esp32 v2.0.9 (arduino-esp32 2.0.10 thru 2.0.14 are buggy so avoid them)
; platform = https://github.com/tasmota/platform-espressif32/releases/download/2023.06.02/platform-espressif32.zip ;; Tasmota Arduino Core 2.0.9 with IPv6 support, based on IDF 4.4.4
;from 92% to 71% !!! Flash: [=======   ]  71.8% (used 1412441 bytes from 1966080 bytes)
; platform = https://github.com/tasmota/platform-espressif32/releases/download/2024.06.00/platform-espressif32.zip
; platform = https://github.com/tasmota/platform-espressif32/releases/download/2025.05.30/platform-espressif32.zip ;; Platform Tasmota Arduino Core 3.1.3.250504based on IDF 5.3.3.250501platform_packages
; platform_packages = framework-arduinoespressif32 @ 3.1.3

platform = https://github.com/pioarduino/platform-espressif32/releases/download/55.03.35/platform-espressif32.zip ; Sep 20, check latest: https://github.com/pioarduino/platform-espressif32/releases
build_flags = 
	${factory_settings.build_flags}
	${features.build_flags}
    -D BUILD_TARGET=\"$PIOENV\"
    -D APP_NAME=\"MoonLight\" ; 🌙 Must only contain characters from [a-zA-Z0-9-_] as this is converted into a filename
    -D APP_VERSION=\"0.7.1\" ; semver compatible version string
    -D APP_DATE=\"20251231\" ; 🌙

    -D PLATFORM_VERSION=\"pioarduino-55.03.35\" ; 🌙 make sure it matches with above plaftform

    -D FT_MOONBASE=1

    ; Move all networking stuff to the protocol core 0 and leave business logic on application core 1
    -D ESP32SVELTEKIT_RUNNING_CORE=1
    -D ESP32SVELTEKIT_LOOP_INTERVAL=20

    ; Uncomment EMBED_WWW to embed the WWW data in the firmware binary
    -D EMBED_WWW

    ; Uncomment to configure Cross-Origin Resource Sharing
    -D ENABLE_CORS
    -D CORS_ORIGIN=\"*\"

    ; Uncomment to enable informations from ESP32-Sveltekit in Serial Monitor
    ; -D SERIAL_INFO // 🌙 this looks redundant as ESP_LOG is also showing almost the same 

    ; Uncomment to skip SSL certificate verification when downloading firmware updates
    -D DOWNLOAD_OTA_SKIP_CERT_VERIFY
    
    ; D E B U G   B U I L D F L A G S
    ; ===============================
    ; These build flags are only for debugging purposes and should not be used in production
    -D CONFIG_ARDUHAL_LOG_COLORS    ; Enable Arduino HAL color output
    -D CONFIG_LOG_COLORS=1          ; 🌙 Enable ESP-IDF color output

	  ; Uncomment to show log messages from the ESP Arduino Core and ESP32-SvelteKit
    -D CORE_DEBUG_LEVEL=4           ; Arduino debug level (0=None, 1=Error, 2=Warn, 3=Info, 4=Debug, 5=Verbose)

    ; 🌙 === Alternative: ESP-IDF Native Logging (currently disabled) ===
    ; use when needing to redirect logging using custom_vprintf, e.g. to UI...
    ; Uncomment these and comment out Arduino logging above to use ESP-IDF logging system
    ; -DUSE_ESP_IDF_LOG             ; Switch from Arduino to ESP-IDF logging
    ; -DLOG_LOCAL_LEVEL=ESP_LOG_DEBUG  ; Set compile-time log level per file
    ; === Experimental/Problematic Options (keep disabled) ===
    ; -DTAG="\"♾️\""                ; Custom log tag - causes FastLED conflicts
    ; -DESP_LOG_LEVEL=ESP_LOG_VERBOSE        ; Generates redefinition warnings
    ; -DESP_LOG_LEVEL_LOCAL=ESP_LOG_VERBOSE  ; Generates redefinition warnings

    ; Serve config files from flash and access at /.config/filename.json
    ;-D SERVE_CONFIG_FILES

    ; Uncomment to teleplot all task high watermarks to Serial
    ; -D TELEPLOT_TASKS

    ; Uncomment and set right values if FT_BATTERY=1 and battery voltage is on pin
    ; -D BATTERY_PIN=35 ;🌙 not on env:esp32-s3-devkitc-1-n16r8v, Pin in board presets
    -D BATTERY_MV=4200 ;🌙

    ; Uncomment to use JSON instead of MessagePack for event messages. Default is MessagePack.
    ; -D EVENT_USE_JSON=1  ; 💫 switch off for FT_MONITOR

  -D NROF_END_POINTS=160 ; 💫 increase number of endpoints to 160, default is 120, one PsychicEndpoint is 56 bytes -> 8960 bytes
    
lib_compat_mode = strict

; Uncomment to include the a Root CA SSL Certificate Bundle for all SSL needs
; Needs -D FT_DOWNLOAD_FIRMWARE=1 and -D FT_NTP=1
board_build.embed_files = src/certs/x509_crt_bundle.bin
; Source for SSL Cert Store can bei either downloaded from Mozilla with 'mozilla' ('https://curl.se/ca/cacert.pem')
; or from a curated Adafruit repository with 'adafruit' (https://raw.githubusercontent.com/adafruit/certificates/main/data/roots-filtered.pem)
; or complied from a 'folder' full of *.pem / *.dem files stored in the ./ssl_certs folder
;board_ssl_cert_source = mozilla
board_ssl_cert_source = adafruit

monitor_speed = 115200
monitor_filters = 
    ; colorize ; 🌙 maybe for USE_ESP_IDF_LOG but certainly not needed for Arduino logging
    esp32_exception_decoder
    log2file
board_build.filesystem = littlefs
extra_scripts = 
    pre:scripts/build_interface.py
    pre:scripts/generate_cert_bundle.py ; comment if no internet (or developing), GitHub CI complains about this since
    scripts/merge_bin.py
    scripts/rename_fw.py
    scripts/save_elf.py
lib_deps = 
	ArduinoJson@>=7.0.0
    elims/PsychicMqttClient@^0.2.4

;💫
[moonlight]
build_flags = 
  -D FT_MOONLIGHT=1
  -D FT_MONITOR=1
  ; FastLED pre-compiled settings:
  ; ML_CHIPSET: Used by FastLED driver.init
  -D ML_CHIPSET=WS2812B ; RGB, for fairy lights or https://www.waveshare.com/wiki/ESP32-S3-Matrix
  ; -D ML_CHIPSET=APA106 ; for Cube202020 / some fairy curtain strings do not work with WS2812B
  ;  -D ML_CHIPSET=SK6812 ; 🚧
   -D ML_COLOR_ORDER=GRB ; define your color order here if needed (why WS2812 has GRB instead of RGB?) Only for FastLED, PD software configurable
  ;  -D ML_RGBW=1 ; define whether to enable RGBW (1 = yes, 0 = no) ... could be derived from ML_CHIPSET???
lib_deps =
  https://github.com/FastLED/FastLED.git#3.10.3 ; sept 2025
  https://github.com/ewowi/WLED-sync#25f280b5e8e47e49a95282d0b78a5ce5301af4fe ; sourceIP + fftUdp.clear() if arduino >=3 (20251104)

; 💫 currently only enabled on s3 as esp32dev runs over 100%
[livescripts]
build_flags = 
  -D HTTPD_STACK_SIZE=8192 ; default 4096 but not enough for more complex read and update 
  -D FT_LIVESCRIPT=1
lib_deps =
  ; https://github.com/hpwit/ESPLiveScript.git#39e9409 ; 1.3.2 / v4.2 15-02-2025 ; Comment if FT_LIVESCRIPT=0
  ; https://github.com/hpwit/ESPLiveScript.git#3b1d1b6 ; v4.3 07-03-2025 ; Comment if FT_LIVESCRIPT=0
  ; https://github.com/hpwit/ESPLiveScript.git#62ba8ac ; vjson 24-05-2025 ; Comment if FT_LIVESCRIPT=0
  ; https://github.com/hpwit/ESPLiveScript.git#afc1d6a ; vjson 24-05-2025 ; Comment if FT_LIVESCRIPT=0
  ; https://github.com/hpwit/ESPLiveScript.git#7286d31 ; vjson 24-05-2025 ; Comment if FT_LIVESCRIPT=0
  ; https://github.com/hpwit/ESPLiveScript.git#4074cb5 ; okay
  ; https://github.com/hpwit/ESPLiveScript.git#29ced05 ; 
  ; https://github.com/hpwit/ESPLiveScript.git#7b97f74 ; okay
  ; https://github.com/hpwit/ESPLiveScript.git#7b52eca ; okay
  ; https://github.com/hpwit/ESPLiveScript.git#cccfc0b ; notokay
  ; https://github.com/hpwit/ESPLiveScript.git#4a0cb82 ; vjson 09-06-2025 ; Comment if FT_LIVESCRIPT=0
  ; https://github.com/hpwit/ESPLiveScript.git#6f86b6e ; vjson 09-06-2025 ; Comment if FT_LIVESCRIPT=0
  ; https://github.com/hpwit/ESPLiveScript.git#9f002b4ec450cd47f5d417bfaddd616dd764d1f3 ; vjson 16-06-2025 ; Comment if FT_LIVESCRIPT=0
  https://github.com/ewowi/ESPLiveScript.git#e02c2dccdd5044c9aa3edb874d26759afb0e1cb9  ; 02-11-2025 fix warnings

;For all boards
[ESP32_LEDSDRIVER]
build_flags = 
  -D ESP32_LEDSDRIVER
lib_deps =
  ; https://github.com/ewowi/I2SClocklessLedDriver.git#c9b12fc ;#dev 20240704 (latest at 20241023)
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#5414935 ;#dev 20240704 (latest at 20241023)
  https://github.com/ewowi/ESP32-LedsDriver.git

[HP_ALL_DRIVERS]
build_flags = 
  -D HP_ALL_DRIVERS
  -D HP_ALL_VERSION=\"20251120\"
lib_deps =
  ; https://github.com/ewowi/I2SClocklessLedDriver.git#5d5508ca38a15497392950d4249cd0d910c3505d
  ; https://github.com/ewowi/I2SClocklessLedDriver.git#d8cdb31f8b0d52c0562eb5b0ce4723e26f0dc62f
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#6bf1400b2fece454bccc53a07bb84258c266b198 ; testint2, 20250804 10:14PM not working yet
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#a7d3dafd005d059a8fb680927567cdd37914ed01 ; dev 20250804 12:05PM cache region crash 
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#4a6b4392206daaf56424f99627e4367b9d87af13 ; 20250804 3:53PM cache region crash

  ; https://github.com/hpwit/I2SClocklessLedDriver.git#1616a33295b3009033bf47d30d0c88619997220a ; dev 20250801 4:10PM (before test int), working 54.03.21 
  ; https://github.com/ewowi/I2SClocklessLedDriver.git#716ecd218215804cbe14753480ef657ad8e96a74 ; dev 20250809 11:52: correct gamma bug
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#3dc6cea7b7e5c605f4303ff3c9ba79654bee4d85
  ; https://github.com/ewowi/I2SClocklessLedDriver.git#9beeedb2d4ef45206b55731e07066e4775434c0f ; testint3, 20250828 2:50
  ; https://github.com/ewowi/I2SClocklessLedDriver.git#17aaa565d3c8623de64191d83bf0747749aa3977 ; dev 20250920: DMA buffer variable and psram
  ; https://github.com/ewowi/I2SClocklessLedDriver.git#f0d55a42f98b9b24f95c83b59c9f55ef83c8034e ; dev 20250921: DMA buffer variable and psram
  ; https://github.com/ewowi/I2SClocklessLedDriver.git#eeb429d79b5b24facb5e8164e8588bdf526c6107 ; dev 20251007: prepare for ESP32-P4
  ; https://github.com/ewowi/I2SClocklessLedDriver.git#b8d9d55e47c6f8dacaa106dc3b122b7e412efea9 ; dev 20251016: uint8_t pins
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#e25ddeeb4c2f8c702f0a98ab3d47627dad05905a ; dev 20251017: no waπrnings
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#6af7c8ce35021afb251d44e119a7a3d74fd087e4 ; dev 20251019: .h/cpp + setShowDelay
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#90967a0ec5803c80b18041d8f9eb4f917f60182c ; dev 20251020: setGlobalNumStrips
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#8f0ed49eaf82730479c9e775df811fd8097dddd8 ; dev 20251021: updateDriver + deleteDriver + uint16_t lenghts
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#1c519f4e195118491933d9f0f0b514ead8f6b6aa
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#58fd98b3fb9d963c551fe65c3a90efa1d50a28b2 ; dev 20251025: initled and updateLeds with custom channels
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#d42695a1da3d3db3b0f99f5731248c696de57180 ; dev 20251025: strange behavior with initled with custom channels
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#3b030e760b8a933bf3bae4c66dce90bb6271a3b5 ; dev 20251026: no COLOR_ORDER_X (set explicitly)
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#5c234c1431f012750b77fee48966d87c5afa496f ; dev 20251120: sk6812 tweaks...
  ; https://github.com/hpwit/I2SClocklessLedDriver.git#3dedc755effb10bd7aaadef068d110c8431ab60e ; dev 20251130: revert part of the sk6812 tweaks
  https://github.com/hpwit/I2SClocklessLedDriver.git#131988ed9f997bc3059dc2af26e3e15a3013247f ; dev 20251231: use p_w for rgbw (https://github.com/hpwit/I2SClocklessLedDriver/pull/50)

[HP_VIRTUAL_DRIVER]
build_flags = 
  -D HP_VIRTUAL_DRIVER
lib_deps =
  https://github.com/ewowi/I2SClocklessVirtualLedDriver#ce6bd17 ; 2025-02-26

; to do
[MM_HUB75_DRIVER]
build_flags = 
  -D MM_HUB75_DRIVER
lib_deps =
  ; https://github.com/... ;#integration ;ewowi repo adds some proposed PR's and makes sure we don't have unexpected updates