Appareils
Registre des appareils, cartes et éditeur de pinout
Les appareils sont des enregistrements org-scoped avec identité, tokens, métadonnées et profil de carte.
Catalogue et assistant
Un catalogue global d'appareils et de capacités prédéfinis permet d'enregistrer un appareil via un assistant : identifiant, métadonnées, credentials Wi-Fi, auto-build du firmware à l'enregistrement.
Profils de cartes et éditeur de pinout
Chaque appareil référence un profil de carte (MCU, capacités des chips, warnings, safe states). L'éditeur de pinout rend la carte en SVG interactif : mode par pin, safe state, contrôles subscribe et write, duty PWM — un compagnon de câblage fidèle pour la carte physique (connecteur USB dessiné en haut par convention).
Tokens et transport
Chaque appareil reçoit un token URL-safe et une clé ChaCha20. L'appareil se connecte
au canal WebSocket /ws/device, s'annonce, et échange des messages ChaCha20 :
annonce, provision ack, set-mode, write, subscribe. Un watchdog évacue les
connexions zombie ; l'état désiré est re-poussé à la reconnexion.
Qui écrit sur un pin
Seul vous écrivez sur un pin : à la main depuis l'éditeur de pinout, ou via un flow
que vous avez déployé (le nœud pnex-device-write). Chaque pin de sortie a une seule
source d'écriture — un pin piloté par un flow ne peut pas être écrit ailleurs. Ni le
serveur ni l'assistant IA n'écrivent de leur propre initiative, et la régulation
critique appartient à l'appareil (voir Flows).
Les tableaux de bord suivent la même règle : un interrupteur sur un tableau ou un téléphone n'écrit jamais une pin. Il écrit un contrôle, et le flow qui l'écoute écrit la pin — voir le tutoriel domotique.