From 90c27157e48045b7eb9e0162f85bbc5db3337c4b Mon Sep 17 00:00:00 2001
From: Xie Zhengtian <coneypo@gmail.com>
Date: Tue, 27 Nov 2018 16:59:41 +0800
Subject: [PATCH] Create using AGL as UOS

---
 doc/tutorials/using_AGL_as_uos | 86 ++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)
 create mode 100644 doc/tutorials/using_AGL_as_uos

diff --git a/doc/tutorials/using_AGL_as_uos b/doc/tutorials/using_AGL_as_uos
new file mode 100644
index 000000000..8fef50033
--- /dev/null
+++ b/doc/tutorials/using_AGL_as_uos
@@ -0,0 +1,86 @@
+.. _acrn_doc:
+
+Using AGL as the User OS
+#############################
+
+In this article we will discusse the way to run AGL as a Guest OS 
+on ACRN hypervisor and the problems we got at current stage. 
+We hope the steps documented in this article could help us to 
+reproduce the problem much easier and provide some information 
+for further debugging.
+
+   .. image:: images/The-overview-of-AGL-as-UOS.png
+      :align: center
+
+Overview
+**********************
+
+Automotive Grade Linux (AGL) is an open source project of The Linux 
+Foundation that is building a Linux-based, open software platform for 
+automotive application.
+
+For more information about AGL, please visit AGL’s official website:
+https://www.automotivelinux.org/
+
+Setup AGL as a Guest OS in ACRN
+*******************************
+
+#. Hardware preparation
+
+    The regulatory model of NUC we used is “NUC6CAYH”, and for more 
+    information about this kind of NUC, please visit the official website:
+    https://www.intel.com/content/www/us/en/products/boards-kits/nuc/kits/
+    nuc6cayh.html. First we need to prepare 2 displays, one for SOS and one 
+    for UOS, and connect these 2 displays to NUC as picture below.
+
+       .. image:: images/The-displayports-of-NUC.png
+          :align: center
+
+
+#. Setup ACRN SOS
+
+    Follow the instructions found in the Getting started guide for Intel NUC 
+    to setup SOS. https://projectacrn.github.io/latest/getting-started/apl-nuc.html#
+
+
+#. Setup ACRN UOS
+  To launch AGL as UOS, we need to download the image of AGL from:
+  https://download.automotivelinux.org/AGL/release/eel/5.1.0/intel-corei7-64/
+  deploy/images/intel-corei7-64/agl-demo-platform-crosssdk-intel-corei7-64.wic.xz
+
+  Here we use version “eel_5.1.0”, and you can try other release of AGL in ACRN.
+
+  .. code-block: none
+
+     projectacrn/
+        $ cd ~
+        $ wget https://download.automotivelinux.org/AGL/release/eel/5.1.0/intel-
+        corei7-64/deploy/images/intel-corei7-64/agl-demo-platform-crosssdk-intel-
+        corei7-64.wic.xz
+        $ unxz agl-demo-platform-crosssdk-intel-corei7-64.wic.xz
+        
+        
+  You need to adjust the ``/usr/share/acrn/samples/nuc/launch_uos.sh`` script
+  to match your installation. These are the couple of lines you need to modify:
+
+  .. code-block:: none
+
+     -s 3,virtio-blk,/root/agl-demo-platform-crosssdk-intel-corei7-64-20180726071132.rootfs.wic \
+     -B "root=/dev/vda2 
+     
+#. Start the User OS (UOS)
+
+  You are now all set to start the User OS (UOS)
+
+  .. code-block:: none
+     sudo /usr/share/acrn/samples/nuc/launch_uos.sh
+
+  **Congratulations**, you are now watching the User OS booting up!
+
+  And you should be able to see the console of AGL:
+    .. code-block:: none
+     sudo /usr/share/acrn/samples/nuc/launch_uos.sh
+     
+     
+     When you see the output of the console above, that means AGL has been 
+     loaded and now you could operate on the console.