aboutsummaryrefslogtreecommitdiffstats
path: root/docs/01_Getting_Started
diff options
context:
space:
mode:
authorJan-Simon Möller <jsmoeller@linuxfoundation.org>2024-07-01 19:33:17 +0200
committerJan-Simon Moeller <jsmoeller@linuxfoundation.org>2024-07-03 10:13:32 +0000
commitb0fe9d1d43a21dd5c244abb3c919ddb04ebed36c (patch)
treef594edd3dae5617aaffa0828f13a54b3f6425733 /docs/01_Getting_Started
parent7b526e80bf3b01f46593d45294af637324cdc6ca (diff)
Update documentation on ricefish branch
Update from master to ricefish. Bug-AGL: SPEC-5194 Signed-off-by: Jan-Simon Möller <jsmoeller@linuxfoundation.org> Change-Id: Iba48923ec4d904d555f681ba3b3bbdac7b42fe04 Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/30055
Diffstat (limited to 'docs/01_Getting_Started')
-rw-r--r--docs/01_Getting_Started/01_Quickstart/01_Using_Ready_Made_Images.md41
-rw-r--r--docs/01_Getting_Started/02_Building_AGL_Image/02_Preparing_Your_Build_Host.md2
-rw-r--r--docs/01_Getting_Started/02_Building_AGL_Image/04_Initializing_Your_Build_Environment.md6
-rw-r--r--docs/01_Getting_Started/02_Building_AGL_Image/05_Customizing_Your_Build.md2
-rw-r--r--docs/01_Getting_Started/02_Building_AGL_Image/07_Building_for_x86_(Emulation_and_Hardware).md2
-rw-r--r--docs/01_Getting_Started/02_Building_AGL_Image/09_Building_for_Supported_Renesas_Boards.md12
-rw-r--r--docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/01_Instrument_Cluster_(IC-IVI_with_Container_isolation).md18
-rw-r--r--docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/02_Flutter_Instrument_Cluster_(qemu-x86).md22
-rw-r--r--docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/03_IVI_Flutter_apps.md20
9 files changed, 51 insertions, 74 deletions
diff --git a/docs/01_Getting_Started/01_Quickstart/01_Using_Ready_Made_Images.md b/docs/01_Getting_Started/01_Quickstart/01_Using_Ready_Made_Images.md
index ac22902..a019337 100644
--- a/docs/01_Getting_Started/01_Quickstart/01_Using_Ready_Made_Images.md
+++ b/docs/01_Getting_Started/01_Quickstart/01_Using_Ready_Made_Images.md
@@ -8,9 +8,9 @@ AGL provides a number of pre-built ready-made images of various versions.
### 1. QEMU (Emulation)
-1. Download the [compressed prebuilt image](https://download.automotivelinux.org/AGL/snapshots/master/latest/qemux86-64/deploy/images/qemux86-64/agl-ivi-demo-qt-crosssdk-qemux86-64.ext4.xz).
+1. Download the [compressed prebuilt image](https://download.automotivelinux.org/AGL/release/ricefish/latest/qemux86-64/deploy/images/qemux86-64/agl-ivi-demo-qt-crosssdk-qemux86-64.ext4.xz).
-2. Download the [compressed kernel image](https://download.automotivelinux.org/AGL/snapshots/master/latest/qemux86-64/deploy/images/qemux86-64/bzImage).
+2. Download the [compressed kernel image](https://download.automotivelinux.org/AGL/release/ricefish/latest/qemux86-64/deploy/images/qemux86-64/bzImage).
3. Install [QEMU](https://www.qemu.org/download/) :
@@ -55,7 +55,7 @@ AGL provides a number of pre-built ready-made images of various versions.
- Login into AGL :
```sh
- Automotive Grade Linux 11.0.0+snapshot qemux86-64 ttyS1
+ Automotive Grade Linux 18.0.0+snapshot qemux86-64 ttyS1
qemux86-64 login: root
```
@@ -128,9 +128,9 @@ The AGL demo images do require 1920x1080. The instructions below have been adapt
### 1. QEMU (Emulation)
-1. Download the [compressed prebuilt image](https://download.automotivelinux.org/AGL/snapshots/master/latest/qemuarm/deploy/images/qemuarm/agl-ivi-demo-qt-crosssdk-qemuarm.ext4.xz).
+1. Download the [compressed prebuilt image](https://download.automotivelinux.org/AGL/release/ricefish/latest/qemuarm/deploy/images/qemuarm/agl-ivi-demo-qt-crosssdk-qemuarm.ext4.xz).
-2. Download the [compressed kernel image](https://download.automotivelinux.org/AGL/snapshots/master/latest/qemuarm/deploy/images/qemuarm/zImage).
+2. Download the [compressed kernel image](https://download.automotivelinux.org/AGL/release/ricefish/latest/qemuarm/deploy/images/qemuarm/zImage).
3. Install [QEMU](https://www.qemu.org/download/) :
@@ -197,36 +197,13 @@ The AGL demo images do require 1920x1080. The instructions below have been adapt
-snapshot
```
-### 2. BeagleBone Enhanced (BBE)
-
- 1. Download the [compressed prebuilt image](https://download.automotivelinux.org/AGL/snapshots/master/latest/bbe/deploy/images/bbe/agl-telematics-demo-bbe.wic.xz).
-
- 2. Extract the image into the SD card of BeagleBone Enhanced :
-
- ```sh
- $ lsblk
- $ sudo umount <sdcard_device_name>
- $ xzcat agl-telematics-demo-bbe.wic.xz | sudo dd of=<sdcard_device_name> bs=4M
- $ sync
- ```
-
- **IMPORTANT NOTE:** Before re-writing any device on your Build Host, you need to
- be sure you are actually writing to the removable MicroSD card and not some other
- device.
- Each computer is different and removable devices can change from time to time.
- Consequently, you should repeat the previous operation with the MicroSD card to
- confirm the device name every time you write to the card.
-
- To summarize this example so far, we have the following:
- The first SATA drive is `/dev/sda` and `/dev/sdc` corresponds to the MicroSD card, and is also marked as a removable device.You can see this in the output of the `lsblk` command where "1" appears in the "RM" column for that device.
-
## AARCH64 - ARM 64bit
### 1. QEMU (Emulation)
-1. Download the [compressed prebuilt image](https://download.automotivelinux.org/AGL/snapshots/master/latest/qemuarm64/deploy/images/qemuarm64/agl-ivi-demo-qt-crosssdk-qemuarm64.ext4.xz).
+1. Download the [compressed prebuilt image](https://download.automotivelinux.org/AGL/release/ricefish/latest/qemuarm64/deploy/images/qemuarm64/agl-ivi-demo-qt-crosssdk-qemuarm64.ext4.xz).
-2. Download the [compressed kernel image](https://download.automotivelinux.org/AGL/snapshots/master/latest/qemuarm64/deploy/images/qemuarm64/Image).
+2. Download the [compressed kernel image](https://download.automotivelinux.org/AGL/release/ricefish/latest/qemuarm64/deploy/images/qemuarm64/Image).
3. Install [QEMU](https://www.qemu.org/download/) :
@@ -295,7 +272,7 @@ The AGL demo images do require 1920x1080. The instructions below have been adapt
### 2. Raspberry Pi 4
- 1. Download the [compressed prebuilt image](https://download.automotivelinux.org/AGL/snapshots/master/latest/raspberrypi4/deploy/images/raspberrypi4-64/agl-ivi-demo-qt-crosssdk-raspberrypi4-64.wic.xz).
+ 1. Download the [compressed prebuilt image](https://download.automotivelinux.org/AGL/release/ricefish/latest/raspberrypi4/deploy/images/raspberrypi4-64/agl-ivi-demo-qt-crosssdk-raspberrypi4-64.wic.xz).
2. Extract the image into the SD card of Raspberry Pi 4 :
@@ -365,7 +342,7 @@ The AGL demo images do require 1920x1080. The instructions below have been adapt
1. Update the [firmware](https://elinux.org/R-Car/Boards/H3SK#Flashing_firmware) using files from [here](https://download.automotivelinux.org/AGL/snapshots/master/latest/h3ulcb-nogfx/deploy/images/h3ulcb/).
- 2. Download the [compressed prebuilt image](https://download.automotivelinux.org/AGL/snapshots/master/latest/h3ulcb-nogfx/deploy/images/h3ulcb/agl-ivi-demo-qt-crosssdk-h3ulcb.wic.xz).
+ 2. Download the [compressed prebuilt image](https://download.automotivelinux.org/AGL/release/ricefish/latest/h3ulcb-nogfx/deploy/images/h3ulcb/agl-ivi-demo-qt-crosssdk-h3ulcb.wic.xz).
3. Extract the image into the boot device :
diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/02_Preparing_Your_Build_Host.md b/docs/01_Getting_Started/02_Building_AGL_Image/02_Preparing_Your_Build_Host.md
index 846271f..bfdd544 100644
--- a/docs/01_Getting_Started/02_Building_AGL_Image/02_Preparing_Your_Build_Host.md
+++ b/docs/01_Getting_Started/02_Building_AGL_Image/02_Preparing_Your_Build_Host.md
@@ -17,7 +17,7 @@ the Yocto Project documentation
**NOTE:** This entire section presumes you want to build an image.
You can skip the entire build process if you want to use a ready-made
development image.
-The [supported images](https://download.automotivelinux.org/AGL/snapshots/master/latest/) exist for several boards as
+The [supported images](https://download.automotivelinux.org/AGL/release/ricefish/latest/) exist for several boards as
well as for the Quick EMUlator (QEMU).
See the
"[Quickstart](../01_Quickstart/01_Using_Ready_Made_Images.md)"
diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/04_Initializing_Your_Build_Environment.md b/docs/01_Getting_Started/02_Building_AGL_Image/04_Initializing_Your_Build_Environment.md
index 03b2f5f..397d478 100644
--- a/docs/01_Getting_Started/02_Building_AGL_Image/04_Initializing_Your_Build_Environment.md
+++ b/docs/01_Getting_Started/02_Building_AGL_Image/04_Initializing_Your_Build_Environment.md
@@ -10,7 +10,7 @@ run to initialize the build environment.
You can find this script here:
```sh
-$AGL_TOP/master/meta-agl/scripts/aglsetup.sh
+$AGL_TOP/ricefish/meta-agl/scripts/aglsetup.sh
```
The script accepts many options that allow you to define build parameters such
@@ -18,7 +18,7 @@ as the target hardware (i.e. the machine), build directory, and so forth.
Use the following commands to see the available options and script syntax:
```sh
-$ cd $AGL_TOP/master
+$ cd $AGL_TOP/ricefish
$ source meta-agl/scripts/aglsetup.sh -h
```
@@ -231,7 +231,7 @@ Common targets are:
Running the script creates the Build Directory if it does not already exist.
The default Build Directory is `$AGL_TOP/<release-branch-name>/build`, and the nomenclature to be used throughout this doc is going to be `$AGL_TOP/<release-branch-name>/<build-dir>`
-For this example, the Build Directory is `$AGL_TOP/master/qemux86-64`.
+For this example, the Build Directory is `$AGL_TOP/ricefish/qemux86-64`.
The script's output also indicates the machine and AGL features selected for the build.
diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/05_Customizing_Your_Build.md b/docs/01_Getting_Started/02_Building_AGL_Image/05_Customizing_Your_Build.md
index 31d2852..21f8aaf 100644
--- a/docs/01_Getting_Started/02_Building_AGL_Image/05_Customizing_Your_Build.md
+++ b/docs/01_Getting_Started/02_Building_AGL_Image/05_Customizing_Your_Build.md
@@ -128,7 +128,7 @@ using mirrors.
To use mirrors, add this line to your `local.conf` file in the Build directory:
```sh
-SSTATE_MIRRORS_append = " file://.* https://download.automotivelinux.org/sstate-mirror/master/${DEFAULTTUNE}/PATH \n "
+SSTATE_MIRRORS_append = " file://.* https://download.automotivelinux.org/sstate-mirror/ricefish/${DEFAULTTUNE}/PATH \n "
```
You can learn more about shared state and how it is used in the
diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/07_Building_for_x86_(Emulation_and_Hardware).md b/docs/01_Getting_Started/02_Building_AGL_Image/07_Building_for_x86_(Emulation_and_Hardware).md
index 89ee35d..b8f7cd2 100644
--- a/docs/01_Getting_Started/02_Building_AGL_Image/07_Building_for_x86_(Emulation_and_Hardware).md
+++ b/docs/01_Getting_Started/02_Building_AGL_Image/07_Building_for_x86_(Emulation_and_Hardware).md
@@ -133,7 +133,7 @@ If you built your image with bitbake, you can now just use the ``runqemu`` wrapp
For this example :
```sh
-$ source $AGL_TOP/master/qemux86-64/agl-init-build-env
+$ source $AGL_TOP/ricefish/qemux86-64/agl-init-build-env
```
In general :
diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/09_Building_for_Supported_Renesas_Boards.md b/docs/01_Getting_Started/02_Building_AGL_Image/09_Building_for_Supported_Renesas_Boards.md
index 95a2267..4c240c7 100644
--- a/docs/01_Getting_Started/02_Building_AGL_Image/09_Building_for_Supported_Renesas_Boards.md
+++ b/docs/01_Getting_Started/02_Building_AGL_Image/09_Building_for_Supported_Renesas_Boards.md
@@ -65,7 +65,7 @@ Follow these steps to download the drivers you need:
| AGL Version | Renesas version |
|:-:|:-:|
- | AGL master | 5.9.0 |
+ | AGL ricefish | 5.9.0 |
3. **Download the Files:**
@@ -652,8 +652,8 @@ similar to the following:
```text
[snip]
---- fragment /home/working/workspace_agl_master/meta-agl/templates/machine/h3ulcb/50_setup.sh
-/home/working/workspace_agl_master /home/working/workspace_agl_master/build_gen3
+--- fragment /home/working/workspace_agl_ricefish/meta-agl/templates/machine/h3ulcb/50_setup.sh
+/home/working/workspace_agl_ricefish /home/working/workspace_agl_ricefish/build_gen3
The graphics and multimedia acceleration packages for
the R-Car Gen3 board can be downloaded from:
https://www.renesas.com/en-us/solutions/automotive/rcar-demoboard-2.html
@@ -661,11 +661,11 @@ 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-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
+/home/working/workspace_agl_ricefish/build_gen3
+--- fragment /home/working/workspace_agl_ricefish/meta-agl/templates/base/99_setup_EULAconf.sh
--- end of setup script
OK
-Generating setup file: /home/working/workspace_agl_master/build_gen3/agl-init-build-env ... OK
+Generating setup file: /home/working/workspace_agl_ricefish/build_gen3/agl-init-build-env ... OK
------------ aglsetup.sh: Done
[snip]
```
diff --git a/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/01_Instrument_Cluster_(IC-IVI_with_Container_isolation).md b/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/01_Instrument_Cluster_(IC-IVI_with_Container_isolation).md
index bca5ef6..cecf096 100644
--- a/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/01_Instrument_Cluster_(IC-IVI_with_Container_isolation).md
+++ b/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/01_Instrument_Cluster_(IC-IVI_with_Container_isolation).md
@@ -49,10 +49,10 @@ Build environment for AGL IC container integration is same as AGL other
profile build environment. 
### 1st step:
-Please read [[Build Process Overview]](https://docs.automotivelinux.org/en/master/#01_Getting_Started/02_Building_AGL_Image/01_Build_Process_Overview/) in AGL doc.
+Please read [[Build Process Overview]](https://docs.automotivelinux.org/en/ricefish/#01_Getting_Started/02_Building_AGL_Image/01_Build_Process_Overview/) in AGL doc.
### 2nd step:
-Please read [[Preparing Your Build Host]](https://docs.automotivelinux.org/en/master/#01_Getting_Started/02_Building_AGL_Image/02_Preparing_Your_Build_Host/) in AGL doc.
+Please read [[Preparing Your Build Host]](https://docs.automotivelinux.org/en/ricefish/#01_Getting_Started/02_Building_AGL_Image/02_Preparing_Your_Build_Host/) in AGL doc.
### 3rd step: 
Define Your Top-Level Directory.
@@ -86,8 +86,8 @@ $ git config \--global user.name "Your Name"
```bash
$ cd $AGL_TOP
-$ mkdir master
-$ export AGL_TOP=$HOME/AGL/master
+$ mkdir ricefish
+$ export AGL_TOP=$HOME/AGL/ricefish
$ cd $AGL_TOP
$ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
$ repo sync
@@ -99,7 +99,7 @@ If your board is Raspberry Pi4, please skip this step.
#### 7-1: Downloading Proprietary Drivers from [Renesas-automotive-products](https://www.renesas.com/us/en/products/automotive-products/automotive-system-chips-socs/r-car-h3-m3-documents-software).
-In case of Optimistic Octopus and master, please download this.
+In case of Royal Ricefish, please download this.
![](images/image3.png)
@@ -181,7 +181,7 @@ work flow that depend to Renesas propriety license limitation.
We recommend to open new terminal to do this extra section.
```bash
-$ export AGL_TOP=$HOME/AGL/master
+$ export AGL_TOP=$HOME/AGL/ricefish
$ cd $AGL_TOP
```
@@ -432,7 +432,7 @@ Upstream:
1. [eLinux](https://elinux.org/R-Car/AGL)
1. [Kingfisher Board](https://elinux.org/R-Car/Boards/Kingfisher)
1. [R-Car M3SK](https://elinux.org/R-Car/Boards/M3SK#Flashing_firmware)
- 1. [agl reference machines](https://docs.automotivelinux.org/en/master/#02_hardware_support/01_Supported_Hardware_Overview/)
+ 1. [agl reference machines](https://docs.automotivelinux.org/en/ricefish/#02_hardware_support/01_Supported_Hardware_Overview/)
1. [AGL Tech Day Presenation](https://static.sched.com/hosted_files/agltechday2022/3b/agl-techday-202204.pdf)
- 1. [Build AGL Image](https://docs.automotivelinux.org/en/master/#01_Getting_Started/02_Building_AGL_Image/0_Build_Process_Overview/)
- 1. [Building for Supported Renesas Boards](https://docs.automotivelinux.org/en/master/#01_Getting_Started/02_Building_AGL_Image/09_Building_for_Supported_Renesas_Boards/)
+ 1. [Build AGL Image](https://docs.automotivelinux.org/en/ricefish/#01_Getting_Started/02_Building_AGL_Image/0_Build_Process_Overview/)
+ 1. [Building for Supported Renesas Boards](https://docs.automotivelinux.org/en/ricefish/#01_Getting_Started/02_Building_AGL_Image/09_Building_for_Supported_Renesas_Boards/)
diff --git a/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/02_Flutter_Instrument_Cluster_(qemu-x86).md b/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/02_Flutter_Instrument_Cluster_(qemu-x86).md
index 1cb3899..4effd99 100644
--- a/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/02_Flutter_Instrument_Cluster_(qemu-x86).md
+++ b/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/02_Flutter_Instrument_Cluster_(qemu-x86).md
@@ -6,7 +6,7 @@ title: Flutter Instrument Cluster (qemu-x86)
## 0. Prepare Your Build Host
-- Install the required tools to build an AGL Image. For detailed explanation, check [Preparing Your Build host](https://docs.automotivelinux.org/en/master/#01_Getting_Started/02_Building_AGL_Image/02_Preparing_Your_Build_Host/)
+- Install the required tools to build an AGL Image. For detailed explanation, check [Preparing Your Build host](https://docs.automotivelinux.org/en/ricefish/#01_Getting_Started/02_Building_AGL_Image/02_Preparing_Your_Build_Host/)
## 1. Define Your Top-Level Directory
@@ -27,12 +27,12 @@ $ chmod a+x $HOME/bin/repo
```
## 3. Download the AGL Source Files
-To download the latest **master** branch AGL files, use the following commands:
+To download the latest **ricefish** branch AGL files, use the following commands:
```bash
$ cd $AGL_TOP
-$ mkdir master
-$ cd master
-$ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
+$ mkdir ricefish
+$ cd ricefish
+$ repo init -b ricefish -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
$ repo sync
```
@@ -40,24 +40,24 @@ $ repo sync
To initialize the build environment, we must use the setup script.
This script is available here:
```bash
-$ $AGL_TOP/master/meta-agl/scripts/aglsetup.sh
+$ $AGL_TOP/ricefish/meta-agl/scripts/aglsetup.sh
```
Run the script:
```bash
$ cd $AGL_TOP
-$ source master/meta-agl/scripts/aglsetup.sh -b build-flutter-cluster -m qemux86-64 agl-demo agl-devel
+$ source ricefish/meta-agl/scripts/aglsetup.sh -b build-flutter-cluster -m qemux86-64 agl-demo agl-devel
```
- Here `-b` is used to specify the build directory and `-m` is used to specify the target platform.
-- Running this script, will create a build directory if it does not exist. Default build directory: `$AGL_TOP/master/build-flutter-cluster`
+- Running this script, will create a build directory if it does not exist. Default build directory: `$AGL_TOP/ricefish/build-flutter-cluster`
- Default target paltform: `qemux86-64`
** NOTE: Set the API key in local.conf **
- By default navigation will not work, you need to set your openrouteservie API key to the variable `OPENROUTE_API_KEY` in your local.conf
-- It is present at `$AGL_TOP/master/build-flutter-cluster/conf/local.conf`
+- It is present at `$AGL_TOP/ricefish/build-flutter-cluster/conf/local.conf`
- Example: Just add `OPENROUTE_API_KEY = "your_openrouteservice_api_key"` to the end of local.conf
@@ -65,7 +65,7 @@ $ source master/meta-agl/scripts/aglsetup.sh -b build-flutter-cluster -m qemux86
## 5. Using BitBake
```bash
-$ cd $AGL_TOP/master/build-flutter-cluster
+$ cd $AGL_TOP/ricefish/build-flutter-cluster
$ source agl-init-build-env
$ bitbake agl-cluster-demo-flutter
```
@@ -74,7 +74,7 @@ $ bitbake agl-cluster-demo-flutter
Boot the image using QEMU
```bash
-$ cd $AGL_TOP/master/build-flutter-cluster
+$ cd $AGL_TOP/ricefish/build-flutter-cluster
$ source agl-init-build-env
$ runqemu kvm serialstdio slirp publicvnc
```
diff --git a/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/03_IVI_Flutter_apps.md b/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/03_IVI_Flutter_apps.md
index 6d6bd93..783bf26 100644
--- a/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/03_IVI_Flutter_apps.md
+++ b/docs/01_Getting_Started/03_Build_and_Boot_guide_Profile/03_IVI_Flutter_apps.md
@@ -6,7 +6,7 @@ title: IVI Flutter apps
## 0. Prepare Your Build Host
-- Install the required tools to build an AGL Image. For detailed explanation, check [Preparing Your Build host](https://docs.automotivelinux.org/en/master/#01_Getting_Started/02_Building_AGL_Image/02_Preparing_Your_Build_Host/)
+- Install the required tools to build an AGL Image. For detailed explanation, check [Preparing Your Build host](https://docs.automotivelinux.org/en/ricefish/#01_Getting_Started/02_Building_AGL_Image/02_Preparing_Your_Build_Host/)
## 1. Define Your Top-Level Directory
@@ -27,12 +27,12 @@ $ chmod a+x $HOME/bin/repo
```
## 3. Download the AGL Source Files
-To download the latest **master** branch AGL files, use the following commands:
+To download the latest **ricefish** branch AGL files, use the following commands:
```bash
$ cd $AGL_TOP
-$ mkdir master
-$ cd master
-$ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
+$ mkdir ricefish
+$ cd ricefish
+$ repo init -b ricefish -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
$ repo sync
```
@@ -40,24 +40,24 @@ $ repo sync
To initialize the build environment, we must use the setup script.
This script is available here:
```bash
-$ $AGL_TOP/master/meta-agl/scripts/aglsetup.sh
+$ $AGL_TOP/ricefish/meta-agl/scripts/aglsetup.sh
```
Run the script:
```bash
-$ cd $AGL_TOP/master
+$ cd $AGL_TOP/ricefish
$ source meta-agl/scripts/aglsetup.sh -b build-flutter-dashboard -m qemux86-64 agl-demo agl-devel
```
- Here `-b` is used to specify the build directory and `-m` is used to specify the target platform.
-- Running this script, will create a build directory if it does not exist. Default build directory: `$AGL_TOP/master/build-flutter-dashboard`
+- Running this script, will create a build directory if it does not exist. Default build directory: `$AGL_TOP/ricefish/build-flutter-dashboard`
- Default target paltform: `qemux86-64`
## 5. Using BitBake
```bash
-$ cd $AGL_TOP/master/build-flutter-dashboard
+$ cd $AGL_TOP/ricefish/build-flutter-dashboard
$ source agl-init-build-env
$ bitbake agl-ivi-demo-flutter
```
@@ -66,7 +66,7 @@ $ bitbake agl-ivi-demo-flutter
Boot the image using QEMU
```bash
-$ cd $AGL_TOP/master/build-flutter-dashboard
+$ cd $AGL_TOP/ricefish/build-flutter-dashboard
$ source agl-init-build-env
$ runqemu kvm serialstdio slirp publicvnc
```