RTL Studio Open IDE

2.6 · SOC CLASS

Peripheral subsystem top

Integrate GPIO, timer, UART, and IRQ modules into a peripheral subsystem top using AXI interfaces and interrupt aggregation.

Video coming soon. This lesson page stays at the same URL when the lecture publishes.

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, and irq_csr inside periph_subsystem.
  • Connect AXI slave interfaces to the correct peripheral modules.
  • Aggregate individual interrupt sources into a single irq_o output.
  • 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.

ConceptDescription
InstantiationCreating a module instance with port connections.
InterfaceA bundle of signals (like AXI) passed as a single port.
AggregationCombining multiple signals (like IRQs) into one vector or wire.

Practice

  1. Open RtlStudio and select this chapter from the Examples or Lecture list.
  2. Confirm that student/rtl/ip/soc/periph_subsystem.sv and student/tb/tb_top.sv appear in the Explore tree.
  3. Open student/rtl/ip/soc/periph_subsystem.sv in the editor.
  4. Connect the s_gpio interface to the u_gpio instance bus port.
  5. Connect the gpio_in, gpio_out, and gpio_oe signals to the u_gpio instance.
  6. Connect the s_timer interface to the u_timer instance bus port.
  7. Connect the timer_irq signal to the u_timer instance irq_pulse port.
  8. Connect the s_uart interface to the u_uart instance bus port.

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

  1. Open the lesson workspace in the IDE. The fabric and the peripheral are one simulation.
  2. Run Verilator and follow the address, write data, and read response on the waveform.
  3. A passing log is not enough when decode or an IRQ line is the point of the lesson — those show up on the VCD.
  4. 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.