Guia de Instalação do OpenCore

# Ryzen e Threadripper (17h e 19h)

Suporte Versão
Suporte Inicial no macOS macOS 10.13 High Sierra

# Ponto de Partida

Criar uma config.plist pode parecer difícil, mas não é. Este guia mostrará como configurar tudo, só é preciso ter tempo. Não se preocupe, você não será deixado no escuro. Isso significa que, caso surjam problemas, verifique as configurações da sua config.plist para garantir que está tudo certo. O principal a ser observado com o OpenCore é:

  • Todas as propriedades precisam estar definidas. O OpenCore não reverte para valores padrão, então não exclua nenhuma seção, a não ser que seja explicitamente indicado. Se o guia não menciona uma opção, mantenha os padrões.
  • O arquivo Sample.plist não pode ser usado sem alterações. É preciso configurá-lo para o seu computador antes de usá-lo.
  • NÂO USE CONFIGURADORES. Eles raramente respeitam as configurações do OpenCore e alguns, como o do Mackie, adicionam propriedades do Clover e corrompem as plists!

Agora, com isso fora do caminho, um breve lembrete sobre as ferramentas necessárias:

Leia este guia mais de uma vez antes de configurar o OpenCore. Tenha certeza de tê-lo configurado corretamente. Observe que as imagens deste guia nem sempre estarão 100% atualizadas, então sempre leia o texto que as acompanha. Se nada for mencionado sobre uma opção, mantenha as configurações padrão.

# ACPI

ACPI

# Add

Informações

É aqui onde todas as SSDTs do computador são adicionadas. Elas são muito importantes para iniciar o macOS e possuem muitos usos, como mapear as portas USB (opens new window), desativar GPUs não suportdas e coisas do tipo. Da forma como o OpenCore funciona, elas são necessárias para iniciar o macOS. O guia sobre como fazê-las pode ser encontrado aqui: Primeiros Passos com a ACPI (opens new window).

SSDTs Necessárias Descrição
SSDT-EC-USBX (opens new window) Corrige tanto o controlador integrado quanto a energia da USB. Veja mais no guia Primeiros Passos com a ACPI (opens new window) para mais detalhes.
SSDT-CPUR (opens new window) Corrige as definições de CPU em placas-mãe B550 e A520. Não utilize caso não possua uma placa-mãe AMD B550 ou A520. É possível baixar a versão compilada aqui: SSDT-CPUR.aml (opens new window)

Observe que não é preciso adicionar a sua DSDT.aml aqui, pois ela já está presente no firmware do seu computador. Então, se ela estiver presente nesta seção, remova a sua entrada da config.plist e exclua o arquivo .aml da pasta EFI/OC/ACPI.

Para aqueles que desejam obter mais informações sobre como extrair DSDTs, como criar SSDTs e como compilá-las, veja o guia Primeiros Passos com a ACPI (opens new window). SSDTs compiladas possuem a extensão .aml (assembled) e serão colocadas na pasta EFI/OC/ACPI. Elas também precisam estar especificadas na sua config.plist, dentro da seção ACPI -> Add.

# Delete

Esta seção bloqueia o carregamento de certas tabelas da ACPI. Ignore-a por enquanto.

# Patch

Esta seção permite modificar partes da ACPI (DSDT, SSDT etc.) de forma dinâmica por meio do OpenCore. No caso deste guia, os patches são gerenciados pelas SSDTs. É uma solução muito mais limpa, pois permite iniciar o Windows e outros sistemas operacionais com o OpenCore.

# Quirks

Configurações relacionadas à ACPI. Deixe tudo como padrão, pois este guia não vai usar essas quirks.

# Booter

Booter

Esta seção é dedicada a quirks relacionadas com a aplicação de patches no boot.efi através do OpenRuntime, o substituto do AptioMemoryFix.efi.

# MmioWhitelist

Esta seção permite definir quais regiões do mapa de memória que são geralmente ignoradas pelo macOS, são boas para o uso. Útil quando combinado com a quirk DevirtualiseMmio.

# Quirks

Informações

Configurações relacionadas à aplicação de patches no boot.efi e a correções de firmware. Será necessário alterar as seguintes opções:

