Appareils
Registre des appareils, cartes et éditeur de pinout
Devices › Appareils / Agents est le registre des cartes et agents edge de l'organisation. Chaque appareil est un enregistrement propre à l'organisation, avec une identité (token, clé du lien chiffré, certificat X.509) et un profil de carte.
Catalogue et assistant
Un catalogue global de modèles (consultable dans Devices › Catalogue d'appareils) alimente l'assistant Enregistrer, en quatre étapes : Identifiant (identifiant unique de 16 caractères au plus, étiquettes facultatives) → Modèle (Générique PneX, Cartes prédéfinies ou Agents, plus la Variante de carte quand un modèle en a plusieurs) → WiFi (un identifiant Wi-Fi et un serveur PNeX choisis dans Devices › Référentiels) → Revue, puis Créer & compiler. Le build tourne sur le serveur : on peut fermer la fenêtre.
Le mot de passe Wi-Fi n'est jamais saisi dans le build : il vient toujours du
référentiel de l'organisation (stocké dans le coffre) et le worker le déchiffre au
moment de compiler. Côté API, un build se lance avec device_id,
wifi_credential_id et pnex_host.
Détail d'un appareil
Détail sur une ligne montre les capacités, le token de provisioning et la clé de chiffrement (masqués, Révéler pour les lire), la carte Étiquettes et le pinout de la carte. Deux liens suivent les étiquettes :
- Page objet ouvre l'objet de l'appareil dans Connaissance › Ontologie : ses liens avec les autres objets de l'organisation (sites, équipements, dossiers…).
- Ajouter à un dossier range l'appareil dans un dossier d'enquête (rôles d'écriture).
Enregistré sur la mauvaise variante (par exemple un NodeMCU à OLED soudé enregistré comme un NodeMCU simple) ? Changer de carte, à côté du nom de la carte, choisit la carte réellement câblée parmi celles du même chip. Les réglages de pins sont conservés ; recompilez, puis mettez l'appareil à jour.
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).
Identité et transport
À l'enregistrement, chaque appareil reçoit un token et une clé partagée de 32 octets (la PSK du lien Noise) ; chaque build y ajoute un certificat client X.509 émis par la CA de l'organisation. Les trois sont compilés dans le firmware.
L'appareil se connecte au point d'entrée devices (port 4443 par défaut) en TLS
mutuel, envoie son token dans l'en-tête Authorization: Bearer, ouvre le lien Noise,
puis s'annonce sur /ws/device et échange des messages chiffrés : annonce,
provision ack, set-mode, write, subscribe. Un watchdog évacue les connexions zombie ;
l'état désiré est re-poussé à la reconnexion. Un appareil qui ne passe jamais actif
se diagnostique avec son code de fermeture : voir
Sécurité → codes de fermeture.
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 Appareil (écriture)). 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.