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

doc: reference old release notes in archived release docs

Browse Source 
Instead of trying to maintain the release notes for old releases in the
current release, reference them in a previous archive.  This eliminates
the need to fix doc build errors by editing old release notes that
reference material that no longer exists in the newer release.

We use the intersphinx extension to support references to
Sphinx-generated content from other projects.  In our case, we're
referencing the archived version of v2.7 documents that was the last
release to generate release notes for all previous releases. This import
is done in conf.py.

(Alternatively we could reference the release notes for a release in
that specific release's archive, but that means fetchind the intersphinx
inventory file (objects.inv) for every release, and seems like
overkill.)

This modification still allows putting multiple release notes in the
doc/release_notes folder and they'll show up in the release notes index
as they have in the past.  Update the separate "archived" release notes
section manually as needed.

Also, adds a draft of the v3.0 release notes to verify the new release
notes index page layout.

Fixes: #7171

Tracked-On: #7171

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
David B. Kinder 2022-04-02 13:53:07 -07:00 committed by David Kinder
parent 0494017f89
commit 8b0d1e45b9
30 changed files with 137 additions and 9665 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
doc/conf.py
View File

@ -39,7 +39,7 @@ if "RELEASE" in os.environ:
sys.path.insert(0, os.path.join(os.path.abspath('.'), 'extensions'))
extensions = [
'breathe', 'sphinx.ext.graphviz', 'sphinx.ext.extlinks',
'eager_only', 'html_redirects', 'link_roles',
'eager_only', 'html_redirects', 'link_roles','sphinx.ext.intersphinx',
'sphinx_tabs.tabs', 'last_updated'
]
@ -49,6 +49,12 @@ extlinks = {'acrn-commit': ('https://github.com/projectacrn/acrn-hypervisor/comm
'acrn-issue': ('https://github.com/projectacrn/acrn-hypervisor/issues/%s', '')
}
# use intersphinx linking to link to previous version release notes
# (We only need to link to an archive that has the older release notes)
intersphinx_mapping = {
'v2.7': ('https://projectacrn.github.io/2.7', None),
}
graphviz_output_format='png'
graphviz_dot_args=[

55
doc/release_notes/index.rst
View File

@ -3,14 +3,15 @@
Release Notes
#############
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline
embedded development through an open source platform. Check out the
:ref:`introduction` for more information.
ACRN is a flexible, lightweight reference hypervisor, built with real-time and
safety-criticality in mind, optimized to streamline embedded development through
an open source platform. Check out the :ref:`introduction` for more information.
The project ACRN reference code can be found on GitHub in
https://github.com/projectacrn. It includes the ACRN hypervisor, the
ACRN Device Model, and documentation.
https://github.com/projectacrn. It includes the ACRN hypervisor, the ACRN
Device Model, and documentation.
.. comment Maintain current release notes in the master branch/latest docs
.. rst-class:: rst-columns
@ -20,3 +21,45 @@ ACRN Device Model, and documentation.
:reversed:
release_notes_*
Release Notes Archive
*********************
Release notes for previous releases are available in the project documentation
archives:
.. comment Maintain this list of archived release notes manually as needed. As
configured in conf.py, these documents are found in the v2.7 documentation using
the intersphinx extension. (That was the last release where we generated
all the previous release notes in one place.)
.. rst-class:: rst-columns
- :ref:`release_notes_2.7`
- :ref:`release_notes_2.6`
- :ref:`release_notes_2.5`
- :ref:`release_notes_2.5.1`
- :ref:`release_notes_2.4`
- :ref:`release_notes_2.3`
- :ref:`release_notes_2.2`
- :ref:`release_notes_2.1`
- :ref:`release_notes_2.0`
- :ref:`release_notes_1.6`
- :ref:`release_notes_1.6.1`
- :ref:`release_notes_1.5`
- :ref:`release_notes_1.4`
- :ref:`release_notes_1.3`
- :ref:`release_notes_1.2`
- :ref:`release_notes_1.1`
- :ref:`release_notes_1.0`
- :ref:`release_notes_1.0.1`
- :ref:`release_notes_1.0.2`
- :ref:`release_notes_0.8`
- :ref:`release_notes_0.7`
- :ref:`release_notes_0.6`
- :ref:`release_notes_0.5`
- :ref:`release_notes_0.4`
- :ref:`release_notes_0.3`
- :ref:`release_notes_0.2`
- :ref:`release_notes_0.1`

1156
doc/release_notes/release_notes_0.1.rst
View File

File diff suppressed because it is too large Load Diff

817
doc/release_notes/release_notes_0.2.rst
View File

@ -1,817 +0,0 @@
.. _release_notes_0.2:
ACRN v0.2 (Sep 2018)
####################
We are pleased to announce the release of Project ACRN version 0.2.
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline
embedded development through an open source platform. Check out the
:ref:`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, and documentation.
You can either download this source code as a zip or tar.gz file (see
the `ACRN v0.2 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v0.2>`_ or
use Git clone and checkout commands:
.. code-block:: bash
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v0.2
The project's online technical documentation is also tagged to correspond
with a specific release: generated v0.2 documents can be found at
https://projectacrn.github.io/0.2/. Documentation for the latest
(master) branch is found at https://projectacrn.github.io/latest/.
Version 0.2 New Features
************************
VT-x, VT-d
================
Based on Intel VT-x virtualization technology, ACRN emulates a virtual
CPU with core partition and simple schedule. VT-d provides hardware
support for isolating and restricting device accesses to the owner of
the partition managing the device. It allows assigning I/O devices to a
VM, and extending the protection and isolation properties of VMs for I/O
operations.
PIC/IOAPIC/MSI/MSI-X/PCI/LAPIC
================================
ACRN hypervisor supports virtualized APIC-V/EPT/IOAPIC/LAPIC
functionality.
Ethernet
================
ACRN hypervisor supports virtualized Ethernet functionality. Ethernet
Mediator is executed in the Service OS and provides packet forwarding
between the physical networking devices (Ethernet, Wi-Fi, etc.) and
virtual devices in the Guest VMs(also called "User OS"). Virtual
Ethernet device could be shared by Linux, Android, and Service OS guests
for regular (i.e. non-AVB) traffic. All hypervisor para-virtualized I/O
is implemented using the VirtIO specification Ethernet pass-through.
Storage (eMMC)
================
ACRN hypervisor supports virtualized non-volatile R/W storage for the
Service OS and Guest OS instances, supporting VM private storage and/or
storage shared between Guest OS instances.
USB (xDCI)
================
ACRN hypervisor supports virtualized assignment of all USB xHCI and/or
xDCI controllers to a Guest OS from the platform.
USB Mediator (xHCI and DRD)
===========================
ACRN hypervisor supports a virtualized USB Mediator.
CSME
================
ACRN hypervisor supports a CSME to a single Linux, Android, or RTOS
guest or the Service OS even when in a virtualized environment.
WiFi
================
ACRN hypervisor supports the passthrough assignment of the WiFi
subsystem to the IVI, enables control of the WiFi as an in-vehicle
hotspot for 3rd party devices, provides 3rd party device applications
access to the vehicle, and provides access of 3rd party devices to the
TCU provided connectivity.
IPU (MIPI-CS2, HDMI-In)
========================
ACRN hypervisor supports passthrough IPU assignment to Service OS or
guest OS, without sharing.
Bluetooth
================
ACRN hypervisor supports bluetooth controller passthrough to a single
Guest OS (IVI).
GPU - Preemption
==================
GPU Preemption is one typical automotive use case which requires the
system to preempt GPU resources occupied by lower priority workloads.
This is done to ensure performance of the most critical workload can be
achieved. Three different schedulers for the GPU are involved: i915 UOS
scheduler, Mediator GVT scheduler, and i915 SOS scheduler.
GPU - Display Surface Sharing via Hyper DMA
============================================
Surface sharing is one typical automotive use case which requires
that the SOS accesses an individual surface or a set of surfaces
from the UOS without having to access the entire frame buffer of
the UOS. Hyper DMA Buffer sharing extends the Linux DMA buffer
sharing mechanism where one driver is able to share its pages
with another driver within one domain.
S3
================
ACRN hypervisor supports S3 feature, partially enabled in LaaG.
Fixed Issues
************
* :acrn-issue:`663` - Black screen displayed after booting SOS/UOS
* :acrn-issue:`676` - Hypervisor and DM version numbers incorrect
* :acrn-issue:`1126` - VPCI coding style and bugs fixes for partition mode
* :acrn-issue:`1125` - VPCI coding style and bugs fixes found in integration testing for partition mode
* :acrn-issue:`1101` - missing acrn_mngr.h
* :acrn-issue:`1071` - hypervisor cannot boot on skylake i5-6500
* :acrn-issue:`1003` - CPU: cpu info is not correct
* :acrn-issue:`971` - acrncrashlog functions need to be enhance
* :acrn-issue:`843` - ACRN boot failure
* :acrn-issue:`721` - DM for IPU mediation
* :acrn-issue:`707` - Issues found with instructions for using Ubuntu as SOS
* :acrn-issue:`706` - Invisible mouse cursor in UOS
* :acrn-issue:`424` - Clear Linux OS desktop GUI of SOS fails to launch
Known Issues
************
:acrn-issue:`677` - SSD Disk ID not consistent between SOS/UOS
The SSD disk ID in the UOS is not the same as in the SOS when the SSD
device is passed-through to the UOS (it should be). The ID is also
changing after a reboot (it shouldn't). **Impact:** There is no impact
to functionality. **Workaround:** None. The issues will be fixed in the
next release.
:acrn-issue:`1268` - GPU hangs when running GfxBench Car Chase in SOS and UOS.
A "GPU HANG" log messages is printed in the dmesg log in SOS and UOS and
is fails to load GfxBench Car Chase animation in HDMI and VGA monitors.
**Impact:** Car Chase may stop running after the GPU hangs, but does not
block other Gfx apps. **Workaround:** None. The issue will be fixed in
the next release.
:acrn-issue:`1270` - SOS and UOS play video but don't display video animation output on monitor.
Video does not display in SOS and UOS. Animation is not displayed with
the running timer. **Impact:** There is no video animation on monitor
screen when playing video in SOS or UOS. **Workaround:** None. The
issue will be fixed in the next release.
:acrn-issue:`1319` - SD card pass-through: UOS can't see SD card after UOS reboot.
SD card could not be found after UOS reboot in pass-through mode.
**Impact:** There is no SD card after UOS reboot.
**Workaround:** None. The issue will be fixed in the next release.
.. comment
Use the syntax:
:acrn-issue:`663` - Short issue description
Longer description that helps explain the problem from the user's
point of view (not internal reasons). **Impact:** What's the
consequences of the issue, and how it can affect the user or system.
**Workaround:** Describe a workaround if one exists (or refer them to the
:acrn-issue:`663`` if described well there. If no workaround, say
"none".
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v0.1
release in July 2018 (click on the CommitID link to see details):
.. comment
This list is obtained from the command:
git log --pretty=format:'- :acrn-commit:`%h` %s' --after="2018-03-01"
- :acrn-commit:`7dd3207` doc: fix typo in network virt hld
- :acrn-commit:`01ce3b6` doc: sort title in developer HLD section
- :acrn-commit:`dae98a0` doc: add network virtualization hld
- :acrn-commit:`55a71e4` doc: add watchdog high-level design
- :acrn-commit:`31285a9` doc: add security hld document
- :acrn-commit:`8c9e0d1` hv: init_iommu rework to enable IOMMU for partition mode ACRN
- :acrn-commit:`5373190` dm: passthru: enable NHLT table for audio passthru
- :acrn-commit:`33acca5` tools: acrn-crashlog: exclude crashlog tool for release version
- :acrn-commit:`9817eb3` Add a comment for switch fallthrough to quiet lint warning
- :acrn-commit:`0306bb4` Removed dead funcs in EFI stub module
- :acrn-commit:`1d15b98` Replace the call to emalloc() to uefi pool allocation
- :acrn-commit:`951a24c` allocate boot related struct right after hypervisor memory
- :acrn-commit:`6085781` Replace __emalloc() with a call to uefi allocate_page()
- :acrn-commit:`fea102e` Remove emalloc_for_low_mem() routine in EFI boot code of HV
- :acrn-commit:`ccf5624` hv:irq: avoid out-of-range access to irq_alloc_bitmap[]
- :acrn-commit:`4a038d1` dm: workaround for DM crash when doing fastboot reboot
- :acrn-commit:`688cdda` DM USB: xHCI: enable USB xHCI emulation in LaaG and AaaG.
- :acrn-commit:`d4afddc` Revert "hv: init_iommu rework to enable IOMMU for partition mode ACRN"
- :acrn-commit:`40dfd3f` doc: edit 0.2 release notes
- :acrn-commit:`737c29f` doc: Add known issues in v0.2 release note.
- :acrn-commit:`994a375` HV:fix potential buffer overflow issues
- :acrn-commit:`b501ce4` HV: remove dead APIC info MACROs in bsp
- :acrn-commit:`2197f43` HV: Add acpi_fixup api to override acpi on needs
- :acrn-commit:`0d5ad8a` HV: add simple parser for ACPI data table
- :acrn-commit:`a1e9fdc` HV: add Kconfig of CONSTANT_ACPI
- :acrn-commit:`eb8c4fb` hv:Fix Implicit conversion:actual to formal param
- :acrn-commit:`8f0cb56` HV: trusty: refine version checking when initializing trusty
- :acrn-commit:`9d60220` hv: remove unused MACROs
- :acrn-commit:`bb0a2bc` HV:Hypercall:Remove redundant error checking
- :acrn-commit:`d8508e4` hv: init_iommu rework to enable IOMMU for partition mode ACRN
- :acrn-commit:`2af08d9` HV: refine 'struct lapic_regs' definition.
- :acrn-commit:`5329ced` hv: vtd: fix potential buffer overflow in suspend/resume
- :acrn-commit:`f355cdf` Revert "DM USB: xHCI: enable USB xHCI emulation in LaaG and AaaG."
- :acrn-commit:`83d1ddc` hv:Delete the dead code
- :acrn-commit:`c307e1b` hv: long and long long is same for printf within x86_64
- :acrn-commit:`a47f5d4` doc: fix Makefile to address multiple publishers
- :acrn-commit:`41a1714` doc: fix spaces in release notes
- :acrn-commit:`3c8157b` doc: Add new feature in v0.2 release note
- :acrn-commit:`c03ea2d` DM USB: xHCI: enable USB xHCI emulation in LaaG and AaaG.
- :acrn-commit:`b4755cd` DM USB: xHCI: enable 'cold plug' mode
- :acrn-commit:`612037e` DM USB: xHCI: enable Flat Mode Hub emulation support.
- :acrn-commit:`d886375` hv: clean up spinlock
- :acrn-commit:`8858634` HV: update opcode when decode_two_byte_opcode()
- :acrn-commit:`5023937` hv: merge pgtable_types.h and pgtable.h
- :acrn-commit:`83e7995` hv: clean up some header files
- :acrn-commit:`5a996ce` hv:irq: correct the size of irq_alloc_bitmap
- :acrn-commit:`4fd5102` hv:treewide:fix multiple MISRAC violations
- :acrn-commit:`00edd83` hypercall: no need check HV memory overlap for MR_DEL
- :acrn-commit:`876cc68` tools:acrn-crashlog: Change the algorithm of generating event key
- :acrn-commit:`b1ba12a` hv: clean up spinlock wrappers
- :acrn-commit:`44a2d77` hv: add SMAP/SMEP check during guest page walking
- :acrn-commit:`d958d31` hv: fix the issue of movs emulation
- :acrn-commit:`d84f7a4` hv: clean up udelay/mdelay related code
- :acrn-commit:`7cab77d` hv: clean up div related code
- :acrn-commit:`1d2ed1a` hv: vioapic/vpic: clean up spinlock wrappers
- :acrn-commit:`4f20c44` dm: passthru: fix a bug in msix read/write
- :acrn-commit:`60c05ac` hv:Replace vlapic pointer with instance in vcpu_arch
- :acrn-commit:`f744762` hv:Remove redundancy 'vlapic' in 'struct vcpu'
- :acrn-commit:`aae5018` hv:Move vlapic structure to vlapic.h
- :acrn-commit:`fdb6409` hv:Replace dynamic memory allocation for apic access address
- :acrn-commit:`887ebf0` hv: Replace dynamic memory allocation for MSR bitmap
- :acrn-commit:`02e7edc` hv: Replace dynamic memory allocation for I/O bitmaps
- :acrn-commit:`eada04b` hv:Replace dynamic memory allocation for vmcs region
- :acrn-commit:`ca75d50` IOC mediator: add RTC feature
- :acrn-commit:`42d9b24` doc: allow overriding displayed doc version
- :acrn-commit:`dbcbe7d` HV: change wake vector to accommodate abl 1820HF1release
- :acrn-commit:`bca43b5` hv: avoid memory leak in trampoline code preparing
- :acrn-commit:`9e76cf4` doc: Add fixed issues in v0.2 release note
- :acrn-commit:`f1e87f6` dm: vrtc: use signalfd to poll signal from timer
- :acrn-commit:`bcaede0` hv: treewide: fix 'Use of function like macro'
- :acrn-commit:`d72e65c` trusty: do not destroy secure world if it's not created
- :acrn-commit:`8773dfb` vlapic: unmap vlapic base only for SOS
- :acrn-commit:`457ac74` vcpu: replace start_vcpu with run_vcpu
- :acrn-commit:`2978c01` io: tiny fix for error message
- :acrn-commit:`bfcf546` Doc: add interrupt storm mitigation explanation.
- :acrn-commit:`d8c4619` HV: change wake vector info to accommodate abl
- :acrn-commit:`4ae88bb` tools: acrn-manager: fix acrnctl reset issue
- :acrn-commit:`f42209c` tools: acrn-manager: remove unnecessary "current" field
- :acrn-commit:`0ca90ba` tools: acrn-manager: rework acrnd resume flow
- :acrn-commit:`26b8b3b` tool: acrn-manager: do not wakeup SOS in advance
- :acrn-commit:`c6b7940` samples: Add AliOS as guest launch option
- :acrn-commit:`a7de5a1` samples: Add tap name as launch function parameter
- :acrn-commit:`bcfe447` DM: deinit initialized pci device when failed
- :acrn-commit:`99285f8` HV: improve pass-thru device interrupt process
- :acrn-commit:`b4e03f2` hv: virq: make irq_window_enabled useful
- :acrn-commit:`8e29615` hv: apicv: enable interrupt-window if any pending external interrupts
- :acrn-commit:`46c3276` hv: apicv: avoid enable interrupt window if interrupt delivery enabled
- :acrn-commit:`f5ca189` dm: bios: update vsbl to v0.9
- :acrn-commit:`047f4e9` Documentation: update to AcrnGT official name
- :acrn-commit:`97aeb7f` hv: pgtable: fix 'Use of function like macro'
- :acrn-commit:`6ee9321` security: Enable '-fpie -pie' options
- :acrn-commit:`5c5aed6` hv:Change several VMX APIs to void type
- :acrn-commit:`e4e38e1` hv:Check if VMX capability is locked with incorrect value
- :acrn-commit:`6593080` hv: Replace dynamic allocation with static memory for vmxon_region
- :acrn-commit:`4360235` hv: treewide: fix 'Macro parameter not in brackets'
- :acrn-commit:`30b77ab` DM: unmap ptdev BAR when deinit
- :acrn-commit:`1b334ec` hv: replace 'return' with 'panic' in bsp_boot_post
- :acrn-commit:`bad8d81` IOC mediator: add new signal for VBUS control
- :acrn-commit:`f2f719c` hv: fix 'Procedure is not called or referenced in code analyzed'
- :acrn-commit:`3718177` hv:Replace dynamic allocation with static memory for shell
- :acrn-commit:`c045442` DM: watchdog: correct 2 MACRO define
- :acrn-commit:`198c6e9` DM: coding style: replace tab with space
- :acrn-commit:`d32ef9b` doc: fix doc misspellings
- :acrn-commit:`5103002` doc: prepare for versioned release notes
- :acrn-commit:`5c3e4d1` tools: acrntrace: fix a variable uninitialized issue
- :acrn-commit:`56f2c1a` tools: acrn-crashlog: correct usercrash-wrapper path
- :acrn-commit:`6703879` hv: treewide: convert some MACROs to inline functions
- :acrn-commit:`37fd387` tools: acrn-crashlog: add usercrash_c in the pipe of core_pattern
- :acrn-commit:`a4cb391` hv: fixup format of log message in vm_load.c
- :acrn-commit:`96809c4` DM NPK: enable the NPK virtualization for AaaG
- :acrn-commit:`9a27659` DM NPK: use a slice (8 masters) as the minimal unit for NPK virt
- :acrn-commit:`d8c97c1` hv: fix broken relocation feature
- :acrn-commit:`36c4a27` HV: Fix VPCI bugs found in integration testing for partition mode
- :acrn-commit:`308910e` HV: Updated vm description table for partition mode
- :acrn-commit:`c9ea890` HV: VPCI coding style fix
- :acrn-commit:`54439ec` hv: treewide: fix 'Expression is not Boolean'
- :acrn-commit:`f611012` HV: Refine two log info about vcpu and instr_emul
- :acrn-commit:`96dba0d` hv: fix MISRA-C issues related to space or newline
- :acrn-commit:`d67eefb` hv: mmu: use get/set_pgentry to get/set page table entry
- :acrn-commit:`7f9befb` hv: ept: remove find_next_table
- :acrn-commit:`9257ecf` hv: mmu: cleanup mmu.h
- :acrn-commit:`06ab2b8` hv: mmu: add 1GB page capability check when CPU boot
- :acrn-commit:`58fffcd` hv: mmu: rename PTT_HOST to PTT_PRIMARY
- :acrn-commit:`c102c44` hv: Device MSIs in partition mode ACRN
- :acrn-commit:`ef1a730` Documentation: correct URL pointing at sample 'acrn.conf' file
- :acrn-commit:`25dacc5` security: Enable '-fpie, -pie' options
- :acrn-commit:`10c64a5` hv: fix MISRA-C issues related to for loop
- :acrn-commit:`852f613` samples: remove extra option for dm
- :acrn-commit:`dba52ba` IOC mediator: fix no CBC signals after resuming
- :acrn-commit:`43741ba` hv: Leave interrupts disabled during vmexit - ACRN partition mode
- :acrn-commit:`348422d` doc: fix graphviz scanning and processing
- :acrn-commit:`e49c42d` Documentation: update GVT-G-porting-image1.png for AcrnGT official name
- :acrn-commit:`a8ac452` dm: cmos: move cmos storage out of vmctx
- :acrn-commit:`fa7eb1f` tools:acrn-crashlog: Document of configuration file
- :acrn-commit:`12c1687` hv:No need to create inverted page tables for trusty memory
- :acrn-commit:`2a184f3` hv: code clean up regarding to guest_msrs
- :acrn-commit:`947e86d` HV: restore correct gpa for guest normal world
- :acrn-commit:`da4c95b` tools: acrn-manager: fix several warnings
- :acrn-commit:`4e8798e` hv:Replace vioapic pointer with instance in structure vm
- :acrn-commit:`29dbd10` hv:Replace vuart pointer with instance in structure vm
- :acrn-commit:`0b54946` hv:Replace vpic pointer with instance in structure vm
- :acrn-commit:`de53964` HV: Removed the unused parameters and union from gdt
- :acrn-commit:`8d35f4e` HV: wrap and enable hkdf_sha256 key derivation based on mbedtls
- :acrn-commit:`12aa2a4` HV: crypto lib code clean up
- :acrn-commit:`71577f6` HV: extract hkdf key derivation files from mbedtls
- :acrn-commit:`925503c` hv: Build fix - ACRN partition mode
- :acrn-commit:`c5dcb34` DM USB: xHCI: fix a potential issue of crash
- :acrn-commit:`7bc1a3f` HV: Refine APICv capabilities detection
- :acrn-commit:`f95d07d` hv: vtd: use EPT as translation table for PTDev in SOS
- :acrn-commit:`4579e57` hv: add gva check for the case gva is from instruction decode
- :acrn-commit:`7dde0df` hv: add GVA validation for MOVS
- :acrn-commit:`b01a812` hv: add new function to get gva for MOVS/STO instruction
- :acrn-commit:`8480c98` hv: move check out of vie_calculate_gla
- :acrn-commit:`54c2541` hv: remove unnecessary check for gva
- :acrn-commit:`5663dd7` hv: extend the decode_modrm
- :acrn-commit:`3b6ccf0` HV: remove callbacks registration for APICv functions
- :acrn-commit:`93c1b07` hv: mmu: remove old map_mem
- :acrn-commit:`f3b825d` hv: trusty: use ept_add_mr to add memory region
- :acrn-commit:`4bb8456` hv: ept: refine ept_add_mr base on mmu_add
- :acrn-commit:`da57284` hv: ptdev: simplify struct ptdev_msi_info
- :acrn-commit:`2371839` hv: ptdev: remove vector index from structure ptdev_msi_info
- :acrn-commit:`d8cc29b` hv: ptdev: check whether phys_pin is valid in add_intx_remapping
- :acrn-commit:`e8c0763` hv: ptdev: add source_id for ptdev to identify source
- :acrn-commit:`6367650` hv: debug: add the hypervisor NPK log
- :acrn-commit:`3c6df9b` hv: add mmio functions for 64bit values
- :acrn-commit:`dcae438` hv: add a hypercall for the hypervisor NPK log
- :acrn-commit:`f4eef97` hv: ptdev: simplify ptdev_intx_pin_remap logic
- :acrn-commit:`a6c2065` hv: apicv: change the name of vapic to apicv
- :acrn-commit:`a0c625b` hv: apicv: change the apicv related API with vlapic_apicv prefix
- :acrn-commit:`74ff712` hv: vlapic: local APIC ID related code cleaning up
- :acrn-commit:`c43d0e4` hv:Changed several APIs to void type
- :acrn-commit:`b75a7df` hv: vcpuid: disable some features in cpuid
- :acrn-commit:`42aaf5d` hv: code clean up regarding to % and / operations
- :acrn-commit:`0c630d9` dm: cmos: fix a logic error for read to clear range
- :acrn-commit:`3e598eb` hv: fix 'No definition in system for prototyped procedure'
- :acrn-commit:`65e01a0` hv: pirq: use a bitmap to maintain irq use status
- :acrn-commit:`e0d40fe` HV:refine 'apic_page' & 'pir_desc' in 'struct acrn_vlapic'
- :acrn-commit:`17ef507` ipu: virtio-ipu4 as default IPU DM
- :acrn-commit:`8924f6d` hv: vmx: fix 'Array has no bounds specified'
- :acrn-commit:`6988a17` DM USB: xHCI: Change the default USB xHCI support to pass through.
- :acrn-commit:`1017d91` hv: treewide: fix 'Empty parameter list to procedure/function'
- :acrn-commit:`7a4dcfc` hv: treewide: fix 'Function prototype/defn param type mismatch'
- :acrn-commit:`752e311` hv:fixed MISRA-C return value violations
- :acrn-commit:`431ef57` hv: vioapic: fix 'No definition in system for prototyped procedure'
- :acrn-commit:`b17de6a` hv: Support HV console for multiple VMs - ACRN partition mode
- :acrn-commit:`b8c1fd6` dm: pass vrpmb key via cmos interface
- :acrn-commit:`c8c0e10` HV: enlarge the CMA size for uos trusty
- :acrn-commit:`40fd889` hv:fixed several return value violations
- :acrn-commit:`b37008d` HV: check secure/normal world for EPTP in gpa2hpa
- :acrn-commit:`10a4c6c` samples: let nuc uos only start with 1 cpu
- :acrn-commit:`709cd57` hv: lib: add ffz64_ex
- :acrn-commit:`5381738` hv: pirq: change the order of functions within irq.c
- :acrn-commit:`a8cd692` hv: pirq: clean up irq handlers
- :acrn-commit:`2c044e0` hv: pirq: refactor vector allocation/free
- :acrn-commit:`1bf2fc3` hv: pirq: refactor irq num alloc/free
- :acrn-commit:`f77d885` hv: pirq: clean up unnecessary fields of irq_desc
- :acrn-commit:`bdcc3ae` hv: fixed compiling warning
- :acrn-commit:`40745d9` hv: vuart: fix the data type violations
- :acrn-commit:`d82a86e` DM USB: xHCI: enable USB xHCI emulation in LaaG and AaaG.
- :acrn-commit:`150b389` hv: fix size issue in mptable guest copy - ACRN partition mode
- :acrn-commit:`0c93a13` hv: sw_loader for VMs in ACRN partition mode
- :acrn-commit:`fce5862` hv: vm_description fix for partition ACRN
- :acrn-commit:`38a1898` hv: Fix comments referring to wrong hypervisor name
- :acrn-commit:`d3db5a6` HV: Add const qualifiers where required
- :acrn-commit:`e280d95` hv: vmx_vapic: fix two build warnings
- :acrn-commit:`39b4fec` hv: apicv: explicit log for SMI IPI unsupported
- :acrn-commit:`604b5a4` hv: apicv: remove APIC_OFFSET_SELF_IPI(0x3F0) register
- :acrn-commit:`93f9126` hv: apicv: remove x2apic related code
- :acrn-commit:`8d38318` hv: virq: disable interrupt-window exiting in vmexit handler
- :acrn-commit:`f4513f9` update to fix format issue of ReST
- :acrn-commit:`5a6ee3f` update doc -Using Ubuntu as the Service OS
- :acrn-commit:`4ecbdf0` tools: acrn-crashlog: update core_pattern content conditionally
- :acrn-commit:`8ff0efc` update user name cl_sos
- :acrn-commit:`99e8997` DM: Add boot option of "i915.enable_guc=0" to disable Guc on UOS new kernel
- :acrn-commit:`36d5fdb` DM/Samples: Add the boot option of "i915.enable_guc=0" to disable guc on SOS new kernel
- :acrn-commit:`5b8c7a5` hv: VM BSP vcpu mode for ACRN partition mode
- :acrn-commit:`c234acb` fix spec_ctrl msr save/restore
- :acrn-commit:`022ef92` hv: Add vrtc emulation support for ACRN partition mode
- :acrn-commit:`f63c7a7` dm: virtio: set VBS-K status to VIRTIO_DEV_INIT_SUCCESS after reset
- :acrn-commit:`1378a84` dm: virtio: add support for VBS-K device reset
- :acrn-commit:`16a8174` hv: vioapic: bug fix update PTDEV RTE
- :acrn-commit:`101ab60` hv: Build fix for Partition mode
- :acrn-commit:`d030595` HV: remove 'spinlock_rfags' declaration
- :acrn-commit:`932bc32` DM: virtio rpmb backend driver updates
- :acrn-commit:`3df3c9f` hv: vuart: fix 'Shifting value too far'
- :acrn-commit:`de487ff` hv:fix return value violations for vpic/vioapic
- :acrn-commit:`cad8492` enable weston to fix: #663
- :acrn-commit:`f2a3e1f` quick fix: fix build failure for release version
- :acrn-commit:`bb5377b` HV: change wake vector info to accommodate ww32 sbl
- :acrn-commit:`f8f49d4` dump vcpu registers on correct vcpu
- :acrn-commit:`4b03c97` add smp_call_function support
- :acrn-commit:`8ef0721` idle: enable IRQ in default idle
- :acrn-commit:`e19d36f` change pcpu_sync_sleep to wait_sync_change
- :acrn-commit:`49d3446` lapic: add send_dest_ipi function
- :acrn-commit:`6e96243` HV: io: drop REQ_STATE_FAILED
- :acrn-commit:`ca83c09` hv: treewide: fix multiple MISRAC violations
- :acrn-commit:`0292e14` DM USB: xHCI: enable xHCI SOS S3 support
- :acrn-commit:`0b405ee` DM USB: xHCI: change flow of creation of virtual USB device
- :acrn-commit:`b359dc3` DM USB: xHCI: code cleanup: change variable name
- :acrn-commit:`27eeea4` DM USB: xHCI: refine port assignment logic
- :acrn-commit:`5cc389a` DM USB: xHCI: limit bus and port numbers of xHCI
- :acrn-commit:`2abec44` DM USB: introduce struct usb_native_devinfo
- :acrn-commit:`363b4da` DM USB: xHCI: refine xHCI PORTSC Register related functions
- :acrn-commit:`b746377` DM USB: xHCI: fix an xHCI issue to enable UOS s3 feature
- :acrn-commit:`b5a233d` HV: Enclose debug specific code with #ifdef HV_DEBUG
- :acrn-commit:`b086162` dm: monitor: bugfix: update wakeup reason before call resume() callback
- :acrn-commit:`a86a25f` tools: acrnd: Fixed get_sos_wakeup_reason()
- :acrn-commit:`2d802d0` tools: vm_resume() requires wakeup reason
- :acrn-commit:`64a9b2b` Revert "[REVERT-ME]: disable turbo mode"
- :acrn-commit:`18d44cc` tools: acrnalyze: Make the result easier to read
- :acrn-commit:`08dd698` hv: pirq: rename common irq APIs
- :acrn-commit:`8fda0d8` hv: pirq: add static irq:vector mappings
- :acrn-commit:`f6e45c9` hv: pirq: remove unnecessary dev_handler_node struct
- :acrn-commit:`d773df9` hv: pirq: remove support of physical irq sharing
- :acrn-commit:`6744a17` hv: treewide: fix 'Shifting value too far'
- :acrn-commit:`a9151ff` hv: add compile time assert for static checks
- :acrn-commit:`69522dc` hv: move boot_ctx offset definitions
- :acrn-commit:`197706f` HV: Use the CPUID(0x16) to obtain tsc_hz when zero tsc_hz is returned by 0x15 cpuid
- :acrn-commit:`7d83abb` HV: Add the emulation of CPUID with 0x16 leaf
- :acrn-commit:`e0eeb8a` HV: Limit the CPUID with >= 0x15 leaf
- :acrn-commit:`d5d3d2d` tools: acrnlog: Add [-t interval] [-h] to usage
- :acrn-commit:`a9a2f91` tools: acrntrace: Remove unused parameters "-r" related things
- :acrn-commit:`76e43ac` HV: handle trusty on vm reset
- :acrn-commit:`c55b696` HV: remove 'warm_reboot()'function and other minor cleanup
- :acrn-commit:`77011ce` HV: Merge hypervisor debug header files
- :acrn-commit:`a6bc36f` HV: refine shell.c & shell_priv.h
- :acrn-commit:`28c8923` HV: rename 'shell_internal.h' to 'shell_priv.h'
- :acrn-commit:`2fbf707` HV: Logical conjunction needs brackets
- :acrn-commit:`6f1c5fa` HV: Logical conjunction needs brackets under /arch/x86/guest
- :acrn-commit:`7a739cc` DM: Add dm for IPU mediation
- :acrn-commit:`a568c9e` dm: bios: update vsbl to v0.8.1
- :acrn-commit:`5a559ce` fixed cpu info incorrect and remove 2M hugepages
- :acrn-commit:`f11b263` remove 2M hugepages
- :acrn-commit:`462284f` HV: add pcpu id check before send IPI
- :acrn-commit:`c25a62e` hv: Create E820 entries for OS in partitioning mode ACRN
- :acrn-commit:`ab29614` HV: VMX reshuffle: put EPT check before enabling
- :acrn-commit:`112b4ea` hv: Fixing build issue with PARTITION_MODE
- :acrn-commit:`7380c16` hv: Add vuart flag to VM descriptions in partition mode
- :acrn-commit:`9e02ef5` hv: Partition mode ACRN -kernel load and bootargs load address
- :acrn-commit:`4e99afc` hv: treewide: fix 'Empty parameter list to procedure/function'
- :acrn-commit:`fc2701d` HV: move vioapic.c & vpic.c to 'dm' folder
- :acrn-commit:`8348800` dm: virtio_rnd: use delayed blocking IO to make virtio_rnd works on Linux based SOS
- :acrn-commit:`98aa74b` hv: treewide: fix 'No default case in switch statement'
- :acrn-commit:`2a65681` misc: totally remove misc folder
- :acrn-commit:`49322ac` dm: storage: support cache mode toggling
- :acrn-commit:`f4fcf5d` dm: virtio: remove hv_caps from virtio_ops
- :acrn-commit:`a2b2991` doc: update virtio-blk usage in HLD
- :acrn-commit:`2592ea8` dm: storage: support writethru and writeback mode
- :acrn-commit:`42cabf6` hv: Handling IO exits in ACRN for partition mode
- :acrn-commit:`a8fcc0f` HV: Add vm_id entry to VM description in partitioning mode
- :acrn-commit:`d0e9f24` hv: Interrupt handling in ACRN partition mode
- :acrn-commit:`0c88f9b` hv: Build mptable for OS in partition mode
- :acrn-commit:`e40b998` hv: Add EPT mapping for UOS in partitioning mode
- :acrn-commit:`c492a14` hv: pirq: do not indicate priority when allocate vector
- :acrn-commit:`229bf32` hv:Refine destroy_secure_world API
- :acrn-commit:`40196d1` hv: treewide: fix 'inline function should be declared static'
- :acrn-commit:`cdd19dc` hv: treewide: fix 'Variable should be declared static'
- :acrn-commit:`183ca5d` HV: Adding hostbridge vdev device support for partition hypervisor
- :acrn-commit:`181de19` HV: Adding passthru vdev device support for partition hypervisor
- :acrn-commit:`5f3ea06` HV: Implementing PCI CFG vm-exit handler for partition hypervisor
- :acrn-commit:`86180bd` HV: Calling into VPCI init/unit functions for partition hypervisor
- :acrn-commit:`65bd038` HV: Compiling in VCPI code for partition hypervisor
- :acrn-commit:`f60fcb6` HV: Defining the per-vm static vpci table for partition hypervisor
- :acrn-commit:`2b22e88` hv: init: rm the code of creating guest init page table
- :acrn-commit:`33e1149` hv: init: unify init logic for vm0 bsp
- :acrn-commit:`4acce93` hv: move save_segment/load_segment to a header file
- :acrn-commit:`43db87c` hv: rename acrn_efi.h to vm0_boot.h
- :acrn-commit:`adddf51` hv: move define of struct cpu_gp_regs to a separate headfile
- :acrn-commit:`5a5b2a1` hv: init: save boot context from bootloader/bios
- :acrn-commit:`ac39b90` DM: update GSI sharing info
- :acrn-commit:`2fc3bde` HV: trusty: new hypercall to save/restore context of secure world
- :acrn-commit:`3225b16` HV: trusty: log printing cleanup
- :acrn-commit:`9ba14da` HV: trusty: remove unused HC ID
- :acrn-commit:`b5b769f` HV: trusty: refine secure_world_control
- :acrn-commit:`ff96453` hv: Boot multiple OS for Partitioning mode ACRN
- :acrn-commit:`5e32c02` tools:acrn-crashlog: Enhance some functions
- :acrn-commit:`10f0bb0` hv: remove push/pop instruction emulation.
- :acrn-commit:`fa9fec5` hv: inject invalid opcode if decode instruction fails
- :acrn-commit:`1a00d6c` hv: add more exception injection API
- :acrn-commit:`96e99e3` hv: use more reliable method to get guest DPL.
- :acrn-commit:`63fe48c` hv: get correct fault address for copy_to/from_gva
- :acrn-commit:`55105db` DM: notify VHM request complete after pausing the VM
- :acrn-commit:`4753da4` doc: add interrupt high-level design doc
- :acrn-commit:`11c209e` DM: add tag info while no repo in release
- :acrn-commit:`8af90e0` misc: Remove unnecessary ExecStop in systemd services
- :acrn-commit:`4106fad` hv: treewide: fix 'Switch empty default has no comment'
- :acrn-commit:`af7943c` DM: check more in guest service & launch script
- :acrn-commit:`04b4c91` hv: Adding a wrapper on top of prepare_vm0
- :acrn-commit:`638d714` DM: adapt to the new VHM request state transitions
- :acrn-commit:`ea13758` DM: add wrappers to gcc built-in atomic operations
- :acrn-commit:`c0544c9` hv: treewide: fix 'Potential side effect problem in expression'
- :acrn-commit:`b1612e3` add cpu_do_idle to handle idle
- :acrn-commit:`b78aa34` HV: instr_emul: Make vm_update_register/rflags as void
- :acrn-commit:`12726db` HV: instr_emul: Make vie_read/write_bytereg as non-failed function
- :acrn-commit:`59c0f35` HV: instr_emul: Make vm_set/get_register as non-failed function
- :acrn-commit:`b6b7e75` HV: instr_emul: Make vm_get_seg_desc a void function
- :acrn-commit:`e625bd7` HV: vmx code clean up
- :acrn-commit:`820b5e4` HV: instr_emul: Remove dead code
- :acrn-commit:`f03ae8d` HV: instr_emul: Rearrange logic of instr_emul*
- :acrn-commit:`ce79d3a` HV: instr_emul: Handle error gracefully
- :acrn-commit:`8836abe` HV: instr_emul: Unify params passing to emulate_xxx
- :acrn-commit:`cebc8d9` DM USB: xHCI: Refine drd code to fix a potential NULL pointer issue.
- :acrn-commit:`7109ab4` hv:removed assert in free_ept_mem
- :acrn-commit:`a5121e9` dm: uart: add state check of backend tty before uart_closetty
- :acrn-commit:`fe51acf` Revert "[REVERT-ME]:handle discontinuous hpa for trusty"
- :acrn-commit:`63ef123` move global x2apic_enabled into arch dir
- :acrn-commit:`72f9c9a` pm: use cpu_context for s3 save/restore
- :acrn-commit:`8a95b2a` vcpu: add ext context support for world switch
- :acrn-commit:`3d5d6c9` vcpu: add get/set register APIs
- :acrn-commit:`5aa1ad3` HV:treewide:fix value outside range of underlying type
- :acrn-commit:`c663267` hv: timer: request timer irq once only
- :acrn-commit:`b4a2ff5` hv: treewide: fix 'Prototype and definition name mismatch'
- :acrn-commit:`f42878e` hv: apicv: improve the default apicv reset flow
- :acrn-commit:`6e86d48` hv: vioapic: set remote IRR to zero once trigger mode switch to edge
- :acrn-commit:`1e18867` hv: vioapic: remove EOI register support
- :acrn-commit:`f96f048` hv: vioapic: change the variable type of pin to uint32_t
- :acrn-commit:`b13882f` hv: vioapic: improve the vioapic reset flow
- :acrn-commit:`86de47b` hv: vioapic: correct the ioapic id mask
- :acrn-commit:`68cbdb3` hv: vioapic: avoid deliver unnecessary interrupt for level trigger
- :acrn-commit:`771c6db` hv: vioapic: refine vioapic_mmio_rw function
- :acrn-commit:`f0d2291` hv: vioapic: check vector prior to irr in EOI write emulation
- :acrn-commit:`fc41629` hv: vioapic: refine vioapic mmio access related code
- :acrn-commit:`66814d8` tools: fix resuming vm issue in acrnctl
- :acrn-commit:`7b34ae8` tools: fix resuming vm issue in acrnd
- :acrn-commit:`6cd6e3d` tools: fix an issue acrnd does not notify the vm stop state to cbc lifecycle service
- :acrn-commit:`331300d` tools: fix an invalid parameter of send_msg in query_state
- :acrn-commit:`7345677` hv:cleanup vmid related code
- :acrn-commit:`2299926` HV: Refine 'hv_main()' function usage
- :acrn-commit:`9d9c97d` doc: fix table in acrn-shell documentation
- :acrn-commit:`093f2f9` Update acrn-shell.rst
- :acrn-commit:`9689227` Update acrn-shell.rst
- :acrn-commit:`f9bf917` HV: Refine hypervisor shell commands
- :acrn-commit:`6643adf` HV: Adding mptable support for partition mode ACRN
- :acrn-commit:`fd0c918` hv: treewide: fix 'Procedure parameter has a type but no identifier'
- :acrn-commit:`c27e250` HV: instr_emul: Move op_byte from vie_op to instr_emul_vie
- :acrn-commit:`baf055e` HV: instr_emul: Using size2mask array directly
- :acrn-commit:`b6a0a36` HV: instr_emul: Remove vie_read_register
- :acrn-commit:`3702659` HV: Rename functions, variables starting with "_"
- :acrn-commit:`a71dede` hv: treewide: fix 'Array has no bounds specified'
- :acrn-commit:`a3b44a2` hv:Replace 0(cpu_id) with BOOT_CPU_ID
- :acrn-commit:`7a3d03c` dm: uart: fix acrn-dm crash issue when invoke uart_closetty function
- :acrn-commit:`8f39a22` hv: cpu: remove unnecessary cpu_id valid check
- :acrn-commit:`a98113b` HV: fully check VMCS control settings
- :acrn-commit:`ae8836d` hv:fix return value violation for vioapic_get_rte
- :acrn-commit:`cd3a62f` HV: Refine invalid parameter handling in hypervisor shell
- :acrn-commit:`61782d7` hv:Rename port/mmio read and write APIs
- :acrn-commit:`7db4c0a` DM: Add function to update PM_WAK_STS
- :acrn-commit:`a8a27d8` dm: add S3 support for UOS
- :acrn-commit:`8ee4c0b` DM: add vm_stop/reset_watchdog
- :acrn-commit:`a2241d9` DM: register pm ops to monitor
- :acrn-commit:`f576f97` hv: add vm restart API
- :acrn-commit:`a4eebb0` hv: cleanup inline assembly code in vmx.c a little bit
- :acrn-commit:`77c3917` HV:treewide:avoid using multiple # or ## in a macro
- :acrn-commit:`581a336` HV: Add Partitioning mode option for ACRN
- :acrn-commit:`93ed037` hv:cleanup console/uart code
- :acrn-commit:`22005c6` HV: Refine hypervisor shell commands
- :acrn-commit:`1664e0c` HV:fix rest integer violations
- :acrn-commit:`56904bc` doc: CSS tweak for table caption location
- :acrn-commit:`64f6295` acrn-manager: create acrn-hypervisor-dev package
- :acrn-commit:`51c75e9` hv: treewide: fix 'Function prototype/defn param type mismatch'
- :acrn-commit:`cf8fd8c` Revert "HV: clear memory region used by UOS before it exit"
- :acrn-commit:`9c24c5c` HV:Rename 'shell_internal.c' to 'shell.c'
- :acrn-commit:`3b06282` HV:Remove i/o session sw interface from hypervisor shell
- :acrn-commit:`a8e9d83` samples: change WIFI BDF to 3:0:0
- :acrn-commit:`00bfde3` HV: rename resume_vm to start_vm in hypercall api
- :acrn-commit:`5e31e7c` IOC mediator: Add parking brake and Hvac signals
- :acrn-commit:`457ecd6` hv: softirq: refine softirq
- :acrn-commit:`073583c` hv: softirq: move softirq.c to common directory
- :acrn-commit:`dec24a9` hv: add check to invalid CR8 writing from guest
- :acrn-commit:`13a50c9` hv: Explicitly trap VMXE and PCIDE bit for CR4 write
- :acrn-commit:`f0ef41c` hv: Extend the always off mask of CR0 and CR4
- :acrn-commit:`d18642a` hv: Add function to check whether cr0 written operation is valid
- :acrn-commit:`ce7257e` doc: tweak logo href to projectacrn.org
- :acrn-commit:`6d25535` doc: fix doc errors from acrn_vhm_mm.h API changes
- :acrn-commit:`014bef6` doc: add virtio-console HLD document
- :acrn-commit:`50af102` dm: bios: update vSBL binary to v0.8
- :acrn-commit:`87a4abd` tools: acrn-crashlog: fix build warnings with gcc8.1.1
- :acrn-commit:`6e77a8d` HV:treewide:rename enum vpic_wire_mode, stack_canary, segment_override, pde_index
- :acrn-commit:`52fe9f4` hv: use macro instead of specify number
- :acrn-commit:`8ed98d3` DM: fix make install issue in auto boot UOS service
- :acrn-commit:`8e2c730` HV:VLAPIC:add suffix "_fn" for function pointer
- :acrn-commit:`2c95a8c` HV:treewide:rename struct pic and iommu_domain
- :acrn-commit:`17771c0` HV: io: refine state transitions of VHM requests
- :acrn-commit:`941eb9d` HV: io: move I/O emulation post-work to io.c
- :acrn-commit:`d817951` HV: io: add post-work for PCICFG and WP requests
- :acrn-commit:`26ab2c9` HV: io: move MMIO handler registration to io.c
- :acrn-commit:`b21b172` HV: io: refactoring vmexit handler on EPT violation
- :acrn-commit:`50e4bc1` HV: io: refactoring vmexit handler on I/O instruction
- :acrn-commit:`d4d8a12` doc: tweak formatting for :kbd: role
- :acrn-commit:`9c3d77e` doc: tweak known-issues pattern for hypercall API
- :acrn-commit:`99ebd92` hv:Delete serial files
- :acrn-commit:`ae30040` hv:Reshuffle console/uart code
- :acrn-commit:`b743627` IOC mediator: fix IOC mediator blocks acrn-dm shutdown flow
- :acrn-commit:`159d57b` HV:treewide:rename union lapic_id and struct segment
- :acrn-commit:`c477211` HV:treewide:rename struct key_info, pir_desc, map_params
- :acrn-commit:`f614fcf` hv: debug: add CR4 to vcpu_dumpreg output
- :acrn-commit:`8205c9a` HV:INSTR_EMUL:Rename struct vie, vie_op, and emul_ctxt
- :acrn-commit:`3446e84` HV:treewide:rename struct timer as struct hv_timer
- :acrn-commit:`cf7a940` HV: clear memory region used by UOS before it exit
- :acrn-commit:`a2fe964` HV: Rename functions beginning with "_"
- :acrn-commit:`d40a6b9` DM: add service to support auto boot UOS
- :acrn-commit:`496e400` HV:treewide:fix rest of violations related parameter changed
- :acrn-commit:`42c77e4` Documentation: add needed library for acrnprobe
- :acrn-commit:`a4aed45` tools: acrn-crashlog: replace debugfs with api
- :acrn-commit:`ea8cb41` tools: acrn-crashlog: replace fdisk and losetup with api
- :acrn-commit:`134e79a` tools: acrn-crashlog: New apis to replace debugfs
- :acrn-commit:`db05675` tools: acrn-crashlog: New apis to replace losetup and fdisk
- :acrn-commit:`c01e675` HV:VLAPIC:rename variable vlapic_timer in the struct and function
- :acrn-commit:`59771ff` HV:treewide:fix "Reference parameter to procedure is reassigned"
- :acrn-commit:`9d4c9d7` HV: stop retrieving seed from multiboot modules
- :acrn-commit:`1b527e5` HV: parse seed through cmdline during boot stage
- :acrn-commit:`58b42ba` HV:treewide:rename struct vpic as struct acrn_vpic
- :acrn-commit:`33fdfd0` HV:treewide:rename struct vlapic as struct acrn_vlapic
- :acrn-commit:`9ea50a5` acrn.conf: remove maxcpus from cmdline
- :acrn-commit:`10ed599` HV: cleanup sprintf&string.c MISRA-C issues
- :acrn-commit:`88f74b5` HV: io: unify vhm_request req and mem_io in vcpu
- :acrn-commit:`1915eec` HV: io: separate I/O emulation interface declarations
- :acrn-commit:`3cab926` DM: add param: -V 5 to auto check/boot UOS image
- :acrn-commit:`45d6f72` HV:refine 'create_vm()' to avoid potential crash and memory leak
- :acrn-commit:`53a5941` doc: add GVT-G porting guide
- :acrn-commit:`746cbab` doc: add UART virtualization documentation
- :acrn-commit:`6c54cba` doc: cleanup css, search, version choices
- :acrn-commit:`f815415` hv: ept: add lookup_address to lookup the page table
- :acrn-commit:`e2516fa` hv: mmu: reimplement mmu_add to add page table mapping
- :acrn-commit:`c779958` hv: mmu: replace the old mmu_del
- :acrn-commit:`236bb10` hv: mmu: refine delete page table mapping
- :acrn-commit:`34c6862` hv: hypercall: add support to change guest page write permission
- :acrn-commit:`efd5ac4` hv: mmu: fix wrong to modify a large page attributes
- :acrn-commit:`5189bcd` HV:treewide:fix "Attempt to change parameter passed by value"
- :acrn-commit:`e71a088` samples: offline SOS cpus before launch uos
- :acrn-commit:`d5ead61` samples: remove maxcpus from bootargs
- :acrn-commit:`2dca23c` add hypercall hc_sos_offline_cpu support
- :acrn-commit:`589c723` add CONFIG_VM0_DESC support
- :acrn-commit:`2283378` refine definition for foreach_vcpu
- :acrn-commit:`3117870` hv:Change shell_init to void type
- :acrn-commit:`a1923dd` hv: add a missing semicolon in vmexit.c
- :acrn-commit:`6788c09` hv: bug fix on operating spin_lock
- :acrn-commit:`ff05a6e` hv:Remove dead code in console.c
- :acrn-commit:`a661ffa` fix x86 dir integer violations
- :acrn-commit:`f1b9f5a` hv: cpu: using struct cpu_gp_regs for general-purpose regs in inter_excp_ctx
- :acrn-commit:`586b527` hv: cpu: remove general-purpose register mapping in instruction emulation
- :acrn-commit:`b2802f3` hv: cpu: align general-purpose register layout with vmx
- :acrn-commit:`3d6ff0e` tools: acrntrace: save trace data file under current dir by default
- :acrn-commit:`3abfdba` doc: add script for syncing acrn-kernel for API gen
- :acrn-commit:`363a84c` DOC:GSG: Fix few mistakes about updating acrn.conf and efibootmgr options
- :acrn-commit:`f18a02a` HV: MISRA cleanup for platform acpi info
- :acrn-commit:`ee13110` HV: change wake vector address to accommodate sbl
- :acrn-commit:`4344832` Revert "DM sample: force enabling HDMI1 and HDMI2 connectors"
- :acrn-commit:`f7f04ba` hv: mmu: minor fix about hv mmu && ept modify
- :acrn-commit:`502e3e2` hv: mmu: refine set guest memory region API
- :acrn-commit:`27fbf9b` HV:treewide:Fixing pointer castings
- :acrn-commit:`a368b57` hv: fix typo in relocation code
- :acrn-commit:`b35e330` HV: make: check CONFIG_RELEASE=y for release build
- :acrn-commit:`da0f28c` HV: Bracket for the same level of precedence
- :acrn-commit:`91337da` HV: logical and high level precedence expression needs brackets
- :acrn-commit:`7aec679` HV: Clean up the unused or legacy code-like comment
- :acrn-commit:`c776137` doc: fix doc error filter patterns
- :acrn-commit:`fb8bce1` hv: treewide: fix 'Array has no bounds specified'
- :acrn-commit:`af194bc` HV: fix bug of restore rsp context
- :acrn-commit:`4fd870f` hv: efi: remove multiple defined struct efi_ctx & dt_addr_t
- :acrn-commit:`d5be735` hv: correct the way to check if a MSR is a fixed MTRR register
- :acrn-commit:`bd69799` fix assign.c integer violations
- :acrn-commit:`f0a3585` HV: common: cleanup of remaining integral-type issues
- :acrn-commit:`112b5b8` HV: guest: cleanup of remaining integral type violations
- :acrn-commit:`1a1ee93` HV: hypercall: make hypercall functions return int32_t
- :acrn-commit:`ad73bb5` HV: treewide: unify the type of bit-field members
- :acrn-commit:`c0b55cd` HV:vtd:fix all integer related violations
- :acrn-commit:`4c941ed` HV:vtd.h fixed inline function violations
- :acrn-commit:`a17653b` HV:transfer DMAR_[GS]ET_BITSLICE to inline function
- :acrn-commit:`e2ad788` doc: clean up tools docs
- :acrn-commit:`38b9b7d` HV: cpuid: Disable Intel RDT for guest OS
- :acrn-commit:`9ac1be2` DM USB: enable isochronous transfer
- :acrn-commit:`b95f939` DM USB: temporary solution for corner case of control transfer
- :acrn-commit:`3389e83` DM USB: add some BCD codes
- :acrn-commit:`b9597d4` DM USB: xHCI: add microframe index(MFINDEX) register emulation support
- :acrn-commit:`a49d483` DM USB: process LIBUSB_TRANSFER_STALL error
- :acrn-commit:`640d896` DM USB: change TRB ring processing logic for ISOC transfer
- :acrn-commit:`d24213d` DM USB: xHCI: fix xhci speed emulation logic
- :acrn-commit:`d6cc701` DM USB: refine logic of toggling interface state
- :acrn-commit:`5317124` DM USB: xHCI: add support for USB 3.0 devices
- :acrn-commit:`8317dea` DM USB: fix guest kernel short packets warning
- :acrn-commit:`7431a90` DM USB: add code for error processing
- :acrn-commit:`00fbfd6` DM USB: fix an USB endpoint reset flow issue
- :acrn-commit:`cb93887` DM USB: modify some logs to help debug
- :acrn-commit:`aecb67b` DM USB: support multiple interfaces USB device
- :acrn-commit:`38e2e45` hv: ept: move EPT PML4 table allocation to create_vm
- :acrn-commit:`1815a1b` hv: ept: store virtual address of EPT PML4 table
- :acrn-commit:`23a5c74` HV: handle integral issues as MISRA-C report
- :acrn-commit:`0252ae9` hv: treewide: fix 'No definition in system for prototyped procedure'
- :acrn-commit:`d28fff2` HV:treewide:Update the type of return value and parameters of atomic operations
- :acrn-commit:`3aa7d59` hv: check eptp value before calling free_ept_mem()
- :acrn-commit:`3571afc` HV: hypercall: revisit types in structure parameters
- :acrn-commit:`f691cab` HV: treewide: terminate 'if .. else if' constructs with 'else'
- :acrn-commit:`e13c852` HV:INSTR_EMUL: Clean up CPU_reg_name
- :acrn-commit:`f4ca3cc` hv: instr_emul: fix 'Parameter indexing array too big at call'
- :acrn-commit:`84d320d` HV:treewide:Fix type conversion in VMX, timer and MTTR module
- :acrn-commit:`f7efd0f` hv: mmu: replace modify_mem with mmu_modify
- :acrn-commit:`0a33c0d` hv: mmu: replace ept_update_mt with ept_modify_mr
- :acrn-commit:`1991823` hv: mmu: revisit mmu modify page table attributes
- :acrn-commit:`20c80ea` HV: bug fix on emulating msi message from guest
- :acrn-commit:`9695d3b` tools: replace payload[0] of struct mngr_msg with an union
- :acrn-commit:`ec86009` tools: acrn-manager: code cleanup
- :acrn-commit:`be80086` tools: Makefile: fix lack of dependence for acrm_mngr.h
- :acrn-commit:`a257f2f` HV: Fixes index out of bounds for addressing irq.
- :acrn-commit:`988a3fe` doc: use code-block:: none for command examples
- :acrn-commit:`dc6d775` tools: acrnd: update README.rst
- :acrn-commit:`0631473` [doc] Add API document for ACRN-GT
- :acrn-commit:`7e9b7f6` HV: instr_emul: Replace ASSERT/panic with pr_err
- :acrn-commit:`f912953` HV:treewide:Update exec_vmread/exec_vmwrite and exec_vmread64/exec_vmwrite64
- :acrn-commit:`612cdce` HV:treewide:Add exec_vmread32 and exec_vmwrite32 functions
- :acrn-commit:`6543796` HV:treewide: Add exec_vmread16 and exec_vmwrite16 functions
- :acrn-commit:`d3b9712` HV:INSTR:Rearrange register names in the enum cpu_reg_name
- :acrn-commit:`055153b` HV:treewide:Replace HOST_GDT_RING0_CODE/DATA_SEL with constant
- :acrn-commit:`f2774e4` HV:common:fix "integer type violations"
- :acrn-commit:`aa2b2d8` hv: change several APIs to void type
- :acrn-commit:`8017ebd` HV:vtd:dma change the macro to the inline function
- :acrn-commit:`d8c3765` HV:vtd:cap change the macro to the inline function
- :acrn-commit:`69ebf4c` HV: vioapic: cleaning up integral-type-related violations
- :acrn-commit:`a1069a5` HV: ioapic: unify the access pattern to RTEs
- :acrn-commit:`9878543` DM: add system reset (with RAM content kept)
- :acrn-commit:`b33012a` DM: add vm reset API
- :acrn-commit:`8d12c06` dm: introduce system/full reset and suspend
- :acrn-commit:`76662a6` loader: Update the memory address of GUEST_CFG_OFFSET
- :acrn-commit:`a91952d` HV: per_cpu: drop dependency on version.h and add license header
- :acrn-commit:`116038f` HV: make: consider header dependencies when rebuilding
- :acrn-commit:`11239ae` update launch_uos.sh to align with ACRN v0.1
- :acrn-commit:`b2e676a` update kernel-pk version to align with ACNR v0.1
- :acrn-commit:`ea0bbd5` doc: reorganize doc tree
- :acrn-commit:`e042558` doc: update GSG for v0.1, add console code-block
- :acrn-commit:`1c712c5` delete pci_devices_ignore=(0:18:1)
- :acrn-commit:`2f2d108` HV: handle integral issue report by MISRA-C
- :acrn-commit:`7706e5c` tools: acrnd: store/load timer list
- :acrn-commit:`e435f03` tools: acrnd: handle timer request from UOS
- :acrn-commit:`ee9ec9d` tools: acrnd: the acrnd work list
- :acrn-commit:`f5e9c76` tools: acrnd: handle resume request from SOS-LCS
- :acrn-commit:`04ed916` tools: acrnd: handle stop request from SOS-LCS
- :acrn-commit:`bcb101f` tools: acrnd: the daemon for acrn-manager
- :acrn-commit:`c4f9a2f` tools: rework on vm ops
- :acrn-commit:`f0fe17d` hv: sprintf: fix 'Declaration does not specify an array'
- :acrn-commit:`aa5027a` HV:misc:fix "signed/unsigned conversion with cast"
- :acrn-commit:`619c600` hv: cpu state update should be moved just before halt.
- :acrn-commit:`621425d` hv: further fix to configurable relocation
- :acrn-commit:`944776f` HV: Fix new MISRAC violations for brackets
- :acrn-commit:`90b342b` HV: prototyping non-static function
- :acrn-commit:`8925eb5` hv: set guest segment base to zero if VCPU does not start in real mode
- :acrn-commit:`b831120` HV: coding style cleanup for TRACE_2L & TRACE_4I usage
- :acrn-commit:`c808972` hv: fix the potential dead loop in _parse_madt
- :acrn-commit:`4627cd4` HV: build: drop useless files
- :acrn-commit:`680c64d` HV:transfer vmid's type to uint16_t
- :acrn-commit:`6ad1508` dm: virtio-net: add variable name in function declaration
- :acrn-commit:`cb0009f` hv: cpu: fix 'Pointer arithmetic is not on array'
- :acrn-commit:`44a175e` HV: instr_emul: Add new function vie_update_rflags
- :acrn-commit:`2f3eb67` HV: Remove SIB decode related code in decode_modrm
- :acrn-commit:`0fbdf37` HV: instr_emul: Cleanup ASSERT
- :acrn-commit:`e3302e8` HV:transfer vm_hw_logical_core_ids's type and rename it
- :acrn-commit:`1d628c6` hv:fix MISRA-C return value violation
- :acrn-commit:`2a2adc7` HV:CPU:Fix a mistake introduced by MARCO replacing patch
- :acrn-commit:`e3452cf` HV: vlapic: minimize explicit casts by adjusting types
- :acrn-commit:`e08a58e` HV: vlapic: save complex expressions to local variables
- :acrn-commit:`f05e2fc` HV: vlapic: cleanup types in formatting strings
- :acrn-commit:`6dd78d5` HV: vlapic: convert loop variables to unsigned
- :acrn-commit:`87f2d4c` HV: vlapic: add suffix 'U' when necessary
- :acrn-commit:`1af8586` HV: Fix missing brackets for MISRA C Violations
- :acrn-commit:`af806a9` HV: Fix missing brackets for MISRA C Violations
- :acrn-commit:`4aa6cda` HV: Fix missing brackets for MISRA C Violations
- :acrn-commit:`d16d9e5` HV: Fix missing brackets for MISRA C Violations
- :acrn-commit:`82e0cdb` HV: Fix missing brackets for MISRA C Violations
- :acrn-commit:`dbfd0e5` HV: Fix missing brackets for MISRA C Violations
- :acrn-commit:`88a3205` HV: Fix missing brackets for MISRA C Violations
- :acrn-commit:`b4a6b93` doc: add v0.1 doc choice
- :acrn-commit:`3fe0fed` version: 0.2-unstable
- :acrn-commit:`b4fb261` hv: fix bug in some embedded assembly code in vmx
- :acrn-commit:`8336101` DM: Fix potential buffer overflow and uninitialized variable
- :acrn-commit:`194fd8b` hv: irq: fix 'Pointer arithmetic is not on array'
- :acrn-commit:`401ffd1` HV: pm: cleanup for MISRA integral type violations
- :acrn-commit:`202bc54` HV: trusty: revise trusty_boot_param structure
- :acrn-commit:`b30ba3d` tools:acrn-crashlog: Detect and classify the crash in ACRN and kernel
- :acrn-commit:`a5853d6` tools:acrn-crashlog: Improve the process of crash reclassify
- :acrn-commit:`0683b16` tools:acrn-crashlog: Get reboot reason in acrnprobe
- :acrn-commit:`2d03706` hv:change shell_puts to void type
- :acrn-commit:`4cab8b9` HV: code cleanup as MISRA-C report for guest/vmsr
- :acrn-commit:`8c43ad5` HV: add the missing brackets to loop body
- :acrn-commit:`fd81655` HV: add the missing brackets to loop body
- :acrn-commit:`df038fc` HV: vmx: Change variable field to uint32_t
- :acrn-commit:`43e4bd4` version: v0.1

661
doc/release_notes/release_notes_0.3.rst
View File

@ -1,661 +0,0 @@
.. _release_notes_0.3:
ACRN v0.3 (Nov 2018)
####################
We are pleased to announce the release of Project ACRN version 0.3.
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline
embedded development through an open source platform. Check out the
:ref:`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, and documentation.
You can either download this source code as a zip or tar.gz file (see
the `ACRN v0.3 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v0.3>`_ or
use Git clone and checkout commands:
.. code-block:: bash
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v0.3
The project's online technical documentation is also tagged to correspond
with a specific release: generated v0.3 documents can be found at
https://projectacrn.github.io/0.3/. Documentation for the latest
(master) branch is found at https://projectacrn.github.io/latest/.
Version 0.3 New Features
************************
- :acrn-issue:`866` - Security Interrupt Storm Mitigation
- :acrn-issue:`878` - Virtualization HLD
- :acrn-issue:`887` - Security xD support
- :acrn-issue:`944` - CSME (and subcomponent) Sharing
- :acrn-issue:`946` - CS(M)E Mediator Definition
- :acrn-issue:`951` - Device CS(M)E support
- :acrn-issue:`1122` - Security Enable compiler and linker setting-flags to harden software
- :acrn-issue:`1124` - MMU code reshuffle
- :acrn-issue:`1179` - RPMB key passing
- :acrn-issue:`1180` - vFastboot release version 0.9
- :acrn-issue:`1181` - Integrate enabling Crash OS feature as default in VSBL debug Version
- :acrn-issue:`1182` - vSBL to support ACPI customization
- :acrn-issue:`1213` - IOC Mediator added RTC Timer feature
- :acrn-issue:`1230` - fix the %l format given to print API only print 32bit
- :acrn-issue:`1231` - VM loader reshuffle
- :acrn-issue:`1240` - [APL][IO Mediator] Enable VHOST_NET & VHOST to accelerate guest networking with virtio_net.
- :acrn-issue:`1284` - [DeviceModel]Enable NHLT table in DM for audio passthrough
- :acrn-issue:`1313` - [APL][IO Mediator] Remove unused netmap/vale in virtio-net
- :acrn-issue:`1328` - [APL][IO Mediator] change trace_printk to pr_debug for vhm ioctl
- :acrn-issue:`1329` - ioeventfd and irqfd implementation to support vhost on ACRN
- :acrn-issue:`1343` - Enable -Werror for ACRN hypervisor
- :acrn-issue:`1364` - [APL][IO Mediator] virtio code reshuffle
- :acrn-issue:`1369` - allocate more RAM to UOS on MRB.
- :acrn-issue:`1401` - IOC mediator reshuffle
- :acrn-issue:`1420` - Update contributing doc with Tracked-On requirement for commits
- :acrn-issue:`1455` - x2apic support for acrn
- :acrn-issue:`1616` - remove unused parameters for acrn-dm
- :acrn-issue:`1626` - support x2APIC mode for ACRN guests
- :acrn-issue:`1672` - L1TF mitigation
- :acrn-issue:`1701` - MISRA C compliance Naming Convention
- :acrn-issue:`1711` - msix.c use MMIO read/write APIs to access MMIO registers
Fixed Issues
************
- :acrn-issue:`1209` - specific PCI device failed to passthrough to UOS
- :acrn-issue:`1268` - GPU hangs when running GfxBench Car Chase in SOS and UOS.
- :acrn-issue:`1270` - SOS and UOS play video but don't display video animation output on monitor.
- :acrn-issue:`1339` - SOS failed to boot with SSD+NVMe boot devices on KBL NUC
- :acrn-issue:`1432` - SOS failed boot
Known Issues
************
:acrn-issue:`677` - SSD Disk ID is not consistent between SOS/UOS
The SSD disk ID in the UOS is not the same as in the SOS when the SSD
device is passed-through to the UOS (it should be). The ID is also
changing after a reboot (it shouldn't). **Impact:** There is no impact
to functionality. **Workaround:** None. The issues will be fixed in the
next release.
:acrn-issue:`1319` - SD card pass-through: UOS can't see SD card after UOS reboot.
SD card could not be found after UOS reboot in pass-through mode.
**Impact:** There is no SD card after UOS reboot.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1773` - USB Mediator: Can't find all devices when multiple usb devices connected[Reproduce rate:60%]
After booting UOS with multiple USB devices plugged in, sometimes there
are one or more devices cannot be discovered. The reproduce rate is ~60%.
**Impact:** Cannot use multiple usb devices at same time.
**Workaround:** Plug-out and plug-in the unrecognized device again.
:acrn-issue:`1774` - UOS can't stop by command: acrnctl stop [vm name] in SOS
After launching UOS in SOS by "acrnctl start" command, UOS VM failed
to be stopped by "acrnctl stop" command.
**Impact:** Can't stop UOS in SOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1775` - [APL UP2]ACRN debugging tool - acrntrace cannot be used in SOS
There are no acrntrace devices "acrn_trace*" under SOS /dev.
**Impact:** acrntrace cannot be used in SOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1776` - [APL UP2]ACRN debugging tool - acrnlog cannot be used in SOS
There are no acrnlog devices "acrn_hvlog*" under SOS /dev.
**Impact:** acrnlog cannot be used in SOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1777` - After UOS plays video for several minutes, the UOS image will be stagnant
After UOS plays video for several minutes, the UOS image will be stagnant.
**Impact:** UOS cannot play video image smoothly all the time.
**Workaround:** None. The issues will be fixed in the next release.
:acrn-issue:`1779` - gfxbench cannot run in SOS or UOS
Failed to run gfxbench in SOS or UOS.
**Impact:** Cannot run gfxbench in SOS or UOS.
**Workaround:** None. The issues will be fixed in the next release.
:acrn-issue:`1780` - Some video formats cannot be played in SOS
There are several formats of videos that cannot be played in SOS:
H265_10bits, VP8, VP9, VP9_10bits, H265.720p.
**Impact:** Cannot play those formats of videos in SOS.
**Workaround:** None. The issues will be fixed in the next release.
:acrn-issue:`1782` - UOS failed to get IP address with the pass-through network card
After network card is pass-through to UOS, it fails to get IP address in UOS.
**Impact:** Cannot use network in UOS.
**Workaround:** None. The issues will be fixed in the next release.
:acrn-issue:`1794` - After SOS boots up, there's no output on SOS screen
After SOS boots up with both "desktop" and "soft-defined-cockpit" bundles installed
or without any, there's no output on SOS screen.
**Impact:** Cannot access SOS.
**Workaround:** Only install "desktop" bundle, then enable and start
weston in Native Clear Linux OS,
and then reboot to SOS. The issues will be fixed in the next release.
:acrn-issue:`1795` - [KBL NUC] SOS fails to get IP address
On KBL NUC hardware platform, SOS fails to get IP address after SOS boot.
**Impact:** Cannot use network in SOS.
**Workaround:** None. The issues will be fixed in the next release.
:acrn-issue:`1796` - APL NUC fails to reboot sometimes
After APL NUC boot to SOS, type "reboot" to reboot SOS, it fails to reboot sometimes.
**Impact:** Cannot reboot SOS.
**Workaround:** Power off and boot again. The issues will be fixed in the next release.
.. comment
Use the syntax:
:acrn-issue:`663` - Short issue description
Longer description that helps explain the problem from the user's
point of view (not internal reasons). **Impact:** What's the
consequences of the issue, and how it can affect the user or system.
**Workaround:** Describe a workaround if one exists (or refer them to the
:acrn-issue:`663`` if described well there. If no workaround, say
"none".
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v0.2
release in Sep 2018 (click on the CommitID link to see details):
.. comment
This list is obtained from the command:
git log --pretty=format:'- :acrn-commit:`%h` %s' --after="2018-03-01"
- :acrn-commit:`b6988e13` hv: fix branch addressing syntax warning
- :acrn-commit:`053608a5` HV: add px cx data of bxt n3350 SOC
- :acrn-commit:`73530055` hv:Replace dynamic memory with static for port io
- :acrn-commit:`5a1f2447` hv: ept: set snp control when modify
- :acrn-commit:`66f133bf` DM: Fix the typo error in checking the /dev/vbs_ipu file
- :acrn-commit:`ab5572bd` doc: explain intr storm monitor params in acrn-dm
- :acrn-commit:`f65e05c5` hv: fix 'Start of variable is upper case'
- :acrn-commit:`d49a6f6f` capture acrnd AaaG booting messages to journald
- :acrn-commit:`c4161c87` dm: uart: fix UOS console output to stdin
- :acrn-commit:`b5881727` DM: add interrupt storm monitor params in cmdline
- :acrn-commit:`ad1cbb76` DM: add interface to set intr storm monitor params
- :acrn-commit:`1902d725` hv: fix partition mode no console issue.
- :acrn-commit:`3cbaf028` HV: Use parameter directly to pass bdf for hcall_assign/deassign_ptdev
- :acrn-commit:`605738fc` hv: hypercall: remove hcall_set_vm_memory_region
- :acrn-commit:`b430b00a` hv: fix 'Expression is not Boolean'
- :acrn-commit:`121454c4` hv: fix a minor bug of static checks
- :acrn-commit:`0800624f` hv: vtd: use pre-defined function for bdf calculation
- :acrn-commit:`039a1c0f` hv: pci: replace function like macro with inline func
- :acrn-commit:`36aaaa1c` DM NPK: unmap the MMIO in pci_npk_deinit
- :acrn-commit:`ef974d1a` hv:Remove atomic operation to set initial value for 'created_vcpu'
- :acrn-commit:`0fc47b5a` hv: fix release build issue
- :acrn-commit:`a8a1e229` hv:vtd: fix minor bug in domain count
- :acrn-commit:`78dd92e4` DM: sos_bootargs: split sos_bootargs into multiple lines
- :acrn-commit:`44ce3a66` doc: update HLD Trace/Log
- :acrn-commit:`27fffb96` doc: update HLD Power Management
- :acrn-commit:`b3d21683` doc: update HLD VM Management
- :acrn-commit:`dfcc06df` doc: update HLD Virtio Devices
- :acrn-commit:`366042ca` hv: fix integer violations
- :acrn-commit:`65a2613a` IOC mediator: fix wakeup reason issue when UOS resuming
- :acrn-commit:`a2516ecc` fix "Casting operation to a pointer"
- :acrn-commit:`ad1e2ab6` DM/sos_bootargs: remove unused parameters for graphics
- :acrn-commit:`ee918f85` HV:debug:profiling Fixed inappropriate condition check
- :acrn-commit:`7f57a74f` hypercall doc: Sync the comments for each hypercall from .h to .c
- :acrn-commit:`99586e32` HV:treewide:rename vm data structure
- :acrn-commit:`ace4f48c` HV:treewide:rename vcpu_arch data structure
- :acrn-commit:`fa26a166` HV:treewide:rename vcpu data structure
- :acrn-commit:`969f7cf0` DM:Check the device file of /dev/vbs_ipu to determine IPU mode
- :acrn-commit:`8efd9edb` hv: vPCI needs to handle reset IO port CF9 differently
- :acrn-commit:`d261b4bc` doc: update virtio related functions doc comments
- :acrn-commit:`ea801a16` dm: Remove unused duplicated API dm_gpa2hva
- :acrn-commit:`4e540e54` HV: doc: use doxygen-generated API docs in HLD
- :acrn-commit:`e0fcb70d` HV: io: add structure and API docs
- :acrn-commit:`a4be10f3` hv: mmu: unmap the trusty EPT when destroy_secure_world
- :acrn-commit:`e8229879` hv: use MMIO read/write APIs to access MMIO registers
- :acrn-commit:`313941e8` tools: acrn-manager: remove unsafe api sscanf
- :acrn-commit:`e24464a0` tools: acrnlog: remove usage of banned APIs
- :acrn-commit:`1d96ce5f` doc: add doxygen alias for easy reST inclusion
- :acrn-commit:`d2d0cbc6` hv:doc:use doxygen-generated API docs in HDL for vIRQ
- :acrn-commit:`cbe03135` hv: revise interfaces description in virq
- :acrn-commit:`f23606a4` hv: revise interfaces description in vioapic
- :acrn-commit:`7c20cb0c` hv: revise interfaces description in vpic
- :acrn-commit:`c41f2860` hv: revise interfaces description in vlapic
- :acrn-commit:`46949631` Documentation: add 'make' to GSG and expand PATH for `sphinx-build`
- :acrn-commit:`4b3b1155` hv: doc: use doxygen-generated API docs in HLD for vtd
- :acrn-commit:`1776d7e7` hv: vtd: add structure and API docs
- :acrn-commit:`7dc3e609` doc: hv: add comments to irq APIs for documentation
- :acrn-commit:`f69dd1c6` HV:doc:use doxygen-generated API docs in HLD
- :acrn-commit:`7c3c6ea4` HV:MM:add API docs
- :acrn-commit:`17d43fe5` doc: doc: update HLD Emulated Devices
- :acrn-commit:`bf88e241` DOC: add main vcpu API & data structure into HLD.
- :acrn-commit:`c8850114` HV: add main vcpu API comments for document
- :acrn-commit:`277c9330` doc: fix formatting error in l1tf doc
- :acrn-commit:`2c85480c` doc: format l1tf.rst
- :acrn-commit:`d6247ff7` doc: update l1tf.rst line endings setting to unix style
- :acrn-commit:`eefb06b3` hv: mmu: add 16GB RAM support for uefi platform
- :acrn-commit:`c36f4d27` doc: hotfix build issue blocked by l1tf.rst
- :acrn-commit:`48ae379b` hv: LAPIC pass-thru support for partition mode of ACRN
- :acrn-commit:`ff56b6f6` hv: Add support for leaf 0xb emulation
- :acrn-commit:`f3aa20a8` hv: self-IPI APIC register in x2APIC mode of guest vLAPIC
- :acrn-commit:`c85e35d3` hv: Switch APICv from MMIO to MSR for x2APIC mode of guest vLAPIC
- :acrn-commit:`cf4d1912` hv: Modify vlapic_get_apicid for x2APIC mode of vLAPIC
- :acrn-commit:`80b6e627` hv: Add APIs to convert x2APIC MSR accesses to LAPIC MMIO offset
- :acrn-commit:`e9fe6efd` hv: vLAPIC ICR write and destination mask matching for x2APIC
- :acrn-commit:`6a4dcce3` hv: APIs for building x2APIC ID and LDR
- :acrn-commit:`7ecc521c` hv: Modify enable_msr_interception API
- :acrn-commit:`64f61961` hv: add missing support to intercept x2APIC MSRs
- :acrn-commit:`94dadc1d` dm: virtio-input: ignore MSC_TIMESTAMP from guest
- :acrn-commit:`ed113f57` hv: mmu: remove "##" for MISRA C
- :acrn-commit:`541f3713` hv: bug fix: normal world may get trusty world's pdpt page
- :acrn-commit:`f1ed6c50` hv: mmu: remove alloc_page() API
- :acrn-commit:`0391f84c` hv: mmu: replace dynamic memory allocation in memory
- :acrn-commit:`9c7c0de0` hv: mmu: add static paging table allocation for EPT
- :acrn-commit:`dc9d18a8` hv: mmu: add static paging table allocation for hypervisor
- :acrn-commit:`74a5eec3` DM: change SOS bootargs console ttyS0 to ttyS2
- :acrn-commit:`0307b218` HV: change vuart port (used by SOS) to ttyS2
- :acrn-commit:`9029ac4b` doc: update Tracked-on in contribute guide
- :acrn-commit:`a86248ec` doc: hide doxygen duplicate definition warnings
- :acrn-commit:`3ffa9686` tools: acrn-crashlog: fix potential issues
- :acrn-commit:`111f9726` hv: fix integer violations
- :acrn-commit:`4c1cb606` hv: Remove the up_count_spinlock and use atomic for up_count
- :acrn-commit:`b7472063` HV: add size check for shell log buffer usage
- :acrn-commit:`b048835c` HV: fix bug "vmexit" cmd cause HV console hung
- :acrn-commit:`0255e627` hv: resolve the negative impacts to UOS MSI/MSI-X remapping
- :acrn-commit:`c1d2499e` hv: enable MSI remapping on vm0
- :acrn-commit:`8c398f7d` hv: fix issues when msi-x shares same BAR with other data structures
- :acrn-commit:`5cbe079e` hv: MSI-X Message Address write fix
- :acrn-commit:`dbe156e9` hv: fix MISRA-c violations in vcpi code
- :acrn-commit:`5555a2f8` hv: fix bug in sizing MSI-X Table Base Address Register
- :acrn-commit:`51977a6d` hv: Don't check multi-function flag in PCI enumeration
- :acrn-commit:`e32bc9e3` hv: avoid hardcode cs.limit in set_vcpu_regs()
- :acrn-commit:`0cd85749` HV: save the cs limit field for SOS
- :acrn-commit:`6993fdb3` DM: set cs_limit from DM side for UOS
- :acrn-commit:`b12c7b74` tools: acrn-manager: remove usage of banned APIs
- :acrn-commit:`af760f8d` tools: acrn-manager: refine the usage of api 'snprintf'
- :acrn-commit:`5493804c` tools: acrnlog: refine the usage of api 'snprintf'
- :acrn-commit:`a2383b06` tools: acrntrace: remove unsafe api and return value check for snprintf
- :acrn-commit:`2975f9fa` hv:Replace dynamic memory with static for sbuf
- :acrn-commit:`9e397322` hv: l1tf: sanitize mapping for idle EPT
- :acrn-commit:`fb68468c` HV: flush L1 cache when switching to normal world
- :acrn-commit:`34a63365` HV: enable L1 cache flush when VM entry
- :acrn-commit:`d43d2c92` HV: add CPU capabilities detection for L1TF mitigation
- :acrn-commit:`2731628e` HV: wrap security related CPU capabilities checking
- :acrn-commit:`25c2d4d7` doc: add l1tf document
- :acrn-commit:`b0cac0e6` Samples:Added the Kernel console parameter in boot.
- :acrn-commit:`43f6bdb7` hv: vtd: fix device assign failure for partition mode
- :acrn-commit:`9ae79496` doc: fix section heading in device model hld
- :acrn-commit:`7df70e0c` doc: update HLD Device Model
- :acrn-commit:`390cc678` doc: tweak doxygen/known-issues handling
- :acrn-commit:`60d0a752` hv: fix integer violations
- :acrn-commit:`4d01e60e` hv: vtd: remove dynamic allocation for iommu_domain
- :acrn-commit:`dda08957` hv: vtd: remove dynamic allocation for dmar_drhd_rt
- :acrn-commit:`f05bfeb9` hv: vtd: remove dynamic page allocation for root&ctx table
- :acrn-commit:`1b1338bc` snprintf: Remove the %o and %p support
- :acrn-commit:`6150c061` dm: bios: update to version 1.0.1
- :acrn-commit:`8c7d471c` HV: bug fix:possible access to NULL pointer
- :acrn-commit:`9ba75c55` dm: mei: fix firmware reset race.
- :acrn-commit:`5f41d4a8` dm: mei: check return value of vmei_host_client_to_vmei()
- :acrn-commit:`b4fbef46` dm: mei: destroy mutex attribute on error path
- :acrn-commit:`8abc9317` dm: mei: set addresses in the hbm disconnect reply
- :acrn-commit:`6bb3d048` hv: remove deprecated functions declaration
- :acrn-commit:`a0ace725` DM USB: xHCI: fix process logic of TRB which has zero data length
- :acrn-commit:`6266dd01` DM: correct memory allocation size for UOS
- :acrn-commit:`ac5b46eb` doc: update rest of hypervisor HLD sections
- :acrn-commit:`97c8c16f` doc: fix misspellings in hld docs
- :acrn-commit:`569ababd` hv: switch vLAPIC mode vlapic_reset
- :acrn-commit:`48d8123a` devicemodel:nuc:launch_uos.sh: drop a useless clear parameter
- :acrn-commit:`62a42d5f` devicemodel: Makefile: clean up/refactor some code
- :acrn-commit:`df5336c9` gitignore: drop some useless entries
- :acrn-commit:`7169248b` sos_bootargs_release.txt: enable guc firmware loading
- :acrn-commit:`fdf1a330` sos_bootargs_debug.txt: enable guc firmware loading
- :acrn-commit:`8873859a` kconfig: optionally check if the ACPI info header is validated
- :acrn-commit:`5f6a10f1` kconfig: use defconfig instead of default values in silentoldconfig
- :acrn-commit:`b9d54f4a` kconfig: support board-specific defconfig
- :acrn-commit:`8bde372c` kconfig: enforce remaking config.mk after oldconfig changes .config
- :acrn-commit:`c7907a82` kconfig: a faster way to check the availability of python3 package
- :acrn-commit:`256108f1` kconfig: add more help messages to config symbols
- :acrn-commit:`05bb7aa2` hv: remove deprecated hypercalls
- :acrn-commit:`bf7b1cf7` doc: update HLD Device passthrough
- :acrn-commit:`7c192db1` doc: update HLD VT-d
- :acrn-commit:`e141150e` doc: Fix AcrnGT broken API doc due to kernel upgrade
- :acrn-commit:`83dbfe4f` hv: implement sharing_mode.c for PCI emulation in sharing mode
- :acrn-commit:`7c506ebc` hv: implement msix.c for MSI-X remapping
- :acrn-commit:`dcebdb8e` hv: implement msi.c to handle MSI remapping for vm0
- :acrn-commit:`6af47f24` hv: vpci: add callback functions to struct vpci
- :acrn-commit:`3e54c70d` hv: rework the MMIO handler callback hv_mem_io_handler_t arguments
- :acrn-commit:`ec5b90f1` hv: implement PCI bus scan function
- :acrn-commit:`9cc1f57f` hv: change function parameters: pci_pdev_read_cfg and pci_pdev_write_cfg
- :acrn-commit:`19e1b967` hv: MSI Message Address should be 64 bits
- :acrn-commit:`7b4b78c3` hv: minor cleanup for dm/vpci code
- :acrn-commit:`bc4f82d1` hv: more cleanup for pci.h
- :acrn-commit:`e24899d9` fix "Recursion in procedure calls found"
- :acrn-commit:`e8a59f30` checkpatch: fix the line limit back to 120
- :acrn-commit:`f4f139bf` DM: generate random virtual RPMB key
- :acrn-commit:`dff441a0` hv:Replace dynamic memory with static for pcpu
- :acrn-commit:`4afb6666` hv:cleanup vcpu_id compare with phys_cpu_num
- :acrn-commit:`3eb45b9b` hv:Check pcpu number to avoid overflow
- :acrn-commit:`672583a0` hv: Check pcpu number in Hw platform detect
- :acrn-commit:`298044d9` hv: Add MAX_PCPU_NUM in Kconfig
- :acrn-commit:`b686b562` DM: wrap ASSERT/DEASSERT IRQ line with Set/Clear IRQ line
- :acrn-commit:`e12f88b8` dm: virtio-console: remove unused virtio_console_cfgwrite
- :acrn-commit:`7961a5ba` HV: Fix some inconsistent comments in vm_description.c
- :acrn-commit:`8860af3b` dm: fix possible buffer overflow in 'acrn_load_elf()'
- :acrn-commit:`dc7df1cd` doc: update HLD Virtual Interrupt
- :acrn-commit:`1c54734f` doc: update HLD Timer section
- :acrn-commit:`d6523964` Documentation: tweak 'partition mode' tutorial
- :acrn-commit:`b3cb7a53` Fix to kernel hang in smp_call_function
- :acrn-commit:`cab93c05` HV:Added SBuf support to copy samples generated to guest.
- :acrn-commit:`5985c121` HV:Added implementation for PMI handler function
- :acrn-commit:`a7cbee18` HV:Added support to get VM enter and exit information
- :acrn-commit:`fc8f9d79` HV:Added support to perform MSR operation on all cpus
- :acrn-commit:`1786f622` HV:Added support to setup tool & start/stop profing
- :acrn-commit:`898b9c8d` HV:Added support to configure PMI and VM switch info
- :acrn-commit:`df549096` HV:Added support to get phy CPU, VM, tool information
- :acrn-commit:`8ba333d2` HV: Added Initial support for SEP/SOCWATCH profiling
- :acrn-commit:`3010718d` dm: cmdline: remove unused parameters
- :acrn-commit:`4261ca22` DM USB: xHCI: refine logic of Disable Slot Command
- :acrn-commit:`e1e0d304` DM USB: xHCI: refine the USB disconnect logic in DM
- :acrn-commit:`f799e8fa` DM USB: xHCI: fix process logic of LINK type TRB
- :acrn-commit:`08a7227f` DM USB: xHCI: fix bug in port unassigning function
- :acrn-commit:`d7008408` DM USB: xHCI: fix issue: crash when plug device during UOS booting
- :acrn-commit:`3d94f868` hv: flush cache after update the trampoline code
- :acrn-commit:`0166ec4b` HV: debug: Check if vUART is configured in partition mode
- :acrn-commit:`05834927` HV: Fix boot failure of partition mode
- :acrn-commit:`70e13bf8` doc: update interrupt hld section
- :acrn-commit:`f84547ca` doc: move docs to match HLD 0.7 org
- :acrn-commit:`9871b343` doc: update I/O emulation section
- :acrn-commit:`6dffef12` doc: filter error exit status incorrect
- :acrn-commit:`d764edbf` doc: update GRUB menu image in partition mode doc
- :acrn-commit:`61a9ca20` Documentation: Add tutorial about how to use partition mode on UP2
- :acrn-commit:`bc7b06ae` doc: update Memory management HLD
- :acrn-commit:`2f8c31f6` tools: acrn-crashlog: update the documents
- :acrn-commit:`655132fc` dm: virtio: remove unused vbs_kernel_init
- :acrn-commit:`eb265809` DM: multiboot info address in DM for elf loader is wrong.
- :acrn-commit:`80e02c97` DM USB: xHCI: Fix an potential array out of range issue.
- :acrn-commit:`84c0c878` DM USB: xHCI: Fix a potential NULL pointer issue.
- :acrn-commit:`1568a4c0` hv:Remove deadcode 'vm_lapic_from_pcpuid'
- :acrn-commit:`46d19824` HV:vcpu fix "Pointer param should be declared pointer to const"
- :acrn-commit:`ea32c34a` HV:fix "Pointer param should be declared pointer to const"
- :acrn-commit:`d79007ae` HV:add const to bitmap_test parameter addr
- :acrn-commit:`482a4dcc` DM: correct the predefine DM option string.
- :acrn-commit:`85bec0d0` hv: Move the guest_sw_loader() call from vcpu to vm
- :acrn-commit:`4f19b3b8` hv: Prepare the gdt table for VM
- :acrn-commit:`ad1ef7ba` samples: enable pstore via the sos kernel cmdline
- :acrn-commit:`6d076caa` tools: acrn-crashlog: remove unsafe apis in usercrash
- :acrn-commit:`8f7fa50d` hv: fix mapping between GSI Num#2 and PIC IRQ #0
- :acrn-commit:`96f8becc` dm: bios: update vSBL to v1.0
- :acrn-commit:`09193c39` hv: x2apic support for acrn
- :acrn-commit:`19abb419` launch_uos.sh: make sure cpu offline by retry
- :acrn-commit:`241d5a68` HV: fix bug by improving intr delay timer handling
- :acrn-commit:`4228c81b` DM: compare unsigned numbers to avoid overflow.
- :acrn-commit:`d2993737` tools: acrnd: Stop all vms when SOS shutdown/reboot
- :acrn-commit:`7b06be9e` HV: checkpatch: add configurations to customize checkpatch.pl
- :acrn-commit:`7195537a` dm: virtio-net: replace banned functions
- :acrn-commit:`7579678d` dm: add const declaration for dm_strto* APIs
- :acrn-commit:`bd97e5cb` dm: rpmb: Support RPMB mode config from launch.sh
- :acrn-commit:`107eaa3a` HV:fix MACRO value mismatch
- :acrn-commit:`a853c055` tools: acrnctl: fix: resume default wakeup reason is CBC_WK_RSN_BTN
- :acrn-commit:`a6677e6e` hv: create new file core.c and pci.c
- :acrn-commit:`4741fcff` hv: pci_priv.h code cleanup
- :acrn-commit:`a43ff9ce` hv: timer: add debug information for add_timer
- :acrn-commit:`7ca1a7de` dm: launch_uos.sh add virtio_mei mediator
- :acrn-commit:`201e5cec` dm: mei: enable virtio_mei compilation
- :acrn-commit:`d4b9bd59` dm: mei: add module initialization
- :acrn-commit:`f6e6e858` dm: mei: implement vmei_start/stop()
- :acrn-commit:`6a1f8242` dm: mei: implement rx flow.
- :acrn-commit:`50ecd93b` dm: mei: implement tx flow
- :acrn-commit:`483a893e` dm: mei: implement HBM protocol handler
- :acrn-commit:`98c6b7a6` dm: mei: add native io handlers
- :acrn-commit:`3abbf10e` dm: mei: add me clients enumeration
- :acrn-commit:`7cbb3872` dm: mei: add virtio cfgread/cfgwrite handlers.
- :acrn-commit:`f462601b` dm: mei: add reset handlers
- :acrn-commit:`a632ac3d` dm: mei: add client management infrastructure
- :acrn-commit:`445f4193` dm: mei: add virtio configuration
- :acrn-commit:`0dc7adfb` dm: mei: add sysfs read functions
- :acrn-commit:`b8d53d17` dm: mei: add reference counter functions
- :acrn-commit:`6a96878e` dm: types: add container_of macro
- :acrn-commit:`4e057c32` dm: mei: add guid handling functions
- :acrn-commit:`d141aebd` dm: mei: add mei hbm protocol definitions header.
- :acrn-commit:`0cc50b1d` dm: remove virtio_heci
- :acrn-commit:`39fde060` hv: ept: remove EPT paging table for HPA to GPA
- :acrn-commit:`70ddca3a` hv: mmu: add pre-assumption for hpa2gpa
- :acrn-commit:`49b476bb` hv: vm_load: set zeropage just past boot args
- :acrn-commit:`9368373f` tools: acrn-crashlog: check the pointer after getting sender
- :acrn-commit:`2973db78` DM: VMcfg: generated example header
- :acrn-commit:`c86da003` DM: VMcfg: support ``--dump`` options
- :acrn-commit:`67d72920` DM: VMcfg: support ``--vmcfg`` options
- :acrn-commit:`321021eb` DM: VMcfg: mrb-env-setup.sh
- :acrn-commit:`d2ed9955` DM: VMcfg: support VM1 on MRB
- :acrn-commit:`ae5b32dc` DM: VMcfg: build-in vm configurations
- :acrn-commit:`646cc8c4` DM: VMcfg: Kconfig & Makefile for VM Configuration
- :acrn-commit:`4ce80e5c` tools: acrn-manager: fix a potential compiler warning
- :acrn-commit:`e8c86566` tools: acrn-manager: fix a potential NULL pointer dereference
- :acrn-commit:`da3b0270` tools: acrnd: Ignore null line reading from timer_list
- :acrn-commit:`a45d961b` tools: acrnd: check wakeup reason first in init_vm
- :acrn-commit:`acc51877` doc: merge static core with cpu virt
- :acrn-commit:`e01f4777` doc: HV startup and CPU virtualization sections
- :acrn-commit:`8893a8c2` doc: update HLD overview chapter
- :acrn-commit:`60b216a4` HV:fixed "Pointer param should be declared pointer to const"
- :acrn-commit:`40dbdcde` tools: acrn-crashlog: remove unsafe strlen in common
- :acrn-commit:`f25bc50e` tools: acrn-crashlog: update string operation in acrnprobe
- :acrn-commit:`6938caa2` tools: acrn-crashlog: refine the configuration structure
- :acrn-commit:`fe4d503c` tools: acrn-crashlog: remove unsafe api sscanf
- :acrn-commit:`fb029284` tools: acrn-crashlog: remove unsafe api sprintf
- :acrn-commit:`5ecf1078` tools: acrn-crashlog: remove unsafe apis from android_events.c
- :acrn-commit:`48ce01a5` tools: acrn-crashlog: new api in strutils
- :acrn-commit:`6a9a46ac` DM USB: xHCI: workaround for Stop Endpoint Command handling
- :acrn-commit:`ecf0585b` DM USB: xHCI: fix incorrect device searching logic
- :acrn-commit:`6b2a18a8` DM USB: add support for multi-layers hubs
- :acrn-commit:`f533a07a` DM USB: xHCI: support multiple hubs in single layer
- :acrn-commit:`6886d3cd` DM USB: xHCI: change port mapping logic for multiple hub support
- :acrn-commit:`540ce05f` DM USB: introduce function usb_get_native_devinfo
- :acrn-commit:`e8f7b6fa` DM USB: introduce struct usb_devpath and related functions
- :acrn-commit:`14bc961f` DM USB: xHCI: remove old hub support code.
- :acrn-commit:`8b5d357f` HV: move default ACPI info to default_acpi_info.h
- :acrn-commit:`bd042352` hv: fix potential buffer overflow in vpic_set_pinstate()
- :acrn-commit:`268a9f14` [REVERTME] dm: script: disable xHCI runtime PM to WA USB role switch hang issue
- :acrn-commit:`ffcf6298` dm: rpmb: DM customized changes for RPMB mux kernel module
- :acrn-commit:`193da971` tools: acrnd: Refine log msg to avoid confusing.
- :acrn-commit:`1c7d2f65` vuart: change irq from 4 to 6
- :acrn-commit:`6485666a` Revert "hv: x2apic support for acrn"
- :acrn-commit:`85ececd2` hv:Simplify for-loop when walk through the vcpu
- :acrn-commit:`813e3abc` doc: Update contrib doc with Tracked-On
- :acrn-commit:`30c29015` Documentation: typo in Ubuntu tutorial and additional note
- :acrn-commit:`fabe6072` hv:Replace dynamic memory with static for microcode
- :acrn-commit:`de10df26` DM: add MSI and INTR support for i6300esb watchdog
- :acrn-commit:`25719db8` HV: move DRHD data to platform acpi info
- :acrn-commit:`ca65e8c7` HV: refine APIC base address to platform acpi info
- :acrn-commit:`8f701b0f` HV: move NR_IOAPICS to platform acpi info
- :acrn-commit:`bf834072` HV: platform acpi info refactor
- :acrn-commit:`4ed87f90` Documentation: add note and instructions for Ubuntu 16.04
- :acrn-commit:`2b449680` Documentation: minor update to the tutorial about Ubuntu as SOS
- :acrn-commit:`21458bdd` dm: storage: banned functions replace
- :acrn-commit:`e1dab512` dm: add string convert API
- :acrn-commit:`4620b935` fix "use of single line comments(s) //"
- :acrn-commit:`75b03bef` dm: add io port 0xF4 writing to force DM exit
- :acrn-commit:`9f764264` dm: add elf loader to dm
- :acrn-commit:`0e897c0a` DM: use acrn_timer api to emulate rtc
- :acrn-commit:`8fdea84a` DM: use acrn_timer api to emulate wdt
- :acrn-commit:`6ffa1aa3` DM: add acrn_timer api for timer emulation
- :acrn-commit:`d9df6e93` HV: parse seed from ABL
- :acrn-commit:`a98dd9e3` HV: trusty: set cse_svn when derive dvseed for trusty
- :acrn-commit:`102f5a01` hv: fix potential buffer overflow in vioapic.c
- :acrn-commit:`eb328d78` hv: retain rip if the fault is injected to guest
- :acrn-commit:`348e2ba1` hv: x2apic support for acrn
- :acrn-commit:`a0fb1c4c` hypervisor: Makefile: let OBJS target depend on VERSION file
- :acrn-commit:`c6c1e42b` HV:fix 'missing for discarded return value' violations
- :acrn-commit:`19e0bed5` script: re-enable audio passthru
- :acrn-commit:`eb97b2f0` tools: acrn-manager: remove assumption of fd num less than 1024
- :acrn-commit:`f582757d` tools: acrn-manager: fix fd leaking
- :acrn-commit:`dc05ffff` dm: uart: fix acrn-dm crash issue
- :acrn-commit:`e7b63aec` doc: add static core partitioning doc
- :acrn-commit:`96412ac1` hv: add suffix(U/UL) to come up MISRA-C into include
- :acrn-commit:`909d1576` dm: cleanup the cmd options for acrn-dm
- :acrn-commit:`2202b7f5` dm: virtio: reject requests that violate the virtio-block spec
- :acrn-commit:`ba4e72bd` dm: virtio: add debugging information in virtio-blk
- :acrn-commit:`7101ce87` dm: storage: remove GEOM support
- :acrn-commit:`b4a7a1ea` HV: allow no IRR when pending bit set if no APIC-V
- :acrn-commit:`38d5df72` hv:enable APICv-Posted Interrupt
- :acrn-commit:`a028567b` vpic: change assert/deassert method
- :acrn-commit:`f9a16395` dm: passthru: fix hardcoded nhlt table length
- :acrn-commit:`1d725c89` hv:Replace dynamic memory with static for vcpu
- :acrn-commit:`7dd35cb7` hv: Fix identifier reuse
- :acrn-commit:`dbd9ab07` hv: Cleanup: Remove dead code.
- :acrn-commit:`b1ccde55` hv: Cleanup: set vcpu mode in vcpu_set_regs
- :acrn-commit:`29190ed2` dm: add call to set BSP init state for UOS S3 and system reset
- :acrn-commit:`113adea0` hv: not start vm automatically when reset vm
- :acrn-commit:`b454a067` hv: remove the vm loader for UOS in hv.
- :acrn-commit:`fc575460` dm: update the bzimage loader
- :acrn-commit:`96d99954` dm: update the vsbl loader
- :acrn-commit:`853b1c74` dm: add API to set vcpu regs of guest
- :acrn-commit:`3cfbc004` hv: add hypercall to set vcpu init state
- :acrn-commit:`66b53f82` kconfig patch
- :acrn-commit:`d859182d` customize function to generate config.h with proper suffixes
- :acrn-commit:`8ccaf3c3` use genld.sh to generate link_ram.ld
- :acrn-commit:`203016b4` dm: passthru: correct the name of xdci dsdt write function
- :acrn-commit:`7f2b9a1c` hv: virq: update apicv irr/rvi before handle vmcs event injection
- :acrn-commit:`90eca21d` hv: simplify the function init_guest_state
- :acrn-commit:`a5fc3e5e` hv: Add function to set UOS BSP init state
- :acrn-commit:`08c13a9e` hv: Update SOS BSP to use new API to init BSP state
- :acrn-commit:`26627bd1` hv: add function to set AP entry
- :acrn-commit:`f7b11c83` hv: add function to reset vcpu registers
- :acrn-commit:`b2dc13d7` dm: virtio: use the correct register size
- :acrn-commit:`790d8a5c` hv:Remove CONFIG_VM0_DESC
- :acrn-commit:`3c575325` dm: passthru: add deinit_msix_table
- :acrn-commit:`244bce75` dm: passthru: enable pba emulation for msix
- :acrn-commit:`57abc88b` script: re-enable PVMMIO ppgtt update optimization for GVT-g
- :acrn-commit:`9114fbb3` Revert "DM: Disable plane_restriction on 4.19 kernel"
- :acrn-commit:`c3ebd6f3` HV: get tss address from per cpu data
- :acrn-commit:`0c7e59f0` hv: fix NULL pointer dereference in "hcall_set_vm_memory_regions()"
- :acrn-commit:`e913f9e6` dm: mevent: add edge triggered events.
- :acrn-commit:`f649beeb` dm: mevent: implement enable/disable functions
- :acrn-commit:`018aba94` dm: mevent: remove useless vmname global variable
- :acrn-commit:`4f1d3c04` dm: inline functions defined in header must be static
- :acrn-commit:`0317cfb2` hv: fix 'No brackets to then/else'
- :acrn-commit:`71927f3c` vuart: assert COM1_IRQ based on its pin's polarity
- :acrn-commit:`a11a10fa` HV:MM:gpa2hpa related error checking fix
- :acrn-commit:`041bd594` hv: improve the readability of ept_cap_detect
- :acrn-commit:`bacfc9b2` dm: fix use of uninitialized variable in monitor.c
- :acrn-commit:`6793eb06` dm: fix assertion in pci_irq_reserve
- :acrn-commit:`e0728f4b` DM USB: xHCI: fix a crash issue when usb device is disconnected
- :acrn-commit:`2b53acb5` HV:change the return type of sbuf_get and sbuf_put
- :acrn-commit:`c5f4c510` HV:fix type related violations
- :acrn-commit:`723c22fc` HV:fix expression is not boolean
- :acrn-commit:`25db6b79` IOC Mediator: Replace strtok with strsep
- :acrn-commit:`69edccc0` IOC Mediator: Add return value check for snprintf
- :acrn-commit:`cc89e52d` hv: mmu: make page table operation no fault
- :acrn-commit:`1e084b08` hv: mmu: invalidate cached translation information for guest
- :acrn-commit:`2b24b378` hv: mmu: add some API for guest page mode check
- :acrn-commit:`9fd87812` IOC Mediator: fix multi-signal parsing issue
- :acrn-commit:`b1b3f76d` dm: virtio: use strnlen instead of strlen
- :acrn-commit:`9bf5aafe` script: workarounds for UOS of 4.19-rc kernel
- :acrn-commit:`b5f77070` dm: vpit: add vPIT support
- :acrn-commit:`0359bd0f` dm: vpit: add PIT-related header files
- :acrn-commit:`eff2ac7a` hv: Remove vm_list
- :acrn-commit:`b8e59e16` hv:Replace dynamic memory with static for vm
- :acrn-commit:`ff3f9bd1` hv: Remove const qualifier for struct vm
- :acrn-commit:`5b28b378` hv: Fix for PARTITION_MODE compilation
- :acrn-commit:`eebccac2` hv: add suffix(U) in vmx.h to come up MISRA-C
- :acrn-commit:`8787b65f` dm: fix the issue when guest tries to disable memory range access
- :acrn-commit:`be0cde7d` Revert "dm: workaround for DM crash when doing fastboot reboot"
- :acrn-commit:`b115546b` crashlog: deprecate acrnprobe_prepare and update Makefile
- :acrn-commit:`f3fc857f` crashlog: introducing crashlogctl
- :acrn-commit:`b1a05d17` crashlog: re-write usercrash-wrapper
- :acrn-commit:`6981a4df` crashlog: do not alter system behavior with watchdog
- :acrn-commit:`d800baf5` doc: tweak hld intro
- :acrn-commit:`1e385441` doc: reorganize HLD docs
- :acrn-commit:`8e21d5ee` doc: update genrest script for latest kconfiglib
- :acrn-commit:`1c0a0570` doc: update genrest script for latest kconfiglib
- :acrn-commit:`16575441` dm: vrtc: add memory configuration in RTC CMOS
- :acrn-commit:`373e79bb` Getting Started Guide: add instructions to disable cbc_* services
- :acrn-commit:`76987149` Getting Started Guide: minor clean-up
- :acrn-commit:`ce961e79` dm: acpi: set SCI_INT polarity to high active
- :acrn-commit:`064e5344` vuart: use pulse irq to assert COM1_IRQ
- :acrn-commit:`099203c1` ptdev: assert/deassert interrupt according to polarity
- :acrn-commit:`e49233ba` ioapic: set default polarity setting as high active
- :acrn-commit:`3b88d3c2` vioapic: add pin_state bitmap to set irq
- :acrn-commit:`ba68bd41` DM USB: xHCI: fix enumeration error after rebooting
- :acrn-commit:`4544d28e` hv: fix 'User name starts with underscore'
- :acrn-commit:`390861a0` DM: increase UOS memory size for MRB
- :acrn-commit:`39d54c87` EFI: Disable RELOC by default temporary
- :acrn-commit:`072e77e7` DM: Disable plane_restriction on 4.19 kernel
- :acrn-commit:`5a64af20` DM: Use the pass-through mode for IPU on 4.19 kernel
- :acrn-commit:`38099e4b` DM: Add the boot option to avoid loading dwc3_pci USB driver
- :acrn-commit:`c7611471` hv: modify static irq mappings into array of structure
- :acrn-commit:`1c0a3d9a` hv: Add API to set vcpu register
- :acrn-commit:`0e0dbbac` hv: Move the strcut acrn_vcpu_regs to public header file
- :acrn-commit:`572b59ff` doc: fix doxygen error in hypercall.h
- :acrn-commit:`6c9bae61` DM USB: xHCI: fix USB hub disconnection issue
- :acrn-commit:`0d4a88e6` DM USB: xHCI: change logic of binding libusb to native device
- :acrn-commit:`2d00a99a` DM USB: xHCI: refine stop endpoint logic
- :acrn-commit:`adc79137` hv: efi_context refine
- :acrn-commit:`ba1aa407` hv: add struct acrn_vcpu_regs
- :acrn-commit:`843f7721` hv: Change the struct cpu_gp_regs name to acrn_gp_regs
- :acrn-commit:`b207f1b9` hv: struct seg_desc_vmcs name change
- :acrn-commit:`5c923296` hv:clear up the usage of printf data struct
- :acrn-commit:`965f8d10` hv: fix irq leak for MSI IRQ
- :acrn-commit:`67ff326e` hv: retain the timer irq
- :acrn-commit:`07e71212` hv:Replace dynamic memory allocation for vuart
- :acrn-commit:`7ce0e6a3` hv:Clear up printf related definition
- :acrn-commit:`ed06b8a7` hv: fix 'Void procedure used in expression'
- :acrn-commit:`9a05fbea` HV: remove IRQSTATE_ASSERT/IRQSTATE_DEASSERT/IRQSTATE_PULSE
- :acrn-commit:`9df8790f` hv: Fix two minor issues in instruction emulation code
- :acrn-commit:`be0651ad` Getting Started Guide: fix highlighting in launch_uos.sh
- :acrn-commit:`37014caa` Documentation: add pointer to the documentation generation in GSG
- :acrn-commit:`7b26b348` Documentation: update list of bundles to be installed in GSG
- :acrn-commit:`f45c3bd2` Documentation: add instruction to use a specific version of Clear
- :acrn-commit:`398ac203` Update acrn_vm_ops.c
- :acrn-commit:`e6c3ea3b` tools: acrn-manager: init vmmngr_head with LIST_HEAD_INITIALIZER
- :acrn-commit:`7b0b67df` dm: virtio-net: add vhost net support
- :acrn-commit:`3fdfaa3d` dm: virtio: implement vhost chardev interfaces
- :acrn-commit:`e3f4e34c` dm: virtio: implement vhost_vq_register_eventfd
- :acrn-commit:`150ad30b` dm: virtio: implement vhost_set_mem_table
- :acrn-commit:`befbc3e9` dm: virtio: implement vhost_vq interfaces
- :acrn-commit:`bb34ffe6` dm: virtio: add vhost support
- :acrn-commit:`781e7dfb` dm: virtio: rename virtio ring structures and feature bits
- :acrn-commit:`dd6a5fbe` HV: Add hypercall to set/clear IRQ line
- :acrn-commit:`05ad6d66` hv: drop the macro arguments acting as formal parameter names
- :acrn-commit:`74622d7d` hv: merge hv_lib.h and hypervisor.h
- :acrn-commit:`3178ecea` hv: Fix the warning for ACRN release build
- :acrn-commit:`6bcfa152` hv: Enable the compiler warning as error for HV
- :acrn-commit:`2111fcff` hv: vtd: add config for bus limitation when init
- :acrn-commit:`6fcaa1ae` hv: bug fix in atomic.h
- :acrn-commit:`026ae83b` hv: include: fix 'Unused procedure parameter'
- :acrn-commit:`68ce114b` doc: add tool for verifying installed doc tools
- :acrn-commit:`c30437de` Fix Doxygen comment in hypercall.h header file
- :acrn-commit:`56992c73` dm: combine VM creating and ioreq shared page setup
- :acrn-commit:`94513ab7` dm: Add vhm ioeventfd and irqfd interfaces
- :acrn-commit:`a189be26` HV: Add one hcall to set the upcall vector passed from sos_kernel
- :acrn-commit:`22869913` HV: Add the definition of VECTOR_HYPERVISOR_CALLBACK_VHM
- :acrn-commit:`a8e688eb` HV: Use the variable to fire VHM interrupt
- :acrn-commit:`89ca54ca` hv:Fix unused var value on all paths
- :acrn-commit:`f1cce671` Makefile: fix cross-compiling issues
- :acrn-commit:`8787c06d` hv: arch: fix 'Unused procedure parameter'
- :acrn-commit:`2908f09f` hv: fix ramdump regression
- :acrn-commit:`52ee6154` tools: acrnlog: update Makefile
- :acrn-commit:`74c4d719` tools: acrnlog: fix several compiler warnings
- :acrn-commit:`c51e2139` tools: acrntrace: update Makefile
- :acrn-commit:`5e0acac4` tools: acrntrace: fix several compiler warnings
- :acrn-commit:`1b9a3b3e` tools: acrn-manager: update Makefile
- :acrn-commit:`227a8c43` tools: acrn-manager: fix warnings before updating Makefile
- :acrn-commit:`270a8332` tools: acrnd: bugfix: service lack of prerequisition
- :acrn-commit:`5affe53a` tools: acrn-crashlog: update Makefile flags
- :acrn-commit:`726711e2` tools: acrn-crashlog: fix some compiler warnings
- :acrn-commit:`4e17d207` hv: fix 'Static procedure is not explicitly called in code analyzed'
- :acrn-commit:`ac9ebc5e` update to support v0.2 release
- :acrn-commit:`71b047cb` hv: fix 'Switch case not terminated with break'
- :acrn-commit:`f3758850` dm: virtio_net: remove netmap/vale backend support
- :acrn-commit:`e0973e48` hv: ioapic: convert some MACROs to inline functions
- :acrn-commit:`99ed5469` DM: add a thread to monitor UOS ptdev intr status
- :acrn-commit:`d123083f` HV: add hypercall to monitor UOS PTdev intr status
- :acrn-commit:`918403f9` HV: modify code for intr storm detect & handling
- :acrn-commit:`de68ee7a` version: 0.3-unstable

445
doc/release_notes/release_notes_0.4.rst
View File

@ -1,445 +0,0 @@
.. _release_notes_0.4:
ACRN v0.4 (Dec 2018)
####################
We are pleased to announce the release of Project ACRN version 0.4.
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline
embedded development through an open source platform. Check out the
:ref:`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, and documentation.
You can either download this source code as a zip or tar.gz file (see
the `ACRN v0.4 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v0.4>`_ or
use Git clone and checkout commands:
.. code-block:: bash
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v0.4
The project's online technical documentation is also tagged to correspond
with a specific release: generated v0.4 documents can be found at
https://projectacrn.github.io/0.4/. Documentation for the latest
(master) branch is found at https://projectacrn.github.io/latest/.
Version 0.4 New Features
************************
- :acrn-issue:`1824` - implement "wbinvd" emulation
- :acrn-issue:`1859` - Doc: update GSG guide to avoid issue "black screen"
- :acrn-issue:`1878` - The "Using Ubuntu as the Service OS" tutorial is outdated and needs to be refreshed
- :acrn-issue:`1926` - `kernel-doc` causing `make doc` failure (because of upcoming Perl changes)
- :acrn-issue:`1927` - Simplify the `launch_uos.sh` script by pointing at the latest iot-lts2018 kernel by default
Fixed Issues
************
- :acrn-issue:`677` - SSD Disk ID is not consistent between SOS/UOS
- :acrn-issue:`1777` - After UOS plays video for several minutes, the UOS image will be stagnant
- :acrn-issue:`1778` - MSDK: 1080p H264 video decode fails in UOS
- :acrn-issue:`1779` - gfxbench cannot run in SOS&UOS
- :acrn-issue:`1781` - Can not recognize the SD card in the SOS
- :acrn-issue:`1792` - System hang and reboot after run "LaaG Forced GPU Reset: subtest error-state-capture-vebox" in UOS
- :acrn-issue:`1794` - After SOS boots up, there's no output on SOS screen
- :acrn-issue:`1795` - SOS fails to get IP address
- :acrn-issue:`1825` - Need to clear memory region used by UOS before it exit
- :acrn-issue:`1837` - 'acrnctl list' shows incomplete VM names
Known Issues
************
:acrn-issue:`1319` - SD card pass-through: UOS can't see SD card after UOS reboot.
SD card could not be found after UOS reboot in pass-through mode.
**Impact:** There is no SD card after UOS reboot.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1773` - USB Mediator: Can't find all devices when multiple usb devices connected[Reproduce rate:60%]
After booting UOS with multiple USB devices plugged in, there's a 60% chance that
one or more devices are not discovered.
**Impact:** Cannot use multiple USB devices at same time.
**Workaround:** Unplug and plug-in the unrecognized device after booting.
:acrn-issue:`1774` - UOS can't stop by command: acrnctl stop [vm name] in SOS
After launching UOS in SOS by "acrnctl start" command, UOS VM failed
to be stopped by "acrnctl stop" command.
**Impact:** Can't stop UOS in SOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1775` - [APL UP2]ACRN debugging tool - acrntrace cannot be used in SOS
There are no acrntrace devices "acrn_trace*" under SOS /dev.
**Impact:** acrntrace cannot be used in SOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1776` - [APL UP2]ACRN debugging tool - acrnlog cannot be used in SOS
There are no acrnlog devices "acrn_hvlog*" under SOS /dev.
**Impact:** acrnlog cannot be used in SOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1780` - Some video formats cannot be played in SOS
Video files with these encodings are not supported in the SOS:
H265_10bits, VP8, VP9, VP9_10bits, H265.720p.
**Impact:** Cannot play those formats of videos in SOS.
**Workaround:** None. The issues will be fixed in the next release.
:acrn-issue:`1782` - UOS failed to get IP address with the pass-through network card
After a network card is pass-through to UOS, it fails to get an IP address in UOS.
**Impact:** Cannot use network in UOS.
**Workaround:** None. The issues will be fixed in the next release.
:acrn-issue:`1796` - APL NUC fails to reboot sometimes
After APL NUC boots to SOS, the "reboot" command sometimes fails to reboot the SOS.
**Impact:** Cannot reboot SOS.
**Workaround:** Power off and boot again. The issues will be fixed in the next release.
:acrn-issue:`1986` - UOS will hang once watchdog reset triggered
If Launching UOS with "-s 8,wdt-i6300esb", UOS will hang if the watchdog reset is triggered.
**Impact:** UOS cannot self-recover after a watchdog reset is triggered.
**Workaround:** None.
:acrn-issue:`1987` - UOS will have same MAC address after launching UOS with virio-net
After launching UOS with virio-net, UOS on different devices have the same MAC address.
**Impact:** A UOS network conflict will exist.
**Workaround:** None. This issues will be fixed in next release.
:acrn-issue:`1991` - Input is useless in UART Console for corner case
Input is useless in UART Console for a corner case,
demonstrated with these steps:
1) Boot to SOS
2) ssh into the SOS.
3) use "./launch_UOS.sh" to boot UOS.
4) On the host, use "minicom -s dev/ttyUSB0".
5) Use "sos_console 0" to launch SOS.
**Impact:** Failed to use UART for input in corner case.
**Workaround:** Enter other keys before typing :kbd:`Enter`.
:acrn-issue:`1996` - There is an error log when using "acrnd&" to boot UOS
An error log is printed when starting acrnd as a background job
(``acrnd&``) to boot UOS. The UOS still boots up
normally, but prints: "Failed to open the socket(sos-lcs) to query the reason for the wake-up.
Activating all vms when acrnd & to boot uos."
**Impact:** UOS boots normally, but prints an error log message.
**Workaround:** None.
:acrn-issue:`2000` - After launching UOS with Audio pass-through, Device (I2C0) doesn't exist in UOS DSDT.dsl
After launching UOS with Audio pass-through, Device (I2C0) doesn't exist in UOS DSDT.dsl
**Impact:** Cannot use Audio device
**Workaround:** None.
:acrn-issue:`2030` - UP2 fails to boot with uart=disabled for hypervisor
SOS boots up fail following GSG document guide.
**Impact:** SOS boots up fail on APL UP2
**Workaround:** A step-by-step workaround has been updated in Github issue.
:acrn-issue:`2031` - UP2 serial port has no output with uart=mmio@0x91622000 for hypervisor
After SOS starts, there's no display on the screen. Though ssh connection is successful, the serial port has no output.
**Impact:** UP2 serial port has no output
**Workaround:** A step-by-step workaround has been updated in Github issue.
.. comment
Use the syntax:
:acrn-issue:`663` - Short issue description
Longer description that helps explain the problem from the user's
point of view (not internal reasons). **Impact:** What's the
consequences of the issue, and how it can affect the user or system.
**Workaround:** Describe a workaround if one exists (or refer them to the
:acrn-issue:`663`` if described well there. If no workaround, say
"none".
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v0.3
release in Nov 2018 (click on the CommitID link to see details):
.. comment
This list is obtained from the command:
git log --pretty=format:'- :acrn-commit:`%h` %s' --after="2018-03-01"
- :acrn-commit:`7ee0e2e2` tools: acrnctl: Fix path error when run "acrnctl add" cmd
- :acrn-commit:`9761eede` hv: cleanup IA32_PAT emulation code r.w.t. to the refactored guest_msrs[]
- :acrn-commit:`b6aaf1b8` hv: MSRs may need isolation between normal and secure world
- :acrn-commit:`92bbb545` hv: rearrange data structure for emulated MSRs
- :acrn-commit:`7fce2462` dm: apply new mevent API to avoid race issue in mei
- :acrn-commit:`64d9c59a` dm: enhance the mevent API
- :acrn-commit:`eec3a342` dm: fix the race issue in mevent_del
- :acrn-commit:`87e7bdb9` DM: updating launch_uos.sh
- :acrn-commit:`9e0562f4` hv: add obvious comment for empty else clause following else if
- :acrn-commit:`d36b44f2` hv: avoid to use ``++`` or ``--`` operators in an expression
- :acrn-commit:`f33edc67` hv: fix reference parameter to procedure is reassigned
- :acrn-commit:`36be890e` hv: fix included file not protected with #define
- :acrn-commit:`ae9d4361` hv: minimize the case of "identifier reuse"
- :acrn-commit:`3afc5113` hv: acpi: remove weak parse_madt
- :acrn-commit:`c616a422` hv: fix string assigned to non const object
- :acrn-commit:`c3799146` hv: remove "i915.enable_initial_modeset"
- :acrn-commit:`c3c93202` hv: fix "Array has no bounds specified" in vmsr.c
- :acrn-commit:`01cb6ba8` hv: fix one MISRA-C violation in mtrr.c
- :acrn-commit:`fe1ace4f` doc: fix doc misspellings
- :acrn-commit:`fa99dba3` Update doc/getting-started/apl-nuc.rst
- :acrn-commit:`f657f401` doc: update gsg to adapt latest release
- :acrn-commit:`e24039a7` doc: tweak CSS for doxygen API usability
- :acrn-commit:`3ca64c5b` dm: add "break" removed by mistake.
- :acrn-commit:`908acb50` hv: add 'no-omit-frame-pointer' in debug version
- :acrn-commit:`9bb16bce` hv: fix type conversion without cast with explicit conversion
- :acrn-commit:`79463fd5` hv: avoid using of mixed mode arithmetic
- :acrn-commit:`9c133c7b` hv: lib: refine print_decimal
- :acrn-commit:`7a62154e` hv: remove the theoretic infinite loop
- :acrn-commit:`5d19962d` security: remove cflag _FORTIFY_SOURCE in hypervisor
- :acrn-commit:`d737d6e6` tools: acrnlog: give user hint when acrn hvlog devices not found
- :acrn-commit:`d85a0b70` tools: acrntrace: give user hint when acrn trace devices not found
- :acrn-commit:`9ea93ce6` hv: x2APICv support on platforms without support for APICv reg virtualization
- :acrn-commit:`9d4b5d7e` DM USB: add some preparing time for xHCI emulation before resuming.
- :acrn-commit:`b159d66f` DM USB: refine the polling thread for libusb events
- :acrn-commit:`966c5872` DM USB: xHCI: fix potential NULL pointer issue.
- :acrn-commit:`5b39fd0e` DM USB: xHCI: fix error logic of allocating xHCI slot
- :acrn-commit:`32c4ce9b` DM USB: xHCI: refine the xHCI S3 process
- :acrn-commit:`9e471d72` DM USB: xHCI: refine the PLC bit emulation logic during S3
- :acrn-commit:`29e81501` DM USB: xHCI: refine error handling logic for ctrl transfer
- :acrn-commit:`f73cf211` hv: fix 'Unused procedure parameter'
- :acrn-commit:`b261e74d` dm: virtio poll mode support for RT
- :acrn-commit:`7cc8566d` hv: fixes related to unused API and uninitialized variable
- :acrn-commit:`f0d3f1c9` HV: Remove some comments for crypto library
- :acrn-commit:`d7232ebb` hv: trusty: refine struct trusty_mem
- :acrn-commit:`5fd6021d` doc: hv: add comments to timer APIs for documentation
- :acrn-commit:`2dbb0cba` doc: fix citation references in modularity doc
- :acrn-commit:`e2a8989f` doc: add a document on considerations and current status of hypervisor modularization
- :acrn-commit:`3b54dd2a` doc: add some "sudo" for code
- :acrn-commit:`945fdd8a` doc: update the directory to "~/"
- :acrn-commit:`0ff74b13` doc: delete "install build tool" about
- :acrn-commit:`1a959d0f` doc: Update note for the directory of UOS image
- :acrn-commit:`e2e9a3e9` doc: Add the note for the directory of UOS image
- :acrn-commit:`10522423` doc: add note for the directory of UOS image
- :acrn-commit:`099c605e` doc: Modify to "/boot/efi"
- :acrn-commit:`ceed3106` Update using_ubuntu_as_sos.rst
- :acrn-commit:`b1db77eb` doc: Update the grub part and add code for NVMe
- :acrn-commit:`4b2e7f11` Delete AGL about
- :acrn-commit:`be70145f` Delete AGL about
- :acrn-commit:`96a2946d` Delete AGL about
- :acrn-commit:`6c8c46af` delete AGL about
- :acrn-commit:`ce89d26e` Delete using_AGL_as_uos.rst
- :acrn-commit:`3d96e356` Rename using_AGL_as_uos to using_AGL_as_uos.rst
- :acrn-commit:`90c27157` Create using AGL as UOS
- :acrn-commit:`2bc24f87` Upload the images for "using_AGL_as_uos"
- :acrn-commit:`12e66b98` Update using_ubuntu_as_sos.rst
- :acrn-commit:`ecff0bf9` Update the layout of packages
- :acrn-commit:`50f17832` Update using_ubuntu_as_sos.rst
- :acrn-commit:`1afb0f13` Update using_ubuntu_as_sos.rst
- :acrn-commit:`06b2ab55` Update using_ubuntu_as_sos.rst
- :acrn-commit:`e4941b22` Update using_ubuntu_as_sos.rst
- :acrn-commit:`65f21a77` Update the version of Ubuntu to 18.04
- :acrn-commit:`abfa1c16` update the length of *
- :acrn-commit:`1664ba5f` Update using_ubuntu_as_sos.rst
- :acrn-commit:`f3527c63` Update using_ubuntu_as_sos.rst
- :acrn-commit:`e4b616d5` Update using_ubuntu_as_sos.rst
- :acrn-commit:`ab005bc8` Update using_ubuntu_as_sos.rst
- :acrn-commit:`2d685a13` Update with Clear Linux 26440
- :acrn-commit:`b38629b8` hv: fix 'Space missing before or after binary operator'
- :acrn-commit:`e32b2b4c` hv: remove dead code
- :acrn-commit:`42e38dfb` hv: fix "No prototype for non-static function"
- :acrn-commit:`48b3cd92` hv: fix "Expression is not boolean"
- :acrn-commit:`11102cfa` hv: change the param type of mmio_write**
- :acrn-commit:`daaff433` doc: upload the images of UP2's serial port
- :acrn-commit:`592bd513` doc: update the serial port part of UP2
- :acrn-commit:`dd43f3ba` hv: replace CPU_PAGE_MASK with PAGE_MASK
- :acrn-commit:`0f766ca6` hv: replace CPU_PAGE_SHIFT with PAGE_SHIFT
- :acrn-commit:`2f15d356` hv: replace CPU_PAGE_SIZE with PAGE_SIZE
- :acrn-commit:`e8e25bd6` hv: clean up function definitions in sbuf.h
- :acrn-commit:`e7d1cdd9` HV: remove ignored pci device from acrn.conf
- :acrn-commit:`e2d09398` DM: remove ignored pci device from SOS bootargs
- :acrn-commit:`db4254e2` HV: find and hide serial PCI dev from service OS
- :acrn-commit:`8d08ec30` HV: replace serial PCI MMIO base with BDF config
- :acrn-commit:`10bde520` hv: other: fix "Procedure has more than one exit point"
- :acrn-commit:`fe3de679` hv: debug: fix "Procedure has more than one exit point"
- :acrn-commit:`414860fb` hv: dev: fix "Procedure has more than one exit point"
- :acrn-commit:`ba44417d` hv: lib: fix "Procedure has more than one exit point"
- :acrn-commit:`279808b2` hv: memory: fix "Procedure has more than one exit point"
- :acrn-commit:`ddb54836` hv: cpu: fix "Procedure has more than one exit point"
- :acrn-commit:`7f08ad83` use 4 vqs
- :acrn-commit:`33362968` change the vq count and vendor id
- :acrn-commit:`d495732c` hv: remove unused flags related APIs in sbuf
- :acrn-commit:`aa9af273` modularization: boot component
- :acrn-commit:`b54f2331` modularization: boot component -- move functions
- :acrn-commit:`51bfafd6` modularization: boot component -- move functions
- :acrn-commit:`512dbb61` Kconfig: remove PLATFORM configuration option
- :acrn-commit:`7eeeccdf` Documentation: add more Kconfig options documentation
- :acrn-commit:`e1564edd` hv: fix type conversion violations
- :acrn-commit:`a0582c99` hv: trusty: refine trusty memory region mapping
- :acrn-commit:`bd1c0838` hv: trusty: reserve memory for trusty
- :acrn-commit:`9bf7dd5d` Enable audio virtualization for AaaG
- :acrn-commit:`79bf121e` hv: throw GP for MSR accesses if they are disabled from guest CPUID
- :acrn-commit:`3836d309` hv: code cleanup: vmsr.c
- :acrn-commit:`36ba7f8a` hv: clear CPUID.07H.EBX[2] to disable SGX from guests
- :acrn-commit:`26dc54ce` HV: allow disabling serial port via Kconfig
- :acrn-commit:`584f6b72` doc: replace return with retval
- :acrn-commit:`97eb72a4` doc: always use 'None' for functions not returning a value
- :acrn-commit:`cbe1b74e` HDCP virtio back-end driver
- :acrn-commit:`fa012e69` CoreU virtio back-end driver
- :acrn-commit:`7003afbe` hv: msix: fix bug when check if msix table access
- :acrn-commit:`5dcfc133` hv:Rename ptdev to ptirq for some APIs
- :acrn-commit:`5b43aa8a` hv:Rename ptdev to ptirq for some variables and structures
- :acrn-commit:`10afa9bb` HV: io: obsolete the valid field in vhm requests
- :acrn-commit:`db3c5746` hv: fix 'Function return value potentially unused'
- :acrn-commit:`e0260b44` doc: add sphinx extension improving only directive
- :acrn-commit:`0bc85d2e` modularization: boot component - move files
- :acrn-commit:`667e0444` hv: vpic: fix "Procedure has more than one exit point"
- :acrn-commit:`17a6d944` hv: guest: fix "Procedure has more than one exit point"
- :acrn-commit:`c32d41a0` hv: irq: fix "Procedure has more than one exit point"
- :acrn-commit:`8dfb9bd9` hv: dm: fix "Procedure has more than one exit point"
- :acrn-commit:`ab3d7c87` hv: boot: fix "Procedure has more than one exit point"
- :acrn-commit:`a1ac585b` hv: add brackets to make operator expression more readable
- :acrn-commit:`aefe9168` Update 'launch_uos.sh' script for UEFI platforms
- :acrn-commit:`839680f0` DM: build TPM2 ACPI table when TPM device enabled
- :acrn-commit:`aae70db6` DM: Add support for virtual TPM enabling
- :acrn-commit:`7df90a25` DM: Support TPM2 CRB device virtualization
- :acrn-commit:`4b83e37c` DM: tpm emulator to communicate with swtpm
- :acrn-commit:`1ba7cebb` Update tools/README.rst
- :acrn-commit:`419feb1a` Documentation: add a README.rst to the tools/ folder
- :acrn-commit:`6d6c5b95` [doc] Enhance Using partition mode on UP2 tutorial
- :acrn-commit:`d3d474cf` Documentation generation: update kernel-doc script to latest
- :acrn-commit:`2d2f96af` hv: clean up function definitions in profiling.h
- :acrn-commit:`14f30a23` hv: clean up function definitions in npk_log.h
- :acrn-commit:`07956605` hv: clean up function definitions in trace.h
- :acrn-commit:`637326bc` hv: clean up function definitions in vuart.h
- :acrn-commit:`7b74b2b9` hv: clean up function definitions in console.h
- :acrn-commit:`649d0e32` hv: clean up function definitions in dump.h
- :acrn-commit:`8920fbac` hv: clean up function definitions in logmsg.h
- :acrn-commit:`5b6c611a` hv: msix: fix "Procedure has more than one exit point"
- :acrn-commit:`2f33d1bc` tools: acrn-manager: Fix acrnctl mistake displaying suspended to paused
- :acrn-commit:`e1d0f7e4` hv: instr_emul: fix decode_modrm no default case in switch statement
- :acrn-commit:`042c3935` hv: trusty: fix get_max_svn_index return type inconsistent
- :acrn-commit:`c200c984` hv: include: remove name starts with underscore
- :acrn-commit:`0100b5a2` HV: replace dynamic memory with static for crypto library
- :acrn-commit:`2afa7173` hv: vlapic: fix "Procedure has more than one exit point"
- :acrn-commit:`3d1332f3` tools: acrn-crashlog: refine the log storage
- :acrn-commit:`06efc58a` hv: assign: clean up HV_DEBUG usage related to vuart pin
- :acrn-commit:`c380ee9e` hv:Revise sanitized page size
- :acrn-commit:`a5fd5524` debug: rename struct logmsg to struct acrn_logmsg_ctl
- :acrn-commit:`e555f75b` debug: Remove early logbuf support
- :acrn-commit:`9f13a51e` hv: hypercall: VM management fix "Procedure has more than one exit point"
- :acrn-commit:`a7398e8a` hv: hypercall: general fix "Procedure has more than one exit point"
- :acrn-commit:`b627c2c9` hv: switch IA32_TSC_AUX between host/guest through VM Controls
- :acrn-commit:`d0b37f8e` hv: reloc: define data structure and MACRO when necessary
- :acrn-commit:`d043171d` IOC mediator: Add VehicalSteeringWheelAngle signal to the whitelist
- :acrn-commit:`580579a3` dm: mei: Use compare and swap primitive for refcnt.
- :acrn-commit:`b1047224` hv: assign: clean up HV_DEBUG usage related to shell
- :acrn-commit:`f21e36f4` hv: vioapic: clean up HV_DEBUG usage
- :acrn-commit:`a9312298` hv: irq: clean up HV_DEBUG usage
- :acrn-commit:`dfe48811` hv: vcpu: clean up HV_DEBUG usage
- :acrn-commit:`e49929a7` hv: ioapic: clean up HV_DEBUG usage
- :acrn-commit:`9d529fb9` hv:use copy of guest's memory block in 'hcall_set_vm_memory_regions()'
- :acrn-commit:`81db2422` hv: enhance Makefile to compile debug/release into 2 libraries
- :acrn-commit:`19b35f97` acrn-dm: wait for monitor thread canceling finish
- :acrn-commit:`02a89dd4` hv: lapic: fix a theoretic infinite loop when clear lapic isr
- :acrn-commit:`dbe3d986` hv: lapic: save lapic base MSR when suspend
- :acrn-commit:`b8a553d1` hv: lapic: remove union apic_lvt
- :acrn-commit:`538ba08c` hv:Add vpin to ptdev entry mapping for vpic/vioapic
- :acrn-commit:`297a264a` hv:Cleanup ptdev lock
- :acrn-commit:`b7bbf812` hv:Replace dynamic memory with static for ptdev
- :acrn-commit:`b0e1657b` HV: Adding partition mode support for cb2_dnv
- :acrn-commit:`664bc1ba` HV: Partition mode source code file layout reorg
- :acrn-commit:`031191db` dm: apl-mrb: launch_uos: remove mei debug flags
- :acrn-commit:`378afc50` dm: mei: fix clients scan in sysfs
- :acrn-commit:`7bd2976f` dm: mei: add zero termination to devpath
- :acrn-commit:`87fbb700` dm: mei: fix double fw_reset on uos reboot
- :acrn-commit:`844553ef` dm: mei: check for state before link reset callback
- :acrn-commit:`58ab26ea` hv: code cleanup: msr.h
- :acrn-commit:`e8296dce` hv: Add IO request completion polling feature
- :acrn-commit:`e350abe4` HV: handle adding ptdev entry failure cases
- :acrn-commit:`fe08a44e` hv: doc: use doxygen-generated API docs in HLD for passthru
- :acrn-commit:`973c616a` doc: passthru: add structure and API docs
- :acrn-commit:`4ec4ddc0` Documentation: clean-up of isolated README.rst files
- :acrn-commit:`29f95021` hv: vtd: error handling revisit
- :acrn-commit:`c4490028` hv: vtd: defer dma remapping enabling until vm creation
- :acrn-commit:`42e0e169` hv: vtd: init interrupt config when resume
- :acrn-commit:`830b3aa0` hv: vtd: check vtd enabling status with spinlock
- :acrn-commit:`a2cb9c2b` hv: vtd: add do_action_for_iommus
- :acrn-commit:`32ed3d1a` hv: vtd: move public API to the bottom part of the file
- :acrn-commit:`efb24923` hv: vtd: merge lines for a statement if needed.
- :acrn-commit:`e35a8e8c` hv: vtd: typo fix
- :acrn-commit:`611944c0` dm: Fix race between ioreq client destroy and access
- :acrn-commit:`3b24c34c` hv: msix: correctly determine when the guest is changing Message Data/Addr
- :acrn-commit:`c41c0dab` hv: properly initialize MSI-X table
- :acrn-commit:`53971e19` hv: fix 2 bugs in msix.c
- :acrn-commit:`119eccfe` hv: hypercall: clean up HV_DEBUG usage
- :acrn-commit:`fc9ec5d8` hv: Derive decryption key from Seed for Trusty to decrypt attestation keybox
- :acrn-commit:`7978188c` tools: acrn-manager: set MAX_NAME_LEN to 32
- :acrn-commit:`5d013ed2` hv: vpci: revert the temporary workaround of handling I/O port CF9
- :acrn-commit:`fe9a340e` hv: separate the PCI CONFIG_ADDR and CONFIG_DATA I/O port handlers
- :acrn-commit:`8b4f3956` hv: PIO emulation handler is attached to I/O port number only
- :acrn-commit:`2c581751` vmx: tiny fix for MACRO name and print format
- :acrn-commit:`9c025190` hv: hv_main: clean up HV_DEBUG usage
- :acrn-commit:`1018a31c` HV: For NUC, use 0x3F8/IRQ4 as the vuart port base address/IRQ and use ttyS0 accordingly
- :acrn-commit:`e56a6b58` HV: For MRB, use 0x3E8/IRQ6 as the vuart port base address/IRQ.
- :acrn-commit:`3b87e7c6` HV: Add vuart port base address/IRQ Kconfig options
- :acrn-commit:`b32e689a` hypervisor: use "wbinvd" carefully in RT environment
- :acrn-commit:`61e6c1f0` hv: reset VM ioreqs in reset_vm
- :acrn-commit:`2fa67a44` HV: clear memory region used by UOS before it exit
- :acrn-commit:`8fa16211` hv: partition mode also needs free vm id when shutdown vm
- :acrn-commit:`9dacc4a5` tools:acrn-crashlog:fix potential issue
- :acrn-commit:`6971cc83` hv: fix '(void) missing for discarded return value'
- :acrn-commit:`a646fcf7` hv: fix 'No brackets to then/else' in vpci code
- :acrn-commit:`bad813ea` hv: fix MISRA-C violations in vpci code: Function pointer is of wrong type
- :acrn-commit:`d3f0edfe` hv: fix MISRA-C violations in vpci code: 93S, 331S and 612S
- :acrn-commit:`f84f1a21` hv: fix MISRA-C violations in vpci code: implicit conversion
- :acrn-commit:`d97224a4` hv: fix integer violations
- :acrn-commit:`7e6d0a21` HV:pic fix "Recursion in procedure calls found"
- :acrn-commit:`0a9d6841` hv: instr_emul: clean up mmio_read/mmio_write
- :acrn-commit:`2c7c909e` hv: vtd: fix the pre-allocated context table number
- :acrn-commit:`3731b4c0` hv: fix '(void) missing for discarded return value'
- :acrn-commit:`b3b24320` hv: fix possible inconsistent issue for 'vm->hw.create_vcpus'
- :acrn-commit:`7bb09f75` fix "Procedure is not pure assembler"
- :acrn-commit:`91fb441d` hv:add global lock for VM & vCPU management hypercalls
- :acrn-commit:`15567535` hv: unify the function pointer assignment
- :acrn-commit:`9a009bce` hv:Replace dynamic memory with static for mmio
- :acrn-commit:`b5505c43` doc: tweaks to 0.3 release notes
- :acrn-commit:`a0345279` DM: update User OS launch script with v0.3 CL and kernel numbers
- :acrn-commit:`1847497d` Documentation: update GSG for release 0.3
- :acrn-commit:`33137dc9` Documentation: adjust "Tracked-On" capitalization in documentation
- :acrn-commit:`f0ec5b26` doc: add Makefile option for singlehtml
- :acrn-commit:`d62196ac` version: 0.4-unstable

569
doc/release_notes/release_notes_0.5.rst
View File

@ -1,569 +0,0 @@
.. _release_notes_0.5:
ACRN v0.5 (Jan 2019)
####################
We are pleased to announce the release of Project ACRN version 0.5.
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline
embedded development through an open source platform. Check out the
:ref:`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, and documentation.
You can either download this source code as a zip or tar.gz file (see
the `ACRN v0.5 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v0.5>`_ or
use Git clone and checkout commands:
.. code-block:: bash
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v0.5
The project's online technical documentation is also tagged to correspond
with a specific release: generated v0.5 documents can be found at
https://projectacrn.github.io/0.5/. Documentation for the latest
(master) branch is found at https://projectacrn.github.io/latest/.
Version 0.5 New Features
************************
**OVMF support initial patches merged in ACRN**:
To support booting Windows as a Guest OS, we are
using Open source Virtual Machine Firmware (OVMF).
Initial patches to support OVMF have been merged in ACRN hypervisor.
More patches for ACRN and patches upstreaming to OVMF work will be continuing.
**UP2 board serial port support**:
This release enables serial port debugging on UP2 boards during SOS and UOS boot.
**One E2E binary to support all UEFI platform**:
ACRN can support both Apollo Lake (APL) and Kaby Lake (KBL) NUCs.
Instead of having separate builds, this release offers community
developers a single end-to-end reference build that supports both
UEFI hardware platforms, configured with a new boot parameter.
See :ref:`getting_started` for more information.
**APL UP2 board with SBL firmware**: With this 0.5 release, ACRN
now supports APL UP2 board with slim Bootloader (SBL) firmware.
Slim Bootloader is a modern, flexible, light-weight, open source
reference boot loader with key benefits such as being fast, small,
customizable, and secure. An end-to-end reference build with
ACRN hypervisor, Clear Linux OS as SOS, and Clear Linux OS as UOS has been
verified on UP2/SBL board.
**Document updates**: Several new documents have been added in this release, including:
* :ref:`gpu-passthrough`
* :ref:`acrn-dm_parameters`
- :acrn-issue:`878` - Virtualization HLD
- :acrn-issue:`892` - Power Management: VMM control
- :acrn-issue:`894` - Power Management: S5
- :acrn-issue:`914` - GPU Passthrough
- :acrn-issue:`1124` - MMU code reshuffle
- :acrn-issue:`1179` - RPMB key passing
- :acrn-issue:`1180` - vFastboot release version 0.9
- :acrn-issue:`1181` - Integrate enabling Crash OS feature as default in VSBL debugversion
- :acrn-issue:`1182` - vSBL to support ACPI customization
- :acrn-issue:`1240` - [APL][IO Mediator] Enable VHOST_NET & VHOST to accelerate guest networking with virtio_net.
- :acrn-issue:`1284` - [DeviceModel]Enable NHLT table in DM for audio passthrough
- :acrn-issue:`1313` - [APL][IO Mediator] Remove unused netmap/vale in virtio-net
- :acrn-issue:`1330` - combine VM creating and ioreq shared page setup
- :acrn-issue:`1364` - [APL][IO Mediator] virtio code reshuffle
- :acrn-issue:`1496` - provide a string convert api and remove banned function for virtio-blk
- :acrn-issue:`1546` - hv: timer: add debug information for add_timer
- :acrn-issue:`1579` - vSBL to Support Ramoops
- :acrn-issue:`1580` - vSBL to support crash mode with vFastboot
- :acrn-issue:`1626` - support x2APIC mode for ACRN guests
- :acrn-issue:`1672` - L1TF mitigation
- :acrn-issue:`1747` - Replace function like macro with inline function
- :acrn-issue:`1821` - Optimize IO request path
- :acrn-issue:`1832` - Add OVMF booting support for booting as an alternative to vSBL.
- :acrn-issue:`1882` - Extend the SOS CMA range from 64M to 128M
- :acrn-issue:`1995` - Support SBL firmware as boot loader on Apollo Lake UP2.
- :acrn-issue:`2011` - support DISCARD command for virtio-blk
- :acrn-issue:`2036` - Update and complete `acrn-dm` parameters description in the user guide and HLD
- :acrn-issue:`2037` - Set correct name for each pthread in DM
- :acrn-issue:`2079` - Replace banned API with permitted API function in a crn device-model
- :acrn-issue:`2120` - Optimize trusty logic to meet MISRA-C rules
- :acrn-issue:`2145` - Reuse linux common virtio header file for virtio
- :acrn-issue:`2170` - For UEFI based hardware platforms, one Clear Linux OS E2E build binary can be used for all platform's installation
- :acrn-issue:`2187` - Complete the cleanup of unbounded APIs usage
Fixed Issues
************
- :acrn-issue:`1986` - UOS will hang once watchdog reset triggered
- :acrn-issue:`1987` - UOS will have same MAC address after launching UOS with virio-net
- :acrn-issue:`2000` - After launching UOS with Audio pass-through, Device (I2C0) doesn't exist in UOS DSDT.dsl
- :acrn-issue:`2030` - UP2 fails to boot with uart=disabled for hypervisor
- :acrn-issue:`2031` - UP2 serial port has no output
- :acrn-issue:`2133` - The system will hang up and print some error info after boot UOS
Known Issues
************
:acrn-issue:`1319` - SD card pass-through: UOS can't see SD card after UOS reboot.
SD card could not be found after UOS reboot in pass-through mode.
**Impact:** There is no SD card after UOS reboot.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1773` - USB Mediator: Can't find all devices when multiple usb devices connected[Reproduce rate:60%]
After booting UOS with multiple USB devices plugged in, there's a 60% chance that
one or more devices are not discovered.
**Impact:** Cannot use multiple USB devices at same time.
**Workaround:** Unplug and plug-in the unrecognized device after booting.
:acrn-issue:`1774` - UOS can't stop by command: acrnctl stop [vm name] in SOS
After launching UOS in SOS by "acrnctl start" command, UOS VM failed
to be stopped by "acrnctl stop" command.
**Impact:** Can't stop UOS in SOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1775` - [APL UP2]ACRN debugging tool - acrntrace cannot be used in SOS
There are no acrntrace devices "acrn_trace*" under SOS /dev.
**Impact:** acrntrace cannot be used in SOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1776` - [APL UP2]ACRN debugging tool - acrnlog cannot be used in SOS
There are no acrnlog devices "acrn_hvlog*" under SOS /dev.
**Impact:** acrnlog cannot be used in SOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1780` - Some video formats cannot be played in SOS
Video files with these encodings are not supported in the SOS:
H265_10bits, VP8, VP9, VP9_10bits, H265.720p.
**Impact:** Cannot play those formats of videos in SOS.
**Workaround:** None. The issues will be fixed in the next release.
:acrn-issue:`1782` - UOS failed to get IP address with the pass-through network card
After a network card is pass-through to UOS, it fails to get an IP address in UOS.
**Impact:** Cannot use network in UOS.
**Workaround:** None. The issues will be fixed in the next release.
:acrn-issue:`1796` - APL NUC fails to reboot sometimes
After APL NUC boots to SOS, the "reboot" command sometimes fails to reboot the SOS.
**Impact:** Cannot reboot SOS.
**Workaround:** Power off and boot again. The issues will be fixed in the next release.
:acrn-issue:`1991` - Input is useless in UART Console for corner case
Input is useless in UART Console for a corner case,
demonstrated with these steps:
1) Boot to SOS
2) ssh into the SOS.
3) use "./launch_UOS.sh" to boot UOS.
4) On the host, use "minicom -s dev/ttyUSB0".
5) Use "sos_console 0" to launch SOS.
**Impact:** Failed to use UART for input in corner case.
**Workaround:** Enter other keys before typing :kbd:`Enter`.
:acrn-issue:`1996` - There is an error log when using "acrnd&" to boot UOS
An error log is printed when starting acrnd as a background job
(``acrnd&``) to boot UOS. The UOS still boots up
normally, but prints: "Failed to open the socket(sos-lcs) to query the reason for the wake-up.
Activating all vms when acrnd & to boot uos."
**Impact:** UOS boots normally, but prints an error log message.
**Workaround:** None.
:acrn-issue:`2267` - [APLUP2][LaaG]LaaG can't detect 4k monitor
After launching UOS on APL UP2 , 4k monitor cannot be detected.
**Impact:** UOS hasn't display with 4k monitor.
**Workaround:** None.
:acrn-issue:`2276` - OVMF failed to launch UOS on UP2.
UP2 failed to launch UOS using OVMF as virtual bootloader with acrn-dm.
**Impact:** UOS cannot boot up using OVMF
**Workaround:** Use VSBL as virtual bootloader
:acrn-issue:`2277` - [APLNUC]Launch UOS with 5G memory will hang 2 minutes
If launching UOS with 5G memory, there will be about 2 minutes hang.
**Impact:** Low UOS boot time performance.
**Workaround:** None.
:acrn-issue:`2278` - [KBLNUC] Cx/Px is not supported on KBLNUC
C states/P states is not supported on KBL NUC.
**Impact:** Power Management states related operations cannot be using in SOS/UOS on KBLNUC
**Workaround:** None
:acrn-issue:`2279` - [APLNUC]After exiting UOS with mediator Usb_KeyBoard and Mouse, SOS cannot use the
Usb_KeyBoard and Mouse
After exiting UOS with mediator Usb_KeyBoard and Mouse, SOS cannot use the Usb_KeyBoard and Mouse.
Reproduce Steps as below:
1) Insert USB keyboard and mouse in standard A port (USB3.0 port)
2) Boot UOS by sharing the USB keyboard and mouse in cmd line:
-s n,xhci,1-1:1-2:1-3:1-4:2-1:2-2:2-3:2-4 \
3) UOS access USB keyboard and mouse.
4) Exit UOS.
5) SOS access USB keyboard and mouse.
**Impact:** SOS cannot use USB keyboard and mouse in such case.
**Workaround:** Unplug and plug-in the USB keyboard and mouse after exiting UOS.
:acrn-issue:`2338` - [UP2]Lost 2G memory in SOS when using SBL as bootloader on UP2.
After using SBL as bootloader to boot UP2, SOS only has 2G memory with 4G physical memory bank.
**Impact:** lost 2G memory in SOS.
**Workaround:** None. The issue will be fixed in the next release.
.. comment
Use the syntax:
:acrn-issue:`663` - Short issue description
Longer description that helps explain the problem from the user's
point of view (not internal reasons). **Impact:** What's the
consequences of the issue, and how it can affect the user or system.
**Workaround:** Describe a workaround if one exists (or refer them to the
:acrn-issue:`663`` if described well there. If no workaround, say
"none".
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v0.4
release in Dec 2018 (click on the CommitID link to see details):
.. comment
This list is obtained from the command:
git log --pretty=format:'- :acrn-commit:`%h` %s' --after="2018-03-01"
- :acrn-commit:`b7fda274` config: fix no serial output with SBL on UP2
- :acrn-commit:`ddf1c923` hv: fix violations in md.c md.h and md_internal.h for crypto lib
- :acrn-commit:`c230a1a6` hv: fix violations in sha256.c for crypto lib
- :acrn-commit:`488e7b2a` hv: fix violations in hkdf.c and crypto_api.c for crypto lib
- :acrn-commit:`08843973` HV: cyclomatic complexity 20 in vlapic_icrlo_write_handler
- :acrn-commit:`eaa0e307` HV: remove multiple exit/return in routines in the file of vlapic.c
- :acrn-commit:`8e00180c` HV: Remove goto statement in guest.c
- :acrn-commit:`2e01b4c8` HV: trivial changes to meet MISRA-C
- :acrn-commit:`971eb84c` HV: add const qualifier for functions' arguments in vlapic.c
- :acrn-commit:`63eecf08` HV: remove multiple return statement in get_vcpu_paging_mode() routine
- :acrn-commit:`b4b9ac59` HV: remove few return statement in while loop of copy_gva function
- :acrn-commit:`5a583fb8` HV: move global variable into the scope of calling function
- :acrn-commit:`235eaf05` HV: APICBASE_RESERVED definition is not used by any code. Just remove it
- :acrn-commit:`04d9f52f` update acrn-dm comment, remove the series of dot
- :acrn-commit:`7a930d88` hv: virq: refine hypervisor/arch/x86/virq.c
- :acrn-commit:`7ebc4877` HV: refine cmdline code, move parts into dbg_cmd
- :acrn-commit:`a5ca305c` HV: add API to change vuart base & irq config
- :acrn-commit:`f4beaf50` HV: support vuart base & irq can be changed
- :acrn-commit:`537adaeb` HV: cleanup CONFIG_COM_IRQ related code
- :acrn-commit:`fde0bcc1` HV: disable vuart when dbg uart is disabled
- :acrn-commit:`860c444c` hv: coding style: add `const` qualifier for some function
- :acrn-commit:`6f0edfc3` hv: coding style: use the defined data type __packed
- :acrn-commit:`40f6a9fd` dm: allow PM1_RTC_EN to be written to PM1A
- :acrn-commit:`57c661c4` dm: vrtc: add RTC to ACPI DSDT
- :acrn-commit:`067273af` hv: assign: fix remaining MISRA-C violations
- :acrn-commit:`1dfd05cd` hv: fix mis-usage of "PAGE_SHIFT"
- :acrn-commit:`5c6fe01c` hv:Change pcpu_active_bitmap to static
- :acrn-commit:`682824de` hv:Change phys_cpu_num to static
- :acrn-commit:`59e2de48` dm: acpi: add PSDS table in ACPI table
- :acrn-commit:`90fd5d58` script: fix launch_uos script issue due to unseen character
- :acrn-commit:`96800093` doc: update footer copyright year
- :acrn-commit:`9c27ed10` profiling: fix the profiling tool crash by page faults
- :acrn-commit:`a177d75e` doc: initial draft of ACRN coding guidelines
- :acrn-commit:`d89ce8ae` hv: schedule: fix "Procedure has more than one exit point"
- :acrn-commit:`952943c3` hv: decouple IO completion polling from idle thread
- :acrn-commit:`a0154223` hv: clear NEED_RESCHEDULE flag in schedule
- :acrn-commit:`e8ac9767` hv: use asm_pause() to replace inline ASM to satisfy MISRAC
- :acrn-commit:`329ea42d` dm: fix the memory leak in virtio mei
- :acrn-commit:`8f57c61d` dm: Add teardown callback for mevent in uart_core
- :acrn-commit:`72d1fa50` dm: refine the uart_core
- :acrn-commit:`21aa1907` hv: vcpuid: cpuid leaf 07h has subleaf
- :acrn-commit:`2d3f510d` hv: trusty_hypercall: fix "Procedure has more than one exit point"
- :acrn-commit:`5aa7e29f` hv: hypercall: fix "Procedure has more than one exit point"
- :acrn-commit:`d6a22682` hv: hypercall: fix complicated violations of "Procedure has more than one exit point"
- :acrn-commit:`f680ed5d` hv: hypercall: fix simple violations of "Procedure has more than one exit point"
- :acrn-commit:`5ebaaaf9` doc: add CSS for non-compliant code examples
- :acrn-commit:`e5c12a64` Makefile: add install-samples-up2
- :acrn-commit:`83034b71` Makefile: specify BOARD&FIRMWARE in sb-hypervisor-install
- :acrn-commit:`c932faa2` Makefile: eliminate mistakes due to deprecated PLATFORM
- :acrn-commit:`55691aed` hv: fix coding style violations in mmu.c
- :acrn-commit:`c1fc7f5f` hv: remove the usage of 'atoi()'
- :acrn-commit:`536ce5fb` dm: remove unnecessary ioreq status changing from DM
- :acrn-commit:`2d1ddd88` dm: Add vm_clear_ioreq to clear ioreq status
- :acrn-commit:`1274fca0` HV: x86: Fix "Variable should be declared static"
- :acrn-commit:`b3c199d0` hv: mmio_read: add `const` qualifier
- :acrn-commit:`1dee629e` hv:vtd: fix additional violations in vtd.c
- :acrn-commit:`3998c977` HV: [v2] bugfix in 'hv_access_memory_region_update()'
- :acrn-commit:`59c61403` dm: use snprintf to replace sprintf
- :acrn-commit:`4b3ebf69` dm: use strncpy to replace strcpy
- :acrn-commit:`b3ad44d4` dm: use strnlen to replace strlen
- :acrn-commit:`3e0b06cf` dm: Fix some issues from string operations
- :acrn-commit:`20d0e666` hv: fix sprintf and hypercall violations
- :acrn-commit:`277c7ec8` hv: hypercall: fix "Procedure has more than one exit point"
- :acrn-commit:`7016244c` hv: io: fix MISRA-C violations related to break
- :acrn-commit:`68643b61` hv: vcpuid: leaf 0dh is percpu related
- :acrn-commit:`ea672c5b` hv: update coding style for tampoline.c
- :acrn-commit:`b89b1228` hv: virq: refine acrn_handle_pending_request() has more than one exit point
- :acrn-commit:`e692d4c7` hv: virq: refine acrn_handle_pending_request() use goto instruction
- :acrn-commit:`b4de4d1b` Makefile: add RELEASE variable to make command
- :acrn-commit:`31487e82` Makefile: keep files used for debug target
- :acrn-commit:`ef03385f` hv: Write Buffer Flush - VT-d
- :acrn-commit:`a5113d92` hv: remove duplicated `is_vmx_disabled`
- :acrn-commit:`1b37ed50` hv: vmcall: fix "goto detected" violations
- :acrn-commit:`f6ae8351` dm: flush the input/output during tty open.
- :acrn-commit:`88a7d8b2` hv: virq: refine vcpu_inject_hi_exception()
- :acrn-commit:`3bfa6955` hv: virq: refine vcpu_inject_vlapic_int() has more than one exit point
- :acrn-commit:`9c97f6be` Documentation: split the build instructions into its own guide
- :acrn-commit:`c358d29c` doc: fix vhm_request doxygen comment
- :acrn-commit:`01bc8e56` Documentation: fix formatting in partition mode tutorial
- :acrn-commit:`c3250030` hv: vcpuid: remove unnecessary check code
- :acrn-commit:`83f32c93` hv: vcpuid: leaf 02h has no subleaf, delete un-needed code.
- :acrn-commit:`44bee516` dm: virtio: fix compile issue on ubuntu
- :acrn-commit:`9fe282f0` hv: Makefile: remove unused MACRO
- :acrn-commit:`cf47f6cf` hv: coding style: refine the remaining functions to one exit point
- :acrn-commit:`36dcb0f6` hv: lib: refine inline assembly use in bitmap operation
- :acrn-commit:`ddd07b95` hv: cpu_state_tbl: fix multiple exits
- :acrn-commit:`eb77e25f` hv: ept: fix MISRA-C violations
- :acrn-commit:`5253ac7a` dm: virtio: refine header file
- :acrn-commit:`738f2536` hv: coding style: refine cpu related function to one exit
- :acrn-commit:`9672538c` init: move init_scheduler into cpu.c
- :acrn-commit:`ff0703dd` scheduler: make scheduling based on struct sched_object
- :acrn-commit:`8aae0dff` scheduler: refine make_reschedule_request
- :acrn-commit:`6d673648` scheduler: refine runqueue related functions
- :acrn-commit:`93e588bc` hv: fix e820.c violations
- :acrn-commit:`60f78e1e` hv:vtd: fix MISRA-C violations on procedure has more than one exit point
- :acrn-commit:`a98a1a69` hv:vtd: fix MISRA-C violations on pointer not checked for null before use
- :acrn-commit:`725e1921` hv:vtd: fix MISRA-C violations on comment possibly contains code
- :acrn-commit:`897ffa27` hv:vtd: fix MISRA-C violations on logical conjunctions need brackets
- :acrn-commit:`80b392a8` hv:vtd: fix MISRA-C violations on pointer param should be declared pointer to const
- :acrn-commit:`5282fa89` hv:vtd: fix MISRA-C violations on scope of variable could be reduced
- :acrn-commit:`bec21d14` Patch for modularizing ioapic.[c/h] and related files.
- :acrn-commit:`af9b7476` doc: fix formatting in NUC GSG
- :acrn-commit:`61f03dae` DOC: change PCI uart description from mmio to bdf
- :acrn-commit:`50f5b0f6` hv: vmexit: fix MISRA-C violations related to multiple exits
- :acrn-commit:`0a713e6f` hv: coding style: refine set_vcpuid_entries to one exit
- :acrn-commit:`a56abee9` hv: coding style: refine find_vcpuid_entry
- :acrn-commit:`58d2a418` HV: fix pm code for multi-exits & unsigned const
- :acrn-commit:`97a73951` dm: pass mac seed not to use vm name on UP2
- :acrn-commit:`1c99a975` hv: coding style: refine trusty
- :acrn-commit:`1dca17cd` hv: coding style: refine initialize_trusty to one exit
- :acrn-commit:`8a55f038` hv: coding style: refine hcall_initialize_trusty to one exit
- :acrn-commit:`1d1d2434` DM USB: xHCI: change log level of some logs for S3 online debugging
- :acrn-commit:`5f0c093e` hv: coding style: remove no real declaration for external variable
- :acrn-commit:`1e3358fd` Debug: Add one hypercall to query hardware info
- :acrn-commit:`81a9de60` hv:fix MISRA-C violations in create_vm
- :acrn-commit:`bb47184f` hv: fix enable_msr_interception() function
- :acrn-commit:`56af4332` hv: io: fix MISRA-C violations related to multiple exits
- :acrn-commit:`c03bad1f` hv: io: fix MISRA-C violations related to style
- :acrn-commit:`f27aa70f` hv: coding style: refine page related
- :acrn-commit:`7c2198c4` hv: config.h fix "Nested comment found."
- :acrn-commit:`e22b35e3` HV/DM: Unify the usage of aligned for structure definition with alignment
- :acrn-commit:`71a80d2d` hv: assign: change ptirq vpin source type from enum to macro
- :acrn-commit:`d5865632` hv: assign: remove added ptirq entries if fails to add all
- :acrn-commit:`d48dc387` hv: assign: fix MISRA-C violations on multiple exits
- :acrn-commit:`e8b3e44f` hv: assign: fix MISRA-C violations on potential null pointer deference
- :acrn-commit:`e19dcf57` hv: assign: fix MISRA-C violations on implicit type conversion
- :acrn-commit:`714814f9` hv: move `atoi` and `strtol_dec` to debug directory
- :acrn-commit:`32d6aa97` hv: string: fix MISRA-C violations related to style
- :acrn-commit:`2c6c383e` hv: string: fix MISRA-C violations related to break
- :acrn-commit:`b319e654` HV: fix bug adapt uart mmio to bdf for HV cmdline
- :acrn-commit:`23c2166a` HV: change serial PCI cfg to bus:dev.func format
- :acrn-commit:`1caf58f2` hv:clean io_request.c MISRA violations
- :acrn-commit:`530388db` hv: irq: fix MISRA-C violations in irq.c and idt.h
- :acrn-commit:`08cf8f64` hv: lapic: fix MISRA-C violation of potential numeric overflow
- :acrn-commit:`83ebd432` hv: ptdev: fix MISRA-C violations
- :acrn-commit:`ccda4595` dm: passthru: add error handling if msix table init failed
- :acrn-commit:`3363779d` dm: passthru: msi/msix handling revisit
- :acrn-commit:`38c11784` hv: coding style: refine mmu.c
- :acrn-commit:`2fefff34` HV: x86: fix "Global variable should be declared const"
- :acrn-commit:`eff94591` HV: x86: fix "Procedure has more than one exit point"
- :acrn-commit:`e283e774` hv: vmcs: fix MISRA-C violations related to multiple exits
- :acrn-commit:`4618a6b1` hv: vmcs: fix MISRA-C violations related to pointer
- :acrn-commit:`8e58a686` hv: vmcs: fix MISRA-C violations related to variable scope
- :acrn-commit:`9a051e7a` hv: vmcs: fix MISRA-C violations related to style
- :acrn-commit:`7d8cd911` security: remove gcc flags Wformat Wformat-security in HV
- :acrn-commit:`d133f95d` hv: fix MISRA-C violations "Pointer param should be declared pointer to const."
- :acrn-commit:`f81fb21a` HV: modularization to refine pm related code.
- :acrn-commit:`03262a96` hv: refine coding style for ucode.c
- :acrn-commit:`927c5172` hv: vpci: fix MISRA-C violations related to variable declarations
- :acrn-commit:`4c28e98d` hv: refine a few functions to only one exit point
- :acrn-commit:`64a46300` hv:refine prepare_vm0 api
- :acrn-commit:`b5e0efca` hv: coding style: refine memory.c
- :acrn-commit:`5b467269` hv: lib: remove memchr
- :acrn-commit:`97132acc` Make ibrs_type as internal variable
- :acrn-commit:`55cce7e4` Fix MISRA-C violation in cpu_caps.c and security.c
- :acrn-commit:`689c1c28` function name change in init.c
- :acrn-commit:`5968da46` move security related funcs into security.c
- :acrn-commit:`0ad6da99` make detect_cpu_cap as internal function
- :acrn-commit:`e22217fd` refine apicv capability check
- :acrn-commit:`7c8b7671` refine in cpu_caps.c
- :acrn-commit:`63773db4` change get_monitor_cap to has_monitor_cap
- :acrn-commit:`6830619d` modularization: combine vmx_caps into cpu_caps
- :acrn-commit:`746fbe14` modularization: move functions related with cpu caps into cpu_caps.c
- :acrn-commit:`b8ffac8b` hv:fix possible buffer overflow in 'ptirq_get_intr_data()'
- :acrn-commit:`6aa42272` fix "Procedure has more than one exit point."
- :acrn-commit:`65a7be8f` hv:refine alloc_vm_id api
- :acrn-commit:`235ad0ff` hv: refine memcpy_s
- :acrn-commit:`f9897c6f` hv: refine memset
- :acrn-commit:`78e9a84f` hv: add fast string enhanced rep movsb/stosb check on initial
- :acrn-commit:`3515ca1e` hv: vpci: fix "Procedure has more than one exit point"
- :acrn-commit:`c547e9cf` hv: enable/disable snoop control bit per vm
- :acrn-commit:`20280341` hv: MISRA-C fix "identifier reuse" in vpci code
- :acrn-commit:`2ddd24e0` dm: storage: support discard command
- :acrn-commit:`f71370ad` dm: storage: rename delete to discard
- :acrn-commit:`36863a0b` modularization: vmx on/off should not use vcpu param
- :acrn-commit:`bed82dd3` cleanup vmcs source and header files
- :acrn-commit:`731c4836` modularization: separate vmx.c into two parts
- :acrn-commit:`0d5c65f1` hv: enforce data size on all out exits
- :acrn-commit:`5ab68eb9` dm: hw: Replace sscanf with permitted string API
- :acrn-commit:`63b814e7` dm: hw: Replace strlen with strnlen
- :acrn-commit:`eab7cd47` dm: hw: Replace sprintf with snprintf
- :acrn-commit:`69dc9392` hv: drop the temporary stack for AP startup
- :acrn-commit:`74849cd9` modularization:move out efi dir from hypervisor
- :acrn-commit:`59e3f562` remove check_tsc
- :acrn-commit:`d2bac7cc` cpu_dead should only run on current pcpu
- :acrn-commit:`d2627ecf` DM USB: xHCI: fix an issues for failing to enumerate device
- :acrn-commit:`1c3344b7` DM USB: xHCI: change log level for S3 process
- :acrn-commit:`3dadb62d` HV: fix bug change default vuart IRQ for UP2 board
- :acrn-commit:`a3d2a7e7` hv: vpci: 2 MISRA-C violation fixes
- :acrn-commit:`44e9318c` hv: vmsr: fix MISRA_C violations
- :acrn-commit:`117b71e6` doc: add partition mode hld
- :acrn-commit:`ed5e210d` Doc: Update GSG for v0.4 version and launch and acrn.conf sample script
- :acrn-commit:`57bf26dc` hv: fix possible buffer overflow issues
- :acrn-commit:`73ab7274` dm: set correct thread name
- :acrn-commit:`cb313815` dm: vhost: remove support for non-msix devices
- :acrn-commit:`b29fc619` dm: virtio-net: apply new mevent API to avoid race issue
- :acrn-commit:`4f36244f` dm: virtio-console: apply new mevent API to avoid race issue
- :acrn-commit:`baf8f8bd` dm: virtio-input: apply new mevent API to avoid race issue
- :acrn-commit:`c2df4a85` DM USB: xHCI: no wait logic implementation for S3
- :acrn-commit:`82659831` DM USB: xHCI: refine emulation for command XHCI_CMD_RS
- :acrn-commit:`e5c98e6d` DM USB: add usb_dev_path_cmp function for convenience
- :acrn-commit:`6c1ca137` DM USB: xHCI: remove the waiting 5 seconds wa for s3
- :acrn-commit:`4fc5dcfc` hv: enable SMAP in hypervisor
- :acrn-commit:`57dfc7de` hv: refine IOREQ state operation functions in hypervisor
- :acrn-commit:`c89d6e65` modularization: clean up namings in vMTRR module
- :acrn-commit:`6bbd0129` modularization: move vMTRR code to guest directory
- :acrn-commit:`e066774a` hv: refine strnlen_s/strstr_s to only one exit point
- :acrn-commit:`e114ea7e` hv: timer: fix procedure has more than one exit point
- :acrn-commit:`4131d46f` hv: remove goto in ept_violation_vmexit_handler
- :acrn-commit:`a958fea7` hv: emulate IA32_TSC_ADJUST MSR
- :acrn-commit:`6b998580` Fix KW issues for tpm_emulator
- :acrn-commit:`2d469a5e` modularization: hypervisor initialization component
- :acrn-commit:`9a7d32f0` modularization: reorg the bsp_boot_init & cpu_secondary_init
- :acrn-commit:`9e917057` profiling: split profiling_vmexit_handler into two functions
- :acrn-commit:`302494cb` doc: update some statements
- :acrn-commit:`07309fdc` doc: update some statements
- :acrn-commit:`40f375b4` Doc: modify the note of UOS kernel modules
- :acrn-commit:`2d9e478c` Doc: delete the step of downloading UOS's kernel
- :acrn-commit:`c3a4a5d4` Doc: add "$" for code
- :acrn-commit:`d56e2c29` Doc: update the steps
- :acrn-commit:`2be939f3` Doc: add "Deploy the UOS kernel modules for AGL"
- :acrn-commit:`73161f91` Update using_agl_as_uos.rst
- :acrn-commit:`c51394c3` doc: update the doc of AGL as UOS
- :acrn-commit:`e5748795` doc: update the doc of using AGL as UOS
- :acrn-commit:`fbaecde6` DM USB: xHCI: Fix banned API issue.
- :acrn-commit:`e835f5f5` dm: enforce data size when accessing PCI BARs
- :acrn-commit:`f5a66e8e` doc: update OVMF usage for acrn-dm
- :acrn-commit:`d8c4e7d3` dm: add option to boot OVMF from acrn-dm
- :acrn-commit:`9e97fd06` dm: add BIOS/ROM image loading support at High BIOS region
- :acrn-commit:`653a5795` dm: query and save image size during initial checking
- :acrn-commit:`a80f08eb` dm: add launch_uos.args sample file for AaaG
- :acrn-commit:`04fef4f3` tools: acrn-manager: change path of vm conf files
- :acrn-commit:`2f30dcdb` hv: refine strncpy_s to only one exit point
- :acrn-commit:`b8ca17c6` hv: remove strcpy_s
- :acrn-commit:`29c8494f` hv: replace strcpy_s with strncpy_s
- :acrn-commit:`07427b4c` modularization: move virtual cpuid stuff into guest dir
- :acrn-commit:`90d7bddd` doc: vertical align table content to top
- :acrn-commit:`e4143ca1` doc: fix use of double dashes
- :acrn-commit:`6dec1667` doc: improve acrn-dm param layout
- :acrn-commit:`21a5b308` Update add acrn-dm parameter descriptions
- :acrn-commit:`c45300fb` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`6d5b769d` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`5998f434` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`c607aedf` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`ba79b218` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`4ab193cf` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`1c70f812` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`341bf84c` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`a0708339` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`a7be8f73` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`5aedc8f4` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`e7e8ce63` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`24542894` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`edd06fe9` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`1ef6b657` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`8b13bf3f` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`7446089d` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`666c97b0` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`a21c3ca3` Update doc/developer-guides/hld/hld-devicemodel.rst
- :acrn-commit:`7bcd7054` doc: additional DM parameter documentation
- :acrn-commit:`97c95697` doc: update code to "losetup -r"
- :acrn-commit:`4355b0df` doc: update some statements
- :acrn-commit:`ad1ba225` doc: update some statements
- :acrn-commit:`6bfbf166` Doc: Update some statements
- :acrn-commit:`85b30685` Doc: define swap partition with 1G
- :acrn-commit:`fae136c2` doc: remove "software-defined-cockpit"
- :acrn-commit:`33b87064` Doc: Update the doc of "Build UOS from Clear Linux"
- :acrn-commit:`8b83cadd` doc: update the layout of the doc
- :acrn-commit:`71bf586e` doc: upload tutorial of 'Build UOS from Clear Linux'
- :acrn-commit:`bc5b27a7` tools: acrnctl: increase STOP_TIMEOUT to 30s when reset VM
- :acrn-commit:`bb768904` config: add up2-sbl board related configs
- :acrn-commit:`59c2b33a` Makefile: separate PLATFORM into BOARD+FIRMWARE
- :acrn-commit:`064a3106` tools: vmcfg: use defconfig instead of default values in Kconfig
- :acrn-commit:`ed1c576d` dm: pass mac seed not to use vm name
- :acrn-commit:`e3fc6c3c` hv: use int32_t replace int
- :acrn-commit:`e8f3a2d4` hv: use uint64_t replace "unsigned long"
- :acrn-commit:`473d8713` hv: use uint32_t replace "unsigned int"
- :acrn-commit:`8bafde99` hv: use uint8_t replace "unsigned char"
- :acrn-commit:`a1435f33` dm: bios: update vSBL to V1.1
- :acrn-commit:`4d13ad9d` hv: enable NX in hypervisor
- :acrn-commit:`405d1335` doc: add 0.4 to doc version menu
- :acrn-commit:`2ef06450` dm: virtio-input: ignore all MSC events from FE
- :acrn-commit:`19fb5fa0` dm: adjust the sequence of destroy client and wait for vm_loop exit
- :acrn-commit:`bff592d9` HV: rename e820_entries to e820_entries_count
- :acrn-commit:`9b58b9d1` HV: improve e820 interfaces and their usages
- :acrn-commit:`b69d24b1` HV: separate e820 related code as e820.c/h
- :acrn-commit:`c5d827ab` ACRN: Add runC container sample config file
- :acrn-commit:`da0cf3af` DM: xHCI: unbind slot id and ndevices relationship.
- :acrn-commit:`c2be20d2` move idt.S and idt.h out of boot component
- :acrn-commit:`27938c33` move idt fixup out of cpu_primary.S
- :acrn-commit:`6b42b347` init fs and gs with 0x10
- :acrn-commit:`cf34cda3` version: 0.5-unstable

403
doc/release_notes/release_notes_0.6.rst
View File

@ -1,403 +0,0 @@
.. _release_notes_0.6:
ACRN v0.6 (Feb 2019)
####################
We are pleased to announce the release of Project ACRN version 0.6.
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline
embedded development through an open source platform. Check out the
:ref:`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 either download this source code as a zip or
tar.gz file (see the `ACRN v0.6 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v0.6>`_ or
use Git clone and checkout commands:
.. code-block:: bash
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v0.6
The project's online technical documentation is also tagged to correspond
with a specific release: generated v0.6 documents can be found at
https://projectacrn.github.io/0.6/. Documentation for the latest
(master) branch is found at https://projectacrn.github.io/latest/.
ACRN v0.6 requires Clear Linux OS version 27600.
Version 0.6 New Features
************************
**Enable Privileged VM support for real-time UOS in ACRN**:
Initial patches to enable a User OS
(UOS) running as a virtual machine (VM)
with real-time characteristics, also called a "Privileged VM". We've
published a tutorial. More patches for ACRN real time support will continue.
**Document updates**: Several new documents have been added in this release, including:
* Running Automotive Grade Linux as a VM
* Using PREEMPT_RT-Linux for real-time UOS
* :ref:`Frequently Asked Questions <faq>`
* :ref:`An introduction to Trusty and Security services on ACRN
<trusty-security-services>`
* A Wiki article about `Porting ClearLinux/ACRN to support Yocto/ACRN
<https://github.com/projectacrn/acrn-hypervisor/wiki/Yocto-based-Service-OS-(SOS)-and-User-OS-(UOS)-on-ACRN>`_
* An `ACRN brochure update (English and Chinese)
<https://projectacrn.org/#code-docs>`_
- :acrn-issue:`888` - Security: Service OS Support for Platform Security Discovery
- :acrn-issue:`1498` - add watchdog MSI and INTR support in DM
- :acrn-issue:`2056` - Enable SMAP in hypervisor
- :acrn-issue:`2288` - Display interface - MIPI support
- :acrn-issue:`2343` - Rework TMR and EOI_EXIT_BITMAP updating logic
- :acrn-issue:`2344` - Add UP2 ACRN SBL binary to E2E build
- :acrn-issue:`2358` - Remove the flooding kernel message from vhm for memory setup
- :acrn-issue:`2395` - change DISCARD to synchronous mode
- :acrn-issue:`2351` - Enable post-launched hybrid mode
Fixed Issues
************
- :acrn-issue:`1775` - [APL UP2]ACRN debugging tool - acrntrace cannot be used in SOS
- :acrn-issue:`1776` - [APL UP2]ACRN debugging tool - acrnlog cannot be used in SOS
- :acrn-issue:`1796` - APL NUC fails to reboot sometimes
- :acrn-issue:`2043` - Fix incorrect vm_id captured when sampling PMU data
- :acrn-issue:`2086` - enable/disable snoop control bit per vm
- :acrn-issue:`2157` - Profiling: fix the profiling tool crash by page faults
- :acrn-issue:`2168` - Modify Makefile to save debug files
- :acrn-issue:`2200` - Won't build using ubuntu 16.04 LTS and binutils 2.26.1
- :acrn-issue:`2237` - Don't export two dma_bufs for the same importer in sos kernel
- :acrn-issue:`2257` - Profiling code clean up
- :acrn-issue:`2277` - [APLNUC]Launch UOS with 5G memory will hang 2 minutes
- :acrn-issue:`2298` - Hardcodes path to iasl
- :acrn-issue:`2341` - vm exit trace position is not correct
- :acrn-issue:`2349` - SOS failed boot up with RELOC config enabled.
- :acrn-issue:`2355` - Switch the default up-notification vector from 0xF7 to 0xF3
- :acrn-issue:`2356` - fail to start UOS on the renamed device name of VHM module
- :acrn-issue:`2371` - kconfig oldconfig doesn't work correctly
- :acrn-issue:`2389` - Need to add the dependency of $(LIB_FLAGS)
- :acrn-issue:`2410` - Launch UOS will occur page fault error when use the hypervisor build on Ubuntu
- :acrn-issue:`2427` - Remove redundant apicv code from legacy vInterrupt inject path
Known Issues
************
:acrn-issue:`1319` - SD card pass-through: UOS can't see SD card after UOS reboot.
SD card could not be found after UOS reboot in pass-through mode.
**Impact:** There is no SD card after UOS reboot.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1773` - USB Mediator: Can't find all devices when multiple usb devices connected[Reproduce rate:60%]
After booting UOS with multiple USB devices plugged in, there's a 60% chance that
one or more devices are not discovered.
**Impact:** Cannot use multiple USB devices at same time.
**Workaround:** Unplug and plug-in the unrecognized device after booting.
:acrn-issue:`1774` - UOS can't stop by command: acrnctl stop [vm name] in SOS
After launching UOS in SOS by "acrnctl start" command, UOS VM failed
to be stopped by "acrnctl stop" command.
**Impact:** Can't stop UOS in SOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1780` - Some video formats cannot be played in SOS
Video files with these encodings are not supported in the SOS:
H265_10bits, VP8, VP9, VP9_10bits, H265.720p.
**Impact:** Cannot play those formats of videos in SOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1782` - UOS failed to get IP address with the pass-through network card
After a network card is pass-through to UOS, it fails to get an IP address in UOS.
**Impact:** Cannot use network in UOS.
**Workaround:** None. The issue will be fixed in the next release.
:acrn-issue:`1991` - Input is useless in UART Console for corner case
Input is useless in UART Console for a corner case,
demonstrated with these steps:
1) Boot to SOS
2) ssh into the SOS.
3) use "./launch_UOS.sh" to boot UOS.
4) On the host, use "minicom -s dev/ttyUSB0".
5) Use "sos_console 0" to launch SOS.
**Impact:** Failed to use UART for input in corner case.
**Workaround:** Enter other keys before typing :kbd:`Enter`.
:acrn-issue:`1996` - There is an error log when using "acrnd&" to boot UOS
An error log is printed when starting acrnd as a background job
(``acrnd&``) to boot UOS. The UOS still boots up
normally, but prints: "Failed to open the socket(sos-lcs) to query the reason for the wake-up.
Activating all vms when acrnd & to boot uos."
**Impact:** UOS boots normally, but prints an error log message.
**Workaround:** None.
:acrn-issue:`2267` - [APLUP2][LaaG]LaaG can't detect 4k monitor
After launching UOS on APL UP2 , 4k monitor cannot be detected.
**Impact:** UOS can't display on a 4k monitor.
**Workaround:** Use a monitor with less than 4k resolution.
:acrn-issue:`2276` - OVMF failed to launch UOS on UP2.
UP2 failed to launch UOS using OVMF as virtual bootloader with acrn-dm.
**Impact:** UOS cannot boot up using OVMF
**Workaround:** Use VSBL as virtual bootloader
:acrn-issue:`2278` - [KBLNUC] Cx/Px is not supported on KBLNUC
C states/P states is not supported on KBL NUC.
**Impact:** Power Management states related operations cannot be using in SOS/UOS on KBLNUC
**Workaround:** None
:acrn-issue:`2279` - [APLNUC]After exiting UOS with mediator Usb_KeyBoard and Mouse, SOS cannot use the Usb_KeyBoard and Mouse
After exiting UOS with mediator Usb_KeyBoard and Mouse, SOS cannot use the Usb_KeyBoard and Mouse.
Reproduce Steps as below:
1) Insert USB keyboard and mouse in standard A port (USB3.0 port)
2) Boot UOS by sharing the USB keyboard and mouse in cmd line:
``-s n,xhci,1-1:1-2:1-3:1-4:2-1:2-2:2-3:2-4 \``
3) UOS access USB keyboard and mouse.
4) Exit UOS.
5) SOS access USB keyboard and mouse.
**Impact:** SOS cannot use USB keyboard and mouse in such case.
**Workaround:** Unplug and plug-in the USB keyboard and mouse after exiting UOS.
:acrn-issue:`2338` - [UP2]Lost 2G memory in SOS when using SBL as bootloader on UP2.
After using SBL as bootloader to boot UP2, SOS only has 2G memory with 4G physical memory bank.
**Impact:** lost 2G memory in SOS.
**Workaround:** Modify SBL Memory setting file "CfgData_Ext_Up2.dlt", see details in issue comments.
:acrn-issue:`2516` - [UP2][SBL] System hang with DP monitor connected
For UP2, system will occur crash when DP monitor is connected. It will be triggered immediately by running command "cat /sys/kernel/debug/dri/0/i915_display_info" in SOS.
**Impact:** Cannot use DP monitor.
**Workaround:** Remove enable_initial_modeset for UP2 platform. You can apply :acrn-commit:`4b53ed67` to rebuild UP2 images.
:acrn-issue:`2522` - [NUC7i7BNH]After starting ias in SOS, there is no display
On NUC7i7BNH, after starting IAS in SOS, there is no display if the monitor is
connected with a TPC to VGA connector.
**Impact:** Special model [NUC7i7BNH] has no display in SOS.
**Workaround:** None.
:acrn-issue:`2523` - UOS monitor does not display when using IAS
There is no UOS display after starting IAS weston.
**Impact:** Cannot use ias weston in UOS.
**Workaround:**
1) Use weston instead of IAS weston: ``swupd install x11-server``
2) Use acrn-kernel to rebuild SOS kernel to replace integrated kernel. To confirm "DRM_FBDEV_EMULATION" related configs in kernel_config_sos should as below:
.. code-block:: bash
CONFIG_DRM_KMS_FB_HELPER=y
CONFIG_DRM_FBDEV_EMULATION=y
CONFIG_DRM_FBDEV_OVERALLOC=100
The issue will be fixed in the next release.
:acrn-issue:`2524` - [UP2][SBL] Launching UOS hang while weston is running in SOS
When using weston in SOS, it will hang during the UOS launch.
**Impact:** launching UOS hang, and then no display in UOS.
**Workaround:** Use acrn-kernel to rebuild SOS kernel to replace the
integrated kernel. Confirm "DRM_FBDEV_EMULATION" related
configs in kernel_config_sos are as below:
.. code-block:: bash
CONFIG_DRM_KMS_FB_HELPER=y
CONFIG_DRM_FBDEV_EMULATION=y
CONFIG_DRM_FBDEV_OVERALLOC=100
The issue will be fixed in the next release.
:acrn-issue:`2527` - [KBLNUC][HV]System will crash when run crashme (SOS/UOS)
System will crash after a few minutes running stress test crashme tool in SOS/UOS.
**Impact:** System may crash in some stress situation.
**Workaround:** None
:acrn-issue:`2528` - [APLUP2] SBL (built by SBL latest code) failed to boot ACRN hypervisor
SBL built by latest slimbootloader code (HEAD->ad42a2bd6e4a6364358b9c712cb54e821ee7ee42) failed to boot acrn hypervisor.
**Impact:** UP2 with SBL cannot boot acrn hypervisor.
**Workaround:** Use SBL built by earlier slimbootloader code (commit id:edc112328cf3e414523162dd75dc3614e42579fe).
This folder version can boot acrn hypervisor normally.
.. comment
Use the syntax:
:acrn-issue:`663` - Short issue description
Longer description that helps explain the problem from the user's
point of view (not internal reasons). **Impact:** What's the
consequences of the issue, and how it can affect the user or system.
**Workaround:** Describe a workaround if one exists (or refer them to the
:acrn-issue:`663`` if described well there. If no workaround, say
"none".
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v0.5
release in Jan 2019 (click on the CommitID link to see details):
.. comment
This list is obtained from the command:
git log --pretty=format:'- :acrn-commit:`%h` %s' --after="2018-03-01"
- :acrn-commit:`ea250c51` doc: fixes to rt-linux tutorial
- :acrn-commit:`1a4a1c30` Need to delete '# CONFIG_BLK_DEV_NVME is not set' to enable NVME driver
- :acrn-commit:`37ce259f` modify create-up2-images scripts
- :acrn-commit:`eb7091bb` HV: add rdmsr/wrmsr debug cmd
- :acrn-commit:`648450c6` HV: cpu: add msr_read_pcpu()& msr_write_pcpu()
- :acrn-commit:`39ffd29a` schedule: add magic number at the bottom of schedule stack
- :acrn-commit:`efc64d77` hv: fix host call stack dump issue
- :acrn-commit:`5214a60b` hv: replace improper use of ASSERT with panic for parse_madt
- :acrn-commit:`9291fbe4` hv: multiboot: replace improper use of ASSERT with panic
- :acrn-commit:`2474c601` hv: replace improper use of panic with ASSERT
- :acrn-commit:`a01c3cb9` doc: change term of vm0 to sos_vm
- :acrn-commit:`7da9161d` hv:no need to use lock for the bit operations of local variable
- :acrn-commit:`e2cb6acb` doc: add Trusty ACRN doc
- :acrn-commit:`9c3c316f` doc: add rt-linux tutorial
- :acrn-commit:`0881bae7` doc: fix correct use of Clear Linux OS
- :acrn-commit:`fc887ead` doc: update coding guidelines
- :acrn-commit:`72faca50` doc: update documents for "--lapic_pt" feature
- :acrn-commit:`2ffc683d` hv: move some api declaration from mmu.h to ept.h
- :acrn-commit:`615c2bf8` hv:move e820 related macro and structure to e820.h
- :acrn-commit:`2b2dbe43` hv:move some files to guest folder
- :acrn-commit:`e9bb4267` hv:move vpic.h & vioapic.h to dm folder
- :acrn-commit:`89b6dc59` HV: MISRA clean in reloc.c
- :acrn-commit:`723ff1f4` HV: modularization improve UEFI macro control code
- :acrn-commit:`2a25f4e9` Doc: Remove CL release number from GSG document
- :acrn-commit:`fea541bd` hv: exception: low prioirity exception inject fix
- :acrn-commit:`c6d2908f` hv: vmexit: add handler for vmexit not supported for guest
- :acrn-commit:`cc2c0c3a` hv:Move several inline APIs from vm.h to \*.c
- :acrn-commit:`61552458` Kconfig: enlarge range of maximum number of IOMMU
- :acrn-commit:`69371f41` EFI: fix potential memory overwrite due to mmap table
- :acrn-commit:`b038ade2` hv: fix misra-c violations in reused partition mode functions
- :acrn-commit:`7d4ba5d7` Documentation build tools: update min version for kconfiglib
- :acrn-commit:`878c4e2d` dm: add example script to launch vm for realtime scenarios
- :acrn-commit:`c873d60a` dm: add option "lapic_pt" to create VM for realtime scenarios
- :acrn-commit:`8925da64` dm: adapt mptable generation for VM with lapic pt
- :acrn-commit:`e2cecfb5` hv: send IPI instead of irq injection to notify vcpu with lapic pt
- :acrn-commit:`16df57aa` hv: don't remap msi for pt devices if lapic_pt
- :acrn-commit:`a073ebee` hv: extend lapic pass-through for DM launched VM
- :acrn-commit:`c853eb4b` hv: remove redundant code for virtual interrupt injection
- :acrn-commit:`6d5456a0` hv: Bit Representation for IOAPIC RTE
- :acrn-commit:`7d57eb05` hv: Add bit representation for MSI addr and data
- :acrn-commit:`68250430` hv:Move severl variable declaration for boot code
- :acrn-commit:`c20d095a` HV: refine sos_vm config header
- :acrn-commit:`66e00230` HV: sanitize vm config
- :acrn-commit:`285b64fa` replace arch_switch_to with pure asm code instead of inline asm
- :acrn-commit:`c233bf54` make sure secondary CPU's stack is aligned with CPU STACK
- :acrn-commit:`ee066a7f` hv: fix possible buffer overflow in 'vcpu_set_eoi_exit()'
- :acrn-commit:`88eeae3f` hv: remove unused fields in 'struct acrn_vcpu'
- :acrn-commit:`5e99565b` security: Increase buffer size to avoid buffer overflow error
- :acrn-commit:`d0eb83aa` HV: move Kconfig IOREQ_POLLING to acrn vm config
- :acrn-commit:`6584b547` Makefile: add missing dependency
- :acrn-commit:`c43bca9c` doc: add a FAQ doc
- :acrn-commit:`bb8f5390` doc: add AGL as VMs on ACRN doc
- :acrn-commit:`5c5f4352` HV: modify RELOC kconfig option default to "enable"
- :acrn-commit:`8f22a6e8` HV: fix per-cpu stack relocation in trampoline.c
- :acrn-commit:`41dd38ba` HV: init_paging() wrongly calcuate the size of hypervisor
- :acrn-commit:`9feab4cf` HV: adjust the starting addr of HV to be 2M-aligned
- :acrn-commit:`07f14401` HV: save efi_ctx into HV to use after init_paging()
- :acrn-commit:`a445a4ea` EFI: Allocate EFI boot related struct from EFI allocation pool
- :acrn-commit:`ad0f8bc3` EFI: Allocate 2M aligned memory for hypervisor image
- :acrn-commit:`912be6c4` tools: respect CFLAGS and LDFLAGS from environment
- :acrn-commit:`899c9146` hv:Fix MISRA-C violations in vm.h
- :acrn-commit:`5ba4afcf` Use $(MAKE) when recursing
- :acrn-commit:`d0c9fce7` doc: add more rules in coding guidelines
- :acrn-commit:`3c605127` io_emul: reorg function definition to pass partition mode build
- :acrn-commit:`15030f6f` io_emul: reshuffle io emulation path
- :acrn-commit:`fb41ea5c` io_emul: remove pending_pre_work
- :acrn-commit:`4fc54f95` schedule: add full context switch support
- :acrn-commit:`21092e6f` schedule: use per_cpu idle object
- :acrn-commit:`5e947886` hv: vlapic: remove `calcvdest`
- :acrn-commit:`fd327920` kconfig: update .config on missed or conflicting symbol values
- :acrn-commit:`ca925f0d` dm: storage: change DISCARD to synchronous mode
- :acrn-commit:`46422692` dm: vhpet: add vHPET support
- :acrn-commit:`0343da8c` dm: vhpet: add HPET-related header files
- :acrn-commit:`3fe4c3f2` dm: provide timer callback handlers the number of expirations
- :acrn-commit:`0f7535fd` dm: add absolute timer mode
- :acrn-commit:`d1e1aa30` dm: create mevent's pipe in non-blocking mode
- :acrn-commit:`a9709bf8` hv: Makefile: add the dependency of $(LIB_FLAGS)
- :acrn-commit:`b489aec3` hv: idt: separate the MACRO definition
- :acrn-commit:`862ed16e` Makefile: add rules for installing debug information
- :acrn-commit:`173b534b` HV: modularization cleanup instr_emul header file
- :acrn-commit:`18dbdfd5` HV: replace lapic_pt with guest flag in vm_config
- :acrn-commit:`68aa718c` HV: replace bootargs config with acrn_vm_os_config
- :acrn-commit:`23f8e5e5` HV: replace memory config with acrn_vm_mem_config
- :acrn-commit:`253b2593` HV: remove vm_config pointer in acrn_vm struct
- :acrn-commit:`7bf9b1be` HV: enable pcpu bitmap config for partition mode
- :acrn-commit:`bc62ab79` HV: remove unused vm num config
- :acrn-commit:`2e32fba5` HV: remove sworld_supported in acrn_vm_config
- :acrn-commit:`ec199d96` HV: add get_sos_vm api
- :acrn-commit:`f3014a3c` HV: show correct vm name per config
- :acrn-commit:`e6117e0d` HV: refine launch vm interface
- :acrn-commit:`49e6deaf` HV: rename the term of vm0 to sos vm
- :acrn-commit:`55e5ed2e` hv:move ept violation handler to io_emul.c
- :acrn-commit:`1d98b701` hv: move 'setup_io_bitmap' to vm.c
- :acrn-commit:`de4ab6fd` hv:modulization for IO Emulation
- :acrn-commit:`808d0af2` HV: check to avoid interrupt delay timer add twice
- :acrn-commit:`d9c38baf` HV: remove unused mptable info
- :acrn-commit:`a8e4f227` HV: add new acrn_vm_config member and config files
- :acrn-commit:`c4a230f3` HV: rename the term of vm_description to vm_config
- :acrn-commit:`fe35dde4` Makefile: support SBL binary for E2E build
- :acrn-commit:`13c44f56` acrn/dm: Check device file of /dev/acrn_hsm to determine the path of offline VCPU
- :acrn-commit:`ca328816` acrn/dm: Add the check of acrn_vhm/acrn_hsm to open the VHM driver
- :acrn-commit:`e4a3a634` acrn/vhm: change the default notification vector to 0xF3
- :acrn-commit:`f45605dd` HV: modularization to separate CR related code
- :acrn-commit:`8265770f` hv:Change acrn_vhm_vector to static
- :acrn-commit:`b22c8b69` hv: add more MSR definitions
- :acrn-commit:`6372548e` hv:Fix violation "Cyclomatic complexity greater than 20" in instr_emul.c
- :acrn-commit:`ae144e1a` hv:fix MISRA-C violation in virq.c
- :acrn-commit:`6641bc79` hv: remove ACRN_REQUEST_TMR_UPDATE and unnecessary codes
- :acrn-commit:`fc61536b` hv: rework EOI_EXIT_BITMAP update logic
- :acrn-commit:`f15cc7d6` hv: set/clear TMR bit like hardware behave
- :acrn-commit:`c9b61748` hv: Make reserved regions in E820 table to Supervisor pages
- :acrn-commit:`4322b024` version: 0.6-unstable

379
doc/release_notes/release_notes_0.7.rst
View File

@ -1,379 +0,0 @@
.. _release_notes_0.7:
ACRN v0.7 (Mar 2019)
####################
We are pleased to announce the release of Project ACRN version 0.7.
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline
embedded development through an open source platform. Check out the
:ref:`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 either download this source code as a zip or
tar.gz file (see the `ACRN v0.7 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v0.7>`_ or
use Git clone and checkout commands:
.. code-block:: bash
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v0.7
The project's online technical documentation is also tagged to correspond
with a specific release: generated v0.7 documents can be found at
https://projectacrn.github.io/0.7/. Documentation for the latest
(master) branch is found at https://projectacrn.github.io/latest/.
ACRN v0.7 requires Clear Linux OS version 28260.
Version 0.7 New Features
************************
Enable Cache QOS With CAT
=========================
Cache Allocation Technology (CAT) is enabled on Apollo Lake (APL)
platforms, providing cache isolation between VMs mainly for real-time
performance quality of service (QoS). The CAT for a specific VM is
normally set up at boot time per the VM configuration determined at
build time. For debugging and performance tuning, the CAT can also be
enabled and configured at runtime by writing proper values to certain
MSRs using the ``wrmsr`` command on ACRN shell.
Support ACPI Power Key Mediator
===============================
ACRN supports ACPI power/sleep key on the APL and KBL NUC platforms,
triggering S3/S5 flow, following the ACPI spec.
Document Updates
================
Several new documents have been added in this release, including:
* ACRN Roadmap: look ahead in 2019
* Performance analysis of VBS-k framework
* HLD design doc for IOC virtualization
* Additional project coding guidelines
New Features Details
********************
- :acrn-issue:`940` - Device: IPU support
- :acrn-issue:`1138` - Debug: NPK
- :acrn-issue:`1186` - Disable VBS_DEBUG to improve VBS-K performance
- :acrn-issue:`1508` - DM: customized changes for RPMB mux kernel module
- :acrn-issue:`1536` - dm: add virtio_mei mediator
- :acrn-issue:`1544` - dm: rpmb: Support RPMB mode config from launch.sh
- :acrn-issue:`1812` - export kdf_sha256 interface from crypto lib
- :acrn-issue:`1815` - improve emulation of I/O port CF9
- :acrn-issue:`1915` - Enable Audio Mediator
- :acrn-issue:`1953` - Add cmdline option to disable/enable vhm module for guest
- :acrn-issue:`2176` - Fix RTC issues in ACPI
- :acrn-issue:`2319` - Add vHPET support
- :acrn-issue:`2351` - Enable post-launched hybrid mode
- :acrn-issue:`2407` - Coding style changes for IOAPIC and MSI representation
- :acrn-issue:`2426` - Enable Interrupt Remapping feature
- :acrn-issue:`2431` - VPCI code cleanup
- :acrn-issue:`2448` - Adding support for socket as a backend for Virtio-Console
- :acrn-issue:`2462` - Enable cache QOS with CAT
- :acrn-issue:`2496` - VTD/IOMMU Modularization
Fixed Issues Details
********************
- :acrn-issue:`1319` - SD card pass-through: UOS can't see SD card after UOS reboot.
- :acrn-issue:`1774` - UOS cannot stop by command: acrnctl stop [vm name] in SOS
- :acrn-issue:`1780` - Some video formats cannot be played in SOS.
- :acrn-issue:`1782` - UOS failed to get ip with the pass-throughed network card
- :acrn-issue:`1999` - [APLNUC][KBLNUC][APLUP2]UOS reset fails with acrnctl reset command
- :acrn-issue:`2276` - OVMF failed to launch UOS on UP2
- :acrn-issue:`2298` - Hard codes path to iasl
- :acrn-issue:`2316` - Tools don't respect CFLAGS/LDFLAGS from environment
- :acrn-issue:`2338` - [UP2]Lost 2G memory in SOS when using SBL as bootloader on UP2
- :acrn-issue:`2370` - Doesn't use parallel make in subbuilds
- :acrn-issue:`2422` - [PATCH] profiling: fix the system freeze issue when running profiling tool
- :acrn-issue:`2453` - Fix vHPET memory leak on device reset
- :acrn-issue:`2455` - host call stack disappear when dumping
- :acrn-issue:`2516` - [UP2][SBL] System hang with DP monitor connected
- :acrn-issue:`2528` - [APLUP2] SBL (built by SBL latest code) failed to boot ACRN hypervisor
- :acrn-issue:`2543` - vLAPIC: DCR not properly initialized
- :acrn-issue:`2548` - [APLNUC/KBLNUC][GVT][SOS/LAAG] Weston fails to play video in SOS and UOS
- :acrn-issue:`2572` - Startup SOS Fails
- :acrn-issue:`2588` - Uninitialized Variable is used in acrn_kernel/drivers/acrn/acrn_trace.c and acrn_hvlog.c
- :acrn-issue:`2606` - HV crash during running VMM related Hypercall fuzzing test.
- :acrn-issue:`2624` - Loading PCI devices with table_count > CONFIG_MAX_MSIX_TABLE_NUM leads to writing outside of struct.
- :acrn-issue:`2643` - Ethernet pass-through, network card can't get ip in uos
- :acrn-issue:`2674` - VGPU needs the lock when updating ppggt/ggtt to avoid the race condition
- :acrn-issue:`2695` - UOS powers off or suspend while pressing power key, UOS has no response
Known Issues
************
:acrn-issue:`1773` - USB Mediator: Can't find all devices when multiple USB devices connected [Reproduce rate:60%]
After booting UOS with multiple USB devices plugged in, there's a 60% chance that one or more devices are not discovered.
**Impact:** Cannot use multiple USB devices at same time.
**Workaround:** Unplug and plug-in the unrecognized device after booting.
-----
:acrn-issue:`1991` - Input not accepted in UART Console for corner case
Input is useless in UART Console for a corner case, demonstrated with these steps:
1) Boot to SOS
2) ssh into the SOS.
3) use ``./launch_UOS.sh`` to boot UOS.
4) On the host, use ``minicom -s dev/ttyUSB0``.
5) Use ``sos_console 0`` to launch SOS.
**Impact:** Fails to use UART for input.
**Workaround:** Enter other keys before typing :kbd:`Enter`.
-----
:acrn-issue:`1996` - There is an error log when using ``acrnd&`` to boot UOS
An error log is printed when starting ``acrnd`` as a background job
(``acrnd&``) to boot UOS. The UOS still boots up
normally, but prints::
Failed to open the socket(sos-lcs) to query the reason for the wake-up.
Activating all vms when acrnd & to boot uos.
**Impact:** UOS boots normally, but prints an error log message.
**Workaround:** None.
-----
:acrn-issue:`2267` - [APLUP2][LaaG] LaaG can't detect 4k monitor
After launching UOS on APL UP2 , 4k monitor cannot be detected.
**Impact:** UOS can't display on a 4k monitor.
**Workaround:** Use a monitor with less than 4k resolution.
-----
:acrn-issue:`2278` - [KBLNUC] Cx/Px is not supported on KBLNUC
C states and P states are not supported on KBL NUC.
**Impact:** Power Management state-related operations in SOS/UOS on
KBL NUC can't be used.
**Workaround:** None
-----
:acrn-issue:`2279` - [APLNUC] After exiting UOS with mediator
Usb_KeyBoard and Mouse, SOS cannot use the USB keyboard and mouse.
These steps reproduce the issue:
1) Insert USB keyboard and mouse in standard A port (USB3.0 port)
2) Boot UOS by sharing the USB keyboard and mouse in cmd line:
``-s n,xhci,1-1:1-2:1-3:1-4:2-1:2-2:2-3:2-4 \``
3) UOS access USB keyboard and mouse.
4) Exit UOS.
5) SOS tries to access USB keyboard and mouse, and fails.
**Impact:** SOS cannot use USB keyboard and mouse in such case.
**Workaround:** Unplug and plug-in the USB keyboard and mouse after exiting UOS.
-----
:acrn-issue:`2522` - [NUC7i7BNH] After starting IAS in SOS, there is no display
On NUC7i7BNH, after starting IAS in SOS, there is no display if the monitor is
connected with a TPC-to-VGA connector.
**Impact:** Special model [NUC7i7BNH] has no display in SOS.
**Workaround:** None.
-----
:acrn-issue:`2523` - UOS monitor does not display when using IAS
There is no UOS display after starting IAS weston.
**Impact:** Cannot use IAS weston in UOS.
**Workaround:**
1) Use weston instead of IAS weston: ``swupd install x11-server``
2) Use acrn-kernel to rebuild SOS kernel to replace integrated kernel.
Confirm "DRM_FBDEV_EMULATION" related configs in kernel_config_sos are:
.. code-block:: bash
CONFIG_DRM_KMS_FB_HELPER=y
CONFIG_DRM_FBDEV_EMULATION=y
CONFIG_DRM_FBDEV_OVERALLOC=100
The issue will be fixed in the next release.
-----
:acrn-issue:`2524` - [UP2][SBL] Launching UOS hangs while weston is running in SOS
When using weston in SOS, it will hang during the UOS launch.
**Impact:** launching UOS hangs, and then no display in UOS.
**Workaround:** Use acrn-kernel to rebuild SOS kernel to replace the
integrated kernel. Confirm "DRM_FBDEV_EMULATION" related
configs in kernel_config_sos are:
.. code-block:: bash
CONFIG_DRM_KMS_FB_HELPER=y
CONFIG_DRM_FBDEV_EMULATION=y
CONFIG_DRM_FBDEV_OVERALLOC=100
The issue will be fixed in the next release.
-----
:acrn-issue:`2527` - [KBLNUC][HV]System will crash when run ``crashme`` (SOS/UOS)
System will crash after a few minutes running stress test ``crashme`` tool in SOS/UOS.
**Impact:** System may crash in some stress situations.
**Workaround:** None
-----
:acrn-issue:`2526` - Hypervisor crash when booting UOS with acrnlog running with mem loglevel=6
If we use ``loglevel 3 6`` to change the mem loglevel to 6, we may hit a page fault in HV.
**Impact:** Hypervisor may crash in some situation.
**Workaround:** None
-----
:acrn-issue:`2753` - UOS cannot resume after suspend by pressing power key
UOS cannot resume after suspend by pressing power key
**Impact:** UOS may failed to resume after suspend by pressing the power key.
**Workaround:** None
.. comment
Use the syntax:
:acrn-issue:`663` - Short issue description
Longer description that helps explain the problem from the user's
point of view (not internal reasons). **Impact:** What's the
consequences of the issue, and how it can affect the user or system.
**Workaround:** Describe a workaround if one exists (or refer them to the
:acrn-issue:`663`` if described well there. If no workaround, say
"none".
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v0.6
release in Feb 2019 (click on the CommitID link to see details):
.. comment
This list is obtained from this git command (update the date to pick up
changes since the last release):
git log --pretty=format:'- :acrn-commit:`%h` %s' --after="2018-03-01"
- :acrn-commit:`c72e2e8c` - doc: use the new board name for UP2 in create-up2-images.sh script
- :acrn-commit:`56afe97e` - doc: fix broken external links
- :acrn-commit:`e263b554` - HV: Fix modularization vm config code lost CAT code
- :acrn-commit:`703b366c` - dm: use power button acpi device to find its input event
- :acrn-commit:`8a324060` - ACRN: dm: Fix launch UOS script "-d" parameter fail issue
- :acrn-commit:`06118998` - OVMF release v0.7
- :acrn-commit:`6794660e` - HV: use the common functions defined in vdev.c to reduce duplicate code
- :acrn-commit:`be3fbaa4` - HV: add generic vdev functions to vdev.c
- :acrn-commit:`731b0444` - HV: rename core.c to vdev.c
- :acrn-commit:`819bcec6` - HV: remove sharing_mode_vdev_array from sharing_mode.c
- :acrn-commit:`00f9b850` - HV: move pci_vdevs[] array from vm.h to vpci.h
- :acrn-commit:`8c3cfe62` - doc: add VBSK overhead analysis doc
- :acrn-commit:`30159d5b` - doc: add some rules related to coding style
- :acrn-commit:`ff65a103` - HV: vm_configs array refinement
- :acrn-commit:`0d90515b` - HV: refine is_lapic_pt
- :acrn-commit:`1bb15c64` - HV: modularization vm config code
- :acrn-commit:`35dfadc9` - dm: check SCI_EN bit of pm1_control before trigger SCI
- :acrn-commit:`566e8824` - dm: power button emulation by acrnctl command.
- :acrn-commit:`32a7b4f1` - doc: add IOC virtualization HLD
- :acrn-commit:`c69dab0a` - hv: add support of EPT mapping of high MMIO
- :acrn-commit:`29b1ebcd` - dm: add support of high MMIO mapping
- :acrn-commit:`32925c10` - dm: allocate 64bit MMIO above 4G strictly to pass OVMF check
- :acrn-commit:`aed75145` - dm: Limit 64 bits PCI BAR region address space
- :acrn-commit:`7628e790` - DM: virtio-gpio: use virtio_base as the first member of virtio_gpio
- :acrn-commit:`a89c41dd` - HV: cleanup header files under hypervisor/common
- :acrn-commit:`3cb5542b` - HV: cleanup header files under hypervisor/dm
- :acrn-commit:`e2995538` - tools: acrn-crashlog: new file to count all events happened in system
- :acrn-commit:`73e53232` - tools: acrn-crashlog: stop only collecting logs when exceeding configured size
- :acrn-commit:`e38ff18b` - hv:cleanup header files for release folder
- :acrn-commit:`33ecdd73` - Makefile: undefine _FORTIFY_SOURCE prior using it
- :acrn-commit:`3b2784ec` - HV: CAT: support config CAT from acrn_vm_config
- :acrn-commit:`43ee5590` - HV: CAT: capability enumeration
- :acrn-commit:`cf524e68` - HV: CAT: add platform specified info for CLOS
- :acrn-commit:`ae34fdd8` - doc: fix misspellings
- :acrn-commit:`a9482f46` - tweak GSG
- :acrn-commit:`2e60adef` - hv: vmcs: simplify update EOI-exit bitmap
- :acrn-commit:`501b3f7e` - hv:cleanup header files for debug folder
- :acrn-commit:`511d4c15` - hv:cleanup console.h
- :acrn-commit:`cca87579` - hv: remove the duplicated init_vm_boot_info() for partition mode
- :acrn-commit:`cf1515d6` - hv: optimize the assignment of load addresses for multiboot images
- :acrn-commit:`3f0ff2ec` - hv: search additional argument when parsing seed from ABL
- :acrn-commit:`f5504e80` - HV: vpci_vdev_array cleanup
- :acrn-commit:`a25f1a40` - HV: remove default folder in configs
- :acrn-commit:`f9b5e21b` - HV: rename board name of up2 to apl-up2
- :acrn-commit:`94e12275` - hv: code style fix for partition mode specific code
- :acrn-commit:`8478a328` - HV: return an error code when REQ state mismatch in acrn_insert_request
- :acrn-commit:`68652104` - ACRN: dm: Modify runC default rootfs directory
- :acrn-commit:`55cb7770` - ACRN: dm: Add new capabilities for runC container
- :acrn-commit:`5690b762` - ACRN: dm: Change runC container's start arguments
- :acrn-commit:`6e919d2a` - ACRN: dm: Add launch container method in script
- :acrn-commit:`f95da183` - dm: acrn-tool: Add del runC configuration in acrnctl del
- :acrn-commit:`a0efd3e5` - dm: acrn-tool: Add new parameter for acrnctl add
- :acrn-commit:`2f7ed65f` - DM: Attestation Keybox support in SOS DM
- :acrn-commit:`987ddafa` - hv: vlapic: refine apicv_post_intr to internal function
- :acrn-commit:`5dd6e79f` - hv: vlapic: refine vlapic_enabled to internal function
- :acrn-commit:`e218efd5` - hv: vm: move vm_active_cpus to vm.h
- :acrn-commit:`780f520f` - DM: virtio-gpio: return a valid length for GPIO request
- :acrn-commit:`8bc0e128` - HV: remove pbdf from struct pci_vdev
- :acrn-commit:`4d119853` - HV: define function bdf_is_equal() to compare bdf
- :acrn-commit:`02866353` - HV: fix comments issue
- :acrn-commit:`1454dd37` - HV: this patch fixes bar address non-zero checking for 64-bit bars
- :acrn-commit:`b43f5cba` - tools: do not include unnecessary files in release build
- :acrn-commit:`eee7d8e7` - hv: debug: mark the mmio address for npk log as hv owned
- :acrn-commit:`bd1e7a46` - hv:cleanup header files for arch folder
- :acrn-commit:`ac7a8a72` - hv:merge MACROs E820_MAX_ENTRIES and NUM_E820_ENTRIES
- :acrn-commit:`fb92d55b` - doc: fix formatting of up2 doc
- :acrn-commit:`1d783d3d` - doc: add 0.6 to doc version menu
- :acrn-commit:`4928be5f` - doc: update partition mode config on up2
- :acrn-commit:`02ae775b` - hv: pae: fix a issue of loading pdptrs when handle cr4
- :acrn-commit:`25385241` - hv: pae: fix bug when calculate PDPT address
- :acrn-commit:`21ae3e74` - DM: virtio-gpio: add print log
- :acrn-commit:`6b0643b5` - DM: virtio-gpio: implementation of gpio operations
- :acrn-commit:`77e17b5d` - DM: virtio-gpio: gpio initialization.
- :acrn-commit:`57029315` - DM: virtio-gpio: virtio framework implementation.
- :acrn-commit:`5300e911` - config: enable parsing dmar table dynamically on UP2
- :acrn-commit:`8e8ed07d` - dm: implement power button for power management
- :acrn-commit:`b24a8a0f` - hv:cleanup header file for guest folder
- :acrn-commit:`75f6cab5` - hv:cleanup header file for per_cpu.h
- :acrn-commit:`c093638b` - hv:merge two header files to one with the same name
- :acrn-commit:`04c30fb3` - hv:move 2 APIs from hypervisor.h to guest_memory.c
- :acrn-commit:`07656a9c` - DM: modify acpi for IASL to support ACPI6.3
- :acrn-commit:`827fffed` - hv: exception: fault type exception should set resume flag in rflags
- :acrn-commit:`26385183` - acrn.conf: clean-up SOS kernel options (EFI platforms)
- :acrn-commit:`caab595e` - hv: vlapic: properly initialize DCR
- :acrn-commit:`614b2ea8` - version: 0.7-unstable

390
doc/release_notes/release_notes_0.8.rst
View File

@ -1,390 +0,0 @@
.. _release_notes_0.8:
ACRN v0.8 (Apr 2019)
####################
We are pleased to announce the release of Project ACRN version 0.8.
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline
embedded development through an open source platform. Check out the
:ref:`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 either download this source code as a zip or
tar.gz file (see the `ACRN v0.8 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v0.8>`_ or
use Git clone and checkout commands:
.. code-block:: bash
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v0.8
The project's online technical documentation is also tagged to correspond
with a specific release: generated v0.8 documents can be found at
https://projectacrn.github.io/0.8/. Documentation for the latest
(master) branch is found at https://projectacrn.github.io/latest/.
ACRN v0.8 requires Clear Linux OS version 28600.
Version 0.8 New Features
************************
GPIO Virtualization
=========================
GPIO virtualization is supported as para-virtualization based on the
Virtual I/O Device (VIRTIO) specification. The GPIO consumers of the
Front-end are able to set or get GPIO values, directions, and
configuration via one virtual GPIO controller. In the Back-end, the GPIO
command line in the launch script can be modified to map native GPIO to
UOS.
Enable QoS Based on runC Container
==================================
ACRN supports Device-Model QoS based on runC container to control the SOS
resources (CPU, Storage, MEM, NET) by modifying the runC configuration file.
S5 Support for RTVM
===============================
ACRN supports a Real-time VM (RTVM) shutting itself down. A RTVM is a
kind of VM that the SOS can't interfere at runtime, and as such, can
only power itself off internally. All poweroff requests external to the
RTVM will be rejected to avoid any interference.
Document Updates
================
Several new documents have been added in this release, including:
* :ref:`Zephyr RTOS as Guest OS <using_zephyr_as_uos>`
* :ref:`Enable cache QoS with CAT <rdt_configuration>`
* :ref:`ACRN kernel parameter introduction <kernel-parameters>`
* :ref:`faq` update for two issues
* :ref:`ACRN Debug introduction <acrn-debug>`
New Features Details
********************
- :acrn-issue:`923` - GPU Mediator shall be compatible with operation of graphics safety watchdog
- :acrn-issue:`1409` - Add support for profiling [sep/socwatch tools]
- :acrn-issue:`1568` - Implement PCI emulation functionality in HV for UOS passthrough devices and SOS MSI/MSI-X remapping
- :acrn-issue:`1867` - vMSR code reshuffle
- :acrn-issue:`2020` - DM: Enable QoS in ACRN, based on runC container
- :acrn-issue:`2512` - GPIO virtualization
- :acrn-issue:`2611` - hv: search additional argument when parsing seed from ABL.
- :acrn-issue:`2868` - OVMF release v0.8
- :acrn-issue:`2708` - one binary for SBL and UEFI
- :acrn-issue:`2713` - Enable ACRN to boot Zephyr
- :acrn-issue:`2792` - Pass ACRN E820 map to OVMF
- :acrn-issue:`2865` - support S5 of Normal VM with lapic_pt
Fixed Issues Details
********************
- :acrn-issue:`1996` - [APLNUC/KBLNUC/APLUP2]There is an error log when using "acrnd&" to boot UOS
- :acrn-issue:`2052` - tpm_emulator code reshuffle
- :acrn-issue:`2474` - Need to capture dropped sample info while profiling
- :acrn-issue:`2490` - systemd virtualization detection doesn't work
- :acrn-issue:`2522` - Start ias in SOS, no display
- :acrn-issue:`2523` - UOS monitor does not display when using ias
- :acrn-issue:`2524` - [UP2][SBL] Launching UOS hang while weston is running in SOS
- :acrn-issue:`2597` - Return PIPEDSL from HW register instead of cached memory for Guest VGPU
- :acrn-issue:`2704` - Possible memory leak issues
- :acrn-issue:`2760` - [UP2]{SBL] make APL-UP2 SBL acrn-hypervisor sos image failed.
- :acrn-issue:`2772` - Enable PCI-E realtek MMC card for UOS
- :acrn-issue:`2780` - [APL_NUC KBL_NUC EFI_UP2]Update clear Linux missing acrn.efi file
- :acrn-issue:`2792` - Pass ACRN E820 map to OVMF
- :acrn-issue:`2829` - The ACRN hypervisor shell interactive help is rather terse
- :acrn-issue:`2830` - Warning when building the hypervisor
- :acrn-issue:`2851` - [APL/KBL/UP2][HV][LaaG]Uos cannot boot when acrnctl add Long_VMName of more than 26
- :acrn-issue:`2870` - Use 'sha512sum' for validating all virtual bootloaders
Known Issues
************
:acrn-issue:`1773` - USB Mediator: Can't find all devices when multiple USB devices connected [Reproduce rate:60%]
After booting UOS with multiple USB devices plugged in, there's a 60% chance that one or more devices are not discovered.
**Impact:** Cannot use multiple USB devices at same time.
**Workaround:** Unplug and plug-in the unrecognized device after booting.
-----
:acrn-issue:`1991` - Input not accepted in UART Console for corner case
Input is useless in UART Console for a corner case, demonstrated with these steps:
1) Boot to SOS
2) ssh into the SOS.
3) use ``./launch_UOS.sh`` to boot UOS.
4) On the host, use ``minicom -s dev/ttyUSB0``.
5) Use ``sos_console 0`` to launch SOS.
**Impact:** Fails to use UART for input.
**Workaround:** Enter other keys before typing :kbd:`Enter`.
-----
:acrn-issue:`2267` - [APLUP2][LaaG] LaaG can't detect 4k monitor
After launching UOS on APL UP2 , 4k monitor cannot be detected.
**Impact:** UOS can't display on a 4k monitor.
**Workaround:** Use a monitor with less than 4k resolution.
-----
:acrn-issue:`2278` - [KBLNUC] Cx/Px is not supported on KBLNUC
C states and P states are not supported on KBL NUC.
**Impact:** Power Management state-related operations in SOS/UOS on
KBL NUC can't be used.
**Workaround:** None
-----
:acrn-issue:`2279` - [APLNUC] After exiting UOS, SOS can't use USB keyboard and mouse
After exiting UOS with mediator
Usb_KeyBoard and Mouse, SOS cannot use the USB keyboard and mouse.
These steps reproduce the issue:
1) Insert USB keyboard and mouse in standard A port (USB3.0 port)
2) Boot UOS by sharing the USB keyboard and mouse in cmd line:
``-s n,xhci,1-1:1-2:1-3:1-4:2-1:2-2:2-3:2-4 \``
3) UOS access USB keyboard and mouse.
4) Exit UOS.
5) SOS tries to access USB keyboard and mouse, and fails.
**Impact:** SOS cannot use USB keyboard and mouse in such case.
**Workaround:** Unplug and plug-in the USB keyboard and mouse after exiting UOS.
-----
:acrn-issue:`2527` - System will crash after a few minutes running stress test ``crashme`` tool in SOS/UOS.
System stress test may cause a system crash.
**Impact:** System may crash in some stress situations.
**Workaround:** None
-----
:acrn-issue:`2526` - Hypervisor crash when booting UOS with acrnlog running with mem loglevel=6
If we use ``loglevel 3 6`` to change the mem loglevel to 6, we may hit a page fault in HV.
**Impact:** Hypervisor may crash in some situation.
**Workaround:** None
-----
:acrn-issue:`2753` - UOS cannot resume after suspend by pressing power key
UOS cannot resume after suspend by pressing power key
**Impact:** UOS may failed to resume after suspend by pressing the power key.
**Workaround:** None
.. comment
Use the syntax:
:acrn-issue:`663` - Short issue description
Longer description that helps explain the problem from the user's
point of view (not internal reasons). **Impact:** What's the
consequences of the issue, and how it can affect the user or system.
**Workaround:** Describe a workaround if one exists (or refer them to the
:acrn-issue:`663`` if described well there. If no workaround, say
"none".
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v0.6
release in Feb 2019 (click on the CommitID link to see details):
.. comment
This list is obtained from this git command (update the date to pick up
changes since the last release):
git log --pretty=format:'- :acrn-commit:`%h` - %s' --after="2018-03-01"
- :acrn-commit:`296c974d` - OVMF release v0.8
- :acrn-commit:`e7f77244` - Tools: acrnctl fix return value when it fails to execute the commands
- :acrn-commit:`eea0ecd2` - Tools: acrnctl fix return value when it fails to execute the commands.
- :acrn-commit:`cee45a80` - hv: add default handlers for PIO/MMIO access
- :acrn-commit:`01b28c8e` - doc: Add tutorial about how to use CAT on UP2
- :acrn-commit:`79582b99` - doc: update software design guidelines
- :acrn-commit:`efad4963` - DM: Add -A to support S5 of hard rt vm
- :acrn-commit:`382acfaf` - HV: Using INIT to kick vCPUs off when RTVM poweroff by itself
- :acrn-commit:`2771b46b` - HV: Add one delmode parameter to make_reschedule_request
- :acrn-commit:`ef9be020` - HV: Introduce one new API send_single_init
- :acrn-commit:`8ad5adce` - HV: Set vm state as with VM_POWERING_OFF when RTVM poweroff by itself
- :acrn-commit:`83d11bbf` - HV: Register S5 pio handler for dm-launched RTVM
- :acrn-commit:`1c0d7f78` - HV: HV: make io_read_fn_t return true or false
- :acrn-commit:`3b2ad677` - HV: make io_write_fn_t return true or false
- :acrn-commit:`ed286e32` - HV: Introduce a new API is_rt_vm
- :acrn-commit:`2e4d7eb5` - DM: Add new flag GUEST_FLAG_RT for RTVM
- :acrn-commit:`71f75ebf` - Tools: acrnlog: fix confusing message "bad file descriptor" when start acrnlog
- :acrn-commit:`9f234222` - ACRN: dm: Enable mount namespace for container.
- :acrn-commit:`dde326ec` - Acrn: dm: Add new start parameter in sample args
- :acrn-commit:`e91d7402` - hv: Debug messages from a CPU are overlapped with other CPUs messages
- :acrn-commit:`558a1788` - doc: update coding guidelines
- :acrn-commit:`868778a6` - hv: fix vulnerability when VM is destroyed
- :acrn-commit:`5a7be9b8` - tools: acrnctl fix cmd buffer is truncated when vmname too long
- :acrn-commit:`b2f2d952` - tools: acrnctl restrict length of vmname to 32 bytes
- :acrn-commit:`8109c2e9` - DM: restrict vmname size to 32 bytes
- :acrn-commit:`b1586ccc` - HV: move MAX_CONFIG_NAME_SIZE to acrn_common.h
- :acrn-commit:`c55308bd` - DM: use soft link of acrn_common.h in HV
- :acrn-commit:`06761102` - dm: remove smbios
- :acrn-commit:`3effbb05` - Revert "hv: vmsr: add IA32_MISC_ENABLE to msr store area"
- :acrn-commit:`40168e73` - hv: vlapic: remove TPR set/get API
- :acrn-commit:`4a683ed1` - hv: vlapic: minor fix for update_msr_bitmap_x2apic_apicv
- :acrn-commit:`20164799` - dm: leave a gap for 32-bit PCI hole in E820 map
- :acrn-commit:`3be6c659` - HV: merge partition_mode.c and sharing_mode.c's code into vpci.c
- :acrn-commit:`320bf183` - HV: rename pci_priv.h to vpci_priv.h
- :acrn-commit:`1a3c9b32` - HV: rename vpci files
- :acrn-commit:`c6a60dd2` - HV: remove all CONFIG_PARTITION_MODE from dm/vpci code
- :acrn-commit:`691468a3` - HV: Remove hypervisor.h from bsp folder
- :acrn-commit:`3d85d72f` - doc: update OVMF image location
- :acrn-commit:`d4ce780e` - doc: update the instructions to increase the size of a UOS disk image
- :acrn-commit:`80dc2c85` - doc: add some rules related to language extensions
- :acrn-commit:`3026a372` - DOC:Update standard reference of SW design guidelines
- :acrn-commit:`fddc5b91` - doc: update UP2 sample directory name in create-up2-image.sh
- :acrn-commit:`904c9e29` - doc: add more details to the FAQ (for version 0.7)
- :acrn-commit:`c47efa3f` - Add new FAQ
- :acrn-commit:`98b3d98a` - hv: vmsr: add IA32_MISC_ENABLE to msr store area
- :acrn-commit:`273381b3` - hv: vmsr: rename msr_num to msr_index in struct msr_store_entry
- :acrn-commit:`5585084c` - hv:move 'udelay' to timer.c
- :acrn-commit:`370998ba` - hv: replace MEM_2K with a new macro MAX_BOOTARGS_SIZE for bootargs size
- :acrn-commit:`12d97728` - DM: virtio-gpio: export GPIO ACPI device
- :acrn-commit:`014e611b` - DM: virtio-gpio: add IRQ statistics
- :acrn-commit:`83a98acb` - DM: virtio-gpio: support reading value from IRQ descriptor
- :acrn-commit:`d34b3ebd` - DM: virtio-gpio: emulate GPIO IRQ controller
- :acrn-commit:`92a0a399` - DM: virtio-gpio: GPIO IRQ initialization.
- :acrn-commit:`9480af8d` - DM: virtio-gpio: setup two virtqueues for gpio irq
- :acrn-commit:`e381aef2` - hv: seed: remove unused seed parsing source files
- :acrn-commit:`0947fbab` - HV: Fix a compiler warning in firmware.h
- :acrn-commit:`071ce15e` - dm: build E820 map for OVMF
- :acrn-commit:`4dd13310` - dm: remove empty UOS E820 entries
- :acrn-commit:`643513f3` - dm: update UOS default E820 map
- :acrn-commit:`263b486a` - dm: pci: add MMIO fallback handler for 64-bit PCI hole
- :acrn-commit:`82e42cfa` - dm: clean up mem.c
- :acrn-commit:`890d4022` - dm: remove GUEST_CFG_OFFSET
- :acrn-commit:`f97ba340` - Doc: Add tutorial about using zephyr as uos
- :acrn-commit:`410c76ac` - hv: enhance ACRN shell interactive help
- :acrn-commit:`a0de49d0` - hv: fix potential buffer overflow in sbl_init_vm_boot_info()
- :acrn-commit:`93ed2af1` - hv: passthru TSC_ADJUST to VM with lapic pt
- :acrn-commit:`f32b59d7` - hv: disable mpx capability for guest
- :acrn-commit:`71ce4c25` - HV: unify the sharing mode and partition mode coding style for similar functions
- :acrn-commit:`026250fd` - HV: centralize the pci cfg read/write sanity checking code
- :acrn-commit:`a403128a` - HV: remove vpci ops
- :acrn-commit:`aa1ee942` - HV: declare and export vpci ops functions as global instead of static local
- :acrn-commit:`a7f528cf` - HV: remove vdev ops for partition mode
- :acrn-commit:`b1cc1881` - hv: Use domain/device specific invalidation for DMAR translation caches
- :acrn-commit:`5c046879` - hv: minor fixes to a few calls to strncpy_s()
- :acrn-commit:`5fdc7969` - doc: add tutorial on how to increase the UOS disk size
- :acrn-commit:`657ac497` - doc: add rdmsr/wrmsr to the "ACRN Shell Commands" documentation
- :acrn-commit:`90b49375` - doc: add rules related to implementation-specific behaviors
- :acrn-commit:`e131d705` - hv: vmconfig: minor fix about regression of commit 79cfb1
- :acrn-commit:`9abd469d` - config: unify board names to lowercase
- :acrn-commit:`5398c901` - hv: remove CONFIG_PARTITION_MODE for pre-launched VM vE820 creation
- :acrn-commit:`ca6e3411` - HV: add vrtc for sharing mode
- :acrn-commit:`1b79f28e` - hv: update CR0/CR4 on demand in run_vcpu()
- :acrn-commit:`19c53425` - HV: remove vdev ops for sharing mode
- :acrn-commit:`eb4f4698` - HV: add const qualifier for the deinit vdev op functions
- :acrn-commit:`b2b1a278` - HV: remove intercepted_gpa and intercepted_size from struct pci_msix
- :acrn-commit:`5767d1e1` - HV: extract common code blocks to has_msi_cap and has_msix_cap functions
- :acrn-commit:`79cfb1cf` - hv: vmconfig: format guest flag with prefix GUEST_FLAG\_
- :acrn-commit:`c018b853` - hv: vmtrr: hide mtrr if hide_mtrr is true
- :acrn-commit:`906c79eb` - hv: vpci: restore vbdf when pci dev un-assigned from uos
- :acrn-commit:`7669a76f` - dm: passthru: pass pbdf when reset msi/msix interrupt
- :acrn-commit:`cd360de4` - hv: fix wrong comment message about CLOS usage in vm config
- :acrn-commit:`190b0940` - Makefile: build for apl-nuc by default
- :acrn-commit:`21d3dc68` - hv: seed: refine header file
- :acrn-commit:`0fb21cfa` - Tools: Acrnd fix reporting unnecessary error on NUC and UP2
- :acrn-commit:`ff41c008` - hv: trusty: refine control registers switching method
- :acrn-commit:`4157b843` - doc: add some rules related to naming convention
- :acrn-commit:`518a82d8` - hv: cleanup some hva/hpa conversion code
- :acrn-commit:`e9335fce` - doc: fix utf-8 punctuation, branding, spelling
- :acrn-commit:`9e78ad52` - doc: fix wrong description of trusty's memory mapping
- :acrn-commit:`fb3e47fd` - doc: add v0.7 version to master branch (/latest)
- :acrn-commit:`5e37c463` - version: 0.8-unstable
- :acrn-commit:`b147c5c6` - DM: Mark thre_int_pending as true when THR is empty
- :acrn-commit:`9b1e2f4c` - remove apl_sdc_stable branch story
- :acrn-commit:`53972001` - DM: fix memory leak
- :acrn-commit:`436c30e4` - doc: add 0.7 release notes
- :acrn-commit:`74023a9a` - hv: vtd: check bus number when assign/unassign device
- :acrn-commit:`93386d3c` - ACRN/DM: Destroy the created pci_device iterator to fix memory leak in passthru_init
- :acrn-commit:`31cb4721` - acrn/dm: Remove the memory leak in gvt mediator
- :acrn-commit:`065e16d3` - Makefile: make UP2 sample directory name consistent with board name
- :acrn-commit:`20249380` - audio-mediator: load updated audio kernel modules Audio kernel has updated name and add two new kernel modules from SOS 28100
- :acrn-commit:`95d1e402` - hv: refactor seed management
- :acrn-commit:`4d0419ed` - dm: passthru: fix potential mem leaks
- :acrn-commit:`caa291c0` - HV: some minor code cleanup for partition mode code
- :acrn-commit:`82789f44` - HV: declare and export partition mode's vdev functions as global instead of static local
- :acrn-commit:`93f6142d` - HV: declare and export sharing mode's vdev functions as global instead of static local
- :acrn-commit:`562628b9` - HV: remove the populate_msi_struct() function
- :acrn-commit:`3158c851` - HV: Modularize boot folder
- :acrn-commit:`286731d9` - hv:move instr_emul_ctxt instance to struct vcpu
- :acrn-commit:`5331b395` - hv:remove 'cpu_mode' from struct vm_guest_paging
- :acrn-commit:`ce387084` - hv: remove CONFIG_PLATFORM_[SBL|UEFI] and UEFI_STUB
- :acrn-commit:`334382f9` - efi-stub: minor change for uefi refactor
- :acrn-commit:`9b24620e` - hv: merge SBL and UEFI related stuff under boot
- :acrn-commit:`56d8b08b` - hv: merge SBL and UEFI related stuff under bsp
- :acrn-commit:`23e85ff1` - Makefile: remove deprecated PLATFORM
- :acrn-commit:`bd24e2de` - tools: acrnctl fix potential buffer overflow
- :acrn-commit:`78890622` - hv: vlapic: minor fix about detect_apicv_cap
- :acrn-commit:`f769f745` - hv: vlapic: add combined constraint for APICv
- :acrn-commit:`6f482b88` - dm: virtio: add memory barrier before notify FE
- :acrn-commit:`7ab6e7ea` - dm: usb: fix possible memory leak
- :acrn-commit:`694fca9c` - DM: Add sample script to launch zephyr as guest
- :acrn-commit:`204f9750` - tools: acrnd: Fix launch UOS by timer list without fork()
- :acrn-commit:`5d6f6ab7` - tools: acrn-manager: fix a race condition on updating VM state
- :acrn-commit:`d5ec844f` - tools: acrn-manager: Replace pdebug with explicit err msg
- :acrn-commit:`48774f71` - tools: acrn-manager: print more debug information
- :acrn-commit:`2b74e1a9` - HV: PAE: Add stac()/clac() in local_gva2gpa_pae
- :acrn-commit:`18ba7524` - dm: virtio-net: fix memory leak
- :acrn-commit:`31f04e1a` - doc: fix typos in coding guidelines
- :acrn-commit:`b75d5567` - Documentation: update the "ACRN Shell Commands" user guide
- :acrn-commit:`5f51e4a7` - pci.c: assert MSIX table count <= config max
- :acrn-commit:`137892fd` - hv: Remove multiple definitions for dmar translation structures
- :acrn-commit:`18b619da` - doc: add the doc for 'Error Detection and Handling'
- :acrn-commit:`72fbc7e7` - doc: add some comments for coding guidelines
- :acrn-commit:`e779982c` - doc: use the new board name for UP2 in create-up2-images.sh script
- :acrn-commit:`bf1aa5c1` - hv: destroy IOMMU domain after vpci_cleanup()
- :acrn-commit:`c0400b99` - HV: Fix modularization vm config code lost CAT code
- :acrn-commit:`649406b0` - HV: refine location of platform_acpi_info header
- :acrn-commit:`ff9ef2a1` - doc: fix broken external links
- :acrn-commit:`85b3ed3e` - doc: update the format in coding style part
- :acrn-commit:`f6a989b7` - dm: use power button acpi device to find its input event
- :acrn-commit:`55f52978` - hv:move several tsc APIs to timer.c
- :acrn-commit:`36f6a412` - hv:validate ID and state of vCPU for related APIs
- :acrn-commit:`9922c3a7` - HV: correct COM_IRQ default config type
- :acrn-commit:`741501c2` - hv: refine vlapic_calc_dest()
- :acrn-commit:`f572d1ec` - [RevertMe] dm: pci: restore workaround when alloc pci mem64 bar
- :acrn-commit:`ca3d4fca` - hv: vlapic: move LVT IRQ vector check to vlapic_fire_lvt
- :acrn-commit:`473d31c0` - hv: vlapic: add vector check for x2apic SELF IPI
- :acrn-commit:`e5d3a498` - hv: vlapic: call vlapic_accept_intr directly in vlapic_set_error
- :acrn-commit:`2b35c078` - hv: do EPT mapping only for physical memory backed GPA on pre-launched VMs
- :acrn-commit:`da14c961` - hv: simplify `get_primary_vcpu` and `vcpu_from_vid`
- :acrn-commit:`3d0d8609` - hv: vlapic: correct wrong use of vector
- :acrn-commit:`0943a836` - [hv] set ECX.bit31 to indicate the presence of a hypervisor
- :acrn-commit:`f6758fd6` - hv: fix a redundant check in general_sw_loader
- :acrn-commit:`b49df10a` - hv: Remove redundant get_dmar_info API calls
- :acrn-commit:`308d4e8c` - hv:move forward the initialization for iommu & ptdev
- :acrn-commit:`bc107105` - doc: fix the typo related to tab

48
doc/release_notes/release_notes_1.0.1.rst
View File

@ -1,48 +0,0 @@
.. _release_notes_1.0.1:
ACRN v1.0.1 (July 2019)
#######################
We are pleased to announce the release of ACRN version 1.0.1. This is a
maintenance release based off the v1.0 branch that primarily fixes some
potential security and stability issues discovered after the v1.0
release.
ACRN is a flexible, lightweight reference hypervisor that's built with
real-time and safety-criticality in mind and is optimized to streamline
embedded development through an open source platform. Check out
:ref:`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 either download this source
code as a zip or tar.gz file (see the `ACRN v1.0.1 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v1.0.1>`_)
or use the following Git clone and checkout commands::
$ git clone https://github.com/projectacrn/acrn-hypervisor
$ cd acrn-hypervisor
$ git checkout v1.0.1
There were no documentation changes in this update, so you can still
refer to the v1.0-specific documentation found at
https://projectacrn.github.io/1.0/.
Change Log in Version 1.0.1 Since Version 1.0
*********************************************
Primary changes are to fix several security and stability issues found
on the v1.0 branch, as listed here:
.. csv-table::
:header: "GIT issue ID", "Commit ID", "Description"
:widths: 15,15,70
:acrn-issue:`3245` , :acrn-commit:`5ced5fe7`, dm: use strncpy to replace strcpy
:acrn-issue:`3276` , :acrn-commit:`5530fc8f`, efi-stub: update string operation in efi-stub
, :acrn-commit:`b65489c2`, dm: use strnlen to replace strlen
:acrn-issue:`3277` , :acrn-commit:`0c0371fc`, dm: fix stability issue in mem.c and xhci.c
:acrn-issue:`3427` , :acrn-commit:`749556ef`, hv: fix symbols not stripped from release binaries
:acrn-issue:`3395` , :acrn-commit:`bc90db46`, dm: fix stability issue in block_if.c
:acrn-issue:`3396` , :acrn-commit:`2e7171d6`, dm: fix variable argument list read without ending with va_end
, :acrn-commit:`1394758d`, tools: fix variable argument list read without ending with va_end
:acrn-issue:`3397` , :acrn-commit:`d6f72885`, hv: fix stability issue in hypervisor

55
doc/release_notes/release_notes_1.0.2.rst
View File

@ -1,55 +0,0 @@
.. _release_notes_1.0.2:
ACRN v1.0.2 (Nov 2019)
######################
We are pleased to announce the release of ACRN version 1.0.2. This is a
maintenance release based on the v1.0 branch that primarily fixes some
potential security and stability issues discovered after the v1.0
release.
ACRN is a flexible, lightweight reference hypervisor that's built with
real-time and safety-criticality in mind and is optimized to streamline
embedded development through an open source platform. Check out
:ref:`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 either download this source
code as a zip or tar.gz file (see the `ACRN v1.0.2 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v1.0.2>`_)
or use the following Git clone and checkout commands::
$ git clone https://github.com/projectacrn/acrn-hypervisor
$ cd acrn-hypervisor
$ git checkout v1.0.2
There were no documentation changes in this update, so you can still
refer to the v1.0-specific documentation found at
https://projectacrn.github.io/1.0/.
Change Log in v1.0.2 Since v1.0.1
*********************************
Primary changes are to fix several security and stability issues found
on the v1.0 branch, as listed here:
.. csv-table::
:header: "GIT issue ID", "Commit ID", "Description"
:widths: 15,15,70
:acrn-issue:`4120` , :acrn-commit:`a94b2a53`, hv: ept: disable execute right on large pages
:acrn-issue:`4120` , :acrn-commit:`1a99288d`, hv: vtd: remove global cache invalidation per vm
:acrn-issue:`4120` , :acrn-commit:`2d55b49e`, hv: ept: flush cache for modified ept entries
:acrn-issue:`4120` , :acrn-commit:`a6944fe6`, hv: vtd: export iommu_flush_cache
:acrn-issue:`4091` , :acrn-commit:`30a773f7`, hv:unmap AP trampoline region from service VM's EPT
:acrn-issue:`4091` , :acrn-commit:`0b6447ad`, hv:refine modify_or_del_pte/pde/pdpte()function
:acrn-issue:`4093` , :acrn-commit:`b1951490`, acrn-hv: code review fix lib/string.c
:acrn-issue:`4089` , :acrn-commit:`6730660a`, tools: acrn-crashlog: refine crash complete code
:acrn-issue:`4088` , :acrn-commit:`aba91a81`, vm-manager: fix improper return value check for "strtol()"
:acrn-issue:`4087` , :acrn-commit:`995efc1b`, dm: refine the check of return value of snprintf
:acrn-issue:`4086` , :acrn-commit:`720a77c1`, dm: fix mutex lock issue in tpm_rbc.c
:acrn-issue:`4085` , :acrn-commit:`b51b8980`, dm: close filepointer before exiting acrn_load_elf()
:acrn-issue:`4084` , :acrn-commit:`84c3ee21`, dm: modify DIR handler reference postion
:acrn-issue:`4083` , :acrn-commit:`4baccdce`, dm: reduce potential crash caused by LIST_FOREACH
:acrn-issue:`4092` , :acrn-commit:`2e054f6c`, hv: fix error debug message in hcall_set_callback_vector
:acrn-issue:`4003` , :acrn-commit:`6199e653`, dm: validate the input in 'pci_emul_mem_handler()'

616
doc/release_notes/release_notes_1.0.rst
View File

@ -1,616 +0,0 @@
.. _release_notes_1.0:
ACRN v1.0 (May 2019)
####################
We are pleased to announce the release of ACRN version 1.0, a key
Project ACRN milestone focused on automotive Software-Defined Cockpit
(SDC) use cases and introducing additional architecture enhancements for
more IoT usages, such as Industrial.
This v1.0 release is a production-ready reference solution for SDC
usages that require multiple VMs and rich I/O mediation for device
sharing including GPU and USB devices. It also includes architectural
enhancements for scaling into new usages including Industrial real-time
support and diverse IoT workload consolidation.
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline embedded
development through an open source platform. Check out the :ref:`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 either download this source code as
a zip or tar.gz file (see the `ACRN v1.0 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v1.0>`_)
or use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v1.0
The project's online technical documentation is also tagged to correspond
with a specific release: generated v1.0 documents can be found at https://projectacrn.github.io/1.0/.
Documentation for the latest (master) branch is found at https://projectacrn.github.io/latest/.
ACRN v1.0 requires Clear Linux* OS version 29070.
Version 1.0 Major Features
**************************
Hardware Support
================
ACRN supports multiple x86 platforms and has been tested with Apollo
Lake and Kaby Lake NUCs, and the UP Squared board.
(See :ref:`hardware` for supported platform details.)
APL UP2 Board With SBL Firmware
===============================
ACRN supports APL UP2 board with Slim Bootloader (SBL) firmware.
Slim Bootloader is a modern, flexible, light-weight,
open source reference bootloader that is also fast, small,
customizable, and secure. An end-to-end reference build has been verified
on UP2/SBL board using ACRN hypervisor, Clear Linux OS as SOS, and Clear
Linux OS as UOS.
Enable Post-Launched RTVM Support for Real-Time UOS in ACRN
===========================================================
This release provides initial patches enabling a User OS (UOS) running as a
virtual machine (VM) with real-time characteristics,
also called a "post-launched RTVM". More patches for ACRN real time support will continue.
Enable Cache QOS With CAT
=========================
Cache Allocation Technology (CAT) is available on Apollo Lake (APL) platforms,
providing cache isolation between VMs mainly for real-time performance quality
of service (QoS). The CAT for a specific VM is normally set up at boot time per
the VM configuration determined at build time. For debugging and performance
tuning, the CAT can also be enabled and configured at runtime by writing proper
values to certain MSRs using the ``wrmsr`` command on ACRN shell.
Enable QoS Based on runC Container
==================================
ACRN supports Device-Model QoS based on runC container to control
the SOS resources (CPU, Storage, MEM, NET) by modifying the runC configuration file,
configuration guide will be published in next release.
S5 Support for RTVM
===================
ACRN supports a Real-time VM (RTVM) shutting itself down. A RTVM is a kind
of VM that the SOS can't interfere with at runtime, and as such, only the
RTVM can power itself off internally. All power-off requests external to the
RTVM will be rejected to avoid any interference.
OVMF Support Initial Patches Merged in ACRN
===========================================
To support booting Windows as a Guest OS, we are using
Open source Virtual Machine Firmware (OVMF). Initial
patches to support OVMF have been merged in ACRN hypervisor. More patches for
ACRN and patches upstreaming to OVMF work will be continuing.
Support ACPI Power Key Mediator
===============================
ACRN supports ACPI power/sleep key on the APL and KBL NUC platforms, triggering
S3/S5 flow, following the ACPI spec.
VT-x, VT-d
==========
Based on Intel VT-x virtualization technology, ACRN emulates a virtual CPU
with core partitioning. VT-d provides hardware support
for isolating and restricting device accesses to only the owner of the
partition managing the device. It allows assigning I/O devices to a VM,
and extending the protection and isolation properties of VMs for
I/O operations.
PIC/IOAPIC/MSI/MSI-X/PCI/LAPIC
==============================
ACRN hypervisor supports virtualized APIC-V, EPT, IOAPIC, and LAPIC functionality.
Ethernet
========
ACRN hypervisor supports virtualized Ethernet functionality. The Ethernet
Mediator is executed in the Service OS and provides packet forwarding between
the physical networking devices (Ethernet, Wi-Fi, etc.) and virtual devices in
the Guest VMs (also called "User OS"). The HW platform physical connection can be shared
with Linux, Android by Service OS guests for regular (i.e. non-AVB) traffic.
Mass Storage
============
ACRN hypervisor supports virtualized non-volatile R/W storage for the Service
OS and Guest OS instances, supporting VM private storage and/or storage shared
between Guest OS instances.
USB (xDCI)
==========
ACRN hypervisor supports pass-through of xDCI
controllers to a Guest OS from the platform.
USB Mediator (xHCI)
===================
ACRN hypervisor supports an emulated USB xHCI controller for Guest OS.
(See :ref:`usb_virtualization` for more information.)
Wi-Fi
=====
ACRN hypervisor supports doing a pass-through of the Wi-Fi chip to
a Guest VM (UOS), enables control of the Wi-Fi as an in-vehicle hotspot for third-party
devices, provides third-party device applications access to the vehicle, and
provides access of third-party devices to the TCU (if applicable) provided connectivity.
IPU (MIPI CSI-2, HDMI-In)
=========================
ACRN hypervisor provide an IPU mediator to share with Guest OS. Alternatively, IPU
can also be configured as pass-through to Guest OS without sharing.
Bluetooth
=========
ACRN hypervisor supports Bluetooth controller passthrough to a single Guest
OS (for example, for In-Vehicle Infotainment or IVI use cases).
GVT-g for ACRN
==============
GVT-g for ACRN (a.k.a AcrnGT) is a feature to enable GPU sharing Service OS
and User OS, so both can run GPU workload simultaneously. Direct display is
supported by AcrnGT, where the Service OS and User OS are each assigned to
a different display. The display ports support eDP and HDMI.
See the HLD GVT-g documentation for more information.
GPU - Preemption
================
GPU Preemption is one typical automotive use case which requires the system
to preempt GPU resources occupied by lower priority workloads. This is done
to ensure performance of the most critical workload can be achieved. Three
different schedulers for the GPU are involved: i915 UOS scheduler, Mediator
GVT scheduler, and i915 SOS scheduler.
GPU - Display Surface Sharing via Hyper DMA
===========================================
Surface sharing is one typical automotive use case which requires that the
SOS accesses an individual surface or a set of surfaces from the UOS without
having to access the entire frame buffer of the UOS. It leverages hyper_DMABUF,
a Linux kernel driver running on multiple VMs and expands DMA-BUFFER sharing
capability to inter-VM.
Virtio Standard Is Supported
============================
Virtio framework is widely used in ACRN, allowing devices beyond network and
storage to be shared to UOS in a standard way. Many mediators in ACRN follow
the virtio spec. Virtio-based virtualization is called para-virtualization.
Virtio is a virtualization standard for network and disk device drivers where
the guest's device driver "knows" it is running in a virtual environment, and
cooperates with the hypervisor. The SOS and UOS can share physical LAN network
and physical eMMC storage device. (See :ref:`virtio-hld` for more information.)
Device Pass-Through Support
===========================
Device pass-through to UOS supported with help of VT-d.
GPIO Virtualization
===================
GPIO virtualization is supported as para-virtualization based on the Virtual
I/O Device (VIRTIO) specification. The GPIO consumers of the Front-end are able
to set or get GPIO values, directions, and configuration via one virtual GPIO
controller. In the Back-end, the GPIO command line in the launch script can be
modified to map native GPIO to UOS. (See :ref:`virtio-hld` for more information.)
New ACRN Tools
==============
We've added a collection of support tools including ``acrnctl``, ``acrntrace``, ``acrnlog``,
``acrn-crashlog``, ``acrnprobe``. (See the `Tools` section under **User Guides** for details.)
Document Updates
================
We have many reference documents `available
<https://projectacrn.github.io>`_, including:
* :ref:`Enable GVT-d in ACRN <gpu-passthrough>`
* :ref:`Device Model Parameters <acrn-dm_parameters>`
* Running Automotive Grade Linux as a VM
* Using PREEMPT_RT-Linux for real-time UOS
* :ref:`Frequently Asked Questions <faq>`
* :ref:`An introduction to Trusty and Security services on ACRN <trusty-security-services>`
* A Wiki article about `Porting Clear Linux/ACRN to support Yocto Project/ACRN
<https://github.com/projectacrn/acrn-hypervisor/wiki/Yocto-based-Service-OS-(SOS)-and-User-OS-(UOS)-on-ACRN>`_
* An `ACRN brochure update (English and Chinese)
<https://projectacrn.org/#code-docs>`_
* ACRN Roadmap: look ahead in `2019
<https://projectacrn.org/wp-content/uploads/sites/59/2019/02/ACRN-Rodamap-2019.pdf>`_
* Performance analysis of `VBS-k framework
<https://projectacrn.github.io/1.0/developer-guides/VBSK-analysis.html>`_
* HLD design doc for `IOC virtualization
<https://projectacrn.github.io/1.0/developer-guides/hld/hld-APL_GVT-g.html?highlight=hld>`_
* Additional project `coding guidelines
<coding_guidelines.html>`_
* :ref:`Zephyr RTOS as Guest OS <using_zephyr_as_uos>`
* :ref:`Enable cache QoS with CAT <rdt_configuration>`
* :ref:`ACRN kernel parameter introduction <kernel-parameters>`
* :ref:`FAQ update for two issues <faq>`
* :ref:`ACRN Debug introduction <acrn-debug>`
* :ref:`Converged Security Engine (CSE) <hld-security>`
New Features Details
********************
- :acrn-issue:`866` - Security Interrupt Storm Mitigation
- :acrn-issue:`887` - Security xD support
- :acrn-issue:`888` - Security: Service OS Support for Platform Security Discovery
- :acrn-issue:`892` - Power Management: VMM control
- :acrn-issue:`894` - Power Management: S5
- :acrn-issue:`914` - GPU Passthrough
- :acrn-issue:`940` - Device: IPU support
- :acrn-issue:`951` - Device CS(M)E support
- :acrn-issue:`1122` - Security Enable compiler and linker setting-flags to harden software
- :acrn-issue:`1179` - RPMB key passing
- :acrn-issue:`1180` - vFastboot release version 0.9
- :acrn-issue:`1181` - Integrate enabling Crash OS feature as default in VSBL debug Version
- :acrn-issue:`1182` - vSBL to support ACPI customization
- :acrn-issue:`1240` - [APL][IO Mediator] Enable VHOST_NET & VHOST to accelerate guest networking with virtio_net.
- :acrn-issue:`1284` - [DeviceModel]Enable NHLT table in DM for audio passthrough
- :acrn-issue:`1329` - ioeventfd and irqfd implementation to support vhost on ACRN
- :acrn-issue:`1343` - Enable -Werror for ACRN hypervisor
- :acrn-issue:`1409` - Add support for profiling [sep/socwatch tools]
- :acrn-issue:`1455` - x2apic support for acrn
- :acrn-issue:`1498` - add watchdog MSI and INTR support in DM
- :acrn-issue:`1536` - dm: add virtio_mei mediator
- :acrn-issue:`1544` - dm: rpmb: Support RPMB mode config from launch.sh
- :acrn-issue:`1568` - Implement PCI emulation functionality in HV for UOS passthrough devices and SOS MSI/MSI-X remapping
- :acrn-issue:`1626` - support x2APIC mode for ACRN guests
- :acrn-issue:`1672` - L1TF mitigation
- :acrn-issue:`1701` - MISRA C compliance Naming Convention
- :acrn-issue:`1711` - msix.c use MMIO read/write APIs to access MMIO registers
- :acrn-issue:`1812` - export kdf_sha256 interface from crypto lib
- :acrn-issue:`1815` - improve emulation of I/O port CF9
- :acrn-issue:`1824` - implement "wbinvd" emulation
- :acrn-issue:`1832` - Add OVMF booting support for booting as an alternative to vSBL.
- :acrn-issue:`1882` - Extend the SOS CMA range from 64M to 128M
- :acrn-issue:`1915` - Enable Audio Mediator
- :acrn-issue:`1953` - Add cmdline option to disable/enable vhm module for guest
- :acrn-issue:`1995` - Support SBL firmware as boot loader on Apollo Lake UP2.
- :acrn-issue:`2011` - support DISCARD command for virtio-blk
- :acrn-issue:`2020` - DM: Enable QoS in ACRN, based on runC container
- :acrn-issue:`2056` - Enable SMAP in hypervisor
- :acrn-issue:`2170` - For UEFI based hardware platforms, one Clear Linux OS E2E build binary can be used for all platform's installation
- :acrn-issue:`2176` - Fix RTC issues in ACPI
- :acrn-issue:`2319` - Add vHPET support
- :acrn-issue:`2351` - Enable post-launched hybrid mode
- :acrn-issue:`2426` - Enable Interrupt Remapping feature
- :acrn-issue:`2431` - VPCI code cleanup
- :acrn-issue:`2448` - Adding support for socket as a backend for Virtio-Console
- :acrn-issue:`2462` - Enable cache QOS with CAT
- :acrn-issue:`2512` - GPIO virtualization
- :acrn-issue:`2708` - one binary for SBL and UEFI
- :acrn-issue:`2713` - Enable ACRN to boot Zephyr
- :acrn-issue:`2792` - Pass ACRN E820 map to OVMF
- :acrn-issue:`2865` - support S5 of Normal VM with lapic_pt
Fixed Issues Details
********************
- :acrn-issue:`424` - Clear Linux OS desktop GUI of SOS fails to launch
- :acrn-issue:`663` - Black screen displayed after booting SOS/UOS
- :acrn-issue:`676` - Hypervisor and DM version numbers incorrect
- :acrn-issue:`677` - SSD Disk ID is not consistent between SOS/UOS
- :acrn-issue:`706` - Invisible mouse cursor in UOS
- :acrn-issue:`707` - Issues found with instructions for using Ubuntu as SOS
- :acrn-issue:`721` - DM for IPU mediation
- :acrn-issue:`843` - ACRN boot failure
- :acrn-issue:`971` - acrncrashlog functions need to be enhance
- :acrn-issue:`1003` - CPU: cpu info is not correct
- :acrn-issue:`1071` - hypervisor cannot boot on skylake i5-6500
- :acrn-issue:`1101` - missing acrn_mngr.h
- :acrn-issue:`1125` - VPCI coding style and bugs fixes found in integration testing for partition mode
- :acrn-issue:`1126` - VPCI coding style and bugs fixes for partition mode
- :acrn-issue:`1209` - specific PCI device failed to passthrough to UOS
- :acrn-issue:`1268` - GPU hangs when running GfxBench Car Chase in SOS and UOS.
- :acrn-issue:`1270` - SOS and UOS play video but don't display video animation output on monitor.
- :acrn-issue:`1319` - SD card pass-through: UOS can't see SD card after UOS reboot.
- :acrn-issue:`1339` - SOS failed to boot with SSD+NVMe boot devices on KBL NUC
- :acrn-issue:`1432` - SOS failed boot
- :acrn-issue:`1774` - UOS cannot stop by command: acrnctl stop [vm name] in SOS
- :acrn-issue:`1775` - [APL UP2]ACRN debugging tool` - acrntrace cannot be used in SOS
- :acrn-issue:`1776` - [APL UP2]ACRN debugging tool` - acrnlog cannot be used in SOS
- :acrn-issue:`1777` - After UOS plays video for several minutes, the UOS image will be stagnant
- :acrn-issue:`1778` - MSDK: 1080p H264 video decode fails in UOS
- :acrn-issue:`1779` - gfxbench cannot run in SOS&UOS
- :acrn-issue:`1780` - Some video formats cannot be played in SOS.
- :acrn-issue:`1781` - Can not recognize the SD card in the SOS
- :acrn-issue:`1782` - UOS failed to get ip with the pass-throughed network card
- :acrn-issue:`1792` - System hang and reboot after run "LaaG Forced GPU Reset: subtest error-state-capture-vebox" in UOS
- :acrn-issue:`1794` - After SOS boots up, there's no output on SOS screen
- :acrn-issue:`1795` - SOS fails to get IP address
- :acrn-issue:`1796` - APL NUC fails to reboot sometimes
- :acrn-issue:`1825` - Need to clear memory region used by UOS before it exit
- :acrn-issue:`1837` - 'acrnctl list' shows incomplete VM names
- :acrn-issue:`1986` - UOS will hang once watchdog reset triggered
- :acrn-issue:`1987` - UOS will have same MAC address after launching UOS with virio-net
- :acrn-issue:`1996` - [APLNUC/KBLNUC/APLUP2]There is an error log when using "acrnd&" to boot UOS
- :acrn-issue:`1999` - [APLNUC][KBLNUC][APLUP2]UOS reset fails with acrnctl reset command
- :acrn-issue:`2000` - After launching UOS with Audio pass-through, Device (I2C0) doesn't exist in UOS DSDT.dsl
- :acrn-issue:`2030` - UP2 fails to boot with uart=disabled for hypervisor
- :acrn-issue:`2031` - UP2 serial port has no output
- :acrn-issue:`2043` - Fix incorrect vm_id captured when sampling PMU data
- :acrn-issue:`2052` - tpm_emulator code reshuffle
- :acrn-issue:`2086` - enable/disable snoop control bit per vm
- :acrn-issue:`2133` - The system will hang up and print some error info after boot UOS
- :acrn-issue:`2157` - Profiling: fix the profiling tool crash by page faults
- :acrn-issue:`2168` - Modify Makefile to save debug files
- :acrn-issue:`2200` - Won't build using ubuntu 16.04 LTS and binutils 2.26.1
- :acrn-issue:`2237` - Don't export two dma_bufs for the same importer in sos kernel
- :acrn-issue:`2257` - Profiling code clean up
- :acrn-issue:`2276` - OVMF failed to launch UOS on UP2
- :acrn-issue:`2277` - [APLNUC]Launch UOS with 5G memory will hang 2 minutes
- :acrn-issue:`2298` - Hard codes path to iasl
- :acrn-issue:`2298` - Hardcodes path to iasl
- :acrn-issue:`2316` - Tools don't respect CFLAGS/LDFLAGS from environment
- :acrn-issue:`2338` - [UP2]Lost 2G memory in SOS when using SBL as bootloader on UP2
- :acrn-issue:`2341` - vm exit trace position is not correct
- :acrn-issue:`2349` - SOS failed boot up with RELOC config enabled.
- :acrn-issue:`2355` - Switch the default up-notification vector from 0xF7 to 0xF3
- :acrn-issue:`2356` - fail to start UOS on the renamed device name of VHM module
- :acrn-issue:`2370` - Doesn't use parallel make in subbuilds
- :acrn-issue:`2371` - kconfig oldconfig doesn't work correctly
- :acrn-issue:`2389` - Need to add the dependency of $(LIB_FLAGS)
- :acrn-issue:`2410` - Launch UOS will occur page fault error when use the hypervisor build on Ubuntu
- :acrn-issue:`2422` - [PATCH] profiling: fix the system freeze issue when running profiling tool
- :acrn-issue:`2427` - Remove redundant apicv code from legacy vInterrupt inject path
- :acrn-issue:`2453` - Fix vHPET memory leak on device reset
- :acrn-issue:`2455` - host call stack disappear when dumping
- :acrn-issue:`2474` - Need to capture dropped sample info while profiling
- :acrn-issue:`2490` - systemd virtualization detection doesn't work
- :acrn-issue:`2516` - [UP2][SBL] System hang with DP monitor connected
- :acrn-issue:`2522` - Start ias in SOS, no display
- :acrn-issue:`2523` - UOS monitor does not display when using ias
- :acrn-issue:`2524` - [UP2][SBL] Launching UOS hang while weston is running in SOS
- :acrn-issue:`2528` - [APLUP2] SBL (built by SBL latest code) failed to boot ACRN hypervisor
- :acrn-issue:`2543` - vLAPIC: DCR not properly initialized
- :acrn-issue:`2548` - [APLNUC/KBLNUC][GVT][SOS/LAAG] Weston fails to play video in SOS and UOS
- :acrn-issue:`2572` - Startup SOS Fails
- :acrn-issue:`2588` - Uninitialized Variable is used in acrn_kernel/drivers/acrn/acrn_trace.c and acrn_hvlog.c
- :acrn-issue:`2597` - Return PIPEDSL from HW register instead of cached memory for Guest VGPU
- :acrn-issue:`2606` - HV crash during running VMM related Hypercall fuzzing test.
- :acrn-issue:`2624` - Loading PCI devices with table_count > CONFIG_MAX_MSIX_TABLE_NUM leads to writing outside of struct.
- :acrn-issue:`2643` - Ethernet pass-through, network card can't get ip in uos
- :acrn-issue:`2674` - VGPU needs the lock when updating ppggt/ggtt to avoid the race condition
- :acrn-issue:`2695` - UOS powers off or suspend while pressing power key, UOS has no response
- :acrn-issue:`2704` - Possible memory leak issues
- :acrn-issue:`2760` - [UP2]{SBL] make APL-UP2 SBL acrn-hypervisor sos image failed.
- :acrn-issue:`2772` - Enable PCI-E realtek MMC card for UOS
- :acrn-issue:`2780` - [APL_NUC KBL_NUC EFI_UP2]Update clear Linux missing acrn.efi file
- :acrn-issue:`2792` - Pass ACRN E820 map to OVMF
- :acrn-issue:`2829` - The ACRN hypervisor shell interactive help is rather terse
- :acrn-issue:`2830` - Warning when building the hypervisor
- :acrn-issue:`2851` - [APL/KBL/UP2][HV][LaaG]Uos cannot boot when acrnctl add Long_VMName of more than 26
- :acrn-issue:`2870` - Use 'sha512sum' for validating all virtual bootloaders
Known Issues
************
:acrn-issue:`1773` - USB Mediator: Can't find all devices when multiple USB devices connected [Reproduce rate:60%]
After booting UOS with multiple USB devices plugged in, there's a 60% chance that one or more devices are not discovered.
**Impact:** Cannot use multiple USB devices at same time.
**Workaround:** Unplug and plug-in the unrecognized device after booting.
-----
:acrn-issue:`1991` - Input not accepted in UART Console for corner case
Input is useless in UART Console for a corner case, demonstrated with these steps:
1) Boot to SOS
2) ssh into the SOS.
3) use ``./launch_UOS.sh`` to boot UOS.
4) On the host, use ``minicom -s dev/ttyUSB0``.
5) Use ``sos_console 0`` to launch SOS.
**Impact:** Fails to use UART for input.
**Workaround:** Enter other keys before typing :kbd:`Enter`.
-----
:acrn-issue:`2267` - [APLUP2][LaaG] LaaG can't detect 4k monitor
After launching UOS on APL UP2 , 4k monitor cannot be detected.
**Impact:** UOS can't display on a 4k monitor.
**Workaround:** Use a monitor with less than 4k resolution.
-----
:acrn-issue:`2278` - [KBLNUC] Cx/Px is not supported on KBLNUC
C states and P states are not supported on KBL NUC.
**Impact:** Power Management state-related operations in SOS/UOS on
KBL NUC can't be used.
**Workaround:** None
-----
:acrn-issue:`2279` - [APLNUC] After exiting UOS, SOS can't use USB keyboard and mouse
After exiting UOS with mediator
Usb_KeyBoard and Mouse, SOS cannot use the USB keyboard and mouse.
These steps reproduce the issue:
1) Insert USB keyboard and mouse in standard A port (USB3.0 port)
2) Boot UOS by sharing the USB keyboard and mouse in cmd line:
``-s n,xhci,1-1:1-2:1-3:1-4:2-1:2-2:2-3:2-4 \``
3) UOS access USB keyboard and mouse.
4) Exit UOS.
5) SOS tries to access USB keyboard and mouse, and fails.
**Impact:** SOS cannot use USB keyboard and mouse in such case.
**Workaround:** Unplug and plug-in the USB keyboard and mouse after exiting UOS.
-----
:acrn-issue:`2527` - System will crash after a few minutes running stress test ``crashme`` tool in SOS/UOS.
System stress test may cause a system crash.
**Impact:** System may crash in some stress situations.
**Workaround:** None
-----
:acrn-issue:`2526` - Hypervisor crash when booting UOS with acrnlog running with mem loglevel=6
If we use ``loglevel 3 6`` to change the mem loglevel to 6, we may hit a page fault in HV.
**Impact:** Hypervisor may crash in some situation.
**Workaround:** None
-----
:acrn-issue:`2753` - UOS cannot resume after suspend by pressing power key
UOS cannot resume after suspend by pressing power key
**Impact:** UOS may failed to resume after suspend by pressing the power key.
**Workaround:** None
-----
:acrn-issue:`2974` - Launching Zephyr RTOS as a real-time UOS takes too long
Launching Zephyr RTOS as a real-time UOS takes too long
These steps reproduce the issue:
1) Build Zephyr image by follow the `guide
<https://projectacrn.github.io/1.0/tutorials/using_zephyr_as_uos.html?highlight=zephyr>`_.
2) Copy the "Zephyr.img", "OVMF.fd" and "launch_zephyr.sh" to ISD.
3) execute the launch_zephyr.sh script.
**Impact:** Launching Zephyr RTOS as a real-time UOS takes too long
**Workaround:** None
-----
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v0.8
release in Apr 2019 (click on the CommitID link to see details):
.. comment
This list is obtained from this git command (update the date to pick up
changes since the last release):
git log --pretty=format:'- :acrn-commit:`%h` - %s' --after="2018-03-01"
- :acrn-commit:`bed57dd2` - HV: vuart: enable connect mode for VM
- :acrn-commit:`235d8861` - HV: vuart: enable vuart console for VM
- :acrn-commit:`3c92d7bb` - HV: vuart: refine vuart config
- :acrn-commit:`1234f4f7` - HV: shell: rename sos_console to vm_console
- :acrn-commit:`2362e585` - HV: correct usage of GUEST_FLAG_IO_COMPLETION_POLLING
- :acrn-commit:`578592b5` - vlapic: refine IPI broadcast to support x2APIC mode
- :acrn-commit:`581c0a23` - HV: move AP_MASK to cpu.h
- :acrn-commit:`7b6fe145` - HV: Remove unnecssary indent in pm.c
- :acrn-commit:`a85d11ca` - HV: Add prefix 'p' before 'cpu' to physical cpu related functions
- :acrn-commit:`25741b62` - HV: fix the issue of ACRN_REQUEST_EXCP flag is not cleared.
- :acrn-commit:`28d50f1b` - hv: vlapic: add apic register offset check API
- :acrn-commit:`70dd2544` - hv: vmsr: refine x2apic MSR bitmap setting
- :acrn-commit:`0c347e60` - hv: vlapic: wrap APICv check pending delivery interrupt
- :acrn-commit:`037fffc2` - hv: vlapic: wrap APICv inject interrupt API
- :acrn-commit:`1db8123c` - hv: virq: refine pending event inject coding style
- :acrn-commit:`fde2c07c` - hv: vlapic: minor fix about APICv inject interrupt
- :acrn-commit:`846b5cf6` - hv: vlapic: wrap APICv accept interrupt API
- :acrn-commit:`7852719a` - ACRN: tool: Fix buffer overflow risk in acrnctl
- :acrn-commit:`763d2183` - DM: virtio-gpio: fix array overflow issue
- :acrn-commit:`f3f870b7` - dm: uart: use mevent_add only when it is a tty
- :acrn-commit:`30609565` - dm: fix possible null pointer dereference in pci_gvt_deinit
- :acrn-commit:`f991d179` - hv: fix possible buffer overflow in vlapic.c
- :acrn-commit:`2c13ac74` - hv: vmcs: minor fix about APICv feature setting
- :acrn-commit:`4fc20097` - hv: instr_emul: check the bit 0(w bit) of opcode when necessary
- :acrn-commit:`7ccb44af` - HV: Remove dead loop in stop_cpus
- :acrn-commit:`91c14081` - HV: Reset physical core of lapic_pt vm when shutdown
- :acrn-commit:`e52917f7` - HV: Reshuffle start_cpus and start_cpu
- :acrn-commit:`cfe8637c` - HV: Kconfig: Remove CPU_UP_TIMEOUT
- :acrn-commit:`565f3c72` - HV: Clear DM set guest_flags when shutdown vm
- :acrn-commit:`a3207b2b` - hv: allocate vpid based on vm_id and vcpu_id mapping
- :acrn-commit:`9673f3da` - HV: validate target vm in hypercall
- :acrn-commit:`82181f4c` - HV: remove ifndef on vpci_set_ptdev_intr_info
- :acrn-commit:`aef5a4fd` - hv: free ptdev device IRQs when shutting down VM
- :acrn-commit:`82fa9946` - dm: safely access MMIO hint in MMIO emulation
- :acrn-commit:`4c38ff00` - dm: completely remove enable_bar()/disable_bar() functions
- :acrn-commit:`a718fbe8` - dm: pci: change return type to bool
- :acrn-commit:`887d4168` - hv: check vm state before creating a VM
- :acrn-commit:`fa475540` - hv: seed: fix potential NULL pointer dereferencing
- :acrn-commit:`334c5ae7` - hv: ept: correct EPT mapping gpa check
- :acrn-commit:`aee9f3c6` - hv: reset per cpu sbuf pointers during vcpu reset
- :acrn-commit:`56acaacc` - hv: vlapic: add TPR below threshold implement
- :acrn-commit:`a4c9cb99` - hv:change register_mmio_emulation_handler to void
- :acrn-commit:`f1aa35a2` - doc: add security advisory section in ACRN introduction website
- :acrn-commit:`3e19d62b` - doc: update coding guidelines
- :acrn-commit:`bba43290` - Setting up KBL serial console on the GSG
- :acrn-commit:`0ae5ef3a` - dm: add IOCTL command to get platform information
- :acrn-commit:`5a51d0bf` - hv: Add host CR2 to exception dump
- :acrn-commit:`b1e68453` - hv: enable vMCE from guest CPUID
- :acrn-commit:`35ef11e6` - HV: enable lapic passthru for logical partition VM1
- :acrn-commit:`824caf8c` - hv: Remove need for init_fallback_iommu_domain and fallback_iommu_domain
- :acrn-commit:`948d58fb` - acrn-dm: enable debug option for acrn-dm
- :acrn-commit:`2e5a6e28` - watchdog: map the watchdog reset to warm reset
- :acrn-commit:`2f4e3207` - dm: virtio-input: adapt Windows virtio-input driver
- :acrn-commit:`81158579` - dm: pci: unregister bars which are still enabled in pci_emul_free_bars
- :acrn-commit:`fd389cb1` - dm: disable ACPI PM timer
- :acrn-commit:`98dfc6f2` - dm: virtio-block: extend the max iov number of virtio block
- :acrn-commit:`fa7f6c2c` - dm: fix deadlock between emulate_mem and un/register_mem
- :acrn-commit:`d648df76` - dm: register_bar/unregister_bar when bar enable/disable
- :acrn-commit:`b838e9b7` - dm: pm: mask the higher bits of parameter of smi_cmd handler
- :acrn-commit:`15966f94` - dm: uart: add uart over tcp support
- :acrn-commit:`48be6f1f` - HV:config:Add config to enable logic partition on KBL NUC i7
- :acrn-commit:`c4c788ca` - HV:BSP:Update firmware detection and operations selecting logic
- :acrn-commit:`a13c19b4` - HV:EFI-STUB:UEFI loader name supporting
- :acrn-commit:`048d72fd` - tools: acrn-crashlog: fix some possible memory leak
- :acrn-commit:`46480f6e` - hv: add new hypercall to fetch platform configurations
- :acrn-commit:`e216f306` - tools: acrn-mngr: add delay to allow user to prevent VM autostart for debug
- :acrn-commit:`8c2ab95f` - tools: acrnd: fix wait_for_stop() return wrong vm state
- :acrn-commit:`2b900a43` - tools: acrn-manager: fix mngr_send_msg() return 0 when read ack fail
- :acrn-commit:`6ac9e15a` - dm: fix possible memory leak in 'load_elf32()'
- :acrn-commit:`e50c0c88` - tools: acrn-manager: fix the possibility of creating directory at will by no permission process
- :acrn-commit:`16a2af57` - hv: Build mptable for guest if VM type is Pre-Launched
- :acrn-commit:`869de397` - hv: rename 'assign_iommu_device' and 'unassign_iommu_device'
- :acrn-commit:`ccecd550` - HV: show VM UUID in shell
- :acrn-commit:`445999af` - HV: make vm id statically by uuid
- :acrn-commit:`cb10dc7e` - HV: return bool in sanitize_vm_config
- :acrn-commit:`60712343` - HV: use term of UUID
- :acrn-commit:`4557033a` - hv: vlapic: minor fix about vlapic write
- :acrn-commit:`fa8fa37c` - hv: vlapic: remove vlapic_rdmsr/wrmsr
- :acrn-commit:`ad1bfd95` - hv: move pci.h to include/hw
- :acrn-commit:`69627ad7` - hv: rename io_emul.c to vmx_io.c
- :acrn-commit:`17faa897` - hv:move common/io_req.c/h to dm folder
- :acrn-commit:`2b79c6df` - hv:move some common APIs to io_req.c
- :acrn-commit:`0a1c016d` - hv: move 'emul_pio[]' from strcut vm_arch to acrn_vm
- :acrn-commit:`35c8437b` - hv:move 'fire_vhm_interrupt' to io_emul.c
- :acrn-commit:`e7605fad` - doc: fix misspellings
- :acrn-commit:`c42f5c5c` - Add description of enabling serial console for KBL NUC.
- :acrn-commit:`8ee00c1e` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`1312fc6f` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`64f74b76` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`c3b9b4c1` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`f964ee92` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`595744a3` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`07baa83c` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`bf51fb03` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`b1adc035` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`65ed6c61` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`875fc6e8` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`a6df7440` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`7ff61fb8` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`76b34ee7` - Update doc/getting-started/gsg_quick_setup.sh
- :acrn-commit:`a7f7b854` - Add gsg quick setup script.
- :acrn-commit:`122685b7` - DM USB: xHCI: refine the failure process logic of control transfer
- :acrn-commit:`69152647` - hv: Use virtual APIC IDs for Pre-launched VMs
- :acrn-commit:`8796ded2` - DM USB: fix SWWDT_UNHANDLED issue
- :acrn-commit:`8bd7b9be` - DM USB: xHCI: fix an logic error during USB reset
- :acrn-commit:`b570755f` - Domain id and name added to launch_uos.sh
- :acrn-commit:`6eaadc34` - dm: passthru: support SD hotplug
- :acrn-commit:`784bfa28` - DM USB: xHCI: fix an issue during BULK transfer
- :acrn-commit:`e30cd452` - doc: tweak home page redirect to latest
- :acrn-commit:`63743d8b` - DM USB: xHCI: WA for an isochronous crash issue
- :acrn-commit:`f0e7ce6a` - version: 1.0-unstable

518
doc/release_notes/release_notes_1.1.rst
View File

@ -1,518 +0,0 @@
.. _release_notes_1.1:
ACRN v1.1 (Jun 2019)
####################
We are pleased to announce the release of ACRN version 1.1.
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline embedded
development through an open source platform. Check out the :ref:`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 either download this source code as
a zip or tar.gz file (see the `ACRN v1.1 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v1.1>`_)
or use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v1.1
The project's online technical documentation is also tagged to correspond
with a specific release: generated v1.1 documents can be found at https://projectacrn.github.io/1.1/.
Documentation for the latest (master) branch is found at https://projectacrn.github.io/latest/.
ACRN v1.1 requires Clear Linux* OS version 29970.
Version 1.1 Major Features
**************************
Hybrid Mode Introduced
======================
In hybrid mode, a Zephyr OS is launched by the hypervisor even before the Service OS is
launched (pre-launched), with dedicated resources to achieve highest level of isolation.
This is designed to meet the needs of a FuSa certifiable safety OS.
Support for New Guest Operating Systems
=======================================
* The `Zephyr RTOS <https://zephyrproject.org>`_ can be a pre-launched Safety OS in hybrid mode.
It can also be a post-launched (launched by Service OS, not the hypervisor) as a guest OS.
* VxWorks as a post-launched RTOS for industrial usages.
* Windows as a post-launched OS
Document Updates
================
We have many `reference documents available <https://projectacrn.github.io>`_, including:
* Update: Using PREEMPT_RT-Linux for real-time UOS
* :ref:`Zephyr RTOS as Guest OS <using_zephyr_as_uos>`
* :ref:`Using VxWorks* as User OS <using_vxworks_as_uos>`
* How to enable OVS in ACRN
* Enable QoS based on runC container
* :ref:`Using partition mode on NUC <using_partition_mode_on_nuc>`
New Features Details
********************
- :acrn-issue:`2538` - Add new hypercall to fetch platform configurations.
- :acrn-issue:`2587` - ACRN HV: allow pre-launched VMs have different memory size and use > 2GB memory
- :acrn-issue:`2621` - refine code in vlapic_trigger_lvt.
- :acrn-issue:`2635` - OVS/vlan 802.1Q support for ACRN ISD
- :acrn-issue:`2902` - Completely remove enable_bar()/disable_bar() functions
- :acrn-issue:`2962` - Enabling WaaG on ACRN
- :acrn-issue:`3069` - Virtualization will support VxWorks7 64-bit as a GuestVM
- :acrn-issue:`3099` - WaaG: Add WaaG support in launch_uos.sh
- :acrn-issue:`3116` - Get max vcpu per vm from HV instead of hardcode
- :acrn-issue:`3158` - Power Management: Guest control
- :acrn-issue:`3179` - Hypervisor CPU SGX
- :acrn-issue:`3214` - Hypervisor Hybrid Mode
- :acrn-issue:`3222` - Virtual boot loader: Required Optimization and Configuration
- :acrn-issue:`3237` - Enable polling mode for virtio devices
- :acrn-issue:`3257` - Audio devices can be passed through to WaaG
Fixed Issues Details
********************
- :acrn-issue:`1262` - acrnctl tool should not only gives RC 0
- :acrn-issue:`1551` - Samples: Kernel bootchart generation using cmdline.
- :acrn-issue:`1844` - Establish a `@return` keyword for functions not returning any value (`void function()`)
- :acrn-issue:`1917` - Documentation: What does ',b' flag do with virtio-blk?
- :acrn-issue:`2378` - Getting started guide for NUC is not working
- :acrn-issue:`2457` - Compilation on Fedora 29 (for UEFI platforms) is broken
- :acrn-issue:`2515` - Display corruption in SOS on KBL
- :acrn-issue:`2518` - Service OS kernel parameters for i915 need a clean-up (EFI platforms)
- :acrn-issue:`2526` - Hypervisor crash when booting UOS with acrnlog running with mem loglevel=6
- :acrn-issue:`2527` - [KBLNUC][HV]System will crash when run crashme (SOS/UOS)
- :acrn-issue:`2584` - acrn-dm segfaults if virtio-gvt enabled but not enabled in kernel
- :acrn-issue:`2737` - Build ACRN failed in Ubuntu 16.04
- :acrn-issue:`2782` - Wifi Firmware initialization failed happened on Reboot
- :acrn-issue:`2794` - Difficult to use make oldconfig
- :acrn-issue:`2806` - hv: minor issue in sbl_init_vm_boot_info()
- :acrn-issue:`2834` - isolate the MSR IA32_MISC_ENABLE between guest and host.
- :acrn-issue:`2848` - Cannot boot SOS kernel outside of ACRN
- :acrn-issue:`2857` - FAQs for ACRN's memory usage need to be updated
- :acrn-issue:`2971` - PCIE ECFG support for AcrnGT
- :acrn-issue:`2976` - [GVT]don't register memory for gvt in acrn-dm
- :acrn-issue:`2984` - HV will crash if launch two UOS with same UUID
- :acrn-issue:`2991` - Failed to boot normal vm on the pcpu which ever run lapic_pt vm
- :acrn-issue:`3009` - When running new workload on weston, the last workload animation not disappeared and screen flashed badly.
- :acrn-issue:`3028` - virtio gpio line fd not release
- :acrn-issue:`3032` - Dump stack of mem allocation in irq_disabled after using mempool for ACRN VHM
- :acrn-issue:`3050` - FYI: Kconfiglib major version bumped to 11
- :acrn-issue:`3051` - Storage: Support rescan feature for virtio-blk
- :acrn-issue:`3053` - Emulated USB controller Vendor ID and Device ID are swapped
- :acrn-issue:`3054` - USB webcam not working in UOS
- :acrn-issue:`3073` - HV: hotfix for acpi.c compile error
- :acrn-issue:`3081` - add -w option for uos launch sh
- :acrn-issue:`3085` - Can't set tsc frequency through option -f/--frequency of acrnalyze.py
- :acrn-issue:`3096` - Add one workaround to fix build issue with latest gcc.
- :acrn-issue:`3118` - virtio gpio static variable keeps increasing
- :acrn-issue:`3123` - Remove unused functions in hypervisor and device model.
- :acrn-issue:`3127` - refine the passthrough devices with dictionary
- :acrn-issue:`3128` - Undefined CONFIG_REMAIN_1G_PAGES
- :acrn-issue:`3136` - distinguish between LAPIC_PASSTHROUGH configured vs enabled
- :acrn-issue:`3138` - Increase kernel boot args and VM Name length
- :acrn-issue:`3142` - fix cpu family calculation
- :acrn-issue:`3145` - Only certain guests should be granted the privilege to reset host
- :acrn-issue:`3152` - Use virtio-blk instead passthru devices to boot RT
- :acrn-issue:`3160` - There is a logic bug when set iommu page walk coherent
- :acrn-issue:`3181` - [auto][sit][daily]Case "Hypervisor_Launch_RTVM_on_SATA_Storage" sata disk can not passthru
- :acrn-issue:`3182` - run command "echo c > /proc/sysrq-trigger" can't trigger AaaG warm reboot
- :acrn-issue:`3184` - fail to locate ACPI RSDP table on some EFI platforms
- :acrn-issue:`3188` - dm: update uos patch in launch_hard_rt_vm.sh
Known Issues
************
:acrn-issue:`1773` - USB Mediator: Can't find all devices when multiple USB devices connected
After booting UOS with multiple USB devices plugged in,
there's a 60% chance that one or more devices are not discovered.
**Impact:** Cannot use multiple USB devices at same time.
**Workaround:** Unplug and plug-in the unrecognized device after booting.
-----
:acrn-issue:`1991` - Input not accepted in UART Console for corner case
Input is useless in UART Console for a corner case, demonstrated with these steps:
1) Boot to SOS
2) ssh into the SOS.
3) use ``./launch_uos.sh`` to boot UOS.
4) On the host, use ``minicom -D /dev/ttyUSB0``.
5) Use ``sos_console 0`` to launch SOS.
**Impact:** Fails to use UART for input.
**Workaround:** Enter other keys before typing :kbd:`Enter`.
-----
:acrn-issue:`2267` - [APLUP2][LaaG] LaaG can't detect 4k monitor
After launching UOS on APL UP2 , 4k monitor cannot be detected.
**Impact:** UOS can't display on a 4k monitor.
**Workaround:** Use a monitor with less than 4k resolution.
-----
:acrn-issue:`2279` - [APLNUC] After exiting UOS, SOS can't use USB keyboard and mouse
After exiting UOS with mediator Usb_KeyBoard and Mouse, SOS cannot use the USB keyboard and mouse.
These steps reproduce the issue:
1) Insert USB keyboard and mouse in standard A port (USB3.0 port)
2) Boot UOS by sharing the USB keyboard and mouse in cmd line:
``-s n,xhci,1-1:1-2:1-3:1-4:2-1:2-2:2-3:2-4 \``
3) UOS access USB keyboard and mouse.
4) Exit UOS.
5) SOS tries to access USB keyboard and mouse, and fails.
**Impact:** SOS cannot use USB keyboard and mouse in such case.
**Workaround:** Unplug and plug-in the USB keyboard and mouse after exiting UOS.
-----
:acrn-issue:`2753` - UOS cannot resume after suspend by pressing power key
UOS cannot resume after suspend by pressing power key
**Impact:** UOS may failed to resume after suspend by pressing the power key.
**Workaround:** None
-----
:acrn-issue:`2974` - Launching Zephyr RTOS as a real-time UOS takes too long
Launching Zephyr RTOS as a real-time UOS takes too long
These steps reproduce the issue:
1) Build Zephyr image by follow the `guide
<https://projectacrn.github.io/latest/tutorials/using_zephyr_as_uos.html?highlight=zephyr>`_.
2) Copy the "Zephyr.img", "OVMF.fd" and "launch_zephyr.sh" to NUC.
3) Execute the launch_zephyr.sh script.
This is not reproducible with the stock ``launch_zephyr.sh`` script in our repo,
it only happens when trying to launch an RTVM.
**Impact:** Launching Zephyr RTOS as a real-time UOS takes too long
**Workaround:** A different version of Grub is known to work correctly
-----
:acrn-issue:`3268` - dm: add virtio-rnd device to command line
LaaG's network is unreachable with UOS kernel
These steps reproduce the issue:
1) Download Clear Linux OS
2) Decompress Clear Linux
3) Replace above ``kvm.img`` with default kernel in UOS
4) Launch UOS
5) Try to ping UOS from another host.
6) UOS network is unreachable.
**Impact:** LaaG's network is unreachable with UOS kernel
**Workaround:** Add ``-s 7,virtio-rnd \`` to the launch_uos.sh script
-----
:acrn-issue:`3280` - AcrnGT holding forcewake lock causes high CPU usage in gvt workload thread.
The i915 forcewake mechanism is to keep the GPU from its low power state, in
order to access some specific registers. However, in the path of GVT-g scheduler submission,
there's no need to acquire the i915 forcewake.
**Impact:** AcrnGT holding forcewake lock cause high cpu usage gvt workload thread
**Workaround:** None
-----
:acrn-issue:`3279` - AcrnGT causes display flicker in some situations.
In current scaler ownership assignment logic, there's an issue that when SOS disables a plane,
it will disable corresponding plane scalers; however, there's no scaler ownership checking there.
So the scalers owned by UOS may be disabled by SOS by accident.
**Impact:** AcrnGT causes display flicker in some situations
**Workaround:** None
-----
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v1.0
release in May 2019 (click on the CommitID link to see details):
.. comment
This list is obtained from this git command (update the date to pick up
changes since the last release):
git log --pretty=format:'- :acrn-commit:`%h` - %s' --after="2019-05-09"
- :acrn-commit:`c1e23f1a` - hv:Fix MISRA-C violations for static inline
- :acrn-commit:`93b4cf57` - dm: clean up assert in virtio.c
- :acrn-commit:`c265bd55` - dm: clean up assert in virtio_audio.c
- :acrn-commit:`14a93f74` - dm: clean up assert in virtio_input.c
- :acrn-commit:`0a6baaf4` - dm: samples: use stdio as vxworks console by default
- :acrn-commit:`e3ee9cf2` - HV: fix expression is not boolean
- :acrn-commit:`5cbda22d` - dm: virtio_gpio: clean up assert
- :acrn-commit:`1e23c4dc` - dm: ioc: clean up assert
- :acrn-commit:`8740232a` - HV: Allow pause RTVM when its state is VM_CREATED
- :acrn-commit:`db7e7f1c` - dm: platform: clean up assert() for some platform devices
- :acrn-commit:`1b799538` - dm: pcidev: clean up assert() for some pci devices
- :acrn-commit:`2b3dedfb` - dm: pci: clean up assert() in pci core
- :acrn-commit:`f8934df3` - HV: implement wbinvd instruction emulation
- :acrn-commit:`ea699af8` - HV: Add has_rt_vm API
- :acrn-commit:`7018a13c` - HV: Add ept_flush_leaf_page API
- :acrn-commit:`f320130d` - HV: Add walk_ept_table and get_ept_entry APIs
- :acrn-commit:`f81585eb` - HV: Add flush_address_space API.
- :acrn-commit:`6fd397e8` - HV: Add CLFLUSHOPT instruction.
- :acrn-commit:`d0e08712` - dm: virtio-block: clean up assert
- :acrn-commit:`3ef385d6` - dm: ahci: clean up assert
- :acrn-commit:`4145b8af` - dm: block: clean up assert
- :acrn-commit:`13228d91` - dm: refine 'assert' usage in irq.c and wdt_i6300esb.c
- :acrn-commit:`e6eef9b6` - dm: refine 'assert' usage in pm.c and acpi.c
- :acrn-commit:`885d503a` - dm: refine 'assert' in hugetlb.c and mem.c
- :acrn-commit:`65d7d83b` - refine 'assert' usage in vmmapi.c and main.c
- :acrn-commit:`dedf9bef` - dm: refine 'assert' in inout.c and post.c
- :acrn-commit:`a2332b15` - dm: refine 'assert' usage in timer.c and rtc.c
- :acrn-commit:`ec626482` - dm: cleanup 'assert' for guest software loading module
- :acrn-commit:`0e046c7a` - hv: vlapic: clear which access type we support for APIC-Access VM Exit
- :acrn-commit:`f145cd49` - doc: Instruction of enabling ACRN-DM QoS.
- :acrn-commit:`fd9eb2a5` - HV: Fix OVMF hang issue when boot with lapic_pt
- :acrn-commit:`cdc5f120` - dm: virtio-net: clean up assert
- :acrn-commit:`b0015963` - dm: fix some potential memory leaks
- :acrn-commit:`0620980f` - dm: use strnlen to replace strlen
- :acrn-commit:`1e1244c3` - dm: use strncpy to replace strcpy
- :acrn-commit:`0ea788b4` - dm: passthru: remove the use of assert()
- :acrn-commit:`efccdd22` - dm: add virtio-rnd device to command line
- :acrn-commit:`030e7683` - doc: add systemd-networkd-autostart bundle in APL GSG
- :acrn-commit:`86d3065d` - doc: tweak doxygen precondition label
- :acrn-commit:`48877362` - ACRN: DM: Add new options for NUC launch_uos script.
- :acrn-commit:`f7f2a6ee` - hv: Rename tables member of vPCI msix struct pci_msix
- :acrn-commit:`22f24c22` - DM: Samples: Enable VxWorks as hard-rt VM
- :acrn-commit:`9960ff98` - hv: ept: unify EPT API name to verb-object style
- :acrn-commit:`4add4059` - hv:build system initialization to sys_init_mod.a
- :acrn-commit:`5abca947` - hv: build virtual platform hypercall to vp_hcall_mod.a
- :acrn-commit:`02bf362d` - hv:build virtual platform trusty to vp_trusty_mod.a
- :acrn-commit:`e67f0eab` - hv:build virtual platform DM to vp_dm_mod.a
- :acrn-commit:`4d646c02` - hv:build virtual platform base to vp_base_mod.a
- :acrn-commit:`83e2a873` - hv:build hardware layer to hw_mod.a
- :acrn-commit:`76f21e97` - hv: build boot module to boot_mod.a
- :acrn-commit:`9c81f4c3` - hv:build library to lib_mod.a
- :acrn-commit:`8338cd46` - hv: move 3 files to lib & arch folder
- :acrn-commit:`7d44cd5c` - hv: Introduce check_vm_vlapic_state API
- :acrn-commit:`f3627d48` - hv: Add update_vm_vlapic_state API to sync the VM vLAPIC state
- :acrn-commit:`a3fdc7a4` - hv: Add is_xapic_enabled API to check vLAPIC moe
- :acrn-commit:`7cb71a31` - hv: Make is_x2apic_enabled API visible across source code
- :acrn-commit:`1026f175` - hv: Shuffle logic in vlapic_set_apicbase API implementation
- :acrn-commit:`8426db93` - DM: vrpmb: replace assert() with return false
- :acrn-commit:`66943be3` - dm: enable audio passthrough device.
- :acrn-commit:`cf6d6f16` - doc: remove (outdated) primer documents
- :acrn-commit:`ed7f64d7` - DM: add deinit API for loggers
- :acrn-commit:`d05349d7` - DM: use pr_dbg in vrtc instead of printf
- :acrn-commit:`5ab098ea` - DM: add disk-logger configure in launch script
- :acrn-commit:`c04949d9` - DM: add disk-logger to write log into file system
- :acrn-commit:`6fa41eee` - DM: add static for local variables
- :acrn-commit:`5a9627ce` - DM USB: xHCI: refine the emulation of Stop Endpoint Command
- :acrn-commit:`1be719c6` - DM USB: clean-up: change name of function usb_dev_comp_req
- :acrn-commit:`7dbde276` - DM USB: xHCI: use new isoch transfer implementation
- :acrn-commit:`b57f6f92` - DM USB: clean-up: give shorter names to libusb_xfer and req
- :acrn-commit:`adaed5c0` - DM USB: xHCI: add 'chained' field in struct usb_data_xfer_block
- :acrn-commit:`f2e35ab7` - DM USB: save MaxPacketSize value in endpoint descriptor
- :acrn-commit:`296b649a` - ACRN/HV: emulated pcicfg uses the aligned offset to fix the unaligned pci_cfg access
- :acrn-commit:`2321fcdf` - HV:Modularize vpic code to remove usage of acrn_vm
- :acrn-commit:`c91a5488` - doc: improve clarity of build-from-source intro
- :acrn-commit:`32239cf5` - hv: reduce cyclomatic complexity of create_vm()
- :acrn-commit:`771f15cd` - dm: don't present ioapic and pic to RT VM
- :acrn-commit:`ac6c5dce` - HV: Clean vpic and vioapic logic when lapic is pt
- :acrn-commit:`f83ddd39` - HV: introduce relative vm id for hcall api
- :acrn-commit:`3d3de6bd` - HV: specify dispatch hypercall for sos or trusty
- :acrn-commit:`8c70871f` - doc: add an introduction for building hypervisor
- :acrn-commit:`6b723344` - xsave: inject GP when guest tries to write 1 to XCR0 reserved bit
- :acrn-commit:`d145ac65` - doc: fix typo in the "Build ACRN from Source" guide
- :acrn-commit:`8dd471b3` - hv: fix possible null pointer dereference
- :acrn-commit:`509af784` - dm: Solve the problem of repeat mount hugetblfs
- :acrn-commit:`e5a25749` - doc: add multiboot module string parameter
- :acrn-commit:`e63d32ac` - hv: delay enabling SMEP/SMAP until the end of PCPU initialization
- :acrn-commit:`9e91f14b` - hv: correctly grant DRHD register access rights to hypervisor
- :acrn-commit:`c71cf753` - ACRN/HV: Add one new board configuration for ACRN-hypervisor
- :acrn-commit:`115ba0e3` - Added recommended BIOS settings for better real-time performance.
- :acrn-commit:`7c45f3b5` - doc: remove 'reboot' command from ACRN shell user guide
- :acrn-commit:`04d82e5c` - HV: return virtual lapic id in vcpuid 0b leaf
- :acrn-commit:`0a748fed` - HV: add hybrid scenario
- :acrn-commit:`a2c6b116` - HV: change nuc7i7bnh ram start to 0x60000000
- :acrn-commit:`31aa37d3` - HV: remove unused INVALID_VM_ID
- :acrn-commit:`50e09c41` - HV: remove cpu_num from vm configurations
- :acrn-commit:`f4e976ab` - HV: return -1 with invalid vcpuid in pt icr access
- :acrn-commit:`ae7dcf44` - HV: fix wrong log when vlapic process init sipi
- :acrn-commit:`765669ee` - dm: support VMs communication with virtio-console
- :acrn-commit:`c0bffc2f` - dm: virtio: refine console options parse code
- :acrn-commit:`ce6e663f` - OVMF release v1.1
- :acrn-commit:`0baf537a` - HV: misra fix for patch set of Zephyr enabling
- :acrn-commit:`1906def2` - HV: enable load zephyr kernel
- :acrn-commit:`6940cabd` - HV: modify ve820 to enable low mem at 0x100000
- :acrn-commit:`ea7ca859` - HV: use tag to specify multiboot module
- :acrn-commit:`d0fa83b2` - HV: move sos bootargs to vm configurations
- :acrn-commit:`8256ba20` - HV: add board specific config header
- :acrn-commit:`bb55489e` - HV: make vm kernel type configurable
- :acrn-commit:`ae8893cb` - HV: use api to get kernel load addr
- :acrn-commit:`1c006113` - HV: separate linux loader from direct boot sw loader
- :acrn-commit:`0f00a4b0` - HV: refine sw_linux struct
- :acrn-commit:`475b05da` - doc: fix formatting in partition doc
- :acrn-commit:`76346fd2` - doc: setup logical partition scenario on nuc
- :acrn-commit:`6f61aa7d` - doc: add instruction of Open vSwitch
- :acrn-commit:`a6bba6bc` - doc: update prefix format in coding guidelines
- :acrn-commit:`a4e28213` - DM: handle SIGPIPE signal
- :acrn-commit:`19366458` - DM: handle virtio-console writes when no socket backend is connected
- :acrn-commit:`376fcddf` - HV: vuart: add vuart_deinit during vm shutdown
- :acrn-commit:`81cbc636` - HV: vuart: Bugfix for no interrupts on THRE
- :acrn-commit:`857e6c04` - dm: passthrough: allow not page-aligned sized bar to be mapped
- :acrn-commit:`b98096ea` - dm: pci: fix the MMIO regions overlap when getting bar size
- :acrn-commit:`011134d5` - doc: Update Using PREEMPT_RT-Linux for real-time UOS
- :acrn-commit:`5533263e` - tools:acrn-crashlog: fix error logs writing to server
- :acrn-commit:`286dd180` - dm: virtio: bugfix for polling mode
- :acrn-commit:`4c09051c` - hv: Remove unused variable in ptirq_msi_info
- :acrn-commit:`34f12219` - hv: use 64bit FACS table address only beyond ACPI2.0
- :acrn-commit:`811d1fe9` - dm: pci: update MMIO EPT mapping when update BAR address
- :acrn-commit:`cee2f8b2` - ACRN/HV: Refine the function of init_vboot to initialize the depriv_boot env correctly
- :acrn-commit:`1c36508e` - ACRN/HV: Assign the parsed RSDP to acpi_rsdp to avoid multiple RSDP parsing
- :acrn-commit:`c5d43657` - hv: vmcs: don't trap when setting reserved bit in cr0/cr4
- :acrn-commit:`f2c53a98` - hv: vmcs: trap CR4.SMAP/SMEP/PKE setting
- :acrn-commit:`a7389686` - hv: Precondition checks for vcpu_from_vid for lapic passthrough ICR access
- :acrn-commit:`7f648d75` - Doc: Cleanup vmcfg in user guides
- :acrn-commit:`9aa06c6e` - Doc: Cleanup vmcfg in HLD
- :acrn-commit:`50f50872` - DM: Cleanup vmcfg
- :acrn-commit:`7315515c` - DM: Cleanup vmcfg APIs usage for removing the entire vmcfg
- :acrn-commit:`a3073175` - dm: e820: reserve memory range for EPC resource
- :acrn-commit:`7a915dc3` - hv: vmsr: present sgx related msr to guest
- :acrn-commit:`1724996b` - hv: vcpuid: present sgx capabilities to guest
- :acrn-commit:`65d43728` - hv: vm: build ept for sgx epc resource
- :acrn-commit:`c078f90d` - hv: vm_config: add epc info in vm config
- :acrn-commit:`245a7320` - hv: sgx: add basic support to init sgx resource for vm
- :acrn-commit:`c5cfd7c2` - vm state: reset vm state to VM_CREATED when reset_vm is called
- :acrn-commit:`610ad0ce` - dm: update uos path in launch_hard_rt_vm.sh
- :acrn-commit:`b27360fd` - doc: update function naming convention
- :acrn-commit:`b833e2f9` - hv: vtd: fix a logic error when set iommu page walk coherent
- :acrn-commit:`517707de` - DM/HV: Increase VM name len
- :acrn-commit:`f010f99d` - DM: Decouple and increase kernel boot args length
- :acrn-commit:`f2fe3547` - HV: remove mptable in vm_config
- :acrn-commit:`26c7e372` - Doc: Add tutorial about using VxWorks as uos
- :acrn-commit:`b10ad4b3` - DM USB: xHCI: refine the logic of CCS bit of PORTSC register
- :acrn-commit:`ae066689` - DM USB: xHCI: re-implement the emulation of extended capabilities
- :acrn-commit:`5f9cd253` - Revert "DM: Get max vcpu per vm from HV instead of hardcode"
- :acrn-commit:`8bca0b1a` - DM: remove unused function mptable_add_oemtbl
- :acrn-commit:`bd3f34e9` - DM: remove unused function vm_get_device_fd
- :acrn-commit:`9224277b` - DM: remove unused function vm_setup_ptdev_msi
- :acrn-commit:`bb8584dd` - DM: remove unused function vm_apicid2vcpu
- :acrn-commit:`ec924385` - DM: remove unused function vm_create_devmem
- :acrn-commit:`75ef7e84` - DM: remove unused function vm_set_lowmem_limit
- :acrn-commit:`683e2416` - DM: remove unused function console_ptr_event
- :acrn-commit:`12f55d13` - DM: remove unused function console_key_event
- :acrn-commit:`aacc6e59` - DM: remove unused function console_refresh
- :acrn-commit:`2711e553` - DM: remove unused function console_fb_register
- :acrn-commit:`d19d0e26` - DM: remove unused function gc_init
- :acrn-commit:`43c01f8e` - DM: remove unused function console_init
- :acrn-commit:`e6360b9b` - DM: remove unused function gc_resize
- :acrn-commit:`d153bb86` - DM: remove unused function gc_set_fbaddr
- :acrn-commit:`475c51e5` - DM: remove unused function console_set_fbaddr
- :acrn-commit:`4e770316` - DM: remove unused function swtpm_reset_tpm_established_flag
- :acrn-commit:`2a33d52e` - DM: remove unused function vrtc_reset
- :acrn-commit:`1a726ce0` - DM: remove unused function vrtc_get_time
- :acrn-commit:`8cb64cc7` - DM: remove unused function vrtc_nvram_read
- :acrn-commit:`dcd6d8b5` - DM: remove unused function virtio_pci_modern_cfgread and virtio_pci_modern_cfgwrite
- :acrn-commit:`62f14bb1` - DM: remove unused function virtio_dev_error
- :acrn-commit:`2d6e6ca3` - DM: remove unused function usb_native_is_ss_port
- :acrn-commit:`7e80a6ee` - hv: vm: enable iommu after vpci init
- :acrn-commit:`bfc08c28` - hv: move msr_bitmap from acrn_vm to acrn_vcpu_arch
- :acrn-commit:`f96ae3f1` - HV: enforce Cx of apl nuc with SPACE_SYSTEM_IO
- :acrn-commit:`1fe57111` - HV: validate pstate by checking px ctl range
- :acrn-commit:`57275a58` - HV: add px cx data for kbl nuc refresh
- :acrn-commit:`3d459dfd` - DM: Fix minor issue of USB vendor ID
- :acrn-commit:`7e520675` - doc: update coding guidelines
- :acrn-commit:`04ccaacb` - hv:not allow SOS to access prelaunched vm memory
- :acrn-commit:`0a461a45` - tools:acrn-crashlog: fix potential memory corruption
- :acrn-commit:`5a23f7b6` - hv: initial host reset implementation
- :acrn-commit:`321e4f13` - DM: add virtual hostbridge in launch script for RTVM
- :acrn-commit:`d0fe1820` - HV: call function is_prelaunched_vm() instead to reduce code
- :acrn-commit:`a6503c6a` - HV: remove function pci_pdev_foreach()
- :acrn-commit:`536c69b9` - hv: distinguish between LAPIC_PASSTHROUGH configured vs enabled
- :acrn-commit:`cb6a3e8f` - doc: prepare for sphinx 2.0 upgrade
- :acrn-commit:`474496fc` - doc: remove hard-coded interfaces in .rst files
- :acrn-commit:`ffb92454` - doc: add note to indicate that vSBL is only supported on APL platforms
- :acrn-commit:`c561f2d6` - doc: add <vm_id> parameter to the "vm_console" command description
- :acrn-commit:`214eb5e9` - doc: Update clearlinux os installation guide link.
- :acrn-commit:`fe4fcf49` - xHV: remove unused function is_dbg_uart_enabled
- :acrn-commit:`36568ff5` - HV: remove unused function sbuf_is_empty and sbuf_get
- :acrn-commit:`c5391d25` - HV: remove unused function vcpu_inject_ac
- :acrn-commit:`26de86d7` - HV: remove unused function copy_to_gva
- :acrn-commit:`163c63d2` - HV: remove unused function resume_vm
- :acrn-commit:`c68c6e4a` - HV: remove unused function shutdown_vcpu
- :acrn-commit:`83012a5a` - HV: remove unused function disable_iommu
- :acrn-commit:`9b7dee90` - HV: remove one lock for ctx->flags operation.
- :acrn-commit:`fc1cbebe` - HV: remove vcpu arch lock, not needed.
- :acrn-commit:`9876138b` - HV: add spinlock to dmar_enable/disable_qi
- :acrn-commit:`90f3ce44` - HV: remove unused UNDEFINED_VM
- :acrn-commit:`73cff9ef` - HV: predefine pci vbar's base address for pre-launched VMs in vm_config
- :acrn-commit:`4cdaa519` - HV: rename vdev_pt_cfgwrite_bar to vdev_pt_write_vbar and some misra-c fix
- :acrn-commit:`aba357dd` - 1. fix cpu family calculation 2. Modify the parameter 'fl' order
- :acrn-commit:`238d8bba` - reshuffle init_vm_boot_info
- :acrn-commit:`0018da41` - HV: add missing @pre for some functions
- :acrn-commit:`b9578021` - HV: unify the sharing_mode_cfgwrite and partition_mode_cfgwrite code
- :acrn-commit:`7635a68f` - HV: unify the sharing_mode_cfgread and partition_mode_cfgread code
- :acrn-commit:`19af3bc8` - HV: unify the sharing_mode_vpci_deinit and partition_mode_vpci_deinit code
- :acrn-commit:`3a6c63f2` - HV: unify the sharing_mode_vpci_init and partition_mode_vpci_init code
- :acrn-commit:`f873b843` - HV: cosmetic fix for pci_pt.c
- :acrn-commit:`cf48b9c3` - HV: use is_prelaunched_vm/is_hostbridge to check if the code is only for pre-launched VMs
- :acrn-commit:`a97e6e64` - HV: rename sharing_mode_find_vdev_sos to find_vdev_for_sos
- :acrn-commit:`32d1a9da` - HV: move bar emulation initialization code to pci_pt.c
- :acrn-commit:`67b2e2b8` - HV: Remove undefined CONFIG_REMAIN_1G_PAGES
- :acrn-commit:`bb48a66b` - dm: refine the passthrough devices with dictionary
- :acrn-commit:`517cff1b` - hv:remove some unnecessary includes
- :acrn-commit:`49350634` - DM: virtio-gpio: fixed static variable keeps increasing issue
- :acrn-commit:`865ee295` - hv: emulate ACPI reset register for Service OS guest
- :acrn-commit:`26f08680` - hv: shutdown guest VM upon triple fault exceptions
- :acrn-commit:`9aa3fe64` - hv: emulate reset register 0xcf9 and 0x64
- :acrn-commit:`8ad0fd98` - hv: implement NEED_SHUTDOWN_VM request to idle thread
- :acrn-commit:`db952315` - HV: fix MISRA violation of host_pm.h
- :acrn-commit:`1aac0dff` - HV: hot fix on usage of CONFIG_ACPI_PARSE_ENABLED
- :acrn-commit:`356bf184` - DM: Get max vcpu per vm from HV instead of hardcode
- :acrn-commit:`86f5993b` - hv: vlapic: fix tpr virtualization when VID is not enabled.
- :acrn-commit:`a68dadb7` - hv: vm: minor fix about vRTC
- :acrn-commit:`8afbdb75` - HV: enable Kconfig of ACPI_PARSE_ENABLED
- :acrn-commit:`86fe2e03` - HV: split acpi.c
- :acrn-commit:`cbab1f83` - HV: remove acpi_priv.h
- :acrn-commit:`565f3cb7` - HV: move dmar parse code to acpi parser folder
- :acrn-commit:`39798691` - hv:merge static_checks.c
- :acrn-commit:`d9717967` - dm:add grep -w option for uos launch sh
- :acrn-commit:`4c28a374` - dm: add sample script to launch Windows as guest
- :acrn-commit:`bdae8efb` - hv: instr_emul: fix movzx return memory opsize wrong
- :acrn-commit:`795d6de0` - hv:move several files related X86 for lib
- :acrn-commit:`350d6a9e` - hv:Move BUS_LOCK to atomic.h
- :acrn-commit:`eff44fb0` - build fix: fix build issue with latest gcc for blkrescan
- :acrn-commit:`c7da3976` - Dockerfile: update Ubuntu 16.04 Dockerfile to include all deps
- :acrn-commit:`7b8abe15` - hv: refine 'init_percpu_lapic_id'
- :acrn-commit:`dbb41575` - hv: remove dynamic memory allocation APIs
- :acrn-commit:`773889bb` - hv: dmar_parse: remove dynamic memory allocation
- :acrn-commit:`5629ade9` - hv: add default DRHD MACROs in template platform acpi info
- :acrn-commit:`5d192288` - Doc: virtio-blk: add description of boot device option
- :acrn-commit:`d9e6cdb5` - dm: not register/unregister gvt bar memory
- :acrn-commit:`a581f506` - hv: vmsr: enable msr ia32_misc_enable emulation
- :acrn-commit:`8e310e6e` - hv: vcpuid: modify vcpuid according to msr ia32_misc_enable
- :acrn-commit:`ef19ed89` - hv: vcpuid: reduce the cyclomatic complexity of function guest_cpuid
- :acrn-commit:`f0d06165` - hv: vmsr: handle guest msr ia32_misc_enable read/write
- :acrn-commit:`a0a6eb43` - hv: msr: use UL since ia32_misc_enable is 64bit
- :acrn-commit:`7494ed27` - Clean up MISRA C violation
- :acrn-commit:`d364d352` - reshuffle struct vboot_candidates
- :acrn-commit:`41ac9e5d` - rename function & definition from firmware to guest boot
- :acrn-commit:`20f97f75` - restruct boot and bsp dir for firmware stuff

375
doc/release_notes/release_notes_1.2.rst
View File

@ -1,375 +0,0 @@
.. _release_notes_1.2:
ACRN v1.2 (Aug 2019)
####################
We are pleased to announce the release of ACRN version 1.2.
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline embedded
development through an open source platform. Check out the :ref:`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 either download this source code as
a zip or tar.gz file (see the `ACRN v1.2 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v1.2>`_)
or use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v1.2
The project's online technical documentation is also tagged to correspond
with a specific release: generated v1.2 documents can be found at https://projectacrn.github.io/1.2/.
Documentation for the latest (master) branch is found at https://projectacrn.github.io/latest/.
ACRN v1.2 requires Clear Linux* OS version 30690.
Version 1.2 Major Features
**************************
What's New in v1.2
==================
* Support OVMF as virtual boot loader for Service VM to launch Clearlinux, VxWorks
or Windows, Secure boot is supported
* Support Kata container
* Windows as a Guest (WaaG): USB host (xHCI) mediator
* Virtualization supports Always Running Timer (ART)
* Various bug fixes and enhancements
Document Updates
================
We have many `reference documents available <https://projectacrn.github.io>`_, including:
* :ref:`Using Windows as User VM <using_windows_as_uos>`
* How to sign binaries of the Clear Linux image
* Using Celadon as User VM
* :ref:`SGX Virtualization <sgx_virt>`
We also updated the following documents based on the newly
defined **Usage Scenarios** in this release, including:
* :ref:`Introduction to Project ACRN <introduction>`
* :ref:`Build ACRN from Source <getting-started-building>`
* :ref:`Supported Hardware <hardware>`
* Using Hybrid mode on NUC (removed in v1.7)
* Launch Two User VMs on NUC using SDC2 Scenario (removed in v1.7)
New Features Details
********************
- :acrn-issue:`3051` - Kata Container Storage: Support rescan feature for virtio-blk
- :acrn-issue:`3163` - WaaG: USB host support
- :acrn-issue:`3401` - System is lagging when execute "fdisk -l" to query disk information with multiple USB devices after launch or reboot UOS
- :acrn-issue:`3486` - USB mediator: mediator mode can not recognize the SSD disk in RTVM and LaaG
- :acrn-issue:`3501` - Virtualization supports Always Running Timer (ART)
- :acrn-issue:`3505` - Succeed to reboot the whole system while execute reboot command in SOS
- :acrn-issue:`3506` - OVMF release v1.2
Fixed Issues Details
********************
- :acrn-issue:`2326` - There is no Read value output in the log when test "ST_PERF_USB2/3_mass_storage_protocol_Read_Large_File_as_Host"
- :acrn-issue:`2927` - The android guest will hung after test USB mediator camera[Frequency:20%]
- :acrn-issue:`3027` - Reboot SOS Failed[Frequency:10%]
- :acrn-issue:`3152` - Use virtio-blk instead passthru devices to boot RT
- :acrn-issue:`3181` - [auto][sit][daily]Case "Hypervisor_Launch_RTVM_on_SATA_Storage" sata disk can not passthru
- :acrn-issue:`3239` - HV can not produce #GP correctly sometimes
- :acrn-issue:`3268` - dm: add virtio-rnd device to command line
- :acrn-issue:`3277` - Potential Memory Leaks Found
- :acrn-issue:`3279` - AcrnGT causes display flicker in some situations
- :acrn-issue:`3280` - AcrnGT holding forcewake lock cause high cpu usage gvt workload thread
- :acrn-issue:`3281` - AcrnGT emulation thread causes high cpu usage when shadowing ppgtt
- :acrn-issue:`3283` - New scenario-based configurations lack documentation
- :acrn-issue:`3341` - Documentation on how to run Windows as a Guest (WaaG)
- :acrn-issue:`3370` - vm_console 2 cannot switch to VM2's console in hybrid mode
- :acrn-issue:`3374` - Potential interrupt info overwrite in acrn_handle_pending_request
- :acrn-issue:`3379` - DM: Increase hugetlbfs MAX_PATH_LEN from 128 to 256
- :acrn-issue:`3392` - During run UnigenHeaven 3D gfx benchmark in WaaG, RTVM latency is much long
- :acrn-issue:`3466` - Buffer overflow will happen in 'strncmp' when 'n_arg' is 0
- :acrn-issue:`3467` - Potential risk in virtioi_i2c.c & virtio_console.c
- :acrn-issue:`3469` - [APL NUC] Display goes black while booting; when only one display monitor is connected
- :acrn-issue:`3473` - dm: bugfix for remote launch guest issue
- :acrn-issue:`3480` - Add script to ``acrn-config/target`` and ``acrn-config/host/board_confing``
- :acrn-issue:`3482` - Acrn-hypervisor Root Directory Clean-up and Create misc/ folder for Acrn daemons, services and tools
- :acrn-issue:`3512` - hv: hypervisor console may hang in some platforms
Known Issues
************
:acrn-issue:`3465` - HV: reinit pbar base if a device reset is detected
When a passthru pci device is reset, its physical bar base address may be reset to 0,
with vpci bar emulation, vpci needs to reinit the physical bar base address to a
valid address if a device reset is detected.
**Impact:** Fail to launch Clear Linux Preempt_RT VM with ``reset`` passthru parameter
**Workaround:** Issue resolved on ACRN tag: ``acrn-2019w33.1-140000p``
-----
:acrn-issue:`3520` - bundle of "VGPU unconformance guest" messages observed for "gvt" in SOS console while using UOS
After the need_force_wake is not removed in course of submitting VGPU workload,
it will print a bundle of below messages while the User VM is started.
| gvt: vgpu1 unconformance guest detected
| gvt: vgpu1 unconformance mmio 0x2098:0xffffffff,0x0
**Impact:** Messy and repetitive output from the monitor
**Workaround:** Need to rebuild and apply the latest Service VM kernel from the ``acrn-kernel`` source code.
-----
:acrn-issue:`3533` - NUC hang while repeating the cold boot
NUC will hang while repeating cold boot operation.
1) Before begin coldboot, enable no passwd ssh for SOS and RTVM.
#) Boot up Service VM
#) Boot up Zephyr guest with UUID "d2795438-25d6-11e8-864e-cb7a18b34643"
#) Boot up RTVM with UUID "495ae2e5-2603-4d64-af76-d4bc5a8ec0e5"
#) Reboot RTVM and then will restart the whole system
#) After Service VM boot up, return to step 3
**Impact:** Cold boot operation is not stable for NUC platform
**Workaround:** Need to rebuild and apply the latest Service VM kernel from the ``acrn-kernel`` source code.
-----
:acrn-issue:`3576` - Expand default memory from 2G to 4G for WaaG
**Impact:** More memory size is required from Windows VM
**Workaround:** Issue resolved on ACRN tag: ``acrn-2019w33.1-140000p``
-----
:acrn-issue:`3609` - Sometimes fail to boot os while repeating the cold boot operation
**Workaround:** Please refer the PR information in this git issue
-----
:acrn-issue:`3610` - LaaG hang while run some workloads loop with zephyr idle
**Workaround:** Revert commit ``bbb891728d82834ec450f6a61792f715f4ec3013`` from the kernel
-----
:acrn-issue:`3611` - OVMF launch UOS fail for Hybrid and industry scenario
**Workaround:** Please refer the PR information in this git issue
-----
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v1.1
release in June 2019 (click on the CommitID link to see details):
.. comment
This list is obtained from this git command (update the date to pick up
changes since the last release):
git log --pretty=format:'- :acrn-commit:`%h` - %s' --after="2019-06-21"
- :acrn-commit:`2dbc8f03` - doc: remove references to 2.0 in intro
- :acrn-commit:`2d61e512` - doc: Release Notes v1.2
- :acrn-commit:`f33886d9` - doc: add new scenario-based intro
- :acrn-commit:`5b3b8efe` - doc: incorporate new scenario-based hardware doc
- :acrn-commit:`0b9257df` - doc: update Getting started guide for Intel NUC software setup
- :acrn-commit:`39aa209d` - doc: update Getting started guide for Intel NUC software setup
- :acrn-commit:`a55436b5` - doc:update Getting started guide for Intel NUC software setup
- :acrn-commit:`664fa27d` - doc: update Using SBL on UP2 Board
- :acrn-commit:`e9e59399` - doc: add limitation for UEFI services
- :acrn-commit:`63e66e65` - doc: hybrid mode scenario introduction
- :acrn-commit:`6b756b8b` - doc: add the SDC2 scenario doc into the navigation
- :acrn-commit:`a3251d85` - doc: incorporate scenario-based doc update
- :acrn-commit:`defac8d1` - doc: apply edits to SDC2 scenario doc
- :acrn-commit:`da744ac3` - doc: adding guide to launch 2 Linux UOSes using SDC2 scenario
- :acrn-commit:`b5140fdd` - doc: update v1.0.1 release notes
- :acrn-commit:`e3349195` - doc: release notes v1.0.1
- :acrn-commit:`4b5a06c1` - doc: improve CSS for home page grid
- :acrn-commit:`f7861687` - doc: fix image proportions on home page for ie
- :acrn-commit:`42d7fbea` - doc: fix broken links after content reorg
- :acrn-commit:`fd2e4391` - doc: additional doc navigation restructuring
- :acrn-commit:`34f9fec4` - doc: simplify navigation with restored doc org
- :acrn-commit:`f88348e9` - doc: continue doc restructuring
- :acrn-commit:`901a65cb` - HV: inject exception for invalid vmcall
- :acrn-commit:`c4f66810` - softirq: disable interrupt when modify timer_list
- :acrn-commit:`f49ab66b` - HV: fix highest severity flag in hybrid mode
- :acrn-commit:`11d4f415` - doc: Reorganize documentation site content
- :acrn-commit:`e188e1f2` - DM USB: xHCI: fix an error in PORTSC emulation
- :acrn-commit:`55a5876e` - DM USB: xHCI: workaround for USB SSD which supports UAS protocol
- :acrn-commit:`0e2cfd2d` - DM USB: add native info in control transfer logging code
- :acrn-commit:`87cafaea` - OVMF release v1.2
- :acrn-commit:`52618d0a` - doc: Update WaaG tutorial launch script and OVMF binary
- :acrn-commit:`8f65bfe6` - README: Fix Getting Started URL
- :acrn-commit:`363daf6a` - HV: return extended info in vCPUID leaf 0x40000001
- :acrn-commit:`accdadce` - HV: Enable vART support by intercepting TSC_ADJUST MSR
- :acrn-commit:`4adc8102` - Makefile: Add install for uefi firmware
- :acrn-commit:`18b4e302` - acrn-config: add README for scenario_config and launch_config
- :acrn-commit:`a03b1341` - acrn-config: generate a patch and apply to acrn-hypervisor
- :acrn-commit:`8adefe26` - acrn-config: generate board information on target board
- :acrn-commit:`107c406b` - dm: array bound checking to avoid buffer overflow
- :acrn-commit:`493ddefd` - dm: fix pointer not checked for null before use
- :acrn-commit:`d4f44bc7` - hv: fix debug message format in 'init_pci_pdev_list'
- :acrn-commit:`bde1d4b1` - acrn-hv: code review fix lib/string.c
- :acrn-commit:`653aa859` - DM: monitor support force stop
- :acrn-commit:`8b27daa7` - tools: acrnctl add '--force' option to 'stop' cmd
- :acrn-commit:`59fd4202` - tools: add force parameter to acrn VM stop operations
- :acrn-commit:`d1c8a514` - doc: Add ovmf option description
- :acrn-commit:`9139f94e` - HV: correct CONFIG_BOARD string of apl up2
- :acrn-commit:`8ee1615e` - doc: fix issues from moving tools to misc/tools
- :acrn-commit:`f44517c7` - final edits 3
- :acrn-commit:`879d0131` - final edit 2
- :acrn-commit:`1ccb9020` - final edits
- :acrn-commit:`d485ed86` - edits
- :acrn-commit:`28e49ac1` - more edits
- :acrn-commit:`cc2714ee` - edits from David review
- :acrn-commit:`7ee02d8e` - Image resize
- :acrn-commit:`87162e8b` - Making three images even smaller
- :acrn-commit:`42960ddc` - Adjust picture size for SGX
- :acrn-commit:`d0f7563d` - Corrected images and formatting
- :acrn-commit:`ce7a126f` - Added 3 SGX images
- :acrn-commit:`01504ecf` - Initial SGX Virt doc upload
- :acrn-commit:`a9c38a5c` - HV:Acrn-hypervisor Root Directory Clean-up and create misc/ folder for Acrn daemons, services and tools.
- :acrn-commit:`555a03db` - HV: add board specific cpu state table to support Px Cx
- :acrn-commit:`cd3b8ed7` - HV: fix MISRA violation of cpu state table
- :acrn-commit:`a092f400` - HV: make the functions void
- :acrn-commit:`d6bf0605` - HV: remove redundant function calling
- :acrn-commit:`c175141c` - dm: bugfix for remote launch guest issue
- :acrn-commit:`4a27d083` - hv: schedule: schedule to idle after SOS resume form S3
- :acrn-commit:`7b224567` - HV: Remove the mixed usage of inline assembly in wait_sync_change
- :acrn-commit:`baf7d90f` - HV: Refine the usage of monitor/mwait to avoid the possible lockup
- :acrn-commit:`11cf9a4a` - hv: mmu: add hpa2hva_early API for early boot
- :acrn-commit:`40475e22` - hv: debug: use printf to debug on early boot
- :acrn-commit:`cc47dbe7` - hv: uart: enable early boot uart
- :acrn-commit:`3945bc4c` - dm: array bound and NULL pointer issue fix
- :acrn-commit:`9fef51ab` - doc: organize release notes into a folder
- :acrn-commit:`ff299d5c` - dm: support VMs communication with virtio-console
- :acrn-commit:`18ecdc12` - hv: uart: make uart base address more readable
- :acrn-commit:`49e60ae1` - hv: refine handler to 'rdpmc' vmexit
- :acrn-commit:`0887eecd` - doc: remove deprecated sos_bootargs
- :acrn-commit:`2e79501e` - doc:update using_partition_mode_on_nuc nuc7i7bnh to nuc7i7dnb
- :acrn-commit:`a7b6fc74` - HV: allow write 0 to MSR_IA32_MCG_STATUS
- :acrn-commit:`3cf1daa4` - HV: move vbar info to board specific pci_devices.h
- :acrn-commit:`ce4d71e0` - vpci: fix coding style issue
- :acrn-commit:`a27ce27a` - HV: rename nuc7i7bnh to nuc7i7dnb
- :acrn-commit:`dde20bdb` - HV:refine the handler for 'invept' vmexit
- :acrn-commit:`16a7d252` - DM: ovmf NV storage writeback support
- :acrn-commit:`c787aaa3` - dm: allow High BIOS to be modifiable by the guest
- :acrn-commit:`12955fa8` - hv_main: Remove the continue in vcpu_thread
- :acrn-commit:`f0e1c5e5` - vcpu: init vcpu host stack when reset vcpu
- :acrn-commit:`11e67f1c` - softirq: move softirq from hv_main to interrupt context
- :acrn-commit:`cb9866bc` - softirq:spinlock: correct vioapic/vpic lock usage
- :acrn-commit:`87558b6f` - doc: remove vuart configuration in nuc and up2
- :acrn-commit:`e729b657` - doc: Add ACRN tag or Clear Linux version info for some tutorials
- :acrn-commit:`ffa7f805` - doc: Add tutorial to learn to sign binaries of a Clear Linux image.
- :acrn-commit:`be44e138` - doc: update WaaG doc
- :acrn-commit:`a4abeaf9` - hv: enforce no interrupt to RT VM via vlapic once lapic pt
- :acrn-commit:`97f6097f` - hv: add ops to vlapic structure
- :acrn-commit:`c1b4121e` - dm: virtio-i2c: minor fix
- :acrn-commit:`d28264ff` - doc: update CODEOWNERS for doc reviews
- :acrn-commit:`a90a6a10` - HV: add SDC2 config in hypervisor/arch/x86/Kconfig
- :acrn-commit:`796ac550` - hv: fix symbols not stripped from release binaries
- :acrn-commit:`63e258bd` - efi-stub: update string operation in efi-stub
- :acrn-commit:`05acc8b7` - hv: vuart: bugfix for communication vuart
- :acrn-commit:`ecc472f9` - doc: fix format in WaaG document
- :acrn-commit:`7990f52f` - doc: Add introduction of using Windows Guest OS
- :acrn-commit:`600aa8ea` - HV: change param type of init_pcpu_pre
- :acrn-commit:`e352553e` - hv: atomic: remove atomic load/store and set/clear
- :acrn-commit:`b39526f7` - hv: schedule: vCPU schedule state setting don't need to be atomic
- :acrn-commit:`8af334cb` - hv: vcpu: operation in vcpu_create don't need to be atomic
- :acrn-commit:`540841ac` - hv: vlapic: EOI exit bitmap should set or clear atomically
- :acrn-commit:`0eb08548` - hv: schedule: minor fix about the return type of need_offline
- :acrn-commit:`e69b3dcf` - hv: schedule: remove runqueue_lock in sched_context
- :acrn-commit:`b1dd3e26` - hv: cpu: pcpu_active_bitmap should be set atomically
- :acrn-commit:`1081e100` - hv: schedule: NEED_RESCHEDULE flag should be set atomically
- :acrn-commit:`7d43a93f` - HV: validate multiboot cmdline before merge cmdline
- :acrn-commit:`45afd777` - tools:acrn-crashlog: detect the panic event from all pstore files
- :acrn-commit:`be586b49` - doc:Update Getting started guide for Intel NUC
- :acrn-commit:`009a16bd` - vhostbridge: update vhostbridge to use vdev_ops
- :acrn-commit:`9eba328b` - vdev_ops: add general vdev ops
- :acrn-commit:`37de8f0b` - vbar:msi:msix: export vbar/msi/msix access checking
- :acrn-commit:`c2d25aaf` - pci_vdev: add pci_vdev_ops to pci_vdev
- :acrn-commit:`7a3ea2ad` - DM USB: xHCI: fix corner case of short packet logic
- :acrn-commit:`32d186ba` - DM USB: xHCI: add the resume state for PLS bits
- :acrn-commit:`c3d4cc36` - DM USB: xHCI: refine the logic of Stop Endpoint cmd
- :acrn-commit:`56868982` - DM USB: xHCI: change log for convenience of debugging
- :acrn-commit:`4db7865c` - tools: acrn-manager: fix headers install for ioc cbc tools
- :acrn-commit:`5b1852e4` - HV: add kata support on sdc scenario
- :acrn-commit:`2d4809e3` - hv: fix some potential array overflow risk
- :acrn-commit:`e749ced4` - dm: remove unsafe apis in dm log
- :acrn-commit:`d8b752c4` - dm: fix variable argument list read without ending with va_end
- :acrn-commit:`178c016a` - tools: fix variable argument list read without ending with va_end
- :acrn-commit:`b96a3555` - dm: fix some possible memory leak
- :acrn-commit:`304ae381` - HV: fix "use -- or ++ operations"
- :acrn-commit:`1884bb05` - HV: modify HV RAM and serial config for apl-nuc
- :acrn-commit:`f18dfcf5` - HV: prepare ve820 for apl nuc
- :acrn-commit:`2ec16949` - HV: fix sbuf "Casting operation to a pointer"
- :acrn-commit:`79d03302` - HV: fix vmptable "Casting operation to a pointer"
- :acrn-commit:`9063504b` - HV: ve820 fix "Casting operation to a pointer"
- :acrn-commit:`1aef5290` - doc: Add platform sos info and GUI screenshots against Celadon Guest OS
- :acrn-commit:`714162fb` - HV: fix violations touched type conversion
- :acrn-commit:`5d6c9c33` - hv: vlapic: clear up where needs atomic operation in vLAPIC
- :acrn-commit:`05a4ee80` - hv: cpu: refine secondary cpu start up
- :acrn-commit:`5930e96d` - hv: io_req: refine vhm_req status setting
- :acrn-commit:`1ea3052f` - HV: check security mitigation support for SSBD
- :acrn-commit:`b592404f` - script: set virtio-console BE to stdio for LaaG
- :acrn-commit:`d90fee9f` - hv: add vuart for VM2 in hybrid scenario
- :acrn-commit:`59800214` - DM: Increase hugetlbfs MAX_PATH_LEN from 128 to 256
- :acrn-commit:`44fc5fcb` - doc: fix typos in rtvm workload design doc
- :acrn-commit:`503b71a1` - doc: add guideline for RTVM workload design
- :acrn-commit:`93659f01` - doc: Add introduction of launching Celadon User OS
- :acrn-commit:`4b6dc025` - HV: fix vmptable misc violations
- :acrn-commit:`564a6012` - HV: fix vuart.c "Parameter needs to add const"
- :acrn-commit:`e4d1c321` - hv:fix "no prototype for non-static function"
- :acrn-commit:`4129b72b` - hv: remove unnecessary cancel_event_injection related stuff
- :acrn-commit:`ea849177` - hv: fix interrupt lost when do acrn_handle_pending_request twice
- :acrn-commit:`9a7043e8` - HV: remove instr_emul.c dead code
- :acrn-commit:`254577a6` - makefile: fix parallel build
- :acrn-commit:`3164f397` - hv: Mitigation for CPU MDS vulnerabilities.
- :acrn-commit:`076a30b5` - hv: refine security capability detection function.
- :acrn-commit:`127c98f5` - hv: vioapic: fix interrupt lost and redundant interrupt
- :acrn-commit:`e720dda5` - DM: virtio-i2c: add dsdt info
- :acrn-commit:`b6f9ed39` - DM: virtio-i2c: add msg process logic
- :acrn-commit:`859af9e0` - DM: virtio-i2c: add backend interface
- :acrn-commit:`a450add6` - DM: virtio-i2c: add support for virtio i2c adapter
- :acrn-commit:`2751f137` - dm: remove Execute attribute of usb_pmapper.c
- :acrn-commit:`f3ffce4b` - hv: vmexit: ecx should be checked instead of rcx when xsetbv
- :acrn-commit:`e8371166` - dm: clean up assert in virtio_rnd.c
- :acrn-commit:`842da0ac` - dm: cleanup assert in core.c
- :acrn-commit:`012ec751` - HV: rename vbdf in struct pci_vdev to bdf
- :acrn-commit:`148e7473` - HV: add support for PIO bar emulation
- :acrn-commit:`4be09f24` - HV: enable bar emulation for sos
- :acrn-commit:`af163d57` - HV: add support for 64-bit bar emulation
- :acrn-commit:`09a63560` - hv: vm_manage: minor fix about triple_fault_shutdown_vm
- :acrn-commit:`ebf5c5eb` - hv: cpu: remove CPU up count
- :acrn-commit:`647797ff` - hv: ptdev: refine ptdev active flag
- :acrn-commit:`cb8bbf7b` - dm: clean up the use of errx
- :acrn-commit:`82f7720a` - dm: vhpet: clean up asserts
- :acrn-commit:`aac82750` - dm: vpit: clean up asserts
- :acrn-commit:`81f9837e` - Revert "dm: add "noapic" to rt-linux kernel parameters"
- :acrn-commit:`5a9a7bcd` - dm: gvt: clean up assert
- :acrn-commit:`bd3f2044` - dm: hyper_dmabuf: clean up assert
- :acrn-commit:`56501834` - dm: gc: clean up assert
- :acrn-commit:`4a22801d` - hv: ept: mask EPT leaf entry bit 52 to bit 63 in gpa2hpa
- :acrn-commit:`c64877f5` - tools: add check to verify that running with root privileges
- :acrn-commit:`4c3f298e` - doc:add more description about application constraints
- :acrn-commit:`ae996250` - HV: extract functions from code to improve code reuse and readability
- :acrn-commit:`84e09a22` - HV: remove uint64_t base from struct pci_bar
- :acrn-commit:`5a8703f7` - HV: need to unmap existing EPT mapping for a vbar base (gpa)
- :acrn-commit:`0247c0b9` - Hv: minor cosmetic fix
- :acrn-commit:`f0244b24` - HV: call get_vbar_base() to get the newly set vbar base address in 64-bit
- :acrn-commit:`ed1bdcbb` - HV: add uint64_t bar_base_mapped[PCI_BAR_COUNT] to struct pci_vdev
- :acrn-commit:`65ca6ae4` - HV: add get_vbar_base() to get vbar base address in 64-bit
- :acrn-commit:`7a2f5244` - HV: store the vbar base address in vbar's reg member
- :acrn-commit:`1b4dbdab` - HV: add get_pbar_base() to get pbar base address in 64-bit
- :acrn-commit:`8707834f` - HV: remove the function get_bar_base()
- :acrn-commit:`74b78898` - HV:fix vcpu more than one return entry
- :acrn-commit:`198e0171` - HV:fix vcpu violations
- :acrn-commit:`dc510030` - version: 1.2-unstable

228
doc/release_notes/release_notes_1.3.rst
View File

@ -1,228 +0,0 @@
.. _release_notes_1.3:
ACRN v1.3 (Sep 2019)
####################
We are pleased to announce the release of ACRN version 1.3.
ACRN is a flexible, lightweight reference hypervisor, built with
real-time and safety-criticality in mind, optimized to streamline embedded
development through an open source platform. Check out the :ref:`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 either download this source code as
a zip or tar.gz file (see the `ACRN v1.3 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v1.3>`_)
or use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v1.3
The project's online technical documentation is also tagged to correspond
with a specific release: generated v1.3 documents can be found at https://projectacrn.github.io/1.3/.
Documentation for the latest (master) branch is found at https://projectacrn.github.io/latest/.
ACRN v1.3 requires Clear Linux* OS version 31080.
Version 1.3 Major Features
**************************
What's New in v1.3
==================
* OVMF supports Graphics Output Protocol (GOP), allowing Windows logo at guest
VM boot time.
* Platform-level coordinated graceful shutdown (S5) for User VMs.
* Virtual UART (vUART) for inter-VM communication.
* Introduced :ref:`acrn-config <acrn_configuration_tool>` tool to configure VM
and hypervisor from a XML configuration file at build time.
* Ethernet mediator now supports prioritization per VM.
* Features for real-time determinism, e.g. Cache Allocation Technology (CAT, only supported on Apollo Lake).
Document Updates
================
We have many new `reference documents available <https://projectacrn.github.io>`_, including:
* Getting Started Guide for Industry scenario
* :ref:`ACRN Configuration Tool Manual <acrn_configuration_tool>`
* :ref:`Trace and Data Collection for ACRN real-time (RT) Performance Tuning <rt_performance_tuning>`
* Building ACRN in Docker
* Running Ubuntu as the User VM
* Running Debian as the User VM
* Running Debian as the Service VM
* :ref:`vUART configuration <vuart_config>`
* :ref:`Enable virtio-i2c <virtio-i2c>`
New Features Details
********************
- :acrn-issue:`3624` - Virtualization supports Windows Guest Bootup Logo
- :acrn-issue:`3623` - Platform Configuration Tool
- :acrn-issue:`3602` - Hypervisor Tools
- :acrn-issue:`3624` - Virtualization supports Windows Guest Bootup Logo
- :acrn-issue:`3564` - Power Management: S5
- :acrn-issue:`3413` - Support NV storage writeback of OVMF
- :acrn-issue:`3327` - Cleanup vIOAPIC and vPIC for RT VM
- :acrn-issue:`3484` - tools: support force stop VM
- :acrn-issue:`3446` - Rename board name of nuc7i7bnh to nuc7i7dnb
- :acrn-issue:`3497` - Inject exception for invalid vmcall
- :acrn-issue:`3498` - Return extended info in vCPUID leaf 0x40000001
- :acrn-issue:`2934` - Use virtual APIC IDs for Pre-launched VMs
- :acrn-issue:`3459` - dm: support VMs communication with virtio-console
- :acrn-issue:`3190` - DM: handle SIGPIPE signal
Fixed Issues Details
********************
- :acrn-issue:`3533` - NUC hang while repeating the cold boot
- :acrn-issue:`3572` - Check guest cr3 before loading pdptrs
- :acrn-issue:`3576` - Expand default memory from 2G to 4G for WaaG
- :acrn-issue:`3593` - Makefile change which add isd build
- :acrn-issue:`3594` - UOS have no response After ignore/poweroff/suspend with pressing power key
- :acrn-issue:`3609` - Sometimes fail to boot os while repeating the cold boot operation
- :acrn-issue:`3610` - LaaG hang while run some workloads loop with zephyr idle
- :acrn-issue:`3611` - OVMF launch UOS fail for Hybrid and industry scenario
- :acrn-issue:`3612` - Potential Null pointer be dereferenced in 'usb_dev_request()'
- :acrn-issue:`3626` - hv: vtd: fix MACRO typos
- :acrn-issue:`3644` - hv boot hang on some KBL platform
- :acrn-issue:`3648` - UOS hang when booting UOS with acrnlog running with mem loglevel=6
- :acrn-issue:`3708` - Properly reset pCPUs with LAPIC PT enabled during VM shutdown/reset
Known Issues
************
- :acrn-issue:`3598` - SEP/SOCWATCH fixes for following coding guidelines
- :acrn-issue:`3622` - Kernel PANIC while rebased acrngt patches to mainline kernel
- :acrn-issue:`3630` - Clean up the code on drm/i915/gvt
- :acrn-issue:`3636` - tsc_deadline incorrect issue
- :acrn-issue:`3673` - Incorrect reference to OVMF.fd in sample UOS startup script
- :acrn-issue:`3675` - cbm length calculation,Extended model judge, print info error
- :acrn-issue:`3681` - Data lose in vuart communication
- :acrn-issue:`3686` - The documentation build system creates artefacts in the
- :acrn-issue:`3697` - Secure timer check failed in trusty which would cause unlock failure after resume from S3
- :acrn-issue:`3721` - [Compiling Issue] Error implicit declaration with VIRTIO_PCI_CONFIG_OFF
- :acrn-issue:`3723` - CODEOWNERS folder names are incorrect
- :acrn-issue:`3729` - Cannot auto boot 2 VMs with acrnd
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v1.2
release in Aug 2019 (click on the CommitID link to see details):
.. comment
This list is obtained from this git command (update the date to pick up
changes since the last release):
git log --pretty=format:'- :acrn-commit:`%h` - %s' --after="2019-08-23"
- :acrn-commit:`fe74464a` - doc: content updates for using SBL on UP2 board file
- :acrn-commit:`860f7b89` - doc: minor edits to using celadon as user os file
- :acrn-commit:`bb6d2acb` - doc: content updates to GSG for the Intel NUC
- :acrn-commit:`32614324` - doc: Add document of RT performance tuning.
- :acrn-commit:`ca27f8ed` - update using_sbl_on_up2 doc and create-up2-images.sh
- :acrn-commit:`36d52c71` - doc: Add note to use a stable Celadon source tree
- :acrn-commit:`72c99c08` - doc: update gsg and acrn_quick_setup.sh
- :acrn-commit:`e7d048b9` - doc: tweak vUART tutorial for improved rendering
- :acrn-commit:`8be09779` - Doc: Update image and text in Virtio-i2c doc
- :acrn-commit:`58a093de` - Doc: Initial vuart configuration doc and images--4979
- :acrn-commit:`6677add9` - Initial virtio i2c doc and images.
- :acrn-commit:`4692db8a` - New tutorials for running deb or ubunt as user vms
- :acrn-commit:`f2a32b48` - Intitial doc for Running Debian as a Service VM
- :acrn-commit:`d853c52d` - Language edits to the Building ACRN in Docker tutorial
- :acrn-commit:`68975ba7` - doc: add build acrn in docker tutorial
- :acrn-commit:`456709c6` - Makefile: build default acrn.efi with nuc6cayh
- :acrn-commit:`3e9f2aa3` - acrn-config: remove hvlog support for generic board
- :acrn-commit:`bd3a686d` - acrn-config: add apl-up2-n3350 config xmls
- :acrn-commit:`ac003623` - acrn-config: update board xml of apl-up2
- :acrn-commit:`55fbe8fb` - acrn-config: update README for acrn-config
- :acrn-commit:`77fa8650` - acrn-config: reserve 16M memory for hv start
- :acrn-commit:`f776cfd2` - acrn-config: fix parameter error in launch script
- :acrn-commit:`c15beff4` - Makefile: add build tag for acrn-config tool in version.h
- :acrn-commit:`c33a2c29` - Makefile: generate config patch in hypervisor/Makefile
- :acrn-commit:`571b30dc` - dm: switch to launch RT_LaaG with OVMF by default
- :acrn-commit:`bf971d75` - OVMF release v1.3
- :acrn-commit:`e5f733fb` - hv: vm: properly reset pCPUs with LAPIC PT enabled during VM shutdown/reset
- :acrn-commit:`bad75329` - acrn-config: add launch sample xmls for acrn-config
- :acrn-commit:`3c621ccc` - acrn-config: generate launch script file and apply to the souce file
- :acrn-commit:`bc31dc00` - acrn-config: modify rootfs tag in board information
- :acrn-commit:`f50f92cc` - Makefile: override .config with specified scenario
- :acrn-commit:`42b864b1` - DM: update launch scripts to use OVMF.fd directly from the rootfs
- :acrn-commit:`bfc92308` - DM: make LaaG launch script use the OVMF.fd from the Service VM
- :acrn-commit:`e0006883` - acrn-config: add memmap param for hvlog in xmls
- :acrn-commit:`b3ff3cdf` - HV: add memmap param for hvlog in sos cmdline
- :acrn-commit:`a348be73` - Misc: lifemngr-daemon-on-UOS
- :acrn-commit:`d2290076` - makefile: enable xml config to build hypervisor
- :acrn-commit:`6e122870` - acrn-config: add xmls for acrn-config tools
- :acrn-commit:`8a16d8b6` - acrn-config: generate a scenario patch and apply to acrn-hypervisor
- :acrn-commit:`77c17ab4` - acrn-config: enhance the target config
- :acrn-commit:`a95a88c5` - doc: Remove "or newer/higher" descriptions for other release notes and some tutorials.
- :acrn-commit:`12db54af` - doc: update CODEOWNER for rst
- :acrn-commit:`6b6aa806` - hv: pm: fix coding style issue
- :acrn-commit:`f039d759` - hv: pm: enhencement platform S5 entering operation
- :acrn-commit:`ce937587` - hv: pm: correct the function name
- :acrn-commit:`f41f9307` - DOC: add --pm_by_vuart setting guide.
- :acrn-commit:`3d23c90a` - DM: to avoid RTVM shutdown forcely by acrn-dm
- :acrn-commit:`8578125f` - DM: add power off by vuart setting to launch script
- :acrn-commit:`eb5a57b7` - DM: add guest vm power manager by vuart
- :acrn-commit:`00401a1e` - DM: separate pty vuart operation from IOC
- :acrn-commit:`d188afbc` - HV: add acpi info header for nuc7i7dnb
- :acrn-commit:`00da5a99` - acrn-config: web UI app for acrn-config tool
- :acrn-commit:`476e9a2e` - doc: Update document for --pm_notify_channel
- :acrn-commit:`e38e0263` - script: launch_uos: Give right pm notify channel
- :acrn-commit:`b36d80ea` - dm: pm: add dm option to select guest notify method
- :acrn-commit:`10413849` - dm: pm: move host power button related code out of pm.c
- :acrn-commit:`ca51cc9d` - hv: vPCI: vPCI device should use its virtual configure space to access its BAR
- :acrn-commit:`6ebc2221` - hv: vPCI: cache PCI BAR physical base address
- :acrn-commit:`5083aba3` - doc: review edits for config tool doc
- :acrn-commit:`ede59885` - doc: add 'logger_setting' parameter information to acrn-dm documentation
- :acrn-commit:`ff91d073` - doc: update .gitignore to reflect the new location of the tools
- :acrn-commit:`9bb21aca` - dm: remove '-p' option from the embedded help
- :acrn-commit:`8b9aa110` - hv: mmu: remove strict check for deleting page table mapping
- :acrn-commit:`127c73c3` - hv: mmu: add strict check for adding page table mapping
- :acrn-commit:`c691c5bd` - hv:add volatile keyword for some variables
- :acrn-commit:`be0c2a81` - doc: update CODEOWNERS for doc, misc reviews
- :acrn-commit:`26642543` - Merge pull request #3660 from deb-intel/3632_GCC
- :acrn-commit:`96d51a52` - Add URL to GCC 7.3 Manual, Section 6
- :acrn-commit:`639c6986` - dm: reserve 16M hole for gvt in e820 table
- :acrn-commit:`32d85105` - hv: remove pr_dbg between stac/clac
- :acrn-commit:`8d27c1e1` - Merge pull request #3632 from shiqingg/doc-lang-ext
- :acrn-commit:`19e9c4ca` - Merge pull request #3613 from gvancuts/acrnctl-force-arg
- :acrn-commit:`67f3da2e` - Merge pull request #3567 from ClaudZhang1995/zy4
- :acrn-commit:`876d3112` - Merge pull request #3640 from lirui34/add_new_glossary
- :acrn-commit:`ceec4d80` - Merge pull request #3649 from gvancuts/zlib1g-dev-debian
- :acrn-commit:`1b48773f` - Merge pull request #3653 from deb-intel/remove_newerRef
- :acrn-commit:`edbec46d` - doc: Add ACRN configuration tool tutorial
- :acrn-commit:`1e3da9f2` - Merge pull request #3658 from deb-intel/USBMed
- :acrn-commit:`fd60bb07` - Add supported USB devices for WaaG and LaaG OSs
- :acrn-commit:`5d284c08` - doc: Add three new glossaries
- :acrn-commit:`81435f55` - vm reset: refine platform reset
- :acrn-commit:`add89b51` - Remove "or newer" reference to ensure that users know ACRN 1.2 requires ONLY Clear Linux OS version 30690.
- :acrn-commit:`4041275f` - doc: update Build ACRN from Source
- :acrn-commit:`d324f79a` - doc: add 'zlib1g-dev' to list of dependencies in Debian
- :acrn-commit:`cd40980d` - hv:change function parameter for invept
- :acrn-commit:`1547a4cb` - efi-stub: fix stack memory free issue
- :acrn-commit:`cd1ae7a8` - hv: cat: isolate hypervisor from rtvm
- :acrn-commit:`38ca8db1` - hv:tiny cleanup
- :acrn-commit:`f15a3600` - hv: fix tsc_deadline correctness issue
- :acrn-commit:`3f84acda` - hv: add "invariant TSC" cap detection
- :acrn-commit:`be0a4b69` - DM USB: fix enumeration related issues
- :acrn-commit:`e7179aa7` - dm: support VM running with more than 4 vcpus
- :acrn-commit:`adf3a593` - Makefile: Refine Makefile to generate both industry and sdc images
- :acrn-commit:`3729fa94` - doc: update Language Extensions in coding guidelines
- :acrn-commit:`f9945484` - hv: vtd: fix MACRO typos
- :acrn-commit:`295701cc` - hv: remove mptable code for pre-launched VMs
- :acrn-commit:`b447ce3d` - hv: add ACPI support for pre-launched VMs
- :acrn-commit:`96b422ce` - hv: create 8-bit sum function
- :acrn-commit:`81e2152a` - hv: cosmetic fixes in acpi.h
- :acrn-commit:`216c19f4` - hv: use __packed for all ACPI related structs
- :acrn-commit:`a1ef0ab9` - hv: move ACPI related defines/structs to acpi.h
- :acrn-commit:`6ca4095d` - Update pages with missing links
- :acrn-commit:`cc1dd6da` - doc: add "-f/--force' optional arg to 'acrnctl' documentation
- :acrn-commit:`2d57c5fe` - dm: virtio-console: add subclass
- :acrn-commit:`66056c1a` - dm: bzimage loader: get linux bzimage setup_sects from header
- :acrn-commit:`fc3d19be` - DM USB: fix potential crash risk due to null pointer
- :acrn-commit:`4a71a16a` - hv: vtd: remove global cache invalidation per vm
- :acrn-commit:`5c816597` - hv: ept: flush cache for modified ept entries
- :acrn-commit:`2abd8b34` - hv: vtd: export iommu_flush_cache
- :acrn-commit:`826aaf7b` - version: 1.3-unstable

402
doc/release_notes/release_notes_1.4.rst
View File

@ -1,402 +0,0 @@
.. _release_notes_1.4:
ACRN v1.4 (Oct 2019)
####################
We are pleased to announce the release of ACRN version 1.4.
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. Check out the :ref:`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 either download this source code as
a zip or tar.gz file (see the `ACRN v1.4 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v1.4>`_)
or use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v1.4
The project's online technical documentation is also tagged to correspond
with a specific release: generated v1.4 documents can be found at https://projectacrn.github.io/1.4/.
Documentation for the latest (master) branch is found at https://projectacrn.github.io/latest/.
ACRN v1.4 requires Clear Linux* OS version 31670.
Version 1.4 Major Features
**************************
What's New in v1.4
==================
* ACRN now conforms to the Microsoft* Hypervisor Top-Level Functional Specification (TLFS).
* ACRN scheduler framework re-architected capabilities have been added.
* WaaG (Windows as a guest) stability and performance has been improved.
* Realtime performance of the RTVM (preempt-RT kernel-based) has been improved.
Document Updates
================
Many new `reference documents <https://projectacrn.github.io>`_ are available, including:
* :ref:`ACRN high-level design <hld>` documents.
* :ref:`enable-s5`
* Enable Secure Boot in the Clear Linux User VM
* :ref:`How-to-enable-secure-boot-for-windows`
* :ref:`asa`
Security Vulnerabilities
************************
We recommend that all developers upgrade to this v1.4 release, which
addresses the following security issues that were discovered in previous releases:
Mitigation for Machine Check Error on Page Size Change
Improper invalidation for page table updates by a virtual guest operating system for multiple
Intel |reg| Processors may allow an authenticated user to potentially enable denial of service
of the host system via local access. Malicious guest kernel could trigger this issue, CVE-2018-12207.
AP Trampoline Is Accessible to the Service VM
This vulnerability is triggered when validating the memory isolation between the VM and hypervisor.
The AP Trampoline code exists in the LOW_RAM region in the hypervisor but is
potentially accessible to the Service VM. This could be used by an attacker to mount DoS
attacks on the hypervisor if the Service VM is compromised.
Improper Usage Of the ``LIST_FOREACH()`` Macro
Testing discovered that the MACRO ``LIST_FOREACH()`` was incorrectly used in some cases
which could induce a "wild pointer" and cause the ACRN Device Model to crash. Attackers
can potentially use this issue to cause denial of service (DoS) attacks.
Hypervisor Crashed When Fuzzing HC_SET_CALLBACK_VECTOR
This vulnerability was reported by the Fuzzing tool for the debug version of ACRN. When the software fails
to validate input properly, an attacker is able to craft the input in a form that is
not expected by the rest of the application. This can lead to parts of the system
receiving unintended inputs, which may result in an altered control flow, arbitrary control
of a resource, or arbitrary code execution.
FILE Pointer Is Not Closed After Using
This vulnerability was reported by the Fuzzing tool. Leaving the file unclosed will cause a
leaking file descriptor and may cause unexpected errors in the Device Model program.
Descriptor of Directory Stream Is Referenced After Release
This vulnerability was reported by the Fuzzing tool. A successful call to ``closedir(DIR *dirp)``
also closes the underlying file descriptor associated with ``dirp``. Access to the released
descriptor may point to some arbitrary memory location or cause undefined behavior.
Mutex Is Potentially Kept in a Locked State Forever
This vulnerability was reported by the Fuzzing tool. Here, ``pthread_mutex_lock/unlock`` pairing was not
always done. Leaving a mutex in a locked state forever can cause program deadlock,
depending on the usage scenario.
We recommend that all developers upgrade to ACRN release v1.4.
New Features Details
********************
- :acrn-issue:`3583` - Add Oracle subsystem vendor ID for some virtio devices.
- :acrn-issue:`3600` - remove unused acrn-dm option "pincpu".
- :acrn-issue:`3663` - CPU Sharing: Static Schedule Configuration.
- :acrn-issue:`3813` - CPU Sharing: noop CPU Scheduler.
- :acrn-issue:`3831` - implement performance related TLFS features.
- :acrn-issue:`3832` - Implement Microsoft TLFS minimal requirements.
- :acrn-issue:`3927` - OVMF release V1.4
Fixed Issues Details
********************
- :acrn-issue:`3286` - Remove all TravisCI-related files (including Dockerfiles)
- :acrn-issue:`3329` - Enhance the built-in and online help for `acrnd`
- :acrn-issue:`3330` - Add a check to `acrnd` and `acrnctl` to verify if running with root privileges
- :acrn-issue:`3425` - Guest cannot support more than 4 vcpu
- :acrn-issue:`3429` - [Community][Internal]Add SDC2 scenario to support three post-launched VM for some automotive SDC system
- :acrn-issue:`3491` - [KBL][HV][LaaG]Kill acrn-dm fail after Failed to Launch UOS with 0core
- :acrn-issue:`3503` - [KBL][HV][Hybrid]SOS fail results is different with native when SOS_LTP_syscalls.
- :acrn-issue:`3532` - [UP2][SBL][VBS] sbl-up2 could not boot up when HYBRID kconfig enabled
- :acrn-issue:`3593` - Makefile change which add isd build.
- :acrn-issue:`3598` - [Community-dev][Internal]SEP/SOCWATCH fixes for following coding guidelines
- :acrn-issue:`3609` - [KBLNUC][Stability][RTVM]Host entered standby state with power key flickering in coldboot test.
- :acrn-issue:`3612` - Potential Null pointer be dereferenced in 'usb_dev_request()'
- :acrn-issue:`3622` - [AcrnGT] Kernel PANIC while rebased acrngt patches to mainline kernel v5.2
- :acrn-issue:`3626` - hv: vtd: fix MACRO typos
- :acrn-issue:`3636` - tsc_deadline incorrect issue.
- :acrn-issue:`3644` - HV hang on AC810
- :acrn-issue:`3648` - [REG][KBL/ISD/VBS][HV][SOS]UOS hang when booting UOS with acrnlog running with mem loglevel=6.
- :acrn-issue:`3673` - [Community-dev][Internal]Incorrect reference to OVMF.fd in sample UOS startup script
- :acrn-issue:`3675` - [Community-dev][Internal] cbm length calculation,Extended model judge, print info error
- :acrn-issue:`3708` - [Auto][Daily][OVMF] RTVM can not launch after poweroff, rtvm can not reboot
- :acrn-issue:`3718` - [KBLNUC][Stability][RTVM]WaaG hang after keep WaaG idle in RTVM Create/Destroy test.
- :acrn-issue:`3729` - [KBLNUC]Cannot auto boot 2 VMs with acrnd
- :acrn-issue:`3751` - [acrn-configuration-tool] The default launch script generated by acrn-config for Preemp-RT
Linux will pass through Ethernet device, which does not match the behavior with devicemodel/samples/nuc/launch_hard_rt.sh
- :acrn-issue:`3754` - [acrn-configuration-tool] WebUI could not select /dev/mmcblk0p1 as UOS rootfs for apl-up2 board, and /dev/mmcblk1p3 for apl-mrb
- :acrn-issue:`3760` - [acrn-configuration-tool]WebUI could not generate configuration patch for a new imported board
- :acrn-issue:`3778` - DM: LIST_FOREACH is improperly used and will result in potential crash
- :acrn-issue:`3787` - crashtool: Invalid pointer validation in "crash_completed_cb()"
- :acrn-issue:`3788` - [acrn-configuration-tool]pci sub class name of NVME contain '-' and ' ' cause wrong macro
- :acrn-issue:`3789` - DM:The return value of snprintf is improperly checked.
- :acrn-issue:`3798` - [acrn-configuration-tool] Failed to make hypervisor by using xml
- :acrn-issue:`3801` - [UP2/KBL][HV][LaaG][Fuzzing]Hypervisor crash when run syz_ic_set_callback_vector.
- :acrn-issue:`3809` - [acrn-configuration-tool]The "uos_type"& items in "passthrough_devices" will disappear when clicking on the drop-down box.
- :acrn-issue:`3811` - [acrn-configuration-tool]Fail to Generate launch_script for a new imported board
- :acrn-issue:`3812` - [acrn-configuration-tool] Generated Launch script is incorrect when select ethernet for apl-mrb with
Scenario:SDC+Launch Setting: sdc_launch_1uos_laag/aaag
- :acrn-issue:`3817` - DM: FILE Pointer Is Not Closed After Operations in acrn_load_elf
- :acrn-issue:`3821` - DM: DIR handler is referenced after release in npk.c
- :acrn-issue:`3822` - DM: Potential Buffer Overflow due to Unvalidated Input in vm_monitor_blkrescan()
- :acrn-issue:`3825` - DM: 'request_mutex' is potentially not unlocked in tpm_crb.c
- :acrn-issue:`3827` - Service VM power off need at least one minute when passthru NVMe to RTVM
- :acrn-issue:`3834` - [acrn-configuration-tool] UX enhancement: acrn-config end users hope to have interfaces to commit changes to
local tree or not after setting scenario/launch scripts
- :acrn-issue:`3840` - [Hybrid][UP2][GVT][LaaG]LaaG has no display with uefi boot mode
- :acrn-issue:`3852` - [acrn-configuration-tool]RTVM cannot launched successfully after have launched vxworks or waag.
- :acrn-issue:`3853` - [acrn-configuration-tool] Generated Launch script is incorrect when select audio&audio_codec for nuc7i7dnb with Scenario:SDC
- :acrn-issue:`3859` - VM-Manager: the return value of "strtol" is not validated properly
- :acrn-issue:`3863` - [acrn-configuration-tool]WebUI do not select audio&wifi devices by default for apl-mrb with LaunchSetting: sdc_launch_1uos_aaag
- :acrn-issue:`3879` - [acrn-configuration-tool]The "-k" parameter is unnecessary in launch_uos_id2.sh for RTVM.
- :acrn-issue:`3880` - [acrn-configuration-tool]"--windows \" missing in launch_uos_id1.sh for waag.
- :acrn-issue:`3900` - [WHL][acrn-configuration-tool]Same bdf in generated whl-ipc-i5.xml.
- :acrn-issue:`3913` - [acrn-configuration-tool]WebUI do not give any prompt when generate launch_script for a new imported board
- :acrn-issue:`3914` - [KBL][HV][LaaG] in LaaG, Geekbenck single core result is aroud 83% percent of native
- :acrn-issue:`3917` - [acrn-configuration-tool]Can not select "Network controller" device in wifi&ethernet combobox for Board=nuc6cayh&nuc7i7dnb on WebUI
- :acrn-issue:`3925` - Statically allocate 2 pCPUs for hard RT VM by default
- :acrn-issue:`3932` - [KBL][acrn-configuration-tool]Generated Launch script miss "-m $mem_size" after select passthru_device
- :acrn-issue:`3933` - [KBLNUC][Function][LaaG] can't bootup LaaG
- :acrn-issue:`3937` - [KBL][acrn-configuration-tool][WaaG]Generated Launch script miss boot_audio_option's right_double_quotation_marks
for Board info:nuc7i7dnb + Launch Setting: industry_launch_1uos_waag
- :acrn-issue:`3947` - [ISD][Stability][WaaG] WaaG auto boot failed after systemctl enable acrnd during S5 testing
- :acrn-issue:`3948` - [KBL][acrn-configuration-tool]'keep_gsi' should not set along with waag vm
- :acrn-issue:`3949` - [KBL][acrn-configuration-tool]'virtio-blk' was generated in launch script of Preempt-RT, should remove it
- :acrn-issue:`3974` - [WHL][Function][RT_LaaG][REG]RTVM cannot poweroff & acrnctl stop.
- :acrn-issue:`3975` - [WHL][Function][RT_LaaG][REG]RTVM cannot poweroff & acrnctl stop.
- :acrn-issue:`3993` - trampoline code in hypervisor potentially be accessible to service VM
Known Issues
************
- :acrn-issue:`3979` - The boot uos script will display the sos information on the uos screen for about 2s
- :acrn-issue:`4005` - Fail to create WaaG image using ISO only on WHL
- :acrn-issue:`4042` - RTVM UOS result is invalid when run cpu2017 with 3 and 1 core.
- :acrn-issue:`4043` - Windows guest can not get normal IP after passthru Ethernet
- :acrn-issue:`4045` - Adding USB mediator in launch script, it takes a long time to start windows, about 13 minutes.
- :acrn-issue:`4046` - Error info pop up when run 3DMARK11 on Waag
- :acrn-issue:`4047` - passthru usb, when WaaG boot at "windows boot manager" menu, the usb keyboard does not work.
- :acrn-issue:`4048` - Scaling the media player while playing a video, then the video playback is not smooth
- :acrn-issue:`4049` - Only slot-2 can work in "-s n,passthru,02/00/0 \" for RTVM, other slots are not functional
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v1.3
release in Sep 2019 (click on the CommitID link to see details):
.. comment
This list is obtained from this git command (update the date to pick up
changes since the last release):
git log --pretty=format:'- :acrn-commit:`%h` - %s' --after="2019-09-28"
- :acrn-commit:`e0d14b70` - Doc: Grammatical edits to the 1.4 Release Notes.
- :acrn-commit:`d8bd5088` - doc: Release notes v1.4
- :acrn-commit:`90a61134` - Doc: Grammatical edits to the Advisory doc.
- :acrn-commit:`c6bccd5c` - doc: Add Advisory notes
- :acrn-commit:`94394ae9` - Doc: Grammatical edits to the Enable S5 Guide.
- :acrn-commit:`b16e5987` - doc: enable s5 guide
- :acrn-commit:`d473cafe` - dm: Add licenses to the scripts.
- :acrn-commit:`79294b39` - Doc: Final edits for the HLD-Security doc.
- :acrn-commit:`865d1a22` - doc: add hld-security guest secure boot description
- :acrn-commit:`a4713fce` - doc: add copyright/license header to doc scripts
- :acrn-commit:`04767070` - Doc: Final edits to the HV Hypercall doc.
- :acrn-commit:`dcfa7587` - Doc: Final edits to the CPU Virt doc
- :acrn-commit:`ce46f35d` - doc: review edits for rt_industry doc
- :acrn-commit:`3298891f` - Doc: Final edits to the HLD Overview doc.
- :acrn-commit:`a74a7551` - Doc: Final edits to Memory Mangt HLD doc.
- :acrn-commit:`1c3f16f5` - doc: review edit for enable_laag_secure_boot
- :acrn-commit:`ae126bd5` - doc: review edits for acrn_configuration_tool
- :acrn-commit:`9687d72e` - doc: add cores and threads for CPU of supported hardware
- :acrn-commit:`2d0739bf` - doc: fix error in building_from_source doc
- :acrn-commit:`3b977eef` - doc: clean up the docs in try using acrn table.
- :acrn-commit:`2a3178aa` - doc: Update Using Windows as Guest VM on ACRN
- :acrn-commit:`9bd274ae` - doc:modify ubuntu build on 18.04
- :acrn-commit:`7d818c82` - doc: Stop using kconfig to make a customized efi.
- :acrn-commit:`67c64522` - dm: fix memory free issue for xhci
- :acrn-commit:`3fb1021d` - Doc: Minor grammatical edits on various files.
- :acrn-commit:`72f71192` - doc: fix doc build errors previously masked
- :acrn-commit:`2a6f2fa8` - hv: update virtual interrupts HLD
- :acrn-commit:`3314857a` - Doc: update conf.py file to include v1.4
- :acrn-commit:`b20a67f8` - doc: clean up waag-secure-boot doc
- :acrn-commit:`9d01d8ad` - doc: instruction of enabling the laag secure boot
- :acrn-commit:`af61b486` - doc: update timer hld
- :acrn-commit:`ea601e42` - doc: update memory management hld
- :acrn-commit:`c8abc7cb` - Added entry for waag-secure-boot tutorial (added in #3883)
- :acrn-commit:`f34f87fa` - doc:update acrn_configuration_tool
- :acrn-commit:`0e652546` - doc: add waag secure boot enabling
- :acrn-commit:`0d2cdd95` - Clean up language in the acrn_quick_setup script.
- :acrn-commit:`cc61ae7c` - doc: schedule_vcpu was removed
- :acrn-commit:`fbc54a18` - doc: Remove apl gsg and merge contents into rt gsg
- :acrn-commit:`f7651009` - doc: remove redundant copy of ovmf.fd firmware
- :acrn-commit:`67d4a38f` - doc: remove the guest cpu number option '-c' from the document
- :acrn-commit:`fe73b2df` - doc: OVMF high level description
- :acrn-commit:`625a6aab` - Doc: Update system power management doc
- :acrn-commit:`383d53b4` - doc: Update hv power management doc
- :acrn-commit:`4586acd4` - document: update HLD for hypervisor overview
- :acrn-commit:`5583c864` - document: update HLD for cpu virtualization
- :acrn-commit:`2077d79d` - doc: fix remaining masked doc build errors
- :acrn-commit:`f3f638fa` - doc: doc build errors not being reported
- :acrn-commit:`9e34a3fd` - Doc: remove broken links in RNs.
- :acrn-commit:`97a0464a` - doc: fix broken include paths
- :acrn-commit:`1a277f75` - doc: fix vuart-virt-hld errors
- :acrn-commit:`bbc228e6` - doc: Add industry argument for auto setup script
- :acrn-commit:`fd821d55` - doc: add atkbdc emulation doc
- :acrn-commit:`6513db40` - doc: add HLD for CAT
- :acrn-commit:`b6007d05` - document: update HLD for hypervisor startup
- :acrn-commit:`93c45f1a` - Doc: update physical interrupt HLD
- :acrn-commit:`f3f48c3b` - doc: add system timer virtualization
- :acrn-commit:`924f4007` - doc: Adding a section for ACRN requirements on a processor
- :acrn-commit:`586a947d` - doc: add hostbridge emulation doc
- :acrn-commit:`2e2c3db5` - doc: add RTC emulation in hypervisor doc
- :acrn-commit:`b5491474` - doc: add virtio-gpio doc
- :acrn-commit:`5466c8e4` - Doc: remove tutorials/rt_linux.rst file
- :acrn-commit:`d0e1f05e` - doc: Align the updates of rt gsg with 1.3
- :acrn-commit:`b4a4d46c` - doc: add entry for passthru realization
- :acrn-commit:`e85ff56c` - doc: modify virtio-i2c doc path
- :acrn-commit:`abfe3e40` - doc: add UART emulation in hypervisor doc
- :acrn-commit:`9493fcdf` - doc: add ahci virtualization introduction
- :acrn-commit:`2cfcb62d` - document: update HLD for vm management
- :acrn-commit:`b92cb4cb` - acrn-config: chose ttyS1 for vuart1
- :acrn-commit:`95a9f6d9` - hv: update the flow to get trampoline buffer in direct boot mode
- :acrn-commit:`c09723bd` - hv[v3]: hide AP trampoline code from service VM
- :acrn-commit:`04f07535` - hv:refine modify_or_del_pte/pde/pdpte()function
- :acrn-commit:`3f3a51ba` - Revert "Makefile: add default defconfig for new board"
- :acrn-commit:`99e2d6bc` - Revert "OVMF release v1.4"
- :acrn-commit:`c1225050` - acrn-config: add 'xhci' usb mediator for laag and waag
- :acrn-commit:`c0e1a5d7` - acrn-config: add serial config in new $(board).config
- :acrn-commit:`9ddf2766` - Makefile: add default defconfig for new board
- :acrn-commit:`382af0b1` - acrn-config: refine mem_size_set function
- :acrn-commit:`1818dfd9` - acrn-config: refine interrupt_storm function
- :acrn-commit:`958830fb` - acrn-config: add support to generate launch script
- :acrn-commit:`70a405b8` - acrn-config: remove runC script from unnecessary launch script
- :acrn-commit:`2e647844` - acrn-config: add config files for whl-ipc-i7 board
- :acrn-commit:`7587ccba` - acrn-config: add config files for whl-ipc-i5 board
- :acrn-commit:`084bf6e1` - acrn-config: remove parser for console
- :acrn-commit:`a503fdce` - HV: Fix poweroff issue of hard RTVM
- :acrn-commit:`5ca26d3b` - Modify KBL-NUC/SDC for default build remove acrn.efi and modify KBL-NUC/SDC for default build Tracked-On: #3953 Signed-off-by: wenlingz <wenling.zhang@intel.com>
- :acrn-commit:`c94b1fcd` - acrn-config: 'keep_gsi' flag set for Android vm
- :acrn-commit:`96f4d511` - acrn-config: Remove virtio-blk for PREEMPT-RT LINUX
- :acrn-commit:`cc7a85ae` - acrn-config: modify vxworks uos id for industry launch config
- :acrn-commit:`39f300a5` - acrn-config: parse rootfs_img and refine virtio-blk
- :acrn-commit:`5f5f3dfd` - acrn-config: modify board name to uos name
- :acrn-commit:`5cbc97ba` - acrn-config: add mem_size for launch vm
- :acrn-commit:`79fb22de` - acrn-config: add the '"' character for launch script
- :acrn-commit:`d5c3523d` - hv: Update industry scenarios configuration
- :acrn-commit:`6f7081f6` - acrn-config: remove vm3 for industry scenario
- :acrn-commit:`9143e563` - dm: update ACPI with latest ASL standard
- :acrn-commit:`5f8e7a6c` - hv: sched: add kick_thread to support notification
- :acrn-commit:`810305be` - hv: sched: disable interrupt when grab schedule spinlock
- :acrn-commit:`15c6a3e3` - hv: sched: remove do_switch
- :acrn-commit:`f04c4912` - hv: sched: decouple scheduler from schedule framework
- :acrn-commit:`cad195c0` - hv: sched: add pcpu_id in sched_control
- :acrn-commit:`84e5a8e8` - OVMF release v1.4
- :acrn-commit:`feba8369` - acrn-config: refine ttyS info of board file
- :acrn-commit:`b6a80520` - acrn-config: filter out the proper wifi/ethernet device
- :acrn-commit:`defeb851` - acrn-config: fix the issue no error message in launch setting
- :acrn-commit:`d9f0d8dc` - acrn-config: fix the wrong 'key' type returned to webUI
- :acrn-commit:`e7134585` - makefile: add dash support to build efi
- :acrn-commit:`9ea7a85c` - acrn-config: set default package value for _S3 and _S5
- :acrn-commit:`24d3eaba` - acrn-config: skip git environment check when not do git commit
- :acrn-commit:`fbd8597f` - acrn-config: refine 'lpc' setting with console type
- :acrn-commit:`2e62ad95` - hv[v2]: remove registration of default port IO and MMIO handlers
- :acrn-commit:`73b8c91e` - Misc: lifemngr-daemon-on-UOS for windows
- :acrn-commit:`82a0d39e` - hv:fix reference to uninitialized variable in vmsi_remap()
- :acrn-commit:`1c7bf9fd` - acrn-config: refine the vbootloader of vm
- :acrn-commit:`a7162359` - acrn-config: add '--windows' option for WaaG vm
- :acrn-commit:`343aabca` - doc:Update hypercall and upcall
- :acrn-commit:`6f9367a5` - Doc: Add ART virtualization hld
- :acrn-commit:`b3142e16` - doc: update hld-security verified boot section
- :acrn-commit:`edffde4e` - doc: update MSR virtualization in HLD
- :acrn-commit:`227ee64b` - doc: update IO/MMIO HLD
- :acrn-commit:`d541ee90` - doc: update CR HLD
- :acrn-commit:`050c0880` - doc: update CPUID HLD
- :acrn-commit:`d81872ba` - hv:Change the function parameter for init_ept_mem_ops
- :acrn-commit:`0f70a5ca` - hv: sched: decouple idle stuff from schedule module
- :acrn-commit:`27163df9` - hv: sched: add sleep/wake for thread object
- :acrn-commit:`9b8c6e6a` - hv: sched: add status for thread_object
- :acrn-commit:`fafd5cf0` - hv: sched: move schedule initialization to each pcpu init
- :acrn-commit:`dadcdcef` - hv: sched: support vcpu context switch on one pcpu
- :acrn-commit:`7e66c0d4` - hv: sched: use get_running_vcpu to replace per_cpu vcpu with cpu sharing
- :acrn-commit:`891e4645` - hv: sched: move pcpu_id from acrn_vcpu to thread_object
- :acrn-commit:`f85106d1` - hv: Do not reset vcpu thread's stack when reset_vcpu
- :acrn-commit:`3072b6fc` - Doc: Grammar add for config tool doc
- :acrn-commit:`6f5dd2da` - doc: acrn_configuration_tool add one more scenario xml element description
- :acrn-commit:`1d194ede` - hv: support reference time enlightenment
- :acrn-commit:`048155d3` - hv: support minimum set of TLFS
- :acrn-commit:`009d835b` - acrn-config: modify board info of block device info
- :acrn-commit:`96dede43` - acrn-config: modify ipu/ipu_i2c device launch config of apl-up2
- :acrn-commit:`001c929d` - acrn-config: correct launch config info for audio/wifi device of apl-mrb
- :acrn-commit:`2a647fa1` - acrn-config: define vm name for Preempt-RT Linux in launch script
- :acrn-commit:`a2430f13` - acrn-config: refine board name with undline_name api
- :acrn-commit:`95b9ba36` - acrn-config: acrn-config: add white list to skip item check
- :acrn-commit:`fc40ee4c` - vm-manager: fix improper return value check for "strtol()"
- :acrn-commit:`9c67d9b9` - grammar edits for the hld security document
- :acrn-commit:`15e8130f` - doc: hld-security hypervisor enhancement section update
- :acrn-commit:`27272634` - doc: hld-security memory management enhancement update
- :acrn-commit:`81a76662` - doc: hld-security introduction update
- :acrn-commit:`38d70690` - doc: add description for usb-virt-hld
- :acrn-commit:`8a2a56e8` - Doc: Update hld-trace-log.rst
- :acrn-commit:`96b4a6db` - acrn-config: add 'boot_audio_option' while auido/audio_codec set
- :acrn-commit:`1326eec4` - acrn-config: refine the tools for audio/audio_codec
- :acrn-commit:`950e3aa2` - acrn-config: refine parameters for media_pt function
- :acrn-commit:`292d1a15` - hv:Wrap some APIs related with guest pm
- :acrn-commit:`988c1e48` - doc: Align CL version for RT GSG and NUC GSG
- :acrn-commit:`e7ef57a9` - dm: fix mutex lock issue in tpm_rbc.c
- :acrn-commit:`73ac285e` - acrn-config: add 'run_container' back to the launch script
- :acrn-commit:`55e4f0af` - acrn-config: remove '-V' option from launch config
- :acrn-commit:`aee3bc36` - acrn-config: enable item check for launch config tool
- :acrn-commit:`98dc755e` - dm: NVME bdf info update on KBLNUC7i7DNH
- :acrn-commit:`712dfa95` - minor content edits to virtio-rnd doc
- :acrn-commit:`89ec29e1` - doc: merge random device doc to virtio-rnd doc
- :acrn-commit:`f2fb227b` - doc: detail change for hld-devicemodel
- :acrn-commit:`d204fdee` - doc: add 'rsync' to the ACRN builder container
- :acrn-commit:`d8deaa4b` - dm: close filepointer before exiting acrn_load_elf()
- :acrn-commit:`b5f77c07` - doc: add socket console backend for virtio-console
- :acrn-commit:`d3ac30c6` - hv: modify SOS i915 plane setting for hybrid scenario
- :acrn-commit:`c74a197c` - acrn-config: modify SOS i915 plane setting for hybrid xmls
- :acrn-commit:`e1a2ed17` - hv: fix a bug that tpr threshold is not updated
- :acrn-commit:`afb3608b` - acrn-config: add confirmation for commit of generated source in config app
- :acrn-commit:`8eaee3b0` - acrn-config: add "enable_commit" parameter for config tool
- :acrn-commit:`780a53a1` - tools: acrn-crashlog: refine crash complete code
- :acrn-commit:`43b2327e` - dm: validation for input to public functions
- :acrn-commit:`477f8331` - dm: modify DIR handler reference position
- :acrn-commit:`de157ab9` - hv: sched: remove runqueue from current schedule logic
- :acrn-commit:`837e4d87` - hv: sched: rename schedule related structs and vars
- :acrn-commit:`89f53a40` - acrn-config: supply optional passthrough device for vm
- :acrn-commit:`82609463` - doc: Clear Linux "ACRN builder" container image
- :acrn-commit:`44d2a56b` - doc: fix missing words issue in acrn configuration tool doc
- :acrn-commit:`d19592a3` - hv: vmsr: disable prmrr related msrs in vm
- :acrn-commit:`de0a5a48` - hv:remove some unnecessary includes
- :acrn-commit:`72232daa` - dm: reduce potential crash caused by LIST_FOREACH
- :acrn-commit:`e6e0e277` - dm: refine the check of return value of snprintf
- :acrn-commit:`44c11ce6` - acrn-config: fix the issue some select boxes disappear after edited
- :acrn-commit:`c7ecdf47` - Corrected number issue in GSG for ACRN Ind Scenario file
- :acrn-commit:`051a8e4a` - doc: update Oracle driver install
- :acrn-commit:`b73b0fc2` - doc: ioc: remove two unused parts
- :acrn-commit:`6f7ba36e` - doc: move the "Building ACRN in Docker" user guide
- :acrn-commit:`1794d994` - doc: update doc generation tooling to only work within the $BUILDDIR
- :acrn-commit:`0dac373d` - hv: vpci: remove pci_msi_cap in pci_pdev
- :acrn-commit:`b1e43b44` - hv: fix error debug message in hcall_set_callback_vector
- :acrn-commit:`62ed91d3` - acrn-config: update vcpu affinity in web UI
- :acrn-commit:`c442f3f4` - acrn-config: keep align with vcpu_affinity for vm config
- :acrn-commit:`db909edd` - acrn-config: refine the data type for member of class
- :acrn-commit:`ee66a94c` - acrn-config: grab Processor CPU number from board information
- :acrn-commit:`fcbf9d7b` - makefile: fix efi stub install issue
- :acrn-commit:`c3eb0d7f` - dm: switch to launch RT_LaaG with OVMF by default
- :acrn-commit:`8c9c8876` - hv: vpci: remove PC-Card type support
- :acrn-commit:`a4d562da` - dm: Add Oracle subsystem vendor ID
- :acrn-commit:`bb1a8eea` - acrn-config: fix pci sub class name contain "-" and ' '
- :acrn-commit:`43410fd0` - Makefile: Add new build target for apl-up2/uefi/hybrid
- :acrn-commit:`d0489ef3` - Makefile: Add acrn build/install functions
- :acrn-commit:`df5ef925` - Misc: life_mngr clear compile warning
- :acrn-commit:`91366b87` - Misc: lifemngr add Makefile
- :acrn-commit:`28b50463` - hv: vm: properly reset pCPUs with LAPIC PT enabled during VM shutdown/reset
- :acrn-commit:`0906b25c` - Makefile: build default acrn.efi with nuc6cayh
- :acrn-commit:`64742be8` - doc: fix broken link in release notes 1.3
- :acrn-commit:`9b1caeef` - version: 1.4-unstable

274
doc/release_notes/release_notes_1.5.rst
View File

@ -1,274 +0,0 @@
.. _release_notes_1.5:
ACRN v1.5 (Jan 2020)
####################
We are pleased to announce the release of ACRN version 1.5.
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. Check out the :ref:`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 either download this source code as
a zip or tar.gz file (see the `ACRN v1.5 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v1.5>`_)
or use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v1.5
The project's online technical documentation is also tagged to correspond
with a specific release: generated v1.5 documents can be found at https://projectacrn.github.io/1.5/.
Documentation for the latest (master) branch is found at https://projectacrn.github.io/latest/.
ACRN v1.5 requires Clear Linux* OS version 32030.
Version 1.5 Major Features
**************************
What's New in v1.5
==================
* Basic CPU sharing: Fairness Round-Robin CPU Scheduling has been added to support basic CPU sharing (the Service VM and WaaG share one CPU core).
* 8th Gen Intel® Core™ Processors (code name Whiskey Lake) are now supported and validated.
* Overall stability and performance has been improved.
* An offline configuration tool has been created to help developers port ACRN to different hardware boards.
Document Updates
================
Many new `reference documents <https://projectacrn.github.io>`_ are available, including:
* :ref:`run-kata-containers`
* :ref:`hardware` (Addition of Whiskey Lake information)
* :ref:`cpu_sharing`
* :ref:`using_windows_as_uos` (Update to use ACRNGT GOP to install Windows)
Fixed Issues Details
********************
- :acrn-issue:`3630` - Clean up the code on drm/i915/gvt.
- :acrn-issue:`3723` - CODEOWNERS folder names are incorrect.
- :acrn-issue:`3777` - Tutorial "Using partition mode on UP2" no longer valid.
- :acrn-issue:`3779` - Modify the Make file.
- :acrn-issue:`3795` - fix a bug that tpr threshold is not updated
- :acrn-issue:`3830` - [KBLNUC][WaaG] bring back non-context register save/restore
- :acrn-issue:`3903` - Local variable 'info' maybe referenced before initializing in 'vmsi_remap()'
- :acrn-issue:`3904` - remove registration of default port IO and MMIO handlers
- :acrn-issue:`3930` - [APL][acrn-configuration-tool][AaaG]Generate unnecessary runc_container code for apl-mrb/apl-up2 with Scenario:SDC + Launch Setting:sdc_launch_1uos_aaag
- :acrn-issue:`3931` - [APL][acrn-configuration-tool][LaaG]Generated Launch script is incorrect, UOS's rootfs_img should be clearlinux.img|android.img for apl-mrb/apl-up2 with Scenario:SDC
- :acrn-issue:`3953` - Modify efi of default build.
- :acrn-issue:`3955` - [KBL][acrn-configuration-tool]'virtio-blk' was generated in launch script of Preempt-RT, should remove it
- :acrn-issue:`3956` - [KBL][acrn-configuration-tool]'keep_gsi' should set along with android vm
- :acrn-issue:`3960` - [Community][External]UP2 Setup - "ACRN HVLog: not running under acrn hypervisor!"
- :acrn-issue:`3968` - Modify efi of default build.
- :acrn-issue:`3972` - doc: no need to copy OVMF.fd to local folder while preparing the User VMs
- :acrn-issue:`3979` - [KBLNUC][WaaG][GVT]The boot uos script will display the sos information on the uos screen for about 2s.
- :acrn-issue:`3980` - [Community][External]invalid ovmf param ./OVMF.fd BOARD=nuc7i7dnb.
- :acrn-issue:`3984` - [Community][External]Fedora 30 as User OS.
- :acrn-issue:`3987` - No bounds specified for array platform_clos_array .
- :acrn-issue:`3993` - trampoline code in hypervisor potentially be accessible to service VM
- :acrn-issue:`4005` - [WHL][Function][WaaG]Fail to create WaaG image using ISO only on WHL
- :acrn-issue:`4007` - V1.3 E2E release binary failed to boot up on KBL NUC with 32G memory.
- :acrn-issue:`4010` - [Community][External]Booting in blind mode
- :acrn-issue:`4012` - Error formatting flag for hypcall_id
- :acrn-issue:`4020` - Refine print string format for 'uint64_t' type value in hypervisor
- :acrn-issue:`4043` - [WHL][Function][WaaG]windows guest can not get normal IP after passthru Ethernet
- :acrn-issue:`4045` - [WHL][Function][WaaG]Adding USB mediator in launch script, it takes a long time to start windows, about 13 minutes.
- :acrn-issue:`4049` - [SIT][ISD] [AUTO] only 2 can work in"-s n,passthru,02/00/0 \", other numbers rtvm can not launch
- :acrn-issue:`4061` - Some scripts are missing license and copyright header
- :acrn-issue:`4066` - [UP2][KBL]][acrn-configuration-tool] head file was not included in board.c
- :acrn-issue:`4073` - [APL-MRB][acrn-configuration-tool] alloc vuar1 irq when pttyS1 not exist only
- :acrn-issue:`4074` - [KBL][acrn-configuration-tool]: Cx desc parsing enhancement
- :acrn-issue:`4082` - [acrn-configuration-tool]bypass acpi_idle/acpi_cpufreq driver
- :acrn-issue:`4094` - Error parameter for intel_pstate in launch_hard_rt_vm.sh
- :acrn-issue:`4099` -[Community][External]Boot issue on non Apollo/Kaby lake.
- :acrn-issue:`4116` - [Community][External]How to set CPU Core UOS
- :acrn-issue:`4123` - [Community][External]Creating Ubuntu SOS not working - black screen
- :acrn-issue:`4125` - [Community][External]vm1 is running, can't create twice!
- :acrn-issue:`4128` - [WHL][acrn-configuration-tool]WebUI can not select vuart 0&vuart 1 by default
- :acrn-issue:`4135` - [Community][External]Invalid guest vCPUs (0) Ubuntu as SOS.
- :acrn-issue:`4139` - [Community][External]mngr_client_new: Failed to accept from fd 38
- :acrn-issue:`4143` - [acrn-configuration-tool] bus of DRHD scope devices is parsed incorrectly
- :acrn-issue:`4163` - [acrn-configuration-tool] not support: -s n,virtio-input
- :acrn-issue:`4164` - [acrn-configuration-tool] not support: -s n,xhci,1-1:1-2:2-1:2-2
- :acrn-issue:`4165` -[WHL][acrn-configuration-tool]Configure epc_section is incorrect
- :acrn-issue:`4172` - [acrn-configuration-tool] not support: -s n,virtio-blk, (/root/part.img---dd if=/dev/zero of=/root/part.img bs=1M count=10 all/part of img, one u-disk device, u-disk as rootfs and the n is special)
- :acrn-issue:`4173` - [acrn-configuration-tool]acrn-config tool not support parse default pci mmcfg base
- :acrn-issue:`4175` - acrntrace fixes and improvement
- :acrn-issue:`4185` - [acrn-configuration-tool] not support: -s n,virtio-net, (not set,error net, set 1 net, set multi-net, vhost net)
- :acrn-issue:`4211` - [kbl nuc] acrn failed to boot when generate hypervisor config source from config app with HT enabled in BIOS
- :acrn-issue:`4212` - [KBL][acrn-configuration-tool][WaaG+RTVM]Need support pm_channel&pm_by_vuart setting for Board:nuc7i7dnb+WaaG&RTVM
- :acrn-issue:`4227` - [ISD][Stability][WaaG][Regression] "Passmark8.0-Graphics3D-DirectX9Complex" test failed on WaaG due to driver error
- :acrn-issue:`4228` - [acrn-configuration-tool] cannot boot hypervisor on customer board with KBL 7300U
- :acrn-issue:`4229` - Add range check in Kconfig.
- :acrn-issue:`4230` - Remove MAX_VCPUS_PER_VM in Kconfig
- :acrn-issue:`4232` - Set default KATA_VM_NUM to 1 for SDC
- :acrn-issue:`4247` - [acrn-configuration-tool] Generate Scenario for VM0 communities with VM1 is incorrect.
- :acrn-issue:`4249` - [acrn-configuration-tool]Generated Launchscript but WebUI prompt error msg after we just select passthru-devices:audio_codec
- :acrn-issue:`4255` - [acrn-configuration-tool][nuc7i7dnb][sdc]uos has no ip address
- :acrn-issue:`4260` - [Community][External]webcam switch between 2 UOS.
- :acrn-issue:`4286` - [acrn-configuration-tool] Remove VM1.vcpu_affinity.pcuid=3 for VM1 in sdc scenario
Known Issues
************
- :acrn-issue:`4047` - passthru usb, when WaaG boot at "windows boot manager" menu, the usb keyboard does not work
- :acrn-issue:`4316` - [KataContainers]LaaG miss ip address when we create kata_container first with macvtap driver
- :acrn-issue:`4317` - [WHL][Function][WaaG]Mediator usb earphone, play audio will incontinuous and not clearly
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v1.4
release in Nov 2019 (click on the CommitID link to view details):
.. comment
This list is obtained from this git command (update the date to pick up
changes since the last release):
git log --pretty=format:'- :acrn-commit:`%h` - %s' --after="2020-01-02"
- :acrn-commit:`ee74737f` - HV: search rsdp from e820 acpi reclaim region
- :acrn-commit:`578a7ab4` - acrn-config: remove pcpu3 from vm1 in SDC scenario
- :acrn-commit:`7d27c4bc` - hv: vpci: restore PCI BARs when doing AF FLR
- :acrn-commit:`bb06f6f9` - hv: vpci: restore PCI BARs when doing PCIe FLR
- :acrn-commit:`92ed8601` - hv: hotfix for xsave
- :acrn-commit:`067d8536` - OVMF release v1.5
- :acrn-commit:`9b71c5cd` - acrn-config: add 'logger_setting' into launch script
- :acrn-commit:`be6c6851` - acrn-config: refine mount device for virtio-blk
- :acrn-commit:`686d7763` - HV: Remove INIT signal notification related code
- :acrn-commit:`d7eb14c5` - HV: Use NMI to replace INIT signal for lapic-pt VMs S5
- :acrn-commit:`29b7aff5` - HV: Use NMI-window exiting to address req missing issue
- :acrn-commit:`d26d8bec` - HV: Don't make NMI injection req when notifying vCPU
- :acrn-commit:`24c2c0ec` - HV: Use NMI to kick lapic-pt vCPU's thread
- :acrn-commit:`23422713` - acrn-config: add `tap\_` prefix for virtio-net
- :acrn-commit:`6383394b` - acrn-config: enable log_setting in all vm
- :acrn-commit:`0b44d64d` - acrn-config: check pass-through device for audio/audio_codec
- :acrn-commit:`75ca1694` - acrn-config: correct vuart1 setting in scenario config
- :acrn-commit:`d52b45c1` - hv:fix crash issue when handling HC_NOTIFY_REQUEST_FINISH
- :acrn-commit:`78139b95` - HV: kconfig: add range check for memory setting
- :acrn-commit:`24994703` - HV: Kconfig: set default Kata num to 1 in SDC
- :acrn-commit:`9d5e72e9` - hv: add lock for ept add/modify/del
- :acrn-commit:`98b3dd94` - acrn-config: set HV_RAM_START above 256M for new board
- :acrn-commit:`46463900` - acrn-config: add 'ramdisk_mod' item tag for tgl-rvp
- :acrn-commit:`13d6b69d` - acrn-config: set DRHDx_IGNORE while no DEV_SCOPE in DRHD
- :acrn-commit:`12a9bc29` - acrn-config: add CONFIG_SERIAL_x for new board
- :acrn-commit:`d699347e` - acrn-config: change gvt_args from selectbox to editbox
- :acrn-commit:`05682b2b` - hv:bugfix in write protect page hypercall
- :acrn-commit:`1636ac04` - acrn-config: Add non-contiguous HPA to currently supported hardware.
- :acrn-commit:`2777f230` - HV: Add helper function send_single_nmi
- :acrn-commit:`525d4d3c` - HV: Install a NMI handler in acrn IDT
- :acrn-commit:`fb346a6c` - HV: refine excp/external_interrupt_save_frame and excp_rsvd
- :acrn-commit:`7f964654` - hv:remove need_cleanup flag in create_vm
- :acrn-commit:`67ec1b77` - HV: expose port 0x64 read for SOS VM
- :acrn-commit:`a44c1c90` - HV: Kconfig: remove MAX_VCPUS_PER_VM in Kconfig
- :acrn-commit:`0ba84348` - acrn-config: rename CONFIG_MAX_PCPU_NUM to MAX_PCPU_NUM
- :acrn-commit:`ea3476d2` - HV: rename CONFIG_MAX_PCPU_NUM to MAX_PCPU_NUM
- :acrn-commit:`67b416d5` - acrn-config: hide non-legacy serial port as SOS console
- :acrn-commit:`deb5ed1f` - acrn-config: unify get_vuart_info_id api in config tool
- :acrn-commit:`212d030b` - acrn-config: add 'poweroff_channel' support for launch config
- :acrn-commit:`7446d41f` - acrn-config: modify 'poweroff_channel' info in launch xmls
- :acrn-commit:`0f19f878` - acrn-config: add 'virtio-console' info in launch xmls
- :acrn-commit:`bad3c53c` - acrn-config: add 'virtio-console' mediator support for launch config
- :acrn-commit:`b6bffd01` - hv:remove 2 unused variables in vm_arch structure
- :acrn-commit:`422a051c` - Makefile: Build Release version by default
- :acrn-commit:`e95b316d` - hv: vtd: fix improper use of DMAR_GCMD_REG
- :acrn-commit:`68ea2cc6` - acrn-config: Fix ve820 table generation when guest memory size is >512MB
- :acrn-commit:`f2bf3d3e` - dm:gvt:update bus0 memlimit32 value
- :acrn-commit:`acb5affd` - doc:update acrn-shell.rst
- :acrn-commit:`413f098b` - Doc: Add libnuma dependency for acrntrace
- :acrn-commit:`a90f4a0a` - Makefile: print config summary at the end
- :acrn-commit:`9729fe07` - acrn-config: support non-contiguous HPA for hybrid scenario
- :acrn-commit:`c8a4ca6c` - HV: Extend non-contiguous HPA for hybrid scenario
- :acrn-commit:`b32ae229` - hv: sched: use hypervisor configuration to choose scheduler
- :acrn-commit:`6a144e6e` - hv: sched: add yield support
- :acrn-commit:`6554437c` - hv: sched_iorr: add some interfaces implementation of sched_iorr
- :acrn-commit:`b39630a8` - hv: sched_iorr: add tick handler and runqueue operations
- :acrn-commit:`f44aa4e4` - hv: sched_iorr: add init functions of sched_iorr
- :acrn-commit:`ed400863` - hv: sched_iorr: Add IO sensitive Round-robin scheduler
- :acrn-commit:`3c8d465a` - acrnboot: correct the calculation of the end boundary of _DYNAMIC region
- :acrn-commit:`0bf03b41` - acrntrace: Set FLAG_CLEAR_BUF by default
- :acrn-commit:`9e9e1f61` - acrntrace: Add opt to specify the cpus where we should capture the data
- :acrn-commit:`366f4be4` - acrntrace: Use correct format for total run time
- :acrn-commit:`1e192f05` - acrntrace: break when finding the matching key
- :acrn-commit:`9655b9de` - acrntrace: Fix the incorrect total vmexit cnt issue
- :acrn-commit:`1115c0c6` - acrn-config: UI supports to edit multiple virtio input devices.
- :acrn-commit:`557e7f19` - Makefile: add gcc flags to prevent some optimization
- :acrn-commit:`c2c05a29` - hv: vlapic: kick targeted vCPU off if interrupt trigger mode has changed
- :acrn-commit:`ed65ae61` - HV: Kconfig changes to support server platform.
- :acrn-commit:`706dbc0e` - acrn-config: support non-contiguous HPA for pre-launched VM
- :acrn-commit:`6e8b4136` - HV: Add support to assign non-contiguous HPA regions for pre-launched VM
- :acrn-commit:`9b44e57d` - acrn-config: Fix target xml generation issue when no P-state scaling driver is present
- :acrn-commit:`03a1b2a7` - hypervisor: handle reboot from non-privileged pre-launched guests
- :acrn-commit:`26801210` - Makefile: fix make failure for logical_partition or hybrid scenario
- :acrn-commit:`65a55320` - acrn-config: add xml to support TGL RVP board
- :acrn-commit:`1fe1afd4` - acrn-config: Add ramdisk tag parsing support
- :acrn-commit:`2b9fa856` - acrn-config: Add ramdisk tag to supported board/scenario xmls
- :acrn-commit:`da3ba68c` - hv: remove corner case in ptirq_prepare_msix_remap
- :acrn-commit:`c05d9f80` - hv: vmsix: refine vmsix remap
- :acrn-commit:`5f5ba1d6` - hv: vmsi: refine write_vmsi_cfg implementation
- :acrn-commit:`2f642002` - dm:gvt:enable gvt bar registration
- :acrn-commit:`89908bf5` - dm:gvt:update gvt bars before other pci devices write bar address
- :acrn-commit:`f27d4754` - dm:gvt:adjust pci bar region with reserved bar regions
- :acrn-commit:`1ac0b57c` - dm:gvt:reserve gvt bar regions in ACRN-DM
- :acrn-commit:`72644ac2` - hv: do not sleep a non-RUNNING vcpu
- :acrn-commit:`d624eb5e` - hv: io: do schedule in IO completion polling loop
- :acrn-commit:`d48da2af` - hv: bugfix for debug commands with smp_call
- :acrn-commit:`47139bd7` - hv: print current sched_object in acrn logmsg
- :acrn-commit:`5eb80402` - acrn-config: update UI to support virtio devices
- :acrn-commit:`5309e415` - acrn-config: modify the description of usb xhci
- :acrn-commit:`7838b537` - acrn-config: add virtio-net mediator support for launch config
- :acrn-commit:`25b2a26e` - acrn-config: add 'virtio-network' info in launch xmls
- :acrn-commit:`8464419a` - acrn-config: add virtio-block support for launch config
- :acrn-commit:`40140281` - acrn-config: add rootfs_dev/rootfs_img with virtio-blk item
- :acrn-commit:`aedd2c70` - acrntrace: parse leaf and subleaf of cpuid
- :acrn-commit:`aae974b4` - HV: trace leaf and subleaf of cpuid
- :acrn-commit:`77039f29` - acrn-config: Extend ve820 generation script for sizes gt 512 MB
- :acrn-commit:`450d2cf2` - hv: trap RDPMC instruction execution from any guest
- :acrn-commit:`3d412266` - hv: ept: build 4KB page mapping in EPT for RTVM for MCE on PSC
- :acrn-commit:`0570993b` - hv: config: add an option to disable mce on psc workaround
- :acrn-commit:`192859ee` - hv: ept: apply MCE on page size change mitigation conditionally
- :acrn-commit:`3cb32bb6` - hv: make init_vmcs as a event of VCPU
- :acrn-commit:`15da33d8` - HV: parse default pci mmcfg base
- :acrn-commit:`80a7281f` - acrn-config: add MMCFG_BASE_INFO item in board config
- :acrn-commit:`0e273e99` - acrn-config: get default pci mmcfg base address
- :acrn-commit:`0d998d6a` - hv: sync physical and virtual TSC_DEADLINE when msr interception enabled/disabled
- :acrn-commit:`97916364` - hv: fix virtual TSC_DEADLINE msr read/write issues
- :acrn-commit:`e6141298` - hv: support xsave in context switch
- :acrn-commit:`8ba203a1` - hv: change xsave init function name
- :acrn-commit:`12a3ec8a` - acrn-config: remove redundant get_leaf_tag_map in launch config lib
- :acrn-commit:`2c2ccfc5` - acrn-config: support OVMF vbootloader only
- :acrn-commit:`38a647c8` - acrn-config: correct epc_section base/size value
- :acrn-commit:`91330eaa` - acrn-config: add usb xhci mediator support for
- :acrn-commit:`420b65a6` - acrn-config: add 'usb_xhci' info to launch xmls
- :acrn-commit:`bc9b6d1b` - acrn-config: add virtio-input support for launch
- :acrn-commit:`9fc32043` - acrn-config: add 'virtio-input' info in launch xmls
- :acrn-commit:`71c51a8f` - acrn-config: refinement for library config
- :acrn-commit:`1e233364` - acrn-config: skip the DRHDn_IGNORE when no device scope
- :acrn-commit:`40929efe` - acrn-config: walk secondary PCI Bus for target board
- :acrn-commit:`5e923420` - acrn-config: refinement for DmarDevScope struct
- :acrn-commit:`f6e6ec4c` - acrn-config: modify SDC config xml to support kata vm config in webUI
- :acrn-commit:`bb2218ef` - acrn-config: add UI to add or remove Kata VM for sdc scenario
- :acrn-commit:`31d023e8` - acrn-config: launch refinement on vcpu affinity and uos image
- :acrn-commit:`d581473c` - acrn-config: refine vcpu affinity/number for SDC scenario
- :acrn-commit:`d44440f7` - acrn-config: print warning if MMIO BAR size above 4G
- :acrn-commit:`dc2d6b66` - acrn-config: modify the git commit message for gen_patch
- :acrn-commit:`2c4ebdc6` - hv: vmsi: name vmsi with verb-object style
- :acrn-commit:`6ee076f7` - hv: assign: rename ptirq_msix_remap to ptirq_prepare_msix_remap
- :acrn-commit:`51a43dab` - hv: add Kconfig parameter to define the Service VM EFI bootloader
- :acrn-commit:`058b03c3` - dm: fix memory free issue for xhci
- :acrn-commit:`422330d4` - HV: reimplement PCI device discovery
- :acrn-commit:`94a456ae` - HV: refactor device_to_dmaru
- :acrn-commit:`34c75a0b` - doc: Add multiple PCI segments as known limitation for hypervisor
- :acrn-commit:`c5a87d41` - HV: Cleanup PCI segment usage from VT-d interfaces
- :acrn-commit:`810169ad` - HV: initialize IOMMU before PCI device discovery
- :acrn-commit:`ea131eea` - HV: add DRHD index to pci_pdev
- :acrn-commit:`0b7bcd64` - HV: extra methods for extracting header fields
- :acrn-commit:`9af4a624` - doc: edit using_ubuntu_as_sos.rst adjust to v1.4
- :acrn-commit:`32b8d99f` - hv:panic if there is no memory map in multiboot info
- :acrn-commit:`bd0dbd27` - hv:add dump_guest_mem
- :acrn-commit:`215bb6ca` - hv:refine dump_host_mem
- :acrn-commit:`4c8dde1b` - hv:remove show_guest_call_trace
- :acrn-commit:`24fa14bc` - Revert "Revert "OVMF release v1.4""
- :acrn-commit:`5b4d676b` - version: 1.5-unstable

237
doc/release_notes/release_notes_1.6.1.rst
View File

@ -1,237 +0,0 @@
.. _release_notes_1.6.1:
ACRN v1.6.1 (May 2020)
######################
We are pleased to announce the release of ACRN version 1.6.1.
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. Check out :ref:`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 either download this source code as
a zip or tar.gz file (see the `ACRN v1.6.1 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v1.6.1>`_)
or use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v1.6.1
The project's online technical documentation is also tagged to correspond
with a specific release: generated v1.6.1 documents can be found at
https://projectacrn.github.io/1.6.1/.
Documentation for the latest (master) branch is found at https://projectacrn.github.io/latest/.
ACRN v1.6.1 requires Clear Linux OS version 33050.
Version 1.6.1 Major Features
****************************
What's New in v1.6.1
====================
* ACRN ensures libvirt supports VM orchestration based on OpenStack
- libvirt is an open-source API, daemon, and management tool as a
layer to decouple orchestrators and hypervisors.
By adding a "ACRN driver", libvirt can support ACRN. Please refer to ACRN-libvirt.
- Supports the libvirt-based orchestrator to configure a guest
domain's CPU configuration during VM creation.
- Supports dynamic configuration for vCPU affinity via acrn-dm
- ACRN configuration tool updated based on VM orchestration support.
* Enable CPU sharing and GVT-d Graphics virtualization by default.
* Supported platforms with multiple IO-APICs
* Supported VT-d Posted Interrupts
Document Updates
================
Many new and updated `reference documents <https://projectacrn.github.io>`_ are available, including:
* :ref:`asa`
* :ref:`setup_openstack_libvirt`
* :ref:`rt_perf_tips_rtvm`
* :ref:`acrn_configuration_tool`
* :ref:`hv-device-passthrough`
* :ref:`cpu_sharing`
* :ref:`getting-started-building`
* Run Clear Linux as the Service VM
* :ref:`using_windows_as_uos`
We recommend that all developers upgrade to ACRN release v1.6.1.
Fixed Issues Details
********************
- :acrn-issue:`1773` - [APLNUC][IO][LaaG]USB Mediator USB3.0 and USB2.0 flash disk boot up UOS, quickly hot plug USB and Can not recognize all the devices
- :acrn-issue:`3291` - Update documentation and helper scripts to use newer `swupd` commands.
- :acrn-issue:`3697` - Secure timer check failed in trusty which would cause unlock failure after resume from S3
- :acrn-issue:`3715` - Add support for multiple RDT resource allocation and fix L3 CAT config overwrite by L2
- :acrn-issue:`3758` - Documentation: add a tutorial (or information) on how to change the Linux kernel parameters for User VMs
- :acrn-issue:`3770` - Warning when building the ACRN hypervisor `SDC (defined at arch/x86/Kconfig:7) set more than once`
- :acrn-issue:`3773` - [Community][Internal] suspicious logic in vhost.c.
- :acrn-issue:`3918` - Change active_hp_work position for code cleaning and add a module parameter to disable hp work.
- :acrn-issue:`3939` - [Community][Internal]zero-copy non-functional with vhost.
- :acrn-issue:`3946` - [Community][External]Cannot boot VxWorks as UOS on KabyLake.
- :acrn-issue:`4017` - hv: rename vuart operations
- :acrn-issue:`4072` - [Community-dev][External]hv: add printf "not support the value of vuart index parameter" in function vuart_register_io_handler.
- :acrn-issue:`4191` - [Community-dev][External]acrnboot: the end address of _DYNAME region is not calculated correct
- :acrn-issue:`4200` - In APCIv advanced mode, a target vCPU (in not-root mode) may get wrong TMR or EOI exit bitmap when another vPCU try to send an interrupt to it if this interrupt trigger mode has changed.
- :acrn-issue:`4250` - [Community-dev][external]acrnboot: parse hv cmdline incorrectly when containing any trailing white-spaces
- :acrn-issue:`4283` - [Community-dev][External]devicemodel: refactor CMD_OPT_LAPIC_PT case branch
- :acrn-issue:`4322` - [ACRN_V1.5][Document] Build cmd error in "Build the ACRN User VM PREEMPT_RT Kernel in Docker" document
- :acrn-issue:`4569` - [acrn-configuration-tool]find 64-bit mmio to generate HI_MMIO_START/HI_MMIO_END
- :acrn-issue:`4620` - [WHL][Function][WaaG] WaaG will fail to reboot with 2 cores.
- :acrn-issue:`4625` - [WHL][ConfigurationTool][WAAG] Need to support passthrough GVT to WaaG by default
- :acrn-issue:`4634` - [acrn-configuration-tool]move new_board_config to board_def config and support to parse it
- :acrn-issue:`4636` - compile crashlog error with latest clearlinux
- :acrn-issue:`4641` - [WHL][acrn-configuration-tool]error "board/scenario xml not match" for created scenario setting
- :acrn-issue:`4664` - Wake up vCPU for interrupts from vPIC
- :acrn-issue:`4666` - Fix offline tool to generate info in pci_dev file for logical partition scenario
- :acrn-issue:`4688` - [WHL][acrn-configuration-tool] RELEASE=n does not take effect while using xml to make hypervisor
- :acrn-issue:`4719` - [WHL][Function][LaaG]Garbage display when shutdown LaaG with CPU sharing GVT-D
- :acrn-issue:`4752` - [WHL][acrn-configuration-tool] console loglevel is not changed if building hypervisor by xml
- :acrn-issue:`4753` - [KBLNUCi7][libvirt][HV] in acrn.efi which enable 4vcpu for laag, with libvirtd.service enabled, SOS kernel panic and reboot
Known Issues
************
- :acrn-issue:`4046` - [WHL][Function][WaaG] Error info popoup when run 3DMARK11 on Waag
- :acrn-issue:`4047` - [WHL][Function][WaaG] passthru usb, Windows will hang when reboot it
- :acrn-issue:`4313` - [WHL][VxWorks] Failed to ping when VxWorks passthru network
- :acrn-issue:`4557` - [WHL][Performance][WaaG] Failed to run 3D directX9 during Passmark9.0 performance test with 7212 gfx driver
- :acrn-issue:`4558` - [WHL][Performance][WaaG] WaaG reboot automatically during run 3D directX12 with 7212 gfx driver
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v1.6
release in Mar 2020 (click the CommitID link to see details):
.. comment
This list is obtained from this git command (update the date to pick up
changes since the last release):
git log --pretty=format:'- :acrn-commit:`%h` - %s' --after="2020-04-02"
- :acrn-commit:`5632dead` - doc: update release_1.6 docs with master docs
- :acrn-commit:`ac5facd2` - doc: update CPU affinity related descriptions
- :acrn-commit:`14366380` - acrn-config: fix log macros for board defconfig
- :acrn-commit:`627dd1c8` - acrn-config: add clearlinux UOS for launch config xmls
- :acrn-commit:`67728c67` - ACRN/DM: Initialize the igd_lpc bridge to ISA_BRIDGE to make Linux guest happy
- :acrn-commit:`71479793` - acrn-config: assign PCPU0~3 to post vm by default
- :acrn-commit:`c390ab01` - hv: don't overwrite the statically configured vm_configs[] in hypercall
- :acrn-commit:`cbaf3e78` - acrn-dm: fix corner cases in acrn_parse_cpu_affinity()
- :acrn-commit:`d661d444` - acrn-config: refine slot assignment for launch config
- :acrn-commit:`eb47f8f5` - acrn-config: refinement for CPU affinity check
- :acrn-commit:`e8d00c2c` - local_gpa2hpa: INVALID_GPA also means failure of address conversion
- :acrn-commit:`440385d5` - ACRN/DM: Reset the passthrough device to fix garbage display issue
- :acrn-commit:`77b7721f` - DM USB: xHCI: Drop commands if the slot is disabled
- :acrn-commit:`16e33b30` - acrn-config: add vm type sanity check
- :acrn-commit:`11959829` - acrn-config: refinement for pci_devs in scenario config xmls
- :acrn-commit:`fb5c35d1` - acrn-config: parse cpu_affinity from launch config xmls
- :acrn-commit:`8cbc6199` - acrn-config: add cpu_affinity for launch config xmls
- :acrn-commit:`b9865fdf` - acrn-dm: change command option name from "pcpu_list" to "cpu_affinity"
- :acrn-commit:`a6ea34bc` - hv: Enable accessed bit in EPT paging
- :acrn-commit:`c72d1936` - acrn-config: update cpu_affinity in scenrio configuration xml files
- :acrn-commit:`cce7389d` - acrn-config: change names for vcpu_affinity[] related items
- :acrn-commit:`45cc2c5e` - acrn-dm: implement cpu_affinity command line argument
- :acrn-commit:`0805eb9a` - hv: dynamically configure CPU affinity through hypercall
- :acrn-commit:`46753944` - hv: replace vcpu_affinity array with cpu_affinity_bitmap
- :acrn-commit:`40ae32f1` - hv: provide vm_config information in get_platform_info hypercall
- :acrn-commit:`42c43993` - hv: some coding refinement in hypercall.c
- :acrn-commit:`c9fa9c73` - hv: move error message logging into gpa copy APIs
- :acrn-commit:`b9a7cf3b` - acrn-config: assign VM IDs for dynamic scenario and launch setting
- :acrn-commit:`bcfbc13f` - acrn-config: add attributes for scenario and launch setting
- :acrn-commit:`3799b95b` - acrn-config: add max VM count check when generating scenario XML file
- :acrn-commit:`1d4b7ab8` - acrn-config: refine template xmls
- :acrn-commit:`ea0c62da` - acrn-config: add 2 UUIDs for post-launched Standard VM
- :acrn-commit:`093b1c48` - acrn-config: add SOS_IDLE for SOS cmdline
- :acrn-commit:`88bed66e` - HV: refine usage of idle=halt in sos cmdline
- :acrn-commit:`510a0931` - Makefile: do not override RELEASE when build with XML
- :acrn-commit:`7410f9d0` - hv: vtd: fix potential dead loop if qi request timeout
- :acrn-commit:`bf917ae2` - acrn-config: Generate info in pci_dev file for Pre-Launched VMs
- :acrn-commit:`b99de16f` - hv: Wake up vCPU for interrupts from vPIC
- :acrn-commit:`75b59165` - acrn-config: remove sdc2 config xmls
- :acrn-commit:`08bcf4be` - acrn-config: refine the HV_RAM_SIZE/HV_RAM_START for board_defconfig
- :acrn-commit:`d7299604` - acrn-config: set HV_RAM_SIZE/HV_RAM_START to blank from config xmls
- :acrn-commit:`5e53ac03` - acrn-config: refine template xmls
- :acrn-commit:`718e7567` - acrn-config: modify epc_section to configurable="0"
- :acrn-commit:`49b3939e` - acrn-config: fix syntax for new logical partition xmls
- :acrn-commit:`fc3b4ed6` - acrn-config: refine GPU vpid format for launch script
- :acrn-commit:`d17076b4` - HV: remove sdc2 scenario support
- :acrn-commit:`7f1c4422` - HV: support up to 7 post launched VMs for industry scenario
- :acrn-commit:`9a23bedd` - crashlog: fix build issue under latest clearlinux
- :acrn-commit:`d742be2c` - HV: Kconfig: enable CPU sharing by default
- :acrn-commit:`4c7ffeea` - acrn-config: add template xmls for dynamic config
- :acrn-commit:`0445c5f8` - acrn-config: dynamic configuration for scenario setting and launch setting
- :acrn-commit:`a12b746a` - acrn-config: remove hard code UUID from config xmls
- :acrn-commit:`86e467f6` - acrn-config: Use vm_type to instead load_type/uuid/severity in config
- :acrn-commit:`85630258` - acrn-config: support to parse pci_devs for pre launched vm
- :acrn-commit:`e0c75652` - acrn-config: add pass-thru PCI device for pre launched vm xmls
- :acrn-commit:`19032398` - acrn-config: remove 'scenario' dependency from acrn config tool
- :acrn-commit:`cc5c6421` - Makefile: disable KCONFIG_FILE when build from xml
- :acrn-commit:`7d173917` - Kconfig: remove MAX_KATA_VM_NUM
- :acrn-commit:`4388099c` - Kconfig: change scenario variable type to string
- :acrn-commit:`28bffa77` - HV: merge sos_pci_dev config to sos macro
- :acrn-commit:`d9c302ba` - HV: init vm uuid and severity in macro
- :acrn-commit:`b08dbd41` - HV: fix wrong gpa start of hpa2 in ve820.c
- :acrn-commit:`60178a9a` - hv: maintain a per-pCPU array of vCPUs and handle posted interrupt IRQs
- :acrn-commit:`a07c3da3` - hv: define posted interrupt IRQs/vectors
- :acrn-commit:`f5f307e9` - hv: enable VT-d PI for ptdev if intr_src->pid_addr is non-zero
- :acrn-commit:`c9dd310e` - hv: check if the IRQ is intended for a single destination vCPU
- :acrn-commit:`198b2576` - hv: add function to check if using posted interrupt is possible for vm
- :acrn-commit:`1bc76991` - hv: extend union dmar_ir_entry to support VT-d posted interrupts
- :acrn-commit:`8be6c878` - hv: pass pointer to functions
- :acrn-commit:`cc5bc34a` - hv: extend struct pi_desc to support VT-d posted interrupts
- :acrn-commit:`b7a126cd` - hv: move pi_desc related code from vlapic.h/vlapic.c to vmx.h/vmx.c/vcpu.h
- :acrn-commit:`8e2efd6e` - hv: rename vlapic_pir_desc to pi_desc
- :acrn-commit:`233577e4` - acrn-config: enable hv config for scenarion setting UI
- :acrn-commit:`c5cd7cae` - acrn-config: add hv configurations to scenario config xmls
- :acrn-commit:`4a98f533` - acrn-config: add support to parse board defconfig from configurations
- :acrn-commit:`d0beb7e9` - acrn-config: support passthroug GVT for WaaG by default
- :acrn-commit:`1bf3163d` - hv: Hypervisor access to PCI devices with 64-bit MMIO BARs
- :acrn-commit:`910d93ba` - hv: Add HI_MMIO_START and HI_MMIO_END macros to board files
- :acrn-commit:`5e8fd758` - acrn-config: round HI_MMIO_START/HI_MMIO_END to the closest 1G
- :acrn-commit:`b9229348` - hv: fix for waag 2 core reboot issue
- :acrn-commit:`45b65b34` - hv: add lock for ept add/modify/del
- :acrn-commit:`bbdf0199` - hv: vpci: refine comment for pci_vdev_update_vbar_base
- :acrn-commit:`dad7fd80` - hv: Fix issues with the patch to reserve EPT 4K pages after boot
- :acrn-commit:`4bdcd33f` - hv: Reserve space for VMs' EPT 4k pages after boot
- :acrn-commit:`963b8cb9` - hv: Server platforms can have more than 8 IO-APICs
- :acrn-commit:`4626c915` - hv: vioapic init for SOS VM on platforms with multiple IO-APICs
- :acrn-commit:`f3cf9365` - hv: Handle holes in GSI i.e. Global System Interrupt for multiple IO-APICs
- :acrn-commit:`ec869214` - hv: Introduce Global System Interrupt (GSI) into INTx Remapping
- :acrn-commit:`b0997e76` - hv: Pass address of vioapic struct to register_mmio_emulation_handler
- :acrn-commit:`9e21c5bd` - hv: Move error checking for hypercall parameters out of assign module
- :acrn-commit:`37eb369f` - hv: Use ptirq_lookup_entry_by_sid to lookup virtual source id in IOAPIC irq entries
- :acrn-commit:`0c9628f6` - acrn-config: remove the same parameters and functions from launch_cfg_lib
- :acrn-commit:`7d827c4d` - acrn-config: remove the same parameters and functions from scenario_cfg_lib
- :acrn-commit:`8e3ede1a` - acrn-config: remove the same parameters and functions from board_cfg_lib
- :acrn-commit:`df4a395c` - acrn-config: expends parameters and functions to common lib
- :acrn-commit:`6bbc5711` - acrn-config: Fixes for BAR remapping logic
- :acrn-commit:`889c0fa4` - acrn-config: update IOMEM_INFO of tgl-rvp board
- :acrn-commit:`bce6a3c4` - Makefile: support make with external configurations
- :acrn-commit:`3774244d` - Makefile: parameters check for board and scenario
- :acrn-commit:`82e93b77` - Makefile: make hypervisor from specified Kconfig
- :acrn-commit:`f8abeb09` - hv: config: enable RDT for apl-up2 by default
- :acrn-commit:`14e7f7a8` - acrn-config: enable CAT for industry scenario on APL-UP2 by default
- :acrn-commit:`02fea0f2` - acrn-config: support generation of per vcpu clos configuraton
- :acrn-commit:`76943866` - HV: CAT: support cache allocation for each vcpu
- :acrn-commit:`d18fd5f8` - acrn-config: find 64-bit mmio for HI_MMIO_START/HI_MMIO_END
- :acrn-commit:`d9d50461` - acrn-config: update IOMEM_INFO of native board config xml
- :acrn-commit:`e7726944` - acrn-config: dump iomem info from /proc/iomem
- :acrn-commit:`8e7b80fc` - acrn-config: Limit check on Pre-Launched VM RAM size
- :acrn-commit:`aa6bb9e2` - acrn-config: support '--out' option for board/scenario/launch config
- :acrn-commit:`05e3ea5f` - acrn-config: correct passthru 'audio' device for nuc6cayh
- :acrn-commit:`c980b360` - acrn-config: minor fix for generating CONFIG_PCI_BDF
- :acrn-commit:`6f8a7ba5` - acrn-config: add some configs in board defconfig
- :acrn-commit:`2eb8e0f7` - acrn-config: remove git check and avoid to generate patch for config files
- :acrn-commit:`48fdeb25` - acrn-config: one button to generate config file
- :acrn-commit:`ab879407` - acrn-config: create temporary scenario file folder if it doesn't exist

397
doc/release_notes/release_notes_1.6.rst
View File

@ -1,397 +0,0 @@
.. _release_notes_1.6:
ACRN v1.6 (Mar 2020)
####################
We are pleased to announce the release of ACRN version 1.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. Check out :ref:`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 either download this source code as
a zip or tar.gz file (see the `ACRN v1.6 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v1.6>`_)
or use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v1.6
The project's online technical documentation is also tagged to correspond
with a specific release: generated v1.6 documents can be found at https://projectacrn.github.io/1.6/.
Documentation for the latest (master) branch is found at https://projectacrn.github.io/latest/.
ACRN v1.6 requires Clear Linux OS version 32680.
Version 1.6 Major Features
**************************
What's New in v1.6
==================
* Graphics passthrough support
- The hypervisor and Service VMs support allowing passthrough graphics devices to target DM-launched guest VMs, based on GVT-d.
* SRIOV support
- The ACRN hypervisor allows an SRIOV-capable PCI device's Physical Function (PF) to be allocated to the Service VM.
- The ACRN hypervisor allows a SRIOV-capable PCI device's Virtual Functions (VFs) to be allocated to any VM.
- The ACRN Service VM supports the SRIOV Ethernet device (through the PF driver), and ensures that the SRIOV VF device is able to be assigned (passthrough) to a post-launched VM (launched by ACRN-DM).
* CPU sharing enhancement - Halt/Pause emulation
- For a vCPU that uses the fairness CPU scheduler, the hypervisor supports yielding an idle vCPU (when it's running a 'HLT' or 'PAUSE' instruction).
* PCI Config space access emulation for passthrough devices in the hypervisor
- The hypervisor provides the necessary emulation (such as config space) of the passthrough PCI device during runtime for a DM-launched VM. Such runtime emulation is DM-independent.
* PCI bridge emulation in hypervisor
Document Updates
================
Many new and updated `reference documents <https://projectacrn.github.io>`_ are available, including:
* :ref:`asa`
* :ref:`sriov_virtualization`
* :ref:`using_xenomai_as_uos`
* :ref:`split-device-model`
* :ref:`rdt_configuration`
We recommend that all developers upgrade to ACRN release v1.6.
New Features Details
********************
- :acrn-issue:`3381` - Avoid interference: PCI bridges
- :acrn-issue:`3831` - Pass-thru PCI device in DM-launched VM
- :acrn-issue:`4282` - Graphics passthrough
- :acrn-issue:`4329` - CPU Sharing: Halt/Pause Emulation
- :acrn-issue:`4360` - Graphics passthrough
- :acrn-issue:`4433` - SRIOV for ethernet device
- :acrn-issue:`4433` - SRIOV Physical Function Allocated To Service OS VM
- :acrn-issue:`4433` - SRIOV Any Virtual Function Allocated To Any One VM under sharing mode
Fixed Issues Details
********************
- :acrn-issue:`3465` -[SIT][ISD] [AUTO]add reset in"-s 2,passthru,02/00/0 \", rtvm can not launch
- :acrn-issue:`3789` -[Security][apl_sdc_stable]DM:The return value of snprintf is improperly checked.
- :acrn-issue:`3886` -Lapic-pt vcpu notification issue
- :acrn-issue:`4032` -Modify License file.
- :acrn-issue:`4042` -[KBL][HV]RTVM UOS result is invalid when run cpu2017 with 3 and 1 core
- :acrn-issue:`4094` -Error parameter for intel_pstate in launch_hard_rt_vm.sh
- :acrn-issue:`4175` -acrntrace fixes and improvement
- :acrn-issue:`4194` -Prevent compiler from optimizing out security checks
- :acrn-issue:`4212` -[KBL][acrn-configuration-tool][WaaG+RTVM]Need support pm_channel&pm_by_vuart setting for Board:nuc7i7dnb+WaaG&RTVM
- :acrn-issue:`4229` -Add range check in Kconfig.
- :acrn-issue:`4230` -Remove MAX_VCPUS_PER_VM in Kconfig
- :acrn-issue:`4253` -[WHL][Function][WaaG]Meet error log and waag can't boot up randomly after allocated 3 cores cpu to waag
- :acrn-issue:`4255` -[acrn-configuration-tool][nuc7i7dnb][sdc]uos has no ip address
- :acrn-issue:`4258` -[Community][External]cyclictest benchmark UOS getting high.
- :acrn-issue:`4282` -ACRN-DM Pass-thru devices bars prefetchable property isn't consistent with physical bars
- :acrn-issue:`4286` -[acrn-configuration-tool] Remove VM1.vcpu_affinity.pcuid=3 for VM1 in sdc scenario
- :acrn-issue:`4298` -[ConfigurationTool] mac address is not added to the launch script
- :acrn-issue:`4301` -[WHL][Hybrid] WHL need support Hybrid mode
- :acrn-issue:`4310` -[ISD][Function][WaaG] WaaG reboot automatically when run 3DMark-v1.5.915.0
- :acrn-issue:`4316` -[KataContainers]LaaG miss ip address when we create kata_container first with macvtap driver.
- :acrn-issue:`4325` -Do not wait pcpus offline when lapic pt is disabled.
- :acrn-issue:`4402` -UEFI UP2 board boot APs failed with ACRN hypervisor
- :acrn-issue:`4419` -[WHL][hybrid] SOS can not poweroff & reboot in hybrid mode of WHL board (multiboot2)
- :acrn-issue:`4472` -[WHL][sdc2] HV launch fails with sdc2 scenario which support launching 3 Guest OS
- :acrn-issue:`4492` -[acrn-configuration-tool] miss include head file from logical partition
- :acrn-issue:`4495` -[acrn-configuration-tool] Missing passthru nvme parameter while using WebUI to generate RTVM launch script
Known Issues
************
- :acrn-issue:`4046` - [WHL][Function][WaaG] Error info pop up when run 3DMARK11 on Waag
- :acrn-issue:`4047` - [WHL][Function][WaaG] passthru usb, Windows will hang when reboot it
- :acrn-issue:`4313` - [WHL][VxWorks] Failed to ping when VxWorks passthru network
- :acrn-issue:`4520` - efi-stub could get wrong bootloader name
- :acrn-issue:`4557` - [WHL][Performance][WaaG] Failed to run 3D directX9 during Passmark9.0 performance test with 7212 gfx driver
- :acrn-issue:`4558` - [WHL][Performance][WaaG] WaaG reboot automatically during run 3D directX12 with 7212 gfx driver
- :acrn-issue:`4560` - [WHL][SIT][HV]build HV fail in docker
Change Log
**********
These commits have been added to the acrn-hypervisor repo since the v1.5
release in Dec 2019 (click the CommitID link to see details):
.. comment
This list is obtained from this git command (update the date to pick up
changes since the last release):
git log --pretty=format:`- :acrn-commit:`%h` - %s` --after="2019-12-18"
- :acrn-commit:`0aa2c237` - hv: change GPU passthru translation mode to TT_PASSTHROUGH
- :acrn-commit:`64352596` - hv: unmap SR-IOV VF MMIO when the VF physical device is disabled
- :acrn-commit:`1d7158c0` - acrn-config: fix missing passthru parameter for launch config
- :acrn-commit:`0eeab73c` - acrn-config: add missed include in pci_dev.c for logical partition
- :acrn-commit:`05dc6c53` - OVMF release v1.6
- :acrn-commit:`fd2330c9` - Doc: Changed lines in RN 1.0 and 0.1 to correct ref issue.
- :acrn-commit:`14692ef6` - hv:Rename two VM states
- :acrn-commit:`a5f9ef40` - Doc: Fix tool ref tag on develop.rst page
- :acrn-commit:`9a85e274` - Doc: Re-org documentation to improve user experience; see Nav Bar
- :acrn-commit:`b62d439b` - acrn-config: remove a function that generates ve820 file
- :acrn-commit:`27b6c82c` - acrn-config: keep HV_RAM_START 2M memory align
- :acrn-commit:`91b06a35` - acrn-config: remap PCI vbar address to high memory
- :acrn-commit:`830df76f` - acrn-config: refine VM number macro from scenario config
- :acrn-commit:`a8c2ba03` - HV: add pci_devices.h for nuc6cayh and apl-up2
- :acrn-commit:`a68f655a` - HV: update ept address range for pre-launched VM
- :acrn-commit:`e7455349` - HV: move create_sos_vm_e820 to ve820.c
- :acrn-commit:`a7b61d25` - HV: remove board specific ve820
- :acrn-commit:`d7eac3fe` - HV: decouple prelaunch VM ve820 from board configs
- :acrn-commit:`4c0965d8` - HV: correct ept page array usage
- :acrn-commit:`e9a99845` - hv: refine read/write configuration APIs for vmsi/vmsix
- :acrn-commit:`4b6dd19a` - hv: pci: rename CFG read/write function for PCI-compatible Configuration Mechanism
- :acrn-commit:`7e74ed55` - misc:life_mngr: support S5 triggered by RTVM
- :acrn-commit:`e641202c` - Doc: Add note to index.html file Note invites users to view v1.5 branch while latest build is under construction.
- :acrn-commit:`3743edf9` - doc: add site under construction page header
- :acrn-commit:`910ac9f9` - dm:send shutdown to life_mngr on SOS
- :acrn-commit:`f78558a4` - dm: add one api for sending shutdown to life_mngr on SOS
- :acrn-commit:`8733abef` - dm:handle shutdown command from UOS
- :acrn-commit:`4fdc2be1` - dm:replace shutdown_uos_thread with a new one
- :acrn-commit:`7e9b7a8c` - dm:set pm-vuart attributes
- :acrn-commit:`790614e9` - hv:rename several variables and api for ioapic
- :acrn-commit:`fa74bf40` - hv: vpci: pass through stolen memory and opregion memory for GVT-D
- :acrn-commit:`659e5420` - hv: add static check for CONFIG_HV_RAM_START and CONFIG_HV_RAM_SIZE
- :acrn-commit:`696f6c7b` - hv: the VM can only deinit its own devices
- :acrn-commit:`d8a19f99` - hv: refine naming
- :acrn-commit:`08ed45f4` - hv: fix wrong VF BDF
- :acrn-commit:`7b429fe4` - hv: prohibit PF from being assigned
- :acrn-commit:`657af925` - hv: passthrough a VF device
- :acrn-commit:`640cf57c` - hv: disable VF device
- :acrn-commit:`2a4235f2` - hv: refine function find_vdev
- :acrn-commit:`d67d0538` - hv: initialize VF BARs
- :acrn-commit:`ddd6253a` - hv: wrap msix map/unmap operations
- :acrn-commit:`41350c53` - hv: vpci: add _v prefix for some function name
- :acrn-commit:`835dc22a` - acrn-config: sdc2 UUID update
- :acrn-commit:`f727d1e7` - HV: sdc2 UUID update
- :acrn-commit:`60a7c49b` - hv: Refine code for API reduction
- :acrn-commit:`b25d5fa5` - acrn-config: remove redundant sos bootargs from vm config
- :acrn-commit:`e5ae37eb` - hv: mmu: minor fix about add_pte
- :acrn-commit:`43676577` - hv: vpci: add a global CFG header configuration access handler
- :acrn-commit:`460e7ee5` - hv: Variable/macro renaming for intr handling of PT devices using IO-APIC/PIC
- :acrn-commit:`9a794432` - acrn-config: Generate target xml and board.c file with MBA RDT resource
- :acrn-commit:`2aaa050c` - HV: move out physical cfg write from vpci-bridge
- :acrn-commit:`ad4d14e3` - HV: enable ARI if PCI bridge support it
- :acrn-commit:`b6684f5b` - HV: sanitize config file for whl-ipc-i5
- :acrn-commit:`64bf4fb8` - dm: don't deassign pass through PCIe device in DM
- :acrn-commit:`67cb1029` - hv: update the hypervisor 64-bit entry address for efi-stub
- :acrn-commit:`49ffe168` - hv: fixup relocation delta for symbols belong to entry section
- :acrn-commit:`2aa8c9e5` - hv: add multiboot2 tags to load relocatable raw binary
- :acrn-commit:`97fc0efe` - hv: remove unused cpu_primary_save_32()
- :acrn-commit:`f0e5387e` - hv: remove pci_vdev_read_cfg_u8/16/32
- :acrn-commit:`e1ca1ae2` - hv: refine functions name
- :acrn-commit:`7c82efb9` - hv: pci: add some pre-assumption and safety check for PCIe ECAM
- :acrn-commit:`667639b5` - doc: fix a missing argument in the function description
- :acrn-commit:`93fa2bc0` - hv: minor fixes in init_paging()
- :acrn-commit:`734ad6ce` - hv: refine pci_read_cap and pci_read_ext_cap
- :acrn-commit:`76f2e28e` - doc: update hv device passthrough document
- :acrn-commit:`b05c1afa` - doc: add doxygen style comments to ptdev
- :acrn-commit:`b6c0558b` - HV: Update existing board.c files for RDT MBA
- :acrn-commit:`92ee33b0` - HV: Add MBA support in ACRN
- :acrn-commit:`d54d35ef` - acrn-config: correct console argument for logical partition scenario
- :acrn-commit:`d54deca8` - hv: initialize SRIOV VF device
- :acrn-commit:`176cb31c` - hv: refine vpci_init_vdev function
- :acrn-commit:`320ed6c2` - hv: refine init_one_dev_config
- :acrn-commit:`87e7d791` - hv: refine init_pdev function
- :acrn-commit:`abbdef4f` - hv: implement SRIOV VF_BAR initialization
- :acrn-commit:`298ef2f5` - hv: refine init_vdev_pt function
- :acrn-commit:`58c0a474` - acrn-config: Fix vbar address generated by the offline tool
- :acrn-commit:`cee8dc22` - acrn-config: Remove "GUEST_FLAG_CLOS_REQUIRED" from offline tool
- :acrn-commit:`984c0753` - xmls: Update existing <$BOARD$>.xml files for RDT support
- :acrn-commit:`a81fcc23` - acrn-config: Set/Unset RDT support in the <$BOARD$>.config file
- :acrn-commit:`6cfd81cd` - acrn-config: Generate board.c file with multiple RDT resources
- :acrn-commit:`b9f46943` - acrn-config: Update common platform clos max on scenario and vm configuration
- :acrn-commit:`cdac28e8` - acrn-config: Update platform max CLOS value to be least common value among RDT resources.
- :acrn-commit:`89a63543` - acrn-config: Extract RDT resource and CLOS from target xml file
- :acrn-commit:`4a007cc3` - acrn-config: Generate target xml file with multiple RDT resources
- :acrn-commit:`a63f8109` - dm: avoid clear guest memory content if guest is RTVM
- :acrn-commit:`be1e3acb` - dm: remove vdev_update_bar_map callback for PCIe device
- :acrn-commit:`595cefe3` - hv: xsave: move assembler to individual function
- :acrn-commit:`2f748306` - hv: introduce SRIOV interception
- :acrn-commit:`14931d11` - hv: add SRIOV capability read/write entries
- :acrn-commit:`5e989f13` - hv: check if there is enough room for all SRIOV VFs.
- :acrn-commit:`ac147795` - hv: implement SRIOV-Capable device detection.
- :acrn-commit:`c751a8e8` - hv: refine confusing e820 table logging layout
- :acrn-commit:`bd92304d` - HV: add vpci bridge operations support
- :acrn-commit:`c246d1c9` - hv: xsave: bugfix for init value
- :acrn-commit:`96f92373` - hv:refine comment about intel integrated gpu dmar
- :acrn-commit:`3098c493` - acrn-config: avoid conflict slot for launch config
- :acrn-commit:`0427de5e` - acrn-config: Kata VM is not supported on dual-core systems
- :acrn-commit:`cef3322d` - HV: Add WhiskeyLake board configuration files
- :acrn-commit:`eaad91fd` - HV: Remove RDT code if CONFIG_RDT_ENABLED flag is not set
- :acrn-commit:`d0665fe2` - HV: Generalize RDT infrastructure and fix RDT cache configuration.
- :acrn-commit:`887e3813` - HV: Add both HW and SW checks for RDT support
- :acrn-commit:`b8a021d6` - HV: split L2 and L3 cache resource MSR
- :acrn-commit:`25974299` - HV: Rename cat.c/.h files to rdt.c/.h
- :acrn-commit:`ee455574` - doc: update copyright year in doc footer
- :acrn-commit:`b2c6cf77` - hv: refine retpoline speculation barriers
- :acrn-commit:`da3d181f` - HV: init efi info with multiboot2
- :acrn-commit:`69da0243` - HV: init module and rsdp info with multiboot2
- :acrn-commit:`b669a719` - HV: init mmap info with multiboot2
- :acrn-commit:`d008b72f` - HV: add multiboot2 header info
- :acrn-commit:`19ffaa50` - HV: init and sanitize acrn multiboot info
- :acrn-commit:`520a0222` - HV: re-arch boot component header
- :acrn-commit:`708cae7c` - HV: remove DBG_LEVEL_PARSE
- :acrn-commit:`a46a7b35` - Makefile: Fix build issue if the ld is updated to 2.34
- :acrn-commit:`ad606102` - hv: sched_bvt: add tick handler
- :acrn-commit:`77c64ecb` - hv: sched_bvt: add pick_next function
- :acrn-commit:`a38f2cc9` - hv: sched_bvt: add wakeup and sleep handler
- :acrn-commit:`e05eb42c` - hv: sched_bvt: add init and deinit function
- :acrn-commit:`a7563cb9` - hv: sched_bvt: add BVT scheduler
- :acrn-commit:`64b874ce` - hv: rename BOOT_CPU_ID to BSP_CPU_ID
- :acrn-commit:`4adad73c` - hv: mmio: refine mmio access handle lock granularity
- :acrn-commit:`fbe57d9f` - hv: vpci: restrict SOS access assigned PCI device
- :acrn-commit:`9d3d9c3d` - dm: vpci: restrict SOS access assigned PCI device
- :acrn-commit:`e8479f84` - hv: vPCI: remove passthrough PCI device unused code
- :acrn-commit:`9fa6eff3` - dm: vPCI: remove passthrough PCI device unused code
- :acrn-commit:`dafa3da6` - vPCI: split passthrough PCI device from DM to HV
- :acrn-commit:`aa38ed5b` - dm: vPCI: add assign/deassign PCI device IC APIs
- :acrn-commit:`fe3182ea` - hv: vPCI: add assign/deassign PCI device HC APIs
- :acrn-commit:`2ca01206` - Makefile: fix build issue on old gcc
- :acrn-commit:`f3a4b232` - hv: add P2SB device to whitelist for apl-mrb
- :acrn-commit:`170aa935` - acrn-config: add P2SB device to whitelist for apl-mrb
- :acrn-commit:`0829edee` - dm:add an extra lpc bridge when enabling gvt-d
- :acrn-commit:`da2ed57a` - dm:add igd-lpc class for Windows guest when enabling gvt-d
- :acrn-commit:`1303861d` - hv:enable gpu iommu except APL platforms
- :acrn-commit:`1f1eb7fd` - hv:disable iommu snoop control to enable gvt-d by an option
- :acrn-commit:`53de3a72` - hv: reset vcpu events in reset_vcpu
- :acrn-commit:`cf3544b4` - Doc: VM2 vCPU affinity info update
- :acrn-commit:`cc6f0949` - hv: CAT is supposed to be enabled in the system level
- :acrn-commit:`8dcede76` - Makefile: disable fcf-protection for some build env
- :acrn-commit:`8ddbfc26` - acrn: add pxelinux as known bootloader
- :acrn-commit:`50f28452` - acrn-config: a few changes on vm_config[] clos generation
- :acrn-commit:`7f57e64e` - Delete pass-through audio to WaaG in default.
- :acrn-commit:`7d4b2c82` - Edits to Ubuntu SOS; changed SOS/UOS to Service VM/User VM
- :acrn-commit:`f3249e77` - hv: enable early pr_xxx() logs
- :acrn-commit:`db6fe1e3` - doc: update Grub configuration instructions for Ubuntu (Service VM)
- :acrn-commit:`920f0270` - acrn: rename param in uart16550_init
- :acrn-commit:`2e10930d` - Python scripts discovering CPU IDs are off by 1
- :acrn-commit:`ef1c92e8` - fix typos in script
- :acrn-commit:`8896ba25` - Grammatical edits to Run Kata Containers doc
- :acrn-commit:`88dfd8d4` - doc: update Kata and ACRN tutorial
- :acrn-commit:`e1eedc99` - Doc: Style updates to Building from Source doc
- :acrn-commit:`1f6c0cd4` - doc: update project's target max LOC
- :acrn-commit:`8f9e4c2d` - Updated grammar in ACRN industry scenario doc
- :acrn-commit:`54e9b562` - doc: Modify CL version from 32030 to 31670
- :acrn-commit:`1b3754aa` - dm:passthrough opregion to uos gpu
- :acrn-commit:`4d882731` - dm:passthrough graphics stolen memory to uos gpu
- :acrn-commit:`f9f64d35` - dm:reserve 64M hole for graphics stolen memory in e820 table
- :acrn-commit:`10c407cc` - HV: init local variable before it is used.
- :acrn-commit:`086e0f19` - hv: fix pcpu_id mask issue in smp_call_function()
- :acrn-commit:`a631c94c` - doc: reset clear linux version and ootb command in getting start guide
- :acrn-commit:`dbf9b933` - doc: update the "Using SDC Mode on the NUC" tutorial
- :acrn-commit:`809338a3` - Doc: Clarify Post-Launch VM data flow discussion for vuart conf
- :acrn-commit:`fd4775d0` - hv: rename VECTOR_XXX and XXX_IRQ Macros
- :acrn-commit:`b9086292` - hv: rename the ACRN_DBG_XXX
- :acrn-commit:`03f5c639` - dm:derive the prefetch property of PCI bar for pass-through device
- :acrn-commit:`ceb197c9` - dm:keep pci bar property unchanged when updating pci bar address
- :acrn-commit:`b59e5a87` - hv: Disable HLT and PAUSE-loop exiting emulation in lapic passthrough
- :acrn-commit:`3edde260` - hv: debug: show vcpu thread status in vcpu_list debug command
- :acrn-commit:`db708fc3` - hv: rename is_completion_polling to is_polling_ioreq
- :acrn-commit:`e4f5c1ef` - version: 1.6-unstable
- :acrn-commit:`008c35a8` - Doc: Updated one paragraph in re_industry doc.
- :acrn-commit:`7cef407d` - Doc: Fixed spelling error in the acrn_config_tool file.
- :acrn-commit:`02ce44ce` - Doc: Style and grammar edits to GSG for ACRN Industry Scenario.
- :acrn-commit:`e8512bf7` - Doc: Grammar updates to ACRN Config Tool doc.
- :acrn-commit:`54511773` - doc: update some xml elements description
- :acrn-commit:`9e244b1b` - doc: update getting start guide about clear linux version and ootb commands
- :acrn-commit:`5f1fa3cf` - doc: change version info
- :acrn-commit:`82b89fd0` - hv: check the validity of `pdev` in `set_ptdev_intr_info`
- :acrn-commit:`fe03d870` - Doc: releasenotes_1.5 update
- :acrn-commit:`e91ecaa7` - Doc: Grammar update to arcn_ootd.rst.
- :acrn-commit:`88644ab7` - Doc: document update base on release_v1.5
- :acrn-commit:`5267a977` - dm:replace perror with pr_err
- :acrn-commit:`0e47f0a8` - hv: fix potential NULL pointer reference in hc_assgin_ptdev
- :acrn-commit:`ddebefb9` - hv: remove depreciated code for hc_assign/deassign_ptdev
- :acrn-commit:`96aba9bd` - Doc: Grammatical edits to RN 1.5.
- :acrn-commit:`9b454dc4` - Doc: releasenotes_1.5
- :acrn-commit:`65ed6c35` - hv: vpci: trap PCIe ECAM access for SOS
- :acrn-commit:`1e50ec88` - hv: pci: use ECAM to access PCIe Configuration Space
- :acrn-commit:`57a36206` - acrn-config: set up whitelist for board containing hide pci device
- :acrn-commit:`65f3751e` - hv: pci: add hide pci devices configuration for apl-up2
- :acrn-commit:`3239cb0e` - hv: Use HLT as the default idle action of service OS
- :acrn-commit:`4303ccb1` - hv: HLT emulation in hypervisor
- :acrn-commit:`a8f6bdd4` - hv: Add vlapic_has_pending_intr of apicv to check pending interrupts
- :acrn-commit:`e3c30336` - hv: vcpu: wait and signal vcpu event support
- :acrn-commit:`1f23fe3f` - hv: sched: simple event implementation
- :acrn-commit:`4115dd62` - hv: PAUSE-loop exiting support in hypervisor.
- :acrn-commit:`bfecf30f` - HV: do not offline pcpu when lapic pt disabled.
- :acrn-commit:`c59f12da` - doc: fix wrong Docker container image in tutorial.
- :acrn-commit:`41a998fc` - hv: cr: handle control registers related to PCID.
- :acrn-commit:`4ae350a0` - hv: vmcs: pass-through instruction INVPCID to VM.
- :acrn-commit:`d330879c` - hv: cpuid: expose PCID related capabilities to VMs.
- :acrn-commit:`96331462` - hv: vmcs: remove redundant check on vpid.
- :acrn-commit:`5f2c303a` - acrn-config: dump CPU info from /sys/devices/system/cpu/possible.
- :acrn-commit:`5d1a08fc` - Doc: Added missing period in run_kata_containers file.
- :acrn-commit:`9071349a` - doc: Update some of the wrong path in acrn configuration tool doc.
- :acrn-commit:`e25a2bf8` - doc: add more details to the Kata Containers with ACRN tutorial.
- :acrn-commit:`933e2178` - dm: pci: reset passthrough device by default.
- :acrn-commit:`21b405d1` - hv: vpci: an assign PT device should support FLR or PM reset.
- :acrn-commit:`e74a9f39` - hv: pci: add PCIe PM reset check.
- :acrn-commit:`26670d7a` - hv: vpci: revert do FLR and BAR restore.
- :acrn-commit:`6c549d48` - hv: vpci: restore physical BARs when writing Command Register if necessary.
- :acrn-commit:`742abaf2` - hv: add sanity check for vuart configuration.
- :acrn-commit:`c6f7803f` - HV: restore lapic state and apic id upon INIT.
- :acrn-commit:`ab132285` - HV: ensure valid vcpu state transition.
- :acrn-commit:`a5158e2c` - HV: refine reset_vcpu api.
- :acrn-commit:`d1a46b82` - HV: rename function of vlapic_xxx_write_handler.
- :acrn-commit:`9ecac862` - HV: clean up redundant macro in lapic.h.
- :acrn-commit:`46ed0b15` - HV: correct apic lvt reset value.
- :acrn-commit:`d4bf019d` - Doc: Added Whiskey Lake specs to hardware ref page.
- :acrn-commit:`8a8438df` - remove no support OS parts and add whl build.
- :acrn-commit:`58b3a058` - hv: vpci: rename pci_bar to pci_vbar.
- :acrn-commit:`d2089889` - hv: pci: minor fix of coding style about pci_read_cap.
- :acrn-commit:`cdf9d6b3` - (ia) devicemodel: refactor CMD_OPT_LAPIC_PT case branch.
- :acrn-commit:`77c3ce06` - acrn-config: remove unnecessary split for `virtio-net`
- :acrn-commit:`ce35a005` - acrn-config: add `cpu_sharing` support for launch config.
- :acrn-commit:`3544f7c8` - acrn-config: add `cpu_sharing` info in launch xmls.
- :acrn-commit:`57939730` - HV: search rsdp from e820 acpi reclaim region.
- :acrn-commit:`fc78013f` - acrn-config: some cleanup for logical partition mode Linux bootargs.
- :acrn-commit:`8f9cda18` - DOC: Content edits to CPU Sharing doc.
- :acrn-commit:`651510a8` - acrn-config: add `logger_setting` into launch script.
- :acrn-commit:`7f74e6e9` - acrn-config: refine mount device for virtio-blk.
- :acrn-commit:`fc357a77` - acrn-config: add `tap_` prefix for virtio-net.
- :acrn-commit:`5b6a33bb` - acrn-config: enable log_setting in all VMs.
- :acrn-commit:`d4bf019d` - Doc: Added Whiskey Lake specs to hardware ref page.
- :acrn-commit:`8a8438df` - remove no support OS parts and add whl build.
- :acrn-commit:`58b3a058` - hv: vpci: rename pci_bar to pci_vbar.
- :acrn-commit:`d2089889` - hv: pci: minor fix of coding style about pci_read_cap.
- :acrn-commit:`cdf9d6b3` - (ia) devicemodel: refactor CMD_OPT_LAPIC_PT case branch.
- :acrn-commit:`77c3ce06` - acrn-config: remove unnecessary split for `virtio-net`
- :acrn-commit:`ce35a005` - acrn-config: add `cpu_sharing` support for launch config.
- :acrn-commit:`3544f7c8` - acrn-config: add `cpu_sharing` info in launch xmls.
- :acrn-commit:`57939730` - HV: search rsdp from e820 acpi reclaim region.
- :acrn-commit:`fc78013f` - acrn-config: some cleanup for logical partition mode Linux bootargs.
- :acrn-commit:`8f9cda18` - DOC: Content edits to CPU Sharing doc.
- :acrn-commit:`651510a8` - acrn-config: add `logger_setting` into launch script.
- :acrn-commit:`7f74e6e9` - acrn-config: refine mount device for virtio-blk.
- :acrn-commit:`fc357a77` - acrn-config: add `tap_` prefix for virtio-net.
- :acrn-commit:`5b6a33bb` - acrn-config: enable log_setting in all VMs.
- :acrn-commit:`bb6e28e1` - acrn-config: check pass-through device for audio/audio_codec.
- :acrn-commit:`4234d2e4` - acrn-config: correct vuart1 setting in scenario config.
- :acrn-commit:`d80a0dce` - acrn-config: fix a few formatting issues.
- :acrn-commit:`051f277c` - acrn-config: modify hpa start size value for logical_partition scenario.
- :acrn-commit:`e5117bf1` - vm: add severity for vm_config.
- :acrn-commit:`f7df43e7` - reset: detect highest severity guest dynamically.
- :acrn-commit:`bfa19e91` - pm: S5: update the system shutdown logical in ACRN.
- :acrn-commit:`197e4a06` - acrn-config: add support to parse `severity` item tag.
- :acrn-commit:`ca2855f2` - acrn-config: add severity setting to scenario config xml.
- :acrn-commit:`a4085538` - Doc: Content edits to Running Kata containers on a Service VM doc.
- :acrn-commit:`9ee55965` - Doc: More edits to CPU Sharing doc.
- :acrn-commit:`fcb85a80` - acrn-config: remove pcpu3 from vm1 in SDC scenario
- :acrn-commit:`1fddf943` - hv: vpci: restore PCI BARs when doing AF FLR
- :acrn-commit:`a90e0f6c` - hv: vpci: restore PCI BARs when doing PCIe FLR
- :acrn-commit:`3c2f4509` - Doc: Add v1.5 release menu choice.
- :acrn-commit:`3e45d5e3` - Doc: Content edit to cpu-sharing page.
- :acrn-commit:`fa5922c8` - Doc: Content edit to rt_industry document.
- :acrn-commit:`17f6344c` - doc: Add tutorial about how to launch kata vm.
- :acrn-commit:`2ceff270` - doc: modify Configuration Tools
- :acrn-commit:`7edf8ed7` - doc: add document for cpu sharing

328
doc/release_notes/release_notes_2.0.rst
View File

@ -1,328 +0,0 @@
.. _release_notes_2.0:
ACRN v2.0 (Jun 2020)
####################
We are pleased to announce the second major release of the Project ACRN
hypervisor.
ACRN v2.0 offers new and improved scenario definitions, with a focus on
industrial IoT and edge device use cases. ACRN supports these uses with
their demanding and varying workloads including Functional Safety
certification, real-time characteristics, device and CPU sharing, and
general computing power needs, while honoring required isolation and
resource partitioning. A wide range of User VM OSs (such as Windows 10,
Ubuntu, Android, and VxWorks) can run on ACRN, running different
workloads and applications on the same hardware platform.
A new hybrid-mode architecture adds flexibility to simultaneously
support both traditional resource sharing among VMs and complete VM
resource partitioning required for functional safety requirements.
Workload management and orchestration, rather standard and mature in
cloud environments, are enabled now in ACRN, allowing open source
orchestrators such as OpenStack to manage ACRN virtual machines. Kata
Containers, a secure container runtime, has also been enabled on ACRN
and can be orchestrated via Docker or Kubernetes.
Rounding things out, we've also made significant improvements in
configuration tools, added many new tutorial documents, and enabled ACRN
on the QEMU machine emulator making it easier to try out and develop with
ACRN.
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. Check out
:ref:`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 either download this source
code as a zip or tar.gz file (see the `ACRN v2.0 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v2.0>`_)
or use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v2.0
The project's online technical documentation is also tagged to
correspond with a specific release: generated v2.0 documents can be
found at https://projectacrn.github.io/2.0/. Documentation for the
latest (master) branch is found at
https://projectacrn.github.io/latest/.
Follow the instructions in the :ref:`rt_industry_ubuntu_setup` to get
started with ACRN.
We recommend that all developers upgrade to ACRN release v2.0.
Version 2.0 Key Features (Comparing With v1.0)
**********************************************
.. contents::
:local:
:backlinks: entry
ACRN Architecture Upgrade to Support Hybrid Mode
================================================
The ACRN architecture has evolved after its initial major 1.0 release in
May 2019. The new hybrid mode architecture has the flexibility to
support both partition mode and sharing mode simultaneously, as shown in
this architecture diagram:
.. figure:: ../introduction/images/ACRN-V2-high-level-arch-1-0.75x.png
:align: center
ACRN V2 high-level architecture
On the left, resources are partitioned and used by a pre-launched User
Virtual Machine (VM), started by the hypervisor before the Service VM
has been launched. It runs independent of other virtual machines, and
can own its own dedicated hardware resources, such as a CPU core,
memory, and I/O devices. Because other VMs may not even be aware of its
existence, this pre-launched VM can be used as a safety VM where, for
example, platform hardware failure detection code can run and take
emergency actions if a system critical failure occurs.
On the right, the remaining hardware resources are shared by the Service
VM and User VMs. The Service VM can access hardware resources directly
(by running native drivers) and offer device sharing services to other
User VMs by the Device Model.
Also on the right, a special post-launched real-time VM (RTVM) can run a
hard real-time OS, such as VxWorks*, Zephyr*, or Xenomai*. Because of
its real-time capabilities, the RTVM can be used for soft PLC, IPC, or
Robotics applications.
New Hardware Platform Support
=============================
This release adds support for 8th Gen Intel® Core™ Processors (code
name: Whiskey Lake). (See :ref:`hardware` for platform details.)
Pre-Launched Safety VM Support
==============================
ACRN supports a pre-launched partitioned safety VM, isolated from the
Service VM and other post-launched VM by using partitioned HW resources.
For example, in the hybrid mode, a real-time Zephyr RTOS VM can be
*pre-launched* by the hypervisor even before the Service VM is launched,
and with its own dedicated resources to achieve a high level of
isolation. This is designed to meet the needs of a Functional Safety OS.
Post-Launched VM Support via OVMF
=================================
ACRN supports Open Virtual Machine Firmware (OVMF) as a virtual boot
loader for the Service VM to launch post-launched VMs such as Windows,
Linux, VxWorks, or Zephyr RTOS. Secure boot is also supported.
Post-Launched Real-Time VM Support
==================================
ACRN supports a post-launched RTVM, which also uses partitioned hardware
resources to ensure adequate real-time performance, as required for
industrial use cases.
Real-Time VM Performance Optimizations
======================================
ACRN 2.0 improves RTVM performance with these optimizations:
* **Eliminate use of VM-Exit and its performance overhead:**
Use Local APIC (LAPIC) passthrough, Virtio Polling Mode Drivers (PMD),
and NMI interrupt notification technologies.
* **Isolate the RTVM from the Service VM:**
The ACRN hypervisor uses RDT (Resource Director Technology)
allocation features such as CAT (Cache Allocation Technology), CDP (Code
Data Prioritization), and MBA (Memory Bandwidth Allocation) to provide
better isolation and prioritize critical resources, such as cache and
memory bandwidth, for RTVMs over other VMs.
* **PCI Configuration space access emulation for passthrough devices in the hypervisor:**
The hypervisor provides the necessary emulation (such as config space)
of the passthrough PCI device during runtime for a DM-launched VM from
Service VM.
* **More hypervisor-emulated devices:**
This includes vPCI and vPCI bridge emulation, and vUART.
* **ART (Always Running Timer Virtualization):**
Ensure time is synchronized between Ptdev and vART
CPU Sharing Support
===================
ACRN supports CPU Sharing to fully utilize the physical CPU resource
across more virtual machines. ACRN enables a borrowed virtual time CPU
scheduler in the hypervisor to make sure the physical CPU can be shared
between VMs and support for yielding an idle vCPU when it's running a
'HLT' or 'PAUSE' instruction.
Large Selection of OSs for User VMs
===================================
ACRN now supports Windows* 10, Android*, Ubuntu*, Xenomai, VxWorks*,
real-time Linux*, and Zephyr* RTOS. ACRN's Windows support now conforms
to the Microsoft* Hypervisor Top-Level Functional Specification (TLFS).
ACRN 2.0 also improves overall Windows as a Guest (WaaG) stability and
performance.
GRUB Bootloader
===============
The ACRN hypervisor can boot from the popular GRUB bootloader using
either the multiboot or multiboot2 prococol (the latter adding UEFI
support). GRUB provides developers with booting flexibility.
SR-IOV Support
==============
SR-IOV (Single Root Input/Output Virtualization) can isolate PCIe
devices to offer performance similar to bare-metal levels. For a
network adapter, for example, this enables network traffic to bypass the
software switch layer in the virtualization stack and achieve network
performance that is nearly the same as in a nonvirtualized environment.
In this example, the ACRN Service VM supports a SR-IOV ethernet device
through the Physical Function (PF) driver, and ensures that the SR-IOV
Virtual Function (VF) device can passthrough to a post-launched VM.
Graphics Passthrough Support
============================
ACRN supports GPU passthrough to dedicated User VM based on Intel GVT-d
technology used to virtualize the GPU for multiple guest VMs,
effectively providing near-native graphics performance in the VM.
Shared Memory Based Inter-Vm Communication
==========================================
ACRN supports Inter-VM communication based on shared memory for
post-launched VMs communicating via a Userspace I/O (UIO) interface.
Configuration Tool Support
==========================
A new offline configuration tool helps developers deploy ACRN to
different hardware systems with its own customization.
Kata Containers Support
=======================
ACRN can launch a Kata container, a secure container runtime, as a User VM.
VM Orchestration
================
Libvirt is an open-source API, daemon, and management tool as a layer to
decouple orchestrators and hypervisors. By adding a "ACRN driver", ACRN
supports libvirt-based tools and orchestrators to configure a User VM's CPU
configuration during VM creation.
Document Updates
================
Many new and updated `reference documents <https://projectacrn.github.io>`_ are available, including:
* General
* :ref:`introduction`
* :ref:`hardware`
* :ref:`asa`
* Getting Started
* :ref:`rt_industry_ubuntu_setup`
* :ref:`using_partition_mode_on_nuc`
* Configuration and Tools
* :ref:`acrn_configuration_tool`
* Service VM Tutorials
* Run Debian as the Service VM
* User VM Tutorials
.. rst-class:: rst-columns2
* :ref:`using_zephyr_as_uos`
* Run Debian as the User VM
* Run Celadon as the User VM
* :ref:`using_windows_as_uos`
* :ref:`using_vxworks_as_uos`
* :ref:`using_xenomai_as_uos`
* Enable ACRN Features
.. rst-class:: rst-columns2
* Enable OVS in ACRN
* :ref:`rdt_configuration`
* :ref:`sriov_virtualization`
* :ref:`cpu_sharing`
* :ref:`run-kata-containers`
* :ref:`how-to-enable-secure-boot-for-windows`
* :ref:`enable-s5`
* :ref:`vuart_config`
* :ref:`sgx_virt`
* Enable QoS based on runC Containers
* :ref:`setup_openstack_libvirt`
* :ref:`acrn_on_qemu`
* :ref:`gpu-passthrough`
* :ref:`using_grub`
* Debug
* :ref:`rt_performance_tuning`
* :ref:`rt_perf_tips_rtvm`
* High-Level Design Guides
* :ref:`virtio-i2c`
* :ref:`split-device-model`
* :ref:`hv-device-passthrough`
* :ref:`vtd-posted-interrupt`
Fixed Issues Details
********************
- :acrn-issue:`3715` - Add support for multiple RDT resource allocation and fix L3 CAT config overwrite by L2
- :acrn-issue:`3770` - Warning when building the ACRN hypervisor \`SDC (defined at arch/x86/Kconfig:7) set more than once`
- :acrn-issue:`3773` - suspicious logic in vhost.c
- :acrn-issue:`3918` - Change active_hp_work position for code cleaning and add a module parameter to disable hp work.
- :acrn-issue:`3939` - zero-copy non-functional with vhost
- :acrn-issue:`3946` - Cannot boot VxWorks as UOS on KabyLake
- :acrn-issue:`4017` - hv: rename vuart operations
- :acrn-issue:`4046` - Error info popoup when run 3DMARK11 on Waag
- :acrn-issue:`4072` - hv: add printf "not support the value of vuart index parameter" in function vuart_register_io_handler
- :acrn-issue:`4191` - acrnboot: the end address of _DYNAME region is not calculated correct
- :acrn-issue:`4250` - acrnboot: parse hv cmdline incorrectly when containing any trailing white-spaces
- :acrn-issue:`4283` - devicemodel: refactor CMD_OPT_LAPIC_PT case branch
- :acrn-issue:`4314` - RTVM boot up fail due to init_hugetlb failed during S5 testing
- :acrn-issue:`4365` - Enable GOP driver work in GVT-d scenario
- :acrn-issue:`4520` - efi-stub could get wrong bootloader name
- :acrn-issue:`4628` - HV: guest: fix bug in get_vcpu_paging_mode
- :acrn-issue:`4630` - The \`board_parser.py` tool contains a few grammatical mistakes and typos
- :acrn-issue:`4664` - Wake up vCPU for interrupts from vPIC
- :acrn-issue:`4666` - Fix offline tool to generate info in pci_dev file for logical partition scenario
- :acrn-issue:`4680` - Fix potential dead loop if VT-d QI request timeout
- :acrn-issue:`4688` - RELEASE=n does not take effect while using xml to make hypervisor
- :acrn-issue:`4703` - Failed to launch WaaG at a high probablity if enable CPU sharing in GVT-d.
- :acrn-issue:`4711` - WaaG reboot will core dump with USB mediator
- :acrn-issue:`4797` - [acrn-configuration-tool] The VM name is always 1 when using web app to generate the launch script
- :acrn-issue:`4799` - [acrn-configuration-tool]wrong parameter for Soft RT/Hard RT vm in launch script
- :acrn-issue:`4827` - Missing explicit initialization of pci_device_lock
- :acrn-issue:`4868` - [acrn-configuation-tool]efi bootloader image file of Yocto industry build not match with default xmls
- :acrn-issue:`4889` - [WHL][QEMU][HV] With latest master branch HV, build ACRN for Qemu fail
Known Issues
************
- :acrn-issue:`4047` - [WHL][Function][WaaG] passthru usb, Windows will hang when reboot it
- :acrn-issue:`4313` - [WHL][VxWorks] Failed to ping when VxWorks passthru network
- :acrn-issue:`4557` - [WHL][Performance][WaaG] Failed to run 3D directX9 during Passmark9.0 performance test with 7212 gfx driver
- :acrn-issue:`4558` - [WHL][Performance][WaaG] WaaG reboot automatically during run 3D directX12 with 7212 gfx driver
- :acrn-issue:`4982` - [WHL]ivshmemTest transfer file failed after UOS shutdown or reboot
- :acrn-issue:`4983` - [WHL][RTVM]without any virtio device, with only pass-through devices, RTVM can't boot from SATA

111
doc/release_notes/release_notes_2.1.rst
View File

@ -1,111 +0,0 @@
.. _release_notes_2.1:
ACRN v2.1 (Aug 2020)
####################
We are pleased to announce the release of the Project ACRN
hypervisor version 2.1.
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. Check out
: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 either download this source code as a zip or
tar.gz file (see the `ACRN v2.1 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v2.1>`_) or
use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v2.1
The project's online technical documentation is also tagged to
correspond with a specific release: generated v2.1 documents can be
found at https://projectacrn.github.io/2.1/. Documentation for the
latest under-development branch is found at
https://projectacrn.github.io/latest/.
ACRN v2.1 requires Ubuntu 18.04. Follow the instructions in the
:ref:`rt_industry_ubuntu_setup` to get started with ACRN.
We recommend that all developers upgrade to ACRN release v2.1.
What's New in v2.1
******************
* Preempt-RT Linux has been validated as a pre-launched realtime VM. See
:ref:`pre_launched_rt` for more details.
* A Trusted Platform Module (TPM) MMIO device can be passthroughed to a
pre-launched VM (with some limitations discussed in
:ref:`mmio-device-passthrough`). Previously passthrough was only
supported for PCI devices.
* Open Virtual Machine Firmware (OVMF) now uses a Local Advanced
Programmable Interrupt Controller (LAPIC) timer as its local time
instead of the High Precision Event Timer (HPET). This provides the
working timer service for the realtime virtual machine (RTVM) booting
process.
* Grub is the recommended bootloader for ACRN. For more information,
see :ref:`using_grub`.
Improvements, updates, and corrections have been made throughout our documentation,
including these:
* :ref:`contribute_guidelines`
* :ref:`hv_rdt`
* :ref:`ivshmem-hld`
* :ref:`mmio-device-passthrough`
* :ref:`virtio-net`
* :ref:`getting-started-building`
* :ref:`acrn_configuration_tool`
* :ref:`pre_launched_rt`
* :ref:`rdt_configuration`
* :ref:`using_hybrid_mode_on_nuc`
* :ref:`using_partition_mode_on_nuc`
* :ref:`using_windows_as_uos`
* :ref:`debian_packaging`
Fixed Issues Details
********************
- :acrn-issue:`4047` - [WHL][Function][WaaG] passthru usb, Windows will hang when reboot it
- :acrn-issue:`4691` - [WHL][Function][RTVM]without any virtio device, with only pass-through devices, RTVM can't boot from SATA
- :acrn-issue:`4711` - [WHL][Stabilty][WaaG]Failed to boot up WaaG with core dumped in WaaG reboot test in GVT-d & CPU sharing env.
- :acrn-issue:`4897` - [WHL][Yocto][GVT-d]WaaG reboot failed due to USB mediator trouble in WaaG reboot stability test.
- :acrn-issue:`4937` - [EHL][Yocto] Fail to boot ACRN on Yocto
- :acrn-issue:`4958` - cleanup spin lock in hypervisor
- :acrn-issue:`4989` - [WHL][Yocto][acrn-configuration-tool] Fail to generate board xml on Yocto build
- :acrn-issue:`4991` - [WHL][acrn-configuration-tool] vuart1 of VM1 does not change correctly
- :acrn-issue:`4994` - Default max MSIx table is too small
- :acrn-issue:`5013` - [TGL][Yocto][YaaG] Can't enter console #1 via HV console
- :acrn-issue:`5015` - [EHL][TGL][acrn-configuration-tool] default industry xml is only support 2 user vms
- :acrn-issue:`5016` - [EHL][acrn-configuration-tool] Need update pci devices for ehl industry launch xmls
- :acrn-issue:`5029` - [TGL][Yocto][GVT] can not boot and login waag with GVT-D
- :acrn-issue:`5039` - [acrn-configuration-tool]minor fix for launch config tool
- :acrn-issue:`5041` - Pre-Launched VM boot not successful if SR-IOV PF is passed to
- :acrn-issue:`5049` - [WHL][Yocto][YaaG] Display stay on openembedded screen when launch YaaG with GVT-G
- :acrn-issue:`5056` - [EHL][Yocto]Can't enable SRIOV on EHL SOS
- :acrn-issue:`5062` - [EHL] WaaG cannot boot on EHL when CPU sharing is enabled
- :acrn-issue:`5066` - [WHL][Function] Fail to launch YaaG with usb mediator enabled
- :acrn-issue:`5067` - [WHL][Function][WaaG] passthru usb, Windows will hang when reboot it
- :acrn-issue:`5085` - [EHL][Function]Can't enable SRIOV when add memmap=64M$0xc0000000 in cmdline on EHL SOS
- :acrn-issue:`5091` - [TGL][acrn-configuration-tool] generate tgl launch script fail
- :acrn-issue:`5092` - [EHL][acrn-config-tool]After WebUI Enable CDP_ENABLED=y ,build hypervisor fail
- :acrn-issue:`5094` - [TGL][acrn-configuration-tool] Board xml does not contain SATA information
- :acrn-issue:`5095` - [TGL][acrn-configuration-tool] Missing some default launch script xmls
- :acrn-issue:`5107` - Fix size issue used for memset in create_vm
- :acrn-issue:`5115` - [REG][WHL][WAAG] Shutdown waag fails under CPU sharing status
- :acrn-issue:`5122` - [WHL][Stabilty][WaaG][GVT-g & GVT-d]Failed to boot up SOS in cold boot test.
Known Issues
************
- :acrn-issue:`4313` - [WHL][VxWorks] Failed to ping when VxWorks passthru network
- :acrn-issue:`5150` - [REG][WHL][[Yocto][Passthru] Launch RTVM fails with usb passthru
- :acrn-issue:`5151` - [WHL][VxWorks] Launch VxWorks fails due to no suitable video mode found
- :acrn-issue:`5152` - [WHL][Yocto][Hybrid] in hybrid mode ACRN HV env, can not shutdown pre-lanuched RTVM
- :acrn-issue:`5154` - [TGL][Yocto][PM] 148213_PM_SystemS5 with life_mngr fail
- :acrn-issue:`5157` - [build from source] during build HV with XML, “TARGET_DIR=xxx” does not work

147
doc/release_notes/release_notes_2.2.rst
View File

@ -1,147 +0,0 @@
.. _release_notes_2.2:
ACRN v2.2 (Sep 2020)
####################
We are pleased to announce the release of the Project ACRN
hypervisor version 2.2.
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. Check out 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 either download this source code as a zip or
tar.gz file (see the `ACRN v2.2 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v2.2>`_) or
use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v2.2
The project's online technical documentation is also tagged to
correspond with a specific release: generated v2.2 documents can be
found at https://projectacrn.github.io/2.2/. Documentation for the
latest under-development branch is found at
https://projectacrn.github.io/latest/.
ACRN v2.2 requires Ubuntu 18.04. Follow the instructions in the
:ref:`rt_industry_ubuntu_setup` to get started with ACRN.
What's New in v2.2
******************
Elkhart Lake and Tiger Lake processor support.
At `Intel Industrial iSummit 2020
<https://newsroom.intel.com/press-kits/intel-industrial-summit-2020>`_,
Intel announced the latest additions to their
enhanced-for-IoT Edge portfolio: the Intel |reg| Atom |reg| x6000E Series, Intel |reg|
Pentium |reg| and Intel |reg| Celeron |reg| N and J Series (all codenamed Elkhart Lake),
and 11th Gen Intel |reg| Core |trade| processors (codenamed Tiger Lake-UP3). The ACRN
team is pleased to announce that this ACRN v2.2 release already supports
these processors.
* Support for time deterministic applications with new features, e.g.,
Time Coordinated Computing and Time Sensitive Networking
* Support for functional safety with new features, e.g., Intel Safety Island
On Elkhart Lake, ACRN can boot using Slim Bootloader
`Slim Bootloader <https://slimbootloader.github.io/>`_ is an
alternative bootloader to UEFI firmware.
Shared memory based inter-VM communication (ivshmem) is extended
ivshmem now supports all kinds of VMs including pre-launched VM, Service VM, and
other User VMs. (See :ref:`ivshmem-hld`)
**CPU sharing supports pre-launched VM.**
**RTLinux with preempt-RT Linux kernel 5.4 is validated both as a pre-launched and post-launched VM.**
**ACRN hypervisor can emulate MSI-X based on physical MSI with multiple vectors.**
Staged removal of deprivileged boot mode support.
ACRN has supported deprivileged boot mode to ease the integration of
Linux distributions such as Clear Linux. Unfortunately, deprivileged boot
mode limits ACRN's scalability and is unsuitable for ACRN's hybrid
hypervisor mode. In ACRN v2.2, deprivileged boot mode is no longer the default
and will be completely removed in ACRN v2.3. We're focusing instead
on using multiboot2 boot (via Grub). Multiboot2 is not supported in
Clear Linux though, so we have chosen Ubuntu (and Yocto Project) as the
preferred Service VM OSs moving forward.
Document Updates
****************
New and updated reference documents are available, including:
.. rst-class:: rst-columns2
* :ref:`develop_acrn`
* :ref:`asm_coding_guidelines`
* :ref:`c_coding_guidelines`
* :ref:`contribute_guidelines`
* :ref:`hv-cpu-virt`
* :ref:`IOC_virtualization_hld`
* :ref:`hv-startup`
* :ref:`hv-vm-management`
* :ref:`ivshmem-hld`
* :ref:`virtio-i2c`
* :ref:`sw_design_guidelines`
* :ref:`faq`
* :ref:`getting-started-building`
* :ref:`introduction`
* :ref:`acrn_configuration_tool`
* :ref:`enable_ivshmem`
* :ref:`setup_openstack_libvirt`
* :ref:`using_grub`
* :ref:`using_partition_mode_on_nuc`
* :ref:`connect_serial_port`
* Using Yocto Project With ACRN
* :ref:`acrn-dm_parameters`
* :ref:`hv-parameters`
* :ref:`acrnctl`
Because we're dropping deprivileged boot mode support in the next v2.3
release, we're also switching our Service VM of choice away from Clear
Linux. We've begun this transition in the v2.2 documentation and removed
some Clear Linux-specific tutorials. Deleted documents are still
available in the `version-specific v2.1 documentation
<https://projectacrn.github.io/v2.1/>`_.
Fixed Issues Details
********************
- :acrn-issue:`5008` - Slowdown in UOS (Zephyr)
- :acrn-issue:`5033` - SOS decode instruction failed in hybrid mode
- :acrn-issue:`5038` - [WHL][Yocto] SOS occasionally hangs/crashes with a kernel panic
- :acrn-issue:`5048` - iTCO_wdt issue: can't request region for resource
- :acrn-issue:`5102` - Can't access shared memory base address in ivshmem
- :acrn-issue:`5118` - GPT ERROR when write preempt img to SATA on NUC7i5BNB
- :acrn-issue:`5148` - dm: support to provide ACPI SSDT for UOS
- :acrn-issue:`5157` - [build from source] during build HV with XML, "TARGET_DIR=xxx" does not work
- :acrn-issue:`5165` - [WHL][Yocto][YaaG] No UI display when launch Yaag gvt-g with acrn kernel
- :acrn-issue:`5215` - [UPsquared N3350 board] Solution to Bootloader issue
- :acrn-issue:`5233` - Boot ACRN failed on Dell-OptiPlex 5040 with Intel i5-6500T
- :acrn-issue:`5238` - acrn-config: add hybrid_rt scenario XML config for ehl-crb-b
- :acrn-issue:`5240` - passthrough DHRD-ignored device
- :acrn-issue:`5242` - acrn-config: add pse-gpio to vmsix_on_msi devices list
- :acrn-issue:`4691` - hv: add vgpio device model support
- :acrn-issue:`5245` - hv: add INTx mapping for pre-launched VMs
- :acrn-issue:`5426` - hv: add vgpio device model support
- :acrn-issue:`5257` - hv: support PIO access to platform hidden devices
- :acrn-issue:`5278` - [EHL][acrn-configuration-tool]: create a new hybrid_rt based scenario for P2SB MMIO pass-thru use case
- :acrn-issue:`5304` - Cannot cross-compile - Build process assumes build system always hosts the ACRN hypervisor
Known Issues
************
- :acrn-issue:`5150` - [REG][WHL][[Yocto][Passthru] Launch RTVM fails with USB passthru
- :acrn-issue:`5151` - [WHL][VxWorks] Launch VxWorks fails due to no suitable video mode found
- :acrn-issue:`5154` - [TGL][Yocto][PM] 148213_PM_SystemS5 with life_mngr fail
- :acrn-issue:`5368` - [TGL][Yocto][Passthru] Audio does not work on TGL
- :acrn-issue:`5369` - [TGL][qemu] Cannot launch qemu on TGL
- :acrn-issue:`5370` - [TGL][RTVM][PTCM] Launch RTVM failed with mem size smaller than 2G and PTCM enabled
- :acrn-issue:`5371` - [TGL][Industry][Xenomai]Xenomai post launch fail

151
doc/release_notes/release_notes_2.3.rst
View File

@ -1,151 +0,0 @@
.. _release_notes_2.3:
ACRN v2.3 (Dec 2020)
####################
We are pleased to announce the release of the Project ACRN
hypervisor version 2.3.
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. Check out 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 either download this source code as a zip or
tar.gz file (see the `ACRN v2.3 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v2.3>`_) or
use Git clone and checkout commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v2.3
The project's online technical documentation is also tagged to
correspond with a specific release: generated v2.3 documents can be
found at https://projectacrn.github.io/2.3/. Documentation for the
latest under-development branch is found at
https://projectacrn.github.io/latest/.
ACRN v2.3 requires Ubuntu 18.04. Follow the instructions in the
:ref:`rt_industry_ubuntu_setup` to get started with ACRN.
What's New in v2.3
******************
Enhanced GPU passthrough (GVT-d)
GPU passthrough (GVT-d) to Windows as a guest is now enabled for 11th Gen
Intel® Core™ processors (codenamed Tiger Lake-UP3).
Shared memory based inter-VM communication (ivshmem) is extended
ivshmem now supports interrupts (See :ref:`ivshmem-hld`).
Enhanced vUART support
Added PCI vUART (up to 8) for VM-to-VM communication. Legacy vUART
(0x3F8-like) is available for console (debugging) support.
End-to-end secure boot improvement
OVMF can be loaded now as two blobs, one for code and the other for data.
The code blob can be verified by the Service VM's ``dm-verity`` as
a step in the end-to-end secure boot.
Enhanced system shutdown
The pre-launched VM may now initiate a system shutdown or reset.
Removed deprivileged boot mode support
ACRN has supported deprivileged boot mode to ease the integration of
Linux distributions such as Clear Linux. Unfortunately, deprivileged boot
mode limits ACRN's scalability and is unsuitable for ACRN's hybrid
hypervisor mode. In ACRN v2.2, deprivileged boot mode was no longer the default
and completely removed in ACRN v2.3. We're focusing instead
on using the simpler and more scalable multiboot2 boot (via Grub).
Multiboot2 is not supported in
Clear Linux so we have chosen Ubuntu (and Yocto Project) as the
preferred Service VM OSs moving forward.
Document Updates
****************
New and updated reference documents are available, including:
.. rst-class:: rst-columns2
* :ref:`asa`
* GVT-g-porting (obsolete with v2.6))
* VBS-K Framework Virtualization Overhead Analysis
* :ref:`asm_coding_guidelines`
* :ref:`c_coding_guidelines`
* :ref:`contribute_guidelines`
* :ref:`doc_guidelines`
* :ref:`hld-devicemodel`
* :ref:`hld-overview`
* :ref:`hld-power-management`
* :ref:`hld-security`
* :ref:`hld-trace-log`
* :ref:`hld-virtio-devices`
* :ref:`ivshmem-hld`
* :ref:`l1tf`
* :ref:`modularity`
* :ref:`sw_design_guidelines`
* :ref:`getting-started-building`
* :ref:`rt_industry_ubuntu_setup`
* :ref:`introduction`
* :ref:`release_notes_2.3`
* :ref:`how-to-enable-acrn-secure-boot-with-grub`
* :ref:`acrn_configuration_tool`
* :ref:`acrn_on_qemu`
* :ref:`acrn-debug`
* :ref:`acrn_doc`
* :ref:`enable_ivshmem`
* :ref:`enable-s5`
* :ref:`rdt_configuration`
* :ref:`rt_performance_tuning`
* :ref:`rt_perf_tips_rtvm`
* :ref:`run-kata-containers`
* Run Debian as the Service VM
* Run Debian as the User VM
* Run Ubuntu as the User VM
* :ref:`setup_openstack_libvirt`
* :ref:`sgx_virt`
* :ref:`sriov_virtualization`
* :ref:`using_grub`
* :ref:`using_hybrid_mode_on_nuc`
* :ref:`using_partition_mode_on_nuc`
* :ref:`using_windows_as_uos`
* :ref:`using_zephyr_as_uos`
* :ref:`vuart_config`
* :ref:`how-to-enable-secure-boot-for-windows`
* :ref:`acrn-dm_parameters`
Because we're dropped deprivileged boot mode support, we're also
switching our Service VM of choice away from Clear Linux and have
removed Clear Linux-specific tutorials. Deleted documents are still
available in the `version-specific v2.1 documentation
<https://projectacrn.github.io/v2.1/>`_.
Fixed Issues Details
********************
- :acrn-issue:`4958` - clean up spin lock for hypervisor
- :acrn-issue:`5316` - add default BAR GPA for vmsi over msi
- :acrn-issue:`5346` - Hide PCI bridge 00:1c.0 from SOS
- :acrn-issue:`5411` - Supporting power off for pre-launched VMs
- :acrn-issue:`5461` - DM: gvt: Identical mapping for GPU DSM
- :acrn-issue:`5463` - WaaG hang in boot loading screen in cold boot test.
- :acrn-issue:`5482` - acrn-config: insert vbdf in hex format and vuart vbdf logic
- :acrn-issue:`5490` - Unhandled Exception happened in HV console when shutdown YaaG with shm device enabled
- :acrn-issue:`5491` - TGL can't setup 6 pci-vuarts
- :acrn-issue:`5498` - Hide IO 0x3f8 for SOS
- :acrn-issue:`5501` - [WHL][Yocto][Hybrid] in hybrid mode ACRN HV env, can not shutdown pre-launched RTVM
- :acrn-issue:`5506` - [EHL][SBL][hybrid_rt] in hybrid_rt, TPM can not work in pre-launched RTVM
- :acrn-issue:`5508` - hv-bugfix-for-hv-emulated-device-de-init_v2.3
- :acrn-issue:`5514` - Coding style issue for xhci.c
Known Issues
************
- :acrn-issue:`5151` - [WHL][VxWorks] Launch VxWorks fails due to no suitable video mode found
- :acrn-issue:`5369` - [TGL][qemu] Cannot launch qemu on TGL
- :acrn-issue:`5572` - [WHL][Hybrid_rt] build hybrid_rt hv from source, boot RTVM fail
- :acrn-issue:`5573` - [EHL][logical_partition] build EHL logical_partition hv from source Fail

298
doc/release_notes/release_notes_2.4.rst
View File

@ -1,298 +0,0 @@
.. _release_notes_2.4:
ACRN v2.4 (Apr 2021)
####################
We are pleased to announce the release of the Project ACRN hypervisor
version 2.4.
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 either download this source code as a zip or
tar.gz file (see the `ACRN v2.4 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v2.4>`_) or
use the Git ``clone`` and ``checkout`` commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v2.4
The project's online technical documentation is also tagged to
correspond with a specific release: generated v2.4 documents can be
found at https://projectacrn.github.io/2.4/. Documentation for the
latest under-development branch is found at
https://projectacrn.github.io/latest/.
ACRN v2.4 requires Ubuntu 18.04. Follow the instructions in the
:ref:`rt_industry_ubuntu_setup` to get started with ACRN.
What's New in v2.4
******************
Extensive work was done to redesign how ACRN
configuration is handled, update the build process to use the new
configuration system, and update the corresponding documentation. This is a
significant change and improvement to how you configure ACRN but also impacts
existing projects, as explained in the next section.
We've also validated the hybrid_rt scenario on the next generation of Intel®
Core™ processors (codenamed Elkhart Lake) and enabled software SRAM and cache
locking for real time performance on Elkhart Lake.
ACRN Configuration and Build
============================
The following major changes on ACRN configuration and build process have been
integrated into v2.4:
- Metadata of configuration entries, including documentation and attributes,
has been removed from ``scenario`` XMLs.
- The C sources generated from ``board`` and ``scenario`` XMLs are no longer
maintained in the repository. Instead they'll be generated as part of the
hypervisor build. Users can now find them under ``configs/`` of the build
directory.
- Kconfig is no longer used for configuration. Related build targets, such as
``defconfig``, now apply to the configuration files in XML.
- The ``make`` command-line variables ``BOARD`` and ``BOARD_FILE`` have been
unified. Users can now specify ``BOARD=xxx`` when invoking ``make`` with
``xxx`` being either a board name or a (relative or absolute) path to a
board XML file. ``SCENARIO`` and ``SCENARIO_FILE`` have been unified in the same
way.
For complete instructions to get started with the new build system, refer to
:ref:`getting-started-building`. For an introduction on the concepts and
workflow of the new configuration mechanism, refer to
:ref:`acrn_configuration_tool`.
Upgrading to v2.4 From Previous Releases
****************************************
We highly recommended that you follow the instructions below to
upgrade to v2.4 from previous ACRN releases.
.. _upgrade_python:
Additional Dependencies
=======================
Python version 3.6 or higher is required to build ACRN v2.4. You can check the version of
Python you are using by:
.. code-block:: bash
$ python3 --version
Python 3.5.2
Only when the reported version is less than 3.6 (as is the case in the example above) do
you need an upgrade. The first (and preferred) choice is to install the latest
Python 3 from the official package repository:
.. code-block:: bash
$ sudo apt install python3
...
$ python --version
Python 3.8.8
If this does not get you an appropriate version, you may use the deadsnakes PPA
(using the instructions below) or build from source yourself.
.. code-block:: bash
$ sudo add-apt-repository ppa:deadsnakes/ppa
$ sudo apt-get update
$ sudo apt install python3.9
$ python --version
Python 3.9.2
In addition, the following new tools and packages are needed to build ACRN v2.4:
.. code-block:: bash
$ sudo apt install libxml2-utils xsltproc
$ sudo pip3 install lxml xmlschema
.. note::
This is not the complete list of tools required to build ACRN. Refer to
:ref:`getting-started-building` for a complete guide to get started from
scratch.
Configuration File Format
=========================
Starting with release v2.4, Kconfig is no longer used, and the contents of scenario
XML files have been simplified. You need to upgrade your own Kconfig-format files
or scenario XML files if you maintain any.
For Kconfig-format file, you must translate your configuration to a scenario
XML file where all previous Kconfig configuration entries are also available. Refer
to :ref:`scenario-config-options` for the full list of settings available in
scenario XML files.
For scenario XML files, you need to remove the obsolete metadata in those files. You can use
the following XML transformation (in XSLT) for this purpose:
.. code-block:: xml
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet
version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="@desc" />
<xsl:template match="@configurable | @multiselect | @readonly" />
<!-- The identity template -->
<xsl:template match="@*|node()">
<xsl:copy>
<xsl:apply-templates select="@*|node()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>
After saving the snippet above to a file (e.g., ``remove_metadata.xsl``), you
can use ``xsltproc`` to clean and transform your own scenario XML file:
.. code-block:: bash
$ xsltproc -o <path/to/output> remove_metadata.xsl <path/to/your/XML>
New Configuration Options
=========================
The following element is added to scenario XML files in v2.4:
- :option:`hv.FEATURES.ENFORCE_TURNOFF_AC`
To upgrade a v2.3-compliant scenario XML file, you can use the following XML
transformation. The indentation in this transformation are carefully tweaked for
the best indentation in converted XML files.
.. code-block:: xml
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet
version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="hv/FEATURES/MULTIBOOT2">
<xsl:copy>
<xsl:apply-templates select="@*|node()"/>
</xsl:copy>
<xsl:if test="not(../ENFORCE_TURNOFF_AC)">
<xsl:text>
</xsl:text>
<ENFORCE_TURNOFF_AC>y</ENFORCE_TURNOFF_AC>
</xsl:if>
</xsl:template>
<!-- The identity template -->
<xsl:template match="@*|node()">
<xsl:copy>
<xsl:apply-templates select="@*|node()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>
Build Commands
==============
We recommend you update the usage of variables ``BOARD_FILE`` and
``SCENARIO_FILE``, which are being deprecated, and ``RELEASE``:
- ``BOARD_FILE`` should be replaced with ``BOARD``. You should not specify
``BOARD`` and ``BOARD_FILE`` at the same time.
- Similarly, ``SCENARIO_FILE`` should be replaced with ``SCENARIO``.
- The value of ``RELEASE`` should be either ``y`` (previously was ``1``) or
``n`` (previously was ``0``).
``BOARD_FILE`` and ``SCENARIO_FILE`` can still be used but will take effect
only if ``BOARD`` and ``SCENARIO`` are not defined. They will be deprecated in
a future release.
Patches on Generated Sources
============================
The C files generated from board and scenario XML files have been removed from the
repository in v2.4. Instead they will be generated in the build output when building the
hypervisor.
Typically you should be able to customize your scenario by modifying the
scenario XML file rather than the generated files directly. But if that is not
possible, you can still register one or more patches that will be applied to
the generated files by following the instructions in
:ref:`acrn_makefile_targets`.
Modifying generated files is not a recommended practice.
If you find a configuration that is not flexible enough to meet your
needs, please let us know by sending mail to `the acrn-dev mailing
list <https://lists.projectacrn.org/g/acrn-dev>`_ or submitting a
`GitHub issue <https://github.com/projectacrn/acrn-hypervisor/issues>`_.
Document Updates
****************
With the changes to ACRN configuration noted above, we made substantial updates
to the ACRN documentation around configuration and options, as listed here:
.. rst-class:: rst-columns2
* :ref:`hv-config`
* :ref:`scenario-config-options`
* :ref:`acrn_configuration_tool`
* :ref:`vuart_config`
* :ref:`getting-started-building`
* :ref:`acrn-dm_parameters`
* :ref:`kernel-parameters`
Additional new or updated reference documents are also available, including:
.. rst-class:: rst-columns2
* :ref:`rt_industry_ubuntu_setup`
* :ref:`setup_openstack_libvirt`
* :ref:`using_windows_as_uos`
We've also made edits throughout the documentation to improve clarity,
formatting, and presentation throughout the ACRN documentation.
Deprivileged Boot Mode Support
==============================
Because we dropped deprivileged boot mode support (in v2.3), we also
switched our Service VM of choice away from Clear Linux and have
removed Clear Linux-specific tutorials. Deleted documents are still
available in the `version-specific v2.1 documentation
<https://projectacrn.github.io/v2.1/>`_.
Fixed Issues Details
********************
- :acrn-issue:`5626` - [CFL][industry] Host Call Trace once detected
- :acrn-issue:`5672` - [EHL][v2.4][config_tools] Pop error message while config multi_ivshmem_device.
- :acrn-issue:`5689` - [EHL][SBL] copy GPA error when booting zephyr as pre-launched VM
- :acrn-issue:`5712` - [CFL][EHL][Hybrid-rt][WAAG]Post Launch WAAG with USB_Mediator-USB3.0 flash disk/SSD with USB3.0 port .waag cannot access USB mass storage
- :acrn-issue:`5717` - [WaaG Ivshmem] windows ivshmem driver does not work with hv land ivshmem
- :acrn-issue:`5719` - [EHL][[Hybrid RT] it will pop some warning messages while launch vm
- :acrn-issue:`5736` - Launch script: Remove --pm_notify_channel uart parameter in launch script
- :acrn-issue:`5772` - The `RELEASE` variable is not correctly handled
- :acrn-issue:`5778` - [EHL][v2.4] Failed to build hv with hypervisor_tools_default_setting _for newboard
- :acrn-issue:`5798` - [EHL][V2.4][[Fusa Partition] cannot disable AC after modify AC configuration in Kconfig
- :acrn-issue:`5802` - [EHL][syzkaller]HV crash with info " rcu detected stall in corrupted" during fuzzing testing
- :acrn-issue:`5806` - [TGL][PTCM]Cache was not locked after post-RTVM power off and restart
- :acrn-issue:`5818` - [EHL][v2.4_rc1] Failed to boot up WAAG randomly
- :acrn-issue:`5863` - config-tools: loosen IVSHMEM_REGION restriction in schema
Known Issues
************
- :acrn-issue:`5369` - [TGL][qemu] Cannot launch qemu on TGL
- :acrn-issue:`5705` - [WindowsGuest] Less memory in the virtual machine than the initialization
- :acrn-issue:`5879` - hybrid_rt scenario does not work with large initrd in pre-launched VM
- :acrn-issue:`5888` - Unable to launch vm at the second time with pty,/run/acrn/life_mngr_$vm_name parameter added in the launch script

32
doc/release_notes/release_notes_2.5.1.rst
View File

@ -1,32 +0,0 @@
.. _release_notes_2.5.1:
ACRN v2.5.1 (Aug 2021)
######################
We are pleased to announce an update release of the Project ACRN hypervisor
version 2.5.1. This is a maintenance release based off the v2.5 branch that
provides an update with a few bug fixes and support for Trusted Platform Module
(TPM) 2.0.
There were no documentation changes in this update, so you can still refer to
the v2.5-specific documentation found at https://projectacrn.github.io/2.5/.
See the :ref:`release_notes_2.5` release notes for information about the v2.5
release.
What's New in v2.5.1
********************
Trusted Platform Module (TPM) 2.0 support
ACRN hypervisor now supports pre-launched VM remote attestation use cases by
passing the TPM 2.0 ACPI table provided by the BIOS to the pre-launched VM.
Fixed Issues Details
********************
.. comment example item
- :acrn-issue:`5626` - [CFL][industry] Host Call Trace once detected
- :acrn-issue:`6305` - Pre-launched Zephyr VM coud not get ACPI table
- :acrn-issue:`6334` - Hypervisor console does not support 64-bit bar PCI UART with 32-bit bar space

209
doc/release_notes/release_notes_2.5.rst
View File

@ -1,209 +0,0 @@
.. _release_notes_2.5:
ACRN v2.5 (Jun 2021)
####################
We are pleased to announce the release of the Project ACRN hypervisor
version 2.5.
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 either download this source code as a zip or
tar.gz file (see the `ACRN v2.5 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v2.5>`_) or
use Git ``clone`` and ``checkout`` commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v2.5
The project's online technical documentation is also tagged to
correspond with a specific release: generated v2.5 documents can be
found at https://projectacrn.github.io/2.5/. Documentation for the
latest under-development branch is found at
https://projectacrn.github.io/latest/.
ACRN v2.5 requires Ubuntu 18.04. Follow the instructions in the
:ref:`gsg` to get started with ACRN.
What's New in v2.5
******************
Nested Virtualization Technology Preview
A brand-new concept, nested virtualization, is introduced as a preview in this
v2.5 release. Nested virtualization lets you run virtual machine instances
inside of a guest VM that's running on the ACRN hypervisor. It's designed to
leverage the KVM/QEMU community's rich feature set while keeping ACRN's unique
advantages in partition mode and hybrid mode. Read more in the
:ref:`nested_virt` advanced guide.
Secure Boot Using EFI Stub
EFI stub, previously retired in favor of using direct boot, returns as an
alternative to end-to-end secure boot with Grub. The hypervisor, Service VM
kernel, and prelaunched VM kernel are packaged into a single ``acrn.efi`` blob
as an EFI application that can then be verified by the EFI BIOS. Read more in
the :ref:`how-to-enable-acrn-secure-boot-with-efi-stub` and
:ref:`how-to-enable-acrn-secure-boot-with-grub` advanced guides.
Modularization Improvements
:ref:`ACRN hypervisor modularization <modularity>` has been improved to be more
scalable, including change to multiboot, interrupt handling, paging and memory
management, and timers, with more to come in future releases.
Configuration and Build Process Improvements
The ACRN configuration and build process continues to evolve from the changes
made in the previous releases. For instructions using the build system, refer
to :ref:`getting-started-building`. For an introduction on the concepts and
workflow of the configuration tools and processes, refer to
:ref:`acrn_configuration_tool`.
Upgrading to v2.5 From Previous Releases
****************************************
We highly recommended that you follow these instructions to
upgrade to v2.5 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.5
extends the schema of board XMLs to summarize board information more
systematically. You must regenerate your board XML file using the new
board inspector when you upgrade to ACRN v2.5 to get the additional information
needed for configuration.
Before using the new board inspector, ensure you have Python >= 3.6 on the target
board and install the ``lxml`` PyPI package. Refer to :ref:`upgrade_python` for
detailed steps to check and upgrade your Python version. The ``lxml`` package can be
installed by executing the following command:
.. code-block:: bash
sudo pip3 install lxml
.. note::
Refer to :ref:`gsg` for a complete list of tools required to
run the board inspector.
With the prerequisites done, copy the entire board inspector folder from
``misc/config_tools/board_inspector`` to the target board, ``cd`` to that
directory on the target, and run the board inspector tool using::
sudo python3 cli.py <my_board_name>
This will generate ``<my_board_name>.xml`` in the current working directory.
You'll need to copy that XML file back to the host system to continue
development.
Add New Configuration Options
=============================
In v2.5, the following elements are added to scenario XML files:
- ``hv.FEATURES.NVMX_ENABLED``
- :option:`vm.PTM`
The following element is renamed:
- :option:`hv.FEATURES.SSRAM.SSRAM_ENABLED` (was ``hv.FEATURES.PSRAM.PSRAM_ENABLED`` in v2.4)
Constraints on values of the following element have changed:
- ``vm.guest_flags.guest_flag`` no longer accepts an empty text. For VMs
with no guest flag set, set the value to ``0``.
Document Updates
****************
With the changes to ACRN configuration, we made updates
to the ACRN documentation around configuration, options, and parameters:
.. rst-class:: rst-columns2
* :ref:`acrn_configuration_tool`
* :ref:`scenario-config-options`
* :ref:`acrn-dm_parameters`
* :ref:`kernel-parameters`
New capabilities are documented here:
* :ref:`nested_virt`
We've also made edits throughout the documentation to improve clarity,
formatting, and presentation throughout the ACRN documentation:
.. rst-class:: rst-columns2
* :ref:`contribute_guidelines`
* :ref:`doc_guidelines`
* :ref:`ahci-hld`
* :ref:`hv-device-passthrough`
* :ref:`hv-hypercall`
* :ref:`timer-hld`
* :ref:`l1tf`
* :ref:`modularity`
* :ref:`sw_design_guidelines`
* :ref:`trusty_tee`
* :ref:`getting-started-building`
* :ref:`gsg`
* :ref:`hardware`
* :ref:`acrn_on_qemu`
* :ref:`acrn_doc`
* :ref:`enable_ivshmem`
* Run Debian as the Service VM
* :ref:`trusty-security-services`
* :ref:`using_hybrid_mode_on_nuc`
* :ref:`connect_serial_port`
Fixed Issues Details
********************
.. comment example item
- :acrn-issue:`5626` - [CFL][industry] Host Call Trace once detected
- :acrn-issue:`5626` - [CFL][industry] Host Call Trace once detected
- :acrn-issue:`5879` - hybrid_rt scenario does not work with large initrd in pre-launched VM
- :acrn-issue:`6015` - HV and DM: Obsolete terms cleanup for SSRAM
- :acrn-issue:`6024` - config-tools: generate board_info.h and pci_dev.c using xslt
- :acrn-issue:`6034` - dm: add allow_trigger_s5 mode to pm_notify_channel uart
- :acrn-issue:`6038` - [REG][RAMDISK] Fail to launch pre RTVM while config ramdisk
- :acrn-issue:`6056` - dm: a minor bug fix of unregister_mem_int
- :acrn-issue:`6072` - [WHL][WAAG]use config tool to passthru Audio,will not display GOP
- :acrn-issue:`6075` - [config_tools][regression][v2.5_rc1] config tool failed to save industry.xml with GuestFlagsOptionsType check
- :acrn-issue:`6078` - Make ACRN HV with hybrid_rt bootable without GRUB on UEFI BIOS
- :acrn-issue:`6100` - virtio_net_ping_rxq SEGV on read from NULL
- :acrn-issue:`6102` - Build failure for BOARD=qemu SCENARIO=sdc on release_2.5
- :acrn-issue:`6104` - [acrn-configuration-tool] Need update tgl-rvp.xml to the latest BIOS info
- :acrn-issue:`6113` - [config_tools][ADL-S]generated board xml parse error on ADL-S
- :acrn-issue:`6120` - [acrn-configuration-tool] shall we add CLOS_MASK elements into tgl scenario files as default configuration
- :acrn-issue:`6126` - TPM do not support dynamic GPA
- :acrn-issue:`6129` - virtio: NULL deref in hw/pci/virtio/virtio.c:664 in vq_endchains
- :acrn-issue:`6131` - guest/vlapic fatal assertion reachable from guest - DoS
- :acrn-issue:`6134` - [acrn-configuration-tool] lxml module not found when get board xml following doc
- :acrn-issue:`6138` - config-tools: support of launch script to generate the "allow_trigger_s5" automatically
- :acrn-issue:`6147` - ASAN reports UAF + SEGV when fuzzing exposed PIO with Hypercube guest VM.
- :acrn-issue:`6157` - coding style fix on v2.5 branch
- :acrn-issue:`6162` - [REG][EHL][SBL] Fail to boot sos
- :acrn-issue:`6168` - SOS failed to boot with nest enabled
- :acrn-issue:`6172` - member access within null pointer of type 'struct xhci_trb'
- :acrn-issue:`6178` - config-tools: adding an empty node <pt_intx> for a pre-launched VM causing check_pt_intx throw out an error
- :acrn-issue:`6185` - [TGL][Industry]yaag can't get ip after SRIVO VF passthru
- :acrn-issue:`6186` - [acrn-configuration-tool] CONFIG_MAX_MSIX_TABLE_NUM value is auto set as 64 when generate an new scenario xml
- :acrn-issue:`6199` - [doc][buildSource] can not pass SCENARIO parameter into hypervisor/build/.config with "make defconfig"
Known Issues
************
- :acrn-issue:`6256` - [TGL][qemu] Cannot launch qemu on TGL
- :acrn-issue:`6257` - [S5]S5 fails on post-launched RTVM

153
doc/release_notes/release_notes_2.6.rst
View File

@ -1,153 +0,0 @@
.. _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

259
doc/release_notes/release_notes_2.7.rst
View File

@ -1,259 +0,0 @@
.. _release_notes_2.7:
ACRN v2.7 (Dec 2021)
####################
We are pleased to announce the release of the Project ACRN hypervisor
version 2.7.
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.7 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v2.7>`_) or
use Git ``clone`` and ``checkout`` commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v2.7
The project's online technical documentation is also tagged to
correspond with a specific release: generated v2.7 documents can be
found at https://projectacrn.github.io/2.7/. Documentation for the
latest development branch is found at https://projectacrn.github.io/latest/.
ACRN v2.7 requires Ubuntu 18.04. Follow the instructions in the
:ref:`gsg` to get started with ACRN.
What's New in v2.7
******************
API and Documentation Updates for User VM and Service VM Terminology
More often than not, the terms "UOS" and "SOS" referred to the User VM and
Service VM components of an ACRN Hypervisor system and not to the VM's OS.
We've updated the hypervisor APIs and documentation to properly reflect these
names and removed uses of UOS and SOS.
In the code, uses of ``uos`` and ``sos`` in names were changed to ``user_vm``
and ``service_vm`` respectively. When specifically referring to the OS of
these VMs, we now use ``user_vm_os`` and ``service_vm_os``. These changes
appear throughout the C files, as well as in the ``.xml`` configuration
files.
For example, here are examples of old and new names:
.. list-table::
:widths: 1 1
:header-rows: 1
* - Old Name
- New Name
* - ``#define SOS_SOCKET_PORT 0x2000``
- ``#define SERVICE_VM_SOCKET_PORT 0x2000``
* - ``pkt->uos_active``
- ``pkt->user_vm_active``
* - ``static uint16_t get_uos_count(void)``
- ``static uint16_t get_user_vm_count(void)``
* - ``static uint16_t get_phy_addr(uint8_t uos_id, uint16_t vaddr)``
- ``static uint16_t get_phy_addr(uint8_t user_vmid, uint16_t vaddr)``
Update Scenario Names
The pre-defined scenario names were changed to be indicative of their
properties instead of an example use. The "industry" scenario is now called
"shared", the "logical partitioning" scenario is now called "partitioned",
and the "hybrid" scenario name remains the same.
Here are the three configuration scenarios:
* **Shared**: The physical hardware resources can be shared among
post-launched User VMs. The Service VM (Device Model) provides device
emulation for the shared virtual devices.
* **Partitioned**: The physical resources are strictly dedicated to
individual pre-launched User VMs and there is no Service VM needed.
* **Hybrid**: The physical resource are dedicated to pre-launched User
VMs and the Service VM provides resource emulation and sharing for
post-launched User VMs, all in the same system configuration.
User-Friendly VM names
Instead of using a UUID as the User VM identifier, we're now using a
user-friendly VM name.
Extend Use of CAT Cache Tuning to VMs
In previous releases, Cache Allocation Technology (CAT) was available only
at the hypervisor level and with per-pCPU granularity. In this v2.7 release,
each VM with exclusive cache resources can partition them with
per-thread granularity and allocate cache resources to prioritized tasks.
Expand Passthrough Device Use Cases
We now allow *pre-launched* VMs (in partitioned or hybrid scenarios) to use
graphics device passthrough for improved performance, a feature previously
available to only post-launched VMs.
Trusted Platform Module (TPM) 2.0 and its associated resource can now be
passthrough to *post-launched* VMs, a feature previously available to
only pre-launched VMs..
Upgrading to v2.7 From Previous Releases
****************************************
We highly recommended that you follow these instructions to
upgrade to v2.7 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.7 adds
the following hardware information to board XMLs to support new features and
fixes.
- Always initialize ``hw_ignore`` when parsing ``DMAR``.
The new board XML can be generated using the ACRN board inspector in the same
way as ACRN v2.6. Refer to :ref:`acrn_config_workflow` for a complete list of
steps to deploy and run the tool.
Update Configuration Options
============================
In v2.7, the following elements are added to scenario XML files.
- :option:`vm.name` (This is a required element. Names must be unique, up to 15
characters long, and contain no space characters.)
- :option:`hv.CAPACITIES.MAX_VM_NUM` (Default value is ``8``)
- :option:`hv.FEATURES.RDT.VCAT_ENABLED` (Default value is ``n``)
The following elements were removed.
- ``KATA_VM`` VM type.
- ``hv.CAPACITIES.MAX_EFI_MMAP_ENTRIES``
- ``hv.MEMORY.HV_RAM_SIZE`` (Hypervisor RAM size is now computed by the linker)
As part of using consistent names for UOS and SOS, we also change configuration
option names or values using these obsolete terms:
- The :option:`vm.vm_type` option value ``SOS_VM`` is now ``SERVICE_VM``
- The ``vm.legacy_vuart.base`` option value ``SOS_VM_COM1_BASE`` is now
``SERVICE_VM_COM1_BASE``, with the same change for COM2, COM3, and COM4 base
and for the ``vm.legacy_vuart.irq`` option values.
In v2.7, the ``acrn-dm`` command line parameter ``--cpu_affinity`` is now mandatory
when launching a User VM. If the launch XML settings, used to generate the launch
scripts, do not specify a ``cpu_affinity`` value, the ACRN Configurator will look for
it from the scenario XML settings. Verify that your existing launch scripts
specify this ``--cpu_affinity`` parameter as ``acrn-dm`` will now complain if it's
missing.
Document Updates
****************
We've updated references throughout the documentation to use "Service VM" and
"User VM" instead of "SOS" and "UOS" respectively.
We've also made edits throughout the documentation to improve clarity,
formatting, and presentation:
.. rst-class:: rst-columns2
* :ref:`hv-device-passthrough`
* :ref:`vt-d-hld`
* :ref:`faq`
* :ref:`gsg`
* :ref:`overview_dev`
* :ref:`hypervisor-make-options`
* :ref:`acrn_configurator_tool`
* :ref:`acrn_on_qemu`
* :ref:`enable_ivshmem`
* :ref:`enable-s5`
* :ref:`using_grub`
* :ref:`using_partition_mode_on_nuc`
* :ref:`acrn-dm_parameters`
* :ref:`acrntrace`
Fixed Issues Details
********************
.. comment example item
- :acrn-issue:`5626` - [CFL][industry] Host Call Trace once detected
- :acrn-issue:`5112` - ACRN debug shell help output behavior, line length, and misspellings
- :acrn-issue:`5626` - [CFL][industry] Host Call Trace once detected
- :acrn-issue:`5692` - Update config option documentation in schema definition files
- :acrn-issue:`6012` - [Mainline][PTCM] [ConfigTool]Obsolete terms cleanup for SSRAM
- :acrn-issue:`6024` - [TGL][Master][IVSHMEM] Only one share memory device in SOS while enabled two from the scenario xml
- :acrn-issue:`6270` - [ADL-S][Industry][Yocto] WaaG boot up but no UI display with more than 1G memory
- :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:`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:`6387` - enable GVT-d for pre-launched linux guest
- :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:`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:`6494` - acrn_trace build failure with latest e2fsprogs v1.46.2 version
- :acrn-issue:`6502` - [ADL][HV][UC lock] SoS kernel panic when #GP for UC lock enabled
- :acrn-issue:`6508` - [HV]Refine pass-thru device PIO BAR handling
- :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:`6542` - [hypercube][tgl][ADL] mem leak while poweroff in guest
- :acrn-issue:`6562` - [ADL-S][Config tool] fail to tpm_getcap -l
- :acrn-issue:`6565` - [acrn-configuration-tool] "modprobe pci_stub" should be executed before unbinding passthru devices
- :acrn-issue:`6572` - [ADL-S][Acrntrace]failed to run acrntrace test
- :acrn-issue:`6584` - HV:check vmx capability
- :acrn-issue:`6592` - [doc] failed to make hvdiffconfig
- :acrn-issue:`6610` - [config tool vUART] IRQ of vUART of pnp 8250 is not generated correctly
- :acrn-issue:`6620` - acrn-config: pass-thru device PIO BAR identical mapping
- :acrn-issue:`6663` - Current HV_RAM_SIZE calculation algorithm sometimes cause build failure
- :acrn-issue:`6674` - [TGL][HV][hybrid] (v2.7 only) during boot zephyr64.elf find HV error: "Unable to copy HPA 0x100000 to GPA 0x7fe00000 in VM0"
- :acrn-issue:`6677` - Service VM shall not have capability to access IOMMU
- :acrn-issue:`6704` - [ADL-S][Partitioned]Kernel panic when boot Pre-launched RTVM with 8 pci devices passthru
- :acrn-issue:`6709` - Issues for platform ICX-D HCC enabling
- :acrn-issue:`6719` - Board Inspector tool crashes if cpuid is not installed
- :acrn-issue:`6724` - (v2.7 only) Remove the GET_PLATFORM_INFO support in ACRN
- :acrn-issue:`6736` - Improved readability desirable for the Board Inspector tool
- :acrn-issue:`6743` - acrn-crashlog/acrnprobe compilation failure with OpenSSL 3.0
- :acrn-issue:`6752` - ACRN HV shows multiple PCIe devices with "out of mmio window" warnings - false alert
- :acrn-issue:`6755` - [icx-d lcc]CAT_capability enable RDT fail
- :acrn-issue:`6767` - [acrn-configuration-tool] Getting duplicate PT_SLOT value If generate launch script continuously through the UI
- :acrn-issue:`6769` - [v2.7] vulnerable coding style in hypervisor and DM
- :acrn-issue:`6778` - [ADL][SSRAM][Master]Error messages output during RTCM unit test
- :acrn-issue:`6780` - [ADL][SSRAM][Master]ACRN boot crash with SSRAM enabled
- :acrn-issue:`6799` - [REG][ADL-S][VxWorks] SOS force reboot while launching vxworks
- :acrn-issue:`6834` - [Acrn-hypervisor][Debug release]Failed to build hypervisor with hv_debug_release enable
- :acrn-issue:`6848` - [ADL][RTVM]ACPI error while launching rtvm
- :acrn-issue:`6851` - [DM] segfault on virtio_console_control_tx()
- :acrn-issue:`6877` - [DM][ASAN] UAF in mevent_handle()
- :acrn-issue:`6885` - adl-s-shared sos can't get in
- :acrn-issue:`6888` - [ADL-S]Yaag reboots too slowly
- :acrn-issue:`6899` - [ADL-S][shared] Core type error when launch RTVM use atom core.
- :acrn-issue:`6907` - [ADL-S][ICX-D][shared][Regression]Multi RT launch failed with V2.7_RC3 build.
- :acrn-issue:`6908` - [ADL-S][Multi_RT]Shutdown one RT and others will hang when launch multi RT.
- :acrn-issue:`6919` - [hypercube][ADL] mem leak while power off in guest (phase-II)
- :acrn-issue:`6931` - [ADL][CPUID] RTVM CPUID 0x2 EBX value is not equal to HV cpuid 0x2 EBX
Known Issues
************
- :acrn-issue:`6631` - [KATA] Kata support is broken in v2.7
- :acrn-issue:`6978` - [TGL] openstack failed with ACRN v2.7

81
doc/release_notes/release_notes_3.0.rst Normal file
View File

@ -0,0 +1,81 @@
.. _release_notes_3.0:
ACRN v3.0 (DRAFT)
#################
We are pleased to announce the release of the Project ACRN hypervisor
version 3.0.
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 v3.0 GitHub release page
<https://github.com/projectacrn/acrn-hypervisor/releases/tag/v3.0>`_) or
use Git ``clone`` and ``checkout`` commands::
git clone https://github.com/projectacrn/acrn-hypervisor
cd acrn-hypervisor
git checkout v3.0
The project's online technical documentation is also tagged to
correspond with a specific release: generated v3.0 documents can be
found at https://projectacrn.github.io/3.0/. Documentation for the
latest development branch is found at https://projectacrn.github.io/latest/.
ACRN v3.0 requires Ubuntu 20.04. Follow the instructions in the
:ref:`gsg` to get started with ACRN.
What's New in v3.0
******************
Upgrading to v3.0 From Previous Releases
****************************************
We highly recommended that you follow these instructions to
upgrade to v3.0 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 v3.0 adds
the following hardware information to board XMLs to support new features and
fixes.
- TBD
The new board XML can be generated using the ACRN board inspector in the same
way as ACRN v2.7. Refer to :ref:`acrn_config_workflow` for a complete list of
steps to deploy and run the tool.
Update Configuration Options
============================
Complete overhaul of configurator in v3.0...
Document Updates
****************
We've also made edits throughout the documentation to improve clarity,
formatting, and presentation.
Fixed Issues Details
********************
.. comment example item
- :acrn-issue:`5626` - [CFL][industry] Host Call Trace once detected
Known Issues
************