Quirk Ativada Observação
DevirtualiseMmio NO É necessário ativar em placas-mãe TRX40.
EnableWriteUnprotector NO
RebuildAppleMemoryMap YES
SetupVirtualMap YES É preciso desativar esta opção ao usar placas-mãe B550, A520, TRX40, X570 com versões de BIOS mais novas, X470 e B450 com versões de BIOS lançadas no final de 2020.
SyncRuntimePermissions YES
Informação Mais Detalhada
  • AvoidRuntimeDefrag: YES
    • Corrige serviços UEFI em tempo de execução, como a data, a hora, a NVRAM, o controle de energia etc.
  • EnableSafeModeSlide: YES
    • Permite que as variáveis slide possam ser usadas no modo de segurança.
  • EnableWriteUnprotector: NO
    • Esta quirk e RebuildAppleMemoryMap podem conflitar às vezes. É recomendado ativar a última em plataformas mais novas e desativar esta quirk.
    • No entanto, devido a problemas com OEMs que não utilizam as últimas builds EDKII, a combinação acima pode causar falhas precoces na inicialização. Isso decorre da ausência do MEMORY_ATTRIBUTE_TABLE. Recomenda-se portanto, desativar RebuildAppleMemoryMap e ativar o EnableWriteUnprotector. Mais informações sobre isso podem ser encontradas na seção de Solução de Problemas.
  • ProvideCustomSlide: YES
    • Usado para variáveis slide calculadas. No entanto, a necessidade desta quirk é determinada pela presença da mensagem OCABC: Only N/256 slide values are usable! no log de depuração. Se a mensagem OCABC: All slides are usable! You can disable ProvideCustomSlide! estiver presente no log, desative o ProvideCustomSlide.
  • RebuildAppleMemoryMap: YES
    • Gera um mapa de memória compatível com o macOS, mas pode não funcionar em alguns firmwares de notebooks OEM. Ao encontrar falhas precoces na inicialização, desative esta quirk.
  • SetupVirtualMap: YES
    • Corrige as chamadas de SetVirtualAddresses para endereços virtuais.
    • Esta quirk deve ser desativada em placas-mãe B550, A520 e TRX40.
  • SyncRuntimePermissions: YES
    • Corrige o alinhamento com tabelas MAT e é necessária para iniciar o Windows e o Linux com as tabelas MAT. Também é recomendado para o macOS. Relevante principalmente para usuários da quirk RebuildAppleMemoryMap.

# DeviceProperties

DeviceProperties

# Add

Configura as propriedades de dispositivo a partir de um mapa.

Por padrão, a Sample.plist apresenta esta seção já configurada para GPUs integradas e para áudio. Como não existem GPUs integradas neste guia, o PciRoot PciRoot(0x0)/Pci(0x2,0x0) pode ser removido da seção Add. Para o áudio, o layout será configurado na seção de argumentos de inicialização (boot-args), então a remoção do PciRoot(0x0)/Pci(0x1b,0x0) também é recomendada tanto da seção Add quanto da seção Block.

TL;DR: exclua todos os PciRoot pois não serão utilizados neste guia.

# Delete

Remove as propriedades de dispositivos do mapa. Pode ser ignorado.

# Kernel

Kernel Patches de Kernel
Kernel

# Add

É aqui onde são especificadas as kexts que serão carregadas, a ordem desse carregamento e quais arquiteturas cada kext suporta. Por padrão, recomenda-se manter o que o ProperTree criou, no entanto, para computadores com CPUs de 32 bits, veja a seguir.

Informação Mais Detalhada

O principal a se observar é:

  • Ordem de Carregamento
    • Lembre-se que quaisquer plugins devem carregar depois de suas dependências.
    • Isso significa que kexts como a Lilu precisam vir antes da VirtualSMC, AppleALC, WhateverGreen etc.

Lembre-se que usuários do ProperTree (opens new window) podem pressionar Cmd/Ctrl + Shift + R para adicionar todas as suas kexts na ordem correta sem precisar digitar cada uma manualmente.

  • Arch
    • Arquiteturas suportadas pela kext.
    • Atualmente, os valores suportados são Any, i386 (32 bits), e x86_64 (64 bits).
  • BundlePath
    • Nome da kext.
    • Ex: Lilu.kext.
  • Enabled
    • Auto explicativo. Ativa ou desativa a kext.
  • ExecutablePath
    • O caminho para o verdadeiro executável fica escondido dentro da kext. É possível encontrá-lo clicando com o botão direito e selecionando a opção Mostrar Conteúdo do Pacote. Geralmente, estará em Contents/MacOS/Kext, mas algumas kexts possuem outras kexts escondidas na pasta Plugin. Observe que kexts compostas somente por um arquivo .plist não precisam ter este campo preenchido.
    • Ex: Contents/MacOS/Lilu.
  • MinKernel
    • A versão mínima do kernel na qual a kext pode ser injetada. Consulte a tabela abaixo para os valores permitidos.
    • Ex. 12.00.00 representa o OS X 10.8 Mountain Lion.
  • MaxKernel
    • A versão máxima do kernel na qual a kext pode ser injetada. Consulte a tabela abaixo para os valores permitidos.
    • Ex. 11.99.99 representa o OS X 10.7 Lion.
  • PlistPath
    • Caminho para o arquivo info.plist escondido dentro da kext.
    • Ex: Contents/Info.plist.
