diff --git a/NOTICE b/NOTICE new file mode 100644 index 0000000..91dbb02 --- /dev/null +++ b/NOTICE @@ -0,0 +1,8 @@ +pyMHCgui — Interface de développement et débogage des contrôleurs de chauffe MHC +Copyright (C) 2025 Jonathan Roth / 462engineering + +Publié sous licence GNU Affero General Public License 3.0 +Vous pouvez redistribuer et modifier ce logiciel selon ses conditions. + +Ce projet peut inclure ou utiliser des bibliothèques tierces. +Chacune d’elles reste soumise à sa propre licence. diff --git a/README.md b/README.md index e69de29..d960b64 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,45 @@ +# pyMHCgui + +**pyMHCgui** est une interface graphique de développement et de débogage pour les **contrôleurs de chauffe MHC**. +Elle permet : + +- De visualiser en temps réel l’état du contrôleur, +- De surveiller la température actuelle et la température cible, +- D’activer ou désactiver les zones de chauffe, +- De contrôler l’état général de la chauffe (start/stop), +- De modifier la température cible, +- De diagnostiquer rapidement les erreurs renvoyées par le système. + +L’interface est développée en **Python**, avec **Tkinter**, et communique en TCP/IP avec un contrôleur MHC via un protocole simple basé sur l’envoi de commandes sur socket TCP. + +**ATTENTION: CET OUTIL N'A PAS VOCATION A ÊTRE UTILISÉ EN PRODUCTION. AUCUN SUPPORT NI AUCUNE GARANTIE DE FONCTIONNEMENT NE PEUVENT ÊTRE ATTENDUS POUR CET OUTIL, Y COMPRIS SI VOUS DISPOSEZ D'UNE GARANTIE EN VIGEUR OU D'UN CONTRAT QUELCONQUE RELATIFS AU CONTROLEUR MHC ET/OU AUX CARTES MHC.** + +--- + +## ✨ Fonctionnalités principales + +- 🔌 Connexion TCP/IP au contrôleur MHC (port **4623**) +- 🧭 Visualisation de l’état général +- 🌡 Affichage des températures sous forme de tableau (une zone par **ligne**) +- 🟩 État des cartes de contrôle (2 cartes) +- 🟦 État des zones de chauffe (4 zones) +- 🔥 Contrôle de la chauffe (start/stop) +- 🎯 Modification de la température cible +- 🔧 Configuration de l’adresse IP au lancement + +--- + +## 📦 Installation + +### Prérequis + +- Python **3.8+** +- Un contrôleur MHC accessible sur le réseau (soit fonctionnel, soit en mode simulation) + +Les dépendances utilisées sont toutes issues de la bibliothèque standard : + +- `tkinter` +- `socket` +- `threading` +- `json` +- `time`