TippvomTibb - Benutzerbeiträge [de]

Multifunktionstester Tooltop ET616/ET618

2026-08-02T20:33:51Z

Chris T. Ludwig:

=Allgemeines=

''Deutsche Übersetzung des Originalhandbuchs „Multifunctional Tester User Manual“ (Art.-Nr. 501061802 V2). Technische Zeichnungen wurden als SVG-Vektorgrafiken neu erstellt; Beschriftungen, die tatsächlich auf dem Gehäuse des Geräts aufgedruckt sind (z. B. '''MAIN''', '''LENGTH''', '''MODE''', '''SCAN''', '''DMM'''), wurden bewusst nicht übersetzt, damit sie mit dem realen Gerät übereinstimmen.''

Alle Rechte vorbehalten. Gedruckt in China. Technische Änderungen ohne vorherige Ankündigung vorbehalten. Alle Produktnamen sind Warenzeichen der jeweiligen Unternehmen. Art.-Nr.: 501061802 V2

Ein Review steht noch aus!

__TOC__

== Sicherheitsinformationen ==

Diese Geräteserie erfüllt IEC1010 (International Electrotechnical Commission). Bitte lesen Sie vor der Benutzung die Sicherheitsinformationen.

Lesen Sie die technischen Daten sorgfältig durch. Nur Modelle mit Multimeterfunktion dürfen zur Messung von Gleich-/Wechselspannung und -strom ab 36 V eingesetzt werden.

Messen Sie niemals Spannungen ab 36 V (außer PoE), wenn das Modell keine Multimeterfunktion besitzt. Diese Spannungen stellen eine Stromschlaggefahr dar.

# Geben Sie bei der Spannungsmessung niemals mehr als 1000 V DC bzw. 400 V AC (Effektivwert) ein. Geben Sie bei der Strommessung niemals mehr als 10 A ein.
# Bis 36 V ist das Gerät sicher. Prüfen Sie zur Vermeidung eines Stromschlags den Anschluss und die Isolierung der Prüfleitungen, bevor Sie Spannungen ab 36 V DC bzw. 25 V DC messen.
# Entfernen Sie die Prüfleitungen vom Messpunkt, bevor Sie Funktion oder Messbereich wechseln.
# Das Gerät verfügt bereits über einen vollständigen Schutz. Wählen Sie dennoch aus Sicherheitsgründen stets die richtige Funktion und den richtigen Messbereich.
# Sicherheitssymbole:
:[[File:icon_warning.svg|24px]] Gefährliche Spannung, bitte Benutzerhandbuch beachten.
:[[File:icon_earth.svg|24px]] Erde/Masse.
:[[File:icon_lowbattery.svg|24px]] Batteriespannung niedrig.

{| class="wikitable" style="background:#fff3cd; border:2px solid #d9822b;" | '''⚠ Warnung:'''
# Verwenden Sie das Gerät nicht, wenn es beschädigt aussieht und/oder sich ungewöhnlich verhält. Der Schutz des Geräts kann beeinträchtigt sein, wenn es beschädigt oder auffällig wirkt.
# Überschreiten Sie den Messbereich nicht. Andernfalls können Anwender verletzt und das Gerät beschädigt werden.
# Verwenden Sie das Gerät nicht unmittelbar vor, während oder unmittelbar nach einem Gewitter.
# Entfernen Sie die Batterien, wenn das Gerät längere Zeit gelagert werden soll. Werden die Batterien nicht entfernt, kann auslaufende Batterieflüssigkeit das Gerät beschädigen.
# Das Gerät darf nicht zum Suchen oder Prüfen spannungsführender Kabel verwendet werden. Der Kontakt mit einem spannungsführenden Kabel kann den Anwender verletzen und das Gerät beschädigen.
# Bei Verwendung als Multimeter dürfen nur die Prüfleitungen an das Gerät angeschlossen werden. Werden andere Anschlüsse mit spannungsführenden Kabeln verbunden (ausgenommen PoE-Geräte), können Anwender verletzt und/oder das Gerät beschädigt werden.
# Prüfen Sie die Batterie, wenn die Batterieanzeige im LCD des Hauptgeräts aufleuchtet und/oder die rote LED am Empfänger blinkt.
# Öffnen Sie das Gehäuse nicht. Lassen Sie das Gerät bei Bedarf von einer Fachkraft reparieren.
|}

== Einführung ==

Dieses Messgerät vereint Kabelverfolgung, Kabellängenmessung und Multimeterfunktionen. Die Vorteile dieses Geräts sind die große Reichweite bei der Kabelverfolgung, klare Tonsignale, eine schnelle und präzise Kabellängenmessung sowie ein genaues Multimeter. Das Gerät ist ein nützliches Werkzeug für Labore, Fabriken, Funkamateure, Netzwerkinstallateure und Techniker.

Es kann in Echtzeit die Länge von Netzwerkkabeln sowie Kurzschlüsse und Leitungsunterbrechungen messen.

Die Kabelverfolgungsfunktion findet das gesuchte Kabel schnell und zuverlässig unter einer Vielzahl von Kabeln. Diese Funktion kann bei Telefonanlagen, Computernetzwerken, BNC-Kabeln und anderen metallischen Netzwerkkabeln eingesetzt werden.

Unsere digitale Verfolgungstechnik nutzt die neueste störungsfreie Digitaltechnologie und bietet dem Anwender damit ein angenehmes Nutzererlebnis.

Das Gerät ist ein unverzichtbares Werkzeug für Computernetzwerke, Telekommunikationsverkabelung, BNC-Verkabelung und andere metallische Verkabelungsprojekte.

=== Arbeitsprinzip ===

Die Kabellängenmessung erfolgt, indem ein Signal auf eine der Adern im Kabel gegeben wird. Durch Empfang und Berechnung des reflektierten Impulses wird die Kabellänge ermittelt.

Durch Aussenden eines Signals vom MAIN-Anschluss zum Zielkabel wird ein analoges Signalfeld erzeugt. Der Empfänger erkennt dieses Signalfeld und findet so das Zielkabel.

== Eigenschaften ==

# Netzwerkkabel-Längenmessung, max. 500 m
# Multimeterfunktionen
# Kabelverfolgung
# Ansprechendes, professionelles Design
# Zahlreiche Kabelprüfverfahren und PoE-Spannungsmessung
# Taschenlampe
# Automatische Abschaltung
# Einstellbare Empfindlichkeit/Lautstärke
# Wiederaufladbarer Lithium-Akku zur Schonung der Umwelt

=== Lieferumfang ===

* Hauptgerät (Sender)
* Empfänger
* Benutzerhandbuch
* 9-V-Batterie
* 3,7-V-Lithium-Akku
* USB-Netzteil
* RJ45-Kabel
* Krokodilklemme
* Multimeter-Zubehör (Prüfleitungen und Temperaturfühler Typ K)

=== Funktionsübersicht ===

{| class="wikitable"
! Funktion !! Beschreibung
|-
| Kabelverfolgung (SCAN) || Findet das gesuchte Kabel unter einer Vielzahl von Kabeln.
|-
| Kabelpaarungsprüfung (TEST) || Prüft Unterbrechung, Kurzschluss und Kabelbelegung (Cable Mapping).
|-
| V (VOLT) || Prüft Polarität und Spannung von Batterien/Telefonleitungen.
|-
| Durchgangsprüfung (OHM) || Prüft Unterbrechung oder Kurzschluss einer Telefonleitung (diese darf dabei nicht an eine Spannungsquelle angeschlossen sein).
|-
| ID-Zuordnung || Prüfung von Netzwerk-Switches und Kabeln durch Anschluss eines Endes an die Remote-ID-Einheit.
|-
| PoE-Test || Prüft Kabelbelegung, Polarität und Spannung von PoE-Netzwerk-Switches.
|-
| Taschenlampe || Weißes Licht.
|-
| Einstellbare Empfindlichkeit || Lautstärke des Tonsignals einstellbar.
|-
| Längenmessung || Kabellänge, Kurzschluss und Leitungsunterbrechung messbar.
|-
| Umschaltbares Verfolgungssignal || Frequenz für die Kabelverfolgung einstellbar.
|-
| Multimeter || DCV, ACV, Durchgangsprüfung, Diode, Temperatur, NCV, Widerstand, ACA und DCA.
|}

== Produktbeschreibung ==

[[File:fig_p5_product.svg|thumb|center|650px|Hauptgerät (links), Empfänger (rechts) und DMM-Eingangsbuchse (unten links) mit Bedienelementen]]

{| class="wikitable" style="background:#fff3cd; border:2px solid #d9822b;" | '''⚠ Warnung:'''Das Produkt wird beschädigt, wenn der Anschluss für Längenmessung (LENGTH) mit PoE oder anderen spannungsführenden Geräten verbunden wird.|}

=== Bedienelemente im Detail ===

'''1. MAIN – Netzwerkkabel-Eingangsbuchse'''
:MAIN: Hier werden Netzwerkkabel, Telefonleitung und das Krokodilklemmenkabel zur Belegungsprüfung, Kabelverfolgung, PoE-Polaritätsprüfung, Batteriespannungsmessung oder Durchgangsprüfung angeschlossen.
:LENGTH: Hier wird das Kabel zur Längenmessung angeschlossen.

'''2. Ergebnisanzeige''' – zeigt Gerätestatus, Prüfergebnis, Verbindungsanzeige usw. sowie den Batteriestand an.

'''3. Drucktasten'''
:3.1 '''EIN/MODE'''-Taste: 2 Sekunden gedrückt halten, um das Gerät einzuschalten. Drücken, um zwischen den Funktionen zu wechseln (Length – Cable Pairing – Cable Tracing – V – Continuity – Switch-Belegungsprüfung – blinkende Switch-Anzeige – Remote-ID-Verfolgung – PoE-Spannung – NCV – Length).
:3.2 '''∧'''-Taste: Bei der Kabelverfolgung Umschalten zwischen analogem und digitalem Signal. Bei der Kabellängenmessung Wechsel des Adernpaars. Bei der Belegungsprüfung Ausführung der normalen Prüfung. Gedrückt halten, um die weiße Beleuchtung ein-/auszuschalten.
:3.3 '''∨'''-Taste: Umschalten zwischen analogem und digitalem Signal. Bei der Kabellängenmessung Auswahl des Kabeltyps. Bei der Belegungsprüfung Auswahl der Schnellprüfung. Gedrückt halten, um die Displaybeleuchtung ein-/auszuschalten.
:3.4 '''SCAN'''-Taste: Auswahl der Kabelverfolgungsfunktion (nur bei Modellen ohne Multimeterfunktion).
:3.5 '''DMM'''-Taste (nur bei Modellen mit Multimeterfunktion): Auswahl der Multimeterfunktion. Im Multimetermodus Auswahl zwischen ACV – DCV – Durchgang – Temperatur – NCV – Widerstand – ACA – DCA.

'''4. Tastkopf (Tracing-Sensor)''' – an das Zielkabel (Netzwerkkabel, Telefonleitung, BNC-Kabel oder anderes metallisches Kabel) heranführen. Anhand der Lautstärke lässt sich das Zielkabel orten.

'''5. Taschenlampe''' – lässt sich über einen separaten Schalter ein-/ausschalten.

'''6. Lautstärke-/Empfindlichkeitsrad''' – im Analogmodus zur Einstellung der Lautstärke, im Digitalmodus zur Einstellung der Frequenz.

'''7. Taschenlampenschalter''' – schaltet die Taschenlampe ein/aus.

'''8. SCAN-Taste''' – schaltet die Kabelverfolgungsfunktion ein/aus. 2 Sekunden gedrückt halten zum Einschalten; danach Umschalten zwischen analoger Verfolgung, digitaler Verfolgung und digitaler Vibration. Erneut 2 Sekunden gedrückt halten zum Ausschalten.

'''9. Anzeigen (LEDs)''' – bei der Belegungsprüfung zeigt eine leuchtende LED an, dass die zugehörige Ader in gutem Zustand ist.

'''10. RJ45-Kabelbuchse'''

== Bedienungsanleitung ==

=== Spannungsmessung (VOLTAGE) ===

[[File:fig_p11_voltage.svg|thumb|center|550px|Spannungsmessung mit Krokodilklemmenkabel an PoE-Switch oder Batterie]]

Das Gerät hilft, bestimmte Probleme in einem Stromkreis zu erkennen, etwa das Vorhandensein und die Polarität einer Spannung. Der Empfänger wird für diese Funktion nicht benötigt. Stecken Sie das mitgelieferte Krokodilklemmenkabel in die MAIN-Buchse am Hauptgerät. Klemmen Sie die Krokodilklemmen an den zu prüfenden Stromkreis. Liegt an der Telefonleitung eine Spannung an, werden die Adern 3 und 4 mit langen Verbindungslinien dargestellt; die positive Ader blinkt zusätzlich. Liegt keine Spannung an, werden die Adern 3 und 4 mit kurzen Verbindungslinien angezeigt. Alternativ kann die Telefonleitung auch direkt in die MAIN-Buchse gesteckt werden, um zu prüfen, ob sie mit einem RJ11-Stecker versehen ist.

''Hinweis:'' Es dürfen keine Wechselspannungen oder andere Hochspannungskreise gemessen werden. Andernfalls besteht die Gefahr eines Stromschlags.

{| class="wikitable" style="background:#fff3cd; border:2px solid #d9822b;" | '''⚠ Warnung:'''Es ist gefährlich, PoE oder andere spannungsführende Quellen an die LENGTH-Buchse anzuschließen. Dies kann einen Stromschlag verursachen.|}

'''Bedienung:''' Drücken Sie nach dem Einschalten die MODE-Taste, bis der Spannungsmessmodus (Voltage Testing Mode) aktiv ist. Verbinden Sie die zu prüfende Batterie oder andere Spannungsquelle mit den mitgelieferten Krokodilklemmenkabeln. Die Polarität wird angezeigt. Drücken Sie alternativ die MODE-Taste, bis POE und V im Display erscheinen. Das Gerät ist nun im Spannungsmessmodus bereit und zeigt Spannung und Polarität an. Die Nummer der positiven Ader blinkt.

=== Kabelverfolgung (SCAN) ===

[[File:fig_p12_cabletracing.svg|thumb|center|550px|Hauptgerät und Empfänger bei der Kabelverfolgung]]

Diese Funktion hilft dem Anwender, das gesuchte Kabel unter vielen Kabeln zu identifizieren. Stecken Sie ein Ende des Zielkabels (z. B. Netzwerkkabel, Telefonleitung oder ein mit der mitgelieferten Krokodilklemme angeschlossenes BNC-Kabel) in die MAIN-Buchse am Hauptgerät. Schalten Sie das Hauptgerät ein. Wählen Sie die Kabelverfolgungsfunktion. Bei Modellen ohne Multimeterfunktion befindet sich die SCAN-Taste an der rechten Seite. Drücken Sie sie, um die Kabelverfolgungsfunktion auszuwählen. Halten Sie die SCAN-Taste am Empfänger 2 Sekunden gedrückt: Die blaue Anzeige (digitale Suche) oder die rote Anzeige (analoge Suche) schaltet sich ein. Bewegen Sie den Empfänger entlang der infrage kommenden Kabel (Netzwerkkabel, Telefon-Patchpanel, Steckverbinder, Hub). Hören Sie auf das Tonsignal und vergleichen Sie die Lautstärke. Nähert sich der Empfänger dem Zielkabel, wird das Tonsignal lauter; am lautesten ist es direkt am Zielkabel. In lauter Umgebung drücken Sie die ∧-Taste, um das Signal zur leichteren Identifikation zu wechseln. Das Gerät verfügt über zwei analoge Signale (angezeigt durch 1 und 3) und ein digitales Signal (angezeigt durch 2) auf dem Display. Bei Kabeln mit Modularstecker kann der Empfänger auch direkt eingesteckt werden.

=== Durchgangsprüfung (CONTINUITY) ===

[[File:fig_p13_continuity_device.svg|thumb|center|500px|Durchgangsprüfung: Anschluss und Schaltsymbol]]

Mit dieser Funktion wird eine nicht an ein Netzwerk angeschlossene Telefonleitung auf Kurzschluss geprüft. Stellen Sie vor der Prüfung sicher, dass die Telefonleitung spannungsfrei ist. Bei unterbrochenem Stromkreis zeigt das Display „OL“ an.

Bei Kabeln mit Modularstecker stecken Sie das Kabel zur Prüfung direkt in die MAIN/RJ45-Buchse. Andernfalls schließen Sie das Prüfkabel mit den mitgelieferten Krokodilklemmen an.

Diese Funktion kann auch zur Durchgangsprüfung anderer Geräte verwendet werden. Das Gerät zeigt an, ob der Stromkreis unterbrochen ist oder nicht.

'''Bedienung:''' Drücken Sie nach dem Einschalten die MODE-Taste, bis die Durchgangsprüfung aktiv ist. Das Display zeigt „Ω“; klemmen Sie die Krokodilklemmen an Netzwerkkabel, Elektrokabel bzw. Koaxialkabel. Besteht Durchgang, zeigt das Gerät „0 Ω“ an, bei Unterbrechung „OL“.

=== Digitale Kabelverfolgung ===

Das Produkt ist ein störungsfreier digitaler Kabelsucher. Es nutzt fortschrittliche Digitaltechnik für eine präzise, störungsfreie digitale Kabelverfolgung.

'''Bedienung:''' Die Bedienung des Hauptgeräts ist gleich. Die Bedienung des Empfängers unterscheidet sich: Halten Sie die SCAN-Taste 2 Sekunden gedrückt, um ihn einzuschalten. Drücken Sie die Taste, um zwischen digitaler Kabelverfolgung, digitaler Verfolgung mit Vibration (falls beim jeweiligen Modell vorhanden) und analoger Kabelverfolgung zu wechseln. Halten Sie die Taste erneut 2 Sekunden gedrückt, um ihn auszuschalten. Ohne Bedienung schaltet sich das Gerät nach 10 Minuten automatisch ab.

Nach Auswahl der Empfängerfunktion über die SCAN-Taste ist keine weitere Tastenbetätigung nötig. Drücken Sie die SCAN-Taste am Hauptgerät, um die Suchfunktion auszuwählen. Drücken Sie die Hz-Taste, um in den digitalen Suchmodus (L2) zu wechseln. Im digitalen Suchmodus kann die Suchfrequenz nicht verändert werden.

Um den Suchvorgang zu beschleunigen, wird empfohlen, die Empfindlichkeit über das Einstellrad zunächst zu maximieren. Nähert sich das Zielkabel, verringern Sie die Empfindlichkeit, um es genau zu identifizieren. Zur Bestätigung, dass es sich um das richtige Kabel handelt, empfiehlt es sich, das Zielkabel in die RJ45-Buchse am Empfänger zu stecken. Leuchten alle LEDs am Empfänger, ist das angeschlossene Kabel das gesuchte Kabel.

'''Digitale Suche (blaue LED-Anzeige):''' Es kommt die neueste digitale Suchtechnologie zum Einsatz. Das Hauptgerät sendet ein digitales Signal aus. Empfängt der Empfänger dieses über das Zielkabel laufende Signal, reagiert er mit einem Tonsignal (blaue Anzeige leuchtet) oder Vibration (blaue Anzeige blinkt).

'''Analoge Suche (rote LED-Anzeige):''' Auch hier wird empfohlen, die Empfindlichkeit zunächst zu maximieren und beim Annähern an das Zielkabel zu verringern, um es genau zu identifizieren.

=== Kabellängenmessung (LENGTH) ===

[[File:fig_p8_length.svg|thumb|center|450px|Anschluss zur Kabellängenmessung]]

Nach dem Einschalten ist das Gerät bereit zur Kabellängenmessung. Diese Funktion eignet sich für verschiedene metallische Kabel (mindestens 2 m lang), einschließlich Netzwerkkabel, Telefonleitungen und BNC-Kabel.

Stecken Sie zur Längenmessung das Kabel in die LENGTH-Buchse. Lassen Sie das andere Kabelende frei; es darf nicht mit anderen Geräten verbunden werden.

{| class="wikitable" style="background:#fff3cd; border:2px solid #d9822b;" | '''⚠ Warnung:'''Die LENGTH-Buchse ist ausschließlich für die Kabellängenmessung vorgesehen. Das Gerät kann beschädigt werden, wenn sie an PoE oder andere spannungsführende Geräte angeschlossen wird.|}

Nach der Messung zeigt das Gerät den Zustand des Kabels an. Der Status jeder Ader (in der Reihenfolge 1,2,3,4,5,6,7,8) wird angezeigt. So kann der Anwender zusammen mit der Kabellänge erkennen, ob das Kabel in gutem Zustand ist.

Drücken Sie die ∧-Taste, um zwischen der Längenmessung der einzelnen Aderpaare umzuschalten (z. B. Paar 1 und 2, 3 und 6, 4 und 5, 7 und 8). Drücken Sie die ∨-Taste, um den Kabeltyp auszuwählen (8P8C-Kabel, 4P4C-Kabel, Telefonleitungen und BNC-Kabel).

Die Messgenauigkeit der Länge beträgt 2 % ± 1 m. Bei nicht standardisierten Leitungen sollten Anwender vor der Messung eine Kalibrierung durchführen (siehe [[#Längen- und Temperaturkalibrierung|Kalibrierung]]).

'''Bedienung:''' Drücken Sie die Ein/Aus-Taste, um das Gerät einzuschalten. Am unteren Displayrand werden 8P8C-Netzwerkkabel, 4P4C-Netzwerkkabel, Telefonleitungen und BNC-Kabel angezeigt.

=== Cable Mapping (TEST) ===

[[File:fig_p10_cablemapping.svg|thumb|center|600px|Cable-Mapping-Prüfung mit Empfänger, HUB und Remote-ID-Einheit]]

Mit der Cable-Mapping-Funktion können Anwender Leitungsunterbrechungen und die physische Verkabelung folgender Kabeltypen prüfen: UTP-Computernetzwerkkabel nach IEEE 10Base-T bzw. EIA/TIA 568A sowie 2- und 4-adrige Telefonleitungen und andere metallische Netzwerkkabel.

Stecken Sie ein Ende des zu prüfenden Kabels in die MAIN-Buchse am Hauptgerät. Drücken Sie die MODE-Taste, um in den Cable-Mapping-Modus zu wechseln. Stecken Sie das andere Kabelende in die RJ45-Buchse am Empfänger. Stimmt die Anzeige am Empfänger mit der am Hauptgerät angezeigten Nummer überein, ist das geprüfte Kabel in gutem Zustand.

'''Bedienung:''' Drücken Sie die MODE-Taste, um zwischen Cable Mapping (TEST), Switch-Belegungsprüfung, Prüfung der LED-Anzeigen an Switch-Ports und der Prüfung mit der Remote-ID-Einheit umzuschalten.
* Stecken Sie ein Ende des zu prüfenden Kabels in die MAIN-Buchse am Hauptgerät, das andere Ende in die entsprechende Buchse.
* Zur Kabelprüfung stecken Sie das andere Kabelende in die MAIN-Buchse am Empfänger. Das Hauptgerät zeigt nacheinander den Zustand jeder Ader an. Drücken Sie ∧ für den Schnellmodus, ∨ für den Normalmodus.
* Zur Switch-Belegungsprüfung schließen Sie das andere Kabelende an den Switch an. Das Hauptgerät zeigt nacheinander den Zustand jeder Ader an.
* Um die blinkenden Switch-Anzeigen zu prüfen, schließen Sie das andere Kabelende an den zu prüfenden Switch an. Die LED des Ports, der mit dem Hauptgerät verbunden ist, blinkt einmal pro Sekunde.
* Für die Prüfung mit der Remote-ID-Einheit schließen Sie das andere Kabelende an die Remote-ID-Einheit an. Das Hauptgerät zeigt die Nummer der angeschlossenen Remote-ID an.

=== Multimeter-Funktionen ===

''Die folgenden Anweisungen gelten nur für Modelle mit Multimeterfunktion.''

==== 1.1 Spannungsmessung ====
# Stecken Sie die schwarze Leitung in die COM-Buchse, die rote Leitung in die VΩHz-Buchse.
# Drücken Sie die DMM-Taste und wählen Sie Wechselspannung (ACV) oder Gleichspannung (DCV).
# Berühren Sie mit den Prüfspitzen den Messpunkt. Das Gerät zeigt die gemessene Spannung an. Bei der Gleichspannungsmessung wird zusätzlich die Polarität der roten Leitung angezeigt.

''Achtung:'' Wird „0L“ angezeigt, ist der Messbereich überschritten – Messung sofort abbrechen. Es dürfen keine Spannungen über 1000 V DC bzw. 400 V AC gemessen werden. Berühren Sie keine Hochspannungskreise; schließen Sie bei Hochspannungsmessungen niemals Netzwerkkabel, spannungsführende Leitungen oder Ladekabel an.

==== 1.2 Strommessung ====
# Stecken Sie die schwarze Leitung in die COM-Buchse, die rote Leitung in die 10-A-Buchse.
# Drücken Sie die DMM-Taste und wählen Sie Gleich- oder Wechselstrom.
# Berühren Sie mit den Prüfspitzen den Messpunkt. Das Gerät zeigt den gemessenen Strom an. Bei der Gleichstrommessung wird zusätzlich die Polarität der roten Leitung angezeigt.

''Achtung:'' Wird „0L“ angezeigt, ist der Messbereich überschritten – Messung sofort abbrechen. Es dürfen keine Ströme über 10 A gemessen werden (Messdauer unter 10 Sekunden).

==== 1.3 Widerstandsmessung ====
# Stecken Sie die schwarze Leitung in die COM-Buchse, die rote Leitung in die VΩHz-Buchse.
# Drücken Sie die DMM-Taste und wählen Sie die Widerstandsfunktion. Berühren Sie mit den Prüfspitzen das Messobjekt.

''Achtung:'' „0L“ bedeutet Überschreitung des Messbereichs oder eine Unterbrechung im Messobjekt. Stellen Sie sicher, dass das Messobjekt spannungsfrei und vollständig entladen ist, bevor Sie messen. Legen Sie im Widerstandsmessbereich keine Spannung an. Bei hochohmigen Messungen (> 1 MΩ) kann es einige Sekunden dauern, bis ein stabiler Messwert angezeigt wird.

==== 1.4 Temperaturmessung ====
Drücken Sie die DMM-Taste und wählen Sie den Temperaturbereich. Stecken Sie das kalte (freie), negative (schwarze) Ende des Thermoelement-Fühlers in die COM-Buchse, das rote Ende in die VHz-Buchse. Bringen Sie die Fühlerspitze am oder auf dem Messobjekt an. Die Temperatur wird angezeigt.

''Achtung:'' Verwenden Sie ausschließlich Thermoelemente vom Typ K, sonst kann der Messwert ungenau sein. Legen Sie im Temperaturmessbereich niemals eine Spannung an.

==== 1.5 NCV-Erkennung (berührungslose Spannungsprüfung) ====
Drücken Sie die DMM-Taste und wählen Sie den NCV-Erkennungsbereich. Führen Sie den Sensor nahe an das Messobjekt heran. Die Spannung wird im analogen Balkendiagramm angezeigt; wird eine Spannung erkannt, ertönt ein Signalton.

==== 1.6 Durchgangsprüfung ====
# Stecken Sie die schwarze Leitung in die COM-Buchse, die rote Leitung in die VΩHz-Buchse (Hinweis: die rote Leitung hat Polarität „+“).
# Drücken Sie die DMM-Taste und wählen Sie die Durchgangsprüfung. Berühren Sie mit den Prüfspitzen das Messobjekt. Beträgt der Widerstand zwischen den beiden Kontaktpunkten weniger als 50 Ω, ertönt ein Signalton.

==== 1.7 Diodentest ====
# Stecken Sie die schwarze Leitung in die COM-Buchse, die rote Leitung in die VΩHz-Buchse (Hinweis: die rote Leitung hat Polarität „+“).
# Drücken Sie die DMM-Taste und wählen Sie den Diodenbereich. Verbinden Sie die rote Leitung mit der Anode, die schwarze Leitung mit der Kathode der Diode.

==== 1.8 Automatische Abschaltung ====
Ohne Funktions- oder Tastenbetätigung wechselt das Gerät nach 20 Minuten in den Ruhemodus. Im Ruhemodus stellt ein Druck auf die Ein/Aus-Taste den Normalbetrieb wieder her.

=== 2.1 Anschluss der Prüfleitungen ===

Das Gerät verfügt über Anschlussanzeigen an den Eingangsbuchsen, die dem Anwender die korrekte Steckerbelegung anzeigen. Falsches Anschließen der Prüfleitungen kann das Gerät beschädigen und/oder den Anwender verletzen. Stellen Sie vor jeder Messung sicher, dass der Anschluss korrekt ist.

[[File:fig_p16_testleads.svg|thumb|center|550px|Anschluss der Prüfleitungen für Spannungs-/Widerstands-/Dioden-/Temperaturmessung (oben) und für die 10-A-Strommessung (unten)]]

== Längen- und Temperaturkalibrierung ==

=== Längenkalibrierung ===

Da Kabel aus unterschiedlichen Materialien eine unterschiedliche Leitfähigkeit besitzen, kann das Messergebnis ungenau sein. Um dies auszugleichen, kann das Gerät kalibriert werden.

'''Kalibrierungsverfahren'''
# Schließen Sie bei eingeschaltetem Gerät ein Kabel mit bekannter Länge an die LENGTH-Buchse am Hauptgerät an. Halten Sie im Kabellängenmess-Modus die Tasten ∧ und ∨ gemeinsam 3 Sekunden gedrückt. Das Gerät wechselt in den Kalibriermodus; der Messwert blinkt. Passen Sie den angezeigten Wert mit den Tasten ∧/∨ an, bis er der tatsächlichen Kabellänge entspricht. Drücken Sie anschließend ∨ und MODE gleichzeitig, um das Ergebnis zu speichern und den Kalibriermodus zu verlassen. Jede andere Taste verlässt den Kalibriermodus ohne zu speichern.
# Halten Sie bei eingeschaltetem Gerät ∧ und MODE gemeinsam gedrückt, um das Gerät auf die Werkseinstellung zurückzusetzen.
# Das zur Kalibrierung verwendete Kabel mit bekannter Länge sollte mindestens 5 m lang sein.

'''Temperaturkalibrierung'''

Das Messergebnis kann durch Temperaturunterschiede zwischen Umgebung und Geräteinnerem beeinflusst werden. Auch hierfür verfügt das Gerät über einen Kalibriermodus.
# Wählen Sie bei eingeschaltetem Gerät den Messmodus und halten Sie die Tasten ∧ und ∨ gemeinsam 3 Sekunden gedrückt. Das Gerät wechselt in den Temperatur-Kalibriermodus; der Messwert blinkt. Passen Sie den angezeigten Wert mit ∧/∨ an, bis er der tatsächlichen Temperatur entspricht. Drücken Sie anschließend ∨ und MODE gleichzeitig, um zu speichern und den Modus zu verlassen. Jede andere Taste verlässt den Modus ohne zu speichern.
# Halten Sie bei eingeschaltetem Gerät ∧ und MODE gemeinsam gedrückt, um auf Werkseinstellung zurückzusetzen.
# Verwenden Sie zur Temperaturkalibrierung ein Quecksilberthermometer mit einer Auflösung von 0,1 °C als Referenz.

== Batterie- und Sicherungswechsel ==

[[File:fig_p17_battery.svg|thumb|center|600px|Batteriewechsel im Hauptgerät (oben) und im Empfänger (unten)]]

== Fehlerbehebung ==

{| class="wikitable"
! !! Symptom !! Ursache !! Lösung
|-
| Hauptgerät || Display bleibt nach Drücken der Ein/Aus-Taste dunkel oder blinkt || Batterie leer || Hauptgerät aufladen oder Akku ersetzen (geschützter 3,7-V-Lithium-Akku)
|-
| Empfänger || Beim Drücken der SCAN-Taste ertönt während der Kabelverfolgung kein Ton || Batterie leer oder nicht eingelegt, oder Empfänger zu weit vom Zielkabel entfernt || Batterie wechseln oder Suchbereich vergrößern
|}

== Produktwartung ==

Dieses Gerät ist ein Präzisionsmessgerät. Achten Sie auf ausreichende Batterieladung. Befolgen Sie die Anweisungen, insbesondere im Hinblick auf den korrekten Anschluss an die Multimeter-Eingangsbuchsen. Der Anwender darf die Anschlussbelegung nicht verändern. Andernfalls kann das Gerät beschädigt und der Anwender verletzt werden.

Pflegehinweise:
# Halten Sie das Gerät von Wasser und Staub fern. Lassen Sie es nicht fallen.
# Betreiben Sie das Gerät nicht in brennbarer, explosionsgefährdeter, sehr heißer, feuchter oder stark magnetischer Umgebung.
# Reinigen Sie das Gehäuse mit einem feuchten Tuch und einem milden Reinigungsmittel. Verwenden Sie keine Scheuer- oder Lösungsmittel.
# Entfernen Sie die Batterien, wenn das Gerät längere Zeit gelagert werden soll.
# Laden Sie das Gerät möglichst bald auf, sobald die Batterieanzeige aufleuchtet.

'''Fehlerbehebung und Warnhinweise:''' Funktioniert das Gerät nicht ordnungsgemäß, prüfen Sie Batterie, Sicherung und Ein-/Ausschalter. Lassen Sie das Gerät reparieren, falls sich das Problem nicht beheben lässt.

Alle Angaben können ohne vorherige Ankündigung geändert werden. Sollten Sie Fehler oder fehlende Informationen feststellen, wenden Sie sich bitte an den Hersteller oder Ihren Händler. Das Unternehmen haftet nicht für Schäden oder Verletzungen, die durch unsachgemäße Bedienung entstehen. Keine der genannten Funktionen darf für sicherheitskritische Sonderzwecke herangezogen werden.

== Elektrische Eigenschaften ==

'''Automatische Abschaltung'''
* Hauptgerät: Schaltet sich nach 20 Minuten ohne Tastenbetätigung automatisch ab.
* Empfänger: Schaltet sich nach 10 Minuten ohne Tastenbetätigung automatisch ab.

'''Stromaufnahme'''
* Hauptgerät: 40–130 mA (je nach Funktion)
* Empfänger: ≤ 100 mA

'''Stromversorgung'''
* Empfänger: 9-V-Blockbatterie
* Hauptgerät: geschützter 3,7-V-Lithium-Akku

'''Reichweite des Kabelverfolgungssignals:''' ≥ 3 km

'''Sicherheit:''' Gefahrlos – die Prüfspitze kann direkt mit nicht hochspannungsführenden Metallleitern in Kontakt kommen.

== Technische Daten ==

{| class="wikitable"
! Grundfunktionen !! 616 !! 618
|-
| Analoge Verfolgung || √ || √
|-
| Durchgangsprüfung || √ || über Multimeterfunktion
|-
| Switch-Verfolgung (mit PoE) || √ || √
|-
| Cable Mapping || √ || √
|-
| Blinkende Switch-Anzeige || √ || √
|-
| Störungsfreie digitale Verfolgung || Digital || Digital/Vibration
|-
| Spannungsprüfung || √ || über Multimeterfunktion
|-
| PoE-Spannungsmessung || Spannung/Polarität || Spannung/Polarität
|-
| Remote-ID-Zuordnung || optional || optional
|-
| Analoges Balkendiagramm || √ || √
|-
| NCV-Erkennung || √ || √
|-
| Sonstige Funktionen || colspan="2" | Taschenlampe am Hauptgerät, Anschlussanzeige für Multimeter-Eingang, LCD-Display, weiße Taschenlampe, einstellbare Lautstärke bei analoger Verfolgung, einstellbare Empfindlichkeit bei digitaler Verfolgung, Anzeige für niedrigen Batteriestand, weiße Displaybeleuchtung, Energiesparfunktion, Verfolgungsreichweite 3 km, einstellbares Verfolgungssignal
|-
| Sonderfunktionen || – || √
|-
| colspan="3" | '''Multimeterfunktionen'''
|-
| Gleichspannung || – || 400 mV–1000 V ±(0,8 %+3)
|-
| Wechselspannung || – || 4 V–400 V ±(1,5 %+5)
|-
| Gleichstrom || – || 1,0–10,0 A ±(1,2 %+4)
|-
| Wechselstrom || – || 1,0–10,0 A ±(2,0 %+5)
|-
| Widerstand || – || 200 Ω–20 MΩ ±(2 %+6)
|-
| Durchgang || – || < 50 Ω, Summer ertönt
|-
| Diode || – || √
|-
| Temperatur (Typ K) || – || −20–1000 °C ±(2,0 %+15)
|-
| Netzwerkkabel-Längenmessung || 400 m || 500 m
|-
| BNC-Kabel-Längenmessung || √ || √
|-
| Netzwerkkabel-Kurzschluss-/Unterbrechungstest || √ || √
|-
| Stromversorgung || colspan="2" | Hauptgerät: 1250 mAh wiederaufladbarer Lithium-Akku; Empfänger: 9-V-Batterie
|-
| Lieferumfang || Geschenkbox/Handbuch/Tragetasche/RJ45-Kabel/Krokodilklemmenkabel || Geschenkbox/Handbuch/Tragetasche/RJ45-Kabel/Prüfleitungen/Temperaturfühler Typ K
|}
<nowiki>*</nowiki> Die Remote-ID-Einheit ist optisches Zubehör.<br />
<nowiki>*</nowiki> Die oben genannten Angaben stellen jeweils die besten erreichbaren Spezifikationen dar.

----

[[Kategorie:Benutzerhandbücher]]
[[Kategorie:Messgeräte]]

Multifunktionstester Tooltop ET616/ET618

2026-08-02T20:32:37Z

Chris T. Ludwig: Die Seite wurde neu angelegt: „= Multifunktions-Tester (ET616 / ET618) – Benutzerhandbuch = ''Deutsche Übersetzung des Originalhandbuchs „Multifunctional Tester User Manual“ (Art.-Nr. 501061802 V2). Technische Zeichnungen wurden als SVG-Vektorgrafiken neu erstellt; Beschriftungen, die tatsächlich auf dem Gehäuse des Geräts aufgedruckt sind (z. B. '''MAIN''', '''LENGTH''', '''MODE''', '''SCAN''', '''DMM'''), wurden bewusst nicht übersetzt, damit sie mit dem realen Gerä…“

= Multifunktions-Tester (ET616 / ET618) – Benutzerhandbuch =

''Deutsche Übersetzung des Originalhandbuchs „Multifunctional Tester User Manual“ (Art.-Nr. 501061802 V2). Technische Zeichnungen wurden als SVG-Vektorgrafiken neu erstellt; Beschriftungen, die tatsächlich auf dem Gehäuse des Geräts aufgedruckt sind (z. B. '''MAIN''', '''LENGTH''', '''MODE''', '''SCAN''', '''DMM'''), wurden bewusst nicht übersetzt, damit sie mit dem realen Gerät übereinstimmen.''

Alle Rechte vorbehalten. Gedruckt in China. Technische Änderungen ohne vorherige Ankündigung vorbehalten. Alle Produktnamen sind Warenzeichen der jeweiligen Unternehmen. Art.-Nr.: 501061802 V2

__TOC__

== Sicherheitsinformationen ==

Diese Geräteserie erfüllt IEC1010 (International Electrotechnical Commission). Bitte lesen Sie vor der Benutzung die Sicherheitsinformationen.

Lesen Sie die technischen Daten sorgfältig durch. Nur Modelle mit Multimeterfunktion dürfen zur Messung von Gleich-/Wechselspannung und -strom ab 36 V eingesetzt werden.

Messen Sie niemals Spannungen ab 36 V (außer PoE), wenn das Modell keine Multimeterfunktion besitzt. Diese Spannungen stellen eine Stromschlaggefahr dar.

# Geben Sie bei der Spannungsmessung niemals mehr als 1000 V DC bzw. 400 V AC (Effektivwert) ein. Geben Sie bei der Strommessung niemals mehr als 10 A ein.
# Bis 36 V ist das Gerät sicher. Prüfen Sie zur Vermeidung eines Stromschlags den Anschluss und die Isolierung der Prüfleitungen, bevor Sie Spannungen ab 36 V DC bzw. 25 V DC messen.
# Entfernen Sie die Prüfleitungen vom Messpunkt, bevor Sie Funktion oder Messbereich wechseln.
# Das Gerät verfügt bereits über einen vollständigen Schutz. Wählen Sie dennoch aus Sicherheitsgründen stets die richtige Funktion und den richtigen Messbereich.
# Sicherheitssymbole:
:[[File:icon_warning.svg|24px]] Gefährliche Spannung, bitte Benutzerhandbuch beachten.
:[[File:icon_earth.svg|24px]] Erde/Masse.
:[[File:icon_lowbattery.svg|24px]] Batteriespannung niedrig.

{| class="wikitable" style="background:#fff3cd; border:2px solid #d9822b;" | '''⚠ Warnung:'''
# Verwenden Sie das Gerät nicht, wenn es beschädigt aussieht und/oder sich ungewöhnlich verhält. Der Schutz des Geräts kann beeinträchtigt sein, wenn es beschädigt oder auffällig wirkt.
# Überschreiten Sie den Messbereich nicht. Andernfalls können Anwender verletzt und das Gerät beschädigt werden.
# Verwenden Sie das Gerät nicht unmittelbar vor, während oder unmittelbar nach einem Gewitter.
# Entfernen Sie die Batterien, wenn das Gerät längere Zeit gelagert werden soll. Werden die Batterien nicht entfernt, kann auslaufende Batterieflüssigkeit das Gerät beschädigen.
# Das Gerät darf nicht zum Suchen oder Prüfen spannungsführender Kabel verwendet werden. Der Kontakt mit einem spannungsführenden Kabel kann den Anwender verletzen und das Gerät beschädigen.
# Bei Verwendung als Multimeter dürfen nur die Prüfleitungen an das Gerät angeschlossen werden. Werden andere Anschlüsse mit spannungsführenden Kabeln verbunden (ausgenommen PoE-Geräte), können Anwender verletzt und/oder das Gerät beschädigt werden.
# Prüfen Sie die Batterie, wenn die Batterieanzeige im LCD des Hauptgeräts aufleuchtet und/oder die rote LED am Empfänger blinkt.
# Öffnen Sie das Gehäuse nicht. Lassen Sie das Gerät bei Bedarf von einer Fachkraft reparieren.
|}

== Einführung ==

Dieses Messgerät vereint Kabelverfolgung, Kabellängenmessung und Multimeterfunktionen. Die Vorteile dieses Geräts sind die große Reichweite bei der Kabelverfolgung, klare Tonsignale, eine schnelle und präzise Kabellängenmessung sowie ein genaues Multimeter. Das Gerät ist ein nützliches Werkzeug für Labore, Fabriken, Funkamateure, Netzwerkinstallateure und Techniker.

Es kann in Echtzeit die Länge von Netzwerkkabeln sowie Kurzschlüsse und Leitungsunterbrechungen messen.

Die Kabelverfolgungsfunktion findet das gesuchte Kabel schnell und zuverlässig unter einer Vielzahl von Kabeln. Diese Funktion kann bei Telefonanlagen, Computernetzwerken, BNC-Kabeln und anderen metallischen Netzwerkkabeln eingesetzt werden.

Unsere digitale Verfolgungstechnik nutzt die neueste störungsfreie Digitaltechnologie und bietet dem Anwender damit ein angenehmes Nutzererlebnis.

Das Gerät ist ein unverzichtbares Werkzeug für Computernetzwerke, Telekommunikationsverkabelung, BNC-Verkabelung und andere metallische Verkabelungsprojekte.

=== Arbeitsprinzip ===

Die Kabellängenmessung erfolgt, indem ein Signal auf eine der Adern im Kabel gegeben wird. Durch Empfang und Berechnung des reflektierten Impulses wird die Kabellänge ermittelt.

Durch Aussenden eines Signals vom MAIN-Anschluss zum Zielkabel wird ein analoges Signalfeld erzeugt. Der Empfänger erkennt dieses Signalfeld und findet so das Zielkabel.

== Eigenschaften ==

# Netzwerkkabel-Längenmessung, max. 500 m
# Multimeterfunktionen
# Kabelverfolgung
# Ansprechendes, professionelles Design
# Zahlreiche Kabelprüfverfahren und PoE-Spannungsmessung
# Taschenlampe
# Automatische Abschaltung
# Einstellbare Empfindlichkeit/Lautstärke
# Wiederaufladbarer Lithium-Akku zur Schonung der Umwelt

=== Lieferumfang ===

* Hauptgerät (Sender)
* Empfänger
* Benutzerhandbuch
* 9-V-Batterie
* 3,7-V-Lithium-Akku
* USB-Netzteil
* RJ45-Kabel
* Krokodilklemme
* Multimeter-Zubehör (Prüfleitungen und Temperaturfühler Typ K)

=== Funktionsübersicht ===

{| class="wikitable"
! Funktion !! Beschreibung
|-
| Kabelverfolgung (SCAN) || Findet das gesuchte Kabel unter einer Vielzahl von Kabeln.
|-
| Kabelpaarungsprüfung (TEST) || Prüft Unterbrechung, Kurzschluss und Kabelbelegung (Cable Mapping).
|-
| V (VOLT) || Prüft Polarität und Spannung von Batterien/Telefonleitungen.
|-
| Durchgangsprüfung (OHM) || Prüft Unterbrechung oder Kurzschluss einer Telefonleitung (diese darf dabei nicht an eine Spannungsquelle angeschlossen sein).
|-
| ID-Zuordnung || Prüfung von Netzwerk-Switches und Kabeln durch Anschluss eines Endes an die Remote-ID-Einheit.
|-
| PoE-Test || Prüft Kabelbelegung, Polarität und Spannung von PoE-Netzwerk-Switches.
|-
| Taschenlampe || Weißes Licht.
|-
| Einstellbare Empfindlichkeit || Lautstärke des Tonsignals einstellbar.
|-
| Längenmessung || Kabellänge, Kurzschluss und Leitungsunterbrechung messbar.
|-
| Umschaltbares Verfolgungssignal || Frequenz für die Kabelverfolgung einstellbar.
|-
| Multimeter || DCV, ACV, Durchgangsprüfung, Diode, Temperatur, NCV, Widerstand, ACA und DCA.
|}

== Produktbeschreibung ==

[[File:fig_p5_product.svg|thumb|center|650px|Hauptgerät (links), Empfänger (rechts) und DMM-Eingangsbuchse (unten links) mit Bedienelementen]]

{| class="wikitable" style="background:#fff3cd; border:2px solid #d9822b;" | '''⚠ Warnung:'''Das Produkt wird beschädigt, wenn der Anschluss für Längenmessung (LENGTH) mit PoE oder anderen spannungsführenden Geräten verbunden wird.|}

=== Bedienelemente im Detail ===

'''1. MAIN – Netzwerkkabel-Eingangsbuchse'''
:MAIN: Hier werden Netzwerkkabel, Telefonleitung und das Krokodilklemmenkabel zur Belegungsprüfung, Kabelverfolgung, PoE-Polaritätsprüfung, Batteriespannungsmessung oder Durchgangsprüfung angeschlossen.
:LENGTH: Hier wird das Kabel zur Längenmessung angeschlossen.

'''2. Ergebnisanzeige''' – zeigt Gerätestatus, Prüfergebnis, Verbindungsanzeige usw. sowie den Batteriestand an.

'''3. Drucktasten'''
:3.1 '''EIN/MODE'''-Taste: 2 Sekunden gedrückt halten, um das Gerät einzuschalten. Drücken, um zwischen den Funktionen zu wechseln (Length – Cable Pairing – Cable Tracing – V – Continuity – Switch-Belegungsprüfung – blinkende Switch-Anzeige – Remote-ID-Verfolgung – PoE-Spannung – NCV – Length).
:3.2 '''∧'''-Taste: Bei der Kabelverfolgung Umschalten zwischen analogem und digitalem Signal. Bei der Kabellängenmessung Wechsel des Adernpaars. Bei der Belegungsprüfung Ausführung der normalen Prüfung. Gedrückt halten, um die weiße Beleuchtung ein-/auszuschalten.
:3.3 '''∨'''-Taste: Umschalten zwischen analogem und digitalem Signal. Bei der Kabellängenmessung Auswahl des Kabeltyps. Bei der Belegungsprüfung Auswahl der Schnellprüfung. Gedrückt halten, um die Displaybeleuchtung ein-/auszuschalten.
:3.4 '''SCAN'''-Taste: Auswahl der Kabelverfolgungsfunktion (nur bei Modellen ohne Multimeterfunktion).
:3.5 '''DMM'''-Taste (nur bei Modellen mit Multimeterfunktion): Auswahl der Multimeterfunktion. Im Multimetermodus Auswahl zwischen ACV – DCV – Durchgang – Temperatur – NCV – Widerstand – ACA – DCA.

'''4. Tastkopf (Tracing-Sensor)''' – an das Zielkabel (Netzwerkkabel, Telefonleitung, BNC-Kabel oder anderes metallisches Kabel) heranführen. Anhand der Lautstärke lässt sich das Zielkabel orten.

'''5. Taschenlampe''' – lässt sich über einen separaten Schalter ein-/ausschalten.

'''6. Lautstärke-/Empfindlichkeitsrad''' – im Analogmodus zur Einstellung der Lautstärke, im Digitalmodus zur Einstellung der Frequenz.

'''7. Taschenlampenschalter''' – schaltet die Taschenlampe ein/aus.

'''8. SCAN-Taste''' – schaltet die Kabelverfolgungsfunktion ein/aus. 2 Sekunden gedrückt halten zum Einschalten; danach Umschalten zwischen analoger Verfolgung, digitaler Verfolgung und digitaler Vibration. Erneut 2 Sekunden gedrückt halten zum Ausschalten.

'''9. Anzeigen (LEDs)''' – bei der Belegungsprüfung zeigt eine leuchtende LED an, dass die zugehörige Ader in gutem Zustand ist.

'''10. RJ45-Kabelbuchse'''

== Bedienungsanleitung ==

=== Spannungsmessung (VOLTAGE) ===

[[File:fig_p11_voltage.svg|thumb|center|550px|Spannungsmessung mit Krokodilklemmenkabel an PoE-Switch oder Batterie]]

Das Gerät hilft, bestimmte Probleme in einem Stromkreis zu erkennen, etwa das Vorhandensein und die Polarität einer Spannung. Der Empfänger wird für diese Funktion nicht benötigt. Stecken Sie das mitgelieferte Krokodilklemmenkabel in die MAIN-Buchse am Hauptgerät. Klemmen Sie die Krokodilklemmen an den zu prüfenden Stromkreis. Liegt an der Telefonleitung eine Spannung an, werden die Adern 3 und 4 mit langen Verbindungslinien dargestellt; die positive Ader blinkt zusätzlich. Liegt keine Spannung an, werden die Adern 3 und 4 mit kurzen Verbindungslinien angezeigt. Alternativ kann die Telefonleitung auch direkt in die MAIN-Buchse gesteckt werden, um zu prüfen, ob sie mit einem RJ11-Stecker versehen ist.

''Hinweis:'' Es dürfen keine Wechselspannungen oder andere Hochspannungskreise gemessen werden. Andernfalls besteht die Gefahr eines Stromschlags.

{| class="wikitable" style="background:#fff3cd; border:2px solid #d9822b;" | '''⚠ Warnung:'''Es ist gefährlich, PoE oder andere spannungsführende Quellen an die LENGTH-Buchse anzuschließen. Dies kann einen Stromschlag verursachen.|}

'''Bedienung:''' Drücken Sie nach dem Einschalten die MODE-Taste, bis der Spannungsmessmodus (Voltage Testing Mode) aktiv ist. Verbinden Sie die zu prüfende Batterie oder andere Spannungsquelle mit den mitgelieferten Krokodilklemmenkabeln. Die Polarität wird angezeigt. Drücken Sie alternativ die MODE-Taste, bis POE und V im Display erscheinen. Das Gerät ist nun im Spannungsmessmodus bereit und zeigt Spannung und Polarität an. Die Nummer der positiven Ader blinkt.

=== Kabelverfolgung (SCAN) ===

[[File:fig_p12_cabletracing.svg|thumb|center|550px|Hauptgerät und Empfänger bei der Kabelverfolgung]]

Diese Funktion hilft dem Anwender, das gesuchte Kabel unter vielen Kabeln zu identifizieren. Stecken Sie ein Ende des Zielkabels (z. B. Netzwerkkabel, Telefonleitung oder ein mit der mitgelieferten Krokodilklemme angeschlossenes BNC-Kabel) in die MAIN-Buchse am Hauptgerät. Schalten Sie das Hauptgerät ein. Wählen Sie die Kabelverfolgungsfunktion. Bei Modellen ohne Multimeterfunktion befindet sich die SCAN-Taste an der rechten Seite. Drücken Sie sie, um die Kabelverfolgungsfunktion auszuwählen. Halten Sie die SCAN-Taste am Empfänger 2 Sekunden gedrückt: Die blaue Anzeige (digitale Suche) oder die rote Anzeige (analoge Suche) schaltet sich ein. Bewegen Sie den Empfänger entlang der infrage kommenden Kabel (Netzwerkkabel, Telefon-Patchpanel, Steckverbinder, Hub). Hören Sie auf das Tonsignal und vergleichen Sie die Lautstärke. Nähert sich der Empfänger dem Zielkabel, wird das Tonsignal lauter; am lautesten ist es direkt am Zielkabel. In lauter Umgebung drücken Sie die ∧-Taste, um das Signal zur leichteren Identifikation zu wechseln. Das Gerät verfügt über zwei analoge Signale (angezeigt durch 1 und 3) und ein digitales Signal (angezeigt durch 2) auf dem Display. Bei Kabeln mit Modularstecker kann der Empfänger auch direkt eingesteckt werden.

=== Durchgangsprüfung (CONTINUITY) ===

[[File:fig_p13_continuity_device.svg|thumb|center|500px|Durchgangsprüfung: Anschluss und Schaltsymbol]]

Mit dieser Funktion wird eine nicht an ein Netzwerk angeschlossene Telefonleitung auf Kurzschluss geprüft. Stellen Sie vor der Prüfung sicher, dass die Telefonleitung spannungsfrei ist. Bei unterbrochenem Stromkreis zeigt das Display „OL“ an.

Bei Kabeln mit Modularstecker stecken Sie das Kabel zur Prüfung direkt in die MAIN/RJ45-Buchse. Andernfalls schließen Sie das Prüfkabel mit den mitgelieferten Krokodilklemmen an.

Diese Funktion kann auch zur Durchgangsprüfung anderer Geräte verwendet werden. Das Gerät zeigt an, ob der Stromkreis unterbrochen ist oder nicht.

'''Bedienung:''' Drücken Sie nach dem Einschalten die MODE-Taste, bis die Durchgangsprüfung aktiv ist. Das Display zeigt „Ω“; klemmen Sie die Krokodilklemmen an Netzwerkkabel, Elektrokabel bzw. Koaxialkabel. Besteht Durchgang, zeigt das Gerät „0 Ω“ an, bei Unterbrechung „OL“.

=== Digitale Kabelverfolgung ===

Das Produkt ist ein störungsfreier digitaler Kabelsucher. Es nutzt fortschrittliche Digitaltechnik für eine präzise, störungsfreie digitale Kabelverfolgung.

'''Bedienung:''' Die Bedienung des Hauptgeräts ist gleich. Die Bedienung des Empfängers unterscheidet sich: Halten Sie die SCAN-Taste 2 Sekunden gedrückt, um ihn einzuschalten. Drücken Sie die Taste, um zwischen digitaler Kabelverfolgung, digitaler Verfolgung mit Vibration (falls beim jeweiligen Modell vorhanden) und analoger Kabelverfolgung zu wechseln. Halten Sie die Taste erneut 2 Sekunden gedrückt, um ihn auszuschalten. Ohne Bedienung schaltet sich das Gerät nach 10 Minuten automatisch ab.

Nach Auswahl der Empfängerfunktion über die SCAN-Taste ist keine weitere Tastenbetätigung nötig. Drücken Sie die SCAN-Taste am Hauptgerät, um die Suchfunktion auszuwählen. Drücken Sie die Hz-Taste, um in den digitalen Suchmodus (L2) zu wechseln. Im digitalen Suchmodus kann die Suchfrequenz nicht verändert werden.

Um den Suchvorgang zu beschleunigen, wird empfohlen, die Empfindlichkeit über das Einstellrad zunächst zu maximieren. Nähert sich das Zielkabel, verringern Sie die Empfindlichkeit, um es genau zu identifizieren. Zur Bestätigung, dass es sich um das richtige Kabel handelt, empfiehlt es sich, das Zielkabel in die RJ45-Buchse am Empfänger zu stecken. Leuchten alle LEDs am Empfänger, ist das angeschlossene Kabel das gesuchte Kabel.

'''Digitale Suche (blaue LED-Anzeige):''' Es kommt die neueste digitale Suchtechnologie zum Einsatz. Das Hauptgerät sendet ein digitales Signal aus. Empfängt der Empfänger dieses über das Zielkabel laufende Signal, reagiert er mit einem Tonsignal (blaue Anzeige leuchtet) oder Vibration (blaue Anzeige blinkt).

'''Analoge Suche (rote LED-Anzeige):''' Auch hier wird empfohlen, die Empfindlichkeit zunächst zu maximieren und beim Annähern an das Zielkabel zu verringern, um es genau zu identifizieren.

=== Kabellängenmessung (LENGTH) ===

[[File:fig_p8_length.svg|thumb|center|450px|Anschluss zur Kabellängenmessung]]

Nach dem Einschalten ist das Gerät bereit zur Kabellängenmessung. Diese Funktion eignet sich für verschiedene metallische Kabel (mindestens 2 m lang), einschließlich Netzwerkkabel, Telefonleitungen und BNC-Kabel.

Stecken Sie zur Längenmessung das Kabel in die LENGTH-Buchse. Lassen Sie das andere Kabelende frei; es darf nicht mit anderen Geräten verbunden werden.

{| class="wikitable" style="background:#fff3cd; border:2px solid #d9822b;" | '''⚠ Warnung:'''Die LENGTH-Buchse ist ausschließlich für die Kabellängenmessung vorgesehen. Das Gerät kann beschädigt werden, wenn sie an PoE oder andere spannungsführende Geräte angeschlossen wird.|}

Nach der Messung zeigt das Gerät den Zustand des Kabels an. Der Status jeder Ader (in der Reihenfolge 1,2,3,4,5,6,7,8) wird angezeigt. So kann der Anwender zusammen mit der Kabellänge erkennen, ob das Kabel in gutem Zustand ist.

Drücken Sie die ∧-Taste, um zwischen der Längenmessung der einzelnen Aderpaare umzuschalten (z. B. Paar 1 und 2, 3 und 6, 4 und 5, 7 und 8). Drücken Sie die ∨-Taste, um den Kabeltyp auszuwählen (8P8C-Kabel, 4P4C-Kabel, Telefonleitungen und BNC-Kabel).

Die Messgenauigkeit der Länge beträgt 2 % ± 1 m. Bei nicht standardisierten Leitungen sollten Anwender vor der Messung eine Kalibrierung durchführen (siehe [[#Längen- und Temperaturkalibrierung|Kalibrierung]]).

'''Bedienung:''' Drücken Sie die Ein/Aus-Taste, um das Gerät einzuschalten. Am unteren Displayrand werden 8P8C-Netzwerkkabel, 4P4C-Netzwerkkabel, Telefonleitungen und BNC-Kabel angezeigt.

=== Cable Mapping (TEST) ===

[[File:fig_p10_cablemapping.svg|thumb|center|600px|Cable-Mapping-Prüfung mit Empfänger, HUB und Remote-ID-Einheit]]

Mit der Cable-Mapping-Funktion können Anwender Leitungsunterbrechungen und die physische Verkabelung folgender Kabeltypen prüfen: UTP-Computernetzwerkkabel nach IEEE 10Base-T bzw. EIA/TIA 568A sowie 2- und 4-adrige Telefonleitungen und andere metallische Netzwerkkabel.

Stecken Sie ein Ende des zu prüfenden Kabels in die MAIN-Buchse am Hauptgerät. Drücken Sie die MODE-Taste, um in den Cable-Mapping-Modus zu wechseln. Stecken Sie das andere Kabelende in die RJ45-Buchse am Empfänger. Stimmt die Anzeige am Empfänger mit der am Hauptgerät angezeigten Nummer überein, ist das geprüfte Kabel in gutem Zustand.

'''Bedienung:''' Drücken Sie die MODE-Taste, um zwischen Cable Mapping (TEST), Switch-Belegungsprüfung, Prüfung der LED-Anzeigen an Switch-Ports und der Prüfung mit der Remote-ID-Einheit umzuschalten.
* Stecken Sie ein Ende des zu prüfenden Kabels in die MAIN-Buchse am Hauptgerät, das andere Ende in die entsprechende Buchse.
* Zur Kabelprüfung stecken Sie das andere Kabelende in die MAIN-Buchse am Empfänger. Das Hauptgerät zeigt nacheinander den Zustand jeder Ader an. Drücken Sie ∧ für den Schnellmodus, ∨ für den Normalmodus.
* Zur Switch-Belegungsprüfung schließen Sie das andere Kabelende an den Switch an. Das Hauptgerät zeigt nacheinander den Zustand jeder Ader an.
* Um die blinkenden Switch-Anzeigen zu prüfen, schließen Sie das andere Kabelende an den zu prüfenden Switch an. Die LED des Ports, der mit dem Hauptgerät verbunden ist, blinkt einmal pro Sekunde.
* Für die Prüfung mit der Remote-ID-Einheit schließen Sie das andere Kabelende an die Remote-ID-Einheit an. Das Hauptgerät zeigt die Nummer der angeschlossenen Remote-ID an.

=== Multimeter-Funktionen ===

''Die folgenden Anweisungen gelten nur für Modelle mit Multimeterfunktion.''

==== 1.1 Spannungsmessung ====
# Stecken Sie die schwarze Leitung in die COM-Buchse, die rote Leitung in die VΩHz-Buchse.
# Drücken Sie die DMM-Taste und wählen Sie Wechselspannung (ACV) oder Gleichspannung (DCV).
# Berühren Sie mit den Prüfspitzen den Messpunkt. Das Gerät zeigt die gemessene Spannung an. Bei der Gleichspannungsmessung wird zusätzlich die Polarität der roten Leitung angezeigt.

''Achtung:'' Wird „0L“ angezeigt, ist der Messbereich überschritten – Messung sofort abbrechen. Es dürfen keine Spannungen über 1000 V DC bzw. 400 V AC gemessen werden. Berühren Sie keine Hochspannungskreise; schließen Sie bei Hochspannungsmessungen niemals Netzwerkkabel, spannungsführende Leitungen oder Ladekabel an.

==== 1.2 Strommessung ====
# Stecken Sie die schwarze Leitung in die COM-Buchse, die rote Leitung in die 10-A-Buchse.
# Drücken Sie die DMM-Taste und wählen Sie Gleich- oder Wechselstrom.
# Berühren Sie mit den Prüfspitzen den Messpunkt. Das Gerät zeigt den gemessenen Strom an. Bei der Gleichstrommessung wird zusätzlich die Polarität der roten Leitung angezeigt.

''Achtung:'' Wird „0L“ angezeigt, ist der Messbereich überschritten – Messung sofort abbrechen. Es dürfen keine Ströme über 10 A gemessen werden (Messdauer unter 10 Sekunden).

==== 1.3 Widerstandsmessung ====
# Stecken Sie die schwarze Leitung in die COM-Buchse, die rote Leitung in die VΩHz-Buchse.
# Drücken Sie die DMM-Taste und wählen Sie die Widerstandsfunktion. Berühren Sie mit den Prüfspitzen das Messobjekt.

''Achtung:'' „0L“ bedeutet Überschreitung des Messbereichs oder eine Unterbrechung im Messobjekt. Stellen Sie sicher, dass das Messobjekt spannungsfrei und vollständig entladen ist, bevor Sie messen. Legen Sie im Widerstandsmessbereich keine Spannung an. Bei hochohmigen Messungen (> 1 MΩ) kann es einige Sekunden dauern, bis ein stabiler Messwert angezeigt wird.

==== 1.4 Temperaturmessung ====
Drücken Sie die DMM-Taste und wählen Sie den Temperaturbereich. Stecken Sie das kalte (freie), negative (schwarze) Ende des Thermoelement-Fühlers in die COM-Buchse, das rote Ende in die VHz-Buchse. Bringen Sie die Fühlerspitze am oder auf dem Messobjekt an. Die Temperatur wird angezeigt.

''Achtung:'' Verwenden Sie ausschließlich Thermoelemente vom Typ K, sonst kann der Messwert ungenau sein. Legen Sie im Temperaturmessbereich niemals eine Spannung an.

==== 1.5 NCV-Erkennung (berührungslose Spannungsprüfung) ====
Drücken Sie die DMM-Taste und wählen Sie den NCV-Erkennungsbereich. Führen Sie den Sensor nahe an das Messobjekt heran. Die Spannung wird im analogen Balkendiagramm angezeigt; wird eine Spannung erkannt, ertönt ein Signalton.

==== 1.6 Durchgangsprüfung ====
# Stecken Sie die schwarze Leitung in die COM-Buchse, die rote Leitung in die VΩHz-Buchse (Hinweis: die rote Leitung hat Polarität „+“).
# Drücken Sie die DMM-Taste und wählen Sie die Durchgangsprüfung. Berühren Sie mit den Prüfspitzen das Messobjekt. Beträgt der Widerstand zwischen den beiden Kontaktpunkten weniger als 50 Ω, ertönt ein Signalton.

==== 1.7 Diodentest ====
# Stecken Sie die schwarze Leitung in die COM-Buchse, die rote Leitung in die VΩHz-Buchse (Hinweis: die rote Leitung hat Polarität „+“).
# Drücken Sie die DMM-Taste und wählen Sie den Diodenbereich. Verbinden Sie die rote Leitung mit der Anode, die schwarze Leitung mit der Kathode der Diode.

==== 1.8 Automatische Abschaltung ====
Ohne Funktions- oder Tastenbetätigung wechselt das Gerät nach 20 Minuten in den Ruhemodus. Im Ruhemodus stellt ein Druck auf die Ein/Aus-Taste den Normalbetrieb wieder her.

=== 2.1 Anschluss der Prüfleitungen ===

Das Gerät verfügt über Anschlussanzeigen an den Eingangsbuchsen, die dem Anwender die korrekte Steckerbelegung anzeigen. Falsches Anschließen der Prüfleitungen kann das Gerät beschädigen und/oder den Anwender verletzen. Stellen Sie vor jeder Messung sicher, dass der Anschluss korrekt ist.

[[File:fig_p16_testleads.svg|thumb|center|550px|Anschluss der Prüfleitungen für Spannungs-/Widerstands-/Dioden-/Temperaturmessung (oben) und für die 10-A-Strommessung (unten)]]

== Längen- und Temperaturkalibrierung ==

=== Längenkalibrierung ===

Da Kabel aus unterschiedlichen Materialien eine unterschiedliche Leitfähigkeit besitzen, kann das Messergebnis ungenau sein. Um dies auszugleichen, kann das Gerät kalibriert werden.

'''Kalibrierungsverfahren'''
# Schließen Sie bei eingeschaltetem Gerät ein Kabel mit bekannter Länge an die LENGTH-Buchse am Hauptgerät an. Halten Sie im Kabellängenmess-Modus die Tasten ∧ und ∨ gemeinsam 3 Sekunden gedrückt. Das Gerät wechselt in den Kalibriermodus; der Messwert blinkt. Passen Sie den angezeigten Wert mit den Tasten ∧/∨ an, bis er der tatsächlichen Kabellänge entspricht. Drücken Sie anschließend ∨ und MODE gleichzeitig, um das Ergebnis zu speichern und den Kalibriermodus zu verlassen. Jede andere Taste verlässt den Kalibriermodus ohne zu speichern.
# Halten Sie bei eingeschaltetem Gerät ∧ und MODE gemeinsam gedrückt, um das Gerät auf die Werkseinstellung zurückzusetzen.
# Das zur Kalibrierung verwendete Kabel mit bekannter Länge sollte mindestens 5 m lang sein.

'''Temperaturkalibrierung'''

Das Messergebnis kann durch Temperaturunterschiede zwischen Umgebung und Geräteinnerem beeinflusst werden. Auch hierfür verfügt das Gerät über einen Kalibriermodus.
# Wählen Sie bei eingeschaltetem Gerät den Messmodus und halten Sie die Tasten ∧ und ∨ gemeinsam 3 Sekunden gedrückt. Das Gerät wechselt in den Temperatur-Kalibriermodus; der Messwert blinkt. Passen Sie den angezeigten Wert mit ∧/∨ an, bis er der tatsächlichen Temperatur entspricht. Drücken Sie anschließend ∨ und MODE gleichzeitig, um zu speichern und den Modus zu verlassen. Jede andere Taste verlässt den Modus ohne zu speichern.
# Halten Sie bei eingeschaltetem Gerät ∧ und MODE gemeinsam gedrückt, um auf Werkseinstellung zurückzusetzen.
# Verwenden Sie zur Temperaturkalibrierung ein Quecksilberthermometer mit einer Auflösung von 0,1 °C als Referenz.

== Batterie- und Sicherungswechsel ==

[[File:fig_p17_battery.svg|thumb|center|600px|Batteriewechsel im Hauptgerät (oben) und im Empfänger (unten)]]

== Fehlerbehebung ==

{| class="wikitable"
! !! Symptom !! Ursache !! Lösung
|-
| Hauptgerät || Display bleibt nach Drücken der Ein/Aus-Taste dunkel oder blinkt || Batterie leer || Hauptgerät aufladen oder Akku ersetzen (geschützter 3,7-V-Lithium-Akku)
|-
| Empfänger || Beim Drücken der SCAN-Taste ertönt während der Kabelverfolgung kein Ton || Batterie leer oder nicht eingelegt, oder Empfänger zu weit vom Zielkabel entfernt || Batterie wechseln oder Suchbereich vergrößern
|}

== Produktwartung ==

Dieses Gerät ist ein Präzisionsmessgerät. Achten Sie auf ausreichende Batterieladung. Befolgen Sie die Anweisungen, insbesondere im Hinblick auf den korrekten Anschluss an die Multimeter-Eingangsbuchsen. Der Anwender darf die Anschlussbelegung nicht verändern. Andernfalls kann das Gerät beschädigt und der Anwender verletzt werden.

Pflegehinweise:
# Halten Sie das Gerät von Wasser und Staub fern. Lassen Sie es nicht fallen.
# Betreiben Sie das Gerät nicht in brennbarer, explosionsgefährdeter, sehr heißer, feuchter oder stark magnetischer Umgebung.
# Reinigen Sie das Gehäuse mit einem feuchten Tuch und einem milden Reinigungsmittel. Verwenden Sie keine Scheuer- oder Lösungsmittel.
# Entfernen Sie die Batterien, wenn das Gerät längere Zeit gelagert werden soll.
# Laden Sie das Gerät möglichst bald auf, sobald die Batterieanzeige aufleuchtet.

'''Fehlerbehebung und Warnhinweise:''' Funktioniert das Gerät nicht ordnungsgemäß, prüfen Sie Batterie, Sicherung und Ein-/Ausschalter. Lassen Sie das Gerät reparieren, falls sich das Problem nicht beheben lässt.

Alle Angaben können ohne vorherige Ankündigung geändert werden. Sollten Sie Fehler oder fehlende Informationen feststellen, wenden Sie sich bitte an den Hersteller oder Ihren Händler. Das Unternehmen haftet nicht für Schäden oder Verletzungen, die durch unsachgemäße Bedienung entstehen. Keine der genannten Funktionen darf für sicherheitskritische Sonderzwecke herangezogen werden.

== Elektrische Eigenschaften ==

'''Automatische Abschaltung'''
* Hauptgerät: Schaltet sich nach 20 Minuten ohne Tastenbetätigung automatisch ab.
* Empfänger: Schaltet sich nach 10 Minuten ohne Tastenbetätigung automatisch ab.

'''Stromaufnahme'''
* Hauptgerät: 40–130 mA (je nach Funktion)
* Empfänger: ≤ 100 mA

'''Stromversorgung'''
* Empfänger: 9-V-Blockbatterie
* Hauptgerät: geschützter 3,7-V-Lithium-Akku

'''Reichweite des Kabelverfolgungssignals:''' ≥ 3 km

'''Sicherheit:''' Gefahrlos – die Prüfspitze kann direkt mit nicht hochspannungsführenden Metallleitern in Kontakt kommen.

== Technische Daten ==

{| class="wikitable"
! Grundfunktionen !! 616 !! 618
|-
| Analoge Verfolgung || √ || √
|-
| Durchgangsprüfung || √ || über Multimeterfunktion
|-
| Switch-Verfolgung (mit PoE) || √ || √
|-
| Cable Mapping || √ || √
|-
| Blinkende Switch-Anzeige || √ || √
|-
| Störungsfreie digitale Verfolgung || Digital || Digital/Vibration
|-
| Spannungsprüfung || √ || über Multimeterfunktion
|-
| PoE-Spannungsmessung || Spannung/Polarität || Spannung/Polarität
|-
| Remote-ID-Zuordnung || optional || optional
|-
| Analoges Balkendiagramm || √ || √
|-
| NCV-Erkennung || √ || √
|-
| Sonstige Funktionen || colspan="2" | Taschenlampe am Hauptgerät, Anschlussanzeige für Multimeter-Eingang, LCD-Display, weiße Taschenlampe, einstellbare Lautstärke bei analoger Verfolgung, einstellbare Empfindlichkeit bei digitaler Verfolgung, Anzeige für niedrigen Batteriestand, weiße Displaybeleuchtung, Energiesparfunktion, Verfolgungsreichweite 3 km, einstellbares Verfolgungssignal
|-
| Sonderfunktionen || – || √
|-
| colspan="3" | '''Multimeterfunktionen'''
|-
| Gleichspannung || – || 400 mV–1000 V ±(0,8 %+3)
|-
| Wechselspannung || – || 4 V–400 V ±(1,5 %+5)
|-
| Gleichstrom || – || 1,0–10,0 A ±(1,2 %+4)
|-
| Wechselstrom || – || 1,0–10,0 A ±(2,0 %+5)
|-
| Widerstand || – || 200 Ω–20 MΩ ±(2 %+6)
|-
| Durchgang || – || < 50 Ω, Summer ertönt
|-
| Diode || – || √
|-
| Temperatur (Typ K) || – || −20–1000 °C ±(2,0 %+15)
|-
| Netzwerkkabel-Längenmessung || 400 m || 500 m
|-
| BNC-Kabel-Längenmessung || √ || √
|-
| Netzwerkkabel-Kurzschluss-/Unterbrechungstest || √ || √
|-
| Stromversorgung || colspan="2" | Hauptgerät: 1250 mAh wiederaufladbarer Lithium-Akku; Empfänger: 9-V-Batterie
|-
| Lieferumfang || Geschenkbox/Handbuch/Tragetasche/RJ45-Kabel/Krokodilklemmenkabel || Geschenkbox/Handbuch/Tragetasche/RJ45-Kabel/Prüfleitungen/Temperaturfühler Typ K
|}
<nowiki>*</nowiki> Die Remote-ID-Einheit ist optisches Zubehör.<br />
<nowiki>*</nowiki> Die oben genannten Angaben stellen jeweils die besten erreichbaren Spezifikationen dar.

----

[[Kategorie:Benutzerhandbücher]]
[[Kategorie:Messgeräte]]

Datei:Icon warning.svg

2026-08-02T20:27:22Z

Chris T. Ludwig: Datei hochgeladen mit MsUpload

Datei hochgeladen mit MsUpload

Datei:Icon earth.svg

2026-08-02T20:27:21Z

Chris T. Ludwig: Datei hochgeladen mit MsUpload

Datei hochgeladen mit MsUpload

Datei:Icon lowbattery.svg

2026-08-02T20:27:21Z

Chris T. Ludwig: Datei hochgeladen mit MsUpload

Datei hochgeladen mit MsUpload

Datei:Fig p13 continuity device.svg

2026-08-02T20:27:20Z

Chris T. Ludwig: Datei hochgeladen mit MsUpload

Datei hochgeladen mit MsUpload

Datei:Fig p12 cabletracing.svg

2026-08-02T20:27:17Z

Chris T. Ludwig: Datei hochgeladen mit MsUpload

Datei hochgeladen mit MsUpload

Datei:Fig p11 voltage.svg

2026-08-02T20:27:07Z

Chris T. Ludwig: Datei hochgeladen mit MsUpload

Datei hochgeladen mit MsUpload

Datei:Fig p8 length.svg

2026-08-02T20:27:03Z

Chris T. Ludwig: Datei hochgeladen mit MsUpload

Datei hochgeladen mit MsUpload

Datei:Fig p17 battery.svg

2026-08-02T20:27:00Z

Chris T. Ludwig: Datei hochgeladen mit MsUpload

Datei hochgeladen mit MsUpload

Datei:Fig p10 cablemapping.svg

2026-08-02T20:26:50Z

Chris T. Ludwig: Datei hochgeladen mit MsUpload

Datei hochgeladen mit MsUpload

Datei:Fig p5 product.svg

2026-08-02T20:26:38Z

Chris T. Ludwig: Datei hochgeladen mit MsUpload

Datei hochgeladen mit MsUpload

Datei:Fig p16 testleads.svg

2026-08-02T20:26:23Z

Chris T. Ludwig: Datei hochgeladen mit MsUpload

Datei hochgeladen mit MsUpload

(AVR) Interrupts

2026-07-31T16:05:35Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

Externe Interrupts können im Prinzip über/von jedem I/O-Pin ausgelöst werden.
Wenn nicht ausdrücklich erwähnt beziehe ich mich bei meinen Aussagen auf den ATmega328P. Wenn jemand eine Info bezüglich eines anderen Prozessors benötigt, einfach unten in die Kommentare schreiben.

Zu beachten:
* Ein Interrupt ist erst nach 4 Taktzyklen durch PCIF erkennbar. Bei 20 MHZ Taktfrequenz sind das immerhin 200ns (4x50ns) oder 0,2us. Es wird aber kein Interrupt "verschluckt" wenn der Auslöser länger als einen Taktzyklus dauert. Kürzere Impulse lösen nicht garantiert einen Interrupt aus. Bei 0-Pegel-Interrupts muss zuerst der aktuelle Befehl abgearbeitet werden.
* Nur INT0 (PD2) und INT1 (PD3) sind "vollwertige" Interrupts
* Die 3 PCIx sind jeweils für eine Gruppe von I/O-Pins zuständig (PCI0 für PCINT7..0, PCI1 für PCINT14..8 , PCI2 für PCINT23..16).
<code>
During interrupts and subroutine calls, the return address program counter (PC) is stored on the stack. The stack is
effectively allocated in the general data SRAM, and consequently the stack size is only limited by the total SRAM size and
the usage of the SRAM. All user programs must initialize the SP in the reset routine (before subroutines or interrupts are
executed). The stack pointer (SP) is read/write accessible in the I/O space. The data SRAM can easily be accessed through
the five different addressing modes supported in the AVR architecture.
The memory spaces in the AVR architecture are all linear and regular memory maps.
A flexible interrupt module has its control registers in the I/O space with an additional global interrupt enable bit in the status
register. All interrupts have a separate interrupt vector in the interrupt vector table. The interrupts have priority in accordance
with their interrupt vector position. The lower the interrupt vector address, the higher the priority.
</code>

=Allgemein=
Die meisten Mikrocontroller besitzen einen oder mehrere I/O-Pins an denen abhaengig vom Zustandswechsel durch eine Programmunterroutine (Funktion) reagiert werden kann. Das ist natuerlich viel cleverer als in einer Schleife dauert nach einem Zustandswechsel zu "fragen" (Polling). Bei einem kleinen Mikrocontrollerprogramm, das nur das tut, mag das noch eine Ueberlegung wert sein. Sobald aber ein Programm ein wenig komplexer wird ist interrupten angesagt.

Zum konfigurieren des Verhaltens bei einem Interrupt besitzen die Controller ein Reihe von Registern.

Beim ATmega328P als erstes, das SREG (AVR Status Register) und darin das Global Interrupt Enable (Bit 7)

The global interrupt enable bit must be set for the interrupts to be enabled. The individual interrupt enable control is then
performed in separate control registers. If the global interrupt enable register is cleared, none of the interrupts are enabled
independent of the individual interrupt enable settings. The I-bit is cleared by hardware after an interrupt has occurred, and is
set by the RETI instruction to enable subsequent interrupts. The I-bit can also be set and cleared by the application with the
SEI and CLI instructions, as described in the instruction set reference.

Abhaengig von den Bits BOOTRST, IVSEL, IVCE stehen die Interruptvektoren (siehe weiter unten) an einer anderen Position im Programmspeicher.

Fuer die Interruptkontrolle sind folgende Register von Bedeutung:
* '''EICRA''' External Interrupt Control Register A (0x69) -> Interrupt Sense Control INT0/INT1 (siehe folgende Tabelle)
* '''EIMSK''' – External Interrupt Mask Register (0x1D/0x3D) -> External Interrupt Request INT0/INT1 Enable
* '''EIFR''' – External Interrupt Flag Register (0x1C/0x3C) -> INTF0/INTF1: External Interrupt Flag 0/1
* '''PCICR''' – Pin Change Interrupt Control Register (0x68) -> PCIE0/1/2: Pin Change Interrupt Enable 0/1/2
* '''PCIFR''' – Pin Change Interrupt Flag Register (0x1B/0x3B) -> PCIF0/1/2: Pin Change Interrupt Flag 0/1/2
* '''PCMSK2''' – Pin Change Mask Register 2 (0x6D) -> PCINT23-PCINT16
* '''PCMSK1''' – Pin Change Mask Register 1 (0x6C) -> PCINT14-PCINT8 (kein PCINT15!)
* '''PCMSK0''' – Pin Change Mask Register 0 (0x6B) -> PCINT7-PCINT0

Im Gegensatz zu den PC-Interrupts, die nur auf einen Wechsel des Zustandes reagieren, koennen INT0/1 auch auch auf fallende und steigende Flanken und Zustaende reagieren.

==INT1 INT0==
Dies sind die "vollwertigen" Interrupts.
* Können auf fallende und steigende Flanke und 0-Pegel triggern (-> EICRA)
* Bei der 0-Pegel wird der Trigger solange ausgelöst bis wieder 1-Pegel anliegt.

An- und Ausschalten kann man die beiden Interrupts im EIMSK – External Interrupt Mask Register. Mask sollte vielleicht besser Enable heißen.

Das EICRA – External Interrupt Control Register A (0x69) dient ausschließlich (Interrupt Sense Control Bit0-3) der Triggereinstellung von INT0 und INT1

{| class="wikitable"
!colspan="3"|Interrupt 0/1 Sense Control
|-
!ISCx1!!ISCx0!!Verhalten
|-
|0||0|| Ein '''LOW-Pegel''' loest einen Interrupt aus.
|-
|0||1|| Ein '''Logik-Wechsel''' loest einen Interrupt aus.
|-
|1||0|| Eine '''fallende Flanke''' loest einen Interrupt aus.
|-
|1||1|| Ein '''steigende Flanke''' loest einen Interrupt aus.
|-
|}

oder kurz

{| class="wikitable"
|-
!ISCx1!!ISCx0!! INTx reagiert auf ...
|-
|0||0|| 0-Pegel
|-
|0||1|| Pegelwechsel
|-
|1||0|| fallende Flanke
|-
|1||1|| steigende Flanke
|-
|}
===Anwendungsbeispiel===
Immer mal wieder habe ich gelesen, dass ein Taster am Interrupt eine schlechte Idee sei. Wegen Tastenprellen und so. Manche behaupten sogar es ginge gar nicht. Hier der Gegenbeweis. Funktioniert bei mir völlig zufriedenstellend. Hier benutze ich die ISR-Variante. Später werde ich weiter unten auch mal eine Gegenüberstellung mit der attachInterrupt-Variante ergänzen.

<syntaxhighlight lang="c" line>
#include <Arduino.h>
#include <avr/interrupt.h> // fuer ISR Makro

const byte ledPin = 5;
volatile byte ledState = LOW;
byte lastledState;

const byte interruptPin = 3;

ISR (INT1_vect){
EIFR|=(1<<INTF1); // Interrupt Flag zu Sicherheit schon mal loeschen
EIMSK&=~(1<<INT1); // Interrupt abschalten
ledState = !ledState;
}

void setup(){
Serial.begin(115200); // vielleicht brauche ich es

pinMode(ledPin, OUTPUT); // LED-Anschluss auf Ausgang
digitalWrite(ledPin, LOW); // LED ausschalten

pinMode(interruptPin, INPUT); // dies ist nicht zwingend notwendig, der Interrupt funktioniert auch im Output-Mode

EICRA |= (1<<ISC11); // auf fallende Flanke reagieren (Der Taster tastet nach GND über einen Pullup-Widerstand.)
EIMSK |= (1<<INT1); // INT1-Interrupt einschalten
}

void loop(){
if (lastledState!=ledState){
digitalWrite(ledPin, ledState);
delay(200); // entprellen
EIFR|=(1<<INTF1); // Interruptflag (nochmal) loeschen
EIMSK|=(1<<INT1); // Interrupt wieder einschalten
lastledState=ledState; // Veraenderung merken
}
}
</syntaxhighlight>

Es sei hier bemerkt, dass innerhalb einer Interruptroutine (ISR) z.B. kein delay() und millis() funktioniert. Sobald man etwas nutzt was auch Interrupts benutzt ist der Ärger mit einprogrammiert. Am besten programmiert man nach dem Motto:

Nur das Notwendigste erledigen und direkt wieder raus, d.h. am besten nur Variablen setzen und keine Unterroutinen.

Wenn ich zeitkritische Routinen geschrieben habe, bin ich auch schon mal auf Inline-Assembler ausgewichen, habe Taktzyklen der Opcodes gezählt und die Gesamtlaufzeit durch I/O-Pin-Trigger auf einem Oszi nachgemessen:-)

==PCINT0-23==
TODO

==Request for Comments==

<comments />

Grafikkarte mehrere Monitore

2026-07-31T16:04:30Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Problem=
Meine ASUStek STRIX-GTX1050TI-O4G-GAMING Grafikkarte hat 4(!) Anschluesse 2 x DVI-D, 1 x HDMI 2.0b und 1 x DisplayPort 1.4.

Einmal ist es mir tatsaechlich gelungen vier Monitore gleichzeitig mit einem Bild zu versorgen. Sobald aber ein Monitor ausgeschaltet wurde, war eine Reaktivierung nicht mehr moeglich.

Da zwei Monitore TV-Geraete/Beamer sind, wollte ich nicht ein riesiges Display, bei dem alle Screens nebeneinander liegen, sondern einzelne Screens (3) um Programme leichter direkt auf einem Screen platzieren zu koennen.

Das schlimme ist, durch die vielen Versuche ging alles irgendwie immer weniger, bis ich zum Schluss, egal welche Kombination ich waehlte, nur noch einen Monitor und einen TV ans laufen bekam.

=Loesungshinweise=

Leider steht im Datenblatt kein Hinweis auf die maximale Anzahl gleichzeitiger Nutzung von angeschlossenen Monitoren. Also gehe ich mal davon aus, dass solange die maximale Displaygroesze von 7680x4320 nicht ueberschritten wird, bis zu vier unterschiedliche Bilder ausgegeben werden koennen.
Bei vier FullHD Screens sollte also, die maximale Displaygroesze weder horizontal noch vertikal ueberschritten sein.

==xrandr, inxi, nvidia-setting, ...==

Starten wir mal mit xrandr.

chris@server:> xrandr -d :0.0 -q
Screen 0: minimum 8 x 8, current 1920 x 1080, maximum 32767 x 32767
DP-0 disconnected (normal left inverted right x axis y axis)
DP-1 connected primary 1920x1080+0+0 (normal left inverted right x axis y axis) 521mm x 293mm
1920x1080 60.00*+
1680x1050 59.95
1600x1200 60.00
1440x900 59.89
1400x1050 59.98
1280x1024 75.02 60.02
1280x960 60.00
1152x864 75.00
1024x768 75.03 70.07 60.00
800x600 75.00 72.19 60.32 56.25
640x480 75.00 72.81 59.94
DVI-D-1 connected (normal left inverted right x axis y axis)
1920x1080 60.00 + 59.94 50.00 23.98 60.05 60.00 50.04
1360x768 60.02
1280x720 60.00 59.94 50.00
1024x768 60.00
800x600 60.32
720x576 50.00
720x480 59.94
640x480 59.94 59.93
chris@server:> xrandr -d :0.1 -q
Screen 1: minimum 8 x 8, current 1920 x 1080, maximum 32767 x 32767
HDMI-0 disconnected primary (normal left inverted right x axis y axis)
chris@server:> xrandr -d :0.2 -q
Screen 2: minimum 8 x 8, current 640 x 480, maximum 32767 x 32767
DVI-D-0 disconnected primary (normal left inverted right x axis y axis)

i2cdetect -l
i2c-3 i2c NVIDIA i2c adapter 8 at f:00.0 I2C adapter
i2c-1 i2c NVIDIA i2c adapter 6 at f:00.0 I2C adapter
i2c-2 i2c NVIDIA i2c adapter 7 at f:00.0 I2C adapter
i2c-0 i2c NVIDIA i2c adapter 1 at f:00.0 I2C adapter

Also ddc sollte in der Lage sein alle vier angschlossenen Monitore zu kontaktieren.

ddcutil detect
Display 1
I2C bus: /dev/i2c-1
EDID synopsis:
Mfg id: HPN - UNK
Model: HP E24t G5
Product code: 14602 (0x390a)
Serial number: CNC4191B0T
Binary serial number: 1684XXXX (0xXXXXXXXX)
Manufacture year: 2024, Week: 19
VCP version: 2.2

Display 2
I2C bus: /dev/i2c-2
DRM connector: card0-DP-1
EDID synopsis:
Mfg id: HSD - HannStar Display Corp
Model: HE247DPB
Product code: 18871 (0x49b7)
Serial number: 123456789XXXX
Binary serial number: 0 (0x00000000)
Manufacture year: 2012, Week: 26
VCP version: 2.1

Invalid display
I2C bus: /dev/i2c-3
DRM connector: card0-HDMI-A-1
EDID synopsis:
Mfg id: SNY - Sony
Model: SONY TV
Product code: 10241 (0x2801)
Serial number:
Binary serial number: XXXXXXXX (0xXXXXXXX)
Manufacture year: 2007, Week: 1
DDC communication failed

I2C/-0 wird nicht erkannt, der HP hat kein DRM und der Sony hat ein Kommunikationproblem. Na toll.

Hier ist der Grund: Der Sony am i2c-3 hat keinen DDC-Chip (Adresse 37), sondern nur einen EDID-Chip (0x50). Der Samsung am i2c-0 hat weder noch und wird somit erst gar nicht erkannt.

server:~ # i2cdetect -y 0
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- 08 -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- 29 -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- 68 -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- --
server:~ # i2cdetect -y 1
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- 37 -- -- 3a -- -- -- -- --
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
50: 50 -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- --
server:~ # i2cdetect -y 2
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: 30 -- -- -- -- -- -- 37 -- -- -- -- -- -- -- --
40: 40 -- -- -- -- -- -- -- -- -- 4a 4b -- -- -- --
50: 50 -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- --
server:~ # i2cdetect -y 3
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- 3a 3b -- -- -- --
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
50: 50 -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- --

Slave addresses x50 (EDID) and x37 (DDC). xrandr has ways other than I2C to access the EDID, e.g. by BIOS calls
Daraus koennte man jetzt schlieszen ,dass i2c-0 DVI-D-0, i2c-1 DVI-D-1, i2c-2 DP1 und i2c-3 HDMI ist.

=Anzahl Anschluesse/Displays/Screens=
==Hinweise aus dem Netz==

Also ich glaub die ganze gtx 1000 Serie unterstützt 4 Displays. Sonst kannst du einfach an die onboard was anschließen oder ne 2. Grafikkarte nehmen

Das ist schon korrekt, viele Grafikkarten können nicht mit 3 Bildschirmen umgehen, auch wenn mehr Anschlüsse vorhanden sind. Dies ist auch vom Hersteller abhängig. An meiner GTX 1050 TI Asus ROG Strix kann ich z.B. problemlos 3 Bildschirme betreiben.

Wenig hilfreiche Hinweise gibt es auch. Gut find ich das mit dem VGA-Tipp;-))

[[Datei:GuteFrage Screenshot GTX1050 3Monitore.png|mini]]

Viele Foreneintraege koennte man sich sparen, wenn man einfach mal die Dokumentation liest.

Most NVIDIA GPUs based on the Kepler¹ architecture, or newer, support driving up to four display devices simultaneously. Most NVIDIA GPUs older than Kepler¹ support driving up to two display devices simultaneously.

¹Kepler-Architektur (GeForce 600/700 Serien, 2012)

=Ueberpruefung=
Dabei kann es doch so einfach sein Klarheit herzustellen.

==Beispiel #1 NVIDIA Quadro M2000==

nvidia-settings -q dpys

8 Display Devices on worker:0

[0] worker:0[dpy:0] (DP-0) (connected, enabled)

Has the following names:
DFP
DFP-0
DPY-EDID-87977d39-dc91-e2a7-5b42-4bf2d8422cd8
DPY-0
DP-0
Connector-2

[1] worker:0[dpy:1] (DP-1)

Has the following names:
DFP
DFP-1
DPY-1
DP-1
Connector-2

[2] worker:0[dpy:2] (DP-2)

Has the following names:
DFP
DFP-2
DPY-2
DP-2
Connector-3

[3] worker:0[dpy:3] (DP-3)

Has the following names:
DFP
DFP-3
DPY-3
DP-3
Connector-3

[4] worker:0[dpy:4] (DP-4) (connected, enabled)

Has the following names:
DFP
DFP-4
DPY-EDID-ed2ec75d-f371-e005-c6ea-73642b39d8a8
DPY-4
DP-4
Connector-1

[5] worker:0[dpy:5] (DP-5)

Has the following names:
DFP
DFP-5
DPY-5
DP-5
Connector-1

[6] worker:0[dpy:6] (DP-6)

Has the following names:
DFP
DFP-6
DPY-6
DP-6
Connector-0

[7] worker:0[dpy:7] (DP-7)

Has the following names:
DFP
DFP-7
DPY-7
DP-7
Connector-0

Diese Karte hat tatsaechlich 4 DP Anschluesse und koennte an jedem der 4 Konnektoren je 2 Monitor betreiben (MST?).

chris@worker:~> ddcutil detect
Display 1
I2C bus: /dev/i2c-2
DRM connector: card0-DP-1
EDID synopsis:
Mfg id: SAM - Samsung Electric Company
Model: U28E590
Product code: 3149 (0x0c4d)
Serial number: H4LN609169
Binary serial number: 1113216074 (0x425a544a)
Manufacture year: 2020, Week: 26
VCP version: 2.0

Display 2
I2C bus: /dev/i2c-4
DRM connector: card0-DP-3
EDID synopsis:
Mfg id: SAM - Samsung Electric Company
Model: U28E590
Product code: 3149 (0x0c4d)
Serial number: HTPKC14310
Binary serial number: 810375238 (0x304d5846)
Manufacture year: 2018, Week: 51
VCP version: 2.0

Und hier hat wieder 5-jaehrige Schimpanse zugeschlagen. Laut nvidia-setting sind die 4 Konnektoren
* 0: DP-6 und DP-7
* 1: DP-4 und DP-5 Monitor (links an card0-DP-3) 0MX......4310J
* 2: DP-0 und DP-1 Monitor (rechts an card0-DP-1) BZT......9169J
* 3: DP-2 und DP-3

Die Karte besitzt 5 (!) I2C-Bus Adapter.

i2cdetect -l
i2c-3 i2c NVIDIA i2c adapter 7 at 4:00.0 I2C adapter
i2c-1 i2c NVIDIA i2c adapter 2 at 4:00.0 I2C adapter
i2c-4 i2c NVIDIA i2c adapter 8 at 4:00.0 I2C adapter
i2c-2 i2c NVIDIA i2c adapter 6 at 4:00.0 I2C adapter
i2c-0 smbus SMBus I801 adapter at 0780 SMBus adapter
i2c-5 i2c NVIDIA i2c adapter 9 at 4:00.0 I2C adapter

Die Zuordnung zu den Konnektoren wirft Fragen auf. Connector 1 -> i2c-2 und Connector 2 -> i2c-4.

==Beispiel #2 NVIDIA GeForce GTX 1050 Ti==

(per ssh)
server:~ # DISPLAY=:0 nvidia-settings -q dpys

5 Display Devices on server:0

[0] server:0[dpy:0] (DVI-D-0) (connected)

Has the following names:
DFP
DFP-0
DPY-EDID-aab368ea-d801-739e-62ca-6109e2567e6d
DPY-0
DVI-D-0
Connector-0

[1] server:0[dpy:1] (HDMI-0)

Has the following names:
DFP
DFP-1
DPY-1
HDMI-0
Connector-1

[2] server:0[dpy:2] (DP-0)

Has the following names:
DFP
DFP-2
DPY-2
DP-0
Connector-2

[3] server:0[dpy:3] (DP-1) (connected, enabled)

Has the following names:
DFP
DFP-3
DPY-EDID-05c8daf9-506c-f4bb-5bf1-0a886a401315
DPY-3
DP-1
Connector-2

[4] server:0[dpy:4] (DVI-D-1)

Has the following names:
DFP
DFP-4
DPY-4
DVI-D-1
Connector-3

Diese Karte hat 4 Anschluesse: 2 DVI-D (nebeneinander 2 Slots Connector-0 und Connector-3), HDMI (Connector-1) und ein DP (Connector-2)

Was mir auffaellt.
*DVI-D-0 ist connected, aber nicht enabled
*HDMI-0: Der angschlossene Sony TV ist nicht connected
*DVI-D-1: Der angschlossene Samsung TV ist nicht connected

Vielleicht hilft die Option "ConnectedMonitor".
Option "ConnectedMonitor" "DVI-D-0, DVI-D-1, HDMI-0, DP-1"

=Vergleich Xorg.conf=
Wie ist also die Hardware in Xorg.conf hinterlegt?

==Quadro M2000==

Die Input-Devices habe ich rausgenommen.

more /etc/X11/xorg.conf
# nvidia-settings: X configuration file generated by nvidia-settings
# nvidia-settings: version 550.127.05

Section "ServerLayout"
Identifier "Layout0"
Screen 0 "Screen0" 0 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
Option "Xinerama" "0"
EndSection

Section "Monitor"
# HorizSync source: edid, VertRefresh source: edid
Identifier "Monitor0"
VendorName "Unknown"
ModelName "Samsung U28E590"
HorizSync 30.0 - 135.0
VertRefresh 56.0 - 75.0
Option "DPMS"
EndSection

Section "Device"
Identifier "Device0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "Quadro M2000"
EndSection

Section "Screen"
Identifier "Screen0"
Device "Device0"
Monitor "Monitor0"
DefaultDepth 24
Option "Stereo" "0"
Option "nvidiaXineramaInfoOrder" "DP-4"
Option "metamodes" "DP-4: nvidia-auto-select +0+0, DP-0: nvidia-auto-select +3840+0"
Option "SLI" "Off"
Option "MultiGPU" "Off"
Option "BaseMosaic" "off"
SubSection "Display"
Depth 24
EndSubSection
EndSection

Was schon mal auffaellt, obwohl 2 Monitore an 2 unterschiedlichen Displayports angeschlossen sind taucht nur ein Monitor0 auf. (NB: VendorName "Unkown" Wer hat denn da wieder geschlafen?)

*ServerLayout [https://www.x.org/archive/X11R7.6/doc/man/man5/xorg.conf.5.xhtml#heading16]
*Monitor [https://www.x.org/archive/X11R7.6/doc/man/man5/xorg.conf.5.xhtml#heading12]
*Device [https://www.x.org/archive/X11R7.6/doc/man/man5/xorg.conf.5.xhtml#heading10]
*Screen [https://www.x.org/archive/X11R7.6/doc/man/man5/xorg.conf.5.xhtml#heading14]

NVidia xorgconfoptions [https://http.download.nvidia.com/XFree86/Linux-x86/325.15/README/xconfigoptions.html] nur fuer den Treiber 325.15 verfuegbar(???).

Die beiden Options von Interesse sind:
* nvidiaXineramaInfoOrder
The option string is a comma-separated list of display device names. The display device names can either be general (e.g, "CRT", which identifies all CRTs), or specific (e.g., "CRT-1", which identifies a particular CRT). Not all display devices need to be identified in the option string; display devices that are not listed will be implicitly appended to the end of the list, in their default order.

Note that nvidiaXineramaInfoOrder tracks all display devices that could possibly be connected to the GPU, not just the ones that are currently enabled. When reporting the Xinerama information, the NVIDIA X driver walks through the display devices in the order specified, only reporting enabled display devices.

*MetaModes (GroszKleinSchreibung?²)
This option describes the combination of modes to use on each monitor when using TwinView or SLI Mosaic Mode. See Chapter 12, Configuring Multiple Display Devices on One X Screen and Chapter 29, Configuring SLI and Multi-GPU FrameRendering for details. Default: string is NULL.

²Just as in all X config entries, spaces are ignored and all entries are case insensitive.

Diese [https://http.download.nvidia.com/XFree86/Linux-x86/325.15/README/configtwinview.html Seite] bringt hoffentlich Klarheit.

Wenn auf der GPU mehrere X-Bildschirme konfiguriert sind, versucht der NVIDIA X-Treiber, Anzeigegeräte und GPU-Ressourcen für diese anderen X-Bildschirme zu reservieren (unter Berücksichtigung der X-Konfigurationsoptionen „UseDisplayDevice“ und „MetaModes“ jedes X-Bildschirms) und weist dann alle verbleibenden Ressourcen dem ersten auf der GPU konfigurierten X-Bildschirm zu.

Was bei meiner QuadroM2000Config weiterhin irritiert, ist dass der 2. Monitor keine eigene Section besitzt und nur ueber DP-0 in den MetaModes auftaucht.

The details of how this works are documented in the nv-control-dpy.c sample NV-CONTROL client in the nvidia-settings source tarball.

==GTX 1050 Ti 4 Monitore/TVs==
Anmerkung:
*Alle vier Monitore/TVs haben FullHD.
*Die beiden Monitore zeigen das gleiche Bild (Desktop). Sind also geklont.
*Die beiden TVs haben jeweils einen eigenen Screen.

[https://http.download.nvidia.com/XFree86/Linux-x86/325.15/README/configmultxscreens.html Hier] zum Nachvollziehen.

Die xorg.conf die nach viel Probiererei auf einmal nicht mehr ging.

# nvidia-settings: X configuration file generated by nvidia-settings
# nvidia-settings: version 550.135

Section "ServerLayout"
Identifier "Layout0"
Screen 0 "Screen0" 0 0
Screen 1 "Screen1" 1920 0
Screen 2 "Screen2" 3840 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
Option "Xinerama" "0"
EndSection

Section "Files"
EndSection

Section "InputDevice"

# generated from data in "/etc/sysconfig/mouse"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "IMPS/2"
Option "Device" "/dev/input/mice"
Option "Emulate3Buttons" "yes"
Option "ZAxisMapping" "4 5"
EndSection

Section "InputDevice"

# generated from default
Identifier "Keyboard0"
Driver "kbd"
EndSection

Section "Monitor"

# HorizSync source: edid, VertRefresh source: edid
Identifier "Monitor0"
VendorName "HP"
ModelName "HP Inc. HP E24t G5"
HorizSync 30.0 - 85.0
VertRefresh 50.0 - 75.0
Option "DPMS"
Option "Enable" "True"
Option "Primary" "True"
EndSection

Section "Monitor"

# HorizSync source: edid, VertRefresh source: edid
Identifier "Monitor1"
VendorName "Sony"
ModelName "SONY TV"
HorizSync 14.0 - 68.0
VertRefresh 48.0 - 62.0
Option "DPMS"
EndSection

Section "Monitor"

# HorizSync source: edid, VertRefresh source: edid
Identifier "Monitor2"
VendorName "SAMSUNG"
ModelName "SAMSUNG TV"
HorizSync 26.0 - 81.0
VertRefresh 24.0 - 75.0
Option "DPMS"
EndSection

Section "Device"
Identifier "Device0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "NVIDIA GeForce GTX 1050 Ti"
BusID "PCI:15:0:0"
Screen 0
Option "UseHotplugEvents" "false"
Option "AllowEmptyInitialConfiguration" "true"
EndSection

Section "Device"
Identifier "Device1"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "NVIDIA GeForce GTX 1050 Ti"
BusID "PCI:15:0:0"
Screen 1
Option "UseHotplugEvents" "false"
Option "AllowEmptyInitialConfiguration" "true"

EndSection

Section "Device"
Identifier "Device2"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "NVIDIA GeForce GTX 1050 Ti"
BusID "PCI:15:0:0"
Screen 2
Option "UseHotplugEvents" "false"
Option "AllowEmptyInitialConfiguration" "true"
EndSection

Section "Screen"

# Removed Option "metamodes" "DP-1: nvidia-auto-select +0+0, DVI-D-0: 1920x1080 +0+0"
Identifier "Screen0"
Device "Device0"
Monitor "Monitor0"
DefaultDepth 24
Option "Stereo" "0"
Option "nvidiaXineramaInfoOrder" "DVI-D-0"
Option "metamodes" "DVI-D-0: nvidia-auto-select +0+0 {AllowGSYNC=Off}"
Option "SLI" "Off"
Option "MultiGPU" "Off"
Option "BaseMosaic" "off"
SubSection "Display"
Depth 24
EndSubSection
EndSection

Section "Screen"
Identifier "Screen1"
Device "Device1"
Monitor "Monitor1"
DefaultDepth 24
Option "Stereo" "0"
Option "nvidiaXineramaInfoOrder" "HDMI-0"
Option "metamodes" "HDMI-0: nvidia-auto-select +0+0 {AllowGSYNC=Off}"
Option "SLI" "Off"
Option "MultiGPU" "Off"
Option "BaseMosaic" "off"
SubSection "Display"
Depth 24
EndSubSection
EndSection

Section "Screen"
Identifier "Screen2"
Device "Device2"
Monitor "Monitor2"
DefaultDepth 24
Option "Stereo" "0"
Option "nvidiaXineramaInfoOrder" "DVI-D-1"
Option "metamodes" "DVI-D-1: nvidia-auto-select +0+0 {AllowGSYNC=Off}"
Option "SLI" "Off"
Option "MultiGPU" "Off"
Option "BaseMosaic" "off"
SubSection "Display"
Depth 24
EndSubSection
EndSection

Was auffaellt.
*# Removed Option "metamodes" "DP-1: nvidia-auto-select +0+0, DVI-D-0: 1920x1080 +0+0" Warum? Das muss doch rein!
*Option "DPMS" bei den TVs muss/sollte raus!
*Option "Enable" "True" kann eigentlich bei allen Monitor-Sections rein.

Darueber hinaus kann vielleicht
Option "ConnectedMonitor" "DVI-D-0, DVI-D-1, HDMI-0, DP-1"
auch nichts schaden?

Reboot oder systemctl restart display-manager. Erfolg gleich Null.
Nvidia erkennt die ausgeschalteten (Stand-by) TVs nicht.

hw-probe ergibt folgenden Eintrag bei devices.

eisa:sony-sny2801;;detected;monitor;;Sony;TV SNY2801 1920x1080

Und unter [https://github.com/linuxhw/EDID/tree/master] findet man unter SNY2801

| Sony | SNY2801 | TV | 1920x1080 | | 2007 | [2E85613CDBF0](<Digital/Sony/SNY2801/2E85613CDBF0>) |

edid-decode (hex):

00 ff ff ff ff ff ff 00 4d d9 01 28 01 01 01 01
01 11 01 03 80 a0 5a 78 0a 0d c9 a0 57 47 98 27
12 48 4c 21 08 00 01 01 01 01 01 01 01 01 01 01
01 01 01 01 01 01 02 3a 80 18 71 38 2d 40 58 2c
45 00 40 84 63 00 00 1e 66 21 50 b0 51 00 1b 30
40 70 36 00 40 84 63 00 00 1e 00 00 00 fd 00 30
3e 0e 44 0f 00 0a 20 20 20 20 20 20 00 00 00 fc
00 53 4f 4e 59 20 54 56 0a 20 20 20 20 20 01 59

02 03 24 70 50 1f 14 13 12 11 16 15 10 05 04 03
02 07 06 01 20 23 09 07 07 83 01 00 00 66 03 0c
00 30 00 80 01 1d 80 d0 72 1c 16 20 10 2c 25 80
40 84 63 00 00 9e 01 1d 80 18 71 1c 16 20 58 2c
25 00 40 84 63 00 00 9e 01 1d 00 bc 52 d0 1e 20
b8 28 55 40 40 84 63 00 00 1e 02 3a 80 d0 72 38
2d 40 10 2c 45 80 40 84 63 00 00 1e 01 1d 00 72
51 d0 1e 20 6e 28 55 00 40 84 63 00 00 1e 00 99

----------------

Block 0, Base EDID:
EDID Structure Version & Revision: 1.3
Vendor & Product Identification:
Manufacturer: SNY
Model: 10241
Serial Number: ...
Made in: week 1 of 2007
Basic Display Parameters & Features:
Digital display
Maximum image size: 160 cm x 90 cm
Gamma: 2.20
RGB color display
First detailed timing is the preferred timing
Color Characteristics:
Red : 0.6250, 0.3398
Green: 0.2802, 0.5947
Blue : 0.1552, 0.0703
White: 0.2832, 0.2978
Established Timings I & II:
DMT 0x04: 640x480 59.940476 Hz 4:3 31.469 kHz 25.175000 MHz
DMT 0x09: 800x600 60.316541 Hz 4:3 37.879 kHz 40.000000 MHz
DMT 0x10: 1024x768 60.003840 Hz 4:3 48.363 kHz 65.000000 MHz
Standard Timings: none
Detailed Timing Descriptors:
DTD 1: 1920x1080 60.000000 Hz 16:9 67.500 kHz 148.500000 MHz (1600 mm x 900 mm)
Hfront 88 Hsync 44 Hback 148 Hpol P
Vfront 4 Vsync 5 Vback 36 Vpol P
DTD 2: 1360x768 60.015162 Hz 85:48 47.712 kHz 85.500000 MHz (1600 mm x 900 mm)
Hfront 64 Hsync 112 Hback 256 Hpol P
Vfront 3 Vsync 6 Vback 18 Vpol P
Display Range Limits:
Monitor ranges (GTF): 48-62 Hz V, 14-68 kHz H, max dotclock 150 MHz
Display Product Name: 'SONY TV'
Extension blocks: 1
Checksum: 0x59

----------------

Block 1, CTA-861 Extension Block:
Revision: 3
Basic audio support
Supports YCbCr 4:4:4
Supports YCbCr 4:2:2
Native detailed modes: 0
Video Data Block:
VIC 31: 1920x1080 50.000000 Hz 16:9 56.250 kHz 148.500000 MHz
VIC 20: 1920x1080i 50.000000 Hz 16:9 28.125 kHz 74.250000 MHz
VIC 19: 1280x720 50.000000 Hz 16:9 37.500 kHz 74.250000 MHz
VIC 18: 720x576 50.000000 Hz 16:9 31.250 kHz 27.000000 MHz
VIC 17: 720x576 50.000000 Hz 4:3 31.250 kHz 27.000000 MHz
VIC 22: 1440x576i 50.000000 Hz 16:9 15.625 kHz 27.000000 MHz
VIC 21: 1440x576i 50.000000 Hz 4:3 15.625 kHz 27.000000 MHz
VIC 16: 1920x1080 60.000000 Hz 16:9 67.500 kHz 148.500000 MHz
VIC 5: 1920x1080i 60.000000 Hz 16:9 33.750 kHz 74.250000 MHz
VIC 4: 1280x720 60.000000 Hz 16:9 45.000 kHz 74.250000 MHz
VIC 3: 720x480 59.940060 Hz 16:9 31.469 kHz 27.000000 MHz
VIC 2: 720x480 59.940060 Hz 4:3 31.469 kHz 27.000000 MHz
VIC 7: 1440x480i 59.940060 Hz 16:9 15.734 kHz 27.000000 MHz
VIC 6: 1440x480i 59.940060 Hz 4:3 15.734 kHz 27.000000 MHz
VIC 1: 640x480 59.940476 Hz 4:3 31.469 kHz 25.175000 MHz
VIC 32: 1920x1080 24.000000 Hz 16:9 27.000 kHz 74.250000 MHz
Audio Data Block:
Linear PCM:
Max channels: 2
Supported sample rates (kHz): 48 44.1 32
Supported sample sizes (bits): 24 20 16
Speaker Allocation Data Block:
FL/FR - Front Left/Right
Vendor-Specific Data Block (HDMI), OUI 00-0C-03:
Source physical address: 3.0.0.0
Supports_AI
Detailed Timing Descriptors:
DTD 3: 1920x1080i 50.000000 Hz 16:9 28.125 kHz 74.250000 MHz (1600 mm x 900 mm)
Hfront 528 Hsync 44 Hback 148 Hpol P
Vfront 2 Vsync 5 Vback 15 Vpol P Vfront +0.5 Odd Field
Vfront 2 Vsync 5 Vback 15 Vpol P Vback +0.5 Even Field
DTD 4: 1920x1080i 60.000000 Hz 16:9 33.750 kHz 74.250000 MHz (1600 mm x 900 mm)
Hfront 88 Hsync 44 Hback 148 Hpol P
Vfront 2 Vsync 5 Vback 15 Vpol P Vfront +0.5 Odd Field
Vfront 2 Vsync 5 Vback 15 Vpol P Vback +0.5 Even Field
DTD 5: 1280x720 50.000000 Hz 16:9 37.500 kHz 74.250000 MHz (1600 mm x 900 mm)
Hfront 440 Hsync 40 Hback 220 Hpol P
Vfront 5 Vsync 5 Vback 20 Vpol P
DTD 6: 1920x1080 50.000000 Hz 16:9 56.250 kHz 148.500000 MHz (1600 mm x 900 mm)
Hfront 528 Hsync 44 Hback 148 Hpol P
Vfront 4 Vsync 5 Vback 36 Vpol P
DTD 7: 1280x720 60.000000 Hz 16:9 45.000 kHz 74.250000 MHz (1600 mm x 900 mm)
Hfront 110 Hsync 40 Hback 220 Hpol P
Vfront 5 Vsync 5 Vback 20 Vpol P
Checksum: 0x99 Unused space in Extension Block: 1 byte

----------------

Warnings:

Block 1, CTA-861 Extension Block:
IT Video Formats are overscanned by default, but normally this should be underscanned.
Video Data Block: VIC 31 is the preferred timing, overriding the first detailed timings. Is this intended?
Add a Colorimetry Data Block with the sRGB colorimetry bit set to avoid interop issues.

Failures:

Block 1, CTA-861 Extension Block:
Missing VCDB, needed for Set Selectable RGB Quantization to avoid interop issues.
EDID:
Base EDID: Some timings are out of range of the Monitor Ranges:
Vertical Freq: 24.000 - 60.317 Hz (Monitor: 48.000 - 62.000 Hz)

EDID conformity: FAIL

Damit koennte man wenigstens einen EDID Emulator fuettern, oder ein Custom EDID.bin in der xorg.conf hinterlegen.
Mit
cat EDID.txt | grep -E '^([a-f0-9]{32}|[a-f0-9 ]{47})$' | tr -d '[:space:]' | xxd -r -p > EDID.bin

kann man den Hexcode-Block in eine EDID.bin schreiben.

=Teilerfolg=
Mit der von Hand korrigierten xorg.conf (s.u.) und nach einem
systemctl restart display-manager
war auf einmal alle Screens vorhanden. Sogar der Samsung der gar nicht angeschlossen war. Beim Samsung stimmt nur die Aufloesung nicht.

Lediglich die Reihenfolge, bzw. Zuordnung der Screens zu den Bildschirmen war vertauscht.

Gute Dienste leistet da der Remote Desktop Viewer, der zeigt ALLE Screens in einem Fenster!

# nvidia-settings: X configuration file generated by nvidia-settings
# nvidia-settings: version 550.135

Section "ServerLayout"
Identifier "Layout0"
Screen 0 "Screen0" 0 0
Screen 1 "Screen1" 1920 0
Screen 2 "Screen2" 3840 0
InputDevice "Keyboard0" "CoreKeyboard"
InputDevice "Mouse0" "CorePointer"
Option "Xinerama" "0"
EndSection

Section "Files"
EndSection

Section "InputDevice"

# generated from data in "/etc/sysconfig/mouse"
Identifier "Mouse0"
Driver "mouse"
Option "Protocol" "IMPS/2"
Option "Device" "/dev/input/mice"
Option "Emulate3Buttons" "yes"
Option "ZAxisMapping" "4 5"
EndSection

Section "InputDevice"

# generated from default
Identifier "Keyboard0"
Driver "kbd"
EndSection

Section "Monitor"

# HorizSync source: edid, VertRefresh source: edid
Identifier "Monitor0"
VendorName "Unknown"
ModelName "HP Inc. HP E24t G5"
HorizSync 30.0 - 85.0
VertRefresh 50.0 - 75.0
Option "DPMS"
EndSection

Section "Monitor"

# HorizSync source: edid, VertRefresh source: edid
Identifier "Monitor1"
VendorName "Unknown"
ModelName "SONY TV"
HorizSync 14.0 - 68.0
VertRefresh 48.0 - 62.0
#Option "DPMS"
Option "Enable" "True"
EndSection

Section "Monitor"

# HorizSync source: edid, VertRefresh source: edid
Identifier "Monitor2"
VendorName "Unknown"
ModelName "SAMSUNG"
HorizSync 26.0 - 81.0
VertRefresh 24.0 - 75.0
#Option "DPMS"
Option "Enable" "True"
EndSection

Section "Device"
Identifier "Device0"
Driver "nvidia"
VendorName "NVIDIA Corporation"
BoardName "NVIDIA GeForce GTX 1050 Ti"
BusID "PCI:15:0:0"
Option "ConnectedMonitor" "DVI-D-0, DP-1, HDMI-0, DVI-D-1"
Option "CustomEDID" "HDMI-0:/etc/X11/Sony_KDL-40D3550_EDID.bin"
Option "IgnoreEDID" "false"
Option "UseEDID" "true"
# Screen 0
EndSection

#Section "Device"
# Identifier "Device1"
# Driver "nvidia"
# VendorName "NVIDIA Corporation"
# BoardName "NVIDIA GeForce GTX 1050 Ti"
# BusID "PCI:15:0:0"
# Option "ConnectedMonitor" "HDMI-0"
# Screen 1
#EndSection
#
#Section "Device"
# Identifier "Device2"
# Driver "nvidia"
# VendorName "NVIDIA Corporation"
# BoardName "NVIDIA GeForce GTX 1050 Ti"
# BusID "PCI:15:0:0"
# Option "ConnectedMonitor" "DVI-D-1"
# Screen 2
#EndSection

Section "Screen"

# Removed Option "metamodes" "DP-1: nvidia-auto-select +0+0, DVI-D-0: 1920x1080 +0+0"
Identifier "Screen0"
Device "Device0"
Monitor "Monitor0"
DefaultDepth 24
Option "Stereo" "0"
Option "nvidiaXineramaInfoOrder" "DVI-D-0"
#Option "metamodes" "DVI-D-0: 1920x1080 +0+0"
Option "metamodes" "DP-1: nvidia-auto-select +0+0, DVI-D-0: 1920x1080 +0+0"
Option "SLI" "Off"
Option "MultiGPU" "Off"
Option "BaseMosaic" "off"
SubSection "Display"
Depth 24
EndSubSection
EndSection

Section "Screen"
Identifier "Screen1"
Device "Device0"
Monitor "Monitor1"
DefaultDepth 24
Option "Stereo" "0"
Option "nvidiaXineramaInfoOrder" "HDMI-0"
Option "metamodes" "HDMI-0: nvidia-auto-select +0+0 {AllowGSYNC=Off}"
Option "SLI" "Off"
Option "MultiGPU" "Off"
Option "BaseMosaic" "off"
SubSection "Display"
Depth 24
EndSubSection
EndSection

Section "Screen"
Identifier "Screen2"
Device "Device0"
Monitor "Monitor2"
DefaultDepth 24
Option "Stereo" "0"
Option "nvidiaXineramaInfoOrder" "DVI-D-1"
Option "metamodes" "DVI-D-1: nvidia-auto-select +0+0 {AllowGSYNC=Off}"
Option "SLI" "Off"
Option "MultiGPU" "Off"
Option "BaseMosaic" "off"
SubSection "Display"
Depth 24
EndSubSection
EndSection

=Beifang=
Nvidia (Texture) Tools:
*nvtop: interactive GPU process viewer (Wie top, aber halt fuer die Grafikkarte. Einfach ausprobieren.)
*nvzoom - Scales the given image.
*nvtestsuite TODO
*nvidia-sleep.sh: Bash-Script Interessant ist die das Ansprechen des NVIDIA-Treiber ueber echo "$1" > /proc/driver/nvidia/suspend
*nvhdrtest HDR High Dynamic Range Image Image Viewer
*nvassemble
*nvcompress
*nvdecompress: --help
*nv-gnome-thumbnailer
*nvddsinfo

Zigbee Dongles

2026-07-31T16:04:29Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Auf dieser Seite sammele ich Infos zu meine Zigbee Koordinatoren.

=JIOTTY CC2652P=
Der USB-Adapter traegt weiterhin die Bezeichnungen 'zigbee2mqtt Stick', 'Smart Home Stick', 'zigbee2mqtt Dongle Plus' und 'CH9102X'.
Der Adapter meldet sich mit der Vendor ID und Product ID 1a86:55d4 QinHeng Electronics USB Single Serial.
Der Treiber unter Linux ist cdc_acm.

modinfo enthaelt u.a. folgende Informationen zum Treiber.
description: USB Abstract Control Model driver for USB modems and ISDN adapters
author: Armin Fuerst, Pavel Machek, Johannes Erdfelt, Vojtech Pavlik, David Kubicek, Johan Hovold

Eine [https://linux-hardware.org/?id=usb:1a86-55d4 Suche] nach 1a86:55d4 ergab u.a. folgendes:

ID USB 1a86:55d4
Class 02-02-01 »
Type modem »
Vendor QinHeng Electronics »
Name SONOFF Zigbee 3.0 USB Dongle Plus V2

(Victron Energy) VE.Bus Quick Configure / System Configurator

2026-07-31T16:04:28Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Ich habe hier den beiden Programmen
* VE.Bus Quick Configure und
* VE.Bus System Konfigurator
eine eigene Seite gewidmet. Da sie beide nur gebraucht werden um u.U. nur einmal ein System aus mehr als einem MultiPlus/Quattro eingestellt zu werden. Hat man nur einen MultiPlus/Quattro benoetigt man diese Programme nicht.

=VE.Bus Quick Configure=
Das Programm VE.Bus Quick Configure (V90.10.153 Stand 04/2023) kann/sollte man nutzen, wenn man nur maximal 3 Geraete zusammenschalten moechte.

(Victron Energy) MultiPlus-II

2026-07-31T16:04:27Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Victron Energy wird im Folgenden VE abgekuerzt.

Der VE.MultiPlus-II (im Folgenden VE.MPII genannt) ist ein Laderegler (Charger) fuer eine Vielzahl von Batterietypen und ein Wechselrichter (Inverter) zur (Not-)Stromversorgung von angeschlossenen Lasten.

=Inbetriebnahme=
Im ersten Schritt habe ich den VE.MPII nur ueber AC-IN an das 230V-Hausnetz angeschlossen. Der Anschluss der Batterie sollte erst nach Ueberpruefung der Konfiguration des VE.MPII folgen.
Um die Konfiguration vorzunehmen habe ich das Victron Energy MK3-USB-Interface (zukuenftig VE.MK3USB genannt) an eine der beiden mit VE.Bus gekennzeichneten RJ-45-Buchsen des VE.MPII angschlossen.
Als Verbindung diente ein RJ45-Netzwerkkabel (UTP).

==Batterieanschlusskabel==

Zuerst wird der Anschluss aufgesetzt, dann die Unterlegscheibe, die Federscheibe und die Mutter. Alle Muttern mit dem empfohlenen Drehmoment von 12 Nm (M8-Mutter)) anziehen, um den Kontaktwiderstand weitestgehend zu reduzieren.

[[Datei:Anschlusskabelstaerke MP Batterie.png|600px]]

Hier werden 70 qmm (120 qmm) und eine 200 A Sicherung im Plus-Pfad fuer meine 48/5000/70 empfohlen.

Dann schauen wir mal in die VDE 0100-430.

I<sub>B</sub><=I<sub>N</sub><=I<sub>Z</sub>

=Panel=
[[Datei:VE.MPII Panel.jpg|400px]]

{| class="wikitable"
!colspan="2"|LED-Panel
|-
|style="background-color:#ffffcc;" |Batterielader
|style="background-color:#ffffcc;" |Wechselrichter
|-
|Stromversorgung (AC-IN) an
|Wechselrichter (AC-OUT) an
|-
|Hauptladephase
|Ueberlast
|-
|Nachladephase
|Batteriekapazitaet schwach
|-
|Erhaltungsladungsphase
|Batterietemperatur kritisch
|-
|}

=Konfiguration ueber das MK3-USB-Interface=
Als erstes stand ein Firmware-Update (v481 auf v494) an. Eigentlich ist die Software version: 2623494. Es werden hier also nur die letzten 3 Ziffern angegeben.
Das Video dazu findet ihr auf [https://youtu.be/LXORvxUl2Fc Youtube].

Once your CerboGX is connected to Internet (using WiFi or Ethernet) you can use Victron VRM (vrm.victronenergy.com) to connect to your CerboGX over the Internet. From there you can also use Remote VE.Configure, which eliminates the need of the MK3-USB dongle. However, Remote VE.Configure has it's limits.

Das MK3 wird oefter von Victron-Mitarbeitern 'Mark-Three' ausgesprochen.

==Country/Grid code standard==

===Na toll!===
[[Datei:VEConnect GridCountryNotSupported.png|800px|VEConnect GridCountryNotSupported]]

Also dann doch auf den Windows-PC wechseln, da es die [https://www.victronenergy.com/Executables/VEConfig/VECSetup_A.exe VEConfigure] offenbar nur fuer Windows gibt.

===VDE-AR-N 4105===
Erzeugungsanlagen am Niederspannungsnetz

[https://www.vde.com/de/fnn/arbeitsgebiete/tar/tar-niederspannung/erzeugungsanlagen-am-niederspannungsnetz-vde-ar-n-4105-2018 Hier] zum genauen Nachlesen.

In der Einstellung der 'VE Configure 3' Grid->Country / grid code standard gibt es fuer Deutschland 2 Einstellungen zur Auswahl.
Germany: VDE-AR-N 4105:2018-11, internal NS protection
Germany: VDE-AR-N 4105:2018-11, external NS protection

Schließlich müssen Erzeugungsanlagen künftig einem Absinken der Netzfrequenz durch Erhöhen ihrer Einspeiseleistung entgegenwirken. Das gilt insbesondere auch für Speicher. Unterfrequenz bedeutet, dass es im Netz zu wenig Erzeugungsleistung bei gleichzeitig zu hohem Verbrauch gibt.

Network and System Protection (NS Protection) according to the grid code VDE-AR-N 4105
Netz- und Anlagenschutz (NA-Schutz) gemäß Netzanschlussregel VDE-AR-N 4105

Netz- und Anlagenschutz bei PV-Anlagen [https://www.bulletin.ch/de/news-detail/netz-und-anlagenschutz-bei-pv-anlagen.html Zitat]:
Früher war die Situation einfach: Die Grosskraftwerke waren für die Netzstabilität verantwortlich, dezentrale Erzeuger (im Folgenden Energieerzeugungsanlage EEA genannt) waren u. a. aufgrund des politischen Drucks geduldet, hatten sich aber unterzuordnen. Konkret: Sollte die Netzfrequenz über 50,2 Hz steigen oder unter 49,5 Hz fallen, hatten sich die EEA automatisch vom Netz zu trennen (VDE V 0126-1-1). Als in den Jahren 2006/2007 alleine die Leistung der PV-Anlagen im europäischen Stromnetz die Primärregelreserve in Europa überschritt und bereits 2010 rund das Zehnfache dieser betrug, wurde deutlich, dass eine kollektive Abschaltung der EEA nicht nur eine schlechte Lösung, sondern ein Pulverfass in der Netzstabilität war.

LOM Loss of mains detection
[https://www.victronenergy.com/live/ve.bus:grid-codes-and-loss-of-mains-detection?utm_source=offline&utm_medium=qr&utm_campaign=qr%20code%20products#] Zitat:
For other countries, Germany for example, only the MultiPlus-II is certified to be installed without requiring additional external anti-islanding safety devices (ENS).
Das Zertikat des Multiplus-II fuer Deutschland findet man [https://www.victronenergy.com/upload/documents/Vict_MultiPlusII_GCC_AR4105_2018_NAS_de_19-118-01.pdf hier].

===Batterietyp===
Der verwendete Batterietypen Pylontech US2000/US3000/US5000(C) sind Lithium-Eisenphosphat Batterien (LiFePo) in einem BMS-Gehäuse.
Jede "Bank" hat ihr eigenes Battery-Management-System (BMS).

Ein kleiner Einschub:
Wenn es um Batterie und Ladung geht, werden haeufig diese Begriffe benutzt.
*Bulk (1.Ladephase 0%-80%): Hauptladephase
*Absorption (2.Ladephase 80%-100%): Nachladephase
*Float (3.Ladephase): Erhaltungsladung
Dieses 3-stufige Laden ist nur bei Nicht-Lithium-Akkumulatoren von Bedeutung.

Elektrischer Steckbrief (siehe auch Wiki Pylontech)

{| class="wikitable"
! !!US2000C!!US3000C!!US5000
|-
|Nennkapazitaet (kWh)||2,4||3,552(*)||4,8
|-
|Nennkapazitaet (Ah)||50||75||100
|-
|Nutzbare Kapazitaet 95% (kWh)||2280||3374||4560
|-
|Entladungstiefe (DoD)
|-
|Nennspannung||colspan="3"|48 V (15 * 3,2 V)
|-
|Betriebsspannungsbereich||colspan="3"|44,5 V - 53,5 V (2,966 V - 3,566 V)
|-
|Ladespannung||colspan="3"|52,5 V - 53,5 V (3,5 V - 3,566 V)
|-
|Maximaler Dauerlade-Entladestrom (empfohlen)||25 A (50 A - 89 A @ 60 s; 90 A - 200 A @ 15 s)||37 A (74 A - 89 A @ 60 s; 90 A - 200 A @ 15 s)||80 A (100 A max.) (101 A - 120 A @ 15 min; 121 A - 200 A @ 15 s)
|-
|Innenwiderstand
|-
|Kurzschlussstrom||colspan="3"|< 4000 A @ 2 ms
|-
|Eigenverbrauch
|}

(*) steht tatsächlich so im Datenblatt

Empfohlene Betriebstemperatur 10°C-40°C.
* Ladung möglich 0°C-50°C.
* Entladung möglich -10°C-50°C
* Lagertemperatur -20°C-60°C
* Ladezyklen >6000 bei 25°C

LiFePO4 allgemein:
* Zellenspannung 3,2 V - 3,3 V
* Ladeschlussspannung 3,6 V - 3,65 V (Schutz ab 3,8 V)
* Ladeschlussspannung empfohlen 3,4 V - 3,5 V (positive Wirkung auf Zyklenzahl)
* Entladeschlussspannung 2,5 V (nach Typ bis 2,0 V)
* Ladestrom 1C zwischen 20°C - 40°C (0-80%)

WIKI: LiFePO4-Zellen können jederzeit zwischengelagert, entladen und geladen werden. Nur im vollständig geladenen und nahezu entladenen Zustand sind längere Lagerzeiten der Lebenserwartung abträglich.

[https://www.microcharge.de/forum/forum/index.php?thread/917-wichtiges-zur-ladung-von-lfp-lifepo4-akkus/ FORUM]: So lange die Spannung bei LiFePO4 im zulässigen Bereich liegt, ist alles in Ordnung. Und: Der Ladestrom sinkt bei vollständig aufgeladenen LiFePO4-Akkus im Gegensatz zu Bleiakkus praktisch komplett bis auf Null ab. Anders als bei Bleiakkus braucht man bei LiFePO4-Akkus keine besondere Ladekennlinie für die Erhaltungsladung, sondern man kann einfach dauerhaft die maximal zulässige Ladespannung anliegen lassen. Wirklich!

==VE Configuration Windows==

[[Datei:VE Configure Win.jpg|600px]]

===VEConfig===

Das Programm heiszt VEConfig.exe. Die aktuelle Version (Stand 04/2023) ist 90.04.234. Das Programm bezeichnet sich selbst mit 'VEConfigure 3', manchmal auch 'VE Configure'.
Das Programm ist nicht zu verwechseln mit der VictronConnect App (Version 5.83).

VictronConnect ersetzt VEConfigure und VEFlash. Es ist einfacher zu benutzen und funktioniert auf mehr Geräten, nicht nur unter Windows.

Das mit Windows verstehe ich nicht. Also bei mir laeuft ein Programm mit dem Namen VictronConnect unter Windows 10. [https://www.victronenergy.com/media/pg/VE.Bus_Configuration_Guide/de/limitations.html Siehe]

Mit ihm kann man
* MultiPlus (einschließlich Compact)
* MultiPlus-II
* MultiPlus-II GX
* MultiGrid
* Quattros
* EasySolar
* EasySolar-II
* EasySolar-II GX
* Phoenix-Wechselrichter mit einem VE.Bus-Anschluss
konfigurieren, also die grundlegenden Einstellungen des Geraetes vornehmen.
Ich wuerde mal behaupten , dass alle Geraete (Victron Wechselrichter/Ladegeraete) die einen VE.Bus Port (Rj45 'normales' Netzwerkkabel U/UTP (Cat 5e)) besitzen angesprochen werden koennen.

Eine ausfuehrliche Erklaerung der Einstellungen findet man [https://www.victronenergy.com/media/pg/VE.Bus_Configuration_Guide/de/description-of-settings.html hier]

Hier ein Schnelldurchlauf mit Anmerkungen.

VEConfigure 3 kann man grob in 4 Bereiche einteilen.
* Menue (File, Port selection, Target, Defaults, Options, Special, Help)
* Statusdisplay (eine Auswahl aktueller Werte)
* Schnellzugriffsknoepfe (Get/Send-Settings, Virtual Panel)
* Konfigurationsreiter (Tabs)

====Menue====
====Statusdisplay====
====Schnellzugriffsknoepfe====
Virtual-Panel-Knopf Wichtiger Hinweis: Sie sollten das virtuelle Panel nicht nutzen, wenn Sie einen PMV oder VVC angeschlossen haben!

[https://www.victronenergy.com/upload/documents/Connection-Diagram-Remote-Panels_Pn17022016.pdf PMV]: Phoenix Multi Control gehoert zu den Remote Panels
Ist aber [https://www.victronenergy.de/panel-systems-remote-monitoring hier] nicht mit aufgefuehrt.
[https://www.victronenergy.com/upload/documents/VVC-manual-EN.pdf VVC]: VE.Net to VE.Bus protocol Converter

====Konfigurationsreiter====
'''General'''
*System frequency: Hier ist die Frequenz des Wechselrichters gemeint, also das AC-Out Netz.

*Shore Limit: (Ufergrenze:-)) Hier ist der maximale Strom (ueber AC1-IN) einzustellen, der von Land, z.B. in der Marina oder einfach aus dem Versorgernetz (Grid) bezogen werden darf/soll. Ein AC2-IN gibt's nicht bei den Multis. Er dient bei den Quattros als z.B. Generatoreingang.

*Overruled by Remote: Ist eigentlich nur für mobile Installationen (Wohnmobil, Yacht, ...) von Bedeutung. Bei einer stationaeren Anlage kenne ich noch keinen Einsatznutzen.

*Dynamic Current Limiter: Bezieht sich auf den AC2-IN(?) Hier geht es darum einem externen Generator, Zeit zu geben, sich an einen sprunghaften Anstieg der AC-OUT-Lasten durch Unterstuetzung des Multis, anzupassen. Ein gutes Beispiel ist in der Hilfe von VEConfigure3 erlaeutert.

*External current sensor connected: (CTR11xxxx jack connector CTR12xxxx wire end) Wird fuer PowerControl und PowerAssist und zum Optimieren des Eigenverbrauchs benoetigt.

*Enable battery Monitor: "Die Aktivierung des VE.Bus-Batteriewächters ermöglicht auch viele Funktionen, die einen Ladezustand (SoC) verwenden können." Was ist denn das fuer ein Satz:-( Ich verstehe ihn nicht. Also von Anfang. Der Ladezustand (SoC) wird wohl im Multi, Quattro, ... berechnet. Das macht der auf Grundlage der angegebenen Batteriekapazitaet (in Ah, also Wh durch Spannung V dividieren). Die Angaben von “State of charge when bulk finished” and “Charge efficiency” werden bei einer Pylontech-Installation ignoriert.[https://www.victronenergy.com/live/battery_compatibility:pylontech_phantom]

*State of charge when Bulk finished: Gibt die Grenze des Ladezustandes in Prozent an, ab der in die Nachladephase geschaltet wird.

*Charge efficiency: Aus dem Datenblatt der Batterie und/oder des Ladereglers zu entnehmen, evtl. auch durch einen Erfahrungswert zu korrigieren.

'''Netz'''

Diese Einstellungen muessen vorgenommen werden, damit es moeglich sein soll (ueberschuessige) Leistung in das oeffentliche Netz einzuspeisen.

https://www.victronenergy.com/live/ve.bus:grid-codes-and-loss-of-mains-detection

For other countries, Germany for example, only the MultiPlus-II is certified to be installed without requiring additional external anti-islanding safety devices (ENS)

[https://community.victronenergy.com/questions/177859/missing-grid-code-germany-vde-ar-n-41052018-11-int.html Internal NS-Protection only MultiPlus II]

[https://www.giga.de/artikel/na-schutz-was-ist-das-und-warum-gibt-es-ihn/ NA Schutz allgemein]

In certain situations, the inverter/charger built-in Loss of Mains detection (LOM) causes issues.

Auch die 4,6 kW Schieflast Grenze sei hier zu nennen.

Nach einem LOM wird das Back-Feed-Relay geoeffnet, um auszuschlieszen, dass der AC-IN-Anschluss spannungsfrei ist.

Den Unter-Reiter VDE grid code settings werde ich in einem eigenen Beitrag (TODO) eroertern.

'''Inverter'''

Die Wechselrichter-Ausgangsspannung ist normalerweise 230 V.

*Erdungsrelais

Wenn der TransferSwitch offen ist, also z.B. bei Stromausfall und der MultiPlus sich im Inverter-Mode befindet ist der N-Anschluss des Inverters mit PE verbunden. Wenn der TransferSwitch schlieszt, also Strom vom AC in zu den AC out flieszt wird vorher der N-Leiter vom PE-Anschluss getrennt.

[https://www.schutztechnik.com/posts/erdschlussschutz-richtig-prufen Erdschlusssicherung]

Hinweis: Mit Split-Phase-Installation (120V/240V) ist keine 2-Phasen-Anlage L1 und L2 mit freiem L3 gemeint!

Zum Thema [https://community.victronenergy.com/questions/149662/2-phasen-split-system-zulassig-in-deutschland.html Schieflast] muss ich glaube ich auch noch einen Beitrag machen.
[https://elektro.tools/neutralleiter/dist/index1.html] [https://www.sw-netz.de/wp-content/uploads/TAB_2019.pdf] [https://www.e-netzeallgaeu.de/media/2019-07-01_E3_Datenblatt_Speicher.pdf] [https://tuprints.ulb.tu-darmstadt.de/14265/1/2020-11-03_Holbein_Markus.pdf]

*Die 3 Einstellungen ('''DC input low''') wirken bei unterschreiten der eingetragenen Spannungsuntergrenzen.

Herunterfahren: Spannung (Vshut-down) die nicht unterschritten werden darf/sollte um die Batterie zu schützen/schonen.

Neustart: Spannung (Vrestart), die wieder erreicht werden muss bevor der Inverter wieder aktiviert wird. (Vrestart > Vshut-down + 1V) Hysterese!

Voralarm: Spannung (Vprealarm) ab der die Voralarmanzeige aktiviert wird.

Der Begriff 'relativ' ist [https://www.victronenergy.com/media/pg/VE.Bus_Configuration_Guide/de/description-of-settings.html hier] im Originaldokument meiner Meinung nach falsch benutzt. Es handelt sich um absolute Spannungsangaben und meint nur Vpre-alrm >= Vrestart > Vshut-down + 1V.

Zusaetzlich zu den Spannungswerten kann auch der Ladezustand (SoC) zum Abschalten, bzw. Neustart dienen.

*AES (Automatic Economy Switch) AES funktioniert nur im Stand-Alone-Betrieb und sollte nicht verwendet werden, wenn hohe Lasten zu geschaltet werden koennen/sollen.

Im Wesentlichen geht es hier um das Energiesparen des Inverters, in dem man 3 Betriebsmodi bei kleiner oder keiner Last waehlt.
*Zero-load power (Null-Last Leistung) (Normalmodus)
*Zero-load power in AES mode (Energiesparmodus Normalmodus-20%)
*Zero-load power in search mode (Energiesparmodus Normalmodus-70%)

Im Datenblatt des MultiPlus-II sind das die drei letzten Zeilen der Angaben zum eingebauten Wechselrichter. Beim MultiPlus-II 48/5000/70-50 sind das 18 W, 12 W und 2 W.
Was hier verwirrend ist, dass der Suchmodus nur ein anderer Typ des AES-Modus ist. Es muesste also korrekt heiszen:
*Zero-load power (Null-Last Leistung)
*Zero-load power in AES mode Type1 modified sine mode (Energiesparmodus -20%)
*Zero-load power in AES mode Type2 search mode (Energiesparmodus -70%)

Mit aktiviertem AES kann die Start-/Stop-Hysterese angegeben werden.
Beim Typ unterscheidet man dann zwischen einem modifizierten Sinus und einer Art Wellenpaketsteuerung, bei der alle Sekunde (In einer Anleitung steht 'every two seconds' Ich glaub ich muss das mal nachmessen.)
ein Sinus (oder Wellenpaket) erzeugt wird und der Strom dabei gemessen wird um ggf. wieder in den Normalmodus zurueckzukehren. Rein ohmsche Lasten duerften damit zurecht kommen. Bei z.B. Schaltnetzteilen habe ich da so meine Zweifel. AES kann fuer mein Dafuerhalten bei einer 'echten' Nulllast schon etwas bringen, aber das setzt voraus dass die Nullast bei kleiner Lasthuerde (Shut-down-power ???) auch richtig erkannt wird.

====Charger====
*Ladegeraet aktivieren ist selbsterklaerend.

Das Abschalten des eingebauten Ladegeraetes ist natuerlich nur sinnvoll, wenn es mindestens ein anderes externes gibt (MPPT). Im Falle von PV-Wechselrichtern an 'AC out' gibt es fuer das Abschalten kaum einen Grund.
Das unerwuenschte Laden mit Netzstrom laesst sich auch anders unterbinden.

*Schwacher AC Eingang
Wenn der MultiPlus-II ein 'schwaches' Versorgungsnetz erkennt (Wellenform, cos(phi)) reduziert er die Leistung des Ladegeraetes. Diese Drosselung kann mit dem Aktivieren dieser Funktion (= Deaktivieren der Schutzfunktion) ausgeschaltet werden.

*Stopp nach uebermaeszigem Konstantstrom
Im Englischen steht hier 'excessive bulk' also intensive Hauptladephase. Hier ist 'zeitlich intensiv' (= 10 Stunden) gemeint. Wenn also die Konstantstrom-Phase (bei Lithium und Blei die Bulk-Phase) zu lange dauert, geht der Lader von einem Defekt aus und schaltet das Ladegeraet ab und aktiviert ggf. weitere Moeglichkeiten (Assistent fuer Lithiumbatterien). Die 10-Stunden-Grenze wirkt fuer mich eher willkuerlich. Bei kleinem Ladestrom und/oder kleinen DC-Lasten direkt an der Batterie sind die 80% Ladezustand nach 10 Stunden auch unter normalen Bedingungen nicht zu erreichen. Ich wuerde diese Funktion deaktivieren und einen anderen 'besseren' Schutz implementieren.

*Lithium Batterie
Diese Aktivierungsmoeglichkeit ist alleine fuer sich nicht ausreichend. Nach der Wahl des Batterietyps wird die Aktivierung ggf. automatisch vorgenommen.

Ob Sie das Kästchen ankreuzen oder nicht, spielt keine Rolle; es hat keine Wirkung. In Systemen mit einer solchen Batterie (Lynx BMS, BYD, Pylontech, MG Electronics, Freedomwon, Redflow und andere) werden alle Ladegeräteeinstellungen durch Parameter, die vom CAN-bus kommen, außer Kraft gesetzt.

* Configured for VE.Bus BMS
Die Aktivierung weist auf die 'Victron Smart Lithium Batteries in conjunction with VE.Bus BMS' hin und darueber hinaus wohl keine Bedeutung.
[https://www.victronenergy.de/upload/documents/Datasheet-BMS-overview-DE.pdf]

*Storage Mode (Lagermodus)
Dieser Modus ist eine weiterer 'Ladephase' (nach bulk, absorption, float, storage) und hat gegenueber der Float-Phase eine leicht abgesenkte Spannung von 13.2V (Ruhespannung) und eine zyklisch wiederkehrende (Repeated absorption interval in days) kurze Absorptionsspannung (Repeated absorption time). Nach einer 24 Stunden Floating-Phase wird bei aktiviertem Storage-Mode in die Storage-Phase gewechselt.

*Verwenden Sie Ausgleich (Tubular Plate Traction Battery Mode)
Dieser spezielle Modus, am Ende der Absorptions-Phase. Sobald der Ladestrom unter 10% des (Start-)Bulk-Stromes faellt, wird der Ladestrom solange gehalten bis die Spannung auf 17 V gestiegen ist.

*Ladeerhaltungsspannung (Float Voltage)
Die Float Voltage duerfte fuer Lithium Batterien eigentlich keine Bedeutung haben, es wird aber darauf hingewiesen, dass bei den Pylontech eine Spannung von 51 V eingetragen sein soll.

*Ladekurven
**Fixed (Die Absorptionsphase ist zeitlich begrenzt und wird aus der Eintragung (maximum) Absorption Time ermittelt.)
**Adaptive (Die Zeit fuer Absorptionphase wird aus der Zeit der Bulk-Phase abgeleitet, aber maximal Absorption Time)
**Adaptive+BatterySafe (Die Zeit fuer Absorptionphase wird aus der Zeit der Bulk-Phase abgeleitet, aber maximal Absorption Time.) (nicht bei Lithium)
Es wird empfohlen unter normalen Umstaenden immer den adaptiven Modus auszuwaehlen. Die Uebersetzung ist im Dokument von Victron hier wieder suboptimal. Was soll uns der Satz "Wenn der Ausgleich zwischen Ladegerät und Batterie nicht ideal ist ..." sagen? Die Empfehlung die Fixed-Ladekurve zu waehlen, so dass eine Ueber- oder Unterladung vermieden werden kann. Was eine Unterladung hier bedeuten soll ist mir nicht klar.

*Stop charger below
Eine Ladung von unter 5°C sollte bei Lithium unterbleiben.

====AC-Eingangssteuerung (Virtual Switch)====
Der Mechanismus hinter der AC-Eingangssteuerung ist das Öffnen oder Schließen des internen AC-Eingangsrelais des MultiPlus. Diese Funktion ist standardmäßig nicht aktiviert.

Ich glaube da war der Google-Uebersetzter oder ein ChatBot am Werk:-))

Die AC-Eingangssteuerung kann auf zahlreiche Arten eingerichtet werden, z.B. trennt sich der Multi vom Netz, wenn die Batterien voll genug sind bzw. die AC-Last nicht zu groß ist. Der Multi wird sich die meiste Zeit vom Netz trennen. Er lässt das Netz nur rein, wenn die Batterien leer sind oder wenn Sie eine große AC-Last betreiben. Sie können das Gitter jetzt wie einen Backup-Generator verwenden.

Diese Einstellungen sind nicht von Bedeutung, bzw. muss auch abgeschaltet sein, wenn man Assistenten benutzt.

TODO

====Assistenten====
[https://www.victronenergy.com/live/assistants:overview_of_available_assistants Ueberblick]

===VE.Bus System Konfigurator===

===VE.Bus Quick Configure===

===VEFlash===

==Menuefuehrung CE Configure 3==

==Request for Comments==

<comments />

WRT54G (Revival)

2026-07-31T16:04:26Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Wie so oft kann ich mich von alter ausgedienter Hardware nicht trennen und ueberlege was man mit so einem Schaetzchen wie dem WRT54G(L V1.1) noch so tun kann. Die Nutzung als AP ist nicht mehr zeitgemaesz, aber als Client kann ich mir einen Einsatz noch gut vorstellen. Abgesehen von der Tatsache dass ein Raspi doch etwas flinker ist, braucht man sich bei einem WRT54G keine Sorgen um sterbende SD-Karten zu machen. Und um ein paar kleine Routinen und Sensoren im Netzwerk einzubinden reicht die Performance der WRT54G in vielen Faellen.

Durch ein paar kleine Hardwareeingriffe kann man den WRT54G mit einem SD-Kartenleser, mit 2 seriellen Schnittstellen und mit zwei USB-Ports (V1.1) ausstatten. Ein Variante, die ich im Netz gefunden habe, integriert noch einen Arduino-ProMicro in das Gehäuse und eroeffnet so ein riesiges Feld an Moeglichkeiten.

'''HINWEIS:''' Das hier beschriebene Vorgehen der systematischen Analyse einer (Embedded-)Hardware laesst sich natuerlich vorgangsgleich auf andere Hardware anwenden. Es ist fuer mich oft der einzige (richtige) Weg, um ein tieferes Verstaendnis von Zusammenhaengen zu erkennen. Das immer wieder erstaunliche an der Sache ist, dass ab einem bestimmten Grad des Eintauchens sich viele Forenfragen in Luft aufloesen. Oder anders ausgedrueckt, macht man sich einmal diese Arbeit weisz man auf einmal was man tut und probiert nicht einfach nur rum.

=DD-WRT vs. OpenWRT=
Ich bin hin- und hergerissen. Mit OpenWRT waren die Erfahrungen (Kamikaze, White Russian) aber eher schlecht. Danach habe ich lange Zeit DD-WRT (v3.0-r36247 std (06/29/18) KERNEL 2.4.37) benutzt und es ging so. Aber die 6 APs (mittlerweile durch Ubiquiti-APs ersetzt) im Haus haben immer irgendwie gezickt.

Jetzt wo der AP-Modus keine Rolle mehr spielt und MMC, JFFS, CIFS, USB, TTYSXX und das Aufspielen neuer Software eine groeszere Rolle spielen, war ich mit DD-WRT irgendwie in einer gefuehlten Sackgasse. DD-WRT bietet zum Beispiel Unterstützung von ip (a und r aber nicht n) parallel zu ifconfig, route und arp, aber gibt z.B. keine Fehlermeldungen bei Befehlen wie mount, mkdir. Auch eine Hilfe sucht man vergebens. Da hilft oft nur ein Blick in den SourceCode was die Software tut, oder halt nicht wie gewohnt funktioniert.

Der Support (DD-WRT) fuer CIFS, MMC und JFFS wird zwar in der WebGUI angeboten, laesst sich auch konfigurieren, aber CIFS und MMC lieszen sich nicht mounten und die Unterstuetzung von JFFS war auf der Konsole nicht auffindbar.

Bei OpenWRT Backfire war es mir bisher nicht moeglich den WLAN-Treiber fuer den BCM4306 zum Laufen zu bringen. Das Backfire-Image 10.03.1 brcm-2.4 wird als stabil fuer WRT54G(V4/L) angegeben, meldet aber (dmesg) "No Broadcom Chipset" osae beim Laden des Treibers (:-(). Das Image brcm47xx wird dagegen als "works (somewhat unstable)" bewertet, laeuft bei mir bisher sauber. Ich weiß nicht auf was sich [https://openwrt.org/toh/linksys/wrt54g hier] das 'unstable' bezieht.

Um da einen Schritt vorwaerts zu machen, muss ich erst eine paar zurueck machen.

Um schneller vergleichen zu koennen, habe ich einen Router mit Backfire 10.03.1 und den anderen mit DD-WRT v3.0 36247 laufen.

Aber der Reihe nach.

=Hardware=
Um sich eine besser Bild von den Zusammenhaengen zu machen hier nochmal die Hardware im Ueberblick.

==CPU==
Label: Broadcom BCM5352EKPBG

<nowiki>
DD-WRT:~# cat /proc/cpuinfo
system type : Broadcom BCM5352 chip rev 0
processor : 0
cpu model : BCM3302 V0.8
BogoMIPS : 199.47
wait instruction : no
microsecond timers : yes
tlb_entries : 32
extra interrupt vector : no
hardware watchpoint : no
ASEs implemented :
VCED exceptions : not available
VCEI exceptions : not available
</nowiki>

Hinweise:

Die 199.47 BogoMIPS lassen auf 200 MHz und ein Verhältnis von 1 schlieszen.

Der CPU-Kern BCM3302 findet auch in den SoC BCM4712, BCM53xx und BCM5836 Verwendung (siehe dazu http://oleg.wl500g.info/sdram.html)

==SDRAM==

Label: Winbond W9412G6JH-5

Size: 2M x 4 BANKS * 16 BITS DDR SDRAM => 16 MebiByte

CELL-Array (Bank) Konfiguration: 4096 * 512 * 16 = 33.554.432 Bit mal 4 Baenke = 134.217.728 Bit = 16.777.216 Byte

Adressraum: 0x000000 - 0xFFFFFF

<nowiki>
DD_WRT:~# nvram show|grep sdram
sdram_config=0x0062
sdram_refresh=0x0000
sdram_ncdl=0xfe0008
sdram_init=0x010b

DD-WRT:~# free
total used free shared buffers cached
Mem: 13004 11808 1196 0 1452 5180
-/+ buffers/cache: 5176 7828
Swap: 0 0 0
</nowiki>

Nuetzlicher Link:

[http://oleg.wl500g.info/sdram.html]

==Flash==

Label: MXIC (Macronix) MX29LV320EBTI-70G

Size: 4 MebiByte of 8 Bits each or 2 MebiBytes of 16

Irgendwo habe ich gelesen, dass der WRT54G den 16 Bit-Zugriff nutzt.

Adressierung: 0x000000 bis 0x3FFFFF

Sector Structure - 8K-Byte x 8 and 64K-Byte x 63• Extra 256-Byte sector for securit

DD-WRT:
<nowiki>
Flash device: 0x400000 at 0x1c000000
bootloader size: 262144
Physically mapped flash: Filesystem type: squashfs, size=0x2c8102
partition size = 2930688
Creating 4 MTD partitions on "Physically mapped flash":
0x00000000-0x00040000 : "cfe"
0x00040000-0x003f0000 : "linux"
0x00124800-0x003f0000 : "rootfs"
mtd: partition "rootfs" doesn't start on an erase block boundary -- force read-only
0x003f0000-0x00400000 : "nvram"
sflash not supported on this router
</nowiki>

Label cfe: 256 MebiByte (262.144 Byte) Bootloader
Label linux: 3.776 MebiByte (3.866.624) darin enthalten (am Ende) 2.862 MebiByte (2.930.688) rootfs
Label nvram: 64 KibiByte (65536) Configvariablen

Was man hier jetzt erkennen kann, dass das eigentliche Image (.bin,.trx) sich im MTD-Device mit dem Label linux (inkl. dem Device rootfs) befindet. Fuer das Image bleiben 4 MebiByte minus 256 MebiByte (CFE Bootloader) minus 64 KibiByte (nvram) uebrig. Die Squashfs-Size (s.o.) 0x2c8102 (2.916.610 Byte) ist vermutlich die belegte Groesze in der linux-Partition.

Mit dem Programm mtd (http://www.linux-mtd.infradead.org/archive/tech/faq.html memory technology device) werden die Partitionen gemountet/administriert/...

<nowiki>
DD-WRT:~# ls -l /dev/mtd/
crw-rw-rw- 1 root root 90, 0 Jan 1 01:00 0
cr--r--r-- 1 root root 90, 1 Jan 1 01:00 0ro
crw-rw-rw- 1 root root 90, 2 Jan 1 01:00 1
cr--r--r-- 1 root root 90, 3 Jan 1 01:00 1ro
crw-rw-rw- 1 root root 90, 4 Jan 1 01:00 2
cr--r--r-- 1 root root 90, 5 Jan 1 01:00 2ro
crw-rw-rw- 1 root root 90, 6 Jan 1 01:00 3
cr--r--r-- 1 root root 90, 7 Jan 1 01:00 3ro
DD-WRT:~# ls -l /dev/mtdblock/
0 1 2 3
DD-WRT:~# ls -l /dev/mtdblock/
brw-rw-rw- 1 root root 31, 0 Jan 1 01:00 0
brw-rw-rw- 1 root root 31, 1 Jan 1 01:00 1
brw-rw-rw- 1 root root 31, 2 Jan 1 01:00 2
brw-rw-rw- 1 root root 31, 3 Jan 1 01:00 3

DD-WRT:~# mtd
Usage: mtd [<options> ...] <command> [<arguments> ...] <device>

The device is in the format of mtdX (eg: mtd4) or its label.
mtd recognizes these commands:
unlock unlock the device
resetbc reset bootcounter for WRT1900AC/WRT1200AC/WRT1900ACv2
erase erase all data on device
write <imagefile>|- write <imagefile> (use - for stdin) to device
Following options are available:
-q quiet mode (once: no [w] on writing,
twice: no status messages)
-r reboot after successful command
-f force write without trx checks
-e <device> erase <device> before executing the command

Example: To write linux.trx to mtd4 labeled as linux and reboot afterwards
mtd -r write linux.trx linux

</nowiki>

===CFE (Common Firmware Environment) Bootloader===

CFE ist nicht nur der Bootloader (fuer Broadcom), sondern auch ein Interface fuer die Hardware.

Auf Github befindet sich der [https://github.com/kevbroch/cfe Sourcecode].

Definition [https://academic.microsoft.com/topic/203009010/publication/search?q=Common%20Firmware%20Environment&qe=And(Composite(F.FId%253D203009010)%252CTy%253D%270%27)&f=&orderBy=0]
Common Firmware Environment (CFE), pronounced as 'cafe', is a firmware interface and bootloader developed by Broadcom for 32-bit and 64-bit system- on-a-chip systems. It is intended to be a flexible toolkit of CPU initialization and bootstrap code for use on embedded processors (typically running on MIPS32/64 instruction set CPUs found in Broadcom SoCs). It is roughly analogous to the BIOS on the IBM PC platform. Its source-code is available on Open source license from Broadcom. Common embedded system alternatives include Das U-Boot.

Da das CFE mit dem BIOS bei einem PC vergleichbar ist, kann man sich vorstellen, dass sollte da ein "Defekt" vorliegen, die einfachen Mechanismen zum wiederherstellen der Embedded Hardware schwieriger werden. Manchmal wird in diesem Zusammenhang auch schon von "bricked" gesprochen. Dies ist aber nicht ganz richtig. Es bleiben in diesem Fall noch mindestens 2 Moeglichkeiten der Rettung: Erstens JTAG und zweitens Flash ausloeten und extern behandeln!

'''Hinweis:''' Mit der zweiten Moeglichkeit habe ich mal ein Panasonic-Notebook mit verlorenem BIOS-Passwort wiederbelebt, obwohl selbst Panasonic behauptet hat, dass es da keine Rettung gaebe, da ihre BIOSe sicher seien und keine (SW-)Moeglichkeit des Passwortruecksetzens besteht. Also wer so einen "hoffnungslosen" Fall hat, dem kann ich gerne weiterhelfen.

Interessant ist auch der Hinweis im [https://en.wikipedia.org/wiki/Common_Firmware_Environment Wiki], dass CFE auch in SmartTVs von LG und Samsung Einsatz findet. Sogar Amiga (meinen hab ich noch:-))) NG nutzt ihn.

===Linux (Image/Squashfs)===

Am Beispiel eines (alten) Images sei die Konvertierung von bin nach trx (und ggf. zuerueck) gezeigt.

dd if=lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.bin of=lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.trx bs=32 skip=1

Mit diesem Befehl werden die ersten 32 Byte des Bin-Images entfernt.

<nowiki>
worker:/home/chris/Downloads # ll lede*
-rw-r--r-- 1 chris users '''4001824''' Jul 27 21:22 lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.bin
-rw-r--r-- 1 root root '''4001792''' Jul 29 22:59 lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.trx

worker:/home/chris/Downloads # hexdump -C lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.bin|more
00000000 57 35 34 47 00 00 00 00 13 06 16 04 47 01 55 32 |W54G........G.U2|
00000010 4e 44 00 06 1f 00 00 00 00 00 00 00 00 00 00 00 |ND..............|
00000020 48 44 52 30 00 10 3d 00 3d a6 e1 7b 00 00 01 00 |HDR0..=.=..{....|
00000030 1c 00 00 00 24 09 00 00 00 54 12 00 1f 8b 08 00 |....$....T......|
00000040 00 00 00 00 02 03 8d 57 5d 68 1c d7 15 fe e6 ee |.......W]h......|
00000050 ac b4 fa 4b 47 ab 95 b3 8e 55 32 d7 ba 5a 6d bd |...KG....U2..Zm.|
00000060 2e dd b8 ae ab 87 2d 9d ae 64 23 8a 1f d6 3f 69 |......-..d#...?i|
00000070 4d 29 61 51 44 f1 43 a0 72 d3 80 1f fa 30 28 4a |M)aQD.C.r....0(J|
00000080 11 45 78 36 60 83 1e 4c 59 d6 92 a3 94 45 2b 3b |.Ex6`..LY....E+;|
00000090 4a ea 42 9d 2c c2 6d 5a 68 a1 50 43 fd d2 22 42 |J.B.,.mZh.PC.."B|
000000a0 1e f2 54 f2 d0 36 6e 42 3b fd ce ec 6c ad 3a 36 |..T..6nB;...l.:6|
000000b0 cd c2 72 67 ee cf 39 df fd ce 39 df bd b3 e0 7f |..rg..9...9.....|
000000c0 be f4 87 f0 f6 b8 83 b5 56 06 eb ad 2c ae b7 c6 |........V...,...|
000000d0 f0 5a ab ea f7 97 80 19 0d 3f 59 3a 3f bc 6e e0 |.Z.......?Y:?.n.|
000000e0 f7 94 b2 4f ff da 00 1b 2b c0 72 d3 c6 ba 6b 63 |...O....+.r...kc|
000000f0 c9 3d 94 ba 8e 8f 43 37 03 fe 2c df f1 30 36 6c |.=....C7..,..06l|
00000100 cc 72 51 65 e1 a6 a5 6f f1 27 c3 50 48 19 7b 39 |.rQe...o.'.PH.{9|
00000110 af fc 44 da 98 5a 45 ed bc 9a 86 85 d3 39 ec a6 |..D..ZE......9..|
worker:/home/chris/Downloads # hexdump -C lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.trx|more
00000000 48 44 52 30 00 10 3d 00 3d a6 e1 7b 00 00 01 00 |HDR0..=.=..{....|
00000010 1c 00 00 00 24 09 00 00 00 54 12 00 1f 8b 08 00 |....$....T......|
00000020 00 00 00 00 02 03 8d 57 5d 68 1c d7 15 fe e6 ee |.......W]h......|
00000030 ac b4 fa 4b 47 ab 95 b3 8e 55 32 d7 ba 5a 6d bd |...KG....U2..Zm.|
00000040 2e dd b8 ae ab 87 2d 9d ae 64 23 8a 1f d6 3f 69 |......-..d#...?i|
00000050 4d 29 61 51 44 f1 43 a0 72 d3 80 1f fa 30 28 4a |M)aQD.C.r....0(J|
00000060 11 45 78 36 60 83 1e 4c 59 d6 92 a3 94 45 2b 3b |.Ex6`..LY....E+;|
00000070 4a ea 42 9d 2c c2 6d 5a 68 a1 50 43 fd d2 22 42 |J.B.,.mZh.PC.."B|
00000080 1e f2 54 f2 d0 36 6e 42 3b fd ce ec 6c ad 3a 36 |..T..6nB;...l.:6|
00000090 cd c2 72 67 ee cf 39 df fd ce 39 df bd b3 e0 7f |..rg..9...9.....|
000000a0 be f4 87 f0 f6 b8 83 b5 56 06 eb ad 2c ae b7 c6 |........V...,...|
000000b0 f0 5a ab ea f7 97 80 19 0d 3f 59 3a 3f bc 6e e0 |.Z.......?Y:?.n.|
000000c0 f7 94 b2 4f ff da 00 1b 2b c0 72 d3 c6 ba 6b 63 |...O....+.r...kc|
000000d0 c9 3d 94 ba 8e 8f 43 37 03 fe 2c df f1 30 36 6c |.=....C7..,..06l|
000000e0 cc 72 51 65 e1 a6 a5 6f f1 27 c3 50 48 19 7b 39 |.rQe...o.'.PH.{9|
000000f0 af fc 44 da 98 5a 45 ed bc 9a 86 85 d3 39 ec a6 |..D..ZE......9..|
00000100 8e 1a cf b1 ca d3 29 78 18 31 f6 ea 88 b5 1f 67 |......)x.1.....g|
00000110 54 da 03 f6 23 af d2 35 1a d8 f5 3d 7c c0 bf 9f |T...#..5...=|...|

</nowiki>

Den Header des Bin-Images (57 35 34 47 00 00 00 00 13 06 16 04 47 01 55 32 4e 44 00 06 1f 00 00 00 00 00 00 00 00 00 00 00) muss ich mir bei Gelegenheit mal noch genauer anschauen.

Fuer die kleine Image-Analyse ist das Programm 'binwalk' recht nuetzlich.

<nowiki>
worker:/home/chris/Downloads # binwalk dd-wrt.v24_std_generic_36247.bin

DECIMAL HEXADECIMAL DESCRIPTION
--------------------------------------------------------------------------------
0 0x0 TRX firmware header, little endian, image size: 3858432 bytes, CRC32: 0xA663F3EF, flags: 0x0, version: 1, header size: 28 bytes, loader offset: 0x1C, linux kernel offset: 0x9D0, rootfs offset: 0xE4800
28 0x1C gzip compressed data, maximum compression, from Unix, last modified: 1970-01-01 00:00:00 (null date)
2512 0x9D0 LZMA compressed data, properties: 0x6E, dictionary size: 33554432 bytes, uncompressed size: 2985984 bytes
935936 0xE4800 Squashfs filesystem, little endian, DD-WRT signature, version 3.0, size: 2916610 bytes, 690 inodes, blocksize: 131072 bytes, created: 2018-06-29 09:09:45

worker:/home/chris/Downloads # binwalk dd-wrt.v24_mini_generic_44715.bin

DECIMAL HEXADECIMAL DESCRIPTION
--------------------------------------------------------------------------------
0 0x0 TRX firmware header, little endian, image size: 3375104 bytes, CRC32: 0x9886060E, flags: 0x0, version: 1, header size: 28 bytes, loader offset: 0x1C, linux kernel offset: 0xA34, rootfs offset: 0xCF400
28 0x1C gzip compressed data, maximum compression, from Unix, last modified: 1970-01-01 00:00:00 (null date)
2612 0xA34 LZMA compressed data, properties: 0x6E, dictionary size: 33554432 bytes, uncompressed size: 2756608 bytes
848896 0xCF400 Squashfs filesystem, little endian, DD-WRT signature, version 3.0, size: 2521285 bytes, 650 inodes, blocksize: 131072 bytes, created: 2020-11-03 04:01:08

worker:/home/chris/Downloads # hexdump -C dd-wrt.v24_mini_generic_44715.bin |more
00000000 48 44 52 30 00 80 33 00 0e 06 86 98 00 00 01 00 |HDR0..3.........|
00000010 1c 00 00 00 34 0a 00 00 00 f4 0c 00 1f 8b 08 00 |....4...........|
00000020 00 00 00 00 02 03 95 58 5d 6c 14 d7 15 3e 33 b3 |.......X]l...>3.|
00000030 eb dd b5 dd 74 d6 ec 3a a6 71 61 27 7b 67 3d b1 |....t..:.qa'{g=.|
00000040 f3 b0 20 8b 6e ab 7d 18 d6 b6 ba a5 a9 e4 90 54 |.. .n.}........T|
00000050 72 db 3c 58 04 28 aa 2a 95 a4 50 f1 40 db 09 01 |r.<X.(.*..P.@...|
00000060 e2 46 0e b3 a8 04 f9 a1 55 b6 36 6b d6 68 61 96 |.F......U.6k.ha.|
00000070 14 42 2b 85 c6 b5 b0 01 a9 aa 48 db a4 95 da 07 |.B+.......H.....|
</nowiki>

Also haben wir nach dem BIN-Header (s.o.) auch noch einen TRX-Header (28 Bytes: 48 44 52 30 00 80 33 00 0e 06 86 98 00 00 01 00 1c 00 00 00 34 0a 00 00 00 f4 0c 00)

Ab 0x1C steht der gzip-header beginnend mit der Magic Number (1f 8b). Siehe dazu [https://en.wikipedia.org/wiki/Gzip weiter]

Um die Analyse weiter zu treiben habe ich noch ein paar Zusatzpakete unter OpenSuSE (15.3) installiert.

zypper in openocd
zypper in sasquatch
zypper in bcm43xx-firmware
zypper in pullin-bcm43xx-firmware

Um sasquatch zu installieren war bei mir noch ein Repo hinzuzufuegen.

zypper ar "https://download.opensuse.org/repositories/devel:/tools/openSUSE_Leap_15.3/" DEVEL

Mit sasqautch war nun auch binwalk mit dem extrahieren der SquachFS-Partition erfolgreich.

<nowiki>
binwalk --extract dd-wrt.v24_std_generic_44715.bin
worker:/home/chris/Downloads # ll _dd-wrt.v24_std_generic_44715.bin.extracted/
total 8944
-rw-r--r-- 1 root root 4816 Jul 31 09:19 1C
-rw-r--r-- 1 root root 2748416 Jul 31 09:19 A34
-rw-r--r-- 1 root root 3622348 Jul 31 09:19 A34.7z
-rw-r--r-- 1 root root 2772622 Jul 31 09:19 CF400.squashfs
drwxr-xr-x 15 root root 4096 Nov 3 2020 squashfs-root
</nowiki>

Die Namen der extrahierten Dateien ist die hexadezimale Position im bin-File. Zusaetzlich zu sind die Inhalte bei A34 und CF400 noch dekomprimiert angelegt.

<nowiki>
worker:/home/chris/Downloads/_dd-wrt.v24_std_generic_44715.bin.extracted # 7z l A34.7z

7-Zip [64] 16.02 : Copyright (c) 1999-2016 Igor Pavlov : 2016-05-21
p7zip Version 16.02 (locale=de_DE.UTF-8,Utf16=on,HugeFiles=on,64 bits,16 CPUs Intel(R) Xeon(R) CPU X5570 @ 2.93GHz (106A5),ASM)

Scanning the drive for archives:
1 file, 3622348 bytes (3538 KiB)

Listing archive: A34.7z

--
Path = A34.7z
Open WARNING: Can not open the file as [7z] archive
Type = lzma

Date Time Attr Size Compressed Name
------------------- ----- ------------ ------------ ------------------------
..... 2748416 A34
------------------- ----- ------------ ------------ ------------------------
2748416 3622348 1 files

Warnings: 1
</nowiki>

unsquashfs fuehrte hier nicht zum Erfolg. Da die Magic Number von 0x73717368 auf 0x74717368 (Grrrr!) geaendert wurde.
Siehe hierzu [https://github.com/jtreml/firmware-mod-kit]

<nowiki>
worker:/home/chris/Downloads/_dd-wrt.v24_std_generic_44715.bin.extracted # sasquatch -i CF400.squashfs
SquashFS version [3.0] / inode count [700] suggests a SquashFS image of the same endianess
Non-standard SquashFS Magic: hsqt
Parallel unsquashfs: Using 1 processor
Trying to decompress using default gzip decompressor...
Trying to decompress with lzma...
Trying to decompress with lzma-adaptive...
Detected lzma-adaptive compression
654 inodes (693 blocks) to write

squashfs-root
dir_scan: failed to make directory squashfs-root, because File exists

created 0 files
created 0 directories
created 0 symlinks
created 0 devices
created 0 fifos
</nowiki>
https://reverseengineering.stackexchange.com/questions/15508/how-to-convert-the-dumped-firmware-from-linksys-wrt54gl-via-jtag-port-in-an-un

===NVRAM===

NonVolatileRAM. Die (Config-)Variablen zur Einstellung der Linux-Umgebung auf der (Embedded-)Hardware werden zur Laufzeit im RAM abgelegt und beim Booten aus der Partition mit dem Label nvram geladen. Das erklaert auch warum man nach einer Aenderung einer Variablen mit 'nvram commit' die Aenderungen in die Flash-Partitiion uebertraegt und somit 'nichtfluechtig' macht. Vergisst man nach einer Variablenaenderung das Committen (sich bekennen, verpflichten: Sinn?) geht die Aenderung bei einem Reboot verloren.

==Weitere WRT54G Hardware==

<nowiki>
DD-WRT:~# cat /proc/pci
PCI devices found:
Bus 0, device 0, function 0:
Class 0501: PCI device 14e4:0800 (rev 0).
IRQ 3.
Non-prefetchable 32 bit memory at 0x18000000 [0x18000fff].
Non-prefetchable 32 bit memory at 0x1fc00000 [0x1fffffff].
Non-prefetchable 32 bit memory at 0x1c000000 [0x1dffffff].
Non-prefetchable 32 bit memory at 0x1a000000 [0x1bffffff].
Bus 0, device 1, function 0:
Class 0200: PCI device 14e4:4713 (rev 0).
IRQ 4.
Master Capable. Latency=64.
Non-prefetchable 32 bit memory at 0x18001000 [0x18001fff].
Bus 0, device 2, function 0:
Class 0b30: PCI device 14e4:0816 (rev 0).
IRQ 5.
Non-prefetchable 32 bit memory at 0x18002000 [0x18002fff].
Bus 0, device 3, function 0:
Class 0c03: PCI device 14e4:4716 (rev 0).
IRQ 6.
Non-prefetchable 32 bit memory at 0x18003000 [0x18003fff].
Bus 0, device 4, function 0:
Class 0500: PCI device 14e4:080f (rev 0).
IRQ 3.
Non-prefetchable 32 bit memory at 0x18004000 [0x18004fff].
Non-prefetchable 32 bit memory at 0x0 [0x7ffffff].
Non-prefetchable 32 bit memory at 0x10000000 [0x17ffffff].
Non-prefetchable 32 bit memory at 0x80000000 [0x9fffffff].
Bus 0, device 5, function 0:
Class 0280: PCI device 14e4:4320 (rev 0).
IRQ 2.
Master Capable. Latency=64.
Non-prefetchable 32 bit memory at 0x18005000 [0x18005fff].
Bus 0, device 6, function 0:
Class 0280: PCI device 14e4:4719 (rev 0).
IRQ 3.
Non-prefetchable 32 bit memory at 0x18006000 [0x18006fff].
</nowiki>

https://devicehunt.com/view/type/pci/vendor/14E4

* BUS 0/DEVICE 0 14e4:0800 Sentry5 Chipcommon I/O Controller
* BUS 0/DEVICE 1 14e4:4713 Sentry5 Ethernet Controller
* BUS 0/DEVICE 2 14e4:0816 BCM3302 Sentry5 MIPS32 CPU
* BUS 0/DEVICE 3 14e4:4716 BCM47xx Sentry5 USB Host Controller
* BUS 0/DEVICE 4 14e4:080f Sentry5 DDR/SDR RAM Controller
* BUS 0/DEVICE 5 14e4:4320 BCM4306 802.11b/g Wireless LAN Controller
* BUS 0/DEVICE 6 14e4:4719 BCM47xx/53xx RoboSwitch Core

Passende Treiber:
BCM4306 PCI 14e4:4320 Broadcom WEP WPA WPA2 b/g b43, b43legacy - Firmware muss installiert werden. Die Benötigte Firmwaredatei ucode4/5.fw ist nur in dem weiter unten im Forum verlinkten älteren Installationspaket enthalten!

https://linux-club.de/wiki/opensuse/Broadcom_Wireless

<nowiki>
# firmware for b43
URL1=http://www.lwfinger.com/b43-firmware
FILE1=broadcom-wl-6.30.163.46.tar.bz2
FIRMWARE1=broadcom-wl-6.30.163.46.wl_apsta.o

# firmware for b43legacy
URL2=http://downloads.openwrt.org/sources
FILE2=wl_apsta-3.130.20.0.o
</nowiki>

=Pimpups=
==SDCard==
Um es vorweg zu nehmen: Lasst es!

Es funktioniert zwar, aber es ist so langsam, dass es in der Praxis keinen Vorteil bringt.

Ich habe als SDCard-Adapter diesen hier verwendet.
[[Datei:WRT54 SDCARD PCB top.jpg|mini]]
[[Datei:WRT54 SDCARD PCB bottom.jpg|mini]]
Auf der Karte ist ein 5C->3.3V Stabi, so dass ich die Karte an 5V anschliessen konnte.

Vom Insert bis Mount kann schon mal ne Minute dauern.

==SERCON==

Da der WRT54G 2 serielle Schnittstellen an JP2 anbietet kann im einfachsten Fall eine als Konsole und er zweite zur Kommunikation mit z. B. einem Mikrocontroller verwendet werden. Aber auch eine virtuelle Anbindung über Sercon wäre eine schöne Sache.

==USB==
TODO

==Serial Interface==

[https://store.curiousinventor.com/product/spk-wrt-serial-port-kit-for-wrt54g-router/]

==OneWire==

[https://owfs.org/index_php_page_wireless-router.html]

==I2C==

=WIKI Hinweise=

To support third-party firmware, Linksys has re-released the WRT54G v4, under the new model name WRT54GL (the 'L' in this name allegedly stands for 'Linux'). It is also possible to replace the 2 MB flash chip in the WRT54G with a 4 MB flash chip. The Macronix International 29LV320BTC-90 is a suitable part although others may work as well. The user must first install a JTAG header and use a JTAG cable to back up the firmware, then replace the chip and restore the firmware with the JTAG cable. After testing for proper functionality of the modified unit, third-party firmware can be flashed using the JTAG cable and a suitable image file.

With the Attitude Adjustment (12.09)[46] release of OpenWrt, all WRT54G hardware versions with 16 MB of RAM are no longer supported, and older Backfire (10.03)[47] is recommended instead. Issues came from dropping support for the legacy Broadcom target brcm-2.4, making lower end devices run out of memory easily. Support for Attitude Adjustment is limited to WRT54G hardware versions with 32 MB of RAM, which includes WRT54GS and (apart from performing RAM upgrades through hardware modifications) some of the WRT54G and WRT54GL versions having the capability for unlocking their additional 16 MB of RAM.[48][49][50][51][52][53]

=JTAG=
Nur der Vollstaendigkeit wegen hier noch ein paar Worte zu JTAG.

'''J'''oint '''T'''est '''A'''ction '''G'''roup (kurz JTAG) ist ein häufig verwendetes Synonym für den IEEE-Standard 1149.1, der eine Methodik für das Testen und Debuggen integrierter Schaltungen, also Hardware auf Leiterplatten, beschreibt.

[https://www.linux-magazin.de/ausgaben/2010/06/diagnosewerkzeug/ Einstieg]

JTAG besteht aus nur 4+2 Pins TCK, TMS, TDI und TDO.

{| class="wikitable"
!colspan="3"|JTAG-Interface
|-
|PIN
|Name
|Bedeutung
|-
|TCK
|Test Clock
|Takt der Datenuebertragung
|-
|TMS
|Test Mode Select
|Navigation im Zustandsautomaten
|-
|TDI
|Test Data In
|Daten Adapter->Geraet
|-
|TDO
|Test Data Out
|Daten Adapter<-Geraet
|-
|/TRST
|Test Reset
|Zustandsautomat in Ausgangszustand
|-
|/SRST
|System Reset
|Hardwarereset
|-
|}

Es gibt keine einheitliche Steckerbelegung für JTAG-Anschluesse.

==Debrick==

[https://zedt.eu/tech/hardware/recovering-a-bricked-linksys-wrt54gl-v1-1-using-jtag-part-1-the-hardware/]

=Request for Comments=

<comments />

=Weiterfuehrende Links/Analysen/Techniken=

https://www.heise.de/ct/ausgabe/2013-21-Hinter-den-Kulissen-eines-Router-Botnets-2313886.html

https://www.heise.de/newsticker/meldung/Funkregulierung-als-Angriff-auf-alternative-Software-Open-Source-Projekte-gefaehrdet-2805855.html

https://forum.ubuntuusers.de/topic/netzwerkkarte-nach-deaktivierung-im-autostart/#post-2480236

https://www.broadcom.com/support/802.11

https://t3n.de/news/sicherheitsluecke-milliarde-1257306/

https://www.agner.org/optimize/ objconv

https://rjmendez.github.io/posts/2019/02/Indeed_CTF_Embedded_2/

https://berlioux.com/electronique/wrt-sim/wrt-sim-en.html

PCF8574

2026-07-31T16:04:23Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Als Porterweiterung für Mikrocontroller ist der PCF8574 mir seiner Anbindung ueber I2C schon ein betagter Geselle (80er).
Fuer Arduino&Co aber nach wie vor sehr nuetzlich.
Diese Seite dient mir dazu, mir nochmal ueber die Anbindung von Tastaturen, Displays oder auch Relais Klarheit zu verschaffen.
Der nachfolgende Artikel aus den 8zigern von ELV diente mir damals dazu mich genauer mit dem I2C-Busprotokoll auseinanderzusetzen.
Heute liegt mein Schwerpunkt eher auf der Sondierung der ueber 48 gezaehlten Libraries mit PCF8574-Unterstuetzung des Arduino-Frameworks.
Bevor man jedoch die Software beurteilen kann, sollte man sich ueber die Hardwaremoeglichkeiten im Klaren sein. Was bei dem PCF8574 noch recht einfach ist.
Ein entscheidendes Kriterium zur Auswahl einer Library ist neben der Groesze, der Kompatibilitaet vor allem die Unterstuetzung der '''Interrupt-Faehigkeit''' (/INT).
[[Datei:ELV PCF8574P.jpg|thumb]]

Das Modul war ein Teil dieses [https://de.elv.com/i2c-pc-interface-iic-2-202540 Bausatzes]

=Hardware=

Den Einstieg mache ich mit der Portimplementierung, die sich ein wenig von der von Mikrocontrollernbekannten unterscheidet.

Laut Datenblatt betraegt die maximale I²C Taktrate 100kHz fuer den PCF und 400 kHz fuer den PCA, was dem Standard entspricht.

Die Spannungsversorgung kann zwischen 2,5 V und 6 V liegen, was den Betrieb z. B. am Raspi mit seinen 3,3V direkt ohne Level-Shifter moeglich macht.

Was mir auch aufgefallen ist betrifft den Umstand, dass die wenigstens Implementationen den /INT-Pin (active LOW open-drain interrupt output) benutzen/auswerten.
Ein Interrupt wird ausgeloest sobald der Status am Eingangspin sich vom Inputport Register Status unterscheidet.

Die Port-Pins sind zustandsgesteuerte Flipflops (Latches) und man kann an sie eine LED z.B. direkt anschlieszen. Die Gesamtstrom-"Belastung" darf dabei aber 80 mA nicht ueberschreiten.

Kapitel 8 des Datenblattes gibt folgendes an:

8 I/O programming

8.1 Quasi-bidirectional I/Os

Quasi weist auf den Umstand hin, dass die Ports zwar als Eingang und Ausgang dienen können , es aber Einschränkungen/Besonderheiten zu beachten gilt.

Es gibt z.B. nicht wie von Mikrocontrollern gewohnt, ein Direction Control Register (DCR).
Bei einem Lesezugriff auf einen Port (Anm.: Mit Port ist zwar hier ein Port-Pin gemeint, eigentlich liest oder schreibt man aber immer alle 8 Port-Pins zusammen.) erhaelt man den Status des Eingangs-FlipFlops.

Eine weitere wichtige Information betrifft das Einschaltverhalten. Sobald der IS mit Spannung versorgt wird gehen alle Ports auf HIGH und als INPUTS und die 100uA Stromquelle ist eingeschaltet.

[[Datei:PCF8574 Port intern.png|800px]]

Das obere FLipFlop uebernimmt und speichert den Zustand im SHift-Register bei einem Schreibzugriff.

Das untere FlipFlop uebernimmt und speicher den Zustand des Port-Pins bei einem Schreib- oder Lesezugriff!

Nach einem Reset (Power on) sind beide FlipFlops im Zustand Q = 1.

Die Anreicherungstypen (MOSFETs) sind bei UGS = 0 V gesperrt (selbstsperrend) ID = 0 A.

Das heiszt der obere pMOSFET (Itrt(pu)) ist bei einem Schreibimpuls und 1-Zustand des Output-FF gesperrt. In allen anderen Faellen ist er leitend.

Ist das Ausgangs-FF im 1-Zustand sind die Ausgangs-MOSFET gesperrt.

Ist das Ausgangs-FF im 0-Zustand sind die Ausgangs-MOSFET beide leitend.
Ein (/INT) Interrupt wird ausgeloest wenn wenn sich der Zusatnd am Port-Pin vom Zusatnd des Eingangs-FF unterscheidet, d.h. der Zustand wurde noch nicht per Lesezugriff ins Eingangs-FF uebernommen. Der Interrupt wird also durch einen Lese- oder Schreibzugriff zurueckgesetzt. Kehrt der Zustand des Port-Pins zum "alten" bekannten Zustand zurueck bevor der Mikrocontroller reagiert, geht der Interrupt auch wieder in den unausgeloesten Zustand zurueck.

An einem Port-Pin kann man 4 verschiedene Zustaende unterscheiden:
INPUT HIGH/LOW: Man muss eine 1 an den Port-Pin uebertragen. Das ist der "Normalzustand" nach einem PowerOn (Reset). MOSFETs gesperrt.
Durch einen Lesezugriff wird der Zustand (VDD oder VSS) des Port-Pins gelesen.
Ensure a logic 1 is written for any port that is being used as an input to ensure the strong external pull-down is turned off.

Die Zuordnung von LOW und HIGH geschieht LOW < 0,3 * VDD und HIGH > 0,7 * VDD.

VDD = 5 V LOW < 1,5 V HIGH > 3,5 V

VDD = 3,3 V LOW < 0,99 V HIGH > 2,31 V

OUTPUT HIGH: Man muss eine 1 an den Port-Pin uebertragen.

OUTPUT LOW: Man muss eine 0 an den Port-Pin uebertragen. Hierbei ist zu beachten, dass nicht gleichzeitig der PIN auf VDD als INPUT gelegt wird.

If a LOW is written, the strong pull-down turns on and stays on. If a
HIGH is written, the strong pull-up turns on for 1⁄2 of the clock cycle, then the line is held
HIGH by the weak current source.

=Programmierung=
==C==
An der Stelle nutze ich die Gelegenheit mir nochmal die geliebten Zeiger(-Operationen) zu vergegenwaertigen.
Eigentlich will ich mir nur noch mal im Klaren werden, ob in main() char *argv[] oder char **argv 'besser' ist.

Ein Zeiger ist eine Variable, in der sich die Adresse eines Datenobjektes oder '''einer Funktion''' befindet.

Um die Adresslaenge (8, 16, 32, 64, 96) herauszubekommen dient z. B. folgendes kleine Programm.

<syntaxhighlight lang="c" line>
#include "stdio.h"
int main()
{
int array[5];

/* If %p is new to you, you can use %d as well */
printf("array=%p : &array=%p\n", array, &array);

printf("array+1 = %p : &array + 1 = %p\n", array+1, &array+1);

return 0;
}
</syntaxhighlight>

Der Pointer array zeigt auf das erste Element des Integer-Arrays.
Somit haben &array[0] und array den gleichen Inhalt.

Auf dem Raspi ergibt sich eine Integerlaenge zu 4 Byte.

Die Adresse von array (&array) zeigt auf das ganze Array (5 x 4 Byte).

Die Notation Datentyp* zeiger finde ich eingaengiger als Datentyp *zeiger. Da beides zulaessig ist bevorzuge ich das Sternchen beim Datentyp.

Das folgende Beispiel zeigt warum:
<syntaxhighlight lang="c" line>
int x, *px = &x;
int *py; py = px;
</syntaxhighlight>
Hier funktioniert * als "Inhalt von" und & als "Adresse von" zu lesen irgendwie nicht mehr so richtig.
Die weiteren Dereferenzierungsoperatoren (. und ->) lasse ich hier mal auszer Acht.

Wenn ich es wie foglt schreibe dagegen schon:
<syntaxhighlight lang="c" line>
int x
int* px = &x;
int* py;
py = px;
</syntaxhighlight>

Der Programmcode ist identisch, die zweite Variante halte ich allerdings fuer besser fassbar.

Zeiger sind vom gleichen Datentyp wie der Datentyp auf den sie zeigen.

<syntaxhighlight lang="c" line>
const int* pointertoconst // Zeiger auf const int; der Zeiger kann veraendert werden seine Objekte nicht
int* const constpointer // const Zeiger auf int; *constpointer=10; erlaubt, aber constpointer = &intvariable nicht
</syntaxhighlight>

Weil ich gerade so am Probieren war hab ich das Testprogramm noch ein wenig erweitert.

<syntaxhighlight lang="c" line>
#include "stdio.h"
#include "stdint.h" // wird fuer die Extended Variable Types gebraucht

int main()
{
// int array[5] = {0}; // alle Werte werden zu 0 initialisiert
int array[5]={0,1,2}; // erlaubt; der Rest der Elemente wird mit 0 initialisiert

uint8_t i; // Extended Variable Type; liest sich logischer als unsigend char i

int len = sizeof(array) / sizeof(array[0]); // Anzahl der Elemente eines Array ermittlen

#define NUM(a) (sizeof(a) / sizeof(*a)) // eleganter Weg die Anzahl der Elemente eines Array zu ermittlen
// damit koennte man in der for-Schleife anstelle von len schoener NUM(array) schreiben

/* If %p is new to you, you can use %d as well */
printf("array=%p : &array=%p\n", array, &array);

printf("array=%x : &array=%x\n", array, &array);

printf("array+1 = %p : &array + 1 = %p\n", array+1, &array+1);

printf("array+1 = %x : &array + 1 = %x\n", array+1, &array+1);

// index bei 5 Elementen von 0 bis 4

for (i=0;i<len;i++) {
printf("%x : %p\n",array[i],&array[i]);
}
return 0;
}

</syntaxhighlight>

Nun zur eigentlichen Herausforderung, die Bedeutung der doppelten Dereferenzierung:

char** array;

Eine haeufig angewendete Naeherung geschieht ueber ein String array D‑':

<syntaxhighlight lang="c" line>
char* myStrings[] = {
"Hello",
"World"
};
</syntaxhighlight>

Der Grund ist naheliegend. Es gibt keinen Datentyp String in C. Stattdessen arbeitet man mit NULL-terminierten Character-Ketten.

Den gleichen Effekt wie das voran gegangene Beispiel erhaelt man auch mit:

<syntaxhighlight lang="c" line>
#include "stdio.h"

int main(){

char hello[]={'H','e','l','l','o','\0'};
char world[]={'W','o','r','l','d','\0'};

char* myStrings[]={hello,world};

// oder !!!

char* myStrings[2];

myStrings[0] = &hello[0]; // hier koente man auch hello schreiben
myStrings[1] = &world[0];

printf("%s %s\n",myStrings[0],myStrings[1]);

return 0;
}

</syntaxhighlight>

Vielleicht ist das ein Grund warum recht viele bei C den Riemen runterwerfen.
Ich halte C allerdings, abgesehen von Assembler, fuer einen Informatiker mit physikalisch-elektrischen Wurzeln ;-) und Anwendungsfaellen, nach wie vor fuer die beste Wahl.

Die main Funktion erhaelt vom Betriebssystem zwei Parameter uebergeben.
Der erste (argc) enthaelt die Anzahl der Argumente, die immer groeszer gleich 1 ist. Bei der Ueberbgabe befinden sich alle Eintrage der Kommandozeile im zweiten Parameter (argv). Da der Programmname zu Beginn der Zeichenfolge steht, bildet er auch das erste Element (argc=1).
Die weiteren Aufrufoptionen sind durch Leerzeichen getrennte Zeichenketten, die als Strings an main() uebergeben werden.
Wie in den Beispielen voran zu sehen, ist argv ein array von Strings also ein array von character-Ketten, die wiederum arrays sind.
Wenn man also die String, bzs. Character-Ketten, als char-arrays begreift ist also argv ein array von Zeigern auf diese char-arrays.
Also
argv: char* argv[]

Jetzt wird's richtig uebel.
<syntaxhighlight lang="c" line>
#include "stdio.h"

int main(int argc, char* argv[]){

printf("%d : %s : %c %c %c %c %c %c %c %c ...\n", argc, argv[0],*argv[0],*(argv[0]+1),*(argv[0]+2),*(argv[0]+3),*(argv+4),*(argv+5),*(argv+6),*(argv+7));

printf("%x %x %x %x\n",argv,argv[0],argv+1,argv[0]+1);

return 0;
}
</syntaxhighlight>

Der Reihe nach. In argv steht ein Zeiger, der auf den ersten Zeiger auf das erste Element (Character-Kette).
Somit sind argv und &argv[0] identisch. Wenn ich den String bearbeiten moechte benoetige ich den zweiten (besser vielleicht untergeordneten) Zeiger.
Will ich an die einzelnen Buchstaben eines jeden String benoetige ich den Inhalt (*) des zweiten Zeigers, also *(argv[0]) usw.
oder den InhaltInhalt von argv, also **argv.

<syntaxhighlight lang="c" line>
#include "stdio.h"

int main(int argc, char* argv[]){

char hello[]={'H','e','l','l','o','\0'};
char world[]={'W','o','r','l','d','\0'};

//char* myStrings[]={hello,world};

// oder !!!

char* myStrings[2];

myStrings[0] = &hello[0];
myStrings[1] = &world[0];

printf("%s %s\n",myStrings[0],myStrings[1]);

printf("%d : %s : %c %c %c %c %c %c %c %c %c...\n", argc, argv[0],*argv[0],**argv,*(argv[0]+1),*(argv[0]+2),*(argv[0]+3),*(*argv+4),*(*argv+5),**argv+6,**argv+7);

printf("%x %x %x %x\n",argv,argv[0],argv+1,argv[0]+1);

return 0;
}
</syntaxhighlight>

Die Klammern um die Additionen (Character-Ketten-Zeiger-Manipulation :-)) sind notwendig um die richtige Reihenfolge der Operationen zu gewaehrleisten. +6 und +7 ergeben nicht das richtig Ergebnis.

Eine Array-Defintion ohne Dimensionsangabe oder gleichzeitige Initialisierung funktioniert nicht. Deshalb ist die Schreibweise char* argv[] durchaus irrefuehrend. Hier klappt es nur wegen der byreference-Parameteruebergabe. Deshalb ist eine Defintion char** argv u.U. besser fassbar.

Beide main-Defintionen liefern das gleich Ergebnis, die Lesart der ersten Variante ist etwas eingaengiger, naemlich dass argv ein Zeiger auf ein array ist.
<syntaxhighlight lang="c" line>
#include "stdio.h"

//int main(int argc, char* argv[]){
int main(int argc, char** argv){

printf("%d : %s : %c %c %c %c %c %c %c %c %c...\n", argc, argv[0],*argv[0],**argv,*(argv[0]+1),*(argv[0]+2),*(argv[0]+3),*(*argv+4),*(*argv+5),**argv+6,**argv+7);

printf("%x %x %x %x\n",argv,argv[0],argv+1,argv[0]+1);

return 0;
}

</syntaxhighlight>

* Die Schreibweise **argv+i fuehrt nicht zum Ziel.
* Die Schreibweise *(*argv+i) fuehrt zum Ziel aber funktioniert so nur fuer das erste Element (Programmname)
* Die Schreibweise *(argv[x]+i) ist am flexibelsten, da man so auch jeden einzelnen Buchstaben der uebergebenen Optionen zugreifen kann

An der Stelle soll's mit einem Abschlussbeispiel mal reichen. Fuer den Anwendungsfall der i2c-Programmierung bleiebn die Kommandozeilen-Optionen ueberschaubar.

<syntaxhighlight lang="c" line>
#include "stdio.h"

//int main(int argc, char* argv[]){
int main(int argc, char** argv){

int i;

for (i=1;i<argc;i++){
if (*argv[i]=='-'){
switch(*(argv[i]+1)){
case 'h': printf("Help\n");
return 1;
break;
default: break;
}
}
}

for(i=0;i<argc;i++){
printf("%d: %s\n",i,argv[i]);
}
return 0;
}
</syntaxhighlight>

(AVR) Interrupts

2026-07-31T16:04:22Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

Externe Interrupts können im Prinzip über/von jedem I/O-Pin ausgelöst werden.
Wenn nicht ausdrücklich erwähnt beziehe ich mich bei meinen Aussagen auf den ATmega328P. Wenn jemand eine Info bezüglich eines anderen Prozessors benötigt, einfach unten in die Kommentare schreiben.

Zu beachten:
* Ein Interrupt ist erst nach 4 Taktzyklen durch PCIF erkennbar. Bei 20 MHZ Taktfrequenz sind das immerhin 200ns (4x50ns) oder 0,2us. Es wird aber kein Interrupt "verschluckt" wenn der Auslöser länger als einen Taktzyklus dauert. Kürzere Impulse lösen nicht garantiert einen Interrupt aus. Bei 0-Pegel-Interrupts muss zuerst der aktuelle Befehl abgearbeitet werden.
* Nur INT0 (PD2) und INT1 (PD3) sind "vollwertige" Interrupts
* Die 3 PCIx sind jeweils für eine Gruppe von I/O-Pins zuständig (PCI0 für PCINT7..0, PCI1 für PCINT14..8 , PCI2 für PCINT23..16).
<code>
During interrupts and subroutine calls, the return address program counter (PC) is stored on the stack. The stack is
effectively allocated in the general data SRAM, and consequently the stack size is only limited by the total SRAM size and
the usage of the SRAM. All user programs must initialize the SP in the reset routine (before subroutines or interrupts are
executed). The stack pointer (SP) is read/write accessible in the I/O space. The data SRAM can easily be accessed through
the five different addressing modes supported in the AVR architecture.
The memory spaces in the AVR architecture are all linear and regular memory maps.
A flexible interrupt module has its control registers in the I/O space with an additional global interrupt enable bit in the status
register. All interrupts have a separate interrupt vector in the interrupt vector table. The interrupts have priority in accordance
with their interrupt vector position. The lower the interrupt vector address, the higher the priority.
</code>

=Allgemein=
Die meisten Mikrocontroller besitzen einen oder mehrere I/O-Pins an denen abhaengig vom Zustandswechsel durch eine Programmunterroutine (Funktion) reagiert werden kann. Das ist natuerlich viel cleverer als in einer Schleife dauert nach einem Zustandswechsel zu "fragen" (Polling). Bei einem kleinen Microcontrollerprogramm, das nur das tut, mag das noch eine Ueberlegung wert sein. Sobald aber ein Programm ein wenig komplexer wird ist interrupten angesagt.

Zum konfigurieren des Verhaltens bei einem Interrupt besitzen die Controller ein Reihe von Registern.

Beim ATmega328P als erstes, das SREG (AVR Status Register) und darin das Global Interrupt Enable (Bit 7)

The global interrupt enable bit must be set for the interrupts to be enabled. The individual interrupt enable control is then
performed in separate control registers. If the global interrupt enable register is cleared, none of the interrupts are enabled
independent of the individual interrupt enable settings. The I-bit is cleared by hardware after an interrupt has occurred, and is
set by the RETI instruction to enable subsequent interrupts. The I-bit can also be set and cleared by the application with the
SEI and CLI instructions, as described in the instruction set reference.

Abhaengig von den Bits BOOTRST, IVSEL, IVCE stehen die Interruptvektoren (siehe weiter unten) an einer anderen Position im Programmspeicher.

Fuer die Interruptkontrolle sind folgende Register von Bedeutung:
* '''EICRA''' External Interrupt Control Register A (0x69) -> Interrupt Sense Control INT0/INT1 (siehe folgende Tabelle)
* '''EIMSK''' – External Interrupt Mask Register (0x1D/0x3D) -> External Interrupt Request INT0/INT1 Enable
* '''EIFR''' – External Interrupt Flag Register (0x1C/0x3C) -> INTF0/INTF1: External Interrupt Flag 0/1
* '''PCICR''' – Pin Change Interrupt Control Register (0x68) -> PCIE0/1/2: Pin Change Interrupt Enable 0/1/2
* '''PCIFR''' – Pin Change Interrupt Flag Register (0x1B/0x3B) -> PCIF0/1/2: Pin Change Interrupt Flag 0/1/2
* '''PCMSK2''' – Pin Change Mask Register 2 (0x6D) -> PCINT23-PCINT16
* '''PCMSK1''' – Pin Change Mask Register 1 (0x6C) -> PCINT14-PCINT8 (kein PCINT15!)
* '''PCMSK0''' – Pin Change Mask Register 0 (0x6B) -> PCINT7-PCINT0

Im Gegensatz zu den PC-Interrupts, die nur auf einen Wechsel des Zustandes reagieren, koennen INT0/1 auch auch auf fallende und steigende Flanken und Zustaende reagieren.

==INT1 INT0==
Dies sind die "vollwertigen" Interrupts.
* Können auf fallende und steigende Flanke und 0-Pegel triggern (-> EICRA)
* Bei der 0-Pegel wird der Trigger solange ausgelöst bis wieder 1-Pegel anliegt.

An- und Ausschalten kann man die beiden Interrupts im EIMSK – External Interrupt Mask Register. Mask sollte vielleicht besser Enable heißen.

Das EICRA – External Interrupt Control Register A (0x69) dient ausschließlich (Interrupt Sense Control Bit0-3) der Triggereinstellung von INT0 und INT1

{| class="wikitable"
!colspan="3"|Interrupt 0/1 Sense Control
|-
!ISCx1!!ISCx0!!Verhalten
|-
|0||0|| Ein '''LOW-Pegel''' loest einen Interrupt aus.
|-
|0||1|| Ein '''Logik-Wechsel''' loest einen Interrupt aus.
|-
|1||0|| Eine '''fallende Flanke''' loest einen Interrupt aus.
|-
|1||1|| Ein '''steigende Flanke''' loest einen Interrupt aus.
|-
|}

oder kurz

{| class="wikitable"
|-
!ISCx1!!ISCx0!! INTx reagiert auf ...
|-
|0||0|| 0-Pegel
|-
|0||1|| Pegelwechsel
|-
|1||0|| fallende Flanke
|-
|1||1|| steigende Flanke
|-
|}
===Anwendungsbeispiel===
Immer mal wieder habe ich gelesen, dass ein Taster am Interrupt eine schlechte Idee sei. Wegen Tastenprellen und so. Manche behaupten sogar es ginge gar nicht. Hier der Gegenbeweis. Funktioniert bei mir völlig zufriedenstellend. Hier benutze ich die ISR-Variante. Später werde ich weiter unten auch mal eine Gegenüberstellung mit der attachInterrupt-Variante ergänzen.

<syntaxhighlight lang="c" line>
#include <Arduino.h>
#include <avr/interrupt.h> // fuer ISR Makro

const byte ledPin = 5;
volatile byte ledState = LOW;
byte lastledState;

const byte interruptPin = 3;

ISR (INT1_vect){
EIFR|=(1<<INTF1); // Interrupt Flag zu Sicherheit schon mal loeschen
EIMSK&=~(1<<INT1); // Interrupt abschalten
ledState = !ledState;
}

void setup(){
Serial.begin(115200); // vielleicht brauche ich es

pinMode(ledPin, OUTPUT); // LED-Anschluss auf Ausgang
digitalWrite(ledPin, LOW); // LED ausschalten

pinMode(interruptPin, INPUT); // dies ist nicht zwingend notwendig, der Interrupt funktioniert auch im Output-Mode

EICRA |= (1<<ISC11); // auf fallende Flanke reagieren (Der Taster tastet nach GND über einen Pullup-Widerstand.)
EIMSK |= (1<<INT1); // INT1-Interrupt einschalten
}

void loop(){
if (lastledState!=ledState){
digitalWrite(ledPin, ledState);
delay(200); // entprellen
EIFR|=(1<<INTF1); // Interruptflag (nochmal) loeschen
EIMSK|=(1<<INT1); // Interrupt wieder einschalten
lastledState=ledState; // Veraenderung merken
}
}
</syntaxhighlight>

Es sei hier bemerkt, dass innerhalb einer Interruptroutine (ISR) z.B. kein delay() und millis() funktioniert. Sobald man etwas nutzt was auch Interrupts benutzt ist der Ärger mit einprogrammiert. Am besten programmiert man nach dem Motto:

Nur das Notwendigste erledigen und direkt wieder raus, d.h. am besten nur Variablen setzen und keine Unterroutinen.

Wenn ich zeitkritische Routinen geschrieben habe, bin ich auch schon mal auf Inline-Assembler ausgewichen, habe Taktzyklen der Opcodes gezählt und die Gesamtlaufzeit durch I/O-Pin-Trigger auf einem Oszi nachgemessen:-)

==PCINT0-23==
TODO

==Request for Comments==

<comments />

Kernel Panic

2026-07-31T15:53:58Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

==Kernel Panic Failed to execute /init (error -2)==
Heute war es mal wieder soweit. Nach einem Kernelupdate (openSUSE Leap 15.2 12/2020) ist der Rechner nicht mehr hochgefahren und zeigte, folgte Fehlermeldung.

[[Datei:Kernel Panic Fehler.jpg |400px]]

Da es ja Kernel Panic und nicht User Panic heißt, hier die Auflösung:

===Schritt 1: CD/DVD Boot in das rescue System===
Geht natürlich auch mit jedem anderen Livesystem. Hauptsache man kann irgendwie auf die Boot-Festplatte zugreifen.

===Schritt 2: root einloggen===
Bei openSUSE gibt es für 'root' kein Passwort. Erst mal umschauen und die (Boot-)Partition der Boot-Festplatte finden. Das ist die Partition in der sich das Verzeichnis /boot befindet. In der Regel befindet sich dieses Verzeichnis im 'normalen' root-Verzeichnis. Es besteht aber auch die Möglichkeit, dass /boot sich in einer eigenen Partition befindet. Der Grund soll hier einmal außen vor bleiben.

===Schritt 3: mount Partition===
lsblk
Als Ergebnis erhält man eine Übersicht aller Laufwerke, die z.Z. am System angeschlossen sind. Es empfiehlt sich zumindest alle USB-Laufwerke für die nachfolgenden Schritte abzuziehen. Wer ganz auf Nummer sicher gehen will sollte auch an alle internen Festplatten außer der Bootplatte den Stromstecker ziehen. Damit braucht man sich erst mal keine Gedanken darüber zu machen wie die Bootreihenfolge im BIOS oder Grub hinterlegt ist. Nicht dass man aus lauter Panic auf der falschen Festplatte arbeitet.
Bei meinen System liegt /boot im root-Verzeichnis der Hauptpartition (/dev/sda2). Für das Mounten kann man sich ein eigenes Verzeichnis (z.B. /hauptplatte ) anlegen oder einfach /mnt nehmen.

mount /dev/sda2 /mnt

Nach dem Mount mit

cd /mnt

ins Verzeichnis wechsel und sich mit ll (ls -l) den Inhalt anzeigen lassen. Wenn der Mount erfolgreich war sieht man jetzt den Inhalt der Hauptpartition, also etwa sowas

===Schritt 4: chroot===
Jetzt muss man das System 'austricksen' und so tun als wäre das Verzeichnis unter /mnt das Hauptverzeichnis. Dies kann man mit dem Befehl 'chroot' erreichen. Bevor man aber aber loslegt noch ein paar Orientierungshilfen. Mit dem Befehl 'cd /' gelangt man ins Root-Verzeichnis. Nicht zu verwechseln mit dem Heimatverzeichnis des Users 'root' unter /root. Zur Kontrolle kann man mit
cd /
ll
sich nochmal das Hauptverzeichnis des Rescue/Live-System anschauen. Jetzt kommen noch ein paar Befehle der Vorbereitung von chroot.
mount -t proc --bind /proc /mnt/proc/
mount --rbind /sys /mnt/sys/
mount --rbind /dev /mnt/dev/
Manchmal findet man in anderen Anleitungen auch die mount-Option --bind anstatt --rbind. rbind hat aber den Vorteil das auch alle eventuellen Submounts gleich mit neu verbunden werden.
Archlinux spricht [https://wiki.archlinux.org/index.php/chroot#Using_arch-chroot hierzu] eine Warnung aus.
Die Angabe des Filesystem-Typs -t proc wird normal automatisch richtig erkannt und kann entfallen. Wenn man ein anderes Verzeichnis zum Mount der Bootplatte erstellt hat muss natürlich /mnt entsprechend angepasst werden.
Allgemein also

mount -t proc --bind /proc /<verzeichnis>/proc/
mount --rbind /sys /<verzeichnis>/sys/
mount --rbind /dev /<verzeichnis>/dev/

Bei proc ist --bind scheinbar ausreichend. Die 'normale' mount-Situation sieht so aus.
Jetzt sind die für den Kernel die wichtigen Arbeits-Verzeichnisse umgebogen und jetzt können wir mit
chroot /mnt/
das ganze System so umstellen ('''ch'''ange '''root''' Verzeichnis), dass das neue Root-Verzeichnis bei /mnt/sda2 beginnt. Das kann man auch leicht überprüfen wenn man jetzt ein 'cd / && ll' macht sind man den Inhalt der Root-Verzeichnisses der Boot-Partition.
Das Rescuesystem ist jetzt 'unsichtbar'.
===Schritt 5: mkinitrd===
Jetzt wechseln wir in das /boot-Verzeichnis. Dort findet man alle derzeit verfügbaren Kernels und deren Begleitdateien. Bei mir sieht man derzeit 4 verschiedene Kernels

<div class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">ll /boot</div>
<div class="mw-collapsible-content">
worker:/boot # ll
total 183308
-rw-r--r-- 1 root root 65 Nov 11 18:46 .vmlinuz-5.3.18-lp152.50-default.hmac
-rw-r--r-- 1 root root 65 Nov 11 18:34 .vmlinuz-5.3.18-lp152.50-preempt.hmac
-rw-r--r-- 1 root root 65 Dec 5 09:58 .vmlinuz-5.3.18-lp152.57-default.hmac
-rw-r--r-- 1 root root 65 Dec 5 10:41 .vmlinuz-5.3.18-lp152.57-preempt.hmac
-rw-r--r-- 1 root root 4610647 Nov 11 17:53 System.map-5.3.18-lp152.50-default
-rw-r--r-- 1 root root 4612190 Nov 11 17:50 System.map-5.3.18-lp152.50-preempt
-rw-r--r-- 1 root root 4605295 Dec 5 09:12 System.map-5.3.18-lp152.57-default
-rw-r--r-- 1 root root 4606747 Dec 5 09:40 System.map-5.3.18-lp152.57-preempt
-rw-r--r-- 1 root root 1725 Aug 26 22:47 boot.readme
-rw-r--r-- 1 root root 228385 Nov 11 17:30 config-5.3.18-lp152.50-default
-rw-r--r-- 1 root root 228416 Nov 11 17:29 config-5.3.18-lp152.50-preempt
-rw-r--r-- 1 root root 228385 Dec 5 08:59 config-5.3.18-lp152.57-default
-rw-r--r-- 1 root root 228416 Dec 5 09:00 config-5.3.18-lp152.57-preempt
drwxr-xr-x 2 root root 4096 Nov 24 23:36 dracut
drwxr-xr-x 5 root root 4096 Jan 4 15:04 grub2
lrwxrwxrwx 1 root root 30 Dec 31 10:13 initrd -> initrd-5.3.18-lp152.57-default
-rw------- 1 root root 8767144 Nov 15 13:20 initrd-5.3.18-lp152.19-default
-rw------- 1 root root 12011868 Jul 16 22:11 initrd-5.3.18-lp152.26-default.bak
-rw------- 1 root root 12166716 Jan 4 14:55 initrd-5.3.18-lp152.50-default
-rw------- 1 root root 12165192 Jan 4 14:55 initrd-5.3.18-lp152.50-preempt
-rw------- 1 root root 12166528 Jan 4 14:55 initrd-5.3.18-lp152.57-default
-rw------- 1 root root 12165256 Jan 4 14:56 initrd-5.3.18-lp152.57-preempt
-rw-r--r-- 1 root root 1255444 Nov 11 17:56 symtypes-5.3.18-lp152.50-default.gz
-rw-r--r-- 1 root root 1256334 Nov 11 17:53 symtypes-5.3.18-lp152.50-preempt.gz
-rw-r--r-- 1 root root 1255444 Dec 5 09:15 symtypes-5.3.18-lp152.57-default.gz
-rw-r--r-- 1 root root 1256334 Dec 5 09:46 symtypes-5.3.18-lp152.57-preempt.gz
-rw-r--r-- 1 root root 432816 Nov 11 17:56 symvers-5.3.18-lp152.50-default.gz
-rw-r--r-- 1 root root 433040 Nov 11 17:53 symvers-5.3.18-lp152.50-preempt.gz
-rw-r--r-- 1 root root 432948 Dec 5 09:14 symvers-5.3.18-lp152.57-default.gz
-rw-r--r-- 1 root root 433173 Dec 5 09:45 symvers-5.3.18-lp152.57-preempt.gz
-rw-r--r-- 1 root root 484 Nov 11 17:56 sysctl.conf-5.3.18-lp152.50-default
-rw-r--r-- 1 root root 377 Nov 11 17:53 sysctl.conf-5.3.18-lp152.50-preempt
-rw-r--r-- 1 root root 484 Dec 5 09:14 sysctl.conf-5.3.18-lp152.57-default
-rw-r--r-- 1 root root 377 Dec 5 09:45 sysctl.conf-5.3.18-lp152.57-preempt
-rw-r--r-- 1 root root 13903220 Nov 11 18:00 vmlinux-5.3.18-lp152.50-default.gz
-rw-r--r-- 1 root root 13997555 Nov 11 17:56 vmlinux-5.3.18-lp152.50-preempt.gz
-rw-r--r-- 1 root root 13883322 Dec 5 09:19 vmlinux-5.3.18-lp152.57-default.gz
-rw-r--r-- 1 root root 13977866 Dec 5 09:51 vmlinux-5.3.18-lp152.57-preempt.gz
lrwxrwxrwx 1 root root 31 Dec 31 10:13 vmlinuz -> vmlinuz-5.3.18-lp152.57-default
-rw-r--r-- 1 root root 9048240 Nov 11 18:46 vmlinuz-5.3.18-lp152.50-default
-rw-r--r-- 1 root root 9109680 Nov 11 18:34 vmlinuz-5.3.18-lp152.50-preempt
-rw-r--r-- 1 root root 9035952 Dec 5 09:58 vmlinuz-5.3.18-lp152.57-default
-rw-r--r-- 1 root root 9093296 Dec 5 10:41 vmlinuz-5.3.18-lp152.57-preempt
</div></div>

Eigentlich sind es nur 2 Kernels 5.3.18-lp152.50 vom 11. November und der neuere vom 5. Dezember, der jetzt die Probleme verursacht.
Die default und Preemp Variante unterscheiden sich nur in einer 'Kleinigkeit':
The kernel for arm64 and x86_64 architectures that supports CONFIG_PREEMPT. Its main purpose is to serve workloads with a higher demand on smaller latencies than the default kernel in average.

Jetzt kann man '''mkinitrd''' ausführen und damit die '''init'''iale '''R'''am'''D'''isk (initrd) neu anlegen (make). Allerdings kamen hier eine Unmenge an Fehlermeldungen.
Für das Erstellen der initrd greift mkinitrd auf das Programm dracut zurück. Die Fehlermeldungen hatten alle das gleiche Muster:

dracut-install: ERROR: failed to install '/usr/bin/ldd:' for '/bin/sh' for '/usr/bin/udevadm'

Die Lösung lag in einer nicht vorhanden Verbindung zu bash. Der folgende Screenshot zeigt neben dem Fehler auch gleich die Lösung.

[[Datei:Kernel Panic Loesungsschritt ldd bash.jpg | 400px]]

bash liegt in /bin und lld sucht in /usr/bin

Ein Softlink bringt die Lösung.

cd /usr/bin && ln -s /bin/bash bash

mkinitrd lief danach ohne Fehlermeldung durch.

===Schritt 6: reboot===

Noch eine Kleinigkeit: Ein 'schutdown -r now' in der chroot-Umgebung gelingt nicht, als erst chroot mit 'exit' verlassen.

Mission accomplished!

==Quellen==
Ähnliches Problem, allerdings etwas komplexer da die Platte verschlüsselt war.[https://forums.opensuse.org/showthread.php/547270-SOLVED-kernel-panic-Failed-to-execute-init-no-working-init-found-after-update-encrypted-luks-lvm]

[https://wiki.archlinux.de/title/Chroot chroot]

[https://de.wikipedia.org/wiki/Initrd initrd]

[https://de.wikipedia.org/wiki/Dracut_(initramfs) dracut]

<comments />

Ricoh Aficio SG2100N CUPS

2026-07-31T15:53:57Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeins=
Der Drucker ist ein Gel-Drucker. Das Schwarz das er druckt, scheint "blickdichter" als das Druckergebnis meines Laserdruckers oder Tintenspritzer.
Daher gebe ich im eine Chance als Drucker fuer meine "PCB-Folien".

=Treiberinstallation=
Unter [http://support.ricoh.com/bb/html/dr_ut_e/re1/model/sg2100n/sg2100n.htm?lang=de Windows 10 (64 bit)] war das Installieren problemlos.

Fuer Cups war es schon etwas aufwendiger. Auf der Suche nach einem passenden Treiber wurde auf mehreren Seite darauf hingewiesen, dass der Drucker in Japan unter dem Namen SG2010L verkauft wird. Der Treiber sollte also auch laufen. Eine Version fuer Ubuntu 20.04LTS habe ich [http://support.ricoh.com/bbv2/html/dr_ut_d/ipsio/model/sg_2010l/sg_2010l.htm hier] gefunden. Die Datei mit dem Namen ipsiosg_4.5.1-0_amd64.deb habe ich heruntergeladen. Einige Seiten beschreiben einen Weg über die Installation des deb-Pakets und einem "Patch-Build".

Mein Weg war im Nachhinein recht simpel. Erst das .deb-File mit Ark entpacken. Das darin File data.tar.xz ebenfalls entpacken. Die Pfade /usr/share und /usr/lib/ stimmen (erstaunlicherweise) bei meiner OpenSuse 15.3 ueberein. Also einfach den Inhalt von data.tar.xz nach /usr/share bzw. lib kopieren.

Die fuer die Installation des Drucker unter Cups notwendige .ppd-Datei befindet sich unter /usr/share/ppd/ricoh und ist für den SG2100N die Datei ri6162d3.ppd.gz.

That's all. Happy Printing.

==Request for Comments==

<comments />

DJI Osmo Pocket

2026-07-31T15:53:56Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

Hier sammele ich alles was die Arbeit mit dem DJI Osmo Pocket für (mich) erleichtert.

*[https://www.youtube.com/watch?v=APAQX-ZBE4o Grundlagen Einführung]

==Cheat Sheet==

TODO

==Schnittstellen==
===USB-C (Unterseite)===

Die Kommunikationsmöglichkeiten des Ports sind vielfältig. Siehe dazu die [https://www.usb.org/sites/default/files/USB%20Type-C%20Spec%20R2.0%20-%20August%202019.pdf Spezifikation]. Ein weiteres sehr hilfreiches Dokument ist eine [https://cdn.sparkfun.com/assets/e/b/4/f/7/USB-C_Datasheet.pdf Annotation Note (AN 1953) von Microchip]. Danke dafür. Und wie so oft sind [https://www.heise.de/ct/artikel/USB-C-Der-Alleskoenner-3836662.html Artikel von heise] fuer mich ein Gewinn.

Beim Verbinden mit einem PC wird die eingelegte Speicherkarte als Laufwerk (nach Bestätigung) durchgereicht.
Ein Zugriff mit dazwischengeschaltetem WLAN-Modul ist/scheint nicht moeglich.

lsusb -> ID 070a:4026 Oki Electric Industry Co., Ltd

lsscsi -> disk DJI Osmo Pocket 1000 /dev/sdg

Ein Aergernis was einem in den Foren oft begegnet ist, dass ein externes Micro nicht gemeinsam mit dem WLAN-Modul betrieben werden kann.

Sobald man eine WLAN-Verbindung mit dem OSMO herstellt, schaltet er sich aus und die LED blinkt (4kurz-Pause-Loop).
Beim zweiten mal hat der WLAN-Client eine Adresse (192.168.2.128/24) bezogen.
Der OSMO selbst hat die Adresse 192.168.12.1

Nmap scan report for 192.168.2.1
Host is up (0.0029s latency).
MAC Address: 60:60:1F:XX:XX:XX (SZ DJI Technology)

==Reverse Engineering==

[https://github.com/fvantienen/dji_rev RevEngine-Linkliste]

==Cosmostreamer==

[https://cosmostreamer.com/products/pocketosmo/ Cosmostreamer Homepage]

TODO

==Request for Comments==

<comments />

(FHEM) KNX Siemens LOGO

2026-07-31T15:53:55Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

==Ausgangslage==
Im Heizungskeller habe ich u.a. eine (alte) nur von der Heizungssteuerung angesteuerte (an/aus) Heizungspumpe und eine neue Pumpengruppe für die Fußbodenheizung in 2 Räumen.
Ich konzentriere mich in diesem Artikel auf die Nutzung der Siemens LOGO (0BA5) zur Ansteuerung der beiden Pumpen. Die Integration in FHEM, die Aktor- und Sensor-Hardware und die Beschreibung der Gesamtheizungsanlage folgen in eigenen Artikeln.

==Siemens LOGO!==
Die LOGO! ist eine Hassliebe. Ich hatte sie mir mal vor Jahren (daher noch eine 0BA5) für das Selbststudium angeschafft und jetzt sollte sie nutzbringend als Pumpenansteuerung Einsatz finden.
===Fakten LOGO!===
Sie hat am Basismodul (24V-Variante) 8 digitale, davon 2 analog nutzbare, Eingänge und 4 Relaisausgänge. Das Programmierkabel ist noch mit einer seriellen Schnittstelle (RS232) ausgestattet. Die zur Programmierung notwendige Software LOGO!Soft Comfort V5 ist noch aus der WinXP-Ära.
Um meine Anbindung sinnvoll zu realisieren habe ich noch eine EIB/KNX-Modul und ein analoges Ausgangsmodul aufgesteckt.

===Fakten Heizung===

Sensorik

* Hin-/Rücklauf Hauptheizkreis (2 Temperaturmessungen)
* Hin-/Rücklauf Fußbodenheizung (2 Temperaturmessungen)
* Option "physikalischer" Sollwertsteller (Auf/Ab 2 Eingänge) für Vorlauf-Temperatur der Fußbodenheizung
* Option "physikalische" Anbindung der Pumpenanforderung (1 Eingang) der Heizungssteuerung

Aktorik

* Pumpe Hauptheizkreis (1 Ausgang)
* Pumpe Fußbodenheizung (1 Ausgang)
* 3-Wegenventil (Temperatureinstellung Vorlauf Fußbodenheizung über Rücklauf-Bypass) (2 Ausgänge)
* Spannungsversorgung EIB/KNX-Ventile der Fußbodenheizung (1 Ausgang)

Wenn man das jetzt zusammenzählt, benötige ich:

* 4 Temperaturmesseingänge (Zonk!)
* 3 Digitale Eingänge
* 5 Schaltausgänge 230V (Zonk! zum Zweiten)

===Workaround 1===

Die alte Heizungspumpe versehe ich dann gerade auch mal mit einer Leistungsansteuerung. Die Leistungsansteuerung (Selbstbau) verfügt am Eingang über eine 0-10V (entspricht 0-100%) Schnittstelle und am Ausgang über ein Wellenpaketsteuerung. Somit kann ich die Hauptheizkreispumpe analog ansteuern und die restelichen 4 Schaltausgänge reichen dann für die Ansteuerung der Pumpengruppe (Fußbodenheizung)

===Workaround 2===

Die LOGO! hat in der 0BA5-Ausführung nur zwei analoge Eingänge (I7 und I8). Und jetzt!

====Lösung 1====
Noch ein analoges Eingangsmodul kaufen. Abgesehen von Tatsache, dass dann die Hutschiene nicht mehr breit (Spannungsversorgung, LOGO, KNX, ANALOG OUT + ANALOG IN) genug ist, habe ich das Problemchen durch Verlegung der Spannungsversorgung in die zweite Reihe gelöst, aber auch die damit verbunden Kosten, knapp 100 Euro für 2 PT100/1000, sind mir dann doch zu viel. Gebraucht zu suchen hatte ich keine Lust, also habe ich diesen Weg erst mal aufgegeben.

====Lösung 2====
Ein Mikrocontroller (ATMEL/PIC) für die Temperaturmessung einsetzen und die Daten "aufbereitet" an die LOGO! übergeben. Ab wie bekommt an die Daten in die Steuerung. Ein Weg wäre die Analogwerte über mehrere EIB-Objekte bereitzustellen. Der andere Weg wäre eine Art Multiplexing für die beiden analogen Eingänge. Das setzt aber voraus, dass ich die beiden analogen Eingangswerte von I7 und I8 auf 4 (oder mehr) speicherbare Analogwerte in der LOGO übertragen kann. Ich habe beiden Wege realisiert und setze sie kombiniert ein.
Siehe dazu den Artikel mehrere analoge Werte mit der LOGO! verarbeiten.

===LOGO Programm V0.9===

<pdf width="1000" >File:LOGO!Soft_Comfort_-_Heizung.pdf</pdf>

(Pylontech) Consolenanschlusskabel

2026-07-31T15:53:54Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Um die Batterie-Informationen direkt, ohne Umweg auslesen zu koennen, nutze ich den Consolen-Port der US[2,3,5]000(C).

Dummerweise wurde der Anschluss vom US2000 zum US3000 von RJ-14 (oft falsch RJ-11) auf RJ-45 gewechselt.
Haengt die US2000 im Verbund mit einem US3000/US5000 kann man auf das RJ-14-Kabel verzichten, da die Konsolen-Kommunkation ueber den Master laeuft.
Nur wenn man eine US2000 alleine direkt auslesen will, benoetigt man ein weiteres Kabel.

Oft werden bei einem RS232-Verbindungskabel, die Kabel mit TXD und RXD beschriftet. Das ist irrefuehrend, da die Anschluesse bei DDE und DÜE ueber Kreuz angeschlossen werden.
Aus RXD/TXD-DDE wird dan TXD/RXD-DÜE.

Es wird auch oft so getan, als koennte man die Anschluesse von DÜE und DDE einfach so miteinander verbinden. Dem ist nicht so! Die Spannungspegel der RS232-Schnittstelle liegen bei bis zu +-15V!!!

Folgende Zuordnung erklaert warum, es doch funktionieren kann.

*Logisch 0 -> Space -> zwischen +3 V und +15 V
*Logisch 1 -> Mark -> zwischen -3 V und -15 V

Solange, die Pegel von DDE und DÜE auf einander abgestimmt und/oder tolerant sind funktioniert es in der Regel.
Bei 3,3 V kann aber ein zu langes Kabel schon fuer Probleme sorgen.

=Pinout RJ-14 (US2000, ... alle nicht C-Varianten)=

Der ConsolePort ist eine RJ-14 (6P4C) (oft falsch als RJ-11 (6P2C) angegeben) Port mit RS232-Protokoll. Der ConsolePort des US3000C ist eine R-J45 (8P8C) Port.
Zu achten ist bei den Bezeichnungen RXD und TXD auf die Seite des Anschlusses. Beim Anschluss der RS232-Kommunikation-Partner werden RXD und TXD ueber Kreuz angeschlossen, was zu einem Verstauchen der Anschlussbezeichnungen fuehrt. RXD und TXD bei einem Kabel nur einmal anzugeben ist mehr als irrefuehrend. Vielmehr muss es auf jeder Stecker-/Buchsenseite angegeben werden.

{| class="wikitable"
!colspan="4"|Pinbelegung RJ-14 (RJ-11)
|-
|Pin RJ-14||Pin RJ-11||RS232 Protokoll||Belegung
|-
|1||NC||-||rowspan="5"|[[Datei:RJ12 6P6C.png|150px]]
|-
|2||1||GND
|-
|3||2||RXD
|-
|4||3||TXD
|-
|5||4||GND
|-
|6||NC||-||Stecker von vorne
|}

=Pinout RJ-45 (US3000C, ... alle C-Varianten)=

Der ConsolePort ist eine RJ-14 (6P4C) (oft falsch als RJ-11 (6P2C) angegeben) Port mit RS232-Protokoll. Der ConsolePort des US3000C ist eine R-J45 (8P8C) Port.
Zu achten ist bei den Bezeichnungen RXD und TXD auf die Seite des Anschlusses. Beim Anschluss der RS232-Kommunikation-Partner werden RXD und TXD ueber Kreuz angeschlossen, was zu einem Verstauchen der Anschlussbezeichnungen fuehrt. RXD und TXD bei einem Kabel nur einmal anzugeben ist mehr als irrefuehrend. Vielmehr muss es auf jeder Stecker-/Buchsenseite angegeben werden.

{| class="wikitable"
!colspan="4"|Pinbelegung RJ-14 (RJ-11)
|-
|Pin RJ-45||RS232 Protokoll||Belegung
|-
|1||-||rowspan="7"|[[Datei:RJ45 8P8C.png|200px]]
|-
|2||-
|-
|3||TXD
|-
|4||+5 V bis +12 V fuer WakeUp
|-
|5||GND fuer WakeUp
|-
|6||RXD
|-
|7||-
|-
|8||GND||Stecker von vorne
|-
|}

Das WakeUpSignal (Spannungspegel) soll >= 0,5 Sekunden anliegen und nach dem Starten dauerhaft "Aus" sein. Der (notwendige) Strom liegt szwischen 5 und 15 mA.

=Pinout RS232=

[[Datei:RS232 Pinout PC.png|400px]]

In der Regel werden nur RXD,TXD und GND benutzt.

=Verbindungskabel=

Aus einem alten Cisco-Kabel.

[[Datei:CiscoConsolenKabelRJ45.jpg|200px|CiscoConsolenKabelRJ45]]

Verdrahtung

[[Datei:Pylontech US3000C DSUB RJ45.png|210px|Pylontech US3000C DSUB RJ45]] [[Datei:Pylontech US2000BPL DSUB RJ14.png|200px]]

Und nachdem die Verkabelung klappt, geht's mit der [[(Pylontech) Consolen-Kommunikation]]Kontaktaufnahme weiter.

(FHEM) 00 MQTT.pm

2026-07-31T15:53:53Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=00_MQTT.pm=
[[(FHEM) MQTT#Module im Detail| Zurueck Uebersicht]]

Ein einzelnes MQTT-Gerät kann mehrere MQTT_DEVICE, MQTT_GENERIC_BRIDGE Clients und (veraltete) MQTT_BRIDGE Clients bedienen. Jedes MQTT_DEVICE fungiert als Brücke zwischen einem Fhem-Gerät und mqtt.
Hinweis: Dieses Modul basiert auf Net::MQTT, das zuerst von CPAN installiert werden muss.

Das Modul MQTT fungiert als Verbindung zwischen FHEM und einem MQTT Broker (Server) und repräsentiert ein MQTT Gateway. Die durch die Module MQTT_DEVICE oder (veraltet!) MQTT_BRIDGE (In neuen Installationen soll das Modul MQTT_GENERIC_BRIDGE bevorzugt werden.) repräsentierten Client-Geräte sind gesondert anzulegen.

Nebenbemerkung: Genau wie in der Netzwerktechnik gehen scheinbar hier die Begriffe Gateway und Bridge munter durcheinander. Ein Gateway liegt im ISO/OSI und im TCP/IP auf verschiedenen Schichten!
Weiterhin scheint es mit diesem Modul Probleme zu geben wenn der Broker nicht auf dem gleichen Server liegt, also die ip nicht localhost oder 127.0.0.1 ist. Aber selbst da gibt es Probleme.
Solange ich keine triftigen Grund kenne werde ich auf den Einsatz dieses Moduls verzichten.

Es muss für jedes MQTT-Gateway ein Server (Broker) eingerichtet und erreichbar sein.

Wenn also von einem MQTT-Gateway die Rede ist, ist damit ein FHEM-Device vom Typ MQTT (Modul 00_MQTT.pm)gemeint.

'''Define'''
define <name> MQTT <ip:port> [<username>] [<password>]

'''Set'''
set <name> connect
set <name> disconnect
set <name> publish [qos:?] [retain:?] <topic> <message>

'''Get'''
version (steht nur im Programmcode, tauscht sonst nirgends auf)
'''Readings'''
 
'''Attributes'''
keep-alive
attr <name> last-will [qos:?] [retain:?] <topic> <message>
attr <name> client-id client id
on-connect
on-disconnect
on-timeout
privacy 0|1

=Erlaeuterungen=

=Hindernisse/Hinweise==
==#1==
Clients: MQTT_DEVICE und MQTT_BRIDGE

Abhaengigkeiten: DevIo.pm

Wenn eine 'Cannot load module MQTT' erscheint fhelt wohl das 'Net::MQTT'

cpan install Net::MQTT

FHEM#>restart

Fehlermeldung:

<pre>
2022.08.07 20:02:53.913 1: reload: Error:Modul 00_MQTT deactivated:
Can't locate Net/MQTT/Constants.pm in @INC (you may need to install the Net::MQTT::Constants module) (@INC contains: ./lib ./FHEM . /usr/lib/perl5/site_perl/5.26.1/x86_64-linux-thread-multi /usr/lib/perl5/site_perl/5.26.1 /usr/lib/perl5/vendor_perl/5.26.1/x86_64-linux-thread-multi /usr/lib/perl5/vendor_perl/5.26.1 /usr/lib/perl5/5.26.1/x86_64-linux-thread-multi /usr/lib/perl5/5.26.1 /usr/lib/perl5/site_perl ./FHEM/lib) at ./FHEM/00_MQTT.pm line 42.
BEGIN failed--compilation aborted at ./FHEM/00_MQTT.pm line 42.

2022.08.07 20:02:53.913 0: Can't locate Net/MQTT/Constants.pm in @INC (you may need to install the Net::MQTT::Constants module) (@INC contains: ./lib ./FHEM . /usr/lib/perl5/site_perl/5.26.1/x86_64-linux-thread-multi /usr/lib/perl5/site_perl/5.26.1 /usr/lib/perl5/vendor_perl/5.26.1/x86_64-linux-thread-multi /usr/lib/perl5/vendor_perl/5.26.1 /usr/lib/perl5/5.26.1/x86_64-linux-thread-multi /usr/lib/perl5/5.26.1 /usr/lib/perl5/site_perl ./FHEM/lib) at ./FHEM/00_MQTT.pm line 42.
BEGIN failed--compilation aborted at ./FHEM/00_MQTT.pm line 42.
</pre>

Loesung:
Leider habe ich noch keinen Hinweis dazu erhalten welche der 3 Net::MQTT Libraries die richtige ist.

cpan[5]> i /Net-MQTT/
Distribution BEANZ/Net-MQTT-1.163170.tar.gz
Distribution JUERD/Net-MQTT-Simple-1.26.tar.gz
Distribution KRENZKE/Net-MQTT-Simple-Auth-0.002.tar.gz
3 items found

cpan[6]> install BEANZ/Net-MQTT-1.163170.tar.gz

Nach dem Installieren war die Definition des Beispiels (s. u.) erfolgreich.

Das MQTT-modul macht nach einem Reconnect einen Retransmit aller noch nicht bestätigten (acknowledged bzw. completet) Messages.

=Beispiele=

[[Datei:Define MQTT.png|mini]]

[[Datei:Define MQTT Attribute.png|mini]]

define 00_MQTT_Test MQTT

Erstmal kam eine Fehlermeldung. Loesung siehe oben.

Beim zweiten Anlauf war die Definition erfolgreich, obwohl hier der notwendige Parameter der IP des MQTT-Server (Broker) weggelassen wurde.

Die 'Raw definition' sieht so aus:

defmod 00_MQTT_Test MQTT

setstate 00_MQTT_Test disconnected
setstate 00_MQTT_Test 2022-08-07 21:08:16 state disconnected

Etwas deutlicher im FHEM-Wiki:

define meinMQTTGW MQTT <Broker-IP>[:<Broker-Port>]

Allerdings fehlt hier der Hinweis auf die optionalen Parameter <username> und <password>.

Warum man bei der Broker-IP 127.0.0.1 den Vorzug vor localhost geben soll, wenn der MQTT-Server auf dem gleichen Rechner laeuft, erschlieszt sich mir nicht.

define 00_MQTT_test MQTT 127.0.0.1

<pre>
2022.08.07 22:54:15.008 3: Opening 00_MQTT_Test device 127.0.0.1
2022.08.07 22:54:15.008 1: 00_MQTT_Test: Can't open 127.0.0.1: No such file or directory
</pre>

defmod 00_MQTT_Test MQTT localhost:1883

<pre>
2022.08.07 23:02:18.153 3: Opening 00_MQTT_Test device localhost:1883
2022.08.07 23:02:18.157 3: 00_MQTT_Test device opened
2022.08.07 23:03:18.633 3: Opening 00_MQTT_Test device 127.0.0.1:1883
2022.08.07 23:03:18.637 3: 00_MQTT_Test device opened
</pre>

Die Warnung von oben hat sich bestaetigt. Wenn man in DEF zwischen localhost und 127.0.0.1 wechselt und mit 'set disconnect' und 'set connect' den STATE beobachtet, ergibt sich folgende Meldung:

<pre>
2022.08.07 23:05:42.513 1: 127.0.0.1:1883 disconnected, waiting to reappear (00_MQTT_Test)
2022.08.07 23:05:45.503 1: 127.0.0.1:1883 reappeared (00_MQTT_Test)
2022.08.07 23:05:45.516 1: 127.0.0.1:1883 disconnected, waiting to reappear (00_MQTT_Test)
2022.08.07 23:05:46.003 1: localhost:1883 reappeared (00_MQTT_Test)
</pre>

Mit 'set <name> publish [qos:?] [retain:?] <topic> <message>' kann man Messages absetzen.
qos meint Quality of Service und retain meint das die Nachricht aufbewahrt werden soll.
qos kann die Werte [0,1,2] annehmen. QOS ist im Publish Fixed Header in 2 Bit codiert. Eine vierte Stufe (3) ist denkbar aber im MQTT-Standard nicht implementiert. Das Retain ist ein 1-Bit Flag im Header.
Um eine Nachricht die mit retain:1 verschickt wurde wieder zu loeschen ist eine Nachricht wieder mit retain:1, dem gleiche Topic und dem NULL_String zu senden.

set <MQTT> publish retain:1 <topic> <"" oder ''>

==Attribute==
Die Attribute kann man in 3 Gruppen teilen.

===Gruppe 1: MQTT spezifisch===
keep-alive [[MQTT#Ping Request/Response|siehe meine Erlaeuterung dazu]]

attr <name> last-will [qos:?] [retain:?] <topic> <message> [[MQTT#Last Will|siehe meine Erlaeuterung dazu]]

Ich habe grosze Zweifel, dass hier die beiden Attribute richtig implementiert sind. Stellt man zum Beispiel keep-alive auf 1 (Sekunde) dann wird der Client auf dem Server nicht nach 1 Sekunde disconnectet, sondern der das connection-reading laeuft im Sekundentakt. ???

===Gruppe 2: Verhalten des FHEM-DEVICES===
attr <name> '''client-id''' client id

Mit diesem Attribut kan die Client ID mit der sich das FHEM-DEVICE am MQTT-Server anmeldet geaendert werden. Wenn das Attribut nicht gesetzt ist, wird die FUUID als Client ID genommen.
<pre>
1659906662: New connection from 127.0.0.1:39670 on port 1883.
1659906662: New client connected from 127.0.0.1:39670 as 62f02811-f33f-7372-6a3f-c658ba3431097541 (p1, c1, k60).
1659906854: Client 62f02811-f33f-7372-6a3f-c658ba3431097541 disconnected.
1659906854: New connection from 127.0.0.1:39722 on port 1883.
1659906854: New client connected from 127.0.0.1:39722 as clientid (p1, c1, k60).
</pre>

attr <name> '''on-connect''' {Perl-expression} <topic> <message>

attr <name> '''on-disconnect''' {Perl-expression} <topic> <message>

attr <name> '''on-timeout''' {Perl-expression}

Im Prinzip sind alle drei Attribute gleich. Bei 'on-connect' und 'on-disconnect' wird eine Nachricht (<message>) an den angegebenen Topic gesendet. Die Perl-expression darf hier weggelassen werden. Bei diesen beiden Attributen ist dieser Publish sozusagen das "Gegenteil" des [[#Last Will|Last Will]] Wird die Perl-expression uebergeben wird diese nach einem connect oder disconnect zuerst ausgewertet und die Nachricht erst im Falle eines (Rueckgabe-)wertes von true, 1 oder undef, gesendet. Die folgenden Variablen werden bei der Auswertung an den Ausdruck übergeben: $hash, $name, $qos, $retain, $topic, $message.

Bei 'on-timeout' die Perl-expression wegzulassen ist dagegen sinnlos. Welcher timeout hier gemeint sein koennte muss ich noch herausfinden.

Beispiele:
attr mqtt on-connect /topic/status connected
attr mqtt on-connect {Log3("abc",1,"on-connect")} /fhem/status connected

Ein sinnvoller Einsatz der Perl-Expression ist mir noch nicht eingefallen.

===Gruppe 3: Bedeutung TODO===
privacy 0|1

=Anwendungen=
Eine sinnvolle Anwendung habe ich noch keine. Nach dem Anlegen des Devices kann man Nachrichten mit set verschicken. Ich habe bisher diesen Devicetyp nur zum Testen benutzt.

Ubiquiti UniFi Security Gateway (USG-3P) WLAN Isolate VLAN

2026-07-31T15:53:52Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Eigentlich war ich davon ausgegangen, dass durch dieses Haekchen WLAN-Clients in verschiedenen Subnetzen nur untereinander im eigenen Subnetz kommunizieren koennen. Dem ist aber nicht so, da der USG-3P mittlerweile als veraltet gilt. Er wird zwar noch fast komplett im Unifi Network 10.1.85 (Dazu muss ich auch noch einen neuen Beitrag machen.) aber die Firewallregel im Network werden nicht im System hinterlegt. Dadurch ist das Haekchen "Isolate" zeigt KEINE Wirkung.

[[File:UnifiNetwork_Isolate.png|200px]]

"Isolate Network" verhaelt sich beim USG-3P leider nicht (immer) so, wie der Name vermuten laesst.

Je nach Controller-Version (insbesondere die neueren 9.x/10.x mit einem aelteren USG) gilt:

Network Isolation verhindert primaer den Zugriff von anderen Netzwerken auf dieses Netzwerk bzw. setzt passende Firewall-Regeln.
Es ersetzt keine vollstaendige Inter-VLAN-Firewall in jeder Konstellation.
Da der USG ein aelteres Produkt ist und die aktuelle UniFi-Oberflaeche auf neuere Gateways (UXG, UDM, UCG) ausgelegt ist, werden manche Optionen nicht identisch umgesetzt.

==Vermutung==
Ich vermute, dass die GUI zwar "Isolate Network" anzeigt, der Controller diese Einstellung aber auf dem USG nicht oder nicht vollstaendig in Firewall-Regeln umsetzt. Das ist bei aelteren USG-Modellen ein bekanntes Verhalten, da neue Controllerfunktionen nicht immer vollstaendig von der alten USG-Firmware unterstuetzt werden.

Die Option "Isolate Network" ist in Network 10.x zwar vorhanden, die vollstaendige automatische Umsetzung ist aber in erster Linie fuer die neueren UniFi-Gateways (UXG, UCG, UDM usw.) vorgesehen. Auf aelteren USG-Geraeten werden neue Funktionen teilweise nicht oder nicht vollstaendig unterstuetzt. Das wird auch von Anwendern mit USG-3P berichtet. [https://www.reddit.com/r/Ubiquiti/comments/1qz51mt/how_to_check_if_usg3p_is_still_supported_in]

=Firewall-Status=
Um die aktuellen Firewallregel im USG-3P zu sehen muss man sich mit ssh auf dem Geraet anmelden.

<pre>
Welcome to EdgeOS

By logging in, accessing, or using the Ubiquiti product, you
acknowledge that you have read and understood the Ubiquiti
License Agreement (available in the Web UI at, by default,
http://192.168.1.1) and agree to be bound by its terms.

Tibb@192.168.178.1's password:
Linux USG-3P 3.10.107-UBNT #1 SMP Thu Jan 12 08:28:15 UTC 2023 mips64

___ ___ .__________.__
| | |____ |__\_ ____/__|
| | / \| || __) | | (c) 2010-2023
| | | | \ || \ | | Ubiquiti, Inc.
|______|___| /__||__/ |__|
|_/ https://www.ui.com

Welcome to EdgeOS on UniFi Security Gateway!

********************************* NOTICE **********************************
* By logging in to, accessing, or using any Ubiquiti product, you are *
* signifying that you have read our Terms of Service (ToS) and End User *
* License Agreement (EULA), understand their terms, and agree to be *
* fully bound to them. The use of CLI (Command Line Interface) can *
* potentially harm Ubiquiti devices and result in lost access to them and *
* their data. By proceeding, you acknowledge that the use of CLI to *
* modify device(s) outside of their normal operational scope, or in any *
* manner inconsistent with the ToS or EULA, will permanently and *
* irrevocably void any applicable warranty. *
***************************************************************************

********************** WARNING! ******************************
* Configuration changes made here are not persistent. *
* They will be overwritten by the UniFi Network Application *
* instance managing this device on next provision. *
* *
* Configuration MUST BE DONE in UniFi Network Application. *
****************************************************************
</pre>

Die Firewallregeln sieht man dann mit:
<pre>
Tibb@USG-3P:~$ show firewall
--------------------------------------------------------------------------------
IPv4 Firewall "AUTHORIZED_GUESTS":

Inactive - Not applied to any interfaces, zones or for content-inspection.

rule action proto packets bytes
---- ------ ----- ------- -----
10000 drop all 0 0

--------------------------------------------------------------------------------
IPv4 Firewall "GUEST_IN":

Active on (eth1.2,IN)

rule action proto packets bytes
---- ------ ----- ------- -----
3001 accept tcp_udp 0 0
condition - tcp dpt:domain

3002 accept tcp 0 0
condition - tcp dpt:https match-set captive_portal_subnets dst

3003 accept all 0 0
condition - match-set guest_pre_allow dst

3004 drop all 81 4932
condition - match-set guest_restricted dst

3005 drop all 0 0
condition - match-set corporate_network dst

3006 drop all 0 0
condition - match-set remote_user_vpn_network dst

3007 drop all 0 0
condition - match-set authorized_guests dst

6001 accept all 46480 26747790
condition - saddr 192.168.2.0/24

10000 accept all 0 0

--------------------------------------------------------------------------------
IPv4 Firewall "GUEST_LOCAL":

Active on (eth1.2,LOCAL)

rule action proto packets bytes
---- ------ ----- ------- -----
3001 accept tcp_udp 9101 596868
condition - tcp dpt:domain

3002 accept icmp 20 3410

3003 accept udp 64 21742
condition - udp spt:bootpc dpt:bootps

10000 drop all 33747 4123084

--------------------------------------------------------------------------------
IPv4 Firewall "GUEST_OUT":

Active on (eth1.2,OUT)

rule action proto packets bytes
---- ------ ----- ------- -----
6001 accept all 49527 7851741
condition - daddr 192.168.2.0/24

10000 accept all 0 0

--------------------------------------------------------------------------------
IPv4 Firewall "LAN_IN":

Active on (eth1,IN) (eth1.3,IN) (eth1.4,IN) (eth1.5,IN) (eth1.148,IN)

rule action proto packets bytes
---- ------ ----- ------- -----
6001 accept all 2201405 287372547
condition - saddr 192.168.178.0/24

6002 accept all 23593 1446864
condition - saddr 192.168.148.0/24

6003 accept all 259330 34563208
condition - saddr 192.168.46.0/24

6004 accept all 709735 128420752
condition - saddr 192.168.47.0/24

6005 accept all 0 0
condition - saddr 192.168.48.0/24

10000 accept all 12 520

--------------------------------------------------------------------------------
IPv4 Firewall "LAN_LOCAL":

Active on (eth1,LOCAL) (eth1.3,LOCAL) (eth1.4,LOCAL) (eth1.5,LOCAL) (eth1.148,LOCAL)

rule action proto packets bytes
---- ------ ----- ------- -----
10000 accept all 1286556 97820849

--------------------------------------------------------------------------------
IPv4 Firewall "LAN_OUT":

Active on (eth1,OUT) (eth1.3,OUT) (eth1.4,OUT) (eth1.5,OUT) (eth1.148,OUT)

rule action proto packets bytes
---- ------ ----- ------- -----
6001 accept all 2060177 194197463
condition - daddr 192.168.178.0/24

6002 accept all 23468 1438338
condition - daddr 192.168.148.0/24

6003 accept all 236238 55342991
condition - daddr 192.168.46.0/24

6004 accept all 571907 98234067
condition - daddr 192.168.47.0/24

6005 accept all 0 0
condition - daddr 192.168.48.0/24

10000 accept all 0 0

--------------------------------------------------------------------------------
IPv4 Firewall "WAN_IN":

Active on (eth0,IN) (eth2,IN)

rule action proto packets bytes
---- ------ ----- ------- -----
2000 accept tcp 0 0
condition - match-set 65c891680444a9310b5e20e4 dst

3001 accept all 2926181 356194625
condition - state RELATED,ESTABLISHED

3002 drop all 0 0
condition - state INVALID

3003 accept tcp 2150 127100
condition - daddr unifi tcp dpt:4443 LOG enabled

10000 drop all 0 0

--------------------------------------------------------------------------------
IPv4 Firewall "WAN_LOCAL":

Active on (eth0,LOCAL) (eth2,LOCAL)

rule action proto packets bytes
---- ------ ----- ------- -----
3001 accept all 1008284 155244003
condition - state RELATED,ESTABLISHED

3002 drop all 14099 733072
condition - state INVALID

10000 drop all 274916 22257204

--------------------------------------------------------------------------------
IPv4 Firewall "WAN_OUT":

Active on (eth0,OUT) (eth2,OUT)

rule action proto packets bytes
---- ------ ----- ------- -----
10000 accept all 3227650 477820843

--------------------------------------------------------------------------------
IPv4 Modify Firewall "LOAD_BALANCE":

Active on (eth1,IN) (eth1.2,IN) (eth1.3,IN) (eth1.4,IN) (eth1.5,IN) (eth1.148,IN)

rule action proto packets bytes
---- ------ ----- ------- -----
3001 accept all 1904 99161
condition - match-set NETv4_eth0 dst

3002 accept all 1872 142272
condition - match-set NETv4_eth2 dst

3003 accept all 1168561 83886222
condition - match-SRC-NTWRK-GROUP corporate_network match-set corporate_networ
k dst

3004 accept all 0 0
condition - match-SRC-NTWRK-GROUP corporate_network match-set remote_user_vpn_
network dst

3005 accept all 0 0
condition - match-SRC-NTWRK-GROUP corporate_network match-set remote_site_vpn_
network dst

3006 accept all 0 0
condition - match-SRC-NTWRK-GROUP corporate_network match-set remote_client_vp
n_network dst

3007 accept all 1757 93454
condition - match-SRC-NTWRK-GROUP corporate_network match-set guest_network ds
t

3008 accept all 70 4140
condition - match-SRC-NTWRK-GROUP guest_network match-set corporate_network ds
t

3009 accept all 0 0
condition - match-SRC-NTWRK-GROUP guest_network match-set remote_user_vpn_netw
ork dst

3010 accept all 0 0
condition - match-SRC-NTWRK-GROUP guest_network match-set remote_site_vpn_netw
ork dst

3011 accept all 0 0
condition - match-SRC-NTWRK-GROUP guest_network match-set remote_client_vpn_ne
twork dst

3012 accept all 9414 628636
condition - match-SRC-NTWRK-GROUP guest_network match-set guest_network dst

3013 accept all 0 0
condition - match-SRC-NTWRK-GROUP remote_user_vpn_network match-set corporate_
network dst

3014 accept all 0 0
condition - match-SRC-NTWRK-GROUP remote_user_vpn_network match-set remote_sit
e_vpn_network dst

3015 accept all 0 0
condition - match-SRC-NTWRK-GROUP remote_user_vpn_network match-set remote_use
r_vpn_network dst

3016 accept all 0 0
condition - match-SRC-NTWRK-GROUP remote_user_vpn_network match-set remote_cli
ent_vpn_network dst

3017 accept all 0 0
condition - match-SRC-NTWRK-GROUP remote_user_vpn_network match-set guest_netw
ork dst

3018 modify all 4098811 633462135

10000 accept all 4098812 633462197

--------------------------------------------------------------------------------
IPv6 Firewall "AUTHORIZED_GUESTSv6":

Inactive - Not applied to any interfaces, zones or for content-inspection.

rule action proto packets bytes
---- ------ ----- ------- -----
10000 drop all 0 0

--------------------------------------------------------------------------------
IPv6 Firewall "GUESTv6_IN":

Active on (eth1.2,IN)

rule action proto packets bytes
---- ------ ----- ------- -----
3001 drop all 0 0
condition - match-set corporate_networkv6 dst

10000 accept all 0 0

--------------------------------------------------------------------------------
IPv6 Firewall "GUESTv6_LOCAL":

Active on (eth1.2,LOCAL)

rule action proto packets bytes
---- ------ ----- ------- -----
3001 accept udp 0 0
condition - udp dpt:domain

3002 accept icmp 0 0

10000 drop all 155 8936

--------------------------------------------------------------------------------
IPv6 Firewall "GUESTv6_OUT":

Active on (eth1.2,OUT)

rule action proto packets bytes
---- ------ ----- ------- -----
10000 accept all 0 0

--------------------------------------------------------------------------------
IPv6 Firewall "LANv6_IN":

Active on (eth1,IN) (eth1.3,IN) (eth1.4,IN) (eth1.5,IN) (eth1.148,IN)

rule action proto packets bytes
---- ------ ----- ------- -----
10000 accept all 0 0

--------------------------------------------------------------------------------
IPv6 Firewall "LANv6_LOCAL":

Active on (eth1,LOCAL) (eth1.3,LOCAL) (eth1.4,LOCAL) (eth1.5,LOCAL) (eth1.148,LOCAL)

rule action proto packets bytes
---- ------ ----- ------- -----
10000 accept all 16989 1006856

--------------------------------------------------------------------------------
IPv6 Firewall "LANv6_OUT":

Active on (eth1,OUT) (eth1.3,OUT) (eth1.4,OUT) (eth1.5,OUT) (eth1.148,OUT)

rule action proto packets bytes
---- ------ ----- ------- -----
10000 accept all 0 0

--------------------------------------------------------------------------------
IPv6 Firewall "WANv6_IN":

Active on (eth0,IN) (eth2,IN)

rule action proto packets bytes
---- ------ ----- ------- -----
3001 accept all 0 0
condition - state RELATED,ESTABLISHED

3002 drop all 0 0
condition - state INVALID

10000 drop all 0 0

--------------------------------------------------------------------------------
IPv6 Firewall "WANv6_LOCAL":

Active on (eth0,LOCAL) (eth2,LOCAL)

rule action proto packets bytes
---- ------ ----- ------- -----
3001 accept ipv6-icmp 10 720
condition - ipv6-icmp neighbour-advertisement

3002 accept ipv6-icmp 0 0
condition - ipv6-icmp neighbour-solicitation

3003 accept all 0 0
condition - state RELATED,ESTABLISHED

3004 drop all 0 0
condition - state INVALID

10000 drop all 35373 7011052

--------------------------------------------------------------------------------
IPv6 Firewall "WANv6_OUT":

Active on (eth0,OUT) (eth2,OUT)

rule action proto packets bytes
---- ------ ----- ------- -----
10000 accept all 0 0
</pre>
ChatGPT ist bei der Analyse eine grosze Hilfe.

Die Kommandos, die zum Setzen der Regeln ausgefuehrt werden, sieht man mit folgendem Kommando.
<pre>
ibb@USG-3P:~$ show configuration commands | match firewall name LAN_IN
set firewall all-ping enable
set firewall broadcast-ping disable
set firewall group address-group authorized_guests description 'authorized guests MAC addresses'
set firewall group address-group guest_allow_dns_servers description 'allow dns servers for guests'
set firewall group address-group guest_portal_address description 'guest portal address'
set firewall group address-group guest_pre_allow description 'allow addresses for guests'
set firewall group address-group guest_restricted address 192.168.0.0/16
set firewall group address-group guest_restricted address 10.0.0.0/8
set firewall group address-group guest_restricted address 172.16.0.0/12
set firewall group address-group guest_restricted description 'restricted addresses for guests'
set firewall group address-group unifi_controller_addresses address 192.168.178.12
set firewall group address-group unifi_controller_addresses description 'UniFi addresses'
set firewall group ipv6-network-group corporate_networkv6 description 'IPv6 corporate subnets'
set firewall group ipv6-network-group guest_networkv6 description 'IPv6 guest subnets'
set firewall group network-group captive_portal_subnets description 'captive portal subnets'
set firewall group network-group corporate_network description 'corporate subnets'
set firewall group network-group corporate_network network 192.168.178.0/24
set firewall group network-group corporate_network network 192.168.148.0/24
set firewall group network-group corporate_network network 192.168.46.0/24
set firewall group network-group corporate_network network 192.168.47.0/24
set firewall group network-group corporate_network network 192.168.48.0/24
set firewall group network-group guest_network description 'guest subnets'
set firewall group network-group guest_network network 192.168.2.0/24
set firewall group network-group remote_client_vpn_network description 'remote client VPN subnets'
set firewall group network-group remote_site_vpn_network description 'remote site VPN subnets'
set firewall group network-group remote_user_vpn_network description 'Remote User VPN subnets'
set firewall group port-group 65c891680444a9310b5e20e4 description customized-SSH
set firewall group port-group 65c891680444a9310b5e20e4 port 22
set firewall group port-group guest_portal_ports description 'guest portal ports'
set firewall group port-group guest_portal_redirector_ports description 'guest portal redirector ports'
set firewall group port-group guest_portal_redirector_ports port 39080
set firewall group port-group guest_portal_redirector_ports port 39443
set firewall group port-group unifi_controller_ports-tcp description 'unifi tcp ports'
set firewall group port-group unifi_controller_ports-tcp port 8080
set firewall group port-group unifi_controller_ports-udp description 'unifi udp ports'
set firewall group port-group unifi_controller_ports-udp port 3478
set firewall ipv6-name AUTHORIZED_GUESTSv6 default-action drop
set firewall ipv6-name AUTHORIZED_GUESTSv6 description 'authorization check packets from guest network'
set firewall ipv6-name GUESTv6_IN default-action accept
set firewall ipv6-name GUESTv6_IN description 'packets from guest network'
set firewall ipv6-name GUESTv6_IN rule 3001 action drop
set firewall ipv6-name GUESTv6_IN rule 3001 description 'Block Virtual Network Traffic'
set firewall ipv6-name GUESTv6_IN rule 3001 destination group ipv6-network-group corporate_networkv6
set firewall ipv6-name GUESTv6_LOCAL default-action drop
set firewall ipv6-name GUESTv6_LOCAL description 'packets from guest network to gateway'
set firewall ipv6-name GUESTv6_LOCAL rule 3001 action accept
set firewall ipv6-name GUESTv6_LOCAL rule 3001 description 'allow DNS'
set firewall ipv6-name GUESTv6_LOCAL rule 3001 destination port 53
set firewall ipv6-name GUESTv6_LOCAL rule 3001 protocol udp
set firewall ipv6-name GUESTv6_LOCAL rule 3002 action accept
set firewall ipv6-name GUESTv6_LOCAL rule 3002 description 'allow ICMP'
set firewall ipv6-name GUESTv6_LOCAL rule 3002 protocol icmp
set firewall ipv6-name GUESTv6_OUT default-action accept
set firewall ipv6-name GUESTv6_OUT description 'packets forward to guest network'
set firewall ipv6-name LANv6_IN default-action accept
set firewall ipv6-name LANv6_IN description 'packets from intranet'
set firewall ipv6-name LANv6_LOCAL default-action accept
set firewall ipv6-name LANv6_LOCAL description 'packets from intranet to gateway'
set firewall ipv6-name LANv6_OUT default-action accept
set firewall ipv6-name LANv6_OUT description 'packets forward to intranet'
set firewall ipv6-name WANv6_IN default-action drop
set firewall ipv6-name WANv6_IN description 'packets from internet to intranet'
set firewall ipv6-name WANv6_IN rule 3001 action accept
set firewall ipv6-name WANv6_IN rule 3001 description 'allow established/related sessions'
set firewall ipv6-name WANv6_IN rule 3001 state established enable
set firewall ipv6-name WANv6_IN rule 3001 state invalid disable
set firewall ipv6-name WANv6_IN rule 3001 state new disable
set firewall ipv6-name WANv6_IN rule 3001 state related enable
set firewall ipv6-name WANv6_IN rule 3002 action drop
set firewall ipv6-name WANv6_IN rule 3002 description 'drop invalid state'
set firewall ipv6-name WANv6_IN rule 3002 state established disable
set firewall ipv6-name WANv6_IN rule 3002 state invalid enable
set firewall ipv6-name WANv6_IN rule 3002 state new disable
set firewall ipv6-name WANv6_IN rule 3002 state related disable
set firewall ipv6-name WANv6_LOCAL default-action drop
set firewall ipv6-name WANv6_LOCAL description 'packets from internet to gateway'
set firewall ipv6-name WANv6_LOCAL rule 3001 action accept
set firewall ipv6-name WANv6_LOCAL rule 3001 description 'Allow neighbor advertisements'
set firewall ipv6-name WANv6_LOCAL rule 3001 icmpv6 type neighbor-advertisement
set firewall ipv6-name WANv6_LOCAL rule 3001 protocol ipv6-icmp
set firewall ipv6-name WANv6_LOCAL rule 3002 action accept
set firewall ipv6-name WANv6_LOCAL rule 3002 description 'Allow Neighbor Solicitations'
set firewall ipv6-name WANv6_LOCAL rule 3002 icmpv6 type neighbor-solicitation
set firewall ipv6-name WANv6_LOCAL rule 3002 protocol ipv6-icmp
set firewall ipv6-name WANv6_LOCAL rule 3003 action accept
set firewall ipv6-name WANv6_LOCAL rule 3003 description 'allow established/related sessions'
set firewall ipv6-name WANv6_LOCAL rule 3003 state established enable
set firewall ipv6-name WANv6_LOCAL rule 3003 state invalid disable
set firewall ipv6-name WANv6_LOCAL rule 3003 state new disable
set firewall ipv6-name WANv6_LOCAL rule 3003 state related enable
set firewall ipv6-name WANv6_LOCAL rule 3004 action drop
set firewall ipv6-name WANv6_LOCAL rule 3004 description 'drop invalid state'
set firewall ipv6-name WANv6_LOCAL rule 3004 state established disable
set firewall ipv6-name WANv6_LOCAL rule 3004 state invalid enable
set firewall ipv6-name WANv6_LOCAL rule 3004 state new disable
set firewall ipv6-name WANv6_LOCAL rule 3004 state related disable
set firewall ipv6-name WANv6_OUT default-action accept
set firewall ipv6-name WANv6_OUT description 'packets to internet'
set firewall ipv6-receive-redirects disable
set firewall ipv6-src-route disable
set firewall ip-src-route disable
set firewall log-martians enable
set firewall modify LOAD_BALANCE description LOAD_BALANCE
set firewall modify LOAD_BALANCE rule 3001 action accept
set firewall modify LOAD_BALANCE rule 3001 destination group address-group NETv4_eth0
set firewall modify LOAD_BALANCE rule 3002 action accept
set firewall modify LOAD_BALANCE rule 3002 destination group address-group NETv4_eth2
set firewall modify LOAD_BALANCE rule 3003 action accept
set firewall modify LOAD_BALANCE rule 3003 destination group network-group corporate_network
set firewall modify LOAD_BALANCE rule 3003 source group network-group corporate_network
set firewall modify LOAD_BALANCE rule 3004 action accept
set firewall modify LOAD_BALANCE rule 3004 destination group network-group remote_user_vpn_network
set firewall modify LOAD_BALANCE rule 3004 source group network-group corporate_network
set firewall modify LOAD_BALANCE rule 3005 action accept
set firewall modify LOAD_BALANCE rule 3005 destination group network-group remote_site_vpn_network
set firewall modify LOAD_BALANCE rule 3005 source group network-group corporate_network
set firewall modify LOAD_BALANCE rule 3006 action accept
set firewall modify LOAD_BALANCE rule 3006 destination group network-group remote_client_vpn_network
set firewall modify LOAD_BALANCE rule 3006 source group network-group corporate_network
set firewall modify LOAD_BALANCE rule 3007 action accept
set firewall modify LOAD_BALANCE rule 3007 destination group network-group guest_network
set firewall modify LOAD_BALANCE rule 3007 source group network-group corporate_network
set firewall modify LOAD_BALANCE rule 3008 action accept
set firewall modify LOAD_BALANCE rule 3008 destination group network-group corporate_network
set firewall modify LOAD_BALANCE rule 3008 source group network-group guest_network
set firewall modify LOAD_BALANCE rule 3009 action accept
set firewall modify LOAD_BALANCE rule 3009 destination group network-group remote_user_vpn_network
set firewall modify LOAD_BALANCE rule 3009 source group network-group guest_network
set firewall modify LOAD_BALANCE rule 3010 action accept
set firewall modify LOAD_BALANCE rule 3010 destination group network-group remote_site_vpn_network
set firewall modify LOAD_BALANCE rule 3010 source group network-group guest_network
set firewall modify LOAD_BALANCE rule 3011 action accept
set firewall modify LOAD_BALANCE rule 3011 destination group network-group remote_client_vpn_network
set firewall modify LOAD_BALANCE rule 3011 source group network-group guest_network
set firewall modify LOAD_BALANCE rule 3012 action accept
set firewall modify LOAD_BALANCE rule 3012 destination group network-group guest_network
set firewall modify LOAD_BALANCE rule 3012 source group network-group guest_network
set firewall modify LOAD_BALANCE rule 3013 action accept
set firewall modify LOAD_BALANCE rule 3013 destination group network-group corporate_network
set firewall modify LOAD_BALANCE rule 3013 source group network-group remote_user_vpn_network
set firewall modify LOAD_BALANCE rule 3014 action accept
set firewall modify LOAD_BALANCE rule 3014 destination group network-group remote_site_vpn_network
set firewall modify LOAD_BALANCE rule 3014 source group network-group remote_user_vpn_network
set firewall modify LOAD_BALANCE rule 3015 action accept
set firewall modify LOAD_BALANCE rule 3015 destination group network-group remote_user_vpn_network
set firewall modify LOAD_BALANCE rule 3015 source group network-group remote_user_vpn_network
set firewall modify LOAD_BALANCE rule 3016 action accept
set firewall modify LOAD_BALANCE rule 3016 destination group network-group remote_client_vpn_network
set firewall modify LOAD_BALANCE rule 3016 source group network-group remote_user_vpn_network
set firewall modify LOAD_BALANCE rule 3017 action accept
set firewall modify LOAD_BALANCE rule 3017 destination group network-group guest_network
set firewall modify LOAD_BALANCE rule 3017 source group network-group remote_user_vpn_network
set firewall modify LOAD_BALANCE rule 3018 action modify
set firewall modify LOAD_BALANCE rule 3018 modify lb-group wan_failover
set firewall name AUTHORIZED_GUESTS default-action drop
set firewall name AUTHORIZED_GUESTS description 'authorization check packets from guest network'
set firewall name GUEST_IN default-action accept
set firewall name GUEST_IN description 'packets from guest network'
set firewall name GUEST_IN rule 3001 action accept
set firewall name GUEST_IN rule 3001 description 'Allow Public DNS'
set firewall name GUEST_IN rule 3001 destination port 53
set firewall name GUEST_IN rule 3001 protocol tcp_udp
set firewall name GUEST_IN rule 3002 action accept
set firewall name GUEST_IN rule 3002 description 'Allow Hotspot Portal'
set firewall name GUEST_IN rule 3002 destination group network-group captive_portal_subnets
set firewall name GUEST_IN rule 3002 destination port 443
set firewall name GUEST_IN rule 3002 protocol tcp
set firewall name GUEST_IN rule 3003 action accept
set firewall name GUEST_IN rule 3003 description 'allow packets to allow subnets'
set firewall name GUEST_IN rule 3003 destination group address-group guest_pre_allow
set firewall name GUEST_IN rule 3004 action drop
set firewall name GUEST_IN rule 3004 description 'Block Restricted Traffic'
set firewall name GUEST_IN rule 3004 destination group address-group guest_restricted
set firewall name GUEST_IN rule 3005 action drop
set firewall name GUEST_IN rule 3005 description 'Block Virtual Network Traffic'
set firewall name GUEST_IN rule 3005 destination group network-group corporate_network
set firewall name GUEST_IN rule 3006 action drop
set firewall name GUEST_IN rule 3006 description 'Block Traffic To VPN Servers'
set firewall name GUEST_IN rule 3006 destination group network-group remote_user_vpn_network
set firewall name GUEST_IN rule 3007 action drop
set firewall name GUEST_IN rule 3007 description 'Block Unauthorized Traffic'
set firewall name GUEST_IN rule 3007 destination group address-group authorized_guests
set firewall name GUEST_IN rule 6001 action accept
set firewall name GUEST_IN rule 6001 description 'Allow Network 192.168.2.0/24 Traffic'
set firewall name GUEST_IN rule 6001 source address 192.168.2.0/24
set firewall name GUEST_LOCAL default-action drop
set firewall name GUEST_LOCAL description 'packets from guest network to gateway'
set firewall name GUEST_LOCAL rule 3001 action accept
set firewall name GUEST_LOCAL rule 3001 description 'allow DNS'
set firewall name GUEST_LOCAL rule 3001 destination port 53
set firewall name GUEST_LOCAL rule 3001 protocol tcp_udp
set firewall name GUEST_LOCAL rule 3002 action accept
set firewall name GUEST_LOCAL rule 3002 description 'allow ICMP'
set firewall name GUEST_LOCAL rule 3002 protocol icmp
set firewall name GUEST_LOCAL rule 3003 action accept
set firewall name GUEST_LOCAL rule 3003 description 'Allow DHCP'
set firewall name GUEST_LOCAL rule 3003 destination port 67
set firewall name GUEST_LOCAL rule 3003 protocol udp
set firewall name GUEST_LOCAL rule 3003 source port 68
set firewall name GUEST_OUT default-action accept
set firewall name GUEST_OUT description 'packets forward to guest network'
set firewall name GUEST_OUT rule 6001 action accept
set firewall name GUEST_OUT rule 6001 description 'Allow Network 192.168.2.0/24 Traffic'
set firewall name GUEST_OUT rule 6001 destination address 192.168.2.0/24
set firewall name LAN_IN default-action accept
set firewall name LAN_IN description 'packets from intranet'
set firewall name LAN_IN rule 6001 action accept
set firewall name LAN_IN rule 6001 description 'Allow Network 192.168.178.0/24 Traffic'
set firewall name LAN_IN rule 6001 source address 192.168.178.0/24
set firewall name LAN_IN rule 6002 action accept
set firewall name LAN_IN rule 6002 description 'Allow Network 192.168.148.0/24 Traffic'
set firewall name LAN_IN rule 6002 source address 192.168.148.0/24
set firewall name LAN_IN rule 6003 action accept
set firewall name LAN_IN rule 6003 description 'Allow Network 192.168.46.0/24 Traffic'
set firewall name LAN_IN rule 6003 source address 192.168.46.0/24
set firewall name LAN_IN rule 6004 action accept
set firewall name LAN_IN rule 6004 description 'Allow Network 192.168.47.0/24 Traffic'
set firewall name LAN_IN rule 6004 source address 192.168.47.0/24
set firewall name LAN_IN rule 6005 action accept
set firewall name LAN_IN rule 6005 description 'Allow Network 192.168.48.0/24 Traffic'
set firewall name LAN_IN rule 6005 source address 192.168.48.0/24
set firewall name LAN_LOCAL default-action accept
set firewall name LAN_LOCAL description 'packets from intranet to gateway'
set firewall name LAN_OUT default-action accept
set firewall name LAN_OUT description 'packets forward to intranet'
set firewall name LAN_OUT rule 6001 action accept
set firewall name LAN_OUT rule 6001 description 'Allow Network 192.168.178.0/24 Traffic'
set firewall name LAN_OUT rule 6001 destination address 192.168.178.0/24
set firewall name LAN_OUT rule 6002 action accept
set firewall name LAN_OUT rule 6002 description 'Allow Network 192.168.148.0/24 Traffic'
set firewall name LAN_OUT rule 6002 destination address 192.168.148.0/24
set firewall name LAN_OUT rule 6003 action accept
set firewall name LAN_OUT rule 6003 description 'Allow Network 192.168.46.0/24 Traffic'
set firewall name LAN_OUT rule 6003 destination address 192.168.46.0/24
set firewall name LAN_OUT rule 6004 action accept
set firewall name LAN_OUT rule 6004 description 'Allow Network 192.168.47.0/24 Traffic'
set firewall name LAN_OUT rule 6004 destination address 192.168.47.0/24
set firewall name LAN_OUT rule 6005 action accept
set firewall name LAN_OUT rule 6005 description 'Allow Network 192.168.48.0/24 Traffic'
set firewall name LAN_OUT rule 6005 destination address 192.168.48.0/24
set firewall name WAN_IN default-action drop
set firewall name WAN_IN description 'packets from internet to intranet'
set firewall name WAN_IN rule 2000 action accept
set firewall name WAN_IN rule 2000 description SSH
set firewall name WAN_IN rule 2000 destination group port-group 65c891680444a9310b5e20e4
set firewall name WAN_IN rule 2000 protocol tcp
set firewall name WAN_IN rule 3001 action accept
set firewall name WAN_IN rule 3001 description 'allow established/related sessions'
set firewall name WAN_IN rule 3001 state established enable
set firewall name WAN_IN rule 3001 state invalid disable
set firewall name WAN_IN rule 3001 state new disable
set firewall name WAN_IN rule 3001 state related enable
set firewall name WAN_IN rule 3002 action drop
set firewall name WAN_IN rule 3002 description 'drop invalid state'
set firewall name WAN_IN rule 3002 state established disable
set firewall name WAN_IN rule 3002 state invalid enable
set firewall name WAN_IN rule 3002 state new disable
set firewall name WAN_IN rule 3002 state related disable
set firewall name WAN_IN rule 3003 action accept
set firewall name WAN_IN rule 3003 description 'PortForward [Smarthome]'
set firewall name WAN_IN rule 3003 destination address 192.168.178.12
set firewall name WAN_IN rule 3003 destination port 4443
set firewall name WAN_IN rule 3003 log enable
set firewall name WAN_IN rule 3003 protocol tcp
set firewall name WAN_LOCAL default-action drop
set firewall name WAN_LOCAL description 'packets from internet to gateway'
set firewall name WAN_LOCAL rule 3001 action accept
set firewall name WAN_LOCAL rule 3001 description 'allow established/related sessions'
set firewall name WAN_LOCAL rule 3001 state established enable
set firewall name WAN_LOCAL rule 3001 state invalid disable
set firewall name WAN_LOCAL rule 3001 state new disable
set firewall name WAN_LOCAL rule 3001 state related enable
set firewall name WAN_LOCAL rule 3002 action drop
set firewall name WAN_LOCAL rule 3002 description 'drop invalid state'
set firewall name WAN_LOCAL rule 3002 state established disable
set firewall name WAN_LOCAL rule 3002 state invalid enable
set firewall name WAN_LOCAL rule 3002 state new disable
set firewall name WAN_LOCAL rule 3002 state related disable
set firewall name WAN_OUT default-action accept
set firewall name WAN_OUT description 'packets to internet'
set firewall options mss-clamp interface-type pppoe
set firewall options mss-clamp interface-type pptp
set firewall options mss-clamp interface-type vti
set firewall options mss-clamp mss 1452
set firewall options mss-clamp6 interface-type pppoe
set firewall options mss-clamp6 interface-type pptp
set firewall options mss-clamp6 mss 1432
set firewall receive-redirects disable
set firewall send-redirects enable
set firewall source-validation disable
set firewall syn-cookies enable
set interfaces ethernet eth0 firewall in ipv6-name WANv6_IN
set interfaces ethernet eth0 firewall in name WAN_IN
set interfaces ethernet eth0 firewall local ipv6-name WANv6_LOCAL
set interfaces ethernet eth0 firewall local name WAN_LOCAL
set interfaces ethernet eth0 firewall out ipv6-name WANv6_OUT
set interfaces ethernet eth0 firewall out name WAN_OUT
set interfaces ethernet eth1 firewall in ipv6-name LANv6_IN
set interfaces ethernet eth1 firewall in modify LOAD_BALANCE
set interfaces ethernet eth1 firewall in name LAN_IN
set interfaces ethernet eth1 firewall local ipv6-name LANv6_LOCAL
set interfaces ethernet eth1 firewall local name LAN_LOCAL
set interfaces ethernet eth1 firewall out ipv6-name LANv6_OUT
set interfaces ethernet eth1 firewall out name LAN_OUT
set interfaces ethernet eth1 vif 2 firewall in ipv6-name GUESTv6_IN
set interfaces ethernet eth1 vif 2 firewall in modify LOAD_BALANCE
set interfaces ethernet eth1 vif 2 firewall in name GUEST_IN
set interfaces ethernet eth1 vif 2 firewall local ipv6-name GUESTv6_LOCAL
set interfaces ethernet eth1 vif 2 firewall local name GUEST_LOCAL
set interfaces ethernet eth1 vif 2 firewall out ipv6-name GUESTv6_OUT
set interfaces ethernet eth1 vif 2 firewall out name GUEST_OUT
set interfaces ethernet eth1 vif 3 firewall in ipv6-name LANv6_IN
set interfaces ethernet eth1 vif 3 firewall in modify LOAD_BALANCE
set interfaces ethernet eth1 vif 3 firewall in name LAN_IN
set interfaces ethernet eth1 vif 3 firewall local ipv6-name LANv6_LOCAL
set interfaces ethernet eth1 vif 3 firewall local name LAN_LOCAL
set interfaces ethernet eth1 vif 3 firewall out ipv6-name LANv6_OUT
set interfaces ethernet eth1 vif 3 firewall out name LAN_OUT
set interfaces ethernet eth1 vif 4 firewall in ipv6-name LANv6_IN
set interfaces ethernet eth1 vif 4 firewall in modify LOAD_BALANCE
set interfaces ethernet eth1 vif 4 firewall in name LAN_IN
set interfaces ethernet eth1 vif 4 firewall local ipv6-name LANv6_LOCAL
set interfaces ethernet eth1 vif 4 firewall local name LAN_LOCAL
set interfaces ethernet eth1 vif 4 firewall out ipv6-name LANv6_OUT
set interfaces ethernet eth1 vif 4 firewall out name LAN_OUT
set interfaces ethernet eth1 vif 5 firewall in ipv6-name LANv6_IN
set interfaces ethernet eth1 vif 5 firewall in modify LOAD_BALANCE
set interfaces ethernet eth1 vif 5 firewall in name LAN_IN
set interfaces ethernet eth1 vif 5 firewall local ipv6-name LANv6_LOCAL
set interfaces ethernet eth1 vif 5 firewall local name LAN_LOCAL
set interfaces ethernet eth1 vif 5 firewall out ipv6-name LANv6_OUT
set interfaces ethernet eth1 vif 5 firewall out name LAN_OUT
set interfaces ethernet eth1 vif 148 firewall in ipv6-name LANv6_IN
set interfaces ethernet eth1 vif 148 firewall in modify LOAD_BALANCE
set interfaces ethernet eth1 vif 148 firewall in name LAN_IN
set interfaces ethernet eth1 vif 148 firewall local ipv6-name LANv6_LOCAL
set interfaces ethernet eth1 vif 148 firewall local name LAN_LOCAL
set interfaces ethernet eth1 vif 148 firewall out ipv6-name LANv6_OUT
set interfaces ethernet eth1 vif 148 firewall out name LAN_OUT
set interfaces ethernet eth2 firewall in ipv6-name WANv6_IN
set interfaces ethernet eth2 firewall in name WAN_IN
set interfaces ethernet eth2 firewall local ipv6-name WANv6_LOCAL
set interfaces ethernet eth2 firewall local name WAN_LOCAL
set interfaces ethernet eth2 firewall out ipv6-name WANv6_OUT
set interfaces ethernet eth2 firewall out name WAN_OUT
set port-forward auto-firewall disable
Tibb@USG-3P:~$
</pre>
Beim Gast-WLAN funktioniert die Isolierung, siehe "set firewall name GUEST_LOCAL default-action drop".

=Workaround=

Als erstes legt man Netzwerklisten an von allen Subnetzen die ein Subnetz nicht erreichen darf. Leider habe ich kein NOT gefunden. Grrrr! Das haette die Sache deutlich vereinfacht. Das zu isolierende Subnetz ausgewaehlt, NOT davor und fertig. So muss man tatsaechlich alle nicht vom Subnetz zu erreichenden Subnetze auflisten.

[[File:UnifiNetwork_Networks.png|800px]]

Im Anschluss kann man dann die Drop-Regeln fuer jedes Subnetz anlegen.

<pre>
Regel

Name: Block VLANXXX

Einstellung Wert
Type LAN IN
Action Drop
Protocol All
Source Network 192.168.xxx.0/24
Destination Network Group <NameausNetwerkliste>
Logging optional
Reihenfolge vor den Accept-Regeln
</pre>

[[File:UnifiNetwork_TrafficandFirewallRuls.png|800px]]

Dadurch konnte ich mir (vorerst) die Anschaffung eines neuen und kompatiblen Produktes, wie UXG, UDM, UCG, ersparen.

=Request for Comments=

<comments />

Ubiquiti Nanostation AC loco Bridge

2026-07-31T15:53:51Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Um einen Internetanschluss an der anderen Grundstuecksseite (ca. 100 m) zu realisieren hatte ich zuerst an ein Kabel gedacht. Das ist zwar noch nicht ganz vom Tisch, bis ich aber eine vernuenftige Leitungsfuehrung hinbekomme, brauche ich allerdings noch etwas Zeit. Der Aufbau einer Netzwerk-Bruecke [https://www.ip-insider.de/was-ist-eine-netzwerk-bridge-a-902076/] laesst sich, so die Hoffnung, schnell und einfach realisieren. Die Wahl fiel auf zwei NanoStation AC loco (5 GHZ airMAX AC Radio) von Ubiquiti, nachfolgend nur noch NanoStation genannt. Da ich im Haus bereits Ubiquiti-Kompnenten einsaetze, ist mir deren Konfiguration bereits vertraut.

=Faktencheck=
Eine Netzwerkbridge arbeitet auf der ISO/OSI-Schicht 2. Es findet also in einem TCP/IP-Netz (MAC, LLC,...) alles in der Netzzugangsschicht statt. Das bedeutet man braucht sich keine Gedanken beim Einrichten des TCP/IP-Netzes zu machen.
[https://de.wikipedia.org/wiki/Logical_Link_Control]

Die NanoStation ist Outdoor geeignet. Dies bezieht sich erst einmal nur auf die Gehaeuse-Kapsel. Fuer den Betrieb Outdoor im 5-GHz-Band ergeben sich allerdings Einschraenkungen bei der Wahl der Kanaele. [https://en.wikipedia.org/wiki/List_of_WLAN_channels][https://community.ui.com/questions/Usage-of-5Ghz-SRD-channels-in-Europe-Germany-wrong-allowed-power-settings/efda8b93-d52b-456a-8722-5dd0e616dafc][https://efis.cept.org/sitecontent.jsp?sitecontent=srd_regulations]

Eine Angabe zur IP-Schutzart konnte ich bisher nicht finden.

Die NanoStation besitzt einen (dedizierten) AccessPoint, mit dem man sich zu Konfiguration-Zwecken verbinden kann. Die SSID ist "Loco5AC-<MAC>"

Zum Betrieb benoetigt man noch eine passives PoE-Netzteil (Empfohlener PoE-Adapter: POE-24-12W-G).
Passiver PoE-2-Paar (Paar 4/5 +24 V, 7/8 Rückfluss (-))
Vollstaendig also: Pin 1: TX+ Pin 2: TX- Pin 3: RX+ Pin 4: 24V Pin 5: 24V Pin 6: RX- Pin 7: GND Pin 8: GND (Tabelle folgt)

Geht man mal von einem Dauerbetrieb mit maximaler Leistung (7 W) aus, sind das pro Station 60 kWh im Jahr.

Der Vorgaenger der NanoStation AC 5 und loco ('''lo'''w'''co'''st?) sind (vermutlich) die NanoStation M und locoM (High-Power 2x2 MIMO airMAX® TDMA Station Models: NSM2/NSM3/NSM365/NSM5/locoM2/locoM5). Da diese nur einen 10/100-MBit/s-Port besitzen, ist hier auch die maximale Bandbreite auf 100 MBit/s begrenzt. Die Web-Oberflaeche hat sich sich vom M zum AC doch um einiges geaendert. [https://www.makes-it-work.de/2014/07/29/tutorial-ubnt-punkt-zu-punkt-verbindung/]
Bei den loco-Varianten fehlt der zweite Ethernetport an den man z. B. eine Netzwerk-Kamera anschliessen koennte.

Es stehen (mindestens) 2 Verbindungsmoeglichkeiten zur Verfuegung.
Überprüfen Sie die Konnektivität in der airOS®-Konfigurationsschnittstelle mit der UISP™-App oder dem Webportal. Beide sind sofort nach dem Einschalten des Geräts '''15 Minuten''' lang verfügbar. Falls erforderlich, können Sie das Gerät aus- und wieder einschalten, um das WLAN zu aktivieren.

=Installation=

Downloads zu allen Airmax-AC Komponenten [https://www.ui.com/download/airmax-ac].

Datenblatt [https://dl.ubnt.com/datasheets/NanoStation_AC/NanoStation_AC_DS.pdf]

=Erstkontakt=

UISP-App oder Webportal

So ganz stellt sich die Frage nicht, da man bequem vom Startbildschirm der App durch anklicken der beiden zugewiesen IP in den Browser wechseln kann. So hat man sich zumindest das Tippen der IP gespart.

Die UISP-App hat bei mir (10/2023) ein anderes Icon.

Android (Samsung, Android Version 12, One UI-Version 4.1)

Die Sicherheitsrichtlinie verhindert das benutzen unsicherer WLAN-Netzwerke. (Einstellungen -> Biometrische Daten und Sicherheit -> Andere Sicherheitseinstellungen -> Sicherheitsrichtlinien-Updates -> ausschalten)

Im Vorfeld sollte man sich schon mal Gedanken ueber Username und Password fuer den zukuenftigen Zugriff und eine SSID fuer die Bridge machen.

Standard-Benutzername und Passwort sind '''ubnt''' und '''ubnt'''.

Die Grundkonfiguration mache ich mit dem der App. Das Dashboard sieht auf dem kleinen Mobilbildschirm nicht so dolle aus.
Neben dem Hauptbildschirm und den weiteren Menuepunkten des 3-Punkte-Menues gibt es 3 Hauptkonfigurations-Reiter:
*DRAHTLOS
*NETZWERK
*SYSTEM

=Konfiguration=

Eine NanoStation wird zur StationPtP und die andere zur AccessPtP. Die Einstellungen sind alle bis auf die Aktivierung des AccessPoints identisch.
Bei der zweiten NanoStation bin ich irgendwie in einem "Auto-AP-Config-Modus" gelandet. Dabei nimmt die Routine alle unten beschriebenen Einstellungen vor. Wenn ich die Config-Datei nicht abgespeichert haette, haette ich mich fast ausgesperrt.

<div class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Config Datei Client</div>
<div class="mw-collapsible-content">
### PART ###
## 1648587044
##WA.v8.7.9
#board.sysid=0xe7fa
#board.cpurevision=0x00001123
#board.arch=0
#board.fcc_id=SWX-NS5ACLW
#board.name=NanoStation 5AC loco
#board.shortname=N5L
#board.model=Loco5AC
#board.timestamp=1684984461
#board.bom=13-00552-22
#board.netmodes=3
#board.hwaddr=E43883XXYYZZ
#board.device_id=705ff379f2b3bbb4efc2b5bfcdee03d3
#board.reboot=40
#board.upgrade=150
#board.phycount=1
#board.phy.1.maxmtu=2024
#board.fcc_unii_activated=1
#board.fcc_unii_switchable=0
#board.required_fw_version=526084
#radio.1.name=
#radio.1.shortname=
#radio.1.bus=pci
#radio.1.devdomain=5000
#radio.1.ccode=840
#radio.1.ccode_fixed=0
#radio.1.ccode_locked=0
#radio.1.subsystemid=0xe7fa
#radio.1.subvendorid=0x0777
#radio.1.txpower.max=25
#radio.1.txpower.min=-4
#radio.1.txpower.offset=2
#radio.1.ieee_modes=21
#radio.1.powerBackoff=6
#radio.1.antennas=1
#radio.1.def_antenna=1
#radio.1.antenna.1.id=1
#radio.1.antenna.1.name=NANO-G2
#radio.1.antenna.1.gain=13
#radio.1.antenna.1.builtin=1
#radio.1.antenna.1.chains=2
#radio.1.antenna.1.chain.1.id=0
#radio.1.antenna.1.chain.1.name=Vertical
#radio.1.antenna.1.chain.2.id=1
#radio.1.antenna.1.chain.2.name=Horizontal
#radio.1.caps=2900361236
#radio.1.caps2=2
#radio.1.eirp.limit=1
#radio.1.regdomain_flags=fcc_new_grant,ts=0x646ed28d
#radio.1.chains=2
#radio.1.ieee_mode_a=1
#radio.1.ptp_only=1
#radio.1.ptp_sta=1
#radio.1.ptmp_only=1
#radio.1.ptmp_sta=1
#radio.1.distance_limit=0
#radio.1.chanbw=10,20,30,40,50,60,80
#radio.2.name=
#radio.2.shortname=
#radio.2.bus=ahb
#radio.2.devdomain=5000
#radio.2.ccode=840
#radio.2.ccode_fixed=0
#radio.2.ccode_locked=0
#radio.2.subsystemid=0xe7fa
#radio.2.subvendorid=0x0777
#radio.2.txpower.max=19
#radio.2.txpower.min=0
#radio.2.txpower.offset=0
#radio.2.ieee_modes=10
#radio.2.powerBackoff=6
#radio.2.antennas=0
#radio.2.def_antenna=0
#radio.2.caps=12
#radio.2.caps2=0
#radio.2.eirp.limit=0
#radio.2.regdomain_flags=ts=0x646ed28d
#radio.2.chains=1
#radio.2.ieee_mode_bg=1
#radio.2.web_exclude=1
#radio.2.distance_limit=0
#radio.2.chanbw=5,10,20,40,80
#feature.rssi.leds=0
#feature.g2=1
#feature.g3=0
#feature.ext_reset=0
#feature.poe_passthrough=0
#78c4f0e363d947eed2e0aed0c453ffbc
### PART ###
aaa.status=disabled
bridge.status=enabled
bridge.1.devname=br0
bridge.1.port.1.devname=eth0
bridge.1.port.1.status=enabled
bridge.1.port.2.devname=ath0
bridge.1.port.2.status=enabled
bridge.1.status=enabled
bridge.1.stp.status=disabled
dhcpc.status=enabled
dhcpc.1.devname=br0
dhcpc.1.fallback=192.168.1.20
dhcpc.1.fallback_netmask=255.255.255.0
dhcpc.1.status=enabled
discovery.beacon.status=enabled
discovery.cdp.status=disabled
discovery.lldp.status=enabled
discovery.status=enabled
ebtables.status=enabled
ebtables.sys.arpnat.status=enabled
ebtables.sys.arpnat.1.devname=ath0
ebtables.sys.arpnat.1.status=enabled
ebtables.sys.eap.status=enabled
ebtables.sys.eap.1.devname=ath0
ebtables.sys.eap.1.status=enabled
ebtables.sys.status=enabled
gui.language=en_US
httpd.https.port=443
httpd.https.status=enabled
httpd.status=enabled
netconf.status=enabled
netconf.1.autoip.status=disabled
netconf.1.devname=ath0
netconf.1.mtu=1500
netconf.1.status=enabled
netconf.1.up=enabled
netconf.2.autoip.status=disabled
netconf.2.autoneg=enabled
netconf.2.devname=eth0
netconf.2.flowcontrol.rx.status=enabled
netconf.2.flowcontrol.tx.status=enabled
netconf.2.mtu=1500
netconf.2.status=enabled
netconf.2.up=enabled
netconf.3.autoip.status=disabled
netconf.3.devname=br0
netconf.3.ip6.status=enabled
netconf.3.mtu=1500
netconf.3.role=mlan
netconf.3.status=enabled
netmode=bridge
radio.countrycode=276
radio.status=enabled
radio.1.ack.auto=enabled
radio.1.ackdistance=600
radio.1.acktimeout=31
radio.1.antenna.gain=13
radio.1.antenna.id=1
radio.1.atpc.sta.status=enabled
radio.1.atpc.threshold=36
radio.1.cable.loss=2
radio.1.center.1.freq=0
radio.1.chanbw=0
radio.1.countrycode=276
radio.1.cwm.enable=0
radio.1.cwm.mode=1
radio.1.devname=ath0
radio.1.dfs.status=enabled
radio.1.freq=0
radio.1.ieee_mode=auto
radio.1.low_txpower_mode=disabled
radio.1.mode=managed
radio.1.obey=enabled
radio.1.polling=enabled
radio.1.pollingnoack=0
radio.1.pollingpri=
radio.1.ptpmode=enabled
radio.1.reg_obey=enabled
radio.1.scanbw.status=enabled
radio.1.status=enabled
radio.1.txpower=25
resolv.nameserver.status=enabled
resolv.nameserver.1.status=disabled
resolv.nameserver.2.status=disabled
resolv.nameserver.3.status=disabled
resolv.nameserver.4.status=disabled
sshd.port=22
sshd.status=enabled
syslog.status=enabled
system.cfg.version=65547
users.status=enabled
users.1.name=Admin
users.1.password=$1$ufsU.X9B$hz....................
users.1.status=enabled
wireless.status=enabled
wireless.1.devname=ath0
wireless.1.hide_ssid=disabled
wireless.1.security.type=none
wireless.1.ssid=UbiBridge
wireless.1.status=enabled
wpasupplicant.device.1.devname=ath0
wpasupplicant.device.1.profile=AUTO
wpasupplicant.device.1.status=enabled
wpasupplicant.profile.1.name=AUTO
wpasupplicant.profile.1.network.1.eap.1.status=disabled
wpasupplicant.profile.1.network.1.key_mgmt.1.name=WPA-PSK
wpasupplicant.profile.1.network.1.pairwise.1.name=CCMP
wpasupplicant.profile.1.network.1.priority=100
wpasupplicant.profile.1.network.1.proto.1.name=RSN
wpasupplicant.profile.1.network.1.psk=<SSIDPW>!SSID
wpasupplicant.profile.1.network.1.ssid=UbiBridge
wpasupplicant.profile.1.network.1.status=enabled
wpasupplicant.profile.1.network.2.key_mgmt.1.name=NONE
wpasupplicant.profile.1.network.2.priority=2
wpasupplicant.profile.1.network.2.status=disabled
wpasupplicant.status=enabled
</div></div>
Da ich die Bridge mit einer festen (statischen) IP betreiben moechte, musste ich sowieso wieder in die Konfiguration. Alles entsprechend abgeaendert. Nur den (Standard-)Benutzernamen ubnt konnte ich an dieser Stelle (noch) nicht aendern.

Dann mal alle drei Hauptmenues nach passenden Eintragungen absuchen.

==DRAHTLOS==
*AccessPoint: Erst mal etwas verwirrend; damit legt man aber wohl fest, ob es sich bei dem Geraet um den AccessPoint oder um die Station handelt.
*PtP-Modus: Ja, ich will eine reine Point-to-Point-Verbindung
*SSID und Passwort vergeben
*Ausgangsleistung lasse ich erst mal auf Auto
*Erweitert -> EIRP-Limit (Germany) berechnen (Sagen wir mal besser aus Liste ermitteln; Da gibt es aber scheinbar noch Klaerungsbedarf [https://community.ui.com/questions/Usage-of-5Ghz-SRD-channels-in-Europe-Germany-wrong-allowed-power-settings/efda8b93-d52b-456a-8722-5dd0e616dafc])

==NETZWERK==
*Netzwerk-Modus: Bridge (nicht Router)
*Management IP: DHCP (ware natuerlich auch statisch moeglich)
*VLAN: konfiguriere ich erst wenn die Bruecke steht

==SYSTEM==
*Geraetenamen: NanoStation 5AC loco ergaenze ich durch ST (Station) oder AP (AccessPoint)
*Benutzername/Passswort
*Standort: lasse ich erst mal weg

=FirstTest=

[[Datei:NanoStationACloco Dashboard 1.png|mini]]
[[Datei:NanoStationACloco System Client 1.png|mini]]

Den AccessPoint habe ich statisch mit meinem 178er-Subnetz verbunden. Nach der Kontaktaufnahme mit der statisch zugewiesenen IP, ganz normal mit einem Browser aus dem Hausnetz, konnte ich mich mit dem AP verbinden und bin auf das Dashboard von airOS8 (Betriebssystem der NanoStation) gelandet.

Bevor ich jetzt die Einstellungen ueber airOS8 weiter verfeinere, erst mal eine einfacher Netzwerktest "Client ueber Bruecke" ans "Hausnetz".

Topologie (Grafik folgt)

Switch (Hausnetz) <-> Bridge AP (feste IP) <-> Bridge ST (DHCP) <-> Notebook (ueber LAN an Bridge ST)

Bei bestehender Bridge erhaelt das Notebook eine IP aus dem Hausnetz. Auch die Bridge Station hat eine eigene IP (Management IP).

Erst mal Firmware (airOS8) auf diese neueste Version updaten.
Nach dem Update von WA V8.7.9 Build 46843 nach WA V8.7.11 Build 46972 hat die Station keine Verbindung mehr mit der AP aufgenommen. Eine Verbindung mit der UISP-App ist fehlgeschlagen.

=Second Test (Feldversuch)=

Ich war mir an dieser Stelle kurz uneins, ob ich die AP-Seite oder die ST-Seite ans Hausnetz anschliesse. Ich habe jetzt die AP-Seite an der FritzBox und die ST-Seite am Hausnetz.
Beide haben zur Konfiguration eine eigene IP. Der AP statisch und die ST erst mal DHCP (spaeter auch statisch). Der AP haengt jetzt an einem Baum in Reichweite der FritzBox. Der HAK steht hinten im Grundstueck im Freien und stellt die Versorgung der Tiny-House-Siedlung sicher. Die ST haengt im Haus erst einmal unterm Dach. Die Verbindung klappte auf anhieb, auch durch die Betonziegel.

Jetzt war die Anbindung der FritzBox an der Reihe. Hierzu habe ich den Weg ueber ssh auf den AP gewaehlt.

<syntaxhighlight lang="bash">
BridgeAdmin@192.168.178.200's password:
___ ___
|\ \|\ \ Welcome to airOS
\ \ \\\ \
\ \ \\\ \ PRODUCT: NanoStation 5AC loco
\ \ \\\ \ MAC: E43883CE6ED3
\ \_______\
\|_______| VERSION: WA.v8.7.11

********************************* NOTICE **********************************
* By logging in to, accessing, or using any Ubiquiti product, you are *
* signifying that you have read our Terms of Service (ToS) and End User *
* License Agreement (EULA), understand their terms, and agree to be *
* fully bound to them. The use of CLI (Command Line Interface) can *
* potentially harm Ubiquiti devices and result in lost access to them and *
* their data. By proceeding, you acknowledge that the use of CLI to *
* modify device(s) outside of their normal operational scope, or in any *
* manner inconsistent with the ToS or EULA, will permanently and *
* irrevocably void any applicable warranty. *
***************************************************************************

WA# uname -a
Linux NanoStation 5AC loco AP 2.6.32.68 #1 Tue Jun 14 04:26:27 EEST 2022 mips GNU/Linux
WA# ip a
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 16436 qdisc noqueue state UNKNOWN
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000
link/ether e4:38:83:cf:6e:d3 brd ff:ff:ff:ff:ff:ff
3: gre0: <NOARP> mtu 1476 qdisc noop state DOWN
link/gre 0.0.0.0 brd 0.0.0.0
5: wifi1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UNKNOWN
link/ieee802.11 e6:38:83:ce:6e:d3 brd ff:ff:ff:ff:ff:ff
6: teql0: <NOARP> mtu 1500 qdisc noop state DOWN qlen 100
link/void
7: wifi0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 2286 qdisc noqueue state UNKNOWN
link/ieee802.11 e4:38:83:ce:6e:d3 brd ff:ff:ff:ff:ff:ff
8: ath0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UNKNOWN qlen 1000
link/ether e4:38:83:ce:6e:d3 brd ff:ff:ff:ff:ff:ff
9: ath1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UNKNOWN
link/ether e6:38:83:ce:6e:d3 brd ff:ff:ff:ff:ff:ff
inet 192.168.172.1/24 brd 192.168.172.255 scope global ath1
10: br0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UNKNOWN
link/ether e4:38:83:ce:6e:d3 brd ff:ff:ff:ff:ff:ff
inet 192.168.178.200/24 brd 192.168.178.255 scope global br0
inet6 fe80::e638:83ff:fece:6ed3/64 scope link
valid_lft forever preferred_lft forever
WA# ip r
192.168.178.0/24 dev br0 proto kernel scope link src 192.168.178.200
192.168.172.0/24 dev ath1 proto kernel scope link src 192.168.172.1
default via 192.168.178.1 dev br0
WA#
</syntaxhighlight>

==Request for Comments==

<comments />

Unifi

2026-07-31T15:53:50Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Unifi Controller=

Zum Installieren unter openSuSE 15.3 habe ich folgenden Forumsschnippsel gefunden:

<nowiki>
RPM's for UniFi Controller

Hello

I've built RPM packages for UniFi 3.x

Currently It's compatible with systemd-aware distros like:

OpenSuse 12.2 and newer
Fedora 15 and newer
RHEL 7
CentOS 7

A bit later I'll add support for systemv/upstart distros too (i.e. Centos/RHEL 6.x)

rpm spec + systemd source files attached

Short build howto for newbies:

Install rpm-build package Fedora/RHEL: yum install rpm-buildOpenSuse: zypper install rpm-build
decompress and copy unifi.spec to ~/rpmbuild/SPECS/
copy unifi.service to ~/rpmbuild/SOURCES/
download UniFi.unix.zip and copy to ~/rpmbuild/SOURCES/
change version string in unifi.spec to match the version of file downloaded
run rpmbuild -bb ~/rpmbuild/unifi.spec
built rpm package will be listed after process

I will push updates to [https://github.com/GioMac/SPEC] My GitHub Account

Feedback is appreciated
</nowiki>

Quelle: https://community.ui.com/questions/RPMs-for-UniFi-Controller/fa7617f5-e534-42c5-a8c8-b295d4a47d4f

https://github.com/GioMac/SPEC

https://github.com/GioMac/SPEC/blob/master/unifi.spec

https://github.com/GioMac/SPEC/blob/master/sources/unifi.service

Die selbstgebauten RPMs waren mir aber noch nie so geheuer. Man weiß nie was drin steckt und bleibt oft auch bei Updates auf der Strecke.
Da der Unifi-Controller ein JAVA-Programm (ace.jar) ist sollte es mit dem Teufel zugehen wenn man das nicht zum Laufen bekommt.

Selbst wenn ich mich entscheiden sollte, den Controller auf einem Debian-Winzling zu betreiben sind die beim steinigen Installationsweg gewonnen Erkenntnisse mit Sicherheit hilfreich.

==Schritt 1==
Das Debian-Package von https://community.ui.com/releases/UniFi-Network-Controller-6-2-17/7f6d58bc-ce9f-43f2-8bc8-0c0dd935ebce herunterladen.

==Schritt 2==

Mit
alien -r unifi_sysvinit_all_6.2.17.deb
ein RPM daraus machen und mit
rpm -i unifi-6.2.17_15282-2.noarch.rpm
installieren.
Missing Depencies

Grrrrrrrrrrrr, waere ja auch zu schoen gewesen.
Einige lieszen sich durch installieren der devel-Pakete aufloesen, aber die Fehlermeldung bezueglich libc ergibt keinen Sinn, also
rpm -i --nodeps unifi-6.2.17_15282-2.noarch.rpm

==Schritt3==
Java installieren. Der Unifi-Controller benötigt Java 8. Unter Opensuse 15.2/15.3:
zypper in java-1_8_0-openjdk
==Schritt 4==
Der Unifi-Controller benötigt eine Insatllation der MongoDB. Da die MongoDB nicht in den Repos von SuSE enthalten ist, das Repo mit
zypper ar https://repo.mongodb.org/zypper/suse/15/mongodb-org/4.4/x86_64/ MongoDB
einbinden und DB installieren
zypper -n in monogodb-org
Und dann mal ganz waghalsig mit
systemctl start mongod
starten und mit
systemctl status mongod
kontrollieren. Er forked zwar bricht dann aber mit einer Fehlermeldung ab.

Da der Unifi-Controller eh (nur) die MongoDB in der Version 3.6 unterstützt (Nachtraegliche Anmerkung: Ich weisz nicht woher ich diese Information hatte. Es wird natuerlich 3.6 bis 4.4 unterstuetzt. In meiner Docker-Variante habe ich Mongo 4.4 erfolgreich am Start.) habe ich die Version 4.4 wieder deinstalliert und mit diesem Repo
zypper addrepo https://download.opensuse.org/repositories/openSUSE:infrastructure:monitoring/openSUSE_Leap_15.2/openSUSE:infrastructure:monitoring.repo
die Version 3.6 installiert.
zypper refresh
zypper in monogdb
systemctl status mongodb
systemctl enable mongodb
systemctl start mongodb
Fehlermeldung!
journalctl -xe
tail -100 /var/log/mongodb/mongod.log
War aber leicht zu beheben. Der mongodb-user benötigt die Rechte auf sein Storage.
chown -R mongodb.mongodb /var/run/mongodb/

Aus irgendeinem Grund ist es mir allerdings zu diesem Zeitpunkt nicht gelungen, die Unifi-Network-Application (Unifi Controller) nativ aus meinem openSuse 15.3 zu installieren. Ich habe dann kurzer Hand die Docker-Variante gewaehlt und zum laufen gebracht. So richtig gefaellt mir diese Loesung aber auch nicht (siehe docker-firewalld-Problem).

Hier kommt demnaechst noch die reine Inbetriebnahme der Unifi-Network-Application mit MongoDB4.4 rein. Jetzt geht's erst einmal im Beitrag [https://tippvomtibb.de/wiki/index.php?title=Ubiquiti_Unifi_Network_Application Ubiquiti Unifi Network Application] in der Docker-Variante weiter.

Insect Detect

2026-07-31T15:53:49Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Hier beschreibe ich die Umsetzung (erstmal nur Nachbau) des Projektes Insect Detect, zu finden auf [https://maxsitt.github.io/insect-detect-docs/ Github]

Initiiert durch einen Kollegen, der im Rahmen seiner Taetigkeit beim [https://www.biosphaere-bliesgau.eu/ Biosphärenreservat Bliesgau] ein Projekt zur Erfassung von Insekten (Voegel, Fledermaeuse, ...) angestoszen hat, habe ich im ersten Schritt eine eigene (Hardware-)Variante des Projektes auf Github umgesetzt und werde dieses als Basis für zukünftige Adaptionen nutzen.

=Stueckliste=

{| class="wikitable"
|-
!
!colspan="4"|Version 2023
!colspan="4"|Version 2024
|-
! Komponente
! Kosten (ca.)
! Full Setup
! Minimal Setup
! Test Setup
! Kosten (ca.)
! Full Setup
! Minimal Setup
! Test Setup
|-
|bgcolor = "#ff9966"| OAK-1 Auto-Focus ('''O'''penCV '''A'''I '''K'''it)
| 145,99 €
| *
| *
| *
| 141,55 €
| *
| *
| *
|-
|bgcolor = "#ff9966"| Raspberry Pi Zero 2 W(H)<br> H=Header bereits aufgeloetet
| ~22,00 €
| *
| *
| *
| 21,90 €
| *
| *
| *
|-
|bgcolor = "#ff9966"| Micro SDXC card 256 GB
| 28,99 €
| *
|
|
| 24,95 €
| *
|
|
|-
|bgcolor = "#ff9966"| Micro SDHC Card 32 GB
| 8,95 €
| *
| *
| *
|-
|bgcolor = "#ff99cc"| Micro USB to USB A adapter, angled
| 5,50 €
| *
| *
|
|-
|bgcolor = "#ff99cc"| Micro USB to USB A adapter
| 1,85 €
| *
|
| *
| 1,85 €
| *
|
| *
|-
|bgcolor = "#ff99cc"| USB A to micro USB cable, 20 cm, angled
| 5,60 €
| *
|
|
|-
|bgcolor = "#ffff66"| RPi Power Supply
| 7,99 €
|
|
| *
|-
|bgcolor = "#ff9966"| RPi CPU Heatsink
| 1,20 €
| *
| *
|
| 1,20 €
| *
| *
|
|-
|bgcolor = "#ff9966"| RPi Header
| 0,95 €
| *
| *
|
|-
|bgcolor = "#ff9966"| RPi Stacking Header
| 1,60 €
| *
| *
|
| 2,12 €
| *
| *
|
|-
|bgcolor = "#6699ff"| RPi Spacer Bolts 10 mm
| 3,50 €
| *
| *
|
|
|
|
|-
|bgcolor = "#6699ff"| RPi Spacer Bolts 20 mm
| 2,60 €
| *
| *
|
|
|
|
|-
|bgcolor = "#6699ff"| Standoff M2.5, female-male (5 mm)
| 1,12 €
|
|
|
| 4
|
|
|-
|bgcolor = "#6699ff"| Standoff M2.5, female*2 (11-12 mm)
| 1,92 €
|
|
|
| 4
|
|
|-
|bgcolor = "#6699ff"| Screw M2.5 (5 mm)
| 1,92 €
|
|
|
| 8
|
|
|-
|bgcolor = "#999966"| Thermal Pad (1 mm) 50x50 mm (optional)
| 4,79 €
| 2
| 1
|
|-
|bgcolor = "#ffff66"| PiJuice Zero UPS pHAT
| 54,23 €
| *
| *
|
|
|
|
|-
|bgcolor = "#ffff66"| PiJuice 12,000mAh LiPo Battery
| 39,40 €
| *
| *
|
|
|
|
|-
|bgcolor = "#ffff66"| Witty Pi 4 L3V7
| 28,56 €
|
|
|
| *
| *
|
|-
|bgcolor = "#ffff66"| Li-Ion Battery Pack 3.7V (4400mAh)
| 14,24 €
|
|
|
| *
| *
|
|-
|bgcolor = "#ffff66"| Voltaic V75 USB Battery Pack
| 101,14 €
|
|
|
| *
| *
|
|-
|bgcolor = "#66ff33"| Fibox PC 162513 Enclosure
| 89,99 €
| *
| *
|
|-
|bgcolor = "#66ff33"| Fibox TM 1625 Mounting Plate
| 7,49 €
| *
| *
|
|-
|bgcolor = "#6699ff"| Cable Gland PG 13.5
| 0,99 €
| *
| *
|
|-
|bgcolor = "#6699ff"| Cable Gland PG 13.5 Locknut
| 0,27 €
| *
| *
|
|-
|bgcolor = "#6699ff"| Stainless Steel Cable Tie
| 3,90 €
| *
| 8
| 6
|-
|bgcolor = "#6699ff"| Cable Tie Mount
| 0,99 €
| *
| 8
| 6
|-
|bgcolor = "#999966"| Acrylic Glas (2 mm) 40x40 mm
| ~5,00 €
| *
| *
|
|-
|bgcolor = "#999966"| EPDM Sealing Strip 20x5 mm
| 6,25 €
| *
| *
|
|-
|bgcolor = "#999966"| Silica Gel Pack 50 g
| 15,99 €
| *
| *
|
|-
|bgcolor = "#ff3300"| Solar Panel 6V 9W
| 98,30 €
| *
| *
|
|-
|bgcolor = "#6699ff"| Solar Panel Bracket, Medium (optional)
| 11,75 €
| *
| *
|
|-
|bgcolor = "#ff99cc"| Solar Panel Extension Cable, 1 ft
| ~7,00 €
| *
| *
|
|-
|bgcolor = "#ff99cc"| Solar Panel Micro USB Adapter
| 3,88 €
| *
| *
|
|-
|bgcolor = "#ffff66"| Voltaic 12,800mAh Li-Ion Battery
| 83,55 €
| *
|
|
|-
|bgcolor = "#999966"| 2x Heatsink 40x30 mm (optional)
| 2,35 €
| *
|
|
|-
|bgcolor = "#339933"| HPL Sheet (4 mm) 350x250 mm
| ~5,00 €
| *
|
|
|-
|bgcolor = "#339933"| Aluminium Square Tube (23.5x23.5 mm), 1.5 m
| ~16,00 €
| *
|
|
|-
|bgcolor = "#6699ff"| 4x M4 20 mm Screws (internal hexagon)
| ~2,00 €
| *
|
|
|-
|bgcolor = "#6699ff"| 7x M4 40 mm Screws
| ~3,00 €
| *
|
|
|-
|bgcolor = "#6699ff"| 2x M4 60 mm Screws
| ~2,00 €
| *
|
|
|-
|bgcolor = "#6699ff"| 21x M4 Hex Nuts
| ~3,00 €
| *
|
|
|-
|bgcolor = "#6699ff"| 18x Flat Washer (e.g. M4 15 mm)
| ~3,00 €
| *
|
|
|-
|bgcolor = "#6699ff"| Pipe Clamp (60.3 mm) 70 mm + screws & nuts
| 5,09 €
| *
|
|
|-
|bgcolor = "#6699ff"| Pipe Clamp (60.3 mm) 350 mm + screws & nuts
| 7,81 €
| *
|
|
|-
|bgcolor = "#339933"| Flower Platform (e.g. 350x200 mm)
| ~17,00 €
| *
|
|
|-
| Total cost
|
| ~704 €
| 531 €
| 187 €
|-
| Total cost with optional components
|
| ~730 €
| 547 €
|
|
|-
| Legende
|colspan="9"|<span style="color: #ff9966;">■</span> Hardware <span style="color: #ff99cc;">■</span> Kabel/Adapter <span style="color: #ffff66;">■</span> Akku <span style="color: #66ff33;">■</span> Gehaeuse <span style="color: #6699ff;">■</span> Befestigungsmaterial <span style="color: #ff3300;">■</span> Solar <span style="color: #339933;">■</span> Platform <span style="color: #999966;">■</span> Sonstiges/Zubehoer
|}

=Hardware=
Der Arbeitsablauf ist grob gesagt: Kamera (Luxonis) -> MicroPC (SBC Raspi (Zero)) -> PC (Linux, Win, Mac).

==Kamera==

Der Kamera (OAK-1 von Luxonis) hat eine besondere Bedeutung, da sie als eine der wenigen (?) Kameras durch die eingebaute VPU (Vision/Visual/Video Processing Unit) Myriad X [https://www.intel.de/content/www/de/de/products/sku/125926/intel-movidius-myriad-x-vision-processing-unit-4gb/specifications.html] eine Vorverarbeitung (Object Detection) des Videomaterials durchfuehrt und der nachgeschalteten Einheit bereits fertige Trackingdaten zur Verfuegung stellt.

==RasPi==
Zum Raspi Zero gibt es eigentlich nicht viel Neues zu sagen.
Bei der Wahl des USV-Moduls sollte man berueckichtigen, dass das PiJuice Zero UPS pHAT schwer oder gar nicht mehr zu beziehen ist.

Da ich eines davon noch besitze hier eine kleine [https://www.makerspace-online.com/pijuice-hat/ Anleitung] zur Inbetriebnahme.

Die IP-Adresse des Pi wird im LoginScreen (HDMI) angezeigt.

Im Wesentlichen laufen hier 2 Programme.

* Das Python Programm webapp.py, welches eine Webschnittstelle zum Pi herstellt.

* Das Python Programm trigger_capture.py, welches die "Detections" als Dateien in einem Ordner ablegt.

==Spannungsversorgung==
Im Dauerbetrieb wird auf der Insect Detect GithubSeite fuer den PiZero und die Kamera ein Energieverbrauch von ~88Wh pro 20 Stunden angegeben.

Eine eigene Messung steht noch aus.

Das Ein- und Aus-Schalten funktioniert ueber einen LED-Button.

===PiJuice===
[https://www.makerspace-online.com/pijuice-hat/]

===Witty Pi 4 L3V7===

===Akku===

Voltaic V75 [https://voltaicsystems.com/v75/]

TODO

==Notebook==

Zur Auswertung der gespeicherten Daten (jpg-captures und metadata.csv) von der SDCard des Raspi.

Die Anforderungen an die Hardware:
* USB 3
* Outdoor-Modell
* lange Akkulaufzeit
* LTE

to be continued ...

=Software=

[[File:insect_detect_active_learning_loop.png|600px]][https://maxsitt.github.io/insect-detect-docs/#overview]

Hier eine noch unsortierte Ansammlung der benutzten Befehle der ersten Gehversuche.

chris@worker:~/YOLOv5-cls> python3.12 -m virtualenv env_yolov5
created virtual environment CPython3.12.11.final.0-64 in 207ms
creator CPython3Posix(dest=/home/chris/YOLOv5-cls/env_yolov5, clear=False, no_vcs_ignore=False, global=False)
seeder FromAppData(download=False, pip=bundle, via=copy, app_data_dir=/home/chris/.local/share/virtualenv)
added seed packages: pip==25.2
activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator

python insect-detect-ml-main/process_images.py -source "InsectDetectFirstShot/"

yolov5-master/utils/dataloaders.py

python3.11 yolov5-master/classify/predict.py --name FirstShot --source "./InsectDetectFirstShot/2025-08-26_19-37-56-028066_TID2_crop_Schmetterling.jpg" --weights "insect-detect-ml-main/models/efficientnet-b0_imgsz128.onnx" --img 128 --sort-top1 --sort-prob --concat-csv --device cpu

python pytorchCUDAtest.py

jupyter notebook

python3.12 -m virtualenv env_yolov5

=Links=

[https://community.hiveeyes.org/t/insect-detect-von-max-sittinger/4906]

[https://insectactivitydetectionsystem.de/]

=Comments=
<comments />

Zigbee

2026-07-31T15:53:43Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Erst war ich skeptisch, ob Zigbee das Richtige als Ergaenzung fuer mein EIB/KNX ist. Es gab tatsaechlich in meinem Haus einen Fall, bei dem die vorhandene Elektroinstallation es nicht erlaubte eine Leuchte direkt (ohne Kernbohrungdurch die Stahlbetondecke) an den KNX anzuschlieszen. WLAN fuer 230V-Schalter war fuer mich OK.
Die Datenerfassung von Temperatur, Praesenz, usw. per KNX war an vielen Stellen aber schlecht oder gar nicht moeglich. Neben WLAN habe ich jetzt noch ein Zigbee-Netz installiert.

=Vorabueberlegungen=
* Matter ist keine Alternative. Es ist einfach noch nicht soweit.
* Ich brauche keine App-Unterstuetzung.
* Die Integration in Home Assistant soll nur ueber MQTT laufen.

NB: HA zu einer Eierlegendenwollmilchsau zu machen halte ich fuer keine gute Idee. Das heiszt fuer mich so viel als geht in MQTT zentieren und in HA (oder FHEM) die Automation hinterlegen. ZHA ist ueberfluessig. Zigbee2MQTT im docker auf meinem Homeserver war die beste Wahl.

=Startschwierigkeiten=
Nach der Installation von Zigbee2MQTT auf dem Homeserver habe ich auch eine Zigbee-Coordinator Anbindung über LAN probiert. Ich habe aber der USB-Stick Anbindung den Vorzug gegeben.

Erst hatte ich den default Kanal 11 belassen, aber schnell festgestellt, dass die Zigbees gegen mein WLAN (6 APs im Haus verteilt) nicht angekommen (Verbindungsabbrueche).

Zigbee unbedingt Kanal 25 einstellen.

Die zweite Huerde war, dass ich die notwendige Anzahl der Router unterschaetzt habe.

Nur steckerbetriebene Devices besitzen Routerfunktionalitaet.

Das fuehrte dazu, dass ich 10 weitere Smartplugs installiert habe, einfach nur um das Netz zu stabilisieren.

Der durchschnittliche Abstand fuer ein stabiles Netz ist beim mir etwa 5 Meter.

Was ich nervig finde ist, dass auf den Devices die IEEE-Address nicht abgedruckt ist. Ich habe schon nach den ersten 10 Devices (mittlerweile ueber 50) den Ueberblick verloren. Also alles auf Anfang und nach jedem Join direkt die IEEE-Address auf das Device geschrieben und gleich in Zigbee2MQTT den Installationsort in der Device-Beschreibung vermerkt.

=HA Automation=

HA ist zwar ganz nett, aber das unendliche Geklicke nur um einen Schalter mit einem Socket (Geraet) zu verbinden finde ich nervig.

Was ich brauche ist schnell und einfach eine Verknuepfung Zigbee -> MQTT -> Zigbee/KNX oder KNX -> MQTT -> Zigbee

Um die Zigbee/MQTT Entitaeten anzusprechen benoetige ich zun Eintragen in die 'automation.yaml' nur den entsprechenden Topic. Bei KNX habe ich noch keine einfachere Loesung gefunden als den "Umweg" ueber eine entity_id zur gehen. Hier mein erstes Testbeispiel.

<pre>
- id: '1774891422778'
alias: Licht_indirekt
description: ''
triggers:
- trigger: mqtt
options:
topic: zigbee2mqtt/0x00124b002919efa7
conditions:
- condition: template
value_template: '{{ trigger.payload_json.action == ''single'' }}'
actions:
- action: light.toggle
metadata: {}
data: {}
target:
entity_id: light.ug_r8_hobby_licht_indirekt
mode: single
</pre>

In dem Automationen-GUI wird der Eintrag in 3 Portionen angeboten.

'''Sobald''' (triggers)
<pre>
trigger: mqtt
options:
topic: zigbee2mqtt/0x00124b002919efa7
</pre>

'''Und wenn''' (conditions)
<pre>
condition: template
value_template: "{{ trigger.payload_json.action == 'single' }}"
</pre>

'''Dann'''
<pre>
action: light.toggle
metadata: {}
data: {}
target:
entity_id: light.ug_r8_hobby_licht_indirekt <- KNX.Entity
</pre>

Eine Unique_ID kann man nicht selbst vergeben! [https://www.home-assistant.io/faq/unique_id]

Um eine KNX-Gruppenadresse anzusprechen muss/sollte eine Entitaet (in der KNX YAML) angelegt sein.
Dann kann sie ueber die entity_id angesprochen werden.

Beispiel Licht:

<syntaxhighlight lang="yaml">knx:
light:
- name: Wohnzimmer Licht
address: "1/2/3"</syntaxhighlight>

danach existiert die Entity:

<pre>light.wohnzimmer_licht</pre>

D.h. der Entity-Name ergibt sich aus dem Namen in LowerCase und Unterstrichen.

Eine schnelle Loesung zum Testen geht auch mit:

= Alternative: KNX direkt per Service ansprechen =

ohne vorher eine Entity anzulegen:

<syntaxhighlight lang="yaml">action:
- service: knx.send
data:
address: "1/2/3"
payload: true</syntaxhighlight>
oder:

<syntaxhighlight lang="yaml">action:
- service: knx.send
data:
address: "1/2/3"
payload: 1</syntaxhighlight>

<span id="beispiel-dimmwert-senden"></span>
= Beispiel Dimmwert senden =

<syntaxhighlight lang="yaml">action:
- service: knx.send
data:
address: "1/2/5"
payload: 50</syntaxhighlight>

=HA "Programmierung"=

Bei **Home Assistant** kannst du die `configuration.yaml` **nicht komplett per CLI neu laden**, aber du kannst:

* die Konfiguration prüfen
* Home Assistant neu starten
* einzelne YAML-Bereiche neu laden

Hier sind die relevanten Befehle.

---

# 1. Konfiguration prüfen (ohne Neustart)

```bash
ha core check
```

prüft die `configuration.yaml` auf Fehler.

---

# 2. komplette Konfiguration neu laden (Neustart)

```bash
ha core restart
```

lädt die gesamte YAML neu.

---

# 3. nur YAML neu laden (ohne Neustart)

nicht alles kann hot-reload, aber viele Bereiche schon:

```bash
ha core reload
```

lädt unterstützte YAML-Komponenten neu.

---

# 4. nur MQTT neu laden

wenn du MQTT Entities geändert hast:

```bash
ha mqtt reload
```

---

# 5. Alternative über Service Call

```bash
ha service call homeassistant.reload_core_config
```

oder z. B.:

```bash
ha service call mqtt.reload
```

---

# 6. wenn du Home Assistant Container nutzt

```bash
docker restart homeassistant
```

---

# typische Nutzung

nach Änderung:

```bash
ha core check
ha core restart
```

---

# Übersicht

| Zweck | Befehl |
| ----------------- | --------------- |
| config prüfen | ha core check |
| alles neu laden | ha core restart |
| teilweises reload | ha core reload |
| mqtt reload | ha mqtt reload |

---

wenn du möchtest, kann ich dir auch zeigen:

* welche YAML Teile ohne Neustart reloadbar sind
* wie man YAML Fehler schneller findet
* wie man config automatisch prüfen lässt

=KNX Geraete Verwirrung=

In Home Assistant bilden '''Integration, Geraet und Entitaet''' eine Hierarchie. Der Unterschied ist wichtig, weil viele Einstellungen davon abhaengen.

Kurz gesagt:

<syntaxhighlight lang="text">Integration → Gerät → Entität</syntaxhighlight>

-----

<span id="integration"></span>

=1 Integration =

Die '''Integration''' ist die Schnittstelle zu einem System oder Protokoll.

Beispiele:

* MQTT
* KNX
* Zigbee
* Zigbee2MQTT
* ZHA
* Philips Hue

Eine Integration:

* stellt Verbindung her
* organisiert Kommunikation
* erzeugt Geräte und Entitäten

-----

<span id="gerät-device"></span>
=2 Geraet (Device) =

Ein '''Gerät''' ist ein physisches oder logisches Gerät im System.

Beispiele:

* Zigbee Temperatursensor
* KNX Aktor
* WLAN Steckdose
* Kamera

Ein Gerät kann mehrere Funktionen haben.

Beispiel Zigbee Sensor:

<syntaxhighlight lang="text">Gerät:
Temperatursensor Wohnzimmer</syntaxhighlight>
Eigenschaften:

* Hersteller
* Modell
* Firmware
* Verbindung (z. B. Zigbee Router)

-----

<span id="entität-entity"></span>
=3 Entität (Entity) =

Die '''Entität''' ist der einzelne messbare oder steuerbare Wert.

Beispiele:

<syntaxhighlight lang="text">sensor.wohnzimmer_temperatur
sensor.wohnzimmer_luftfeuchte
sensor.wohnzimmer_batterie</syntaxhighlight>
Alle gehören zum selben Gerät.

Eine Entität hat:

* Zustand (state)
* Attribute
* Einheit
* device_class

-----

<span id="beispiel-komplett"></span>
= Beispiel komplett =

<span id="zigbee-multisensor"></span>
== Zigbee Multisensor ==

<span id="integration-1"></span>
=== Integration ===

Zigbee2MQTT

<span id="gerät"></span>
=== Gerät ===

Multisensor Wohnzimmer

<span id="entitäten"></span>
=== Entitäten ===

<syntaxhighlight lang="text">sensor.wohnzimmer_temperatur
sensor.wohnzimmer_luftfeuchte
sensor.wohnzimmer_batterie
binary_sensor.wohnzimmer_bewegung</syntaxhighlight>

-----

<span id="beispiel-knx-aktor"></span>
= Beispiel KNX Aktor =

<span id="integration-2"></span>
=== Integration ===

KNX

<span id="gerät-1"></span>
=== Gerät ===

Schaltaktor Flur

<span id="entitäten-1"></span>
=== Entitäten ===

<syntaxhighlight lang="text">switch.flur_licht
sensor.flur_strom</syntaxhighlight>

-----

<span id="darstellung-im-home-assistant-ui"></span>
= Darstellung im Home Assistant UI =

<span id="integration-3"></span>
== Integration ==

<syntaxhighlight lang="text">Einstellungen → Geräte & Dienste</syntaxhighlight>
<span id="geräte"></span>
== Geräte ==

<syntaxhighlight lang="text">Geräteseite mit Eigenschaften</syntaxhighlight>
<span id="entitäten-2"></span>
== Entitäten ==

<syntaxhighlight lang="text">einzelne steuerbare Objekte</syntaxhighlight>

-----

<span id="merksatz"></span>
= Merksatz =

'''Integration''' = Verbindung zum System

'''Gerät''' = physisches Objekt

'''Entität''' = einzelne Funktion oder Messwert

-----

<span id="typische-verwechslung"></span>
= Typische Verwechselung =

Viele denken:

<syntaxhighlight lang="text">Gerät = Entität</syntaxhighlight>
Das stimmt nicht.

Ein Geraet enthält meist mehrere Entitaeten.

-----

= Beispiel aus der Praxis =

Steckdose mit Messfunktion:

Gerät:

<syntaxhighlight lang="text">Zigbee Steckdose Küche</syntaxhighlight>
Entitäten:

<syntaxhighlight lang="text">switch.steckdose_kueche
sensor.stromverbrauch_kueche
sensor.spannung_kueche
sensor.energie_kueche</syntaxhighlight>

-----

<span id="warum-das-wichtig-ist"></span>
= Warum das wichtig ist =

Unterschied relevant für:

* Automationen
* Dashboard
* Geräteverwaltung
* Diagnose
* Gruppierung

Automationen arbeiten meist mit:

<syntaxhighlight lang="text">Entitäten</syntaxhighlight>

-----

Wenn du möchtest, kann ich dir auch zeigen:

* wie Entitäten intern aufgebaut sind
* wie entity_id entsteht
* wann Home Assistant kein Gerät erzeugt
* warum MQTT oft nur Entitäten ohne Gerät erzeugt

Bei '''KNX''' und '''Home Assistant''' treffen zwei unterschiedliche Konzepte aufeinander:

* KNX ist '''telegramm- und funktionsorientiert'''
* Home Assistant ist '''geräte- und entitätsorientiert'''

Dadurch entsteht oft Verwirrung.

<span id="gesamtübersicht"></span>
= Gesamtübersicht =

<syntaxhighlight lang="text">KNX Welt Home Assistant Welt
------------------------------------------------------------
physikalische Adresse → Gerät (Device)
Gruppenadresse → Entität (Entity)
Funktion im Aktor → Entität (Entity)
KNX Busgerät → Gerät (Device)</syntaxhighlight>

-----

<span id="physikalische-adresse-knx"></span>
= Physikalische Adresse (KNX) =

Die physikalische Adresse identifiziert ein '''konkretes KNX-Gerät im Bus'''.

Format:

<syntaxhighlight lang="text">Bereich.Linie.Teilnehmer
z. B.
1.1.15</syntaxhighlight>
Eigenschaften:

* eindeutig im KNX Bus
* gehört zu einem realen Gerät
* wird für Programmierung und Diagnose verwendet
* wird normalerweise '''nicht direkt in Home Assistant genutzt'''

Beispiel:

<syntaxhighlight lang="text">1.1.20 = KNX Schaltaktor im Schaltschrank</syntaxhighlight>

-----

<span id="gruppenadresse-knx"></span>
= Gruppenadresse (KNX) =

Die Gruppenadresse ist die wichtigste Adresse für die Funktion.

Format:

<syntaxhighlight lang="text">Hauptgruppe/Mittelgruppe/Untergruppe
z. B.
1/2/10</syntaxhighlight>
Sie beschreibt:

<syntaxhighlight lang="text">Funktion</syntaxhighlight>
<ol start="26" style="list-style-type: lower-alpha;">
<li>B.:</li></ol>

<syntaxhighlight lang="text">1/2/10 = Licht Wohnzimmer EIN/AUS</syntaxhighlight>
KNX arbeitet primär über Gruppenadressen.

Mehrere Geräte können dieselbe Gruppenadresse verwenden:

Beispiel:

* Taster sendet
* Aktor empfängt

-----

<span id="gerät-home-assistant"></span>
= Geraet (Home Assistant) =

Ein Geraet ist die Zusammenfassung von Funktionen eines realen Geräts.

Beispiel:

<syntaxhighlight lang="text">KNX Schaltaktor 8-fach</syntaxhighlight>
enthält mehrere Kanäle:

* Kanal A
* Kanal B
* Kanal C

In HA:

<syntaxhighlight lang="text">Gerät = KNX Aktor</syntaxhighlight>

-----

<span id="entität-home-assistant"></span>
= 4️⃣ Entitaet (Home Assistant) =

Jede Funktion eines KNX-Geräts wird eine Entität.

Beispiel:

<syntaxhighlight lang="text">switch.licht_wohnzimmer
light.kueche
cover.rollladen_buero
sensor.temperatur_bad</syntaxhighlight>
Jede Entität verwendet eine oder mehrere Gruppenadressen.

-----

<span id="beispiel-knx-schaltaktor-4-fach"></span>
= Beispiel KNX Schaltaktor 4-fach =

KNX:

physikalische Adresse:

<syntaxhighlight lang="text">1.1.20</syntaxhighlight>
Gruppenadressen:

<syntaxhighlight lang="text">1/1/1 Licht Küche
1/1/2 Licht Flur
1/1/3 Licht Bad
1/1/4 Licht Büro</syntaxhighlight>
Home Assistant:

Gerät:

<syntaxhighlight lang="text">KNX Aktor 4fach</syntaxhighlight>
Entitäten:

<syntaxhighlight lang="text">switch.licht_kueche
switch.licht_flur
switch.licht_bad
switch.licht_buero</syntaxhighlight>

-----

<span id="beispiel-configuration.yaml"></span>
= Beispiel configuration.yaml =

<syntaxhighlight lang="yaml">knx:
switch:
- name: licht_kueche
address: "1/1/1"
state_address: "1/1/101"

- name: licht_flur
address: "1/1/2"
state_address: "1/1/102"</syntaxhighlight>

-----

<span id="beziehung-im-detail"></span>
= Beziehung im Detail =

<span id="physikalische-adresse"></span>
== physikalische Adresse ==

identifiziert:

<syntaxhighlight lang="text">Hardware-Gerät im KNX Bus</syntaxhighlight>
wird hauptsächlich genutzt für:

* ETS Programmierung
* Diagnose
* Busmanagement

-----

<span id="gruppenadresse"></span>
== Gruppenadresse ==

definiert:

<syntaxhighlight lang="text">Funktion im Gebäude</syntaxhighlight>
<ol start="26" style="list-style-type: lower-alpha;">
<li>B.:</li></ol>

* Licht schalten
* Dimmen
* Temperatur messen
* Jalousie fahren

-----

<span id="entität"></span>
== Entität ==

repräsentiert:

<syntaxhighlight lang="text">eine Funktion als Objekt in Home Assistant</syntaxhighlight>

-----

<span id="wichtig-zu-verstehen"></span>
= Wichtig zu verstehen =

Home Assistant kennt normalerweise:

<syntaxhighlight lang="text">Gruppenadresse</syntaxhighlight>
aber nicht zwingend:

<syntaxhighlight lang="text">physikalische Adresse</syntaxhighlight>
HA arbeitet funktionsorientiert.

-----

<span id="beispiel-taster"></span>
= Beispiel Taster =

KNX:

physikalische Adresse:

<syntaxhighlight lang="text">1.1.10</syntaxhighlight>
sendet Gruppenadresse:

<syntaxhighlight lang="text">1/1/1</syntaxhighlight>
Home Assistant:

keine eigene Entität notwendig, da der Aktor reagiert.

Optional:

<syntaxhighlight lang="text">binary_sensor.taster_wohnzimmer</syntaxhighlight>
wenn Status gewünscht.

-----

<span id="sonderfall-mehrere-gruppenadressen-pro-entität"></span>
= Sonderfall: mehrere Gruppenadressen pro Entität =

Dimmer:

<syntaxhighlight lang="yaml">knx:
light:
- name: wohnzimmer
address: "1/2/1"
state_address: "1/2/2"
brightness_address: "1/2/3"
brightness_state_address: "1/2/4"</syntaxhighlight>
Eine Entität nutzt mehrere Gruppenadressen.

-----

<span id="merkschema"></span>
= Merkschema =

<syntaxhighlight lang="text">physikalische Adresse
= KNX Hardware Adresse

Gruppenadresse
= KNX Funktion

Gerät
= KNX Gerät logisch zusammengefasst

Entität
= einzelne Funktion eines Geräts</syntaxhighlight>

-----

<span id="praxisregel"></span>
= Praxisregel =

Wenn du in Home Assistant arbeitest:

→ du brauchst meist nur die Gruppenadresse

die physikalische Adresse ist nur relevant für:

* ETS
* Diagnose
* Busstruktur

X Server

2026-07-31T15:53:42Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Problem=

Habe gerade das Problem, dass ein Rechner mit einer NVIDIA GTX1050Ti (2 DVI, 1 HDMI, 1 DP) an der nur an HDMI ein Monitor angeschlossen ist, nach einem Bildschirm-TimeOut die Ausgabe nicht auf HDMI aktiviert. Ein Ausstecken und wieder Einstecken aktiviert den Motor wieder. Auf Dauer ist da aber keine Loesung.
Wenn ich mich mit SSH auf den Rechner einlogge, quittiert xrandr zum Umschalten/Einschalten des Displays allerdings die Eingabe mit einem "Can't open DISPLAY". Das gleiche Problem hatte ich vor Jahren schon mal mit ferngesteuerten Schwarzen Brettern (Signature Displays).
Ich kann mich nur noch dunkel an die Loesung erinnern, deshalb hier ein paar Gedankenstuetzen.

Ein weiteres Problem, beim Betrieb von mehreren Monitoren, habe ich [https://tippvomtibb.de/wiki/index.php?title=Grafikkarte_mehrere_Monitore hier] beschrieben.

=Loesungshinweise=

* Der Login ueber SSH muss/sollte mit dem gleichen Benutzer erfolgen unter dem der X-Server laeuft.
* Den Befehlen wird/kann ein DISPLAY=:0.0 vorangestellt/werden. Dazu unten mehr.

Erst mal herausfinden welche Screens oder Display gibt es denn ueberhaupt.

worker:/home/chris # export |grep DISP
declare -x DISPLAY=":0"

worker:/home/chris # export |grep XAUTH
declare -x XAUTHLOCALHOSTNAME="worker"
declare -x XAUTHORITY="/root/.xauthzQiHUM"

chris@worker:~> ps axu |grep X
root 2471 0.0 0.2 6886860 279712 tty2 Ssl+ Nov27 2:58 /usr/bin/X -nolisten tcp -background none -seat seat0 vt2 -auth /run/sddm/xauth_qnDYsZ -noreset -displayfd 16

chris@server:/root> ps axu |grep X
root 9204 0.3 0.4 25577276 225592 tty7 Ssl+ Nov26 12:46 /usr/bin/X -nolisten tcp -auth /run/sddm/{e639dd90-50a8-4714-847c-c0f83977379d} -background none -noreset -displayfd 17 -seat seat0 vt7

Interessanterweise laeuft bei meinem Arbeitsplatzrechner (openSUSE 15.6) das virtuelle Terminal unter tty2, bisher war es standardmaeszig tty7.

Programme, die etwas mit X(Xorg) zu tun haben.
X(7), Xserver(1), xdm(1), xinit(1), xorg.conf(5), xvidtune(1), xkeyboard-config (7), apm(4), ati(4), chips(4), cirrus(4), cyrix(4), fbdev(4), glide(4), glint(4), i128(4), i740(4), imstt(4), intel(4), mga(4), neo-magic(4), nsc(4), nv(4), openchrome (4), r128(4), rendition(4), s3virge(4), siliconmotion(4), sis(4), sunbw2(4), suncg14(4), suncg3(4), suncg6(4), sunffb(4), sunleo(4), suntcx(4), tdfx(4), tga(4), trident(4), tseng(4), v4l(4), vesa(4), vmware(4)

Die DISPLAY-Variable hat die Form H:D.S

* Hostname default localhost, bzw. Socket
* Display
* Screen

Ein Display bezeichnet die gesamte Anzeigeumgebung, die durch einen X11-Server verwaltet wird. Ein X11-Server kann mehrere Displays unterstützen, die auf verschiedenen physikalischen Geräten oder auf verschiedenen Monitoren eines Systems laufen.
Ein Display besteht in der Regel aus einer Kombination von Hardware (Monitoren, Grafikkarten) und Software (dem X11-Server), die zusammen eine grafische Oberfläche bieten.

Ein Screen ist ein einzelner virtueller Monitor innerhalb eines Displays, der auf mehrere physikalische Monitore aufgeteilt sein kann.

Da es in der Regel nur ein Display und einen Screen gibt, wird die DISPLAY-Variable verkuerzt mit :0 angegeben.

declare -x DISPLAY=":0"

Folgender Befehl listet die aktiven Screens, Displays auf.

cd /tmp/.X11-unix && for x in X*; do echo ":${x#X}"; done

Das echo platziert noch einen Doppelpunkt davor und #X formatiert noch. [https://www.gnu.org/software/bash/manual/bash.html#Special-Parameters]

Dieses kleine Bash-Script listet alle Screen-Sockets im Verzeichnis /tmp/.x11-unix auf.

chris@server:/tmp/.X11-unix> ll X*
srwxrwxrwx 1 root root 0 Nov 26 20:40 X0

xdpyinfo scheint der richtige Weg zu sein.

chris@worker:/tmp/.X11-unix> xdpyinfo | grep -A4 '^screen'
screen #0:
dimensions: 7680x2160 pixels (1227x352 millimeters)
resolution: 159x156 dots per inch
depths (7): 24, 1, 4, 8, 15, 16, 32
root window id: 0x23f

Mit inxi -Ga erhaelt man noch mehr Klarheit, obwohl das ssh-Terminal im Gegensatz zum lokalen Terminal, die Screens nicht anzeigt.

server:/etc/X11 # inxi -Ga

Graphics:
Device-1: NVIDIA GP107 [GeForce GTX 1050 Ti] vendor: ASUSTeK driver: nvidia
v: 550.135 alternate: nouveau,nvidia_drm non-free: 530.xx+
status: current (as of 2023-05) arch: Pascal code: GP10x
process: TSMC 16nm built: 2016-21 pcie: gen: 1 speed: 2.5 GT/s lanes: 16
link-max: gen: 2 speed: 5 GT/s ports: active: none off: DP-1,HDMI-A-1
empty: DVI-D-1,DVI-D-2 bus-ID: 0f:00.0 chip-ID: 10de:1c82 class-ID: 0300
Display: server: X.Org v: 1.21.1.11 with: Xwayland v: 24.1.1
compositor: kwin_x11 driver: X: loaded: nvidia gpu: nvidia,nvidia-nvswitch
display-ID: :0 screens: 3 default screen: 0
Screen-1: 0 s-res: 1920x1080 s-dpi: 93 s-size: 524x292mm (20.63x11.50")
s-diag: 600mm (23.62")
Monitor-1: DP-1 note: disabled pos: primary
model: HannSpree/HannStar HE247DPB serial: 123456789XXXX built: 2012
res: 1920x1080 hz: 60 dpi: 94 gamma: 1.2 size: 521x293mm (20.51x11.54")
diag: 598mm (23.5") ratio: 16:9 modes: max: 1920x1080 min: 640x480
Monitor-2: HDMI-A-1 mapped: DVI-D-1 note: disabled model: Sony TV
serial: 168XXXXX built: 2007 res: 1920x1080 dpi: 30 gamma: 1.2
size: 1600x900mm (62.99x35.43") diag: 1836mm (72.3") ratio: 16:9 modes:
max: 1920x1080 min: 640x480
Screen-2: 1 s-res: 1920x1080 s-dpi: 30 s-size: 1626x914mm (64.02x35.98")
s-diag: 1865mm (73.44")
Screen-3: 2 s-res: 640x480 s-dpi: 75 s-size: 217x163mm (8.54x6.42")
s-diag: 271mm (10.69")
API: OpenGL v: 4.6.0 NVIDIA 550.135 renderer: NVIDIA GeForce GTX 1050
Ti/PCIe/SSE2 direct-render: Yes

Die Kernelmodul-Parameter sind bei mir z.B. auf dem Server (GTX1050Ti) und dem Worker (Quadro M2000)identisch.

chris@server:~> cat /proc/driver/nvidia/params
ResmanDebugLevel: 4294967295
RmLogonRC: 1
ModifyDeviceFiles: 1
DeviceFileUID: 0
DeviceFileGID: 483
DeviceFileMode: 432
InitializeSystemMemoryAllocations: 1
UsePageAttributeTable: 4294967295
EnableMSI: 1
EnablePCIeGen3: 0
MemoryPoolSize: 0
KMallocHeapMaxSize: 0
VMallocHeapMaxSize: 0
IgnoreMMIOCheck: 0
TCEBypassMode: 0
EnableStreamMemOPs: 0
EnableUserNUMAManagement: 1
NvLinkDisable: 0
RmProfilingAdminOnly: 1
PreserveVideoMemoryAllocations: 1
EnableS0ixPowerManagement: 0
S0ixPowerManagementVideoMemoryThreshold: 256
DynamicPowerManagement: 3
DynamicPowerManagementVideoMemoryThreshold: 200
RegisterPCIDriver: 1
EnablePCIERelaxedOrderingMode: 0
EnableResizableBar: 0
EnableGpuFirmware: 18
EnableGpuFirmwareLogs: 2
EnableDbgBreakpoint: 0
OpenRmEnableUnsupportedGpus: 1
DmaRemapPeerMmio: 1
ImexChannelCount: 2048
RegistryDwords: ""
RegistryDwordsPerDevice: ""
RmMsg: ""
GpuBlacklist: ""
TemporaryFilePath: ""
ExcludedGpus: ""

Einstellen kann man die Parameter unter /etc/modprobe.d mit einem conf-File.

==xauth==

Gleicher Rechner einmal als Hauptbenutzer und einmal als root.

chris@worker:~> xauth
Using authority file /home/chris/.xauthFAgo86
xauth> list
worker/unix:0 MIT-MAGIC-COOKIE-1 4608d1c4cf9a0d32e9b31fe3a04e768d
#ffff##:0 MIT-MAGIC-COOKIE-1 4608d1c4cf9a0d32e9b31fe3a04e768d
xauth>

worker:/home/chris # xauth
Using authority file /root/.xauthzQiHUM
xauth> list
worker/unix:0 MIT-MAGIC-COOKIE-1 4608d1c4cf9a0d32e9b31fe3a04e768d
#ffff##:0 MIT-MAGIC-COOKIE-1 4608d1c4cf9a0d32e9b31fe3a04e768d
xauth>

Was auffaellt:
* Das Authority-File liegt unter home.
* Der Name des Authority-Files wird gebildet, beginnend mit Punkt gefolgt von xauth und einem 6-stelligen Zufallsstring.

Das ist deswegen bemerkenswert, da auf meinem Server, beim root-Nutzer, dies nach den gleichen Regeln erkennbar ist.
Beim Hauptnutzer aber nicht!

Dort lag das Auhority-File unter /run/user/1000 und begann, ohne Punkt, mit xauth, Unterstrich und einem 6-stelligen Zufallsstring.

Ein "Mitbenutzen" des Xauth-Files fuehrt zum Fehler.

xauth: error in locking auhority file ...

Das MAGIC-COOKIE ist fuer beide Nutzer gleich.

=Loesung=

Das Vorgehen, welches bei mir den gewuenschten Erfolg erbracht hat, war im ersten Schritt, zum Testen, den Zugriff fuer jeden freizuschalten.
Dazu benutze ich das Programm xhost (Das musste ich noch nachinstallieren: zypper in xhost)

worker:/home/chris # xhost +
access control disabled, clients can connect from any host

Dies muss allerdings in einem Terminal in der X-Umgebung stattfinden. Erst dann hat man den Zugriff, z.B. mit xrandr von der Konsole, oder per SSH.Besser ist es natuerlich nur einem Nutzer dieses Recht einzuraeumen.

xhost +SI:localuser:username

Durch Fernbedienbarkeit kann ich nun den Monitor wieder aufwecken, ohne das HDMI-Kabel aus-/einzustecken.

Xrandr zeigte den Monitor als 'active' und 'connected'.

Wenn ich die Aufloesung mit mode kurz umschalte ist das Bild wieder da. Also stimmt irgendwas mit dem Timing nicht, oder vielleicht ist sogar das Kabel daran schuld.

chris@server:~> DISPLAY=:0 xrandr --output HDMI-0 --mode 1920x1080
chris@server:~> DISPLAY=:0 xrandr --output HDMI-0 --mode 3840x2160

=Loesung dauerhaft=

Das Dumme an der o.g. Loesung ist, dass die Freigabe durch xhost ein reboot nicht ueberlebt.

Ein Hinweis im Internet meint den entsprechenden Eintrag in /etc/X0.hosts vorzunehmen. Eine solche Datei existiert bei meiner Distri (openSuSE 15.6) nicht.

Ein Mitstreiter meint dazu:

X0.hosts ignored and also ssh login problem with X apps

I have just downloaded and installed the 32 bit server version on a couple of machines.

These machines are remote displays, no keyboards or mice, requiring a kick of from ssh to start the app. Its just bare sever install with TWM, X, and XDM.

Problem is they don't seem to read my /etc/X0.hosts file until theres been a keyboard login. After that locally xhost returns the names from the file.

I removed the exec /usr/bin/X -nolisten tcp "$@" line
from /etc/X11/xinit/xserverrc but this also is no help.

In the user .profile I have these 2 lines,

DISPLAY='0.0'
xhost +

This is a real chicken and egg thing, no auto login, no keyboard for login and no ssh X access before a local login. And no easy way to make it auto login with out installing GWM.

Is there something else to be done with this new Xorg release to enable starting an app on X by ssh?

Harry

fixed silly typo

DISPLAY=:0.0;
export DISPLAY

Die Freigabe mit xhost wird durchweg aus Sicheheitsgruenden nicht empfohlen. In der Regel wird ein ssh-X-Tunnel (ssh -XY) vorgeschlagen.

=Beifang=

Bei der Recherche habe ich gerade noch ein netten kleines Tool gefunden.

worker:/home/chris # hostnamectl
Static hostname: worker
Icon name: computer-desktop
Chassis: desktop 🖥
Machine ID: 3423XXXXXXXXXXXXXXXXXXXXXXXe0fea
Boot ID: 722dXXXXXXXXXXXXXXXXXXXXXXX77dd5
Operating System: openSUSE Leap 15.6
CPE OS Name: cpe:/o:opensuse:leap:15.6
Kernel: Linux 6.4.0-150600.23.25-default
Architecture: x86-64
Hardware Vendor: Hewlett-Packard
Hardware Model: HP Z840 Workstation
Firmware Version: M60 v02.62
Firmware Date: Thu 2024-01-04
Firmware Age: 10month 3w 5d

Noch ein nettes Tool.

chris@server:~> loginctl session-status
11 - root (0)
Since: Fri 2024-11-29 17:49:35 CET; 2h 32min ago
Leader: 9216 (sshd)
TTY: pts/3
Remote: 192.168.178.218
Service: sshd; type tty; class user
State: active
Unit: session-11.scope
├─ 1807 loginctl session-status
├─ 1808 less
├─ 9216 "sshd: root [priv]" "" "" ""
├─ 9234 "sshd: root@pts/3" "" "" "" ""
├─ 9238 -bash
├─ 32710 su chris
└─ 32711 bash

Websocket (Programmierung)

2026-07-31T15:53:40Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Wie programmiert man eine Websocket-Kommunikation in Javascript, Python, PHP, ...?

=Javascript=
Als erstes benoetigt man eine Instanz eines Websocket-Objektes (Javascript-API des W3C (/ˈdʌbəl.juː ˈkjuːbd/ C)).

var meinWebSocket = new WebSocket('<URL>',['<Subprotokoll>',...]);

Die Angabe des Subprotokolls ist optional.

Das fuehrt zu einem WebSocket Opening-Handshake-Request ueber HTTP.

<code>
GET /chat HTTP/1.1
Host: server.example.com
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Key: dGhlICLhbXBsZSBub14jXY==
Origin: http://example.com
Sec-WebSocket-Protocol: chat, superchat, soap, wamp, ....
Sec-WebSocket-Version: 13
Sec-WebSocket-Extensions: .......
</code>

WebSocket Opening-Handshake-Response

<code>
HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept: s3pPCLBiTxaQ9kYGzzhZRbK+OMG= (key nicht valide)
Sec-WebSocket-Protocol: chat
</code>

Sec-WebSocket-Accept benutzt den Sec-WebSocket-Key und haengt eine [https://de.wikipedia.org/wiki/Universally_Unique_Identifier GUID] an. Diese Zeichenkette wird dann mittels der Hashfunktion SHA-1 verschlüsselt und dann noch Base64 kodiert, um sie als Textstring uebertragen zu koennen.

TODO Algorithmus

Nachdem Instanzieren und der Verbindungsaufnahme kann sich die Verbindung in 4 moeglichen Zustaenden (readyState) befinden.

{| class="wikitable"
!Zustand!!readyState!!Beschrebung
|-
|CONECTING||0||Objekt instanziert; Vebindung zum Server wird aufgebaut
|-
|OPEN||1||Verbindung erfolgreich aufgebaut; Kanal kommunikationsbereit
|-
|CLOSING||2||Verbindung wird geschlossen (Closing-Handshake)
|-
|CLOSED||3||Verbindung geschlossen, oder Verbindungsaufbau gescheitert
|}

Beim Wechsel des readyStates wird ein Event ausgeloest.

{| class="wikitable"
!Eventhandler!!Event!!Beschrebung
|-
|onopen||open||State geht in OPEN
|-
|onerror||error||Fehler beim Verbindungsaufbau oder bei der Kommunkiation
|-
|onmessage||message||Nachricht trifft ein
|-
|onclose||close||Verbindung geschlossen, oder Verbindungsaufbau gescheitert
|}

Die Eventhandler sind Attribute des WebSocket-Objektes.

==Codeschnipsel==
===onopen===
<syntaxhighlight lang="javascript">
meinWebSocket.onopen = function() {
console.log('WebSocket-Verbindung aufgebaut!');
meinWebSocket.send('...');
}
</syntaxhighlight>
===onerror===
<syntaxhighlight lang="javascript">
meinWebSocket.onerror = function(event) {
let reason = event.reason;
let code = event.code;
console.log('WebSocket-Verbindung Error: ' + reason + '(' + code + ')');
}
</syntaxhighlight>
===onmessage===
<syntaxhighlight lang="javascript">
meinWebSocket.onmessage = function(message) {
let data = message.data;
console.log('WebSocket-Nachricht: ' + data);
}
</syntaxhighlight>
===onclose===
<syntaxhighlight lang="javascript">
meinWebSocket.onclose = function(event) {
let state = event.readyState;
console.log('WebSocket-ReadyState: ' + state);
}
</syntaxhighlight>

Es ist auch moeglich die Eventhandler-Funktionen imt der Methode addEventListener() bekannt zu machen.

meinWWebSocket.addEventListener("",Funktion()){...};

Hiermit sind dann auch mehrere Handler-Funktionen pro Event moeglich.

=First Contact=

Achtung [https://piehost.com/blog/echo-websocket-org-alternative][https://github.com/websocket-client/websocket-client/issues/779]
Es gibt irgendwie keinen oeffentlichen EchoServer mehr.

Das Angebot der [https://www.postman.com/product/what-is-postman/ Website von postman.com] lohnt einen tieferen Blick. Das [https://learning.postman.com/docs/introduction/overview/ "Learning Center"] sieht sehr interessant aus. Mal [https://learning.postman.com/docs/developer/echo-api/ den] Echoservice ausprobieren.

<syntaxhighlight lang="javascript">
<!doctype html>
<html lang="de">
<body>
<script type="text/javascript">
var meinWebSocket = new WebSocket('wss://ws.postman-echo.com/raw');

meinWebSocket.onopen = function() {
console.log('WebSocket-Verbindung aufgebaut.');
meinWebSocket.send('Hallo Welt!');
console.log('WebSocket-Nachricht verschickt.');
}

meinWebSocket.onerror = function(event) {
let reason = event.reason;
let code = event.code;
console.log('WebSocket-Verbindung Error: ' + reason + '(' + code + ')');
}

meinWebSocket.onmessage = function(message) {
let data = message.data;
console.log('WebSocket-Nachricht vom Server: ' + data);
}

meinWebSocket.onclose = function(event) {
let state = event.readyState;
console.log('WebSocket-ReadyState: ' + state);
}
</script>
</body>
</html>
</syntaxhighlight>

Die Console zeigt nach der Ausfuehrung folgende Eintraege.
WebSocket-ReadyState: undefined websocketechojs.html:25:10
WebSocket-Verbindung aufgebaut. websocketechojs.html:8:10
WebSocket-Nachricht verschickt. websocketechojs.html:10:10
WebSocket-Nachricht vom Server: Hallo Welt! websocketechojs.html:21:10

Weiterer Quellcode [https://socketsbay.com/test-websockets]

Und [http://websocketstest.com/ hier] ein WebsocketTester.

=Request for Comments=

<comments />

=Links=
[https://web-development.github.io/applied-js-and-css/websocket/]

Wärmepumpe

2026-07-31T15:53:39Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Auf der Suche nach einer nachvollziehbaren Einscheidungshilfe zur Anschaffung einer (Pool-)Wärmepumpe bin ich auf viele Seite gestoszen, die zwar durchaus brauchbare Informationen bereit gehalten haben, aber trotzdem blieb eine Unsicherheit zur genauen Beurteilung einer Anlage eines bestimmten Herstellers.

Ein Auslöser für diese Unsicherheit war z.B. folgende Textpassage von [https://www.upoolia.com/poolheizungen/pool-waermepumpe upoolia.de]

Zitat:
Wie werden Leistungsdaten geschönt?
Bei den Leistungsangaben zu Wärmepumpen wird möglicherweise noch mehr gelogen wie bei den Verbrauchszahlen im Automobilbau. Dies gilt auch oder vielleicht sogar besonders für die Anbieter die sich im Internet rühmen der größte Hersteller zu sein.
Geht man zum Beispiel bei der Wertermittlung davon aus, dass das Eingangswasser nur 10°C ist und die Umgebungstemperatur 26°C ist kommen natürlich bessere COP Werte und damit Wirkungsgrade heraus als bei 15°C Eingangs-Wassertemperatur und 10°C Außentemperatur. Wie der Idealwert ermittelt wurde wird leider verschwiegen. (Siehe Diagramm zum Wirkungsgrad in Abhängigkeit von den Temperaturen)
Pumpensysteme besitzen wie Autos eine ideale Betriebsgeschwindigkeit. Geht man an die obere Leistungsgrenze (maximale Heizleistung) verschlechtern sich die Werte erheblich (Ihr Auto braucht bei Vollgas auch mehr Benzin für 100 gefahrene km.) Ist man zu weit unten entsteht der gleiche Effekt. Inverter-Pumpen sind Drehzahlgeregelt. Die Angaben beziehen sich auf einen sehr geringen Drehzahlbereich, der nur beim Halten der Pool-Temperatur mit optimalen Außentemperaturen und geringen Wassereingangstemperaturen erreicht wird.

=Einstieg=
Um eine genauere Basis zur Abschaetzung zu erhalten, lohnt sich wie so oft eine Blick nach Wikipedia.

Eine solche Wärmepumpe gehoert zu den '''thermischen Maschinen'''. Diese werden in '''Waermekraftmaschinen''', '''Kaeltemaschinen''' und '''Waermepumpen''' eingeteilt.
Es gibt Literatur, die die Kaeltemaschinen und Waermepumpen zu Kraftwaermemaschinen zusammenfassen. Dies ist durchaus sinnvoll, da dann die Aufteilung in '''rechts'''drehender Kreisprozess (Uhrzeigersinn) bei '''Waermekraft'''maschinen und '''links'''drehender Kreisprozess (Gegenuhrzeigersinn) bei '''Kraftwaerme'''maschinen sehr deutlich wird.
Um deren Funktionsprinzip besser zu verstehen, sollte man ein Verstaendnis fuer den Kreisprozess einer periodisch arbeitenden Waermekraftmaschine, bzw. Kraftwaermemaschine entwickeln.
Man hat ein Arbeitsmedium, das verschiedene Zustandsaenderungen (Druck, Volumen, Temperatur und Energie) durchlaeuft.
Fuer die theoretische Erlaeuterung ist es ausreichend einen solchen (Kreis-)Prozess mit nur 2 Zustaenden zu betrachten.
Im pV-Diagramm (auch p,V-Diagramm, oder p,v-Diagramm) ergibt sich qualitativ die folgende Darstellung.

[[Datei:Kreisprozess.png|500px]]

Rechtsprozess (obere Grafik): Umwandlung von Waermeenergie in mechanische Arbeit (Q->W)

Linksprozess (untere Grafik): Umwandlung von mechanischer Arbeit in Waermeenergie (W->Q)

==Anmerkungen zum pV-Diagramm==
Der Druck wird in bar angegeben. Die gesetzliche, aber nicht SI-Einheit, hat nur den Vorteil, dass die Zahlen an der y-Acchse nicht so grosz sind. Man koennte aber genau so gut 10^5 Pa schreiben.
Das Pascal ist im Internationalen Einheitensystem (SI) die Maßeinheit des Drucks sowie der mechanischen Spannung. Sie ist nach Blaise Pascal benannt und folgendermaßen definiert:

1 Pa = 1 N·m−2

Hektopascal (1 hPa = 100 Pa) und dem Kilopascal (1 kPa = 1000 Pa) auch das Bar (1 bar = 10^5 Pa = 100 kPa)

Der mittlere Luftdruck der Atmosphäre auf Meereshöhe (Standard- bzw. Normdruck) beträgt

1 atm = 101325 Pa = 1013,25 hPa = 1,01325 bar = 1013,25 mbar.

Wie beim Druck mit bar verhaelt es sich auch beim Volumen. Ein Liter ist zwar eine gesetzliche Maszeinheit, aber 0,001 m^3 ist etwas sperrig.
Der Liter wird noch durch die Stoffmenge (SI-Einheit) geteilt.

Avogadrosches Gesetz: Gleiche Volumina verschiedener Gase enthalten bei gleichem Druck und gleicher Temperatur die gleiche Anzahl an Teilchen. Mit anderen Worten, 1 Mol eines (idealen) Gases nimmt bei 0 °C und 101325 Pa ein Volumen von 22,4 l ein. Dieses Gesetz gilt streng nur für ideale Gase.

Wenn man also an der x-Achse einen Wert von z.B. 40 angeschrieben findet, sind das 40 l/mol (Liter pro mol).

Mit der 2D-Darstellung des pV-Diagramm konnte ich mich noch nie richtig anfreunden. Die Isochoren und Isobaren sind zwar sehr einfach zu deuten, aber die dritte Dimension, die Temperatur, faellt entweder unter den Tisch oder wird als "Tiefenwert" in die 2D-Darstellung eingefuegt.
Um aber isotherme, isentrope (adiabatische), polytrope Vorgaenge zu erkennen/deuten/verstehen ist fuer mich die 3D-Darstellung also p(V,T) unverzichtbar.

=Thermische Maschinen=
Legende: rot="Warmseite" blau="Kaltseite" gruen="Energiegewinn Haupteffekt" grau="Energiestrom (Waerme/Elektro) Nebeneffekt"

[[Datei:ThermischeMaschinen.png|500px]]

==Waermekraftmaschinen==
Der Carnot-Prozesz z. B. wird rechtsherum (Rechtsprozess/Plus-Zyklus) durchlaufen.
In diesem Fall wird Waermeenergie in mechanische Energie gewandelt.
Typische Vertreter sind der Verbrennungsmotor oder Dampfmaschine.
Dieser Maschinentyp soll hier nicht naeher betrachtet werden.

==Kraftwaermemaschinen==
Der Kreisprozess wird linksherum (Linksprozess/Minus-Zyklus)durchlaufen.
Typische Vertreter sind Waermetauscher (Kuehlschrank, Klimaanlage) und Waermepumpen.

[[Datei:Heatpump2.svg|mini]]

Beim Linksprozess muessen wir mechanische Arbeit zufuehren um den Kreislauf zu durchlaufen,

da der "Rueckweg" mehr Energie benoetigt als der "Hinweg".

Die mechanische Arbeit wird von einem Kompressor/Verdichter erbracht, der elektrische Energie in mechanische umwandelt, die zum "Antreiben" des Waermestroms dient.

Neben dem Kompressor/Verdichter (4) gibt es fuer den Zustandsablauf noch drei weitere technische Bauteile, den Verdampfer (3), den Kondensator (1) und eine Drossel (2).

Dieser Aufbau ist beim Kuehlschrank, Klimaanlage und Waermepumpe weitestgehend identisch.

Wie kann man sich nun den technischen Ablauf am besten merken.

Fangen wir mit dem Kompressor an. Er nimmt die notwendige (elektrische) Energie auf, um vom Zustand 2 (V grosz,p klein) zurueck zum Zustand 1 (V klein, p grosz) zu kommen. Er ist also fuer eine Volumenverkleinerung und Druckerhoehung verantwortlich.
Der "Gegenspieler" zum Kompressor ist die Drossel. Ohne sie wuerde der Kompressor ins "Leere" arbeiten. Die Druckerhoehung (mit Volumenverkleinerung) geschieht also nur weil am "Ausgang" des Kompressors eine Drossel den "Ausweg" verkleinert.
Jeder der schon mal mit einer Luftpumpe gearbeitet hat kennt den Effekt, dass wenn man das Luftaustrittsventil zuhaelt, die Pumpe beim Zusammenschieben warm wird. Diese Waerme wird durch einen Waermetauscher zwischen Kompressor und Drossel abgegeben. Wenn man weisz (s.u.), dass condensare dicht zusammendraengen heiszt, liegt es nahe diesen Waermetauscher Kondensator zu nennen. Nach dem Zustand 1 gibt die Drossel das Gas (evtl. sogar fluessig) wieder in die "Freiheit". Der Druck sinkt und das Volumen nimmt wieder zu. Dieser Vorgang benoetigt Energie, die aus der Umgebung mit Hilfe eines weiteren Waermetauschers (Lamellenwaermeuebertrager bei der Waermepumpe) genommen wird. An dieser Stelle ist es hiflreich, sich nochmal zu vergegenwaertigen, dass es Kaelte physikalisch eigentlich gar nicht gibt, sondern kalt eigentlich mit weniger warm besser ausgedrueckt werden kann. Da der zweite Waermetauscher Energie aus der Umgebung aufnimmt, um die Volumenzunahme des Kreislaufmittels zu unterstuetzen, "fehlt" diese Energie in der unmittelbaren Umgebung des Waermetauschers. Der Umgebung wird also Energie entzogen, allerdings weniger als der Kondensator an Waermeenegie abgibt. Die unmittelbare Umgebung wird also kaelter. Diese kalte Luftmasse wird durch einen Ventilator wegtransportiert, um fuer "neue" waermere Luft Platz zu machen. Merke: Kaelte ist fehlende Waerme:-) Der zweite Waermetauscher wird auch Verdampfer genannt, da die eingesetzten "Kaeltemittel" idR fluessig die Drossel verlassen und danach im Waermetauscher verdampfen, also ihren Aggregatzustand von fluessig nach gasfoermig wechseln und dabei Waerme aufnehmen (muessen).

Auf dem Foto auf dieser [https://www.lieber-lieber.de/service/waermepumpentausch Seite] sieht man gut den Verdichter, die zwei Waermetauscher und die Drossel. Leider ist das Bild zu schlecht um die anderen Komponenten auszumachen.

Eine sehr schoene schematische Darstellung einer Waermepumpe findet sich [https://www.danfoss.com/de-de/markets/buildings-commercial/dcs/heat-pumps/#tab-related-applications hier]

Eine noch detailliertere Beschreibung ist [https://www.energie-experten.org/heizung/waermepumpe hier] entnommen.

Zitat:

Während der Verdampfer Wärme aufnimmt, gibt der Verflüssiger (Kondensator) die Wärme des vom Verdichter kommenden heißen Kältemittelgases über einen Wärmetauscher an das Heizungswassers wieder ab. Dabei tritt der überhitzte Dampf in den Verflüssiger ein, wird auf Verflüssigungstemperatur abgekühlt (Erhitzung) und kondensiert (Verflüssigung). Nach der Verflüssigung des Kältemittels wird das Kondensat noch weiter gekühlt (Unterkühlung), um Dampfblasen vor dem Expansionsventil zu vermeiden. Diese könnten sonst die Flüssigkeitszufuhr zum Verdampfer mindern und diesen in seiner Funktionsfähigkeit einschränken.

Damit der Dampf jedoch Wärme an die Umgebung abgeben kann, muss seine Temperatur höher liegen, als die Umgebungstemperatur. Dies ist nur bei sehr hohen Drücken möglich ist. Bei einer Umgebungstemperatur von 40 °C muss z.B. das Kältemittel R12 auf über 10 bar komprimiert werden. Die obere Temperatur, bei der die Wärmepumpe noch Energie an die Umgebung abgeben kann, hängt also stark davon ab, wie hoch der Dampf im Verdichter komprimiert werden kann, was wiederum die Leistungszahl bzw. Jahresarbeitszahl der Wärmepumpe beeinflusst.

Verflüssigen und Verdampfen sind zwei zentrale Prozesse in einer Wärmepumpe. Die Verflüssigung bezeichnet den Phasenübergang eines Gases oder Gasgemisches in den flüssigen Aggregatzustand. Analog dazu ist Verdampfung der Phasenübergang einer Flüssigkeit oder eines Flüssigkeitsgemisches in den gasförmigen Aggregatzustand. Die sehr ähnliche Funktion des Verdampfers und des Verflüssigers machen es daher recht einfach möglich, mit einer Wärmepumpe auch zu kühlen, indem nur die Funktionen von Verdampfer und Verflüssiger getauscht werden. Aus technischer Sicht geschieht dies durch ein Umschaltventil, zwei Rückschlagventile und ein zweites Expansionsventil.

Im Verflüssiger wird der Wärmestrom vom Kältemittel zu Heizmedium durch die Übertragungsfläche des Wärmetauschers, die Temperaturdifferenz und die Wärmedurchgangszahl bestimmt. In Wärmepumpen beträgt die Temperaturdifferenz beim Heizmedium Wasser etwa 2 bis 5 Kelvin (K) und beim Heizmedium Luft wie bei Luft/Luft-Wärmepumpen rund 5 bis 10 K. Die Wärmemenge, die der Verflüssiger auf das Heizmedium überträgt, ist daher in etwa die Summe der Wärme, die im Verdampfer aufgenommen wurde, plus der vom Verdichter aufgenommenen elektrischen Energie.

===Kondensieren===

Wortherkunft: lateinisch condensare → la „dicht zusammendrängen“, einer Ableitung zum Adjektiv densus → la „dicht“ mit dem Präfix con- → la „mit, zusammen“;

Synonym kann auch verflüssigen (seltener: dehydratisieren, eindampfen, evaporieren) benutzt werden.

Ein Kondensator (oder Kondenser) ist ein Apparat, in welchem ein Stoff vom gasförmigen Aggregatzustand in den flüssigen Aggregatzustand überführt wird (Kondensation).

Diese Definition eines Kondensator ist zu kurz gegriffen und laesst eine Verbindung zum elektrischen Kondensator nicht mehr zu.
Besser waere eine Definition wie folgt:

Ein Kondensator ist ein (technischer) Gegenstand, der ein Medium dicht zusammendrängt.

Besser als Gegenstand finde ich noch Device.

Das Medium beim elektrischen Kondensator waeren die Elektronen und bei einem Kondenser waere es z. B. Wasser.

Der Kondensator wird auch Verfluessiger genannt.

===Expansionsorgan===

Das Expansionsorgan ist ein Bauteil einer Wärmepumpe≡, das zwischen Verflüssiger und Verdampfer eingebaut wird und zur Absenkung des Druckes (Entspannung des Gases) erforderlich ist.

Das Expansionsorgan, eigentlich Expansionsventil ist ein gesteuertes Drosselventil (Drossel). Es heißt so, weil es die Expansion im Verdampfer so steuert, dass möglichst kein flüssiges Kältemittel mehr übrig bleibt. Damit soll der (Gas-)Kompressor geschuetzt werden.

===Rohrleitungen===
Duenne Rohre deuten auf fluessige Phase und dicke Leitungen auf gasfoermige Phase hin.

==Warmepumpenparameter==

===Kaeltemittel===
Die Daten sind der Anleitung meiner Waermepumpe entnommen.

Das Gerät enthält das fluorierte Treibhausgas Difluormethan (R32), welches für die Funktionalitaet des Geräts erforderlich ist. Die industrielle Bezeichnung lautet HFKW-32. Die gebraeuchliche Bezeichnung ist R32. Die chemische Bezeichnung ist Difluormethan und die chemische Summenformel ist CH2F2. Das Treibhauspotential ist mit GWP675 angegeben.

===Jahresarbeitszahl===
Das Verhältnis zwischen Umgebungswärme und Antriebsenergie drückt sich in der '''Jahresarbeitszahl''' einer Wärmepumpe aus. Je höher diese Zahl, desto größer ist der Anteil der kostenlosen Umweltenergie und desto weniger Antriebsenergie wird benötigt. Hierfür sollte die Wärmequellentemperatur hoch und die Vorlauftemperatur des Heizkörpers niedrig sein.
Fuer LuftWasserWaermepumpen wurde eine Jahresarbeitszahl von 3 bestimmt.

Gaengige Leistungsbezeichnungen für Luft/Wasser-Wärmepumpen sind A10/W35, A2/W50 und A2/W35.

https://www.vaillant.de/heizung/heizung-verstehen/tipps-rund-um-ihre-heizung/jahresarbeitszahl/

===Wirkungsgrad===
Gern wird im Zusammenhang mit dem Wirkungsgrad der Coefficient Of Performance (COP) bzw. die Leistungszahl von Wärmepumpen genannt oder gar faelschlicherweise gleichgesetzt.

Ein Koeffizient ist ein konstanter Faktor, ein COP sozusagen ein Leistungsfaktor. Gelegentlich liest man auch Leistungsziffer was unterstellt das bei 9 im Dezimalsystem Schluss waere;-). Der COP ist also eine Zahl ohne Einheit die das Verhaeltnis von Heizleistung und Eingangsleistung ins Heizsystem ausgedrueckt wird. Die Eingangsleistung ins Heizsystem ist etwas niedriger, durch Luefter, Steuerung, ... als die elektrische Eingangsleistung der Waermepumpe.

Auch die Angabe nach der Europäischen Norm EN 14511 ist zur Ermittlung des Wirkungsgrades wenig hilfreich.
A10/W35 = COP 4,3
A2/W50 = COP 2,7
Besser waere es eine Messkurve, oder besser noch eine Funktion f(TLuft,TWasser) anzugeben wonach sich der COP einer jeden Betriebssituation ermitteln lassen wuerde.

[https://www.bauwion.de/begriffe/leistungszahl-cop-en-14511 Zitat:]

Leistungszahl (COP) nach EN 14511

Die Wirtschaftlichkeit von Wärmepumpen wird durch die sogenannte Leistungszahl ε beschreiben. Man nennt die Leistungszahl auch Coefficient of Performance (COP). Sie definiert sich durch das Verhältnis zwischen der erzeugten Heizleistung und dem aufgenommenen elektrischen Antriebsstrom einer Wärmepumpe. Je höher diese Zahl ist, desto besser ist der Wirkungsgrad. Grundsätzlich kann die Leistungszahl nach DIN EN 255-3 oder DIN EN 14511 ermittelt werden, die jeweils von unterschiedlichen Spreizungen bei der Vorlauftemperatur ausgehen, so dass auch unterschiedliche Leistungszahlen entstehen. Um vergleichbare Werte verschiedener Systeme gegenüberstellen zu können, müssen also die sowohl die Norm als auch die Rahmenbedingungen übereinstimmen, unter denen die Werte unter Laborbedingungen ermittelt wurden. Hierzu werden folgende genormte Prüfkurzzeichen verwendet, die den Betriebszustand der Prüfung beschreiben:

W= Water, Wasser
B= engl. Brine (=Sole)
S= Sole
A= engl. Air (=Luft)
E= Erdreich

Beispiel: A0/W35 = 3,0

Die Kennzeichnung bedeutet, dass eine Luftwärmepumpe bei einer Außenlufttemperatur von 0°C (A0) und einer Vorlauftemperatur von 35°C (W35) aus einem Kilowatt elektrischer Antriebsleistung 3,0 kW Heizleistung erwirtschaftet. Die Leistungszahl bzw. der COP ist in diesem Beispiel 3,0. Grundsätzlich ist beim Vergleich der Leistungszahlen genau darauf zu achten, nach welcher Norm und welchen Betriebspunkten die Werte ermittelt wurden. Dagegen sind die Ergebnisse aus den unabhängigen Prüfungen des EHPA (European Heat Pump Association) nach normierten Bedingungen entstanden, so dass die dort veröffentlichten Werte immer vergleichbar sind.

Formel: COP = Heizleistung / elektr. Antriebsleistung Einheit: keine

Eine Überschlagrechnung sagt mir, dass bei einem kWh-Preis fuer elektr. Strom von ca. 27 ct. (Stand 12/2021) und einem kWh-Preis bei Gas von ca. 6 ct (Stand 12/2021) muesste eine Waermepumpe unter allen Betriebsbedingungen (Sommer, Winter, ...) mindestens einen COP von 4,5 haben, dass sich eine Waermepumpe gegenueber einer Gasheizung lohnt und da ist der hoehere Anschaffungspreis noch nicht beruecksichtigt. Viele technische Informationsblaetter der WP-Hersteller bleiben einen "Durchschnitts-COP" schuldig. Gerne wird mit einem maximalen COP geworben, der in der Regel aber nur unter Idealbedingungen erreichbar ist. Da man (leider) sein Gas nicht selbst produzieren kann, bleibt eigentlich nur noch die Moeglichkeit an der Stromschraube zu drehen. Mit meiner PV-(Insel)Anlage habe ich zur Zeit Gestehungskosten von 8 ct/kWh und mit Speicher von etwa 17 ct/kWh. Dann sieht die Rechnung schon deutlich besser aus. Dann auch wieder eine Waermepumpe mit PV-Strom als Poolheizung ideal, im Winter braucht man aber doch recht viel Flaeche fuer eine PV-Anlage, die auch im Winter genuegend Strom zur Verfuegung stellt, um eine Waermepumpe (moeglicht keine Luft) zu betreiben und die E-Autos wollen im Winter ja auch noch voll geladen werden. Da kommen einem die "neuen" PV-Module aus China mit 600 Wp gerade recht. Damit ist der Flaechenbedarf nicht mehr ganz so grosz wie noch vor einigen Jahren. Hier im Saarland liegt der Ertrag im Winter im Dezember dann doch bei schlappen 20 kWh/Wp. Ich runde mal groszzuegig für Nov, Dez und Jan auf je 30 kWh/Wp auf, damit es sich besser rechnen laesst. Das sind also 1kWh pro Wp. Um den Pool auf Temperatur zu halten ist eine kWh schnell aufgebraucht. Ein E-Auto benoetigt etwa 10 kwh auf 100 km. Um z.B. Pool und Auto zu unterhalten sind schnell 5 kWh pro Tag notwendig. Was mit einer 5 kWp-Anlage nach erreichbar scheint. (Messungen folgen ...). Eine 5 kWp-Anlage hat etwa einen Flaechenbedarf (10 Module) 17 qm. Diese Zahl erscheint mir recht niedrig. Ich werde in Q1/2022 mit einen 60 qm Anlage eine Testreihe beginnen. Bericht folgt.

===Technische Daten===
*Modell:BP-39WS-B Mini
*Artikelnummer:049273
*Gesamtgewicht (netto/brutto):19kg / 21kg
*Abmessungen (B x H x T):365mm × 370mm x 320mm
*Heizleistung *:3,9kW
*Eingangsleistung Heizung *:0,65kW
*Bewertung der Eingangsleistung0,85kW
*Eingangsstrom Heizung *:3,3A
*Betriebsspannung und -frequenz **:220-240V~, 50Hz
*Leistungsziffer COP6,0
*Schutzklasse:I
*Schutzart:IPX4
*Schallleistungspegel:47 dB(A)
*Material Wärmeübertrager:Titan in PVC
*Durchsatz Wasser:3m3/h - 4m3/h
*Durchsatz Luft:1200m3/h
*Arbeitsdruck Niederdruckseite:0,7MPa
*Max. BetriebsdruckNiederdruckseite:1,5MPa
*Arbeitsdruck Hochdruckseite:3,0MPa
*Max. Betriebsdruck Hochdruckseite:4,3MPa
*Kältemittel:R32Masse Kältemittel:280g
*Treibhauspotential GWP:675CO2-Äquivalent:0,19kg/t
*Temperaturanstieg Poolwasser***(Außentemp.=Wassertemp.=26°C)
*10m³ 0,3°C/h
*20m³ 0,2°C/h
*30m³ 0,1°C/h
*40m³ 0,1°C/h
*50m³ 0,1°C/h
* variabel - in Abhängigkeit der Umgebungsbedingungen.
** Einphasenwechselstrom
*** Wärmeverlust wurde nicht berücksichtigt (z.B.: mit oder ohne Abdeckung, Isolierung, ...)

=Faustformeln=
TODO

=Weiterfuehrende Quellen=
Ein wirklich tolles Dokument kommt von der Firma Siemens (siemens.de/buildingtechnologies) mit dem Namen Kältetechnik (Siemens-Kaeltetechnik.pdf). Leider kann ich aufgrund von Copyright-Bestimmung das Dokument hier nicht zum Download anbieten,
das Kundenbetreuungscenter von Siemens hilft aber bestimmt gerne weiter.

Siemens AG Building Technologies Division Lyoner Straße 27 60528 Frankfurt am MainKundenbetreuungs-Center Tel. 0800 100 76 39 info.de.sbt@siemens.comArtikel-Nr. E10003-A38-H214 (Stand 04/2017)

https://www.amberger-kuehltechnik.de/wp-content/uploads/Grundlagen-Kaelte.pdf

http://www.andreasjahnke.de/index_htm_files/Schulung%20Kaeltetechnik%20Grundlagen.pdf

https://www.gunt.de/images/download/Cat3a_german.pdf

https://docplayer.org/67215201-Fachwissen-kaeltetechnik.html

https://www.umsicht.fraunhofer.de/content/dam/umsicht/de/dokumente/referenzen/flexkaelte/K%C3%A4ltetechnik_in_Deutschland-Steckbriefe_zu_K%C3%A4ltetechnologien.pdf

Windows PIN 0xd0000225

2026-07-31T15:53:38Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Problem=
Nach einem Windowsupdate (Win11 23H2 auf 24H2) am 20241213 hat Windows bei der Anmeldung meinen Fingerabdruck nicht mehr akzeptiert.

Auch die PIN und das Kennwort haben mit Fehler abgebrochen.

=Loesungsversuche=
Der abgesicherte Modus mit Deinstallation der Updates brachte keinen Erfolg.

Das Umbenennen des NGC-Ordners brachte keinen Erfolg.

Also erst mal Datensicherung machen;-)

In Windows_RE

diskpart startet das Programm und man gelang in eine Shell

list disk
select disk <n>

list volume
select volume <n>

Eigentlich muesste es list disks und list volumes heiszen. Selektieren braucht man nur wenn man nachfolgende Kommandos nutzt die sich auf eine Disk oder ein Volume beziehen.
Um z.B. ein Volume zu formatieren braucht man die Disk nicht zu selektieren. Es reicht ein select volume <n> und anschlieszend

format fs=ntfs label=<name> [quick]

Hier sieht man neben der zugeordneten Laufwerksbuchstaben auch die Groesze der Partitionen.

fsutil volume diskfree c:

Jetzt kann ich abschätzen wie grosz mein BackupMedium sein muss.

Als Backupmethode will ich mal xcopy und robocopy eine Chance geben. Wenn das nicht klappt dann LiveLinux und rsync.

==Robocopy, die Erste==
Als haette ich es geahnt robocopy went out of destination disk space!!!

fsutil fsinfo ntfsinfo YourDestinationCopyDriveLetter:

TODO

==Robocopy, die Zweite==
[https://www.reddit.com/r/techsupport/comments/18hxnh6/robocopy_backup_taking_ages_due_to_recursive/]

=Loesung=
Den entscheidenen Hinweis habe ich von dieser [https://www.easeus.de/partitionieren-tipps/windows-11-passwort-vergessen-zuruecksetzen.html Seite] erhalten.Im eingebetteten Video wird erklaert wie man das Passwort des/der Benutzer zueruecksetzen kann.

Hier im Schnellverfahren.

*Den Button der Barrierefreiheit auf dem Anmeldebildschirm mit der Eingabeaufforderung verknuepfen.
*Benutzerkonten-Verwaltung oeffnen
*Passwort neu setzen

Der Button der Barrierefreiheit ist normalerweise mit dem Programm Utilman.exe verknuepft. Diese Verknuepfung setzt man auf cmd.exe neu und sichert das Programm zur Barrierefreiheit.
Um das zu tun, startet man den Abgesicherten Modus. Ich glaub der heiszt gar nicht mehr so. Es wird jetzt ein Windows RE gestartet.
Windows RE entweder mit Shift + Restart wenn man sich im Anmeldebildschirm befindet oder Strg+F8 sofern man gerade bootet.

cd \window\System32
ren Utilman.exe Utilman1.exe
cp cmd.exe Utilma.exe

Exit und Continue. Wenn man jetzt wieder im Anmeldebildschirm landet, kann man durch einen Klick auf das Maennlein die Eingabeaufforderung starten und folgendes eingeben.

control userpasswords2

Im der nun erscheinenden Benutzerkontenliste den gewünschten Benutzer auswaehlen und unten auf Kennwort ruecksetzen klicken und zweimal ein neues Passwort eingeben. Voilà!

Das ist so simpel, dass ich immer noch staune.

Interessant ist noch zu bemerken, dass der Aufruf der Benutzerkontenliste im angemeldeten Zustand, beim Zuruecksetzten auf Strg+Alt+Entf verweist.

Wandhalterungen

2026-07-31T15:53:37Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

Zwei kleine Beispiele einer Wandhalterung. Einmal für die XBOX , um sie hinter dem Fernseher zu verstecken und eine Wandhalterung für ein Microsoft Surface, dass ich als SmartHomeDisplay benutze.
Sollte jemand Interesse haben, schreibt euren Wunsch in den Kommentar.
===XBOX-Halterung===
Das X-Anordnung fand ich irgendwie passend.

[[Datei:XBOX-Halterung.jpg|200px]]

===Surface Halterung===
Beim Entwurf habe ich festegestellt, dass das Surface auf der Rückseite oben rechts und links metallische Gehäuseteile besitzt, so dass ich mit 2 Neodym-Magneten ganz einfach das Tablet fixieren kann. Es ist leicht zu entnehmen aber auch durch die leichte Schrägstellung und den Magneten, so fest dass ein unbeabsichtigtes Lösen unwahrscheinlich ist. Dadurch dass der Ladeanschluss auch magnetisch einklappt ist eine Entnahme recht komfortabel.
{| class="wikitable"
|-
|[[Datei:Surface-Halterung 1.jpg|200px]]
|[[Datei:Surface-Halterung 2.jpg|200px]]
|[[Datei:Surface-Halterung 3.jpg|150px]]
|-
|}

==Request for Comments==

<comments />

Wallboxen

2026-07-31T15:53:36Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Wer ein E-Auto faehrt braucht eigentlich (k)eine Wallbox. Bei meinem Tesla Model 3 war ein einphasiges Ladegeraet dabei. Da ich in meinem Haus derzeit die Photovoltaik eh nur einphasig speichere, kommt mir die einphasige Ladung gerade recht.
Fuer die Batterie ist es sowieso schonender und bei einer Ladestrombegrenzung von 10 A ist mein Akku (60 kWh) nach ca. 24 Stunden voll und das schaffe ich locker einmal die Woche.

Die Wallboxen (3) habe ich nur wenn's mal schnell gehen soll und weil sie [https://wallboxcenter.de/kfw-wallboxen-firmen-unternehmen-kfw441-kommunen-kfw-339/ gefoerdert] wurden.

Ich habe mich bewusst fuer 3 unterschiedliche Modelle entschieden, um Erfahrung zu sammeln.

=Modell 1 Heidelberg=
Status: gekauft

Energy Control 11kW (nicht Home Eco)

Heidelberg Wallbox Energy Control

Heidelberg Wallbox Home Eco

Material/Optik

Edelstahlfront, Silber-schwarz

Metallgehäuse, Silber-schwarz

Ladeleistung

11 kW

11 kW

Stecker

Typ-2-Anschluss

Typ-2-Anschluss

Länge Ladekabel

5 oder 7,5 Meter

3,5, 5 oder 7,5 Meter

KfW-Förderfähig

ja

nein

Fehlerstromschutz integriert

ja

ja

Besonderheiten

Integriertes Lastmanagementsystem (mit bis zu 16 weiteren Wallboxen vernetzbar)
KfW-förderfähig Für Innen- und Außenbereich geeignet
Optionale Zugriffskontrolle per Schaltelement z. B. RFID oder Schlüsselschalter
Mit zwei verschieden großen Ladekabeln erhältlich

Für Innen- und Außenbereich geeignet
Optionale Zugangskontrolle, z. B. RFID, Schlüsselschalter
Mit drei verschieden großen Ladekabeln erhältlich

TODO

=Modell 2 Zappi=
Status: Auswahlprozess

Es gibt Stand 11/2022, mal abgesehen von Gehaeusefarbe (weisz/schwarz), Anschlussmoeglichkeit (Stecker/Kabel) und der Ladeleistung (22 kW/7kW), 3 Varianten.

Bei der Suche nach der geeigneten Zappi ist fuer mich die Modellbezeichnung hilfreich:

Die nachgestellte Buchstabenkombination (T U W B) steht wohl fuer '''B'''lack, '''W'''hite. '''T''' kommt mit Kabel (Tethered) und '''U''' mit Steckdose (Untethered). Die 22 kW Varianten fuehren '''22''' in der Bezeichnung und die 7,4 kW-Varianten '''07''' Ich habe auch schon die Bezeichnung 27 gesehen..
Das nachgestellte -T oder -A war mir lange nicht klar. Es gibt [https://myenergi.nl/wp-content/uploads/sites/4/2021/04/Zappi-2-Full-Manual-V1_6_2_T.pdf hier] eine Anleitung nur fuer die T-Modelle und haben einen Hinweis in einer Fusznote: -T variant is fully compliant with EN 61851-1:2019. Die A-Modelle benutzen anstatt 868 MHz, 915 MHz zur Kommunikation.

Siehe auch [https://myenergi.de/wp-content/uploads/2019/04/zappidatasheet_deutsch_0720_web.pdf hier].

Weiter Links zur Info:
Diverse Links zur Information:

Zappi Bedienungsanleitung:
myenergi.de/wp-content/uploads…eisung-v1.4_DE_120720.pdf

Zappi Schnellinstallationsanleitung:
myenergi.de/wp-content/uploads…V1_21_09_2020_Ansicht.pdf

Zappi Datenblatt:
myenergi.de/wp-content/uploads…heet_deutsch_0720_web.pdf

Infos bezüglich Probleme mit Kia und Hyundai:
myenergi.de/kia-e-niro/

Hub Bedienungsanleitung:
myenergi.de/wp-content/uploads…ng_v.3.2.-DE-05_27_20.pdf

Hub & App Datenblatt:
myenergi.de/wp-content/uploads…heet_deutsch_0520_web.pdf

App Installation:
myenergi.de/wp-content/uploads…egistrierung_20_12_03.pdf

Harvi Bedienungsanleitung:
myenergi.de/wp-content/uploads…weisung_v.1.0.DE-0520.pdf

Harvi Schnellinstallationsanweisung:
myenergi.de/wp-content/uploads…ht_v.1.0.-DE-05_27_20.pdf

FAQS:
myenergi.de/faqs/

Firmware Update Anleitung:
myenergi.de/wp-content/uploads…irmware-update_081020.pdf
NEU (03.05.2021):
myenergi.com/updating-your-firmware/

Firmware Versionen Zappi, Hub usw.:
support.myenergi.com/hc/en-gb/…Current-firmware-versions

CT Installationsleitfaden:
myenergi.de/wp-content/uploads…en_30_11_2020_Ansicht.pdf

Englischsprachiges Forum:
myenergi.info/firmware-versions-t133.html

Im [https://myenergi.de/wp-content/uploads/2020/08/zappi_quick_installationsguide_V1_21_09_2020_Ansicht.pdf Handbuch] werden folgende Modellbezeichnungen aufgefuehrt: Einphasig: 207TB, 207TB-T, 207TW, 207TW-T, 207UB, 207UB-T, 207UW, 207UW-T
Dreiphasig: 222TB, 207TB-T, 222TW, 222TW-T, 222UB, 222UB-T, 222UW, 222UW-T

Wobei bei ''Dreiphasig' das zweite Modell wohl 222TB-T heiszen soll.

Zappi V1

Gibt es die ueberhaupt noch?

Das [https://myenergi.com/wiki/zappi-v1/ WIKI] gibt naehere Informationen.

Zappi V2

Das [https://myenergi.com/wiki/zappi-v2/ WIKI] gibt naehere Informationen.

ZAPPI 222TB EAN: 761856647657 (Preis 11/22: 820 Euro)

Zappi V2.1

ZAPPI 2H22TB-T (Preis 11/22: 1100 Euro ohne Kabel, 1200 Euro mit Kabel)

=Modell 3 ???=
Status: noch nicht gekauft
TODO

WRT54G (Revival)

2026-07-31T15:53:34Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Wie so oft kann ich mich von alter ausgedienter Hardware nicht trennen und ueberlege was man mit so einem Schaetzchen wie dem WRT54G(L V1.1) noch so tun kann. Die Nutzung als AP ist nicht mehr zeitgemaesz, aber als Client kann ich mir einen Einsatz noch gut vorstellen. Abgesehen von der Tatsache dass ein Raspi doch etwas flinker ist, braucht man sich bei einem WRT54G keine Sorgen um sterbende SD-Karten zu machen. Und um ein paar kleine Routinen und Sensoren im Netzwerk einzubinden reicht die Performance der WRT54G in vielen Faellen.

Durch ein paar kleine Hardwareeingriffe kann man den WRT54G mit einem SD-Kartenleser, mit 2 seriellen Schnittstellen und mit zwei USB-Ports (V1.1) ausstatten. Ein Variante, die ich im Netz gefunden habe, integriert noch einen Arduino-ProMicro in das Gehäuse und eroeffnet so ein riesiges Feld an Moeglichkeiten.

'''HINWEIS:''' Das hier beschriebene Vorgehen der systematischen Analyse einer (Embedded-)Hardware laesst sich natuerlich vorgangsgleich auf andere Hardware anwenden. Es ist fuer mich oft der einzige (richtige) Weg, um ein tieferes Verstaendnis von Zusammenhaengen zu erkennen. Das immer wieder erstaunliche an der Sache ist, dass ab einem bestimmten Grad des Eintauchens sich viele Forenfragen in Luft aufloesen. Oder anders ausgedrueckt, macht man sich einmal diese Arbeit weisz man auf einmal was man tut und probiert nicht einfach nur rum.

=DD-WRT vs. OpenWRT=
Ich bin hin- und hergerissen. Mit OpenWRT waren die Erfahrungen (Kamikaze, White Russian) aber eher schlecht. Danach habe ich lange Zeit DD-WRT (v3.0-r36247 std (06/29/18) KERNEL 2.4.37) benutzt und es ging so. Aber die 6 APs (mittlerweile durch Ubiquiti-APs ersetzt) im Haus haben immer irgendwie gezickt.

Jetzt wo der AP-Modus keine Rolle mehr spielt und MMC, JFFS, CIFS, USB, TTYSXX und das Aufspielen neuer Software eine groeszere Rolle spielen, war ich mit DD-WRT irgendwie in einer gefuehlten Sackgasse. DD-WRT bietet zum Beispiel Unterstützung von ip (a und r aber nicht n) parallel zu ifconfig, route und arp, aber gibt z.B. keine Fehlermeldungen bei Befehlen wie mount, mkdir. Auch eine Hilfe sucht man vergebens. Da hilft oft nur ein Blick in den SourceCode was die Software tut, oder halt nicht wie gewohnt funktioniert.

Der Support (DD-WRT) fuer CIFS, MMC und JFFS wird zwar in der WebGUI angeboten, laesst sich auch konfigurieren, aber CIFS und MMC lieszen sich nicht mounten und die Unterstuetzung von JFFS war auf der Konsole nicht auffindbar.

Bei OpenWRT Backfire war es mir bisher nicht moeglich den WLAN-Treiber fuer den BCM4306 zum Laufen zu bringen. Das Backfire-Image 10.03.1 brcm-2.4 wird als stabil fuer WRT54G(V4/L) angegeben, meldet aber (dmesg) "No Broadcom Chipset" osae beim Laden des Treibers (:-(). Das Image brcm47xx wird dagegen als "works (somewhat unstable)" bewertet, laeuft bei mir bisher sauber. Ich weiß nicht auf was sich [https://openwrt.org/toh/linksys/wrt54g hier] das 'unstable' bezieht.

Um da einen Schritt vorwaerts zu machen, muss ich erst eine paar zurueck machen.

Um schneller vergleichen zu koennen, habe ich einen Router mit Backfire 10.03.1 und den anderen mit DD-WRT v3.0 36247 laufen.

Aber der Reihe nach.

=Hardware=
Um sich eine besser Bild von den Zusammenhaengen zu machen hier nochmal die Hardware im Ueberblick.

==CPU==
Label: Broadcom BCM5352EKPBG

<nowiki>
DD-WRT:~# cat /proc/cpuinfo
system type : Broadcom BCM5352 chip rev 0
processor : 0
cpu model : BCM3302 V0.8
BogoMIPS : 199.47
wait instruction : no
microsecond timers : yes
tlb_entries : 32
extra interrupt vector : no
hardware watchpoint : no
ASEs implemented :
VCED exceptions : not available
VCEI exceptions : not available
</nowiki>

Hinweise:

Die 199.47 BogoMIPS lassen auf 200 MHz und ein Verhältnis von 1 schlieszen.

Der CPU-Kern BCM3302 findet auch in den SoC BCM4712, BCM53xx und BCM5836 Verwendung (siehe dazu http://oleg.wl500g.info/sdram.html)

==SDRAM==

Label: Winbond W9412G6JH-5

Size: 2M x 4 BANKS * 16 BITS DDR SDRAM => 16 MebiByte

CELL-Array (Bank) Konfiguration: 4096 * 512 * 16 = 33.554.432 Bit mal 4 Baenke = 134.217.728 Bit = 16.777.216 Byte

Adressraum: 0x000000 - 0xFFFFFF

<nowiki>
DD_WRT:~# nvram show|grep sdram
sdram_config=0x0062
sdram_refresh=0x0000
sdram_ncdl=0xfe0008
sdram_init=0x010b

DD-WRT:~# free
total used free shared buffers cached
Mem: 13004 11808 1196 0 1452 5180
-/+ buffers/cache: 5176 7828
Swap: 0 0 0
</nowiki>

Nuetzlicher Link:

[http://oleg.wl500g.info/sdram.html]

==Flash==

Label: MXIC (Macronix) MX29LV320EBTI-70G

Size: 4 MebiByte of 8 Bits each or 2 MebiBytes of 16

Irgendwo habe ich gelesen, dass der WRT54G den 16 Bit-Zugriff nutzt.

Adressierung: 0x000000 bis 0x3FFFFF

Sector Structure - 8K-Byte x 8 and 64K-Byte x 63• Extra 256-Byte sector for securit

DD-WRT:
<nowiki>
Flash device: 0x400000 at 0x1c000000
bootloader size: 262144
Physically mapped flash: Filesystem type: squashfs, size=0x2c8102
partition size = 2930688
Creating 4 MTD partitions on "Physically mapped flash":
0x00000000-0x00040000 : "cfe"
0x00040000-0x003f0000 : "linux"
0x00124800-0x003f0000 : "rootfs"
mtd: partition "rootfs" doesn't start on an erase block boundary -- force read-only
0x003f0000-0x00400000 : "nvram"
sflash not supported on this router
</nowiki>

Label cfe: 256 MebiByte (262.144 Byte) Bootloader
Label linux: 3.776 MebiByte (3.866.624) darin enthalten (am Ende) 2.862 MebiByte (2.930.688) rootfs
Label nvram: 64 KibiByte (65536) Configvariablen

Was man hier jetzt erkennen kann, dass das eigentliche Image (.bin,.trx) sich im MTD-Device mit dem Label linux (inkl. dem Device rootfs) befindet. Fuer das Image bleiben 4 MebiByte minus 256 MebiByte (CFE Bootloader) minus 64 KibiByte (nvram) uebrig. Die Squashfs-Size (s.o.) 0x2c8102 (2.916.610 Byte) ist vermutlich die belegte Groesze in der linux-Partition.

Mit dem Programm mtd (http://www.linux-mtd.infradead.org/archive/tech/faq.html memory technology device) werden die Partitionen gemountet/administriert/...

<nowiki>
DD-WRT:~# ls -l /dev/mtd/
crw-rw-rw- 1 root root 90, 0 Jan 1 01:00 0
cr--r--r-- 1 root root 90, 1 Jan 1 01:00 0ro
crw-rw-rw- 1 root root 90, 2 Jan 1 01:00 1
cr--r--r-- 1 root root 90, 3 Jan 1 01:00 1ro
crw-rw-rw- 1 root root 90, 4 Jan 1 01:00 2
cr--r--r-- 1 root root 90, 5 Jan 1 01:00 2ro
crw-rw-rw- 1 root root 90, 6 Jan 1 01:00 3
cr--r--r-- 1 root root 90, 7 Jan 1 01:00 3ro
DD-WRT:~# ls -l /dev/mtdblock/
0 1 2 3
DD-WRT:~# ls -l /dev/mtdblock/
brw-rw-rw- 1 root root 31, 0 Jan 1 01:00 0
brw-rw-rw- 1 root root 31, 1 Jan 1 01:00 1
brw-rw-rw- 1 root root 31, 2 Jan 1 01:00 2
brw-rw-rw- 1 root root 31, 3 Jan 1 01:00 3

DD-WRT:~# mtd
Usage: mtd [<options> ...] <command> [<arguments> ...] <device>

The device is in the format of mtdX (eg: mtd4) or its label.
mtd recognizes these commands:
unlock unlock the device
resetbc reset bootcounter for WRT1900AC/WRT1200AC/WRT1900ACv2
erase erase all data on device
write <imagefile>|- write <imagefile> (use - for stdin) to device
Following options are available:
-q quiet mode (once: no [w] on writing,
twice: no status messages)
-r reboot after successful command
-f force write without trx checks
-e <device> erase <device> before executing the command

Example: To write linux.trx to mtd4 labeled as linux and reboot afterwards
mtd -r write linux.trx linux

</nowiki>

===CFE (Common Firmware Environment) Bootloader===

CFE ist nicht nur der Bootloader (fuer Broadcom), sondern auch ein Interface fuer die Hardware.

Auf Github befindet sich der [https://github.com/kevbroch/cfe Sourcecode].

Definition [https://academic.microsoft.com/topic/203009010/publication/search?q=Common%20Firmware%20Environment&qe=And(Composite(F.FId%253D203009010)%252CTy%253D%270%27)&f=&orderBy=0]
Common Firmware Environment (CFE), pronounced as 'cafe', is a firmware interface and bootloader developed by Broadcom for 32-bit and 64-bit system- on-a-chip systems. It is intended to be a flexible toolkit of CPU initialization and bootstrap code for use on embedded processors (typically running on MIPS32/64 instruction set CPUs found in Broadcom SoCs). It is roughly analogous to the BIOS on the IBM PC platform. Its source-code is available on Open source license from Broadcom. Common embedded system alternatives include Das U-Boot.

Da das CFE mit dem BIOS bei einem PC vergleichbar ist, kann man sich vorstellen, dass sollte da ein "Defekt" vorliegen, die einfachen Mechanismen zum wiederherstellen der Embedded Hardware schwieriger werden. Manchmal wird in diesem Zusammenhang auch schon von "bricked" gesprochen. Dies ist aber nicht ganz richtig. Es bleiben in diesem Fall noch mindestens 2 Moeglichkeiten der Rettung: Erstens JTAG und zweitens Flash ausloeten und extern behandeln!

'''Hinweis:''' Mit der zweiten Moeglichkeit habe ich mal ein Panasonic-Notebook mit verlorenem BIOS-Passwort wiederbelebt, obwohl selbst Panasonic behauptet hat, dass es da keine Rettung gaebe, da ihre BIOSe sicher seien und keine (SW-)Moeglichkeit des Passwortruecksetzens besteht. Also wer so einen "hoffnungslosen" Fall hat, dem kann ich gerne weiterhelfen.

Interessant ist auch der Hinweis im [https://en.wikipedia.org/wiki/Common_Firmware_Environment Wiki], dass CFE auch in SmartTVs von LG und Samsung Einsatz findet. Sogar Amiga (meinen hab ich noch:-))) NG nutzt ihn.

===Linux (Image/Squashfs)===

Am Beispiel eines (alten) Images sei die Konvertierung von bin nach trx (und ggf. zuerueck) gezeigt.

dd if=lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.bin of=lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.trx bs=32 skip=1

Mit diesem Befehl werden die ersten 32 Byte des Bin-Images entfernt.

<nowiki>
worker:/home/chris/Downloads # ll lede*
-rw-r--r-- 1 chris users '''4001824''' Jul 27 21:22 lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.bin
-rw-r--r-- 1 root root '''4001792''' Jul 29 22:59 lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.trx

worker:/home/chris/Downloads # hexdump -C lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.bin|more
00000000 57 35 34 47 00 00 00 00 13 06 16 04 47 01 55 32 |W54G........G.U2|
00000010 4e 44 00 06 1f 00 00 00 00 00 00 00 00 00 00 00 |ND..............|
00000020 48 44 52 30 00 10 3d 00 3d a6 e1 7b 00 00 01 00 |HDR0..=.=..{....|
00000030 1c 00 00 00 24 09 00 00 00 54 12 00 1f 8b 08 00 |....$....T......|
00000040 00 00 00 00 02 03 8d 57 5d 68 1c d7 15 fe e6 ee |.......W]h......|
00000050 ac b4 fa 4b 47 ab 95 b3 8e 55 32 d7 ba 5a 6d bd |...KG....U2..Zm.|
00000060 2e dd b8 ae ab 87 2d 9d ae 64 23 8a 1f d6 3f 69 |......-..d#...?i|
00000070 4d 29 61 51 44 f1 43 a0 72 d3 80 1f fa 30 28 4a |M)aQD.C.r....0(J|
00000080 11 45 78 36 60 83 1e 4c 59 d6 92 a3 94 45 2b 3b |.Ex6`..LY....E+;|
00000090 4a ea 42 9d 2c c2 6d 5a 68 a1 50 43 fd d2 22 42 |J.B.,.mZh.PC.."B|
000000a0 1e f2 54 f2 d0 36 6e 42 3b fd ce ec 6c ad 3a 36 |..T..6nB;...l.:6|
000000b0 cd c2 72 67 ee cf 39 df fd ce 39 df bd b3 e0 7f |..rg..9...9.....|
000000c0 be f4 87 f0 f6 b8 83 b5 56 06 eb ad 2c ae b7 c6 |........V...,...|
000000d0 f0 5a ab ea f7 97 80 19 0d 3f 59 3a 3f bc 6e e0 |.Z.......?Y:?.n.|
000000e0 f7 94 b2 4f ff da 00 1b 2b c0 72 d3 c6 ba 6b 63 |...O....+.r...kc|
000000f0 c9 3d 94 ba 8e 8f 43 37 03 fe 2c df f1 30 36 6c |.=....C7..,..06l|
00000100 cc 72 51 65 e1 a6 a5 6f f1 27 c3 50 48 19 7b 39 |.rQe...o.'.PH.{9|
00000110 af fc 44 da 98 5a 45 ed bc 9a 86 85 d3 39 ec a6 |..D..ZE......9..|
worker:/home/chris/Downloads # hexdump -C lede-17.01.7-brcm47xx-legacy-linksys-wrt54g-squashfs.trx|more
00000000 48 44 52 30 00 10 3d 00 3d a6 e1 7b 00 00 01 00 |HDR0..=.=..{....|
00000010 1c 00 00 00 24 09 00 00 00 54 12 00 1f 8b 08 00 |....$....T......|
00000020 00 00 00 00 02 03 8d 57 5d 68 1c d7 15 fe e6 ee |.......W]h......|
00000030 ac b4 fa 4b 47 ab 95 b3 8e 55 32 d7 ba 5a 6d bd |...KG....U2..Zm.|
00000040 2e dd b8 ae ab 87 2d 9d ae 64 23 8a 1f d6 3f 69 |......-..d#...?i|
00000050 4d 29 61 51 44 f1 43 a0 72 d3 80 1f fa 30 28 4a |M)aQD.C.r....0(J|
00000060 11 45 78 36 60 83 1e 4c 59 d6 92 a3 94 45 2b 3b |.Ex6`..LY....E+;|
00000070 4a ea 42 9d 2c c2 6d 5a 68 a1 50 43 fd d2 22 42 |J.B.,.mZh.PC.."B|
00000080 1e f2 54 f2 d0 36 6e 42 3b fd ce ec 6c ad 3a 36 |..T..6nB;...l.:6|
00000090 cd c2 72 67 ee cf 39 df fd ce 39 df bd b3 e0 7f |..rg..9...9.....|
000000a0 be f4 87 f0 f6 b8 83 b5 56 06 eb ad 2c ae b7 c6 |........V...,...|
000000b0 f0 5a ab ea f7 97 80 19 0d 3f 59 3a 3f bc 6e e0 |.Z.......?Y:?.n.|
000000c0 f7 94 b2 4f ff da 00 1b 2b c0 72 d3 c6 ba 6b 63 |...O....+.r...kc|
000000d0 c9 3d 94 ba 8e 8f 43 37 03 fe 2c df f1 30 36 6c |.=....C7..,..06l|
000000e0 cc 72 51 65 e1 a6 a5 6f f1 27 c3 50 48 19 7b 39 |.rQe...o.'.PH.{9|
000000f0 af fc 44 da 98 5a 45 ed bc 9a 86 85 d3 39 ec a6 |..D..ZE......9..|
00000100 8e 1a cf b1 ca d3 29 78 18 31 f6 ea 88 b5 1f 67 |......)x.1.....g|
00000110 54 da 03 f6 23 af d2 35 1a d8 f5 3d 7c c0 bf 9f |T...#..5...=|...|

</nowiki>

Den Header des Bin-Images (57 35 34 47 00 00 00 00 13 06 16 04 47 01 55 32 4e 44 00 06 1f 00 00 00 00 00 00 00 00 00 00 00) muss ich mir bei Gelegenheit mal noch genauer anschauen.

Fuer die kleine Image-Analyse ist das Programm 'binwalk' recht nuetzlich.

<nowiki>
worker:/home/chris/Downloads # binwalk dd-wrt.v24_std_generic_36247.bin

DECIMAL HEXADECIMAL DESCRIPTION
--------------------------------------------------------------------------------
0 0x0 TRX firmware header, little endian, image size: 3858432 bytes, CRC32: 0xA663F3EF, flags: 0x0, version: 1, header size: 28 bytes, loader offset: 0x1C, linux kernel offset: 0x9D0, rootfs offset: 0xE4800
28 0x1C gzip compressed data, maximum compression, from Unix, last modified: 1970-01-01 00:00:00 (null date)
2512 0x9D0 LZMA compressed data, properties: 0x6E, dictionary size: 33554432 bytes, uncompressed size: 2985984 bytes
935936 0xE4800 Squashfs filesystem, little endian, DD-WRT signature, version 3.0, size: 2916610 bytes, 690 inodes, blocksize: 131072 bytes, created: 2018-06-29 09:09:45

worker:/home/chris/Downloads # binwalk dd-wrt.v24_mini_generic_44715.bin

DECIMAL HEXADECIMAL DESCRIPTION
--------------------------------------------------------------------------------
0 0x0 TRX firmware header, little endian, image size: 3375104 bytes, CRC32: 0x9886060E, flags: 0x0, version: 1, header size: 28 bytes, loader offset: 0x1C, linux kernel offset: 0xA34, rootfs offset: 0xCF400
28 0x1C gzip compressed data, maximum compression, from Unix, last modified: 1970-01-01 00:00:00 (null date)
2612 0xA34 LZMA compressed data, properties: 0x6E, dictionary size: 33554432 bytes, uncompressed size: 2756608 bytes
848896 0xCF400 Squashfs filesystem, little endian, DD-WRT signature, version 3.0, size: 2521285 bytes, 650 inodes, blocksize: 131072 bytes, created: 2020-11-03 04:01:08

worker:/home/chris/Downloads # hexdump -C dd-wrt.v24_mini_generic_44715.bin |more
00000000 48 44 52 30 00 80 33 00 0e 06 86 98 00 00 01 00 |HDR0..3.........|
00000010 1c 00 00 00 34 0a 00 00 00 f4 0c 00 1f 8b 08 00 |....4...........|
00000020 00 00 00 00 02 03 95 58 5d 6c 14 d7 15 3e 33 b3 |.......X]l...>3.|
00000030 eb dd b5 dd 74 d6 ec 3a a6 71 61 27 7b 67 3d b1 |....t..:.qa'{g=.|
00000040 f3 b0 20 8b 6e ab 7d 18 d6 b6 ba a5 a9 e4 90 54 |.. .n.}........T|
00000050 72 db 3c 58 04 28 aa 2a 95 a4 50 f1 40 db 09 01 |r.<X.(.*..P.@...|
00000060 e2 46 0e b3 a8 04 f9 a1 55 b6 36 6b d6 68 61 96 |.F......U.6k.ha.|
00000070 14 42 2b 85 c6 b5 b0 01 a9 aa 48 db a4 95 da 07 |.B+.......H.....|
</nowiki>

Also haben wir nach dem BIN-Header (s.o.) auch noch einen TRX-Header (28 Bytes: 48 44 52 30 00 80 33 00 0e 06 86 98 00 00 01 00 1c 00 00 00 34 0a 00 00 00 f4 0c 00)

Ab 0x1C steht der gzip-header beginnend mit der Magic Number (1f 8b). Siehe dazu [https://en.wikipedia.org/wiki/Gzip weiter]

Um die Analyse weiter zu treiben habe ich noch ein paar Zusatzpakete unter OpenSuSE (15.3) installiert.

zypper in openocd
zypper in sasquatch
zypper in bcm43xx-firmware
zypper in pullin-bcm43xx-firmware

Um sasquatch zu installieren war bei mir noch ein Repo hinzuzufuegen.

zypper ar "https://download.opensuse.org/repositories/devel:/tools/openSUSE_Leap_15.3/" DEVEL

Mit sasqautch war nun auch binwalk mit dem extrahieren der SquachFS-Partition erfolgreich.

<nowiki>
binwalk --extract dd-wrt.v24_std_generic_44715.bin
worker:/home/chris/Downloads # ll _dd-wrt.v24_std_generic_44715.bin.extracted/
total 8944
-rw-r--r-- 1 root root 4816 Jul 31 09:19 1C
-rw-r--r-- 1 root root 2748416 Jul 31 09:19 A34
-rw-r--r-- 1 root root 3622348 Jul 31 09:19 A34.7z
-rw-r--r-- 1 root root 2772622 Jul 31 09:19 CF400.squashfs
drwxr-xr-x 15 root root 4096 Nov 3 2020 squashfs-root
</nowiki>

Die Namen der extrahierten Dateien ist die hexadezimale Position im bin-File. Zusaetzlich zu sind die Inhalte bei A34 und CF400 noch dekomprimiert angelegt.

<nowiki>
worker:/home/chris/Downloads/_dd-wrt.v24_std_generic_44715.bin.extracted # 7z l A34.7z

7-Zip [64] 16.02 : Copyright (c) 1999-2016 Igor Pavlov : 2016-05-21
p7zip Version 16.02 (locale=de_DE.UTF-8,Utf16=on,HugeFiles=on,64 bits,16 CPUs Intel(R) Xeon(R) CPU X5570 @ 2.93GHz (106A5),ASM)

Scanning the drive for archives:
1 file, 3622348 bytes (3538 KiB)

Listing archive: A34.7z

--
Path = A34.7z
Open WARNING: Can not open the file as [7z] archive
Type = lzma

Date Time Attr Size Compressed Name
------------------- ----- ------------ ------------ ------------------------
..... 2748416 A34
------------------- ----- ------------ ------------ ------------------------
2748416 3622348 1 files

Warnings: 1
</nowiki>

unsquashfs fuehrte hier nicht zum Erfolg. Da die Magic Number von 0x73717368 auf 0x74717368 (Grrrr!) geaendert wurde.
Siehe hierzu [https://github.com/jtreml/firmware-mod-kit]

<nowiki>
worker:/home/chris/Downloads/_dd-wrt.v24_std_generic_44715.bin.extracted # sasquatch -i CF400.squashfs
SquashFS version [3.0] / inode count [700] suggests a SquashFS image of the same endianess
Non-standard SquashFS Magic: hsqt
Parallel unsquashfs: Using 1 processor
Trying to decompress using default gzip decompressor...
Trying to decompress with lzma...
Trying to decompress with lzma-adaptive...
Detected lzma-adaptive compression
654 inodes (693 blocks) to write

squashfs-root
dir_scan: failed to make directory squashfs-root, because File exists

created 0 files
created 0 directories
created 0 symlinks
created 0 devices
created 0 fifos
</nowiki>
https://reverseengineering.stackexchange.com/questions/15508/how-to-convert-the-dumped-firmware-from-linksys-wrt54gl-via-jtag-port-in-an-un

===NVRAM===

NonVolatileRAM. Die (Config-)Variablen zur Einstellung der Linux-Umgebung auf der (Embedded-)Hardware werden zur Laufzeit im RAM abgelegt und beim Booten aus der Partition mit dem Label nvram geladen. Das erklaert auch warum man nach einer Aenderung einer Variablen mit 'nvram commit' die Aenderungen in die Flash-Partitiion uebertraegt und somit 'nichtfluechtig' macht. Vergisst man nach einer Variablenaenderung das Committen (sich bekennen, verpflichten: Sinn?) geht die Aenderung bei einem Reboot verloren.

==Weitere WRT54G Hardware==

<nowiki>
DD-WRT:~# cat /proc/pci
PCI devices found:
Bus 0, device 0, function 0:
Class 0501: PCI device 14e4:0800 (rev 0).
IRQ 3.
Non-prefetchable 32 bit memory at 0x18000000 [0x18000fff].
Non-prefetchable 32 bit memory at 0x1fc00000 [0x1fffffff].
Non-prefetchable 32 bit memory at 0x1c000000 [0x1dffffff].
Non-prefetchable 32 bit memory at 0x1a000000 [0x1bffffff].
Bus 0, device 1, function 0:
Class 0200: PCI device 14e4:4713 (rev 0).
IRQ 4.
Master Capable. Latency=64.
Non-prefetchable 32 bit memory at 0x18001000 [0x18001fff].
Bus 0, device 2, function 0:
Class 0b30: PCI device 14e4:0816 (rev 0).
IRQ 5.
Non-prefetchable 32 bit memory at 0x18002000 [0x18002fff].
Bus 0, device 3, function 0:
Class 0c03: PCI device 14e4:4716 (rev 0).
IRQ 6.
Non-prefetchable 32 bit memory at 0x18003000 [0x18003fff].
Bus 0, device 4, function 0:
Class 0500: PCI device 14e4:080f (rev 0).
IRQ 3.
Non-prefetchable 32 bit memory at 0x18004000 [0x18004fff].
Non-prefetchable 32 bit memory at 0x0 [0x7ffffff].
Non-prefetchable 32 bit memory at 0x10000000 [0x17ffffff].
Non-prefetchable 32 bit memory at 0x80000000 [0x9fffffff].
Bus 0, device 5, function 0:
Class 0280: PCI device 14e4:4320 (rev 0).
IRQ 2.
Master Capable. Latency=64.
Non-prefetchable 32 bit memory at 0x18005000 [0x18005fff].
Bus 0, device 6, function 0:
Class 0280: PCI device 14e4:4719 (rev 0).
IRQ 3.
Non-prefetchable 32 bit memory at 0x18006000 [0x18006fff].
</nowiki>

https://devicehunt.com/view/type/pci/vendor/14E4

* BUS 0/DEVICE 0 14e4:0800 Sentry5 Chipcommon I/O Controller
* BUS 0/DEVICE 1 14e4:4713 Sentry5 Ethernet Controller
* BUS 0/DEVICE 2 14e4:0816 BCM3302 Sentry5 MIPS32 CPU
* BUS 0/DEVICE 3 14e4:4716 BCM47xx Sentry5 USB Host Controller
* BUS 0/DEVICE 4 14e4:080f Sentry5 DDR/SDR RAM Controller
* BUS 0/DEVICE 5 14e4:4320 BCM4306 802.11b/g Wireless LAN Controller
* BUS 0/DEVICE 6 14e4:4719 BCM47xx/53xx RoboSwitch Core

Passende Treiber:
BCM4306 PCI 14e4:4320 Broadcom WEP WPA WPA2 b/g b43, b43legacy - Firmware muss installiert werden. Die Benötigte Firmwaredatei ucode4/5.fw ist nur in dem weiter unten im Forum verlinkten älteren Installationspaket enthalten!

https://linux-club.de/wiki/opensuse/Broadcom_Wireless

<nowiki>
# firmware for b43
URL1=http://www.lwfinger.com/b43-firmware
FILE1=broadcom-wl-6.30.163.46.tar.bz2
FIRMWARE1=broadcom-wl-6.30.163.46.wl_apsta.o

# firmware for b43legacy
URL2=http://downloads.openwrt.org/sources
FILE2=wl_apsta-3.130.20.0.o
</nowiki>

=Pimpups=
==SDCard==
Um es vorweg zu nehmen: Lasst es!

Es funktioniert zwar, aber es ist so langsam, dass es in der Praxis keinen Vorteil bringt.

Ich habe als SDCard-Adapter diesen hier verwendet.
[[Datei:WRT54 SDCARD PCB top.jpg|mini]]
[[Datei:WRT54 SDCARD PCB bottom.jpg|mini]]
Auf der Karte ist ein 5C->3.3V Stabi, so dass ich die Karte an 5V anschliessen konnte.

Vom Insert bis Mount kann schon mal ne Minute dauern.

==SERCON==

Da der WRT54G 2 serielle Schnittstellen an JP2 anbietet kann im einfachsten Fall eine als Konsole und er zweite zur Kommunikation mit z. B. einem Microcontroller verwendet werden. Aber auch eine virtuelle Anbindung über Sercon wäre eine schöne Sache.

==USB==
TODO

==Serial Interface==

[https://store.curiousinventor.com/product/spk-wrt-serial-port-kit-for-wrt54g-router/]

==OneWire==

[https://owfs.org/index_php_page_wireless-router.html]

==I2C==

=WIKI Hinweise=

To support third-party firmware, Linksys has re-released the WRT54G v4, under the new model name WRT54GL (the 'L' in this name allegedly stands for 'Linux'). It is also possible to replace the 2 MB flash chip in the WRT54G with a 4 MB flash chip. The Macronix International 29LV320BTC-90 is a suitable part although others may work as well. The user must first install a JTAG header and use a JTAG cable to back up the firmware, then replace the chip and restore the firmware with the JTAG cable. After testing for proper functionality of the modified unit, third-party firmware can be flashed using the JTAG cable and a suitable image file.

With the Attitude Adjustment (12.09)[46] release of OpenWrt, all WRT54G hardware versions with 16 MB of RAM are no longer supported, and older Backfire (10.03)[47] is recommended instead. Issues came from dropping support for the legacy Broadcom target brcm-2.4, making lower end devices run out of memory easily. Support for Attitude Adjustment is limited to WRT54G hardware versions with 32 MB of RAM, which includes WRT54GS and (apart from performing RAM upgrades through hardware modifications) some of the WRT54G and WRT54GL versions having the capability for unlocking their additional 16 MB of RAM.[48][49][50][51][52][53]

=JTAG=
Nur der Vollstaendigkeit wegen hier noch ein paar Worte zu JTAG.

'''J'''oint '''T'''est '''A'''ction '''G'''roup (kurz JTAG) ist ein häufig verwendetes Synonym für den IEEE-Standard 1149.1, der eine Methodik für das Testen und Debuggen integrierter Schaltungen, also Hardware auf Leiterplatten, beschreibt.

[https://www.linux-magazin.de/ausgaben/2010/06/diagnosewerkzeug/ Einstieg]

JTAG besteht aus nur 4+2 Pins TCK, TMS, TDI und TDO.

{| class="wikitable"
!colspan="3"|JTAG-Interface
|-
|PIN
|Name
|Bedeutung
|-
|TCK
|Test Clock
|Takt der Datenuebertragung
|-
|TMS
|Test Mode Select
|Navigation im Zustandsautomaten
|-
|TDI
|Test Data In
|Daten Adapter->Geraet
|-
|TDO
|Test Data Out
|Daten Adapter<-Geraet
|-
|/TRST
|Test Reset
|Zustandsautomat in Ausgangszustand
|-
|/SRST
|System Reset
|Hardwarereset
|-
|}

Es gibt keine einheitliche Steckerbelegung für JTAG-Anschluesse.

==Debrick==

[https://zedt.eu/tech/hardware/recovering-a-bricked-linksys-wrt54gl-v1-1-using-jtag-part-1-the-hardware/]

=Request for Comments=

<comments />

=Weiterfuehrende Links/Analysen/Techniken=

https://www.heise.de/ct/ausgabe/2013-21-Hinter-den-Kulissen-eines-Router-Botnets-2313886.html

https://www.heise.de/newsticker/meldung/Funkregulierung-als-Angriff-auf-alternative-Software-Open-Source-Projekte-gefaehrdet-2805855.html

https://forum.ubuntuusers.de/topic/netzwerkkarte-nach-deaktivierung-im-autostart/#post-2480236

https://www.broadcom.com/support/802.11

https://t3n.de/news/sicherheitsluecke-milliarde-1257306/

https://www.agner.org/optimize/ objconv

https://rjmendez.github.io/posts/2019/02/Indeed_CTF_Embedded_2/

https://berlioux.com/electronique/wrt-sim/wrt-sim-en.html

WLAN Schaltsteckdose

2026-07-31T15:53:33Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
"OMG, warum baut der eine WLAN-Steckdosenleiste, wenn's sowas doch fertig zu kaufen gibt?"
[https://www.smarthomearea.de/bestenlisten-fuer-alle-smart-home-geraete/bestenliste-top-10-wifi-steckdosenleisten-wlan-steckdosenleisten-vernetzte-mehrfachsteckdosen-amazon-echo-alexa-google-home-assistant-9463/]

Die meisten, bzw. alle, die ich bis jetzt gefunden habe erfuellen nicht alle Kriterien und die Betonung liegt auf Steckdosenleiste.

Auswahlbedingungen:
* Rueckmeldefunktion: schaltbar von mehreren "Stellen" mit gegenseitiger Anzeige des aktuellen Schaltzustandes.
* FHEM-Intergration, oder "offene"-Schnittstelle. Eine Smartphone-App-Steuerung ist ja selten daemlich.
* Cloudfree Wie viele Apps/Clouds soll ich noch installieren.
* Skalierbar 2,3,4,... Steckdosen.
* evtl. Dimmerfunktion
* Preis, selbst wenn man SONOFF (z.B. SONOFF POW R2 1 Kanal Schaltaktor WLAN, mit Messfunktion) nimmt.

==Smartphone-App-Steuerung==
Schalten muss schnell und einfach sein!

Was nutzt es mir wenn ich fuer jeden Smartplug-Hersteller eine andere App benoetige.

Selbst wenn ein Schlauer auf die Idee kommt, alles in einer App zu integrieren, muss ich idR die App oeffnen und navigieren. Da nutzen auch keine SprachassistentINNEN, solange ER nicht Jarvis heiszt und mit WENIGEN Angaben weiss, was ER zu tun hat.

=Vorhaben 1=
[[Datei:Schaltsteckdosenleiste.jpg|mini]]
Einzeln schaltbare Steckdosenleisten sind schon unter 10 Euro zu haben. Ein Umbau lohnt eigentlich nicht. Da die Einbausteckdose 713 von Bals schon fuer 2 Euro/Stueck zu haben ist. Na gut, man muss den Gehaeusepreis dazurechnen. Als Gehaeuse kann ein Stueck Kabelkanal dienen.
[[Datei:Bals Einbausteckdose.png|mini]]
=Vorhaben 2=
[[Datei:Schaltsteckdosenleiste selbstbau.jpg|mini]]

=Vorhaben 3=
[[Datei:SteckdosenleisteinBox.jpg|mini]]

=NodeMCU=
Allen Vorhaben liegen aehnliche Forderungen zugrunde.
* WLAN-Anbindung
* MQTT-Steuerung
* Toggletaster
* Signalisierung Schaltzustand
* 1-polige-/2-polige-Trennung
...

==Software==

Ausgehend von dem Testprogramm aus dem Artikel [[NodeMCU]] beginnt jetzt die Bereinigung, Optimierung und Anpassung des Codes.
Der Uebersichtlichkeit geschuldet packe ich die Kommentare in den Quellcode.

Forderung an die Software:
* Parameter zur Anpassung
* Interrupts

<div class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Firmware NodeMCU (ESP8266) Schaltsteckdose</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="c" line>

//funktioniert 20210821 mit NodeMCU ueber USB
//Blink fehlt noch
#include <Arduino.h> // in den DHT examples benutzt
#include <Ticker.h> // in den DHT examples benutzt, esp8266 library that calls functions periodically
#include <ESP8266WiFi.h> // Include the Wi-Fi library
#include <PubSubClient.h> // MQTT
#include <DHT.h> // DHT Temp/Hum DHT11 DHT22
#include <PCF8574.h> // I2C Port-Expander 8 IN/OUT
#include <Wire.h> // This library allows you to communicate with I2C / TWI devices

// WLAN //
WiFiClient espClient;
const char* ssid = "XXX"; // The SSID (name) of the Wi-Fi network you want to connect to
const char* password = "YYY"; // The password of the Wi-Fi network

// MQTT //
const char* mqtt_server = "192.168.178.x";
PubSubClient client(espClient);
unsigned long lastMsg = 0;
#define MSG_BUFFER_SIZE (50)
char msg[MSG_BUFFER_SIZE];
long int value = 0;

// DHT //
Ticker ticker;
DHT11 sensor; // change to DHT22 if needed!
volatile float humidity = 0;
volatile float temperature = 0;
volatile uint8_t error = 0;
volatile int8_t result = 0;
int grad = 248; // mit dem Gradzeichen gibt es schon mal Probleme

void readDHT() { // Funktion eigentlich ueberfluessig, da nur eine (weitere) Funktion aufgerufen wird
sensor.read();
}

//PCF
PCF8574 PCF(0x20); // Man beachte, dass die Slave-Adresse nur 7-Bit lang ist und nicht zwischen R/W unterscheidet.

// this callback will be called from an interrupt
// it should be short and carry the ICACHE_RAM_ATTR attribute
void IRAM_ATTR handleData(float h, float t) {
humidity = h;
temperature = t;
result = 1;
}

// this callback will be called from an interrupt
// it should be short and carry the ICACHE_RAM_ATTR attribute // ICACHE_RAM_ATTR veraltet
void IRAM_ATTR handleError(uint8_t e) {
error = e;
result = -1;
}

void callback(char* topic, byte* payload, unsigned int length) {
Serial.print("Message arrived [");
Serial.print(topic);
Serial.print("] ");
for (unsigned int i = 0; i < length; i++) {
Serial.print((char)payload[i]);
}
Serial.println();

// Switch on the LED if an 1 was received as first character
// Ein Moeglichkeit der Auswertung um Schaltzustaende zu aendern
if ((char)payload[0] == '1') {
digitalWrite(LED_BUILTIN, LOW); // Turn the LED on (Note that LOW is the voltage level
// but actually the LED is on; this is because
// it is active low on the ESP-01)
} else {
digitalWrite(LED_BUILTIN, HIGH); // Turn the LED off by making the voltage HIGH
}

}

// MQTT Verbindung nicht vorhanden
void reconnect() {
// Loop until we're reconnected
while (!client.connected()) {
Serial.print("Attempting MQTT connection...");
// Create a random client ID
String clientId = "ESP8266Client-";
clientId += String(random(0xffff), HEX); // ClientID muss in die global configs
// Attempt to connect
if (client.connect(clientId.c_str())) {
Serial.println("connected");
// Once connected, publish an announcement...
client.publish("outTopic", "hello world"); // outTopic muss in die global configs
// ... and resubscribe
client.subscribe("inTopic");
} else {
Serial.print("failed, rc=");
Serial.print(client.state());
Serial.println(" try again in 5 seconds");
// Wait 5 seconds before retrying
delay(5000);
}
}
}

void setup() {
pinMode(LED_BUILTIN, OUTPUT); // Initialize the BUILTIN_LED (alte Bezeichnung) pin as an output

// Die ganze serielle Kommunikation braucht man eigentlich nur zum Debuggen
Serial.begin(115200); // Start the Serial communication to send messages to the computer
delay(10);
Serial.println('\n');

//sensor.setup(D4);
sensor.setPin(D8);
sensor.onData(handleData);
sensor.onError(handleError);
ticker.attach(30, readDHT);

WiFi.mode(WIFI_STA);// ist scheinbar der defaultwert wird in letzter Version nicht benutzt
WiFi.begin(ssid, password); // Connect to the network
Serial.print("Connecting to ");
Serial.print(ssid); Serial.println(" ...");

int i = 0;
while (WiFi.status() != WL_CONNECTED) { // Wait for the Wi-Fi to connect
delay(1000);
Serial.print(++i); Serial.print(' ');
}

randomSeed(micros());

Serial.println('\n');
Serial.println("Connection established!");
Serial.print("IP address:\t");
Serial.println(WiFi.localIP()); // Send the IP address of the ESP8266 to the computer

client.setServer(mqtt_server, 1883);
client.setCallback(callback);

PCF.begin();
}

void loop() {
if (result > 0) {
Serial.printf("Humid: %g %%\n", humidity);
Serial.println();
Serial.printf("Temp: %3.1f %cC\n", temperature,grad);
Serial.println();
} else if (result < 0) {
Serial.printf("Error: %s\n", sensor.getError());
}
result = 0;
if (!client.connected()) {
reconnect();
}
client.loop();

unsigned long now = millis();
if (now - lastMsg > 2000) {
lastMsg = now;
++value;
snprintf (msg, MSG_BUFFER_SIZE, "hello world #%ld", value);
Serial.print("Publish message: ");
Serial.println(msg);
client.publish("outTopic", msg);
PCF.toggle(4);
}
}

</syntaxhighlight>
</div></div>

===MQTT Topics===
Zur Zeit zeigt sich durch Tests in FHEM noch Kraut und Rueben.
[[Datei:FHEM MQTT DeviceIDs.png|mini]]

Hier mal eine kleine Zusammenstellung der Dos and Donts or Best practices

'''Never use a leading forward slash'''

A leading forward slash is permitted in MQTT. For example, /myhome/groundfloor/livingroom. However, the leading forward slash introduces an unnecessary topic level with a zero character at the front. The zero does not provide any benefit and often leads to confusion.
Topic names must consist of at least one character to be valid.

/

is already a topic name.

'''Never use spaces in a topic'''

A space is the natural enemy of every programmer. When things are not going the way they should, spaces make it much harder to read and debug topics. As with leading forward slashes, just because something is allowed, doesn’t mean it should be used. UTF-8 has many different white space types, such uncommon characters should be avoided.

'''Keep the topic short and concise'''

Each topic is included in every message in which it is used. Make your topics as short and concise as possible. When it comes to small devices, every byte counts and topic length has a big impact.

'''Use only ASCII characters, avoid non printable characters'''

Because non-ASCII UTF-8 characters often display incorrectly, it is very difficult to find typos or issues related to the character set. Unless it is absolutely necessary, we recommend avoiding the use of non-ASCII characters in a topic.
E'''mbed a unique identifier or the Client Id into the topic'''
It can be very helpful to include the unique identifier of the publishing client in the topic. The unique identifier in the topic helps you identify who sent the message. The embedded ID can be used to enforce authorization. Only a client that has the same client ID as the ID in the topic is allowed to publish to that topic. For example, a client with the client1 ID is allowed to publish to client1/status, but not permitted to publish to client2/status.

'''Don’t subscribe to #'''

Sometimes, it is necessary to subscribe to all messages that are transferred over the broker. For example, to persist all messages into a database. Do not subscribe to all messages on a broker by using an MQTT client and subscribing to a multi-level wildcard. Frequently, the subscribing client is not able to process the load of messages that results from this method (especially if you have a massive throughput). Our recommendation is to implement an extension in the MQTT broker. For example, with the plugin system of HiveMQ you can hook into the behavior of HiveMQ and add an asynchronous routine to process each incoming message and persist it to a database.

'''Don’t forget extensibility'''

Topics are a flexible concept and there is no need to preallocate them in any way. However, both the publisher and the subscriber need to be aware of the topic. It is important to think about how topics can be extended to allow for new features or products. For example, if your smart-home solution adds new sensors, it should be possible to add these to your topic tree without changing the whole topic hierarchy.

'''Use specific topics, not general ones'''

When you name topics, don’t use them in the same way as in a queue. Differentiate your topics as much as possible. For example, if you have three sensors in your living room, create topics for myhome/livingroom/temperature, myhome/livingroom/brightness and myhome/livingroom/humidity. Do not send all values over myhome/livingroom. Use of a single topic for all messages is a anti pattern. Specific naming also makes it possible for you to use other MQTT features such as retained messages. For more on retained messages, see part 8 of the Essentials series.

Diese Zusammenstellung empfand ich als sehr hilfreich.

In meinem Haus hat jeder Raum bereits eine Nummer mit vorangestelltem UG, EG und DG. Jetzt kaeme noch der Garten als neuer "Raum" dazu. Oder ich entscheide eine Stufe darueber bereits zwischen Haus und Garten. Da ich im Garten zwischen Pool Carport unterscheiden will, muss ich wohl auch noch eine Unterteilung nach Terrasse hinzufuegen. Bisher habe ich das alles in FHEM unter "Auszen" zusammengefasst.
Die erste Ebene waere also Haus/Außenanlage, Außenbereich oder einfach nur Außen.

Noch etwas detaillierter geht es [https://pi3g.com/2019/05/29/mqtt-topic-tree-design-best-practices-tips-examples/ hier] weiter.

Ein erster Versuch fuer mich sieht dann so aus (weder am Anfang noch am Ende steht ein Slash):
Haus/[UG,EG,DG]/[1-9]+/ClientID/Art
Außen/[Terrasse,Veranda,Garten,Pool,Carport,...]/ClientID/Art

Art waere dann [Schalter,Temperatur,Feuchtigkeit,Dimmer,...]

Einen Payload im JSON-Format benoetige ich erst mal nicht. Ich werde nach Moeglichkeit numerische Payloads gebrauchen.
Spaetestens wenn man mehrere Schalter in einem Client vereint stellt sich die Frage ob ich z.B. fuer jeden Schalter einen Topic anlege, oder im Topic Schalter eine Zahl als Repraesentation aller Schalter uebergebe.

Zum Beispiel:
..../ClientID/Schalter1 0
..../ClientID/Schalter2 0
..../ClientID/Schalter3 1
..../ClientID/Schalter4 0
..../ClientID/Schalter5 1
oder
..../ClientID/Schalter 00101

Da ich im zweiten Beispiel den aktuellen Zustand erst bestimmen muss um die Message zu erzeugen faellt die Wahl auf die erste Variante.
Auf Unterstriche zur Bedeutungs-/Worttrennung verzichte ich.

===DEBUG-Mode===
Die ganzen Serial-Prints kommen in eine bedingte Kompilierung.

==Hardware==

==Links==
https://cmatic.de/?accessid=2&id=16
==Request for Comments==

<comments />

Videostreaming

2026-07-31T15:53:32Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Wie selbstvestaendlich benutzt man Videostreaming von Youtube, Prime, ....

Irgendwie werde ich das Gefuehl aber nicht los, sobald die Anforderung zu simpel wird kommen einem nicht geahnte Schwierigkeiten in die Quere.
Da spielt der Liebingsplayer eine Video nicht ab, weil der passende Codec nicht lizenziert oder installiert ist, die Latenzen machen das fluessige schauen unmoeglich, die Rechenleistung des Rechners reicht nicht aus um die Anforderungen eines Codec zu bedienen und und und ...

Der Ausloeser fuer diesen Beitrag ist die Moeglichkeit zu schaffen, von einem System geringer Leistung (RasPi,NAO...) mit angeschlossener Kamera, das Videobild ueber eine Netzwerkverbindung moeglichst in einem Browser, oder Viewer-Marke-Eigenbau fluessig anzuzeigen.

Da das eigentliche Ziel eine ressourcenschonende Uebertragung von Videomaterial von z.B. RasPI, NAO, ... zu OpenCV ist kann der [https://www.it-jim.com/blog/gstreamer-for-computer-vision-and-audio-processing/ Artikel] recht interessant sein.

=Dateiformate=

Auch Videodateitypen, oder auch Datei-Container. Ein Container enthält das Video, Audiodaten und ggf. weitere Informationen wie Untertitel oder Metadaten.
[https://de.wikipedia.org/wiki/Containerformat]
Fuer mich nach wie vor von Interesse
MPEG-1 und MPEG-2 (m2p, mpg, mpeg, ts)
MPEG-4 (mp4, m4v)
Matroska (mkv)
HTML5 (WebM)

Instagram
Videoformat: MP4 oder MOV
Audio: AAC
Video-Codec: H.264
Framerate: maximal 30 Bilder pro Sekunde (fps)
Maximale Dateigröße: 15 MB

YouTube
Videoformat: MP4
Audio: AAC-LC
Video-Codec: H.264
Framerate: selbe Framerate wie bei der Aufnahme, gängig sind 24, 25, 30, 48, 50 und 60 Bilder pro Sekunde
Maximale Dateigröße: 256 GB

WhatsApp
TODO

Um mich der Sache zu naehern, hier eine Sammlung der ausprobierten Befehle.

=Versuch und Irrtum=

Das man nicht blind im Nebel stochert.

v4l2-ctl --list-formats
ioctl: VIDIOC_ENUM_FMT
Index : 0
Type : Video Capture
Pixel Format: 'YUYV'
Name : YUYV 4:2:2

v4l2-ctl -d /dev/video0 --list-framesizes=YUYV
ioctl: VIDIOC_ENUM_FRAMESIZES
Size: Discrete 640x480
Size: Discrete 160x120
Size: Discrete 176x144
Size: Discrete 320x240
Size: Discrete 352x288

v4l2-ctl -L
brightness 0x00980900 (int) : min=0 max=255 step=1 default=124 value=124
contrast 0x00980901 (int) : min=0 max=255 step=1 default=145 value=145
saturation 0x00980902 (int) : min=0 max=255 step=1 default=75 value=75
hue 0x00980903 (int) : min=-127 max=127 step=1 default=0 value=0
gamma 0x00980910 (int) : min=1 max=8 step=1 default=4 value=4
gain 0x00980913 (int) : min=0 max=65535 step=1 default=16 value=16
power_line_frequency 0x00980918 (menu) : min=0 max=2 default=1 value=1
0: Disabled
1: 50 Hz
2: 60 Hz
sharpness 0x0098091b (int) : min=0 max=255 step=1 default=10 value=10

gst-device-monitor-1.0
Device found:

name : \_SB_.PCI0.EUS1-4.1.4:1.0-18ec:3399
class : Source/Video
caps : video/x-raw, format=YUY2, width=160, height=120
video/x-raw, format=YUY2, width=176, height=144
video/x-raw, format=YUY2, width=320, height=240
video/x-raw, format=YUY2, width=352, height=288
video/x-raw, format=YUY2, width=640, height=480
gst-launch-1.0 libcamerasrc camera-name="\\_SB_.PCI0.EUS1-4.1.4:1.0-18ec:3399" ! ...

Einmal YUYV 4:2:2 und jetzt YUY2

packed 4:2:2 YUV

+--+--+--+--+ +--+--+--+--+
|Y0|U0|Y1|V0| |Y2|U2|Y3|V2| ...
+--+--+--+--+ +--+--+--+--+

Component 0: Y
depth: 8
pstride: 2
offset: 0

Component 1: U
depth: 8
offset: 1
pstride: 4

Component 2: V
depth 8
offset: 3
pstride: 4

Image
default rstride: RU4 (width * 2)
default size: rstride (image) * height

==1==

gst-launch-1.0 v4l2src device="/dev/video0" ! autovideoconvert ! autovideosink sync=false

Das sync=false am Ende laesst das Video erst fluessig erscheinen.

==2==

gst-launch-1.0 v4l2src device="/dev/video0" ! videoconvert ! clockoverlay ! x264enc tune=zerolatency ! mpegtsmux ! hlssink playlist-root=http://192.168.178.10/gstreamer/hlstest location=/mnt/SERVER/WWW/gstreamer/hlstest/segment_%05d.ts target-duration=5 max-files=5

Ein HTML5 Player gibt diesen Stream nicht wieder.

Es gibt in HTML5 folgende Einschraenkung, .ts ist da nicht dabei.
.mp4 = H.264 + AAC
.ogg/.ogv = Theora + Vorbis
.webm = VP8 + Vorbis

==3==

gst-launch-1.0 webmmux name=mux ! filesink location=test.webm \
videotestsrc num-buffers=250 ! video/x-raw,framerate=25/1 ! videoconvert ! vp8enc ! queue ! mux.video_0 \
audiotestsrc samplesperbuffer=44100 num-buffers=10 ! audio/x-raw,rate=44100 ! vorbisenc ! queue ! mux.audio_0

Zum Probieren ganz hilfreich, da "Fehler" bei der Quelle(nangabe) wegfallen.

==4==

gst-launch-1.0 webmmux name=mux ! filesink location=test.webm v4l2src device=/dev/video0 ! videoconvert ! vp8enc ! queue ! mux.video_0

Video war mit deutlicher Verzoegerung im Browser zu sehen. Der Name mux wird dann ganz am Ende als Referenz benutzt mux.video oder mux.audio.
Damit erklaert sich auch die hier "falsche" Reihenfolge der Pipe.

==5==

gst-launch-1.0 v4l2src device=/dev/video0 ! queue ! x264enc ! mp4mux ! filesink location=video.mp4

==6==
ffmpegcolorspace wurde durch videoconvert ersetzt.

gst-launch-1.0 v4l2src ! videoconvert ! jpegenc ! avimux ! filesink location=output.avi

Fuehrt beim Firefox zum Download.

==7==
Erzeugt zwar eine mp4-Datei. Das Abspielen gelingt aber weder mit VLC noch MPlayer.

st-launch-1.0 v4l2src ! videoconvert ! x264enc ! mp4mux ! filesink location=video.mp4 -e

==8==

gst-launch-1.0 -v v4l2src ! videoconvert ! rtpvrawpay ! udpsink host="127.0.0.1" port=5000

Geht irgendwie, aber kein brauchbares Bild. VLC bleibt schwarz.
Mplayer bringt Stream not seekable! und auch kein Bild

gst-launch-1.0 -v udpsrc port=5000 caps = "application/x-rtp, media=(string)video, clock-rate=(int)90000, encoding-name=(string)RAW, width=(string)640, height=(string)480, payload=(int)96, sampling=(string)RGBA, depth=(string)8, a-framerate=30/1" ! rtpvrawdepay ! videoconvert ! queue ! xvimagesink sync=false

==9==

gst-launch-1.0 -e -v v4l2src ! videoconvert ! videoscale ! videorate ! "video/x-raw,format=I420,width=640,height=480,framerate=30/1" ! x264enc key-int-max=15 ! rtph264pay ! udpsink host=localhost port=5000

Da ist der Server bei ueber 100% CPU-Last. Das erklaert die leichte Verzoegerung.

gst-launch-1.0 -v udpsrc uri=udp://localhost:5000 ! application/x-rtp,media=video,clock-rate=90000,encoding-name=H264,payload=96 ! rtph264depay ! avdec_h264 ! autovideosink

Vektorisieren mit potracer und mkbitmap

2026-07-31T15:53:31Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Eigentlich hatte ich zwei Anwendungsfaelle um verschiedene Bitmaps zu vektorisieren.
* Eine Bitmap so zu konvertieren, dass ich sie als Grundlage fue eine CNC-Fraese nutzen konnte und
* die Icons in FHEM waren mir oft zu klein, zu grosz, zu unscharf, ...

=Einstieg=
Ich suchte etwas fuer die Kommandozeile. Schnell bin ich auf das [https://potrace.sourceforge.net/ Paket Potrace] von Peter Selinger gestoszen.

Den Grundlagen von Ubuntuusers habe ich nicht hinzuzufuegen. Sie gehen aber leider ueber die Informationen der Man-Pages nicht hinaus.

* https://wiki.ubuntuusers.de/potrace/
* https://wiki.ubuntuusers.de/mkbitmap/

Die Reihenfolge der Nutzung ist mkbitmap und dann potrace. Es wird empfohlen die Bitmaps mit mkbitmap fuer potrace vorzubereiten. Das ist aber kein muss.

==mkbitmap==

mkbitmap 1.16. Transforms images into bitmaps with scaling and filtering.

Usage: mkbitmap [options] [file...]

OPTIONS

General:
-h, --help - print this help message and exit
-v, --version - print version info and exit
-l, --license - print license info and exit
-o, --output <file> - output to file
-x, --nodefaults - turn off default options

Inversion:
-i, --invert - invert the input (undo 'blackboard' effect)

Highpass filtering:
-f, --filter <n> - apply highpass filter with radius n (default 4)
-n, --nofilter - no highpass filtering
-b, --blur <n> - apply lowpass filter with radius n (default: none)

Scaling:
-s, --scale <n> - scale by integer factor n (default 2)
-1, --linear - use linear interpolation
-3, --cubic - use cubic interpolation (default)

Thresholding:
-t, --threshold <n> - set threshold for bilevel conversion (default 0.45)
-g, --grey - no bilevel conversion, output a greymap

Possible input file formats are: pnm (pbm, pgm, ppm), bmp.
The default options are: -f 4 -s 2 -3 -t 0.45

Manpage

=Beipiele=

[https://potrace.sourceforge.net/samples.html]

[https://potrace.sourceforge.net/mkbitmap.html]

Diese zweite Seite, mit vorangeschaltetem mkbitnap erlaeutert schoen die Varienten zum besten Ergebnis.

Der richtige Threshold, also die Stufe ab der ein Pixel weiß oder schwarz wird ist nicht einfach zu finden.

Ohne Anwendung eines Highpassfilters kommt er zu folgenden Ueberlegungen.

Wenn wir eine einfache Schwellenwertmethode zur Konvertierung von Grautönen in Schwarz/Weiß anwenden, können wir nie ganz den richtigen Schwellenwert finden. Der Hintergrund wird schwarz, bevor der Vordergrund zufriedenstellend ist. Die folgenden Bilder wurden auf verschiedenen Ebenen mit Schwellenwerten versehen.

Durch die Hochpassfilterung werden großflächige Unregelmäßigkeiten wie Hintergrundschwankungen unterdrückt, während kleinräumige Details wie Linien erhalten bleiben. Die Filterung hängt von einem Parameter namens Filterradius ab, der ungefähr der Größe der erhaltenen Features entspricht. Der Filterradius kann auch anhand der Linienstärke ermittelt werden. Die folgende Bildsequenz veranschaulicht die Wirkung des Filterradiusparameters.

So ergibt sich der erste Befehl mit dem man anfangen kann.

mkbitmap -f 2 -s 2 -t 0.48

Tibber Pulse (API)

2026-07-31T15:53:28Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Da ich aktuell vom Energieversorger einen zweiten Hausanschluss (40kW :-() gelegt bekommen habe und ich für die Wallboxen zur Foerderung einen 100% Oekostrom haben musste, habe ich kurzerhand einen Vertrag mit Tibber (mal zum Testen) abgeschlossen.

=Installation=
Pulse IR und Bridge
[[Datei:Tibber Pulse IR und Bridge.png|mini|Tibber Pulse IR und Bridge]]
Eigentlich verlief die Installation problemlos. Fuer mich war allerdings der Assistent in der Tibber-App zu kindisch. Das ist eher was für Apple-User. Ich haette mir an der ein oder anderen Stelle mehr Hardcore-Infos gewuenscht. Da der mehrstufige Prozess (WLAN-Bridge-Pulse-Zaehler) doch einige Stolperfallen enthaelt, ist es fuer mich eher frustrierend jedesmal bei einem Fehler zurueck auf Los geschickt zu werden. Das geht definitiv besser. Ist aber wieder ein Beispiel, dass die Informatiker-Jobs heute nur noch durch 5-jaehrige Schimpansen (ungelernte ;-)) besetzt werden.

Bei mir gab es letztendlich nur einen gravierenden Fehler. Von den mitgelieferten Akkus des Pulse war einer defekt. Bei mir sind das zwei AA-Zellen auf LiBasis! Ein Nachladen mit einem Lithium-1.5V-Lader hat keinen Erfolg gebracht. Erst der Austausch gegen 2 neue Zellen war erfolgreich.

=App=
[[Datei:TibberAppIcon.png|mini|TibberAppIcon]]
Die App find ich ziemlich verquer. Sobald Rechnungsanschrift und Installationsorte unterschiedlich sind, geht das Chaos los. Auch der Support tut sich dann schwer. Ich traue mich gar nicht so richtig weitere Vertraege abzuschlieszen.
Alles ueber die App machen zu wollen/muessen ist ... Das gehoert fuer mich ins WebUserPortal.

Was echt nervt ist, dass sich gefühlt jeden Monat das LookandFeel aendert. Schon die dritte oder vierte Designaenderung des Homescreens (Zuhause).

=API=
Da die App eher suboptimal ist, habe ich recht zuegig damit angefangen mir die notwendigen Infos ueber die API auf eine Infoseite im Intranet zu holen. Ein Integration in FHEM und/oder HA steht noch aus.

=Erste Schritte=

Uebersicht [https://developer.tibber.com/docs/overview]

Zusammenfassung: Die Plattform wird über GraphQL verfügbar gemacht, eine Technologie, die von Facebook konzipiert und entwickelt wurde.

==Was ist GraphQL?==

[https://de.wikipedia.org/wiki/GraphQL Wikipedia]

[https://github.com/graphql GraphQL]

===ChatGPT zu GraphQL===

GraphQL ist eine von Facebook entwickelte Abfragesprache und Laufzeitumgebung für APIs (Application Programming Interfaces). Im Gegensatz zu traditionellen RESTful APIs, bei denen die Client-Anwendung verschiedene Endpunkte aufruft, um Daten abzurufen oder zu manipulieren, ermöglicht GraphQL dem Client, genau die Daten abzurufen, die er benötigt, indem er eine einzige Abfrage an den Server sendet.

Hier sind einige Hauptmerkmale von GraphQL:

'''Declarative Datenabfrage''': Der Client spezifiziert genau, welche Daten er vom Server erhalten möchte, indem er eine GraphQL-Abfrage definiert, die die benötigten Felder und deren Struktur beschreibt. Dadurch kann der Client genau die Daten erhalten, die er benötigt, ohne Overfetching oder Underfetching.
'''Typsystem''': GraphQL definiert ein Typsystem, das die Struktur und den Typ der Daten beschreibt, die von der API zurückgegeben werden können. Dies ermöglicht eine strikte Typisierung und verbesserte Dokumentation.
'''Single-Endpoint-Architektur''': Im Gegensatz zu RESTful APIs, die oft mehrere Endpunkte für verschiedene Ressourcentypen haben, hat eine GraphQL-API normalerweise nur einen Endpunkt, über den alle Abfragen und Mutationen gesendet werden.
'''Echtzeitfähigkeit''': GraphQL unterstützt auch Abonnements, die es ermöglichen, Daten in Echtzeit zu empfangen, wenn sich etwas ändert. Dies ist besonders nützlich für Anwendungsfälle wie Live-Chats, Benachrichtigungen und Echtzeit-Dashboard-Aktualisierungen.
'''Entwicklungserfahrung''': GraphQL bietet eine verbesserte Entwicklererfahrung, da Clients genau die Daten erhalten können, die sie benötigen, und Entwickler APIs schneller entwickeln können, ohne sich um Versionierung oder unerwartete Seiteneffekte durch Änderungen an der Backend-API kümmern zu müssen.

Insgesamt bietet GraphQL eine flexible, effiziente und moderne Möglichkeit, APIs zu entwerfen und zu verwenden, die den Anforderungen moderner Anwendungen besser gerecht wird als traditionelle RESTful APIs.

Auf der Tibber-Seite heiszt es:

The GraphQL query language is basically about selecting fields on objects.

Was dies bedeutet kommt weiter unten. Weiter heiszt es auf der Tibber Seite.

GraphQL ist eine Abfragesprache für Ihre(? unsere) API und eine serverseitige Laufzeitumgebung zum Ausführen von Abfragen mithilfe eines Typsystems, das Sie für Ihre Daten definieren. GraphQL ist nicht an eine bestimmte Datenbank oder Speicher-Engine gebunden und wird stattdessen durch Ihren vorhandenen Code und Ihre Daten unterstützt.

Mit der Uebersetzung von Google hadere ich noch. Der Satz kommt vermutlich ursrpruenglich von Facebook und wurde von Tibber 1:1 uebernommen.

Der naechste Satz gibt schon mehr Aufschluss:
Tibber hat sich für GraphQL als API entschieden, weil es unseren Integratoren und uns selbst Flexibilitaet bietet. Die Moeglichkeit, die gewuenschten Daten genau zu definieren, macht die Nutzung wesentlich einfacher als herkoemmliche [https://www.ibm.com/de-de/topics/rest-apis REST-basierte APIs]. Es ist auch sehr schoen, dass die serverseitige Implementierung von GraphQL sehr gut mit unserer Microservice-Architektur zusammenspielt :-)

Zum Einstieg nutze ich den [https://developer.tibber.com/explorer Api Explorer im TibberDev]. Nachdem man sich dort einen Personal Token angelegt hat, kann's direkt losgehen. Der [https://developer.tibber.com/explorer GraphiQL] hat auch eine Autovervollstaendigung. Sehr praktisch.
[[Datei:TibberDevAccount.png|mini|TibberDevAccount]]
Die Root-Types sind
*query: Query
*mutation: RootMutation
*subscription: RootSubscription
*fragment feht irgendwie in der Doc

Der Aufbau ist recht simpel und das Doc in knapp einer Stunde durchprobiert. So dass ich dann schnell an dem Punkt angelangt bin, dass ich ein Programm (PHP, Python oder JavaScript) brauche welches die fuer mich interessanten Daten in meine MySQL-DB uebertraegt. Ob ich zuerst anzeige und dann speichere, also sozusagen ueber die Datenbank puffere, oder umgekehrt muss ich noch festlegen.

===ChatGPT zum Subprotokoll===

Das Subprotokoll "graphql-transport-ws" ist ein WebSocket-Subprotokoll, das speziell für die Kommunikation zwischen Client und Server in GraphQL-Anwendungen entwickelt wurde. Es basiert auf dem WebSocket-Protokoll, das eine bidirektionale, persistente Verbindung zwischen einem Client und einem Server ermöglicht.

Im Kontext von GraphQL wird "graphql-transport-ws" verwendet, um GraphQL-Abfragen, Mutationen und Abonnements über WebSocket-Verbindungen zu übertragen. Im Gegensatz zum traditionellen HTTP-Protokoll, das eine separate Anfrage-Antwort-Struktur hat, ermöglicht WebSocket eine kontinuierliche Kommunikation zwischen Client und Server, was besonders nützlich ist, wenn Echtzeit-Aktualisierungen benötigt werden, wie bei Abonnements in GraphQL.

Das Subprotokoll "graphql-transport-ws" definiert spezifische Nachrichtenformate und Handshake-Verfahren, die für die GraphQL-Kommunikation über WebSockets erforderlich sind. Durch die Verwendung dieses Subprotokolls können Entwickler GraphQL-Anwendungen erstellen, die von den Echtzeitfähigkeiten von WebSocket profitieren, ohne auf die Vorteile und Flexibilität von GraphQL verzichten zu müssen.

==Mehrfacher Hinweis Subprotokolwechsel Dezember 2022==

Die TibberAPI unterstuetzte zunaechst GraphQL-Websocket-Subscriptions mithilfe des Unterprotokolls graphql-ws. Diese Bibliothek wird/wurde jedoch archiviert und nicht mehr gepflegt. Daher wurde am 31. Maerz 2022 die Unterstützung für das Unterprotokoll graphql-transport-ws hinzugefuegt.

Die Unterstuetzung für das alte Protokoll wird im Dezember 2022 entfernt. Gleichzeitig aendert sich auch die URL für die Verbindung zum Websocket-Server. Zuvor konnte die Verbindung unter '''wss://api.tibber.com/v1-beta/gql/subscriptions''' hergestellt werden. Nach der Aenderung muss die URL ueber GraphQL abgefragt werden (siehe Beispiel unten) und der Client muss das Unterprotokoll graphql-transport-ws unterstuetzen.

<syntaxhighlight code=xml>
Frage:
{
viewer {
websocketSubscriptionUrl
}
}

Antwort:
{
"data": {
"viewer": {
"websocketSubscriptionUrl": "wss://websocket-api.tibber.com/v1-beta/gql/subscriptions"
}
}
}
</syntaxhighlight>

==Anfragenbegrenzung==
Zum Schutz der API gilt eine Ratenbegrenzung von 100 Anfragen in 5 Minuten pro IP-Adresse. Beachten Sie, dass die Preise einmal täglich am Nachmittag berechnet werden (für Norwegen und Schweden sind sie zunächst vorläufig und werden später möglicherweise mit geringfügigen Änderungen nach Bestätigung der Wechselkurse endgültig festgelegt). Sie können „priceInfo.today“ und „priceInfo.tomorrow“ verwenden, um sie im Voraus abzurufen, anstatt nur „priceInfo.current“ für die aktuelle Stunde zu verwenden.

=In medias res=
Zum Starten empfiehlt die Tibber-API-Doc, die fundamentalen Konzepte von GraphQL, die Kommunikation mit der API und den Explorer.

Um die nachfolgenden Beispiele schnell zu verstehen, hier der Link zur [https://developer.tibber.com/docs/reference API-Referenz]

Bei der GraphQL-Abfragesprache geht es im Wesentlichen um die Auswahl von Feldern in Objekten.

Auf der Docs-Reference-Seite gibt es einen interessanten Hinweis:
This reference is auto-generated from https://api.tibber.com

Es koennte als eine URL geben, die einem die aktuelle '''Tibber GraphQL Schema Reference''' direkt zur Auswertung ausgibt. Der Umweg ueber das Parsen der HTML-Ausgabe ginge zur Not natuerlich auch.

==Objekt Typen==

Die Begriffsdifferenzierung Objekt und Object Types ist mir derzeit noch nicht klar. Ich werde wohl um die allgemeine [https://github.com/graphql/graphql-spec Spec von GraphQL] nicht herumkommen:-(

Bei 'Home' wird von einem Objekttyp gesprochen. Klar ist, man hat Objekte, die mit dem Schluesselwort type eingeleitet und dann beschrieben werden.

Einige Felder sind Skalare (Boolesche Werte, Zeichenfolgen, Ganzzahlen, Gleitkommazahlen), waehrend andere Objekttypen sind (Adresse, LegalEntity). Eine GraphQL-Abfrage muss vollstaendig auf Skalarebene sein. D.h. in einer Abfrage duerfen die abgefragten Felder keine Objekte (keine weiteren Objekttypen) sein, sondern hierarchisch heruntergebrochen auf weitere Inhalte bis es Skalare sind.

<syntaxhighlight lang=xml>
This query is valid:

{
homes{
id
}
}

This is not:

{
homes{
id
owner <- hier ist der Fehler. Dies ist kein Skalar!
}
}

The owner field is an object type and you would need to specify which scalar fields you would like returned:

{
homes{
id
owner{
name
}
}
}
</syntaxhighlight>

==query Datenabfrage (read)==

query->viewer

Zuerst mit homes die Zaehlerplatz-iD holen und dan mit home (id: "<ID>") nur die data dazu holen.

Hello World;-)
{
viewer {
login
name
userId
accountType
home (id: "xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb") {
id
features {
realTimeConsumptionEnabled
}
subscriptions {
id
}
currentSubscription {
id
}
meteringPointData {
consumptionEan
gridCompany
gridAreaCode
priceAreaCode
productionEan
energyTaxType
vatType
estimatedAnnualConsumption
}
owner {
id
}
mainFuseSize
}
websocketSubscriptionUrl
}
}

Interessant fand ich z.B.

"priceAreaCode": "Amprion",

"estimatedAnnualConsumption": 500

"mainFuseSize": null

und was da noch alles an Daten einzutragen ist.
size: Int
The size of the home in square meters

==mutation Datenveraenderung (write)==

Mutationen gibt es nur 3, wobei die erste bei mir entfaellt.

sendMeterReading(input: MeterReadingInput!): MeterReadingResponse!
Send meter reading for home (only available for Norwegian users)

updateHome(input: UpdateHomeInput!): Home!
Update home information

sendPushNotification(input: PushNotificationInput!): PushNotificationResponse!
Send notification to Tibber app on registered devices

==subscription==

Subscription hat nur 2 Felder, wobei dauerhaft nur das erste interessant ist.

liveMeasurement(homeId: ID!): LiveMeasurement
Subscribe to real-time measurement stream from Pulse or Watty device

testMeasurement(homeId: ID!): LiveMeasurement
Subscribe to test stream

<syntaxhighlight lang=xml>
subscription{
liveMeasurement(homeId: "<homeID>"){
timestamp
power
lastMeterConsumption
accumulatedConsumption
accumulatedProduction
accumulatedConsumptionLastHour
accumulatedProductionLastHour
accumulatedCost
accumulatedReward
currency
minPower
averagePower
maxPower
powerProduction
powerReactive
powerProductionReactive
minPowerProduction
maxPowerProduction
lastMeterProduction
powerFactor
voltagePhase1
voltagePhase2
voltagePhase3
currentL1
currentL2
currentL3
signalStrength
}
}
</syntaxhighlight>

==fragment==

?

Dazu habe ich bisher keine weiteren Infos gefunden.

=Programmierung=

Bei der Programmierung steht bei mir hier die Client-Programmierung im Vordergrund.

==Query/Mutation==

Die Abfragen und Aenderungen zu programmieren sind schnell erledigt.

Der Einstieg auf der Konsole gelingt mit curl recht gut.

<syntaxhighlight lang=bash>
curl \
-H "Authorization: Bearer xxxxx-yyyyyy_dhfakjebnrqauvhdjhfaklhdf \
-H "Content-Type: application/json" \
-X POST \
-d 'mutation{ sendMeterReading(input:{homeId:"some home id", reading: 123}){time reading }}' https://api.tibber.com/v1-beta/gql
</syntaxhighlight>

==Subscription==

Die Subscriptions sind schon ein wenig anspruchsvoller zu programmieren als Query und Mutation (QuM).
Ist QuM eine simple http-Anfrage mit einer Antwort im JSON-Format, ist es bei den Subscriptions ein Websocket, der einmal geoeffnet in unregelmaeszigen Abstaenden JSON-Pakete liefert.

===Anforderungen für Websocket-Abonnement-Clients===

* Clients muessen den User-Agent-Header festlegen, wenn sie die GraphQL-API aufrufen und eine Websocket-Verbindung oeffnen. Sowohl die Plattform als auch die Treiberversion muessen angegeben werden. Z.B. Homey/10.0.0 com.tibber/1.8.3
* Clients müssen das Unterprotokoll graphql-transport-ws implementieren
* Clients müssen Jitter und exponentielles Backoff implementieren, wenn sie Anfragen an die API wiederholen
* Clients müssen die WebSocket-Server-URL dynamisch abfragen

===Best Practices für die Implementierung von WebSocket-Abonnement-Clients===

Bei der Implementierung eines Clients zum Abonnieren von Live-Daten sind einige Szenarien zu beruecksichtigen:
* Keine Daten aufgrund von Netzwerkproblemen: Es kann sinnvoll sein, einen Wiederverbindungsmechanismus zu implementieren, falls mehrere Minuten lang keine Daten empfangen wurden. Bei einem erneuten Versuch muss zunaechst die alte Websocket-Verbindung zerstoert und ordnungsgemaeszer Jitter und exponentielle Verzoegerung implementiert werden.
* Ein Echtzeitgeraet wird moeglicherweise entfernt. Es wird empfohlen, vor dem erneuten Verbinden immer zu ueberpruefen, ob home.features.realTimeConsumptionEnabled einen echten Wert hat.
* Eine WebSocket-Verbindung kann aufgrund eines ungueltigen Authentifizierungstokens verboten sein (z. B. weil ein Benutzer möglicherweise sein Tibber-Konto entfernt hat). In diesem Fall darf der Client es nicht mit demselben Token erneut versuchen. Stattdessen muss der Autorisierungsprozess erneut ausgeführt werden, wobei der Benutzer neue Anmeldeinformationen eingibt.
* Es kann zu einem Neustart der Tibber-Websocket-API kommen, was bedeutet, dass die Verbindung mit dem "Code 1001" und dem Grund "Going away" geschlossen wird. In diesem Fall kann der Client nach einer zufälligen Verzoegerung von 1 bis 60 Sekunden (Jitter angewendet) die Verbindung wiederherstellen, um zu vermeiden, dass alle Clients gleichzeitig die Verbindung wiederherstellen.

In PHP habe ich wenig bis gar nichts gefunden. Ich wollte mir auch einfach die Nutzung einer GraphQL-Library ersparen. Python habe ich erst einmal an den Schluss verschoben und einem Integration in FHEM den Vorzug gegeben.

===Perl (FHEM)===
Hier der Code der tatsaechlich funktioniert, obwohl er an ein paar Stellen nicht so vorgeht wie ich aus den Tibber-Docs erwartet hatte.

HINWEIS: Dies ist der "nackte" Perl-Code. In der "Originaldatei" sind noch die "FHEM-Escapes" doppelter Strichpunkt und Zeilenfolgezeichen \ enthalten. Eine Eingabe ueber die FHEM-Kommandozeile hat bei mir nicht funktioniert. Erst das direkte Einkopieren in die fhem.conf zeigte das nachfolgende, funktionierende Ergebnis.

<syntaxhighlight lang="perl" line>
connect:cmd:.connect {
my $hash = $defs{$name};
my $devState = DevIo_IsOpen($hash);
return "Device already open" if (defined($devState));

# establish connection to websocket
# format must also include portnumber if a path is to be specified
$hash->{DeviceName} = AttrVal($name, "websocketURL", "wss:echo.websocket.org:443");

# special headers needed for Tibber, see also Developer Tools in Browser
$hash->{header}{'Sec-WebSocket-Protocol'} = 'graphql-transport-ws';
$hash->{header}{'Host'} = 'websocket-api.tibber.com';
$hash->{header}{'Origin'} = 'https://developer.tibber.com';

# callback function when "select()" signals data for us
# websocket Ping/Pongs are treated in DevIo but still call this function
$hash->{directReadFn} = sub () {
my $hash = $defs{$name};

# we can read without closing the DevIo, because select() signalled data
my $buf = DevIo_SimpleRead($hash);

# if read fails, close device
if(!defined($buf)) {
DevIo_CloseDev($hash);
$buf = "not_connected";
}

#Log(3, "$name:$reading: websocket data: >>>$buf<<<");

# only update our reading if buffer is not empty and if last update is older than minInterval
if ($buf ne "") {
my $websocketDataAge = ReadingsAge($name, "websocketData", 3600);
my $minInterval = AttrVal($name, "minInterval", 0);
my $isNext = ($buf =~ /.*id.*type.*next.*payload.*data.*liveMeasurement.*/s);

readingsBeginUpdate($hash);
readingsBulkUpdate($hash, "websocketData", "$buf") if ($isNext && $websocketDataAge > $minInterval);
readingsBulkUpdate($hash, "websocketData", "$buf") if (!$isNext);
readingsEndUpdate($hash, 1);
}
};

# open DevIo websocket
DevIo_OpenDev($hash, 0, undef, sub(){
my ($hash, $error) = @_;
return "$error" if ($error);

my $token = AttrVal($name, "token", "???");

DevIo_SimpleWrite($hash, '{"type":"connection_init","payload":{"token":"'.$token.'"}}', 2);
});
readingsBulkUpdate($hash, "websocketData", "");

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
disconnect:cmd:.disconnect {
my $hash = $defs{$name};
RemoveInternalTimer($hash);
DevIo_SimpleRead($hash);
DevIo_CloseDev($hash);

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
onDisconnect {
my $myState = ReadingsVal($name, "state", "???");
my $myData = ReadingsVal($name, "websocketData", "???");
return if ($myState ne "disconnected" and $myData ne "not_connected");

## timer callback function, called after a few seconds to initiate a reconnect
my $timerFunction = sub() {
my ($hash) = @_;
my $devState = DevIo_IsOpen($hash);

# only re-connect if device is not connected
readingsSingleUpdate($hash, "cmd", "connect", 1) if (!defined($devState));
};
my $hash = $defs{$name};
RemoveInternalTimer($hash, $timerFunction);

# wait a random time before reconnect (exponential backoff TBD):
my $rwait = int(rand(200)) + 30;
InternalTimer(gettimeofday() + $rwait, $timerFunction, $hash);
readingsBulkUpdate($hash, "cmd", "reconnect attempt in $rwait seconds");

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
onConnectionAck:websocketData:.*connection_ack.* {
#websocketData contains the string "connection_ack"
Log(3, "$name:$reading: got connection ack");

# do not proceed if connection is lost
my $hash = $defs{$name};
my $devState = DevIo_IsOpen($hash);
return "Device not open" if (!defined($devState));

readingsBulkUpdate($hash, "cmd", "got connection ack");

my $homeId = AttrVal($name, "homeId", "???");
my $myId = AttrVal($name, "myId", "???");

# build the query, do it in pieces, the comma at the end caused perl errors
# so we put it together in this not very elegant way
my $json = '{ "id":"'. $myId .'", "type":"subscribe"'.", ";
$json .= '"payload":{';
$json .= '"variables":{}'.", ";
$json .= '"extensions":{}'.", ";
$json .= '"query":"subscription { liveMeasurement( homeId: \"'.$homeId.'\" ) ';
$json .= '{ timestamp power lastMeterConsumption accumulatedConsumption accumulatedProduction ';
$json .= 'accumulatedProductionLastHour accumulatedCost accumulatedReward currency minPower averagePower maxPower ';
$json .= 'powerProduction powerReactive powerProductionReactive minPowerProduction maxPowerProduction lastMeterProduction ';
$json .= 'powerFactor voltagePhase1 voltagePhase2 voltagePhase3 signalStrength }}"';
$json .= '}}';

#send the string via websocket as ASCII
Log(3, "$name:$reading: sending JSON: >>>$json<<<");
DevIo_SimpleWrite($hash, $json, 2);

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
onNextLiveMeasurement:websocketData:.*next.*payload.*data.*liveMeasurement.* {
#websocketData contains next-live-measurement-data
my $val = ReadingsVal($name, "websocketData", "{}");
my %res = %{json2nameValue($val, undef, undef, "payload_data_liveMeasurement.*")};

my $ret = "got values for:\n";
foreach my $k (sort keys %res) {
$ret .= "$k\n";
readingsBulkUpdate($hash, makeReadingName($k), $res{$k});
}
return $ret;
}
</syntaxhighlight>

====Code Analyse====

Es gibt 5 Eintrittspunkte:
* connect
* disconnect
* onDisconnect
* onConnectionAck
* onNextLiveMeasurement

Die ersten beiden legen die Befehlsfolgen für ein Start-Kommando (set cmd connect, bzw. set cmd disconnect) oder Stop-Kommando fest.
Die letzten 3 reagieren auf die entsprechenden Events.
=====connect=====

Lexikalische Variablen mittels my, bzw. my()

Jede Variable, die mit our deklariert oder auch "einfach so" ohne eine Deklaration verwendet wird, wird in die Symboltabelle des jeweils aktuellen Packages aufgenommen.
Deklariert man dagegen eine Variable mit dem Operator my, so wird die entsprechende Variable in einer anderen Tabelle abgelegt, auf die kein expliziter Zugriff möglich ist.
Neben der Tatsache, daß my-Variablen in einer eigenen Tabelle verwaltet werden, ist von besonderer Bedeutung, daß sie nur einen recht beschränkten Gültigkeitsbereich besitzen. Eine durch my erzeugte Variable steht nur in dem aktuellen Block (definiert durch geschweifte Klammern "{...}"), der aktuellen Datei oder innerhalb eines Arguments von eval() zur Verfügung. Außerhalb davon existieren diese Variablen nicht, es ist also (im Gegensatz zu our-Variablen) auch mit Hilfe des Package-Namens dort kein Zugriff möglich
Es kann in einem Package durchaus zwei Variablen gleichen Namens geben: eine in der Symboltabelle und eine, die durch einen Aufruf von my entstanden ist. In einem solchen Falle wird bei einfacher Verwendung des Bezeichners auf die my-Variable zugegriffen.

In $defs stehen alle Defines drin. In $hash wird also der Name des des aufrufenden Devices lokal hinterlegt und danach mit DevIO_IsOpen() der Status abgefragt.
$defs ist ein Hash. Ein Hash ist ein anderer Namen fuer ein assoziatives Array. Also eine ungeordnete Liste von Skalaren (Zahl oder String) die ueber einen Stringwert angesprochen (Lookup) werden koennen.

FHEM-Spezial:
In $defs findet man alle Devices, z.b. $defs{"Rolladen_Tuere"} beinhaltet das Device.
my @alle = keys %defs;
my @teilmenge = defInfo('TYPE=notify','NAME'); liefert ein array mit allen notify devices.
z.B. my @teilmenge = defInfo('NAME=Rollladen.*','NAME');

return "Device already open" if (defined($devState));
Sollte also das Device bereits im State "offen" sein, wird die connect-Routine abgebrochen. Dann erscheint in den Readings nicht Datum/Uhrzeit des Connects sondern die Meldung "Device already open".

# establish connection to websocket
# format must also include portnumber if a path is to be specified
$hash->{DeviceName} = AttrVal($name, "websocketURL", "wss:echo.websocket.org:443");

HASH-Operationen (Beispiel):
$href ={APR => 4,AUG => 8}; #anonymous hash
$el = $href->{APR}; $el = %{$href}{APR}; #access element of hash
$href2 = {%{$href1}}; #copy hash
if (ref($r) eq "HASH") {} #checks if $r points to hash

Dem Internal "DeviceName" wird das Ergebnis von AttrVal() zugewiesen. Bei mir ergab das:
DeviceName wss:websocket-api.tibber.com:443/v1-beta/gql/subscriptions

FHEM-Referenz:
AttrVal(<devicename>,<attribute>,<defaultvalue>)
Gibt das entsprechende Attribut des Gerätes zurück
{ Value("wz") }
{ OldValue("wz") }
{ time_str2num(OldTimestamp("wz")) }
{ ReadingsVal("wz", "measured-temp", "20")+0 }
{ ReadingsTimestamp("wz", "measured-temp", 0)}
{ AttrVal("wz", "room", "none") }

Das Attribut websocketURL ist bei mir wss:websocket-api.tibber.com:443/v1-beta/gql/subscriptions. Somit erklaert sich auch der Eintrag bei DeviceName. "wss:echo.websocket.org:443" ist nur der Defaultwert.

Man haette zum Testen auch die folgenden beiden verwenden/eintragen koennen.
There are free test servers that we can use to experiment with a WebSocket client, such as:

Hoppscotch – wss://echo-websocket.hoppscotch.io (GUI)
λ if else – wss://ws.ifelse.io (GUI)

Both provide a GUI for testing via a browser. The former sends a timestamp to the client every second but doesn’t respond to client messages. The latter is a standard echo service that sends a copy of each received message back to the client. Both make sense in testing.

Da curl nicht nativ websocket-Kommunikation unterstuetzt kann man auf folgende Tool ausweichen. Auch chrome bietet ein Websocket-Client-Plugin.
*wssh3
*websocat
*wscat

# special headers needed for Tibber, see also Developer Tools in Browser
$hash->{header}{'Sec-WebSocket-Protocol'} = 'graphql-transport-ws';
$hash->{header}{'Host'} = 'websocket-api.tibber.com';
$hash->{header}{'Origin'} = 'https://developer.tibber.com';

# callback function when "select()" signals data for us
# websocket Ping/Pongs are treated in DevIo but still call this function

$hash->{directReadFn} = sub () {
my $hash = $defs{$name};

# we can read without closing the DevIo, because select() signalled data
my $buf = DevIo_SimpleRead($hash);

# if read fails, close device
if(!defined($buf)) {
DevIo_CloseDev($hash);
$buf = "not_connected";
}

#Log(3, "$name:$reading: websocket data: >>>$buf<<<");

# only update our reading if buffer is not empty and if last update is older than minInterval
if ($buf ne "") {
my $websocketDataAge = ReadingsAge($name, "websocketData", 3600);
my $minInterval = AttrVal($name, "minInterval", 0);
my $isNext = ($buf =~ /.*id.*type.*next.*payload.*data.*liveMeasurement.*/s);

readingsBeginUpdate($hash);
readingsBulkUpdate($hash, "websocketData", "$buf") if ($isNext && $websocketDataAge > $minInterval);
readingsBulkUpdate($hash, "websocketData", "$buf") if (!$isNext);
readingsEndUpdate($hash, 1);
}
};

Die Callback-Funktion wird direkt, ohne Namen, in das/den (?) Hash unter directReadFn abgelegt.
Die Callback-Funktion:
Hier wird mit Hilfe der Funktion DevIo_SimpleRead() die Rueckmeldung des Server eingelesen. Siehe [https://wiki.fhem.de/wiki/DevIo]
Hinweis zum Logging in FHEM: [https://wiki.fhem.de/wiki/DevelopmentModuleAPI#Logging]
Die eigentliche Aktivitaet geschieht in den sieben Zeilen am Ende der Callback-Fkt.
ReadingsAge(<devicename>,<reading>,<defaultvalue>) #gibt das Alter des Readings in Sekunden zurück.
AttrVal hatten wir schon.
isNext bekommt seinen Wert aus dem durch einen REGEX geliefert Wert des Buffers. Beispiel ($match) = ($dirty =~ /^(.*)$/s);

Die Funktion readingsBeginUpdate() bereitet die Definition mit dem Hash $hash auf ein Update von Readings vor. Dies betrifft insbesondere das Setzen von Umgebungsvariablen sowie dem aktuellen Zeitstempel als Änderungszeitpunkt. Der Aufruf dieser Funktion ist notwendig um eigentliche Updates mit der Funktion readingsBulkUpdate() auf der gewünschten Definition durchführen zu können. [https://wiki.fhem.de/wiki/DevelopmentModuleAPI#readingsBeginUpdate]

Die Funktion readingsEndUpdate() beendet den Bulk-Update Prozess durch die Funktionen readingsBeginUpdate() & readingsBulkUpdate() und triggert optional die entsprechenden Events sämtlicher erzeugter Readings für die Definition $hash. Desweiteren werden nachgelagerte Tasks wie bspw. die Erzeugung von User-Readings (Attribut: userReadings), sowie die Erzeugung des STATE aufgrund des Attributs stateFormat durchgeführt. Sofern $do_trigger gesetzt ist, werden alle anstehenden Events nach Abschluss getriggert.

# open DevIo websocket
DevIo_OpenDev($hash, 0, undef, sub(){
my ($hash, $error) = @_;
return "$error" if ($error);

my $token = AttrVal($name, "token", "???");

DevIo_SimpleWrite($hash, '{"type":"connection_init","payload":{"token":"'.$token.'"}}', 2);
});

Das ist die eigentliche Kontaktaufnahme.

Dies dient vermutlich dazu, bis zum ersten Empfang von Daten, das Reading websocketDate zu leeren.

return POSIX::strftime("%H:%M:%S",localtime(time()));

Zum Abschluss erscheint dann im Reading connect die aktuelle Zeit.

readingsBulkUpdate($hash, "websocketData", "");

=====disconnect=====

<syntaxhighlight lang="python" line>
disconnect:cmd:.disconnect {
my $hash = $defs{$name};
RemoveInternalTimer($hash);
DevIo_SimpleRead($hash);
DevIo_CloseDev($hash);
return POSIX::strftime("%H:%M:%S",localtime(time()));
</syntaxhighlight>

Erlaeuterung:

*Die Funktion RemoveInternalTimer löscht möglicherweise noch anstehende Timer welche mit dem Übergabeparameter $arg gescheduled sind. Optional kann man zusätzlich die Suche auf eine bestimmte Funktion $functionName weiter einschränken. [https://wiki.fhem.de/wiki/DevelopmentModuleAPI#RemoveInternalTimer]

*Die Funktion DevIo_SimpleRead() liest anstehende Daten für die Verbindung von $hash ein und gibt diese zurück. [https://wiki.fhem.de/wiki/DevIo#DevIo_SimpleRead()]

*Die Funktion DevIo_CloseDev() schließt eine evtl. geöffnete Verbindung für die Definition $hash. [https://wiki.fhem.de/wiki/DevIo#DevIo_CloseDev()]

*POSIX:: [https://metacpan.org/pod/POSIX#strftime]

=====onDisconnect=====
TODO

=====onConnectionAck=====
TODO

=====onNextLiveMeasurement=====
TODO

===JavaScript===
Zum Eingewoehnen:

<syntaxhighlight lang=javascript>
// WebSocket-Verbindung herstellen
const socket = new WebSocket('ws://echo.websocket.org');

// Event-Handler für Verbindungsereignisse
socket.onopen = function(event) {
console.log('WebSocket-Verbindung hergestellt.');
// Nachricht senden, sobald die Verbindung hergestellt ist
socket.send('Hallo Server!');
};

socket.onmessage = function(event) {
console.log('Nachricht vom Server erhalten:', event.data);
};

socket.onclose = function(event) {
console.log('WebSocket-Verbindung geschlossen.');
};

socket.onerror = function(error) {
console.error('WebSocket-Fehler aufgetreten:', error);
};
</syntaxhighlight>

Und jetzt das Gerippe fuer Tibber mit Haut versehen:

<syntaxhighlight lang=javascript>
const WebSocket = require('ws');

const query = `subscription {
liveMeasurement(homeId: "xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb") {
timestamp
power
accumulatedConsumption
minPower
maxPower
averagePower
voltagePhase1
currentL1
accumulatedCost
currency
}
}`;

// WebSocket-Verbindung herstellen
const socket = new WebSocket('wss://websocket-api.tibber.com/v1-beta/gql/subscriptions',['graphql-transport-ws'], {
headers: {
'Content-Type': 'application/json',
'User-Agent': 'NodeJS tibberview',

}
});

// Event-Handler für Verbindungsereignisse
socket.onopen = function(event) {
console.log("WebSocket-Verbindung hergestellt.");
// Nachricht senden, sobald die Verbindung hergestellt ist
const connectionQuery = {
type: "connection_init",
payload: {
token: "xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb",
}
};

socket.send(JSON.stringify(connectionQuery));
console.log("Verbindung zum 'Tibber feed' hergestellt.");
};

socket.onmessage = function(event) {
console.log("Nachricht vom Server erhalten:", event.data);
const msg = JSON.parse(event.data);

if (msg.type === "connection_ack") {
console.log("Tibber ACK empfangen: ", msg);

const realtimeDataQuery = {
id: "xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb",
type: "subscribe",
payload: { query }
};

socket.send(JSON.stringify(realtimeDataQuery));
}
else if (msg.type === "next") {
if (!msg.payload.data) {
console.log("⚠ Nachricht hat keinen Inhalt.");
return;
}
const data = msg.payload.data.liveMeasurement;
socket.emit("data", data);
} else {
console.log("Nachrichteninhalt: ", msg)
}
};

socket.onclose = function(event) {
console.log('WebSocket-Verbindung geschlossen.');
};

socket.onerror = function(error) {
console.error('WebSocket-Fehler aufgetreten:', error);
};

</syntaxhighlight>

Das Programm erzeugte folgende Ausgabe:
<syntaxhighlight lang=bash>
worker:/mnt/1.5T_RAID/Programme/JavaScript/WebSocket # node tibberclient_demo.js
WebSocket-Verbindung hergestellt.
Verbindung zum 'Tibber feed' hergestellt.
Nachricht vom Server erhalten: {"type":"connection_ack"}
Tibber ACK empfangen: { type: 'connection_ack' }
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:48.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.6,"voltagePhase1":230.1,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:51.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.3,"voltagePhase1":229.8,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:52.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.3,"voltagePhase1":230,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:53.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.2,"voltagePhase1":230.3,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:54.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.1,"voltagePhase1":230.3,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:55.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306,"voltagePhase1":230.2,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:56.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306,"voltagePhase1":229.8,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:57.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.9,"voltagePhase1":229.9,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:58.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.8,"voltagePhase1":230.1,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:59.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.8,"voltagePhase1":230.4,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:47:00.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.7,"voltagePhase1":230.1,"currentL1":2.7,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"xxxxxxxx-yyyy-zzzz-aaaa-bbbbbbbbbbbb","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:47:01.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.6,"voltagePhase1":229.9,"currentL1":2.7,"accumulatedCost":11.672781,"currency":"SEK"}}}}
^C
</syntaxhighlight>

An der Stelle mache ich jetzt einen Ausflug in PHP.

===PHP===
Nachdem der Websocket-Kontakt mit JavaScript funktioniert hat, kommt jetzt ein Serverprogramm was folgendes tun soll.

*Abfrage der Basisdaten
*Objekt Types Builder
*Mutation
*Websocket Subsrciption

TODO

===Python===

Quelle: https://github.com/Danielhiversen/pyTibber

Client-Beispiel mit eingesetztem DEMO_TOKEN und user_agent
Obwohl DEMO_TOKEN in tibber.py definiert ist, wird es nicht uebernommen.
<syntaxhighlight lang=python>
import tibber.const
import tibber
import asyncio

async def start():
tibber_connection = tibber.Tibber(tibber.const.DEMO_TOKEN, user_agent="worker")
await tibber_connection.update_info()
print(tibber_connection.name)

home = tibber_connection.get_homes()[0]
await home.fetch_consumption_data()
await home.update_info()
print(home.address1)

await home.update_price_info()
print(home.current_price_info)

# await tibber_connection.close_connection()

loop = asyncio.run(start())
</syntaxhighlight>

<syntaxhighlight lang=python>
import tibber.const
import asyncio

import aiohttp
import tibber

def _callback(pkg):
print(pkg)
data = pkg.get("data")
if data is None:
return
print(data.get("liveMeasurement"))

async def run():
async with aiohttp.ClientSession() as session:
tibber_connection = tibber.Tibber(tibber.const.DEMO_TOKEN, websession=session, user_agent="worker")
await tibber_connection.update_info()
home = tibber_connection.get_homes()[0]
await home.rt_subscribe(_callback)

while True:
await asyncio.sleep(10)

loop = asyncio.run(run())
</syntaxhighlight>

Starlink

2026-07-31T15:53:27Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Starlink Mini=
So heute (2026-06-29) mal Starlink in Betrieb genommen.

Die Lieferung war ein K(r)ampf. Bestellt am 11. Mai 2026 und heute ist der Router immer noch nicht da!
DHL hat zwar nachverpackt, aber wieder zurueckgeschickt. Eine Supportanfrage wurde zwar beantwortet, aber immer noch kein neuer Router unterwegs.

Den Router brauche ich aber GsD nicht. Die Antenne hat soweit schon alles eingebaut.
Per WLAN mit dem Mobil verbunden und die Ausrichtung durchgefuehrt.

Das spezielle Ethernetkabel, mit Feuchtigkeitsschutz, habe ich bei AliExpress bestellt.

Die Antenne hat standardmaeszig die IP 192.168.1.1.

DHCP ist eingebaut.

Ein per LAN angeschlossener PC hat die IP 192.168.1.222 erhalten.

Der Bandbreitentest ergab bei einem 100 MBit/s-Vertrag folgendes:

[[File:Screenshot 2026-06-29 at 18-40-02 Browsermessung Breitbandmessung.png|400px]]

Jetzt kommt die Antenne an den zweiten WAN-Anschluss des USG-3P und als Backup (Distributed; Failover taugt nix! Kein automatisches Restore nach einem Fallback!) fuer meinen Vodafone Kabel-Gigabit-Anschluss.

Ping von der console:

<pre>
ping clx.de
PING clx.de (217.160.223.182) 56(84) bytes of data.
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=1 ttl=56 time=45.4 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=2 ttl=56 time=24.0 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=3 ttl=56 time=34.4 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=4 ttl=56 time=32.7 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=5 ttl=56 time=27.5 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=6 ttl=56 time=25.9 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=7 ttl=56 time=39.9 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=8 ttl=56 time=45.8 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=9 ttl=56 time=45.4 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=10 ttl=56 time=36.0 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=11 ttl=56 time=26.9 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=12 ttl=56 time=44.5 ms
64 bytes from clienthosting.eu (217.160.223.182): icmp_seq=13 ttl=56 time=24.3 ms
</pre>

Speedtest

<pre>
speedtest-cli --server 73799
Retrieving speedtest.net configuration...
Testing from Starlink (145.224.73.201)...
Retrieving speedtest.net server list...
Retrieving information for the selected server...
Hosted by Bordell RoyalGirl (Berlin) [0.12 km]: 1800000.0 ms
Testing download speed................................................................................
Download: 92.09 Mbit/s
Testing upload speed......................................................................................................
Upload: 37.41 Mbit/s
</pre>

<pre>
speedtest-cli --server 69225
Retrieving speedtest.net configuration...
Testing from Starlink (145.224.73.201)...
Retrieving speedtest.net server list...
Retrieving information for the selected server...
Hosted by cndd.net (Berlin) [1.63 km]: 1800000.0 ms
Testing download speed................................................................................
Download: 91.54 Mbit/s
Testing upload speed......................................................................................................
Upload: 38.59 Mbit/s
</pre>

Zum Vergleich ein Vodafone300 (Gigabit-Kabel)
<pre>
speedtest-cli --server 1973
Retrieving speedtest.net configuration...
Testing from Vodafone Germany (77.24.97.213)...
Retrieving speedtest.net server list...
Retrieving information for the selected server...
Hosted by DegNet GmbH (Deggendorf) [148.20 km]: 1800000.0 ms
Testing download speed................................................................................
Download: 281.15 Mbit/s
Testing upload speed......................................................................................................
Upload: 32.11 Mbit/s
</pre>

Was die 1800000.0 ms bedeuten sollen muss ich noch rausfinden.

=EasterEgg=

<pre>
ssh admin@192.168.1.1
The authenticity of host '192.168.1.1 (192.168.1.1)' can't be established.
ECDSA key fingerprint is SHA256:iVCavjPXwZzXDSnWIHi+nqJe5K8oe9URY6ipf5dwYwU.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added '192.168.1.1' (ECDSA) to the list of known hosts.

-----BEGIN CERTIFICATE-----
MIIB6zCCAXCgAwIBAgIMAQAAAAAAAAABtXq1MAoGCCqGSM49BAMDMBsxGTAXBgNV
BAMTEFNwYWNlWCBSb3V0ZXIgQ0EwHhcNMjUxMDEyMDAwMDAwWhcNNDUxMDEyMDAw
MDAwWjBIMQswCQYDVQQGEwJVUzEPMA0GA1UEChMGU3BhY2VYMSgwJgYDVQQDEx9S
b3V0ZXItMDEwMDAwMDAwMDAwMDAwMDAxQjU3QUI1MHYwEAYHKoZIzj0CAQYFK4EE
ACIDYgAEjwUdaSvXuwKV+Esmefdhn1hyDdevo8VVaIxs17CymQtoFgUApAWsby3b
U3p5TBPGkx1ERnm24stNf9dHeby4O1eYEDi2e+2fyXqvFbj3zRVYz5YuGOkAD4ng
//jt4Dcio1AwTjAdBgNVHQ4EFgQUo3Z4qcDEJe2nsXebQirJtA6ZoUgwHwYDVR0j
BBgwFoAUXK1XuFQFitF8QKLiv/LDgeiTQiAwDAYDVR0TBAUwAwEBADAKBggqhkjO
PQQDAwNpADBmAjEAuZZgNNj2rdtAOUM580KSjajK+TFguE2QK2ccAgmriQd4k0pO
MEkwFJ8FJZ96WSkEAjEAmMzGiWHzvmGQYWuknBsg1gXCClUhi3NksFUsdqeoubWb
SIVBnB886ms6coVOcptg
-----END CERTIFICATE-----

+
+
+ +
+ +
+ + __
+ + + + + + + __ / \
+ + + + / \ |~~~~|
+ + + + |~~~~| ______________ \ /
+ + + \ / / // ||
+ + + || / O -=- // /
+ + + \ _/ ,_____, //__/
+ + + + \// \___/ //\
+ + + + / // \\
+ + + + + + + + + + /____________// \\
--------------------------------------------------------------------------------
In 2021, Starlink WiFi basically consisted of router and a dishy cable. That
was it. That's all of Starlink WiFi in 2021. As you can see, I'm a routing
machine. And, yeah, I believe in kicking off wireless communication events
with mariachi bands. I really like mariachi bands.

2026.06.18.mr79817 Router-010000000000000001B57AB5
--------------------------------------------------------------------------------
admin@192.168.1.1: Permission denied (publickey,keyboard-interactive).
</pre>

=Ports=
<pre>
nmap -v -A 192.168.1.1
Starting Nmap 7.95 ( https://nmap.org ) at 2026-07-03 16:59 CEST
NSE: Loaded 157 scripts for scanning.
NSE: Script Pre-scanning.
Initiating NSE at 16:59
Completed NSE at 16:59, 0.00s elapsed
Initiating NSE at 16:59
Completed NSE at 16:59, 0.00s elapsed
Initiating NSE at 16:59
Completed NSE at 16:59, 0.00s elapsed
Initiating ARP Ping Scan at 16:59
Scanning 192.168.1.1 [1 port]
Completed ARP Ping Scan at 16:59, 0.06s elapsed (1 total hosts)
Initiating Parallel DNS resolution of 1 host. at 16:59
Completed Parallel DNS resolution of 1 host. at 16:59, 0.04s elapsed
Initiating SYN Stealth Scan at 16:59
Scanning 192.168.1.1 [1000 ports]
Discovered open port 53/tcp on 192.168.1.1
Discovered open port 80/tcp on 192.168.1.1
Discovered open port 22/tcp on 192.168.1.1
Discovered open port 9002/tcp on 192.168.1.1
Discovered open port 9003/tcp on 192.168.1.1
Discovered open port 9001/tcp on 192.168.1.1
Discovered open port 9000/tcp on 192.168.1.1
Completed SYN Stealth Scan at 16:59, 4.75s elapsed (1000 total ports)
Initiating Service scan at 16:59
Scanning 7 services on 192.168.1.1
Completed Service scan at 16:59, 26.18s elapsed (7 services on 1 host)
Initiating OS detection (try #1) against 192.168.1.1
Retrying OS detection (try #2) against 192.168.1.1
NSE: Script scanning 192.168.1.1.
Initiating NSE at 16:59
Completed NSE at 17:00, 8.58s elapsed
Initiating NSE at 17:00
Completed NSE at 17:00, 0.34s elapsed
Initiating NSE at 17:00
Completed NSE at 17:00, 0.00s elapsed
Nmap scan report for 192.168.1.1
Host is up (0.00076s latency).
Not shown: 992 filtered tcp ports (no-response)
PORT STATE SERVICE VERSION
22/tcp open ssh OpenSSH 7.4 (protocol 2.0)
| ssh-hostkey:
| 2048 c6:25:91:7b:dd:f8:fb:fe:96:af:eb:a3:02:95:2e:bb (RSA)
|_ 384 2c:e3:a4:8c:23:3d:70:67:79:7d:75:24:0f:d2:fb:b2 (ECDSA)
53/tcp open tcpwrapped
| dns-nsid:
| NSID: Go SpaceX! Go Starlink! (476f205370616365582120476f20537461726c696e6b21)
| id.server: Go SpaceX! Go Starlink!
|_ bind.version: 2002-03-14
80/tcp open http Golang net/http server
|_http-title: Starlink
| http-methods:
|_ Supported Methods: GET HEAD POST
|_http-favicon: Unknown favicon MD5: D43B9C2E786CF83C5C8E48DC6A22C6FC
| fingerprint-strings:
| FourOhFourRequest, GetRequest:
| HTTP/1.0 200 OK
| X-Content-Type-Options: nosniff
| X-Frame-Options: DENY
| Date: Fri, 03 Jul 2026 14:59:36 GMT
| Content-Type: text/html; charset=utf-8
| <!doctype html>
| <html>
| <head>
| <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
| <link rel="shortcut icon" href="static/favicon.ico">
| <title>Starlink</title>
| <link rel="stylesheet" type="text/css" href="static/css/layout.css" media="screen">
| <meta name="viewport" content="width=device-width, maximum-scale=1.0, user-scalable=1">
| <style>
| .button-link, .button-link:visited {
| display: inline-block;
| padding: 10px 20px;
| font-size: 16px;
| color: black;
| background-color: white;
| text-decoration: none;
| border-radius: 5px;
| text-align: center;
| .button-link:hover {
| HTTPOptions:
| HTTP/1.0 405 Method Not Allowed
| Content-Type: text/plain; charset=utf-8
| X-Content-Type-Options: nosniff
| Date: Fri, 03 Jul 2026 14:59:36 GMT
| Content-Length: 19
| Method not allowed
| RTSPRequest:
| HTTP/1.1 400 Bad Request
| Content-Type: text/plain; charset=utf-8
| Connection: close
|_ Request
443/tcp closed https
9000/tcp open grpc
9001/tcp open http Golang net/http server
|_http-title: Site doesn't have a title (text/plain; charset=utf-8).
| fingerprint-strings:
| FourOhFourRequest:
| HTTP/1.0 500 Internal Server Error
| Content-Type: text/plain; charset=utf-8
| X-Content-Type-Options: nosniff
| Date: Fri, 03 Jul 2026 14:59:51 GMT
| Content-Length: 22
| Internal Server Error
| GenericLines, Help, LPDString, RTSPRequest, SIPOptions, SSLSessionReq, Socks5:
| HTTP/1.1 400 Bad Request
| Content-Type: text/plain; charset=utf-8
| Connection: close
| Request
| GetRequest, HTTPOptions:
| HTTP/1.0 500 Internal Server Error
| Content-Type: text/plain; charset=utf-8
| X-Content-Type-Options: nosniff
| Date: Fri, 03 Jul 2026 14:59:36 GMT
| Content-Length: 22
| Internal Server Error
| OfficeScan:
| HTTP/1.1 400 Bad Request: missing required Host header
| Content-Type: text/plain; charset=utf-8
| Connection: close
|_ Request: missing required Host header
| http-methods:
|_ Supported Methods: POST
9002/tcp open ssl/dynamid?
| ssl-cert: Subject: commonName=Router-010000000000000001B57AB5/organizationName=SpaceX/countryName=US
| Issuer: commonName=SpaceX Router CA
| Public Key type: ec
| Public Key bits: 384
| Signature Algorithm: ecdsa-with-SHA384
| Not valid before: 2025-10-12T00:00:00
| Not valid after: 2045-10-12T00:00:00
| MD5: 0d98:5c08:8aba:44e1:22ac:b8d1:0501:477e
|_SHA-1: 0856:39fd:132e:ac24:dda6:57aa:e902:5ae0:c208:0e0b
9003/tcp open grpc
2 services unrecognized despite returning data. If you know the service/version, please submit the following fingerprints at https://nmap.org/cgi-bin/submit.cgi?new-service :
==============NEXT SERVICE FINGERPRINT (SUBMIT INDIVIDUALLY)==============
SF-Port80-TCP:V=7.95%I=7%D=7/3%Time=6A47CE58%P=x86_64-suse-linux-gnu%r(Get
SF:Request,1553,"HTTP/1\.0\x20200\x20OK\r\nX-Content-Type-Options:\x20nosn
SF:iff\r\nX-Frame-Options:\x20DENY\r\nDate:\x20Fri,\x2003\x20Jul\x202026\x
SF:2014:59:36\x20GMT\r\nContent-Type:\x20text/html;\x20charset=utf-8\r\n\r
SF:\n<!doctype\x20html>\r\n<html>\r\n<head>\r\n\t<meta\x20http-equiv=\"Con
SF:tent-Type\"\x20content=\"text/html;\x20charset=utf-8\"\x20/>\r\n\t<link
SF:\x20rel=\"shortcut\x20icon\"\x20href=\"static/favicon\.ico\">\r\n\t<tit
SF:le>Starlink</title>\r\n\r\n\x20\x20\x20\x20<link\x20rel=\"stylesheet\"\
SF:x20type=\"text/css\"\x20href=\"static/css/layout\.css\"\x20media=\"scre
SF:en\">\r\n\r\n\x20\x20\x20\x20<meta\x20name=\"viewport\"\x20content=\"wi
SF:dth=device-width,\x20maximum-scale=1\.0,\x20user-scalable=1\">\r\n\x20\
SF:x20\x20\x20<style>\r\n\x20\x20\x20\x20\x20\x20\x20\x20\.button-link,\x2
SF:0\.button-link:visited\x20{\r\n\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20
SF:\x20\x20display:\x20inline-block;\r\n\x20\x20\x20\x20\x20\x20\x20\x20\x
SF:20\x20\x20\x20padding:\x2010px\x2020px;\r\n\x20\x20\x20\x20\x20\x20\x20
SF:\x20\x20\x20\x20\x20font-size:\x2016px;\r\n\x20\x20\x20\x20\x20\x20\x20
SF:\x20\x20\x20\x20\x20color:\x20black;\r\n\x20\x20\x20\x20\x20\x20\x20\x2
SF:0\x20\x20\x20\x20background-color:\x20white;\r\n\x20\x20\x20\x20\x20\x2
SF:0\x20\x20\x20\x20\x20\x20text-decoration:\x20none;\r\n\x20\x20\x20\x20\
SF:x20\x20\x20\x20\x20\x20\x20\x20border-radius:\x205px;\r\n\x20\x20\x20\x
SF:20\x20\x20\x20\x20\x20\x20\x20\x20text-align:\x20center;\r\n\x20\x20\x2
SF:0\x20\x20\x20\x20\x20}\r\n\r\n\x20\x20\x20\x20\x20\x20\x20\x20\.button-
SF:link:hover\x20{\r\n\x20\x20\x20\x20\x20\x20\x20\x20")%r(HTTPOptions,B9,
SF:"HTTP/1\.0\x20405\x20Method\x20Not\x20Allowed\r\nContent-Type:\x20text/
SF:plain;\x20charset=utf-8\r\nX-Content-Type-Options:\x20nosniff\r\nDate:\
SF:x20Fri,\x2003\x20Jul\x202026\x2014:59:36\x20GMT\r\nContent-Length:\x201
SF:9\r\n\r\nMethod\x20not\x20allowed\n")%r(RTSPRequest,67,"HTTP/1\.1\x2040
SF:0\x20Bad\x20Request\r\nContent-Type:\x20text/plain;\x20charset=utf-8\r\
SF:nConnection:\x20close\r\n\r\n400\x20Bad\x20Request")%r(FourOhFourReques
SF:t,1000,"HTTP/1\.0\x20200\x20OK\r\nX-Content-Type-Options:\x20nosniff\r\
SF:nX-Frame-Options:\x20DENY\r\nDate:\x20Fri,\x2003\x20Jul\x202026\x2014:5
SF:9:36\x20GMT\r\nContent-Type:\x20text/html;\x20charset=utf-8\r\n\r\n<!do
SF:ctype\x20html>\r\n<html>\r\n<head>\r\n\t<meta\x20http-equiv=\"Content-T
SF:ype\"\x20content=\"text/html;\x20charset=utf-8\"\x20/>\r\n\t<link\x20re
SF:l=\"shortcut\x20icon\"\x20href=\"static/favicon\.ico\">\r\n\t<title>Sta
SF:rlink</title>\r\n\r\n\x20\x20\x20\x20<link\x20rel=\"stylesheet\"\x20typ
SF:e=\"text/css\"\x20href=\"static/css/layout\.css\"\x20media=\"screen\">\
SF:r\n\r\n\x20\x20\x20\x20<meta\x20name=\"viewport\"\x20content=\"width=de
SF:vice-width,\x20maximum-scale=1\.0,\x20user-scalable=1\">\r\n\x20\x20\x2
SF:0\x20<style>\r\n\x20\x20\x20\x20\x20\x20\x20\x20\.button-link,\x20\.but
SF:ton-link:visited\x20{\r\n\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x
SF:20display:\x20inline-block;\r\n\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20
SF:\x20\x20padding:\x2010px\x2020px;\r\n\x20\x20\x20\x20\x20\x20\x20\x20\x
SF:20\x20\x20\x20font-size:\x2016px;\r\n\x20\x20\x20\x20\x20\x20\x20\x20\x
SF:20\x20\x20\x20color:\x20black;\r\n\x20\x20\x20\x20\x20\x20\x20\x20\x20\
SF:x20\x20\x20background-color:\x20white;\r\n\x20\x20\x20\x20\x20\x20\x20\
SF:x20\x20\x20\x20\x20text-decoration:\x20none;\r\n\x20\x20\x20\x20\x20\x2
SF:0\x20\x20\x20\x20\x20\x20border-radius:\x205px;\r\n\x20\x20\x20\x20\x20
SF:\x20\x20\x20\x20\x20\x20\x20text-align:\x20center;\r\n\x20\x20\x20\x20\
SF:x20\x20\x20\x20}\r\n\r\n\x20\x20\x20\x20\x20\x20\x20\x20\.button-link:h
SF:over\x20{\r\n\x20\x20\x20\x20\x20\x20\x20\x20");
==============NEXT SERVICE FINGERPRINT (SUBMIT INDIVIDUALLY)==============
SF-Port9001-TCP:V=7.95%I=7%D=7/3%Time=6A47CE58%P=x86_64-suse-linux-gnu%r(G
SF:enericLines,67,"HTTP/1\.1\x20400\x20Bad\x20Request\r\nContent-Type:\x20
SF:text/plain;\x20charset=utf-8\r\nConnection:\x20close\r\n\r\n400\x20Bad\
SF:x20Request")%r(GetRequest,BF,"HTTP/1\.0\x20500\x20Internal\x20Server\x2
SF:0Error\r\nContent-Type:\x20text/plain;\x20charset=utf-8\r\nX-Content-Ty
SF:pe-Options:\x20nosniff\r\nDate:\x20Fri,\x2003\x20Jul\x202026\x2014:59:3
SF:6\x20GMT\r\nContent-Length:\x2022\r\n\r\nInternal\x20Server\x20Error\n"
SF:)%r(SSLSessionReq,67,"HTTP/1\.1\x20400\x20Bad\x20Request\r\nContent-Typ
SF:e:\x20text/plain;\x20charset=utf-8\r\nConnection:\x20close\r\n\r\n400\x
SF:20Bad\x20Request")%r(HTTPOptions,BF,"HTTP/1\.0\x20500\x20Internal\x20Se
SF:rver\x20Error\r\nContent-Type:\x20text/plain;\x20charset=utf-8\r\nX-Con
SF:tent-Type-Options:\x20nosniff\r\nDate:\x20Fri,\x2003\x20Jul\x202026\x20
SF:14:59:36\x20GMT\r\nContent-Length:\x2022\r\n\r\nInternal\x20Server\x20E
SF:rror\n")%r(RTSPRequest,67,"HTTP/1\.1\x20400\x20Bad\x20Request\r\nConten
SF:t-Type:\x20text/plain;\x20charset=utf-8\r\nConnection:\x20close\r\n\r\n
SF:400\x20Bad\x20Request")%r(Help,67,"HTTP/1\.1\x20400\x20Bad\x20Request\r
SF:\nContent-Type:\x20text/plain;\x20charset=utf-8\r\nConnection:\x20close
SF:\r\n\r\n400\x20Bad\x20Request")%r(FourOhFourRequest,BF,"HTTP/1\.0\x2050
SF:0\x20Internal\x20Server\x20Error\r\nContent-Type:\x20text/plain;\x20cha
SF:rset=utf-8\r\nX-Content-Type-Options:\x20nosniff\r\nDate:\x20Fri,\x2003
SF:\x20Jul\x202026\x2014:59:51\x20GMT\r\nContent-Length:\x2022\r\n\r\nInte
SF:rnal\x20Server\x20Error\n")%r(LPDString,67,"HTTP/1\.1\x20400\x20Bad\x20
SF:Request\r\nContent-Type:\x20text/plain;\x20charset=utf-8\r\nConnection:
SF:\x20close\r\n\r\n400\x20Bad\x20Request")%r(SIPOptions,67,"HTTP/1\.1\x20
SF:400\x20Bad\x20Request\r\nContent-Type:\x20text/plain;\x20charset=utf-8\
SF:r\nConnection:\x20close\r\n\r\n400\x20Bad\x20Request")%r(Socks5,67,"HTT
SF:P/1\.1\x20400\x20Bad\x20Request\r\nContent-Type:\x20text/plain;\x20char
SF:set=utf-8\r\nConnection:\x20close\r\n\r\n400\x20Bad\x20Request")%r(Offi
SF:ceScan,A3,"HTTP/1\.1\x20400\x20Bad\x20Request:\x20missing\x20required\x
SF:20Host\x20header\r\nContent-Type:\x20text/plain;\x20charset=utf-8\r\nCo
SF:nnection:\x20close\r\n\r\n400\x20Bad\x20Request:\x20missing\x20required
SF:\x20Host\x20header");
MAC Address: 74:24:9F:45:7A:B5 (Tibro)
Aggressive OS guesses: Linux 3.2 - 4.14 (98%), Linux 3.10 - 4.11 (94%), OpenWrt Chaos Calmer 15.05 (Linux 3.18) or Designated Driver (Linux 4.1 or 4.4) (94%), Android 5.1 (94%), Android 6 - 9 (Linux 3.18) (94%), Linux 3.2 - 3.16 (94%), Linux 3.18 (93%), DD-WRT (Linux 3.18) (93%), Linux 4.4 (93%), Android 4 (92%)
No exact OS matches for host (test conditions non-ideal).
Uptime guess: 3.511 days (since Tue Jun 30 04:44:28 2026)
Network Distance: 1 hop
TCP Sequence Prediction: Difficulty=252 (Good luck!)
IP ID Sequence Generation: All zeros

TRACEROUTE
HOP RTT ADDRESS
1 0.76 ms 192.168.1.1

NSE: Script Post-scanning.
Initiating NSE at 17:00
Completed NSE at 17:00, 0.00s elapsed
Initiating NSE at 17:00
Completed NSE at 17:00, 0.00s elapsed
Initiating NSE at 17:00
Completed NSE at 17:00, 0.00s elapsed
Read data files from: /usr/bin/../share/nmap
OS and Service detection performed. Please report any incorrect results at https://nmap.org/submit/ .
Nmap done: 1 IP address (1 host up) scanned in 43.89 seconds
Raw packets sent: 2045 (93.288KB) | Rcvd: 37 (2.244KB)
</pre>

=traceroute=

Route auf die oeffentliche IPV4 der Antenne. Man sieht die Pakete laufen ueber meinen Kabelanschluss raus
<pre>
traceroute 145.224.73.201
traceroute to 145.224.73.201 (145.224.73.201), 30 hops max, 60 byte packets
1 USG-3P (192.168.178.1) 0.426 ms 0.600 ms 0.856 ms
2 192.168.1.1 (192.168.1.1) 3.551 ms 4.550 ms 4.628 ms
3 ip4d1861d6.fixed.kabel-deutschland.de (77.24.97.214) 16.167 ms 20.308 ms 22.135 ms
4 ip5886d836.static.kabel-deutschland.de (88.134.216.54) 18.312 ms 22.198 ms 22.233 ms
5 ip5886c1b6.static.kabel-deutschland.de (88.134.193.182) 24.488 ms 26.521 ms 28.066 ms
6 145.254.3.170 (145.254.3.170) 29.953 ms 24.044 ms 19.597 ms
7 145.254.2.195 (145.254.2.195) 17.266 ms 22.275 ms 145.254.2.15 (145.254.2.15) 25.638 ms
8 ae32-100-pcr1.fnt.cw.net (195.2.18.217) 24.221 ms spacex-ic-371295.ip.twelve99-cust.net (62.115.37.21) 23.103 ms ae32-100-pcr1.fnt.cw.net (195.2.18.217) 17.806 ms
9 telia-gw.fnt.cw.net (195.2.22.238) 20.614 ms 18.744 ms ae17.pcr1.fnt.cw.net (195.2.20.226) 21.914 ms
10 telia-gw.fnt.cw.net (195.2.22.238) 21.985 ms spacex-ic-371295.ip.twelve99-cust.net (62.115.37.21) 21.789 ms 23.601 ms
11 spacex-ic-371295.ip.twelve99-cust.net (62.115.37.21) 23.583 ms 18.059 ms 19.935 ms
12 * * *
13 undefined.hostname.localhost (206.224.68.195) 24.057 ms 22.618 ms *
14 * * *
</pre>

Telia ist ein großer schwedischer Telekommunikationskonzern. Der internationale Backbone-Bereich hieß früher Telia Carrier; das globale IP-Backbone ist unter AS1299 bekannt. Telia Carrier wurde später als Arelion weitergeführt. Das zeigt ziemlich eindeutig einen Netzübergang/Peering-Punkt zwischen dem Cable-&-Wireless-Backbone und dem damaligen Telia/Twelve99-Backbone in Frankfurt.
spacex-ic-371295.ip.twelve99-cust.net hat die IP-Adresse 62.115.37.21. Der Name bezeichnet sehr wahrscheinlich einen Interconnect zwischen dem Arelion/Twelve99-Backbone und SpaceX/Starlink.Die Lokalisierung ist sehr wahrscheinlich Frankfurt am Main. Und dann verliert sich die Spur:-(

Sungo SXL MQTT Anbindung

2026-07-31T15:53:25Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Nach einer kleinen Pause (5 Monate) versuche ich die SunGO SXL Anbindung aus dem Versuchstadium zu befreien und mal alles ordentlich zu machen. Die Hardware kommt in eine Gehäuse und die Software soll ihren ersten Stresstest bestehen.

=Ausgangssituation=
[[Datei:SunGO Raspi Interface roh.jpg|mini]]
Abgesehen von der SunGo SXL Steuerung sind aktuelle noch ein RasPi 3B, ein CP2102 USBSER und Arduino NANO und 4 DS18B20 im Einsatz.
Das Netzteil ist nur eine Übergangslösung. Am liebsten wuerde ich eine MiniUSV mit ins Gehaeuse packen. Mal schauen was es da von der Stange gibt.
Auf dem RasPi laeuft derzeit nur eine Software die die Aufgabe hat die Daten des SunGo-Interfaces und die Temperaturen der 4 DS18B20 (Vor-/Ruecklauf-Heizkreis1 und Vor-/Ruecklauf-Fuszbodenheizung) einzulesen und per MQTT an den FHEM-Broker (MQTT-Server) zu liefern.

=Software=
Verdammt! Nach 5 Monaten raecht sich die fehlende Dokumentation.

==Sungo_MQTT==
Dieses Programm liest die Daten des Interfaces ueber die USB-Schnittstelle ein und uebergibt sie an die Console und den MQTT-Server.
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Sungo_MQTT.c</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="c" line>
#include <string.h>
#include <stdlib.h>
#include <stdio.h>
#include <unistd.h>
#include <stdbool.h>
#include <time.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <termios.h> // termios is the API that is in general recommended for serial I/O in Unix.
#include "MQTTClient.h"

// MQTT defines
#define ADDRESS "tcp://192.168.178.12:1883"
//#define ADDRESS "tcp://localhost:1883"
#define CLIENTID "SunGo"
//#define TOPIC "MQTTExamples"
//#define PAYLOAD "Hello World!"
#define QOS 0
#define TIMEOUT 10000L

// SERCOM defines
#define BAUDRATE B115200
#define MODEMDEVICE "/dev/ttyS1"
#define _POSIX_SOURCE 1 /* POSIX compliant source */
#define FALSE 0
#define TRUE 1

// SunGo defines
#define DUMMY 0
#define TEMPERATUR 1 // °C
#define STRAHLUNG 2 // W/m²
#define SPEICHER1 7 // kwh
#define DATUM 8
#define UHRZEIT 9
#define PROZENT 10 // %
#define FUNKTION1 11
#define FUNKTION2 12
#define SPEICHER2 15 // h
#define VOLUMENSTROM 19 // l/min

volatile int STOP=FALSE; // braucht man eigentlich nicht Man koennte z.B. um die Endlosschleife elegant zu verlassen durch einen Taster mit ISR die globale Variabe STOP auf true setzen
// solange das nicht realisiert ist laeuft die "main-Schleife" endlos.

// globale Variablen
char datum[11];
char uhrzeit[7];
char temperatur[25];
char prozent[7];
char strahlung[8];
char fehler[17];
char stunden[8];
char dummy[7];

// hexadezimale Darstellung in dezimale umstellen
unsigned int hextodec(char hex[10]){
unsigned int decimal=0;
unsigned int length=0;
unsigned int base = 1;
int i=0;

while(hex[i]!='\0'){
i++;
}
length=i;

//printf("hextodec %s\n\r",hex);
//printf("length %d\n\r",length);

for(i = length-1; i >= 0; i--){
//printf("i: %d\n\r",i);
if (i<0)i=0;
if(hex[i] >= '0' && hex[i] <= '9'){
decimal += ((unsigned char)hex[i] - 48) * base;
base *= 16;
}
else if(hex[i] >= 'A' && hex[i] <= 'F'){
decimal += ((unsigned char)hex[i] - 55) * base;
base *= 16;
}
else if(hex[i] >= 'a' && hex[i] <= 'f'){
decimal += ((unsigned char)hex[i] - 87) * base;
base *= 16;
}
}
//printf("decimal %d\n\r",decimal);
return decimal;
}

void delay(int number_of_seconds) // wird doch nicht gebraucht
{
// Converting time into milli_seconds
int milli_seconds = 1000 * number_of_seconds;

// Storing start time
clock_t start_time = clock();

// looping till required time is not achieved
while (clock() < start_time + milli_seconds)
;
}

// allgemeine Funktion; die verschiedenen Typen werden ueber switch case angesprochen
void formatieren(unsigned char typ,unsigned char lowbyte,unsigned char highbyte){
char data[10]=""; // dient der Aufnahme des zu wandelnden Wertes gebildet aus highbyte und lowbyte
char tmp[3]=""; // hilfvariable
char formatted[25]="";
char dataStr[5]="";
unsigned int dataInteger;
float dataFloat;
unsigned int dataStunden, dataMinuten;

//memset(formatted,'\0',sizeof(formatted));
//memset(data,'\0',sizeof(data));
//memset(tmp,'\0',sizeof(tmp));

// aus den beiden Einzelwerten wird der "Gesamtwert in der "richtigen" Reihenfolge gebildet
sprintf(tmp,"%02X",highbyte);
strcpy(data,tmp);
sprintf(tmp,"%02X",lowbyte);
strcat(data,tmp);

//printf("Data: %s\n",data);

dataInteger=hextodec(data);

switch(typ) {
case DUMMY: if(TRUE){
strcpy(dummy,data);
}
else{
strcpy(dummy,"Error!");
}
break;
case DATUM: sprintf(dataStr,"%d",dataInteger);
strcpy(formatted,"00.00.2021");
if(strlen(dataStr)==3){
formatted[0]=dataStr[1];
formatted[1]=dataStr[2];
formatted[4]=dataStr[0];
strcpy(datum,formatted);
}
else if(strlen(dataStr)==4){
formatted[0]=dataStr[2];
formatted[1]=dataStr[3];
formatted[3]=dataStr[0];
formatted[4]=dataStr[1];
strcpy(datum,formatted);
}
else{
strcpy(datum,"Error!");
}
break;
case UHRZEIT: dataStunden=(unsigned int)dataInteger/60;
dataMinuten=dataInteger-(dataStunden*60);
if(TRUE){ // hier koennte man die gueltig der stunden und minuten noch testen
sprintf(formatted,"%02d:%02d",dataStunden,dataMinuten);
strcpy(uhrzeit,formatted);
}
else{
strcpy(uhrzeit,"Error!");
}
break;
case TEMPERATUR: dataFloat=(float)dataInteger/10.0;
if(TRUE){
//sprintf(formatted,"%5.1f °C (%d) ",dataFloat,dataInteger);
sprintf(formatted,"%5.1f °C",dataFloat);
strcpy(temperatur,formatted);
}
else{
strcpy(temperatur,"Error!\0");
}
break;
case SPEICHER2: if(TRUE){
sprintf(formatted,"%dh",dataInteger);
strcpy(stunden,formatted);
}
else{
strcpy(stunden,"Error!");
}
break;
case PROZENT: if(TRUE){
sprintf(formatted,"%3d%%",dataInteger);
strcpy(prozent,formatted);
}
else{
strcpy(prozent,"Error!");
}
break;
case STRAHLUNG: if(TRUE){
sprintf(formatted,"%d W/m² ",dataInteger);
strcpy(strahlung,formatted);
}
else{
strcpy(strahlung,"Error!\0");
}
break;
default: printf("Type Error (unknown)\n"); break;
}

return;
}

int main(int argc, char **argv)
{ int i; // Schleifenzaehler allgemein
unsigned int state=0, syncstate=0; // state 10,20,30 oder 31 entsprechend 0100, 0200, 0300, 0301
unsigned int dsIndex, dfIndex; // Zeiger auf Datensatz und Datenfeld
unsigned long zeitzaehler=0; // Ausgabe verlangsamen 500000 etwa 1 Minute

unsigned char buf[1];
unsigned char merker[6];
unsigned char datensatz[100];
unsigned char datenfeld[100];
unsigned char datenfelder[50][16];
bool printflag;

// MQTT Vorbereitung
MQTTClient client;
MQTTClient_connectOptions conn_opts = MQTTClient_connectOptions_initializer;
MQTTClient_message pubmsg = MQTTClient_message_initializer;
MQTTClient_deliveryToken token;
int mqttrc; //
char topic[255]; // zur Aufnahme Werte unterhalb des basetopic
char *basetopic = "Haus/Heizung/Solaranlage/SunGo/";

// MQTT Cleint Struktur anlegen
if ((mqttrc = MQTTClient_create(&client, ADDRESS, CLIENTID, MQTTCLIENT_PERSISTENCE_NONE, NULL)) != MQTTCLIENT_SUCCESS){
printf("Failed to create mqttclient, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}

// SerCOM Vorbereitung
struct termios oldtio,newtio;
int fd; // FileDescriptor SerCOM
int res; // SerCOM Einlesekontrolle

// wenn in Kommandozeile die Schnittstelle mitgegeben wird, dann nimm diese sonst versuche default
if (argc > 1)
fd = open(argv[1], O_RDWR | O_NOCTTY );
else
fd = open(MODEMDEVICE, O_RDWR | O_NOCTTY );
if (fd <0) {
perror(MODEMDEVICE);
exit(-1);
}

// sichere die aktuellen Einstellungen
tcgetattr(fd,&oldtio);

// baue die neuen Einstellungen zusammen
bzero(&newtio, sizeof(newtio));
newtio.c_cflag = BAUDRATE | CS8 | CLOCAL | CREAD;
newtio.c_iflag = IGNPAR | IXON | IXOFF;
newtio.c_oflag = 0;
newtio.c_lflag = 0;
newtio.c_cc[VTIME] = 0; /* inter-character timer unused */
newtio.c_cc[VMIN] = 1; /* blocking read until 1 chars received */

tcflush(fd, TCIFLUSH);
tcsetattr(fd,TCSANOW,&newtio);

setvbuf(stdout, (char *)NULL, _IONBF, 0);

// hier sind alle Vorbereitungen (SERCOM, MQTT) abgeschlossen jetzt koennen die Daten des Interfaces eingelesen, aufbereitet und per MQTT gesendet werden
// Die 4 verschiedenen denkbaren Pakete (DPA_1, DPA_2, DPB_1, DPB_2) beginnen alle mit AA 55 55 AA (DEZ: 170 85 85 170)
// wenn diese Folge erkannt wird bestimmen die beiden folgenden Bytes den Typ des Paketes
while (STOP==FALSE) { // Endlosschleife

res = read(fd,buf,1);

//sobald ein AA kommt beginne die Beobachtung
if ((buf[0]==170) && (syncstate==5)){
syncstate=0;
}
if ((buf[0]==170) && (syncstate==0)){ // wenn der syncstate 0 (gleich Anfang) und ein AA erkannt wird dann setze sysncstate=1
syncstate=1;
merker[0]=buf[0];
}
if ((buf[0]==85) && (syncstate==1)){ // wenn der syncstate 1 (AA bereits erkannt) und ein 55 erkannt wird dann setze sysncstate=2
syncstate=2;
merker[1]=buf[0];
}
if ((buf[0]==85) && (syncstate==2)){ // wenn der syncstate 2 (AA 55 bereits erkannt) und ein 55 erkannt wird dann setze sysncstate=3
syncstate=3;
merker[2]=buf[0];
}
if ((buf[0]==170) && (syncstate==3)){ // wenn der syncstate 3 (AA 55 55 bereits erkannt) und ein AA erkannt wird dann setze sysncstate=4
syncstate=4;
merker[3]=buf[0];
state=0;
}
// wenn AA 55 55 AA erkannt wurde steht syncstate auf 4 , in merker[0-3] befindet sich die Syncfolge und state ist 0
// wenn das nachfolgende Byte entweder 01 02 oder 03 ist ist alles wie erwartet und kann weitergehen syncstate = 5
if (((buf[0]==1)||(buf[0]==2)||(buf[0]==3)) && (merker[0]==170) && (merker[1]==85) && (merker[2]==85) && (merker[3]==170) && (syncstate==4)){
merker[4]=buf[0];
syncstate=5;
}
// ab hier werden die 4 Pakete unterschieden DPA_1 0200 (state 20), DPA_2 0100 (state 10), DPB_1 0301 (state 31) und DPB_2 0300 (state 30)

if ((buf[0]==0) && (merker[4]==1) && (merker[0]==170) && (merker[1]==85) && (merker[2]==85) && (merker[3]==170) && (syncstate==5)){
state=10; // state 10 bereit fuer 0100 Daten fuer das LC-Display
printflag=FALSE;
for(i=0;i<5;i++)merker[i]=0;

}
if ((buf[0]==0) && (merker[4]==2) && (merker[0]==170) && (merker[1]==85) && (merker[2]==85) && (merker[3]==170) && (syncstate==5)){
state=20; // state 20 bereit fuer 0200 hat keinen (?) Inhalt -> keine Auswertung
printflag=FALSE;
for(i=0;i<5;i++)merker[i]=0;

}
if ((buf[0]==0) && (merker[4]==3) && (merker[0]==170) && (merker[1]==85) && (merker[2]==85) && (merker[3]==170) && (syncstate==5)){
state=30; // state 30 bereit fuer 0300 Datensatze
printflag=FALSE;
for(i=0;i<5;i++)merker[i]=0;
dsIndex=0;

}
if ((buf[0]==1) && (merker[4]==3) && (merker[0]==170) && (merker[1]==85) && (merker[2]==85) && (merker[3]==170) && (syncstate==5)){
state=31; // state 31 bereit fuer 0301 Datenfaelder
printflag=FALSE;
for(i=0;i<5;i++)merker[i]=0;
dfIndex=0;

}

// state 10 und 20 werden nicht ausgewertet
if ((state==10) && printflag) {

}
else if ((state==20) && printflag) {

}
else if ((state==30) && printflag){

if(dsIndex<100)datensatz[dsIndex++]=buf[0];
}
else if ((state==31) && printflag) {

if(dfIndex<100)datenfeld[dfIndex++]=buf[0];
}
else{
//printf("syncstate: %d, state: %d, %X\n\r",syncstate,state,buf[0]);
}

printflag=TRUE;

if (zeitzaehler==10000){
// es wird etwa 3 mal pro Minute eine Auswahl der Datensaetze ausgegeben
// Datum: 18.09.2021
// Message published, return code 0
// Uhrzeit: 12:17
// Message published, return code 0
// Kollektor: 58.6 °C
// Message published, return code 0
// Speicher unten: 49.2 °C
// Message published, return code 0
// Speicher oben: 52.1 °C
// Message published, return code 0
// Rücklaufanhebung T7: 52.0 °C
// Message published, return code 0
// Rücklaufanhebung T8: 28.1 °C
// Message published, return code 0
// Ausgang 1: 60%
// Message published, return code 0
// Ausgang 6: 100%
// Message published, return code 0
// Speicher 2: 15632h
// Message published, return code 0

conn_opts.keepAliveInterval = 20;
conn_opts.cleansession = 1;
// Baue MQTT Verbindung auf
if ((mqttrc = MQTTClient_connect(client, &conn_opts)) != MQTTCLIENT_SUCCESS){
printf("Failed to connect, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}
//Datum
formatieren(DATUM,datensatz[2],datensatz[3]);
printf("Datum: %s\n",datum);
strcpy(topic,basetopic);
strcat(topic,"Datum");
pubmsg.payload = datum;
pubmsg.payloadlen = (int)strlen(datum);
pubmsg.qos = QOS;
pubmsg.retained = 0;
if ((mqttrc = MQTTClient_publishMessage(client, topic, &pubmsg, &token)) != MQTTCLIENT_SUCCESS){
printf("Failed to publish message, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}else{
printf("Message published, return code %d\n", mqttrc);
}
//Uhrzeit
formatieren(UHRZEIT,datensatz[4],datensatz[5]);
printf("Uhrzeit: %s\n",uhrzeit);
strcpy(topic,basetopic);
strcat(topic,"Uhrzeit");
pubmsg.payload = uhrzeit;
pubmsg.payloadlen = (int)strlen(uhrzeit);
pubmsg.qos = QOS;
pubmsg.retained = 0;
if ((mqttrc = MQTTClient_publishMessage(client, topic, &pubmsg, &token)) != MQTTCLIENT_SUCCESS){
printf("Failed to publish message, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}else{
printf("Message published, return code %d\n", mqttrc);
}
//Kollektor
formatieren(TEMPERATUR,datensatz[6],datensatz[7]);
printf("Kollektor: %s\n",temperatur);
strcpy(topic,basetopic);
strcat(topic,"Kollektor/Temperatur");
pubmsg.payload = temperatur;
pubmsg.payloadlen = (int)strlen(temperatur);
pubmsg.qos = QOS;
pubmsg.retained = 0;
if ((mqttrc = MQTTClient_publishMessage(client, topic, &pubmsg, &token)) != MQTTCLIENT_SUCCESS){
printf("Failed to publish message, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}else{
printf("Message published, return code %d\n", mqttrc);
}
//Speicher unten
formatieren(TEMPERATUR,datensatz[8],datensatz[9]);
printf("Speicher unten: %s\n",temperatur);
strcpy(topic,basetopic);
strcat(topic,"Speicher/unten/Temperatur");
pubmsg.payload = temperatur;
pubmsg.payloadlen = (int)strlen(temperatur);
pubmsg.qos = QOS;
pubmsg.retained = 0;
if ((mqttrc = MQTTClient_publishMessage(client, topic, &pubmsg, &token)) != MQTTCLIENT_SUCCESS){
printf("Failed to publish message, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}else{
printf("Message published, return code %d\n", mqttrc);
}
//Speicher oben
formatieren(TEMPERATUR,datensatz[10],datensatz[11]);
printf("Speicher oben: %s\n",temperatur);
strcpy(topic,basetopic);
strcat(topic,"Speicher/oben/Temperatur");
pubmsg.payload = temperatur;
pubmsg.payloadlen = (int)strlen(temperatur);
pubmsg.qos = QOS;
pubmsg.retained = 0;
if ((mqttrc = MQTTClient_publishMessage(client, topic, &pubmsg, &token)) != MQTTCLIENT_SUCCESS){
printf("Failed to publish message, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}else{
printf("Message published, return code %d\n", mqttrc);
}
//Rücklaufanhebung T7
formatieren(TEMPERATUR,datensatz[18],datensatz[19]);
printf("Rücklaufanhebung T7: %s\n",temperatur);
strcpy(topic,basetopic);
strcat(topic,"Rücklaufanhebung/T7/Temperatur");
pubmsg.payload = temperatur;
pubmsg.payloadlen = (int)strlen(temperatur);
pubmsg.qos = QOS;
pubmsg.retained = 0;
if ((mqttrc = MQTTClient_publishMessage(client, topic, &pubmsg, &token)) != MQTTCLIENT_SUCCESS){
printf("Failed to publish message, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}else{
printf("Message published, return code %d\n", mqttrc);
}
//Rücklaufanhebung T8
formatieren(TEMPERATUR,datensatz[20],datensatz[21]);
printf("Rücklaufanhebung T8: %s\n",temperatur);
strcpy(topic,basetopic);
strcat(topic,"Rücklaufanhebung/T8/Temperatur");
pubmsg.payload = temperatur;
pubmsg.payloadlen = (int)strlen(temperatur);
pubmsg.qos = QOS;
pubmsg.retained = 0;
if ((mqttrc = MQTTClient_publishMessage(client, topic, &pubmsg, &token)) != MQTTCLIENT_SUCCESS){
printf("Failed to publish message, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}else{
printf("Message published, return code %d\n", mqttrc);
}
//Ausgang 1
formatieren(PROZENT,datensatz[32],0);
printf("Ausgang 1: %s\n",prozent);
strcpy(topic,basetopic);
strcat(topic,"Ausgang/1/Prozent");
pubmsg.payload = prozent;
pubmsg.payloadlen = (int)strlen(prozent);
pubmsg.qos = QOS;
pubmsg.retained = 0;
if ((mqttrc = MQTTClient_publishMessage(client, topic, &pubmsg, &token)) != MQTTCLIENT_SUCCESS){
printf("Failed to publish message, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}else{
printf("Message published, return code %d\n", mqttrc);
}
//Ausgang 6
formatieren(PROZENT,datensatz[37],0);
printf("Ausgang 6: %s\n",prozent);
strcpy(topic,basetopic);
strcat(topic,"Ausgang/6/Prozent");
pubmsg.payload = prozent;
pubmsg.payloadlen = (int)strlen(prozent);
pubmsg.qos = QOS;
pubmsg.retained = 0;
if ((mqttrc = MQTTClient_publishMessage(client, topic, &pubmsg, &token)) != MQTTCLIENT_SUCCESS){
printf("Failed to publish message, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}else{
printf("Message published, return code %d\n", mqttrc);
}
// Speicherstunden
formatieren(SPEICHER2,datensatz[50],datensatz[51]);
printf("Speicher 2: %s\n",stunden);
strcpy(topic,basetopic);
strcat(topic,"Speicher/Stunden");
pubmsg.payload = stunden;
pubmsg.payloadlen = (int)strlen(stunden);
pubmsg.qos = QOS;
pubmsg.retained = 0;
if ((mqttrc = MQTTClient_publishMessage(client, topic, &pubmsg, &token)) != MQTTCLIENT_SUCCESS){
printf("Failed to publish message, return code %d\n", mqttrc);
exit(EXIT_FAILURE);
}else{
printf("Message published, return code %d\n", mqttrc);
}
/* printf("Waiting for up to %d seconds for publication of %s\n"
"on topic %s for client with ClientID: %s\n",
(int)(TIMEOUT/1000), PAYLOAD, TOPIC, CLIENTID);
rc = MQTTClient_waitForCompletion(client, token, TIMEOUT);
printf("Message with delivery token %d delivered\n", token);
*/
if ((mqttrc = MQTTClient_disconnect(client, 10000)) != MQTTCLIENT_SUCCESS){
printf("Failed to disconnect, return code %d\n", mqttrc);
}
zeitzaehler=0;
}
zeitzaehler++;
if (zeitzaehler%100000==0)printf("%d\n",zeitzaehler); // Lebenszeichen

}

close(fd); // schliesze serielle Schnittstelle

tcsetattr(fd,TCSANOW,&oldtio); // stelle die alte ComConfig wieder her

MQTTClient_destroy(&client); // beende die MQTT Kommunikation

return EXIT_SUCCESS;
}
</syntaxhighlight>
</div></div>

==Sungoauswertungcurses==
Dieses Programm dient erst mal nur dem Einlesen und Interpretieren der Daten vom Interface. Sie werden nach der Aufbereitung geordnet und auf der Console mittels curses ausgegeben. In diesem Programm sind noch die alten Varianten der Konvertierungsfunktionen vorhanden.
Dies ist zwar nicht elegant, aber es funktioniert.
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Sungoauswertungcurses.c</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="c" line>
#include <string.h>
#include <stdlib.h>
#include <stdio.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <termios.h> // termios is the API that is in general recommended for serial I/O in Unix.
#include <curses.h>

#define BAUDRATE B115200
#define MODEMDEVICE "/dev/ttyS1"
#define _POSIX_SOURCE 1 /* POSIX compliant source */
#define FALSE 0
#define TRUE 1

volatile int STOP=FALSE;

char datum[11];
char uhrzeit[7];
char temperatur[25];
char prozent[7];
char fehler[17];
char stunden[8];
char dummy[7];

unsigned int hextodec(char hex[10]){
unsigned int decimal=0;
unsigned int length=0;
unsigned int base = 1;
int i=0;

while(hex[i]!='\0'){
i++;
}
length=i;

//printf("hextodec %s\n\r",hex);
//printf("length %d\n\r",length);

for(i = length-1; i >= 0; i--){
//printf("i: %d\n\r",i);
if (i<0)i=0;
if(hex[i] >= '0' && hex[i] <= '9'){
decimal += ((unsigned char)hex[i] - 48) * base;
base *= 16;
}
else if(hex[i] >= 'A' && hex[i] <= 'F'){
decimal += ((unsigned char)hex[i] - 55) * base;
base *= 16;
}
else if(hex[i] >= 'a' && hex[i] <= 'f'){
decimal += ((unsigned char)hex[i] - 87) * base;
base *= 16;
}
}
//printf("decimal %d\n\r",decimal);
return decimal;
}

void datumformatieren(unsigned char lowbyte,unsigned char highbyte){
char data[10]="";
char tmp[3]="";
char datumStr_formatted[]="00.00.2021";
char datumStr[5]="";
unsigned int datumInt;
size_t l;

sprintf(tmp,"%X",highbyte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

sprintf(tmp,"%X",lowbyte);
strcat(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

//strcpy(data,"0135");
//printf("data: %s\n\r",data);
datumInt=hextodec(data);
//printf("int: %d\n\r",datumInt);
sprintf(datumStr,"%d",datumInt);
if(strlen(datumStr)==3){
datumStr_formatted[0]=datumStr[1];
datumStr_formatted[1]=datumStr[2];
datumStr_formatted[4]=datumStr[0];
strcpy(datum,datumStr_formatted);
}
else if(strlen(datumStr)==4){
datumStr_formatted[0]=datumStr[2];
datumStr_formatted[1]=datumStr[3];
datumStr_formatted[3]=datumStr[0];
datumStr_formatted[4]=datumStr[1];
strcpy(datum,datumStr_formatted);
}
else{
strcpy(datum,"Error!");
}
return;
}

void uhrzeitformatieren(unsigned char lowbyte,unsigned char highbyte){
char data[10]="";
char tmp[3]="";
char uhrzeitStr_formatted[]="00:00";
unsigned int uhrzeitInt, stunden, minuten;
size_t l;

sprintf(tmp,"%02X",highbyte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

sprintf(tmp,"%02X",lowbyte);
strcat(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

//strcpy(data,"1500");
//printf("data: %s\n\r",data);
uhrzeitInt=hextodec(data);
//printf("int: %d\n\r",uhrzeitInt);
stunden=(unsigned int)uhrzeitInt/60;
minuten=uhrzeitInt-(stunden*60);
if(TRUE){ // hier koennte man die gueltig der stunden und minuten noch testen
sprintf(uhrzeitStr_formatted,"%02d:%02d",stunden,minuten);
strcpy(uhrzeit,uhrzeitStr_formatted);
}
else{
strcpy(uhrzeit,"Error!");
}
return;
}

void temperaturformatieren(unsigned char lowbyte,unsigned char highbyte){
char data[10]="";
char tmp[3]="";
char temperaturStr_formatted[20]="";
unsigned int temperaturInt;
float temperaturFloat;
size_t l;

memset(data,'\0',sizeof(data));
memset(tmp,'\0',sizeof(tmp));

sprintf(tmp,"%02X",highbyte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

sprintf(tmp,"%02X",lowbyte);
strcat(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

//strcpy(data,"0500");
//printf("data: %s\n\r",data);
temperaturInt=hextodec(data);
//printf("int: %d\n\r",temperaturInt);
temperaturFloat=(float)temperaturInt/10.0;

if(TRUE){
memset(temperaturStr_formatted,'\0',sizeof(temperaturStr_formatted));
sprintf(temperaturStr_formatted,"%5.1f °C (%d) ",temperaturFloat,temperaturInt);
strcpy(temperatur,temperaturStr_formatted);
}
else{
strcpy(temperatur,"Error!\0");
}
return;
}

void prozentformatieren(unsigned char byte){
char data[10]="";
char tmp[3]="";
char prozentStr_formatted[]="000%";
unsigned int prozentInt;
size_t l;

sprintf(tmp,"%X",byte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

//strcpy(data,"1500");
//printf("data: %s\n\r",data);
prozentInt=hextodec(data);
//printf("int: %d\n\r",prozentInt);

if(TRUE){
sprintf(prozentStr_formatted,"%3d%%",prozentInt);
strcpy(prozent,prozentStr_formatted);
}
else{
strcpy(prozent,"Error!");
}
return;
}

void stundenformatieren(unsigned char lowbyte,unsigned char highbyte){
char data[10]="";
char tmp[3]="";
char stundenStr_formatted[]="000000h";
unsigned int stundenInt;

sprintf(tmp,"%X",highbyte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

sprintf(tmp,"%X",lowbyte);
strcat(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

//strcpy(data,"1500");
//printf("data: %s\n\r",data);
stundenInt=hextodec(data);
//printf("int: %d\n\r",temperaturInt);

if(TRUE){
sprintf(stundenStr_formatted,"%dh",stundenInt);
strcpy(stunden,stundenStr_formatted);
}
else{
strcpy(stunden,"Error!");
}
return;
}

void fehlerformatieren(unsigned char byte1,unsigned char byte2,unsigned char byte3,unsigned char byte4,unsigned char byte5,unsigned char byte6,unsigned char byte7,unsigned char byte8){
char data[10]="";
char tmp[3]="";
char fehlerStr_formatted[9];
unsigned int fehlerInt;

fehlerInt=12345;

if(TRUE){
sprintf(fehlerStr_formatted,"%d",fehlerInt);
strcpy(fehler,fehlerStr_formatted);
}
else{
strcpy(fehler,"Error!");
}
return;
}

void dummyformatieren(unsigned char lowbyte,unsigned char highbyte){
char data[10]="";
char tmp[3]="";

sprintf(tmp,"%X",highbyte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

sprintf(tmp,"%X",lowbyte);
strcat(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

if(TRUE){
strcpy(dummy,data);
}
else{
strcpy(dummy,"Error!");
}
return;
}

int main(int argc, char **argv)
{

struct termios oldtio,newtio;

int fd;
int c;
int res;
int i,k,l;
unsigned int x,y,z,t1,t2,t3,dsIndex, dfIndex, dfX, dfY, sort1,sort2, stelle, zeilenproblock;
unsigned int state=0, syncstate=0;

unsigned char buf[1];
unsigned char merker[6];
unsigned char datensatz[200];
unsigned char datenfeld[100];
unsigned char datenfelder[50][16];
char data[10]="";
char tmp[3]="";
bool printflag;

memset(temperatur, '\0', sizeof(temperatur));

// wenn in Kommandozeile die Schnittstelle mitgegeben wird, dann nim diese sonst veruche default
if (argc > 1)
fd = open(argv[1], O_RDWR | O_NOCTTY );
else
fd = open(MODEMDEVICE, O_RDWR | O_NOCTTY );
if (fd <0) {
perror(MODEMDEVICE);
exit(-1);
}

// sichere die aktuellen Einstellungen
tcgetattr(fd,&oldtio);

// baue die neuen Einstellungen zusammen
bzero(&newtio, sizeof(newtio));
newtio.c_cflag = BAUDRATE | CS8 | CLOCAL | CREAD;
newtio.c_iflag = IGNPAR | IXON | IXOFF;
newtio.c_oflag = 0;
newtio.c_lflag = 0;
newtio.c_cc[VTIME] = 0; /* inter-character timer unused */
newtio.c_cc[VMIN] = 5; /* blocking read until 5 chars received */

tcflush(fd, TCIFLUSH);
tcsetattr(fd,TCSANOW,&newtio);

setvbuf(stdout, (char *)NULL, _IONBF, 0);

initscr();
getmaxyx(stdscr,x,y);
printf("X:%d/Y:%d\n",x,y);
while (STOP==FALSE) { /* loop for input */
res = read(fd,buf,1); /* returns after 5 chars have been input */
//printf("A: syncstate: %d, state: %d, %X\n\r",syncstate,state,buf[0]);

//sobald ein AA kommt beginne die Beobachtung
if ((buf[0]==170) && (syncstate==5)){
syncstate=0;
}
if ((buf[0]==170) && (syncstate==0)){
syncstate=1;
merker[0]=buf[0];
}
if ((buf[0]==85) && (syncstate==1)){
syncstate=2;
merker[1]=buf[0];
}
if ((buf[0]==85) && (syncstate==2)){
syncstate=3;
merker[2]=buf[0];
}
if ((buf[0]==170) && (syncstate==3)){
syncstate=4;
merker[3]=buf[0];
state=0;
}
if (((buf[0]==1)||(buf[0]==2)||(buf[0]==3)) && (merker[0]==170) && (merker[1]==85) && (merker[2]==85) && (merker[3]==170) && (syncstate==4)){
merker[4]=buf[0];
syncstate=5;
}

if ((buf[0]==0) && (merker[4]==1) && (merker[0]==170) && (merker[1]==85) && (merker[2]==85) && (merker[3]==170) && (syncstate==5)){
state=10; // state 10 bereit fuer 0100
printflag=FALSE;
for(i=0;i<5;i++)merker[i]=0;
x=1;
y=8;
stelle=0;
}
if ((buf[0]==0) && (merker[4]==2) && (merker[0]==170) && (merker[1]==85) && (merker[2]==85) && (merker[3]==170) && (syncstate==5)){
state=20; // state 10 bereit fuer 0100
printflag=FALSE;
for(i=0;i<5;i++)merker[i]=0;
x=2;
y=8;
stelle=0;
}
if ((buf[0]==0) && (merker[4]==3) && (merker[0]==170) && (merker[1]==85) && (merker[2]==85) && (merker[3]==170) && (syncstate==5)){
state=30; // state 10 bereit fuer 0100
printflag=FALSE;
for(i=0;i<5;i++)merker[i]=0;
dsIndex=0;
x=3;
y=8;
stelle=0;
}
if ((buf[0]==1) && (merker[4]==3) && (merker[0]==170) && (merker[1]==85) && (merker[2]==85) && (merker[3]==170) && (syncstate==5)){
state=31; // state 10 bereit fuer 0100
printflag=FALSE;
for(i=0;i<5;i++)merker[i]=0;
dfIndex=0;
x=4;
y=8;
stelle=0;
}

zeilenproblock=3;

if ((state==10) && printflag) {
z=(x-1)*zeilenproblock+x;
mvprintw(z,1,"0100:");
mvaddch(z,y,buf[0]);
mvprintw(z+1,y,"%02X ",buf[0]);
mvprintw(z+2,y,"%d ",stelle);
y+=3;
stelle++;
}
else if ((state==20) && printflag) {
z=(x-1)*zeilenproblock+x;
mvprintw(z,1,"0200:");
mvaddch(z,y,buf[0]);
mvprintw(z+1,y,"%02X ",buf[0]);
mvprintw(z+2,y,"%d ",stelle);
y+=3;
stelle++;
}
else if ((state==30) && printflag){
z=(x-1)*zeilenproblock+x;
mvprintw(z,1,"0300:");
mvaddch(z,y,buf[0]);
mvprintw(z+1,y,"%02X ",buf[0]);
mvprintw(z+2,y,"%d ",stelle);
y+=3;
stelle++;
if(dsIndex<100)datensatz[dsIndex++]=buf[0];
}
else if ((state==31) && printflag) {
z=(x-1)*zeilenproblock+x;
mvprintw(z,1,"0301:");
mvaddch(z,y,buf[0]);
mvprintw(z+1,y,"%02X ",buf[0]);
mvprintw(z+2,y,"%d ",stelle);
y+=3;
stelle++;
if(dfIndex<100)datenfeld[dfIndex++]=buf[0];
}
else{
//printf("syncstate: %d, state: %d, %X\n\r",syncstate,state,buf[0]);
}
//mvprintw(5,1,"Test");
printflag=TRUE;
refresh();
//printf("E: syncstate: %d, state: %d, %X\n\r",syncstate,state,buf[0]);
//if (buf[0]=='z') STOP=TRUE;
//x max = 4
z=20;
t1=35;
t2=t1+30;
sort1=0;
mvprintw(z+sort1,1,"Datum: (2,3)");
datumformatieren(datensatz[2],datensatz[3]);
//printf("datum: %s",datum);
mvprintw(z+sort1,t1,datum);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[2],datensatz[3]);
sort1++;
mvprintw(z+sort1,1,"Uhrzeit: (4,5)");
uhrzeitformatieren(datensatz[4],datensatz[5]);
//printf("uhrzeit: %s",uhrzeit);
mvprintw(z+sort1,t1,uhrzeit);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[4],datensatz[5]);
sort1++;
mvprintw(z+sort1,1,"Kollektor: (6,7)");
temperaturformatieren(datensatz[6],datensatz[7]);
//printf("temperatur: %s",temperatur);
mvprintw(z+sort1,t1,"%s",temperatur);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[6],datensatz[7]);
sort1++;
mvprintw(z+sort1,1,"Speicher unten: (8,9)");
temperaturformatieren(datensatz[8],datensatz[9]);
//printf("temperatur: %s",temperatur);
mvprintw(z+sort1,t1,"%s",temperatur);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[8],datensatz[9]);
sort1++;
mvprintw(z+sort1,1,"Speicher oben: (10,11)");
temperaturformatieren(datensatz[10],datensatz[11]);
//printf("temperatur: %s",temperatur);
mvprintw(z+sort1,t1,"%s",temperatur);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[10],datensatz[11]);
sort1++;
mvprintw(z+sort1,1,"Thermostat: (12,13)");
temperaturformatieren(datensatz[12],datensatz[13]);
//printf("temperatur: %s",temperatur);
mvprintw(z+sort1,t1,"%s",temperatur);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[12],datensatz[13]);
sort1++;
mvprintw(z+sort1,1,"Poolschutz: (14,15)");
temperaturformatieren(datensatz[14],datensatz[15]);
//printf("temperatur: %s",temperatur);
mvprintw(z+sort1,t1,"%s",temperatur);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[14],datensatz[15]);
sort1++;
mvprintw(z+sort1,1,"Ertrag: (16,17)");
temperaturformatieren(datensatz[16],datensatz[17]);
//printf("temperatur: %s",temperatur);
mvprintw(z+sort1,t1,"%s",temperatur);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[16],datensatz[17]);
sort1++;
mvprintw(z+sort1,1,"Ruecklaufanhebung T7: (18,19)");
temperaturformatieren(datensatz[18],datensatz[19]);
//printf("temperatur: %s",temperatur);
mvprintw(z+sort1,t1,"%s",temperatur);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[18],datensatz[19]);
sort1++;
mvprintw(z+sort1,1,"Ruecklaufanhebung T8: (20,21)");
temperaturformatieren(datensatz[20],datensatz[21]);
//printf("temperatur: %s",temperatur);
mvprintw(z+sort1,t1,"%s",temperatur);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[20],datensatz[21]);
sort1++;
mvprintw(z+sort1,1,"T: (22,23)");
temperaturformatieren(datensatz[22],datensatz[23]);
//printf("temperatur: %s",temperatur);
mvprintw(z+sort1,t1,"%s",temperatur);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[22],datensatz[23]);
sort1++;
mvprintw(z+sort1,1,"Dummy: (24,25)");
dummyformatieren(datensatz[24],datensatz[25]);
//printf("dummy: %s",dummy);
mvprintw(z+sort1,t1,dummy);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[24],datensatz[25]);
sort1++;
mvprintw(z+sort1,1,"Strahlung: (26,27)");
temperaturformatieren(datensatz[26],datensatz[27]);
//printf("temperatur: %s",temperatur);
mvprintw(z+sort1,t1,temperatur);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[26],datensatz[27]);
sort1++;
mvprintw(z+sort1,1,"Dummy: (28,29)");
dummyformatieren(datensatz[28],datensatz[29]);
//printf("dummy: %s",dummy);
mvprintw(z+sort1,t1,dummy);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[28],datensatz[29]);
sort1++;
mvprintw(z+sort1,1,"Dummy: (30,31)");
temperaturformatieren(datensatz[30],datensatz[31]);
//printf("dummy: %s",dummy);
mvprintw(z+sort1,t1,dummy);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[30],datensatz[31]);
sort1++;
mvprintw(z+sort1,1,"Ausgang 1: (32)");
prozentformatieren(datensatz[32]);
//printf("prozent: %s",prozent);
mvprintw(z+sort1,t1,prozent);
mvprintw(z+sort1,t2,"%02X",datensatz[32]);
sort1++;
mvprintw(z+sort1,1,"Ausgang 2: (33)");
prozentformatieren(datensatz[33]);
//printf("prozent: %s",prozent);
mvprintw(z+sort1,t1,prozent);
mvprintw(z+sort1,t2,"%02X",datensatz[33]);
sort1++;
mvprintw(z+sort1,1,"Ausgang 3: (34)");
prozentformatieren(datensatz[34]);
//printf("prozent: %s",prozent);
mvprintw(z+sort1,t1,prozent);
mvprintw(z+sort1,t2,"%02X",datensatz[34]);
sort1++;
mvprintw(z+sort1,1,"Ausgang 4: (35)");
prozentformatieren(datensatz[35]);
//printf("prozent: %s",prozent);
mvprintw(z+sort1,t1,prozent);
mvprintw(z+sort1,t2,"%02X",datensatz[35]);
sort1++;
mvprintw(z+sort1,1,"Ausgang 5: (36)");
prozentformatieren(datensatz[36]);
//printf("prozent: %s",prozent);
mvprintw(z+sort1,t1,prozent);
mvprintw(z+sort1,t2,"%02X",datensatz[36]);
sort1++;
mvprintw(z+sort1,1,"Ausgang 6: (37)");
prozentformatieren(datensatz[37]);
//printf("prozent: %s",prozent);
mvprintw(z+sort1,t1,prozent);
mvprintw(z+sort1,t2,"%02X",datensatz[37]);
sort1++;
mvprintw(z+sort1,1,"Fehler: (38-45)");
fehlerformatieren(datensatz[38],datensatz[39],datensatz[40],datensatz[41],datensatz[42],datensatz[43],datensatz[44],datensatz[45]);
//printf("fehler: %s",fehler);
mvprintw(z+sort1,t1,fehler);
mvprintw(z+sort1,t2,"%02X %02X %02X %02X %02X %02X %02X %02X",datensatz[38],datensatz[39],datensatz[40],datensatz[41],datensatz[42],datensatz[43],datensatz[44],datensatz[45]);
sort1++;
mvprintw(z+sort1,1,"Speicher 1: (46,47)");
temperaturformatieren(datensatz[46],datensatz[47]);
//printf("temperatur: %s",temperatur);
mvprintw(z+sort1,t1,temperatur);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[46],datensatz[47]);
sort1++;
mvprintw(z+sort1,1,"Dummy: (48,49)");
dummyformatieren(datensatz[48],datensatz[49]);
//printf("dummy: %s",dummy);
mvprintw(z+sort1,t1,dummy);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[48],datensatz[49]);
sort1++;
mvprintw(z+sort1,1,"Speicher 2: (50,51)");
stundenformatieren(datensatz[50],datensatz[51]);
//printf("stunden: %s",stunden);
mvprintw(z+sort1,t1,stunden);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[50],datensatz[51]);
sort1++;
mvprintw(z+sort1,1,"Dummy: (52,53)");
dummyformatieren(datensatz[52],datensatz[53]);
//printf("dummy: %s",dummy);
mvprintw(z+sort1,t1,dummy);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[52],datensatz[53]);
sort1++;
mvprintw(z+sort1,1,"Dummy: (54,55)");
dummyformatieren(datensatz[54],datensatz[55]);
//printf("dummy: %s",dummy);
mvprintw(z+sort1,t1,dummy);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[54],datensatz[55]);
sort1++;
mvprintw(z+sort1,1,"Funktion 1 aktiv: (56,57)");
dummyformatieren(datensatz[56],datensatz[57]);
//printf("dummy: %s",dummy);
mvprintw(z+sort1,t1,dummy);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[56],datensatz[57]);
sort1++;
mvprintw(z+sort1,1,"Funktion 2 aktiv: (58,59)");
dummyformatieren(datensatz[58],datensatz[59]);
//printf("dummy: %s",dummy);
mvprintw(z+sort1,t1,dummy);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[58],datensatz[59]);
sort1++;
mvprintw(z+sort1,1,"Volumenstrom: (60,61)");
dummyformatieren(datensatz[60],datensatz[61]);
//printf("dummy: %s",dummy);
mvprintw(z+sort1,t1,dummy);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[60],datensatz[61]);
sort1++;
mvprintw(z+sort1,1,"Dummy: (62,63)");
dummyformatieren(datensatz[62],datensatz[63]);
//printf("dummy: %s",dummy);
mvprintw(z+sort1,t1,dummy);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[62],datensatz[63]);
sort1++;
mvprintw(z+sort1,1,"Dummy: (64,65)");
dummyformatieren(datensatz[64],datensatz[65]);
//printf("dummy: %s",dummy);
mvprintw(z+sort1,t1,dummy);
mvprintw(z+sort1,t2,"%02X %02X",datensatz[64],datensatz[65]);

t3=t2+20;
sort2=0;

i=0;
mvprintw(z+sort2,t3,"%02X ",datenfeld[i++]);
mvprintw(z+sort2,t3+3,"%02X ",datenfeld[i++]);
mvprintw(z+sort2,t3+6,"%02X ",datenfeld[i++]);
for(k=0;k<32;k++){
sprintf(tmp,"%X",datenfeld[i+(k*16)]);
strcpy(data,tmp);
sort2=hextodec(data)*2;
if (sort2>62) sort2=64;
for(l=0;l<16;l++){
mvprintw(z+sort2,t3+(l*3),"%02X ",datenfeld[i+(k*16)+l]);
if (datenfeld[i+(k*16)+l]!=0){ mvprintw(z+sort2+1,t3+(l*3),"%c ",datenfeld[i+(k*16)+l]); }
else { mvprintw(z+sort2+1,t3+(l*3)," "); }
}
}

}
endwin();

close(fd);

tcsetattr(fd,TCSANOW,&oldtio);

return EXIT_SUCCESS;
}

</syntaxhighlight>
</div></div>

==Sungoserialcapture==
Diese Programm liest die Interfacedaten und schreibt die Daten ohne Auswertung zur weiteren Bearbeitung in ein Datei.
Auch in diesem Programm sind noch die alten Varianten der Konvertierungsfunktionen vorhanden.
Dies ist zwar nicht elegant, aber es funktioniert.
<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Sungoserialcapture.c</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="c" line>
#include <string.h>
#include <stdlib.h>
#include <stdio.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <termios.h> // termios is the API that is in general recommended for serial I/O in Unix.
#include <curses.h>

#define BAUDRATE B115200
#define MODEMDEVICE "/dev/ttyS1"
#define _POSIX_SOURCE 1 /* POSIX compliant source */
#define FALSE 0
#define TRUE 1

volatile int STOP=FALSE;

char datum[11];
char uhrzeit[7];
char temperatur[8];
char prozent[7];
char fehler[17];
char stunden[8];
char dummy[7];

unsigned int hextodec(char hex[10]){
unsigned int decimal=0;
unsigned int length=0;
unsigned int base = 1;
int i=0;

while(hex[i]!='\0'){
i++;
}
length=i;

//printf("hextodec %s\n\r",hex);
//printf("length %d\n\r",length);

for(i = length-1; i >= 0; i--){
//printf("i: %d\n\r",i);
if (i<0)i=0;
if(hex[i] >= '0' && hex[i] <= '9'){
decimal += ((unsigned char)hex[i] - 48) * base;
base *= 16;
}
else if(hex[i] >= 'A' && hex[i] <= 'F'){
decimal += ((unsigned char)hex[i] - 55) * base;
base *= 16;
}
else if(hex[i] >= 'a' && hex[i] <= 'f'){
decimal += ((unsigned char)hex[i] - 87) * base;
base *= 16;
}
}
//printf("decimal %d\n\r",decimal);
return decimal;
}

void datumformatieren(unsigned char lowbyte,unsigned char highbyte){
char data[10]="";
char tmp[3]="";
char datumStr_formatted[]="00.00.2021";
char datumStr[5]="";
unsigned int datumInt;
size_t l;

sprintf(tmp,"%X",highbyte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

sprintf(tmp,"%X",lowbyte);
strcat(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

//strcpy(data,"0135");
//printf("data: %s\n\r",data);
datumInt=hextodec(data);
//printf("int: %d\n\r",datumInt);
sprintf(datumStr,"%d",datumInt);
if(strlen(datumStr)==3){
datumStr_formatted[0]=datumStr[1];
datumStr_formatted[1]=datumStr[2];
datumStr_formatted[4]=datumStr[0];
strcpy(datum,datumStr_formatted);
}
else if(strlen(datumStr)==4){
datumStr_formatted[0]=datumStr[2];
datumStr_formatted[1]=datumStr[3];
datumStr_formatted[3]=datumStr[0];
datumStr_formatted[4]=datumStr[1];
strcpy(datum,datumStr_formatted);
}
else{
strcpy(datum,"Error!");
}
return;
}

void uhrzeitformatieren(unsigned char lowbyte,unsigned char highbyte){
char data[10]="";
char tmp[3]="";
char uhrzeitStr_formatted[]="00:00";
unsigned int uhrzeitInt, stunden, minuten;
size_t l;

sprintf(tmp,"%X",highbyte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

sprintf(tmp,"%X",lowbyte);
strcat(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

//strcpy(data,"1500");
//printf("data: %s\n\r",data);
uhrzeitInt=hextodec(data);
//printf("int: %d\n\r",uhrzeitInt);
stunden=(unsigned int)uhrzeitInt/60;
minuten=uhrzeitInt-(stunden*60);
if(TRUE){ // hier koennte man die gueltig der stunden und minuten noch testen
sprintf(uhrzeitStr_formatted,"%d:%d",stunden,minuten);
strcpy(uhrzeit,uhrzeitStr_formatted);
}
else{
strcpy(uhrzeit,"Error!");
}
return;
}

void temperaturformatieren(unsigned char lowbyte,unsigned char highbyte){
char data[10]="";
char tmp[3]="";
char temperaturStr_formatted[]="000.0°C";
unsigned int temperaturInt;
float temperaturFloat;
size_t l;

sprintf(tmp,"%X",highbyte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

sprintf(tmp,"%X",lowbyte);
strcat(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

//strcpy(data,"1500");
//printf("data: %s\n\r",data);
temperaturInt=hextodec(data);
//printf("int: %d\n\r",temperaturInt);
temperaturFloat=(float)temperaturInt/10.0;

if(TRUE){
sprintf(temperaturStr_formatted,"%.1f°C",temperaturFloat);
strcpy(temperatur,temperaturStr_formatted);
}
else{
strcpy(temperatur,"Error!");
}
return;
}

void prozentformatieren(unsigned char byte){
char data[10]="";
char tmp[3]="";
char prozentStr_formatted[]="000%";
unsigned int prozentInt;
size_t l;

sprintf(tmp,"%X",byte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

//strcpy(data,"1500");
//printf("data: %s\n\r",data);
prozentInt=hextodec(data);
//printf("int: %d\n\r",prozentInt);

if(TRUE){
sprintf(prozentStr_formatted,"%d%%",prozentInt);
strcpy(prozent,prozentStr_formatted);
}
else{
strcpy(prozent,"Error!");
}
return;
}

void stundenformatieren(unsigned char lowbyte,unsigned char highbyte){
char data[10]="";
char tmp[3]="";
char stundenStr_formatted[]="000000h";
unsigned int stundenInt;

sprintf(tmp,"%X",highbyte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

sprintf(tmp,"%X",lowbyte);
strcat(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

//strcpy(data,"1500");
//printf("data: %s\n\r",data);
stundenInt=hextodec(data);
//printf("int: %d\n\r",temperaturInt);

if(TRUE){
sprintf(stundenStr_formatted,"%dh",stundenInt);
strcpy(stunden,stundenStr_formatted);
}
else{
strcpy(stunden,"Error!");
}
return;
}

void fehlerformatieren(unsigned char byte1,unsigned char byte2,unsigned char byte3,unsigned char byte4,unsigned char byte5,unsigned char byte6,unsigned char byte7,unsigned char byte8){
char data[10]="";
char tmp[3]="";
char fehlerStr_formatted[9];
unsigned int fehlerInt;

fehlerInt=12345;

if(TRUE){
sprintf(fehlerStr_formatted,"%d",fehlerInt);
strcpy(fehler,fehlerStr_formatted);
}
else{
strcpy(fehler,"Error!");
}
return;
}

void dummyformatieren(unsigned char lowbyte,unsigned char highbyte){
char data[10]="";
char tmp[3]="";

sprintf(tmp,"%X",highbyte);
strcpy(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

sprintf(tmp,"%X",lowbyte);
strcat(data,tmp);
//l=strlen(data);
//printf("data: %s (%d)\n\r",data,l);

if(TRUE){
strcpy(dummy,data);
}
else{
strcpy(dummy,"Error!");
}
return;
}

int main(int argc, char **argv)
{
FILE *fp;
struct termios oldtio,newtio;

int fd;
int c;
int res;
int i,k,l;
unsigned int x,y,z,t1,t2,dsIndex, dfIndex, dfX, dfY, sort1,sort2, stelle, zeilenproblock;
unsigned int state=0, syncstate=0;

unsigned char buf[1];
unsigned char merker[6];
unsigned char datensatz[100];
unsigned char datenfeld[100];
unsigned char datenfelder[50][16];
char data[10]="";
char tmp[3]="";
bool printflag;

// wenn in Kommandozeile die Schnittstelle mitgegeben wird, dann nimm diese sonst veruche default
if (argc > 1)
fd = open(argv[1], O_RDWR | O_NOCTTY );
else
fd = open(MODEMDEVICE, O_RDWR | O_NOCTTY );
if (fd <0) {
perror(MODEMDEVICE);
exit(-1);
}

// sichere die aktuellen Einstellungen
tcgetattr(fd,&oldtio);

// baue die neuen Einstellungen zusammen
bzero(&newtio, sizeof(newtio));
newtio.c_cflag = BAUDRATE | CS8 | CLOCAL | CREAD;
newtio.c_iflag = IGNPAR | IXON | IXOFF;
newtio.c_oflag = 0;
newtio.c_lflag = 0;
newtio.c_cc[VTIME] = 0; /* inter-character timer unused */
newtio.c_cc[VMIN] = 5; /* blocking read until 5 chars received */

tcflush(fd, TCIFLUSH);
tcsetattr(fd,TCSANOW,&newtio);

setvbuf(stdout, (char *)NULL, _IONBF, 0);

fp=fopen("sungocapture.bin","w");

if (fp == NULL)
return 0;

while (STOP==FALSE) { /* loop for input */
res = read(fd,buf,1); /* returns after 5 chars have been input */
//printf("A: syncstate: %d, state: %d, %X\n\r",syncstate,state,buf[0]);

fputc(res,fp);

}

fclose(fp);

close(fd);

tcsetattr(fd,TCSANOW,&oldtio);

return EXIT_SUCCESS;
}

</syntaxhighlight>
</div></div>

Solarthermie SunGo SXL

2026-07-31T15:53:23Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

Suchwort: Prozeda

==Motivation==
Angeregt durch drei Artikel unter https://hobbyelektronik.org<ref>https://hobbyelektronik.org/w/index.php/Prozeda-Decoder</ref><ref>https://hobbyelektronik.org/w/index.php/Pirozeda-HAT</ref><ref>https://hobbyelektronik.org/w/index.php/Prozeda-Decoder/Der_Datenstick</ref> habe ich mein Vorhaben, die SunGo SXL Solarthermie Steuerung in meine Gebäudeautomation zu integrieren, wieder aufgenommen.
Die Artikel sind für mich eine schöne Quelle (gewesen) meine Informationen und Daten abzugleichen und die Sicherheit zu haben, dass so wie ich mir das Ganze vorstelle, es scheinbar funktioniert.
Was durchaus erstaunlich ist. Denn bereits zu Beginn habe ich bei der Analyse des Datensticks im Datenblatt des AT45DB081D die Taktfrequenz bis zu 66 MHz gelesen.
Sollte die SunGo diese Rate ausnutzen, ist eine Emulation des Datensticks doch schon recht aufwendig und alle Mikrocontroller und RasPis dieser Welt als reine Softwareemulatoren auszen vor. Aber dazu weiter unten mehr.

==Allgemeines==
Die SunGo SXL ist eine Steuerung für solarthermische Anlagen der Firma Wagner&Co.
Die Steuerung bietet die Möglichkeit des Datenloggings. Zu diesem Zweck wird an der markierten Stelle ein kleiner Stick eingesteckt.
Um die Daten, die auf dem Stick aufgezeichnet werden, zu visualisieren, muss der Stick abgezogen werden und am PC in einen Leseadapter gesteckt werden.
Dann lassen sich mit der mitgelieferten Software (Datalogging Solareg II; DtSol2.exe)die Daten einlesen, anzeigen und exportieren.

==Artikel==
Die Artikel liefern eine Vielzahl von mitprotokollierten Daten und deren Analyse bis hin zur Beschreibung des möglichen Nachrichtenformats. Dafür herzlichen Dank, das hat mir viel Zeit gespart.
Auch die Interface-Implementierung mit Hilfe eines ATmega328 und die Datenaufbereitung durch einen RasPi ist eine gelungene Referenz. Zwischendrin haben mich dann aber immer mal wieder Aussagen unsicher gemacht,
die ich nicht nachvollziehen konnte. Dazu gehörten z. B. die Aussagen "Datenstick als Sackgasse herausgestellt" und "Leider stellte sich heraus, dass der Regler für den "zweiten Kanal" keinen Chip select herausführt."
Der Interface-ATmega ist auch z.B. MISO nicht angeschlossen. Was ist mit den Daten, die die SunGo lesen will!!!
Da ich diese Dinge nicht nachvollziehen kann habe ich mich entschlossen "meinen" Weg zu gehen und mir mit den Erkenntnissen der Artikel nur Gewissheit zu verschaffen, dass ich nicht in Fallen tappe, die bereits ausfindig gemacht wurden.

==Vorbemerkungen==
Im ersten Analyseschritt konzentriere ich mich ganz auf die Daten auf dem Datenstick. Wenn es gelingt das Datenformat zu "lesen" kann man daraus schließen welche Daten am Port der Steuerung übertragen werden und zwar in beide Richtungen!
Es ist doch sehr erstaunlich, dass durch einen fehlenden Stick am Steckplatz der Steuerung und damit fehlender Parameter z.B. des Log-Intervalls, die Steuerung freiwillig trotzdem Daten an den Stick sendet. Die Analyse der Kommunikation der SunGo über den MiniDIN-Port kommt erst später, sobald die Daten des Datensticks interpretierbar sind.

Ergänzung nach fortgeschrittener Entwicklung: Meine weiter oben dargestellten Bedenken haben sich eigentlich in Luft aufgelöst. Der Datenstick ist in sofern ein Sackgasse, da es nicht notwendig ist die SungoSXL zu bewegen den Datenstick zu beschreiben, da (alle) die notwendigen Daten zweimal auf dem SPI anliegen. Ein mögliche Erklärung ist schnell gefunden. An dem nach außen geführten SPI hängt intern wenigstens ein weiterer Client, dessen #CS (leider) nicht nach außen geführt ist. Somit kann man am MOSI die Daten mitlauschen. Für die Datenaufbereitung ist allerdings die Analyse der Datenspeicherung auf dem Datastick von (entscheidender) Bedeutung. Den (außen) fehlenden ChipSelect habe ich virtuell durch eine Timingroutine erzeugt. Ich gebe zu, dass ich mit meiner derzeitigen Lösung, die zwar funktioniert, eigentlich nicht glücklich bin. Kurz gesagt, ich würde die Daten lieber schön nach jedem Paket in der Datenlücke per seriellem Interface an den PC übertragen. Dumm ist halt nur, dass man die Lücke nicht richtig findet. Da muss ich mir noch was ausdenken, aber dazu unten mehr.

==Datastick Analyse==
[[Datei:SunGoSXL AT45DB081D.png|mini]]
Den Datenumfang sieht man am schönsten in der Datalog-Software (Datalogging Solareg II)

Datalogging-Software (V2.02.16) Menüstruktur:

*Datei
**Lese Datastick (STRG-L)
**Öffnen (STRG-O)
**Initialisiere Datastick ([[#Initialisierung Datenstick|Initialisierung Datenstick]])
**Log-Intervall setzen ([[#LogIntervall setzen|LogIntervall setzen]])
**Speichern
**Drucken..
**Beenden
*Optionen
**Sprache
**Auslesegeschwindigkeit anpassen ([[#Delay ermitteln|Delay ermitteln]])
**Rohdaten Datastick lesen ([[#Datenstick Rohdaten|Datenstick Rohdaten]])
**Datastick löschen ([[#Datenstick löschen|Datenstick löschen]])
**Bezeichnungsänderungen löschen
**Schreiben des Datasticks ermöglichen (?)
**Ertrag dokumentieren
*Hilfe
**Inhalt...
**Über..

Als Analysezeitraum diente eine Aufzeichnung vom 03.11. (Start 04:16 Uhr) bis 14.11. (Ende 12:56 Uhr).
Zur Aufzeichnung stehen folgende Werte zu Verfügung:
*Uhrzeit
*T1 Kollektor °C
*T2 Speicher unten
*T3 Speicher oben
*T4 Thermostat A
*T5 Poolschutz
*T6 Ertrag T
*T7 Rücklaufanhebung T
*T8 Rücklaufanhebung T
*T9 T
*Strahlung W/m²
*Speicher kWh
*Speicher h
*Funktion aktiv 1
*Funktion aktiv 2
*Volumenstrom l/min

Wobei hier noch nicht deutlich erkennbar ist, ob gerade die Werte Strahlung und Speicher, Werte sind die in der Datalog-Software aufbereitet sind und sich somit gar nicht als Rohdaten auf dem Datenstick befinden.

Anzahl Datensätze: (Aufzeichnungsintervall 1 Minute)
*03.11. 1184
*04.11. 1440
*05.11. 1440
*06.11. 1440
*07.11. 1440
*08.11. 1440
*09.11. 1440
*10.11. 1440
*11.11. 1440
*12.11. 1440
*13.11. 1440
*14.11. 777 in Summe 16361 Einträge

Der benutzte Datenstick hat eine Größe von 8 Mbit. Die Funktion "Rohdaten Datastick lesen" erzeugt eine Datei namens "debug.bin" mit einer Größe von 2 MiB. Da kommen doch Zweifel auf, dass es sich wirklich um die Rohdaten auf dem Stick handelt.

Mein FlashCat-EEPROM-Programmer liefert den tatsächlichen Inhalt des EEPROMS. Und siehe da. Das was da in debug.bin drin steht ist nach meinem Verständnis gar kein "binärer" Inhalt, sondern eine TXT-Datei, die die hexadezimale Entsprechung der eigentlichen Binärdatei in ASCII enthält.
Beispiel: In der Binärdatei steht HEX AA 55 01 05 ... Dies ist die hexadezimale Darstellung der Binärdaten 10101010 01010101 00000001 00001001 ... im EEPROM. Wenn man nun diese AA 55 01 05 (4 Byte) in ASCII codiert erhält man 61 61 35 35 30 31 30 35 (8 Byte)....
Dadurch erklärt sich die doppelte Dateigröße. Die Verwendung eines solchen Formates (Codierung) erschließt sich mir nicht.
NB: Endian habe ich nicht kontrolliert. Die Bin-Datei lässt Little-Endian vermuten. Ist aber eigentlich auch egal. Ich muss sowieso später im Ausleseprogramm individuell darauf reagieren.

Als Grundlage für die weitere Untersuchung dient natürlich jetzt die "korrekte" Bin-Datei.

<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Inhalt EEPROM</div>
<div class="mw-collapsible-content">
<div style="font-family:Courier;white-space: pre-wrap;">
0000:0000 | <span style="color:blue">AA 55 01 05 23 01 </span><span style="color:red">FF FF FF FF FF FF FF FF FF 01 | ŠU..#.ĸĸĸĸĸĸĸĸĸ.</span>
0000:0010 | <span style="color:green">20 57 61 67 6E 65 72 20 26 20 43 6F 20 20 00 00 | Wagner & Co ..
0000:0020 | 00 00 00 00 00 00 00 00 00 00 20 53 6F 6C 61 72 | .......... Solar
0000:0030 | 20 53 6F 6C 61 72 74 65 63 68 6E 69 6B 20 31 34 | Solartechnik 14
0000:0040 | 31 35 31 36 53 50 31 32 30 31 31 32 35 31 30 30 | 1516SP1201125100
0000:0050 | 20 20 53 79 73 74 65 6D 2D 4E 72 2E 20 20 04 BB | System-Nr. .ŧ
0000:0060 | 20 53 79 73 74 65 6D 2D 56 65 72 2E 20 20 00 66 | System-Ver. .f</span>
0000:0070 | <span style="color:Teal">FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0080 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0090 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:00A0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:00B0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:00C0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:00D0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:00E0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:00F0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0100 | BF FF 7E FF F7 E7 DF FF FF FF FF FF FF FF FF FF | ŋĸ~ĸũįßĸĸĸĸĸĸĸĸĸ
0000:0110 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0120 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0130 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0140 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0150 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0160 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0170 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0180 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0190 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:01A0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:01B0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:01C0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:01D0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:01E0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:01F0 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ
0000:0200 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸĸ</span>
0000:0210 | <span style="color:Navi">20 20 20 20 44 61 74 75 6D 20 20 20 20 20 00 08 | Datum ..
0000:0220 | 20 20 20 55 68 72 7A 65 69 74 20 20 20 20 00 09 | Uhrzeit ..
0000:0230 | 20 20 4B 6F 6C 6C 65 6B 74 6F 72 20 20 20 00 01 | Kollektor ..
0000:0240 | 20 20 53 70 65 69 63 68 65 72 20 B9 20 20 00 01 | Speicher đ ..
0000:0250 | 20 20 53 70 65 69 63 68 65 72 20 B3 20 20 00 01 | Speicher ģ ..
0000:0260 | 20 54 68 65 72 6D 6F 73 74 61 74 20 41 20 00 01 | Thermostat A ..
0000:0270 | 20 20 50 6F 6F 6C 73 63 68 75 74 7A 20 20 00 01 | Poolschutz ..
0000:0280 | 20 20 45 72 74 72 61 67 20 20 20 54 20 20 00 01 | Ertrag T ..
0000:0290 | 52 FC 63 6B 6C 2E 41 6E 68 2E 20 54 20 20 00 01 | Rückl.Anh. T ..
0000:02A0 | 52 FC 63 6B 6C 2E 41 6E 68 2E 20 54 20 20 00 01 | Rückl.Anh. T ..
0000:02B0 | 20 20 20 54 20 20 20 20 20 20 00 00 00 00 00 01 | T ......
0000:02C0 | 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 00 | Dummy...........
0000:02D0 | 53 74 72 61 68 6C 75 6E 67 20 00 00 00 00 00 02 | Strahlung ......
0000:02E0 | 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 00 | Dummy...........
0000:02F0 | 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 00 | Dummy...........
0000:0300 | 20 20 41 75 73 67 61 6E 67 20 31 20 20 20 00 0A | Ausgang 1 ..
0000:0310 | BF FF 3E FF E7 E7 DF FF 20 20 41 75 73 67 61 6E | ŋĸ>ĸįįßĸ Ausgan
0000:0320 | 67 20 32 20 20 20 00 0A 20 20 41 75 73 67 61 6E | g 2 .. Ausgan
0000:0330 | 67 20 33 20 20 20 00 0A 20 20 41 75 73 67 61 6E | g 3 .. Ausgan
0000:0340 | 67 20 34 20 20 20 00 0A 20 20 41 75 73 67 61 6E | g 4 .. Ausgan
0000:0350 | 67 20 35 20 20 20 00 0A 20 20 41 75 73 67 61 6E | g 5 .. Ausgan
0000:0360 | 67 20 36 20 20 20 00 0A 20 20 46 65 68 6C 65 72 | g 6 .. Fehler
0000:0370 | 20 20 00 00 00 00 00 0D 20 20 46 65 68 6C 65 72 | ...... Fehler
0000:0380 | 20 20 00 00 00 00 00 0D 20 20 46 65 68 6C 65 72 | ...... Fehler
0000:0390 | 20 20 00 00 00 00 00 0E 20 20 20 53 70 65 69 63 | ...... Speic
0000:03A0 | 68 65 72 20 20 20 00 07 44 75 6D 6D 79 00 00 00 | her ..Dummy...
0000:03B0 | 00 00 00 00 00 00 00 00 44 75 6D 6D 79 00 00 00 | ........Dummy...
0000:03C0 | 00 00 00 00 00 00 00 00 20 20 20 53 70 65 69 63 | ........ Speic
0000:03D0 | 68 65 72 20 20 20 00 0F 44 75 6D 6D 79 00 00 00 | her ..Dummy...
0000:03E0 | 00 00 00 00 00 00 00 00 44 75 6D 6D 79 00 00 00 | ........Dummy...
0000:03F0 | 00 00 00 00 00 00 00 00 46 75 6E 6B 74 69 6F 6E | ........Funktion
0000:0400 | 20 61 6B 74 69 76 00 0B 46 75 6E 6B 74 69 6F 6E | aktiv..Funktion
0000:0410 | 20 61 6B 74 69 76 00 0C BF FF 3E FF E7 E7 DF FF | aktiv..ŋĸ>ĸįįßĸ
0000:0420 | 20 56 6F 6C 75 6D 65 6E 73 74 72 6F 6D 20 00 13 | Volumenstrom ..
0000:0430 | 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 00 | Dummy...........
0000:0440 | 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 00 | Dummy...........
0000:0450 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:0460 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:0470 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:0480 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:0490 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:04A0 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:04B0 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:04C0 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:04D0 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:04E0 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:04F0 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:0500 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................
0000:0510 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0C </span>| ................
0000:7F60 | <span style="background-color:OrangeRed">BF FF 7E FF F7 E7 DF FF</span><span style="color:FireBrick"> 4F 04 00 01 2E 00 E6 00 | ŋĸ~ĸũįßĸO.....æ.
0000:7F70 | 25 01 C4 09 C4 09 C4 09 0D 01 DE 00 A2 FE 00 00 | %.Ä.Ä.Ä...Þ.Ēþ..
0000:7F80 | 00 00 00 00 00 00 00 00 00 00 00 64 00 15 15 08 | ...........d....
0000:7F90 | 00 00 00 00 00 00 00 00 7D 01 00 00 00 00 01 00 | ........}.......
0000:7FA0 | 00 00 00 00 00 00 00 00</span><span style="color:#008800"> 4F 04 01 01 2E 00 E6 00 | ........O.....æ.
0000:7FB0 | 25 01 C4 09 C4 09 C4 09 0D 01 DE 00 A2 FE 00 00 | %.Ä.Ä.Ä...Þ.Ēþ..
0000:7FC0 | 00 00 00 00 00 00 00 00 00 00 00 64 00 15 15 08 | ...........d....
0000:7FD0 | 00 00 00 00 00 00 00 00 7D 01 00 00 00 00 01 00 | ........}.......
0000:7FE0 | 00 00 00 00 00 00 00 00</span><span style="color:FireBrick"> 4F 04 02 01 2E 00 E6 00 | ........O.....æ.
0000:7FF0 | 25 01 C4 09 C4 09 C4 09 0B 01 DF 00 A2 FE 00 00 | %.Ä.Ä.Ä...ß.Ēþ..
0000:8000 | 00 00 00 00 00 00 00 00 00 00 00 64 00 15 15 08 | ...........d....
0000:8010 | 00 00 00 00 00 00 00 00 7D 01 00 00 00 00 01 00 | ........}.......
0000:8020 | 00 00 00 00 00 00 00 00</span><span style="color:#008800"> 4F 04 03 01 2E 00 E6 00 | ........O.....æ.
0000:8030 | 25 01 C4 09 C4 09 C4 09 0D 01 DE 00 A2 FE 00 00 | %.Ä.Ä.Ä...Þ.Ēþ..
0000:8040 | 00 00 00 00 00 00 00 00 00 00 00 64 00 15 15 08 | ...........d....
0000:8050 | 00 00 00 00 00 00 00 00 7D 01 00 00 00 00 01 00 | ........}.......
0000:8060 | 00 00 00 00 00 00 00 00 <span style="background-color:OrangeRed">BF FF 7E FF F7 E7 DF FF</span> | ........ŋĸ~ĸũįßĸ</span>
0000:8070 | <span style="color:Firebrick"> 4F 04 04 01 2E 00 E7 00 25 01 C4 09 C4 09 C4 09 | O.....į.%.Ä.Ä.Ä.
0000:8080 | 0D 01 DE 00 A2 FE 00 00 00 00 00 00 00 00 00 00 | ..Þ.Ēþ..........
0000:8090 | 00 00 00 64 00 15 15 08 00 00 00 00 00 00 00 00 | ...d............
0000:80A0 | 7D 01 00 00 00 00 01 00 00 00 00 00 00 00 00 00 | }...............
0000:80B0 | </span><span style="color:#008800">4F 04 05 01 2E 00 E6 00 25 01 C4 09 C4 09 C4 09 | O.....æ.%.Ä.Ä.Ä.
0000:80C0 | 0C 01 DD 00 A2 FE 00 00 00 00 00 00 00 00 00 00 | ..Ý.Ēþ..........
0000:80D0 | 00 00 00 64 00 15 15 08 00 00 00 00 00 00 00 00 | ...d............
0000:80E0 | 7D 01 00 00 00 00 01 00 00 00 00 00 00 00 00 00 | }...............
0000:80F0 | 4F 04 06 01 2D 00 E6 00 24 01 C4 09 C4 09 C4 09 | O...-.æ.$.Ä.Ä.Ä.
0000:8100 | 0B 01 DD 00 A2 FE 00 00 00 00 00 00 00 00 00 00 | ..Ý.Ēþ..........
0000:8110 | 00 00 00 64 00 15 15 08 00 00 00 00 00 00 00 00 | ...d............
0000:8120 | 7D 01 00 00 00 00 01 00 00 00 00 00 00 00 00 00 | }...............
0000:8130 | 4F 04 07 01 2F 00 E6 00 26 01 C4 09 C4 09 C4 09 | O.../.æ.&.Ä.Ä.Ä.
0000:8140 | 0E 01 DE 00 A2 FE 00 00 00 00 00 00 00 00 00 00 | ..Þ.Ēþ..........
0000:8150 | 00 00 00 64 00 15 15 08 00 00 00 00 00 00 00 00 | ...d............
0000:8160 | 7D 01 00 00 00 00 01 00 00 00 00 00 00 00 00 00 | }...............
</div>
</div></div>

In der Darstellung des BIN-Files musste ich etwas tricksen. Man erkennt den Sprung an Adresse 0000:0510 - 0000:7F60.
Das kommt daher, dass ich hier die passenden Daten zu der nachfolgenden Exportdatei zeigen will. Da die Daten im EEPROM in
einem Ringpuffer-Verfahren abgelegt sind und in der Exportdatei chronologisch gezeigt werden, erklärt sich, dass der älteste Eintrag im Ringpuffer in der Regel nicht am Anfang des EEPROM-Speichers abgelegt ist.

Die Binärdatei hat folgende Struktur:

{| class="wikitable"
!Offset (hex)!!Offset (dez)!!Datenbytes!!Bemerkung
|-
|0x00000|| 0 ||AA 55 LI XX XX XX ||File Signatur erinnert an die Magic Number. Das dritte Byte ist das Logintervall.
|-
|0x00006|| 6 ||FF ... FF 01||
|-
|0x00010|| 16 ||20 57 61 67 ... ||Wagner& Co ... System-Nr. und System-Version sind als 2 Byte Integer codiert
|-
|0x00100|| 256 || 8 Byte (Identifier ?)
|-
|0x00210|| 528 || ||Kopfdaten (Kopfzeile Messwerte incl. Typ und Reihenfolge). Pro Eintrag 16 Bytes.
|-
|0x00520|| || ||In Blöcken von jeweils 264 Byte Daten (Datum (8 Byte) + 4 * Werte (64 Byte))
|-
|}

Was im Vergleich mit der auf hobbyelektronik.org veröffentlichen Binärdatei auffällt ist, dass der Wert 0x40 (64) in der Datalogging Software kein zulässiges LogIntervall ist. Es werden nur die Werte 1,2,5,10,15,20 und 30 Minuten vorgeschlagen. Die nächsten Bytes sind bei mir 05 23 01, in der Vergleichsdatei 05 24 01. Die darauf folgende Reihe von FF schließen mit 01 oder 00 ab. Ein weiterer großer Unterschied ist an Offset-Position 0000:0100 zu sehen. In meiner Binärdatei steht ab dieser Stelle ein 8 Byte (Zufallswert). Dieser Wert fehlt in der Vergleichsdatei. Der Grund liegt in der (Page-)Organisation des EEPROMs. Dort sind 256 bzw. 264 Bytes pro Page einstellbar. Die Differenz sind genau die fraglichen 8 Bytes. Aber egal ob sie nun mitgelesen/geschrieben werden, sie lassen sich leicht im Programm ausfiltern.

<div style="font-family:Courier;white-space: pre-wrap;">
00000000 AA 55 40 05 24 01 FF FF FF FF FF FF FF FF FF 00 ªU@.$.ÿÿÿÿÿÿÿÿÿ.
00000010 20 20 57 61 67 6E 65 72 20 26 20 43 6F 20 00 00 Wagner & Co ..
00000020 00 00 00 00 00 00 00 00 00 00 20 53 6F 6C 61 72 .......... Solar
00000030 20 53 6F 6C 61 72 74 65 63 68 6E 69 6B 20 XX XX Solartechnik XX
00000040 XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XXXXXXXXXXXXXXXX
00000050 20 20 53 79 73 74 65 6D 2D 4E 72 2E 20 20 XX XX System-Nr. XX
00000060 20 53 79 73 74 65 6D 2D 56 65 72 2E 20 20 XX XX System-Ver. XX
</div>

Die darauf folgenden Kopfdaten haben immer 16 Bytes. Das zweitletzte Byte ist wohl immer 0x00 und stellt den Stringabschluss dar. Das letzte (16.) Byte ist der Typ des (Mess-)wertes.
*00 Dummy
*01 Temperatur
*02 (Strahlung) W/m²
*07 (Speicher) kWh
*08 Datum
*09 Uhrzeit
*0A Prozent
*0B (Funktion aktiv)
*0C (Funktion aktiv)
*0D (Fehler)
*0E (Fehler)
*0F (Speicher) h
*13 (Volumenstrom) l/min

Es werden folgende Werte geschrieben:
#Datum 2 Byte Little Endian uint16 Ob die führenden Nullen mit gerechnet werden muss ich noch testen. Sonst wäre z.B. 112 nicht eindeutig 1.12. oder 11.2.
#Uhrzeit 2 Byte Little Endian uint16 Anzahl der Minuten seit Mitternacht.
#Kollektor 2 Byte Little Endian uint16 Teiler 10 damit 1 Nachkommastelle
#Speicher unten 2 Byte Little Endian uint16 Teiler 10 damit 1 Nachkommastelle
#Speicher oben 2 Byte Little Endian uint16 Teiler 10 damit 1 Nachkommastelle
#Thermostat 2 Byte Little Endian uint16 Teiler 10 damit 1 Nachkommastelle
#Poolschutz 2 Byte Little Endian uint16 Teiler 10 damit 1 Nachkommastelle
#Ertrag 2 Byte Little Endian uint16 Teiler 10 damit 1 Nachkommastelle
#Rücklaufanhebung 1 2 Byte Little Endian uint16 Teiler 10 damit 1 Nachkommastelle
#Rücklaufanhebung 2 2 Byte Little Endian uint16 Teiler 10 damit 1 Nachkommastelle
#T (?) 2 Byte Little Endian uint16 Teiler 10 damit 1 Nachkommastelle Zweier-Komplement
#Dummy 2 Byte 00 00
#Strahlung 2 Byte bei mir immer 00 00 , daher kann ich nicht kontrollieren
#Dummy 2 Byte 00 00
#Dummy 2 Byte 00 00
#Ausgang 1 1 Byte Prozent
#Ausgang 2 1 Byte Prozent
#Ausgang 3 1 Byte Prozent
#Ausgang 4 1 Byte Prozent
#Ausgang 5 1 Byte Prozent
#Ausgang 6 1 Byte Prozent
#Fehler (0D) X Byte
#Fehler (0D) X Byte
#Fehler (0E) Y Byte X+X+Y = 8
#Speicher (07)
#Dummy (00) 2 Byte 00 00
#Dummy (00) 2 Byte 00 00
#Speicher (15) 2 Byte Little Endian uint16
#Dummy (00) 2 Byte 00 00
#Dummy (00) 2 Byte 00 00
#Funktion aktiv (11) 2 Byte Little Endian uint16
#Funktion aktiv (12) 2 Byte Little Endian uint16
AB Byte 60 gibt es keinen Hinweis mehr im Typ 0301
#Volumenstrom 2 Byte Little Endian uint16
#Dummy 2 Byte 00 00
#Dummy 2 Byte 00 00
#(Checksumme ?) 2 Byte

<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Die Exportdatei der Datalogging-Software dient als Abgleich.</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="txt" line>
;Datalogging
; Wagner & Co
;
; Solartechnik
1317SP1201105100
; System-Nr. 1211
; System-Ver. 102
Datum Uhrzeit Kollektor Speicher unten Speicher oben Thermostat A Poolschutz Ertrag T Rückl.Anh. T Rückl.Anh. T T Strahlung Ausgang 1 Ausgang 2 Ausgang 3 Ausgang 4 Ausgang 5 Ausgang 6 Speicher Speicher Funktion aktiv Funktion aktiv Volumenstrom
8 9 1 1 1 1 1 1 1 1 1 2 10 10 10 10 10 10 7 15 11 12 19

03.11.21 04:16:00 4.600 23.000 29.300 250.000 250.000 250.000 26.900 22.200 -35.000 0.000 0.000 0.000 0.000 0.000 0.000 100.000 0 381 0.100 0.000 0.000
03.11.21 04:17:00 4.600 23.000 29.300 250.000 250.000 250.000 26.900 22.200 -35.000 0.000 0.000 0.000 0.000 0.000 0.000 100.000 0 381 0.100 0.000 0.000
03.11.21 04:18:00 4.600 23.000 29.300 250.000 250.000 250.000 26.700 22.300 -35.000 0.000 0.000 0.000 0.000 0.000 0.000 100.000 0 381 0.100 0.000 0.000
03.11.21 04:19:00 4.600 23.000 29.300 250.000 250.000 250.000 26.900 22.200 -35.000 0.000 0.000 0.000 0.000 0.000 0.000 100.000 0 381 0.100 0.000 0.000
03.11.21 04:20:00 4.600 23.100 29.300 250.000 250.000 250.000 26.900 22.200 -35.000 0.000 0.000 0.000 0.000 0.000 0.000 100.000 0 381 0.100 0.000 0.000
...
</syntaxhighlight>
</div></div>

===Initialisierung Datenstick===

Der Vorgang wird durch den entsprechenden Menüeintrag aufgerufen. In der Übersicht erkennt man, dass der Initialisierungsprozess ca. 16 Sekunden dauert. Die Unterbrechnung am Anfang bis ca. 8 Sekunden hat die Ursache in der (User-)Reaktion auf die Meldung, dass der Stick bereits eine Kennung besitzt und ob wirklich neu geschrieben werden soll.

[[Datei:Screenshot SunGo Datastick Initialisierung Overview.png|600px]]

Man erkennt bei der Startabfrage die aktuelle Kennung AA 55 01 00 ab Offset 8 und BD FF 26 55 A5 05 94 2F AA 55 01 00 ( am Ende dann: DE EF 93 2A D2 82 CA 17 D5 2A 80 80 7F).

[[Datei:Screenshot SunGo Datastick Initialisierung Start.png|600px]]

Die Erase-Methode ist hier das Block-Erase. Die 50h ist der Opcode gefolgt von der Blockadresse.

A block of eight pages can be erased at one time. This command is useful when large amountsof data has to be written into the device. This will avoid using multiple Page Erase Commands.To perform a block erase for the DataFlash standard page size (264-bytes), an opcode of 50Hmust be loaded into the device, followed by three address bytes comprised of three don’t carebits, nine page address bits (PA11 -PA3) and 12 don’t care bits. The nine page address bits areused to specify which block of eight pages is to be erased. To perform a block erase for thebinary page size (256-bytes), the opcode 50H must be loaded into the device, followed by threeaddress bytes consisting of four don’t care bits, nine page address bits (A19 - A11) and 11 don’tcare bits. The nine page address bits are used to specify which block of eight pages is to beerased. When a low-to-high transition occurs on the CS pin, the part will erase the selectedblock of eight pages. The erase operation is internally self-timed and should take place in a max-imum time of tBE. During this time, the status register will indicate that the part is busy.

[[Datei:Screenshot SunGo Datastick Initialisierung Erase.png|600px]]

Die letzte Blockadresse die gelöscht wird ist 1F F0 00. Dann folgt noch ein Main Memory Page Program Through Buffer 1 82h und ein Main Memory Page Read D2h

[[Datei:Screenshot SunGo Datastick Initialisierung End.png|600px]]

===LogIntervall setzen===
Das LogIntervall setzen besteht wirklich nur im Verändern des Wertes nach AA 55. Hier in diesem Fall 1E für 30 Minuten.

[[Datei:Screenshot SunGo Datastick LogIntervall setzen.png|660px]]

===Delay ermitteln===
[[Datei:SunGo Software Screenshot Lesegeschwindigkeit.png|600px]]

[[Datei:Screenshot SunGo Lesegeschwindigkeittest.png|800px]]

[[Datei:SunGo Software Screenshot Lesegeschwindigkeit Delay.png|120px]]

===Datenstick Rohdaten===
TODO

===Datenstick löschen===
TODO

==Steuerung Analyse==

Zu Beginn der Analyse der Steuerung gleich etwas Beruhigendes. Der SPI-Takt (5 us/200 kHz) der Steuerung ist gemütlich. Die Bits werden auf der Mitte (fallende Flanke) des Taktes übernommen.
Als Grundlage diente mir ein knapp 20 Sekunden langer Mitschnitt.

[[Datei:SunGo Steuerung Screenshot 20Sekunden Sample.png|x100px]]

Der Zyklus wiederholt sich jede Sekunde. Es kommen 5 Doppelpakete (DPA) mit einem Abstand von 200 ms. Je nachdem wie man den Anfang festlegt, kommen bevor der Zyklus von neuem beginnt in der 146ms Lücke noch ein Doppelpaket (DPB) und die EEPROM-Abfrage.

[[Datei:SunGo Steuerung Screenshot Pulseview Overview.png|x100px]]

Refresh: 200ms

DPA_1 ist ein AA 55 55 AA 02 00 17x AA 16x AA

DPA_2 ist ein AA 55 55 AA 01 00 und enthält die Daten für das Display.

[[Datei:SunGo Steuerung Screenshot Pulseview Paketabstaende.png|x100px]]

*DPA_1 (AB): 3,5ms
*P (BC): 46,5ms (AC): 50ms
*DPA_2 (CD): 4,4ms
*P (DE): 145,6ms (CE): 150ms
*Periode (AE): 200ms

Refresh: 1s

DPB_1 ist ein AA 55 55 AA 03 01 Inhalt noch nicht untersucht

DPB_2 ist ein AA 55 55 AA 03 00 Nutzdaten

[[Datei:SunGo Screenshot Datenpaket B.png|x100px]]

Nach jedem fünften DPA_2 folgt
*Pause 21ms
*DPB_1 5ms
*Pause 15ms
*DPB_2 5ms
*Pause 10ms
*EEPROM 2ms
*Pause 88ms

DPA_1:"kleines" Paket (AB): 320us: AA 55 55 AA 02 00 (P970us) 1100us: 17*AA (P67us) 1033us:16*AA gesamt:3491us dann Abstand 46ms
Pause: 50ms

DPA_2:"großes" Paket (CD) 320us: AA 55 55 AA 01 00 (P290us) 3787us: 64 Byte (10P=592us) gesamt:4387us

Vor dem CS (Periodendauer: 1000ms) kommt immer noch ein weiteres Doppelpaket dazwischen
*0s: DPA (+DPB+EEPROM-Abfrage in der 145,6ms Lücke)
*200ms: DPA
*400ms: DPA
*600ms: DPA
*800ms: DPA
*1000ms: next Cycle

===Inhalt der "Nicht-EEPROM" Pakete===

<div class="toccolours mw-collapsible mw-collapsed" style="width:1800px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Daten der Pakete ohne EEPROM Chip Select</div>
<div class="mw-collapsible-content">
Zeile 5924
AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 03 01 0D 11 04 08 52 FC 63 6B 6C 2E 41 6E 68 2E 20 54 20 20 01 09 52 FC 63 6B 6C 2E 41 6E 68 2E 20 54 20 20 01 0A 20 20 20 54 20 20 20 20 20 20 00 00 00 00 01 0B 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 00 23 4C AA 55 55 AA 03 00 20 00 35 01 1B 04 7D 00 18 01 1D 01 C4 09 C4 09 C4 09 23 01 2D 01 A2 FE 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 15 15 08 00 00 00 00 00 00 00 00 FD 38 00 00 00 00 01 00 00 00 00 00 00 00 00 00 20 0A

Zeile 18438
AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 03 01 0D 11 04 0C 53 74 72 61 68 6C 75 6E 67 20 00 00 00 00 02 0D 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 0E 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 0F 20 20 41 75 73 67 61 6E 67 20 31 20 20 20 0A 00 23 2E AA 55 55 AA 03 00 20 00 35 01 1B 04 7D 00 18 01 1D 01 C4 09 C4 09 C4 09 23 01 2D 01 A2 FE 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 15 15 08 00 00 00 00 00 00 00 00 FD 38 00 00 00 00 01 00 00 00 00 00 00 00 00 00 20 0A

Zeile 30952
AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 35 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 AA 55 55 AA 03 01 0D 11 04 10 20 20 41 75 73 67 61 6E 67 20 32 20 20 20 0A 11 20 20 41 75 73 67 61 6E 67 20 33 20 20 20 0A 12 20 20 41 75 73 67 61 6E 67 20 34 20 20 20 0A 13 20 20 41 75 73 67 61 6E 67 20 35 20 20 20 0A 00 23 99 AA 55 55 AA 03 00 20 00 35 01 1B 04 7D 00 18 01 1C 01 C4 09 C4 09 C4 09 22 01 2D 01 A2 FE 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 15 15 08 00 00 00 00 00 00 00 00 FD 38 00 00 00 00 01 00 00 00 00 00 00 00 00 00 20 08

Zeile 43466
AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 03 01 0D 11 04 14 20 20 41 75 73 67 61 6E 67 20 36 20 20 20 0A 15 20 20 46 65 68 6C 65 72 20 20 00 00 00 00 0D 16 20 20 46 65 68 6C 65 72 20 20 00 00 00 00 0D 17 20 20 46 65 68 6C 65 72 20 20 00 00 00 00 0E 00 23 0B AA 55 55 AA 03 00 20 00 35 01 1B 04 7D 00 18 01 1C 01 C4 09 C4 09 C4 09 22 01 2D 01 A2 FE 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 15 15 08 00 00 00 00 00 00 00 00 FD 38 00 00 00 00 01 00 00 00 00 00 00 00 00 00 20 08

Zeile 55980
AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 03 01 0D 11 04 18 20 20 20 53 70 65 69 63 68 65 72 20 20 20 07 19 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 1A 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 1B 20 20 20 53 70 65 69 63 68 65 72 20 20 20 0F 00 23 BF AA 55 55 AA 03 00 20 00 35 01 1B 04 7D 00 18 01 1C 01 C4 09 C4 09 C4 09 22 01 2D 01 A2 FE 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 15 15 08 00 00 00 00 00 00 00 00 FD 38 00 00 00 00 01 00 00 00 00 00 00 00 00 00 20 08

Zeile 68494
AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 02 00 AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E 34 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 61 AA 55 55 AA 03 01 0D 11 04 1C 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 1D 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00 1E 46 75 6E 6B 74 69 6F 6E 20 61 6B 74 69 76 0B 1F 46 75 6E 6B 74 69 6F 6E 20 61 6B 74 69 76 0C 00 23 04 AA 55 55 AA 03 00 20 00 35 01 1B 04 7C 00 17 01 1C 01 C4 09 C4 09 C4 09 21 01 2D 01 A2 FE 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 15 15 08 00 00 00 00 00 00 00 00 FD 38 00 00 00 00 01 00 00 00 00 00 00 00 00 00 20 05
</div></div>

Mann kann in den Paketen "Steuersequenzen" ausmachen. Sie werden durch 'AA 55 55 AA' eingeleitet und von einem Selektor (2 Byte ?) 01 00, 02 00, 03 00 und 03 01 gefolgt.

Hier die sind Beispieldaten sortiert nach den Selektoren:
AA 55 55 AA 01 00 20 20 53 70 65 69 63 68 65 72 20 DE 20 20 20 20 32 38 2E (35 oder 34) 01 43 20 20 20 31 36 20 05 2D 01 43 2D 06 31 30 35 20 01 01 18 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 (61 bei 34 und 62 bei 35)
S p e i c h e r ^ 2 8 . 5 4 ° C 1 6 - ° C - 1 0 5

Der ''''01 00'''' spricht das Display an.

AA 55 55 AA 02 00 33xAA

Der ''''02 00'''' hat "keinen" Inhalt.

AA 55 55 AA 03 00 Einleitung 20 00 (64 Nutzbytes) 35 01 1B 04 7C 00 17 01 1C 01 C4 09 C4 09 C4 09 21 01 2D 01 A2 FE 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 15 15 08 00 00 00 00 00 00 00 00 FD 38 00 00 00 00 01 00 00 00 00 00 00 00 00 00 Abschluss 20 05
Datum Uhrzeit
09.03. 17:31
Datensatz aus dem Stick: 4F 04 03 01 2E 00 E6 00 25 01 C4 09 C4 09 C4 09 0D 01 DE 00 A2 FE 00 00 00 00 00 00 00 00 00 00 00 00 00 64 00 15 15 08 00 00 00 00 00 00 00 00 7D 01 00 00 00 00 01 00 00 00 00 00 00 00 00 00

Der ''''03 00'''' ist der Interessante. Beim Vergleich der Nutzdaten mit dem Speicherstickinhalt-Datensatz sieht man die Übereinstimmung des Aufbaus. SUPER! Dann kann man sich die Emulation des Stick sparen und durch sniffen und einem Selektorscan nach '03 00' hat man das gleiche Ergebnis!
Das einzige Problem ist das fehlende ChipSelect zu diesen Datenpaketen.

AA 55 55 AA 03 01 0D 11 04 (67 Byte)
1C 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00
1D 44 75 6D 6D 79 00 00 00 00 00 00 00 00 00 00
1E 46 75 6E 6B 74 69 6F 6E 20 61 6B 74 69 76 0B
1F 46 75 6E 6B 74 69 6F 6E 20 61 6B 74 69 76 0C
00 23 04

Die Bedeutung des ''''03 01'''' Datensatzes habe ich noch nicht untersucht. Nachtrag: Der Datensatz 0301 enthält die übermittelten Datenfelder (Klartext) des Datensatzes 0300. Dann ergibt es auch einen Sinn wenn 0301 immer vor 0300 gesendet wird.

Um den Arduino im Sniffing-Mode und nicht im Emulator-Mode zu betreiben ist das Timing der Pakete hilfreich. Durch das fehlende Chipselect ist man gezwungen irgendwie einen Rhythmus oder Trigger im Ausleseprogramm zu implementieren.

==Arduino als SPI-Master==
[[Datei:Datastick Adapter.png|mini|Datastick Adapter]]
Als erste Quelle habe ich https://www.arduino.cc/en/Tutorial/SPIEEPROM benutzt.
Ich hatte mir für den Anschluss von DigiAnalyzer auf die Schnelle einen Adapter gebastelt. Leider hat er am original Interface seinen Dienst versagt. Ich gehe von Laufzeitproblemen aus.
Er bekommt eine zweite Chance als Brücke zum Arduino.

<div class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">SPI Master EEPROM</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="c" line>
#define DATAOUT 11//MOSI
#define DATAIN 12//MISO
#define SPICLOCK 13//sck
#define SLAVESELECT 10//ss
//opcodes
#define WREN 6
#define WRDI 4
#define RDSR 5
#define WRSR 1
#define READ 3
#define WRITE 2
byte eeprom_output_data;
byte eeprom_input_data=0;
byte clr;
int address=0;
//data buffer
char buffer [128];
void fill_buffer()
{
for (int I=0;I<128;I++)
{
buffer[I]=I;
}
}
char spi_transfer(volatile char data)
{
SPDR = data; // Start the transmission
while (!(SPSR & (1<<SPIF))) // Wait the end of the transmission
{
};
return SPDR; // return the received byte
}
void setup()
{
Serial.begin(9600);
pinMode(DATAOUT, OUTPUT);
pinMode(DATAIN, INPUT);
pinMode(SPICLOCK,OUTPUT);
pinMode(SLAVESELECT,OUTPUT);
digitalWrite(SLAVESELECT,HIGH); //disable device
// SPCR = 01010000
//interrupt disabled,spi enabled,msb 1st,master,clk low when idle,
//sample on leading edge of clk,system clock/4 rate (fastest)
SPCR = (1<<SPE)|(1<<MSTR);
clr=SPSR;
clr=SPDR;
delay(10);
//fill buffer with data
fill_buffer();
//fill eeprom w/ buffer
digitalWrite(SLAVESELECT,LOW);
spi_transfer(WREN); //write enable
digitalWrite(SLAVESELECT,HIGH);
delay(10);
digitalWrite(SLAVESELECT,LOW);
spi_transfer(WRITE); //write instruction
address=0;
spi_transfer((char)(address>>8)); //send MSByte address first
spi_transfer((char)(address)); //send LSByte address
//write 128 bytes
for (int I=0;I<128;I++)
{
spi_transfer(buffer[I]); //write data byte
}
digitalWrite(SLAVESELECT,HIGH); //release chip
//wait for eeprom to finish writing
delay(3000);
Serial.print('h',BYTE);
Serial.print('i',BYTE);
Serial.print('\n',BYTE);//debug
delay(1000);
}
byte read_eeprom(int EEPROM_address)
{
//READ EEPROM
int data;
digitalWrite(SLAVESELECT,LOW);
spi_transfer(READ); //transmit read opcode
spi_transfer((char)(EEPROM_address>>8)); //send MSByte address first
spi_transfer((char)(EEPROM_address)); //send LSByte address
data = spi_transfer(0xFF); //get data byte
digitalWrite(SLAVESELECT,HIGH); //release chip, signal end transfer
return data;
}
void loop()
{
eeprom_output_data = read_eeprom(address);
Serial.print(eeprom_output_data,DEC);
Serial.print('\n',BYTE);
address++;
if (address == 128)
address = 0;
delay(500); //pause for readability
}
</syntaxhighlight>
</div></div>

Jetzt das Ganze entsprechend anpassen. Erst mal nur lesender Zugriff.

The following code examples show how to initialize the SPI as a master and how to perform a simple transmission. DDR_SPI in the examples must be replaced by the actual data direction register controlling the SPI pins. DD_MOSI, DD_MISO and DD_SCK must be replaced by the actual data direction bits for these pins. E.g. if MOSI is placed on pin PB5, replace DD_MOSI with DDB5 and DDR_SPI with DDRB.

<syntaxhighlight lang="c" line>
void SPI_MasterInit(void){
/* Set MOSI and SCK output, all others input */
DDR_SPI = (1<<DD_MOSI)|(1<<DD_SCK);
/* Enable SPI, Master, set clock rate fck/16 */
SPCR = (1<<SPE)|(1<<MSTR)|(1<<SPR0);
}

void SPI_MasterTransmit(char cData){
/* Start transmission */
SPDR = cData;
/* Wait for transmission complete */
while(!(SPSR & (1<<SPIF)));
}
</syntaxhighlight>

Bei dem Beispiel aus dem Atmega328 Manual fehlt (natürlich) noch ein bisschen was. Fassen wir mal zusammen was zu tun ist.

#Die vier I/Os (MISO, MOSI, SCK, /SS) entsprechend Master-Mode setzen. (siehe Tabelle)
#Die 8 Schalter im SPCR und SPI2X im SPSR setzen.
#Den globalen Interrupt setzen (SEI). Bräuchte man im Master-Mode eigentlich nicht. Ich gehe auf Nummer sicher und lasse eine Interrupt-Routine zur Kontrolle mitlaufen.
#Pollen von WCOL
#Schreiben eines Bytes, evtl. als Unterroutine einer Transferfunktion.

=== Beispiel 1===
{| class="wikitable"
!PinDirection!!Master SPIDirection!!Slave SPI
|-
|MOSI||User defined (Output)||Input
|-
|MISO||Input||User defined (Output)
|-
|SCK||User defined (Output)||Input
|-
|SS||User defined (Output or Input)||Input
|-
|}

Anhand der Tabelle erkennt man, dass man als Nutzer selbst dafür Sorge tragen muss die Richtungen der I/Os richtig zu setzen.

When the SPI is enabled, the data direction of the MOSI, MISO, SCK, and SS pins is overridden according to the table.

<div class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">SPI Master EEPROM</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="c" line>
// Anschluesse kann man so lassen
#define DATAOUT 11//MOSI
#define DATAIN 12//MISO
#define SPICLOCK 13//sck
#define SLAVESELECT 10//ss

// Opcodes muessen angepasst werden
#define MainMemoryPageRead 210 // D2h
// weitere folgen

byte eeprom_output_data;
byte eeprom_input_data=0;
byte clr;
int address=0;

//data buffer auf Pagegroesze setzen
char buffer [264];

// die Buffer Obergrenze anpassen
void fill_buffer(){
for (int i=0;i<buffer.length();i++){
buffer[i]=0;
}
}

char spi_transfer(volatile char data){
SPDR = data; // Start the transmission
while (!(SPSR & (1<<SPIF))) { // Wait the end of the transmission

};
return SPDR; // return the received byte
}

//READ EEPROM
byte read_eeprom(int address){
int data;
digitalWrite(SLAVESELECT,LOW);
spi_transfer(READ); //transmit read opcode
spi_transfer((char)(address>>8)); //send MSByte address first
spi_transfer((char)(address)); //send LSByte address
data = spi_transfer(0xFF); //get data byte
digitalWrite(SLAVESELECT,HIGH); //release chip, signal end transfer
return data;
}

void setup(){
Serial.begin(9600);

pinMode(DATAOUT, OUTPUT);
pinMode(DATAIN, INPUT);
pinMode(SPICLOCK,OUTPUT);
pinMode(SLAVESELECT,OUTPUT);
digitalWrite(SLAVESELECT,HIGH); //disable device
// SPCR = 01010000
//interrupt disabled,spi enabled,msb 1st,master,clk low when idle,
//sample on leading edge of clk,system clock/4 rate (fastest)
SPCR = (1<<SPE)|(1<<MSTR);
clr=SPSR;
clr=SPDR;

delay(10);

//fill buffer with data
fill_buffer();

//fill eeprom w/ buffer
digitalWrite(SLAVESELECT,LOW);

spi_transfer(WREN); //
digitalWrite(SLAVESELECT,HIGH);

delay(10);

digitalWrite(SLAVESELECT,LOW);
spi_transfer(WRITE); //write instruction
address=0;
spi_transfer((char)(address>>8)); //send MSByte address first
spi_transfer((char)(address)); //send LSByte address
//write 128 bytes
for (int i=0;i<128;i++){
spi_transfer(buffer[i]); //write data byte
}

digitalWrite(SLAVESELECT,HIGH); //release chip
//wait for eeprom to finish writing

delay(3000);

Serial.print('h',BYTE);
Serial.print('i',BYTE);
Serial.print('\n',BYTE);//debug
delay(1000);
}

void loop(){
eeprom_output_data = read_eeprom(address);
Serial.print(eeprom_output_data,DEC);
Serial.print('\n',BYTE);
address++;
if (address == 264)
address = 0;
delay(500); //pause for readability
}
</syntaxhighlight>
</div></div>

<hr>

===Beispiel 2===
Für meinen Test habe ich es mir etwas einfacher gemacht und die SPI-Library benutzt. Ich habe soweit alles kommentiert.
Die nächsten Erweiterungen wären vielleicht:
#Weitere Opcodes
#Tastencodes interpretieren und daraus den Index auf das Opcode-Array bestimmen
#define DEBUG
#erweitern des Opcode-Arrays, nicht nur Transferlänge, sondern "richtige" Aufteilung Opcode,<Adresse>,Antwort ->Gesamttransferlaenge daraus berechnen
#Buffer an Gesamtlaenge anpassen
#Interpretieren des Status und Ausgabe in Klartext
#Aufforderung zur Eingabe
#Hilfetext beim Start im Terminal
#Begrenzen der Ausgabe auf die Nutzbytes
#...

<div class="toccolours mw-collapsible mw-collapsed" style="width:1000px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">SPI Master EEPROM</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="c" line>
#include <Arduino.h>

#include<SPI.h> //Library fuer SPI

#define MAXCOMBYTES 10

//AT45DB081D Standard parts are shipped with the page size set to 264-bytes. The user is able to configure these parts to a 256-byte page size if desired
unsigned char opcodes[][2]={
{215,2}, // D7 Status Register Read
{159,4} // 9F Manufacturer and Device Read
};
unsigned char serialBuffer[MAXCOMBYTES];

byte index=0;

const int slaveSelectPin = 10; // /SS bzw /CS ist an PIN 10 (PB2) angeschlossen

void setup (void){
Serial.begin(115200); // Serielle Kommunikation vorbereiten
Serial.println("Master to EEPROM"); // schon mal was ausgeben, dass man sieht das es lebt

SPI.begin(); // SPI Kommunikation vorbereiten
SPI.setClockDivider(SPI_CLOCK_DIV8); // Da das EEPROM bis 66 MHz verträgt kann man hier nix falsch machen (16/8=2Mhz)
pinMode(slaveSelectPin,OUTPUT); // ist nicht notwendig wird in SPI.begin erledigt
digitalWrite(slaveSelectPin,HIGH); // den SPI Slave "abschalten"
}

void loop(void){
byte j; //Laufvariable keine weitere Bedeutung
//char *hexbyte="abcdefghij"; // in C++ nicht erlaubt
char outstr[5]; // outstr als pointer auf einen string nach dem Muster '0X## '
byte serialIncomingByte = 0; // zum Einlesen der Tastatureingaben ueber die serielle Schnittstelle
byte transferlength = 0; // Gesamtlaenge der Uebertragung OpCode+<Adresse>+Antwort

if (Serial.available() > 0) { // nur reagieren wenn eine Taste im seriellen Terminal gedrueckt wurde
serialIncomingByte = Serial.read(); // einlesen der Taste, derzeit nur 1 und 2 erlaubt
sprintf(outstr,"%d ",serialIncomingByte);
Serial.println(outstr);

for (index=0;index<MAXCOMBYTES;index++){
serialBuffer[index]='\0';
}

if (serialIncomingByte==49){ // Taste 1 gedrueckt
serialBuffer[0]=opcodes[0][0];
transferlength=opcodes[0][1];
}
if (serialIncomingByte==50){ // Taste 2 gedrueckt
serialBuffer[0]=opcodes[1][0];
transferlength=opcodes[1][1];
}
Serial.print("Gesendet: ");
for(j=0;j<MAXCOMBYTES;j++){
sprintf(outstr,"0x%02X ",serialBuffer[j]);
Serial.print(outstr);
}
Serial.println();
digitalWrite(slaveSelectPin,LOW);
SPI.transfer(serialBuffer,transferlength);
digitalWrite(slaveSelectPin,HIGH);

Serial.print("Empfangen: ");
for(j=0;j<MAXCOMBYTES;j++){
sprintf(outstr,"0x%02X ",serialBuffer[j]);
Serial.print(outstr);
}
Serial.println();

}

}
</syntaxhighlight>
</div></div>

Ausgabe nach betätigen der Tasten 2 und 1:
Gesendet: 0x9F 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
Empfangen: 0x9F 0x1F 0x25 0x00 0x00 0x00 0x00 0x00 0x00 0x00
Gesendet: 0xD7 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
Empfangen: 0xD7 0xA4 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00

[[Datei:Screenshot PulseView SPI EEPROM 1.png|x100px]]
[[Datei:Screenshot PulseView SPI EEPROM 2.png|x100px]]

Aus der Statusmeldung kann man ablesen, dass das EEPROM im 264-Byte-PageSize-Modus (Bit 0 = 0) arbeitet. Das erklärt vielleicht auch warum in den Beispielen von .org die 8 Byte zu Beginn jeder Page fehlen, wenn das verwendete EEPROM im 256-Byte Modus gearbeitet hat. Ob die Steuerung, dieses ausliest und darauf regiert muss ich noch feststellen. (Bug or Feature?)

==Arduino als SPI-Slave==

In SPI slave mode, the control logic will sample the incoming signal of the SCK pin. To ensure correct sampling of the clock signal, the minimum low and high periods should be:Low periods: Longer than 2 CPU clock cycles.High periods: Longer than 2 CPU clock cycles.

Diese Aussage macht mir noch etwas Sorgen. Ich habe die Taktrate am SCK noch nicht an der Steuerung nachgemessen. Der eingesetzte AT45DB081D verträgt Frequenzen bis 66 MHz. Damit wäre der Atmega völlig überfordert. Allerdings bezieht sich diese Angabe auf lesenden Zugriff. Im SPI-Slave-Betrieb will ich ja die schreibenden Zugriffe der Steuerung entgegnehmen. Will ich mal hoffen, dass die Steuerung es eher gemächlich mag. Dass es bei hobbyelektronik.org scheinbar mit einem ATmega328 geklappt hat, lässt hoffen.

Wie weiter oben bereits erwähnt. Habe ich nachgemessen und den Takt der Steuerung mit 200 kHz festgestellt. Also ist die Geschwindigkeit des Arduino völlig ausreichend. Man könnte sogar auf die SPI-Schnittstelle verzichten.

===Sniffing-Mode===

====1. Versuch====

Bei diesem Versuch erzeugt sich der Mikrocontroller sein SlaveSelect selbst. Der SS (PIN10) wird auf einen anderen Output-Pin verbunden, der vom Programm nach bestimmen Kriterien geschaltet wird.

Programmablauf:
*warte auf eine Lücke (SCK low), die länger als 88 ms (< 146 ms) dauert.
*setzte den Pseudo-SS auf low.
*lese SPI
*Endlosschleife

Das Warten auf die Lücke kann man sich vermutlich sogar ganz sparen. Da die Bytesequenz 'AA 55 55 AA' einen Datensatz ankündigt kann man man ein SPI-Dauerlesen einrichten und warten bis die Startsequenz "vorbeikommt" und alle nachfolgenden Bytes in den Puffer schreiben. Ein Lücke, die dann länger als 10 ms ist gibt den Trigger zur Verarbeitung. Sollten die 10 ms zur Verarbeitung nicht ausreichen könnte man den EEPROM-SS als Trigger nehmen. Wenn also EEPROM-SS kommt, SPI anhalten und die Verarbeitung starten. Dann hätte man 88 ms zur Verarbeitung, das sollte für den ersten Versuch reichen.

=====Verdeutlichung=====

Der ATmega soll als Interface zwischen dem SPI-Port der SunGoSXL und einer seriellen Verbindung (auch über SER2USB-Adapter an USB) eines Auswerte-Systems (Raspi, PC, ...) dienen.
Dazu sind im Wesentlichen 2 Programmroutinen notwendig. Eine Sniffer-Routine, die die SPI-Daten aufnimmt und in einem Puffer ablegt und eine zweite Routine die regelmäßig (Sekundentakt?) die Pufferdaten über die serielle Schnittstelle weiterreicht. Die Aufnahme und Abgabe sind leicht zu implementieren, das passende Timing ist eine Herausforderung. Da ich keine Lust habe, das ganze in Assembler zu schreiben, da hätte ich ja die volle Kontrolle über die Timer und Interruptabläufe, wollte ich doch bei C bleiben. Das Problem sei kurz geschildert. Sobald man mehr als eine Library benutzt hat man kaum noch eine Kontrolle über die Nutzung der Hardwareresourcen eines Mikrocontrollers. Vorausgesetzt, die Libraries sind sauber implementiert wird aber durch das harmonische Nebeneinander automatisch eine Programm-Overhead (oft über 80%) erzeugt, der Echtzeitanwendungen das Leben schwer macht. Ein Methode, die ich schon praktiziert habe ist, den Code per C zu erzeugen und dann den daraus gewonnen Assembler-Code zu bereinigen. Das erspart das mühsame Assembler from the scratch.

Also was ist zu tun?

Grob gesagt haben wir im Sekundentakt (bietet sich durch das EEPROM-CS an) insgesamt x Pakete einzulesen, in den Puffer zu schreiben und seriell auszugeben.

[[Datei:Sungo Gesamtpakete Timing.png|800px]]

[[Datei:Sungo Gesamtpakete Tabelle.png|500px]]

===Emulator-Mode===

Diese Version verfogle ich erst weiter, sobald der Sniffing-Mode kein befriedigendes Ergebnis liefert.

==Request for Comments==

<comments />

==Quellen==

https://github.com/chris-heo/pirozeda

Socat & Co.

2026-07-31T15:53:22Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

Erfahrungen mit socat, nc (netcat) und ser2net. Motivation fuer diese Zusammenstellung war die Notwendigkeit Sensoren, bzw. Devices (TUL (EIB/KNX), Buderus Logamatic, Schmidt Holzofensteuerung, Wagner Sungo Solarthermie, ELV Wetterstation, Hörmann SupraMatic Garagentorantrieb, Tuercommander (Eigenbau), ELV Keymatic, Abus, und, und, und) an FHEM anzuschlieszen. Die Kabelage im Haus hatte ueberhand genommen und da meine CISCO-Switches noch einige Ports frei hatten waren schnell ein paar Atoms, PIs und Arduinos angschlossen. Um jetzt aber die Peripherie der Satelliten an FHEM anzuheften mussten die meist seriellen Adapter irgendwie dem Server mit FHEM zugänglich gemacht werden. Die o.g. drei Programme erfüllen bisher genau meine Vorstellungen. Leider konnte fhem2fhem mich nicht überzeugen. Die Baustelle FHEM auf dem zentralen Hausserver ist nach wie vor groß genug;-)

Die Inbetriebnahme der socat/nc/ser2net-Scripte dauerte nur einen Tag. Probleme macht noch die Stabilitaet. Der Stresstest für das (Gesamt-)System ist auch noch nicht ausgearbeitet.

Derzeitiger Einsatz von Socat und nc (netcat):
Auf meinen Server läuft fhem. Fhem auf dem Interfacerechner oder Fritzbox oder Raspi oder .. laufen zu lassen ist für mich keine Option. Es sprechen einige Dinge wie Performance, zentrale Datenhaltung, Administrationaufwand dagegen.
Auf dem Interface-Rechner [[FHEM-GW|fhem-gw (IP 192.168.178.XX)]] laufen derzeit 3 Interfaces + die Tuerklingel. Die 3 Interfaces werden über nc dem Server übergeben. Auf dem IPC läuft nc im Server-Modus auf Port 3333. (nc -lk 3333 & oder nc -lk 3333 | /bin/bash &)
So ist es dann möglich die Klingel von jedem Rechner aus dem Netzwerk mit folgendem Kommando zu starten:
/usr/bin/netcat 192.168.178.12 3333 < /opt/fhem_resources/tuerklingel.cmd >result.txt.
In tuerklingel.cmd steht aplay /fhem_resources/Assembly.wav. Da alles was in tuerklingel.cmd steht in der bash auf dem IPC ausgeführt wird, besteht hier natuerlich ein Sicherheitsrisiko, welches noch Beachtung finden sollte.

Zum Weiterreichen der 3 Interfaces wird ser2net benutzt: Auf Port 2001 in die Buderus Logamatic angebunden, 2002 der TPUART für den EIB, auf 2003 der CUL für die 868 MHz Kommunikation und auf 2004 ein FH1000PC ebenfalls für 868 MHz Kommunikation. Das FHZ1000PC-Funkinterface wird eigentlich nicht mehr benötigt. Werde ich wohl demnächst mal auf 433MHz umbauen um vielleicht die Schaltsteckdosen zu bedienen.
Die Konfigurationsdatei ist /etc/ser2net.conf.

Jedes Kapitel beginnt jeweils mit der Eroerterung der Manpage. Im Anschluss folgen meine eigenen ausdokumentierten Konfigurationsdateien als Beispiele.

Was ich mal noch probieren muss:

- PuTTY starten (IP, Port bzw. raw als Verbindung angeben)
- auf der seriellen Schnittstelle ein beliebiges Terminalprogramm starten

=Links=
[https://tibbo.com/ Tibbo]

[http://www.dihav.com/view.php?id=serialterminal]

[http://com0com.sourceforge.net/]

== socat ==

Was sagt die Man-Page (man socat der Version 1.7.3.1):

=== NAME ===
socat - Multipurpose relay (SOcket CAT)

Also auf deutsch ein "Vielzweck-Relais", oder besser vielleicht eine Allzweck-Übermittlungsstation.
Der Sinn erschließt sich im Deutschen aus der Beschreibung allerdings immer noch nicht vollständig.

Socat ist ein Portmanteau (Kontamination) aus SOcket und CAT.
Die beiden Ursprungsworte sind dem geübten Unixer wohl bekannt.
Hier eine (Wiki-)Kurzdefinition.

[https://de.wikipedia.org/wiki/Socket_(Software) Socket] Ein Socket (von engl. Sockel, Steckverbindung oder Steckdose) ist ein vom Betriebssystem bereitgestelltes Objekt, das als Kommunikationsendpunkt dient. Ein Programm verwendet Sockets, um Daten mit anderen Programmen auszutauschen. Das andere Programm kann sich dabei auf demselben Computer (Interprozesskommunikation) oder einem anderen, via Netzwerk erreichbaren Computer befinden. Die Kommunikation über Sockets erfolgt in der Regel bidirektional, das heißt, über das Socket können Daten sowohl empfangen als auch gesendet werden.

[http://www.linfo.org/cat.html cat] cat ist einer der am meisten genutzten Befehle auf Unix-ähnlichen Betriebssystemen. Er hat im Wesentlichen drei Aufgaben in Bezug zu Textdateien: sie anzuzeigen, sie zu kombinieren oder neue zu erzeugen.

Betrachtet man sich nun die socat-Syntax entwickelt man langsam eine Vorstellung wozu socat dienlich sein kann.

=== SYNOPSIS ===
(Zusammenfassung)

socat [options] <address> <address>
socat -V
socat -h[h[h]] | -?[?[?]]
filan
procan

Abgesehen von der Tatsache, dass in der ersten der fünf Zeilen das Wichtigste zum richtigen Gebrauch beschrieben steht, erkennt man, dass zu dem socat-Softwarepaket noch zwei weitere Programme, filan und procan, gehören.
Auf diese wird weiter unten noch eingegangen.

Das linuxUSER-Magazin beschreibt socat in der Ausgabe 04.2014 wie folgt:
Socket Cat oder kurz Socat ermöglicht das Einrichten bidirektionaler Verbindungen zwischen zwei Systemen. Dabei reicht das Spektrum von der einfachen Datenübertragung bis hin zum Streamen großer Datenmengen. So eignet sich das Tool beispielsweise für schlichte TCP-Weiterleitungen ebenso wie als Relaying-Lösung zwischen IPv6 und IPv4. Auch als SSL-Wrapper auf Server- oder Client-Seite kommt Socat infrage, wenn der umzuleitende Dienst nicht SSL-fähigist. In Kombination mit Chroot lassen sich so sichere Umgebungen gestalten. Sowohl die umfangreiche Manpage als auch die Webseite des Projekts bieten dafür inspirierende Beispiele.

Der Verbindungsaufbauerfolgt bei Socat in vier Stufen, beginnend mit dem Auswertender übergebenen Kommandozeilenparameter. Es folgt der Verbindungsaufbau,dessen erfolgreichen Abschluss Socat abwartet. Dann fährt es mit der Verarbeitung fort. Steht die Verbindung, lassen sich Daten in beide Richtungen übertragen.Sobald eines der Systeme ein EOFSignal sendet, baut Socat die Verbindung ab. Die gesamte Konfiguration erfolgt über Parameter,eine Konfigurationsdatei kennt das Tool nicht.Da es neben den Verbindungsoptionen zahlreiche weitere Einstellungen unterstützt,wie etwa Blockgröße,Timeout oder Debugging,empfiehlt es sich, Socat via Skript aufzurufen.

Ab der Reihe nach.

=== DESCRIPTION ===
(noch ins Deutsche zu übersetzen)

'''Socat''' is a command line based utility that establishes two bidirectional byte streams and transfers data between them. Because the streams can
be constructed from a large set of different types of data sinks and sources (see address types), and because lots of address options may be
applied to the streams, socat can be used for many different purposes.

'''Filan''' is a utility that prints information about its active file descriptors to stdout. It has been written for debugging socat, but might be
useful for other purposes too. Use the -h option to find more infos.

'''Procan''' is a utility that prints information about process parameters to stdout. It has been written to better understand some UNIX process prop-
erties and for debugging socat, but might be useful for other purposes too.

The '''life cycle''' of a socat instance typically consists of four phases:

- In the '''init phase''', the command line options are parsed and logging is initialized.
- During the '''open phase''', socat opens the first address and afterwards the second address. These steps are usually blocking; thus, especially for
complex address types like socks, connection requests or authentication dialogs must be completed before the next step is started.
- In the '''transfer phase''', socat watches both streams’ read and write file descriptors via select() , and, when data is available on one side and
can be written to the other side, socat reads it, performs newline character conversions if required, and writes the data to the write file
descriptor of the other stream, then continues waiting for more data in both directions.
- When one of the streams effectively reaches EOF, the '''closing phase''' begins. Socat transfers the EOF condition to the other stream, i.e. tries to
shutdown only its write stream, giving it a chance to terminate gracefully. For a defined time socat continues to transfer data in the other
direction, but then closes all remaining channels and terminates.

=== OPTIONS ===

Die Nennung der (speziellen) Optionen -V, -h[h[h]] und -?[?[?]] (s.o.) ist nur dadurch begründet, dass diese ohne die oblogatorischen Adressbezeichner auskommen.
Kleiner Hinweis am Rande: Angaben in [] sind optional also wahlfrei/nicht zwingend und Angaben in <> sind obligatorisch also verpflichtend/zwingend.
Leider konnte ich keine entsprechende Erläuterung auf der [https://de.wikipedia.org/wiki/Manpage Wiki-Seite] finden.

Socat provides some command line options that modify the behaviour of
the program. They have nothing to do with so called address options
that are used as parts of address specifications.

Socat stellt einige (24) Kommandozeilenoptionen bereit, die das Verhalten des Programms beeinflussen.
Diese haben nichts mit den (sogenannten) Adressoptionen zu tun, die weiter unten bei den Adressangaben erläutert werden.
Aus Gründen der besseren Übersicht sind Mehrfachnennungen der Optionen -h oder -? und -d jeweils in einer Zeile zusammengefasst.

{| class="wikitable"
|-
! Nr !! Option !! Originaltext !! Übersetzung/Erläuterung Beispiele zu jeder Option finden sich im Anschluss an die Tabelle
|-
| 1 || '''-V''' || Print version and available feature information to stdout, and exit. || Gibt die Versionsnummer und eine Übersicht über die (einkompilierten) Möglichkeiten auf die Standardausgabe (idR der Bildschirm) aus und endet.
|-
| 2 || '''-h[h[h]] bzw. -?[?[?]]''' || Print a help text to stdout describing command line options and available address types, and exit. (2x) Like −h, plus a list of the short names of all available address options. Some options are platform dependend, so this output is helpful for checking the particular implementation. (3x) Like −hh, plus a list of all available address option names. || Gibt den Hilfetext des Programms aus. Das Mehrfachnenen der Option erweiter den Hilfetext noch um mögliche Kurznamen und mögliche Adressoptionen.
|-
| 3 || '''-d[d[d[d]]]''' || Without this option, only fatal and error messages are generated; applying this option also prints warning messages. See DIAGNOSTICS for more information. (2x) Prints fatal, error, warning, and notice messages. (3x) Prints fatal, error, warning, notice, and info messages. (4x) Prints fatal, error, warning, notice, info, and debug messages. ||
|-
| 4 || '''-D''' || Logs information about file descriptors before starting the transfer phase. ||
|-
| 5 || '''−ly[<facility>'''] || Writes messages to syslog instead of stderr; severity as defined with −d option. With optional <facility>, the syslog type can be selected, default is "daemon". Third party libraries might not obey this option. ||
|-
| 6 || '''−lf <logfile>''' || Writes messages to <logfile> [filename] instead of stderr. Some third party libraries, in particular libwrap, might not obey this option. ||
|-
| 7 || '''-ls''' || Writes messages to stderr (this is the default). Some third party libraries might not obey this option, in particular libwrap appears to only log to syslog. ||
|-
| 8 || '''−lp<progname>''' || Overrides the program name printed in error messages and used for constructing environment variable names. ||
|-
| 9 || '''-lu''' || Extends the timestamp of error messages to microsecond resolution. Does not work when logging to syslog. ||
|-
| 10|| '''−lm[<facility>]''' || Mixed log mode. During startup messages are printed to stderr; when socat starts the transfer phase loop or daemon mode (i.e. after opening all streams and before starting data transfer, or, with listening sockets with fork option, before the first accept call), it switches logging to syslog. With optional <facility>, the syslog type can be selected, default is "daemon". ||
|-
| 11 || '''−lh''' || Adds hostname to log messages. Uses the value from environment variable HOSTNAME or the value retrieved with uname() if HOSTNAME is not set. ||
|-
| 12 || '''−v''' || Writes the transferred data not only to their target streams, but also to stderr. The output format is text with some conversions for readability, and prefixed with "> " or "< " indicating flow directions. ||
|-
| 13 || '''-x''' || Writes the transferred data not only to their target streams, but also to stderr. The output format is hexadecimal, prefixed with "> " or "< " indicating flow directions. Can be combined with −v . ||
|-
| 14 || '''−b<size>''' || Sets the data transfer block <size> [size_t]. At most <size> bytes are transferred per step. Default is 8192 bytes. ||
|-
| 15 || '''-s''' || By default, socat terminates when an error occurred to prevent the process from running when some option could not be applied. With this option, socat is sloppy with errors and tries to continue. Even with this option, socat will exit on fatals, and will abort connection attempts when security checks failed. ||
|-
| 16 || '''−t<timeout>''' || When one channel has reached EOF, the write part of the other channel is shut down. Then, socat waits <timeout> [timeval] seconds before terminating. Default is 0.5 seconds. This timeout only applies to addresses where write and read part can be closed independently. When during the timeout interval the read part gives EOF, socat terminates without awaiting the timeout. ||
|-
| 17 || '''−T<timeout>''' || Total inactivity timeout: when socat is already in the transfer loop and nothing has happened for <timeout> [timeval] seconds (no data arrived, no interrupt occurred...) then it terminates. Useful with protocols like UDP that cannot transfer EOF.
|-
| 18 || '''-u''' || Uses unidirectional mode. The first address is only used for reading, and the second address is only used for writing (example). ||
|-
| 19 || '''-U''' || Uses unidirectional mode in reverse direction. The first address is only used for writing, and the second address is only used for reading. ||
|-
| 20 || '''-g''' || During address option parsing, don’t check if the option is considered useful in the given address environment. Use it if you want to force, e.g., appliance of a socket option to a serial device. ||
|-
| 21 || '''−L<lockfile>''' || If lockfile exists, exits with error. If lockfile does not exist, creates it and continues, unlinks lockfile on exit. ||
|-
| 22 || '''−W<lockfile>''' || If lockfile exists, waits until it disappears. When lockfile does not exist, creates it and continues, unlinks lockfile on exit. ||
|-
| 23 || '''−4''' || Use IP version 4 in case that the addresses do not implicitly or explicitly specify a version; this is the default. ||
|-
| 24 || '''−6''' || Use IP version 6 in case that the addresses do not implicitly or explicitly specify a version. ||
|}

=== ADDRESS SPECIFICATIONS ===

With the address command line arguments, the user gives socat
instructions and the necessary information for establishing the byte
streams.

An address specification usually consists of an address type keyword,
zero or more required address parameters separated by ’:’ from the
keyword and from each other, and zero or more address options separated
by ’,’.

The keyword specifies the address type (e.g., TCP4, OPEN, EXEC). For
some keywords there exist synonyms (’−’ for STDIO, TCP for TCP4).
Keywords are case insensitive. For a few special address types, the
keyword may be omitted: Address specifications starting with a number
are assumed to be FD (raw file descriptor) addresses; if a ’/’ is found
before the first ’:’ or ’,’, GOPEN (generic file open) is assumed.

The required number and type of address parameters depend on the
address type. E.g., TCP4 requires a server specification (name or
address), and a port specification (number or service name).

Zero or more address options may be given with each address. They
influence the address in some ways. Options consist of an option
keyword or an option keyword and a value, separated by ’=’. Option
keywords are case insensitive. For filtering the options that are
useful with an address type, each option is member of one option group.
For each address type there is a set of option groups allowed. Only
options belonging to one of these address groups may be used (except
with option −g).

Address specifications following the above schema are also called
single address specifications. Two single addresses can be combined
with "!!" to form a dual type address for one channel. Here, the first
address is used by socat for reading data, and the second address for
writing data. There is no way to specify an option only once for being
applied to both single addresses.

Usually, addresses are opened in read/write mode. When an address is
part of a dual address specification, or when option −u or −U is used,
an address might be used only for reading or for writing. Considering
this is important with some address types.

With socat version 1.5.0 and higher, the lexical analysis tries to
handle quotes and parenthesis meaningfully and allows escaping of
special characters. If one of the characters ( { [ ’ is found, the
corresponding closing character − ) } ] ’ − is looked for; they may
also be nested. Within these constructs, socats special characters and
strings : , !! are not handled specially. All those characters and
strings can be escaped with \ or within ""

=== ADDRESS TYPES ===

This section describes the available address types with their keywords,
parameters, and semantics.
CREATE:<filename>

Opens <filename> with creat() and uses the file descriptor for writing.
This address type requires write−only context, because a file opened
with creat cannot be read from.
Flags like O_LARGEFILE cannot be applied. If you need them use OPEN
with options create,create.
<filename> must be a valid existing or not existing path. If <filename>
is a named pipe, creat() might block; if <filename> refers to a socket,
this is an error.
Option groups: FD,REG,NAMED
Useful options: mode, user, group, unlink−early, unlink−late, append
See also: OPEN, GOPEN

EXEC:<command−line>

Forks a sub process that establishes communication with its parent
process and invokes the specified program with execvp() .
<command−line> is a simple command with arguments separated by single
spaces. If the program name contains a ’/’, the part after the last ’/’
is taken as ARGV[0]. If the program name is a relative path, the
execvp() semantics for finding the program via $PATH apply. After
successful program start, socat writes data to stdin of the process and
reads from its stdout using a UNIX domain socket generated by
socketpair() per default. (example)
Option groups: FD,SOCKET,EXEC,FORK,TERMIOS
Useful options: path, fdin, fdout, chroot, su, su−d, nofork, pty,
stderr, ctty, setsid, pipes, login, sigint, sigquit
See also: SYSTEM

FD:<fdnum>

Uses the file descriptor <fdnum>. It must already exist as valid UN*X
file descriptor.
Option groups: FD (TERMIOS,REG,SOCKET)
See also: STDIO, STDIN, STDOUT, STDERR

GOPEN:<filename>

(Generic open) This address type tries to handle any file system entry
except directories usefully. <filename> may be a relative or absolute
path. If it already exists, its type is checked. In case of a UNIX
domain socket, socat connects; if connecting fails, socat assumes a
datagram socket and uses sendto() calls. If the entry is not a socket,
socat opens it applying the O_APPEND flag. If it does not exist, it is
opened with flag O_CREAT as a regular file (example).
Option groups: FD,REG,SOCKET,NAMED,OPEN
See also: OPEN, CREATE, UNIX−CONNECT

IP−SENDTO:<host>:<protocol>

Opens a raw IP socket. Depending on host specification or option pf, IP
protocol version 4 or 6 is used. It uses <protocol> to send packets to
<host> [IP address] and receives packets from host, ignores packets
from other hosts. Protocol 255 uses the raw socket with the IP header
being part of the data.
Option groups: FD,SOCKET,IP4,IP6
Useful options: pf, ttl
See also: IP4−SENDTO, IP6−SENDTO, IP−RECVFROM, IP−RECV, UDP−SENDTO,
UNIX−SENDTO

INTERFACE:<interface>

Communicates with a network connected on an interface using raw packets
including link level data. <interface> is the name of the network
interface. Currently only available on Linux. Option groups: FD,SOCKET
Useful options: pf, type
See also: ip−recv

IP4−SENDTO:<host>:<protocol>

Like IP−SENDTO, but always uses IPv4.
Option groups: FD,SOCKET,IP4

IP6−SENDTO:<host>:<protocol>

Like IP−SENDTO, but always uses IPv6.
Option groups: FD,SOCKET,IP6

IP−DATAGRAM:<address>:<protocol>

Sends outgoing data to the specified address which may in particular be
a broadcast or multicast address. Packets arriving on the local socket
are checked if their source addresses match RANGE or TCPWRAP options.
This address type can for example be used for implementing symmetric or
asymmetric broadcast or multicast communications.
Option groups: FD, SOCKET, IP4, IP6, RANGE
Useful options: bind, range, tcpwrap, broadcast, ip−multicast−loop,
ip−multicast−ttl, ip−multicast−if, ip−add−membership, ttl, tos, pf
See also: IP4−DATAGRAM, IP6−DATAGRAM, IP−SENDTO, IP−RECVFROM, IP−RECV,
UDP−DATAGRAM

IP4−DATAGRAM:<host>:<protocol>

Like IP−DATAGRAM, but always uses IPv4. (example)
Option groups: FD,SOCKET,IP4,RANGE

IP6−DATAGRAM:<host>:<protocol>

Like IP−DATAGRAM, but always uses IPv6. Please note that IPv6 does not
know broadcasts.
Option groups: FD,SOCKET,IP6,RANGE

IP−RECVFROM:<protocol>

Opens a raw IP socket of <protocol>. Depending on option pf, IP
protocol version 4 or 6 is used. It receives one packet from an
unspecified peer and may send one or more answer packets to that peer.
This mode is particularly useful with fork option where each arriving
packet − from arbitrary peers − is handled by its own sub process. This
allows a behaviour similar to typical UDP based servers like ntpd or
named.
Please note that the reply packets might be fetched as incoming traffic
when sender and receiver IP address are identical because there is no
port number to distinguish the sockets.
This address works well with IP−SENDTO address peers (see above).
Protocol 255 uses the raw socket with the IP header being part of the
data.
Option groups: FD,SOCKET,IP4,IP6,CHILD,RANGE
Useful options: pf, fork, range, ttl, broadcast
See also: IP4−RECVFROM, IP6−RECVFROM, IP−SENDTO, IP−RECV, UDP−RECVFROM,
UNIX−RECVFROM

IP4−RECVFROM:<protocol>

Like IP−RECVFROM, but always uses IPv4.
Option groups: FD,SOCKET,IP4,CHILD,RANGE

IP6−RECVFROM:<protocol>

Like IP−RECVFROM, but always uses IPv6.
Option groups: FD,SOCKET,IP6,CHILD,RANGE

IP−RECV:<protocol>

Opens a raw IP socket of <protocol>. Depending on option pf, IP
protocol version 4 or 6 is used. It receives packets from multiple
unspecified peers and merges the data. No replies are possible. It can
be, e.g., addressed by socat IP−SENDTO address peers. Protocol 255 uses
the raw socket with the IP header being part of the data.
Option groups: FD,SOCKET,IP4,IP6,RANGE
Useful options: pf, range
See also: IP4−RECV, IP6−RECV, IP−SENDTO, IP−RECVFROM, UDP−RECV,
UNIX−RECV

IP4−RECV:<protocol>

Like IP−RECV, but always uses IPv4.
Option groups: FD,SOCKET,IP4,RANGE

IP6−RECV:<protocol>

Like IP−RECV, but always uses IPv6.
Option groups: FD,SOCKET,IP6,RANGE

OPEN:<filename>

Opens <filename> using the open() system call (example). This operation
fails on UNIX domain sockets.
Note: This address type is rarly useful in bidirectional mode.
Option groups: FD,REG,NAMED,OPEN
Useful options: creat, excl, noatime, nofollow, append, rdonly, wronly,
lock, readbytes, ignoreeof
See also: CREATE, GOPEN, UNIX−CONNECT

OPENSSL:<host>:<port>

Tries to establish a SSL connection to <port> [TCP service] on <host>
[IP address] using TCP/IP version 4 or 6 depending on address
specification, name resolution, or option pf.
NOTE: Up to version 1.7.2.4 the server certificate was only checked for
validity against the system certificate store or cafile or capath, but
not for match with the server’s name or its IP address. Since version
1.7.3.0 socat checks the peer certificate for match with the <host>
parameter or the value of the openssl−commonname option. Socat tries to
match it against the certificates subject commonName, and the
certifications extension subjectAltName DNS names. Wildcards in the
certificate are supported.
Option groups: FD,SOCKET,IP4,IP6,TCP,OPENSSL,RETRY
Useful options: cipher, method, verify, commonname cafile, capath,
certificate, key, compress, bind, pf, connect−timeout, sourceport,
retry
See also: OPENSSL−LISTEN, TCP

OPENSSL−LISTEN:<port>

Listens on tcp <port> [TCP service]. The IP version is 4 or the one
specified with pf. When a connection is accepted, this address behaves
as SSL server.
Note: You probably want to use the certificate option with this
address.
NOTE: The client certificate is only checked for validity against
cafile or capath, but not for match with the client’s name or its IP
address!
Option groups: FD,SOCKET,IP4,IP6,TCP,LISTEN,OPENSSL,CHILD,RANGE,RETRY
Useful options: pf, cipher, method, verify, commonname cafile, capath,
certificate, key, compress, fork, bind, range, tcpwrap, su, reuseaddr,
retry
See also: OPENSSL, TCP−LISTEN

PIPE:<filename>

If <filename> already exists, it is opened. If it does not exist, a
named pipe is created and opened. Beginning with socat version 1.4.3,
the named pipe is removed when the address is closed (but see option
unlink−close
Note: When a pipe is used for both reading and writing, it works as
echo service.
Note: When a pipe is used for both reading and writing, and socat tries
to write more bytes than the pipe can buffer (Linux 2.4: 2048 bytes),
socat might block. Consider using socat option, e.g., −b 2048
Option groups: FD,NAMED,OPEN
Useful options: rdonly, nonblock, group, user, mode, unlink−early
See also: unnamed pipe

PIPE

Creates an unnamed pipe and uses it for reading and writing. It works
as an echo, because everything written to it appeares immediately as
read data.

Note: When socat tries to write more bytes than the pipe can queue
(Linux 2.4: 2048 bytes), socat might block. Consider, e.g., using
option −b 2048
Option groups: FD
See also: named pipe

PROXY:<proxy>:<hostname>:<port>

Connects to an HTTP proxy server on port 8080 using TCP/IP version 4 or
6 depending on address specification, name resolution, or option pf,
and sends a CONNECT request for hostname:port. If the proxy grants
access and succeeds to connect to the target, data transfer between
socat and the target can start. Note that the traffic need not be HTTP
but can be an arbitrary protocol.
Option groups: FD,SOCKET,IP4,IP6,TCP,HTTP,RETRY
Useful options: proxyport, ignorecr, proxyauth, resolve, crnl, bind,
connect−timeout, mss, sourceport, retry
See also: SOCKS, TCP

PTY

Generates a pseudo terminal (pty) and uses its master side. Another
process may open the pty’s slave side using it like a serial line or
terminal. (example). If both the ptmx and the openpty mechanisms are
available, ptmx is used (POSIX).

Option groups: FD,NAMED,PTY,TERMIOS
Useful options: link, openpty, wait−slave, mode, user, group
See also: UNIX−LISTEN, PIPE, EXEC, SYSTEM

READLINE

Uses GNU readline and history on stdio to allow editing and reusing
input lines (example). This requires the GNU readline and history
libraries. Note that stdio should be a (pseudo) terminal device,
otherwise readline does not seem to work.
Option groups: FD,READLINE,TERMIOS
Useful options: history, noecho
See also: STDIO

SCTP−CONNECT:<host>:<port>

Establishes an SCTP stream connection to the specified <host> [IP
address] and <port> [TCP service] using TCP/IP version 4 or 6 depending
on address specification, name resolution, or option pf.
Option groups: FD,SOCKET,IP4,IP6,SCTP,CHILD,RETRY
Useful options: bind, pf, connect−timeout, tos, mtudiscover,
sctp−maxseg, sctp−nodelay, nonblock, sourceport, retry, readbytes
See also: SCTP4−CONNECT, SCTP6−CONNECT, SCTP−LISTEN, TCP−CONNECT

SCTP4−CONNECT:<host>:<port>

Like SCTP−CONNECT, but only supports IPv4 protocol.
Option groups: FD,SOCKET,IP4,SCTP,CHILD,RETRY

SCTP6−CONNECT:<host>:<port>

Like SCTP−CONNECT, but only supports IPv6 protocol.
Option groups: FD,SOCKET,IP6,SCTP,CHILD,RETRY

SCTP−LISTEN:<port>

Listens on <port> [TCP service] and accepts a TCP/IP connection. The IP
version is 4 or the one specified with address option pf, socat option
(−4, −6), or environment variable SOCAT_DEFAULT_LISTEN_IP. Note that
opening this address usually blocks until a client connects.
Option groups: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,IP6,SCTP,RETRY
Useful options: crnl, fork, bind, range, tcpwrap, pf, max−children,
backlog, sctp−maxseg, sctp−nodelay, su, reuseaddr, retry, cool−write
See also: SCTP4−LISTEN, SCTP6−LISTEN, TCP−LISTEN, SCTP−CONNECT

SCTP4−LISTEN:<port>

Like SCTP−LISTEN, but only supports IPv4 protocol.
Option groups: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,SCTP,RETRY

SCTP6−LISTEN:<port>

Like SCTP−LISTEN, but only supports IPv6 protocol.
Option groups: FD,SOCKET,LISTEN,CHILD,RANGE,IP6,SCTP,RETRY

SOCKET−CONNECT:<domain>:<protocol>:<remote−address>

Creates a stream socket using the first and second given socket
parameters and SOCK_STREAM (see man socket\(2)) and connects to the
remote−address. The two socket parameters have to be specified by int
numbers. Consult your OS documentation and include files to find the
appropriate values. The remote−address must be the data representation
of a sockaddr structure without sa_family and (BSD) sa_len components.
Please note that you can − beyond the options of the specified groups −
also use options of higher level protocols when you apply socat option
−g.
Option groups: FD,SOCKET,CHILD,RETRY
Useful options: bind, setsockopt−int, setsockopt−bin, setsockopt−string
See also: TCP, UDP−CONNECT, UNIX−CONNECT, SOCKET−LISTEN, SOCKET−SENDTO

SOCKET−DATAGRAM:<domain>:<type>:<protocol>:<remote−address>

Creates a datagram socket using the first three given socket parameters
(see man socket\(2)) and sends outgoing data to the remote−address. The
three socket parameters have to be specified by int numbers. Consult
your OS documentation and include files to find the appropriate values.
The remote−address must be the data representation of a sockaddr
structure without sa_family and (BSD) sa_len components.
Please note that you can − beyond the options of the specified groups −
also use options of higher level protocols when you apply socat option
−g.
Option groups: FD,SOCKET,RANGE
Useful options: bind, range, setsockopt−int, setsockopt−bin,
setsockopt−string
See also: UDP−DATAGRAM, IP−DATAGRAM, SOCKET−SENDTO, SOCKET−RECV,
SOCKET−RECVFROM

SOCKET−LISTEN:<domain>:<protocol>:<local−address>

Creates a stream socket using the first and second given socket
parameters and SOCK_STREAM (see man socket\(2)) and waits for incoming
connections on local−address. The two socket parameters have to be
specified by int numbers. Consult your OS documentation and include
files to find the appropriate values. The local−address must be the
data representation of a sockaddr structure without sa_family and (BSD)
sa_len components.
Please note that you can − beyond the options of the specified groups −
also use options of higher level protocols when you apply socat option
−g.
Option groups: FD,SOCKET,LISTEN,RANGE,CHILD,RETRY
Useful options: setsockopt−int, setsockopt−bin, setsockopt−string
See also: TCP, UDP−CONNECT, UNIX−CONNECT, SOCKET−LISTEN, SOCKET−SENDTO,
SOCKET−SENDTO

SOCKET−RECV:<domain>:<type>:<protocol>:<local−address>

Creates a socket using the three given socket parameters (see man
socket\(2)) and binds it to <local−address>. Receives arriving data.
The three parameters have to be specified by int numbers. Consult your
OS documentation and include files to find the appropriate values. The
local−address must be the data representation of a sockaddr structure
without sa_family and (BSD) sa_len components.
Option groups: FD,SOCKET,RANGE
Useful options: range, setsockopt−int, setsockopt−bin,
setsockopt−string
See also: UDP−RECV, IP−RECV, UNIX−RECV, SOCKET−DATAGRAM, SOCKET−SENDTO,
SOCKET−RECVFROM

SOCKET−RECVFROM:<domain>:<type>:<protocol>:<local−address>

Creates a socket using the three given socket parameters (see man
socket\(2)) and binds it to <local−address>. Receives arriving data and
sends replies back to the sender. The first three parameters have to be
specified as int numbers. Consult your OS documentation and include
files to find the appropriate values. The local−address must be the
data representation of a sockaddr structure without sa_family and (BSD)
sa_len components.
Option groups: FD,SOCKET,CHILD,RANGE
Useful options: fork, range, setsockopt−int, setsockopt−bin,
setsockopt−string
See also: UDP−RECVFROM, IP−RECVFROM, UNIX−RECVFROM, SOCKET−DATAGRAM,
SOCKET−SENDTO, SOCKET−RECV

SOCKET−SENDTO:<domain>:<type>:<protocol>:<remote−address>

Creates a socket using the three given socket parameters (see man
socket\(2)). Sends outgoing data to the given address and receives
replies. The three parameters have to be specified as int numbers.
Consult your OS documentation and include files to find the appropriate
values. The remote−address must be the data representation of a
sockaddr structure without sa_family and (BSD) sa_len components.
Option groups: FD,SOCKET
Useful options: bind, setsockopt−int, setsockopt−bin, setsockopt−string
See also: UDP−SENDTO, IP−SENDTO, UNIX−SENDTO, SOCKET−DATAGRAM,
SOCKET−RECV SOCKET−RECVFROM

SOCKS4:<socks−server>:<host>:<port>

Connects via <socks−server> [IP address] to <host> [IPv4 address] on
<port> [TCP service], using socks version 4 protocol over IP version 4
or 6 depending on address specification, name resolution, or option pf
(example).
Option groups: FD,SOCKET,IP4,IP6,TCP,SOCKS4,RETRY
Useful options: socksuser, socksport, sourceport, pf, retry
See also: SOCKS4A, PROXY, TCP

SOCKS4A:<socks−server>:<host>:<port>

like SOCKS4, but uses socks protocol version 4a, thus leaving host name
resolution to the socks server.
Option groups: FD,SOCKET,IP4,IP6,TCP,SOCKS4,RETRY

STDERR

Uses file descriptor 2.

Option groups: FD (TERMIOS,REG,SOCKET)
See also: FD

STDIN

Uses file descriptor 0.

Option groups: FD (TERMIOS,REG,SOCKET)
Useful options: readbytes
See also: FD

STDIO

Uses file descriptor 0 for reading, and 1 for writing.

Option groups: FD (TERMIOS,REG,SOCKET)
Useful options: readbytes
See also: FD

STDOUT

Uses file descriptor 1.

Option groups: FD (TERMIOS,REG,SOCKET)
See also: FD

SYSTEM:<shell−command>

Forks a sub process that establishes communication with its parent
process and invokes the specified program with system() . Please note
that <shell−command> [string] must not contain ’,’ or "!!", and that
shell meta characters may have to be protected. After successful
program start, socat writes data to stdin of the process and reads from
its stdout.
Option groups: FD,SOCKET,EXEC,FORK,TERMIOS
Useful options: path, fdin, fdout, chroot, su, su−d, nofork, pty,
stderr, ctty, setsid, pipes, sigint, sigquit
See also: EXEC

TCP:<host>:<port>

Connects to <port> [TCP service] on <host> [IP address] using TCP/IP
version 4 or 6 depending on address specification, name resolution, or
option pf.
Option groups: FD,SOCKET,IP4,IP6,TCP,RETRY
Useful options: crnl, bind, pf, connect−timeout, tos, mtudiscover, mss,
nodelay, nonblock, sourceport, retry, readbytes
See also: TCP4, TCP6, TCP−LISTEN, UDP, SCTP−CONNECT, UNIX−CONNECT

TCP4:<host>:<port>

Like TCP, but only supports IPv4 protocol (example).
Option groups: FD,SOCKET,IP4,TCP,RETRY

TCP6:<host>:<port>

Like TCP, but only supports IPv6 protocol.
Option groups: FD,SOCKET,IP6,TCP,RETRY

TCP−LISTEN:<port>

Listens on <port> [TCP service] and accepts a TCP/IP connection. The IP
version is 4 or the one specified with address option pf, socat option
(−4, −6), or environment variable SOCAT_DEFAULT_LISTEN_IP. Note that
opening this address usually blocks until a client connects.
Option groups: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,IP6,TCP,RETRY
Useful options: crnl, fork, bind, range, tcpwrap, pf, max−children,
backlog, mss, su, reuseaddr, retry, cool−write
See also: TCP4−LISTEN, TCP6−LISTEN, UDP−LISTEN, SCTP−LISTEN,
UNIX−LISTEN, OPENSSL−LISTEN, TCP−CONNECT

TCP4−LISTEN:<port>

Like TCP−LISTEN, but only supports IPv4 protocol (example).
Option groups: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,TCP,RETRY

TCP6−LISTEN:<port>

Like TCP−LISTEN, but only supports IPv6 protocol.
Additional useful option: ipv6only
Option groups: FD,SOCKET,LISTEN,CHILD,RANGE,IP6,TCP,RETRY

TUN[:<if−addr>/<bits>]

Creates a Linux TUN/TAP device and optionally assignes it the address
and netmask given by the parameters. The resulting network interface is
almost ready for use by other processes; socat serves its "wire side".
This address requires read and write access to the tunnel cloning
device, usually /dev/net/tun , as well as permission to set some
ioctl()s. Option iff−up is required to immediately activate the
interface!
Option groups: FD,NAMED,OPEN,TUN
Useful options: iff−up, tun−device, tun−name, tun−type, iff−no−pi
See also: ip−recv

UDP:<host>:<port>

Connects to <port> [UDP service] on <host> [IP address] using UDP/IP
version 4 or 6 depending on address specification, name resolution, or
option pf.
Please note that, due to UDP protocol properties, no real connection is
established; data has to be sent for ‘connecting’ to the server, and no
end−of−file condition can be transported.
Option groups: FD,SOCKET,IP4,IP6
Useful options: ttl, tos, bind, sourceport, pf
See also: UDP4, UDP6, UDP−LISTEN, TCP, IP

UDP4:<host>:<port>

Like UDP, but only supports IPv4 protocol.
Option groups: FD,SOCKET,IP4

UDP6:<host>:<port>

Like UDP, but only supports IPv6 protocol.
Option groups: FD,SOCKET,IP6

UDP−DATAGRAM:<address>:<port>

Sends outgoing data to the specified address which may in particular be
a broadcast or multicast address. Packets arriving on the local socket
are checked for the correct remote port and if their source addresses
match RANGE or TCPWRAP options. This address type can for example be
used for implementing symmetric or asymmetric broadcast or multicast
communications.
Option groups: FD,SOCKET,IP4,IP6,RANGE
Useful options: bind, range, tcpwrap, broadcast, ip−multicast−loop,
ip−multicast−ttl, ip−multicast−if, ip−add−membership, ttl, tos,
sourceport, pf
See also: UDP4−DATAGRAM, UDP6−DATAGRAM, UDP−SENDTO, UDP−RECVFROM,
UDP−RECV, UDP−CONNECT, UDP−LISTEN, IP−DATAGRAM

UDP4−DATAGRAM:<address>:<port>

Like UDP−DATAGRAM, but only supports IPv4 protocol (example1,
example2).
Option groups: FD,SOCKET,IP4, RANGE

UDP6−DATAGRAM:<address>:<port>

Like UDP−DATAGRAM, but only supports IPv6 protocol.
Option groups: FD,SOCKET,IP6,RANGE

UDP−LISTEN:<port>

Waits for a UDP/IP packet arriving on <port> [UDP service] and
‘connects’ back to sender. The accepted IP version is 4 or the one
specified with option pf. Please note that, due to UDP protocol
properties, no real connection is established; data has to arrive from
the peer first, and no end−of−file condition can be transported. Note
that opening this address usually blocks until a client connects.
Option groups: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,IP6
Useful options: fork, bind, range, pf
See also: UDP, UDP4−LISTEN, UDP6−LISTEN, TCP−LISTEN

UDP4−LISTEN:<port>

Like UDP−LISTEN, but only support IPv4 protocol.
Option groups: FD,SOCKET,LISTEN,CHILD,RANGE,IP4

UDP6−LISTEN:<port>

Like UDP−LISTEN, but only support IPv6 protocol.
Option groups: FD,SOCKET,LISTEN,CHILD,RANGE,IP6

UDP−SENDTO:<host>:<port>

Communicates with the specified peer socket, defined by <port> [UDP
service] on <host> [IP address], using UDP/IP version 4 or 6 depending
on address specification, name resolution, or option pf. It sends
packets to and receives packets from that peer socket only. This
address effectively implements a datagram client. It works well with
socat UDP−RECVFROM and UDP−RECV address peers.
Option groups: FD,SOCKET,IP4,IP6
Useful options: ttl, tos, bind, sourceport, pf
See also: UDP4−SENDTO, UDP6−SENDTO, UDP−RECVFROM, UDP−RECV,
UDP−CONNECT, UDP−LISTEN, IP−SENDTO

UDP4−SENDTO:<host>:<port>

Like UDP−SENDTO, but only supports IPv4 protocol.
Option groups: FD,SOCKET,IP4

UDP6−SENDTO:<host>:<port>

Like UDP−SENDTO, but only supports IPv6 protocol.
Option groups: FD,SOCKET,IP6

UDP−RECVFROM:<port>

Creates a UDP socket on <port> [UDP service] using UDP/IP version 4 or
6 depending on option pf. It receives one packet from an unspecified
peer and may send one or more answer packets to that peer. This mode is
particularly useful with fork option where each arriving packet − from
arbitrary peers − is handled by its own sub process. This allows a
behaviour similar to typical UDP based servers like ntpd or named. This
address works well with socat UDP−SENDTO address peers.
Option groups: FD,SOCKET,IP4,IP6,CHILD,RANGE
Useful options: fork, ttl, tos, bind, sourceport, pf
See also: UDP4−RECVFROM, UDP6−RECVFROM, UDP−SENDTO, UDP−RECV,
UDP−CONNECT, UDP−LISTEN, IP−RECVFROM, UNIX−RECVFROM

UDP4−RECVFROM:<port>

Like UDP−RECVFROM, but only supports IPv4 protocol.
Option groups: FD,SOCKET,IP4,CHILD,RANGE

UDP6−RECVFROM:<port>

Like UDP−RECVFROM, but only supports IPv6 protocol.
Option groups: FD,SOCKET,IP6,CHILD,RANGE

UDP−RECV:<port>

Creates a UDP socket on <port> [UDP service] using UDP/IP version 4 or
6 depending on option pf. It receives packets from multiple unspecified
peers and merges the data. No replies are possible. It works well with,
e.g., socat UDP−SENDTO address peers; it behaves similar to a syslog
server.
Option groups: FD,SOCKET,IP4,IP6,RANGE
Useful options: fork, pf, bind, sourceport, ttl, tos
See also: UDP4−RECV, UDP6−RECV, UDP−SENDTO, UDP−RECVFROM, UDP−CONNECT,
UDP−LISTEN, IP−RECV, UNIX−RECV

UDP4−RECV:<port>

Like UDP−RECV, but only supports IPv4 protocol.
Option groups: FD,SOCKET,IP4,RANGE

UDP6−RECV:<port>

Like UDP−RECV, but only supports IPv6 protocol.
Option groups: FD,SOCKET,IP6,RANGE

UNIX−CONNECT:<filename>

Connects to <filename> assuming it is a UNIX domain socket. If
<filename> does not exist, this is an error; if <filename> is not a
UNIX domain socket, this is an error; if <filename> is a UNIX domain
socket, but no process is listening, this is an error.
Option groups: FD,SOCKET,NAMED,RETRY,UNIX
) Useful options: bind
See also: UNIX−LISTEN, UNIX−SENDTO, TCP

UNIX−LISTEN:<filename>

Listens on <filename> using a UNIX domain stream socket and accepts a
connection. If <filename> exists and is not a socket, this is an error.
If <filename> exists and is a UNIX domain socket, binding to the
address fails (use option unlink−early!). Note that opening this
address usually blocks until a client connects. Beginning with socat
version 1.4.3, the file system entry is removed when this address is
closed (but see option unlink−close) (example).
Option groups: FD,SOCKET,NAMED,LISTEN,CHILD,RETRY,UNIX
Useful options: fork, umask, mode, user, group, unlink−early
See also: UNIX−CONNECT, UNIX−RECVFROM, UNIX−RECV, TCP−LISTEN

UNIX−SENDTO:<filename>

Communicates with the specified peer socket, defined by [<filename>]
assuming it is a UNIX domain datagram socket. It sends packets to and
receives packets from that peer socket only. Please note that it might
be neccessary to bind the local socket to an address (e.g. /tmp/sock1,
which must not exist before). This address type works well with socat
UNIX−RECVFROM and UNIX−RECV address peers.
Option groups: FD,SOCKET,NAMED,UNIX
Useful options: bind
See also: UNIX−RECVFROM, UNIX−RECV, UNIX−CONNECT, UDP−SENDTO, IP−SENDTO

UNIX−RECVFROM:<filename>

Creates a UNIX domain datagram socket [<filename>]. Receives one packet
and may send one or more answer packets to that peer. This mode is
particularly useful with fork option where each arriving packet − from
arbitrary peers − is handled by its own sub process. This address works
well with socat UNIX−SENDTO address peers.
Option groups: FD,SOCKET,NAMED,CHILD,UNIX
Useful options: fork
See also: UNIX−SENDTO, UNIX−RECV, UNIX−LISTEN, UDP−RECVFROM,
IP−RECVFROM

UNIX−RECV:<filename>

Creates a UNIX domain datagram socket [<filename>]. Receives packets
from multiple unspecified peers and merges the data. No replies are
possible. It can be, e.g., addressed by socat UNIX−SENDTO address
peers. It behaves similar to a syslog server. Option groups:
FD,SOCKET,NAMED,UNIX
See also: UNIX−SENDTO, UNIX−RECVFROM, UNIX−LISTEN, UDP−RECV, IP−RECV

UNIX−CLIENT:<filename>

Communicates with the specified peer socket, defined by [<filename>]
assuming it is a UNIX domain socket. It first tries to connect and, if
that fails, assumes it is a datagram socket, thus supporting both
types.
Option groups: FD,SOCKET,NAMED,UNIX
Useful options: bind
See also: UNIX−CONNECT, UNIX−SENDTO, GOPEN

ABSTRACT−CONNECT:<string>
ABSTRACT−LISTEN:<string>
ABSTRACT−SENDTO:<string>
ABSTRACT−RECVFROM:<string>
ABSTRACT−RECV:<string>
ABSTRACT−CLIENT:<string>

The ABSTRACT addresses are almost identical to the related UNIX
addresses except that they do not address file system based sockets but
an alternate UNIX domain address space. To archieve this the socket
address strings are prefixed with "\0" internally. This feature is
available (only?) on Linux. Option groups are the same as with the
related UNIX addresses, except that the ABSTRACT addresses are not
member of the NAMED group.

Performs a chroot() operation to <directory> before opening the
address. This call might require root privilege.

setgid=<group>

Changes the primary <group> of the process after processing the
address. This call might require root privilege. Please note that this
option does not drop other group related privileges.

setgid−early=<group>

Like setgit but is performed before opening the address.

setuid=<user>

Changes the <user> (owner) of the process after processing the address.
This call might require root privilege. Please note that this option
does not drop group related privileges. Check if option su better fits
your needs.

setuid−early=<user>

Like setuid but is performed before opening the address.

su=<user>

Changes the <user> (owner) and groups of the process after processing
the address (example). This call might require root privilege.

su−d=<user>

Short name for substuser−delayed. Changes the <user> (owner) and groups
of the process after processing the address (example). The user and his
groups are retrieved before a possible chroot() . This call might
require root privilege.

setpgid=<pid_t>

Makes the process a member of the specified process group <pid_t>. If
no value is given, or if the value is 0 or 1, the process becomes
leader of a new process group.

setsid

Makes the process the leader of a new session (example).

READLINE option group

These options apply to the readline address type.
history=<filename>

Reads and writes history from/to <filename> (example).

noprompt

Since version 1.4.0, socat per default tries to determine a prompt −
that is then passed to the readline call − by remembering the last
incomplete line of the output. With this option, socat does not pass a
prompt to readline, so it begins line editing in the first column of
the terminal.

noecho=<pattern>

Specifies a regular pattern for a prompt that prevents the following
input line from being displayed on the screen and from being added to
the history. The prompt is defined as the text that was output to the
readline address after the lastest newline character and before an
input character was typed. The pattern is a regular expression, e.g.
"^[Pp]assword:.*$" or "([Uu]ser:|[Pp]assword:)". See regex\(7) for
details. (example)

prompt=<string>

Passes the string as prompt to the readline function. readline prints
this prompt when stepping through the history. If this string matches a
constant prompt issued by an interactive program on the other socat
address, consistent look and feel can be archieved.

APPLICATION option group

This group contains options that work at data level. Note that these
options only apply to the "raw" data transferred by socat, but not to
protocol data used by addresses like PROXY.

cr

Converts the default line termination character NL (’\n’, 0x0a) to/from
CR (’\r’, 0x0d) when writing/reading on this channel.

crnl

Converts the default line termination character NL (’\n’, 0x0a) to/from
CRNL ("\r\n", 0x0d0a) when writing/reading on this channel (example).
Note: socat simply strips all CR characters.

ignoreeof

When EOF occurs on this channel, socat ignores it and tries to read
more data (like "tail −f") (example).

readbytes=<bytes>

socat reads only so many bytes from this address (the address provides
only so many bytes for transfer and pretends to be at EOF afterwards).
Must be greater than 0.

lockfile=<filename>

If lockfile exists, exits with error. If lockfile does not exist,
creates it and continues, unlinks lockfile on exit.

waitlock=<filename>

If lockfile exists, waits until it disappears. When lockfile does not
exist, creates it and continues, unlinks lockfile on exit.

escape=<int>

Specifies the numeric code of a character that triggers EOF on the
input stream. It is useful with a terminal in raw mode (example).

SOCKET option group

These options are intended for all kinds of sockets, e.g. IP or UNIX
domain. Most are applied with a setsockopt() call.
bind=<sockname>

Binds the socket to the given socket address using the bind() system
call. The form of <sockname> is socket domain dependent: IP4 and IP6
allow the form [hostname|hostaddress][:(service|port)] (example), UNIX
domain sockets require <filename>.

connect−timeout=<seconds>

Abort the connection attempt after <seconds> [timeval] with error
status.

so−bindtodevice=<interface>

Binds the socket to the given <interface>. This option might require
root privilege.

broadcast

For datagram sockets, allows sending to broadcast addresses and
receiving packets addressed to broadcast addresses.

debug

Enables socket debugging.

dontroute

Only communicates with directly connected peers, does not use routers.

keepalive

Enables sending keepalives on the socket.

linger=<seconds>

Blocks shutdown() or close() until data transfers have finished or the
given timeout [int] expired.

oobinline

Places out−of−band data in the input data stream.

priority=<priority>

Sets the protocol defined <priority> [<int>] for outgoing packets.

rcvbuf=<bytes>

Sets the size of the receive buffer after the socket() call to <bytes>
[int]. With TCP sockets, this value corresponds to the socket’s maximal
window size.

rcvbuf−late=<bytes>

Sets the size of the receive buffer when the socket is already
connected to <bytes> [int]. With TCP sockets, this value corresponds to
the socket’s maximal window size.

rcvlowat=<bytes>

Specifies the minimum number of received bytes [int] until the socket
layer will pass the buffered data to socat.

rcvtimeo=<seconds>

Sets the receive timeout [timeval].

reuseaddr

Allows other sockets to bind to an address even if parts of it (e.g.
the local port) are already in use by socat (example).

sndbuf=<bytes>

Sets the size of the send buffer after the socket() call to <bytes>
[int].

sndbuf−late=<bytes>

Sets the size of the send buffer when the socket is connected to
<bytes> [int].

sndlowat=<bytes>

Specifies the minimum number of bytes in the send buffer until the
socket layer will send the data to <bytes> [int].

sndtimeo=<seconds>

Sets the send timeout to seconds [timeval].

pf=<string>

Forces the use of the specified IP version or protocol. <string> can be
something like "ip4" or "ip6". The resulting value is used as first
argument to the socket() or socketpair() calls. This option affects
address resolution and the required syntax of bind and range options.

type=<type>

Sets the type of the socket, specified as second argument to the
socket() or socketpair() calls, to <type> [int]. Address resolution is
not affected by this option. Under Linux, 1 means stream oriented
socket, 2 means datagram socket, and 3 means raw socket.

prototype

Sets the protocol of the socket, specified as third argument to the
socket() or socketpair() calls, to <prototype> [int]. Address
resolution is not affected by this option. 6 means TCP, 17 means UDP.

so−timestamp

Sets the SO_TIMESTAMP socket option. This enables receiving and logging
of timestamp ancillary messages.

setsockopt−int=<level>:<optname>:<optval>

Invokes setsockopt() for the socket with the given parameters. level
[int] is used as second argument to setsockopt() and specifies the
layer, e.g. SOL_TCP for TCP (6 on Linux), or SOL_SOCKET for the socket
layer (1 on Linux). optname [int] is the third argument to setsockopt()
and tells which socket option is to be set. For the actual numbers you
might have to look up the appropriate include files of your system. The
4th setsockopt() parameter, value [int], is passed to the function per
pointer, and for the length parameter sizeof\(int) is taken
implicitely.

setsockopt−bin=<level>:<optname>:<optval>

Like setsockopt−int, but <optval> must be provided in dalan format and
specifies an arbitrary sequence of bytes; the length parameter is
automatically derived from the data.

setsockopt−string=<level>:<optname>:<optval>

Like setsockopt−int, but <optval> must be a string. This string is
passed to the function with trailing null character, and the length
parameter is automatically derived from the data.

UNIX option group

These options apply to UNIX domain based addresses.
unix−tightsocklen=[0|1]

On socket operations, pass a socket address length that does not
include the whole struct sockaddr_un record but (besides other
components) only the relevant part of the filename or abstract string.
Default is 1.

IP4 and IP6 option groups

These options can be used with IPv4 and IPv6 based sockets.
tos=<tos>

Sets the TOS (type of service) field of outgoing packets to <tos>
[byte] (see RFC 791).

ttl=<ttl>

Sets the TTL (time to live) field of outgoing packets to <ttl> [byte].

ip−options=<data>

Sets IP options like source routing. Must be given in binary form,
recommended format is a leading "x" followed by an even number of hex
digits. This option may be used multiple times, data are appended.
E.g., to connect to host 10.0.0.1 via some gateway using a loose source
route, use the gateway as address parameter and set a loose source
route using the option ip−options=x8307040a000001 .
IP options are defined in RFC 791.

mtudiscover=<0|1|2>

Takes 0, 1, 2 to never, want, or always use path MTU discover on this
socket.

ip−pktinfo

Sets the IP_PKTINFO socket option. This enables receiving and logging
of ancillary messages containing destination address and interface
(Linux) (example).

ip−recverr

Sets the IP_RECVERR socket option. This enables receiving and logging
of ancillary messages containing detailled error information.

ip−recvopts

Sets the IP_RECVOPTS socket option. This enables receiving and logging
of IP options ancillary messages (Linux, *BSD).

ip−recvtos

Sets the IP_RECVTOS socket option. This enables receiving and logging
of TOS (type of service) ancillary messages (Linux).

ip−recvttl

Sets the IP_RECVTTL socket option. This enables receiving and logging
of TTL (time to live) ancillary messages (Linux, *BSD).

ip−recvdstaddr

Sets the IP_RECVDSTADDR socket option. This enables receiving and
logging of ancillary messages containing destination address (*BSD)
(example).

ip−recvif

Sets the IP_RECVIF socket option. This enables receiving and logging of
interface ancillary messages (*BSD) (example).

ip−add−membership=<multicast−address:interface−address>
ip−add−membership=<multicast−address:interface−name>
ip−add−membership=<multicast−address:interface−index>
ip−add−membership=<multicast−address:interface−address:interface−name>
ip−add−membership=<multicast−address:interface−address:interface−index>

Makes the socket member of the specified multicast group. This is
currently only implemented for IPv4. The option takes the IP address of
the multicast group and info about the desired network interface. The
most common syntax is the first one, while the others are only
available on systems that provide struct mreqn (Linux).
The indices of active network interfaces can be shown using the utility
procan.

ip−multicast−if=<hostname>

Specifies hostname or address of the network interface to be used for
multicast traffic.

ip−multicast−loop=<bool>

Specifies if outgoing multicast traffic should loop back to the
interface.

ip−multicast−ttl=<byte>

Sets the TTL used for outgoing multicast traffic. Default is 1.

res−debug
res−aaonly
res−usevc
res−primary
res−igntc
res−recurse
res−defnames
res−stayopen
res−dnsrch

These options set the corresponding resolver (name resolution) option
flags. Append "=0" to clear a default option. See man resolver\(5) for
more information on these options. Note: these options are valid only
for the address they are applied to.

IP6 option group

These options can only be used on IPv6 based sockets. See IP options
for options that can be applied to both IPv4 and IPv6 sockets.
ipv6only=<bool>

Sets the IPV6_V6ONLY socket option. If 0, the TCP stack will also
accept connections using IPv4 protocol on the same port. The default is
system dependent.

ipv6−recvdstopts

Sets the IPV6_RECVDSTOPTS socket option. This enables receiving and
logging of ancillary messages containing the destination options.

ipv6−recvhoplimit

Sets the IPV6_RECVHOPLIMIT socket option. This enables receiving and
logging of ancillary messages containing the hoplimit.

ipv6−recvhopopts

Sets the IPV6_RECVHOPOPTS socket option. This enables receiving and
logging of ancillary messages containing the hop options.

ipv6−recvpktinfo

Sets the IPV6_RECVPKTINFO socket option. This enables receiving and
logging of ancillary messages containing destination address and
interface.

ipv6−unicast−hops=link(TYPE_INT)(<int>)

Sets the IPV6_UNICAST_HOPS socket option. This sets the hop count limit
(TTL) for outgoing unicast packets.

ipv6−recvrthdr

Sets the IPV6_RECVRTHDR socket option. This enables receiving and
logging of ancillary messages containing routing information.

ipv6−tclass

Sets the IPV6_TCLASS socket option. This sets the transfer class of
outgoing packets.

ipv6−recvtclass

Sets the IPV6_RECVTCLASS socket option. This enables receiving and
logging of ancillary messages containing the transfer class.

TCP option group

These options may be applied to TCP sockets. They work by invoking
setsockopt() with the appropriate parameters.

cork

Doesn’t send packets smaller than MSS (maximal segment size).

defer−accept

While listening, accepts connections only when data from the peer
arrived.

keepcnt=<count>

Sets the number of keepalives before shutting down the socket to
<count> [int].

keepidle=<seconds>

Sets the idle time before sending the first keepalive to <seconds>
[int].

keepintvl=<seconds>

Sets the interval between two keepalives to <seconds> [int].

linger2=<seconds>

Sets the time to keep the socket in FIN−WAIT−2 state to <seconds>
[int].

mss=<bytes>

Sets the MSS (maximum segment size) after the socket() call to <bytes>
[int]. This value is then proposed to the peer with the SYN or SYN/ACK
packet (example).

mss−late=<bytes>

Sets the MSS of the socket after connection has been established to
<bytes> [int].

nodelay

Turns off the Nagle algorithm for measuring the RTT (round trip time).

rfc1323

Enables RFC1323 TCP options: TCP window scale, round−trip time
measurement (RTTM), and protect against wrapped sequence numbers (PAWS)
(AIX).

stdurg

Enables RFC1122 compliant urgent pointer handling (AIX).

syncnt=<count>

Sets the maximal number of SYN retransmits during connect to <count>
[int].

md5sig

Enables generation of MD5 digests on the packets (FreeBSD).

noopt

Disables use of TCP options (FreeBSD, MacOSX).

nopush

sets the TCP_NOPUSH socket option (FreeBSD, MacOSX).

sack−disable

Disables use the selective acknowledge feature (OpenBSD).

signature−enable

Enables generation of MD5 digests on the packets (OpenBSD).

abort−threshold=<milliseconds>

Sets the time to wait for an answer of the peer on an established
connection (HP−UX).

conn−abort−threshold=<milliseconds>

Sets the time to wait for an answer of the server during the initial
connect (HP−UX).

keepinit

Sets the time to wait for an answer of the server during connect\()
before giving up. Value in half seconds, default is 150 (75s) (Tru64).

paws

Enables the "protect against wrapped sequence numbers" feature (Tru64).

sackena

Enables selective acknowledge (Tru64).

tsoptena

Enables the time stamp option that allows RTT recalculation on existing
connections (Tru64).

SCTP option group

These options may be applied to SCTP stream sockets.
sctp−nodelay

Sets the SCTP_NODELAY socket option that disables the Nagle algorithm.

sctp−maxseg=<bytes>

Sets the SCTP_MAXSEG socket option to <bytes> [int]. This value is then
proposed to the peer with the SYN or SYN/ACK packet.

UDP, TCP, and SCTP option groups

Here we find options that are related to the network port mechanism and
thus can be used with UDP, TCP, and SCTP client and server addresses.
sourceport=<port>

For outgoing (client) TCP and UDP connections, it sets the source
<port> using an extra bind() call. With TCP or UDP listen addresses,
socat immediately shuts down the connection if the client does not use
this sourceport (example).

lowport

Outgoing (client) TCP and UDP connections with this option use an
unused random source port between 640 and 1023 incl. On UNIX class
operating systems, this requires root privilege, and thus indicates
that the client process is authorized by local root. TCP and UDP listen
addresses with this option immediately shut down the connection if the
client does not use a sourceport <= 1023. This mechanism can provide
limited authorization under some circumstances.

SOCKS option group

When using SOCKS type addresses, some socks specific options can be
set.
socksport=<tcp service>

Overrides the default "socks" service or port 1080 for the socks server
port with <TCP service>.

socksuser=<user>

Sends the <user> [string] in the username field to the socks server.
Default is the actual user name ($LOGNAME or $USER) (example).

HTTP option group

Options that can be provided with HTTP type addresses. The only HTTP
address currently implemented is proxy−connect.
proxyport=<TCP service>

Overrides the default HTTP proxy port 8080 with <TCP service>.

ignorecr

The HTTP protocol requires the use of CR+NL as line terminator. When a
proxy server violates this standard, socat might not understand its
answer. This option directs socat to interprete NL as line terminator
and to ignore CR in the answer. Nevertheless, socat sends CR+NL to the
proxy.

proxyauth=<username>:<password>

Provide "basic" authentication to the proxy server. The argument to the
option is used with a "Proxy−Authorization: Base" header in base64
encoded form.
Note: username and password are visible for every user on the local
machine in the process list; username and password are transferred to
the proxy server unencrypted (base64 encoded) and might be sniffed.

resolve

Per default, socat sends to the proxy a CONNECT request containing the
target hostname. With this option, socat resolves the hostname locally
and sends the IP address. Please note that, according to RFC 2396, only
name resolution to IPv4 addresses is implemented.

RANGE option group

These options check if a connecting client should be granted access.
They can be applied to listening and receiving network sockets.
tcp−wrappers options fall into this group.
range=<address−range>

After accepting a connection, tests if the peer is within range. For
IPv4 addresses, address−range takes the form address/bits, e.g.
10.0.0.0/8, or address:mask, e.g. 10.0.0.0:255.0.0.0 (example); for
IPv6, it is [ip6−address/bits], e.g. [::1/128]. If the client address
does not match, socat issues a warning and keeps listening/receiving.

tcpwrap[=<name>]

Uses Wietse Venema’s libwrap (tcpd) library to determine if the client
is allowed to connect. The configuration files are /etc/hosts.allow and
/etc/hosts.deny per default, see "man 5 hosts_access" for more
information. The optional <name> (type string) is passed to the wrapper
functions as daemon process name (example). If omitted, the basename of
socats invocation (argv[0]) is passed. If both tcpwrap and range
options are applied to an address, both conditions must be fulfilled to
allow the connection.

allow−table=<filename>

Takes the specified file instead of /etc/hosts.allow.

deny−table=<filename>

Takes the specified file instead of /etc/hosts.deny.

tcpwrap−etc=<directoryname>

Looks for hosts.allow and hosts.deny in the specified directory. Is
overridden by options hosts−allow and hosts−deny.

LISTEN option group

Options specific to listening sockets.
backlog=<count>

Sets the backlog value passed with the listen() system call to <count>
[int]. Default is 5.

max−children=<count>

Limits the number of concurrent child processes [int]. Default is no
limit.

CHILD option group

Options for addresses with multiple connections via child processes.

fork

After establishing a connection, handles its channel in a child process
and keeps the parent process attempting to produce more connections,
either by listening or by connecting in a loop (example).

SSL−CONNECT and SSL−LISTEN differ in when they actually fork off the
child: SSL−LISTEN forks before the SSL handshake, while SSL−CONNECT
forks afterwards. RETRY and FOREVER options are not inherited by the
child process.
On some operating systems (e.g. FreeBSD) this option does not work for
UDP−LISTEN addresses.

EXEC option group

Options for addresses that invoke a program.
path=<string>

Overrides the PATH environment variable for searching the program with
<string>. This $PATH value is effective in the child process too.

login

Prefixes argv[0] for the execvp() call with ’−’, thus making a shell
behave as login shell.

FORK option group

EXEC or SYSTEM addresses invoke a program using a child process and
transfer data between socat and the program. The interprocess
communication mechanism can be influenced with the following options.
Per default, a socketpair() is created and assigned to stdin and stdout
of the child process, while stderr is inherited from the socat process,
and the child process uses file descriptors 0 and 1 for communicating
with the main socat process.

nofork

Does not fork a subprocess for executing the program, instead calls
execvp\() or system\() directly from the actual socat instance. This
avoids the overhead of another process between the program and its
peer, but introduces a lot of restrictions:

o

this option can only be applied to the second socat address.

o

it cannot be applied to a part of a dual address.

o

the first socat address cannot be OPENSSL or READLINE

o

socat options −b, −t, −D, −l, −v, −x become useless

o

for both addresses, options ignoreeof, cr, and crnl become useless

o

for the second address (the one with option nofork), options append,
cloexec, flock, user, group, mode, nonblock, perm−late, setlk, and
setpgid cannot be applied. Some of these could be used on the first
address though.

pipes

Creates a pair of unnamed pipes for interprocess communication instead
of a socket pair.

openpty

Establishes communication with the sub process using a pseudo terminal
created with openpty() instead of the default (socketpair or ptmx).

ptmx

Establishes communication with the sub process using a pseudo terminal
created by opening /dev/ptmx or /dev/ptc instead of the default
(socketpair).

pty

Establishes communication with the sub process using a pseudo terminal
instead of a socket pair. Creates the pty with an available mechanism.
If openpty and ptmx are both available, it uses ptmx because this is
POSIX compliant (example).

ctty

Makes the pty the controlling tty of the sub process (example).

stderr

Directs stderr of the sub process to its output channel by making
stderr a dup() of stdout (example).

fdin=<fdnum>

Assigns the sub processes input channel to its file descriptor <fdnum>
instead of stdin (0). The program started from the subprocess has to
use this fd for reading data from socat (example).

fdout=<fdnum>

Assigns the sub processes output channel to its file descriptor <fdnum>
instead of stdout (1). The program started from the subprocess has to
use this fd for writing data to socat (example).

sighup, sigint, sigquit

Has socat pass signals of this type to the sub process. If no address
has this option, socat terminates on these signals.

TERMIOS option group

For addresses that work on a tty (e.g., stdio, file:/dev/tty,
exec:...,pty), the terminal parameters defined in the UN*X termios
mechanism are made available as address option parameters. Please note
that changes of the parameters of your interactive terminal remain
effective after socat’s termination, so you might have to enter "reset"
or "stty sane" in your shell afterwards. For EXEC and SYSTEM addresses
with option PTY, these options apply to the pty by the child processes.

b0

Disconnects the terminal.

b19200

Sets the serial line speed to 19200 baud. Some other rates are
possible; use something like socat −hh |grep ’ b[1−9]’ to find all
speeds supported by your implementation.

Note: On some operating systems, these options may not be available.
Use ispeed or ospeed instead.

echo=<bool>

Enables or disables local echo.

icanon=<bool>

Sets or clears canonical mode, enabling line buffering and some special
characters.

raw

Sets raw mode, thus passing input and output almost unprocessed. This
option is obsolete, use option rawer or cfmakeraw instead.

rawer

Makes terminal rawer than raw option. This option implicitly turns off
echo. (example).

cfmakeraw

Sets raw mode by invoking cfmakeraw() or by simulating this call. This
option implicitly turns off echo.

ignbrk=<bool>

Ignores or interpretes the BREAK character (e.g., ^C)

brkint=<bool>

bs0

bs1

bsdly=<0|1>
clocal=<bool>

cr0
cr1
cr2
cr3

Sets the carriage return delay to 0, 1, 2, or 3, respectively. 0 means
no delay, the other values are terminal dependent.

crdly=<0|1|2|3>
cread=<bool>
crtscts=<bool>

cs5
cs6
cs7
cs8

Sets the character size to 5, 6, 7, or 8 bits, respectively.

csize=<0|1|2|3>
cstopb=<bool>

Sets two stop bits, rather than one.

dsusp=<byte>

Sets the value for the VDSUSP character that suspends the current
foreground process and reactivates the shell (all except Linux).

echoctl=<bool>

Echos control characters in hat notation (e.g. ^A)

echoe=<bool>
echok=<bool>
echoke=<bool>
echonl=<bool>
echoprt=<bool>
eof=<byte>
eol=<byte>
eol2=<byte>
erase=<byte>
discard=<byte>

ff0

ff1

ffdly=<bool>
flusho=<bool>
hupcl=<bool>
icrnl=<bool>
iexten=<bool>
igncr=<bool>
ignpar=<bool>
imaxbel=<bool>
inlcr=<bool>
inpck=<bool>
intr=<byte>
isig=<bool>
ispeed=<unsigned−int>

Set the baud rate for incoming data on this line.
See also: ospeed, b19200

istrip=<bool>
iuclc=<bool>
ixany=<bool>
ixoff=<bool>
ixon=<bool>
kill=<byte>
lnext=<byte>
min=<byte>

nl0

Sets the newline delay to 0.

nl1

nldly=<bool>
noflsh=<bool>
ocrnl=<bool>
ofdel=<bool>
ofill=<bool>
olcuc=<bool>
onlcr=<bool>
onlret=<bool>
onocr=<bool>
opost=<bool>

Enables or disables output processing; e.g., converts NL to CR−NL.

ospeed=<unsigned−int>

Set the baud rate for outgoing data on this line.
See also: ispeed, b19200

parenb=<bool>

Enable parity generation on output and parity checking for input.

parmrk=<bool>
parodd=<bool>
pendin=<bool>
quit=<byte>
reprint=<byte>

sane

Brings the terminal to something like a useful default state.

start=<byte>
stop=<byte>
susp=<byte>
swtc=<byte>

tab0

tab1

tab2

tab3

tabdly=<unsigned−int>
time=<byte>
tostop=<bool>

vt0

vt1

vtdly=<bool>
werase=<byte>
xcase=<bool>

xtabs

i−pop−all

With UNIX System V STREAMS, removes all drivers from the stack.

i−push=<string>

With UNIX System V STREAMS, pushes the driver (module) with the given
name (string) onto the stack. For example, to make sure that a
character device on Solaris supports termios etc, use the following
options: i−pop−all,i−push=ptem,i−push=ldterm,i−push=ttcompat

PTY option group

These options are intended for use with the pty address type.
link=<filename>

Generates a symbolic link that points to the actual pseudo terminal
(pty). This might help to solve the problem that ptys are generated
with more or less unpredictable names, making it difficult to directly
access the socat generated pty automatically. With this option, the
user can specify a "fix" point in the file hierarchy that helps him to
access the actual pty (example). Beginning with socat version 1.4.3,
the symbolic link is removed when the address is closed (but see option
unlink−close).

wait−slave

Blocks the open phase until a process opens the slave side of the pty.
Usually, socat continues after generating the pty with opening the next
address or with entering the transfer loop. With the wait−slave option,
socat waits until some process opens the slave side of the pty before
continuing. This option only works if the operating system provides the
poll() system call. And it depends on an undocumented behaviour of
pty’s, so it does not work on all operating systems. It has
successfully been tested on Linux, FreeBSD, NetBSD, and on Tru64 with
openpty.

pty−interval=<seconds>

When the wait−slave option is set, socat periodically checks the HUP
condition using poll() to find if the pty’s slave side has been opened.
The default polling interval is 1s. Use the pty−interval option
[timeval] to change this value.

OPENSSL option group

These options apply to the openssl and openssl−listen address types.
cipher=<cipherlist>

Selects the list of ciphers that may be used for the connection. See
the man page of ciphers , section CIPHER LIST FORMAT, for detailed
information about syntax, values, and default of <cipherlist>.
Several cipher strings may be given, separated by ’:’. Some simple
cipher strings:

3DES

Uses a cipher suite with triple DES.

MD5

Uses a cipher suite with MD5.

aNULL

Uses a cipher suite without authentication.

NULL

Does not use encryption.

HIGH

Uses a cipher suite with "high" encryption. Note that the peer must
support the selected property, or the negotiation will fail.

method=<ssl−method>

Sets the protocol version to be used. Valid strings (not case
sensitive) are:

SSL2

Select SSL protocol version 2.

SSL3

Select SSL protocol version 3.

SSL23

Select the best available SSL or TLS protocol. This is the default when
this option is not provided.

TLS1

Select TLS protocol version 1.

TLS1.1

Select TLS protocol version 1.1.

TLS1.2

Select TLS protocol version 1.2.

DTLS1

Select DTLS protocol version 1.

verify=<bool>

Controls check of the peer’s certificate. Default is 1 (true).
Disabling verify might open your socket for everyone, making the
encryption useless!

cert=<filename>

Specifies the file with the certificate and private key for
authentication. The certificate must be in OpenSSL format (*.pem). With
openssl−listen, use of this option is strongly recommended. Except with
cipher aNULL, "no shared ciphers" error will occur when no certificate
is given.

key=<filename>

Specifies the file with the private key. The private key may be in this
file or in the file given with the cert option. The party that has to
proof that it is the owner of a certificate needs the private key.

dhparams=<filename>

Specifies the file with the Diffie Hellman parameters. These parameters
may also be in the file given with the cert option in which case the
dhparams option is not needed.

cafile=<filename>

Specifies the file with the trusted (root) authority certificates. The
file must be in PEM format and should contain one or more certificates.
The party that checks the authentication of its peer trusts only
certificates that are in this file.

capath=<dirname>

Specifies the directory with the trusted (root) certificates. The
directory must contain certificates in PEM format and their hashes (see
OpenSSL documentation)

egd=<filename>

On some systems, openssl requires an explicit source of random data.
Specify the socket name where an entropy gathering daemon like egd
provides random data, e.g. /dev/egd−pool.

pseudo

On systems where openssl cannot find an entropy source and where no
entropy gathering daemon can be utilized, this option activates a
mechanism for providing pseudo entropy. This is archieved by taking the
current time in microseconds for feeding the libc pseudo random number
generator with an initial value. openssl is then feeded with output
from random\() calls.

NOTE:This mechanism is not sufficient for generation of secure keys!

compress

Enable or disable the use of compression for a connection. Setting this
to "none" disables compression, setting it to "auto" lets OpenSSL
choose the best available algorithm supported by both parties. The
default is to not touch any compression−related settings. NOTE:
Requires OpenSSL 0.9.8 or higher and disabling compression with OpenSSL
0.9.8 affects all new connections in the process.

commonname=<string>

Specify the commonname that the peer certificate must match. With
OPENSSL−CONNECT address this overrides the given hostname or IP target
address; with OPENSSL−LISTEN this turns on check of peer certificates
commonname. This option has only meaning when option verify is not
disabled and the choosen cipher provides a peer certificate.

fips

Enables FIPS mode if compiled in. For info about the FIPS encryption
implementation standard see http://oss−institute.org/fips−faq.html.
This mode might require that the involved certificates are generated
with a FIPS enabled version of openssl. Setting or clearing this option
on one socat address affects all OpenSSL addresses of this process.

RETRY option group

Options that control retry of some system calls, especially connection
attempts.
retry=<num>

Number of retries before the connection or listen attempt is aborted.
Default is 0, which means just one attempt.

interval=<timespec>

Time between consecutive attempts (seconds, [timespec]). Default is 1
second.

forever

Performs an unlimited number of retry attempts.

TUN option group

Options that control Linux TUN/TAP interface device addresses.
tun−device=<device−file>

Instructs socat to take another path for the TUN clone device. Default
is /dev/net/tun.

tun−name=<if−name>

Gives the resulting network interface a specific name instead of the
system generated (tun0, tun1, etc.)

tun−type=[tun|tap]

Sets the type of the TUN device; use this option to generate a TAP
device. See the Linux docu for the difference between these types. When
you try to establish a tunnel between two TUN devices, their types
should be the same.

iff−no−pi

Sets the IFF_NO_PI flag which controls if the device includes
additional packet information in the tunnel. When you try to establish
a tunnel between two TUN devices, these flags should have the same
values.

iff−up

Sets the TUN network interface status UP. Strongly recommended.

iff−broadcast

Sets the BROADCAST flag of the TUN network interface.

iff−debug

Sets the DEBUG flag of the TUN network interface.

iff−loopback

Sets the LOOPBACK flag of the TUN network interface.

iff−pointopoint

Sets the POINTOPOINT flag of the TUN device.

iff−notrailers

Sets the NOTRAILERS flag of the TUN device.

iff−running

Sets the RUNNING flag of the TUN device.

iff−noarp

Sets the NOARP flag of the TUN device.

iff−promisc

Sets the PROMISC flag of the TUN device.

iff−allmulti

Sets the ALLMULTI flag of the TUN device.

iff−master

Sets the MASTER flag of the TUN device.

iff−slave

Sets the SLAVE flag of the TUN device.

iff−multicast

Sets the MULTICAST flag of the TUN device.

iff−portsel

Sets the PORTSEL flag of the TUN device.

iff−automedia

Sets the AUTOMEDIA flag of the TUN device.

iff−dynamic

Sets the DYNAMIC flag of the TUN device.

=== DATA VALUES ===

This section explains the different data types that address parameters
and address options can take.
address−range

Is currently only implemented for IPv4 and IPv6. See address−option
‘range’

bool

"0" or "1"; if value is omitted, "1" is taken.

byte

An unsigned int number, read with strtoul() , lower or equal to
UCHAR_MAX .

command−line

A string specifying a program name and its arguments, separated by
single spaces.

data

A raw data specification following dalan syntax. Currently the only
valid form is a string starting with ’x’ followed by an even number of
hex digits, specifying a sequence of bytes.

directory

A string with usual UN*X directory name semantics.

facility

The name of a syslog facility in lower case characters.

fdnum

An unsigned int type, read with strtoul() , specifying a UN*X file
descriptor.

filename

A string with usual UN*X filename semantics.

group

If the first character is a decimal digit, the value is read with
strtoul() as unsigned integer specifying a group id. Otherwise, it must
be an existing group name.

int

A number following the rules of the strtol() function with base "0",
i.e. decimal number, octal number with leading "0", or hexadecimal
number with leading "0x". The value must fit into a C int.

interface

A string specifying the device name of a network interface as shown by
ifconfig or procan, e.g. "eth0".

IP address

An IPv4 address in numbers−and−dots notation, an IPv6 address in hex
notation enclosed in brackets, or a hostname that resolves to an IPv4
or an IPv6 address.
Examples: 127.0.0.1, [::1], www.dest−unreach.org, dns1

IPv4 address

An IPv4 address in numbers−and−dots notation or a hostname that
resolves to an IPv4 address.
Examples: 127.0.0.1, www.dest−unreach.org, dns2

IPv6 address

An iPv6 address in hexnumbers−and−colons notation enclosed in brackets,
or a hostname that resolves to an IPv6 address.
Examples: [::1], [1234:5678:9abc:def0:1234:5678:9abc:def0],
ip6name.domain.org

long

A number read with strtol() . The value must fit into a C long.

long long

A number read with strtoll() . The value must fit into a C long long.

off_t

An implementation dependend signed number, usually 32 bits, read with
strtol or strtoll.

off64_t

An implementation dependend signed number, usually 64 bits, read with
strtol or strtoll.

mode_t

An unsigned integer, read with strtoul() , specifying mode (permission)
bits.

pid_t

A number, read with strtol() , specifying a process id.

port

A uint16_t (16 bit unsigned number) specifying a TCP or UDP port, read
with strtoul() .

protocol

An unsigned 8 bit number, read with strtoul() .

size_t

An unsigned number with size_t limitations, read with strtoul .

sockname

A socket address. See address−option ‘bind’

string

A sequence of characters, not containing ’\0’ and, depending on the
position within the command line, ’:’, ’,’, or "!!". Note that you
might have to escape shell meta characters in the command line.

TCP service

A service name, not starting with a digit, that is resolved by
getservbyname() , or an unsigned int 16 bit number read with strtoul()
.

timeval

A double float specifying seconds; the number is mapped into a struct
timeval, consisting of seconds and microseconds.

timespec

A double float specifying seconds; the number is mapped into a struct
timespec, consisting of seconds and nanoseconds.

UDP service

A service name, not starting with a digit, that is resolved by
getservbyname() , or an unsigned int 16 bit number read with strtoul()
.

unsigned int

A number read with strtoul() . The value must fit into a C unsigned
int.

user

If the first character is a decimal digit, the value is read with
strtoul() as unsigned integer specifying a user id. Otherwise, it must
be an existing user name.

=== EXAMPLES ===

socat − TCP4:www.domain.org:80

transfers data between STDIO (−) and a TCP4 connection to port 80 of
host www.domain.org. This example results in an interactive connection
similar to telnet or netcat. The stdin terminal parameters are not
changed, so you may close the relay with ^D or abort it with ^C.

socat -d -d READLINE,history=$HOME/.http_history \
TCP4:www.domain.org:www,crnl

this is similar to the previous example, but you can edit the current
line in a bash like manner (READLINE) and use the history file
.http_history; socat prints messages about progress (−d −d). The port
is specified by service name (www), and correct network line
termination characters (crnl) instead of NL are used.

socat TCP4−LISTEN:www TCP4:www.domain.org:www

installs a simple TCP port forwarder. With TCP4−LISTEN it listens on
local port "www" until a connection comes in, accepts it, then connects
to the remote host (TCP4) and starts data transfer. It will not accept
a econd connection.

socat -d -d -lmlocal2 \
TCP4-LISTEN:80,bind=myaddr1,reuseaddr,fork,su=nobody,range=10.0.0.0/8 \
TCP4:www.domain.org:80,bind=myaddr2

TCP port forwarder, each side bound to another local IP address (bind).
This example handles an almost arbitrary number of parallel or
consecutive connections by fork’ing a new process after each accept() .
It provides a little security by su’ing to user nobody after forking;
it only permits connections from the private 10 network (range); due to
reuseaddr, it allows immediate restart after master process’s
termination, even if some child sockets are not completely shut down.
With −lmlocal2, socat logs to stderr until successfully reaching the
accept loop. Further logging is directed to syslog with facility
local2.

socat TCP4-LISTEN:5555,fork,tcpwrap=script \
EXEC:/bin/myscript,chroot=/home/sandbox,su-d=sandbox,pty,stderr

a simple server that accepts connections (TCP4−LISTEN) and fork’s a new
child process for each connection; every child acts as single relay.
The client must match the rules for daemon process name "script" in
/etc/hosts.allow and /etc/hosts.deny, otherwise it is refused access
(see "man 5 hosts_access"). For EXEC’uting the program, the child
process chroot’s to /home/sandbox, su’s to user sandbox, and then
starts the program /home/sandbox/bin/myscript. Socat and myscript
communicate via a pseudo tty (pty); myscript’s stderr is redirected to
stdout, so its error messages are transferred via socat to the
connected client.

socat EXEC:"mail.sh target@domain.com",fdin=3,fdout=4 \
TCP4:mail.relay.org:25,crnl,bind=alias1.server.org,mss=512

mail.sh is a shell script, distributed with socat, that implements a
simple SMTP client. It is programmed to "speak" SMTP on its FDs 3 (in)
and 4 (out). The fdin and fdout options tell socat to use these FDs for
communication with the program. Because mail.sh inherits stdin and
stdout while socat does not use them, the script can read a mail body
from stdin. Socat makes alias1 your local source address (bind), cares
for correct network line termination (crnl) and sends at most 512 data
bytes per packet (mss).

socat −,escape=0x0f /dev/ttyS0,rawer,crnl

opens an interactive connection via the serial line, e.g. for talking
with a modem. rawer sets the console’s and ttyS0’s terminal parameters
to practicable values, crnl converts to correct newline characters.
escape allows to terminate the socat process with character control−O.
Consider using READLINE instead of the first address.

socat UNIX-LISTEN:/tmp/.X11-unix/X1,fork \
SOCKS4:host.victim.org:127.0.0.1:6000,socksuser=nobody,sourceport=20

with UNIX−LISTEN, socat opens a listening UNIX domain socket
/tmp/.X11−unix/X1. This path corresponds to local XWindow display :1 on
your machine, so XWindow client connections to DISPLAY=:1 are accepted.
Socat then speaks with the SOCKS4 server host.victim.org that might
permit sourceport 20 based connections due to an FTP related weakness
in its static IP filters. Socat pretends to be invoked by socksuser
nobody, and requests to be connected to loopback port 6000 (only weak
sockd configurations will allow this). So we get a connection to the
victims XWindow server and, if it does not require MIT cookies or
Kerberos authentication, we can start work. Please note that there can
only be one connection at a time, because TCP can establish only one
session with a given set of addresses and ports.

socat −u /tmp/readdata,seek−end=0,ignoreeof −

this is an example for unidirectional data transfer (−u). Socat
transfers data from file /tmp/readdata (implicit address GOPEN),
starting at its current end (seek−end=0 lets socat start reading at
current end of file; use seek=0 or no seek option to first read the
existing data) in a "tail −f" like mode (ignoreeof). The "file" might
also be a listening UNIX domain socket (do not use a seek option then).

(sleep 5; echo PASSWORD; sleep 5; echo ls; sleep 1) |
socat - EXEC:’ssh -l user server’,pty,setsid,ctty

EXEC’utes an ssh session to server. Uses a pty for communication
between socat and ssh, makes it ssh’s controlling tty (ctty), and makes
this pty the owner of a new process group (setsid), so ssh accepts the
password from socat.

socat -u TCP4-LISTEN:3334,reuseaddr,fork \
OPEN:/tmp/in.log,creat,append

implements a simple network based message collector. For each client
connecting to port 3334, a new child process is generated (option
fork). All data sent by the clients are append’ed to the file
/tmp/in.log. If the file does not exist, socat creat’s it. Option
reuseaddr allows immediate restart of the server process.

socat READLINE,noecho=’[Pp]assword:’ EXEC:’ftp
ftp.server.com’,pty,setsid,ctty

wraps a command line history (READLINE) around the EXEC’uted ftp client
utility. This allows editing and reuse of FTP commands for relatively
comfortable browsing through the ftp directory hierarchy. The password
is echoed! pty is required to have ftp issue a prompt. Nevertheless,
there may occur some confusion with the password and FTP prompts.

socat PTY,link=$HOME/dev/vmodem0,rawer,wait-slave \
EXEC:"ssh modemserver.us.org socat - /dev/ttyS0,nonblock,rawer"

generates a pseudo terminal device (PTY) on the client that can be
reached under the symbolic link $HOME/dev/vmodem0. An application that
expects a serial line or modem can be configured to use
$HOME/dev/vmodem0; its traffic will be directed to a modemserver via
ssh where another socat instance links it to /dev/ttyS0.

socat TCP4-LISTEN:2022,reuseaddr,fork \
PROXY:proxy:www.domain.org:22,proxyport=3128,proxyauth=user:pass

starts a forwarder that accepts connections on port 2022, and directs
them through the proxy daemon listening on port 3128 (proxyport) on
host proxy, using the CONNECT method, where they are authenticated as
"user" with "pass" (proxyauth). The proxy should establish connections
to host www.domain.org on port 22 then.

socat − SSL:server:4443,cafile=server.crt,cert=client.pem

is an OpenSSL client that tries to establish a secure connection to an
SSL server. Option cafile specifies a file that contains trust
certificates: we trust the server only when it presents one of these
certificates and proofs that it owns the related private key. Otherwise
the connection is terminated. With cert a file containing the client
certificate and the associated private key is specified. This is
required in case the server wishes a client authentication; many
Internet servers do not.
The first address (’−’) can be replaced by almost any other socat
address.

socat
SSL−LISTEN:4443,reuseaddr,pf=ip4,fork,cert=server.pem,cafile=client.crt
PIPE

is an OpenSSL server that accepts TCP connections, presents the
certificate from the file server.pem and forces the client to present a
certificate that is verified against cafile.crt.
The second address (’PIPE’) can be replaced by almost any other socat
address.
For instructions on generating and distributing OpenSSL keys and
certificates see the additional socat docu socat−openssl.txt.

echo |socat −u − file:/tmp/bigfile,create,largefile,seek=100000000000

creates a 100GB sparse file; this requires a file system type that
supports this (ext2, ext3, reiserfs, jfs; not minix, vfat). The
operation of writing 1 byte might take long (reiserfs: some minutes;
ext2: "no" time), and the resulting file can consume some disk space
with just its inodes (reiserfs: 2MB; ext2: 16KB).

socat tcp−l:7777,reuseaddr,fork system:’filan −i 0 −s >&2’,nofork

listens for incoming TCP connections on port 7777. For each accepted
connection, invokes a shell. This shell has its stdin and stdout
directly connected to the TCP socket (nofork). The shell starts filan
and lets it print the socket addresses to stderr (your terminal
window).

echo −e "\0\14\0\0\c" |socat −u −
file:/usr/bin/squid.exe,seek=0x00074420

functions as primitive binary editor: it writes the 4 bytes 000 014 000
000 to the executable /usr/bin/squid at offset 0x00074420 (this is a
real world patch to make the squid executable from Cygwin run under
Windows, actual per May 2004).

socat − tcp:www.blackhat.org:31337,readbytes=1000

connects to an unknown service and prevents being flooded.

socat −U TCP:target:9999,end−close TCP−L:8888,reuseaddr,fork

merges data arriving from different TCP streams on port 8888 to just
one stream to target:9999. The end−close option prevents the child
processes forked off by the second address from terminating the shared
connection to 9999 (close\(2) just unlinks the inode which stays active
as long as the parent process lives; shutdown\(2) would actively
terminate the connection).

socat −
UDP4−DATAGRAM:192.168.1.0:123,sp=123,broadcast,range=192.168.1.0/24

sends a broadcast to the network 192.168.1.0/24 and receives the
replies of the timeservers there. Ignores NTP packets from hosts
outside this network.

socat −
SOCKET−DATAGRAM:2:2:17:x007bxc0a80100x0000000000000000,bind=x007bx00000
000x0000000000000000,setsockopt−int=1:6:1,range=x0000xc0a80100x00000000
00000000:x0000xffffff00x0000000000000000

is semantically equivalent to the previous example, but all parameters
are specified in generic form. the value 6 of setsockopt−int is the
Linux value for SO_BROADCAST.

socat − IP4−DATAGRAM:255.255.255.255:44,broadcast,range=10.0.0.0/8

sends a broadcast to the local network\(s) using protocol 44. Accepts
replies from the private address range only.

socat −
UDP4−DATAGRAM:224.255.0.1:6666,bind=:6666,ip−add−membership=224.255.0.1
:eth0

transfers data from stdin to the specified multicast address using UDP.
Both local and remote ports are 6666. Tells the interface eth0 to also
accept multicast packets of the given group. Multiple hosts on the
local network can run this command, so all data sent by any of the
hosts will be received by all the other ones. Note that there are many
possible reasons for failure, including IP−filters, routing issues,
wrong interface selection by the operating system, bridges, or a badly
configured switch.

socat TCP:host2:4443 TUN:192.168.255.1/24,up

establishes one side of a virtual (but not private!) network with host2
where a similar process might run, with UDP−L and tun address
192.168.255.2. They can reach each other using the addresses
192.168.255.1 and 192.168.255.2. Note that streaming eg. via TCP or SSL
does not guarantee to retain packet boundaries and may thus cause
packet loss.

socat PTY,link=/var/run/ppp,rawer INTERFACE:hdlc0

circumvents the problem that pppd requires a serial device and thus
might not be able to work on a synchronous line that is represented by
a network device. socat creates a PTY to make pppd happy, binds to the
network interface hdlc0, and can transfer data between both devices.
Use pppd on device /var/run/ppp then.

socat −T 1 −d −d TCP−L:10081,reuseaddr,fork,crlf SYSTEM:"echo −e
\"\\\"HTTP/1.0 200 OK\\\nDocumentType: text/plain\\\n\\\ndate:
\$$date$\\\nserver:\$SOCAT_SOCKADDR:\$SOCAT_SOCKPORT\\\nclient:
\$SOCAT_PEERADDR:\$SOCAT_PEERPORT\\\n\\\"\"; cat; echo −e
\"\\\"\\\n\\\"\""

creates a simple HTTP echo server: each HTTP client that connects gets
a valid HTTP reply that contains information about the client address
and port as it is seen by the server host, the host address (which
might vary on multihomed servers), and the original client request.

socat −d −d
UDP4−RECVFROM:9999,so−broadcast,so−timestamp,ip−pktinfo,ip−recverr,ip−r
ecvopts,ip−recvtos,ip−recvttl!!−
SYSTEM:’export; sleep 1’ |grep SOCAT

waits for an incoming UDP packet on port 9999 and prints the
environment variables provided by socat. On BSD based systems you have
to replace ip−pktinfo with ip−recvdstaddr,ip−recvif. Especially
interesting is SOCAT_IP_DSTADDR: it contains the target address of the
packet which may be a unicast, multicast, or broadcast address.

=== DIAGNOSTICS ===

Socat uses a logging mechanism that allows to filter messages by
severity. The severities provided are more or less compatible to the
appropriate syslog priority. With one or up to four occurrences of the
−d command line option, the lowest priority of messages that are issued
can be selected. Each message contains a single uppercase character
specifying the messages severity (one of F, E, W, N, I, or D)

FATAL:

Conditions that require unconditional and immediate program
termination.

ERROR:

Conditions that prevent proper program processing. Usually the program
is terminated (see option −s).

WARNING:

Something did not function correctly or is in a state where correct
further processing cannot be guaranteed, but might be possible.

NOTICE:

Interesting actions of the program, e.g. for supervising socat in some
kind of server mode.

INFO:

Description of what the program does, and maybe why it happens. Allows
to monitor the lifecycles of file descriptors.

DEBUG:

Description of how the program works, all system or library calls and
their results.

Log messages can be written to stderr, to a file, or to syslog.

On exit, socat gives status 0 if it terminated due to EOF or inactivity
timeout, with a positive value on error, and with a negative value on
fatal error.

=== FILES ===

/usr/bin/socat
/usr/bin/filan
/usr/bin/procan

=== ENVIRONMENT VARIABLES ===

Input variables carry information from the environment to socat, output
variables are set by socat for use in executed scripts and programs.

In the output variables beginning with "SOCAT" this prefix is actually
replaced by the upper case name of the executable or the value of
option −lp.
SOCAT_DEFAULT_LISTEN_IP (input)

(Values 4 or 6) Sets the IP version to be used for listen, recv, and
recvfrom addresses if no pf (protocol−family) option is given. Is
overridden by socat options −4 or −6.

SOCAT_PREFERRED_RESOLVE_IP (input)

(Values 0, 4, or 6) Sets the IP version to be used when resolving
target host names when version is not specified by address type, option
pf (protocol−family), or address format. If name resolution does not
return a matching entry, the first result (with differing IP version)
is taken. With value 0, socat always selects the first record and its
IP version.

SOCAT_FORK_WAIT (input)

Specifies the time (seconds) to sleep the parent and child processes
after successful fork\(). Useful for debugging.

SOCAT_VERSION (output)

Socat sets this variable to its version string, e.g. "1.7.0.0" for
released versions or e.g. "1.6.0.1+envvar" for temporary versions; can
be used in scripts invoked by socat.

SOCAT_PID (output)

Socat sets this variable to its process id. In case of fork address
option, SOCAT_PID gets the child processes id. Forking for exec and
system does not change SOCAT_PID.

SOCAT_PPID (output)

Socat sets this variable to its process id. In case of fork, SOCAT_PPID
keeps the pid of the master process.

SOCAT_PEERADDR (output)

With passive socket addresses (all LISTEN and RECVFROM addresses), this
variable is set to a string describing the peers socket address. Port
information is not included.

SOCAT_PEERPORT (output)

With appropriate passive socket addresses (TCP, UDP, and SCTP − LISTEN
and RECVFROM), this variable is set to a string containing the number
of the peer port.

SOCAT_SOCKADDR (output)

With all LISTEN addresses, this variable is set to a string describing
the local socket address. Port information is not included example

SOCAT_SOCKPORT (output)

With TCP−LISTEN, UDP−LISTEN, and SCTP−LISTEN addresses, this variable
is set to the local port.

SOCAT_TIMESTAMP (output)

With all RECVFROM addresses where address option so−timestamp is
applied, socat sets this variable to the resulting timestamp.

SOCAT_IP_OPTIONS (output)

With all IPv4 based RECVFROM addresses where address option ip−recvopts
is applied, socat fills this variable with the IP options of the
received packet.

SOCAT_IP_DSTADDR (output)

With all IPv4 based RECVFROM addresses where address option
ip−recvdstaddr (BSD) or ip−pktinfo (other platforms) is applied, socat
sets this variable to the destination address of the received packet.
This is particularly useful to identify broadcast and multicast
addressed packets.

SOCAT_IP_IF (output)

With all IPv4 based RECVFROM addresses where address option ip−recvif
(BSD) or ip−pktinfo (other platforms) is applied, socat sets this
variable to the name of the interface where the packet was received.

SOCAT_IP_LOCADDR (output)

With all IPv4 based RECVFROM addresses where address option ip−pktinfo
is applied, socat sets this variable to the address of the interface
where the packet was received.

SOCAT_IP_TOS (output)

With all IPv4 based RECVFROM addresses where address option ip−recvtos
is applied, socat sets this variable to the TOS (type of service) of
the received packet.

SOCAT_IP_TTL (output)

With all IPv4 based RECVFROM addresses where address option ip−recvttl
is applied, socat sets this variable to the TTL (time to live) of the
received packet.

SOCAT_IPV6_HOPLIMIT (output)

With all IPv6 based RECVFROM addresses where address option
ipv6−recvhoplimit is applied, socat sets this variable to the hoplimit
value of the received packet.

SOCAT_IPV6_DSTADDR (output)

With all IPv6 based RECVFROM addresses where address option
ipv6−recvpktinfo is applied, socat sets this variable to the
destination address of the received packet.

SOCAT_IPV6_TCLASS (output)

With all IPv6 based RECVFROM addresses where address option
ipv6−recvtclass is applied, socat sets this variable to the transfer
class of the received packet.

SOCAT_OPENSSL_X509_ISSUER (output)

Issuer field from peer certificate

SOCAT_OPENSSL_X509_SUBJECT (output)

Subject field from peer certificate

SOCAT_OPENSSL_X509_COMMONNAME (output)

commonName entries from peer certificates subject. Multiple values are
separated by " // ".

SOCAT_OPENSSL_X509_* (output)

all other entries from peer certificates subject

SOCAT_OPENSSL_X509V3_DNS (output)

DNS entries from peer certificates extensions − subjectAltName field.
Multiple values are separated by " // ".

HOSTNAME (input)

Is used to determine the hostname for logging (see −lh).

LOGNAME (input)

Is used as name for the socks client user name if no socksuser is
given.
With options su and su−d, LOGNAME is set to the given user name.

USER (input)

Is used as name for the socks client user name if no socksuser is given
and LOGNAME is empty.
With options su and su−d, USER is set to the given user name.

SHELL (output)

With options su and su−d, SHELL is set to the login shell of the given
user.

PATH (output)

Can be set with option path for exec and system addresses.

HOME (output)

With options su and su−d, HOME is set to the home directory of the
given user.

=== CREDITS ===

The work of the following groups and organizations was invaluable for
this project:

The FSF (GNU, http://www.fsf.org/ project with their free and portable
development software and lots of other useful tools and libraries.

The Linux developers community (http://www.linux.org/) for providing a
free, open source operating system.

The Open Group (http://www.unix−systems.org/) for making their standard
specifications available on the Internet for free.

=== VERSION ===

This man page describes version 1.7.3 of socat.

=== BUGS ===

Addresses cannot be nested, so a single socat process cannot, e.g.,
drive ssl over socks.

Address option ftruncate without value uses default 1 instead of 0.

Verbose modes (−x and/or −v) display line termination characters
inconsistently when address options cr or crnl are used: They show the
data after conversion in either direction.

The data transfer blocksize setting (−b) is ignored with address
readline.

Send bug reports to <socat@dest−unreach.org>

=== SEE ALSO ===

nc\(1), netcat6\(1), sock\(1), rinetd\(8), cage\(1), socks.conf\(5),
openssl\(1), stunnel\(8), pty\(1), rlwrap\(1), setsid\(1)

Socat home page http://www.dest−unreach.org/socat/

=== AUTHOR ===

Gerhard Rieger <rieger@dest−unreach.org>

== ser2net ==

Ser2net ist OpenSource und steht unter https://sourceforge.net/projects/ser2net/files/ser2net/ zum Download zur Verfügung.

=== README der Version 3.5 vom 2017-11-22 (kommentiert)===

This is ser2net, a program for allowing network connections to serial
ports or [http://timelordz.com/wiki/IPMI_Configuration_and_Monitoring IMPI] (Intelligent Platform Monitoring Interface allow you to manage a server remotely.) Serial Over Lan ( SOL) connections.
See the man page for information about using the program.

Note that ser2net supports [https://tools.ietf.org/html/rfc2217 RFC2217]
(remote control of serial port parameters), but you must have a compliant client.
The only one I know of is [http://www.columbia.edu/kermit kermit].

ser2net supports making connections to IPMI SOL (serial over LAN)
capable systems. This way, if you have a system with SOL, you can use
it with programs that speak sockets and avoid having to run a serial
cable to the system. It uses [https://sourceforge.net/projects/openipmi/ OpenIPMI] for this, so you have to know
how to make an OpenIPMI connection to the remote system. That can be
rather complicated, but for a simple example, add a line like:

3022:telnet:0:sol.lan -U <userid> -P <password> <ipmi BMC IP>:115200

Obviously, use the IPMI BMC userid and password here. Depending on
your system there are a lot of other options, and configuration of
IPMI on the remote system is not for the faint of heart. And also, if
you put passwords in the ser2net.conf file, it becomes a security
issue and you should make it readable only by the user that runs
ser2net.

ser2net also supports threading. By default it runs with a single
thread but you can add '-t <num threads>' and it will spawn the given
number of threads. On modern Linux systems it uses [https://en.wikipedia.org/wiki/Epoll epoll] to avoid
the [https://en.wikipedia.org/wiki/Thundering_herd_problem "thundering herd"] issue, so it should be quite scalable. Also,
it runs reconfigurations in a separate thread to avoid a reconfig
blocking things up.

If you don't want to compile with threads, you can add
"--with-pthreads=no" to the configure line.

If you want the opposite of ser2net (you want to connect to a "local"
serial port device that is really remote) then Cyclades has provided
a tool for this at https://sourceforge.net/projects/cyclades-serial/.
It is capable of connecting to ser2net using RFC2217.

If you check this out from git, you won't have all the configure
programs and files, because those are generated. Do:
autoreconf -i
to generate everything first. Then you can run configure.

=== NAME ===

ser2net − Serial to network proxy

=== SYNOPSIS ===
(Zusammenfassung)

ser2net [−c configfile] [−C configline] [−p controlport] [−n] [−d] [−b] [−v] [-P pidfile]

=== DESCRIPTION ===

The ser2net daemon allows telnet and tcp sessions to be established
with a unit’s serial ports.

The program comes up normally as a daemon, opens the TCP ports
specified in the configuration file, and waits for connections. Once a
connection occurs, the program attempts to set up the connection and
open the serial port. If another user is already using the connection
or serial port, the connection is refused with an error message.

=== OPTIONS ===

{| class="wikitable"
|-
! Nr. !! Option !! Originaltext !! Übersetzung/Erläuterung
|-
| 1 || −c config−file || Set the configuration file to one other than the default of /etc/ser2net.conf || Beispiel
|-
| 2 || −C config-line || Handle a single configuration line. This may be specified multiple times for multiple lines. This is just like a line in the config file. This disables the default config file, you must specify a -c after the last -C to have it read a config file, too. || Beispiel
|-
| 3 || -n || Stops the daemon from forking and detaching from the controlling terminal. This is useful for running from init. || Beispiel
|-
| 4 || -d|| Like -n, but also sends the system logs to standard output. This is most useful for debugging purposes. || Beispiel
|-
| 5 || -P pidfile || If specified, put the process id (pid) of ser2net in the pidfile, replacing whatever was in that file previously. A pidfile is not created by default, you must specify this to create one. Note also that this filename must be specific with the full path, as ser2net will change directory to "/" when it becomes a daemon. when it|| Beispiel
|-
| 6 || -u || If UUCP locking is enabled, this will disable the use of UUCP locks. || Beispiel
|-
| 7 || -b || Cisco IOS uses a different mechanism for specifying the baud rates than the mechanism described in RFC2217. This option sets the IOS version of setting the baud rates. The default is RFC2217’s. Note that this capability is now handled automatically and this option is ignored. || Beispiel
|-
| 8 || -v || Prints the version of the program and exits. || Beispiel
|-
| 9 || −p controlport || Enables the control port and sets the TCP port to listen to for the control port. A port number may be of the form [host,]port, such as 127.0.0.1,2000 or localhost,2000. If this is specified, it will only bind to the IP address specified for the port. Otherwise, it will bind to all the addresses on the machine. If the port number is zero, that means that standard in/out will be used for the only input/output, and only one port should be specified in the config. This way, it can be used from inetd. || Beispiel
|-
| 10 || −s signature || Specifies the default RFC2217 signature. || Beispiel
|}

=== CONTROL PORT ===

The control port provides a simple interface for controlling the ports
and viewing their status. To accomplish this, it has the following
commands:

'''showport [<TCP port>]'''
Show information about a port. If no port is given, all ports are
displayed.

'''showshortport [<TCP port>]'''
Show information about a port, each port on one line. If no port is
given, all ports are displayed. This can produce very wide output.

'''help'''
Display a short list and summary of commands.

'''exit'''
Disconnect from the control port.

'''version'''
Display the version of this program.

'''monitor <type> <tcp port>'''
Display all the input for a given port on the calling control port.
Only one direction may be monitored at a time. The type field may be
tcp or term and specifies whether to monitor data from the TCP port or
from the serial port Note that data monitoring is best effort, if the
controller port cannot keep up the data will be silently dropped. A
controller may only monitor one thing and a port may only be monitored
by one controller.

'''monitor stop'''
Stop the current monitor.

'''disconnect <tcp port>'''
Disconnect the tcp connection on the port.

'''setporttimeout <tcp port> <timeout>'''
Set the amount of time in seconds before the port connection will be
shut down if no activity has been seen on the port.

'''setportconfig <tcp port> <config>'''
Set the port configuration as in the device configuration in the
/etc/ser2net.conf file. If conflicting options are specified, the last
option will be the one used. Note that these will not change until the
port is disconnected and connected again. Options 300, 1200, 2400,
4800, 9600, 19200, 38400, 57600, 115200 set the various baud rates.
EVEN, ODD, NONE set the parity. 1STOPBIT, 2STOPBITS set the number of
stop bits. 7DATABITS, 8DATABITS set the number of data bits. [-]XONXOFF
turns on (- off) XON/XOFF support. [-]RTSCTS turns on (- off) hardware
flow control. [-]LOCAL ignores (- checks) the modem control lines (DCD,
DTR, etc.)

'''setportcontrol <tcp port> <controls>'''
Modify dynamic port controls. These do not stay between connections.
Controls are: DTRHI, DTRLO Turns on and off the DTR line. RTSHI, RTSLO
Turns on and off the RTS line.

'''setportenable <tcp port> <enable state>'''
Sets the port operation state. Valid states are: off to shut the TCP
port down, raw to enable the TCP port transfer all I/O as-is, rawlp to
enable the TCP port input and device output without termios setting,
and telnet to enable the TCP port is up run the telnet negotiation
protocol on the port.

=== CONFIGURATION ===

Configuration is accomplished through the file /etc/ser2net.conf. A
file with another name or path may be specified using the −c option, or
individual config lines may be specified with the −C option. This file
consists of one or more entries with the following format:

<TCP port>:<state>:<timeout>:<device>:<options>

or

BANNER:<banner name>:<banner text>

or

SIGNATURE:<signature name>:<signature text>

or

OPENSTR:<openstr name>:<openstr text>

or

CLOSESTR:<closestr name>:<closestr text>

or

TRACEFILE:<tracefile name>:<tracefile>

or

CONTROLPORT:<port spec>

=== FIELDS ===

'''TCP port'''
Name or number of the TCP/IP port to accept connections from for this
device. A port number may be of the form
'''[host,]port''', such as 127.0.0.1,2000 or localhost,2000, or ::,2000.
If this is specified, it will only bind to the IP address specified for the port.
Otherwise, it will bind to all the ports on the machine.
You can specify an IPV6 address in the port, any colon before the comma is ignored for parsing fields.

'''state'''
Either '''raw''' or '''rawlp''' or '''telnet''' or '''off'''.
off disables the port from accepting connections.
It can be turned on later from the control port.
raw enables the port and transfers all data as-is between the port and
the long. rawlp enables the port and transfers all input data to
device, device is open without any termios setting. It allow to use
/dev/lpX devices and printers connected to them. telnet enables the
port and runs the telnet protocol on the port to set up telnet
parameters. This is most useful for using telnet.

'''timeout'''
The '''time''' (in seconds) before the port will be disconnected if there is
no activity on it. A zero value disables this function.

'''device'''
The name of the device to connect to. This must be in the form of
'''/dev/<device>'''.

'''device configuration options'''
Sets operational parameters for the serial port.
Values may be separated by spaces or commas.
Options
* '''300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200''' set the various baud rates.
* '''EVEN, ODD, NONE''' set the parity.
* '''1STOPBIT, 2STOPBITS''' set the number of stop bits.
* '''7DATABITS, 8DATABITS''' set the number of data bits.
* '''[-]XONXOFF''' turns on (- off) XON/XOFF support.
* '''[-]RTSCTS''' turns on (- off) hardware flow control.
* '''[-]LOCAL''' ignores (- checks) the modem control lines (DCD, DTR, etc.)
* '''[-]HANGUP_WHEN_DONE''' lowers (- does not lower) the modem control lines (DCD, DTR, etc.) when the connection closes.
* '''NOBREAK''' disables automatic clearing of the break setting of the port.
HINT: A serial break is not a character. It is a signal that can be sent using the TX line of the device sending the break.
When a serial port is idle and no data is being sent the TX line is in a logical 1 state. While data is being send the TX line rapidly transitions between logical 0 and logical 1.
Each frame of data takes a certain period of time to send, depending on the bit rate of the connection. This is called the "frame time" or "word time".
A break occurs when the TX line is held to a logical 0 for longer than one frame time.
There are short breaks and long breaks. In general a short break is one that lasts longer than one frame time, but less than two frame times. A long break can last two or more frame times.
Most serial devices that support breaks use a short break.
* '''remctl''' allows remote control of the serial port parameters via RFC 2217. See the README for more info.
* '''kickolduser''' sets the port so that the previous user will be kicked off if a new user comes in. Useful if you forget to log off from someplace else a lot.
* '''<banner name>''' displays the given banner when a user connects to the port.
* '''<signature name>''' sends RFC 2217 signature on clients request.
* '''<openstr name>''' Send the given string to the device when the port is opened.
* '''<closestr name>''' Send the given string to the device when the port is closed.
* '''tr=<filename>''' When the port is opened, open the given tracefile and
store all data read from the physical device (and thus written to the
user’s TCP port) in the file. The actual filename is specified in the
TRACEFILE directive. If the file already exists, it is appended. The
file is closed when the port is closed.
* '''tw=<filename>''' Like tr, but traces data written to the device.
* '''tb=<filename>''' trace both read and written data to the same file. Note
that this is independent of tr and tw, so you may be tracing read,
write, and both to different files.
* '''[-]hexdump''' turns on (- turns off) hexdump output to all trace files.
Each line in the trace file will be 8 (or less) bytes in canonical
hex+ASCII format. This is useful for debugging a binary protocol.
* '''[-]timestamp''' adds (- removes) a timestamp to all of the trace files. A
timestamp is prepended to each line if hexdump is active for the trace
file. A timestamped line is also recorded in the trace file when a
remote client connects or disconnects from the port.
* '''[-][tr-|tw-|tb-]hexdump''' turns on (- turns off) hexdump output for only
one trace file. May be combined with [-]hexdump. Order is important.
* '''[-][tr-|tw-|tb-]timestamp''' adds (- removes) a timestamp to only one the
trace files May be combined with [-]timestamp. Order is important.

'''banner name'''
A '''name''' for the banner; this may be used in the options of a port.

'''banner text'''
The '''text''' to display as the banner. It takes escape sequences for
substituting strings, see [[#FBSF|"FILENAME, BANNER, AND STRING FORMATTING"]] for
details.

'''tracefile name'''
A '''name''' for the tracefile, this is used in the tw, tr, and tb options of
a port.

'''tracefile'''
The '''file''' to send the trace into. Note that this takes escape sequences
for substituting strings, see [[#FBSF|"FILENAME, BANNER, AND STRING FORMATTING"]]
for details. Note that when using the time escape sequences, the time
is read once at port startup, so if you use both tw and tr they will
have the same date and time.

'''port spec'''
The control '''port''' specification as defined by the [−p] option on the
command line. This lets the control port be specified in the
configuration file. The command line will override this, and only the
first port specified is used.

Blank lines and lines starting with ‘#’ are ignored.

<span id="FBSF"></span>

=== FILENAME, BANNER, AND STRING FORMATTING ===

Filenames, banners, and open/close string may contain normal "C" escape
sequences and a large number of other escape sequences, too:

\a - bell
\b - backspace
\f - form feed
\n - newline
\r - carriage return
\t - tab
\v - vertical tab
\\ - \
\? - ?
\’ - ’
\" - "
\nnn - octal value for nnn
\xXX - hex value for XX
\d - The device name (/dev/ttyS0, etc.)
\p - TCP port number
\B - The serial port parameters (eg 9600N81)
\Y -> year
\y -> day of the year (days since Jan 1)
\M -> month (Jan, Feb, Mar, etc.)
\m -> month (as a number)
\A -> day of the week (Mon, Tue, etc.)
\D -> day of the month
\e -> epoc (seconds since Jan 1, 1970)
\U -> microseconds in the current second
\p -> local port number
\d -> local device name
\I -> remote IP address (in dot format)
\H -> hour (24-hour time)
\h -> hour (12-hour time)
\i -> minute
\S -> second
\q -> am/pm
\P -> AM/PM

In addition, for backwards compatibility because filenames and banners
used to have different formatting, \s is the serial port parameters if
in a banner and seconds if in a filename. Use of this is discouraged as
it may change in the future.

These sequences may be used to make the filename unique per open and
identify which port/device the filename was for. Note that in filenames
when using \d, everything up to and including last / in the device name
is removed, because you can’t have a / in a filename. So in a filename
/dev/ttyS0 would become just ttyS0.

=== SECURITY ===

ser2net uses the tcp wrappers interface to implement host-based
security. See hosts_access(5) for a description of the file setup. Two
daemons are used by ser2net, "ser2net" is for the data ports and
"ser2net-control" is for the control ports.

=== SIGNALS ===

'''SIGHUP'''

If ser2net receives a SIGHUP, it will reread it configuration file and
make the appropriate changes. If an inuse port is changed or deleted,
the actual change will not occur until the port is disconnected.

=== Error ===

Almost all error output goes to syslog, not standard output.

=== FILES ===

/etc/ser2net.conf

=== SEE ALSO ===

telnet(1), hosts_access(5)

=== KNOWN PROBLEMS ===

None.

=== AUTHOR ===

Corey Minyard <minyard@acm.org>

== nc (netcat) ==

=== NAME ===

nc — arbitrary TCP and UDP connections and listens

nc oder netcat (oft nur ein Link/Verknüpfung auf nc) ist ein Programm mit dem man nach Belieben, Verbindungen oder einfach nur "Zuhörer" für TCP oder UDP realisieren kann.

=== SYNOPSIS ===
(Zusammenfassung)

nc [−46DdhklnrStUuvzC] [−i interval] [−P proxy_username] [−p source_port] [−s source_ip_address] [−T ToS] [−w timeout] [−X proxy_protocol] [−x proxy_address[:port]] [hostname] [port[s]]

Aus der Syntax kann man erkennen, dass sich (ohne Fehlermeldung) nc gänzlich ohne Parameter aufrufen lässt.
Es wird in diesem Fall ggf. folgender Hinweis ausgegeben:

This is nc from the netcat-openbsd package. An alternative nc is available in the netcat-traditional package.

=== DESCRIPTION ===

The nc (or netcat) utility is used for just about anything under the
sun involving TCP or UDP. It can open TCP connections, send UDP
packets, listen on arbitrary TCP and UDP ports, do port scanning, and
deal with both IPv4 and IPv6. Unlike telnet(1), nc scripts nicely, and
separates error messages onto standard error instead of sending them to
standard output, as telnet(1) does with some.

Common uses include:
* simple TCP proxies
* shell-script based HTTP clients and servers
* network daemon testing
* a SOCKS or HTTP ProxyCommand for ssh(1)
* and much, much more

=== OPTIONS ===

The 25 options are as follows:

{| class="wikitable"
|-
! Überschrift !! Überschrift !! Überschrift
|-
| 1 || '''-4''' || Forces nc to use IPv4 addresses only. ||
|-
| 2 || '''-6''' || Forces nc to use IPv6 addresses only. ||
|-
| 3 || '''-D''' || Enable debugging on the socket. ||
|-
| 4 || '''-d''' || Do not attempt to read from stdin. ||
|-
| 5 || '''-h''' || Prints out nc help. ||
|-
| 6 || '''-i interval''' || Specifies a delay time interval between lines of text sent and received. Also causes a delay time between connections to multiple ports. ||
|-
| 7 || '''-k''' || Forces nc to stay listening for another connection after its current connection is completed. It is an error to use this option without the −l option. ||
|-
| 8 || '''-l''' || Used to specify that nc should listen for an incoming connection rather than initiate a connection to a remote host. It is an error to use this option in conjunction with the −p, −s, or −z options. Additionally, any timeouts specified with the −w option are ignored. ||
|-
| 9 || '''-n''' || Do not do any DNS or service lookups on any specified addresses, hostnames or ports. ||
|-
| 10 || '''−P proxy_username''' || Specifies a username to present to a proxy server that requires authentication. If no username is specified then authentication will not be attempted. Proxy authentication is only supported for HTTP CONNECT proxies at present. ||
|-
| 11 || '''−p source_port''' || Specifies the source port nc should use, subject to privilege restrictions and availability. It is an error to use this option in conjunction with the −l option. ||
|-
| 12 || '''-q''' || after EOF on stdin, wait the specified number of seconds and then quit. If seconds is negative, wait forever. ||
|-
| 13 || '''-r''' || Specifies that source and/or destination ports should be chosen randomly instead of sequentially within a range or in the order that the system assigns them. ||
|-
| 14 || '''-S''' || Enables the RFC 2385 TCP MD5 signature option. ||
|-
| 15 || '''−s source_ip_address''' || Specifies the IP of the interface which is used to send the packets. It is an error to use this option in conjunction with the −l option. ||
|-
| 16 || '''−T ToS''' || Specifies IP Type of Service (ToS) for the connection. Valid values are the tokens ‘‘lowdelay’’, ‘‘throughput’’, ‘‘reliability’’, or an 8-bit hexadecimal value preceded by ‘‘0x’’. ||
|-
| 17|| '''-C''' || Send CRLF as line-ending ||
|-
| 18 || '''-t''' || Causes nc to send RFC 854 DON’T and WON’T responses to RFC 854 DO and WILL requests. This makes it possible to use nc to script telnet sessions. ||
|-
| 19 || '''-U''' || Specifies to use Unix Domain Sockets. ||
|-
| 20 || '''-u''' || Use UDP instead of the default option of TCP. ||
|-
| 21 || '''-v''' || Have nc give more verbose output. ||
|-
| 22 || '''−w timeout''' || If a connection and stdin are idle for more than timeout seconds, then the connection is silently closed. The −w flag has no effect on the −l option, i.e. nc will listen forever for a connection, with or without the −w flag. The default is no timeout. ||
|-
| 23 || '''−X proxy_protocol''' || Requests that nc should use the specified protocol when talking to the proxy server. Supported protocols are ‘‘4’’ (SOCKS v.4), ‘‘5’’ (SOCKS v.5) and ‘‘connect’’ (HTTPS proxy). If the protocol is not specified, SOCKS version 5 is used. ||
|-
| 24 || '''−x proxy_address[:port]''' || Requests that nc should connect to hostname using a proxy at proxy_address and port. If port is not specified, the well-known port for the proxy protocol is used (1080 for SOCKS, 3128 for HTTPS). ||
|-
| 25 || '''−z''' || Specifies that nc should just scan for listening daemons, without sending any data to them. It is an error to use this option in conjunction with the −l option. ||
|}

hostname can be a numerical IP address or a symbolic hostname (unless
the −n option is given). In general, a hostname must be specified,
unless the −l option is given (in which case the local host is used).

port[s] can be single integers or ranges. Ranges are in the form nn-mm.
In general, a destination port must be specified, unless the −U option
is given (in which case a socket must be specified).

=== CLIENT/SERVER MODEL ===

It is quite simple to build a very basic client/server model using nc.
On one console, start nc listening on a specific port for a connection.
For example:

$ nc -l 1234

nc is now listening on port 1234 for a connection. On a second console
(or a second machine), connect to the machine and port being listened
on:

$ nc 127.0.0.1 1234

There should now be a connection between the ports. Anything typed at
the second console will be concatenated to the first, and vice-versa.
After the connection has been set up, nc does not really care which
side is being used as a ‘server’ and which side is being used as a
‘client’. The connection may be terminated using an EOF (‘^D’).

=== DATA TRANSFER ===

The example in the previous section can be expanded to build a basic
data transfer model. Any information input into one end of the
connection will be output to the other end, and input and output can be
easily captured in order to emulate file transfer.

Start by using nc to listen on a specific port, with output captured
into a file:

$ nc -l 1234 > filename.out

Using a second machine, connect to the listening nc process, feeding it
the file which is to be transferred:

$ nc host.example.com 1234 < filename.in

After the file has been transferred, the connection will close
automatically.

=== TALKING TO SERVERS ===

It is sometimes useful to talk to servers ‘‘by hand’’ rather than
through a user interface. It can aid in troubleshooting, when it might
be necessary to verify what data a server is sending in response to
commands issued by the client. For example, to retrieve the home page
of a web site:

$ echo -n "GET / HTTP/1.0\r\n\r\n" | nc host.example.com 80

Note that this also displays the headers sent by the web server. They
can be filtered, using a tool such as sed(1), if necessary.

More complicated examples can be built up when the user knows the
format of requests required by the server. As another example, an email
may be submitted to an SMTP server using:

$ nc [-C] localhost 25 << EOF
HELO host.example.com
MAIL FROM:<user@host.example.com>
RCPT TO:<user2@host.example.com>
DATA
Body of email.
.
QUIT
EOF

=== PORT SCANNING ===

It may be useful to know which ports are open and running services on a
target machine. The −z flag can be used to tell nc to report open
ports, rather than initiate a connection. For example:

$ nc -z host.example.com 20-30
Connection to host.example.com 22 port [tcp/ssh] succeeded!
Connection to host.example.com 25 port [tcp/smtp] succeeded!

The port range was specified to limit the search to ports 20 − 30.

Alternatively, it might be useful to know which server software is
running, and which versions. This information is often contained within
the greeting banners. In order to retrieve these, it is necessary to
first make a connection, and then break the connection when the banner
has been retrieved. This can be accomplished by specifying a small
timeout with the −w flag, or perhaps by issuing a "QUIT" command to the
server:

$ echo "QUIT" | nc host.example.com 20-30
SSH-1.99-OpenSSH_3.6.1p2
Protocol mismatch.
220 host.example.com IMS SMTP Receiver Version 0.84 Ready

=== (more) EXAMPLES ===

Open a TCP connection to port 42 of host.example.com, using port 31337
as the source port, with a timeout of 5 seconds:

$ nc -p 31337 -w 5 host.example.com 42

Open a UDP connection to port 53 of host.example.com:

$ nc -u host.example.com 53

Open a TCP connection to port 42 of host.example.com using 10.1.2.3 as
the IP for the local end of the connection:

$ nc -s 10.1.2.3 host.example.com 42

Create and listen on a Unix Domain Socket:

$ nc -lU /var/tmp/dsocket

Connect to port 42 of host.example.com via an HTTP proxy at 10.2.3.4,
port 8080. This example could also be used by ssh(1); see the
ProxyCommand directive in ssh_config(5) for more information.

$ nc -x10.2.3.4:8080 -Xconnect host.example.com 42

The same example again, this time enabling proxy authentication with
username ‘‘ruser’’ if the proxy requires it:

$ nc -x10.2.3.4:8080 -Xconnect -Pruser host.example.com 42

=== SEE ALSO ===

cat(1), ssh(1)

=== AUTHORS ===

Original implementation by *Hobbit* 〈 hobbit@avian.org〉 .
Rewritten with IPv6 support by Eric Jackson <ericj@monkey.org>.

=== CAVEATS ===

UDP port scans will always succeed (i.e. report the port as open),
rendering the −uz combination of flags relatively useless.

BSD April 22, 2017 BSD

== setserial ==

Die Angaben beziehen sich auf setserial version 2.17, 27-Jan-2000.

=== NAME ===

setserial − get/set Linux serial port information

=== SYNOPSIS ===

setserial [ −abqvVWz ] device [ parameter1 [ arg ] ] ...

setserial -g [ −abGv ] device1 ...

Man beachte hier die eckige Klammerung mit Leerzeichen und die Reihenfolge aller Übergabeparameter,
die nicht mit der Angabe der Ausgabe bei z. B. -v übereinstimmt!

#setserial -v
setserial version 2.17, 27-Jan-2000

usage: setserial serial-device -abqvVWz [cmd1 [arg]] ...
setserial -g [-abGv] device1 ...

=== DESCRIPTION ===

setserial is a program designed to set and/or report the configuration
information associated with a serial port. This information includes
what I/O port and IRQ a particular serial port is using, and whether or
not the break key should be interpreted as the Secure Attention Key,
and so on.

During the normal bootup process, only COM ports 1-4 are initialized,
using the default I/O ports and IRQ values, as listed below. In order
to initialize any additional serial ports, or to change the COM 1-4
ports to a nonstadard configuration, the setserial program should be
used. Typically it is called from an rc.serial script, which is usually
run out of /etc/rc.local.

The device argument or arguments specifies the serial device which
should be configured or interrogated. It will usually have the
following form: /dev/cua[0-3].

If no parameters are specified, setserial will print out the port type
(i.e., 8250, 16450, 16550, 16550A, etc.), the hardware I/O port, the
hardware IRQ line, its "baud base," and some of its operational flags.

If the −g option is given, the arguments to setserial are interpreted
as a list of devices for which the characteristics of those devices
should be printed.

Without the −g option, the first argument to setserial is interpreted
as the device to be modified or characteristics to be printed, and any
additional arguments are interpreted as parameters which should be
assigned to that serial device.

For the most part, superuser privilege is required to set the
configuration parameters of a serial port. A few serial port parameters
can be set by normal users, however, and these will be noted as
exceptions in this manual page.

=== OPTIONS ===

Setserial accepts the following options:

{| class="wikitable"
|-
! Nr. !! Option !! Originaltext!! Übersetzung/Erläuterung
|-
| 1 || -a || When reporting the configuration of a serial device, print all available information. || Beispiel
|-
| 2 || -b || When reporting the configuration of a serial device, print a summary of the device’s configuration, which might be suitable for printing during the bootup process, during the /etc/rc script. || Beispiel
|-
| 3 || -G || Print out the configuration information of the serial port in a form which can be fed back to setserial as command-line arguments. || Beispiel
|-
| 4 || -q || Be quiet. Setserial will print fewer lines of output. || Beispiel
|-
| 5 || -v || Be verbose. Setserial will print additional status output.|| Beispiel
|-
| 6 || -V || Display version and exit. || Beispiel
|-
| 7 || -W || Do wild interrupt initialization and exit. This option is no longer relevant in Linux kernels after version 2.1. || Beispiel
|-
| 8 || -z || Zero out the serial flags before starting to set flags. This is related to the automatic saving of serial flags using the −G flag. || Beispiel
|}

=== PARAMETERS ===

The following parameters can be assigned to a serial port.

All argument values are assumed to be in decimal unless preceeded by
"0x".
port port_number

The port option sets the I/O port, as described above.

irq irq_number

The irq option sets the hardware IRQ, as described above.

uart uart_type

This option is used to set the UART type. The permitted types are none,
8250, 16450, 16550, 16550A, 16650, 16650V2, 16654, 16750, 16850, 16950,
and 16954. Using UART type none will disable the port.

Some internal modems are billed as having a "16550A UART with a 1k
buffer". This is a lie. They do not have really have a 16550A
compatible UART; instead what they have is a 16450 compatible UART with
a 1k receive buffer to prevent receiver overruns. This is important,
because they do not have a transmit FIFO. Hence, they are not
compatible with a 16550A UART, and the autoconfiguration process will
correctly identify them as 16450’s. If you attempt to override this
using the uart parameter, you will see dropped characters during file
transmissions. These UART’s usually have other problems: the skip_test
parameter also often must be specified.

autoconfig

When this parameter is given, setserial will ask the kernel to attempt
to automatically configure the serial port. The I/O port must be
correctly set; the kernel will attempt to determine the UART type, and
if the auto_irq parameter is set, Linux will attempt to automatically
determine the IRQ. The autoconfig parameter should be given after the
port,auto_irq, and skip_test parameters have been specified.

auto_irq

During autoconfiguration, try to determine the IRQ. This feature is not
guaranteed to always produce the correct result; some hardware
configurations will fool the Linux kernel. It is generally safer not to
use the auto_irq feature, but rather to specify the IRQ to be used
explicitly, using the irq parameter.

^auto_irq

During autoconfiguration, do not try to determine the IRQ.

skip_test

During autoconfiguration, skip the UART test. Some internal modems do
not have National Semiconductor compatible UART’s, but have cheap
imitations instead. Some of these cheasy imitations UART’s do not fully
support the loopback detection mode, which is used by the kernel to
make sure there really is a UART at a particular address before
attempting to configure it. So for certain internal modems you will
need to specify this parameter so Linux can initialize the UART
correctly.

^skip_test

During autoconfiguration, do not skip the UART test.

baud_base baud_base

This option sets the base baud rate, which is the clock frequency
divided by 16. Normally this value is 115200, which is also the fastest
baud rate which the UART can support.

spd_hi

Use 57.6kb when the application requests 38.4kb. This parameter may be
specified by a non-privileged user.

spd_vhi

Use 115kb when the application requests 38.4kb. This parameter may be
specified by a non-privileged user.

spd_shi

Use 230kb when the application requests 38.4kb. This parameter may be
specified by a non-privileged user.

spd_warp

Use 460kb when the application requests 38.4kb. This parameter may be
specified by a non-privileged user.

spd_cust

Use the custom divisor to set the speed when the application requests
38.4kb. In this case, the baud rate is the baud_base divided by the
divisor. This parameter may be specified by a non-privileged user.

spd_normal

Use 38.4kb when the application requests 38.4kb. This parameter may be
specified by a non-privileged user.

divisor divisor

This option sets the custom divison. This divisor will be used then the
spd_cust option is selected and the serial port is set to 38.4kb by the
application. This parameter may be specified by a non-privileged user.

sak

Set the break key at the Secure Attention Key.

^sak

disable the Secure Attention Key.

fourport

Configure the port as an AST Fourport card.

^fourport

Disable AST Fourport configuration.

close_delay delay

Specify the amount of time, in hundredths of a second, that DTR should
remain low on a serial line after the callout device is closed, before
the blocked dialin device raises DTR again. The default value of this
option is 50, or a half-second delay.

closing_wait delay

Specify the amount of time, in hundredths of a second, that the kernel
should wait for data to be transmitted from the serial port while
closing the port. If "none" is specified, no delay will occur. If
"infinite" is specified the kernel will wait indefinitely for the
buffered data to be transmitted. The default setting is 3000 or 30
seconds of delay. This default is generally appropriate for most
devices. If too long a delay is selected, then the serial port may hang
for a long time if when a serial port which is not connected, and has
data pending, is closed. If too short a delay is selected, then there
is a risk that some of the transmitted data is output at all. If the
device is extremely slow, like a plotter, the closing_wait may need to
be larger.

session_lockout

Lock out callout port (/dev/cuaXX) accesses across different sessions.
That is, once a process has opened a port, do not allow a process with
a different session ID to open that port until the first process has
closed it.

^session_lockout

Do not lock out callout port accesses across different sessions.

pgrp_lockout

Lock out callout port (/dev/cuaXX) accesses across different process
groups. That is, once a process has opened a port, do not allow a
process in a different process group to open that port until the first
process has closed it.

^pgrp_lockout

Do not lock out callout port accesses across different process groups.

hup_notify

Notify a process blocked on opening a dial in line when a process has
finished using a callout line (either by closing it or by the serial
line being hung up) by returning EAGAIN to the open.

The application of this parameter is for getty’s which are blocked on a
serial port’s dial in line. This allows the getty to reset the modem
(which may have had its configuration modified by the application using
the callout device) before blocking on the open again.

^hup_notify

Do not notify a process blocked on opening a dial in line when the
callout device is hung up.

split_termios

Treat the termios settings used by the callout device and the termios
settings used by the dialin devices as separate.

^split_termios

Use the same termios structure to store both the dialin and callout
ports. This is the default option.

callout_nohup

If this particular serial port is opened as a callout device, do not
hangup the tty when carrier detect is dropped.

^callout_nohup

Do not skip hanging up the tty when a serial port is opened as a
callout device. Of course, the HUPCL termios flag must be enabled if
the hangup is to occur.

low_latency

Minimize the receive latency of the serial device at the cost of
greater CPU utilization. (Normally there is an average of 5-10ms
latency before characters are handed off to the line discpline to
minimize overhead.) This is off by default, but certain real-time
applications may find this useful.

^low_latency

Optimize for efficient CPU processing of serial characters at the cost
of paying an average of 5-10ms of latency before the characters are
processed. This is the default.

=== CONSIDERATIONS OF CONFIGURING SERIAL PORTS ===

It is important to note that setserial merely tells the Linux kernel
where it should expect to find the I/O port and IRQ lines of a
particular serial port. It does *not* configure the hardware, the
actual serial board, to use a particular I/O port. In order to do that,
you will need to physically program the serial board, usually by
setting some jumpers or by switching some DIP switches.

This section will provide some pointers in helping you decide how you
would like to configure your serial ports.

The "standard MS-DOS" port associations are given below:

/dev/ttys0 (COM1), port 0x3f8, irq 4
/dev/ttys1 (COM2), port 0x2f8, irq 3
/dev/ttys2 (COM3), port 0x3e8, irq 4
/dev/ttys3 (COM4), port 0x2e8, irq 3

Due to the limitations in the design of the AT/ISA bus architecture,
normally an IRQ line may not be shared between two or more serial
ports. If you attempt to do this, one or both serial ports will become
unreliable if you try to use both simultaneously. This limitation can
be overcome by special multi-port serial port boards, which are
designed to share multiple serial ports over a single IRQ line.
Multi-port serial cards supported by Linux include the AST FourPort,
the Accent Async board, the Usenet Serial II board, the Bocaboard
BB-1004, BB-1008, and BB-2016 boards, and the HUB-6 serial board.

The selection of an alternative IRQ line is difficult, since most of
them are already used. The following table lists the "standard MS-DOS"
assignments of available IRQ lines:

IRQ 3: COM2
IRQ 4: COM1
IRQ 5: LPT2
IRQ 7: LPT1

Most people find that IRQ 5 is a good choice, assuming that there is
only one parallel port active in the computer. Another good choice is
IRQ 2 (aka IRQ 9); although this IRQ is sometimes used by network
cards, and very rarely VGA cards will be configured to use IRQ 2 as a
vertical retrace interrupt. If your VGA card is configured this way;
try to disable it so you can reclaim that IRQ line for some other card.
It’s not necessary for Linux and most other Operating systems.

The only other available IRQ lines are 3, 4, and 7, and these are
probably used by the other serial and parallel ports. (If your serial
card has a 16bit card edge connector, and supports higher interrupt
numbers, then IRQ 10, 11, 12, and 15 are also available.)

On AT class machines, IRQ 2 is seen as IRQ 9, and Linux will interpret
it in this manner.

IRQ’s other than 2 (9), 3, 4, 5, 7, 10, 11, 12, and 15, should not be
used, since they are assigned to other hardware and cannot, in general,
be changed. Here are the "standard" assignments:

IRQ 0 Timer channel 0
IRQ 1 Keyboard
IRQ 2 Cascade for controller 2
IRQ 3 Serial port 2
IRQ 4 Serial port 1
IRQ 5 Parallel port 2 (Reserved in PS/2)
IRQ 6 Floppy diskette
IRQ 7 Parallel port 1
IRQ 8 Real-time clock
IRQ 9 Redirected to IRQ2
IRQ 10 Reserved
IRQ 11 Reserved
IRQ 12 Reserved (Auxillary device in PS/2)
IRQ 13 Math coprocessor
IRQ 14 Hard disk controller
IRQ 15 Reserved

=== MULTIPORT CONFIGURATION ===

Certain multiport serial boards which share multiple ports on a single
IRQ use one or more ports to indicate whether or not there are any
pending ports which need to be serviced. If your multiport board
supports these ports, you should make use of them to avoid potential
lockups if the interrupt gets lost.

In order to set these ports specify set_multiport as a parameter, and
follow it with the multiport parameters. The multiport parameters take
the form of specifying the port that should be checked, a mask which
indicate which bits in the register are significant, and finally, a
match parameter which specifies what the significant bits in that
register must match when there is no more pending work to be done.

Up to four such port/mask/match combinations may be specified. The
first such combinations should be specified by setting the parameters
port1, mask1, and match1. The second such combination should be
specified with port2, mask2, and match2, and so on. In order to disable
this multiport checking, set port1 to be zero.

In order to view the current multiport settings, specify the parameter
get_multiport on the command line.

Here are some multiport settings for some common serial boards:

AST FourPort port1 0x1BF mask1 0xf match1 0xf

Boca BB-1004/8 port1 0x107 mask1 0xff match1 0

Boca BB-2016 port1 0x107 mask1 0xff match1 0
port2 0x147 mask2 0xff match2 0

=== Hayes ESP Configuration ===

Setserial may also be used to configure ports on a Hayes ESP serial
board.

The following parameters when configuring ESP ports:
rx_trigger

This is the trigger level (in bytes) of the receive FIFO. Larger values
may result in fewer interrupts and hence better performance; however, a
value too high could result in data loss. Valid values are 1 through
1023.

tx_trigger

This is the trigger level (in bytes) of the transmit FIFO. Larger
values may result in fewer interrupts and hence better performance;
however, a value too high could result in degraded transmit
performance. Valid values are 1 through 1023.

flow_off

This is the level (in bytes) at which the ESP port will "flow off" the
remote transmitter (i.e. tell him to stop stop sending more bytes).
Valid values are 1 through 1023. This value should be greater than the
receive trigger level and the flow on level.

flow_on

This is the level (in bytes) at which the ESP port will "flow on" the
remote transmitter (i.e. tell him to resume sending bytes) after having
flowed it off. Valid values are 1 through 1023. This value should be
less than the flow off level, but greater than the receive trigger
level.

rx_timeout

This is the amount of time that the ESP port will wait after receiving
the final character before signaling an interrupt. Valid values are 0
through 255. A value too high will increase latency, and a value too
low will cause unnecessary interrupts.

=== CAUTION ===

CAUTION: Configuring a serial port to use an incorrect I/O port can
lock up your machine.

=== FILES ===

/etc/rc.local /etc/rc.serial

=== SEE ALSO ===

tty(4), ttys(4), kernel/chr_drv/serial.c

=== AUTHOR ===

The original version of setserial was written by Rick Sladkey
(jrs@world.std.com), and was modified by Michael K. Johnson
(johnsonm@stolaf.edu).

This version has since been rewritten from scratch by Theodore Ts’o
(tytso@mit.edu) on 1/1/93. Any bugs or problems are solely his
responsibility.

== statserial ==

Die Angaben beziehen sich auf die Version 1.1-743.2.

=== NAME ===

statserial − display serial port modem status lines

=== SYNOPSIS ===

statserial [-n | -d | -x] <device-name>

=== DESCRIPTION ===

Statserial displays a table of the signals on a standard 9-pin or
25-pin serial port, and indicates the status of the handshaking lines.
It can be useful for debugging problems with serial ports or modems.

The optional device-name parameter is the full name of the device file
for the serial port in question. If not specified, the default is taken
from the environment variable MODEM if set, otherwise /dev/cua1.

=== COMMAND−LINE OPTIONS ===

Each of the command line options is mutually exclusive.

-n

Normally statserial will loop continuously, updating the status at one
second intervals; you can exit using Control-C. The -n option disables
looping.

-d

With this option the status of the modem is printed as a decimal
number. The bits are encoded as follows (XXX indicates unused bits):

+---+---+---+---+---+---+---+---+---+
| 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
+---+---+---+---+---+---+---+---+---+
|DSR|RI |DCD|CTS|XXX|XXX|RTS|DTR|XXX|
+---+---+---+---+---+---+---+---+---+

-x

This option is the same as -d, except that the output is in
hexadecimal.

=== BUGS/LIMITATIONS ===

Statserial only works with devices that support the TIOCMGET ioctl.

You need permission to read the device file.

The device file may be locked if other applications are using it.

=== AUTHOR ===

Statserial was written by Jeff Tranter (Jeff_Tranter@Mitel.COM), later
updated by Frank Baumgart (godot@uni-paderborn.de) and is released
under the conditions of the GNU General Public License. See the file
COPYING and notes in the source code for details.

=== SEE ALSO ===

setserial(8) stty(1)
/usr/src/linux/drivers/char/serial.c /usr/include/linux/termios.h

Slicer

2026-07-31T15:53:20Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Ich nutze diese Seite, um die verschiedenen Einstellmoeglichkeiten (Parameter) der beiden Slicing-Software-Produkte (Slicer) im Ueberblick zu haben.
Cura fuer den Filamentdruck und chitubox Harzdruck.
Derzeit benutze ich zur Modellerstellung Autodesk Fusion 360 (gelegentlich auch Blender oder Plasticity).
Der Auftritt der Slicer beginnt mit dem Datei->3D-Drucken Menuepunkt in Fusion.
[[Datei:Fusion 3D Druck.jpg|mini]]
Fusion unterstuezt dabei 3 Ausgabeformate:
* 3MF 3D Manufacturing Format
* STL(binär)
* STL(ASCII) Standard Triangulation Language (De-facto-Standard mit Schwaechen)
* OBJ OBJect

STP (STEP) STandard for the Exchange of Product model data und AMF – Additive Manufacturing File Format stehen in Fusion als Export nicht zur Verfuegung.

AMF ist kurz gesagt eine Erweiterung des STL (1988), die seit 2009 zur Verfuegung steht. Es ist XML basierend. Es hat wenig Verbreitung.

3MF ([http://3mf.io/ 3MF Konsortium]) Von Microsoft gegruendet. Mitglieder u.a. Autodesk, PTC, Netfabb, Ultimaker, HP, Shapeways, Siemens. Unterstuetzt u.a. eine Miniaturansicht des Modells, Druckerprofile, Angaben zu Stützmaterialien.

OBJ eigentlich fuer 3D-Grafik und Animation entwickelt. Unterstuetzt Farben und Texturen

STL enthaelt nur die Oberflaechengeometrie des Modells in Dreiecksflaechen (Meshes). In 3D-Druckmenue von Fusion kann die 'Netzvorschau' und die 'Anzahl der Dreiecke' einen groben Eindruck von der Guete des Druckes vermitteln. Es werden keine weiteren Daten zu z.B. Farben, Texturen, ... gespeichert.

Die Angaben zu den Verfeinerungsoptionen beziehen sich auf die Gestalt der Meshes (einfach nur Dreiecke, nicht zu verwechseln mit Mesh als Einheit oder gar WLAN-Mesh)

=Datentransfer im Detail=
==Fusion 3D Druck Menue==
Beim Format '3MF' kann man den Einheitentyp (Zentimeter, Millimeter, Meter, Zoll, Fuß) nicht einstellen.

Mit Struktur kann man alle Modelle in eine Datei ablegen, oder jedes Modell in eine eigene Datei.

Mit eingeschalteter Netzvorschau kann man die Anzahl der generierten Dreiecke sehen.

Mit den Verfeinerungseinstellungen 'Hoch', 'Mittel' und 'Niedrig' veraendert sich folgerichtig auch die Anzahl der Dreiecke.

Zu den Verfeinerungsoptionen mein ChatGPT:

'''1. Flächenabmaß (Surface Deviation)'''

Das Flächenabmaß bezieht sich darauf, wie genau die Oberflächen von 3D-gedruckten Modellen die ursprünglichen CAD-Modelloberflächen abbilden sollen. Ein kleineres Flächenabmaß bedeutet eine höhere Genauigkeit und somit eine bessere Oberflächenqualität, was jedoch zu einer erhöhten Dateigröße und möglicherweise längeren Druckzeiten führt. Diese Einstellung ist besonders wichtig, wenn das Modell komplexe Kurven oder feine Details enthält.

'''2. Normales Abmaß (Normal Deviation)'''

Das normale Abmaß steuert, wie genau die Normalen der Flächen im 3D-Modell repräsentiert werden sollen. Eine geringere Abweichung führt zu einer genaueren und glatteren Oberflächenwiedergabe, erhöht aber auch die Anforderungen an die Dateikomplexität und die Druckzeit.
An der Stelle bin ich mir nicht sicher, ob hier nicht ein Uebersetzungsfehler vorliegt. 'Normal Deviation' ergibt Sinn. Die Uerbsetzung sollte besser 'Normalen Abmaß' lauten. Naemlich das Abmasz (Abweichung) der Normalen, also von Dreieck und Original.

'''3. Maximale Kantenlänge (Maximum Edge Length)'''

Diese Einstellung begrenzt die Länge der Kanten im 3D-Druck-Modell. Eine kleinere maximale Kantenlänge kann die Genauigkeit des Modells verbessern, da sie dazu führt, dass Details feiner aufgelöst werden. Dies ist besonders nützlich bei Modellen mit vielen kleinen Features oder feinen Texturen.

'''4. Seitenverhältnis (Aspect Ratio)'''

Das Seitenverhältnis bezieht sich auf das Verhältnis zwischen der Breite und Höhe der einzelnen Elemente des Modells. Ein ungünstiges Seitenverhältnis kann zu Druckproblemen führen, insbesondere bei dünnen, hohen Features, die während des Druckens brechen oder sich verziehen könnten. Die Optimierung des Seitenverhältnisses ist entscheidend für die strukturelle Integrität und die ästhetische Qualität des gedruckten Objekts.

Die Verfeinerungsoptionen sind im Detail:

Das Abmaß gibt die maximale erlaubte Abweichung zwischen den tatsächlichen und den idealen Oberflächen an. Das Flaechenabmaß konzentriert sich auf die geometrische Treue der Oberflaeche selbst. Das normale Abmaß bezieht sich auf die Genauigkeit, mit der die Normalen der Oberflächen im 3D-Modell wiedergegeben werden. Es betrifft die Praezision der Oberflaechennormalen, die für visuelle Effekte wie Beleuchtung und Texturierung wichtig sind.

Am einfachsten kann man sich die Werte an einem Quader klar machen. Ein Quader hat 6 Seiten, jeweils Rechtecke, die jedes durch 2 Meshes genau abgebildet werden koennen. Die Einstellungen haben somit keinen Einfluss auf die Abbildtreue.

An der Stelle lass ich's mit den Einstellungen mal gut sein. Vielleicht mach mal weiter wenn ich mir die Meshing-Algorithmen mal genauer anschaue.
Ich sehe keinen Grund darin, den 3D Druck in Fusion nicht immer mit der Verfeinerung 'Hoch' durchzufuehren. Warum soll man vor der Uebergabe in den Slicer auf Details verzichten.

[[Datei:Fusion 3D Druck Quader.jpg|800px]]

Als 3D-Objekt Viewer benutze ich F3D (Windows, Linux, ...) [https://github.com/f3d-app/f3d/releases/tag/v2.0.0]

Dabei ist mir aufgefallen, dass die Koordinaten-Position (Ursprung) nicht dem Original in Fusion entspricht.

Hinweis: X rot, Y gruen, Z blau (XYZ=RGB)

Der Koerper hat im Original die Masze (20/10/5).

===3MF===
Beim 3MF-Dateiformat handelt es sich um ein Zip-Archiv (File Signatur 50 4B 03 04). Die Datei enthielt im o. g. Beispiel zwei Dateien.
* 3D/3dmodel.model
*_rels/.rels

<syntaxhighlight lang="xml" line>
<?xml version="1.0" encoding="utf-8"?>
<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
<Relationship Type="http://schemas.microsoft.com/3dmanufacturing/2013/01/3dmodel" Target="/3D/3dmodel.model" Id="rel0"/>
</Relationships>
</syntaxhighlight>
<syntaxhighlight lang="xml" line>
<?xml version="1.0" encoding="utf-8"?>
<model xmlns="http://schemas.microsoft.com/3dmanufacturing/core/2015/02" unit="millimeter" xml:lang="en-US" xmlns:m="http://schemas.microsoft.com/3dmanufacturing/material/2015/02" xmlns:p="http://schemas.microsoft.com/3dmanufacturing/production/2015/06" xmlns:b="http://schemas.microsoft.com/3dmanufacturing/beamlattice/2017/02" xmlns:s="http://schemas.microsoft.com/3dmanufacturing/slice/2015/07" xmlns:sc="http://schemas.microsoft.com/3dmanufacturing/securecontent/2019/04">
<metadata name="Title" type="QName" preserve="1">Scheibe v1</metadata>
<resources>
<m:colorgroup id="2">
<m:color color="#A0A0A0FF"/>
<m:color color="#A0A0A0FF"/>
</m:colorgroup>
<object id="1" name="Körper2" type="model" p:UUID="1eb949bd-306e-47d5-9ca5-fae3bfc7a5f0" pid="2" pindex="1">
<mesh>
<vertices>
<vertex x="20.000000" y="10.000000" z="0" />
<vertex x="0" y="10.000000" z="0" />
<vertex x="0" y="10.000000" z="5.000000" />
<vertex x="20.000000" y="10.000000" z="5.000000" />
<vertex x="20.000000" y="0" z="0" />
<vertex x="20.000000" y="0" z="5.000000" />
<vertex x="0" y="0" z="0" />
<vertex x="0" y="0" z="5.000000" />
</vertices>
<triangles>
<triangle v1="0" v2="1" v3="3" />
<triangle v1="3" v2="1" v3="2" />
<triangle v1="4" v2="0" v3="5" />
<triangle v1="5" v2="0" v3="3" />
<triangle v1="6" v2="4" v3="7" />
<triangle v1="7" v2="4" v3="5" />
<triangle v1="1" v2="6" v3="2" />
<triangle v1="2" v2="6" v3="7" />
<triangle v1="7" v2="5" v3="2" />
<triangle v1="2" v2="5" v3="3" />
<triangle v1="1" v2="0" v3="6" />
<triangle v1="6" v2="0" v3="4" />
</triangles>
</mesh>
</object>
</resources>
<build p:UUID="7216c12b-0a4b-464d-b9e2-85b262c4d008">
<item objectid="1" p:UUID="90cd1c31-7ad4-42cd-9206-7d2902c90d1f"/>
</build>
</model>
</syntaxhighlight>

===STL Binaer===
File Signature 53 54 4c 42 20 41 54 46 STLB ATF [https://people.sc.fsu.edu/~jburkardt/data/stlb/stlb.html]

===STL ASCII===
Im Gegensatz zum STLB-Format ist das STLA-Format direkt als Textdatei lesbar.
<syntaxhighlight lang="ascii" line>
solid ASCII
facet normal 0.000000e+00 1.000000e+00 -0.000000e+00
outer loop
vertex 2.000000e+01 1.000000e+01 0.000000e+00
vertex 0.000000e+00 1.000000e+01 0.000000e+00
vertex 2.000000e+01 1.000000e+01 5.000000e+00
endloop
endfacet
facet normal 0.000000e+00 1.000000e+00 0.000000e+00
outer loop
vertex 2.000000e+01 1.000000e+01 5.000000e+00
vertex 0.000000e+00 1.000000e+01 0.000000e+00
vertex 0.000000e+00 1.000000e+01 5.000000e+00
endloop
endfacet
facet normal 1.000000e+00 0.000000e+00 0.000000e+00
outer loop
vertex 2.000000e+01 0.000000e+00 0.000000e+00
vertex 2.000000e+01 1.000000e+01 0.000000e+00
vertex 2.000000e+01 0.000000e+00 5.000000e+00
endloop
endfacet
facet normal 1.000000e+00 -0.000000e+00 0.000000e+00
outer loop
vertex 2.000000e+01 0.000000e+00 5.000000e+00
vertex 2.000000e+01 1.000000e+01 0.000000e+00
vertex 2.000000e+01 1.000000e+01 5.000000e+00
endloop
endfacet
facet normal 0.000000e+00 -1.000000e+00 0.000000e+00
outer loop
vertex 0.000000e+00 0.000000e+00 0.000000e+00
vertex 2.000000e+01 0.000000e+00 0.000000e+00
vertex 0.000000e+00 0.000000e+00 5.000000e+00
endloop
endfacet
facet normal 0.000000e+00 -1.000000e+00 0.000000e+00
outer loop
vertex 0.000000e+00 0.000000e+00 5.000000e+00
vertex 2.000000e+01 0.000000e+00 0.000000e+00
vertex 2.000000e+01 0.000000e+00 5.000000e+00
endloop
endfacet
facet normal -1.000000e+00 0.000000e+00 0.000000e+00
outer loop
vertex 0.000000e+00 1.000000e+01 0.000000e+00
vertex 0.000000e+00 0.000000e+00 0.000000e+00
vertex 0.000000e+00 1.000000e+01 5.000000e+00
endloop
endfacet
facet normal -1.000000e+00 -0.000000e+00 0.000000e+00
outer loop
vertex 0.000000e+00 1.000000e+01 5.000000e+00
vertex 0.000000e+00 0.000000e+00 0.000000e+00
vertex 0.000000e+00 0.000000e+00 5.000000e+00
endloop
endfacet
facet normal 0.000000e+00 0.000000e+00 1.000000e+00
outer loop
vertex 0.000000e+00 0.000000e+00 5.000000e+00
vertex 2.000000e+01 0.000000e+00 5.000000e+00
vertex 0.000000e+00 1.000000e+01 5.000000e+00
endloop
endfacet
facet normal -0.000000e+00 0.000000e+00 1.000000e+00
outer loop
vertex 0.000000e+00 1.000000e+01 5.000000e+00
vertex 2.000000e+01 0.000000e+00 5.000000e+00
vertex 2.000000e+01 1.000000e+01 5.000000e+00
endloop
endfacet
facet normal 0.000000e+00 0.000000e+00 -1.000000e+00
outer loop
vertex 0.000000e+00 1.000000e+01 0.000000e+00
vertex 2.000000e+01 1.000000e+01 0.000000e+00
vertex 0.000000e+00 0.000000e+00 0.000000e+00
endloop
endfacet
facet normal 0.000000e+00 0.000000e+00 -1.000000e+00
outer loop
vertex 0.000000e+00 0.000000e+00 0.000000e+00
vertex 2.000000e+01 1.000000e+01 0.000000e+00
vertex 2.000000e+01 0.000000e+00 0.000000e+00
endloop
endfacet
endsolid
</syntaxhighlight>

===OBJ (MTL)===
Mit der OBJ-Datei wird auch noch gleichzeitig eine MTL-Datei (Material) exportiert. Die enthaelt Informationen zu der Textur.
<syntaxhighlight lang="ascii" line>
# WaveFront *.obj file (generated by Autodesk ATF)

mtllib Quader.mtl

g Körper2

v 20.000000 10.000000 0.000000
v 0.000000 10.000000 0.000000
v 0.000000 10.000000 5.000000
v 20.000000 10.000000 5.000000
v 20.000000 0.000000 0.000000
v 20.000000 0.000000 5.000000
v 0.000000 0.000000 0.000000
v 0.000000 0.000000 5.000000
vt 0.000000 0.000000 0.000000
vt 2.000000 0.000000 0.000000
vt 0.000000 0.500000 0.000000
vt 2.000000 0.500000 0.000000
vt 0.000000 0.000000 0.000000
vt 1.000000 0.000000 0.000000
vt 0.000000 0.500000 0.000000
vt 1.000000 0.500000 0.000000
vt 0.000000 0.000000 0.000000
vt 2.000000 0.000000 0.000000
vt 0.000000 0.500000 0.000000
vt 2.000000 0.500000 0.000000
vt 0.000000 0.000000 0.000000
vt 1.000000 0.000000 0.000000
vt 0.000000 0.500000 0.000000
vt 1.000000 0.500000 0.000000
vt -1.000000 -0.500000 0.000000
vt 1.000000 -0.500000 0.000000
vt -1.000000 0.500000 0.000000
vt 1.000000 0.500000 0.000000
vt 1.000000 0.500000 0.000000
vt -1.000000 0.500000 0.000000
vt 1.000000 -0.500000 0.000000
vt -1.000000 -0.500000 0.000000
vn 0.000000 0.100000 0.000000
vn 0.000000 0.100000 0.000000
vn 0.000000 0.100000 0.000000
vn 0.000000 0.100000 0.000000
vn 0.100000 0.000000 0.000000
vn 0.100000 0.000000 0.000000
vn 0.100000 0.000000 0.000000
vn 0.100000 0.000000 0.000000
vn 0.000000 -0.100000 0.000000
vn 0.000000 -0.100000 0.000000
vn 0.000000 -0.100000 0.000000
vn 0.000000 -0.100000 0.000000
vn -0.100000 0.000000 0.000000
vn -0.100000 0.000000 0.000000
vn -0.100000 0.000000 0.000000
vn -0.100000 0.000000 0.000000
vn 0.000000 0.000000 0.100000
vn 0.000000 0.000000 0.100000
vn 0.000000 0.000000 0.100000
vn 0.000000 0.000000 0.100000
vn 0.000000 0.000000 -0.100000
vn 0.000000 0.000000 -0.100000
vn 0.000000 0.000000 -0.100000
vn 0.000000 0.000000 -0.100000
usemtl Stahl_-_satiniert
f 1/1/1 2/2/2 4/3/3
f 4/3/3 2/2/2 3/4/4
f 5/5/5 1/6/6 6/7/7
f 6/7/7 1/6/6 4/8/8
f 7/9/9 5/10/10 8/11/11
f 8/11/11 5/10/10 6/12/12
f 2/13/13 7/14/14 3/15/15
f 3/15/15 7/14/14 8/16/16
f 8/17/17 6/18/18 3/19/19
f 3/19/19 6/18/18 4/20/20
f 2/21/21 1/22/22 7/23/23
f 7/23/23 1/22/22 5/24/24
# 8 vertices
# 24 texture params
# 24 normals
# 12 facets

# 1 groups
</syntaxhighlight>

<syntaxhighlight lang="ascii" line>
# WaveFront *.mtl file (generated by Autodesk ATF)

newmtl Stahl_-_satiniert
Kd 0.627451 0.627451 0.627451
</syntaxhighlight>

==CHITUBOX==

Die Software ist soweit unspektakulaer. Neben den zu erwartenden Funktionen wie Verschieben, Drehen, Skalieren und Duplizieren und Spiegeln hat die Funktion 'Dig Hole' in Kombination mit 'Hollow' beim Resin-Druck eine besondere Bedeutung. Im Gegensatz zum Filament-Druck muss fluessiges Resin aus einem Hohlraum abflieszen koennen und dazu benoetigt es Loecher :-). Auf das Problem, dass in einem Hohlraum ein Vakuum gezogen wird ist damit beseitigt.

Darueber hinaus gibt es eigentlich nur 2 notwendige Menues Stuetzstrukturen und Slice Settings.

Der 'Slice Settings'-Button befindet sich rechts im Dateibearbeitungs-Menue ganz unten, direkt ueber dem Slice-Button, mit dem man den Prozess abschlieszen kann.
Das Stuetzstrukturmenue befindet sich als Reiter rechts neben der Dateibearbeitung. Neben der Tatsache, dass man die Stuetzstruktur-Einstellungen in einer Config-Datei (zwischen-)speichern kann, ist der Autosupport-Button sehr hilfreich.
Recht hilfreich ist auch die Cavity- und Collision-Detector, die Alarm schlagen sollte mit den Modellen grunedsaetzlich was nicht stimmen.

Die groeszte Beachtung sollte man wohl den Slice-Settings widmen. Die Einstellungen sind recht umfangreich und sind Maschinen und Resin-Typ abhaengig.

[[Datei:Chitubox Slice Settings Machine.jpg|400px]]

[[Datei:Chitubox Slice Settings Resin.jpg|400px]]

[[Datei:Chitubox Slice Settings Print.jpg|400px]]

[[Datei:Chitubox Slice Settings Advance.jpg|400px]]

Die Eintraege zu GCODE sind in meiner Version V2.2 nicht (mehr) vorhanden.
Bug Fix v1.9.1: Fixed the bug that the gcode parameter is not displayed!?

Nachdem Slicen bekommt man nochmal alle Einstellungen zu Maschine, Resin und Print angezeigt, dann kann man speichern. Bei mir kam beim Testen noch eine Warnung ich haette keine Island-Detection [https://www.chitubox.com/en/academy/tutorials/chitubox-basic/manual/island-detection-on-chitubox-explained] durchgefuehrt.

Ausgegeben wird eine Datei im CTB-Format (ChiTuBox-Format [https://www.chitubox.com/en/page/sdk]).

About CTB file format and the SDK

Before the CTB file format was created, the commonly used slice file types were CBDDLP, CWS, ZIP, SLC, etc. They didn't perform well when dealing with the increasing number of new application scenarios, and their extensibility couldn't satisfy the growing demands of the LCD/DLP resin 3D printer users. So when CHITUBOX Basic V1.6.1 was released (in Nov 2019), CBD-Tech introduced a new file format tailored for LCD/DLP resin 3D printers – CTB (short for CHITUBOX). This format was lightweight, streamlined and highly extensible, and worked better with various resin 3D printers. As the functionalities of CHITUBOX continued to grow, the CTB format got updated continuously to fit in more application scenarios and support more resin printer features.

Later, in 2021, LCD/DLP resin 3D printing technologies kept advancing, and so did the CHITUBOX software. So when CHITUBOX Basic V1.9.0 and CHITUBOX Pro were released, we introduced the new, upgraded CTB. This new format enables you to use the newly-added powerful features of the CHITUBOX software, such as Two-Stage Motion Control (TSMC), Resting Time, Multi-parameter Slice, and more.

As the user base of CTB is rapidly growing, we also see requirements coming out from the developers in our communities and our business partners. To help them offer better products and services to the users, CBD-Tech publishes the standard and officially verified SDK for the CTB format. We hope these tools can simplify creative process for the developers and the partners and help them unleash their creativity.

Hinweis aus dem Forum:
Am I correct in thinking that the Elegoo Mars Pro only supports the new CTB format, and nothing else? I tried putting an old CBDDLP file on there and the printer just tried to open it as if it's a folder.

Seems like a bit of a dissapointing step back if so, as it means there's currently no choice of slicer other than the (somewhat limited) Chitubox. Useful tools like the Photon File Validator for fixing bad supports also no longer work due to the forced new file format.

You are correct, the pro only supports the new ctb format. It's actually a smaller more compact file than the old format and seems to be more stable. If you really want to work outside chitubox you can use slicers like the prusa slice and add/create supports then save the whole thing as an stl then bring into chitubox to simply slice. I believe eventually other software will catch up and support the new ctb format.

You can import stl, obj, cbddlp, photon, photons, zip, slc, wow, fhd, cwS, ctb, phz, svgx, lgs, chitubox, cfg, ... files into Chitubox wich comes with the printer. From there you can convert the files to .cbt and print them.

==Cura Ultimaker==
UltiMaker Cura ist eine kostenlose, benutzerfreundliche 3D-Drucksoftware, der Millionen von Nutzern vertrauen. Optimieren Sie Ihr 3D-Modell mit über 400 Einstellungen für die besten Slicing- und Druckergebnisse.

==Prusa Slicer==
PrusaSlicer ist ein quelloffenes, funktionsreiches und haeufig aktualisiertes Tool, das alles enthaelt, was Sie brauchen, um die perfekten Druckdateien für Ihren 3D-Drucker zu generieren. Sie koennen Neuigkeiten und das vollstaendige Versionsprotokoll auf Github einsehen.

=Links=

Druckmodell-Plattformen: [https://www.thingiverse.com/ Thingiverse] [https://www.myminifactory.com/ MyMiniFactory]

=Request for Comments=

<comments />

Serial.print() Funktion

2026-07-31T15:53:19Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

oder serial.println()

Nach dem ich schon in mehreren Programmen Probleme mit "zerschossenen" Variablen hatte trage ich hier mal alle meine Infos zusammen.

Ähnlich gelagerte Probleme haben andere Nutzer bereits in Foren formuliert.

https://www.arduinoforum.de/arduino-Thread-Problem-mit-char-array

https://forum.arduino.cc/index.php?topic=368430.0

Mit den Antworten war ich allerdings weniger zufrieden. Ich finde in Foren einfach zu oft die Reaktion:

#Warum machst Du das so?
#Das geht so viel besser!
#Dein Ansatz ist falsch.

Das heißt eigentlich wird gar zu selten auf das eigentliche Problem eingegangen, sondern es wird einfach ein Workaround geschildert oder gar eine komplett andere Evtl-Lösung empfohlen.
Ein Kommentator spricht mir aus der Seele:

Ich verstehe deinen Lösungsvorschlag schon, aber mich würde mehr interessieren, warum meine Lösung nicht funktioniert.

==1. Fall==
Variablen haben nach einem Funktionsaufruf einen anderen (undefinierten) Wert, obwohl sie in der Funktion gar nicht benutzt wurden.
Unabhängig von der Scope-Problematik, sehe ich als Ursache fehlerhaft programmierte Libraries als Ursache. Dies tritt gerade dann zu Tage wenn mehrere Libraries in einem Programm benutzt werden, die sich
dann sehr oft gegenseitig beeinflussen. Die Problem wird dann auch noch durch den Umstand verstärkt wenn die (RAM-)Ressourcen ausgereizt werden, oder der Zugriff auf Kommunikationsschnittstellen aufgeteilt wird.

==2.Fall==
Das Gepointere geht fast immer in die Hose. Obwohl die Logik (Speicherbereich zugewiesen, Inhalt vorhanden, String korrekt mit \0 abgeschlossen, ...) stimmt, erhält man nicht das gewünschte Ergebnis.
Hier habe ich mehrfach Versuche, die über seriellen Output, StatusLEDs oder angeschlossenes Display den Programmzustand nach "außen" melden, abgebrochen.

==Lösung(en)==
Mein einziger Ansatz, der Lösungen verspricht, ist das Emulieren oder noch besser Step-Debugging wie ich es noch aus der Assemblerzeit mit dem MC86HC05/11 her kenne. Zu diesem Zweck habe ich mir jetzt mal
den Atmel-ICE ([https://de.wikipedia.org/wiki/In-Circuit-Emulator In-Circuit-Emulator]) zugelegt und werde die oben genannten Fälle mal "low Level" untersuchen.

to be continued ...

==Request for Comments==

<comments />

Schaltjahr berechnen

2026-07-31T15:53:18Z

Chris T. Ludwig: Rechtschreibkorrektur (automatisiert)

=Allgemeines=
Ich habe vor kurzem als Dozent einen Python-Kurs gehalten. Auf der Suche nach "schoenen" kleinen Beispielen habe ich mich wieder an meinen Schulzeit erinnert und die Schaltjahr-Berechnung rausgekramt. Das war so ein Klassiker neben den Tuermen von Hanoi, Game of Life und allen Varianten von Zahlenberechnungen (Pi, Prim, Fibonacci, ggT, Fakultaet, ...)

Schaltjahr (lateinisch annus intercalarius oder annus bissextus)

Ein siderisches Jahr der Erde dauert derzeit im Mittel etwa 365,256 Tage, gemessen in SI-Einheiten, somit ungefähr 20 Minuten länger als ein tropisches Jahr.

Die Einschaltung eines zusätzlichen Tages oder Monats wird auch als Interkalation bezeichnet. Eine Sonderform der Schalttage sind Epagomene.

Der Julianische Kalender (Julius Caesar 45 v.Chr.) fuegt alle 4 Jahre einen Schalttag (29.2.) ein.

Seit 1582 n.Chr. wird im gregorianischen Kalender alle 400 Jahre auf das Einfuegen verzichtet.

Die Regeln:
* Ist das Jahr durch 4 (ohne Rest) teilbar? ("Julianische Regel")
* Ist das Jahr durch 100 (ohne Rest) und ist das Jahr durch 400 (ohne Rest) teilbar? ("Gregorianische Ergaenzung")

=Programme=
==Excel==
In der Zelle A1 steht das Jahr.

=IF(OR(MOD(A1,400)=0,AND(MOD(A1,4)=0,MOD(A1,100)<>0)),"Leap Year", "NOT a Leap Year")

Die Bedingung mal etwas aufgeloest:
OR(MOD(A1,400)=0,
AND(MOD(A1,4)=0,
MOD(A1,100)<>0
)
)

Wie kommt man jetzt auf sowas?

Wir haben 3 Bedingungen, die man alle 3 mit der Modulo-Operation abbilden kann.
Eine 0 bei der Modulo-Division bedeutet keinen Rest und damit ein "True" fuer das Schaltjahr.
* Jahr Modulo 4 = 0 -> Schaltjahr
* Jahr Modulo 400 = 0 UND Jahr Modulo 100 = 0 -> kein Schaltjahr