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 (and compatible formats). The CSV should have:
- A header row with column names
- Time values in the first column (in seconds)
- Digital signal values (0 or 1) in subsequent columns
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
- Load your CSV file by drag & drop or clicking the drop zone
- Adjust column settings if your clock/data are in different columns
- Select sample edge (rising/falling) based on your protocol
- Choose bit order (MSB/LSB) as needed
- Select a protocol decoder if applicable
- 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.