QEMU Emulation for OpenRISC 1000

Board Overview

Name:

qemu_or1k

Vendor:

QEMU, a generic and open source machine emulator and virtualizer

Status:

Maintained

Architecture:

openrisc

SoC:

qemu_or1k

Browse board sources

Overview

This board configuration will use QEMU to emulate the OpenRISC 1000 platform.

This configuration provides support for an or1k CPU core and these devices:

• OpenRISC Interrupt Controller

• OpenRISC Tick Timer

• NS16550 UART

Note

This board configuration makes no claims about its suitability for use with an actual OpenRISC 1000 hardware system, or any other hardware system.

Hardware

Supported Features

The qemu_or1k board supports the hardware features listed below.

on-chip / on-board

Feature integrated in the SoC / present on the board.

2 / 2

Number of instances that are enabled / disabled.
Click on the label to see the first instance of this feature in the board/SoC DTS files.

vnd,foo

Compatible string for the Devicetree binding matching the feature.
Click on the link to view the binding documentation.

qemu_or1k/qemu_or1k target

Type	Location	Description	Compatible
Interrupt controller	on-board	OpenRISC CPU interrupt controller1	opencores,or1k-pic-level
Serial controller	on-board	ns16550 UART1	ns16550
SRAM	on-board	Generic on-chip SRAM1	mmio-sram

Devices

System Clock

Qemu Tick Timer timer uses a clock frequency of 20 MHz, see hw/openrisc/cputimer.c in Qemu source tree for details.

Serial Port

This board configuration uses a single serial communication channel with UART3.

Programming and Debugging

Use this configuration to run basic Zephyr applications and kernel tests in the QEMU emulated environment, for example, with the Basic Synchronization sample:

# From the root of the zephyr repository
west build -b qemu_or1k samples/synchronization
west build -t run

This will build an image with the synchronization sample app, boot it using QEMU, and display the following console output:

*** Booting Zephyr OS build zephyr-v3.5.0-3843-g5a1358a9ef ***
thread_a: Hello World from cpu 0 on qemu_or1k!
thread_b: Hello World from cpu 0 on qemu_or1k!
thread_a: Hello World from cpu 0 on qemu_or1k!
thread_b: Hello World from cpu 0 on qemu_or1k!
thread_a: Hello World from cpu 0 on qemu_or1k!
thread_b: Hello World from cpu 0 on qemu_or1k!
thread_a: Hello World from cpu 0 on qemu_or1k!
thread_b: Hello World from cpu 0 on qemu_or1k!
thread_a: Hello World from cpu 0 on qemu_or1k!
thread_b: Hello World from cpu 0 on qemu_or1k!

Exit QEMU by pressing CTRL+A x.

References

https://www.qemu.org/