Interface de Débogage¶

L'interface de débogage (/debug) est un outil intégré au backend pour tester les communications avec les clients Essensys et diagnostiquer les problèmes de scénarios.

Accès¶

L'interface est accessible à l'adresse suivante : http://mon.essensys.fr/debug

Diagnostic MCP (Ops)¶

En complément de /debug, le serveur MCP fournit des outils d'exploitation pour accélérer le diagnostic et la remédiation.

Outils recommandés¶

• list_service_status : état active/enabled des services clés.
• read_service_logs : lecture journalctl d'un service.
• restart_service : redémarrage ciblé d'un service autorisé.
• get_port_diagnostics : vérifie les ports clés (80, 443, 7070, 8083, 6379).
• get_system_metrics : uptime, mémoire, disque, interfaces, clients.
• run_self_diagnostic : état global + recommandations, avec auto_repair=true possible.

Workflow conseillé (MCP)¶

1. Exécuter run_self_diagnostic.
2. Lire recommendations.
3. Si nécessaire, relancer avec auto_repair=true.
4. Vérifier avec list_service_status puis read_service_logs sur les services encore KO.

Fonctionnalités¶

1. Injection d'Actions (Inject Action)¶

Cette section permet d'envoyer manuellement des commandes au client (injecter des actions dans la file d'attente du backend).

• Key (Clé) : L'indice de la variable à modifier (ex: 590 pour déclencher un scénario, 619 pour une lumière).
• Value (Valeur) : La valeur à affecter.

Exemple "Allumer Couloir" : * Key: 619 * Value: 4

Exemple "Déclencher Scénario 2 (Je sors)" : * Key: 590 * Value: 1 (Confirmation)

2. Logs Temps Réel (Logs / Response)¶

Cette section affiche les traces de communication backend/client en temps réel.

• Injected action : Indique que votre commande manuelle a été reçue par le backend et mise en file d'attente (avec un GUID unique).
• Client retrieved ... actions : Indique que le client (le boîtier Essensys) a fait une requête GET /api/myactions et a récupéré la commande. C'est la preuve que le "polling" fonctionne.
• Client CONFIRMED action : Indique que le client a envoyé une requête POST /api/done/{guid} pour confirmer qu'il a bien reçu et traité l'action.

Diagnostic¶

• Si vous voyez "Injected" mais jamais "Retrieved" : Le client n'est probablement pas connecté ou ne poll pas l'API correctement. Vérifiez la connectivité réseau du boîtier.
• Si vous voyez "Retrieved" mais jamais "Confirmed" : Le client reçoit la commande mais échoue à la traiter (bug firmware) ou à envoyer la confirmation.

Référence des Commandes (Basé sur Scenario 1)¶

Voici la liste des constantes pour l'injection manuelle, basées sur les indices du Scenario 1 (Zone de test recommandée).

Pour exécuter une commande : 1. Injectez les valeurs dans les clés ci-dessous (ex: 611:1 pour allumer entrée). 2. (Optionnel) Si nécessaire, déclenchez le scénario 1 en injectant 590:1 (Index Scenario).

Éclairage - ALLUMER¶

Éclairage - ÉTEINDRE¶

Volets & Stores - OUVRIR¶

Volets & Stores - FERMER¶

Scénarios & Sécurité¶

Description des Scénarios (Table de Vérité)¶

Voici le comportement par défaut des scénarios (basé sur table_ref.txt et TableEchange.h). Pour déclencher un scénario, injectez son numéro (1-8) dans la clé 590.

Personnalisation (Scénarios 7 et 8)¶

D'après le code C (TableEchange.h), tous les scénarios partagent la même structure de données (définie par enum enumScenario). Pour configurer un scénario "Personnalisé", il suffit d'écrire les valeurs souhaitées aux adresses mémoire correspondantes.

Formule : Clé = Base_Scénario + Offset_Fonction

Bases des Scénarios¶

• Scénario 7 : 838
• Scénario 8 : 879

