- Home
- Skills
- APIs & Backend
- Geraeteprotokoll rekonstruieren und sauber anbinden
Geraeteprotokoll rekonstruieren und sauber anbinden
Rekonstruiert aus Mitschnitten das Protokoll einer Maschine oder Altanlage: Rahmengrenzen, Pruefsumme durch Durchprobieren von 17 Verfahren, Feldzuordnung - und fuehrt ueber sieben Abnahmeschritte zur eigenen Anbindung.
$49
Works with the AI Agents you already use
Geraeteprotokoll rekonstruieren und sauber anbinden
Example session with this skill installed
Unsere Beschriftungsmaschine haengt an einer seriellen Leitung und soll ans ERP. Das Protokoll ist nicht dokumentiert, der Hersteller nicht erreichbar. Ich habe einen Mitschnitt von 146 Byte. Meine Pruefsumme stimmt nie.
- Read your context and instructions
- Compiled the geraeteprotokoll rekonstruieren und
Zusammenfassung
Zwei Skriptlaeufe. Der Rahmenaufbau ist vollstaendig geklaert und die Pruefsumme eindeutig bestimmt - Verfahren, Stelle, abgedeckter Bereich und Bytereihenfolge. Danach ist die eigene Anbindung eine Abnahme, kein Ratespiel.
Schritt 1 - Rahmengrenzen
$ python3 scripts/rahmen_finden.py mitschnitt.bin --rahmen-raus rahmen.txt
# Rahmenanalyse: mitschnitt.bin
Eingelesen als roh, 146 Byte.
| Punkte | Hypothese | Einzelheiten | Rahmen |
|---|---|---|---|
| 1.00 | laengenfeld | Laengenfeld bei Offset 1 als u8, Versatz 4 | 14 |
| 0.46 | trennzeichen | Trennzeichen 0x04, Laengen 24..53 | 4 |
| 0.41 | trennzeichen | Trennzeichen 0x13, Laengen 32..41 | 4 |
**Beste Hypothese: laengenfeld** (1.00 Punkte, 14 Rahmen).
14 Rahmen geschrieben nach `rahmen.txt`.
Der
Versatz 4 sagt gleich mit, dass vier Byte nicht im Laengenwert stecken: Startbyte, Laengenbyte und zwei Byte am Ende.
Schritt 2 - Pruefsumme
$ python3 scripts/pruefsumme_raten.py rahmen.txt
# Pruefsummen-Probe: rahmen.txt
14 Rahmen, kuerzester 8 Byte.
## Passt auf ALLE Rahmen
| Verfahren | Breite | Ablage | Kopf ausgenommen | Bytes dahinter |
|---|---|---|---|---|
| crc16 Modbus | 2 | le | 0 | 0 |
**Sparsamste Erklaerung: crc16 Modbus, 2 Byte le abgelegt, Rumpf ab Offset 0, 0 Byte dahinter.**
Damit sind die zwei Byte am Ende erklaert und der Rahmen vollstaendig:
0x02 | Laenge | Befehl | Daten | CRC16(le)
Die Gegenprobe, die zeigt dass hier nichts geraten wird
Derselbe Lauf auf 900 Byte reinem Rauschen:
**Keine Hypothese ueber der Schwelle.** Entweder kein Rahmenprotokoll, ein
Mitschnitt mit abgeschnittenem Anfang, oder Nutzdaten mit eingebetteten
Trennzeichen.
## Kein Verfahren passt auf alle Rahmen
Naechstbeste Teiltreffer:
- keine
Exit 2, beide Male. Die Werkzeuge erfinden nichts.
Schritt 3 - Felder
Gruppierung nach dem Byte an Offset 2 ergibt vier Befehlsarten. Zaehler sitzt direkt dahinter, laeuft bei 255 um. Nutzwert stimmt erst nach Division durch 10 mit der Anzeige am Geraet ueberein - die Skalierung ist der haeufigste Deutungsfehler und faellt nur im Vergleich mit der Anzeige auf.
Schritt 4 - Abnahme, und davor die Freigabe
| Punkt | Erfuellt |
|---|---|
| Maschine in sicherem Zustand | ja, Werkzeug frei, kein Material |
| Not-Halt geprueft und in Reichweite | ja |
| Verantwortlichen informiert | ja |
| Erster Versuch nur Zustandsabfrage | ja |
Dann die sieben Schritte. Schritt 2 ist der eigentliche Beweis: ein Rahmen mit
selbst berechneter CRC wird angenommen. Verfaelschte CRC wird stillschweigend verworfen (protokolliert). Mindestabstand gemessen: 20 ms - darunter verwirft das Geraet ohne Meldung.
Liefergegenstand
Schnittstellenbeschreibung aus assets/vorlage-02-schnittstellenbeschreibung.md mit Rahmenaufbau, Befehlsliste, Pruefsumme, gemessenem Zeitverhalten, Fehlerverhalten und - der Teil, der sonst fehlt -
allen offenen Feldern mit Offset. Dazu das Abnahmeprotokoll und die Angabe der geprueften Geraetefirmware.
Naechste Schritte
- Dauerlauf ueber eine Stunde als Schritt 7 der Abnahme.
- Firmwarestand im Protokoll festhalten - ein Wechsel kann Felder verschieben.
- ERP-Anbindung gegen die Schnittstellenbeschreibung bauen, nicht gegen den Mitschnitt.
Connects securely to your tools. The creator never sees your data.
About this skill
Das Problem
Eine Maschine laeuft seit zwanzig Jahren, der Hersteller ist nicht mehr erreichbar, und sie soll an das heutige System angebunden werden. Das Protokoll ist nicht dokumentiert, und die eigene Pruefsumme wird vom Geraet stillschweigend verworfen.
Was dieser Skill macht
Er fuehrt von einem Mitschnitt zu einer abgenommenen Schnittstelle - nicht zu einem Skript, das einmal zufaellig funktioniert hat.
Rahmengrenzen: drei Hypothesen werden gegeneinander geprueft und bewertet - Laengenfeld, feste Laenge, Trennzeichen. Rohe Bytes und Hexdump-Text werden beide erkannt. Bei fester Laenge gewinnt bewusst die kleinste passende Laenge, weil 80 Byte mit zehn konstanten Positionen dieselbe Struktur sind wie 16 Byte mit zwei.
Pruefsumme: systematisches Durchprobieren statt Raten. Pruefsummenstelle (letzte 1, 2 oder 4 Byte, optional mit Bytes dahinter), Rumpfbereich (0 bis 6 ausgenommene Kopfbytes) und 17 Verfahren - Summen, XOR, LRC, CRC-8 in drei und CRC-16 in sechs Varianten, CRC-32, Adler-32 - in beiden Bytereihenfolgen. Gemeldet wird nur, was auf alle Rahmen passt.
Feldarbeit: nach Befehlsart gruppieren, Zaehler erkennen, Nutzwerte gegen die Anzeige pruefen (auch mal 10, mal 100 und als BCD - Skalierung ist der haeufigste Deutungsfehler), Reservefelder benennen statt erklaeren.
Sicherheit, und das ist hier kein Formalismus
Lesen aendert nichts. Senden kann eine Achse bewegen oder ein Ventil oeffnen. Der Skill fuehrt deshalb eine Freigabe mit, die vor dem ersten selbst gesendeten Rahmen auszufuellen ist: Maschine in sicherem Zustand, Not-Halt geprueft und in Reichweite, Verantwortlichen informiert, erster Versuch nur Zustandsabfrage - und wenn es einen Pruefstand gibt, dort.
Was mitgeliefert wird
- Zwei getestete Python-Skripte, nur Standardbibliothek, kein Netzzugriff, keine Telemetrie.
- Drei vorberechnete Dokumente in
assets/: Mitschnitt-Protokoll (waehrend der Aufnahme mitzufuehren), Schnittstellenbeschreibung und Abnahmeprotokoll. Sie enthalten genau die Felder, die ein frei geschriebenes Dokument weglaesst - Firmwarestand, offene Felder mit Offset, Umgebung der Abnahme. - Drei Referenzdateien: Mitschnitt aufnehmen, von Rahmen zu Feldern, Abnahme.
Fuer wen
Instandhaltung, Maschinenbau, Systemintegratoren, Betriebe mit Altanlagen, die ans ERP oder an eine Leitstelle sollen.
Grenzen
Nicht fuer verschluesselte oder authentisierte Protokolle, nicht fuer das Umgehen von Zugangsschutz, nicht fuer fremde Netze, nicht fuer Dateiformate. Findet kein Verfahren auf alle Rahmen, ist die erste Ursache nicht die Pruefsumme, sondern die Rahmengrenze - der Skill sagt das in dieser Reihenfolge.
No support for encrypted or authenticated protocols. Analysis requires at least three frames. Does not handle capturing or transmitting data; requires external tools for I/O.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 17 days ago
Requires