Lors du premier démarrage du module il est nécessaire de saisir les informations de connexion au réseau Wifi. Les informations concernant le serveur MQTT ou le mode TIC peuvent être également renseignées au démarrage, mais peuvent être saisies plus tard, une fois le module connecté au réseau WiFi.
Brancher le connecteur USB-C à une source d'alimentation 5V (chargeur USB classique), puis attendre l'affichage de l'écran suivant :
Hotspot Wifi: TeleInfoKit
Clé: ABCD-1234-EF56
Un réseau Wifi portant le SSID TeleInfoKit
a été créé. A l'aide d'un smartphone ou d'un ordinateur, se connecter à ce réseau Wifi. Le mot de passe du hotspot wifi est affiché à l'écran. Il est unique à chaque boitier.
Une fois connecté au réseau wifi avec un smartphone, le captive portail s'affiche.
Il est possible de configurer dès maintenant le serveur MQTT et les réglages pour les données TIC. Pour cela, se référer à la section configuration MQTT et TIC.
Ces réglages seront toujours accessibles une fois le module connecté au réseau WiFi.
Cliquer sur le bouton "Configure Wifi" pour faire apparaître la liste des réseaux wifi à portée (l'ESP-01 est compatible WiFi 2.4GHz seulement), puis :
- Taper le nom du réseau dans le champ SSID ou le sélectionner dans la liste.
- Saisir le mot de passe du réseau wifi
Cliquer sur Save
. Le module va afficher un message de confirmation puis continuer le démarrage avec un message Configuration reseau ok
.
Le point d'accès wifi se désactive.
Note: Le réseau wifi utilisé doit avoir accès à internet pour que l'heure puisse être obtenue depuis un serveur NTP.
La configuration est accessible via le bouton Setup
la page principale
Il existe deux mode TIC : Historique et Standard. Les anciens compteurs électroniques blanc génèrent seulement des informations TIC en mode Historique. Les compteurs linky peuvent être en mode Standard ou Historique. Le mode Standard envoie des informations plus nombreuses et plus précises que le mode Historique. Il est possible de demander à son fournisseur d'électricité de changer ce mode.
Sélectionner le mode TIC adapté au compteur en cochant la case Mode TIC Standard
si le compteur est paramétré en mode Standard ; laisser la case décochée si le compteur est en mode historique.
Le mode TIC courant sera affiché à gauche de l'écran du TeleInfoKit qui affiche le graphe (voir section Ecran historique).
Pour vérifier si votre compteur est en mode TIC Historique ou Standard, sur l'écran de celui-ci il sera affiché
Historique mode TIC
ouStandard mode TIC
en appuyant quelques fois sur son bouton.
- Saisir l'adresse du serveur mqtt (ip ou alias dns)
- Saisir le login et le mot de passe du serveur MQTT (Si pas de login/mot de passe, laisser à vide)
- Pour limiter la fréquence d'envoi des données via MQTT, saisir un délai (en secondes). La valeur
0
ou un champ vide signifie un envoi en temps réel.
Note: Quelques secondes après le démarrage, l'ensemble des données est envoyé afin de resynchroniser les éventuels systèmes à l'écoute sur toutes les valeurs.
Note: Que ce soit en mode temps réel ou avec un délai défini, seules les données mises à jour sont envoyées.
Note: En mode temps réel, les données sont transmises au rythme des trames envoyées par le compteur, soit environ toutes les 1 à 2 secondes.
Si le serveur MQTT n'est pas accessible ou en cas d'erreur dans l'ip, login ou mot de passe MQTT, un message d'erreur s'affichera. Le démarrage se poursuit dans tous les cas, et le module reste accessible via son portail de configuration.
Pour corriger la configuration MQTT, suivre la procédure de Configuration MQTT et TIC ou bien réinitialiser le module.
Si le paramétrage wifi est incorrect, le module ne poursuit pas son démarrage. Le point d'accès reste actif et la procédure est à recommencer. Si le point d'accès wifi TeleInfoKit
ne réapparaît pas, il peut être nécessaire de redémarrer le module.
Se référer au document Messages MQTT pour toutes les informations sur la structure des topics et le contenu des messages.
L'écran affiche différentes informations à travers plusieurs "pages". Pour passer d'une page à la suivante, effectuer un appui court le bouton du module. Les écrans vont défiler en boucle.
Un double clic permet de revenir au premier écran (Historique) depuis n'importe quel écran.
L'écran s'éteindra de lui même au bout d'une minute afin de limiter l'usure des pixels et éviter les effets de marquage. Pour réactiver l'écran, appuyer sur le bouton.
Ce premier écran rassemble un grand nombre d'informations. La zone principale est occupée par un graphe de la consommation sur les dernières 24h.
A chaque barre correspond 1 heure. Les barres à gauche sont les plus anciennes, la barre la plus à droite est l'heure courante. La hauteur de la barre indique le nombre de Wh consommés sur cette période d'une heure (HC + HP).
La barre horizontale à droite indique la hauteur maximale des barres du graphe. Le nombre indiqué sous cette barre (2864Wh sur l'exemple ci-dessous) indique la consommation max sur une période d'une heure au cours des dernières 24h. Cela sert donc d'échelle pour le graphe, cette valeur étant la consommation associée à la barre la plus haute du graphe.
Le graphe est optimisé pour occuper le maximum de hauteur possible à l'écran. L'échelle (la plus grande consommation par tranche d'une heure) s'adapte donc au fur et a mesure du temps.
Au fil des heures, le graphe se décale vers la gauche, les nouvelles valeurs de consommation poussant les anciennes.
Dans le coin supérieur droit, la puissance consommée à l'instant t est affichée (ici 2985VA). Sa valeur est mise à jour en continu, environ toutes les 1 à 2 secondes.
Dans le coin haut gauche se trouve l'indication du mode TIC. Pour le mode Standard, un S
apparait dans un carré, pour le mode Historique ce sera un H
.
Après un redémarrage, le graphe est vide, il se reconstruit au fil des heures.
Cet écran affiche la puissance consommée actuelle, remontée par le compteur.
Puissance/Intensite
1800VA
8A
Ces valeur sont mises à jour en continu, environ toutes les 2 secondes.
Cet écran affiche les l'identifiant compteur et l'index total en Wh (tag EAST
pour le mode standard, et tag BASE
+ HCHP
+ HPHP
pour le mode Historique).
Compteur 123061855214
Index total 125456987
Sur cet écran, le réseau wifi auquel le module est connecté s'affiche, avec l'IP obtenue sur ce réseau. En dernière ligne l'adresse MAC de l'ESP est affichée, pour lui affecter une IP statique par exemple.
Wifi <nom du reseau>
192.168.1.24
DC:4F:22:B7:27:A3
Les valeurs sont données à titre d'exemple.
Affiche la date et l'heure pour vérifier la bonne connexion réseau.
L'écran est le suivant :
Réinit ? v2.x.xxxxxx
Appui long pour reset...
ABCD-1234-EF56
La version de firmware est affichée sur la première ligne sur la droite.
Sur la dernière ligne se trouve le mot de passe du point d'accès WiFi lorsque celui-ci est actif à la première utilisation du TeleInfoKit ou bien après avoir réinitialisé les paramètres. Ce mot de passe sert aussi pour la mise à jour de firmware.
Le mot de passe n'est composé que de tirets, de chiffres et de lettres majuscules comprises entre A et F (caractères hexadécimaux).
Pour activer la réinitialisation, faire un appui long sur le bouton. La procédure est détaillée dans la section réinitialisation de la configuration.
Un appui court passe à l'écran suivant sans réinitialisation.
Ecran OFF dans 5s.
Appui court pour rallumer.
Sans appui supplémentaire sur le bouton, l'écran va s'éteindre au bout de 5s au lieu d'une minute pour les autres écrans. Un nouvel appui sur le bouton réactive l'écran et passe à la page suivante.
Pour modifier ou supprimer les paramètres (Réseau Wifi, serveur MQTT, authentification, fréquences d'envoi), les étapes sont les suivantes :
- Naviguer jusqu'à l'écran 6
Réinit ? v2.x.xxxxxx
Appui long pour reset...
ABCD-1234-EF56
- Effectuer un appui long
- L'écran va afficher
Appui long pour confirmer
Appui court pour annuler
- Pour revenir en arrière et annuler la procédure, effectuer un clic rapide ou attendre 10s.
- Pour confirmer la réinitialisation, effectuer un nouveau clic long.
- L'écran va afficher successivement
Reinitialisation en cours
puis
Redemarrage
Le module a supprimé toutes ses informations de connexion et va démarrer avec sa configuration d'origine, c'est à dire sans identifiants Wifi ni configuration enregistrée.
Pour enregistrer de nouveaux paramètres de connexion, voir la section Démarrage et Configuration.
Si le module ne démarre plus du tout, il est également possible d'effectuer une remise à zéro complète, avant que celui-ci ne commence sa phase d'initialisation. Cela peut être utile en cas de crash en boucle si une mauvaise configuration a été effectuée, en cas de corruption du fichier de configuration interne, ou tout autre cas de figure non prévu.
Il suffit de presser le bouton frontal une fois dès que l'écran affiche "démarrage" avec la barre de progression, juste après l'écran d'accueil qui indique TeleInfoKit
avec la version du module. Le module peut être redémarré grâce à un appui sur le bouton reset, ou en débranchant et rebranchant sa prise usb.
Si l'appui se fait trop tot, le boîtier va démarrer en mode TEST et ne sera pas connecté au WiFi. Redémarrer et recommencer la procédure. Voir section Mode test.
Attention à ne PAS appuyer sur le bouton AVANT le démarrage du module, celui-ci ne démarrera pas.
Si la demande de réinitialisation est bien prise en compte, l'écran va afficher :
Réinit ? v2.x.xxxxxx
Appui long pour reset...
ABCD-1234-EF56
- Effectuer un appui long
- L'écran va afficher
Appui long pour confirmer
Appui court pour annuler
- Dans ce mode de réinitialisation, un appui court n'annulera pas, mais la procédure de reset sera abandonnée au bout de 10s et le module poursuivra son démarrage.
- Pour confirmer la réinitialisation, effectuer un nouveau clic long.
- L'écran va afficher successivement
Reinitialisation en cours
puis
Redemarrage
Comme lors de la réinitialisation classique, le module a supprimé toutes ses informations de connexion et va démarrer avec sa configuration d'origine, c'est à dire sans identifiants Wifi ni configuration enregistrée.
Pour enregistrer de nouveaux paramètres de connexion, voir la section Démarrage et Configuration.
Un mode de test existe pour vérifier que le signal TIC arrive bien au module et que celui-ci parvient à le décoder. Ce mode de test s'active en appuyant sur le bouton frontal dans la première demi-seconde du démarrage. Lorsque le mode TEST est actif, le module ne se connecte PAS au WiFi, il n'envoie donc aucune information et la mise à jour "Over The Air" est indisponible.
Dans ce mode TEST, l'écran affiche des informations TIC sommaires :
- La puissance instantanée consommée (
SINSTS
pour le mode Standard,PAPP
pour le mode historique) - L'index total (
EAST
pour le mode standard,BASE
+HCHP
+HPHP
pour le mode historique)
L'écran affiche :
TIC TEST [H]
POWER 1234
INDEX 12345698
En haut à droite de l'écran se trouve un H
ou un S
dans un encadré pour indiquer le mode TIC courant (Standard ou Historique). Pour basculer d'un mode à l'autre, cliquer une fois sur le bouton.
Les données vont s'afficher au bout d'une seconde environ et vont se mettre à jour régulièrement.
Pour sortir du mode TEST, redémarrer le module ou attendre 60 secondes sans appui sur le bouton, celui-ci va redémarrer automatiquement en mode normal.
Le module n'expose plus d'API HTTP REST depuis la version 2.0 du firmware pour des raisons de simplification et d'optimisation du code, et du peu d'utilité que cette fonctionnalité apportait.
Le portail web des firmwares 1.x qui présentait un graphe des consommation sur une page web n'est pas présent depuis la version 2.0 du firmware pour des raisons de simplification et d'optimisation du code, et du peu d'utilité que cette fonctionnalité apportait.