doc: update sample app guide
Address comments from DX reviews, and update the cyclictest histogram output (improvements from PR #8026) Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
parent
31f92eba63
commit
5a8339be25
Binary file not shown.
After Width: | Height: | Size: 65 KiB |
Binary file not shown.
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 23 KiB |
|
@ -360,8 +360,15 @@ and generate new launch scripts for this Sample Application.
|
||||||
:width: 400px
|
:width: 400px
|
||||||
|
|
||||||
|
|
||||||
#. We're done configuring the sample application scenario. Exit the configurator
|
#. We're done configuring the sample application scenario. When you saved the
|
||||||
by clicking the **X** in the top right corner).
|
scenario, the configurator did a re-verification of all the option settings
|
||||||
|
and found no issues, so all the error indicators are now cleared.
|
||||||
|
|
||||||
|
Exit the configurator by clicking the **X** in the top right corner).
|
||||||
|
|
||||||
|
.. image:: images/samp-image015a.png
|
||||||
|
:class: drop-shadow
|
||||||
|
:align: center
|
||||||
|
|
||||||
You can see the saved scenario and launch scripts in the working
|
You can see the saved scenario and launch scripts in the working
|
||||||
directory:
|
directory:
|
||||||
|
@ -534,11 +541,11 @@ Install and Run ACRN on the Target System
|
||||||
sudo ~/acrn-work/launch_user_vm_id1.s
|
sudo ~/acrn-work/launch_user_vm_id1.s
|
||||||
|
|
||||||
#. The launch script will start up the HMI_VM and show an Ubuntu login
|
#. The launch script will start up the HMI_VM and show an Ubuntu login
|
||||||
prompt in your ssh session and a graphical login on your target's HDMI
|
prompt in your ssh session (and a graphical login on your target's HDMI
|
||||||
monitor.
|
monitor).
|
||||||
|
|
||||||
Login to the HMI_VM as **root** user (not acrn) using your development
|
Login to the HMI_VM as **root** user (not acrn) using your development
|
||||||
systems ssh session:
|
system's ssh session:
|
||||||
|
|
||||||
.. code-block:: console
|
.. code-block:: console
|
||||||
:emphasize-lines: 1
|
:emphasize-lines: 1
|
||||||
|
@ -565,6 +572,7 @@ Install and Run ACRN on the Target System
|
||||||
#. Run the HMI VM Sample Application userApp (in the background) and histapp.py::
|
#. Run the HMI VM Sample Application userApp (in the background) and histapp.py::
|
||||||
|
|
||||||
./userApp &
|
./userApp &
|
||||||
|
|
||||||
python3 histapp.py
|
python3 histapp.py
|
||||||
|
|
||||||
At this point, the HMI_VM is running and we've started the HMI parts of
|
At this point, the HMI_VM is running and we've started the HMI parts of
|
||||||
|
@ -599,9 +607,10 @@ Install and Run ACRN on the Target System
|
||||||
(acrn-guest)root@ubuntu:~#
|
(acrn-guest)root@ubuntu:~#
|
||||||
|
|
||||||
|
|
||||||
#. Run the cyclictest (in the background) and the rtAPP in this RT_VM::
|
#. Run the cyclictest (in the background) and then the rtApp in this RT_VM::
|
||||||
|
|
||||||
cyclictest -p 80 --fifo="./data_pipe" -q &
|
cyclictest -p 80 --fifo="./data_pipe" -q &
|
||||||
|
|
||||||
./rtApp
|
./rtApp
|
||||||
|
|
||||||
Now the two parts of the sample application are running:
|
Now the two parts of the sample application are running:
|
||||||
|
@ -613,18 +622,20 @@ Now the two parts of the sample application are running:
|
||||||
|
|
||||||
We can view this data displayed as a histogram:
|
We can view this data displayed as a histogram:
|
||||||
|
|
||||||
Option 1: Use a browser on the HMI VM using the target system console
|
Option 1: Use a browser on your development system
|
||||||
Login to the HMI_VM on the target system's console. (If you want to
|
|
||||||
login as root, click on the "Not listed?" link under the username choices you
|
|
||||||
do see and enter the root username and password. Open the web browser to
|
|
||||||
http://localhost
|
|
||||||
|
|
||||||
Option 2: Use a browser on your development system
|
|
||||||
Open a web-browser on your development computer to the
|
Open a web-browser on your development computer to the
|
||||||
HMI_VM IP address we found in an earlier step (e.g., http://10.0.0.100).
|
HMI_VM IP address we found in an earlier step (e.g., http://10.0.0.100).
|
||||||
|
|
||||||
|
Option 2: Use a browser on the HMI VM using the target system console
|
||||||
|
Login to the HMI_VM on the target system's console. (If you want to
|
||||||
|
login as root, click on the "Not listed?" link under the username choices you
|
||||||
|
do see and enter the root username and password.) Open the web browser to
|
||||||
|
http://localhost
|
||||||
|
|
||||||
Refresh the browser. You'll see a histogram graph showing the
|
Refresh the browser. You'll see a histogram graph showing the
|
||||||
percentage of latency time intervals reported by cyclictest.
|
percentage of latency time intervals reported by cyclictest. The histogram will
|
||||||
|
update every time you refresh the browser. (Notice the count of samples
|
||||||
|
increases as reported on the vertical axis label.)
|
||||||
|
|
||||||
.. figure:: images/samp-image018.png
|
.. figure:: images/samp-image018.png
|
||||||
:class: drop-shadow
|
:class: drop-shadow
|
||||||
|
@ -635,6 +646,9 @@ percentage of latency time intervals reported by cyclictest.
|
||||||
The horizontal axis represents the latency values in microseconds, and the
|
The horizontal axis represents the latency values in microseconds, and the
|
||||||
vertical axis represents the percentage of occurrences of those values.
|
vertical axis represents the percentage of occurrences of those values.
|
||||||
|
|
||||||
|
Congratulations
|
||||||
|
***************
|
||||||
|
|
||||||
That completes the building and running of this sample application. You
|
That completes the building and running of this sample application. You
|
||||||
can view the application's code in the
|
can view the application's code in the
|
||||||
``~/acrn-work/acrn-hypervisor/misc/sample_application`` directory on your
|
``~/acrn-work/acrn-hypervisor/misc/sample_application`` directory on your
|
||||||
|
|
Loading…
Reference in New Issue