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>
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
| 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:
$ 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`).
```
**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
* **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
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** or **AGL Reference Hardware**:
```text
Automotive Grade Linux ${AGL_VERSION} h3ulcb ttySC0
```text
Automotive Grade Linux ${AGL_VERSION} h3ulcb ttySC0