How ali-abdl/uart-verilog-cocotb works
This repository implements a parameterized, full-duplex UART and its verification environment. The runtime path is a controller request through the UART top level to the transmitter, with baud ticks supporting serial timing; incoming serial data is synchronized and decoded by the receiver. The repository also provides cocotb regression, scoreboard and functional coverage, plus bound SystemVerilog protocol assertions. The map reflects README-documented relationships; source excerpts did not include the RTL or individual testbenches, so their internal call wiring is not inferred.
Main entry points: tb Cocotb Test Suites · uart.v UART Top · uart_tx.v Transmitter FSM · uart_rx.v Receiver FSM
Components 14
UART Design
- UART Top
rtl/uart.v - Transmitter FSM
rtl/uart_tx.v - Receiver FSM
rtl/uart_rx.v - Baud Tick Generator
rtl/baud_gen.v
Cocotb Verification
- Cocotb Test Suites
tb - Loopback Harness
tb/uart_loopback.v - Scoreboard
tb/scoreboard.py - Functional Coverage
tb/coverage.py
Assertion Verification
- TX Assertions
sva/uart_tx_sva.sv - RX Assertions
sva/uart_rx_sva.sv - TX Assertion Bench
sva/tb_uart_tx_sva.sv - RX Assertion Bench
sva/tb_uart_rx_sva.sv
Other components
- Host Controller
- Serial Peer
Connections 15
- Host Controller → UART Top: requests transfer
README.md - UART Top → Transmitter FSM: routes transmit
README.md - UART Top → Receiver FSM: routes receive
README.md - Transmitter FSM → Baud Tick Generator: uses gated ticks
README.md - Receiver FSM → Baud Tick Generator: uses oversample ticks
README.md - Serial Peer → Receiver FSM: sends serial data
README.md - Transmitter FSM → Serial Peer: transmits serial data
README.md - Cocotb Test Suites → UART Top: exercises DUT
README.md - Cocotb Test Suites → Loopback Harness: uses harness
README.md - Cocotb Test Suites → Scoreboard: checks results
- Cocotb Test Suites → Functional Coverage: collects coverage
- TX Assertion Bench → TX Assertions: drives assertions
README.md - RX Assertion Bench → RX Assertions: drives assertions
README.md - TX Assertions → Transmitter FSM: binds to FSM
README.md - RX Assertions → Receiver FSM: binds to FSM
README.md