From a7edf92ae45bdb3bd352a4c22fc08d9ba0f5560d Mon Sep 17 00:00:00 2001 From: "David B. Kinder" Date: Thu, 18 Aug 2022 17:54:14 -0700 Subject: [PATCH] doc: update sample app user guide After review with engineering, we added material for showing what a successful hmi_vm.img build ending looks like (and a hint of what to do if it looks like the build failed. Also added using a dhclient commmand to the instructions in case the HMI_VM didn't get an IP address. Signed-off-by: David B. Kinder --- doc/getting-started/sample-app.rst | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/doc/getting-started/sample-app.rst b/doc/getting-started/sample-app.rst index 72d54aa35..65fce9ed7 100644 --- a/doc/getting-started/sample-app.rst +++ b/doc/getting-started/sample-app.rst @@ -140,7 +140,19 @@ Make the HMI_VM image ./create_image.sh hmi-vm After the script is finished the ``hmi_vm.img`` image file is created in the - ``build`` directory. The HMI VM image is a configured Ubuntu desktop image + ``build`` directory. You should see a final message from the script that + looks like this: + + .. code-block:: console + + 2022-08-18T09:53:06+08:00 [ Info ] VM image created at /home/acrn/acrn-work/acrn-hypervisor/misc/sample_application/image_builder/build/hmi_vm.img. + + If you don't see such a message, look back through the output to see what + errors are indicated. For example, there could have been a network error + while retrieving packages from the internet. In such a case, simply trying + the ``create_image.sh`` command again might work. + + The HMI VM image is a configured Ubuntu desktop image ready to launch as an ACRN user VM with the HMI parts of the sample app installed. @@ -541,6 +553,10 @@ Install and Run ACRN on the Target System (acrn-guest)root@ubuntu:~# hostname -I | cut -d ' ' -f 1 10.0.0.100 + If no IP address is reported, run this command to request an IP address and check again:: + + dhclient + #. Run the HMI VM Sample Application userApp (in the background) and histapp.py:: ./userApp &