Tabela de Suporte de *Kernel*
Versão do macOS MinKernel MaxKernel
10.4 8.0.0 8.99.99
10.5 9.0.0 9.99.99
10.6 10.0.0 10.99.99
10.7 11.0.0 11.99.99
10.8 12.0.0 12.99.99
10.9 13.0.0 13.99.99
10.10 14.0.0 14.99.99
10.11 15.0.0 15.99.99
10.12 16.0.0 16.99.99
10.13 17.0.0 17.99.99
10.14 18.0.0 18.99.99
10.15 19.0.0 19.99.99
11 20.0.0 20.99.99

# Emulate

Informações

Necessário para "falsificar" CPUs não suportadas, como Pentiums e Celerons, e para desativar o gerenciamento de energia em CPUs não suportadas (como em CPUs AMD).

Quirk Ativada
DummyPowerManagement YES
Informações Mais Detalhadas
  • CpuidMask: Deixe vazio.
    • Máscara para CPUID falso.
  • CpuidData: Deixe vazio.
    • Entrada do CPUID falso.
  • DummyPowerManagement: YES
    • Nova alternativa para a NullCPUPowerManagement.kext, exigida em todos os computadores baseados em CPUs AMD, pois eles não possuem gerenciamento de energia nativo. Usuários de CPUs Intel podem ignorar isso.
  • MinKernel: Deixe vazio.
    • A versão mínima do kernel no qual os patches acima serão injetados. Se nenhum valor for especificado, será aplicado a todas as versões do macOS. Veja os valores permitidos na tabela abaixo.
    • Ex. 12.00.00 representa o OS X 10.8 Mountain Lion.
  • MaxKernel: Deixe vazio.
    • A versão máxima do kernel no qual os patches acima serão injetados. Se nenhum valor for especificado, será aplicado a todas as versões do macOS. Veja os valores permitidos na tabela abaixo.
    • Ex. 11.99.99 representa o OS X 10.7 Lion.
Tabela de Suporte de *Kernel*
Versão do macOS MinKernel MaxKernel
10.4 8.0.0 8.99.99
10.5 9.0.0 9.99.99
10.6 10.0.0 10.99.99
10.7 11.0.0 11.99.99
10.8 12.0.0 12.99.99
10.9 13.0.0 13.99.99
10.10 14.0.0 14.99.99
10.11 15.0.0 15.99.99
10.12 16.0.0 16.99.99
10.13 17.0.0 17.99.99
10.14 18.0.0 18.99.99
10.15 19.0.0 19.99.99
11 20.0.0 20.99.99

# Force

Usado para carregar kexts direto do volume do sistema. Relevante somente para sistemas operacionais mais antigos nos quais algumas kexts não estavam presentes no cache (ex.: IONetworkingFamily no Mac OS X 10.6 Snow Leopard).

Pode ser ignorado.

# Block

Impede que certas kexts sejam carregadas. Irrelevante no momento.

# Patch

