Bulk documentation updates for needlefish
[AGL/documentation.git] / docs / 1_Hardware_Support / Overview.md
1 ---
2 title: Supported Boards
3 ---
4
5
6
7 AGL makes two types of hardware support available: Reference BSPs and Community BSPs.
8
9 1) **Reference Boards** have Board Support Packages (BSPs) that are maintained by their sponsoring companies and are included in our Jenkins CI system. Reference BSPs have snapshot builds that are made available daily and are fully validated with test results made available for every major AGL release.
10
11 2) **Community Boards** have BSPs that are maintained as a best effort by the AGL community based on upstream BSPs. Community Boards include some of the most-used Hobbyist boards such as older automotive boards.
12
13 The following table briefs about the various hardware platforms, supported by AGL :
14
15 ### AGL Reference Machines
16
17 |      BOARD      |     MACHINE    | ARCHITECHTURE | QUICK START GUIDE|
18 |:---------------:|:--------------:|:-------------:|:----------------:|
19 |       QEMU      |   qemu-x86-64  |      x86      |[QEMU Quick Start](https://docs.automotivelinux.org/en/needlefish/#0_Getting_Started/1_Quickstart/Using_Ready_Made_Images/#_top)|
20 |                 |    qemu-arm    |     arm32     |
21 |                 |   qemu-arm64   |     arm64     |
22 |                 |                |               |
23 |    RCar Gen 3   |     h3ulcb     |     arm64     |[RCar Gen 3 Quick Start](https://docs.automotivelinux.org/en/needlefish/#0_Getting_Started/1_Quickstart/Using_Ready_Made_Images/#3-r-car-h3sk-h3ulcb-board)|
24 |                 | h3-salvator-x  |     arm64     |
25 |                 |      h3-kf     |     arm64     |
26 |                 |     m3ulcb     |     arm64     |
27 |                 | m3-salvator-x  |     arm64     |
28 |                 |      m3-kf     |     arm64     |
29 |                 |   agl-refhw    |     arm64     |
30 |                 |                |               |
31 |  Raspberry Pi   |  raspberrypi4  |     arm64     |[Raspberry Pi Quick Start](https://docs.automotivelinux.org/en/needlefish/#0_Getting_Started/1_Quickstart/Using_Ready_Made_Images/#2-raspberry-pi-4)|
32
33
34 ### Community Supported Boards
35
36 |    BOARD      |      MACHINE          | ARCHITECHTURE |
37 |:-------------:|:---------------------:|:-------------:|
38 |  BeagleBone   |        bbe            |     arm32     |
39 |               |    beaglebone         |     arm32     |
40 |               |                       |               |
41 |   i.MX 6      |      cubox-i          |     arm32     |
42 |               | imx6qdlsabreauto      |     arm32     |
43 |               |                       |               |
44 |   i.MX 8      |     imx8mqevk         |     arm64     |
45 |               |   imx8mqevk-viv       |     arm64     |
46 |               |                       |               |
47 |     virtio    | virtio-aarch64        |     arm64     |
48
49 ### Supported Images
50
51 AGL supports a variety of interfaces, each requiring unique setup configuration.
52
53 #### 1. In-Vehicle Infotainment (IVI)
54
55 **Supported boards** :
56
57 AGL Reference Boards (QEMU, RCar Gen 3, agl-refhw & Raspberry Pi 4)
58
59 Community supported Machines (BBE, i. MX 6, i. MX 8)
60
61 * Qt Based :
62
63     * Setting up flags at `aglsetup` script :
64
65         ```sh
66         $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo
67
68         #To enable Developer Options
69         $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-devel
70         ```
71
72     * Building target image :
73
74         ```sh
75         $ time bitbake agl-demo-platform
76         ```
77
78 * HTML5 Based :
79
80     * Setting up flags at `aglsetup` script :
81
82         ```sh
83         $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo
84
85         # To enable Developer Options
86         $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-devel
87         ```
88
89     * Building target image :
90
91         ```sh
92         $ time bitbake agl-demo-platform-html5
93         ```
94
95 * Flutter-based Image:
96
97     * Setting up flags at `aglsetup` script :
98
99         ```sh
100         $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-flutter
101
102         # To enable Developer Options
103         $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-flutter agl-devel
104         ```
105
106     * Building target image :
107
108         ```sh
109         $ time bitbake agl-ivi-demo-platform-flutter
110         ```
111
112
113
114 #### 2. Instrument Cluster
115
116 **Supported boards** :
117
118 AGL Reference Boards (QEMU, RCar Gen 3 & Raspberry Pi 4)
119
120 * Setting up flags at `aglsetup` script :
121
122     ```sh
123     $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo
124
125     # To enable Developer Options
126     $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-devel
127     ```
128
129 * Building target image :
130
131     ```sh
132     $ time bitbake agl-cluster-demo
133     ```
134
135 #### 3. Telematics
136
137 Headless demo platform for low-spec boards.
138
139 **Supported boards** :
140
141 Community supported Machines (BeagleBone)
142
143
144 * Setting up flags at `aglsetup` script :
145
146     ```sh
147     $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo
148
149     # To enable Developer Options
150     $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-devel
151     ```
152
153 * Building target image :
154
155     ```sh
156     $ time bitbake agl-telematics-demo
157     ```