Clover to Opencore

Chuyển từ Clover sang Opencore

Võ Nguyễn Hoàng Long

2021-10-01

16 min

Lý do có guide này: guide này hình thành là do 1 số bạn muốn chuyển bootloader Clover và OpenCore nhưng gặp số tình trạng như ko biết tính năng này ở đâu trong bootloader mới do đó mọi thứ bạn cần đề ở đây do hiện nay mọi người có xu hướng dùng opencore nhiều hơn nên ở đây mình sẽ viết theo lối convert từ Clover sang OpenCore nhưng người dùng Clover hoàn toàn có thể làm theo.

Cấu trúc EFI

Config

Cả hai OpenCore và Clover đều có

Drivers

Opencore: EFI --> OC --> Drivers

Clover: EFI –> Drivers –> UEFI (ngoài ra còn mục BIOS và OFF nhưng nó nằm ngoài phạm vi bài này)

Tool

Cấu trúc tương đương nhau

Kext

Opencore: EFI --> OC —> Kexts

Clover: EFI --> Kexts --> Other

ACPI

Cấu trúc đường dẫn tương đương nhau

Config

ACPI

ACPI Rename:

XHCI patch (bạn có thể map usb để thay thế)
- XHCI to XHC
- XHX1 to XHC
STA rename (OpenCore đã có)
- SAT0 to SATA
- SAT1 to SATA
IMEI rename (dùng WhateverGreen)
- HECI to IMEI
- HEC1 to IMEI
- MEI to IMEI
- IDER to MEID
Graphics patches (dùng WhateverGreen)
- GFX0 to IGPU
- PEG0 to GFX0
- PEGP to GFX0
- SL01 to PEGP
EC patches (bạn có thể dùng SSDT-EC)
- EC0 to EC
- H_EC to EC
- ECDV to EC
- PGEC to EC
Audio rename (dùng AppleALC)
- HDAS to HDEF
- CAVS to HDEF
- AZAL to HDEF
- ALZA to HDEF
- B0D3 to HDAU
Fix RTC (sử dụng SSDT-AWAC hoặc patch RTC)
- STAS to [Blank]
- Fix Z390 BIOS DSDT Device(RTC) bug
- Fix 300-series RTC Bug
Fix NVMe (dùng NVMeFix để thay thế)
- PXSX to ANS1
- PXSX to ANS2
AirPort/WiFi patches bcrm (dùng airport bcrm fixup)
- PXSX to ARPT
Các patch ACPI khác:
- LPC0 to LPCB (dùng SSDT-SBUS-MCHC)
- PC00 to PCIO
- FPU to MATH
- TMR to TIMR
- PIC to IPIC
- GBE1 to ETH0

Patches:

TgtBridge patches:
- ACPI -> Patch -> ... -> Base
DisableASPM:
- DeviceProperties -> Add -> PciRoot... -> pci-aspm-default | Data | <00>
HaltEnabler:
- ACPI -> Quirks -> FadtEnableReset -> YES

Fixes:

FixIPIC:
- SSDTTime là phương pháp thay thế.
FixSBUS:
- SSDT-SBUS-MCHC là phương pháp thay thế.
FixShutdown:
- FixShutdown-USB-SSDT
- _PTS to ZPTS Patch
FixDisplay:
- Patch framebuffer xem chi tiết tại đây.
FixHDA:
- AppleALC sử dụng.
FixHPET:
- Fix HPET.
FixSATA:
- Kernel -> Quirks -> ExternalDiskIcons -> YES
FixRTC:
- SSDTTime dùng SSDTTime patch hpet để thay thế.
FixTMR:
- SSDTTime dùng SSDTTime để patch HPET.
AddPNLF:
- SSDT-PNLF dùng SSDT-PNLF
AddMCHC:
- SSDT-SBUS-MCHC dùng SSDT này để thay thế.
AddIMEI:
- SSDT-SBUS-MCHC
- Cũng có thế dùng whatevergreen
- 1 số Sandy Bridge hoặc Ivy Bridge cần sử dụng SSDT-IMEI.
FakeLPC:
- DeviceProperties -> Add -> PciRoot... -> device-id
- fake device id để dử dụng bộ điều khiển LPC trong Apple LPC.
FixIntelGfx:
- Bạn có thể sử dụng WhateverGreen
AddHDMI:
- Bạn có thể sử dụng WhateverGreen

