add notice and readme

This commit is contained in:
Jonathan Roth 2025-11-27 11:26:34 +01:00
parent b652181ec8
commit 1195fbca34
2 changed files with 53 additions and 0 deletions

8
NOTICE Normal file
View File

@ -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 delles reste soumise à sa propre licence.

View File

@ -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,
- Dactiver 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.
Linterface est développée en **Python**, avec **Tkinter**, et communique en TCP/IP avec un contrôleur MHC via un protocole simple basé sur lenvoi 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 ladresse 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`