Offsets des Fonctions (à ajouter à la Base)¶

(Note : Les offsets continuent séquentiellement pour MSB, CHB, PDE... Voir TableEchange.h pour la liste complète : +19=Allumer PDV LSB, +20=PDV MSB, +21=CHB LSB...)

Exemple Concret¶

Objectif : Configurer le Scénario 7 pour qu'il allume la lampe de l'Entrée (Valeur 1).

1. Base Scénario 7 = 838
2. Offset Allumer PDV LSB = +19
3. Clé à injecter = 838 + 19 = 857
4. Valeur = 1 (Entrée)

Commande à injecter : 857:1 Ensuite, déclencher le scénario 7 en injectant 590:7.

Exemples de Configuration pour le Scénario 7 (Base 838)¶

Voici deux exemples complets pour illustrer la logique.

Exemple A : "Soirée TV" (Fermer Salon + Lumière Tamisée)¶

Objectif : 1. Fermer les 3 volets du Salon. 2. Allumer le variateur du Salon. 3. Éteindre les lumières de la Cuisine (pour éviter les reflets).

Calculs & Injections :

Résumé : Injectez 866:7, 858:128, 855:3 -> Puis lancez 590:7.

Exemple B : "Sécurité Totale" (Départ Vacances Personnalisé)¶

Objectif : 1. Mettre l'alarme. 2. Fermer TOUS les volets de la maison (PDV, CHB, PDE). 3. Couper l'arrivée d'eau (Sécurité).

Calculs & Injections :

Résumé : Injectez 839:1, 866:255, 867:255, 868:255, 869:1 -> Puis lancez 590:7.

Table Complète des Offsets (Programmation C)¶

Utilisez ce tableau pour calculer n'importe quelle clé de configuration. Clé Finale = Base Scénario + Offset

Exemple de calcul pour la colonne "Ex: Clé Scén 7" : Base 838 + Offset.

Configuration des Temps (Volets & Lampes)¶

Vous pouvez régler la durée de course des volets ou le temps d'extinction automatique des lampes.

Temps de Course des Volets (en Secondes)¶

Valeur : 1 à 255 secondes.

Exemple : Régler le Volet 1 du Salon (Index 0 de PDV) à 20 secondes. * Clé : 566 * Valeur : 20

Temps d'Extinction Automatique des Lampes (en Minutes)¶