DropTables:

ACPI -> Delete

SSDT:

PluginType:
- SSDT-PLUG
P States: ssdtPRGen.sh (nếu Sandy Bridge và Ivy Bridge)
C States: ssdtPRGen.sh (nếu Sandy Bridge và Ivy Bridge)

Boot

Boot Argument:

NVRAM -> Add -> 7C436110-AB2A-4BBB-A880-FE41995C9F82 -> boot-args

NeverHibernate:

Misc -> Boot -> HibernateMode -> None

Default Boot Volume:

Misc -> Security -> AllowSetDefault -> True
- Ấn Ctrl+Enter ở màn hình gui opencore để chọn boot mặc định.
Hoặc bạn có thể dùng như RealMac ở trong Setting.

Boot Graphics

DefaultBackgroundColor:

NVRAM -> Add -> 4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14 -> DefaultBackgroundColor
- 00000000: Syrah Black
- BFBFBF00: Light Gray
- Bạn có thể tùy chọn màu bằng các convert mã màu RGB của bạn sang hex bằng hackintool hoặc bất kì trình chuyển đổi hex nào mà bạn muốn.

EFILoginHiDPI:

OpenCore sử dụng UI scaling UEFI -> Output

flagstate:

NVRAM -> Add -> 4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14 -> flagstate | Data | <>
- 0 -> <00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000>

UIScale:

NVRAM -> Add -> 4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14 -> UIScale | Data | <>
- 1 -> <01>
- 2 -> <02>

Devices

USB:

FixOwnership: UEFI -> Quirk -> ReleaseUsbOwnership
ClockID: DeviceProperties -> Add -> PciRoot... -> AAPL,clock-id
HighCurrent: DeviceProperties -> Add -> PciRoot... -> AAPL, HighCurrent
- Từ for OS X 10.11 and mới hơn.
- Đối với phiên bản mới hơn được xác định ở IOUSBHostFamily.kext -> AppleUSBHostPlatformProperties hoặc được add vào SSDT-EC-USBX cho Skylake SMBios mới hơn (gen 6 +)

Audio:

Bạn sẽ cần biết âm thanh đc đièu khiên qua device, sử dụng gfxutil để tìm ra chúng:

// mở terminal
path/to/gfxutil -f HDEF

Inject: DeviceProperties -> Add -> PciRoot... -> layout-id
AFGLowPowerState: DeviceProperties -> Add -> PciRoot... -> AFGLowPowerState -> <01000000>
ResetHDA: UEFI -> Audio -> ResetTrafficClass
- hoặc bạn có thể add vào boot-arg alctsel=1 cho apple alc

Add Properties:

Bạn cần xác định đường dẫn của PciRoot

Properties:

DeviceProperties -> Add

FakeID: bạn sẽ cần tìm đường dẫn tới PciRoot và cho nó vào DeviceProperties -> Add, tìm đường dẫn PciRoot bằng gfxutil.

USB
- device-id
- device_type
- device_type
IMEI
- device-id
- vendor-id
WIFI
- name
- compatible
LAN
- device-id
- compatible
- vendor-id
XHCI
- device-id
- device_type: UHCI
- device_type: OHCI
device_type: EHCI
- device-id
- AAPL,current-available
- AAPL,current-extra
- AAPL,current-available
- AAPL,current-extra
- AAPL,current-in-sleep
- built-in
device_type: XHCI
- device-id
- AAPL,current-available
- AAPL,current-extra
- AAPL,current-available
- AAPL,current-in-sleep
- built-in

ForceHPET:

UEFI -> Quirks -> ActivateHpetSupport

Disable Drivers

Bạn có thể ko thêm vào UEFI -> Drivers, hoặc thêm dấu # vào trước driver trong config để OpenCore bỏ qua nó.

Cả 2 đều có GUI, xem chi tiết tại đây

Graphics

InjectIntel:

GMA Patching

InjectAti:

DeviceProperties -> Add -> PciRoot... -> device-id
- ví dụ: <B0670000> cho R9 390X
DeviceProperties -> Add -> PciRoot... -> @0,connector-type
- bạn có thể cần patch connector theo bản sau chi ở đây

LVDS                    <02 00 00 00>
DVI (Dual Link)         <04 00 00 00>
DVI (Single Link)       <00 02 00 00>
VGA                     <10 00 00 00>
S-Video                 <80 00 00 00>
DP                      <00 04 00 00>
HDMI                    <00 08 00 00>
DUMMY                   <01 00 00 00>