É aqui onde a mágica dos patches de kernel para AMD acontece. Observe que as opções KernelToPatch e MatchOS do Clover se tornam Kernel e MinKernel / MaxKernel no OpenCore. É possível encontrar patches prontos, feitos por AlGrey, aqui (opens new window)(algrey#9303).

Patches de Kernel:

Para unir as configurações:

  • Abra os dois arquivos.
  • Apague a seção Kernel -> Patch da config.plist.
  • Copie a seção Kernel -> Patch da patches.plist;
  • Cole onde os patches antigos estavam na config.plist.

# Quirks

Informações

Configurações relacionadas ao kernel. Ative somente as seguintes opções:

Quirk Ativada
PanicNoKextDump YES
PowerTimeoutKernelPanic YES
XhciPortLimit YES
Informações Mais Detalhadas
  • AppleCpuPmCfgLock: NO
    • Necessário somente quando a trava de CFG não puder ser desativada na BIOS. Usuários de AMD podem ignorar isso.
  • AppleXcpmCfgLock: NO
    • Necessário somente quando a trava de CFG não puder ser desativada na BIOS. Usuários de AMD podem ignorar isso.
  • AppleXcpmExtraMsrs: NO
    • Desativa múltiplos acessos ao MSR necessários em CPUs não suportadas como Pentiums e alguns Xeons.
  • CustomSMBIOSGuid: NO
    • Aplica patches de GUID quando UpdateSMBIOSMode está configurado para Custom. Mais relevante para notebooks Dell.
    • Ativar esta quirk em conjunto com PlatformInfo -> UpdateSMBIOSMode -> Custom desativará a injeção de SMBIOS em sistemas operacionais que não sejam da Apple. Este guia não endossa este método, pois quebra a compatibilidade com o Bootcamp. Use por sua conta e risco.
  • DisableIoMapper: NO
    • CPUs AMD não possuem suporte a DMAR ou VT-D, portanto é irrelevante.
  • DisableLinkeditJettison: YES
    • Permite que a Lilu e outras kexts tenham uma performance melhor sem o keepsyms=1.
  • DisableRtcChecksum: NO
    • Previne que a AppleRTC escreva na soma de verificação primária (0x58-0x59). Exigido para usuários que, ao reiniciar/desligar o macOS, experienciam uma redefinição de BIOS ou são enviados para o modo de segurança.
  • ExtendBTFeatureFlags NO
    • Útil para aqueles que tiverem problemas com o Continuidade ao usar placas Wi-Fi que não sejam da Apple ou da Fenvi.
  • LapicKernelPanic: NO
    • Desativa um kernel panic no interruptor AP core lapic. Geralmente é necessário em computadores HP. Equivalente ao Kernel LAPIC do Clover.
  • LegacyCommpage: NO
    • Resolve a necessidade de instruções SSSE3 em CPUs de 64 bits no macOS. Relevante principalmente para CPUs Pentium 4 de 64 bits, como Prescott.
  • PanicNoKextDump: YES
    • Permite ler os logs de kernel panics quando ocorrem.
  • PowerTimeoutKernelPanic: YES
    • Ajuda a corrigir kernel panics relacionadas a alterações de energia com os drivers da Apple no macOS 10.15 Catalina. Mais perceptível com o áudio digital.
  • SetApfsTrimTimeout: -1
    • Configura o intervalo de tempo do TRIM (em microsegundos) em SSDs com sistema de arquivos APFS. Aplicável somente para o macOS 10.14 Mojave ou mais novos que estejam utilizando SSDs problemáticos.
  • XhciPortLimit: YES
    • Isto é, na verdade, o patch que corrige o limite de 15 portas USB. Não dependa dele, pois não é uma solução garantida para corrigir problemas de USB. Uma solução mais apropriada para computadores com CPUs AMD pode ser encontrado aqui: Mapeamento de USB em AMD (opens new window).

O motivo para tal é que o UsbInjectAll reimplementa uma funcionalidade integrada do macOS sem os ajustes apropriados. É muito mais limpo simplesmente descrever suas portas em uma kext com só um arquivo .plist dentro, o que não desperdiçará memória em tempo de execução e coisas do tipo.

# Scheme

Configurações relacionadas com a inicialização de sistemas operacionais antigos, como o Mac OS X 10.4 Tiger, 10.5 Leopard e 10.6 Snow Leopard. A maioria dos leitores pode pular essa parte. No entanto, aqueles que planejam usar sistemas antigos, continuem lendo.

Informação Mais Detalhada
  • FuzzyMatch: True
    • Usado para ingorar somas de verificação no kernelcache, optando em vez disso pelo último cache disponível. Pode ajudar a melhorar a performance da inicialização em muitos computadores com Mac OS X 10.6 Snow Leopard.
  • KernelArch: x86_64
    • Configura o tipo de arquitetura do kernel. As opções possíveis são: Auto, i386 (32 bits) e x86_64 (64 bits).
    • Se estiver utilizando sistemas operacionais mais antigos que necessitam de um kernel 32 bits, como o Mac OS X 10.4 Tiger e 10.5 Leopard, recomenda-se configurar essa opção para Auto e deixar que o macOS decida a melhor opção baseado na SMBIOS. Veja a tabela abaixo com os valores suportados:
      • Mac OS X 10.4 Tiger e 10.5 Leopard: x86_64, i386 ou i386-user32.
        • i386-user32 se refere ao espaço de usuário em 32 bits. Então, CPUs de 32 bits precisam usar essa opção (ou CPUs que não possuem as instruções SSSE3).
        • x86_64 Ainda executará o espaço do kernel em 32 bits. No entanto, garantirá que o espaço de usuário seja 64 bits nessas versões do Mac OS X.
      • Mac OS X 10.6 Snow Leopard: i386, i386-user32 ou x86_64.
      • OS X 10.7 Lion: i386 ou x86_64.
      • OS X 10.8 Mountain Lion ou mais novo: x86_64.
  • KernelCache: Auto
    • Configura o tipo de cache do kernel. Útil principalmente para depuração, então recomenda-se manter configurado como Auto para obter o melhor suporte.

# Misc

Misc

# Boot

Configurações da tela de inicialização. Mantenha todos os padrões como estão.

# Debug

Informações

Útil para depurar os problemas de inicialização do OpenCore (tudo será alterado, exceto DisplayDelay):

Quirk Ativada
AppleDebug YES
ApplePanic YES
DisableWatchDog YES
Target 67
Informação Mais Detalhada
  • AppleDebug: YES
    • Ativa o log do boot.efi. Útil para depuração. Observe que isso só é suportado no macOS 10.15.4 Catalina ou superior.
  • ApplePanic: YES
    • Tenta salvar os logs de kernel panics diretamente no disco.
  • DisableWatchDog: YES
    • Desativa o watchdog do UEFI. Pode ajudar com problemas precoces na inicialização.
  • DisplayLevel: 2147483650
    • Exibe ainda mais informações de depuração. Necessita da versão de depuração do OpenCore.
  • SerialInit: NO
    • Necessário para configurar a saída serial no OpenCore.
  • SysReport: NO
    • Útil para a depuração, como a extração de tabelas da ACPI.
    • Observe que essa função está limitada a versões de depuração do OpenCore.
  • Target: 67
    • Exibe mais informações de depuração, mas requer a versão de depuração do OpenCore.

Esses valores são baseados nos cálculos feitos na página Depurando o OpenCore.

# Security

Informações

Segurança é bastante autoexplicativa. Não pule esta parte. Eis o que deve ser alterado:

Quirk Ativada Comentário
AllowNvramReset YES
AllowSetDefault YES
BlacklistAppleUpdate YES
ScanPolicy 0
SecureBootModel Default Essa opção é literalmente uma palavra e diferencia maiúsculas de minúsculas. Mude para Disabled se precisar desativar a Inicialização Segura (ex.: se precisar usar os Web Drivers da Nvidia).
Vault Optional Esta opção é literalmente uma palavra e omiti-la não é permitido. Você vai se arrepender se não configurá-la para Optional. Atente-se para o fato de que a opção diferencia maiúsculas de minúsculas.
Informação Mais Detalhada
  • AllowNvramReset: YES
    • Permite redefinir a NVRAM tanto por meio do seletor de inicialização e ao pressionar Cmd+Opt+P+R.
  • AllowSetDefault: YES
    • Permite apertar CTRL+Enter e CTRL+Index para configurar o dispositivo padrão de inicialização no seletor.
  • ApECID: 0
    • Usado para configurar identificadores de inicialização segura personalizados. Atualmente, essa quirk não é confiável devido a um bug no instalador do macOS. Recomenda-se fortemente manter essa opção configurada para o valor padrão.
  • AuthRestart: NO
    • Ativa a reinicialização autenticada para o FileVault 2, de forma que a senha não seja exigida ao reiniciar o computador. Pode ser considerada um risco à segurança, portanto é opcional.
  • BlacklistAppleUpdate: YES
    • Usado para bloquear atualizações de firmware. Age como um nível extra de proteção, já que o macOS 11 Big Sur não mais utiliza a variável run-efi-updater.
  • DmgLoading: Signed
    • Garante que o OpenCore só carregará DMGs que estejam assinadas digitalmente.
  • ExposeSensitiveData: 6
    • Exibe mais informações de depuração e necessita da versão de depuração do OpenCore.
  • Vault: Optional
    • Não será necessário lidar com cofres, então ignore esta opção. Não será possível iniciar se esta opção estiver configurada para Secure.
    • Isso é literalmente uma palavra e sua omissão não é permitida. Você vai se arrepender se não configurá-la para Optional. Atente-se para o fato de que a opção diferencia maiúsculas de minúsculas.
  • ScanPolicy: 0
    • Configurar para 0 permite ver todas as unidades disponíveis. Veja a seção Segurança (opens new window) para obter mais detalhes. O OpenCore não iniciará pendrives se esta opção estiver configurada para Default.
  • SecureBootModel: Default

# Tools

Usado para executar as ferramentas de depuração do OpenCore, como o shell. A função de snapshot do ProperTree adicionará as ferramentas necessárias automaticamente.

# Entries

Usado para especificar caminhos de inicialização irregulares que não podem ser encontrados naturalmente pelo OpenCore.

Não será abordado aqui. Veja o item 8.6 do PDF de configuração para mais informações: Configuration.pdf (opens new window) (em inglês).

# NVRAM

NVRAM

# Add

4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14

Usado para o escalonamento da interface de usuário do OpenCore. O padrão servirá para os propósitos deste guia. Veja a seção abaixo para obter informações mais detalhadas.

Informação Mais Detalhada

Caminho do inicializador. Usado principalmente para o escalonamento da interface gráfica.

  • UIScale:

    • 01: Resolução padrão.
    • 02: HiDPI (geralmente necessário para que o FileVault funcione corretamente em telas menores)

  • DefaultBackgroundColor: Cor de fundo usada pelo boot.efi.

    • 00000000: Syrah Black (preto).
    • BFBFBF00: Light Gray (cinza).

4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102

GUID de NVRAM do OpenCore. Relevante principalmente para usuários da RTCMemoryFixup.

Informação Mais Detalhada

7C436110-AB2A-4BBB-A880-FE41995C9F82

Máscara de bits da Proteção da Integridade do Sistema (SIP).

  • Argumentos de inicialização (boot-args) de uso geral:
boot-args Descrição
-v Ativa o modo verbose, que exibe todos os textos ocultos que rolam na tela durante a inicialização, em vez da maçã e da barra de progresso. É de grande valia para qualquer hackintosher, já que fornece uma espiada por trás do processo de inicialização e pode ajudar a identificar problemas, encontrar kexts defeituosas e outras coisas que impeçam o macOS de iniciar completamente.
debug=0x100 Isso desativa o watchdog do macOS, o que ajuda a prevenir uma reinicialização após um kernel panic. Dessa forma, é possível (talvez) obter algumas informações importantes e seguir as migalhas para resolver um problema.
keepsyms=1 É uma configuração companheira do debug=0x100, que diz ao sistema operacional para também exibir os símbolos na tela durante um kernel panic. Pode oferecer uma compreensão ainda maior sobre o que pode estar causando o kernel panic em primeiro lugar.
npci=0x2000 Isso desativa uma depuração da PCI relacionada a kIOPCIConfiguratorPFM64. Uma alternativa é npci= 0x3000, que desativa também a depuração relacionada agIOPCITunnelledKey. Necessário quando a inicialização trava em PCI Start Configuration, pois há conflitos de IRQ nas trilhas de PCI. Desnecessário se Above4GDecoding estiver ativado. Fonte (opens new window) (em inglês)
alcid=1 Usado para configurar o layout-id para a AppleALC. Veja a lista de codecs suportados (opens new window) (em inglês) para descobrir qual layout é o mais apropriado para o seu computador. Mais informações são fornecidas no guia de Pós-instalação do OpenCore (opens new window)
  • Argumentos de inicialização (boot-args) específicas de GPUs:
boot-args Descrição
agdpmod=pikera Usado para desativar o boardID em GPUs Navi (série RX 5000). Sem isso, será exibida uma tela preta. Não use caso não possua uma GPU Navi (isto é, placas Polaris e Vega não devem usar).
nvda_drv_vrl=1 Usado para ativar os Web Drivers da Nvidia em placas Maxwell e Pascal no macOS 10.12 Sierra e 10.13 High Sierra.

  • csr-active-config: 00000000

    • Confgigurações da Proteção da Integridade do Sistema (SIP). É geralmente recomendado alterar essa opção por meio da partição de Recuperação, usando o utilitário de linha de comando csrutil.
    • Por padrão, o csr-active-config é configurado para 00000000, o que ativa a Proteção da Integridade do Sistema. É possível escolher uma variedade de valores diferentes, mas de maneira geral, recomenda-se mantê-lo ligado para melhores práticas de segurança. Mais informações podem ser encontradas na página de solução de problemas: Desativando o SIP.

  • run-efi-updater: No

    • Isso é usado para prevenir que os pacotes de atualização de firmware da Apple sejam instalados e quebrem a ordem de inicialização. É importante, pois essas atualizações de firmware (criadas para os Macs) não funcionam em hackintoshes.

  • prev-lang:kbd: <>

    • Necessário para teclados não latinos. Use o formato lang-COUNTRY:keyboard. Recomenda-se manter vazio, mas é possível especificá-lo caso seja necessário. O padrão na Sample.plist é russo.):
    • Estadunidense: en-US:0(656e2d55533a30 em hexadecimal).
    • Uma lista completa pode ser encontrada em AppleKeyboardLayouts.txt (opens new window) (em inglês).
    • Dica: a opção prev-lang:kbd pode ser alterada para usar uma cadeia de caracteres (string), de forma que digitar en-US:0 diretamente também será aceito, removendo a necessidade de converter o valor para hexadecimal.
