From 0fc33066fa8ba5bb3ec729747bbd11745ad2a4c7 Mon Sep 17 00:00:00 2001 From: Jan-Simon Möller Date: Mon, 1 Jul 2024 19:12:52 +0200 Subject: Add documentation for building EC2 instances MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This adds the documentation for building and uploading EC2 images (AMIs) that can run on graviton instances. Bug-AGL: SPEC-5181 Signed-off-by: Jan-Simon Möller Change-Id: I824db52579247c731b7e0e34f755f80ffa338ed6 Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/30054 --- .../11_Available_Demo_Images.md | 139 ------------------ .../11_Building_for_EC2_arm64_and_x86-64.md | 155 +++++++++++++++++++++ .../12_Available_KVM_Demo_Images.md | 96 ------------- .../21_Available_Demo_Images.md | 139 ++++++++++++++++++ .../22_Available_KVM_Demo_Images.md | 96 +++++++++++++ .../images/1_EC2_dashboard.png | Bin 0 -> 136837 bytes .../images/2_start-instance-1.png | Bin 0 -> 187248 bytes .../images/3_start_instance-2.png | Bin 0 -> 174546 bytes 8 files changed, 390 insertions(+), 235 deletions(-) delete mode 100644 docs/01_Getting_Started/02_Building_AGL_Image/11_Available_Demo_Images.md create mode 100644 docs/01_Getting_Started/02_Building_AGL_Image/11_Building_for_EC2_arm64_and_x86-64.md delete mode 100644 docs/01_Getting_Started/02_Building_AGL_Image/12_Available_KVM_Demo_Images.md create mode 100644 docs/01_Getting_Started/02_Building_AGL_Image/21_Available_Demo_Images.md create mode 100644 docs/01_Getting_Started/02_Building_AGL_Image/22_Available_KVM_Demo_Images.md create mode 100644 docs/01_Getting_Started/02_Building_AGL_Image/images/1_EC2_dashboard.png create mode 100644 docs/01_Getting_Started/02_Building_AGL_Image/images/2_start-instance-1.png create mode 100644 docs/01_Getting_Started/02_Building_AGL_Image/images/3_start_instance-2.png (limited to 'docs') diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/11_Available_Demo_Images.md b/docs/01_Getting_Started/02_Building_AGL_Image/11_Available_Demo_Images.md deleted file mode 100644 index 32ebb6c..0000000 --- a/docs/01_Getting_Started/02_Building_AGL_Image/11_Available_Demo_Images.md +++ /dev/null @@ -1,139 +0,0 @@ ---- -title: Available Demo Images ---- - -## 1. Demo Images - -These images are available when the `agl-demo` feature is given to `aglsetup.sh`. The resulting images use DHCP for network configuration, and all except the `agl-ivi-demo-control-panel` images will contain instances of the KUKSA.val databroker by default. - -### agl-ivi-image - -Base IVI demo image that the other IVI images derive from. A user will typically not be building this image, it is more relevant if making changes to the base demo services or packaging that affects all the IVI demos. - -### agl-ivi-image-crosssdk - -Corresponding SDK image for `agl-ivi-image`. Typically, a user will be more interested in the `agl-ivi-demo-qt-crosssk`, as the resulting SDK from that image is more useful for application development. - -### agl-ivi-image-flutter - -Base Flutter IVI demo image. Derived from `agl-ivi-image` and includes the Flutter components required for running Flutter applications. A user will typically not be building this image, it usually will only be interesting if doing development of primary Flutter applications such as IVI homescreen applications. - -### agl-ivi-demo-flutter - -Flutter based IVI demo image, using `flutter-ics-homescreen` application. - -### agl-ivi-demo-html5 - -HTML5 based IVI demo image, using a combination of the Chromium Embedded Framework (CEF) and Web Application Manager (WAM). - -### agl-ivi-demo-qt - -Qt based IVI demo image, using `homescreen` and `launcher` as well as other Qt applications. - -### agl-ivi-demo-qt-crosssdk - -This is the corresponding SDK image for `agl-ivi-demo-qt`. - -### agl-ivi-demo-control-panel - -IVI demo control panel image. Simple image that runs the `agl-demo-control-panel` application for driving demo setups. - -### agl-cluster-demo-flutter - -Flutter based IC demo image, using `flutter-cluster-dashboard` application. - -### agl-cluster-demo-qt - -Qt based IC demo image, using `cluster-dashboard` application. - -### agl-gateway-demo - -Gateway demo image. The image runs the KUKSA.val databroker and the associated `kuksa-dbc-feeder` for CAN input. - -### agl-telematics-demo - -Telematics demo image. Currently a WIP. - -## 2. Preconfigured Demo Images - -These images are also available when the `agl-demo` feature is given to `aglsetup.sh`, but are intended for use with a more complete demo setup along the lines of what the project showcases at tradeshows such as CES or Embedded World. The resulting images use DHCP for network configuration, but the following address assignments are assumed: - -- IVI board has address 192.168.10.2 -- IC board has address 192.168.10.3 -- Gateway board has address 192.168.10.4 - -Whether an image includes the KUKSA.val databroker or not will be indicated below. - -Note that the preconfigured IVI images are for the most part only tested on the Renesas H3ULCB based AGL reference hardware. While the IC images are typically run on a Raspberry Pi 4 when a standalone IC is used as part of a tradeshow demo, the IC images are simpler and should be a bit more flexible with respect to target platform. - -### agl-ivi-demo-flutter-preconfigured - -Flutter IVI demo image with: - -- IC navigation streaming support -- KUKSA.val databroker present, preconfigured IC images assume it runs on IVI board. -- udev configuration for USB I2C adapter for demo setup LEDs and RTC -- Weston Terminal application removed - -### agl-ivi-demo-flutter-preconfigured-gateway - -Flutter IVI demo image with: - -- IC navigation streaming support -- KUKSA.val databroker removed, as it runs on the gateway. -- Application configuration changes for databroker being on the gateway. -- udev configuration for USB I2C adapter for demo setup LEDs and RTC -- Weston Terminal application removed - -### agl-ivi-demo-qt-preconfigured - -Qt IVI demo image with: - -- IC navigation streaming support -- KUKSA.val databroker present, preconfigured IC images assume it runs on IVI board. -- udev configuration for USB I2C adapter for demo setup LEDs and RTC -- Weston Terminal application removed - -### agl-ivi-demo-control-panel-preconfigured - -IVI demo control panel image with: - -- Default configuration for databroker running on IVI board. - -### agl-ivi-demo-control-panel-preconfigured-gateway - -IVI demo control panel image with: - -- KUKSA.val databroker present, with `kuksa-dbc-feeder` configuration to output CAN messages for the signals coming from the application's vehicle simulation. -- Default configuration disables HVAC and steering wheel pages, as those are driven by hardware connected to the gateway in the full demo setup. - -### agl-cluster-demo-flutter-preconfigured - -Flutter IC demo image with: - -- KUKSA.val databroker removed, as it runs on the IVI board. -- Application configuration changes for databroker being on the IVI board. -- Configuration tweaks to invert the screen orientation, as the IC screen in the full demo setup is upside down. - -### agl-cluster-demo-flutter-preconfigured-gateway - -Flutter IC demo image with: - -- KUKSA.val databroker removed, as it runs on the gateway. -- Application configuration changes for databroker being on the gateway. -- Configuration tweaks to invert the screen orientation, as the IC screen in the full demo setup is upside down. - -### agl-cluster-demo-qt-preconfigured - -Qt IC demo image with: - -- KUKSA.val databroker removed, as it runs on the IVI board. -- Application configuration changes for databroker being on the IVI board. -- Configuration tweaks to invert the screen orientation, as the IC screen in the full demo setup is upside down. - -### agl-gateway-demo-preconfigured - -Gateway demo image with: - -- `kuksa-dbc-feeder` against `can0` interface configured for vehicle simulation (e.g. vehicle and engine speed) CAN messages coming from the `agl-ivi-demo-control-panel-preconfigured-gateway` image. -- A second instance of `kuksa-dbc-feeder` against `can1` interface configured for input and output of CAN messages from and to the steering wheel and HVAC hardware, respectively. \ No newline at end of file diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/11_Building_for_EC2_arm64_and_x86-64.md b/docs/01_Getting_Started/02_Building_AGL_Image/11_Building_for_EC2_arm64_and_x86-64.md new file mode 100644 index 0000000..8e22274 --- /dev/null +++ b/docs/01_Getting_Started/02_Building_AGL_Image/11_Building_for_EC2_arm64_and_x86-64.md @@ -0,0 +1,155 @@ +--- +title: Building for AWS EC2 (arm64 or x86-64) +--- + +Building an image for emulation allows you to simulate your +image without actual target hardware. In this case using an EC2 instance. + +This section describes the steps you need to take to build the +AGL demo image for emulation using EC2 either for arm64 or x86-64. + +In the commanline examples below, we will focus on aws-ec2-arm64 primarily. +If you need x86-64, then replace it with aws-ec2-x86-64 likewise. + +## 1. Making Sure Your Build Environment is Correct + +The +"[Initializing Your Build Environment](./04_Initializing_Your_Build_Environment.md)" +section presented generic information for setting up your build environment +using the `aglsetup.sh` script. +If you are building the AGL demo image for emulation, you need to specify some +specific options when you run the script: + +**Sample Qt based IVI demo :** + +```sh +$ source meta-agl/scripts/aglsetup.sh -f -m aws-ec2-arm64 -b build-aws-ec2 agl-demo agl-devel +$ echo "# reuse download directories" >> $AGL_TOP/site.conf +$ echo "DL_DIR = \"$HOME/downloads/\"" >> $AGL_TOP/site.conf +$ echo "SSTATE_DIR = \"$AGL_TOP/sstate-cache/\"" >> $AGL_TOP/site.conf +$ ln -sf $AGL_TOP/site.conf conf/ +``` + +**IVI-EG Flutter based demo :** + +``` +$ source meta-agl/scripts/aglsetup.sh -f -m aws-ec2-arm64 -b build-aws-ec2 agl-demo agl-devel +$ echo "# reuse download directories" >> $AGL_TOP/site.conf +$ echo "DL_DIR = \"$HOME/downloads/\"" >> $AGL_TOP/site.conf +$ echo "SSTATE_DIR = \"$AGL_TOP/sstate-cache/\"" >> $AGL_TOP/site.conf +$ ln -sf $AGL_TOP/site.conf conf/ +``` + +The "-m" option specifies the "aws-ec2-arm64" machine. +The list of AGL features used with script are appropriate for development of +the AGL demo image. For production use, you need to omit agl-devel and tailor your image. + +## 2. Using BitBake + +Start the build using the `bitbake` command. + +**NOTE:** An initial build can take many hours depending on your +CPU and and Internet connection speeds. +The build also takes approximately 100G-bytes of free disk space. + +**Sample Qt based IVI demo :** +The target is `agl-ivi-demo-qt`. + +``` +$ time bitbake agl-ivi-demo-qt +``` + +By default, the build process puts the resulting image in the Build Directory and further exporting that as `$IMAGE_NAME`: + +``` +/tmp/deploy/images/aws-ec2-arm64/agl-ivi-demo-qt-aws-ec2-arm64.rootfs.wic.vhd +$ export IMAGE_NAME=agl-ivi-demo-qt +``` + +**IVI-EG Flutter based demo :** +The target is `agl-ivi-demo-flutter`. + +``` +$ time bitbake agl-ivi-demo-flutter +``` + +By default, the build process puts the resulting image in the Build Directory and further exporting that as $IMAGE_NAME: + + +``` +/tmp/deploy/images/aws-ec2-arm64/agl-ivi-demo-flutter-aws-ec2-arm64.rootfs.wic.vhd +$ export IMAGE_NAME=agl-ivi-demo-flutter +``` + + +## 3. Deploying the AGL Demo Image + +Deploying the image consists of uploading the image to S3 and +conversion to to an AMI image. The whole process is done using +a script out of meta-aws . Next you need to start a new instance +using your new image. +The image is setup to expose its screen over rdp. This is ok for +development, but you need to keep security in mind when configuring +the EC2 security groups and/or tunnel over ssh. + + + +### 3.1 Uploading using create-ec2-ami.sh + +The script required to upload the resulting image is part of meta-aws in the subfolder scripts/ec2-ami/. + +**It has a few requirements that you need to setup first.** + +**These are documented in the [Readme there](https://github.com/aws4embeddedlinux/meta-aws/blob/scarthgap/scripts/ec2-ami/README.md).** + +**Read it and set it up accordingly.** + +The script itself is called creat-ec2-ami.sh and takes 4 arguments: +* your S3 bucket name +* the size of the AMI (don't make it too small) +* the target image name +* the machine name + +``` +Example run +../bsp/meta-aws/scripts/ec2-ami/create-ec2-ami.sh my_s3_bucket 8 agl-ivi-demo-flutter aws-ec2-arm64 +``` + +After this process is complete, your image is available as AMI to you (only to you). + +### 3.2 Configuring within AWS EC2 + +In your EC2 dashboard go the the same region as you configured the upload for, +select "Launch instance" and enter a name. + +![ec2-dashboard](images/1_EC2_dashboard.png) + +Select under "My AMIs" the uploaded AGL image in question. Select an instance type +that is big enough (>= 4GB RAM, 8GB RAM recommended). + +![ec2-instance-1](images/2_start-instance-1.png) + +Select your key pair, select the security group. + +![ec2-instance-2](images/3_start_instance-2.png) + +Finally start the instance. + +**Note1: AWS serial console does not help as you have no root password available until you reset it.** + +**Note2: You cannot connect as 'root' (as shown in the connect tab) - you have to substitute 'root' with 'user'.** + +**Note3: There is no web output, you need to use RDP. See below ...** + + +### 3.3 Connecting via RDP + +For security reasons, you should always tunnel over ssh. + +For this, connect using 'ssh -i "yourkey.pem" -L 3389:localhost:3389 user@publicIPofSERVER' . + +Then use an rdp client and connect to 'localhost' . + +### 3.4 Security considerations + +As mentioned above, do not expose port 3389 to the internet by opening up the port. diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/12_Available_KVM_Demo_Images.md b/docs/01_Getting_Started/02_Building_AGL_Image/12_Available_KVM_Demo_Images.md deleted file mode 100644 index ce8bb44..0000000 --- a/docs/01_Getting_Started/02_Building_AGL_Image/12_Available_KVM_Demo_Images.md +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: Available KVM Demo Images ---- - -## 1. KVM Demo Images - -These images are available when the `agl-kvm` feature is given to `aglsetup.sh`. The resulting images use DHCP for network configuration, but the following address assignments are assumed: - -- KVM demo board has internal address 172.16.10.1 -- IVI guest has internal address 172.16.10.2 -- IC guest has internal address 172.16.10.3 - -Note that all of the KVM demo images are currently configured for the Renesas H3ULCB based AGL reference hardware. While the demo can likely be run on other hardware, there are some pieces of configuration that are currently hard-coded that would need to be changed. One particular aspect of hardware-specific configuration is that the USB connection for the touchscreen used for the IVI needs to be plugged into the lower USB connector of the 2x USB 3.0 connector header on the reference hardware. - -### agl-ivi-demo-flutter-guest - -Flutter IVI demo image with: - -- IC navigation streaming support - -### agl-cluster-demo-flutter-guest - -Flutter IC demo image with: - -- KUKSA.val databroker removed, as it runs on the IVI guest. -- Application configuration changes for databroker being on the IVI guest. - -### agl-kvm-demo - -Base KVM demo image with: - -- `agl-ivi-demo-flutter-guest` IVI guest. -- `agl-cluster-demo-flutter-guest` IC guest. -- KUKSA.val databroker not present, as it runs on the IVI guest. - -## 2. Preconfigured KVM demo images - -These images are also available when the `agl-kvm` feature is given to `aglsetup.sh`, but are intended for use with a more complete demo setup along the lines of what the project showcases at tradeshows such as CES or Embedded World. The resulting images use DHCP for network configuration, but the following address assignments are assumed: - -- KVM demo board has internal address 172.16.10.1 -- IVI guest has internal address 172.16.10.2 -- IC guest has internal address 172.16.10.3 -- KVM demo board has address 192.168.10.2 -- Gateway board has address 192.168.10.4 - -### agl-ivi-demo-flutter-guest-preconfigured - -Flutter IVI demo image with: - -- IC navigation streaming support -- KUKSA.val databroker removed, as it runs on the KVM host. -- Application configuration changes for databroker being on the KVM host. -- Platform service daemons such as audio and HVAC support removed as they run on the KVM host. -- Weston Terminal application removed - -### agl-ivi-demo-flutter-guest-preconfigured-gateway - -Flutter IVI demo image with: - -- IC navigation streaming support -- KUKSA.val databroker removed, as it runs on the gateway. -- Application configuration changes for databroker being on the gateway. -- Platform service daemons such as audio and HVAC support removed as they run on the KVM host. -- Weston Terminal application removed - -### agl-cluster-demo-flutter-guest-preconfigured - -Flutter IC demo image with: - -- KUKSA.val databroker removed, as it runs on the KVM host. -- Application configuration changes for databroker being on the KVM host. -- Configuration tweaks to invert the screen orientation, as the IC screen in the full demo setup is upside down. - -### agl-cluster-demo-flutter-guest-preconfigured-gateway - -Flutter IC demo image with: - -- KUKSA.val databroker removed, as it runs on the gateway. -- Application configuration changes for databroker being on the gateway. -- Configuration tweaks to invert the screen orientation, as the IC screen in the full demo setup is upside down. - -### agl-kvm-demo-flutter-preconfigured - -KVM demo image with: - -- `agl-ivi-demo-flutter-guest-preconfigured` IVI guest. -- `agl-cluster-demo-flutter-guest-preconfigured` IC guest. -- KUKSA.val databroker. -- Platform service daemons such as audio and HVAC. - -### agl-kvm-demo-flutter-preconfigured-gateway - -- `agl-ivi-demo-flutter-guest-preconfigured-gateway` IVI guest. -- `agl-cluster-demo-flutter-guest-preconfigured-gateway` IC guest. -- Platform service daemons such as audio and HVAC -- Service configuration for the KUKSA.val databroker being on the gateway. \ No newline at end of file diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/21_Available_Demo_Images.md b/docs/01_Getting_Started/02_Building_AGL_Image/21_Available_Demo_Images.md new file mode 100644 index 0000000..32ebb6c --- /dev/null +++ b/docs/01_Getting_Started/02_Building_AGL_Image/21_Available_Demo_Images.md @@ -0,0 +1,139 @@ +--- +title: Available Demo Images +--- + +## 1. Demo Images + +These images are available when the `agl-demo` feature is given to `aglsetup.sh`. The resulting images use DHCP for network configuration, and all except the `agl-ivi-demo-control-panel` images will contain instances of the KUKSA.val databroker by default. + +### agl-ivi-image + +Base IVI demo image that the other IVI images derive from. A user will typically not be building this image, it is more relevant if making changes to the base demo services or packaging that affects all the IVI demos. + +### agl-ivi-image-crosssdk + +Corresponding SDK image for `agl-ivi-image`. Typically, a user will be more interested in the `agl-ivi-demo-qt-crosssk`, as the resulting SDK from that image is more useful for application development. + +### agl-ivi-image-flutter + +Base Flutter IVI demo image. Derived from `agl-ivi-image` and includes the Flutter components required for running Flutter applications. A user will typically not be building this image, it usually will only be interesting if doing development of primary Flutter applications such as IVI homescreen applications. + +### agl-ivi-demo-flutter + +Flutter based IVI demo image, using `flutter-ics-homescreen` application. + +### agl-ivi-demo-html5 + +HTML5 based IVI demo image, using a combination of the Chromium Embedded Framework (CEF) and Web Application Manager (WAM). + +### agl-ivi-demo-qt + +Qt based IVI demo image, using `homescreen` and `launcher` as well as other Qt applications. + +### agl-ivi-demo-qt-crosssdk + +This is the corresponding SDK image for `agl-ivi-demo-qt`. + +### agl-ivi-demo-control-panel + +IVI demo control panel image. Simple image that runs the `agl-demo-control-panel` application for driving demo setups. + +### agl-cluster-demo-flutter + +Flutter based IC demo image, using `flutter-cluster-dashboard` application. + +### agl-cluster-demo-qt + +Qt based IC demo image, using `cluster-dashboard` application. + +### agl-gateway-demo + +Gateway demo image. The image runs the KUKSA.val databroker and the associated `kuksa-dbc-feeder` for CAN input. + +### agl-telematics-demo + +Telematics demo image. Currently a WIP. + +## 2. Preconfigured Demo Images + +These images are also available when the `agl-demo` feature is given to `aglsetup.sh`, but are intended for use with a more complete demo setup along the lines of what the project showcases at tradeshows such as CES or Embedded World. The resulting images use DHCP for network configuration, but the following address assignments are assumed: + +- IVI board has address 192.168.10.2 +- IC board has address 192.168.10.3 +- Gateway board has address 192.168.10.4 + +Whether an image includes the KUKSA.val databroker or not will be indicated below. + +Note that the preconfigured IVI images are for the most part only tested on the Renesas H3ULCB based AGL reference hardware. While the IC images are typically run on a Raspberry Pi 4 when a standalone IC is used as part of a tradeshow demo, the IC images are simpler and should be a bit more flexible with respect to target platform. + +### agl-ivi-demo-flutter-preconfigured + +Flutter IVI demo image with: + +- IC navigation streaming support +- KUKSA.val databroker present, preconfigured IC images assume it runs on IVI board. +- udev configuration for USB I2C adapter for demo setup LEDs and RTC +- Weston Terminal application removed + +### agl-ivi-demo-flutter-preconfigured-gateway + +Flutter IVI demo image with: + +- IC navigation streaming support +- KUKSA.val databroker removed, as it runs on the gateway. +- Application configuration changes for databroker being on the gateway. +- udev configuration for USB I2C adapter for demo setup LEDs and RTC +- Weston Terminal application removed + +### agl-ivi-demo-qt-preconfigured + +Qt IVI demo image with: + +- IC navigation streaming support +- KUKSA.val databroker present, preconfigured IC images assume it runs on IVI board. +- udev configuration for USB I2C adapter for demo setup LEDs and RTC +- Weston Terminal application removed + +### agl-ivi-demo-control-panel-preconfigured + +IVI demo control panel image with: + +- Default configuration for databroker running on IVI board. + +### agl-ivi-demo-control-panel-preconfigured-gateway + +IVI demo control panel image with: + +- KUKSA.val databroker present, with `kuksa-dbc-feeder` configuration to output CAN messages for the signals coming from the application's vehicle simulation. +- Default configuration disables HVAC and steering wheel pages, as those are driven by hardware connected to the gateway in the full demo setup. + +### agl-cluster-demo-flutter-preconfigured + +Flutter IC demo image with: + +- KUKSA.val databroker removed, as it runs on the IVI board. +- Application configuration changes for databroker being on the IVI board. +- Configuration tweaks to invert the screen orientation, as the IC screen in the full demo setup is upside down. + +### agl-cluster-demo-flutter-preconfigured-gateway + +Flutter IC demo image with: + +- KUKSA.val databroker removed, as it runs on the gateway. +- Application configuration changes for databroker being on the gateway. +- Configuration tweaks to invert the screen orientation, as the IC screen in the full demo setup is upside down. + +### agl-cluster-demo-qt-preconfigured + +Qt IC demo image with: + +- KUKSA.val databroker removed, as it runs on the IVI board. +- Application configuration changes for databroker being on the IVI board. +- Configuration tweaks to invert the screen orientation, as the IC screen in the full demo setup is upside down. + +### agl-gateway-demo-preconfigured + +Gateway demo image with: + +- `kuksa-dbc-feeder` against `can0` interface configured for vehicle simulation (e.g. vehicle and engine speed) CAN messages coming from the `agl-ivi-demo-control-panel-preconfigured-gateway` image. +- A second instance of `kuksa-dbc-feeder` against `can1` interface configured for input and output of CAN messages from and to the steering wheel and HVAC hardware, respectively. \ No newline at end of file diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/22_Available_KVM_Demo_Images.md b/docs/01_Getting_Started/02_Building_AGL_Image/22_Available_KVM_Demo_Images.md new file mode 100644 index 0000000..ce8bb44 --- /dev/null +++ b/docs/01_Getting_Started/02_Building_AGL_Image/22_Available_KVM_Demo_Images.md @@ -0,0 +1,96 @@ +--- +title: Available KVM Demo Images +--- + +## 1. KVM Demo Images + +These images are available when the `agl-kvm` feature is given to `aglsetup.sh`. The resulting images use DHCP for network configuration, but the following address assignments are assumed: + +- KVM demo board has internal address 172.16.10.1 +- IVI guest has internal address 172.16.10.2 +- IC guest has internal address 172.16.10.3 + +Note that all of the KVM demo images are currently configured for the Renesas H3ULCB based AGL reference hardware. While the demo can likely be run on other hardware, there are some pieces of configuration that are currently hard-coded that would need to be changed. One particular aspect of hardware-specific configuration is that the USB connection for the touchscreen used for the IVI needs to be plugged into the lower USB connector of the 2x USB 3.0 connector header on the reference hardware. + +### agl-ivi-demo-flutter-guest + +Flutter IVI demo image with: + +- IC navigation streaming support + +### agl-cluster-demo-flutter-guest + +Flutter IC demo image with: + +- KUKSA.val databroker removed, as it runs on the IVI guest. +- Application configuration changes for databroker being on the IVI guest. + +### agl-kvm-demo + +Base KVM demo image with: + +- `agl-ivi-demo-flutter-guest` IVI guest. +- `agl-cluster-demo-flutter-guest` IC guest. +- KUKSA.val databroker not present, as it runs on the IVI guest. + +## 2. Preconfigured KVM demo images + +These images are also available when the `agl-kvm` feature is given to `aglsetup.sh`, but are intended for use with a more complete demo setup along the lines of what the project showcases at tradeshows such as CES or Embedded World. The resulting images use DHCP for network configuration, but the following address assignments are assumed: + +- KVM demo board has internal address 172.16.10.1 +- IVI guest has internal address 172.16.10.2 +- IC guest has internal address 172.16.10.3 +- KVM demo board has address 192.168.10.2 +- Gateway board has address 192.168.10.4 + +### agl-ivi-demo-flutter-guest-preconfigured + +Flutter IVI demo image with: + +- IC navigation streaming support +- KUKSA.val databroker removed, as it runs on the KVM host. +- Application configuration changes for databroker being on the KVM host. +- Platform service daemons such as audio and HVAC support removed as they run on the KVM host. +- Weston Terminal application removed + +### agl-ivi-demo-flutter-guest-preconfigured-gateway + +Flutter IVI demo image with: + +- IC navigation streaming support +- KUKSA.val databroker removed, as it runs on the gateway. +- Application configuration changes for databroker being on the gateway. +- Platform service daemons such as audio and HVAC support removed as they run on the KVM host. +- Weston Terminal application removed + +### agl-cluster-demo-flutter-guest-preconfigured + +Flutter IC demo image with: + +- KUKSA.val databroker removed, as it runs on the KVM host. +- Application configuration changes for databroker being on the KVM host. +- Configuration tweaks to invert the screen orientation, as the IC screen in the full demo setup is upside down. + +### agl-cluster-demo-flutter-guest-preconfigured-gateway + +Flutter IC demo image with: + +- KUKSA.val databroker removed, as it runs on the gateway. +- Application configuration changes for databroker being on the gateway. +- Configuration tweaks to invert the screen orientation, as the IC screen in the full demo setup is upside down. + +### agl-kvm-demo-flutter-preconfigured + +KVM demo image with: + +- `agl-ivi-demo-flutter-guest-preconfigured` IVI guest. +- `agl-cluster-demo-flutter-guest-preconfigured` IC guest. +- KUKSA.val databroker. +- Platform service daemons such as audio and HVAC. + +### agl-kvm-demo-flutter-preconfigured-gateway + +- `agl-ivi-demo-flutter-guest-preconfigured-gateway` IVI guest. +- `agl-cluster-demo-flutter-guest-preconfigured-gateway` IC guest. +- Platform service daemons such as audio and HVAC +- Service configuration for the KUKSA.val databroker being on the gateway. \ No newline at end of file diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/images/1_EC2_dashboard.png b/docs/01_Getting_Started/02_Building_AGL_Image/images/1_EC2_dashboard.png new file mode 100644 index 0000000..6a5341b Binary files /dev/null and b/docs/01_Getting_Started/02_Building_AGL_Image/images/1_EC2_dashboard.png differ diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/images/2_start-instance-1.png b/docs/01_Getting_Started/02_Building_AGL_Image/images/2_start-instance-1.png new file mode 100644 index 0000000..89e38ad Binary files /dev/null and b/docs/01_Getting_Started/02_Building_AGL_Image/images/2_start-instance-1.png differ diff --git a/docs/01_Getting_Started/02_Building_AGL_Image/images/3_start_instance-2.png b/docs/01_Getting_Started/02_Building_AGL_Image/images/3_start_instance-2.png new file mode 100644 index 0000000..3387182 Binary files /dev/null and b/docs/01_Getting_Started/02_Building_AGL_Image/images/3_start_instance-2.png differ -- cgit 1.2.3-korg