summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJan-Simon Möller <jsmoeller@linuxfoundation.org>2021-02-02 18:51:39 +0100
committerJan-Simon Moeller <jsmoeller@linuxfoundation.org>2021-02-03 11:23:30 +0000
commitd215d26262b9b00201de1525398c497c6ad9c94c (patch)
treede77e519f599547df5f7eb23a5992a11a27d35f6
parentf89dc1a25200480f19094c468b2122462bfdfc45 (diff)
Adapt instructions for VirtualBox
This is due to https://www.virtualbox.org/ticket/19873?cversion=0&cnum_hist=4 Adapt the documentation to deal with the resolution issue. Bug-AGL: SPEC-3731 Signed-off-by: Jan-Simon Möller <jsmoeller@linuxfoundation.org> Change-Id: I6ff56593d1064d44dc5ab972d8e3475003a91f36 Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/25988
-rw-r--r--docs/0_Getting_Started/1_Quickstart/Using_Ready_Made_Images.md9
1 files changed, 8 insertions, 1 deletions
diff --git a/docs/0_Getting_Started/1_Quickstart/Using_Ready_Made_Images.md b/docs/0_Getting_Started/1_Quickstart/Using_Ready_Made_Images.md
index 7bbc957..17f238d 100644
--- a/docs/0_Getting_Started/1_Quickstart/Using_Ready_Made_Images.md
+++ b/docs/0_Getting_Started/1_Quickstart/Using_Ready_Made_Images.md
@@ -75,6 +75,9 @@ AGL provides a number of pre-built ready-made images of various versions.
### 2. Virtual Box (Emulation)
+**NOTE :** Please note [https://www.virtualbox.org/ticket/19873](https://www.virtualbox.org/ticket/19873) as this affects the VMs resolution.
+The AGL demo images do require 1920x1080. The instructions below have been adapted.
+
1. Download the [compressed vbox disk image](https://download.automotivelinux.org/AGL/snapshots/master/latest/qemux86-64/deploy/images/qemux86-64/agl-demo-platform-crosssdk-qemux86-64.wic.vmdk.xz).
2. Install and set up [Virtual Box](https://www.virtualbox.org/wiki/Linux_Downloads).
@@ -96,7 +99,11 @@ AGL provides a number of pre-built ready-made images of various versions.
- Go to `Storage`, and change the attribute to `Type : AHCI` and click on `OK`.
![vbox-step-5](images/vbox-5.png)
- Next go to `Display` and change the attribute to 'VMSVGA' for the graphics driver. Change the graphics memory to be at least 64MB.
- - Click on `Start`.
+ - **Important:**: Open a new terminal window and execute this command:
+ ```sh
+ VBoxManage setextradata agl-demo VBoxInternal2/EfiGraphicsResolution 1920x1080
+ ```
+ - Return to the UI and click on `Start`.
- For troubleshooting, you can refer [here](https://lists.automotivelinux.org/g/agl-dev-community/message/8474).
### 3. x86 physical system