# Create EFI & Config - OCAuxiliaryTools This guide uses specific [example 10th Gen Intel hardware](https://chriswayg.gitbook.io/opencore-visual-beginners-guide/step-by-step/intro-hardware#example-hardware) for the purpose of illustrating the workflow of OCAuxiliaryTools tools. Presumably your hardware will differ, which means that your configuration will probably differ in each section. Do not just copy the settings shown for this example, but look up the recommended settings in the [OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/) in the section relevant for your CPU architecture. ## Using OpenCore Auxiliary Tools to Create EFI & Config * *OCAuxiliaryTools* is an excellent configuration and update utility. It will be used to create the complete OpenCore EFI folder including the Config.plist. *(You may use this alongside a plist editor such as* [*ProperTree*](https://github.com/corpnewt/ProperTree) *or* [*Xplist*](https://github.com/ic005k/PlistEDPlus)*)*. * If you are following this example, but are using different hardware, just open the relevant sections for *your CPU generation* in [config.plist Setup | OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/config.plist/#creating-your-config-plist) alongside *OCAuxiliaryTools.* * Download & install [OpenCore Auxiliary Tools - OCAT](https://github.com/ic005k/QtOpenCoreConfig) and launch the *OCAuxiliaryTools* application. ![OCAuxiliaryTools initial Window](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FVyawr2VzbOiZs7CPquO4%2FScreenshot%202024-06-01%20at%2010.01.08%20PM.png?alt=media\&token=6c618665-ad44-42fd-afc4-0b96bc475feb) * Click the *Database/Configuration Template* button *(highlighted in the screenshot)* * This links to a [Github repo](https://github.com/5T33Z0/OC-Little-Translated/tree/main/F_Desktop_EFIs/Config_Templates) where you can download the relevant configuration. *(The steps are also explained there.)* * *Click on* `Config_Templates.zip` and then the *Download Raw File* button on that Github page to download the [templates](https://raw.githubusercontent.com/5T33Z0/OC-Little-Translated/main/F_Desktop_EFIs/Config_Templates/Config_Templates.zip). Unzip the templates on your Desktop for example.

Configuration Templates locally downloaded

