Contribute
Register

[HOW TO] OpenCore 0.6.5 > 0.6.6 differences

Joined
Dec 10, 2010
Messages
736
Motherboard
Gigabyte Z390 Aorus Elite
CPU
i9-9900K
Graphics
RX 580
Mobile Phone
  1. iOS
LauncherOption instead of Bootstrap.efi

In OC 0.6.6 there is a major change from previous versions. Until now OC was an EFI driver and it needed a loader. Bootstrap.efi or BOOTx64.efi performed this function. But now OC is an app and it no longer needs a loader. This improves compatibility with UEFI firmwares.
End user will notice this change by the absence of Bootstrap folder and the substitution in config.plist of Misc> Security> BootProtect key with LauncherOption and LauncherPath keys, both in Misc> Boot.

In Dortania's guide they explain this change but in summary the process can be similar to this:
  • Enter into Boot section of BIOS setup to erase entries that contain OpenCore, placing macOS disk as the first option
  • ResetNVRAM in OC menu
  • Prepare OC 0.6.6 EFI folder
  • Configure LauncherOption and LauncherPath
    LauncherOption=Disabled
    LauncherPath=Default
  • Reboot by removing OpenCore entries in BIOS again and cleaning NVRAM.
From now on there are 2 ways to work.
  • LauncherOption=Disabled (equivalent to BootProtect=None in OC 0.6.5): computer's boot menu shows connected disks but OC does not write its own entry into BIOS
  • LauncherOption=Full (equivalent to BootProtect=Bootstrap in OC 0.6.5): OC writes an entry into BIOS pointing directly to OpenCore.efi and the computer's boot menu shows OC and connected disks.
LauncherOption=Full must be accompanied by UEFI> Quirks> RequestBootVarRouting=True.

config.plist
  • Kernel> Quirks> added SetApfsTrimTimeout (number) to improve trim command on APFS disks, it can be -1
  • Misc> Boot> added LauncherOption (string) and LauncherPath (string)
  • Misc> Security> removed BootProtect
  • Platform> Generic> added MaxBIOSVersion (boolean), can be False
  • Platform> added UseRawUuidEncoding (boolean) to choose the encoding style of SMBIOS UUID, can be False
  • UEFI> Audio> PlayChime (string) cannot be empty
  • UEFI> Input> KeySupportMode (string) cannot be empty, default is Auto
  • UEFI> Input> PointerSupportMode (string) cannot be empty if PointerSupport is enabled
  • UEFI> Quirks> added DisableSecurityPolicy (boolean) to disable various security measures in the firmware eliminating the possibility of having Secure Boot. It can be False. It should not be True if UEFI Secure Boot is used.
Files and folders
  • Bootstrap folder has been removed.
  • VBoxHfs.efi driver has been replaced by OpenHfsPlus.efi derived from Apple's proprietary driver, it still does not reach the performance of HfsPlus.efi but outperforms VBoxHfs.efi.
  • OpenPartitionDxe.efi driver has been added incorporating Apple Partition Management scheme to support older systems (mac OS 10.8 and 10.9).
  • ocvalidate tool has been improved in the Misc, NVRAM and UEFI sections
  • OpenCanopy has been improved. In this version I have had to use the Resources folder from the Andy1970AppleLife GitHub site because OC 0.6.6 needs 2 new icons, Left and Right. If they are missing, the Picker is displayed in text mode.
    In Misc> Boot, PickerVariant key can have different values (Auto, Default, Old, Modern) and Images folder within Resources can have icon sets of 3 groups: no prefix (Default), prefixed with Modern and prefixed with Old. Auto option chooses the set of icons according to the NVRAM variable DefaultBackgroundColor, for Light Gray it chooses the Old prefix, for any other color it chooses the set without prefix.
    OpenCanopy has also added the option of image as the background of the Picker screen.
Note: For OpenCanopy icons, it's recommended to read this post by blackosx with a detailed explanation of the changes in OpenCanopy in OC 0.6.6. This user also has icons for 0.6.6 and a command to generate custom icon sets, you have them in post 1 of the thread OpenCanopy Icons.
chris1111 also has updated icons for 0.6.6 and icon pack generator. In the thread My Simple theme OC + Icnspack-Builder.

Note: remember that, if you boot Windows from OC, to prevent OC from injecting SMBIOS values you have to act on these keys in config.plist:
  • Kernel> Quirks> CustomSMBIOSGuid> True (default is False)
  • PlatformInfo> UpdateSMBIOSMode> Custom (default is Create).
