Merge pull request #677 from plauwers/french_manual

Added french translations for the manual

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) !

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:
+<img src="../images/Logic Level Adapter.jpg">
+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:
+
+<img src="../images/Logic Level Adapter on NodeMCU.jpg">  
+<img src="../images/Logic Level Adapter in Case.jpg">  
+<img src="../images/Logic Level Adapter on Olimex EVB.jpg">  
+
+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         |

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.