- Depending on your Renesas board, define and export a `MACHINE` variable as follows:
-
- | Board| `MACHINE` Setting |
- |:-:|:-:|
- | 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 Premier/H3 | `MACHINE`=h3ulcb |
- | Starter Kit Premier/H3 + kingfisher support | `MACHINE`=h3ulcb-kf |
- | Starter Kit Premier/H3 without graphic | `MACHINE`=h3ulcb-nogfx |
- | Salvator-X | `MACHINE`=h3-salvator-x |
-
- For example, the following command defines and exports the `MACHINE` variable
- for the Starter Kit Pro/M3 Board:
-
- ```sh
- $ export MACHINE=m3ulcb
- ```
-
-2. **Run the `aglsetup.sh` Script:**
-
- Use the following commands to run the AGL Setup script:
-
- ```sh
- $ cd $AGL_TOP
- $ source meta-agl/scripts/aglsetup.sh -m $MACHINE -b build agl-devel agl-demo
- ```
-
- **NOTE:**
- Running the `aglsetup.sh` script automatically places you in the
- working directory (i.e. `$AGL_TOP/build`).
- You can change this default behavior by adding the "-f" option to the
- script's command line.
-
- In the previous command, the "-m" option sets your machine to the previously
- defined `MACHINE` variable.
- The "-b" option defines your Build Directory, which is the
- default `$AGL_TOP/build`.
- Finally, the AGL features are provided to support building the AGL Demo image
- for the Renesas board.
-
- You can learn more about the AGL Features in the
- "[Initializing Your Build Environment](./3_Initializing_Your_Build_Environment.md)"
- section.
-
-3. **Examine the Script's Log:**
-
- Running the `aglsetup.sh` script creates the `setup.log` file, which is in
- the `build/conf` folder.
- You can examine this log to see the results of the script.
- For example, suppose the graphics drivers were missing or could not be extracted
- when you ran the script.
-
-<details>
- <summary> In case of missing graphics drivers, you could notice an error message
- similar to the following:</summary>
- <pre>
- <code>
-[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
-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
-
-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
-/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
-OK
-Generating setup file: /home/working/workspace_agl_master/build_gen3/agl-init-build-env ... OK
------------- aglsetup.sh: Done
-[snip]
- </code>
- </pre>
-</details>
-
- If you encounter this issue, or any other unwanted behavior, you can fix the error
- mentioned, remove the `$AGL_TOP/build` directory, and then re-launch the
- `aglsetup.sh` again.
-
-<details>
- <summary>Here is another example that indicates the driver files could not be extracted from the downloads directory:</summary>
- <pre>
- <code>
-[snip]
-
-~/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
-~/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
-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>