Chave Tipo Valor
prev-lang:kbd String en-US:0

# Delete

Informações

Reescreve as variáveis NVRAM na marra. Observe que Add não sobrescreve valores que já estejam presentes na NVRAM. Então, valores como os boot-args devem ser deixados como estão. Mude apenas o seguinte:

Quirk Ativado
WriteFlash YES
Informação Mais Detalhada

  • LegacyEnable: NO

    • Permite que a NVRAM seja armazenada no arquivo nvram.plist. Necessário em computadores que não possuem NVRAM nativa.

  • LegacyOverwrite: NO

    • Permite sobrescrever variáveis de firmware a partir do arquivo nvram.plist. Necessário somente em computadores que não possuem NVRAM nativa.

  • LegacySchema

    • Usado para atribuir variáveis NVRAM. Usado com o LegacyEnable configurado para YES.

  • WriteFlash: YES

    • Ativa a função de escrever em memória flash para todas as variáveis adicionadas.

# PlatformInfo

PlatformInfo

Informações

Para configurar a informação da SMBIOS, será utilizado o aplicativo GenSMBIOS (opens new window), desenvolvido por CorpNewt.

Neste exemplo, será selecionada a SMBIOS do iMacPro1,1. No entanto, algumas SMBIOS funcionam melhor com certas GPUs do que outras.

  • iMacPro1,1: AMD RX Polaris ou mais novas.
  • MacPro7,1: AMD RX Polaris ou mais novas.
    • Observe que MacPro7,1 é exclusiva para macOS 10.15 Catalina ou superior.
  • MacPro6,1: AMD R5/R7/R9 e mais antigas.
  • iMac14,2: Nvidia Kepler e mais novas.
    • Observação: iMac14,2 é a única que possui suporte nos OS X 10.8 Mountain Lion ao macOS 10.15 Catalina. Para o macOS 11 Big Sur ou mais novo, use MacPro7,1.

