Adding file naming and indexing
[AGL/documentation.git] / docs / 01_Getting_Started / 03_Build_and_Boot_guide_Profile / 01_Instrument_Cluster_(IC-IVI_with_Container_isolation).md
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 marlin -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
42 repo sync
43 ```
44 - Optional: Specify the manifest file(marlin_13.0.0.xml) using -m option
45
46 ```bash
47 repo init -b marlin -m marlin_13.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/master/#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-lxc
75 ```
76
77 ## 7. Using BitBake
78 ```bash
79 bitbake lxc-host-image-demo
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/master/#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/master/#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/master/#01_Getting_Started/02_Building_AGL_Image/0_Build_Process_Overview/)
127  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/)