Mostly updates to the yocto links or adding the refhw.
Signed-off-by: Jan-Simon Möller <jsmoeller@linuxfoundation.org>
Change-Id: Ib28bd5de72e7be8b2a2605e8149143fb946a7b69
Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/25984
- Login into AGL :
```sh
- Automotive Grade Linux 9.99.4+snapshot qemux86-64 ttyS1
+ Automotive Grade Linux 11.0.0+snapshot qemux86-64 ttyS1
qemux86-64 login: root
```

- Go to `Storage`, and change the attribute to `Type : AHCI` and click on `OK`.

+ - Next go to `Display` and change the attribute to 'VMSVGA' for the graphics driver. Change the graphics memory to be at least 64MB.
- Click on `Start`.
- For troubleshooting, you can refer [here](https://lists.automotivelinux.org/g/agl-dev-community/message/8474).
$ xz -v -d agl-demo-platform-crosssdk-qemuarm.ext4.xz
```
-7. Launch QEMU with vinagre (for scaling), remove `- snapshot \` if you want to save changes to the image files :
+7. Launch QEMU with vinagre (for scaling), remove `- snapshot` if you want to save changes to the image files :
```sh
$ ( sleep 5 && vinagre --vnc-scale localhost ) > /tmp/vinagre.log 2>&1 &
- Login into AGL :
```sh
- Automotive Grade Linux 9.99.4+snapshot qemux86-64 ttyS1
+ Automotive Grade Linux 11.0.0+snapshot qemux86-64 ttyS1
qemux86-64 login: root
```
- Login into AGL :
```sh
- Automotive Grade Linux 9.99.4+snapshot qemux86-64 ttyS1
+ Automotive Grade Linux 11.0.0+snapshot qemux86-64 ttyS1
qemux86-64 login: root
```
4. Make sure your build configuration is defined exactly how you want it for your build.
5. Use
- [BitBake](https://yoctoproject.org/docs/3.1.2/bitbake-user-manual/bitbake-user-manual.html)
+ [BitBake](https://yoctoproject.org/docs/3.1.4/bitbake-user-manual/bitbake-user-manual.html)
to build your image.
making sure your system is set up to use the
[Yocto Project](https://yoctoproject.org) OpenEmbedded build system,
which is based on
-[BitBake](https://yoctoproject.org/docs/3.1.2/bitbake-user-manual/bitbake-user-manual.html).
+[BitBake](https://yoctoproject.org/docs/3.1.4/bitbake-user-manual/bitbake-user-manual.html).
This section presents minimal information so you can prepare the build host
to use the "Dunfell" version of the Yocto Project (i.e. version 3.1.2).
1. **Use a Supported Linux Distribution:** To use the AGL software, it is
recommended that your build host is a native Linux machine that runs a
Yocto Project supported distribution as described by the
- "[Supported Linux Distributions](https://www.yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#detailed-supported-distros)"
+ "[Supported Linux Distributions](https://www.yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#detailed-supported-distros)"
section in the Yocto Project Reference Manual.
Basically, you should be running a recent version of Ubuntu, Fedora, openSUSE,
CentOS, or Debian.
* Python 3.4.0 or greater
If your distribution does not meet these minimal requirements, see the
- "[Required Git, tar, and Python Versions](https://www.yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#required-git-tar-and-python-versions)"
+ "[Required Git, tar, and Python Versions](https://www.yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#required-git-tar-and-python-versions)"
section in the Yocto Project Reference Manual for steps that you can
take to be sure you have these tools.
Depending on the Linux distribution you are using, the list of
host packages differ.
See
- "[The Build Host Packages](https://www.yoctoproject.org/docs/3.1.2/yocto-project-qs/yocto-project-qs.html#packages)"
+ "[The Build Host Packages](https://www.yoctoproject.org/docs/3.1.4/yocto-project-qs/yocto-project-qs.html#packages)"
section of the Yocto Project Quick Start for information on the packages you need.
**NOTE:** If you are using the CentOS distribution, you need to
separately install the epel-release package and run the `makecache` command as
described in
- "[The Build Host Packages](https://www.yoctoproject.org/docs/3.1.2/yocto-project-qs/yocto-project-qs.html#packages)"
+ "[The Build Host Packages](https://www.yoctoproject.org/docs/3.1.4/yocto-project-qs/yocto-project-qs.html#packages)"
section of the Yocto Project Quick Start.
Aside from the packages listed in the previous section, you need the following:
* **agl-ci**: Flags used for Continuous Integration (CI).
Using this feature changes the value of the
- [`IMAGE_FSTYPES`](https://yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#var-IMAGE_FSTYPES)
+ [`IMAGE_FSTYPES`](https://yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#var-IMAGE_FSTYPES)
variable.
* **agl-ci-change-features**: Enables features for CI builds for Gerrit changes.
agl-profile-telematics
**NOTE:** For information on Package Groups, see the
- "[Customizing Images Using Custom Package Groups](https://www.yoctoproject.org/docs/3.1.2/dev-manual/dev-manual.html#usingpoky-extend-customimage-customtasks)"
+ "[Customizing Images Using Custom Package Groups](https://www.yoctoproject.org/docs/3.1.4/dev-manual/dev-manual.html#usingpoky-extend-customimage-customtasks)"
section in the Yocto Project Development Tasks Manual.
You can also find general information about Layers in the
- "[Layers](https://www.yoctoproject.org/docs/3.1.2/dev-manual/dev-manual.html#yocto-project-layers)"
+ "[Layers](https://www.yoctoproject.org/docs/3.1.4/dev-manual/dev-manual.html#yocto-project-layers)"
section in that same manual.
-->
* **agl-ptest**: Enables
- [Ptest](https://yoctoproject.org/docs/3.1.2/dev-manual/dev-manual.html#testing-packages-with-ptest)
+ [Ptest](https://yoctoproject.org/docs/3.1.4/dev-manual/dev-manual.html#testing-packages-with-ptest)
as part of the build.
* **agl-sota**: Enables Software Over-the-Air (SOTA) components and dependencies.
documentation set.
Here are some references if you want to dig into configuration further:
-* [Customizing Images Using local.conf](https://yoctoproject.org/docs/3.1.2/dev-manual/dev-manual.html#usingpoky-extend-customimage-localconf)
-* [Local](https://yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#ref-varlocality-config-local)
-* [build/conf/local.conf](https://yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#structure-build-conf-local.conf)
-* [build/conf/bblayers.conf](https://yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#structure-build-conf-bblayers.conf)
-* [BBLAYERS](https://yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#var-BBLAYERS)
-* [User Configuration](https://yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#user-configuration)
-* [Enabling Your Layer](https://yoctoproject.org/docs/3.1.2/dev-manual/dev-manual.html#enabling-your-layer)
+* [Customizing Images Using local.conf](https://yoctoproject.org/docs/3.1.4/dev-manual/dev-manual.html#usingpoky-extend-customimage-localconf)
+* [Local](https://yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#ref-varlocality-config-local)
+* [build/conf/local.conf](https://yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#structure-build-conf-local.conf)
+* [build/conf/bblayers.conf](https://yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#structure-build-conf-bblayers.conf)
+* [BBLAYERS](https://yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#var-BBLAYERS)
+* [User Configuration](https://yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#user-configuration)
+* [Enabling Your Layer](https://yoctoproject.org/docs/3.1.4/dev-manual/dev-manual.html#enabling-your-layer)
```
See the
-"[Maintaining Build Output Quality](https://www.yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#maintaining-build-output-quality)"
+"[Maintaining Build Output Quality](https://www.yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#maintaining-build-output-quality)"
section in the Yocto Project Reference Manual for a complete discussion on
build history.
```
You can read about the class in the
-"[rm_work.bbclass](https://www.yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#ref-classes-rm-work)"
+"[rm_work.bbclass](https://www.yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#ref-classes-rm-work)"
section of the Yocto Project Reference Manual for more information.
## Pointing at Shared State Cache Locations
```
If you want to know more about the Yocto Project sstate mechanism, see the
-"[Shared State Cache](https://www.yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#shared-state-cache)"
+"[Shared State Cache](https://www.yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#shared-state-cache)"
section in the Yocto Project Reference Manual.
## Preserving the Download Directory
Downloading these files can take a while, particularly if your network
connection is slow.
The process downloads files into a
-"[download directory](https://www.yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#var-DL_DIR)".
+"[download directory](https://www.yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#var-DL_DIR)".
The `DL_DIR` variable defines the download directory.
For subsequent builds, you can preserve this directory to speed up the download
part of a build.
```
You can learn more about shared state and how it is used in the
-"[Shared State Cache](https://yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#shared-state-cache)"
+"[Shared State Cache](https://yoctoproject.org/docs/3.1.4/ref-manual/ref-manual.html#shared-state-cache)"
section of the Yocto Project Reference Manual.
## Common Settings using Symbolic Link with site.conf
You can use the following command:
```sh
- chmod a+x $XDG_DOWNLOAD_DIR/*.zip
+ chmod a+rw $XDG_DOWNLOAD_DIR/*.zip
```
6. **Check to be Sure the Files are Downloaded and Have the Correct Rights:**
|:-:|:-:|
| Starter Kit Pro/M3 | `MACHINE`=m3ulcb |
| Starter Kit Pro/M3 + kingfisher support | `MACHINE`=m3ulcb-kf |
- | Starter Kit Pro/M3 without graphic | `MACHINE`=m3ulcb-nogfx |
+ | Starter Kit Pro/M3 without graphic driver (using pixman) | `MACHINE`=m3ulcb-nogfx |
| Starter Kit Premier/H3 | `MACHINE`=h3ulcb |
| Starter Kit Premier/H3 + kingfisher support | `MACHINE`=h3ulcb-kf |
- | Starter Kit Premier/H3 without graphic | `MACHINE`=h3ulcb-nogfx |
+ | Starter Kit Premier/H3 without graphic driver (using pixman) | `MACHINE`=h3ulcb-nogfx |
| Salvator-X | `MACHINE`=h3-salvator-x |
| AGL Reference Hardware | `MACHINE`=h3ulcb |
- | AGL Reference Hardware without graphic | `MACHINE`=h3ulcb-nogfx |
+ | AGL Reference Hardware without graphic driver (using pixman) | `MACHINE`=h3ulcb-nogfx |
For example, the following command defines and exports the `MACHINE` variable
- for the Starter Kit Pro/M3 Board:
+ for the Starter Kit Premier/H3 Board:
```sh
- $ export MACHINE=m3ulcb
+ $ export MACHINE=h3ulcb
```
2. **Run the `aglsetup.sh` Script:**
https://www.renesas.com/en-us/solutions/automotive/rcar-demoboard-2.html
These 2 files from there should be store in your'/home/devel/Downloads' directory.
- R-Car_Gen3_Series_Evaluation_Software_Package_for_Linux-weston5-20190802.zip
- R-Car_Gen3_Series_Evaluation_Software_Package_of_Linux_Drivers-weston5-20190802.zip
+ R-Car_Gen3_Series_Evaluation_Software_Package_for_Linux-weston8-20200923.zip
+ R-Car_Gen3_Series_Evaluation_Software_Package_of_Linux_Drivers-weston8-20200923.zip
/home/working/workspace_agl_master/build_gen3
--- fragment /home/working/workspace_agl_master/meta-agl/templates/base/99_setup_EULAconf.sh
--- end of setup script
~/workspace_agl/build/conf $ cat setup.log
--- beginning of setup script
--- fragment /home/working/workspace_agl/meta-agl/templates/base/01_setup_EULAfunc.sh
- --- fragment /home/working/workspace_agl/meta-agl/templates/machine/m3ulcb/50_setup.sh
+ --- fragment /home/working/workspace_agl/meta-agl/templates/machine/h3ulcb/50_setup.sh
~/workspace_agl ~/workspace_agl/build
- ERROR: FILES "+/home/working/Downloads/R-Car_Gen3_Series_Evaluation_Software_Package_for_Linux-weston5-20190802.zip+" NOT EXTRACTING CORRECTLY
- ERROR: FILES "+/home/working/Downloads/R-car_Gen3_Series_Evaluation_Software_Package_of_Linux_Drivers-weston5-20190802.zip+" NOT EXTRACTING CORRECTLY
+ ERROR: FILES "+/home/working/Downloads/R-Car_Gen3_Series_Evaluation_Software_Package_for_Linux-weston8-20200923.zip+" NOT EXTRACTING CORRECTLY
+ ERROR: FILES "+/home/working/Downloads/R-car_Gen3_Series_Evaluation_Software_Package_of_Linux_Drivers-weston8-20200923.zip+" NOT EXTRACTING CORRECTLY
The graphics and multimedia acceleration packages for
the R-Car Gen3 board BSP can be downloaded from:
<https://www.renesas.com/us/en/application/automotive/r-car-h3-m3-documents-software>
These 2 files from there should be stored in your
'/home/working/Downloads' directory.
- R-Car_Gen3_Series_Evaluation_Software_Package_for_Linux-weston5-20190802.zip
- R-Car_Gen3_Series_Evaluation_Software_Package_of_Linux_Drivers-weston5-20190802.zip
+ R-Car_Gen3_Series_Evaluation_Software_Package_for_Linux-weston8-20200923.zip
+ R-Car_Gen3_Series_Evaluation_Software_Package_of_Linux_Drivers-weston8-20200923.zip
ERROR: Script /home/working/workspace_agl/build/conf/setup.sh failed
[snip]
```
root@m3ulcb:~# cat /etc/os-release
ID="poky-agl"
NAME="Automotive Grade Linux"
-VERSION="3.0.0+snapshot-20161202 (chinook)"
-VERSION_ID="3.0.0-snapshot-20161202"
-PRETTY_NAME="Automotive Grade Linux 3.0.0+snapshot-20161202 (chinook)"
+VERSION="11.0.0+snapshot-20210128 (koi)"
+VERSION_ID="11.0.0-snapshot-20210128"
+PRETTY_NAME="Automotive Grade Linux 11.0.0+snapshot-20210128 (koi)"
```
## 11. Supplementary Information
| | m3ulcb | arm64 |
| | m3-salvator-x | arm64 |
| | m3-kf | arm64 |
+| | agl-refhw | arm64 |
| | | |
| Raspberry Pi | raspberrypi4 | arm64 |
### Community supported Machines
-| BOARD | $MACHINE | ARCHITECHTURE |
-|:-------------:|:-----------------:|:-------------:|
-| BeagleBone | bbe | arm32 |
-| | beaglebone | arm32 |
-| | | |
-| i. MX 6 | cubox-i | arm32 |
-| | imx6qdlsabreauto | arm32 |
-| | nitrogen6x | arm32 |
-| | | |
-| i. MX 8 | imx8mqevk | arm64 |
-| | imx8mqevk-viv | arm64 |
-| | | |
-| Snapdragon | dragonboard-410c | arm64 |
-| | dragonboard-820c | arm64 |
-| | | |
-| ARC HS | hsdk | ARC |
+| BOARD | $MACHINE | ARCHITECHTURE |
+|:-------------:|:---------------------:|:-------------:|
+| BeagleBone | bbe | arm32 |
+| | beaglebone | arm32 |
+| | | |
+| i.MX 6 | cubox-i | arm32 |
+| | imx6qdlsabreauto | arm32 |
+| | nitrogen6x | arm32 |
+| | | |
+| i.MX 8 | imx8mqevk | arm64 |
+| | imx8mqevk-viv | arm64 |
+| | | |
+| Snapdragon | dragonboard-410c | arm64 |
+| | dragonboard-820c | arm64 |
+| | | |
+| ARC HS | hsdk | ARC |
### Supported Images
**Supported boards** :
-AGL Reference Boards (QEMU, RCar Gen 3 & Raspberry Pi 4)
+AGL Reference Boards (QEMU, RCar Gen 3, agl-refhw & Raspberry Pi 4)
Community supported Machines (i. MX 6, i. MX 8, Snapdragon & ARC HS)
* Setting up flags at `aglsetup` script :
```sh
- $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-profile-graphical-html5
+ $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo
# To enable Developer Options
- $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-profile-graphical-html5 agl-devel
+ $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-devel
```
* Building target image :
* Setting up flags at `aglsetup` script :
```sh
- $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-cluster-demo
+ $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo
# To enable Developer Options
- $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-cluster-demo agl-devel
+ $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-devel
```
* Building target image :
* Setting up flags at `aglsetup` script :
```sh
- $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-telematics-demo
+ $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo
# To enable Developer Options
- $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-telematics-demo agl-devel
+ $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-devel
```
* Building target image :
```sh
$ time bitbake agl-telematics-demo
- ```
\ No newline at end of file
+ ```
## Packagegroups
This section describes the AGL
-[packagegroup](https://yoctoproject.org/docs/3.1.2/dev-manual/dev-manual.html#usingpoky-extend-customimage-customtasks)
+[packagegroup](https://yoctoproject.org/docs/3.1.4/dev-manual/dev-manual.html#usingpoky-extend-customimage-customtasks)
design:
* packagegroup-agl-image-minimal
## Packagegroups
-AGL DEMO Platform's [packagegroups](https://www.yoctoproject.org/docs/3.1.2/dev-manual/dev-manual.html#usingpoky-extend-customimage-customtasks)
+AGL DEMO Platform's [packagegroups](https://www.yoctoproject.org/docs/3.1.4/dev-manual/dev-manual.html#usingpoky-extend-customimage-customtasks)
consist of the following:
- packagegroup-agl-demo-platform