gerrit.automotivelinux Code Review - AGL/documentation.git/blob

   1 ---
   2 title: Instrument Cluster (IC-IVI with Container isolation)
   3 ---
   4
   5 # Build and Boot AGL Instrument Cluster demo image (IC-IVI with Container isolation)
   6 ## Required Equipments
   7 **1) Tested board:** **[Starter Kit Pro/M3](https://elinux.org/R-Car/Boards/M3SK) + [kingfisher support](https://elinux.org/R-Car/Boards/Kingfisher)**
   8
   9 **2) MicroUSB**
  10
  11 **3) MicroSD card**
  12 ## 0. Host PC environemnt
  13 **Build PC**
  14 Ubuntu OS (Tested version 18.04.6 LTS)
  15
  16 ## 1. Define Your Top-Level Directory
  17
  18 ```bash
  19 export AGL_TOP=$HOME/AGL
  20 mkdir -p $AGL_TOP
  21 ```
  22
  23 ## 2. Download the repo Tool and Set Permissions
  24
  25 ```bash
  26 mkdir -p $HOME/bin
  27 export PATH=$HOME/bin:$PATH
  28 curl https://storage.googleapis.com/git-repo-downloads/repo > $HOME/bin/repo
  29 chmod a+x $HOME/bin/repo
  30 ```
  31
  32 ## 3. Download the AGL Source Files
  33 - **AGL Version:** Magic Marlin
  34 ```bash
  35 cd $AGL_TOP
  36 mkdir marlin
  37 export AGL_TOP=$HOME/AGL/marlin
  38 cd $AGL_TOP
  39 git config --global user.email "you@example.com"
  40 git config --global user.name "Your Name"
  41 repo init -b pike -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
  42 repo sync
  43 ```
  44 - Optional: Specify the manifest file(pike_16.0.0.xml) using -m option
  45
  46 ```bash
  47 repo init -b pike -m pike_16.0.0.xml -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
  48 ```
  49 - Optional: Specify the master branch
  50 ```bash
  51 repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
  52 ```
  53
  54 ## 4. Downloading Proprietary Drivers
  55 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)
  56 - To check the files to download
  57 ```bash
  58 grep -rn ZIP_.= $AGL_TOP/meta-agl/meta-agl-bsp/meta-rcar-gen3/scripts/setup_mm_packages.sh
  59 export XDG_DOWNLOAD_DIR=$HOME/Downloads
  60 ```
  61 - Download and copy Proprietary Drivers files (Run commands at downloaded files directory)
  62 ```bash
  63 cp R-Car_Gen3_Series_Evaluation_Software_Package_* $XDG_DOWNLOAD_DIR/
  64 chmod a+rw $XDG_DOWNLOAD_DIR/*.zip
  65 ```
  66 ## 5. Define Your Board
  67 - Supporting Starter Kit Pro/M3 + kingfisher Board (For other supported boards, check [Define Your Board](https://docs.automotivelinux.org/en/pike/#01_Getting_Started/02_Building_AGL_Image/09_Building_for_Supported_Renesas_Boards.md))
  68 ```bash
  69 export MACHINE=m3ulcb-kf
  70 ```
  71 ## 6. Run the aglsetup.sh Script
  72 ```bash
  73 cd $AGL_TOP
  74 source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b $MACHINE agl-ic-container
  75 ```
  76
  77 ## 7. Using BitBake
  78 ```bash
  79 bitbake agl-cluster-demo-lxc-host
  80 ```
  81 - The build process puts the resulting image in the Build Directory
  82 ($AGL_TOP/m3ulcb-kf/tmp/deploy/images/m3ulcb)
  83 ## 8.Boot the Board (Deploying the AGL Demo Image)
  84 - To boot your image on the Renesas board, you need to do three things:
  85
  86 a) Update all [firmware](https://docs.automotivelinux.org/en/pike/#01_Getting_Started/02_Building_AGL_Image/09_Building_for_Supported_Renesas_Boards/#4-troubleshooting) on R-Car M3 Starter Kit board (Flashing firmware).
  87
  88 b) Prepare the MicroSD card and Flash image to the MicroSD card using [Etcher](https://www.balena.io/etcher/)
  89  (**image file name:** lxc-host-image-demo-m3ulcb-kf.wic.xz), then insert MicroSD card in the R-Car M3SK.
  90 c) Boot the board.
  91
  92 1) Use a MicroUSB cable to connect the PC to R-Car Starter Kit Pro (M3ULCB) board CN12 "CPLD/DEBUG"
  93 - Serial settings are 115200 8N1.
  94 - Run any standard terminal emulator program (e.g. minicom).
  95 [Replace **"Device"** with USB tty device name, for example **`/dev/ttyUSB0`**]
  96 ```bash
  97 sudo minicom -b 115200 -D "DEVICE"
  98 ```
  99
 100 - Power on the board
 101 - Quickly hit any key to get into the U-boot command prompt; you should see the following:
 102  ```bash
 103 Hit any key to stop autoboot:  0                                                                =>
 104 ```
 105 - Booting image command (for details check [How to boot](https://elinux.org/R-Car/AGL#Instrument_Cluster_with_Container_isolation_demo_image))
 106  ```bash
 107 ext4load 0x48080000 Image
 108 ext4load 0x48000000 /boot/r8a77961-ulcb-kf.dtb
 109 booti 0x48080000 - 0x48000000
 110 ```
 111
 112 # Run SoC board Screen
 113 A) Connect HDMI panel to M3SK(CN4) for **IVI Container**
 114 ![IVI](https://elinux.org/images/9/91/Marlin-lxc-Ivi.JPG)
 115
 116 B) Connect HDMI panel to Kingfisher(CN49)for **Cluster Container**
 117 ![IC](https://elinux.org/images/7/76/Marlin-lxc-Cluster.JPG)
 118
 119 <! -- https://elinux.org/images/thumb/7/76/Marlin-lxc-Cluster.JPG/1200px-Marlin-lxc-Cluster.JPG) -->
 120 # Reference webpages
 121  1. [eLinux](https://elinux.org/R-Car/AGL)
 122  1. [Kingfisher Board](https://elinux.org/R-Car/Boards/Kingfisher)
 123  1. [R-Car M3SK](https://elinux.org/R-Car/Boards/M3SK#Flashing_firmware)
 124  1. [agl reference machines](https://docs.automotivelinux.org/en/pike/#02_hardware_support/01_Supported_Hardware_Overview/)
 125  1. [AGL Tech Day Presenation](https://static.sched.com/hosted_files/agltechday2022/3b/agl-techday-202204.pdf)
 126  1. [Build AGL Image](https://docs.automotivelinux.org/en/pike/#01_Getting_Started/02_Building_AGL_Image/0_Build_Process_Overview/)
 127  1. [Building for Supported Renesas Boards](https://docs.automotivelinux.org/en/pike/#01_Getting_Started/02_Building_AGL_Image/09_Building_for_Supported_Renesas_Boards/)