La console série¶
Branchez l'USB de la console sur un ordinateur : elle apparaît comme un port série nommé papyDeck RP1 (115 200 bauds, n'importe quel terminal). Tout ce que les trois puces racontent sort là — la console de RP3 dans les deux sens, celle de RP2 en lecture, préfixée [rp2] — et quelques touches de contrôle pilotent la machine.
Lire l'état — Ctrl+L¶
Ctrl+L imprime l'état, une ligne par sous-système :
| Ligne | Ce qu'elle dit |
|---|---|
[sup] |
le superviseur : cause du dernier démarrage (boot=watchdog\|reboot\|run\|por), état RUN de RP2/RP3, présence et fréquence du VSYNC, hot-plug HDMI, compteurs du lien (err, ovf) |
[game] |
le budget de trame : temps update et draw en µs contre les 16 667 µs d'une trame, puis la display list — used/clipped/dropped/repeats/missing — et le tas Lua |
[pool] |
le cache d'art de RP2 : Kio occupés, bitmaps résidents, chargements, ratés (full = working set plus grand que le pool) |
[map] |
les écritures de carte du fond : runs, entrées, en attente, perdues |
[sd] |
la micro-SD : détectée, montée, taille, label, nombre de jeux |
[esp] |
le lien ESP32 : hello, manettes appairées, état Wi-Fi |
La ligne [game] est la mesure d'un jeu sur la vraie carte : update=181 us … budget 16667 se lit ~1 % de la trame. La ligne [sup] sort aussi toute seule toutes les 2 s.
Les autres touches¶
- Ctrl+Q — bascule les rapports périodiques de RP2 et RP3 : cycles par ligne (
compose,bg,passcontre le budget), autotest du blitter, temps de reconstruction de palette. Les chiffres que les pages d'architecture donnent comme « mesurés » viennent de là. - Ctrl+P puis un nom de jeu et ++entree++ — lance ce jeu (
sys.run), sans passer par le dashboard. - Ctrl+R / Ctrl+T — reset matériel de RP3 / RP2 (impulsion RUN) ; Ctrl+W redémarre RP1 par son watchdog, ce qui relance tout.
- Ctrl+K — vide le cache de compilation : le prochain lancement recompile le bundle d'art du jeu.
- Ctrl+D — coupe l'envoi de la display list (un arrêt sur image, pour sonder).
Toute autre touche part vers la console de RP3. Les touches restantes (Ctrl+U, Ctrl+F, Ctrl+G, Ctrl+E) sont les ponts de développement pour programmer les NOR et l'ESP32 par ce même câble — voir les README du dépôt firmware.