Logic MSO Analysis

Dekodiert UART/SPI/I2C/1-Wire aus Saleae-Logic-MSO-Binärexporten für CTF und Hardware-RE.

von BrownFineSecurity · BrownFineSecurity/iothackbot

Funktioniert mit Setup ★ 7.6/10

Logic MSO Analysis — Dekodiert UART/SPI/I2C/1-Wire aus Saleae-Logic-MSO-Binärexporten für CTF und Hardware-RE.

Was es kann

Lädt Saleae-Logic-MSO-Binärcaptures über die Python-Bibliothek saleae-mso-api und liefert Timing-Cluster-Heuristiken sowie durchgerechnete Python-Beispiele zum Dekodieren von UART-, SPI-, I2C- und 1-Wire-Signalen, ausgerichtet auf CTF-Challenges und Hardware-Reverse-Engineering. Liefert ein gebündeltes analyze_protocol.py-CLI (Histogramm-/Cluster-/CSV-Export-Modi) und ein examples.md-Walkthrough für die Triage unbekannter Protokolle.

Testbericht

Baute ein synthetisches 2-Byte-('Hi')-UART-Capture und führte die decode_uart_byte()-Funktion aus der SKILL.md wörtlich aus: Ihr Sampling am Bit-Perioden-Zentrum rekonstruierte korrekt das erste Byte, wo ein naiver Von-Grund-auf-Baseline-Sampler es falsch ermittelte ('X' statt 'H') — aber die umgebende Multi-Byte-Schleife im selben Dokument hat einen echten Bug, der sie bei jedem Multi-Byte-Capture nach einem Byte stillschweigend anhalten lässt.

Getestet am: 2026-07-13 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/BrownFineSecurity/iothackbot
cd iothackbot
mkdir -p ~/.claude/skills
cp -r skills/logicmso ~/.claude/skills/logicmso

Befehle & Beispiel-Prompts

  • /logicmsoDekodiert UART/SPI/I2C/1-Wire aus Saleae-Logic-MSO-Binärexporten für CTF und Hardware-RE.

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • Decode this UART capture from my Saleae Logic MSO export file
  • I have an unknown protocol dump, help me cluster timing and identify SPI or I2C
  • Analyze this Logic MSO binary capture for a CTF hardware reverse engineering challenge