xemu/docs/system/target-rx.rst
Yoshinori Sato 4adbfa45cc docs: Document the RX target
Add rx-virt target specification document.

Signed-off-by: Yoshinori Sato <ysato@users.sourceforge.jp>
Message-Id: <20200308130637.37651-1-ysato@users.sourceforge.jp>
[PMD: Cover in MAINTAINERS, rename as gdbsim, use machine argument]
Signed-off-by: Philippe Mathieu-Daudé <f4bug@amsat.org>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
2020-06-22 18:37:12 +02:00

37 lines
1001 B
ReStructuredText

.. _RX-System-emulator:
RX System emulator
--------------------
Use the executable ``qemu-system-rx`` to simulate RX target (GDB simulator).
This target emulated following devices.
- R5F562N8 MCU
- On-chip memory (ROM 512KB, RAM 96KB)
- Interrupt Control Unit (ICUa)
- 8Bit Timer x 1CH (TMR0,1)
- Compare Match Timer x 2CH (CMT0,1)
- Serial Communication Interface x 1CH (SCI0)
- External memory 16MByte
Example of ``qemu-system-rx`` usage for RX is shown below:
Download ``<u-boot_image_file>`` from
https://osdn.net/users/ysato/pf/qemu/dl/u-boot.bin.gz
Start emulation of rx-virt::
qemu-system-rx -M gdbsim-r5f562n8 -bios <u-boot_image_file>
Download ``kernel_image_file`` from
https://osdn.net/users/ysato/pf/qemu/dl/zImage
Download ``device_tree_blob`` from
https://osdn.net/users/ysato/pf/qemu/dl/rx-virt.dtb
Start emulation of rx-virt::
qemu-system-rx -M gdbsim-r5f562n8 \
-kernel <kernel_image_file> -dtb <device_tree_blob> \
-append "earlycon"