Overview

This tool analyzes digital signal captures from logic analyzers. It extracts clock-synchronized data bits and can decode various protocols.

Supported File Format

The tool accepts CSV files from Kingst Logic Analyzer software, KVDAT captures, and oscilloscope waveform CSVs with metadata before the data header. The CSV should have:

• A header row with column names
• Time values in the first column (in seconds)
• Digital signal values (0 or 1) or analog voltage values in subsequent columns

Single-channel waveform CSVs can be selected with the Bus checkboxes and combined with Create Bus. Files named like SDA/Data and SCL/CLK are paired automatically when dropped together.

CSV Format Example

Time[s], clock, dat
2.00000000, 1, 1
2.30403414, 0, 1
2.30403514, 1, 1
2.30403614, 0, 1
2.30403714, 1, 0
2.30403814, 0, 0
2.30403914, 1, 1

Interface Types

The tool auto-detects available interface types based on the number of columns in your CSV:

Interface	Signals	Min Columns	Protocols
2-Wire	CLK, DATA	2	FSI, I²C, SMBus, PMBus
SPI (4-Wire)	CLK, MOSI, MISO, CS	4	SPI
Dual SPI	CLK, IO0, IO1, CS	4	Dual SPI
Quad SPI	CLK, IO0-3, CS	6	QSPI

Column Settings

Setting	Description	Default
Interface	Select the interface type (auto-filtered by column count)	2-Wire
Signals	Column index for each signal (1-based after time column)	Sequential
Protocol	Protocol decoder (filtered by interface type)	None

Note: Sampling edge and bit order are determined by the selected protocol.

How It Works

1. Load your CSV file by drag & drop or clicking the drop zone
2. Adjust column settings if your clock/data are in different columns
3. Select sample edge (rising/falling) based on your protocol
4. Choose bit order (MSB/LSB) as needed
5. Select a protocol decoder if applicable
6. Click on Data/Non-FF/Decoded columns to see full details

Output Columns

• Frequency — Detected clock frequency
• Period — Clock period in microseconds
• Bits — Total number of sampled bits
• Data — Sampled data in hex or binary (click to expand)
• Non-FF — Bytes that are not 0xFF with their positions (click to expand)
• Decoded — Protocol frames if a decoder is selected

Global Options

• Display Format — Switch between Hexadecimal and Binary display
• Show byte timestamps — Include timing for each byte in the data display

Protocols

Protocol definitions are loaded from the protocols/ folder as JSON files. Currently supported:

• 2-Wire: FSI, I²C, SMBus, PMBus
• SPI: Standard SPI (4-wire)
• Dual SPI: 2-bit per clock mode
• Quad SPI: 4-bit per clock mode

Protocols are automatically filtered based on the selected interface type. Add new protocols by placing JSON definition files in the protocols/ directory with an interface section.