ErgoLine D340 Protokoll

Die D340 bleibt als „Leitungsmodem“ an der Anlage. Sie erledigt den gesamten Dialog mit der Sopho (UPN, LAPD, Philips-TMP). Ein PC spricht nur mit der Firmware des Telefons: über eine serielle Leitung mit einem kleinen Binärprotokoll aus Rahmen. Das Telefon meldet Zustände (klingelt, verbunden, ausgelöst …) mit Rufnummern; der PC erteilt Aufträge (anmelden, wählen, annehmen, auflegen), die das Telefon quittiert.

Beide Richtungen verwenden dasselbe Format: ein Byte Klasse, ein Byte Länge, dann genau so viele Bytes Nutzdaten. Mehrere Rahmen folgen lückenlos aufeinander. bestätigt Treiber

Zerlegen: Puffer sammeln; solange mindestens zwei Bytes da sind, Länge L = puffer[1] lesen und warten, bis L + 2 Bytes vorliegen. Der Treiber liest L vorzeichenbehaftet (höchstens 127). Es gibt kein Startzeichen, nach dem man synchronisieren könnte: Nach einem Fehler den Puffer verwerfen und auf die nächste Lücke warten.

def feed(puffer, neu):
    puffer += neu
    while len(puffer) >= 2 and len(puffer) >= puffer[1] + 2:
        klasse, laenge = puffer[0], puffer[1]
        yield klasse, bytes(puffer[2:2 + laenge])
        del puffer[:2 + laenge]

Nutzdaten einer Meldung (Klasse 02): Byte 0 = Typ, Byte 1 = Leitung (bisher immer 01), danach typabhängig. Namen wie im Treiber (L3_STATUS…).

Meldung 3c 01 kk (FACILITY_REJECTED): das Telefon hat ein Merkmal abgelehnt, z. B. 4f per Funktionstaste im Ruhezustand. bestätigt

Hinter Typ und Leitung folgen Elemente nach dem Muster von ISDN (Q.931): Kennung, Länge, Inhalt. Ein Byte mit gesetztem Bit 8 steht allein (bisher nur 98, Bedeutung offen).

Aufträge haben Klasse 01; Byte 0 ist der Typ, Byte 1 ist 00. Alle Rahmen stammen aus dem Philips-Treiber. Anmelden, Keepalive, Annehmen und Auflegen sind am Gerät erprobt (2026-10-01); die übrigen noch nicht.

Wählen im Detail. Bei n Ziffern ist L = n + 6: Typ 19, Leitung 00, das Einzelbyte 98, dann IE 70 mit Länge n + 1, Typ-Oktett 81 und den Ziffern als ASCII.

Wahl „123“        01 09 19 00 98 70 04 81 31 32 33
Wahl extern „01 0170 0000000“
                  01 13 19 00 98 70 0e 81 30 31 30 31 37 30 30 30 30 30 30 30 30

Im Treiber nicht unterstützt (Rückgabe LINEERR_OPERATIONUNAVAIL): Umleiten eines klingelnden Anrufs, Blind Transfer, Accept.

• Nur Aufträge werden quittiert. Die Quittung 04 00 kommt nach 100–150 ms bestätigt. Der Treiber wartet bis zu 5 s (auch auf 03/05); bleibt sie aus, gilt der Auftrag als gescheitert. Treiber
• Meldungen des Telefons quittiert der PC nicht. Der Treiber hat dafür keine Sendestelle. Treiber
• Unverständliche Eingaben beantwortet das Telefon nach etwa 1,5 s mit 05 00. bestätigt
• Kommt 15 s lang nichts vom Telefon, sendet der Treiber Keepalive 01 02 00 00. Treiber
• Watchdog des Telefons: Kommt 30 s lang kein Rahmen vom PC, legt die D340 ein vom PC geführtes Gespräch selbst auf (3a 01 30, 32 01 98 08 00, 39 – wie Auflegen am Telefon). Gemessen viermal 30,4–30,7 s nach dem letzten PC-Rahmen; mit Keepalive alle 10 s hielt dasselbe Gespräch 60 s. Ein Daemon sollte daher nach 15 s ohne Senden ein Keepalive schicken, nicht nur nach 15 s ohne Empfang. bestätigt (logs/test_20261001_190905_watchdog_ohne_keepalive.log, logs/test_20261001_191319_watchdog_mit_keepalive.log)
• Pro Zeitpunkt ist höchstens ein Auftrag offen: senden, Quittung abwarten, dann den nächsten.

Links stehen Handlungen am Telefon, Pfeile sind Rahmen. Achtung: Im Freisprechbetrieb beendet die Lautsprecher-Taste am Telefon das Gespräch (Ursache leer). Schwarze Pfeile: Meldungen des Telefons. Farbige Pfeile: Aufträge des PCs. Gestrichelt: erwartet, am Gerät noch nicht gesehen.

Die Rahmen tragen keine Anrufkennung; das Byte „Leitung“ ist immer 01. Der Philips-Treiber führt deshalb selbst eine Anruftabelle (31 Plätze) und ordnet jede Meldung dem Anruf zu, der gerade in einem passenden Zustand ist. Die Zustände sind die TAPI-Werte LINECALLSTATE_*; im Diagramm oben: RUHE = IDLE, KLINGELT = OFFERING, WÄHLTON = DIALTONE, WAHL = DIALING, RUFT = PROCEEDING/RINGBACK, VERBUNDEN = CONNECTED, AUSGELÖST = DISCONNECTED.

Je Meldung setzt der Parser einen Ereigniscode, eine Übergangstabelle (0x100069eb) bildet „alter Zustand × Code“ auf den neuen Zustand ab, eine zweite Funktion (0x1000b70b) setzt den Modus (Wählton-Art, Besetzt-Art, Auslöseursache als LINEDISCONNECTMODE).