InjectNvidia:

Patch nvcap

FakeIntel:

DeviceProperties -> Add -> PciRoot(0x0)/Pci(0x2,0x0) -> device-id
- ví dụ. 66010003 cho the HD 4000
DeviceProperties -> Add -> PciRoot(0x0)/Pci(0x2,0x0) -> vendor-id -> <86800000>

FakeAti:

DeviceProperties -> Add -> PciRoot... -> device-id
- ie: <B0670000> for the R9 390X
DeviceProperties -> Add -> PciRoot... -> ATY,DeviceID
- ie: <B067> for the R9 390X
DeviceProperties -> Add -> PciRoot... -> @0,compatible
- ie. ATY,Elodea for HD 6970M
DeviceProperties -> Add -> PciRoot... -> vendor-id-> <02100000>
DeviceProperties -> Add -> PciRoot... -> ATY,VendorID -> <0210>

xem chi tiết tại đây

Custom EDID

xem chi tiết tại đây

Dual Link:

DeviceProperties -> Add -> PciRoot... -> AAPL00,DualLink
- 1 -> <01000000>
- 0 -> <00000000>

NVCAP

xem chi tiết tại đây

display-cfg:

DeviceProperties -> Add -> PciRoot... -> @0,display-cfg
tham khảo tại Nvidia injection

LoadVBios:

Tạo 1 cấu trúc ssdt tương tự như sau

External (SB.PCI0.GFX0, DeviceObj)
External (SB.PCI0.PEG0, DeviceObj)
External (SB.PCI0.PEG0.PEGP, DeviceObj)
External ( DTGP , MethodObj)

Scope (\_SB.PCI0)
{
    Scope (PEG0)
    {
        Scope (PEGP)
        {
            Method (_DSM, 4, NotSerialized)  // _DSM: Device-Specific Method
            {
                Store (Package ()
                {
                    Buffer (0x00010000)
                    {
                        // Put your VBIOS here (you could extract it with Linux or Windows)
                    }

                }, Local0)
                DTGP (Arg0, Arg1, Arg2, Arg3, RefOf (Local0))
                Return (Local0)
            }
        }
     }
  }
}

NvidiaGeneric:

DeviceProperties -> Add -> PciRoot... -> model | string | Add the GPU name

NvidiaSingle:

xem chi tiết tại đây disable dgpu

NvidiaNoEFI:

DeviceProperties -> Add -> PciRoot... -> NVDA,noEFI | Boolean | True
tham khảo tại đây: GT 640 scramble

ig-platform-id:

DeviceProperties -> Add -> PciRoot(0x0)/Pci(0x2,0x0) -> APPL,ig-platform-id

BootDisplay:

DeviceProperties -> Add -> PciRoot... -> @0,AAPL,boot-display

RadeonDeInit:

Tính năng này hầu như ko cần nếu bạn có sử dụng WhateverGreen

Kernel and Kext Patches

KernelPm:

Kernel -> Quirks -> AppleXcpmCfgLock -> YES

AppleIntelCPUPM:

Kernel -> Quirks -> AppleCpuPmCfgLock -> YES

DellSMBIOSPatch:

sử dụng cho các hệ thống dell cũ sử dụng APTIO V

Kernel -> Quirks -> CustomSMBIOSGuid -> YES
PlatformInfo -> UpdateSMBIOSMode -> Custom

KextsToPatch:

Kernel -> Patch
1 số quy tắc đổi

comment : sử dụng cho cả opencore và clover

Disabled : tương ứng với mục enable ben opencore

MatchBuild : được thay thế bằng minkernel và maxkernel 

MatchOS : được thay thế bằng minkernel và maxkernel

Find : có ở opencore và clover

Replace : có cả ở opencore và clover

MaskFind : opencore sử dụng mask để thay thế

Mask replace : có cả ở opencore và clover

count ,limit, skip thường được đặt thành 0

Identifier thường được đặt thành kernel ( trông 1 số trường hợp khi bạn patch kext nào thì sẽ để đường dẫn theo kext đó vd như com.apple.iokit.IOGraphicsFamily )

KernelToPatch:

Kernel -> Patch

ForceKextsToLoad:

Kernel -> Force

Kernel LAPIC:

Kernel -> Quirks -> LapicKernelPanic -> YES

KernelXCPM:

Kernel -> Quirks -> AppleXcpmExtraMsrs -> YES

patch xcpm theo bảng dưới xem chi tiết tại đây

Base: _xcpm_bootstrap
Comment: _xcpm_bootstrap (Ivy Bridge) 10.15
Count: 1
Enabled: YES
Find: 8D43C43C22
Identifier: kernel
Limit: 0
Mask: FFFF00FFFF
MinKernel: 19.
MaxKernel: 19.99.99
Replace: 8D43C63C22
ReplaceMask: 0000FF0000
Skip: 0

cho low-end haswell+ pentium Celerons

USB Port Limit Patches:

Kernel -> Quirks -> XhciPortLimit -> YES

External Icons Patch:

Kernel -> Quirks -> ExternalDiskIcons -> YES
được sử dụng để cho ổ đĩa trong ở macos đc xem như ổ đĩa ngoài

AppleRTC

1 số lỗi về rtc

config.plist -> Kernel -> Quirks -> DisableRtcChecksum -> true

Xem chi tiết tại đây.

Bạn có thể ađ vào boot-arg để qua khỏi lỗi sau đó patch lại.

rtcfx_exclude=00-FF

FakeCPUID:

Kernel -> Emulate:

Cpuid1mask:  

//remove 0x và tách thành từng cặp

0x0306A9 ==> 03 06 A9

// đảo ngược thứ tự các cặp

03 06 A9 ==> A9 06 03

//thêm các số 0 vào sau dãy sô vừa đổi sao cho đủ 4 cặp mỗi cặp gồm 8 chữ số

A9 06 03 ==> A9060300 00000000 00000000 00000000

Cpuid1Data:

FFFFFFFF 00000000 00000000 00000000

xem chi tiết tại đây

Rt Variables

ROM:

Xem chi tiết tại đây

MLB:

PlatformInfo -> Generic -> MLB

BooterConfig:

NVRAM -> Add -> 4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14-> UIScale:
- 0x28: Data | <01>
- 0x2A: Data | <02>

CsrActiveConfig:

NVRAM -> Add -> 7C436110-AB2A-4BBB-A880-FE41995C9F82 -> csr-active-config:
- 0x0: 00000000
- 0x3: 03000000
- 0x67: 67000000
- 0x3E7: E7030000

SMBIOS

Product Name:

PlatformInfo -> Generic -> SystemProductName

Serial Number:

PlatformInfo -> Generic -> SystemSerialNumber

Board Serial Number:

PlatformInfo -> Generic -> MLB

SmUUID:

PlatformInfo -> Generic -> SystemUUID

Memory:

PlatformInfo -> CustomMemory -> True
PlatformInfo -> Memory

Slots AAPL Injection:

DeviceProperties -> Add -> PciRoot... -> APPL,slot-name | string | Add slot

System Parameters

CustomUUID:

Tính năng này dường như ko cần thiết

InjectSystemID:

gần như vô dụng

BacklightLevel:

set tính năng này trong nvram
NVRAM -> Add -> 7C436110-AB2A-4BBB-A880-FE41995C9F82 -> backlight-level | Data | <Insert value>
- 0x0101 -> <0101>

InjectKexts:

thật sự ko cần thiết

NoCaches:

được sử dụng cho macos 10.7 và opencore yêu cầu macos phải từ 10.7+ nên ko có bản tương đương

ExposeSysVariables:

chỉ cần thêm nó và dưới platformInfo

NvidiaWeb:

Điều này có nghĩa là bạn đang áp dụng dòng vào terminal sudo nvram nvda_drv=1 mỗi lần khởi động có thể áp dụng nó vào opencore theo đường dẫn sau:
NVRAM -> Add -> 7C436110-AB2A-4BBB-A880-FE41995C9F82 -> nvda_drv: <31>

Source tham khảo: Converting common properties from Clover to OpenCore | OpenCore Install Guide (dortania.github.io)

Clover to Opencore

# Cấu trúc EFI

# Config

# ACPI

# ACPI Rename:

# Patches:

# Fixes:

# DropTables:

# Boot

# Boot Graphics

# Devices

# Disable Drivers

# GUI (Menu boot)

# Graphics

# Kernel and Kext Patches

# Rt Variables

# SMBIOS

# System Parameters