As extra help, I attach my config.plist from OC 0.6.6 configured for Coffee Lake processor. Serial numbers have been changed to not match mine.
 

Attachments

  • config.plist
    18.7 KB · Views: 213
Last edited:
Joined
Jan 1, 2014
Messages
136
Motherboard
HP ProBook 450 G1-Clover
CPU
i3-4000M
Graphics
HD 4600
Mac
  1. iMac
  2. MacBook
  3. MacBook Air
  4. MacBook Pro
Mobile Phone
  1. Android
One correction: "Platform> Generic> added UseRawUuidEncoding" is "Platform> added UseRawUuidEncoding"

I'm unable to boot after updating to OC 0.6.6 and mine is a Ivy Bridge family. HP Elite 8300 CMT. It is stuck in blank screen.
Thanks for sharing the need of Left and right icon. I'll try this out.
 
Joined
Oct 10, 2015
Messages
885
Motherboard
Z370 AORUS Gaming 3
CPU
i5-9600K
Graphics
RX 580
Mac
  1. MacBook
  2. MacBook Pro
Mobile Phone
  1. iOS
MaxBIOSVersion is a quirk exclusive to legacy Macs for preventing bricking during a macOS update by injecting the firmware version as 9999.999.999.999.999. The trick was discovered by some people on MacRumors and forwarded to the team of Legacy Patcher (Dortania), and ultimately 0.6.6 added the Boolean quirk.
 
Joined
Dec 10, 2010
Messages
736
Motherboard
Gigabyte Z390 Aorus Elite
CPU
i9-9900K
Graphics
RX 580
Mobile Phone
  1. iOS
MaxBIOSVersion is a quirk exclusive to legacy Macs for preventing bricking during a macOS update by injecting the firmware version as 9999.999.999.999.999. The trick was discovered by some people on MacRumors and forwarded to the team of Legacy Patcher (Dortania), and ultimately 0.6.6 added the Boolean quirk.
Thanks for the info. I didn't knew that.
 
Joined
Dec 10, 2010
Messages
736
Motherboard
Gigabyte Z390 Aorus Elite
CPU
i9-9900K
Graphics
RX 580
Mobile Phone
  1. iOS
... I'm unable to boot after updating to OC 0.6.6 and mine is a Ivy Bridge family. HP Elite 8300 CMT. It is stuck in blank screen...
I had the same problem (black screen) the first time I tried 0.6.6. I don't know what the cause was.
What I did was carefully go through config.plist for my CoffeLake CPU according to the Dortania guide. I'm not sure what I changed but this way the problem was fixed and now it starts fine.
 
Joined
Jan 5, 2016
Messages
20
Motherboard
Gigabyte GA-Z97-HD3
CPU
i7-4790
Graphics
Radeon RX580
Mac
  1. MacBook Air
Mobile Phone
  1. iOS
  • UEFI> Quirks> added DisableSecurityPolice (boolean) to disable various security measures in the firmware eliminating the possibility of having Secure Boot. It can be False. It should not be True if UEFI Secure Boot is used.
Shouldn't it be DisableSecurityPolicy?
 
Joined
Dec 10, 2010
Messages
736
Motherboard
Gigabyte Z390 Aorus Elite
CPU
i9-9900K
Graphics
RX 580
Mobile Phone
  1. iOS
  • UEFI> Quirks> added DisableSecurityPolice (boolean) to disable various security measures in the firmware eliminating the possibility of having Secure Boot. It can be False. It should not be True if UEFI Secure Boot is used.
Shouldn't it be DisableSecurityPolicy?
Yes, misspelling. Corrected, thanks.
 
Joined
Jan 1, 2014
Messages
136
Motherboard
HP ProBook 450 G1-Clover
CPU
i3-4000M
Graphics
HD 4600
Mac
  1. iMac
  2. MacBook
  3. MacBook Air
  4. MacBook Pro
Mobile Phone
  1. Android
I had the same problem (black screen) the first time I tried 0.6.6. I don't know what the cause was.
What I did was carefully go through config.plist for my CoffeLake CPU according to the Dortania guide. I'm not sure what I changed but this way the problem was fixed and now it starts fine.
I replaced HfsPlus.efi with OpenHfsPlus.efi in EFI/OC/Drivers and that did the trick.. I'm on OC 0.6.6
 
Top