Execute o GenSMBIOS, escolha a opção 1 para baixar o MacSerial e a opção 3 para selecionar a SMBIOS. Isso mostrará uma saída similar à seguinte:

  #######################################################
 #              iMacPro1,1 SMBIOS Info                 #
#######################################################

Type:         iMacPro1,1
Serial:       C02YX0TZHX87
Board Serial: C029269024NJG36CB
SmUUID:       DEA17B2D-2F9F-4955-B266-A74C47678AD3

A ordem é Product | Serial | Board Serial (MLB)

A parte Type deve ser copiada para Generic -> SystemProductName.

A parte Serial deve ser copiada para Generic -> SystemSerialNumber.

A parte Board Serial deve ser copiada para Generic -> MLB.

A parte SmUUID deve ser copiada para Generic -> SystemUUID.

Configure o Generic -> ROM tanto para uma ROM da Apple (extraída de um Mac de verdade), o endereço MAC do controlador de rede ou qualquer endereço MAC aleatório. Pode ser só 6 bytes aleatórios. Neste guia, será utilizado 11223300 0000. Depois da instalação, siga o guia Corrigindo os iServiços (opens new window) para saber como encontrar o endereço MAC real do seu computador.

Lembre-se que o objetivo aqui é ter um número de série inválido ou um que seja válido, mas que não esteja em uso. A mensagem de resposta deve ser algo como: "Número de série inválido" ou "Data de compra não validada".

