Bulk documentation updates for needlefish
[AGL/documentation.git] / docs / 1_Hardware_Support / Overview.md
index f05237b..8c404f0 100644 (file)
@@ -2,46 +2,49 @@
 title: Supported Boards
 ---
 
-The following table briefs about the various hardware platforms, supported by AGL :
 
-**NOTE:** Further information about AGL Distribution available at [AGL wiki](https://wiki.automotivelinux.org/agl-distro).
+
+AGL makes two types of hardware support available: Reference BSPs and Community BSPs.
+
+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.
+
+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.
+
+The following table briefs about the various hardware platforms, supported by AGL :
 
 ### AGL Reference Machines
 
-|      BOARD      |    $MACHINE    | ARCHITECHTURE |
-|:---------------:|:--------------:|:-------------:|
-|       QEMU      |   qemu-x86-64  |      x86      |
+|      BOARD      |     MACHINE    | ARCHITECHTURE | QUICK START GUIDE|
+|:---------------:|:--------------:|:-------------:|:----------------:|
+|       QEMU      |   qemu-x86-64  |      x86      |[QEMU Quick Start](https://docs.automotivelinux.org/en/needlefish/#0_Getting_Started/1_Quickstart/Using_Ready_Made_Images/#_top)|
 |                 |    qemu-arm    |     arm32     |
 |                 |   qemu-arm64   |     arm64     |
 |                 |                |               |
-|    RCar Gen 3   |     h3ulcb     |     arm64     |
+|    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)|
 |                 | h3-salvator-x  |     arm64     |
 |                 |      h3-kf     |     arm64     |
 |                 |     m3ulcb     |     arm64     |
 |                 | m3-salvator-x  |     arm64     |
 |                 |      m3-kf     |     arm64     |
+|                 |   agl-refhw    |     arm64     |
 |                 |                |               |
-|  Raspberry Pi   |  raspberrypi4  |     arm64     |
-
-### Community supported Machines
-
-|    BOARD     |     $MACHINE          | ARCHITECHTURE |
-|:-------------:|:-----------------:|:-------------:|
-|  BeagleBone  |        bbe            |     arm32     |
-|              |    beaglebone         |     arm32     |
-|              |                       |               |
-|   i. MX 6    |      cubox-i          |     arm32     |
-|              | imx6qdlsabreauto      |     arm32     |
-|              |    nitrogen6x         |     arm32     |
-|              |                       |               |
-|   i. MX 8    |     imx8mqevk         |     arm64     |
-|              |   imx8mqevk-viv       |     arm64     |
-|              |                       |               |
-|  Snapdragon  | dragonboard-410c      |     arm64     |
-|              | dragonboard-820c      |     arm64     |
-|              |                       |               |
-|    ARC HS    |       hsdk            |      ARC      |
+|  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)|
+
 
+### Community Supported Boards
+
+|    BOARD      |      MACHINE          | ARCHITECHTURE |
+|:-------------:|:---------------------:|:-------------:|
+|  BeagleBone   |        bbe            |     arm32     |
+|               |    beaglebone         |     arm32     |
+|               |                       |               |
+|   i.MX 6      |      cubox-i          |     arm32     |
+|               | imx6qdlsabreauto      |     arm32     |
+|               |                       |               |
+|   i.MX 8      |     imx8mqevk         |     arm64     |
+|               |   imx8mqevk-viv       |     arm64     |
+|               |                       |               |
+|     virtio    | virtio-aarch64        |     arm64     |
 
 ### Supported Images
 
@@ -51,9 +54,9 @@ AGL supports a variety of interfaces, each requiring unique setup configuration.
 
 **Supported boards** :
 
-AGL Reference Boards (QEMU, RCar Gen 3 & Raspberry Pi 4)
+AGL Reference Boards (QEMU, RCar Gen 3, agl-refhw & Raspberry Pi 4)
 
-Community supported Machines (i. MX 6, i. MX 8, Snapdragon & ARC HS)
+Community supported Machines (BBE, i. MX 6, i. MX 8)
 
 * Qt Based :
 
@@ -77,10 +80,10 @@ Community supported Machines (i. MX 6, i. MX 8, Snapdragon & ARC HS)
     * Setting up flags at `aglsetup` script :
 
         ```sh
-        $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-profile-graphical-html5
+        $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo
 
         # To enable Developer Options
-        $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-profile-graphical-html5 agl-devel
+        $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-devel
         ```
 
     * Building target image :
@@ -89,6 +92,24 @@ Community supported Machines (i. MX 6, i. MX 8, Snapdragon & ARC HS)
         $ time bitbake agl-demo-platform-html5
         ```
 
+* Flutter-based Image:
+
+    * Setting up flags at `aglsetup` script :
+
+        ```sh
+        $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-flutter
+
+        # To enable Developer Options
+        $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-flutter agl-devel
+        ```
+
+    * Building target image :
+
+        ```sh
+        $ time bitbake agl-ivi-demo-platform-flutter
+        ```
+
+
 
 #### 2. Instrument Cluster
 
@@ -99,10 +120,10 @@ AGL Reference Boards (QEMU, RCar Gen 3 & Raspberry Pi 4)
 * Setting up flags at `aglsetup` script :
 
     ```sh
-    $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-cluster-demo
+    $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo
 
     # To enable Developer Options
-    $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-cluster-demo agl-devel
+    $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-devel
     ```
 
 * Building target image :
@@ -123,14 +144,14 @@ Community supported Machines (BeagleBone)
 * Setting up flags at `aglsetup` script :
 
     ```sh
-    $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-telematics-demo
+    $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo
 
     # To enable Developer Options
-    $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-telematics-demo agl-devel
+    $ source meta-agl/scripts/aglsetup.sh -f -m $MACHINE -b build-$MACHINE agl-demo agl-devel
     ```
 
 * Building target image :
 
     ```sh
     $ time bitbake agl-telematics-demo
-    ```
\ No newline at end of file
+    ```