github/acrn-hypervisor
1
0
Fork 0
mirror of https://github.com/projectacrn/acrn-hypervisor.git synced 2025-06-23 05:57:33 +00:00
Code Issues Projects Releases Wiki Activity

doc: update vUART tutorials

Browse Source 
The current code assign COM2 to S5 feature as a commutation vUART, so
the COM2's IO port which value is 0x2F8 could not assign to another
vUART connection.

This patch add a note and modify the legacy vUART sample, change the
default IO port to 0x3E8 which was known as COM3.

Tracked-On: #6690
Signed-off-by: Chenli Wei <chenli.wei@linux.intel.com>
This commit is contained in:
Chenli Wei 2022-07-18 22:23:49 +08:00 committed by David Kinder
parent 69e1ec970c
commit ccf80a5ec2
2 changed files with 10 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/tutorials/images/configurator-vuartconn01.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 60 KiB

After

Width:  |  Height:  |  Size: 56 KiB

13
doc/tutorials/vuart_configuration.rst
View File

@ -84,10 +84,17 @@ For the connection:
To add another connection, click **+** on the right side of an existing
connection. Or click **-** to delete a connection.
.. note::
The release v3.0 ACRN Configurator assigns COM2 (I/O address ``0x2F8``) to
the S5 feature. A conflict will occur if you assign ``0x2F8`` to another
connection. In our example, we'll use COM3 (I/O address ``0x3F8``).
.. image:: images/configurator-vuartconn01.png
:align: center
:class: drop-shadow
Example Configuration
=====================
@ -108,7 +115,7 @@ connection between two VMs. The example extends the information provided in the
#. For the vUART type, this example uses ``Legacy``.
#. For the virtual I/O address, this example uses ``0x2f8``.
#. For the virtual I/O address, this example uses ``0x3E8``.
.. image:: images/configurator-vuartconn01.png
:align: center
@ -134,7 +141,7 @@ connection between two VMs. The example extends the information provided in the
[ 0.105303] printk: console [tty0] enabled
[ 0.105319] printk: console [ttyS0] enabled
[ 1.391979] 00:03: ttyS0 at I/O 0x3f8 (irq = 4, base_baud = 115200) is a 16550A
[ 1.649819] serial8250: ttyS1 at I/O 0x2f8 (irq = 3, base_baud = 115200) is a 16550A
[ 1.649819] serial8250: ttyS1 at I/O 0x3e8 (irq = 5, base_baud = 115200) is a 16550A
[ 3.394543] systemd[1]: Created slice system-serial\x2dgetty.slice.
#. Test vUART communication:
@ -164,4 +171,4 @@ For details on ACRN vUART high-level design, see:
* :ref:`hv-console-shell-uart`
* :ref:`vuart_virtualization`
* :ref:`uart_virtualization`
* :ref:`uart_virtualization`