Skip to contentSkip to conversation

docs: Add RX target.

PATCH Superseded Yoshinori Sato 3 participants 6 messages Mar 8, 2020 – Mar 10, 2020

v1 of 2 Superseded Latest is v2 →

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 docs: Add RX target.

Add rx-virt target specificaion document.

---
 docs/system/target-rx.rst | 35 +++++++++++++++++++++++++++++++++++
 docs/system/targets.rst   |  1 +
 2 files changed, 36 insertions(+)
 create mode 100644 docs/system/target-rx.rst
docs/system/target-rx.rst new file +35 -0
new file mode 100644
index 0000000000..8540fd5218
@@ -0,0 +1,35 @@
+.. _RX-System-emulator:
+
+RX System emulator
+--------------------
+
+Use the executable ``qemu-system-rx`` to simulate a Virtual RX target.
+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 -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 -kernel <kernel_image_file> -dtb <device_tree_blob> \
+      -append "earlycon"
docs/system/targets.rst +1 -0
index eba3111247..946f513daa 100644
@@ -17,3 +17,4 @@ Contents:
    target-arm
    target-m68k
    target-xtensa
+   target-rx
Signature · 1 line
2.20.1
#1 lore raw
Quoted 1 line · Yoshinori Sato

Add rx-virt target specificaion document.

specification

Quoted 14 lines
---
  docs/system/target-rx.rst | 35 +++++++++++++++++++++++++++++++++++
  docs/system/targets.rst   |  1 +
  2 files changed, 36 insertions(+)

create mode 100644 docs/system/target-rx.rst

docs/system/target-rx.rst new file +0 -0
new file mode 100644
index 0000000000..8540fd5218

docs/system/target-rx.rst line 7

Quoted 7 lines
docs/system/target-rx.rst new file +7 -0
@@ -0,0 +1,35 @@
+.. _RX-System-emulator:
+
+RX System emulator
+--------------------
+
+Use the executable ``qemu-system-rx`` to simulate a Virtual RX target.
+This target emulated following devices.

s/emulated/emulates the/

docs/system/target-rx.rst Contents: · line 20

Quoted 6 lines
docs/system/target-rx.rst new file +2 -0
+++ b/docs/system/targets.rst
@@ -17,3 +17,4 @@ Contents:
     target-arm
     target-m68k
     target-xtensa
+   target-rx

Is it worth keeping this list alphabetically sorted?

Signature · 3 lines
Eric Blake, Principal Software Engineer
Red Hat, Inc.           +1-919-301-3226
Virtualization:  qemu.org | libvirt.org
#2 lore raw

2020-03-10 00:07 に Eric Blake さんは書きました:

Quoted 13 lines · Yoshinori Sato
Quoted 1 line

Add rx-virt target specificaion document.

specification

Quoted 8 lines
---
  docs/system/target-rx.rst | 35 +++++++++++++++++++++++++++++++++++
  docs/system/targets.rst   |  1 +
  2 files changed, 36 insertions(+)

create mode 100644 docs/system/target-rx.rst

Quoted 17 lines
Quoted 12 lines
docs/system/target-rx.rst new file +6 -0
new file mode 100644
index 0000000000..8540fd5218
@@ -0,0 +1,35 @@
+.. _RX-System-emulator:
+
+RX System emulator
+--------------------
+
+Use the executable ``qemu-system-rx`` to simulate a Virtual RX 
Quoted 2 lines

target.
+This target emulated following devices.

s/emulated/emulates the/

OK. I'll fix it.

Quoted 9 lines

docs/system/target-rx.rst Contents: · line 20

Quoted 7 lines

+++ b/docs/system/targets.rst

docs/system/target-rx.rst new file +1 -0
@@ -17,3 +17,4 @@ Contents:
     target-arm
     target-m68k
     target-xtensa
+   target-rx

Is it worth keeping this list alphabetically sorted?

It was not in alphabetical order, it was added at the last. Is it better to arrange in alphabetical order?

---
Yoshinori Sato

#3 lore raw
Quoted 10 lines · Yoshinori Sato
Quoted 8 lines
Quoted 6 lines

+++ b/docs/system/targets.rst

(quoted diff) +0 -0
@@ -17,3 +17,4 @@ Contents:

     target-arm
     target-m68k
     target-xtensa
+   target-rx

Is it worth keeping this list alphabetically sorted?

It was not in alphabetical order, it was added at the last. Is it better to arrange in alphabetical order?

The 3 lines of context was alphabetical, but looking at the whole file, the overall list is not. So sticking yours last is fine after all.

Signature · 3 lines
Eric Blake, Principal Software Engineer
Red Hat, Inc.           +1-919-301-3226
Virtualization:  qemu.org | libvirt.org
#4 lore raw
Quoted 12 lines · Eric Blake
Quoted 9 lines · Yoshinori Sato
Quoted 8 lines

docs/system/targets.rst Contents: · line 20

Quoted 6 lines

+++ b/docs/system/targets.rst

docs/system/targets.rst +1 -0
@@ -17,3 +17,4 @@ Contents:
     target-arm
     target-m68k
     target-xtensa
+   target-rx

Is it worth keeping this list alphabetically sorted?

Quoted 5 lines
Quoted 2 lines

It was not in alphabetical order, it was added at the last. Is it better to arrange in alphabetical order?

The 3 lines of context was alphabetical, but looking at the whole file, the overall list is not. So sticking yours last is fine after all.

In an ideal world the correct order would probably be "alphabetical order of the headline titles in the referenced files", so that the displayed ToC is alphabetized.

thanks
-- PMM

#5 lore raw
Quoted 17 lines · Peter Maydell
Quoted 15 lines · Eric Blake
Quoted 11 lines · Yoshinori Sato
Quoted 8 lines

docs/system/targets.rst Contents: · line 20

Quoted 6 lines

+++ b/docs/system/targets.rst

docs/system/targets.rst +1 -0
@@ -17,3 +17,4 @@ Contents:
     target-arm
     target-m68k
     target-xtensa
+   target-rx

Is it worth keeping this list alphabetically sorted?

It was not in alphabetical order, it was added at the last. Is it better to arrange in alphabetical order?

Quoted 6 lines
Quoted 2 lines

The 3 lines of context was alphabetical, but looking at the whole file, the overall list is not. So sticking yours last is fine after all.

In an ideal world the correct order would probably be "alphabetical order of the headline titles in the referenced files", so that the displayed ToC is alphabetized.

OK.
Change to alphabetical order.

Quoted 2 lines

thanks
-- PMM

Signature · 1 line
Yosinori Sato