Merge pull request #679 from plauwers/german_manual

Creation of german manual

docs/de/README.md

@@ -0,0 +1,24 @@
+# Was ist BSB-LAN?
+
+[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, Olimex 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 es dir, das Heizsystem zu überwachen und zu steuern und beliebige Werte zu protokollieren. Dieses Projekt unterstützt fast alle Parameter, die in Heizsystemen verfügbar sind, und kann eine umfassendere und kostengünstigere Alternative zu OZW 672, OCI 700 oder Remocon Net B sein.
+
+Eine 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 du eine microSD-Karte verwendest.
+
+Temperatur- und Feuchtigkeitssensoren können ebenfalls angeschlossen und deren Daten protokolliert und analysiert werden. Die Möglichkeit, deinen eigenen Code in die BSB-LAN-Software zu integrieren, bietet außerdem eine Vielzahl von Erweiterungsmöglichkeiten.
+
+# Wo und wie fange ich an?
+
+- Wenn du ein erfahrener Benutzer bist, kannst du direkt zu den [Schnellstartanweisungen](quickstart.md) gehen. Wenn nicht (oder wenn du auf Probleme stößt), lies bitte weiter!
+- Wird mein Heizsystem von BSB-LAN unterstützt? Bitte gehe zur [Liste der unterstützten Heizsysteme](supported_heating_systems.md).
+- Wenn du bereits weißt, dass dein System unterstützt wird, erfahre mehr über den [BSB-LAN-Adapter](bsb-lan_adapter.md) und wo du ihn bekommen kannst.
+- Wenn du den Adapter bereits hast, möchtest du vielleicht wissen, [wie du den Adapter installierst](install.md).
+- Wenn du den Adapter installiert hast, musst du [BSB-LAN konfigurieren](configure.md).
+- Sobald alles eingerichtet ist, findest du heraus, [wie du BSB-LAN verwendest](using.md) oder mehr über die Möglichkeiten erfährst, BSB-LAN in [Home-Automation-Systeme zu integrieren](homeautomation.md).
+- Wenn du BSB-LAN aktualisieren möchtest und wissen möchtest, was sich seit deiner letzten Installation geändert hat, solltest du das [ChangeLog](CHANGELOG.md) überprüfen.
+- 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 du auf Probleme stößt, wirf einen Blick auf die [Seite zur Fehlerbehebung](troubleshooting.md).
+- Und bevor du jemand anderem irgendwelche Fragen stellst, schau dir zuerst unsere [Häufig gestellten Fragen (FAQ)](faq.md) an!

docs/de/bsb-lan_adapter.md

@@ -0,0 +1,38 @@
+# Der BSB-LAN-Adapter
+---
+### Adapterplatinen verfügbar – schreib' Frederik einfach eine E-Mail an bsb(ät)code-it.de (auf Deutsch oder Englisch) für weitere Details.
+---
+Um dein Heizsystem mit einem Mikrocontroller zu verbinden, benötigst du eine Adapterplatine, die die notwendige Logik-Pegelumwandlung vornimmt:
+<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 die Due-Platine keinen integrierten EEPROM hat. Daher kannst du die Arduino Due-Platine auf einem ESP32-Mikrocontroller wiederverwenden (wenn du die richtigen Pins mit Drähten verbindest), aber du kannst 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 die [Olimex ESP32-EVB](https://www.olimex.com/Products/IoT/ESP32/ESP32-EVB/open-source-hardware) oder die [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 microSD-Karte |X |X            |-            |-          |
+|Zugängliche GPIOs|2 (GPIO13/16)|einige|einige|viele         |

docs/de/bus_systems.md

@@ -0,0 +1,53 @@
+# Der BSB/LPB/PPS-Bus
+
+Entwickelt Ende des letzten Jahrtausends auf Basis des BatiBUS (weitere Informationen findest du [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 immer noch 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 senden, die manchmal bis zu einem Kilometer lang sind.
+
+Die Bus-Topologie ermöglicht es dir 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. Du kannst sogar die beiden Drähte für BSB-LAN in einem bereits "besetzten" Steckplatz hinzufügen, ohne das andere Gerät zu beschädigen (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 vorgezogen werden sollten, wenn sie verfügbar sind. PPS bietet jedoch in der Regel eine ausreichende Anzahl an Parametern für den durchschnittlichen Benutzer. BSB-LAN kann auf jedem dieser Busse ausgeführt werden und der Wechsel zwischen ihnen ist einfach durch Ändern einiger Einstellungen möglich.
+
+---
+
+[](){#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 die gleichen physikalischen Parameter teilt, aber viel vielseitiger ist: 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 Feedback gibt, 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 zum Beispiel QAA55 und 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, beispielsweise 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, die gleichen Parameter-Daten auf beiden Bussystemen 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, wird folgende Formel verwendet:
+`SEGMENT` mal 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.
+
+Um mehr über das LPB-System und seine Implementierung zu erfahren, kannst du auf diese beiden Dokumente aus den späten 1990er Jahren zurückgreifen: Eines behandelt die [grundlegenden Systemdaten](https://sid.siemens.com/v/u/20138) und die Konzeptionierung eines LPB-Netzwerks, das andere befasst sich mit den [grundlegenden technischen Daten](https://sid.siemens.com/v/u/20140) und enthält Details zu Kabellängen und -durchmessern usw.
+
+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 kontinuierlich seine Daten an das Raumgerät und teilt diesem mit, wann und welche Art von Informationen es senden soll. Es kann also bis zu einigen 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 andere Aufgaben, die BSB-LAN erledigen soll, zu einer vorübergehenden Unterbrechung und möglicherweise zu einer Fehlermeldung auf der Heizungsanlage führen können. Allerdings sollte sich dies nach kurzer Zeit von selbst beheben, 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 Komfort-Soll-Raumtemperatur, werden zunächst intern in BSB-LAN gespeichert und erst an die Heizungsanlage gesendet, wenn diese das Raumgerät (d. h. BSB-LAN) dazu auffordert. Dies kann bis zu einer Minute dauern, daher sollte man nicht verwirrt sein, wenn Einstellungen nicht sofort auf dem Heizgerät erscheinen, 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 die Heizungsanlage zu senden, muss BSB-LAN im "Raumgerät"-Modus ausgeführt werden, was bedeutet, dass alle Raumgeräte von der Heizungsanlage entfernt werden müssen. In diesem Fall ist es besonders wichtig, regelmäßig einen Raumtemperaturwert an BSB-LAN zu senden, der diesen Wert dann an das Heizgerät weiterleitet. Nur wenn der Heizkörper ausschließlich auf der Außentemperatur basiert, 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 Raumtemperatur-Soll-Einstellung. Dies verhindert, dass ein ungültig gewordener Parameterwert gespeichert und gesendet wird, nur weil er im EEPROM gespeichert ist.
+
+Raumgeräte, die häufig mit Heizungsanlagen verwendet werden, die PPS unterstützen, sind QAA50 und QAA70.