What you practice
Peripheral subsystem top (2.6). Integrate GPIO, timer, UART, and IRQ modules into a peripheral subsystem top using AXI interfaces and interrupt aggregation. It is in Peripheral Subsystem Top — Part 2 · Peripheral Islands of the SoC Masterclass. Build GPIO, timer, UART, and IRQ islands, then wrap them as a peripheral subsystem.
SoC lessons simulate the fabric and the peripheral together in the IDE. Verilator is the simulator; the waveform is where address and response show up.
What you will learn
Today you will integrate GPIO, timer, UART, and IRQ modules into a peripheral subsystem top. This lesson teaches hierarchical design and signal aggregation for complex SoC blocks. You will connect AXI interfaces and combine interrupt lines into a single output.
Learning objectives
- Instantiate
gpio_csr,timer_csr,uart_csr_hook, andirq_csrinsideperiph_subsystem. - Connect AXI slave interfaces to the correct peripheral modules.
- Aggregate individual interrupt sources into a single
irq_ooutput. - Verify the design using the provided testbench with AXI transactions.
Theory
A top-level peripheral subsystem acts as a wrapper for individual IP blocks. It routes external AXI signals to the correct internal modules. It also combines internal signals like interrupts into a unified interface. This approach keeps individual modules simple and reusable. The top module handles the aggregation logic and signal mapping.
| Concept | Description |
|---|---|
| Instantiation | Creating a module instance with port connections. |
| Interface | A bundle of signals (like AXI) passed as a single port. |
| Aggregation | Combining multiple signals (like IRQs) into one vector or wire. |
Practice
- Open RtlStudio and select this chapter from the Examples or Lecture list.
- Confirm that
student/rtl/ip/soc/periph_subsystem.svandstudent/tb/tb_top.svappear in the Explore tree. - Open
student/rtl/ip/soc/periph_subsystem.svin the editor. - Connect the
s_gpiointerface to theu_gpioinstancebusport. - Connect the
gpio_in,gpio_out, andgpio_oesignals to theu_gpioinstance. - Connect the
s_timerinterface to theu_timerinstancebusport. - Connect the
timer_irqsignal to theu_timerinstanceirq_pulseport. - Connect the
s_uartinterface to theu_uartinstancebusport.
Summary
You successfully integrated GPIO, timer, UART, and IRQ modules into the peripheral subsystem top module. You practiced instantiating IP blocks and routing internal signals like interrupts to the controller. The simulation confirmed correct connectivity with a passing INFO message.
© 2026 RtlStudio. Licensed under CC BY-NC-ND 4.0. Commercial use and modifications by third parties are not permitted.
Run it in the Verilog IDE
- Open the lesson workspace in the IDE. The fabric and the peripheral are one simulation.
- Run Verilator and follow the address, write data, and read response on the waveform.
- A passing log is not enough when decode or an IRQ line is the point of the lesson — those show up on the VCD.
- Run Yosys on the RTL island you just integrated when you want the mapped cells.
The lesson is done when the simulation matches Peripheral subsystem top. Change the source, run the Verilog simulator again, and read the waveform without leaving the IDE. Simulation guide · Yosys guide.