* Check which [Platform Info](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#platforminfo) is relevant for your hardware. For this example we will use `iMac20,1` and the corresponding file `Desktop_10thGen_Comet_Lake_iMac20,1.plist` * Open this configuration in OCAuxiliaryTools. Then click the Save button so that OCvalidate will update its messages accordingly, which should get rid of any errors. * *Then select Menu -> Edit -> Generate EFI on the Desktop* ![Edit Menu](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FDPxESaF86GdI3qyBSA9V%2FScreenshot%202024-06-01%20at%2010.34.37%20PM.png?alt=media\&token=0f818a64-4ecd-4e8c-8e7e-8a65cf83e9bf) This will generate the EFI folder including the most recent official release version of OpenCore on your desktop. For now ignore any missing kexts (which can be added later), as all the essential ones should be included already (as shown below) ![](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FNITvyddimVCdST7Cy7u5%2FScreenshot%202024-06-01%20at%2010.46.45%20PM.png?alt=media\&token=5956973d-6a99-4c55-a2a2-896922899b5f) ### ACPI In [ACPI - Add](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#acpi) uncheck what is not needed (as shown below) ![ACPI - Add Section](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FYF48AiHSjWhv5SnCkHMQ%2FScreenshot%202024-06-01%20at%2011.36.48%20PM.png?alt=media\&token=f554b972-28a0-4a62-a84d-4123296abcbd) * For example we may not need [SSDT-PMC](https://dortania.github.io/Getting-Started-With-ACPI/Universal/nvram) in Comet Lake any more, as the NVRAM works without it. * Check the relevant section of the [Desktop Comet Lake | OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#acpi) for more details. * Add any additional SSDTs, if needed by clicking on the **\[+]** button for downloaded SSDTs or by clicking on the **\[…]** button for the most common prebuilt SSDTs available within *OCAuxiliaryTools* In [ACPI - Quirks](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#acpi), uncheck *ResetLogoStatus*. (*'It is enabled by default in sample.plist. This Quirk didn't exist at the time the OpenCore Install Guide was written, so it's unknown if it's a requirement. Most likely it's not.' @5T33Z0*) ![ACPI Quirks Section](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2Fh0LVCVnUi1ZTtZKcp3WV%2FScreenshot%202024-06-01%20at%2010.53.20%20PM.png?alt=media\&token=89566496-ca68-42e7-b6df-aee8ba32ef98) **You can hover with your mouse over each option** (or right click and *Show Tips)* **to see the explanation from the official OpenCore reference manual.** This is a really helpful feature of *OCAuxiliaryTools*, as it enables you to quickly understand options which are only clearly explained in the very detailed [OpenCore Reference Manual](https://github.com/acidanthera/OpenCorePkg/blob/master/Docs/Configuration.pdf) document: ![Configuration.pdf](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2Fgit-blob-dcc7caeaa1db29c7954bdbc4bed5a7cb387f74f5%2Fopencore_configuration_doc.png?alt=media) ### Booter No changes in [Booter](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#booter) ![Booter - Quirks Section](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FrcFN8yxtZvozxyABbOwA%2FScreenshot%202024-06-01%20at%2010.56.57%20PM.png?alt=media\&token=7b2ca1d3-02b3-4339-941c-c3eddc96ab69) ### Device Properties In [Device Properties](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#deviceproperties) enable the iGPU for computing tasks only (not intended to drive a display), as you will be using a compatible dedicated AMD GPU. Therefore change `AAPL,ig-platform-id` to `0300913E` ![Device Properties - Add Section](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FpjeW0agVAjvqjGJRPMWf%2FScreenshot%202024-06-01%20at%2010.59.42%20PM.png?alt=media\&token=49da8a3d-40a8-486f-a9bc-54e1dd6c51f1) * Note, that keys which start with a **#** are commented out and will not be used by OpenCore ### Kernel In the [Kernel](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#kernel) section add `IntelMausi.kext`, the Intel onboard Ethernet driver for macOS. * Click on the **\[...]** button to open the most common kexts available within *OCAuxiliaryTools*. Just drag-and-drop `IntelMausi.kext` into the app window. It will automatically be added to the Config.plist and enabled. ![Kernel Add Section](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FlYgeqKA93itI9jY2fRjy%2FScreenshot%202024-06-01%20at%2011.02.55%20PM.png?alt=media\&token=6a782ad7-cf8c-4f1e-82a6-61439e8ed357) * Add any additional kexts, if needed by clicking on the **\[+]** button for kexts downloaded from elsewhere. * For changing the order of the kexts, select a kext and click on the **\[<]** and **\[>]** buttons to move the kext up or down which will determine the order in which they are loaded. No changes in the [Kernel - Quirks](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#quirks-3) section Optionally display the *Preselection* for your CPU platform, especially if you have opened an older EFI and you want to ensure that the recommended options have been enabled. The *Preselection* feature will display those option in ***Bold-Italic*** type without actually changing your settings. You will need to decide if the recommendations are relevant to you. Since we are installing Monterey or Ventura for this example, we do not enable the hacky *XhciPortLimit setting* any more: *"With macOS 11.3 (Big Sur) and newer,* [*XhciPortLimit is broken resulting in boot loops*](https://github.com/dortania/bugtracker/issues/162)*."* ![](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2F9WqtUgJCwf0zxrmUO1he%2FScreenshot%202024-06-01%20at%2011.08.45%20PM.png?alt=media\&token=9ee4f49f-5cd0-459a-b21e-b25b080641d5) * Again just hover with the mouse over each option to read the explanation from the OpenCore reference documentation. Alternatively right click over an option and select *Show Tips* to see the tip in a tool window. ### Misc In the section [Misc - Boot ](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#misc)you may choose PickerVariant *GoldenGate* for the OpenCore booter GUI ![](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FELbYBcpj0biwYoKn4IwR%2FScreenshot%202024-06-01%20at%2011.10.58%20PM.png?alt=media\&token=e30c8ac1-99a7-4af2-85a4-125d076e5027) In the [Misc - Debug](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#debug) section: *DisplayLevel* click the *Select* button and enable *Debug\_\_Warn* and *Debug\_\_Error* ![Misc - Debug Section](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2F4MYhCSzZnyNRemHGuC9m%2FScreenshot%202024-06-01%20at%2011.14.00%20PM.png?alt=media\&token=11167b1b-d44b-439e-a870-3c5b7c400c1c) * By default the EFI created by *OCAuxiliaryTools* uses the most recent *release* version of OpenCore. If you want to show additional debug information change `Target` to `67` and switch to the *debug* version of OpenCore, which will be explained at the end of this guide. In the [Misc - Security](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#security) section change *SecureBootModel* to *Default* if installing macOS Monterey or newer. ![Misc - Security Section](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FMlNK1nsV15dOIISr5tUj%2FScreenshot%202024-06-01%20at%2011.16.05%20PM.png?alt=media\&token=ea1918c1-f24a-4e59-8be5-7e61818568e0) In [Misc - Tools](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#tools), click the **\[…]** button and add `OpenShell.efi` by dragging it into the list ![Misc - Tools Section](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FEmPA5gqhkURIeCnl6Vs8%2FScreenshot%202024-06-01%20at%2011.18.06%20PM.png?alt=media\&token=492c64fb-12fb-4ffc-9dca-2f896c1be987) ### NVRAM In [NVRAM - Add](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#add-4) change `csr-active-config` to `00000000` to enable SIP. * Add the following string in `boot-args` for debugging and for audio: `-v debug=0x100 keepsyms=1 alcid=1` * Change `prev-lang:kbd` to use a `String` and input `en-US:0` (or your language code) instead of using the HEX value. ![NVRAM - Add Section](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2F1IAmNo6F0AGSAuZM1gbO%2FScreenshot%202024-06-01%20at%2011.22.09%20PM.png?alt=media\&token=cebfae43-dbff-46ac-9512-e01805fdd2cd) ### Platform Info In the [Platform Info - Generic](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#platforminfo) section, use the built-in Generator of *OCAuxiliaryTools* for setting up the SMBIOS info (instead of using the *GenSMBIOS* terminal application). * Click *Generate* (near the *SystemProductName* field) ![Platform Info - Generic Section](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2Fu4IPyKc260CPlIjR4qXZ%2FScreenshot%202024-06-01%20at%2011.25.29%20PM.png?alt=media\&token=5359ed2a-c961-4896-a166-338b2e0c755e) * Also check the serial on the [Apple Support](https://checkcoverage.apple.com/us/en/) webpage. * You should see *“… we’re unable to check coverage for this serial number”* or something similar in your language. This is the response you want, because your Hackintosh should not reuse someone else’s existing serial from a real Mac. * The *SerialInfo* tab of *OCAuxiliaryTools* displays the info of the new serial generated for the EFI you are working on. ### UEFI No changes needed in the [UEFI](https://dortania.github.io/OpenCore-Install-Guide/config.plist/comet-lake.html#uefi) section ![UEFI Drivers Section](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2F86lekb6i8I0l7wTCuwYr%2FScreenshot%202024-06-01%20at%2011.26.34%20PM.png?alt=media\&token=9bb2a8b6-b8d4-4190-976b-50c66690f130) * You can add additional drivers using the **\[+]** or **\[…]** button. * The OpenCanopy boot GUI should work out-of-the-box as *OCAuxiliaryTools* activates it by default. * If you want to enable the *Boot Chime*, you can configure it in the *UEFI-Audio* section during post-install. See [Setting up Boot-chime with AudioDxe](https://dortania.github.io/OpenCore-Post-Install/cosmetic/gui.html#setting-up-boot-chime-with-audiodxe). ### Notes * If your motherboard uses the Intel’s I225-V 2.5GBe ethernet controller, additional settings are required in the relevant sections. Just refer to the [OpenCore Install Guide](https://dortania.github.io/OpenCore-Install-Guide/) and use the applicable presets in *OCAuxiliaryTools*. * Remember to **save your Config.plist** by clicking the *Save* button or with Menu -> File -> Save. Several **additional features of OCAuxiliaryTools** will be discussed on the page [**Debug and Upgrade OpenCore**](https://chriswayg.gitbook.io/opencore-visual-beginners-guide/step-by-step/oc-auxiliary-tools-upgrade)**.** This page also serves as an unofficial introductory user guide for **OCAuxiliaryTools. It has been updated with OCAuxiliaryTools version 20240001 using OpenCore 1.0.0. As this page is only infrequently updated, newer versions may have different features or require different settings.** ![](https://3366797968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LwXl0c-BaUDNDvUg8TP%2Fuploads%2FFgodoVfQ9J7nzfXa4rSu%2Fby-nc-license.svg?alt=media\&token=03a208c0-37c6-488e-b564-b57cd43c75c9) *Except where otherwise noted, content on this site is licensed under the* [*Creative Commons — Attribution-NonCommercial 4.0 International — CC BY-NC 4.0*](https://creativecommons.org/licenses/by-nc/4.0/) *license. Attribution by link to* [*chriswayg · GitHub*](https://github.com/chriswayg)*.*