How tpanackerman/logic-analyzer-fpga works
This repository is a 16-channel FPGA logic analyzer with an ESP32 signal generator and a Python desktop application. The main workflow is to generate or probe digital signals, configure and trigger FPGA capture, stream records over UART, then visualize waveforms and decode protocols; automatic channel-role prediction and manual role assignment support analysis. The GUI also provides capture-dump and link-diagnostic utilities. The README documents the FPGA stages and product capabilities; sampled Python excerpts and the source index establish GUI module relationships. FPGA internals not excerpted are represented at documented subsystem level.
Main entry points: main.py GUI capture · analyze_dump.py Offline analysis · sample_access.py Sample access · capture_dump.py Capture dump
Components 14
Signal source
- ESP32 generator
esp32_gen_input/esp32_gen_input.ino
FPGA capture
- Analyzer top
src/logic_analyzer_top.v - Input sampler
src/sampler_sync.v - Trigger engine
src/trigger_engine.v - Capture buffer
src/circular_buffer_controller.v - UART stream
src/data_width_divider.v
Desktop analysis
- GUI capture
gui/main.py - Sample access
gui/sample_access.py - Role predictor
gui/channel_predictor.py - Protocol decoders
gui/decoders.py
Capture utilities
- Capture dump
gui/capture_dump.py - Offline analysis
gui/analyze_dump.py - Link diagnostic
gui/fpga_link_check.py
Other components
- Operator
Connections 20
- Operator → GUI capture: configures capture
README.md - ESP32 generator → Input sampler: drives probe signals
README.md - Analyzer top → Input sampler: samples inputs
README.md - Input sampler → Trigger engine: feeds sampled signals
README.md - Trigger engine → Capture buffer: controls capture
README.md - Capture buffer → UART stream: streams records
README.md - UART stream → GUI capture: sends UART data
README.md - GUI capture → Sample access: builds sample view
gui/main.py - GUI capture → Role predictor: predicts channel roles
gui/main.py - GUI capture → Protocol decoders: decodes protocols
gui/main.py - Role predictor → Sample access: reads waveform features
gui/channel_predictor.py - Protocol decoders → Sample access: reads waveform samples
gui/decoders.py - Operator → Capture dump: requests capture
gui/capture_dump.py - Capture dump → Analyzer top: configures and reads
gui/capture_dump.py - Capture dump → Offline analysis: saves dump data
gui/analyze_dump.py - Offline analysis → Sample access: builds sample view
gui/analyze_dump.py - Offline analysis → Role predictor: runs prediction
gui/analyze_dump.py - Offline analysis → Protocol decoders: runs decoding
gui/analyze_dump.py - Operator → Link diagnostic: checks connection
gui/fpga_link_check.py - Link diagnostic → Analyzer top: tests UART link
gui/fpga_link_check.py