Creare la EFI

Per impostare la struttura di OpenCore, dovrai prendere la EFI trovata nei rilasci di OpenCorePkgopen in new window. Nota che saranno nelle cartelle IA32 o X64, rispettivamente per i Firmware a 32-bit e a 64-bit:

DEBUG versus RELEASE?

DEBUGRELASE
Può effettuare grandi debug contro i problemi di avvio, tuttavia può aggiungere un po' di attesa all'avvio (tipo 3-5 secondi per arrivare al picker). Una volta installato puoi facilmente traslare alla sezione RELEASETempi di avvio più veloci, tuttavia non provvede informazioni utili per la risoluzione di problemi come invece fa la versione di DEBUG.

Copia l'EFI

Una volta scaricata, posiziona la cartella EFI (da OpenCorePkg) nella radice della tua partizione EFI:

Note

Se usate l'installazione via Recovery, dovete copiare la cartella EFI nella radice della partizione primaria della chiavetta

Ora apriamo la nostra EFI e vediamo che c'è al suo interno:

Ora puoi mettere i tuoi file (Driver del Firmware, Tools, Kext e ACPI nelle rispettive cartelle. Ecco come una EFI potrebbe apparire (la tua potrebbe essere differente):

Ricorda!

  • Gli SSDT e il DSDT personalizzato (.aml) vanno nella cartella ACPI
  • I Kext (.kext) vanno nella cartella kexts
  • I driver firmware (.efi) vanno nella cartella drivers

Driver del Firmware

I driver del Firmware sono dei driver utilizzati da OpenCore negli ambienti UEFI. Servono principalmente per avviare una computer, estendendo la capacità di patch di OpenCore oppure mostrandoti le diverse unità nel selettore(ovvero le unità HFS).

OpenCore viene distribuito con numerosi driver, tuttavia nella maggior parte dei casi solo alcuni sono necessari:

DriverStatoDescrizione
Un driver HFS+ (Vedere sotto per una lista) Richiesto Richiesto per avviare la recovery o sistemi che usano questo file system
OpenRuntime.efiEstende Opencore e lo aiuta a modificare il file boot.efi per correggere la NVRAM e per una migliore gestione della batteria
OpenUsbKbDxe.efi Optionale Richiesto per i sistemi non UEFI
ResetNvramEntry.efiRichiesto per resettare la NVRAM
OpenPartitionDxe.efiRichiesto per avviare la recovery di macOS 10.7-10.9

Note

  • Non puoi usare i driver UEFI di Clover (EmuVariableUEFI, AptioMemoryFix, OsxAptioFixDrv, ...) su OpenCore! Vedi Conversione driver Firmware per maggiori informazioni sui driver supportati e quelli già inclusi con OpenCore.
  • Devono essere posizionati sotto EFI/OC/Drivers/

Scegliere il driver HFS+

Attualmente si consiglia l'utilizzo di:

  • OpenHfsPlus: variante opensource creata dagli sviluppatori di OpenCore e aggiunto di default alla EFI
  • HfsPlus.efiopen in new window, driver sviluppato da Apple

Nel caso di sistemi con particolari condizioni:

Più informazioni riguardo agli altri driver
  • AudioDxe.efi
    • Non relazionato col supporto audio in macOS
  • CrScreenshotDxe.efi
    • Usato per fare degli screenshot nel UEFI, non necessario per noi
  • HiiDatabase.efi
    • Usato per sistemare l'interfaccia grafica in Sandy Bridge o meno recenti per tool come OpenShell.efi
    • Non richiesto per avviare
  • NvmExpressDxe.efi
    • Usato da Haswell o più vecchi quando non ci sono driver NVMe nel firmware
    • Non usare se non sai che stai facendo
  • OpenCanopy.efi
    • Questo è la interfaccia grafica opzionale di OpenCore, spiegheremo come impostarla in Post Install (EN) perciò rimuovila per ora
  • Ps2KeyboardDxe.efi + Ps2MouseDxe.efi
    • Ovvio che devi usarlo quando è necessario, la tastiera e il mouse USB non lo necessitano
    • Reminder: PS2 ≠ USBSB
  • ResetNvramEntry.efi
    • Permette il reset della NVRAM dal selettore di avvio
  • UsbMouseDxe.efi
    • Idea simile a OpenUsbKbDxe, usato solo dai sistemi legacy che usano DuetPkg
  • XhciDxe.efi
    • Usato da Sandy Bridge o più vecchi quando il driver XHCI non è nel firmware
    • Necessario se stai usando una scheda di espansione USB 3.0 in una macchina vecchia

Utenti Legacy

Oltre a ciò che abbiamo detto in precedenza, se il tuo hardware è particolarmente vecchio (indicativamente dal 2011 o meno recenti) oppure hai intenzioni particolari, potresti aver bisogno di quanto segue.

Tools

ToolStatoDescrizione
OpenShell.efi Opzionale Raccomandato per debug più semplice, in caso di situazioni particolari

Kext

Un kext è un kernel extension (estensione kernel), li possiammo immaginare come una sorta di drivers per MacOs, questi file andranno nella cartella kext della tua EFI.

  • Nota per Windows e Linux: I kext saranno visti come normali cartelle dal vostro sistema, controlla più volte che la cartella che stai installando abbia un'estensione .kext visibile(e non aggiungere manulamente l'estensione se non è presente).
    • Se qualche kext dovesse includere un file .dSYM, lo puoi semplicemente cancellare. Sono utili solamente per il debug.
  • Nota sul posizionamento: Questi files devono essere posizionati sotto EFI/OC/Kexts/.

