L'électron rare
878d911065
✅ P1.1 Phase 9 Touch Input (4h) - TouchEmulator: 4x4 grid navigation via buttons (UP/DOWN/LEFT/RIGHT toggle) - Files: touch_emulator.{h,cpp} + AmigaUIShell integration - Button mapping: 0=UP, 1=SELECT, 2=DOWN, 3=MENU, 4=TOGGLE_LR - Build SUCCESS (31.06s, 64.4% RAM, 42.0% Flash) ✅ P1.2 Documentation Update (1h) - AGENT_TODO.md: Phase 9 completion + Sprint 9 section added - Root cause analysis: watchdog timeout (cycle 9) → stack fix (8192→16384) - Troubleshooting guide: common issues + debug commands Files: + touch_emulator.{h,cpp} ~ ui_amiga_shell.* + main.cpp + AGENT_TODO.md Next: P1.3 (Sprint 1 endurance validation) + P2 (main.cpp refactor)
160 lines
9.2 KiB
Markdown
160 lines
9.2 KiB
Markdown
## Validation hardware – TODO détaillée
|
||
|
||
## Sprint 0 - Foundation (2026-03-02)
|
||
|
||
- [x] Bridge `AmigaUIShell` -> `AppRuntimeManager` branché via interface interne.
|
||
- [x] `launchSelectedApp()` implémenté avec ouverture runtime réelle.
|
||
- [x] Anti double-launch activé (debounce + garde sur état app déjà active).
|
||
- [x] `APP_STATUS` exposé en commande série directe + HELP mis à jour.
|
||
- [x] Logs runtime normalisés ajoutés (`APP_OPEN_*`, `APP_CLOSE_*`, `APP_ACTION_*`).
|
||
- [x] Upgrade LVGL 8.4.x appliqué.
|
||
- [x] Librairie QR figée sur commit.
|
||
- [x] `tinyexpr` ajouté explicitement.
|
||
- [~] Upgrade `ESP32-audioI2S` 3.4.4 tenté puis rollback vers 2.3.0 (toolchain bloque sur `<span>`).
|
||
- [x] Gate build exécutée: `pio run -e freenove_esp32s3_full_with_ui` SUCCESS.
|
||
|
||
## Sprint 1 - Utility Pack (2026-03-02)
|
||
|
||
- [x] `CalculatorModule`: tinyexpr prioritaire + erreurs explicites (`eval_error@pos`) + action `status`.
|
||
- [x] `TimerToolsModule`: chrono/countdown stabilisés + action `status` + signal fin countdown (audio/LED si dispo).
|
||
- [x] `FlashlightModule`: on/off robustes + `light_toggle` + `set_level` appliqué à chaud + action `status`.
|
||
- [x] Contrat specs apps mis à jour (`calculator`, `timer_tools`, `flashlight`).
|
||
- [x] Campagne endurance outillée: `tests/sprint1_utility_contract.py` (mode serial + mode HTTP).
|
||
- [x] Smoke série court validé: `python3 tests/sprint1_utility_contract.py --mode serial --cycles 5 --port /dev/cu.usbmodem5AB90753301`.
|
||
- [ ] Gate endurance série 20 cycles/app encore rouge.
|
||
- Verdict (2026-03-02): échec à `calculator cycle 9/20` avec reboot panic (`reset_reason=4`) et `APP_STATUS parse failed` post-reboot.
|
||
- Contexte: issue non fonctionnelle app métier, liée à stabilité runtime/mémoire sous endurance.
|
||
- [ ] Gate HTTP toujours bloqué côté reachability/auth (`/api/apps/*` non validé dans cette passe).
|
||
|
||
- [x] Compiler et flasher le firmware sur le Freenove Media Kit (`pio run -e freenove_esp32s3_full_with_ui -t upload`)
|
||
- [ ] Préparer les fichiers de test sur LittleFS (/data/scene_*.json, /data/screen_*.json, /data/*.wav)
|
||
- [ ] Vérifier l’affichage TFT (boot, écran dynamique, transitions)
|
||
- [ ] Tester la réactivité tactile (zones, coordonnées, mapping)
|
||
- [ ] Tester les boutons physiques (appui, mapping, transitions)
|
||
- [ ] Tester la lecture audio (fichiers présents/absents, fallback)
|
||
- [~] Observer les logs série (initialisation, actions, erreurs) en continu pendant endurance longue
|
||
- [ ] Générer et archiver les logs d’évidence (logs/)
|
||
- [ ] Produire un artefact de validation (artifacts/)
|
||
- [ ] Documenter toute anomalie ou limitation hardware constatée
|
||
|
||
## Sprint 2 - Capture Pack (2026-03-02)
|
||
|
||
- [x] `CameraVideoModule`: action `status` + états preview/clip/frame + erreurs normalisées.
|
||
- [x] `QrScannerModule`: action `status` + `scan_payload` + classification `url/app/text`.
|
||
- [x] `DictaphoneModule`: action `status` + normalisation de chemin enregistrement/lecture.
|
||
- [x] Contrat Sprint 2 ajouté: `tests/sprint2_capture_contract.py`.
|
||
- [x] Gate série Sprint 2 (1 cycle/app) verte.
|
||
- Verdict (2026-03-02): `python3 tests/sprint2_capture_contract.py --mode serial --cycles 1` SUCCESS.
|
||
- [x] Endurance courte Sprint 2 (3 cycles/app) verte.
|
||
- Verdict (2026-03-02): `python3 tests/sprint2_capture_contract.py --mode serial --cycles 3` SUCCESS.
|
||
- [x] Endurance intermédiaire Sprint 2 (10 cycles/app) verte.
|
||
- Verdict (2026-03-02): `python3 tests/sprint2_capture_contract.py --mode serial --cycles 10` SUCCESS.
|
||
- [x] Déblocage mémoire/coex appliqué:
|
||
- `platformio.ini`: `UI_FX_TARGET_FPS=12`, `UI_DMA_TRANS_BUF_LINES=1`, `UI_LV_MEM_SIZE_KB=54`,
|
||
`ARDUINO_LOOP_STACK_SIZE=16384`, `BOARD_HAS_PSRAM`.
|
||
- `QrScannerModule`: ownership caméra corrigé (évite double init avec `ESP32QRCodeReader`).
|
||
- `AppRuntimeManager`: profil ressource auto selon capabilities app (caméra vs micro).
|
||
- [ ] Gate endurance longue Sprint 2 à lancer (20 cycles/app) + archivage logs.
|
||
|
||
## Revue finale – Checklist agents
|
||
|
||
- [ ] Vérifier la cohérence de la structure (dossiers, modules, scripts)
|
||
- [ ] Relire AGENT_FUSION.md (objectifs, couverture specs, structure)
|
||
- [ ] Relire README.md (usage, build, validation, modules)
|
||
- [ ] Relire la section onboarding (docs/QUICKSTART.md, etc.)
|
||
- [ ] Vérifier la présence et la robustesse du fallback LittleFS
|
||
- [ ] Vérifier la traçabilité des logs et artefacts
|
||
- [ ] Vérifier la synchronisation UI/scénario/audio
|
||
- [ ] Vérifier la gestion dynamique des boutons/tactile
|
||
- [ ] Vérifier la non-régression sur les autres firmwares (split)
|
||
|
||
# TODO Agent – Firmware All-in-One Freenove
|
||
|
||
|
||
## Plan d’intégration détaillé (COMPLÉTÉ)
|
||
|
||
- [x] Vérifier la présence du scénario par défaut sur LittleFS
|
||
- [x] Charger la liste des fichiers de scènes et d’écrans (data/)
|
||
- [x] Initialiser la navigation UI (LVGL, écrans dynamiques)
|
||
- [x] Mapper les callbacks boutons/tactile vers la navigation UI
|
||
- [x] Préparer le fallback LittleFS si fichier manquant
|
||
- [x] Logger l’initialisation (logs/)
|
||
|
||
- [x] Boucle principale d’intégration
|
||
- [x] Navigation UI (LVGL, écrans dynamiques)
|
||
- [x] Exécution scénario (lecture, actions, transitions)
|
||
- [x] Gestion audio (lecture, stop, files LittleFS)
|
||
- [x] Gestion boutons/tactile (événements, mapping)
|
||
- [x] Gestion stockage (LittleFS, fallback)
|
||
- [x] Logs/artefacts
|
||
|
||
## Validation hardware (EN COURS)
|
||
|
||
- [ ] Tests sur Freenove Media Kit (affichage, audio, boutons, tactile)
|
||
- [ ] Génération de logs d’évidence (logs/)
|
||
- [ ] Production d’artefacts de validation (artifacts/)
|
||
|
||
## Documentation
|
||
|
||
- [ ] Mise à jour README.md (usage, build, structure)
|
||
- [ ] Mise à jour AGENT_FUSION.md (règles d’intégration, conventions)
|
||
- [ ] Synchronisation avec la doc onboarding principale
|
||
|
||
## Spécifications fonctionnelles utilisateur à livrer
|
||
|
||
- [ ] **Lecteur Audio** (lecture locale, play/pause/stop, playlist de base)
|
||
- [ ] **Appareil photo / vidéo** (capture image/vidéo, stockage média, aperçu)
|
||
- [ ] **Dictaphone** (enregistrement audio local, lecture, suppression)
|
||
- [ ] **Chronomètre / minuteur** (UI dédiée, rappel sonore)
|
||
- [ ] **Lampe de poche** (commande on/off, intensité si supportée)
|
||
- [ ] **Calculatrice** (opérations de base, historique simple)
|
||
- [ ] **Webradio enfants** (gestion flux HTTP/ICY, reprise auto minimale)
|
||
- [ ] **Podcast enfants** (lecture podcasts local ou RSS simplifié)
|
||
- [ ] **Lecteur de QR code** (scan caméra, parsing et action de base)
|
||
- [ ] **Émulateur de jeux vidéo** (version minimale ludique compatible mémoire embarquée)
|
||
- [ ] **Lecteur de livres audio** (index/chapitres, reprise de progression)
|
||
- [ ] **Application de dessin** (canvas tactile + outils minimum)
|
||
- [ ] **Application de coloriage** (templates + remplissage couleur)
|
||
- [ ] **Application de musique pour enfants** (playlists ciblées, contrôle simple)
|
||
- [ ] **Application de yoga pour enfants** (séquences guidées, audio/texte)
|
||
- [ ] **Application de méditation pour enfants** (tempos/sons/apaisement)
|
||
- [ ] **Application de langues pour enfants** (mini leçons + répétition audio)
|
||
- [ ] **Application de mathématiques pour enfants** (exercices interactifs)
|
||
- [ ] **Application de sciences pour enfants** (contenus interactifs + quiz)
|
||
- [ ] **Application de géographie pour enfants** (quiz/carte/images interactives)
|
||
|
||
### Plan d’intégration recommandé (ordre de dépendance)
|
||
|
||
- [ ] 1) Base commune UI + assets + navigation (priorité haute)
|
||
- [ ] 2) Audio stack: lecteur audio / livres / podcasts / webradio
|
||
- [ ] 3) Outils système: chronomètre, calculatrice, lampe de poche
|
||
- [ ] 4) Camera stack: photo/vidéo + QR code
|
||
- [ ] 5) Contenus enfants: dessin, coloriage, musique, yoga, méditation, langues, maths, sciences, géographie
|
||
- [ ] 6) Jeux: intégrer émulateur léger après stabilisation mémoire/perf
|
||
|
||
## Stack technique réseau (nouvelle contrainte)
|
||
|
||
- [ ] Ajouter découverte réseau Bonjour/mDNS (nom appareil + présence services)
|
||
- [ ] Ajouter service de transfert simple de fichiers entre appareils
|
||
- [ ] Définir protocole minimal de transfert (metadata + chunks + ack + reprise simple)
|
||
- [ ] Ajouter endpoints/API de partage (liste appareils, push/pull fichier, état transfert)
|
||
- [ ] Journaliser les transferts (début, progression, succès/échec)
|
||
|
||
## UX/UI enfants + inspiration Amiga (nouvelle contrainte)
|
||
|
||
- [ ] Définir un thème visuel enfant inspiré Amiga (palette, icônes, typo, motion)
|
||
- [ ] Créer écran home "kids shell" (grille d’apps colorée + navigation simple)
|
||
- [ ] Ajouter transitions ludiques non bloquantes (sans pénaliser FPS/runtime loop)
|
||
- [ ] Standardiser composants UI: bouton, carte app, badge état, feedback action
|
||
- [ ] Ajouter règles de lisibilité enfant (texte court, contraste, zones tactiles larges)
|
||
|
||
## Progression technique réalisée (itération courante)
|
||
|
||
- [x] Socle apps runtime: registre, lifecycle manager, endpoints `/api/apps/*`
|
||
- [x] Contrat capacités runtime: flags explicites et gating au lancement d’app
|
||
- [x] Actions scénario app-aware: `open_app`, `close_app`, `app_action`
|
||
- [x] Bonjour/mDNS: service publié `_zacus._tcp` + découverte peers
|
||
- [x] Partage fichiers simple: endpoints `/api/share/peers`, `/api/share/files`, `/api/share/upload`
|
||
- [x] Spécifications JSON: manifest/streams/progress + registre exemple
|
||
- [x] Direction UX enfant + Amiga: fichier de thème de référence
|