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

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
  • 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.

• 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

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