Logic MSO Analysis

Avkodar UART/SPI/I2C/1-Wire från Saleae Logic MSO-binärexporter för CTF och maskinvaru-RE.

av BrownFineSecurity · BrownFineSecurity/iothackbot

Fungerar med konfiguration ★ 7.6/10

Logic MSO Analysis — Avkodar UART/SPI/I2C/1-Wire från Saleae Logic MSO-binärexporter för CTF och maskinvaru-RE.

Vad den gör

Läser in Saleae Logic MSO-binärinspelningar via Python-biblioteket saleae-mso-api och ger tidsklustringsheuristik plus genomarbetade Python-exempel för att avkoda UART-, SPI-, I2C- och 1-Wire-signaler, riktat mot CTF-utmaningar och maskinvaru-reverse engineering. Levererar ett medföljande analyze_protocol.py-CLI (histogram-/klustrings-/CSV-exportlägen) och en examples.md-genomgång för triage av okänt protokoll.

Testrapport

Byggde en syntetisk 2-byte ('Hi') UART-inspelning och körde SKILL.md:s egen decode_uart_byte() ordagrant: dess mittpunkt-av-bitperiod-sampling återhämtade korrekt den första byten där en naiv sampler från grunden fick fel ('X' istället för 'H') — men den kringliggande loopen för flera byte i samma dokument har en riktig bugg som gör att den tyst stannar efter en byte vid varje inspelning med flera byte.

Testad: 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

Kommandon och exempelprompter

  • /logicmsoAvkodar UART/SPI/I2C/1-Wire från Saleae Logic MSO-binärexporter för CTF och maskinvaru-RE.

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • 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