ACRN Kernel Parameters¶
Generic kernel parameters¶
A number of kernel parameters control the behavior of ACRN-based systems. Some are applicable to the Service VM kernel, others to the User VM kernel, and some are applicable to both.
This section focuses on generic parameters from the Linux kernel which are relevant for configuring or debugging ACRN-based systems.
|Parameter||Used in Service VM or User VM||Description||Usage example|
|module_blacklist||Service VM||A comma-separated list of modules that should not be loaded. Useful to debug or work around issues related to specific modules.||
|no_timer_check||Service VM,User VM||Disables the code which tests for broken timer IRQ sources.||
|console||Service VM,User VM||
Output console device and options.
console=tty0 console=ttyS0 console=hvc0
All Kernel messages with a loglevel less than the console loglevel will
be printed to the console. The loglevel can also be changed with
|ignore_loglevel||User VM||Ignoring loglevel setting will print all
kernel messages to the console. Useful for debugging.
We also add it as printk module parameter, so users
could change it dynamically, usually by changing
|log_buf_len||User VM||Sets the size of the printk ring buffer, in bytes. n must be a power of two and greater than the minimal size. The minimal size is defined by LOG_BUF_SHIFT kernel config parameter. There is also CONFIG_LOG_CPU_MAX_BUF_SHIFT config parameter that allows to increase the default size depending on the number of CPUs. See init/Kconfig for more details.”||
|consoleblank||Service VM,User VM||The console blank (screen saver) timeout in seconds. Defaults to 600 (10 minutes). A value of 0 disables the blank timer.||
|rootwait||Service VM,User VM||Wait (indefinitely) for root device to show up. Useful for devices that are detected asynchronously (e.g. USB and MMC devices).||
|root||Service VM,User VM||
Define the root filesystem
root=/dev/mmcblk0p1 root=/dev/vda2 root=PARTUUID=00112233-4455-6677-8899-AABBCCDDEEFF
|rw||Service VM,User VM||Mount root device read-write on boot||
Disable clocksource stability checks for TSC.
Format: <string>, where the only supported value is:
|cma||Service VM||Sets the size of the kernel global memory area for
contiguous memory allocations, and optionally the
placement constraint by the physical address range of
memory allocations. A value of 0 disables CMA
altogether. For more information, see
Sets the guest physical address and size of the dedicated hypervisor
log ring buffer between the hypervisor and Service VM.
If hypervisor relocation is disabled, verify that
If hypervisor relocation is enabled, reserve the memory below 256MB, since hypervisor could be relocated anywhere between 256MB and 4GB.
You should enable ASLR on SOS. This ensures that when guest Linux is relocating kernel image, it will avoid this buffer address.
Mark specific memory as reserved.
|ramoops.mem_address ramoops.mem_size ramoops.console_size||Service VM||
Ramoops is an oops/panic logger that writes its logs to RAM before the system crashes. Ramoops uses a predefined memory area to store the dump. See Linux Kernel Ramoops oops/panic logger for details.
This buffer should not overlap with hypervisor reserved memory and
guest kernel image. See
ramoops.mem_address=0xa00000 ramoops.mem_size=0x400000 ramoops.console_size=0x200000
Reboot in case of panic
The comma-delimited parameters are:
Maximum number of processors that an SMP kernel will bring up during bootup.
After bootup, you can bring up additional plugged CPUs by executing
|nohpet||User VM||Don’t use the HPET timer||
Intel IOMMU driver (DMAR) option
Intel GVT-g (AcrnGT) Parameters¶
This table gives an overview of all the Intel GVT-g parameters that are available to tweak the behavior of the graphics sharing (Intel GVT-g, aka AcrnGT) capabilities in ACRN. The GVT-g-kernel-options section below has more details on a few select parameters.
|Parameter||Used in Service VM or User VM||Description||Usage example|
|i915.enable_gvt||Service VM||Enable Intel GVT-g graphics virtualization support in the host||
|i915.gvt_workload_priority||Service VM||Define the priority level of User VM graphics workloads||
|i915.enable_initial_modeset||Service VM||On MRB, value must be
|i915.nuclear_pageflip||Service VM,User VM||Force enable atomic functionality on platforms that don’t have full support yet.||
|i915.domain_scaler_owner||Service VM||See i915.domain_scaler_owner||
|i915.enable_guc||Service VM||Enable GuC load for HuC load.||
|i915.enable_guc||User VM||Disable GuC||
|i915.enable_hangcheck||User VM||Disable check GPU activity for detecting hangs.||
|i915.enable_fbc||User VM||Enable frame buffer compression for power savings||
GVT-g (AcrnGT) Kernel Options details¶
This section provides additional information and details on the kernel command line options that are related to AcrnGT.
This option enables support for Intel GVT-g graphics virtualization
support in the host. By default, it’s not enabled, so we need to add
i915.enable_gvt=1 in the Service VM kernel command line. This is a Service
OS only parameter, and cannot be enabled in the User VM.
AcrnGT supports Prioritized Rendering as described in the Prioritized Rendering and Preemption high-level design. This configuration option controls the priority level of GVT-g guests. Priority levels range from -1023 to 1023.
The default priority is zero, the same priority as the Service VM. If the level is less than zero, the guest’s priority will be lower than the Service VM, so graphics preemption will work and the prioritized rendering feature will be enabled. If the level is greater than zero, User VM graphics workloads will preempt most of the Service VM graphics workloads, except for display updating related workloads that use a default highest priority (1023).
Currently, all User VMs share the same priority. This is a Service VM only parameters, and does not work in the User VM.
At time, kernel graphics must be initialized with a valid display configuration with full display pipeline programming in place before the user space is initialized and without a fbdev & fb console.
i915.enable_initial_modeset=1, the FBDEV of i915 will not be
initialized, so users would not be able to see the fb console on screen.
If there is no graphics UI running by default, users will see black
i915.enable_initial_modeset=0 in Service VM, the plane restriction
(also known as plane-based domain ownership) feature will be disabled.
(See the next section and Plane-Based Domain Ownership in the ACRN GVT-g
High Level Design for more information about this feature.)
In the current configuration, we will set
i915.enable_initial_modeset=1 in Service VM and
i915.enable_initial_modeset=0 in User VM.
On each Intel GPU display pipeline, there are several plane scalers to zoom in/out the planes. For example, if a 720p video is played full-screen on a 1080p display monitor, the kernel driver will use a scaler to zoom in the video plane to a 1080p image and present it onto a display pipeline. (Refer to “Intel Open Source Graphics PRM Vol 7: display” for the details.)
On Broxton platforms, Pipe A and Pipe B each
have two plane scalers, and Pipe C has one plane scaler. To support the
plane scaling in AcrnGT guest OS, we introduced the parameter
i915.domain_scaler_owner, to assign a specific scaler to the target
As with the parameter
i915.domain_plane_owners, each nibble of
i915.domain_scaler_owner represents the domain id that owns the scaler;
every nibble (4 bits) represents a scaler and every group of 2 nibbles
represents a pipe. This is a Service VM only configuration and cannot be
modified at runtime. Domain ID 0x0 is for the Service VM, the User VM
use domain IDs from 0x1 to 0xF.
For example, if we set
i915.domain_scaler_owner=0x021100, the Service VM
owns scaler 1A, 2A; User VM #1 owns scaler 1B, 2B; and User VM #2 owns scaler
This parameter enable detection of a GPU hang. When enabled, the i915 will start a timer to check if the workload is completed in a specific time. If not, i915 will treat it as a GPU hang and trigger a GPU reset.
In AcrnGT, the workload in Service VM and User VM can be set to different
priorities. If Service VM is assigned a higher priority than the User VM, the User VM’s
workload might not be able to run on the HW on time. This may lead to
the guest i915 triggering a hangcheck and lead to a guest GPU reset.
This reset is unnecessary so we use
disable this timeout check and prevent guest from triggering unnecessary