mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-04-28 19:54:01 +00:00
a7e53dd32f
The 'uart=' parameter for the hypervisor takes multiple forms. One is to specify the BDF (Bus, Device, Function) value of the serial port PCI device. The description in the documentation used the previous format (e.g. '0:18.1') but a 16-bit WORD in HEX needs to be passed nowadays. E.g.: '0:18.1' is specified by 'uart=0xc1' Tracked-On: #5842 Signed-off-by: Geoffroy Van Cutsem <geoffroy.vancutsem@intel.com> Signed-off-by: Benjamin Fitch <benjamin.fitch@intel.com>
41 lines
2.7 KiB
ReStructuredText
41 lines
2.7 KiB
ReStructuredText
.. _hv-parameters:
|
|
|
|
ACRN Hypervisor Parameters
|
|
##########################
|
|
|
|
Generic Hypervisor Parameters
|
|
*****************************
|
|
|
|
The ACRN hypervisor supports the following parameter:
|
|
|
|
+-----------------+-----------------------------+----------------------------------------------------------------------------------------+
|
|
| Parameter | Value | Description |
|
|
+=================+=============================+========================================================================================+
|
|
| | disabled | This disables the serial port completely. |
|
|
| +-----------------------------+----------------------------------------------------------------------------------------+
|
|
| ``uart=`` | bdf@<BDF value> | This sets the serial port PCI BDF (in HEX), e.g. ``bdf@0xc1`` |
|
|
| | | |
|
|
| | | BDF: Bus, Device, and Function (in HEX) of the serial PCI device. The BDF is packed |
|
|
| | | into a 16-bit WORD with format (B:8, D:5, F:3). For example, PCI device ``0:18.1`` |
|
|
| | | becomes ``0xc1`` |
|
|
| +-----------------------------+----------------------------------------------------------------------------------------+
|
|
| | port@<port address> | This sets the serial port PIO address, e.g. ``uart=port@0x3F8`` |
|
|
| +-----------------------------+----------------------------------------------------------------------------------------+
|
|
| | mmio@<MMIO address> | This sets the serial port MMIO address, e.g. ``uart=mmio@0xfe040000`` |
|
|
+-----------------+-----------------------------+----------------------------------------------------------------------------------------+
|
|
|
|
The Generic hypervisor parameters are specified in the GRUB multiboot/multiboot2 command.
|
|
For example:
|
|
|
|
.. code-block:: none
|
|
:emphasize-lines: 5
|
|
|
|
menuentry 'Boot ACRN hypervisor from multiboot' {
|
|
insmod part_gpt
|
|
insmod ext2
|
|
echo 'Loading ACRN hypervisor ...'
|
|
multiboot --quirk-modules-after-kernel /boot/acrn.32.out uart=bdf@0xc1
|
|
module /boot/bzImage Linux_bzImage
|
|
module /boot/bzImage2 Linux_bzImage2
|
|
}
|