La maggior parte dei kext elencati in precedenza possono essere trovati pre-compilati nella build Repoopen in new window. I kext qui indicati vengono compilati ogni volta che c'è un nuovo aggiornamento.

Obbligatori

Kext richiesti

Senza i due qua sotto nessun sistema è avviabile:

  • (Richiesto) Liluopen in new window
    • Un kext per modificare molti processi necessario per AppleALC, WhateverGreen, VirtualSMC e molti altri kext. Senza lilu non funzioneranno.
    • Nota bene che Lilu ed i plugins per funzionare richiedono OS X 10.4 o più recenti
  • (Richiesto) VirtualSMCopen in new window
    • Emula il chip SMC che si trova sui veri Mac, senza questo MacOs non si avvierà.
    • Necessita OS X 10.4 o più recenti

Plugin di VirtualSMC

I plug-in seguenti non sono necessari per l'avvio e aggiungono semplicemente funzionalità extra al sistema come il monitoraggio dell'hardware:

Nota

Mentre VirtualSMC supporta 10.6, i plugins potrebbero richiedere 10.8+

  • SMCProcessor.kext
    • Utilizzato per monitorare la temperatura della CPU
    • Non per sistemi con CPU AMD
    • Richiede OS X 10.7 o più recenti
  • SMCAMDProcessoropen in new window
    • Usato per monitorare la temperatura nei processori AMD Zen
    • In sviluppo, potenzialmente instabile
    • Richiede AMDRyzenCPUPowerManagement (vedi Kext specifici per CPU AMD)
    • Richiede macOS 10.13 e successivi
  • SMCRadeonGPUopen in new window
    • Usato per monitorare la temperatura della GPU nei sistemi AMD
    • Richiede la stessa versione di RadeonSensor
    • Richiede macOS 11 o più recenti
  • SMCSuperIO.kext
    • Utilizzato per monitorare la velocità della ventola
    • Non per sistemi con CPU AMD
    • Richiede OS X 10.6 o più recenti
  • SMCLightSensor.kext
    • Utilizzato per il sensore di luminosità sui laptop
    • Non utilizzare se non si ha un sensore di luminosità (come nei desktop), può causare problemi in caso contrario
    • Richiede OS X 10.6 o più recenti
  • SMCBatteryManager.kext
    • Utilizzato per misurare la batteria sui laptop
    • Non usare nei desktop
    • Richiede OS X 10.4 o più recenti
  • SMCDellSensors.kext
    • Permette un monitoraggio più fine e il controllo delle ventole nei sistemi Dell che supportano System Management Mode (SMM)
    • Consente un monitoraggio e un controllo più accurato delle ventole sulle macchine Dell che supportano il System Management Mode (SMM)
    • Non utilizzare se non si dispone di una macchina Dell supportata, principalmente i laptop Dell possono trarre vantaggio da questo kext
    • Richiede OS X 10.7 o più recenti