Für einen Daemon heißt das: eine eigene Anruftabelle führen, jede Meldung über den aktuellen Zustand zuordnen, Aufträge nur bei erfüllter Vorbedingung senden und Modus bzw. Ursache mitführen (für SIP-Statuscodes und Statistik).

Aufbau, der sich im Test bewährt hat (Referenz: gateway/ergoline/ im Repository, Python 3 + pyserial):

• Port über /dev/serial/by-id/… öffnen, 1200 Baud, 8O1. Xon/Xoff zunächst aus lassen, weil 11 und 13 auch als Auftragstypen vorkommen.
• Ein Lesethread schreibt jedes Byte ins Rohlog und füttert den Rahmen-Assembler. Fertige Rahmen gehen in eine Ereignis-Queue; Klassen 03/04/05 zusätzlich in eine Quittungs-Queue.
• Aufträge laufen über genau eine Sendefunktion: Quittungs-Queue leeren, Rahmen schreiben, bis 5 s auf die Quittung warten.
• Nach dem Öffnen einmal Anmelden. Ein Zeitgeber sendet Keepalive, wenn 15 s nichts kam.
• Ein Zustandsautomat pro Leitung übersetzt Meldungen in SIP-Ereignisse und SIP-Ereignisse in Aufträge (Abschnitt 08).
• Fällt die serielle Verbindung weg: Port schließen, neu öffnen, neu anmelden. Laufende Anrufe auf SIP-Seite beenden.

from ergoline.link import ErgoLink
from ergoline import protocol as p

with ErgoLink("/dev/serial/by-id/usb-FTDI_…-if00-port0") as link:
    q = link.sende(p.anmelden())                 # erwartet Klasse 04
    while True:
        zeit, r = link.rahmen.get()
        if r.klasse != p.MELDUNG:
            continue
        typ = p.MELDUNGSTYP.get(r.typ)
        if typ == "RINGING":
            ie = dict(p.ies(r.daten[2:]))
            extern, nummer = p.extern(p.rufnummer(ie[0x6C]))
            sip_invite(von=nummer)               # eigener SIP-Stack, z. B. baresip ctrl_tcp
        elif typ == "DISCONNECTED":
            sip_bye()

def sip_angenommen():   link.sende(p.annehmen())
def sip_beendet():      link.sende(p.auflegen())
def sip_waehlen(nr):    link.sende(p.belegen()); link.sende(p.waehlen(nr))

Werkzeug zum Ausprobieren: tools/ergo.py decode|listen|anmelden|keepalive; gesprächsrelevante Aufträge nur mit --freigabe.

Der Philips-Treiber durchläuft beim Öffnen zusätzlich einen Service-Modus mit 9600 Baud. Für den Betrieb ist das vermutlich nicht nötig vermutet; die Folge ist hier nur zur Vollständigkeit festgehalten. Treiber

1. Port öffnen (9600), Escape 02 02 0A 00, 500 ms Pause.
2. 9600 8N1, Probe 05 88 00 89, 2 s auf Quittung; sonst 9600 8O1 und Escape wiederholen.
3. Versionsabfrage: 05 B0 00 B0 → Quittung („ATS-Mode“, Textzeilen) → RQV:0\r → Quittung → RQQ:1\r → Einzelbyte 02. Die Antwort kommt als Textzeile.
4. Umschalten auf 1200 8O1 mit Xon/Xoff, dann Anmelden 01 02 01 00 (5 s auf Quittung).

Ein Hayes-AT-Protokoll gibt es an dieser Buchse nicht. Der ältere Octophon-Treiber (AT$CAL …) gehört zu einem anderen Gerät bzw. einer anderen Firmware und ist inkompatibel.

1. Inhalt der Bereitmeldung 01 (01 02 00): ändert er sich je nach Zustand des Telefons?
2. Nachwahl im Gespräch: hört die Gegenseite DTMF-Töne?
3. Stören Xon/Xoff, da 11/13 auch Auftragstypen sind?
4. Bedeutung von 98 und der Aufträge 15, 18, 1b–24, 27.
5. Meldet das Telefon Ereignisse auch nach einem Neustart ohne vorherige Eingabe?
6. Warum wird DIALTONE nach 10 s wiederholt?
7. Sprachweg über „Sprache über Zusatzgerät“: Pegel und Echo an X_IN/X_OUT.

• Mitschnitte im Repository: logs/serial_20260930_163534.log (alle Meldungen), logs/bitbang_20260930_1633*/1634*/1635* (Rate, Fehlerantwort). Übersicht: logs/INDEX.md.
• Philips ErgoLine D330/D340 TSP for TAPI 2.x, Version 2.1.2 (2002), nicht im Repository (Urheberrecht Philips). Direkt-Download aus der Wayback Machine: ergoline.zip; SHA-256 Ergoline.tsp: 2b5b2b3e2e3ff51a2ca666b7bc874e9e9d81551a3f67c5357ea8ea297f50b282. Wichtige Stellen: Parser 0x100172b9, Rahmen-Assembler 0x1000dbe9, Aufträge 0x10014b0c (Wählen), 0x10015d57 (Annehmen), 0x100168ce (Auflegen), Initialisierung 0x10007afc, Portmodi 0x100132c2/0x1001332e.
• ErgoLine D330/D340 Customer Engineer Manual (Philips), Wartungscodes und Schnittstellen; Sopho ErgoLine D340 User Manual.
• Arbeitsnotizen: docs/protocol.md, docs/hardware.md, docs/sackgassen.md.