Logic MSO Analysis

Decodifica UART/SPI/I2C/1-Wire da export binari di Saleae Logic MSO per CTF e reverse engineering hardware.

di BrownFineSecurity · BrownFineSecurity/iothackbot

Richiede configurazione ★ 7.6/10

Logic MSO Analysis — Decodifica UART/SPI/I2C/1-Wire da export binari di Saleae Logic MSO per CTF e reverse engineering hardware.

Cosa fa

Carica catture binarie Saleae Logic MSO tramite la libreria Python saleae-mso-api e fornisce euristiche di clustering temporale più esempi Python svolti per decodificare segnali UART, SPI, I2C e 1-Wire, pensato per sfide CTF e reverse engineering hardware. Include una CLI analyze_protocol.py (modalità histogram/cluster/export CSV) e una guida examples.md per il triage di protocolli sconosciuti.

Rapporto di test

Ho costruito una cattura UART sintetica di 2 byte ('Hi') ed eseguito alla lettera la decode_uart_byte() dello stesso SKILL.md: il suo campionamento al centro del periodo di bit ha recuperato correttamente il primo byte, dove un campionatore ingenuo scritto da zero sbagliava ('X' invece di 'H') — ma l'esempio di loop multi-byte che lo circonda nello stesso documento ha un bug reale che lo fa fermare silenziosamente dopo un byte su qualsiasi cattura multi-byte.

Testato il: 2026-07-13 · Claude Code 2.x (agent harness)

Installazione

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

Comandi e prompt di esempio

  • /logicmsoDecodifica UART/SPI/I2C/1-Wire da export binari di Saleae Logic MSO per CTF e reverse engineering hardware.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • 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