What you practice
Explore a pre-built SoC tree (0.2). Explore a pre-seeded SoC hierarchy and verify base address assignments via simulation without code changes. It is in Explore SoC Hierarchy — Part 0 · SoC Warming Up of the SoC Masterclass. Meet a mini-SoC memory map and walk a pre-built hierarchy in simulation.
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
You will explore a pre-seeded System-on-Chip (SoC) hierarchy and verify its base address assignments through simulation. This lesson warms up your workflow by running a complete design without requiring any code changes.
Learning objectives
- Navigate the RtlStudio workspace for a pre-built SoC lesson.
- Inspect the DUT
dutand its internalsoc_hierarchy_previewmodule. - Run simulation and interpret the
INFO:log output from the testbench. - Verify that the timer base address matches the expected constant value.
Theory
An SoC integrates multiple peripheral modules such as GPIO, timers, and UARTs onto a single chip. Each peripheral requires a unique base address in the memory map for CPU access. The soc_hierarchy_preview module in this lesson simply assigns fixed constants to these base addresses. This setup allows you to focus on the simulation flow and hierarchy inspection before implementing complex logic.
| Signal Name | Direction | Width | Description |
|---|---|---|---|
| clk | Input | 1-bit | System clock |
| rst_n | Input | 1-bit | Active-low reset |
| gpio_base | Output | 32-bit | Base address for GPIO peripheral |
| timer_base | Output | 32-bit | Base address for Timer peripheral |
| uart_base | Output | 32-bit | Base address for UART peripheral |
Practice
Open RtlStudio and select lesson 0.2 from the Examples or Lecture list. Confirm that the file tree appears in the Explore panel with student/ and golden/ directories. Open student/rtl/design.sv to inspect the DUT implementation. Notice that dut instantiates soc_hierarchy_preview to drive the output base addresses. Open student/tb/tb_top.sv to review the testbench stimulus and checking logic. The testbench asserts reset, waits for stabilization, and then checks the timer_base value. Click Simulation in the left sidebar and run the simulation. Read the Log panel to see the INFO: messages printed by the testbench.
Summary
You explored a pre-built SoC hierarchy by examining the DUT and its instantiated IP modules. You verified the correct wiring of base address outputs for GPIO, Timer, and UART peripherals. Running the simulation confirmed that the hierarchy initializes correctly and produces the expected PASS result.
© 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 Explore a pre-built SoC tree. Change the source, run the Verilog simulator again, and read the waveform without leaving the IDE. Simulation guide · Yosys guide.