Grafica

  • WhateverGreenopen in new window
    • Utilizzato per la patch grafica di DRM, controllo del board ID, correzioni di framebuffer...
    • Tutte le GPU beneficiano di questo kext.
    • Necessita di OS X 10.6 o più recenti

Audio

  • AppleALCopen in new window
    • Utilizzato per patch di AppleHDA, consentendo il supporto per la maggior parte dei controller audio integrati
    • I processori AMD 15°/16° potrebbero avere problemi con questo kext e i sistemi Ryzen/Threadripper raramente supportano il microfono
    • Necessita di OS X 10.4 o più recenti
Kext audio per i sistemi legacy

Per coloro che intendono avviare 10.7 e versioni precedenti, è preferibile optare per questi kext:

Ethernet

Qui supponiamo che tu sappia quale scheda ethernet ha il tuo sistema, ricorda che le pagine delle specifiche del prodotto molto probabilmente elencheranno il tipo di scheda di rete.

  • IntelMausiopen in new window
    • Necessario per la maggior parte delle schede di rete Intel, i chipset basati su I211 avranno bisogno di SmallTreeIntel82576 kext
    • I NIC Intel 82578, 82579, I217, I218 e I219 sono ufficialmente supportati
    • Necessita OS X 10.9 o più recenti, gli utenti 10.6-10.8 possono utilizzare IntelSnowMausi
  • AppleIGBopen in new window
    • Richiesto per i NIC I211 che devono avviare macOS Monterey e successivi
    • Podrebbe essere instabile con alcuni NIC, si raccomanda di stare con Big Sur e usare SmallTree
    • Richiesto per la maggior parte delle schede AMD che eseguono NIC Intel
    • Richiede macOS 12 e successivi
  • SmallTreeIntel82576open in new window
    • Richiesto per la maggior parte delle schede AMD che eseguono NIC Intel fino a Big Sur, dato che non funziona su macOS 12. Baseto su SmallTree però modificato per supportare I211.
    • Richiede OS X 10.9-12 (v1.0.6), macOS 10.13-14 (v1.2.5), macOS 10.15+ (v1.3.0)
  • AtherosE2200Ethernetopen in new window
    • Richiesto per Atheros e i NIC Killer
    • Richiede OS X 10.8 o successivo
    • Nota: i modelli Atheros Killer E2500 sono in realtà basati su Realtek, per questi sistemi si consiglia di utilizzare RealtekRTL8111open in new window
  • RealtekRTL8111open in new window
    • Per i Gigabit Ethernet di Realtek
    • Richiede OS X 10.8 e meno recenti per la versione 2.2.0 e inferiori, macOS 10.12 e sucessivi per le versioni 2.2.2, macOS 10.14 e sucessivi per la versione 2.3.0 e sucessive
    • NOTA: a volte i Gigabit Ethernet di Realtek potrebbe non funzionare correttamente se si utilizza l'ultima versione del kext. Se hai qualche problema, prova ad usare vecchie versioni.
  • LucyRTL8125Ethernetopen in new window
    • Per i 2,5 Gb Ethernet di Realtek
    • Richiede macOS 10.15 o successivo
  • Per i NIC I225-V di Intel, le patch sono menzionate nella sezione desktop Comet Lake DeviceProperties. Non è richiesto nessun kext.
    • Richiede macOS 10.15 o successivo
  • For Intel's I350 NICs, patches are mentioned in the HEDT Sandy and Ivy Bridge-E DeviceProperties section. No kext is required.
    • Requires OS X 10.10 or newer