Página para Verificar a Cobertura da Apple (opens new window)

Automatic: YES

  • Gera o PlatformInfo baseado na seção Generic, em vez de usar as seções DataHub, NVRAM e SMBIOS.

# Generic

Informação Mais Detalhada

  • AdviseFeatures: NO

    • Usado para quando a partição EFI não é a primeira na unidade do Windows.

  • MaxBIOSVersion: NO

    • Configura a versão da BIOS para o máximo, evitando assim que atualizações de firmware no macOS 11 Big Sur e superior sejam baixadas. Mais relevante principalmente para Macs originais.

  • ProcessorType: 0

    • Configure como 0 para ativar a detecção automática de tipo. Porém, este valor pode ser substituído, se necessário. Veja o arquivo AppleSmBios.h (opens new window) (em inglês) para os valores possívels.

  • SpoofVendor: YES

    • Altera a informação de fabricante para Acidanthera. Geralmente, não é seguro usar Apple como fabricante na maioria dos casos.

  • SystemMemoryStatus: Auto

    • Define, nas informações da SMBIOS, se a memória é soldada ou não. Puramente cosmético, por isso recomenda-se deixar como Auto.

  • UpdateDataHub: YES

    • Atualiza os campos de Data Hub.

  • UpdateNVRAM: YES

    • Atualiza os campos da NVRAM.

  • UpdateSMBIOS: YES

    • Atualiza os campos da SMBIOS.

  • UpdateSMBIOSMode: Create

    • Substitui as tabelas com EfiReservedMemoryType recentemente alocado. Use Custom em notebooks Dell que exigem o uso da quirk CustomSMBIOSGuid.
    • Configurar para Custom com a quirk CustomSMBIOSGuid ativada pode também desativar a injeção de SMBIOS em sistemas operacionais que não são da Apple. No entanto, este método não é recomendado por quebrar a compatibilidade com o Bootcamp. Use por sua conta e risco.

# UEFI

UEFI

ConnectDrivers: YES

  • Força a conexão dos drivers .efi. Mudar para NO pode acelerar um pouco a inicialização, mas exigirá que os drivers se conectem por conta própria. Acontece que nem todos fazem isso, como é o caso de alguns drivers de sistema de arquivos, que podem não carregar caso esta opção esteja configurada para NO.

# Drivers

Adicione os drivers .efi aqui.

Para este guia, os únicos drivers que devem estar presentes nessa seção são:

  • HfsPlus.efi
  • OpenRuntime.efi

# APFS

Configurações relacionadas ao driver de APFS. Mantenha as opções padrão.

# Audio

Configurações relacionadas ao AudioDxe. Esta seção será ignorada neste guia. Mantenha todas as opções padrão. Esta seção não tem nada a ver com o suporte de áudio no macOS.

