diff --git a/docs/fr/CHANGELOG.md b/docs/fr/CHANGELOG.md new file mode 100644 index 00000000..39d04616 --- /dev/null +++ b/docs/fr/CHANGELOG.md @@ -0,0 +1,525 @@ +# ChangeLog # + +## Current Master ## + +- **ATTENTION : CHANGEMENT CASSANT !** Structure de sujet rationalisée pour MQTT. La nouvelle structure ajoute `/status` pour interroger un paramètre, `/set` pour définir un paramètre, `/inf` pour envoyer des données sous la forme d'un télégramme INF et `/poll` pour forcer BSB-LAN à envoyer une mise à jour de la valeur du paramètre au courtier. Si vous utilisez la découverte automatique MQTT, idéalement, l'appel de `/M1` devrait mettre à jour ces changements. Cependant, si vous utilisez vos propres configurations, vous devrez apporter des ajustements ici. +- **ATTENTION : CHANGEMENT CASSANT !** Lorsque vous utilisez des paramètres JSON pour MQTT, auparavant, tous les messages étaient écrits dans `BSB-LAN/json` et donc fondamentalement immédiatement remplacés lorsque plusieurs paramètres étaient enregistrés. Ce paramètre détermine désormais uniquement le format (et non le format et le sujet) des données qui sont écrites dans `/status` de chaque paramètre. Pour la découverte automatique, le texte brut reste le seul choix valide. +- **ATTENTION : CHANGEMENT CASSANT** Le message d'accusé de réception envoyé par BSB-LAN au sujet `MQTT` a été supprimé. Au lieu de cela, la QoS pour la publication des messages a été définie au niveau 1. +- **ATTENTION : CHANGEMENT CASSANT :** Les valeurs de configuration du journal ont changé. Cependant, seuls les utilisateurs qui se sont connectés à UDP sont concernés et devront ajuster leurs paramètres. +- Ajout d'un paramètre pour publier uniquement les paramètres de journalisation sur MQTT. Les mises à jour MQTT forcées via le sujet `/poll` sont toujours possibles. +- Ajout de state_class pour les capteurs non cumulatifs dans la découverte automatique MQTT +- Mise à jour de l'émulation de l'unité de pièce dans `custom_functions` pour fonctionner avec la version 4.x. +- Correction d'un bogue pour VT_ENERGY, ajout de nouveaux types de données VT_ENERGY10 et VT_ENERGY10_N + +## Version 4.1 ## +**06.11.2024** + +- **ATTENTION : CHANGEMENT CASSANT !** Structure de sujet modifiée pour MQTT. Cela signifie que toutes les entités MQTT existantes dans votre système de domotique devront être ajustées ou recréées ! La nouvelle structure est désormais `BSB-LAN///`. +- **ATTENTION : CHANGEMENT CASSANT !** L'identifiant unique pour la découverte automatique MQTT a été modifié. Cela signifie que toutes les entités MQTT qui ont été créées via la découverte automatique devront être recréées ! +- **ATTENTION :** Les options de configuration `fixed_device_family` et `fixed_device_variant` ont été supprimées car elles ne fonctionnent plus pour les listes de paramètres spécifiques aux appareils. Si votre système de chauffage est éteint lorsque vous allumez le microcontrôleur, BSB-LAN essaiera d'obtenir les détails toutes les 60 secondes. +- **ATTENTION :** Le changement des options de configuration entraîne une nouvelle disposition de l'EEPROM, l'EEPROM sera donc réinitialisée en fonction de la configuration de `BSB_LAN_config.h`. +- La découverte automatique MQTT fonctionne désormais pour tous les appareils, et pas seulement pour l'ID d'appareil 0. Utilisez `/M1!` ou `/M0!` pour créer/supprimer des entités pour l'ID d'appareil ``. +- Le drapeau des messages de découverte automatique MQTT a été modifié en "retain" afin que les paramètres restent disponibles après le redémarrage de Home Assistant. + +## Version 4.0 ## +**01.11.2024** + +- **ATTENTION : CHANGEMENT CASSANT !** Le paramètre de température de la pièce 10000, 10001 et 10002 doit désormais avoir le drapeau supplémentaire `FL_SPECIAL_INF`, sinon la température de consigne ne fonctionnera pas ! +- **ATTENTION : CHANGEMENT CASSANT !** Le paramètre de simulation de la température extérieure 10017 doit avoir le drapeau `FL_SPECIAL_INF` supprimé, sinon la température de consigne ne fonctionnera pas ! +- **ATTENTION : CHANGEMENT CASSANT !** Le paramètre de température de la pièce 10000, 10001 et 10002 pour les appareils de chauffage Weishaupt (familles d'appareils 49, 50, 51 et 59) doit désormais avoir le drapeau `FL_SPECIAL_INF` supprimé, sinon la température de consigne ne fonctionnera pas ! +- **ATTENTION : CHANGEMENT CASSANT !** Les commandes d'URL `/U` (afficher les variables définies par l'utilisateur) et `/X` (afficher les valeurs MAX !) ont été supprimées car ces valeurs peuvent désormais être accessibles via les paramètres 20000++ +- **ATTENTION : CHANGEMENT CASSANT !** Les paramètres du programme horaire PPS (15050-15091) ont été rationalisés avec les paramètres du programme horaire BSB/LPB, ce qui a permis d'obtenir un seul paramètre par jour (au lieu de six), couvrant trois points de commutation (début et fin) par paramètre. +- **ATTENTION :** Pour ESP32, BSB-LAN nécessite la version 3.0.x du framework ESP32 - veuillez rechercher les erreurs ou les comportements étranges (les capteurs 1-Wire n'ont pas encore été testés) ainsi que tout autre type de comportement étrange/plantages. +- **ATTENTION :** Nouvelles options de configuration dans `BSB_LAN_config.h` - veuillez mettre à jour vos fichiers de configuration existants ! La configuration basée sur le Web sera écrasée par les paramètres du fichier de configuration en raison d'un changement dans la disposition de l'EEPROM ! +- **ATTENTION :** Nouveau manuel d'utilisation : https://docs.bsb-lan.de/ +- Les boutons et `RGT_EMULATION` ont été déplacés du code principal vers la bibliothèque `custom_functions`. Pour continuer à les utiliser, utilisez les fichiers `BSB_LAN_custom_*.h` et activez la définition `CUSTOM_COMMANDS`. +- La plupart des définitions de configuration ont été supprimées de `BSB_LAN_config.h`. Presque toutes les fonctionnalités peuvent désormais être configurées sans reflash. +- BSB-LAN prend désormais en charge la découverte automatique MQTT (prise en charge, par exemple, par Home Assistant). Pour créer des appareils, appelez la commande d'URL `/M1`, pour les supprimer, appelez `/M0` +- **ATTENTION :** La découverte automatique MQTT crée un commutateur général pour l'appareil BSB-LAN dans Home Assistant. Ce commutateur écrira immédiatement toutes les valeurs de paramètre stockées dans Home Assistant. N'UTILISEZ PAS CE COMMUTATEUR à moins de SAVOIR EXACTEMENT ce qu'il fait ! +- Le bouton "Set" dans l'interface Web fonctionne désormais également avec les appareils de destination non par défaut (c'est-à-dire 1 au lieu de 0) +- Les paramètres interrogés/définis sont désormais transférés au courtier MQTT (si MQTT est activé) +- Les commandes `/M1` et `/M0` précédemment utilisées pour activer/désactiver la fonction de surveillance ont été supprimées car elles peuvent désormais être accessibles via la configuration dans l'interface Web. +- La liste des catégories avec `/K` fonctionne désormais également avec l'appareil de destination (par exemple, /K!1 pour l'appareil de destination 1, la valeur par défaut est 0). +- Correction d'un bogue important pour la mise à jour OTA : les versions précédentes avaient une limite stricte sur la taille du fichier que les systèmes de chauffage plus récents avec plusieurs centaines de paramètres ont atteinte, de sorte qu'aucune mise à jour OTA n'était possible. Ceci est maintenant corrigé, mais les utilisateurs concernés devront effectuer une mise à jour USB une fois de plus. +- Les capteurs 1-Wire et DHT sont désormais désactivés avec la valeur -1 au lieu de 0. Dans l'interface Web, un champ vide est également accepté. +- MQTTTopicPrefix n'est plus facultatif, le sujet "fromBroker" a été supprimé (anciennement utilisé pour envoyer des commandes à BSB-LAN via MQTT) +- L'utilisation de la fonctionnalité des moyennes sur 24 heures ne nécessite plus l'utilisation d'une carte SD. La carte SD ne sera utilisée que pour stocker les moyennes si la journalisation des intervalles sur la carte SD est active. +- Nouvelle variante d'unité de pièce PPS pour RVD130, qui augmente le nibble supérieur du byte magique à chaque transaction. +- L'interrogation de l'heure actuelle auprès d'un serveur NTP est active par défaut. La désactiver en définissant `ntp_server` sur une chaîne vide. +- Nouveau drapeau de paramètre `FL_NOSWAP_QUR` pour les paramètres qui n'échangent pas les deux premiers octets de l'ID de commande dans le télégramme QUR +- Nouveau drapeau de paramètre `FL_FORCE_INF` pour les paramètres dont nous sommes certains qu'ils ne fonctionnent qu'avec INF (tels que la température de la pièce). Forcera un télégramme INF même si `/S` est utilisé pour définir le paramètre (permet de définir la température de la pièce via l'interface Web) +- Filigrane du logo BSB-LAN dans l'affichage du graphique du journal (DE-cr) +- Les ENUM binaires (oui/non, on/off, etc.) renvoient désormais soit 0 soit 1 lorsqu'ils sont interrogés, et non - comme c'est le cas avec certains systèmes de chauffage - 0 ou 255. La définition de toute valeur de 1 à 255 est toujours possible. +- Correction d'un bogue critique dans PPS qui empêchait son exécution correcte en mode unité active/pièce. +- Correction d'un bogue (ou, selon le point de vue, réduction de la sécurité) qui empêchait l'émission de commandes via la console série/Telnet lorsque l'authentification HTTP était active +- Diverses corrections de bugs, notamment la journalisation des télégrammes de bus sur le périphérique de stockage. +- Nouvelle version de la bibliothèque OneWireNg +- Cette version a été soutenue par les sponsors suivants : Erich Scheilko + +## Version 3.3 ## +**12.03.2024** + +- **ATTENTION :** Nouvelles options de configuration dans `BSB_LAN_config.h` - veuillez mettre à jour vos fichiers de configuration existants ! +- ESP32 : prise en charge de la réception de la date et de l'heure via NTP au lieu de les obtenir à partir du chauffage. +- Le paramètre du courtier MQTT accepte désormais les noms de domaine ainsi que les adresses IP. Un port facultatif peut être ajouté après un deux-points, par exemple broker.my-domain.com:1884. Sinon, la valeur par défaut est 1883. +- ESP32 NodeMCU : prise en charge d'un adaptateur de carte SD supplémentaire facultatif. Les broches SPI peuvent être configurées dans `BSB_LAN_config.h`, par défaut sur les broches SPI standard 5, 18, 19 et 23. +- ESP32 : Le passage d'un périphérique de stockage de journal (carte SD/flash interne) à un autre peut désormais être effectué dans l'interface Web. +- ESP32 : Créer un point d'accès WiFi temporaire en cas de défaillance de la connexion Ethernet +- ESP32 NodeMCU : La broche de réinitialisation de l'EEPROM est passée de 18 à 21 pour éviter les collisions avec les adaptateurs de carte SD SPI. +- Cette version a été soutenue par les sponsors GitHub suivants : jsimon3 + +## Version 3.2 ## +**15.11.2023** + +- **ATTENTION :** Dans `BSB_LAN_config.h`, la nouvelle disposition de `log_parameters`, `avg_parameters` et `ipwe_parameters` est désormais écrite entre accolades et de taille différente (40 au lieu de 80) et de type (`parameter` au lieu de `float`). Veuillez mettre à jour votre `BSB_LAN_config.h` en conséquence pour éviter les erreurs ! +- Ajout de vérifications de version de fichier de configuration pour empêcher l'utilisation de fichiers de configuration obsolètes avec de nouvelles versions logicielles. +- La variable `esp32_save_energy` est désormais définie par défaut sur false car elle ne semble avoir de sens que lorsque l'on utilise une connexion LAN ou si l'on utilise le WiFi et que l'on peut vivre avec l'impact sur les performances. +- Ajout du dossier `custom_functions` où seront collectés des exemples de code pour des fonctions utiles qui sont néanmoins trop spécifiques pour être ajoutées au code principal de BSB-LAN. +- Ajout d'un exemple de fonction personnalisée pour la cartographie des capteurs DS18B20 sur des paramètres de nombres à virgule flottante personnalisés +- Cette version a été soutenue par les sponsors GitHub suivants : BraweProg, fdobrovolny, Harald + +## Version 3.1 ## +**04.06.2023** + +- **ATTENTION :** Pour les appareils ESP32 utilisant la flash interne pour le stockage des journaux : le système de fichiers est passé de SPIFFS à LittleFS. Téléchargez les données de journal importantes avant de mettre à jour ! +- **ATTENTION :** Dans `BSB_LAN_config.h`, la structure de `log_parameters`, `avg_parameters` et `ipwe_parameters` a changé et inclut désormais l'appareil de destination sur le bus ! +- **ATTENTION :** Le nouveau schéma d'EEPROM peut entraîner la perte des paramètres de configuration Web lors de la mise à jour. Notez vos paramètres avant de mettre à jour ! +- **ATTENTION :** Nouvelle variable `esp32_save_energy` dans `BSB_LAN_config.h` - mettez à jour avant de compiler la nouvelle version. +- **ATTENTION :** Nouvelle variable bssid dans `BSB_LAN_config.h` - définit une adresse BSSID fixe à laquelle se connecter lors de l'utilisation du WiFi sur ESP32. +- Les paramètres peuvent désormais être interrogés à partir d'autres appareils sur le bus à l'aide de la notation ! également lors de la journalisation (y compris MQTT) ou lors de l'utilisation de paramètres de moyenne ou de IPWE +- Activer/désactiver l'économie d'énergie sur ESP32. Économise 20 % d'énergie, mais peut avoir un impact sur la portée WiFi et la vitesse de téléchargement des fichiers de journal lorsque vous utilisez le WiFi (LAN non affecté) +- Amélioration des performances et de l'utilisation de la mémoire flash sur les appareils ESP32 utilisant la flash interne pour la journalisation grâce au passage de SPIFFS à LittleFS +- Pour améliorer la gestion des grands journaux de données : sélection de la plage de dates dans `/DG`, nouvelles commandes d'URL `/Da,b`, `/DA`, `/DB`, `/Dn`, `/DI` et `/DKn` +- Cette version a été soutenue par les sponsors GitHub suivants : lapixo, nrobadey + +## Version 3.0 ## +**16.03.2023** + +- **ATTENTION :** `BSB_LAN_custom_defs.h`.default doit être renommé en `BSB_LAN_custom_defs.h` et ne contient qu'un ensemble très limité de paramètres par défaut. Consultez le manuel pour obtenir des listes de paramètres spécifiques aux appareils. +- Ajouter la nouvelle commande d'URL `/LN` pour forcer la journalisation indépendamment de l'intervalle actuel. +- Amélioration des vérifications de la bibliothèque : les utilisateurs d'ESP32 n'ont plus besoin de supprimer les dossiers ArduinoMDNS et WiFiSpi. +- Nouvelle version de SdFat 2 pour Arduino Due +- Nouveau type de données `VT_BINARY_ENUM` +- Cette version a été soutenue par les sponsors GitHub suivants : Alex, DE-cr + +## Version 2.2 ## +**01.11.2022** + +- **ATTENTION :** Plusieurs variables dans `BSB_LAN_config.h`.default ont changé de type de variable, il est probablement préférable de recréer votre `BSB_LAN_config.h` à partir de zéro. +- Les numéros de paramètre sont désormais à virgule flottante (c'est-à-dire XXXX.Y) car certains paramètres contiennent deux types d'informations différents. Ils sont désormais affichés par incréments décimaux de 0,1. Vous pouvez toujours interroger le paramètre "principal" via XXXX (sans .Y) +- De nombreux correctifs de bugs et de nouveaux types de données +- Les listes de paramètres spécifiques aux appareils sont prises en charge + +## Version 2.1 ## +**30.07.2022** + +- De nombreux nouveaux paramètres pour LMU64 +- **ATTENTION :** Nouvelles catégories pour les contrôleurs LMU64 et RVD/RVP en raison de leurs systèmes de numérotation différents. Ils seront remplis au fil du temps. Les catégories PPS et capteurs ont été déplacées de deux positions. +- ESP32 : OTA utilise désormais les informations d'identification d'authentification HTTP système-wide +- Amélioration de l'affichage intégré des graphiques `/DG`, nouvelle définition de configuration `#define USE_ADVANCED_PLOT_LOG_FILE` - grâce à Christian Ramharter +- Ajout d'une journalisation facultative via la diffusion +- Si BSB-LAN ne parvient pas à se connecter au Wi-Fi sur ESP32, il configurera son propre point d'accès « BSB-LAN » avec le mot de passe « BSB-LPB-PPS-LAN » pendant 30 minutes. Après cela, il redémarrera et tentera de se reconnecter. +- Nouvelles fonctions MQTT, y compris la possibilité de définir n'importe quel paramètre par un message MQTT et d'interroger activement n'importe quel paramètre une fois en envoyant un message MQTT. +- Prise en charge ajoutée pour les capteurs BME280. +- Définition d'une adresse de destination temporaire pour l'interrogation des paramètres en ajoutant « !x » (où « x » est l'ID de destination), par exemple « /6224!10 » pour interroger l'identification de l'unité d'affichage. +- Les commandes URL « /A », « /B », « /T » et « /JA » ont été supprimées car tous les capteurs peuvent désormais être accessibles via les numéros de paramètre 20 000 et plus, ainsi que (actuellement) sous la nouvelle catégorie K49. +- De nouvelles catégories ont été ajoutées, les catégories suivantes ont été décalées vers le haut. +- L'authentification HTTP utilise désormais un nom d'utilisateur et un mot de passe en texte clair dans la configuration. +- Les utilisateurs de PPS peuvent désormais envoyer l'heure et le jour de la semaine au chauffage. +- De nombreux nouveaux paramètres ont été ajoutés. +- La commande URL « /JR » permet d'interroger la valeur standard (réinitialisée) d'un paramètre au format JSON. +- La commande URL « /JB » permet de sauvegarder les paramètres dans un fichier JSON. +- La nouvelle bibliothèque pour DHT22 devrait fournir des résultats plus fiables. +- Types de données et de valeurs consolidés: nouveaux types de données « VT_YEAR », « VT_DAYMONTH » et « VT_TIME » en tant que sous-ensembles de « VT_DATETIME » pour les paramètres 1-3, en remplaçant « VT_SUMMERPERIOD » et en ajustant « VT_VACATIONPROG ». Nouveaux types de valeurs « DT_THMS » pour l'heure composée de heures:minutes:secondes. +- MQTT: utilisez « MQTTDeviceID » comme ID client pour le courtier, qui par défaut est toujours « BSB-LAN ». ATTENTION: Vérifiez votre configuration si votre courtier dépend de l'ID client de quelque manière que ce soit pour l'autorisation, etc. + +## Version 1.1 ## +**10.11.2020** + +- **ATTENTION:** le paramètre Push ECS (« Trinkwasser Push ») a dû être déplacé de 1601 à 1603 car 1601 a une signification « officielle » différente sur certains appareils de chauffage. Veuillez vérifier et modifier votre configuration si nécessaire. +- **ATTENTION:** de nouvelles catégories ont été ajoutées, la plupart des numéros de catégorie (en utilisant « /K ») seront décalés de quelques numéros. +- La commande URL « /JA » affiche les valeurs moyennes. +- De nombreux nouveaux paramètres décodés. +- Nouveaux paramètres pour les familles d'appareils 25, 44, 51, 59, 68, 85, 88, 90, 96, 97, 108, 134, 162, 163, 170, 195, 209, 211. +- Amélioration de l'affichage mobile de l'interface Web. +- Ajout de la définition « BtSerial » pour détourner la sortie série vers Serial2 où un adaptateur Bluetooth peut être connecté (5V->5V, GND->GND, RX->TX2, TX->RX2). L'adaptateur doit être en mode esclave et configuré à 115 200 bps, 8N1. +- De nombreuses traductions polonaises ajoutées. +- Nouveaux types de données « VT_BYTE10 » et « VT_SPF ». +- Correction d'un bogue concernant l'affichage des programmes de temps de chauffage sur le bus PPS. +- Correction d'un bogue MQTT. + +## Version 1.0 ## +**03.08.2020** + +- La commande URL « /JI » affiche la configuration au format JSON. +- La commande URL « /JC » obtient la liste des valeurs possibles à partir d'une liste de fonctions définies par l'utilisateur. + Exemple: « /JC=505,700,701,702,711,1600,1602 ». +- Les télégrammes de journalisation (paramètre de journalisation 30 000) écrivent désormais dans un fichier séparé (« journal.txt »). Il peut être réinitialisé avec la commande « /D0 » (en même temps que datalog.txt) et vidé avec la commande « /DJ ». +- La configuration Wi-Fi a été supprimée car elle n'est plus applicable pour le Due. +- De nombreux nouveaux paramètres pour diverses familles d'appareils. +- Optimisation et restructuration du code, augmentation générale de la vitesse. +- Nouveaux schémas pour la disposition de la carte V3. +- De nombreux bogues corrigés. + +## Version 0.44 ## +**11.05.2020** + +- Ajout de la fonctionnalité de serveur Web via une carte SD et diverses autres améliorations de l'utilisateur GitHub dukess. +- Ajout d'une sortie JSON pour MQTT. +- Interface Web plus conviviale pour les appareils mobiles. +- Plus de paramètres et de familles d'appareils. +- Dernière version entièrement testée sur Mega 2560. Les futures versions pourront toujours s'exécuter sur la Mega, mais ne seront testées que sur l'Arduino Due. + +## Version 0.43 ## +**20.02.2020** + +- Prise en charge ajoutée pour HardwareSerial (Serial1) connexion de l'adaptateur. Utilisez l'épingle RX 19 dans la définition du bus pour l'activer. Consultez le manuel/forum pour plus de détails matériels. +- Ajout de la définition DebugTelnet pour détourner la sortie série vers un client Telnet (port 23, sans mot de passe) dans « BSB_LAN_config.h ». +- Ajout de la possibilité de contrôler BSB-LAN (presque) complètement via le port série USB. La plupart des commandes sont prises en charge comme leurs homologues URL, c'est-à-dire « //xxx » pour interroger le paramètre xxx ou « //N » pour redémarrer l'Arduino. +- Changement de l'ID d'appareil par défaut de 6 (contrôleur de pièce « RGT1 ») à l'ID inutilisé 66 (« LAN »). +- De nombreux nouveaux paramètres, exécutez « /Q » pour voir les éventuels changements pour votre famille d'appareils et nous faire un rapport! +- Ajout de variables globales (tableaux de 20 octets) « custom_floats[] » et « custom_longs[] » pour une utilisation avec « BSB_LAN_custom.h », par exemple pour lire des capteurs, etc. + La sortie de ces variables se fait via la nouvelle commande URL « /U ». +- Ajout des familles d'appareils 23 et 29 (chaudières Grünenwald). +- Ajout des familles d'appareils 49, 52, 59 (chaudières Weishaupt). +- Ajout des familles d'appareils 91, 92, 94, 118, 133, 136, 137, 165, 184, 188 (divers contrôleurs tels que QAA75 ou AVS37). +- Ajout de la famille d'appareils 171 (système de granulés de bois Bösch). +- Ajout de la famille d'appareils 172 (SensoTherm BLW Split B (RVS21.826F/200)). +- Ajout des familles d'appareils 186 et 164 (Olymp WHS-500). +- Ajout de la variante 2 de la famille d'appareils 195 (Thision 19 Plus / LMS14.111B109). +- Inclusion des paramètres DHT, 1Wire et de l'état du brûleur (>20000) dans MQTT. +- L'anglais est maintenant la langue par défaut. +- Mise à jour de diverses traductions. +- Ajout de fichiers STL pour imprimer un boîtier avec une imprimante 3D (grâce à l'utilisateur FHEM EPo!). +- Déplacement de tous les capteurs vers « /T », « /H » n'est plus utilisé. +- Nouveaux paramètres virtuels 702/703 pour le contrôleur de pièce Weishaupt. +- Nouveau paramètre virtuel 10003 pour définir la température extérieure sur les systèmes plus récents. +- Ajout de descriptions de texte pour les phases d'erreur (6706 et suivantes). +- « /Q » est maintenant plus complet. +- Nouveaux types de données « VT_CUSTOM_ENUM » et « VT_CUSTOM_BYTE » pour extraire des informations de télégrammes non standard (tels que 702/703). +- Correction d'un bogue: implémentation DHCP (Ethernet). + +## Version 0.42 ## +**21.03.2019** + +- Ajout de la localisation! Vous pouvez maintenant aider à traduire BSB-LAN dans votre langue! Il vous suffit de copier l'un des fichiers de langue du dossier de localisation (« LANG_DE.h » est le plus complet) et de traduire ce que vous pouvez. Les éléments non traduits seront affichés en allemand. + Attention: la définition de la langue dans « BSB_LAN_config.h » est désormais « #define LANG ». + Par exemple: « #define LANG DE ». +- Ajout d'une exportation vers un courtier MQTT, utilisez « log_parameters »[] dans « BSB_LAN_config.h » pour définir les paramètres et activer la définition « MQTTBrokerIP ». +- Ajout de la prise en charge des modules Wi-Fi tels qu'un ESP8266 ou un Wemos Mega connecté à Serial3 (RX:15/TX:14) de l'Arduino. + L'ESP8266 doit être flashé avec le microprogramme AT d'Espressif pour fonctionner. + Veuillez noter que le Wi-Fi via la série est, par conception, beaucoup plus lent (seulement 115 kpbs) que les connexions TCP/IP « pures ». +- Ajout d'une nouvelle catégorie « 34 - Konfiguration / Erweiterungsmodule ». Toutes les catégories suivantes se déplacent d'un numéro vers le haut! +- De nombreux nouveaux paramètres provenant de la famille d'appareils 123, exécutez « /Q » pour voir si certains paramètres fonctionnent également pour votre appareil de chauffage! +- De nombreux nouveaux paramètres encore inconnus via une interrogation par force brute :) (numéros de paramètre 10200 et plus). +- Ajout de nouvelles commandes PPS-Bus, déplacement des numéros de paramètre à 15000 et plus. +- Le mode PPS par défaut est désormais « écoute ». + Utilisez le troisième paramètre de la définition du bus pour passer de l'écoute à la commande, 1 pour la commande, tout le reste pour l'écoute, + c'est-à-dire que BSB bus(68,67,1) envoie des données à la chaudière, BSB bus(68,67) ne reçoit que des données de la chaudière/du contrôleur de pièce. + Vous pouvez passer d'un mode à l'autre à l'exécution avec la commande URL « /P2,x » où x est soit 1 (pour la commande) soit autre chose que 1 (pour l'écoute uniquement). +- Correction d'un bogue qui a provoqué le plantage des requêtes de bus PPS. +- Améliorations de la stabilité pour le bus PPS. +- Amélioration de la légende du graphique lors de la représentation de plusieurs paramètres. +- Ajout d'une exportation JSON; interroger avec « /JQ=a,b,c,d... » ou pousser des requêtes vers « /JQ » ou pousser des commandes set vers « /JS ». +- La journalisation des paramètres MAX! est désormais possible avec le paramètre de journalisation 20007. +- Ajout de la famille d'appareils Waterstage WP (119). +- Ajout de la famille d'appareils WHG Procon (195). +- Ajout de l'unité au fichier journal ainsi qu'à la sortie moyenne. +- Réécriture de l'appariement des appareils dans « cmd_tbl » pour prendre en charge également la variante de l'appareil (Gerätevariante). Exécutez « /Q » pour voir si la transition a fonctionné pour votre appareil! +- Ajout de « BSB_LAN_custom_setup.h » et « BSB_LAN_custom_global.h » pour vous permettre d'ajouter du code individuel (meilleur utilisé en conjonction avec « BSB_LAN_custom.h »). +- Tous les paramètres (connus) OEM ont été marqués avec le drapeau « FL_OEM ». Les paramètres OEM sont par défaut en lecture seule. Pour les rendre accessibles en écriture, changez « FL_OEM » de 5 à 4 dans « BSB_LAN_defs.h ». +- Amélioration des performances pour l'interrogation de plusieurs paramètres à la fois (similaire à la requête de catégorie). +- Ajout d'une option de configuration pour définir le sous-réseau. +- « /Q » n'a plus besoin de « #define DEBUG ». +- Correction d'un bogue d'adressage de mémoire ENUM. +- Correction d'un bogue dans la fonction de réinitialisation « /N », effacement de l'EEPROM pendant la réinitialisation avec « /NE ». +- Ajout de favicon.ico. +- Division de cmdtbl en cmdtbl1 et cmdtbl2 en raison de la limite de taille de struct de 32 Ko d'Arduino, ce qui libère de l'espace pour de nouveaux paramètres. + +## Version 0.41 ## +**17.03.2019** + +- Version intermédiaire contenant tous les changements de la version 0.42 ci-dessus, à l'exception de la localisation, c'est-à-dire que tous les fragments de texte font toujours partie du code principal. + +## Version 0.40 ## +**21.01.2018** + +- Mise en œuvre de l'interrogation des thermostats de chauffage MAX!, affichage avec la commande URL « /X ». + Voir « BSB_LAN_custom.h » pour un exemple d'envoi de la température moyenne de la pièce au système de chauffage. +- Ajout d'une nouvelle catégorie « 22 - Energiezähler » - veuillez noter que toutes les catégories suivantes se déplacent d'un cran vers le haut! +- Nouveau paramètre virtuel 1601 (poussée TWW manuelle). +- Ajout de la famille d'appareils Fujitsu Waterstage WSYP100DG6 (211). +- Ajout de la famille d'appareils CTC (103). +- Nouvelle définition « #define TRUSTED_IP2 » pour accorder l'accès à une deuxième adresse IP locale. +- Ajout d'une définition facultative « #define GatewayIP » dans « BSB_LAN_config.h » pour activer la définition de l'adresse du routeur différente de x.x.x.1. +- Suppression du paramètre 10109 car il est identique à 10000. +- Ajout d'une fonction pour vérifier tous les CommandIDs connus sur votre propre système de chauffage. Utilisez « /Q » après avoir activé la définition « #define DEBUG » dans « BSB_LAN_config.h ». +- Ajout de numéros de paramètre au menu de catégorie. +- Mise à jour de analyze.sh. +- espérons que cela résout le problème de mémoire +- Déplacement des chaînes HTML vers « html_strings.h ». + +## Version 0.39 ## +**02.01.2018** + +- Implémentation du protocole PPS-Bus. + Voir « /K40 » pour les commandes limitées disponibles pour ce bus. + Utilisez setBusType(2) pour définir le PPS au démarrage ou « /P2 » pour basculer temporairement. +- Définissez les GPIOs en entrée en utilisant « /Gxx,I ». +- Définition « #define CUSTOM_COMMANDS » ajoutée. + Utilisez ceci dans votre configuration pour inclure du code individuel de « BSB_LAN_custom.h » + (doit être créé par vous!) qui est exécuté à la fin de chaque boucle principale. + Les variables « custom_timer » et « custom_timer_compare » ont été ajoutées pour exécuter + du code à des intervalles arbitraires. +- Ajout de la famille d'appareils LogoBloc Unit L-UB 25C (95). +- plusieurs nouveaux paramètres ajoutés. +- Correction d'un bogue pour la journal +## Version 0.34 ## +**29.05.2017** + +- Les données de journalisation peuvent maintenant être affichées sous forme de graphique. +- L'interface Web peut maintenant afficher et définir les paramètres de type `VT_BIT` sous une forme lisible par l'utilisateur. +- Ajout de descriptions KonfigRGx ; attention : plusieurs sources ont été utilisées, il n'est pas garanti que les descriptions correspondent à votre système de chauffage individuel. +- `VT_BIT` est généralement en lecture seule dans l'interface Web. Pour le définir, utilisez la commande d'URL `/S` avec la représentation décimale de la valeur. +- Correction d'un bug avec `VT_SECONDS_SHORT5`, qui affecte les paramètres 9500 et 9540. +- Correction d'un bug concernant la famille d'appareils Fujitsu (de 127 à 170). +- Déplacement des bibliothèques du dossier `libraries` vers `src` afin qu'elles puissent être incluses sans les copier dans le dossier `Arduino libraries`. +- Modification du chemin d'inclusion de `DallasTemperature.h` pour `OneWire.h`. + +## Version 0.33 ## +**09.05.2017** + +- Plus de définitions de systèmes de chauffage en raison de la nouvelle fonction d'auto-détection basée sur la famille d'appareils (paramètre 6225), ou définissez la variable `device_id` directement sur la valeur du paramètre. +- Deux options de sécurité supplémentaires : `TRUSTED_IP` pour limiter l'accès à une seule adresse IP, et l'authentification HTTP avec nom d'utilisateur et mot de passe. +- Les valeurs moyennes sont enregistrées sur la carte SD si elle est présente et que la définition LOGGER est activée. +- Désactiver la journalisation en définissant `/L0=0` - de cette façon, vous pouvez activer la définition LOGGER sans remplir la carte SD, mais toujours enregistrer les valeurs moyennes. +- Nouveaux codes d'erreur pour THISION. +- Ajout du vidage de la charge utile des données sur le site Web pour les commandes de type inconnu, les paramètres non pris en charge sont grisés. +- Activer la journalisation des télégrammes (paramètre de journalisation 30000) également en mode surveillance (bsb.cpp et bsb.h mis à jour). +- L'heure du système de chauffage est désormais récupérée périodiquement à partir des télégrammes de diffusion, ce qui réduit encore l'activité du bus. +- Nouveau type de données `VT_BIT` pour les paramètres qui définissent des bits individuels. Affichage sous forme de chiffres binaires, la définition utilise toujours la représentation décimale. +- Nouveau type de données `VT_TEMP_SHORT5_US` pour les températures non signées sur un octet divisées par 2 (pour l'instant, uniquement 887 Vorlaufsoll NormAussentemp). +- Nouveau type de données `VT_PERCENT5` pour les températures non signées sur un octet divisées par 2 (pour l'instant, uniquement 885 Pumpe-PWM Minimum). +- Nouveau type de données `VT_SECONDS_WORD5` pour les secondes sur deux octets divisées par 2 (pour l'instant, uniquement 2232, 9500 et 9540). +- Nouveau type de données `VT_SECONDS_SHORT4` pour les secondes sur un octet (signé ?) divisées par 4 (pour l'instant, uniquement 2235). +- Nouveau type de données `VT_SECONDS_SHORT5` pour les secondes sur un octet (signé ?) divisées par 5 (pour l'instant, uniquement 9500, 9540). +- Nouveau type de données `VT_SPEED2` pour les rpm sur deux octets (pour l'instant, uniquement 7050). +- Nettoyage de la fonction set() pour supprimer les cas de doublons apparents. +- Ajout de cas pour `VT_TEMP_WORD`, `VT_SECONDS_WORD5`, `VT_TEMP_SHORT`, `VT_TEMP_SHORT5`, `VT_SECONDS_SHORT4` à la fonction set(). + +## Version 0.32 ## +**18.04.2017** + +- De nombreux nouveaux paramètres sont pris en charge. +- La nouvelle interface Web permet de contrôler le système de chauffage sans logiciel supplémentaire ou commandes URL cryptiques. Les commandes URL sont bien sûr toujours disponibles, il n'est donc pas nécessaire de changer quoi que ce soit lors de l'utilisation de FHEM, etc. +- L'interface Web en allemand est disponible avec la définition `LANG_DE`. +- Nouvelle commande URL `/LB=x` pour journaliser uniquement les messages de diffusion (x=1) ou tous les messages du bus (x=0). +- Nouvelle commande URL `/X` pour réinitialiser l'Arduino (il faut activer la définition RESET dans `BSB_LAN_config.h`). +- Nouveaux paramètres de journalisation 20002 et 20003 pour les temps et cycles de chargement de l'eau chaude. +- Déplacement des paramètres de journalisation DS18B20 de 20010-20019 à 20200-20299 et des paramètres de journalisation DHT22 de 20020-20029 à 20100-20199. +- Déplacement du paramètre de journalisation moyen de 20002 à 20004. +- Définition de nombreux paramètres en lecture seule car c'est ce qu'ils sont évidemment (K33-36). +- Diverses corrections de bugs. + +## Version 0.31 ## +**10.04.2017** + +- Augmentation du vidage du fichier journal par un facteur 5 / tant que nous avons encore de la mémoire, vous pouvez augmenter logbuflen de 100 à 1000 pour augmenter la vitesse de transfert d'environ 16 à 18 Ko/s. +- Ajustement de la surveillance de l'activité de la chaudière en fonction des messages de diffusion pour les systèmes Brötje. +- Suppression de la définition `PROGNR_5895` car jusqu'à présent, elle a seulement désactivé une définition ENUM. +- Suppression de la définition `PROGNR_6030` car le double ID de commande pouvait être résolu via les définitions BROETJE / non-BROETJE. +- Renommage de `BROETJE_SOB` en BROETJE pour permettre une distinction fine entre les différents cas BROETJE (par exemple 6800ff). + Cela signifie que vous devez maintenant activer DEUX définitions lors de l'utilisation d'un système Brötje : la définition générale BROETJE ainsi que `BROETJE_SOB` ou `BROETJE_BSW`. + Jetez un coup d'œil à votre journal série pour les paramètres 6800 afin de voir quels ID de commande correspondent à votre système et activez l'un des deux en conséquence. +- Changement de l'adressage 16 bits de la mémoire flash en 32 bits pour résoudre les problèmes de plantage dus à des tables PROGMEM de plus en plus grandes - nous avons maintenant beaucoup d'espace pour respirer à nouveau pour de nouveaux ID de commande :) +- Suppression du caractère de fin de chaîne \0 de plusieurs ENUMs qui a conduit à des listes ENUM incorrectes. Veuillez garder à l'esprit de ne pas terminer les ENUMs par un caractère de fin de chaîne \0 ! + +## Version 0.30 ## +**22.03.2017** + +- La bibliothèque Time de Paul Stoffregen (https://github.com/PaulStoffregen/Time) est désormais requise et incluse dans le dossier de la bibliothèque. +- Ajout de la journalisation des données de télégramme brut sur la carte SD avec le paramètre de journalisation 30000. La journalisation des données de télégramme est affectée par les commandes `/V` et `/LU`. +- Ajout de la commande `/LU=x` pour journaliser uniquement les ID de commande connus (x=0) ou inconnus (x=1) lors de la journalisation des données de télégramme. +- Suppression de la définition `USE_BROADCAST`, les données de diffusion sont désormais toujours traitées. +- Nouvelles fonctions internes GetDateTime, TranslateAddr, TranslateType. + +## Version 0.29 ## +**07.03.2017** + +- Ajout de la commande `/C` pour afficher la configuration actuelle. +- Ajout de la commande `/L` pour configurer l'intervalle de journalisation et les paramètres. +- Ajout d'une option pour la commande `/A` pour définir les paramètres de moyenne sur 24 heures pendant l'exécution. +- Ajout d'un paramètre spécial 20002 pour la journalisation de la commande `/A` (moyennes sur 24 heures, n'a de sens que pour les longs intervalles de journalisation). +- Corrections de bugs pour la journalisation des capteurs DS18B20. + +## Version 0.28 ## +**05.03.2017** + +- Ajout de paramètres spéciaux 20000++ pour la journalisation sur carte SD des commandes `/B,` `/T` et `/H` (voir `BSB_LAN_config.h` pour des exemples). +- Ajout d'informations de version à l'interface Web `BSB_LAN`. + +## Version 0.27 ## +**01.03.2017** + +- Ajout d'un champ de date au fichier journal (nécessite l'envoi de l'heure exacte par le système de chauffage). +- `/D0` recrée le fichier datalog.txt avec l'en-tête de tableau. +- Ajout d'un champ "flags" à la structure de la table de commandes. Actuellement, seul `FL_RONLY` est pris en charge pour rendre un paramètre en lecture seule. +- Ajout de `DEFAULT_FLAG` dans la configuration. Par défaut à `NULL`, c'est-à-dire que tous les champs sont en lecture/écriture. + La définition à `FL_RONLY` rend tous les paramètres en lecture seule, par exemple pour un niveau de sécurité supplémentaire. + Les paramètres individuels peuvent être définis sur `NULL`/`FL_RONLY` pour rendre uniquement ces paramètres accessibles en écriture/lecture seule. + +## Version 0.26 ## +**27.02.2017** + +- Ajout de la fonctionnalité de journalisation sur carte micro SD, en utilisant l'emplacement de la carte SD du bouclier Ethernet w5100. +- Ajout de paramètres supplémentaires (par exemple 8009). + +## Version 0.25 ## +**21.02.2017** + +- Ajout de paramètres FUJITSU supplémentaires. + +## Version 0.24 ## +**14.02.2017** + +- Mise à jour du README avec les fonctions ajoutées. +- Ajout des traductions allemandes du FAQ et du README, gracieuseté d'Ulf Dieckmann. + +## Version 0.23 ## +**12.02.2017** + +- Correction de bugs mineurs. + +## Version 0.22 ## +**07.02.2017** + +- Ajout de paramètres FUJITSU supplémentaires. +- Implémentation (espérons-le) correcte des lectures `VT_VOLTAGE`. +- Corrections de bugs mineurs. + +## Version 0.21 ## +**06.02.2017** + +- Ajout de nombreux paramètres pour la pompe à chaleur Fujitsu, y compris la nouvelle directive `#define FUJITSU` pour activer ces paramètres en raison de numéros de paramètres différents. +- Corrections de bugs mineurs. + +## Version 0.20 ## +**27.01.2017** + +- Ajout de paramètres supplémentaires pour Feststoffkessel. +- Corrections de bugs mineurs. + +## Version 0.19 ## +**01.01.2017** + +- Ajout de la commande d'humidité `/H`, actuellement pour les capteurs DHT22. +- Ajout de la commande de moyenne sur 24 heures `/A`, définissez les paramètres dans `BSB_LAN_config.h`. +- Suppression des espaces blancs de fin des chaînes de menu. +- Correction de l'ID de commande 0x053D04A2 pour les chauffe-eau THISION. +- Inclusion de la bibliothèque DHT de Rob Tillaart car il existe plusieurs bibliothèques implémentant le protocole et celle-ci est utilisée dans le code pour sa capacité à adresser plusieurs capteurs avec un seul objet. +- Suppression du paramètre d'URL `/temp` car il est un doublon de `/T`. +- Inclusion d'une boucle pour afficher les capteurs DHT22 dans IPWE. +- Rendre la compilation des extensions IPWE optionnelle (`#define IPWE`). + +## Version 0.18 ## +**22.12.2016** + +- Séparation de la configuration dans `bsb_lan_config.h`. +- Séparation des définitions de commandes dans `bsb_lan_defs.h`. +- Changement des valeurs de retour GPIO de LOW/HIGH à 1/0. +- Réactivation et mise à jour d'IPWE (définissez les paramètres dans la configuration). +- Vérification des broches protégées lors de l'accès à GPIO (définissez dans la configuration). +- Ajout des schémas et des fichiers PCB dans un nouveau sous-dossier "schémas". + +## Version 0.17a ## +**20.12.2016** + +- Correction d'erreurs mineures. + +## Version 0.17 ## +**20.12.2016** + +- Fusion de v0.16 avec les modifications de l'utilisateur FHEM miwi. + +## Version 0.16 ## +**20.11.2016** + +- Suppression d'IPWE et de l'interface EthRly. +- Ajout de l'interface GPIO. +- Fusion des paramètres de J.Weber. +- Résolution des ID de commande en double. + +## Version 0.15a ## +**25.07.2016** + +- Regroupement des commandes d'un projet Python et de ce projet, + fusion des deux versions, correction des erreurs évidentes. + Insertion de valeurs numériques hypothétiques dans les définitions ENUM + où les manuels Broetje documentaient uniquement les textes des messages. +- Ajout d'informations à partir de traces dans une installation Broetje avec + un contrôleur ISR-SSR et une chaudière à mazout WOB 25C. + +## Version 0.15 ## +**21.04.2016** + +- Ajout de Solar et Pufferspeicher d'Elco Logon B & Logon B MM. + +## Version 0.14 ## +**04.04.2016** + +- Corrections de bugs mineurs pour Broetje SOB. +- Extension du traitement des diffusions (expérimental). + +## Version 0.13 ## +**31.03.2016** + +- Changement de la valeur de résistance dans le chemin de réception de 4k7 à 1k5. +- Ajout des valeurs 0x0f et 0x10 à Enum8005. +- Correction des chaînes pour Zeitprogramme. +- Ajout d'un délai d'attente pour l'envoi d'un message (1 seconde). +- Ajout de `/T` pour interroger les capteurs de température One Wire dans les requêtes mixtes. +- Ajout d'un traitement spécial pour Broetje SOB. +- Simplification des paramètres. + +## Version 0.12 ## +**09.04.2015** + +- Ajout de `ONEWIRE_SENSORS` à ipwe. +- Correction du décodage des paramètres pour le système de chauffage ELCO Thision. + +## Version 0.11 ## +**07.04.2015** + +- Correction du décodage des paramètres pour le système de chauffage ELCO Thision. + +## Version 0.10 ## +**15.03.2015** + +- Ajout de paramètres supplémentaires pour le système de chauffage ELCO Thision. + +## Version 0.9 ## +**09.03.2015** + +- Ajout de paramètres supplémentaires pour le système de chauffage ELCO Thision. +- printTelegramm renvoie la chaîne de valeur pour un traitement ultérieur. + +## Version 0.8 ## +**05.03.2015** + +- Ajout de paramètres pour le système de chauffage ELCO Thision. +- Ajout de l'extension IPWE. +- Corrections de bugs mineurs. + +## Version 0.7 ## +**06.02.2015** + +- Ajout de la fonctionnalité de surveillance du bus. + +## Version 0.6 ## +**02.02.2015** + +- Renommage de SoftwareSerial en BSBSoftwareSerial. +- Changement de la structure de dossiers pour permettre une construction simple avec le kit de développement Arduino. + +## Version 0.5 ## +**02. diff --git a/docs/fr/README.md b/docs/fr/README.md new file mode 100644 index 00000000..d822b70c --- /dev/null +++ b/docs/fr/README.md @@ -0,0 +1,24 @@ +# Qu'est-ce que BSB-LAN ? + +[BSB-LAN est une solution logicielle](https://www.bsb-lan.de)/matérielle pour accéder au [« Boiler-System-Bus » (BSB)][BSB], au [« Local-Process-Bus (LPB) »][LPB] et à la [« Punkt-zu-Punkt-Schnittstelle » (PPS)][PPS]. Le matériel BSB-LAN est disponible pour divers microcontrôleurs basés sur *ESP32* (ESP32 NodeMCU, Olimex EVB, Olimeé POE-ISO) ainsi que pour un *Arduino Due* avec un shield Ethernet. Il permet d'accéder aux systèmes de chauffage Atlantic, Brötje, Elco et de nombreux autres fabricants via Ethernet/WiFi, à condition qu'ils utilisent l'une des cartes électroniques Siemens répertoriés ci-dessous. + +BSB-LAN permet de surveiller et de contrôler le système de chauffage et d'enregistrer toutes les valeurs reçues. Ce projet prend en charge presque tous les paramètres disponibles sur les systèmes de chauffage et peut être une alternative plus complète et plus économique à l'OZW 672, à l'OCI 700 ou au Remocon Net B. + +L'[intégration facultative dans les systèmes domotiques existants](homeautomation.md) tels que [Home Assistant][HomeAssistant], [ioBroker][ioBroker], [openHAB][openHAB], [Node-RED][NodeRED], [Homebridge][Homebridge], [Jeedom][Jeedom], [SmartHomeNG][SmartHomeNG], [Volkszähler][Volkszaehler], [FHEM][FHEM], [HomeMatic][Homematic], Loxone, IP-Symcon ou EDOMI est possible via [MQTT][MQTT], [JSON][JSON] ou [HTTP access][using]. + +L'adaptateur peut également être utilisé comme carte d'acquisition sans connexion à Internet grâce à une carte microSD. + +Les capteurs de température et d'humidité peuvent également être connectés et leurs données peuvent également être enregistrées et analysées. Vous avez aussi la possibilité d'intégrer votre propre code dans le logiciel BSB-LAN, pour rajouter autant de fonctionnalités que vous le souhaitez. + +# Où et comment commencer ? + +- Vous êtes un utilisateur expérimenté ? Consultez les [instructions de démarrage rapide](quickstart.md). Sinon (ou si vous rencontrez des problèmes), veuillez continuer à lire ! +- Mon système de chauffage est-il pris en charge par BSB-LAN ? Veuillez consulter la [liste des systèmes de chauffage pris en charge](supported_heating_systems.md). +- Si vous savez déjà que votre système est pris en charge, en [savoir plus sur l'adaptateur BSB-LAN](bsb-lan_adapter.md) et où l'obtenir. +- Si vous avez déjà l'adaptateur, vous voudrez peut-être savoir [comment l'installer](install.md). +- Si vous avez installé l'adaptateur, vous devrez [configurer BSB-LAN](configure.md). +- Une fois que vous avez tout configuré, découvrez [comment utiliser BSB-LAN](using.md) ou en savoir plus sur les façons de [l'intégrer dans les systèmes de domotique](homeautomation.md). +- Si vous souhaitez mettre à jour BSB-LAN et que vous souhaitez savoir ce qui a changé depuis votre dernière installation, veuillez consulter le [ChangeLog](CHANGELOG.md). +- Nos [pages wiki](https://github.com/fredlcore/BSB-LAN/wiki) sont en constante évolution et fournissent des connaissances de base ainsi que des sujets plus spécialisés sur BSB-LAN et les systèmes de chauffage en général. +- Si vous rencontrez des problèmes, consultez la [page de dépannage](troubleshooting.md). +- Et avant de poser des questions à qui que ce soit, consultez d'abord nos [Foire aux questions (FAQ)](faq.md) ! diff --git a/docs/fr/bsb-lan_adapter.md b/docs/fr/bsb-lan_adapter.md new file mode 100644 index 00000000..32434020 --- /dev/null +++ b/docs/fr/bsb-lan_adapter.md @@ -0,0 +1,37 @@ +# L'adaptateur BSB-LAN +--- +### Pour avoir un adaptateur - contactez Frederik à bsb(ät)code-it.de (en allemand ou en anglais) pour plus de détails. +--- +Pour connecter votre système de chauffage à un microcontrôleur, vous avez besoin d'une carte électronique qui effectue la conversion de niveau logique: + +L'adaptateur est ensuite branché directement sur le microcontrôleur, soit sous les broches de l'ESP32-NodeMCU, soit sur le connecteur UEXT de l'Olimex: + + + + + +Les deux types d'ESP32 (Olimex et ESP32-NoceMCU) ne diffèrent que par l'emplacement de leurs connecteurs, les autres parties de la carte étant identiques. +La carte Arduino Due contient une puce EEPROM car la Due n'est pas équipée d'une EEPROM. Par conséquent, vous pouvez réutiliser la carte Arduino Due sur un microcontrôleur ESP32 (si vous connectez les broches correctes avec des fils), mais vous ne pouvez pas utiliser un adaptateur ESP32 sur une Arduino Due. +--- +# Microcontrôleurs appropriés + +BSB-LAN peut être installé sur trois types différents de microcontrôleurs: + +1. ESP32-Olimex +2. ESP32-NodeMCU (version 30 broches uniquement!) +3. Arduino Due. + +Olimex produit plusieurs types de cartes: +Nous recommandons soit l'[Olimex ESP32-EVB](https://www.olimex.com/Products/IoT/ESP32/ESP32-EVB/open-source-hardware) soit l'[Olimex ESP32-POE-ISO](https://www.olimex.com/Products/IoT/ESP32/ESP32-POE-ISO/open-source-hardware). La simple version POE (sans "ISO") n'est pas recommandée car elle ne permet pas de se connecter à la fois à Ethernet PoE et à USB. + +L'[Arduino Due](https://store.arduino.cc/products/arduino-due) nécessite un [Shield Ethernet](https://store.arduino.cc/products/arduino-ethernet-shield-2) pour accéder au réseau local. + +Chacun des différents contrôleurs a ses avantages et ses inconvénients: + +|Fonctionnalité|ESP32-Olimex|ESP32-POE-ISO|ESP32-NodeMCU|Arduino Due| +|:------------|:----------:|:-----------:|:-----------:|:---------:| +|Ethernet/LAN |X |X |- |X | +|WiFi/WLAN |X |X |X |- | +|Mise à jour via OTA|X |X |X |- | +|Carte micro-SD intégrée |X |X |- |- | +|GPIO accessibles|2 (GPIO13/16)|quelques-uns|quelques-uns|beaucoup | diff --git a/docs/fr/bus_systems.md b/docs/fr/bus_systems.md new file mode 100644 index 00000000..5bfba3ea --- /dev/null +++ b/docs/fr/bus_systems.md @@ -0,0 +1,47 @@ +# Le bus BSB/LPB/PPS + +Développé à la fin du dernier millénaire sur la base du BatiBUS (plus d'informations sont disponibles [ici](https://2007.blog.dest-unreach.be/wp-content/uploads/2012/12/Interface-module-I-O-OPEN-ALBATROS-PTM59-20V1_19957_hq-en.pdf) et [ici](https://2007.blog.dest-unreach.be/wp-content/uploads/2012/12/BatiBus_v1.4.pdf)), de nombreux contrôleurs de systèmes de chauffage Siemens utilisent toujours le même type de bus physique pour communiquer avec les unités de pièce et d'autres appareils de chauffage. Bien qu'une vitesse de bus de seulement 4800 bits par seconde puisse sembler anachronique de nos jours, elle fournit toujours un protocole de transmission stable et robuste qui est encore aujourd'hui parfaitement suffisant pour transmettre de courts messages de quelques dizaines d'octets sur des lignes pouvant atteindre un kilomètre de long. + +La topologie de bus permet également de connecter BSB-LAN à n'importe quel point: à l'unité de pièce, au système de chauffage ou à tout endroit où les lignes de bus sont disponibles. Vous pouvez même ajouter les deux fils pour BSB-LAN dans un emplacement déjà "occupé" et cela n'endommagera pas l'autre appareil (en supposant une installation correcte). + +En plus de la même couche physique, trois systèmes de bus, BSB, LPB et PPS, s'occupent de différentes tâches et, bien que BSB et LPB doivent toujours être préférés lorsqu'ils sont disponibles, PPS fournit néanmoins un ensemble de paramètres qui est généralement tout à fait suffisant pour l'utilisateur moyen. +BSB-LAN fonctionne sur l'un de ces bus et le passage de l'un à l'autre nécessite simplement de modifier quelques paramètres. + +--- + +[](){#BSB} +## Le bus du système de chaudière (BSB) +BSB est le système de bus le plus courant dans les contrôleurs Siemens depuis 10 à 15 ans. Il s'agit du successeur du système PPS, avec lequel il partage les mêmes paramètres physiques, mais il est beaucoup plus polyvalent: au lieu de quelques dizaines de paramètres, il peut en accéder à des centaines et les regrouper en différentes catégories pour faciliter la navigation. Il s'agit d'un protocole basé sur les transactions, dans lequel la plupart des messages sont envoyés d'un appareil à un autre, et le destinataire renvoie un type de retour, par exemple si la tâche a pu être effectuée ou si elle contenait des données non valides. + +Bien que BSB soit capable d'adresser plusieurs appareils sur le bus, il n'est pas utilisé dans les systèmes avec plus d'un appareil de chauffage. L'appareil de chauffage a toujours l'ID `0`, l'unité d'affichage sur le système de chauffage a l'ID `10` (ou `0x0A` en hexadécimal) et l'unité de pièce standard a l'ID `6`. BSB-LAN a l'ID `66` ou `0x42` en hexadécimal. +Les unités de pièce qui "parlent" BSB sont, par exemple, les QAA55 et les QAA75. + +--- + +[](){#LPB} +## Le bus de processus local (LPB) +LPB a été introduit plus ou moins en même temps que PPS, qu'il complétait en termes de communication avec d'autres appareils de chauffage: alors que PPS était utilisé pour communiquer avec l'unité de pièce, LPB était utilisé pour envoyer des commandes d'un appareil de chauffage principal à un ou plusieurs appareils de chauffage auxiliaires, par exemple dans une configuration en cascade. À l'époque, la plupart des informations transmises via LPB étaient liées aux composants internes du système de chauffage (telles que les données des capteurs ou les températures de consigne internes), tandis que les paramètres pertinents pour l'utilisateur (tels que la température de confort) n'étaient disponibles que via PPS. De nos jours, les appareils de chauffage qui offrent à la fois LPB et BSB ont le même type de données de paramètres disponibles sur les deux systèmes de bus. + +LPB utilise un schéma d'adressage spécifique avec des segments et des appareils. Chaque segment de 0 à 15 peut contenir jusqu'à 15 appareils (de 1 à 15). Lors de l'écriture de ces adresses, le segment et l'appareil sont séparés par un deux-points: `00:01` ou `04:03`. +Pour convertir l'adresse basée sur le segment en ID de destination requis pour BSB-LAN, la formule est la suivante: +`SEGMENT` multiplié par 16 plus `APPAREIL` moins un. +Exemple: l'appareil 3 du segment 4 est égal à `4 * 16 + 3 - 1` = 66. +L'unité de chauffage principale est par définition `00:01`, ce qui correspond à un ID de destination 0. +Pour en savoir plus sur le système LPB et son déploiement, vous pouvez consulter ces deux documents de la fin des années 1990, l'un couvre les [données système de base](https://sid.siemens.com/v/u/20138) qui couvrent la conceptualisation d'un réseau LPB, et l'autre traite des [données d'ingénierie de base](https://sid.siemens.com/v/u/20140) et fournit des détails sur les longueurs et diamètres de câble, etc. + +À l'exception de certains radiateurs Weishaut, les unités de pièce ne sont pas connectées au système de chauffage via LPB. Les modèles plus récents utilisent BSB pour cette tâche, tandis que les modèles plus anciens utilisent soit PPS, soit dans certains cas OpenTherm. + +--- + +[](){#PPS} +## L'interface point à point (PPS) +L'interface point à point (PPS, pour "Punkt-zu-Punkt Schnittstelle" en allemand) est compatible avec les autres systèmes au niveau physique, mais pas au niveau de l'échange de télégrammes de messages. Alors que BSB et LPB communiquent en envoyant des télégrammes et en accusant réception de leur réception, PPS est dominé par l'unité de chauffage. L'unité de chauffage envoie constamment ses données à l'unité de pièce et indique à l'unité de pièce quand et quel type d'informations elle doit envoyer. Il peut donc falloir jusqu'à quelques minutes avant qu'une valeur définie dans BSB-LAN ne soit réellement demandée par le système de chauffage et affichée. +Il s'agit également d'un protocole très sensible à la temporisation, de sorte que l'exécution d'autres tâches longues par BSB-LAN entraînera une interruption temporaire et un éventuel message d'erreur sur le système de chauffage. Cependant, après un court moment, cela devrait se résoudre de soi lorsque les deux composants "communiquent" à nouveau. + +Contrairement à BSB et LPB, les modifications apportées dans BSB-LAN n'ont pas d'effet immédiat. La modification de valeurs, par exemple comme la température de consigne de confort de la pièce, sera tout d'abord stockée en interne dans BSB-LAN, puis envoyée au système de chauffage une fois que celui-ci aura demandé à l'unité de pièce (c'est-à-dire BSB-LAN) de le faire. Cela peut prendre jusqu'à une minute ou plus, il ne faut donc pas être confus si les paramètres ne s'affichent pas immédiatement sur le radiateur, comme c'est le cas avec BSB et LPB. + +Avec PPS, BSB-LAN peut fonctionner dans deux modes: écoute passive ou en tant qu'unité de pièce. En mode passif, BSB-LAN peut simplement écouter les données échangées entre l'unité de pièce et l'appareil de chauffage. Il n'est pas possible d'envoyer ses propres données, tout simplement parce qu'elles seraient écrasées en un rien de temps par le même type de données provenant de l'unité de pièce. +Pour envoyer des données de paramètres au système de chauffage, BSB-LAN doit fonctionner en mode "unité de pièce", ce qui signifie que toute unité de pièce doit être retirée du système de chauffage. Dans ce cas, il est particulièrement important d'envoyer régulièrement une valeur de température de pièce à BSB-LAN, qui à son tour enverra cette valeur à l'appareil de chauffage. Seule une valeur de température extérieure peut être ignorée si le radiateur fonctionne uniquement sur la température extérieure. +BSB-LAN stocke certaines valeurs dans sa mémoire EEPROM non volatile, mais certaines valeurs doivent être réinitialisées après un redémarrage, telles que la température de consigne de la pièce. Il s'agit d'éviter de stocker une valeur de paramètre qui est devenue non valide mais qui est toujours envoyée car elle est stockée dans l'EEPROM. + +Les unités de pièce couramment utilisées avec les systèmes de chauffage qui prennent en charge PPS sont les QAA50 et les QAA70. diff --git a/docs/fr/configure.md b/docs/fr/configure.md new file mode 100644 index 00000000..509e9e8d --- /dev/null +++ b/docs/fr/configure.md @@ -0,0 +1,132 @@ +# Configuration +Il existe deux façons de configurer BSB-LAN : + +1. Via le fichier de configuration `BSB_LAN_config.h` +2. Via l'interface web en appelant [http://bsb-lan.local/C](http://bsb-lan.local/C) (ou l'adresse IP correspondante) + +Pour la configuration initiale, certains paramètres doivent être configurés dans le fichier de configuration (tels que les paramètres de langue et de réseau). +Toutes les modifications ultérieures peuvent être effectuées via l'interface web. Il peut cependant être utile de configurer (également) le fichier de configuration dans le cas où vous devriez changer de microcontrôleur. Presque tous les paramètres existent également dans l'interface web et vice versa. + +Sur un microcontrôleur basé sur ESP32, BSB-LAN configurera son propre point d'accès sans fil nommé `BSB-LAN` s'il ne peut pas se connecter à un réseau. Ainsi, même sans aucune configuration supplémentaire, vous pouvez vous connecter à ce point d'accès avec le mot de passe `BSB-LPB-PPS-LAN` et accéder à BSB-LAN via l'adresse IP `http://192.168.4.1` et poursuivre la configuration de cette manière. Gardez à l'esprit que si vous avez défini un mot de passe ou un nom d'utilisateur et un mot de passe HTTP, ceux-ci sont toujours requis si ces détails sont stockés dans l'EEPROM ou `BSB_LAN_config.h`. + +--- +## Configuration via `BSB_LAN_config.h` + +Le fichier de configuration se compose de variables qui sont utilisées dans d'autres parties de BSB-LAN. Il est donc important de **ne modifier que le contenu** des variables (c'est-à-dire les paramètres) et **pas le type** des variables. Ainsi, si vous avez par exemple le paramètre +`byte ip_addr[4] = {192,168,178,88} ;` +vous ne devez pas modifier la partie `byte ip_addr[4] =`, mais seulement le contenu, dans ce cas l'adresse IP séparée par des virgules. +--- +## Configuration via l'interface web + +La configuration de BSB-LAN via l'interface web est assez simple, car vous n'avez pas à vous soucier des noms de variables, mais vous disposez de descriptions claires. +Au départ, seul un nombre limité d'options de configuration sont affichées dans l'interface web. Pour y accéder à l'ensemble des paramètres, vous devez définir l'option "extended configuration" sur "on". +--- +## Aperçu des options de configuration + +### Paramètres généraux +| Interface Web | Fichier de configuration | Fonctionnalité | Paramètres possibles | +| ------------- | ---------------------- | ------------- | ------------------- | +| - | ** `#define LANG` ** | Définir la langue | `DE`, `EN`, `FR` et autres codes de pays ISO | +| Afficher la configuration étendue | - | Afficher toutes les options de configuration | **On**
**Off** | +| Lire la configuration depuis l'EEPROM | `UseEEPROM` | Lire la configuration depuis l'EEPROM ou le fichier | **On** (`1`)
**Off** (`0`) | +| [](){#WriteAccess}Niveau d'accès en écriture | - | Si `DEFAULT_FLAG` est défini sur `FL_SW_CTL_RONLY`, vous pouvez définir le niveau d'accès en écriture ici. | **Off** (lecture seule)
**On (Standard)**
**On (Complet)** | +| Vérifier les mises à jour | `enable_version_check` | Interroger le serveur BSB-LAN pour une nouvelle version disponible | **On** (`true`) | +| Mise à jour OTA | `enable_ota_update` | Activer la mise à jour OTA (Over-The-Air) | **On** (`true`) | +| Économie d'énergie | `esp32_save_energy` | Réduit la vitesse, économise l'énergie. Ne pas activer lors de l'utilisation du Wi-Fi. | **On** (`true`)
**Off** (`false`) | +| Système de fichiers du serveur Web | `webserver` | Active le service de fichiers depuis la carte SD | **On** (`true`)
**Off** (`false`) | +| - | `#define DEFAULT_FLAG` | Définir l'accès en lecture/écriture au système de chauffage. `FL_RONLY` définit tous les paramètres en lecture seule. `FL_SW_CTL_RONLY` permet de définir l'accès en lecture/écriture via le paramètre de configuration de l'interface web.
`0` rend tous les paramètres pouvant être écrits, writable. **N'utilisez pas cette option sauf instruction contraire !** | **FL_RONLY**
**FL_SW_CTL_RONLY**
**0** | + +### Paramètres de bus +| Interface Web | Fichier de configuration | Fonctionnalité | Paramètres possibles | +| ------------- | ---------------------- | ------------- | ------------------- | +| Type de bus | `bus_type` | Type de bus (BSB/LPB/PPS) | **BSB** (`0`)
**LPB** (`1`)
**PPS** (`2`) | +| Mode PPS | `pps_write` | BSB-LAN peut agir comme une unité de pièce PPS (uniquement si aucune unité de pièce réelle n'est connectée) ou simplement écouter passivement. | **passif** (`0`)
**en tant qu'unité de pièce** (`1`) | +| Modèle QAA PPS | `QAA_TYPE` | Unité de pièce qui doit être simulée pour le bus PPS | **QAA70** (`0x53`), **QAA50** (`0x52`), **QAA95** (`0x37`), **QAW10** (`0x4D`), **QAW20** (`0x4E`), **MCBA/REA70/DC225** (`0x58`), **QAA10** (`0x5A`), **QAA20** (`0x5B`), **QAA12/13** (`0x5D`), **BMU** (`0x66`), **RVD130** (`0x43`) | +| Adresse propre | `own_address` | Adresse de bus propre (par défaut `66` ne doit pas être modifiée) | **66** (`66`) | +| Adresse de destination | `dest_address` | Adresse de bus de destination.
Pour **BSB** toujours `0`.
Pour **LPB** `0` si l'appareil de destination se trouve dans le segment 1, adresse de l'appareil 0.
Pour convertir de la notation de segment et d'adresse d'appareil LPB en adresse de destination, multipliez le segment par 16, ajoutez l'adresse de l'appareil et soustrayez un. Par exemple, pour adresser un appareil du segment 4 avec l'adresse de l'appareil 3, l'adresse de destination est `(4 * 16) + 3 - 1 = 66`.
Pour **PPS** non pertinent. | **0** (`0`) | +| Numéro d'épingle RX
Numéro d'épingle TX | `bus_pins` | Définir les broches RX/TX pour communiquer avec l'adaptateur BSB-LAN. Laissez à `0` pour la détection automatique. | **0** et **0** (`0, 0`) | + +### Paramètres réseau +| Interface Web | Fichier de configuration | Fonctionnalité | Paramètres possibles | +| ------------- | ---------------------- | ------------- | ------------------- | +| **Périphérique réseau** | `network_type` | Choisissez entre WLAN et LAN pour connecter BSB-LAN au réseau. | **LAN** (`0`)
**WLAN** (`1`) | +| **Nom du réseau WLAN** | `wifi_ssid` | Définir le nom du réseau WLAN lors de l'utilisation du WLAN. | **Your_WLAN_name** (`Your_WLAN_name`) | +| **Mot de passe WLAN** | `wifi_pass` | Définir le mot de passe du WLAN lors de l'utilisation du WLAN. | **YourWLANpassword** (`YourWLANpassword`) | +| **Utilisation du DHCP** | `use_dhcp` | Définir si oui ou non utiliser DHCP pour obtenir une adresse IP du routeur. | **On** (`true`)
**Off** (`false`) | +| Adresse IP (fixe) | `ip_addr` | Lorsque vous n'utilisez pas DHCP, vous pouvez définir une adresse IP fixe ici. Sinon, laissez à `0.0.0.0`. Dans l'interface web, vous pouvez utiliser la notation par points. Dans le fichier de configuration, vous devez utiliser une virgule comme séparateur. | **192.168.178.88** (`192,168,178,88`) | +| Sous-réseau | `subnet_addr` | Sous-réseau lors de l'utilisation d'une adresse IP fixe. Même notation que pour l'adresse IP. | **255.255.255.0** (`255,255,255,0`) | +| Passerelle | `gateway_addr` | Adresse de la passerelle lors de l'utilisation d'une adresse IP fixe. Même notation que pour l'adresse IP. | **192.168.178.1** (`192,168,178,1`) | +| Serveur DNS | `dns_addr` | Adresse du serveur DNS lors de l'utilisation d'une adresse IP fixe. Même notation que pour l'adresse IP. | **192.168.178.1** (`192,168,178,1`) | +| Port TCP | `HTTPPort` | Numéro de port HTTP pour accéder à l'interface web. Par défaut `80`. | **80** (`80`) | +| Adresse MAC | `mac` | Définir une adresse MAC fixe. Uniquement pertinent sur Arduino. | **00:80:41:19:69:90** (`0x00, 0x80, 0x41, 0x19, 0x69, 0x90`) | +| Nom d'hôte mDNS | `mDNS_hostname` | Nom d'hôte pour la découverte mDNS | **BSB-LAN** (`BSB-LAN`) | +| Authentification HTTP | `USER_PASS` | Si ce paramètre n'est pas vide, il contient le nom d'utilisateur et le mot de passe pour l'authentification HTTP, séparés par un deux-points. | **Nom d'utilisateur : Mot de passe** (`Username:Password`) | +| Clé de passe URL | `PASSKEY` | La clé de passe ajoute une séquence définie par l'utilisateur qui doit être ajoutée à l'URL après le nom d'hôte.
Par exemple, une clé de passe de `1234` nécessite que chaque URL soit écrite comme `http://bsb-lan.local/1234/` au lieu de simplement `http://bsb-lan.local/`. Laissez vide pour aucune clé de passe. | **1234** (`1234`) | +| Adresse IP de confiance | `trusted_ip_addr` | L'accès à BSB-LAN n'est possible que depuis cette adresse IP. Même notation que pour l'adresse IP. | **192.168.178.89** (`192,168,178,89`) | +| Adresse IP de confiance | `trusted_ip_addr2` | L'accès à BSB-LAN n'est possible que depuis cette adresse IP. Même notation que pour l'adresse IP. | **192.168.178.90** (`192,168,178,90`) | +| [](){#BSSID}- | `bssid` | Entrez ici une adresse BSSID spécifique pour vous assurer de vous connecter à un point d'accès spécifique. Définissez sur tous les zéros dans des circonstances normales. | (`0x00, 0x00, 0x00, 0x00, 0x00, 0x00`) | +| - | `ntp_server` | Définissez un serveur NTP ici pour obtenir l'heure exacte pour BSB-LAN. Définissez sur une chaîne vide si vous ne souhaitez pas utiliser NTP. Uniquement pour les microcontrôleurs basés sur ESP32. | (`pool.ntp.org`) | +| - | `local_timezone` | Fuseau horaire à utiliser pour NTP. Voir [ici](https://github.com/nayarsystems/posix_tz_db/blob/master/zones.csv) pour une liste complète. | (`CET-1CEST,M3.5.0,M10.5.0/3`) | + +### Journalisation + +| Interface Web | Fichier de configuration | Fonctionnalité | Paramètres possibles | +| ------------- | ---------------------- | ------------- | ------------------- | +| Périphérique de stockage | `LogDestination` | Sélectionnez la destination pour les activités de journalisation. La carte SD est fortement recommandée, car l'utilisation de la mémoire flash interne finira par l'user. | **Carte SD** (`SDCARD`)
**Mémoire flash interne** (`FLASH`) | +| **Mode de journalisation** | `LoggingMode` | Définir les destinations/activités de journalisation. Plusieurs sélections sont possibles, pour le fichier de configuration, les valeurs doivent être ajoutées, par exemple, pour envoyer au courtier MQTT et à UDP, définir la valeur sur `4 + 16 = 20` | **Écrire sur la carte SD** (`1`)
**Calculer les moyennes sur 24 heures** (`2`)
**Envoyer au courtier MQTT** (`4`)
**Envoyer uniquement les paramètres de journalisation au courtier MQTT** (`8`)
**Envoyer à UDP** (`16`) | +| **Intervalle de journalisation** | `log_interval` | Intervalle pour les activités de journalisation (en secondes) | **60** (`60`) | +| **Paramètres de journalisation** | `log_parameters` | Liste des paramètres de journalisation. Voir les instructions d'adressage ci-dessous. | **8700, 8743!2, 8314!2** (`{8700, -1}, {8743, 2}, {8314, 2}`) | +| Journaliser les télégrammes de bus | `logTelegram` | Journaliser les télégrammes de bus bruts, tels que les messages de diffusion ou les télégrammes inconnus | **Off** (`LOGTELEGRAM_OFF`)
**Journaliser tous les télégrammes de bus** (`LOGTELEGRAM_ON`)
**Journaliser uniquement les télégrammes de bus inconnus** (`LOGTELEGRAM_UNKNOWN_ONLY`)
**Journaliser uniquement les télégrammes de bus de diffusion** (`LOGTELEGRAM_BROADCAST_ONLY`)
**Journaliser uniquement les télégrammes de bus de diffusion inconnus** (`LOGTELEGRAM_UNKNOWN_ONLY + LOGTELEGRAM_BROADCAST_ONLY`) | +| Paramètres de moyenne sur 24 heures | `avg_parameters` | Liste des paramètres pour la génération de moyennes sur 24 heures. Voir les instructions d'adressage ci-dessous. | **8700, 8743!2, 8314!2** (`{8700, -1}, {8743, 2}, {8314, 2}`) | +| - | `#define DEFAULT_DAYS_TO_PLOT` | Définir le nombre de jours par défaut à tracer pour les données de journalisation | (`3`) | + +### MQTT + +| Interface Web | Fichier de configuration | Fonctionnalité | Paramètres possibles | +| ------------- | ---------------------- | ------------- | ------------------- | +| **Serveur de courtier MQTT** | `mqtt_broker_addr` | Nom d'hôte/IP du courtier MQTT | **my-mqtt-broker.local** (`my-mqtt-broker.local`) | +| Nom d'utilisateur MQTT | `MQTTUsername` | Nom d'utilisateur facultatif pour le courtier MQTT | **MyMQTTusername** (`MyMQTTusername`) | +| Mot de passe MQTT | `MQTTPassword` | Mot de passe facultatif pour le courtier MQTT | **MyMQTTpassword** (`MyMQTTpassword`) | +| ID de l'appareil MQTT | `MQTTDeviceID` | Identifiant de l'appareil pour MQTT | **BSB-LAN** (`BSB-LAN`) | +| Préfixe de sujet MQTT | `MQTTTopicPrefix` | Préfixe de sujet pour MQTT | **BSB-LAN** (`BSB-LAN`) | +| Utilisation de MQTT | `mqtt_mode` | Définir le format des messages MQTT | **Texte brut** (`1`) - Envoyer le numéro et la valeur du paramètre au format texte brut
**JSON** (`2`) - +| Broches DHT | `DHT_Pins` | Définissez les broches du capteur DHT22 (utilisez `-1` dans le fichier de configuration pour désactiver) | **11, 12, 13** (`11, 12, 13, -1, -1, -1, -1, -1, -1`) | +| --- | --- | --- | --- | +| Capteurs BME280 | `BME_Sensors` | Définissez le nombre de capteurs BME280 sur le bus I2C. Vous devez avoir accès aux broches I2C. Les adresses fixes `0x76` et `0x77` seront utilisées. Utilisez `0` pour désactiver. | **1** (`1`) | +| Utilisation de MAX ! | `enable_max_cul` | Activer ou désactiver la connexion à CUNO/CUNX/MAX!Cube modifié | **On** (`true`)
**Off** (`false`)|| +| Adresse IP du cube | `max_cul_ip_addr` | Adresse IP du CUNO/CUNX/MAX!Cube | **192.168.178.21** (`192,168,178,21`) | +| Appareils MAX ! | `max_device_list` | ID des appareils MAX ! à interroger. Ces ID peuvent être trouvés sur une étiquette de l'appareil. Après les avoir entrés ici, chaque appareil doit être mis en mode d'appariement. Cette opération doit être répétée chaque fois que la disposition EEPROM de BSB-LAN est modifiée (voir le journal des modifications). | **KEQ0502326, KEQ0505080, KHA0002948** (`"KEQ0502326", "KEQ0505080", "KHA0002948"`) | +| Utilisation de IPWE | `enable_ipwe` | Activer l'extension IPWE (`/ipwe.cgi`) | **On** (`true`)
**Off** (`false`) | +| Paramètres IPWE | `ipwe_parameters` | Liste des paramètres à afficher dans l'extension IPWE. Voir les instructions d'adressage ci-dessous. | 8700, 8743!2, 8314!2 ({8700, -1}, {8743, 2}, {8314, 2}) | +| - | `#define CUSTOM_COMMANDS` | Activer les fonctions personnalisées | | + +### Débogage + +| Interface Web | Fichier de configuration | Fonctionnalité | Paramètres possibles | +| ------------- | --- | --- | --- | +| Utilisation du débogage | `debug_mode` | Sélectionnez la sortie de débogage | **Off** (`0`)
**Série** (`1`)
**Telnet** (`2`) | +| Mode verbeux | `verbose` | Activer ou désactiver les messages de débogage verbeux (ne pas désactiver à moins d'être conseillé) | **On** (`1`)
**Off** (`0`) | +| Mode données brutes | `monitor` | Activer ou désactiver le mode données brutes (ne pas activer à moins d'être conseillé) | **On** (`1`)
**Off** (`0`) | +| Afficher les paramètres inconnus | `show_unknown` | Essayez d'afficher également les paramètres non pris en charge par l'appareil de destination | **On** (`true`)
**Off** (`false`) | + +--- + +## Adressage de différents régulateurs de chauffage + +Pour adresser des paramètres à partir d'appareils autres que l'appareil de destination par défaut dans l'interface Web, vous devez ajouter un point d'exclamation suivi de l'adresse de l'appareil (voir ci-dessus pour la conversion de la notation segment/appareil en adresse d'appareil). +Par exemple, le paramètre 8700 de l'adresse d'appareil 1 serait écrit comme `8700!1` au lieu de simplement `8700`. + +Pour le fichier de configuration, les paramètres sont répertoriés sous la forme `{numéro de paramètre, adresse de destination}`. Le paramètre 8700 de l'adresse d'appareil 1 serait donc écrit comme `{8700, 1}`. Pour adresser la destination par défaut, vous pouvez le faire en utilisant `-1`. diff --git a/docs/fr/faq.md b/docs/fr/faq.md new file mode 100644 index 00000000..fef57bb3 --- /dev/null +++ b/docs/fr/faq.md @@ -0,0 +1,11 @@ +# Foire aux questions (FAQ) + +--- + +## Mon chauffage a une connexion OpenTherm/eBus/L-Bus/R-Bus, puis-je utiliser BSB-LAN ? +- Non, ces contrôleurs ne sont pas compatibles avec BSB-LAN. Ne tentez **pas** de connecter l'adaptateur à votre système de chauffage ! + +--- + +## Il me manque la fonction *XYZ* +- BSB-LAN offre la possibilité de créer ses propres fonctions à l'aide des fichiers `BSB_LAN_custom_global.h`, `BSB_LAN_custom_setup.h` et `BSB_LAN_custom.h`. Pour plus de détails et d'exemples, veuillez consulter le dossier `custom_functions` dans le repo Github. N'hésitez pas à partager vos solutions avec nous ! diff --git a/docs/fr/homeautomation.md b/docs/fr/homeautomation.md new file mode 100644 index 00000000..0c9bf98f --- /dev/null +++ b/docs/fr/homeautomation.md @@ -0,0 +1,144 @@ +# Connexion de BSB-LAN aux systèmes de domotique + +BSB-LAN fournit quatre façons de se connecter aux systèmes de domotique: + +1. Utilisation de modules pris en charge pour des systèmes de domotique spécifiques +2. Échange de données via MQTT +3. Échange de données via JSON +4. Échange de données via des commandes URL et la récupération de données à l'écran + +--- + +## Utilisation de modules pris en charge pour des systèmes de domotique spécifiques + +Pour certains systèmes, des modules spécifiques existent et peuvent être utilisés pour accéder à BSB-LAN de manière transparente: + +### Home Assistant + +Bien que le plugin officiel ne fonctionne plus, l'approche MQTT (voir ci-dessous) fonctionne bien avec Home Assistant, y compris la fonctionnalité de découverte automatique. +Voici un lien vers une [vidéo sur la chaîne YouTube de BSB-LAN](https://youtu.be/DbHEiWm5nBs) qui montre comment configurer BSB-LAN dans Home Assistant en utilisant la fonctionnalité de découverte automatique de Home Assistant. + +Pour plus de détails sur la mise en œuvre, vous pouvez également consulter ces tutoriels: + +L'utilisateur GitHub @ryann72 a écrit des instructions détaillées pour [BSB-LAN et HomeAssistant/Mosquitto](https://github.com/ryann72/Home-assistant-tutoriel/blob/main/BSB-LAN/tutoriel%20BSB-LAN%20English.md). Il est également disponible en [français](https://github.com/ryann72/Home-assistant-tutoriel/blob/main/BSB-LAN/tutoriel%20BSB-LAN.md). + +L'utilisateur YouTube @StoneTime a créé deux vidéos (en allemand) dans lesquelles il montre l'[installation de BSB-LAN](https://www.youtube.com/watch?v=n-5I-TUzXuk) ainsi que sa [configuration dans Home Assistant](https://www.youtube.com/watch?v=R2Q-_flTPvk). Dankeschön! + +L'utilisateur YouTube @ArminasTV a créé deux vidéos (en français) dans lesquelles il montre l'[installation de BSB-LAN](https://www.youtube.com/watch?v=5lNgNYlZ7M0&t=0s) ainsi que sa configuration avec [Home Assistant et MQTT](https://www.youtube.com/watch?v=WtmKPo1xMio&t=411s). Merci beaucoup! + +### Homebridge + +L'utilisateur de BSB-LAN, Michael, a écrit un [plugin pour Homebridge](https://www.npmjs.com/package/@bsblan/homebridge-bsblan-thermostat). Merci! + +### ioBroker + +L'utilisateur GitHub @hacki11 a développé [un adaptateur pour ioBroker](https://github.com/hacki11/ioBroker.bsblan). Merci! + +### Jeedom + +L'utilisateur GitHub @bernard-dandrea a écrit un [plugin pour Jeedom](https://bernard-dandrea.github.io/jeedom-BSBLAN/fr_FR/) (avec une description en français). Merci! + +### Node-RED + +L'utilisateur GitHub @konne a écrit un [module pour Node-RED](https://github.com/node-red-contrib/node-red-contrib-bsb-lan). Merci! + +### FHEM + +L'utilisateur du forum FHEM, Luposoft, a écrit une explication concise de la [configuration pour utiliser FHEM via MQTT](https://forum.fhem.de/index.php/topic,29762.msg1129702.html#msg1129702). Merci! + +### openHAB + +Depuis la version 2.5.4, il existe une [liaison](https://www.openhab.org/addons/bindings/bsblan/) qui fait officiellement partie d'OpenHAB. + +### Homematic + +L'utilisateur du forum FHEM, PaulM, a [écrit quelques scripts](https://forum.fhem.de/index.php?topic=29762.1830) pour illustrer l'intégration de BSB-LAN dans Homematic. Merci! + +### SmartHomeNG + +L'utilisateur GitHub @thensty a écrit un [plugin pour SmartHomeNG](https://github.com/smarthomeNG/plugins/tree/develop/bsblan). Merci! + +### Volkszaehler + +L'utilisateur GitHub @lapixo a contribué à un [script pour le projet Volkszaehler](https://github.com/lapixo/volkszaehler_bsb-lan/tree/main). Merci! + +### Script Bash + +L'utilisateur GitHub @khfm a écrit des [scripts Bash](https://github.com/khfm/bsb-lan-readout) pour interroger les données et les afficher à l'aide de gnuplot. Merci! + +--- + +## Échange de données via MQTT + +Il s'agit de la méthode recommandée pour connecter BSB-LAN aux systèmes de domotique car elle permet un échange de données transparent. +En prérequis, un courtier MQTT (tel que [mosquitto](https://mosquitto.org)) est nécessaire, soit en local, soit via un service public. Certains systèmes de domotique tels que Home Assistant proposent l'installation de mosquitto dans le cadre de leur logiciel. + +**Attention:** Actuellement, le courtier mosquitto semble avoir un problème avec la gestion d'un grand nombre de messages à partir des versions 2.0.16 et ultérieures ([voir ce rapport de bogue](https://github.com/eclipse-mosquitto/mosquitto/issues/2887)). Si vous rencontrez le problème que vos entités BSB-LAN deviennent «indisponibles», en particulier après avoir utilisé la fonctionnalité de découverte automatique ci-dessous, veuillez rétrograder vers la version 2.0.15 de mosquitto. Cependant, soyez conscient que cette version a des problèmes de sécurité, assurez-vous donc que votre courtier s'exécute au moins dans un environnement protégé par un pare-feu. + +Dans BSB-LAN, vous devez effectuer ou activer au moins les configurations suivantes: + +- Définissez le **mode de journalisation** (en plus) sur **Envoyer au courtier MQTT**. +- Définissez l'**intervalle de journalisation** sur le temps (en secondes) pendant lequel vous souhaitez que les paramètres de journalisation soient publiés. +- Sélectionnez jusqu'à 20 **paramètres de journalisation** que vous souhaitez envoyer à votre système de domotique. +- Définissez l'**utilisation de MQTT** sur **texte brut**. +- Définissez le **serveur du courtier MQTT** sur le nom d'hôte de votre courtier MQTT (tel que le serveur mosquitto). + +Si votre système de domotique prend en charge la découverte automatique MQTT (comme c'est le cas avec Home Assistant), vous pouvez appeler la commande URL `/M1!` et BSB-LAN enverra des messages de découverte automatique pour **tous les paramètres disponibles** à partir de l'ID d'appareil `` au courtier MQTT et donc au système de domotique. Vous devrez peut-être effectuer un nettoyage par la suite ou envoyer un message de suppression pour tous ces paramètres à l'aide de la commande URL `/M0!` si vous ne souhaitez plus utiliser cette fonctionnalité. + +Sinon, si vous souhaitez configurer vos propres détails de connexion, la structure de sujet de BSB-LAN est la suivante: +`///` +où + +- `` est défini dans les paramètres de BSB-LAN (par défaut `BSB-LAN`), +- `` est l'ID du régulateur de chauffage (généralement `0` pour le contrôleur principal), +- `` est le numéro de catégorie tel qu'il est utilisé avec la commande URL `/K`, +- `` est le numéro de paramètre, tel que `501.1`. + +Cette structure est suivie de l'un de ces sujets qui déterminent l'action à effectuer: + +- `/status` - contient la valeur du paramètre dans la charge utile MQTT. +- `/set` - utilisé pour définir un paramètre avec la valeur contenue dans la charge utile MQTT publiée à l'aide du télégramme SET (méthode par défaut de définition des paramètres). +- `/inf` - identique à `/set`, mais utilise le télégramme INF (utilisé pour envoyer le paramètre de température ambiante 10000, par exemple). +- `/poll` - ignore la valeur publiée et force BSB-LAN à mettre à jour immédiatement `/status` du même paramètre avec une valeur de paramètre nouvellement récupérée. `/poll` peut également être accessible directement sous le sujet principal (par exemple `BSB-LAN/poll`) où il accepte une liste de paramètres séparés par des virgules. Ces paramètres auront ensuite leurs sujets `/status` respectifs mis à jour en une seule fois. L'adressage des paramètres peut être effectué soit dans le style de sujet (avec une barre oblique de début), soit de manière similaire à la liste des paramètres de journalisation dans les paramètres de BSB-LAN (voir les exemples ci-dessous). + +Dans le même temps, la méthode héritée d'envoi de commandes URL via MQTT directement au sujet principal (tel que défini dans les paramètres, par défaut `BSB-LAN`), est toujours prise en charge pour des raisons de compatibilité, mais est déconseillée. Les réponses seront toujours écrites dans `/status` de la structure de sujet ci-dessus. + +Le sujet `/status` est mis à jour de quatre manières: + +- via les paramètres de journalisation vers MQTT comme expliqué ci-dessus +- chaque fois qu'une requête URL est effectuée sur BSB-LAN (peut être désactivé en **activant** `Only send log parameters to MQTT` dans la configuration) +- chaque fois qu'un paramètre est modifié via l'unité de pièce (peut être désactivé en **activant** `Only send log parameters to MQTT` dans la configuration) +- chaque fois que le paramètre est mis à jour via le sujet `/poll` comme expliqué ci-dessus + +Dans ces cas, les valeurs respectives des paramètres concernés seront envoyées au courtier MQTT, de sorte que même les modifications apportées en dehors de BSB-LAN sont envoyées au système de domotique, c'est pourquoi l'approche MQTT est la méthode recommandée pour se connecter à un système de domotique. +Cela signifie également que, comme alternative à la fonctionnalité de journalisation intégrée de BSB-LAN, vous pouvez également appeler périodiquement une URL avec les paramètres que vous souhaitez voir mis à jour. Étant donné que ces paramètres seront également envoyés au courtier MQTT, votre système de domotique les recevra également. +Par exemple, si vous appelez périodiquement l'URL `http://bsb-lan.local/700/8700`, le mode de fonctionnement du circuit de chauffage 1 (paramètre 700) ainsi que la température extérieure actuelle (paramètre 8700) seront envoyés au courtier MQTT. + +### Exemples d'interrogation ou de définition de paramètres via MQTT à l'aide de mosquitto ### +Interroger la température extérieure (ID d'appareil 0, numéro de catégorie 51, paramètre 8700): +`mosquitto_sub -h my.mosquitto-broker.local -u USER -P PASSWORD -t BSB-LAN/0/51/8700/status` + +Définissez le point de consigne de température de confort (ID d'appareil 0, numéro de catégorie 16, paramètre 710) à 20 degrés: +`mosquitto_pub -h my.mosquitto-broker.local -u USER -P PASSWORD -m "20" -t BSB-LAN/0/16/710/set` + +Forcer la mise à jour immédiate de la température extérieure (ID d'appareil 0, numéro de catégorie 51, paramètre 8700): +`mosquitto_pub -h my.mosquitto-broker.local -u USER -P PASSWORD -m "" -t BSB-LAN/0/51/8700/poll` + +Forcer la mise à jour immédiate des paramètres 700 et 8700 à partir de l'appareil par défaut ainsi que du paramètre 8326 à partir de l'ID d'appareil 1: +`mosquitto_pub -h my.mosquitto-broker.local -u USER -P PASSWORD -m "700,8700,8326!1" -t BSB-LAN/poll` +ou +`mosquitto_pub -h my.mosquitto-broker.local -u USER -P PASSWORD -m "/0/16/700,/0/51/8700,/1/50/8326" -t BSB-LAN/poll` + +**Attention:** Veuillez noter que le numéro de catégorie diffère d'un système à l'autre et doit être comparé avec votre système en premier! + +--- + +## Échange de données via JSON + +BSB-LAN permet d'interroger et de définir des paramètres via des structures JSON et fournit également de nombreuses informations sur les paramètres et les structures de catégories de cette manière. L'API JSON est accessible via des [commandes URL](using.md) et le fichier `openapi.yaml` fourni dans ce référentiel peut être utilisé avec [Swagger](https://editor.swagger.io/?url=https://raw.githubusercontent.com/fredlcore/bsb_lan/master/openapi.yaml) pour explorer ses possibilités et ses fonctionnalités. + +--- + +## Échange de données via des commandes URL et la récupération de données à l'écran + +Pour des solutions plus simples, l'[utilisation de commandes URL](using.md) pour interroger et définir des paramètres peut être utilisée pour contrôler BSB-LAN à partir d'autres systèmes. La récupération de données à l'écran est possible car le projet tente de ne pas rompre certaines façons d'afficher les données, de sorte que l'analyse avec des expressions régulières reste réalisable. Néanmoins, pour la plupart des scénarios, l'une des autres options sera probablement préférable. diff --git a/docs/fr/install.md b/docs/fr/install.md new file mode 100644 index 00000000..25fe3e81 --- /dev/null +++ b/docs/fr/install.md @@ -0,0 +1,51 @@ +# Installation +L'installation de BSB-LAN nécessite trois étapes : + +1. Installer l'IDE Arduino pour flasher le logiciel BSB-LAN sur le microcontrôleur +2. Assembler les pièces matérielles +3. Connecter BSB-LAN au système de chauffage + +## Installation de l'IDE Arduino et flashage de BSB-LAN + +1. [Téléchargez](https://github.com/fredlcore/BSB-LAN/archive/refs/heads/master.zip) et décompressez la version actuelle de BSB-LAN à partir du référentiel principal ou utilisez *git* pour [cloner](https://github.com/fredlcore/BSB-LAN.git) le référentiel. +2. Accédez au dossier BSB_LAN et renommez les fichiers suivants : + 1. `BSB_LAN_custom_defs.h.default` en `BSB_LAN_custom_defs.h` + 2. `BSB_LAN_config.h.default` en `BSB_LAN_config.h`. +3. [Téléchargez](https://www.arduino.cc/en/software) et installez l'IDE Arduino pour votre système. +4. Connectez votre microcontrôleur (ESP32 ou Arduino Due) à votre ordinateur et démarrez l'IDE Arduino. +5. Accédez à ***Outils/Conseil/Gestionnaire de cartes*** et assurez-vous que le framework pour votre carte est installé ("esp32 by Espressif Systems" pour le microcontrôleur ESP32, "Arduino SAM Boards (32-bits ARM Cortex-M3) by Arduino" pour le microcontrôleur Arduino Due) +6. À nouveau, accédez à ***Outils/Conseil*** et sélectionnez votre microcontrôleur : + 1. *ESP32 Dev Module* pour le Joy-It ESP32 NodeMCU. + 2. *Olimex ESP32-EVB* pour l'Olimex EVB basé sur ESP32. + 3. *OlimeMultiplier l'option Olimex ESP32-POE-ISO* pour l'Olimex POE ISO basé sur ESP32 + 4. *Arduino Due (Programming Port)* pour l'Arduino Due. **N'utilisez pas le port USB natif ici** ! +7. À nouveau, accédez à ***Outils/Conseil*** et sélectionnez la vitesse de téléchargement appropriée (jusqu'à 460800 pour ESP32, 115200 pour Arduino Due). +8. [](){#SPIFFS}Pour les microcontrôleurs basés sur ESP32, accédez à nouveau à ***Outils/Conseil*** et sélectionnez "Minimal SPIFFS" pour le schéma de partition (**ne confondez pas ceci avec le schéma de partition "Minimal" similaire** qui est différent et ne fonctionne pas dans notre cas). **Si vous ne définissez pas le bon schéma de partition, le micrologiciel ne rentrera pas dans l'ESP32 !** +9. Accédez à ***Fichier/Ouvrir*** et accédez au dossier BSB_LAN, puis double-cliquez sur `BSB_LAN.ino`. Le projet s'ouvrira. +10. Vous pouvez maintenant passer à la [configuration](configure.md) de BSB-LAN. +11. Une fois la configuration terminée, accédez à ***Esquisse/Téléverser*** et téléversez le logiciel BSB-LAN sur le microcontrôleur. + +### Mises à jour ultérieures sur les microcontrôleurs basés sur ESP32 "over the air" (OTA) + +Si vous exécutez BSB-LAN sur un microcontrôleur basé sur ESP32 et que vous avez activé les mises à jour Over-the-Air dans les [paramètres](configure.md), vous pouvez effectuer les futures mises à jour de BSB-LAN à l'aide de votre navigateur. Pour ce faire, au lieu d'utiliser *Esquisse/Téléverser*, vous devez sélectionner ***Esquisse/Exporter le binaire compilé***. Cela créera un dossier `build` dans votre dossier BSB-LAN dans lequel vous trouverez, entre autres, le fichier `BSB_LAN.ino.bin`. Ouvrez maintenant [http://bsb-lan.local:8080](http://bsb-lan.local:8080) et sélectionnez et téléversez ce fichier. Ne pas interrompre le processus de téléversement. Vous pouvez essayer d'accéder à BSB-LAN à partir d'une autre fenêtre de navigateur pour voir si le processus est terminé. +Veuillez noter que cela ne s'applique qu'aux microcontrôleurs basés sur ESP32. Les cartes Arduino ne prennent pas en charge cette fonctionnalité. + +## Assemblage de l'adaptateur BSB-LAN +Vous pouvez obtenir un adaptateur entièrement assemblé auprès de Frederik (bsb(ät)code-it.de) ou en construire un vous-même (consultez le dossier `schémas` pour les schémas). Une fois que vous avez l'adaptateur BSB-LAN prêt, vous devez simplement le brancher sur le microcontrôleur. Si vous utilisez un microcontrôleur Olimex, vérifiez à nouveau que l'adaptateur est bien centré sur le connecteur, car il peut encore s'insérer même s'il est décalé d'une rangée de broches sur la gauche ou sur la droite. + +## Connexion de BSB-LAN au système de chauffage + +Une fois le microcontrôleur et l'adaptateur BSB-LAN prêts, effectuez les étapes suivantes pour connecter BSB-LAN au système de chauffage : + +1. Débranchez le microcontrôleur de votre ordinateur et éteignez votre système de chauffage. Localisez les connecteurs BSB/LPB/PPS. Vous devrez peut-être ouvrir votre système de chauffage pour cela. Consultez la liste des [systèmes de chauffage pris en charge](supported_heating_systems.md) pour savoir où se trouvent les broches.
***Faites tout cela à vos propres risques !***
***Si vous n'êtes pas prudent, vous risquez d'endommager votre équipement !***
**Prenez particulièrement soin d'éviter les décharges électrostatiques (ESD) qui peuvent détruire à la fois BSB-LAN et le contrôleur de chauffage !** +2. Branchez maintenant l'adaptateur BSB-LAN sur le microcontrôleur et connectez le connecteur à vis `+` au connecteur `CL+` (BSB), `DB` (LPB) ou `A6` (PPS, différents noms de connecteurs sont possibles), et le connecteur à vis `-` au connecteur `CL-` (BSB), `MB` (LPB) ou `M` (PPS). S'il n'y a pas de connecteur vide, il n'y a aucun problème à ajouter les fils pour BSB-LAN à un connecteur déjà "utilisé", à condition que les fils soient insérés avec soin. En ce qui concerne les câbles, un câble torsadé à deux cœurs (idéalement blindé/blindé) est recommandé [par Siemens](https://sid.siemens.com/v/u/20140). Cependant, un certain nombre d'utilisateurs ont également réussi avec un simple fil de téléphone si les distances ne sont pas trop longues. +3. [](){#PowerSupply}Vous devez maintenant alimenter le microcontrôleur. Notez que le système de chauffage n'alimente pas le microcontrôleur, même si la LED de l'adaptateur BSB-LAN s'allume lorsque vous le connectez au système de chauffage. Vous devez alimenter le microcontrôleur via son port USB (ou via PoE sur l'Olimex POE-ISO). Assurez-vous d'utiliser une alimentation stable d'au moins 2 ampères. Une fois le microcontrôleur alimenté, allumez le système de chauffage. La LED rouge de l'adaptateur BSB-LAN doit s'allumer. Il devrait clignoter de temps en temps. +4. Ouvrez maintenant votre navigateur web et accédez à l'adresse IP de BSB-LAN. Si MDNS est activé, vous pouvez directement accéder à [`http://bsb-lan.local`](http://bsb-lan.local). Sinon, vous pouvez trouver l'adresse IP de BSB-LAN dans votre routeur, ou vous pouvez connecter le microcontrôleur à votre PC et ouvrir l'IDE Arduino, puis accéder à ***Outils/Moniteur série*** et définir la vitesse du moniteur série sur 115200. Redémarrez le microcontrôleur, et l'adresse IP s'affichera lors de la connexion au réseau. + +## Génération de la liste des paramètres spécifiques à l'appareil + +Lorsque vous accédez à BSB-LAN pour la première fois, vous remarquerez que seuls quelques paramètres sont affichés sur l'interface Web de l'appareil. Cela est dû au fait que chaque modèle du contrôleur Siemens intégré à votre système de chauffage prend en charge un ensemble différent de paramètres. Auparavant, je fournissais une liste de paramètres collectés à partir de tous les types de systèmes de chauffage, mais il s'est avéré que cette liste était ambiguë ou contenait même des erreurs que nous ne pouvions pas corriger de manière fiable. Cette liste est toujours disponible dans la version 2.2.x de BSB-LAN et peut être copiée à partir de là si nécessaire. +Cependant, il n'est pas conseillé de le faire car les ambiguïtés et les erreurs susmentionnées présentent un risque trop élevé de mauvaise configuration du système de chauffage. Il est plutôt recommandé de cliquer sur le bouton "**Liste des paramètres spécifiques à l'appareil**" dans le menu BSB-LAN et d'envoyer la liste générée à Frederik (bsb(ät)code-it.de). À partir de ce fichier, une liste de paramètres peut être générée qui correspond exactement au contrôleur de votre système de chauffage. Malheureusement, ce processus ne peut pas encore être automatisé, mais au moins il n'a besoin d'être effectué qu'une seule fois. Ces données brutes ne contiennent aucun paramètre ni aucun autre type de données personnelles, uniquement la structure des paramètres du système de chauffage. +Il est dans mon propre intérêt de créer et de renvoyer ces listes de paramètres sans délai, mais je vous demande de bien vouloir comprendre si cela prend un peu plus de temps en raison de mon travail ou de questions familiales. + +Une fois que vous avez reçu la liste des paramètres (ou que vous avez pris celle de la version 2.2.x), vous devez remplacer le fichier `BSB_LAN_custom_defs.h` existant par celui qui vous a été envoyé, le compiler et le flasher à nouveau. Vous êtes maintenant prêt à accéder à tous les paramètres. diff --git a/docs/fr/list_of_controllers.md b/docs/fr/list_of_controllers.md new file mode 100644 index 00000000..f476655a --- /dev/null +++ b/docs/fr/list_of_controllers.md @@ -0,0 +1 @@ +AVS37, [AVS55][RVS21-AVS55], AVS71, AVS74, AVS75, AVS77, AVS79, [LMS14][LMS14], [LMS15][LMS14], [LMU54][LMU64], [LMU64][LMU64], [LMU74][LMU74], [LMU75][LMU74], RVA33, RVA36, RVA43, RVA46, RVA47, [RVA53][RVA53], RVA60, RVA61, [RVA63][RVA63], RVA65, RVA66, RVC32, RVD110, RVD115, RVD120, RVD125, RVD130, RVD135, RVD139, RVD140, RVD144, RVD145, RVD230, RVD235, RVD240, RVD245, RVD250, RVD255, RVD260, RVD265, RVL469, RVL470, RVL471, RVL472, RVL479, RVL480, RVL481, RVL482, RVP340, RVP350, RVP351, RVP360, RVP361, [RVP54][RVP54], RVP5xx, [RVS13][RVS13], [RVS21][RVS21], [RVS23][RVS23], RVS26, [RVS41][RVS41], [RVS43][RVS43], [RVS46][RVS46], RVS47, [RVS51][RVS51], [RVS53][RVS53], [RVS61][RVS61], [RVS63][RVS63], [RVS65][RVS65], RVS68, RWI65, WRI80 diff --git a/docs/fr/quickstart.md b/docs/fr/quickstart.md new file mode 100644 index 00000000..fdecb9a6 --- /dev/null +++ b/docs/fr/quickstart.md @@ -0,0 +1,46 @@ +# Instructions de démarrage rapide +Ces instructions de démarrage rapide s'adressent aux utilisateurs qui sont familiarisés avec l'installation et la configuration de logiciels sur leur ordinateur. Si vous avez besoin d'instructions plus détaillées, veuillez consulter les [instructions d'installation](install.md) ! + +1. Assurez-vous que votre système de chauffage est [compatible](supported_heating_systems.md) avec BSB-LAN ! +2. [Téléchargez](https://github.com/fredlcore/BSB-LAN/archive/refs/heads/master.zip) et décompressez la version actuelle de BSB-LAN à partir du référentiel principal ou utilisez *git* pour [cloner](https://github.com/fredlcore/BSB-LAN.git) le référentiel. +3. Accédez au dossier BSB_LAN et renommez les fichiers suivants : + 1. `BSB_LAN_custom_defs.h.default` en `BSB_LAN_custom_defs.h` + 2. `BSB_LAN_config.h.default` en `BSB_LAN_config.h`. +4. [Téléchargez](https://www.arduino.cc/en/software) et installez l'IDE Arduino pour votre système. +5. Connectez votre microcontrôleur (ESP32 ou Arduino Due) à votre ordinateur et démarrez l'IDE Arduino. +6. Accédez à ***Outils/Board/Board Manager*** et assurez-vous que le framework pour votre carte est installé ("esp32 by Espressif Systems" pour le microcontrôleur ESP32, "Arduino SAM Boards (32-bits ARM Cortex-M3) by Arduino" pour le microcontrôleur Arduino Due) +7. À nouveau, accédez à ***Outils/Board*** et sélectionnez votre microcontrôleur : + 1. *ESP32 Dev Module* pour le Joy-It ESP32 NodeMCU. + 2. *Olimex ESP32-EVB* pour l'Olimex EVB basé sur ESP32. + 3. *Olimex ESP32-POE-ISO* pour l'Olimex POE ISO basé sur ESP32 + 4. *Arduino Due (Programming Port)* pour l'Arduino Due. **N'utilisez pas le port USB natif ici** ! +8. À nouveau, accédez à ***Outils/Board*** et sélectionnez la vitesse de téléchargement appropriée (jusqu'à 460800 pour ESP32, 115200 pour Arduino Due). +9. Pour les microcontrôleurs basés sur ESP32, accédez à nouveau à ***Outils/Partition Scheme*** et sélectionnez "Minimal SPIFFS" pour le schéma de partition (**ne confondez pas avec le schéma de partition "Minimal" similaire qui est différent et ne fonctionne pas dans notre cas**). **Si vous ne définissez pas le bon schéma de partition, le micrologiciel ne rentrera pas dans l'ESP32** ! +10. Accédez à ***Fichier/Ouvrir*** et accédez au dossier BSB_LAN, puis double-cliquez sur `BSB_LAN.ino`. Le projet s'ouvrira. +11. Cliquez sur l'onglet avec le nom de fichier `BSB_LAN_config.h` et configurez au moins les options suivantes : + 1. Recherchez `#define LANG DE` : changez `DE` en `EN` pour l'anglais, `FR` pour le français, etc. + 2. Recherchez `uint8_t network_type` : définissez cette option sur `LAN` si vous utilisez une connexion Ethernet/LAN. Définissez-la sur `WLAN` si vous utilisez une connexion WiFi/WLAN. + 3. Si vous n'utilisez pas DHCP, configurez les options suivantes en fonction de votre réseau (assurez-vous d'utiliser une virgule, et non un point, pour les adresses IP !) : + 1. `byte ip_addr[4] = {192,168,178,88};` + 2. `byte gateway_addr[4] = {192,168,178,1};` + 3. `byte dns_addr[4] = {192,168,178,1};` + 4. `byte subnet_addr[4] = {255,255,255,0};` + 5. `char wifi_ssid[32] = "Your_Wifi_network_name";` + 6. `char wifi_pass[32] = "Your_WiFi_network_password";` +12. Accédez maintenant à ***Sketch/Upload*** et téléchargez le logiciel BSB-LAN sur le microcontrôleur. +13. Déconnectez le microcontrôleur et éteignez votre système de chauffage. Localisez les connecteurs BSB/LPB/PPS. Vous devrez peut-être ouvrir votre système de chauffage pour cela. ***Faites tout cela à vos propres risques*** ! +14. Connectez maintenant l'adaptateur BSB-LAN au microcontrôleur et connectez le connecteur à vis `+` au connecteur `CL+` (BSB), `DB` (LPB) ou `A6` (PPS, les noms des connecteurs peuvent varier), et le connecteur à vis `-` au connecteur `CL-` (BSB), `MB` (LPB) ou `M` (PPS). +15. Allumez le microcontrôleur via le port USB ou via PoE (uniquement Olimex POE-ISO). Puis allumez le système de chauffage. Le LED rouge de l'adaptateur BSB-LAN doit s'allumer. Il devrait clignoter de temps en temps. +16. Ouvrez maintenant votre navigateur web et accédez à l'adresse IP de BSB-LAN. Si MDNS est activé, vous pouvez directement accéder à `http://bsb-lan.local`. Vous pouvez trouver l'adresse IP de BSB-LAN dans votre routeur, ou vous pouvez connecter le microcontrôleur à votre PC et ouvrir l'IDE Arduino, puis accéder à ***Outils/Moniteur série***. Redémarrez le microcontrôleur, et l'adresse IP s'affichera lors de la connexion au réseau. +17. **C'est terminé :-)** +--- +## Ça ne fonctionne pas ! + +Veuillez vous assurer de vérifier **chaque entrée** dans la [section Dépannage](troubleshooting.md) avant de nous contacter ! + +--- +## Pourquoi est-ce que je ne vois que quelques paramètres ? + +Lors de votre première connexion à BSB-LAN, vous remarquerez que seuls quelques paramètres sont affichés sur l'interface Web de l'appareil. Cela est dû au fait que chaque modèle du contrôleur Siemens intégré à votre système de chauffage prend en charge un ensemble différent de paramètres. Auparavant, je fournissais une liste de paramètres collectés à partir de différents types de systèmes de chauffage, mais il s'est avéré que cette liste était ambiguë ou contenait même des erreurs que nous ne pouvions pas corriger de manière fiable. Cette liste est toujours disponible dans la version 2.2.x de BSB-LAN et peut être copiée à partir de là si nécessaire. +Cependant, il n'est pas conseillé de le faire car les ambiguïtés et les erreurs mentionnées présentent un risque trop élevé de mauvaise configuration du système de chauffage. Il est plutôt recommandé de cliquer sur le bouton "**Liste des paramètres spécifiques à l'appareil**" dans le menu de BSB-LAN et d'envoyer la liste générée à Frederik (bsb(ät)code-it.de). À partir de ce fichier, une liste de paramètres peut être générée qui correspond exactement au contrôleur de votre système de chauffage. Malheureusement, ce processus ne peut pas encore être automatisé, mais au moins il n'a besoin d'être fait qu'une seule fois. Ces données brutes ne contiennent aucune configuration ni aucun autre type de données personnelles, uniquement la structure des paramètres du système de chauffage. +Il est dans mon propre intérêt de créer et de renvoyer ces listes de paramètres sans délai, mais je vous prie de bien vouloir comprendre si cela prend un peu plus de temps en raison de mon travail ou de mes obligations familiales. diff --git a/docs/fr/supported_heating_systems.md b/docs/fr/supported_heating_systems.md new file mode 100644 index 00000000..0fd05e9b --- /dev/null +++ b/docs/fr/supported_heating_systems.md @@ -0,0 +1,57 @@ +# Systèmes de chauffage pris en charge + +BSB-LAN prend en charge les systèmes de chauffage qui communiquent à l'aide du [BSB (Boiler System Bus)](bus_systems.md#BSB), du [LPB (Local Process Bus)](bus_systems.md#LPB) ou du [PPS (Punkt-zu-Punkt-Schnittstelle)](bus_systems.md#PPS). Ces contrôleurs sont généralement fabriqués par Siemens, les modèles plus anciens peuvent encore porter le nom de "Landis & Stafea" ou "Landis & Gyr". + +Nous avons compilé une [liste de modèles fonctionnels](supported_models.md) de différents fabricants de systèmes de chauffage qui ont été confirmés comme fonctionnant avec BSB-LAN, bien qu'il n'y ait pas de garantie à 100 % que les fabricants conservent le nom du modèle mais changent le contrôleur pour un système différent. Assurez-vous donc toujours de vérifier que les bonnes connecteurs sont disponibles. + +Voici quelques exemples de contrôleurs de chauffage et des connecteurs utilisés pour se connecter à BSB-LAN. Certains connecteurs ont trois broches, d'autres en ont deux. S'il y a trois broches, **assurez-vous de choisir les deux bonnes (CL+ et CL-)** car la troisième broche (G+) sert à fournir l'éclairage de fond pour l'unité de la pièce. Il n'endommagera pas BSB-LAN, mais il peut être trompeur car la LED de BSB-LAN s'allumera même si elle n'est pas connectée à la bonne broche. + +D'ailleurs : Si vous n'avez qu'un seul connecteur et qu'il est déjà occupé par une unité de pièce, il n'y a aucun problème à ajouter BSB-LAN au même connecteur. Faites simplement attention lorsque vous ajoutez les fils pour BSB-LAN. + +| Contrôleur | Image | Remarques | +|:--------:|:---:|:------| +| [](){#LMS14}**LMS14**
**LMS15** | | Connexion BSB :
**+** = Gauche
**-** = Centre | +| **LMS14**
**LMS15** | | Connexion BSB : CL+/CL- | +| **LMS14**
**LMS15**
Baxi Luna Platinum,
Chappee Klista | | Connexion BSB :
Bornier M2
Broche 2 : CL-
Broche 3 : CL+
Consultez les instructions détaillées ici pour Baxi Luna Platinum. | +| [](){#LMU64}**LMU54**
**LMU64** | | Connexion LPB :
via le plugin OCI420 supplémentaire, voir [détails ci-dessous][OCI420]. | +| [](){#LMU74}**LMU74**
**LMU75** | | Connexion BSB :
**+** = Haut
**-** = Centre
Connexion LPB :
via le plugin OCI420 supplémentaire | +| [](){#RVA53}**RVA53** | | Connexion PPS : A6/MD | +| [](){#RVA63}**RVA63** | | Connexion LPB : MB/DB
Connexion PPS : A6/MD | +| [](){#RVP54}**RVP54** | | Connexion PPS : A6/M | +| [](){#RVS13}**RVS13** | | Connexion BSB : CL+/CL- | +| [](){#RVS21}**RVS21** | | Connexion BSB via le connecteur X86
**+** = broche la plus à droite
**-** = deuxième broche à partir de la droite | +| [](){#RVS21-AVS55}**RVS21 avec AVS55** | | Module d'extension AVS55, placé sur le dessus du RVS21.
Connexion BSB via le connecteur X86 :
**+** = broche la plus à droite
**-** = deuxième broche à partir de la droite
ou via le connecteur X150 :
**+** = broche supérieure
**-** = deuxième broche du haut | +| [](){#RVS23}**RVS23** | | Connexion LPB : LPB/M | +| [](){#RVS41}**RVS41** | | Connexion BSB : CL+/CL-
Connexion LPB : MB/DB | +| [](){#RVS43}**RVS43
LOGON B** | | Connexion BSB : CL+/CL-
Connexion LPB : MB/DB | +| [](){#RVS43-ZR1}**RVS46
ISR-ZR1** | | Connexion BSB : CL+/CL-
Connexion LPB : MB/DB | +| [](){#RVS46}**RVS46** | | Connexion BSB : CL+/CL-
Connexion LPB : MB/DB | +| [](){#RVS51}**RVS51** | | Connexion BSB : CL+/CL- | +| [](){#RVS53}**RVS53** | | Connexion BSB : CL+/CL- | +| [](){#RVS61}**RVS61** | | Connexion BSB : CL+/CL-
Connexion LPB : MB/DB | +| [](){#RVS63}**RVS63** | | Connexion BSB : CL+/CL-
Connexion LPB : MB/DB | +| [](){#RVS65}**RVS65** | | Connexion BSB : CL+/CL-
Connexion LPB : MB/DB | + +[](){#OCI420} +## Paramètres de configuration pour OCI420 ## + +Faire fonctionner correctement l'OCI420 peut s'avérer un peu difficile s'il ne fait pas déjà partie d'un réseau LPB existant. Si vous connectez l'OCI420 pour la première fois à votre appareil de chauffage et que vous n'avez aucun autre appareil de chauffage LPB, vous obtiendrez très probablement l'"erreur 81" qui indique qu'il y a une erreur de bus. Mais ne vous inquiétez pas, il s'agit très probablement de configurer quelques paramètres pour le faire fonctionner. Pour le LMU64, le paramètre correspondant est 604 (_LPBKonfig0_). Il doit être défini comme suit pour utiliser BSB-LAN comme seul appareil connecté à l'OCI420 : +``` +604.0 = 0 +604.1 = 1 +604.2 = 1 +604.3 = 1 +604.4 = 1 +604.5 = 0 +604.6 = 0 +604.7 = 0 +``` + +Ensuite, vous devez définir l'adresse LPB de l'OCI420 dans les paramètres 605 (doit être défini sur 1) et 606 (doit être défini sur 0). Par la suite, il ne devrait plus y avoir de message d'erreur et la LED rouge de l'OCI420 devrait clignoter à intervalles réguliers, et vous êtes prêt à connecter et à utiliser BSB-LAN. +**Attention :** Si l'OCI420 est déjà connecté à un autre appareil LPB, **n'apportez aucune modification ici** et connectez plutôt BSB-LAN à l'autre appareil LPB. Il devrait fonctionner sans aucun réglage. + +## Liste des modèles de contrôleurs fonctionnels + +Il existe de nombreux autres contrôleurs qui sont susceptibles de fonctionner avec BSB-LAN. Faites attention à ces modèles de contrôleurs Siemens dans votre système de chauffage : + +--8<-- "docs/fr/list_of_controllers.md" diff --git a/docs/fr/supported_models.md b/docs/fr/supported_models.md new file mode 100644 index 00000000..356496b6 --- /dev/null +++ b/docs/fr/supported_models.md @@ -0,0 +1,48 @@ +# Modèles pris en charge de différents fabricants + +Voici une liste de modèles de différents fabricants qui ont été testés dans le passé avec BSB-LAN. Veuillez noter que les fabricants peuvent à tout moment modifier les spécifications techniques, y compris le contrôleur, sans changer le nom du modèle (ou seulement une très petite partie de celui-ci). Lorsque nous sommes informés d'un tel changement, nous le mentionnons ici, mais il est évident que cette liste n'est pas complète dans les deux sens. Dans tous les cas, veuillez effectuer vous-même une vérification finale pour vous assurer que votre système de chauffage dispose des connecteurs nécessaires pour utiliser BSB-LAN. + +- Brötje : BBK, BBS, BGB, BLW (**voir les exceptions ci-dessous!**), BMK, BMR, BOB, BSK, BSW, Eurocontrol, ISR, LogoBloc, SGB, SOB, SPK, WBC, WBS, WGB (**voir les exceptions ci-dessous!**), WMC, WMS, WOB +- **Modèles Brötje non fonctionnels : BOK, BLW Neo, BLW Split-P, BLW Split C, BLW Split-K C, WGB-K, WGB 14.1/22.1/28.1/38.1, WHC, WHS, WLC, WLS** +- Bösch : pompes à chaleur avec contrôleur de type RVS +- Elco : Aerotop, Aquatop, Rendamax, Straton, Thision (**pas Thision Mini!**), Thision S, Thision S Plus, Trigon S Plus +- ATAG : QR +- Atlantic : Alféa, Axeo, Excellia, Extensa, Hynea hybrid duo gaz, Navistem, Perfinox, Varmax +- Austria Email : LWP, LWPK +- Baxi : Luna Platinum, Luna Duo, Block Kondens +- Boesch : SLS +- Chappée : Luna, Klista +- CitrinSolar : proClima +- CTA : Optiheat +- CTC : 380 IC +- Deville : 9942, 9981 +- Eco : AiWA, AW, BW, DW, heatLite, Star, TBW, WW, WWi, TWW +- Ecostar : Ecodense WT-S 45 +- EVI Heat : Combi-7 +- Fernwärme : RVD230 +- Froeling : Rendagas Plus +- Fujitsu Waterstage : Comfort, Duo, WOHA, WSHA, WSYA, WSYK, WSYP +- Geminox : Thrs +- General : (aka Fujitsu Waterstage) WC13F / WOC13RIYF / WGHA 100DG +- Gruenenwald : Greenheat +- GS : UnoTec +- Hansa : SND +- Herz : Commotherm 5 DeLuxe +- Interdomo : Domostar GBK 25H/SH +- MAN/MHG : Ecostar 200 +- MHG : ecoWP Xe, Procon E +- Oilon : SH, SHx +- Olymp : SHS, WHS +- Palazzetti : Choro Sistema Calore +- Sieger : TG11 +- Šildymo Technologijų Centras (ŠTC) : STC9 +- Sixmadun : TG11BE +- SSP : Proburner +- Sunex : Nexus +- Termomax : Termo ÖV +- Thermics : Energie +- Thermital : TBox Clima TOP +- Tifell : Biofell +- Viessmann : Vitotwin 300-W +- Wamak : AiWa, DB +- Weishaupt : WTU diff --git a/docs/fr/troubleshooting.md b/docs/fr/troubleshooting.md new file mode 100644 index 00000000..736ab350 --- /dev/null +++ b/docs/fr/troubleshooting.md @@ -0,0 +1,93 @@ +# Dépannage + +BSB-LAN s'efforce de rendre l'accès à votre système de chauffage aussi simple que possible, mais il y a toujours des choses qui peuvent mal tourner. Si vous rencontrez encore des problèmes après avoir lu ce document ainsi que la [FAQ](faq.md), veuillez [ouvrir un rapport de bogue](https://github.com/fredlcore/BSB-LAN/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=%5BBUG%5D) sur la page GitHub du projet et assurez-vous de nous fournir tous les fichiers journaux nécessaires et les autres détails requis, en particulier à partir du moniteur série (ou *SerMo* en abrégé). + +Avant de le faire, cependant, assurez-vous d'installer la version la plus récente de BSB-LAN à partir du référentiel maître (et non la version de publication), même si la vôtre n'est vieille que de "quelques" jours. Beaucoup de choses auraient pu se passer depuis lors : ! + +### Utilisation du moniteur série +- Accédez au moniteur série en allant dans ***Outils/Moniteur série*** dans l'IDE Arduino. +- Définissez la vitesse de transmission sur 115200 dans le coin supérieur droit de la fenêtre du moniteur série. +- Assurez-vous de copier les messages à partir du moment où votre microcontrôleur démarre (indiqué par le message `READY`) jusqu'au moment où vous rencontrez le problème. +- Veuillez ne pas envoyer de captures d'écran, uniquement des fichiers texte brut. + +Le moniteur série dans l'IDE Arduino présente actuellement un bogue qui vous permet de ne copier que les parties des messages du moniteur série qui s'affichent à l'écran. Bien que cela signifie que la copie de grandes parties des messages du journal est fastidieuse, vous devez tout de même fournir le journal complet pour obtenir de l'aide. Augmenter la taille de la fenêtre du moniteur série aide un peu. + +--- + +## La compilation échoue : "Croquis trop grand" +- [Sélectionnez le schéma de partition *Minimal SPIFFS*][SPIFFS] dans l'IDE Arduino sous ***Outils/Schéma de partition***. +**Attention :** Ce paramètre est réinitialisé par défaut lors de la mise à jour du framework ESP32 ! +Si vous utilisez des mises à jour par-dessus l'air, vous devez flasher le logiciel une fois via USB après avoir modifié le schéma de partition avant que les mises à jour OTA ne fonctionnent à nouveau. + +--- + +## Plus d'accès à l'interface Web +Si vous avez modifié les paramètres de sorte que vous ne pouvez plus accéder à l'interface Web, il existe deux façons de restaurer le système : + +- **Si vous pouvez flasher l'appareil :** + 1. Configurez `BSB_LAN_config.h` avec des paramètres corrects et fonctionnels. + 2. Définissez `UseEEPROM` sur `0`. + 3. Flasher BSB-LAN sur le microcontrôleur. + 4. Vous pouvez maintenant accéder à BSB-LAN. Accédez à "Paramètres" et enregistrez les paramètres. Cela stockera les paramètres de travail dans l'EEPROM. + 5. Maintenant, modifiez `BSB_LAN_config.h` *à nouveau* ! et définissez `UseEEPROM` sur `1` et flasher à nouveau BSB-LAN sur le microcontrôleur. + 6. Ce n'est qu'à ce moment-là que BSB-LAN lira et utilisera les paramètres de l'EEPROM, vous pourrez donc apporter d'autres modifications dans l'interface Web. +- **Si vous ne pouvez pas flasher l'appareil :** + 1. Si vous ne pouvez pas flasher l'appareil sur place, vous pouvez réinitialiser BSB-LAN sur le dernier paramètre `BSB_LAN_config.h` en connectant deux broches *avant et pendant le démarrage du microcontrôleur* : + - ESP32-Olimex : connecter les broches 34 et 3V3. + - ESP32-NodeMCU : connecter les broches 21 et 3V3. + - Arduino Due : connecter les broches 31 et 33. + 2. Si les broches ont été connectées avec succès, la LED intégrée du microcontrôleur clignotera lentement pendant quatre secondes. + 3. Ensuite, ouvrez la configuration dans l'interface Web, vérifiez tous les paramètres de la configuration et enregistrez-les. Cela stockera les paramètres de travail dans l'EEPROM. +- **Point d'accès temporaire sur un microcontrôleur basé sur ESP32** + - Sur un microcontrôleur basé sur ESP32, BSB-LAN configurera son propre point d'accès sans fil nommé `BSB-LAN` s'il ne peut pas se connecter à un réseau. Dans ce cas, vous pouvez vous connecter à ce point d'accès avec le mot de passe `BSB-LPB-PPS-LAN` et accéder à BSB-LAN via l'adresse IP `http://192.168.4.1` et voir si vous pouvez corriger la configuration de cette manière. Gardez à l'esprit que si vous avez défini une clé de passe ou un nom d'utilisateur et un mot de passe HTTP, ils sont toujours requis si ces détails sont stockés dans l'EEPROM ou `BSB_LAN_config.h`. + +--- + +## Je ne peux accéder qu'à très peu de paramètres via BSB/LPB ! +- Initialement, BSB-LAN n'est fourni qu'avec un petit ensemble de paramètres qui fonctionnent sur (presque) tous les systèmes de chauffage. Vous devez obtenir une [liste de paramètres spécifique à l'appareil](install.md#generating-the-device-specific-parameter-list). + +--- + +## La liste des catégories est soudainement très petite +- BSB-LAN a besoin de détecter le contrôleur du système de chauffage pour déterminer les catégories à afficher. Si BSB-LAN n'est pas connecté au contrôleur ou si la détection échoue, seules quelques catégories universelles sont affichées. + +--- + +## Impossible de lire les paramètres / la famille d'appareils est `0` +- Type de bus incorrect (BSB au lieu de LPB ou vice versa). +- Si la LED rouge de l'adaptateur n'est pas allumée (et idéalement clignote légèrement), il y a un problème de câblage entre l'adaptateur et le système de chauffage. La LED rouge s'allumera une fois l'adaptateur correctement connecté, même si l'adaptateur BSB-LAN n'est même pas connecté au microcontrôleur ! + +--- + +## Pas de données même si la LED rouge de l'adaptateur est allumée +- Assurez-vous que l'adaptateur est connecté à CL+/CL- et non à la troisième broche (G+) : G+ alimentera la LED, mais ce n'est pas une ligne de données. +- [Assurez-vous d'avoir allumé le microcontrôleur][PowerSupply]. Vous pouvez penser que le système de chauffage alimente le microcontrôleur car la LED sur l'adaptateur BSB-LAN est allumée, mais ce n'est pas le cas. Vous devez l'alimenter séparément. +- Avec l'adaptateur pour les microcontrôleurs Olimex : Assurez-vous que la carte adaptatrice BSB-LAN est **exactement** centrée sur le connecteur UEXT. Il s'insérera toujours, s'il est décalé d'une broche vers la gauche ou la droite, mais il ne fonctionnera pas. +- Assurez-vous que les broches RX/TX sont correctement définies/détectées. La séquence de démarrage dans le moniteur série vous montrera quelles broches sont utilisées ou ont été détectées automatiquement. + +--- + +## Pas de connexion réseau ou connexion non fiable +- Essayez d'alimenter le microcontrôleur via USB à partir d'un ordinateur portable. Nous avons eu de nombreux cas où les alimentations étaient peu fiables malgré des spécifications suffisantes. +- Consultez le journal du moniteur série pour vérifier si le microcontrôleur a pu acquérir une adresse IP. Si ce n'est pas le cas, vos paramètres réseau ou votre connexion physique peuvent être défectueux. + +--- + +## Aucune connexion au réseau Wi-Fi masqué possible +- Oui, il s'agit d'une restriction connue. La seule façon de le faire est de [définir explicitement le BSSID][BSSID] dans `BSB_LAN_config.h`. + +--- + +## La température de la pièce (ou tout autre paramètre) ne peut pas être définie +- Vérifiez les paramètres de BSB-LAN et assurez-vous que [l'accès en écriture est activé][WriteAccess] et défini sur *standard* ou *complet*. + +--- + +## L'interface Web se fige lors de l'établissement d'une nouvelle connexion +- BSB-LAN n'est pas un système multitâche. Cela signifie qu'il peut s'occuper d'une tâche à la fois. Donc, même si une commande URL est arrêtée (en fermant la fenêtre du navigateur), BSB-LAN risque de ne pas le détecter et de ne commencer à traiter les nouvelles demandes qu'une fois la précédente terminée. + +--- + +## Le moniteur série n'affiche pas de données lisibles +- Assurez-vous que la vitesse est correctement définie sur 115200 bps. +- Assurez-vous que le bon port est sélectionné. \ No newline at end of file diff --git a/docs/fr/using.md b/docs/fr/using.md new file mode 100644 index 00000000..5f91d6a7 --- /dev/null +++ b/docs/fr/using.md @@ -0,0 +1,138 @@ +# Utilisation de BSB-LAN + +## Contrôle du système de chauffage via l'interface web + +Dans un premier temps, ou si vous souhaitez simplement allumer ou éteindre votre système de chauffage, vous pouvez ouvrir l'interface web de BSB-LAN et accéder au menu *Paramètres*. Cela affichera une liste de catégories de votre contrôleur de chauffage. + +Vous pouvez cliquer sur chaque catégorie pour obtenir une liste des paramètres correspondants. Si vous voyez un bouton `Set`, cela signifie que le paramètre peut être modifié, et en cliquant sur le bouton, la nouvelle valeur sera envoyée au chauffage. Si le bouton `Set` n'est pas présent, le paramètre est en lecture seule et ne peut pas être modifié. + + + +--- + +## Utilisation des commandes URL de BSB-LAN + +La plupart des fonctionnalités de BSB-LAN peuvent être contrôlées à l'aide de commandes URL. Ces commandes sont utiles, voire nécessaires, lorsque vous connectez BSB-LAN à un [système de domotique](homeautomation.md). Elles permettent également d'accéder à des fonctions qui ne sont pas directement accessibles via l'interface web. + +Les commandes URL sont appelées juste après le nom d'hôte de BSB-LAN et une clé de passe (facultative). Par exemple, pour obtenir une liste de catégories, vous devez ouvrir l'URL `http://bsb-lan.local/K` (ou `http://bsb-lan.local/1234/K` si la clé de passe `1234` est utilisée). + +### Interrogation et définition de paramètres + + + +| Commande URL | Fonctionnalité | +|:----------|:------------| +| `/` | Interroger le paramètre `` | +| `/!` | Interroger le paramètre `` du contrôleur à l'adresse de destination `` | +| `///` | Interroger les paramètres ``, `` et ``. Les paramètres peuvent inclure `!` pour adresser différents contrôleurs. | +| `/-` | Interroger les paramètres de `` à `` | +| `/!-` | Interroger les paramètres de `` à `` du contrôleur à l'adresse de destination `` | +| `/K` | Lister toutes les catégories de paramètres du contrôleur à l'adresse de destination par défaut | +| `/K!` | Lister toutes les catégories de paramètres du contrôleur à l'adresse de destination `` | +| `/K` | Interroger tous les paramètres de la catégorie `` du contrôleur à l'adresse de destination par défaut | +| `/K!` | Interroger tous les paramètres de la catégorie `` du contrôleur à l'adresse de destination `` | +| `/S=` | Définir le paramètre `` du contrôleur à l'adresse de destination par défaut sur la valeur ``. Pour définir un paramètre sur `---` (off/désactivé), envoyez simplement une valeur vide : `S=` | +| `/S!=` | Définir le paramètre `` du contrôleur à l'adresse de destination `` sur la valeur `` | +| `/I=` | Envoyer la valeur `y` en tant que télégramme INF au paramètre ``. Cela n'est nécessaire que pour la définition de la température de la pièce (paramètres 10000 ff.). | + +### Configuration + +| Commande URL | Fonctionnalité | +|:----------|:------------| +| `/C` | Configuration | +| `/CO` | Afficher la configuration de BSB-LAN | +| `/P,,` | Définir temporairement le type de bus sur ``, l'adresse propre sur `` et l'adresse cible sur `` | +| `/V` | Activer (`1`) ou désactiver (`0`) le mode de sortie détaillé. Il doit rester activé sauf instruction contraire. | + +### Journalisation + +| Commande URL | Fonctionnalité | +|:----------|:------------| +| `/DG` | Affichage graphique (tracé) d'un fichier journal actif | +| `/D` ou `/DD` | Afficher le fichier journal `datalog.txt` du stockage. Contient les paramètres enregistrés et leurs valeurs lorsque la journalisation sur carte SD est active. | +| `/D` | Afficher les `` derniers jours du calendrier du fichier journal | +| `/D,` | Afficher les données du fichier journal entre `` et ``. `` et `` doivent être au format aaaa-mm-jj (par exemple `/D2024-04-01,2024-04-30`) | +| `/D0` | Réinitialiser les fichiers journaux `datalog.txt` et `journal.txt` et créer de nouveaux en-têtes. Doit être exécuté avant la première journalisation. | +| `/DK` | Supprimer les données plus anciennes que `` jours du fichier journal | +| `/LN` | Forcer la journalisation indépendamment de l'intervalle actuelle et redémarrer l'intervalle configuré à ce moment-là | +| `/L=,,` | Définir l'intervalle de journalisation sur `` secondes et (facultativement) réinitialiser les paramètres de journalisation sur ``, ``, etc. jusqu'au redémarrage | +| `/L=0,0` | Désactiver la journalisation sur le stockage jusqu'au redémarrage | +| `/LB=` | Journaliser uniquement les télégrammes de diffusion (`1`) ou tous les télégrammes (`0`). Le paramètre est actif jusqu'au redémarrage. | +| `/LU=` | Journaliser uniquement les télégrammes de bus inconnus (`1`) ou tous les télégrammes (`0`). Le paramètre est actif jusqu'au redémarrage. | +| `/A=0` | Désactiver le calcul de la moyenne sur 24 heures jusqu'au redémarrage | +| `/A=,,` | Changer le calcul de la moyenne sur 24 heures pour les paramètres ``, `` et `` jusqu'au redémarrage | +| `/B0` | Réinitialiser les statistiques de temps de fonctionnement et de cycles du brûleur | +| `/DD0` | Supprimer uniquement le fichier journal `datalog.txt` | +| `/DJ` | Afficher le fichier journal `journal.txt` du stockage | +| `/DJ0` | Supprimer uniquement le fichier journal `journal.txt` | +| `/LD` | Désactiver la journalisation des télégrammes dans `journal.txt` jusqu'au redémarrage | +| `/LE` | Activer la journalisation des télégrammes dans `journal.txt` | + +### Informations sur les paramètres + +| Commande URL | Fonctionnalité | +|:----------|:------------| +| `/E` | Afficher les options du paramètre ``. Disponible uniquement pour les paramètres de type option, tels que les types de données `VT_ENUM`, `VT_CUSTOM_ENUM`, `VT_BITS` et `VT_CUSTOM_BITS`. | +| `/R` | Interroger la valeur par défaut du paramètre `` | + +### Contrôle GPIO + +| Commande URL | Fonctionnalité | +|:----------|:------------| +| `/G` | Afficher l'état actuel de la broche GPIO `` | +| `/G=` | Définir la broche GPIO `` sur HIGH (`` = `1`) ou LOW (`` = `0`) | + +### Interface JSON + +| Commande URL | Fonctionnalité | +|:----------|:------------| +| `/JQ=,,` | Interroger les paramètres ``, `` et `` et renvoyer une structure JSON | +| `/JQ` | Interroger les paramètres en fonction d'une structure JSON reçue via HTTP POST | +| `/JK=` | Interroger tous les paramètres de la catégorie `` | +| `/JS` | Définir les paramètres en fonction d'une structure JSON reçue via HTTP | +| `/JR` | Interroger la valeur par défaut du paramètre `` et renvoyer une structure JSON | +| `/JK=ALL` | Afficher les plages de toutes les catégories disponibles en tant que structure JSON | +| `/JC=,,` | Afficher les valeurs possibles pour les paramètres ``, `` et `` pour les paramètres de type option. Même structure JSON que `/JK=`. | +| `/JB` | Sauvegarder tous les paramètres modifiables dans une structure JSON qui peut être utilisée pour les réécrire avec `/JS` | +| `/JL` | Créer une structure JSON des paramètres de configuration de BSB-LAN | +| `/JW` | Écrire les paramètres de configuration en fonction d'une structure JSON créée par `/JL` | +| `/JI` | Afficher les informations d'exécution de BSB-LAN en tant que structure JSON | +| `/JV` | Renvoyer la version de l'API JSON de BSB-LAN en tant que structure JSON | + +### Divers + +| Commande URL | Fonctionnalité | +|:----------|:------------| +| `/M!` | Envoyer (`=1`) ou révoquer (`=0`) les messages de découverte automatique MQTT pour tous les paramètres du contrôleur à l'adresse de destination ``. | +| `/N` | Réinitialiser et redémarrer le microcontrôleur (environ 15 secondes) | +| `/NE` | Effacer l'EEPROM et redémarrer le microcontrôleur. Tous les paramètres de configuration seront ensuite lus à partir du fichier de configuration jusqu'à ce qu'ils soient définis et enregistrés à nouveau dans l'interface web pour être écrits dans l'EEPROM. | +| `/QD` | Afficher la structure des paramètres du système de chauffage | +| `/W` | Avec `/W` précédant les commandes URL `C`, `S` et `Q`, les données sont renvoyées sans en-tête et pied de page HTML (par exemple : `/WC` ou `/WS=`). | + +--- + +## Utilisation de la fonctionnalité de tracé graphique + + + +Si des données journalisées sont disponibles sur le stockage (carte SD ou mémoire flash interne), l'option **Afficher le fichier journal** devient cliquable. Par défaut, elle affichera les données journalisées dans le navigateur. + +Pour accéder aux données journalisées elles-mêmes (dans le fichier `datalog.txt`), utilisez la commande URL `/D` mentionnée ci-dessus. + +Par défaut, "Afficher le fichier journal" affiche les données de journalisation des `n` derniers jours (`n=DEFAULT_DAYS_TO_PLOT`, configurable dans `BSB_LAN_config.h`). Ensuite, vous pouvez utiliser les contrôles de la page web pour sélectionner une autre plage, en fonction des données contenues dans le fichier journal. + +Les actions de survol, de clic et de roulette de la souris dans l'affichage graphique offrent diverses options de contrôle : + +- Meilleure lisibilité des numéros de valeur lorsque les tracés sont proches les uns des autres (survol du tracé) +- Les utilisateurs peuvent mettre en surbrillance les tracés de manière interactive pour une meilleure vue d'ensemble (survol des entrées de légende) +- Les utilisateurs peuvent désactiver les tracés de manière interactive pour une meilleure vue d'ensemble et un meilleur ajustement vertical (clic sur les entrées de légende) +- Zoom (roulette de la souris/pinch sur le tracé) et capacité de panoramique (déplacement du tracé zoomé) + +Pour une analyse plus approfondie, vous pouvez utiliser ce [script Python](https://github.com/DE-cr/BSB-LAN/tree/BSB-LAN_evaluate_datalogs/BSB_LAN/scripts/BSB-LAN_evaluate_datalogs) qui prend la sortie du journal de BSB-LAN pour créer des fichiers CSV pivotés qui peuvent être utilisés pour des diagrammes plus informatifs.