Kext Ethernet per sistemi Legacy

Rilevante per le installazioni di macOS legacy o per vecchi computer.

Inoltre, tieni presente che alcune schede NIC sono effettivamente supportate in modo nativo in macOS:

Controller Ethernet Nativamente Supportati

Serie Aquantia

# AppleEthernetAquantiaAqtion.kext
pci1d6a,1    = Aquantia AQC107
pci1d6a,d107 = Aquantia AQC107
pci1d6a,7b1  = Aquantia AQC107
pci1d6a,80b1 = Aquantia AQC107
pci1d6a,87b1 = Aquantia AQC107
pci1d6a,88b1 = Aquantia AQC107
pci1d6a,89b1 = Aquantia AQC107
pci1d6a,91b1 = Aquantia AQC107
pci1d6a,92b1 = Aquantia AQC107
pci1d6a,c0   = Aquantia AQC113
pci1d6a,4c0  = Aquantia AQC113

Nota bene: A causa di alcuni firmware obsoleti forniti su molti NIC Aquantia, potrebbe essere necessario aggiornare il firmware da Linux/Windows per assicurarsi che sia compatibile con macOS.

Serie Intel

# AppleIntel8254XEthernet.kext
pci8086,1096 = Intel 80003ES2LAN
pci8086,100f = Intel 82545EM
pci8086,105e = Intel 82571EB/82571GB

# AppleIntelI210Ethernet.kext
pci8086,1533 = Intel I210
pci8086,15f2 = Intel I225LM (Added in macOS 10.15)

# Intel82574L.kext
pci8086,104b = Intel 82566DC
pci8086,10f6 = Intel 82574L

Serie Broadcom

# AppleBCM5701Ethernet.kext
pci14e4,1684 = Broadcom BCM5764M
pci14e4,16b0 = Broadcom BCM57761
pci14e4,16b4 = Broadcom BCM57765
pci14e4,1682 = Broadcom BCM57762
pci14e4,1686 = Broadcom BCM57766

USB

  • USBToolBox (toolopen in new window e kextopen in new window)

    • Usato per iniettare le USB su piattaforme Intel nel caso in cui non siano definite da ACPI
    • Strumento per la mappatura USB
    • Non dovrebbe essere necessario nei Desktop Skylake e più recenti
    • Raccomandabile tuttavia mappare le tue porte USB prima di installare macOS per evitare problemi con il limite delle porte
      • AsRock è stupida e non necessita questo
    • Funzionalità
      • Per Coffee Lake e laptop più vecchi rimane la raccomandazione di usare questo kext
      • Supporta il mappaggio da Windows e macOS (Linux work in progress)
    • Non funziona per nessuna CPU AMD
      • Può mappare usando il kext USBToolBox kext o il kext nativo Apple (AppleUSBHostMergeProperties)
    • Richiede OS X 10.11 o più recenti
      • Supporta abbinamenti multipli
      • Supporta companion ports (da Windows)

  • XHCI-unsupportedopen in new window

    • Necessario per i controller USB non nativi
    • CPU basate su sistemi AMD non lo necessitano questo kext
    • Schede madri che solitamente richiedono questo kext:
      • H370
      • B360
      • H310
      • Z390 (non necessario su Mojave e versioni più recenti)
      • X79
      • X99
      • Schede ASRock Intel (non necessario tuttavia sulle schede B460/Z490+)

WiFi e Bluetooth

All Bluetooth Cards

Attenzione

Da non usare con macOS 11 e meno recenti

