Logic MSO Analysis

Decodifica UART/SPI/I2C/1-Wire desde exportaciones binarias de Saleae Logic MSO, para CTF e ingeniería inversa de hardware.

Por BrownFineSecurity · BrownFineSecurity/iothackbot

Funciona con configuración ★ 7.6/10

Logic MSO Analysis — Decodifica UART/SPI/I2C/1-Wire desde exportaciones binarias de Saleae Logic MSO, para CTF e ingeniería inversa de hardware.

Qué hace

Carga capturas binarias de Saleae Logic MSO vía la librería Python saleae-mso-api y ofrece heurísticas de agrupamiento temporal (timing-cluster) más ejemplos de Python trabajados para decodificar señales UART, SPI, I2C y 1-Wire, orientado a retos de CTF e ingeniería inversa de hardware. Incluye un CLI analyze_protocol.py (modos de histograma/cluster/exportación CSV) y una guía examples.md para triage de protocolos desconocidos.

Informe de la prueba

Construimos una captura UART sintética de 2 bytes ('Hi') y ejecutamos textualmente el propio decode_uart_byte() del SKILL.md: su muestreo en el centro del período de bit recuperó correctamente el primer byte, donde un muestreador base ingenuo hecho desde cero se equivocó ('X' en vez de 'H') — pero el ejemplo de bucle multi-byte que lo rodea en el mismo documento tiene un bug real que hace que se detenga silenciosamente tras un byte en cualquier captura multi-byte.

Probado el: 2026-07-13 · Claude Code 2.x (agent harness)

Instalación

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

Comandos y prompts de ejemplo

  • /logicmsoDecodifica UART/SPI/I2C/1-Wire desde exportaciones binarias de Saleae Logic MSO, para CTF e ingeniería inversa de hardware.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • 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