diff options
| author | Yoshinori Sato | 2020-01-23 14:25:25 +0100 |
|---|---|---|
| committer | Philippe Mathieu-Daudé | 2020-06-22 18:37:12 +0200 |
| commit | 4adbfa45cc3793fa85157a4813306618f6009f52 (patch) | |
| tree | 21d5b9927c3c89c5eb96a4c70cf5650c253f2418 /docs/system/target-rx.rst | |
| parent | BootLinuxConsoleTest: Test the RX GDB simulator (diff) | |
| download | qemu-4adbfa45cc3793fa85157a4813306618f6009f52.tar.gz qemu-4adbfa45cc3793fa85157a4813306618f6009f52.tar.xz qemu-4adbfa45cc3793fa85157a4813306618f6009f52.zip | |
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>
Diffstat (limited to 'docs/system/target-rx.rst')
| -rw-r--r-- | docs/system/target-rx.rst | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/docs/system/target-rx.rst b/docs/system/target-rx.rst new file mode 100644 index 0000000000..4a20a89a06 --- /dev/null +++ b/docs/system/target-rx.rst @@ -0,0 +1,36 @@ +.. _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" |