Intel

  • AirportItlwmopen in new window
    • Aggiunge il supporto per un'ampia varietà di schede wireless Intel e funziona in modo nativo nella recovery grazie all'integrazione della famiglia IO80211
    • Richiede macOS 10.13 o più recente e Apple Secure Boot per funzionare correttamente
  • Itlwmopen in new window
    • Alternativa a AirportItlwm per sistemi dove Apple Secure Boot non può essere abilitato
    • Richiede Heliportopen in new window
    • Sarà trattata come una scheda Ethernet, dovrai quindi connetterti tramite Heliport
    • Non funziona in recovery
  • IntelBluetoothFirmwareopen in new window
    • Aggiunge il supporto Bluetooth a macOS se associato a una scheda wireless Intel
    • Richiede MacOs 10.13 o più recenti
    • Da macOS 10.13 fino 11, devi abilitare IntelBluetoothInjector (incluso)
Ulteriori informazioni sull'attivazione di AirportItlwm

Per abilitare il supporto di AirportItlwm con OpenCore, dovrai:

  • Abilita Misc -> Security -> SecureBootModel impostandolo comeDefault o qualche altro valore valido
    • Questo è discusso successivamente più avanti in questa guida ma anche nella guida post-installazione: Apple Secure Boot
  • Se non puoi abilitare SecureBootModel, puoi comunque forzare l'inserimento di IO80211Family (Altamente sconsigliato)
    • Imposta quanto segue in Kernel -> Force nel tuo config.plist (discusso più avanti in questa guida):

Broadcom

  • AirportBrcmFixupopen in new window
    • Utilizzato per patchare schede Broadcom non Apple/non Fenvi, Non funzionerà su schede Intel, Killer, Realtek, ecc
    • Richiede OS X 10.10 o versioni più recenti
  • BrcmPatchRAMopen in new window
    • Utilizzato per caricare il firmware sul chipset Broadcom Bluetooth, richiesto per tutte le schede non Apple/non Fenvi Airport.
    • Da associare a BrcmFirmwareData.kext
      • BrcmPatchRAM3 per 10.15+ ( deve essere asscociato con BrcmBluetoothInjector)
      • BrcmPatchRAM2 per 10.11-10.14
      • BrcmPatchRAM per 10.8-10.10
    • Da macOS 10.13 fino 11, devi abilitare IntelBluetoothInjector (incluso)
BrcmPatchRAM ordine di caricamento

L'ordine in Kernel -> Add dovrebbe essere:

  1. BrcmBluetoothInjector (se necessario)
  2. BrcmFirmwareData
  3. BrcmPatchRAM3 (o BrcmPatchRAM2/BrcmPatchRAM)

ProperTree lo gestirà automaticamente, quindi non te ne devi preoccupare

Kext specifici per CPU AMD

  • XLNCUSBFIXopen in new window
    • Fix USB per sistemi AMD FX, non consigliata per Ryzen
    • Richiede macOS 10.13 o versioni più recenti
  • VoodooHDAopen in new window
    • Audio per sistemi FX e supporto Microfono + Audio sul pannello frontale per i sistemi Ryzen, non usare con AppleALC. La qualità audio è notevolmente peggiore di AppleALC sulle CPU Zen
    • Richiede OS X 10.6 o successivo
    • Usare questo kext su macOS 11.3 e successivi non è raccomandato perché devi disabilitare il SIP per modificare il filesystem di macOS
  • AMDRyzenCPUPowerManagementopen in new window
    • Power management per CPU AMD Ryzen
    • In sviluppo, potenzialmente instabile
    • Richiede macOS 10.13 o successivi

