Commit 4adbfa45 authored by Yoshinori Sato's avatar Yoshinori Sato Committed by Philippe Mathieu-Daudé
Browse files

docs: Document the RX target 



Add rx-virt target specification document.

Signed-off-by: default avatarYoshinori 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: default avatarPhilippe Mathieu-Daudé <f4bug@amsat.org>
Reviewed-by: default avatarRichard Henderson <richard.henderson@linaro.org>
parent cf665623

MAINTAINERS

+1 −0
Original line number Diff line number Diff line
@@ -1261,6 +1261,7 @@ RX Machines 
rx-gdbsim

M: Yoshinori Sato <ysato@users.sourceforge.jp>

S: Maintained

F: docs/system/target-rx.rst

F: hw/rx/rx-gdbsim.c

F: tests/acceptance/machine_rx_gdbsim.py

docs/system/target-rx.rst

0 → 100644
+36 −0
Original line number Diff line number Diff line 
.. _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"

docs/system/targets.rst

+1 −0
Original line number Diff line number Diff line
@@ -18,3 +18,4 @@ Contents: 
   target-m68k

   target-xtensa

   target-s390x

   target-rx