# Input

Configurações relacionadas à transmissão do teclado para o boot.efi. É usado para oferecer suporte ao FileVault e a teclas de atalho. Mantenha todas as opções padrão pois essas quirks não serão utilizados no momento. Obtenha mais detalhes aqui: Segurança e FileVault (opens new window).

# Output

Configurações relacionadas com a exibição visual do OpenCore. Mantenha todas as opções no padrão pois essas quirks não serão utilizadas no momento.

# ProtocolOverrides

Relevante principalmente em máquinas virtuais, Macs antigos e para usuários do FileVault. Para mais detalhes, acesse: Segurança e FileVault (opens new window).

# Quirks

Informações

Configurações das quirks relacionados ao ambiente UEFI. Altere as seguintes opções:

Quirk Ativada Observação
UnblockFsConnect NO Necessária principalmente em placas-mãe HP.
Informação Mais Detalhada

  • DisableSecurityPolicy: NO

    • Desativa a política de segurança de plataforma no firmware. Recomendado para firmwares problemáticos que impeçam o carregamento de drivers de firmware de terceiros ao desligar a Inicialização Segura.
    • Recomenda-se ativar esta opção em dispositivos Microsoft Surface.

  • RequestBootVarRouting: YES

    • Redireciona o AptioMemoryFix de EFI_GLOBAL_VARIABLE_GUID para OC_VENDOR_VARIABLE_GUID. É necessário quando o firmware tenta excluir as opções de boot. Recomenda-se deixar ativado em todos os computadores para garantir o funcionamento correto ao instalar atualizações, do painel de controle Disco de Inicialização e outras coisas.

  • UnblockFsConnect: NO

    • Alguns firmwares bloqueiam o intrumental de partições, abrindo-as no modo By Driver, o que resulta na impossibilidade de instalação dos protocolos de sistema de arquivo. É relevante principalmente em computadores HP, quando nenhum driver for listado.

# ReservedMemory

Usado para impedir que os sistemas operacionais usem certas regiões da memória. É relevante principalmente para as GPUs integradas das CPUs Sandy Bridge ou em computadores com falhas de memória. O uso desta quirk não será coberto neste guia.

# Limpando

Agora tudo está pronto para ser salvo e copiado para a partição EFI, na pasta EFI/OC.

Para aqueles que estiverem tendo problemas de inicialização, é recomendado ler a seção de Solução de Problemas primeiro. Se ainda restarem dúvidas, é possível consultar algum dos recursos disponíveis abaixo:

# Configurações da BIOS em AMD

  • Observação: a maioria dessas opções podem não estar presentes no firmware do seu computador. É recomendado que todas as opções estejam configuradas da forma mais próxima possível, mas não se preocupe muito caso essas opções não estejam presentes na BIOS do seu computador.

# Opções para Desativar

Nome em Inglês Nome em Português Observação
Fast Boot Inicialização Rápida NA
Secure Boot Inicialização Segura NA
Serial/COM Port Porta Serial/COM NA
Parallel Port Porta Paralela NA
Compatibility Support Module (CSM) Módulo de Suporte de Compatibilidade (MSC) É preciso estar desligada. Erros de GPU como gIO são comuns com essa opção ligada.

Observação especial para usuários da CPU 3990X: Atualmente, o macOS não suporta mais do que 64 threads no kernel. Caso tenha mais, ocorrerá uma kernel panic. A CPU 3990X possui um total de 128 threads e então precisa que metade deles sejam desligados. Nessas situações, recomenda-se desligar o hyper-threading na BIOS.

# Enable

Nome em Inglês Nome em Português Oservação
Above 4G decoding NA Precisa estar ligado. Se não puder encontrar essa opção, adicione npci=0x2000 aos argumentos de inicialização (boot-args). Não mantenha essa opção da BIOS e o argumento de boot ligados ao mesmo tempo!
Ativar essa opção pode quebrar certos drivers (ex.: Ethernet) ou causar falhas de inicialização em outros sistemas operacionais em placas-mãe Gigabyte/Aorus ou AsRock. Se isso acontecer, desative esta opção e, em vez dela, opte por utilizar a npci.
Em BIOS mais recentes (a partir de 2020), ativar o Above4G pode desbloquear a opção Resizable BAR Support em algumas placas-mãe X570 ou mais novas. Tenha certeza de desativar a opção Resizable BAR Support, em vez de mantê-la em Auto.
EHCI/XHCI Hand-off NA NA
OS type: Windows 8.1/10 UEFI Mode Tipo de SO: Windows 8.1/10 em Modo UEFI NA
SATA Mode: AHCI Modo SATA: AHCI NA

# Finalizando

Depois de tudo terminado, acesse o guia Processo de Instalação para continuar com a configuração do OpenCore.

⟵ Processo de Instalação ⟶