Extra

  • AppleMCEReporterDisableropen in new window
    • Richiesto in macOS 12.3 o sucessivi su sistemi AMD e su macOS 10.15 e successivi su sistemi Intel dual-socket
    • SMBIOS interessati:
      • MacPro6,1
      • MacPro7,1
      • iMacPro1,1
  • CpuTscSyncopen in new window
    • Necessario per la sincronizzazione del TSC su alcune schede madri Intel HEDT e server, senza questo macOS potrebbe essere estremamente lento o non avviabile.
    • Non funziona su CPU AMD
    • Richiede OS X 10.8 o versioni più recenti
  • NVMeFixopen in new window
    • Utilizzato per correggere la gestione dell'alimentazione e l'inizializzazione di NVMe non Apple
    • Richiede macOS 10.14 o versioni più recenti
  • SATA-Unsupportedopen in new window
    • Aggiunge il supporto per un'ampia varietà di controller SATA, principalmente utile per i laptop che hanno problemi nel vedere l'unità SATA in macOS. Si consiglia prima di provare senza questo.
    • Per macOS 11+: CtlnaAHCIPortopen in new window dovrà essere utilizzato invece perché numerosi controller sono stati eliminati dal binario stesso
      • Coloro che utilizzano Catalina e versioni precedenti non ne sono coinvolti
  • CPUTopologyRebuildopen in new window
    • Un plugin di Lilu sperimentale che ottimizza l'eterogenea configurazione dei core di Alder Lake. Solo per CPU Alder Lake
  • RestrictEventsopen in new window
Kext SATA per sistemi Legacy

Tastiera, mouse e trackpad dei laptop

Per capire che tipo di tastiera e trackpad hai, controlla Gestione dispositivi in Windows o dmesg | grep -i input in Linux

Attenzione

La maggior parte delle tastiere dei laptop sono PS2! Dovresti provare un tentativo con VoodooPS2 anche se hai un trackpad di altre tipologie.

Trackpad/Tastiere PS2

  • VoodooPS2open in new window
    • Funziona con molti sistemi con tastiere, mouse e trackpad di tipo PS2
    • Richiede almeno macOS 10.11 per le funzioni MT2 (Magic Trackpad 2)
  • RehabMan VoodooPS2open in new window
    • Per i sistemi meno recenti con tastiere, mouse e trackpad PS2 o quando non si vuole utilizzare VoodooInput
    • Supporta macOS 10.6 e più recenti

Trackpad SMBus

Dispositivi HID I2C/USB

  • VoodooI2Copen in new window
    • Richiede almeno macOS 10.11.
    • Si collega ai controller I2C per permettere ai plugin di collegarsi ai trackpad I2C
    • I dispositivi USB che usano i plugin sottostanti necessitano di VoodooI2C
    • Devi essere accoppiato con uno dei plugin sottostanti:

Plugin di VoodooI2C

Tipo di connessionePluginNote
Multitouch HIDVoodooI2CHIDUtilizzabile con i Touchscreen e Trackpad I2C/USB
ELAN ProprietaryVoodooI2CElanELAN1200+ invece richiede VoodooI2CHID
FTE1001 touchpadVoodooI2CFTE
Atmel Multitouch ProtocolVoodooI2CAtmelMXT
Synaptics HIDVoodooRMIopen in new windowI2C Synaptic Trackpads (Richiede VoodooI2C solo per la modalità I2C)
Alps HIDAlpsHIDopen in new windowUtilizzabile con trackpad Alps USB o I2C. Visibile maggiormente nei laptop Dell e in alcuni HP EliteBook.

Kext misti per Laptop

Fare riferimento a Kexts.mdopen in new window per un elenco completo dei kext supportati

SSDT

Quando vedi tutti quegli SSDT nella cartella AcpiSamples ti potresti chiedere se ne hai bisogno. Esamineremo gli SSDT di cui hai bisogno nella guida Iniziamo con ACPI, la quale ha una sezione estesa sugli SSDT inclusa la loro compilazione sulle diverse piattaforme.

Note

Una volta che hai recuperato i SSDT devi solo aggiungerli ad OpenCore.

  • Devi posizionarli in due sezioni:

    • EFI/OC/ACPI (Solo file .aml, ricordati di compilare i tuoi SSDT)
    • config.plist -> ACPI -> Add

  • Ricordati di non aggiungere il tuo DSDT.aml alla EFI

Per gli utenti di FixHPET

Dovrete unire al config.plist le patch del file oc_patches.plist:

  • Apri entrambi i file
  • Cancella la sezione ACPI -> Patch dal config.plist
  • Copia la sezione ACPI -> Patch dal oc_patches.plist
  • Incolla le patch nella sezione ACPI -> Patch nel config.plist