doc: add UID parameter for acpidev_pt

Now the acpidev_pt module only use the hid to check the device,it can't
work well if there are more then one instance.

So this patch add UID to identify same type device to fix these issue.

Tracked-On: #6690
Signed-off-by: Chenli Wei <chenli.wei@linux.intel.com>
This commit is contained in:
Chenli Wei 2022-01-28 11:32:21 +08:00 committed by David Kinder
parent 9f8231e7ba
commit b41ff11a9c
3 changed files with 11 additions and 7 deletions

View File

@ -56,7 +56,7 @@ options:
[-l lpc] [-m mem] [-r ramdisk_image_path]
[-s pci] [--ovmf ovmf_file_path]
[--enable_trusty] [--intr_monitor param_setting]
[--acpidev_pt HID] [--mmiodev_pt MMIO_regions]
[--acpidev_pt HID[,UID]] [--mmiodev_pt MMIO_regions]
[--vtpm2 sock_path] [--virtio_poll interval] [--mac_seed seed_string]
[--cpu_affinity lapic_ids] [--lapic_pt] [--rtvm] [--windows]
[--debugexit] [--logger-setting param_setting]
@ -81,7 +81,7 @@ options:
--intr_monitor: enable interrupt storm monitor
its params: threshold/s,probe-period(s),delay_time(ms),delay_duration(ms),
--virtio_poll: enable virtio poll mode with poll interval with ns
--acpidev_pt: ACPI device ID args: HID in ACPI Table
--acpidev_pt: ACPI device ID args: HID,UID from the ACPI tables
--mmiodev_pt: MMIO resources args: physical MMIO regions
--vtpm2: Virtual TPM2 args: sock_path=$PATH_OF_SWTPM_SOCKET
--lapic_pt: enable local apic passthrough
@ -111,7 +111,7 @@ Here's an example showing how to run a VM with:
-s 5,virtio-console,@pty:pty_port \
-s 3,virtio-blk,/home/acrn/UserVM.img \
-s 4,virtio-net,tap_LaaG \
--acpidev_pt MSFT0101 \
--acpidev_pt MSFT0101,00 \
--intr_monitor 10000,10,1,100 \
-B "root=/dev/vda2 rw rootwait maxcpus=3 nohpet console=hvc0 \
console=ttyS0 no_timer_check ignore_loglevel log_buf_len=16M \

View File

@ -20,7 +20,7 @@ Here is how ACRN supports MMIO device passthrough:
pre-launched VM, plus we use the command line to tell which MMIO
device we want to pass through to the post-launched VM.
If the MMIO device has ACPI Tables, use ``--acpidev_pt HID`` and
If the MMIO device has ACPI Tables, use ``--acpidev_pt HID[,UID]`` and
if not, use ``--mmiodev_pt MMIO_regions``.
.. note::

View File

@ -218,16 +218,20 @@ Here are descriptions for each of these ``acrn-dm`` command line parameters:
----
``--acpidev_pt <HID>``
``--acpidev_pt <HID>[,<UID>]``
This option is to enable ACPI device passthrough support. The ``HID`` is a
mandatory parameter for this option which is the Hardware ID of the ACPI
device.
The ``UID`` is an option and used to specify a particular instance of the
HID device, the default is 00.
Example::
--acpidev_pt MSFT0101
--acpidev_pt MSFT0101,00
To pass through a TPM (which HID is MSFT0101) ACPI device to a User VM.
To pass through a TPM (which HID is MSFT0101 and UID is 00) ACPI device to
a User VM.
----