Files

T

electron-rare 97d531cf26 chore(embedded): add memory-budget guardrail script and docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-11 03:52:54 +01:00

1.9 KiB

Raw Permalink Blame History

Quickstart

Prérequis

python3
accès USB vers la carte Freenove
réseau local optionnel pour les tests HTTP

Bootstrap

./scripts/bootstrap_platformio.sh
./scripts/doctor_repo.sh
source .venv/bin/activate

Le bootstrap crée une .venv locale et installe platformio, esptool et pyserial.

Build

python -m platformio run -e freenove_esp32s3_full_with_ui
python -m platformio run -e freenove_esp32s3_full_with_ui -t buildfs

Budget memoire

./scripts/check_memory_budget.sh --env freenove_esp32s3_full_with_ui --max-ram 75 --max-flash 80 --yes

Le script force un build platformio run, lit les lignes RAM: et Flash:, et retourne un code non-zero si les seuils sont depasses.

Flash

python -m platformio run -e freenove_esp32s3_full_with_ui -t uploadfs --upload-port <PORT>
python -m platformio run -e freenove_esp32s3_full_with_ui -t upload --upload-port <PORT>

Monitor

python -m platformio device monitor -b 115200 --port <PORT>

Signatures attendues

Boot normal:

[MAIN] Freenove all-in-one boot
[MEM] psram_found=1

Boot diagnostic sans PSRAM:

[MEM] PSRAM expected by build flags but not detected
[BOOT] safe diagnostic mode enabled: PSRAM required, app stack disabled
[SAFE] boot path: storage + serial + display + buttons only

Smoke minimal

python tests/sprint1_utility_contract.py --mode serial --port <PORT>
python tests/sprint2_capture_contract.py --mode serial --port <PORT>
python tests/sprint3_audio_contract.py --mode serial --port <PORT>
python tests/phase9_ui_validation.py --port <PORT>

Procédure si la PSRAM est absente

Garder le monitor série ouvert.
Vérifier que le boot reste vivant en mode diagnostic.
Confirmer l'absence d'initialisation Wi-Fi, ESP-NOW, caméra et audio.
Vérifier le module réel et la config platformio.ini avant de reflasher.

1.9 KiB Raw Permalink Blame History