xref: /openbmc/qemu/docs/system/target-rx.rst (revision 992861fb)
1.. _RX-System-emulator:
2
3RX System emulator
4--------------------
5
6Use the executable ``qemu-system-rx`` to simulate RX target (GDB simulator).
7This target emulated following devices.
8
9-  R5F562N8 MCU
10
11   -  On-chip memory (ROM 512KB, RAM 96KB)
12   -  Interrupt Control Unit (ICUa)
13   -  8Bit Timer x 1CH (TMR0,1)
14   -  Compare Match Timer x 2CH (CMT0,1)
15   -  Serial Communication Interface x 1CH (SCI0)
16
17-  External memory 16MByte
18
19Example of ``qemu-system-rx`` usage for RX is shown below:
20
21Download ``<u-boot_image_file>`` from
22https://osdn.net/users/ysato/pf/qemu/dl/u-boot.bin.gz
23
24Start emulation of rx-virt::
25  qemu-system-rx -M gdbsim-r5f562n8 -bios <u-boot_image_file>
26
27Download ``kernel_image_file`` from
28https://osdn.net/users/ysato/pf/qemu/dl/zImage
29
30Download ``device_tree_blob`` from
31https://osdn.net/users/ysato/pf/qemu/dl/rx-virt.dtb
32
33Start emulation of rx-virt::
34  qemu-system-rx -M gdbsim-r5f562n8 \
35      -kernel <kernel_image_file> -dtb <device_tree_blob> \
36      -append "earlycon"
37