154 lines
6.4 KiB
ReStructuredText
154 lines
6.4 KiB
ReStructuredText
.. _release_notes_2.6:
|
|
|
|
ACRN v2.6 (Sep 2021)
|
|
####################
|
|
|
|
We are pleased to announce the release of the Project ACRN hypervisor
|
|
version 2.6.
|
|
|
|
ACRN is a flexible, lightweight reference hypervisor that is built with
|
|
real-time and safety-criticality in mind. It is optimized to streamline
|
|
embedded development through an open-source platform. See the
|
|
:ref:`introduction` introduction for more information.
|
|
|
|
All project ACRN source code is maintained in the
|
|
https://github.com/projectacrn/acrn-hypervisor repository and includes
|
|
folders for the ACRN hypervisor, the ACRN device model, tools, and
|
|
documentation. You can download this source code either as a zip or
|
|
tar.gz file (see the `ACRN v2.6 GitHub release page
|
|
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v2.6>`_) or
|
|
use Git ``clone`` and ``checkout`` commands::
|
|
|
|
git clone https://github.com/projectacrn/acrn-hypervisor
|
|
cd acrn-hypervisor
|
|
git checkout v2.6
|
|
|
|
The project's online technical documentation is also tagged to
|
|
correspond with a specific release: generated v2.6 documents can be
|
|
found at https://projectacrn.github.io/2.6/. Documentation for the
|
|
latest development branch is found at https://projectacrn.github.io/latest/.
|
|
|
|
ACRN v2.6 requires Ubuntu 18.04. Follow the instructions in the
|
|
:ref:`gsg` to get started with ACRN.
|
|
|
|
|
|
What's New in v2.6
|
|
******************
|
|
|
|
Nested Virtualization Technology Performance Tuning
|
|
The performance of nested virtualization, a feature first introduced as a
|
|
preview in the v2.5 release, was improved. CPU and I/O performance of level 2
|
|
virtual machines (for example, a VM running on a KVM/QEMU VM that itself is a
|
|
VM on ACRN hypervisor) is now on par with a VM running on KVM on bare metal.
|
|
Read more in the :ref:`nested_virt` tutorial.
|
|
|
|
Support loading OSs in ELF format
|
|
ACRN hypervisor now can load OS images packed in ELF (Executable and Linkable
|
|
Format). This adds flexibility to OSs such as Zephyr running in pre-launched
|
|
VMs.
|
|
|
|
|
|
Upgrading to v2.6 From Previous Releases
|
|
****************************************
|
|
|
|
We highly recommended that you follow these instructions to
|
|
upgrade to v2.6 from previous ACRN releases.
|
|
|
|
Generate New Board XML
|
|
======================
|
|
|
|
Board XML files, generated by ACRN board inspector, contain board information
|
|
that is essential to build ACRN. Compared to previous versions, ACRN v2.6 adds
|
|
the following hardware information to board XMLs to support new features and
|
|
fixes.
|
|
|
|
- Maximum width of physical and linear addresses
|
|
- Device objects in the ACPI namespace
|
|
- Routing of PCI interrupt pins
|
|
- Number of requested vectors of MSI-capable PCI devices
|
|
|
|
The new board XML can be generated using the ACRN board inspector in the same
|
|
way as ACRN v2.5. Refer to :ref:`acrn_config_workflow` for a complete list of
|
|
steps to deploy and run the tool.
|
|
|
|
Add New Configuration Options
|
|
=============================
|
|
|
|
In v2.6, the following elements are added to scenario XML files.
|
|
|
|
- :option:`hv.FEATURES.ENFORCE_TURNOFF_GP` (Default value is ``n``)
|
|
- :option:`hv.FEATURES.SECURITY_VM_FIXUP` (Default value is ``n``)
|
|
|
|
Document Updates
|
|
****************
|
|
|
|
We've made major improvements to the introductory ACRN documentation including:
|
|
|
|
.. rst-class:: rst-columns2
|
|
|
|
* :ref:`introduction`
|
|
* :ref:`overview_dev`
|
|
* :ref:`gsg`
|
|
* :ref:`acrn_configuration_tool`
|
|
|
|
We've also made edits throughout the documentation to improve clarity,
|
|
formatting, and presentation:
|
|
|
|
.. rst-class:: rst-columns2
|
|
|
|
* :ref:`hld-devicemodel`
|
|
* :ref:`hld-overview`
|
|
* :ref:`hld-power-management`
|
|
* :ref:`hld-virtio-devices`
|
|
* :ref:`hld-io-emulation`
|
|
* :ref:`virtio-net`
|
|
* :ref:`acrn_on_qemu`
|
|
* :ref:`cpu_sharing`
|
|
* :ref:`nested_virt`
|
|
* :ref:`setup_openstack_libvirt`
|
|
* :ref:`using_hybrid_mode_on_nuc`
|
|
* :ref:`acrn_doc`
|
|
|
|
Fixed Issues Details
|
|
********************
|
|
|
|
.. comment example item
|
|
- :acrn-issue:`5626` - [CFL][industry] Host Call Trace once detected
|
|
|
|
- :acrn-issue:`6012` - [Mainline][PTCM] [ConfigTool]Obsolete terms cleanup for SSRAM
|
|
- :acrn-issue:`6284` - [v2.6] vulnerable coding style in hypervisor and DM
|
|
- :acrn-issue:`6340` - [EF]Invalid LPC entry prevents GOP driver from working properly in WaaG for DP3
|
|
- :acrn-issue:`6342` - [v2.6] vulnerable coding style in config tool python source
|
|
- :acrn-issue:`6360` - ACRN Makefile missing dependencies
|
|
- :acrn-issue:`6366` - TPM pass-thru shall be able to support start method 6, not only support Start Method of 7
|
|
- :acrn-issue:`6388` - [hypercube][tgl][ADL]AddressSanitizer: SEGV virtio_console
|
|
- :acrn-issue:`6389` - [hv ivshmem] map SHM BAR with PAT ignored
|
|
- :acrn-issue:`6405` - [ADL-S][Industry][Yocto] WaaG BSOD in startup when run reboot or create/destroy stability test.
|
|
- :acrn-issue:`6417` - ACRN ConfigTool improvement from DX view
|
|
- :acrn-issue:`6423` - ACPI NVS region might not be mapped on prelaunched-VM
|
|
- :acrn-issue:`6428` - [acrn-configuration-tool] Fail to generate launch script when disable CPU sharing
|
|
- :acrn-issue:`6431` - virtio_console use-after-free
|
|
- :acrn-issue:`6434` - HV panic when SOS VM boot 5.4 kernel
|
|
- :acrn-issue:`6442` - [EF]Post-launched VMs do not boot with "EFI Network" enabled
|
|
- :acrn-issue:`6461` - [config_tools] kernel load addr/entry addr should not be configurable for kernel type KERNEL_ELF
|
|
- :acrn-issue:`6473` - [HV]HV can't be used after dumpreg rtvm vcpu
|
|
- :acrn-issue:`6476` - [hypercube][TGL][ADL]pci_xhci_insert_event SEGV on read from NULL
|
|
- :acrn-issue:`6481` - ACRN on QEMU can't boot up with v2.6 branch
|
|
- :acrn-issue:`6482` - [ADL-S][RTVM]rtvm poweroff causes sos to crash
|
|
- :acrn-issue:`6502` - [ADL][HV][UC lock] SoS kernel panic when #GP for UC lock enabled
|
|
- :acrn-issue:`6507` - [TGL][HV][hybrid] during boot zephyr64.elf find HV error: "Unable to copy HPA 0x100000 to GPA 0x7fe00000 in VM0"
|
|
- :acrn-issue:`6508` - [HV]Refine pass-thru device PIO BAR handling
|
|
- :acrn-issue:`6510` - [ICX-RVP][SSRAM] No SSRAM entries in guest PTCT
|
|
- :acrn-issue:`6518` - [hypercube][ADL]acrn-dm program crash during hypercube testing
|
|
- :acrn-issue:`6528` - [TGL][HV][hybrid_rt] dmidecode Fail on pre-launched RTVM
|
|
- :acrn-issue:`6530` - [ADL-S][EHL][Hybrid]Path of sos rootfs in hybrid.xml is wrong
|
|
- :acrn-issue:`6533` - [hypercube][tgl][ADL] mem leak while poweroff in guest
|
|
- :acrn-issue:`6592` - [doc] failed to make hvdiffconfig
|
|
|
|
Known Issues
|
|
************
|
|
|
|
- :acrn-issue:`6630` - Fail to enable 7 PCI based VUART on 5.10.56 RTVM
|
|
- :acrn-issue:`6631` - [KATA][5.10 Kernel]failed to start docker with Service VM 5.10 kernel
|
|
|