Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create AAOS tutorial #78

Merged
merged 5 commits into from
May 31, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,7 @@ hotfix
HTTPS
HW
HWE
HVAC
IAM
idmapped
IDR
Expand Down
55 changes: 55 additions & 0 deletions tutorial/getting-started-aaos.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
This tutorial guides you through basic operations that you can do with an application based on an Android Automotive OS (AAOS) image.

In this tutorial, we will be specifically focusing on the following tasks:
- Creating an application using an AAOS image
- Stream the application you created with a specific screen resolution
- Set the temperature of the automotive using the Vehicle Hardware Abstraction Layer (VHAL) controls
keirthana marked this conversation as resolved.
Show resolved Hide resolved

## Prerequisites
We will use the appliance dashboard to perform the tasks for this tutorial. So if you haven’t installed the Anbox Cloud Appliance yet, you must do so before you can continue with this tutorial. Follow the installation instructions available at [How to install the Anbox Cloud Appliance](https://discourse.ubuntu.com/t/22681) to install and initialise the appliance.

## Create an AAOS-based application

On the web dashboard *Applications* screen, click *Add Application*.

Enter values for the mandatory fields, keeping the following points in mind:
- Select *Automotive* as the application type.
- Select an AAOS image. The image name should indicate whether it is an AOSP or an AAOS image. For example, `jammy:aaos13:amd64` is an AAOS image.

Click *Add application* and wait till the *Applications* list screen shows your application with a ready status.

## Stream the application with a specific screen resolution

On the *Sessions* screen, click *Create session*.

Select the application that you created earlier.

Any of the *Screen resolution* options listed for the application should work but to set a custom resolution, select *Custom* from the drop-down and set the following values:
```
Width = 2304
Height = 3072
keirthana marked this conversation as resolved.
Show resolved Hide resolved
```
Remember that screen resolutions for AAOS (automotive) applications will be different from those of the AOSP (mobile) applications because the target devices are different.

It is important to understand that higher screen resolutions consume more resources.

Select a desired *Frame rate*, for example, 60.

Click *Create session*.

## Set automotive temperature using the VHAL panel

Once the session is created, you can see the Android UI streaming. The controls on the right help you set specific automotive controls.

Try setting the temperature by performing the following steps:

- Select *All VHAL properties* on the right.
- In the *Search* bar, enter *HVAC_TEMPERATURE_SET*.
- Click on the HVAC panel icon to open it.
- Modify the temperatures for *Area 1* and *Area 2*
keirthana marked this conversation as resolved.
Show resolved Hide resolved

As you modify the temperatures, you can see the changes reflecting on the HVAC panel.

## Learn more

Learn about the various [supported system properties in the VHAL](https://source.android.com/docs/automotive/vhal/system-properties).