MacHyperVSupport

Hyper-V integration services for macOS. Requires a Generation 2 virtual machine on Windows 8.1 or higher.

Supported Hyper-V devices and services

• Heartbeat
• Guest shutdown
• Synthetic graphics (partial support)
• Synthetic mouse
• Synthetic keyboard
• Synthetic SCSI controller
• Synthetic network controller

Additional information

• The following SSDTs should be used for proper operation:

  • SSDT-HV-CPU: Required on Windows 10 as Hyper-V on this version may not expose processors as Processor objects
  • SSDT-HV-PLUG: Ensures VMPlatformPlugin loads on Big Sur, avoids freezes with the default PlatformPlugin
  • SSDT-HV-VMBUS: Enables correct Startup Disk operation

• On older versions of macOS, IOSCSIParallelFamily (com.apple.iokit.IOSCSIParallelFamily) may need to be Force injected. Refer to the OpenCore Configuration manual for details.

• Booter quirks

  • AllowRelocationBlock - required for macOS 10.7 and older
  • AvoidRuntimeDefrag - required
  • ForceExitBootServices - required for macOS 10.7 and older
  • RebuildAppleMemoryMap - required for macOS 10.6 and older

• Kernel quirks

  • ProvideCurrentCpuInfo - required for proper TSC/FSB values and CPU topology values.

• UEFI quirks

  • DisableSecurityPolicy - required on Windows 10 and newer

• Lilu is required for patching and library functions

• Installer images can either be passed in from USB hard disks, or converted from a DMG to a VHDX image using qemu-img:

  • DMGs need to be in a read/write format first.
  • qemu-img convert -f raw -O vhdx Installer.dmg Installer.vhdx

Boot arguments

Module	Debug	Message Debug	Off
CPU disabler (10.4)	-hvcpudbg	N/A	N/A
Graphics	-hvgfxdbg	-hvgfxmsgdbg	-hvgfxoff
Heartbeat	-hvheartdbg	-hvheartmsgdbg	-hvheartoff
Keyboard	-hvkbddbg	-hvkbdmsgdbg	-hvkbdoff
Mouse	-hvmousdbg	-hvmousmsgdbg	-hvmousoff
Network	-hvnetdbg	-hvnetmsgdbg	-hvnetoff
PCI bridge	-hvpcibdbg	-hvpcibmsgdbg	-hvpciboff
PCI module support	-hvpcimdbg	N/A	N/A
PCI provider	-hvpcipdbg	N/A	N/A
PCI root bridge	-hvpcirdbg	N/A	N/A
Shutdown	-hvshutdbg	-hvshutmsgdbg	-hvshutoff
Storage	-hvstordbg	-hvstormsgdbg	-hvstoroff
VMBus controller	-hvvmbusdbg	N/A	N/A
VMBus device nub	-hvvmbusdevdbg	N/A	N/A

Credits

• Apple for macOS
• Goldfish64 for this software
• vit9696 for Lilu.kext and providing assistance
• Microsoft Hypervisor Top-Level Functional Specification
• Linux and FreeBSD Hyper-V integration services