Valeur : 1 à 255 minutes (0 = Pas d'extinction).

Exemple : Éteindre la lumière du WC 1 automatiquement après 5 minutes. * Clé : 555 (550 + 5) * Valeur : 5

Configuration des Variateurs (Type de Sortie)¶

Vous pouvez configurer le type de charge pilotée par les sorties variateurs.

Valeurs possibles : * 0 : TOR avec Rampe (Allumage/Extinction progressif type halogène) * 1 : Gradateur (Dimmer variable) * 2 : TOR Sec (Sans rampe, pour LED non dimmable ou Relais)

Exemple : Configurer la Salle à Manger (PDV + 1) en mode Gradateur. * Clé : 495 * Valeur : 1

Configuration de l'Arrosage¶

Vous pouvez piloter le système d'arrosage automatique.

Mode de Fonctionnement (Arrose_Mode)¶

Clé : 363

Détecteur de Pluie (Arrose_Detect)¶

Clé : 406

Exemple : Forcer l'arrosage pendant 30 minutes. * Clé : 363 * Valeur : 30

Configuration Fin de Vacances (Retour)¶

Paramétrez la date de retour et le mode de chauffage à appliquer à ce moment-là.

Date et Heure de Fin (VacanceFin)¶

Chauffage au Retour (VacanceFin_Force)¶

Définit le mode de chauffage qui s'enclenchera à la date définie ci-dessus.

Valeurs (Bitmask) : La valeur combine la consigne (Bits 0-3) et le mode (Bits 4-5). * Consigne (b0-b3) : 0=OFF, 1=Confort, 2=Eco, 3=Eco+, 4=Eco++, 5=Hors Gel. * Mode (b4-b5) : 0=Auto, 1=Forcé, 2=Anticipé. * Reprise (b7) : 128 (0x80) = "Continuer le fonctionnement actuel" (Ignore le reste).

Exemples de Valeurs : * 1 (0x01) : Auto + Confort * 2 (0x02) : Auto + Eco * 5 (0x05) : Auto + Hors Gel * 17 (0x11) : Forcé + Confort (16 + 1) * 21 (0x15) : Forcé + Hors Gel (16 + 5) * 128 (0x80) : Ne rien changer (Continuer)

Versions Système¶

Informations sur les versions logicielles installées.

État du Système (Lecture Seule)¶

Ces variables indiquent l'état global et les défauts en cours.

Statut Global (Status)¶

Clé : 10

Alertes (Alerte)¶

Clé : 11

Informations Techniques (Information)¶

Clé : 12

Configuration du Délestage¶

Permet d'activer ou désactiver la fonction de délestage (coupure automatique des gros consommateurs si dépassement puissance).

Activation (Delestage)¶

Clé : 459

Téléinformation Compteur ERDF¶

Données reçues du compteur électrique (Linky/Electronique) et paramètres de répartition.

État Instantané & Option¶

Plage : 460 à 464

Compteurs de Consommation (Index)¶

Les compteurs sont sur 2 octets (LSB/MSB).

Heures Pleines / Base (HPB) : 465 à 476 * 465-466 : Global * 467-468 : Chauffage * 469-470 : Refroidissement * 471-472 : Eau Chaude * 473-474 : Prises * 475-476 : Autres

Heures Creuses (HC) : 477 à 488 * Même ordre que HPB (Global, Chauffage, Refroid., Eau Ch., Prises, Autres).

Répartition Estimée (%)¶

Paramètres pour définir la répartition de la consommation "Autre" (calcul théorique).

Note sur les Valeurs 16 bits (LSB / MSB)¶

Les compteurs et puissances sont stockés sur 2 octets (16 bits). Pour simuler une valeur (ex: 500 VA), vous devez calculer les parties LSB (Poids faible) et MSB (Poids fort).

Formules : * MSB = Valeur_Totale / 256 (Division entière) * LSB = Valeur_Totale % 256 (Modulo / Reste)

Exemple : Simuler une puissance de 500 VA 1. Calcul MSB : 500 / 256 = 1 2. Calcul LSB : 500 - (1 * 256) = 500 - 256 = 244

Injection : * Clé 464 (MSB) : 1 * Clé 463 (LSB) : 244

Consommation Instantanée (PAPP)¶

C'est la variable la plus courante à surveiller ou simuler.

• Variables : TeleInf_PAPP_LSB (463) et TeleInf_PAPP_MSB (464).
• Unité : Volt-Ampère (VA). (≈ Watt).

Lecture (Reconstitution de la valeur) : Puissance_Totale = (Valeur_464 * 256) + Valeur_463

Exemple : Si 464 vaut 2 et 463 vaut 10. Puissance = (2 * 256) + 10 = 512 + 10 = 522 VA

Cycle de Confirmation & Retour d'État¶

Lorsque vous injectez une valeur (ex: 464:1 pour le MSB puissance), le client (la carte) procède en deux temps :

1. Confirmation (ACK) : Le client reçoit l'ordre, l'exécute, et appelle /api/done/{guid}. Réponse : 201 Created. (Cette étape confirme juste la réception, pas la valeur).

2. Mise à jour d'État (Sync) : Le client renvoie régulièrement son état complet (ou ses changements) via /api/mystatus. C'est dans ce message JSON (champ ek) que le serveur reçoit la confirmation de la nouvelle valeur.

   POST /api/mystatus
   {
     "version": "...",
     "ek": [
       { "k": 464, "v": "1" },
       { "k": 463, "v": "244" }
     ]
   }
   

Entrées Physiques ( Boutons )¶

Indices pour l'état des entrées physiques (Boutons Poussoirs).