Creation of german manual

docs/de/README.md

@@ -0,0 +1,20 @@
+Was ist BSB-LAN?
+<div style="float:left"><svg class='logo' viewBox='0 0 400 400' xmlns='http://www.w3.org/2Multiplier000/svg' height=100% width=100%><path id='b' d='m98 47-63 1c-6 0-12 4-11 11v88c1 5 3 10 10 11l79-1c25-1 24-53 4-61 11-5 18-49-19-49zM48 72h52c1 10-2 18-11 19l-38 1v22l43-1c14 0 14 11 14 20H48Z'/><use href='#b' x='246'/><path d='m268 350 1-100c2-14 14-16 29-1l56 59v-69h25l-1 99c1 12-12 17-22 7l-63-64v69Zm-65-173c-112 90-67 155-34 173-4-11-7-23-6-38h60c0 29-4 31-8 40 57-35 42-86 15-112-21-21-32-40-27-63zm-10 81c13 10 18 20 24 30h-48c5-9 8-18 24-30zM21 239h25v86h77v25l-90-1s-11 1-11-12z M246 47v25h-68c-10 1-11 18 1 18l47 1c41 3 37 63 2 66l-82 1v-25h77c11 0 12-18 0-18h-48c-42-5-37-67 0-67z'/></svg></div>
+ [BSB-LAN ist eine Software-](https://www.bsb-lan.de) /Hardware-Lösung für den Zugriff auf den ["Boiler-System-Bus" (BSB)][BSB], den ["Local-Process-Bus (LPB)"][LPB] und die ["Punkt-zu-Punkt-Schnittstelle" (PPS) ][PPS]. Die BSB-LAN-Hardware ist für verschiedene ESP32-basierte Mikrocontroller (ESP32 NodeMCU, Olimex EVB, Olime0x POE-ISO) sowie für einen Arduino Due mit Ethernet-Shield erhältlich. Es ermöglicht den Zugriff auf Heizsysteme von Atlantic, Brötje, Elco und vielen anderen Herstellern über LAN/WLAN, sofern sie einen der unten aufgeführten Siemens-Controller verwenden. 
+BSB-LAN ermöglicht die Überwachung und Steuerung des Heizsystems und die Protokollierung beliebiger Werte. Dieses Projekt unterstützt fast alle Parameter, die in den Heizsystemen verfügbar sind, und kann eine umfassendere und kostengünstigere Alternative zu OZW 672, OCI 700 oder Remocon Net B sein.
+
+Optionale [Integration in bestehende Smart-Home-Systeme](homeautomation.md) wie [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 oder EDOMI ist über [MQTT][MQTT], [JSON][JSON] oder [HTTP-Zugriff][using] möglich. 
+Der Adapter kann auch als eigenständiger Logger ohne LAN- oder Internetverbindung verwendet werden, wenn eine microSD-Karte eingesetzt wird. 
+Auch Temperatur- und Feuchtigkeitssensoren können angeschlossen und deren Daten protokolliert und analysiert werden. Die Möglichkeit, eigenen Code in die BSB-LAN-Software zu integrieren, bietet außerdem eine Vielzahl von Erweiterungsmöglichkeiten. 
+
+# Wo und wie fange ich an?
+- Sie sind ein erfahrener Benutzer? Dann lesen Sie die [Schnellstartanleitung](quickstart.md). Andernfalls (oder wenn Sie auf Probleme stoßen) lesen Sie bitte weiter!
+- Wird mein Heizsystem von BSB-LAN unterstützt? Bitte besuchen Sie die [Liste der unterstützten Heizsysteme](supported_heating_systems.md).
+- Wenn Sie bereits wissen, dass Ihr System unterstützt wird, erfahren Sie mehr über den [BSB-LAN-Adapter](bsb-lan_adapter.md) und wo Sie ihn erhalten können.
+- Wenn Sie den Adapter bereits haben, möchten Sie vielleicht wissen, [wie Sie den Adapter installieren](install.md).
+- Wenn Sie den Adapter installiert haben, müssen Sie [BSB-LAN konfigurieren](configure.md).
+- Wenn Sie alles eingerichtet haben, erfahren Sie, [wie Sie BSB-LAN verwenden](using.md) oder mehr über die Möglichkeiten, BSB-LAN in [Heimautomatisierungssysteme zu integrieren](homeautomation.md).
+- Wenn Sie BSB-LAN aktualisieren möchten und wissen möchten, was sich seit Ihrer letzten Installation geändert hat, lesen Sie bitte das [ChangeLog](CHANGELOG.md).
+- Unsere [Wiki-Seiten](https://github.com/fredlcore/BSB-LAN/wiki) wachsen kontinuierlich und bieten Hintergrundwissen sowie spezielle Themen zu BSB-LAN und Heizsystemen im Allgemeinen.
+- Wenn Sie auf Probleme stoßen, werfen Sie einen Blick auf die [Seite zur Fehlerbehebung](troubleshooting.md).
+- Und bevor Sie jemand anderem Fragen stellen, schauen Sie bitte zuerst in unsere [Häufig gestellten Fragen (FAQ)](faq.md)!

docs/de/bsb-lan_adapter.md

@@ -0,0 +1,37 @@
+# Der BSB-LAN-Adapter
+---
+### Adapterplatinen verfügbar - kontaktieren Sie Frederik unter bsb(ät)code-it.de (Deutsch oder Englisch) für weitere Details.
+---
+Um eine Verbindung zu Ihrem Heizsystem mit einem Mikrocontroller herzustellen, benötigen Sie eine Adapterplatine, die die notwendige Logik-Pegelumwandlung durchführt:
+<img src="../images/Logic Level Adapter.jpg">
+Der Adapter wird dann direkt auf den Mikrocontroller gesteckt, entweder unter die Pins des ESP32-NodeMCU oder auf den UEXT-Anschluss des 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">  
+
+Die beiden verschiedenen Arten von ESP32-Adaptern (Olimex und ESP32-NodeMCU) unterscheiden sich nur in der Position ihrer Anschlüsse, die anderen Teile der Platine sind identisch.  
+Die Arduino Due-Platine enthält einen EEPROM-Chip, da der Due nicht über einen On-Board-EEPROM verfügt. Daher können Sie die Arduino Due-Platine auf einem ESP32-Mikrocontroller wiederverwenden (wenn Sie die richtigen Pins mit Drähten verbinden), aber Sie können keinen Adapter für den ESP32 auf einem Arduino Due verwenden.
+---
+# Geeignete Mikrocontroller
+
+BSB-LAN kann auf drei verschiedenen Arten von Mikrocontrollern installiert werden:
+
+1. ESP32-Olimex
+2. ESP32-NodeMCU (nur 30-Pin-Version!)
+3. Arduino Due
+
+Olimex produziert mehrere Arten von Platinen:
+Wir empfehlen entweder den [Olimex ESP32-EVB](https://www.olimex.com/Products/IoT/ESP32/ESP32-EVB/open-source-hardware) oder den [Olimex ESP32-POE-ISO](https://www.olimex.com/Products/IoT/ESP32/ESP32-POE-ISO/open-source-hardware). Die einfache POE-Version (ohne "ISO") wird nicht empfohlen, da sie keine gleichzeitige Verbindung mit PoE-Ethernet und USB zulässt.
+
+Der [Arduino Due](https://store.arduino.cc/products/arduino-due) benötigt ein [Ethernet Shield](https://store.arduino.cc/products/arduino-ethernet-shield-2), um auf das lokale Netzwerk zuzugreifen.
+
+Jeder der verschiedenen Controller hat seine Vor- und Nachteile:
+
+|Funktionalität|ESP32-Olimex|ESP32-POE-ISO|ESP32-NodeMCU|Arduino Due|
+|:------------|:----------:|:-----------:|:-----------:|:---------:|
+|Ethernet/LAN |X           |X            |-            |X          |
+|WiFi/WLAN    |X           |X            |X            |-          |
+|Over-the-air aktualisierbar|X |X            |X            |-          |
+|Integrierte Micro-SD-Karte |X |X            |-            |-          |
+|Zugängliche GPIOs|2 (GPIO13/16)|einige|einige|viele         |

docs/de/bus_systems.md

@@ -0,0 +1,54 @@
+# Der BSB/LPB/PPS-Bus
+
+Entwickelt am Ende des letzten Jahrtausends auf Basis des BatiBUS (weitere Informationen finden sich [hier](https://2007.blog.dest-unreach.be/wp-content/uploads/2012/12/Interface-module-I-O-OPEN-ALBATROS-PTM59-20V1_19957_hq-en.pdf) und [hier](https://2007.blog.dest-unreach.be/wp-content/uploads/2012/12/BatiBus_v1.4.pdf)), verwenden viele Siemens-Heizungssteuerungen immer noch den gleichen physischen Bus, um mit Raumgeräten und anderen Heizgeräten zu "kommunizieren". Auch wenn eine Busgeschwindigkeit von nur 4800 Bit pro Sekunde heute anachronistisch erscheinen mag, bietet sie dennoch ein stabiles und robustes Übertragungsprotokoll, das auch heute noch völlig ausreichend ist, wenn es darum geht, kurze Nachrichten von einigen Dutzend Bytes über Leitungen zu übertragen, die manchmal bis zu einem Kilometer lang sind.
+
+Die Bus-Topologie ermöglicht es außerdem, BSB-LAN an jedem beliebigen Punkt anzuschließen: am Raumgerät, an der Heizungsanlage oder überall dort, wo die Busleitungen verfügbar sind. Sie können sogar die beiden Drähte für BSB-LAN in einem bereits "belegten" Steckplatz hinzufügen, ohne dass dies dem anderen Gerät schadet (vorausgesetzt, die Installation ist ordnungsgemäß).
+
+Auf derselben physischen Ebene bieten drei Bussysteme, BSB, LPB und PPS, Lösungen für unterschiedliche Aufgaben, wobei BSB und LPB immer dann vorgezogen werden sollten, wenn sie verfügbar sind, während PPS dennoch eine Reihe von Parametern bietet, die für den durchschnittlichen Benutzer in der Regel völlig ausreichend sind.
+
+BSB-LAN kann auf jedem dieser Busse betrieben werden, und der Wechsel zwischen ihnen ist nur eine Frage der Änderung weniger Einstellungen.
+
+---
+
+[](){#BSB}
+## Der Heizungsbus (BSB)
+
+BSB ist das am häufigsten verwendete Bussystem in Siemens-Steuerungen der letzten 10-15 Jahre. Es ist der Nachfolger des PPS-Systems, mit dem es sich die gleichen physikalischen Parameter teilt, aber es ist viel vielseitiger: Anstatt nur einige Dutzend Parameter kann es auf Hunderte von Parametern zugreifen und diese in verschiedene Kategorien einteilen, um die Navigation zu erleichtern. Es handelt sich um ein transaktionsbasiertes Protokoll, bei dem die meisten Nachrichten von einem Gerät an ein anderes gesendet werden und der Empfänger eine Art von Feedback zurücksendet, z. B. ob die Aufgabe abgeschlossen werden konnte oder ob sie ungültige Daten enthielt.
+
+Obwohl BSB in der Lage ist, mehrere Geräte auf dem Bus anzusprechen, wird es nicht in Systemen mit mehr als einem Heizgerät verwendet. Das Heizgerät hat immer die ID `0`, die Anzeigeeinheit an der Heizungsanlage hat die ID `10` (oder `0x0A` in hexadezimal) und die Standard-Raumgerät hat die ID `6`. BSB-LAN hat die ID `66` oder `0x42` in hexadezimal. Raumgeräte, die "BSB sprechen", sind z. B. das QAA55 und das QAA75.
+
+---
+
+[](){#LPB}
+## Der lokale Prozessbus (LPB)
+
+LPB wurde ungefähr zur gleichen Zeit wie PPS eingeführt, das es in Bezug auf die Kommunikation mit anderen Heizgeräten ergänzte: Während PPS zur Kommunikation mit dem Raumgerät verwendet wurde, wurde LPB verwendet, um Befehle von einem Haupt-Heizgerät an ein oder mehrere Hilf-Heizgeräte zu senden, z. B. in einer Kaskaden-Konfiguration. Zu dieser Zeit bezogen sich die meisten über LPB übertragenen Informationen auf die internen Abläufe der Heizungsanlage (wie Sensordaten oder interne Solltemperaturen), während die für den Benutzer relevanten Parameter (wie z. B. die Komfort-Soll-Raumtemperatur) nur über PPS verfügbar waren. Heutzutage bieten Heizgeräte, die sowohl LPB als auch BSB unterstützen, auf beiden Bussystemen die gleichen Parameterinformationen an.
+
+LPB verwendet ein spezifisches Adressierungsschema mit Segmenten und Geräten. Jedes Segment von 0 bis 15 kann bis zu 15 Geräte (von 1 bis 15) enthalten. Beim Schreiben dieser Adressen werden Segment und Gerät durch einen Doppelpunkt getrennt: `00:01` oder `04:03`.
+
+Um die segmentbasierte Adresse in die für BSB-LAN erforderliche Ziel-ID umzuwandeln, lautet die Formel wie folgt:
+`SEGMENT` multipliziert mit 16 plus `GERÄT` minus eins.
+Beispiel: Gerät 3 im Segment 4 entspricht `4 * 16 + 3 - 1` = 66.
+Die Haupt-Heizungsanlage ist per Definition `00:01`, was einer Ziel-ID 0 entspricht.
+Weitere Informationen zum LPB-System und seiner Implementierung finden Sie in diesen beiden Dokumenten aus den späten 1990er Jahren, die eines die [grundlegenden Systemdaten](https://sid.siemens.com/v/u/20138) abdeckt, die die Konzeptionierung eines LPB-Netzwerks umfassen, und das andere sich mit den [grundlegenden technischen Daten](https://sid.siemens.com/v/u/20140) befasst und Details zu Kabellängen und -durchmessern usw. enthält.
+
+Mit Ausnahme einiger Weishaut-Heizgeräte sind Raumgeräte nicht über LPB mit der Heizungsanlage verbunden. Neuere Modelle verwenden für diese Aufgabe BSB, während ältere Modelle entweder PPS oder in einigen Fällen auch OpenTherm verwenden.
+
+---
+
+[](){#PPS}
+## Die Punkt-zu-Punkt-Schnittstelle (PPS)
+
+Die Punkt-zu-Punkt-Schnittstelle (PPS, abgeleitet vom deutschen Begriff "Punkt-zu-Punkt-Schnittstelle") ist auf der physischen Ebene mit den anderen Systemen kompatibel, aber nicht in der Art und Weise, wie Nachrichten-Telegramme ausgetauscht werden. Während BSB und LPB miteinander kommunizieren, indem sie Telegramme senden und deren Empfang bestätigen, wird PPS vom Heizgerät dominiert. Das Heizgerät sendet ständig seine Daten an das Raumgerät und teilt diesem mit, wann und welche Art von Informationen es senden soll. Daher kann es einige Minuten dauern, bis ein in BSB-LAN eingestellter Wert tatsächlich vom Heizsystem angefordert und dort angezeigt wird.
+
+Es handelt sich außerdem um ein sehr zeitkritisches Protokoll, sodass lange andere Aufgaben, die BSB-LAN erledigen soll, zu einer vorübergehenden Unterbrechung und möglicherweise zu einer Fehlermeldung auf der Heizungsanlage führen. Allerdings sollte sich dies nach kurzer Zeit von selbst erledigen, wenn die beiden Komponenten wieder miteinander "kommunizieren".
+
+Im Gegensatz zu BSB und LPB werden Änderungen, die in BSB-LAN vorgenommen werden, nicht sofort wirksam. Änderungen von Werten, beispielsweise der Soll-Raumtemperatur, werden zunächst intern in BSB-LAN gespeichert und erst an das Heizsystem gesendet, wenn dieses das Raumgerät (d. h. BSB-LAN) auffordert, dies zu tun. Dies kann bis zu einer Minute oder sogar länger dauern, sodass man nicht verwirrt sein sollte, wenn Einstellungen nicht sofort auf dem Heizgerät angezeigt werden, wie es bei BSB und LPB der Fall ist.
+
+Mit PPS kann BSB-LAN in zwei Modi betrieben werden: entweder passives Abhören oder als Raumgerät. Im Passivmodus kann BSB-LAN nur den Datenaustausch zwischen dem Raumgerät und dem Heizgerät mithören. Es ist nicht möglich, eigene Daten zu senden, da diese sofort von den gleichen Daten überschrieben würden, die vom Raumgerät kommen.
+
+Um Parameterdaten an das Heizsystem zu senden, muss BSB-LAN im "Raumgerät"-Modus ausgeführt werden, was bedeutet, dass alle Raumgeräte vom Heizsystem entfernt werden müssen. In diesem Fall ist es besonders wichtig, regelmäßig einen Raumtemperaturwert an BSB-LAN zu senden, der diesen Wert wiederum an das Heizgerät weiterleitet. Nur wenn der Heizkörper ausschließlich auf der Grundlage der Außentemperatur arbeitet, kann dieser Wert ignoriert werden.
+
+BSB-LAN speichert einige Werte in seinem nicht flüchtigen EEPROM, aber einige Werte müssen nach einem Neustart neu eingestellt werden, wie z. B. die Soll-Raumtemperatur. Dies soll verhindern, dass ein ungültig gewordener Parameterwert gespeichert und gesendet wird, nur weil er im EEPROM gespeichert ist.
+
+Raumgeräte, die häufig mit Heizsystemen verwendet werden, die PPS unterstützen, sind das QAA50 und das QAA70.