doc(examples): explain how to run basic_gr_peach

Author: yvt

README.md

@@ -129,6 +129,10 @@ cd examples/basic_nucleo_f401re
 cargo embed --release
 ```
 
+See [this document](examples/basic_gr_peach/README.md) for how to run the example application on [the GR-PEACH development board].
+
+[the GR-PEACH development board]: https://www.renesas.com/us/en/products/gadget-renesas/boards/gr-peach.html#overview
+
 ## Prerequisites
 
 You need a Nightly Rust compiler. This project is heavily reliant on unstable features, so it might or might not work with a newer compiler version. See the file `rust-toolchain` to find out which compiler version this project is currently tested with.

examples/basic_gr_peach/.gdbinit

@@ -0,0 +1,9 @@
+target remote :3333
+mon reset halt
+
+# Enable the on-chip RAM
+mon mwb 0xFCFE0400 0xff
+mon mwb 0xFCFE0404 0xff
+mon mwb 0xFCFE0408 0xff
+
+load

examples/basic_gr_peach/README.md

@@ -0,0 +1,38 @@
+This directory contains an example Constance application for [GR-PEACH].
+
+[GR-PEACH]: https://www.renesas.com/us/en/products/gadget-renesas/boards/gr-peach.html#overview
+
+You need the following software to run this application:
+
+ - [OpenOCD]
+ - `arm-none-eabi-gdb`
+ - [rustup] or the correct version of the Rust toolchain
+ - The Armv7-A build of the Rust standard library (can be [installed] by `rustup target add armv7a-none-eabi`)
+
+[OpenOCD]: http://openocd.org
+[rustup]: https://rustup.rs
+[installed]: https://rust-lang.github.io/rustup/cross-compilation.html
+
+This application can be loaded onto the target using OpenOCD and GDB. In one terminal window, start an instance of OpenOCD using the supplied configuration file:
+
+```shell
+openocd -f opencd.cfg
+```
+
+In another terminal window, compile and load the application by doing the following:
+
+```shell
+cargo build --release
+arm-none-eabi-gdb -iex 'target remote localhost:3333' ../../target/armv7a-none-eabi/release/basic_gr_peach
+```
+
+GDB automatically executes the commands in the `.gdbinit` file to download the image to the target's on-chip memory and direct PC to the entry point. Now, open a serial terminal application, configure the baud rate to 115200, and enter `c` in GDB. You should see the following output in the serial terminal:
+
+```text
+UART is ready
+COTTAGE = Objects { task1: Task(1), task2: Task(2) }
+time = 5.178ms
+time = 1.006644s
+time = 2.007444s
+...
+```

examples/basic_gr_peach/openocd.cfg

@@ -0,0 +1,17 @@
+source [find interface/cmsis-dap.cfg]
+source [find target/swj-dp.tcl]
+
+set _CHIPNAME rza1
+swj_newdap $_CHIPNAME cpu -expected-id 0x3ba02477
+
+set _TARGETNAME $_CHIPNAME.cpu
+target create $_TARGETNAME cortex_a -chain-position $_TARGETNAME
+
+adapter_khz 1000
+reset_config trst_and_srst
+debug_level 0
+gdb_target_description enable
+gdb_breakpoint_override hard
+init
+halt
+cortex_a dbginit