add some documentation

Description.txt

@@ -0,0 +1,60 @@
+Le but de ce projet est de réaliser un thermostat pour contrôler des radiateurs électriques via leur fil pilote.
+
+Ce projet est très largement inspiré de :
+https://www.fraifrai.net/index.php?pages/Mon-projet-domotique-libre
+Donc, un grand merci à Alex G. et Fraifrai
+
+
+Il est composé de deux parties principales :
+- La partie hardware qui pilote le chauffage via son fil pilote.
+- La partie thermostat proprement dite (sur une raspberry pi par exemple.)
+
+En gros, ça donne :
+---------------         ---------------         ---------------              --------------
+|             |  MQTT   |             |  MQTT   |             |  fils pilote |            |
+| Rpi/ IHM Qt |---------| Mosquitto   |---------|  ESP12F     |--------------| Radiateurs |
+|             |         |             |         |             |              |            |
+---------------         ---------------         ---------------              --------------
+      |
+      | Bluetooth Le 4.1
+      |
+-------------------------------------
+|                                   |
+| Thermomètres/Hygromètres (Xiaomi) |
+|                                   |
+-------------------------------------
+
+Il faut mettre un thermomètre par zone que l'on veut piloter.
+J'ai choisi des thermomètres chez xiaomi (https://maison-de-geek.com/2018/01/test-lhygrothermometre-de-chez-xiaomi/), mais on peut choisir un peu ce que l'on veut, pourvu que l'on puisse récupérer la température via MQTT.
+
+Sur la raspberry Pi, il y a un service qui va jouer le rôle de passerelle bluetooth vers MQTT pour les thermomètres.
+TODO: voir https://github.com/algirdasc/xiaomi-ble-mqtt
+
+Ensuite un logiciel avec une jolie interface sur la Rpi permet de configurer la température dans chaque zone, les plages horaires etc
+TODO: faire ce logiciel...
+TODO: c'est peut être mieux si on sépare la partie thermostat de la partie IHM pour pouvoir faire coexister plusieurs IHM en même temps (genre écran de la RPI + IHM web + appli smartphone etc.)
+
+Enfin, l'ESP12F est à l'écoute des ordre d'allumage et d'extinction des radiateurs sur un topic MQTT.
+
+
+Pilotage du radiateur
+=====================
+
+Pour piloter un radiateur, il faut lui envoyer des ordres via son fil pilote.
+Les ordres de bases sont :
+- 0V => mode "confort"
+- 220V alternatif => mode "éco" (généralement, c'est le mode confort -3°C)
+- 220V alternatif avec les seules alternances négatives : hors gel
+- 220V alternatif avec les seules alternances positives : arrêt
+Il y a 2 autres modes qui correspondent à confort -1°C et -2°C, mais elles sont rarement implémentées.
+
+Pour ce projet, comme nous voulons refaire un thermostat, nous aurons simplement besoin de confort et arrêt.
+Donc, soit 0V, soit 220V+diode.
+
+Pour couper le 220V, nous nous servons d'un MOC3043 piloté par un ESP12F.
+Il n'y a pas besoin de passer par un transistor supplémentaire car l'ESP12F peut fournir assez de courant sur une GPIO pour piloter ce MOC.
+
+L'ordre de marche ou arrêt est envoyé à l'ESP12F via MQTT.
+Le PCB est fourni dans kicad/schematics/heating_control
+Il permet de piloter 4 chauffages, mais il peut être facilement étendu à 5, voire 7. (Tant qu'il y a des GPIOs de disponibles).
+