Loading 3D model… large boards can take a moment.
Moniteur open-hardware basse consommation à base d'ESP32 pour le compteur électrique Linky (monophasé), avec intégration native à Home Assistant via MQTT.
LinKey (jeu de mot) lit la sortie série TIC (Télé-Information Client) d'un Linky monophasé et publie les mesures de puissance, d'énergie et de courant vers le broker MQTT de votre Home Assistant. Le coprocesseur ULP de l'ESP32 décode la trame TIC pendant que le CPU principal reste en light sleep, ce qui maintient une consommation moyenne suffisamment faible pour fonctionner sur l'alimentation de la TIC via une supercapa.
.
├── CAO/ Boîtier imprimable 3D (source STEP + modèle Onshape)
├── Doc/ Spécification TIC Linky et documents de référence
├── Firmware/ Projet ESP-IDF (ULP + machine d'état CPU, WiFi/MQTT)
└── PCB/ Projet KiCad, schéma, Gerbers
Le firmware est un projet ESP-IDF situé dans Firmware/. Consultez Firmware/README.md pour le guide complet de compilation, flashage et configuration.
Démarrage rapide :
git clone --recurse-submodules https://github.com/Konkzor/LinKey.git
cd LinKey/Firmware
source ~/esp/v5.4.1/esp-idf/export.sh
idf.py menuconfig # Configurer l'appareil et les options MQTT
idf.py -p /dev/ttyUSB0 flash monitor
Les identifiants WiFi sont provisionnés ensuite en BLE via l'application Espressif. Le firmware tente de découvrir Home Assistant en mDNS pour construire automatiquement l'URI MQTT (mqtt://<ha-ip>:1883), puis utilise mqtt://homeassistant.local:1883 comme solution de repli.
L'identité MQTT par défaut est dérivée de l'adresse MAC WiFi : utilisateur linkey_<suffixe_mac> et topics linkey/<suffixe_mac>/..., par exemple linkey/8ebde0/state.
Le PCB a été réalisé sous KiCad 9.
Les sources de la carte se trouvent dans PCB/. Voir PCB/README.md pour une description des composants, le brochage de l'ESP32 et la connexion TIC.
PCB/LinKey.kicad_proPCB/MCAD files/Note : Les fichiers de fabrication et la nomenclature ne sont pas versionnés dans le repo. Ils sont disponibles en artefacts des jobs de la CI ainsi que dans la page Releases pour les versions taguées.
Le boîtier est conçu sous Onshape et imprimable en 3D.
Les sources se trouvent dans CAO/. Voir CAO/README.md pour le lien vers le modèle Onshape et les paramètres d'impression conseillés.
Ce projet utilise une double licence selon la nature des fichiers :
Le matériel (PCB/ : sources KiCad, Gerbers… et CAO/ : modèles 3D du boîtier, pièces mécaniques) est distribué sous CERN Open Hardware Licence Version 2 – Weakly Reciprocal (CERN-OHL-W-2.0).
Vous êtes libre d'utiliser, d'étudier, de modifier et de fabriquer ce matériel. Si vous modifiez les fichiers de conception eux-mêmes, vous devez publier ces modifications sous la même licence. En revanche, vous n'êtes pas tenu de publier les sources de produits plus larges qui ne font qu'incorporer cette conception.
Texte complet : LICENSE (EN).
Le code du firmware (Firmware/main/) est distribué sous licence MIT, plus permissive et adaptée au logiciel.
Texte complet : Firmware/LICENSE (EN).
No comments yet. Be the first to ask about this board.