Document AGL Reference Hardware

Add AGL Reference Hardware configuration to the Renesas board
documentation.

Bug-AGL: SPEC-3708

Signed-off-by: Scott Murray <scott.murray@konsulko.com>
Change-Id: I48c852ec2ee880cae121a7d3368f5a127bcf2d9b
Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/25957
Reviewed-by: Fr�d�ric Marec <frederic.marec@iot.bzh>
Reviewed-by: Jan-Simon Moeller <jsmoeller@linuxfoundation.org>
Tested-by: Jan-Simon Moeller <jsmoeller@linuxfoundation.org>

diff --git a/docs/0_Getting_Started/2_Building_AGL_Image/5_3_RCar_Gen_3.md b/docs/0_Getting_Started/2_Building_AGL_Image/5_3_RCar_Gen_3.md
index d0030c4..f97996b 100644 (file)
--- a/docs/0_Getting_Started/2_Building_AGL_Image/5_3_RCar_Gen_3.md
+++ b/docs/0_Getting_Started/2_Building_AGL_Image/5_3_RCar_Gen_3.md
@@ -18,6 +18,15 @@ image for the following Renesas platforms:
 The information on this page describes setup and build procedures for both of these
 Renesas development kits.
 
 The information on this page describes setup and build procedures for both of these
 Renesas development kits.
 

+Additionally, the AGL Reference Hardware platform is based on the same Renesas
+H3 processor used on the Renesas R-Car Starter Kit Premier and Salvator-X boards,
+so support for it leverages the Starter Kit Premier (also known as "h3ulcb")
+build.
+For more information on the AGL reference hardware platform, please refer to its
+[manual](https://wiki.automotivelinux.org/_media/eg-rhsa/rh_manual_ver.1.0.pdf),
+or the Reference Hardware System Architecture Expert Group
+[wiki page](https://wiki.automotivelinux.org/eg-rhsa).
+

 ## 1. Downloading Proprietary Drivers
 
 Before setting up the build environment, you need to download proprietary drivers from the
 ## 1. Downloading Proprietary Drivers
 
 Before setting up the build environment, you need to download proprietary drivers from the


@@ -152,6 +161,8 @@ you need to take steps to make sure your build host is set up correctly.
     | Starter Kit Premier/H3  + kingfisher support  | `MACHINE`=h3ulcb-kf |
     | Starter Kit Premier/H3  without graphic   | `MACHINE`=h3ulcb-nogfx |
     | Salvator-X  | `MACHINE`=h3-salvator-x |
     | Starter Kit Premier/H3  + kingfisher support  | `MACHINE`=h3ulcb-kf |
     | Starter Kit Premier/H3  without graphic   | `MACHINE`=h3ulcb-nogfx |
     | Salvator-X  | `MACHINE`=h3-salvator-x |

+    | AGL Reference Hardware | `MACHINE`=h3ulcb |
+    | AGL Reference Hardware  without graphic   | `MACHINE`=h3ulcb-nogfx |

 
     For example, the following command defines and exports the `MACHINE` variable
     for the Starter Kit Pro/M3 Board:
 
     For example, the following command defines and exports the `MACHINE` variable
     for the Starter Kit Pro/M3 Board:


@@ -169,6 +180,14 @@ you need to take steps to make sure your build host is set up correctly.
     $ source meta-agl/scripts/aglsetup.sh -m $MACHINE -b build agl-devel agl-demo
     ```
 
     $ source meta-agl/scripts/aglsetup.sh -m $MACHINE -b build agl-devel agl-demo
     ```
 

+    If building for the AGL Reference Hardware (with `MACHINE` set to "h3ulcb" or
+    "h3ulcb-nogfx"), add `agl-refhw-h3`, for example:
+
+    ```sh
+    $ cd $AGL_TOP
+    $ source meta-agl/scripts/aglsetup.sh -m $MACHINE -b build agl-devel agl-demo agl-refhw-h3
+    ```
+

     **NOTE:**
     Running the `aglsetup.sh` script automatically places you in the
     working directory (i.e. `$AGL_TOP/build`).
     **NOTE:**
     Running the `aglsetup.sh` script automatically places you in the
     working directory (i.e. `$AGL_TOP/build`).


@@ -371,6 +390,10 @@ Follow these steps to update the firmware:
     ```
 
     **NOTE:** The Salvator-X firmware update process is not documented on eLinux.
     ```
 
     **NOTE:** The Salvator-X firmware update process is not documented on eLinux.

+    **NOTE:** The AGL Reference Hardware board generally should not require a
+    firmware update to be usable, and has a slightly different update procedure.
+    If you do need to update the firmware, the procedure is documented
+    [here](https://git.automotivelinux.org/AGL/meta-agl-refhw/tree/meta-agl-refhw-gen3/docs/ReferenceHW_Rcar_gen3.md).

 
 ### Preparing the MicroSD Card
 
 
 ### Preparing the MicroSD Card
 


@@ -691,6 +714,8 @@ boot device and also to set the screen resolution:
 
        * **M3SK with a Kingfisher board** : `$ setenv load_dtb ext4load mmc 0:1 0x48000000 /boot/r8a7796-m3ulcb-kf.dtb`
 
 
        * **M3SK with a Kingfisher board** : `$ setenv load_dtb ext4load mmc 0:1 0x48000000 /boot/r8a7796-m3ulcb-kf.dtb`
 

+       * **AGL Reference Hardware board** : `$ setenv load_dtb ext4load mmc 0:1 0x48000000 /boot/r8a7795-agl-refhw.dtb`
+

 5. Save the boot environment:
     ```sh
     saveenv
 5. Save the boot environment:
     ```sh
     saveenv


@@ -709,7 +734,7 @@ Once the board boots, you should see the
 on the external monitor.
 A login prompt should appear as follows depending on your board:
 
 on the external monitor.
 A login prompt should appear as follows depending on your board:
 

-**h3ulcb**:
+**h3ulcb** or **AGL Reference Hardware**:

 
 ```text
 Automotive Grade Linux ${AGL_VERSION} h3ulcb ttySC0
 
 ```text
 Automotive Grade Linux ${AGL_VERSION} h3ulcb ttySC0