### Command Block Example

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/README.md

Placeholder for demonstrating command-line syntax examples.

```bash
command syntax here
```

--------------------------------

### Code Sample Example

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/README.md

Placeholder for demonstrating code samples, such as XML or plist configurations.

```xml
<configuration here>
```

--------------------------------

### Configuration Table Header Example

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/README.md

Example of a header row for configuration tables, specifying columns for Parameter, Type, Required, Default, and Description.

```markdown
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
```

--------------------------------

### Install and Run USBMap Tool

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/installation-guide.md

Clone the USBMap repository and run the command-line script to map USB ports. Follow the on-screen prompts to detect and configure your USB ports.

```bash
git clone https://github.com/corpnewt/USBMap
cd USBMap
python USBMap.command
```

--------------------------------

### EFI File Structure Checklist

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/installation-guide.md

Verify that all essential files and directories are present in your EFI partition before proceeding with the installation. This structure is crucial for a successful boot.

```text
EFI/
├── BOOT/
│   └── BOOTX64.efi
└── OC/
    ├── ACPI/
    │   ├── SSDT-PLUG.aml
    │   ├── SSDT-EC-USBX.aml
    │   ├── SSDT-AWAC.aml
    │   └── SSDT-RHUB.aml
    ├── Drivers/
    │   ├── OpenRuntime.efi
    │   ├── HfsPlus.efi
    │   └── ...
    ├── Kexts/
    │   ├── Lilu.kext/
    │   ├── VirtualSMC.kext/
    │   ├── WhateverGreen.kext/
    │   └── ... (other kexts)
    └── config.plist
```

--------------------------------

### Decision Matrix Header Example

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/README.md

Example of a header row for decision matrices, showing columns for Processor, Cores, and SMBIOS.

```markdown
| Processor | Cores | SMBIOS |
|-----------|-------|--------|
```

--------------------------------

### iGPU AAPL,ig-platform-id Configuration Example

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/device-properties-reference.md

Example of how to set the AAPL,ig-platform-id property for Intel integrated graphics in config.plist. This specific example uses Base64 encoding for the value 07009B3E.

```xml
<key>PciRoot(0x0)/Pci(0x2,0x0)</key>
<dict>
    <key>AAPL,ig-platform-id</key>
    <data>BwCbPg==</data>  <!-- 07009B3E in Base64 -->
</dict>
```

--------------------------------

### Add i225 Ethernet and iGPU Configuration to config.plist

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/device-properties-reference.md

Example of adding custom device properties for the Intel i225 Ethernet controller and integrated graphics (iGPU) to the config.plist. This includes setting the 'AAPL,ig-platform-id' for the iGPU and 'device-id' and 'compatible' for the Ethernet controller.

```xml
<key>DeviceProperties</key>
<dict>
    <key>Add</key>
    <dict>
        <key>PciRoot(0x0)/Pci(0x2,0x0)</key>
        <dict>
            <key>AAPL,ig-platform-id</key>
            <data>BwCbPg==</data>
        </dict>
        <key>PciRoot(0x0)/Pci(0x1C,0x4)/Pci(0x0,0x0)</key>
        <dict>
            <key>device-id</key>
            <data>wOADDg==</data>
            <key>compatible</key>
            <string>pci8086,37d0</string>
        </dict>
    </dict>
</dict>
```

--------------------------------

### Audio Kexts: Choose One

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/quick-reference.md

Kernel extensions for audio support. Choose AppleALC.kext for most systems or VoodooHDA.kext for AMD FX or problematic audio setups.

```text
AppleALC.kext               (most systems)
  OR
VoodooHDA.kext              (AMD FX / problematic audio)
```

--------------------------------

### Run genSMBIOS Tool

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/installation-guide.md

Execute the genSMBIOS script to begin the process of generating unique system identifiers. Ensure you have Python installed and the tool extracted.

```bash
python genSMBIOS.py
```

--------------------------------

### Configure iGPU Stolen Memory

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/device-properties-reference.md

Example for setting the 'framebuffer-stolenmem' property to specify iGPU stolen memory size. The provided value 'AAAAAA==' corresponds to 0x00000000, typically used for firmware allocation.

```xml
<key>framebuffer-stolenmem</key>
<data>AAAAAA==</data>  <!-- 0x00000000 for firmware allocation -->
```

--------------------------------

### Sonoma 14.4+ Installation Secure Boot Configuration

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/macos-version-support.md

During the installation of macOS Sonoma 14.4 and newer, SecureBootModel must be set to 'Disabled' in Misc > Security to prevent installation loops. This is a critical security check enforced by these versions.

```plist
SecureBootModel Disabled
```

--------------------------------

### Combine Boot Arguments for Ventura with Navi GPU and i225 Ethernet

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/boot-arguments-reference.md

Use 'agdpmod=pikera e1000=0' for complex configurations, such as Ventura systems with a Navi GPU and i225 Ethernet. This combines arguments for graphics and Ethernet controller compatibility.

```bash
agdpmod=pikera e1000=0
```

--------------------------------

### macOS Sonoma (14.4+) Security Configuration

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/quick-reference.md

Security settings for macOS Sonoma during installation and after first boot. SecureBootModel should be Disabled during installation and then set to Default.

```text
During Installation:
  Misc > Security > SecureBootModel: Disabled

After First Boot:
  Misc > Security > SecureBootModel: Default
```

--------------------------------

### BIOS Enable Checklist

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/quick-reference.md

Ensure these BIOS settings are enabled for optimal performance and compatibility.

```text
☐ VT-x
☐ Above 4G Decoding (or use npci=0x2000 in boot-args)
☐ Hyper-Threading
☐ Execute Disable Bit
☐ EHCI/XHCI Hand-off
☐ OS Type: Windows 8.1/10 UEFI Mode
☐ DVMT Pre-Allocated: 64MB
☐ SATA Mode: AHCI
```

--------------------------------

### Networking Boot Arguments

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/quick-reference.md

Use these boot arguments to address specific network adapter issues on certain macOS versions.

```bash
dk.e1000=0          # i225 on Monterey ≤12.2.1
e1000=0             # i225 on Monterey ≥12.3 through Tahoe
```

--------------------------------

### Backup EFI Partition

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/installation-guide.md

To back up your EFI partition, first mount it using `diskutil mount /dev/diskXs1`, then copy the EFI folder to a secure backup location. Replace `/path/to/backup/` with your desired backup directory.

```bash
# Mount EFI partition
diskutil mount /dev/diskXs1

# Backup to safe location
cp -r /Volumes/EFI/EFI /path/to/backup/EFI_backup
```

--------------------------------

### Combine Boot Arguments for Gaming System with AMD Navi GPU

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/boot-arguments-reference.md

Use 'agdpmod=pikera -wegnoegpu' to force the use of the iGPU while ensuring the system recognizes the dedicated GPU as Navi, which can prevent black screens. This configuration is suitable for gaming systems with AMD Navi GPUs.

```bash
agdpmod=pikera -wegnoegpu
```

--------------------------------

### Configure iGPU AAPL,ig-platform-id for Desktop (Alternative)

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/installation-guide.md

Use AAPL,ig-platform-id 00009B3E as an alternative for desktop systems if the primary value does not work. This serves as a fallback configuration.

```yaml
AAPL,ig-platform-id
00009B3E
```

--------------------------------

### Graphics Boot Arguments

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/quick-reference.md

Apply these boot arguments for specific graphics configurations, such as AMD Navi GPUs or forcing integrated graphics.

```bash
agdpmod=pikera      # AMD Navi (RX 5000/6000)
-wegnoegpu          # Force iGPU only
```

--------------------------------

### Copy EFI to SSD

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/installation-guide.md

After macOS installation, mount the EFI partition of your USB and SSD, then copy the EFI folder from the USB to the SSD's EFI partition. Ensure you identify the correct disk using `diskutil list`.

```bash
# Mount EFI partition
diskutil list                          # Find EFI disk
diskutil mount /dev/diskXs1            # Mount EFI (X = disk number)

# Copy EFI
cp -r /Volumes/USB\ EFI/EFI /Volumes/EFI/
```

--------------------------------

### Sonoma 14.4+ Post-Installation Secure Boot Re-enablement

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/macos-version-support.md

After successfully installing macOS Sonoma 14.4 or newer, it is recommended to change SecureBootModel back from 'Disabled' to 'Default' in Misc > Security. This restores the system's secure boot status.

```plist
SecureBootModel Default
```

--------------------------------

### Monterey Boot Argument for i225 Ethernet (12.3.1+)

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/macos-version-support.md

Use this updated boot argument for i225 ethernet on Monterey versions 12.3.1 and later.

```plist
boot-args: e1000=0
```

--------------------------------

### Disable APFS Minimum Date and Version Requirements

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/macos-version-support.md

For macOS Catalina (10.15) and older, these settings are critical to bypass APFS format version checks that would otherwise cause installation failures. Without them, you may encounter 'APFS Volume could not be mounted' errors.

```plist
MinDate -1
MinVersion -1
```

--------------------------------

### WiFi/Bluetooth Kexts: Choose One

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/quick-reference.md

Kernel extensions for WiFi and Bluetooth. Select AirportItlwm + IntelBluetoothFirmware for Intel WiFi, or AirportBrcmFixup + BrcmPatchRAM for Broadcom.

```text
Intel WiFi:         AirportItlwm + IntelBluetoothFirmware
Broadcom:           AirportBrcmFixup + BrcmPatchRAM
```

--------------------------------

### Add Boot Argument for Intel i225 Ethernet

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/installation-guide.md

Add the appropriate boot argument to your config.plist to ensure the Intel i225 Ethernet driver functions correctly based on your macOS version.

```bash
e1000=0
```

```bash
dk.e1000=0
```

--------------------------------

### Mount EFI Partition

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/quick-reference.md

Commands to list disks, mount the EFI partition, and back it up. Replace 'X' with the correct disk number.

```bash
diskutil list                     # Find EFI disk
diskutil mount /dev/diskXs1       # X = disk number
cp -r /Volumes/EFI /path/backup   # Backup first
```

--------------------------------

### Memory Boot Argument

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/quick-reference.md

This boot argument can be used if the 'Above 4G Decoding' BIOS option is unavailable.

```bash
npci=0x2000         # Above 4G Decoding if BIOS option unavailable
```

--------------------------------

### Basic Device Properties Structure

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/device-properties-reference.md

This XML structure shows the location and basic organization of device properties within OpenCore's config.plist, using a placeholder for the iGPU platform ID.

```xml
<key>DeviceProperties</key>
<dict>
    <key>Add</key>
    <dict>
        <key>PciRoot(0x0)/Pci(0x2,0x0)</key>
        <dict>
            <key>AAPL,ig-platform-id</key>
            <data>....VALUE......</data>
        </dict>
    </dict>
</dict>
```

--------------------------------

### Monterey 12.2.1 and Earlier i225 Ethernet Boot Argument

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/macos-version-support.md

Use this boot argument for early versions of macOS Monterey (12.2.1 and prior) if you have an i225 Ethernet adapter. This argument was necessary due to the 'dk.' prefix used for DriverKit parameters in these versions.

```bash
dk.e1000=0
```

--------------------------------

### Monterey Boot Argument for i225 Ethernet (12.0-12.2.1)

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/macos-version-support.md

Use this boot argument for i225 ethernet on Monterey versions 12.0 through 12.2.1.

```plist
boot-args: dk.e1000=0
```

--------------------------------

### Create USB Port Map

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/quick-reference.md

This command helps create a USB port map. Follow the prompts and copy the generated SSDT-USBMAP.aml to the EFI/OC/ACPI/ directory.

```bash
python USBMap.command
# Follow prompts
# Copy generated SSDT-USBMAP.aml to EFI/OC/ACPI/
```

--------------------------------

### Input Kexts for Laptops

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/quick-reference.md

Kernel extensions for laptop input devices, including I2C, RMI, SMBus trackpads, and PS2 keyboards/trackpads.

```text
VoodooI2C.kext              (I2C trackpad)
VoodooRMI.kext              (Synaptics SMBus trackpad)
VoodooSMBus.kext            (ELAN SMBus trackpad)
VoodooPS2Controller.kext    (PS2 keyboard/trackpad)
```

--------------------------------

### config.plist Platform Information

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/quick-reference.md

Configure the PlatformInfo > Generic section in your config.plist using values generated by genSMBIOS.

```text
PlatformInfo > Generic:
  ├─ MLB: [From genSMBIOS]
  ├─ ROM: [From genSMBIOS]
  ├─ SystemSerialNumber: [From genSMBIOS]
  └─ SystemUUID: [From genSMBIOS]
```

--------------------------------

### Catalina Configuration

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/macos-version-support.md

Configuration settings for macOS Catalina (10.15).

```plist
UEFI.APFS.MinDate: -1
UEFI.APFS.MinVersion: -1
Misc.Security.SecureBootModel: j137 (or equivalent)
```

--------------------------------

### Configure Boot Arguments in OpenCore config.plist

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/boot-arguments-reference.md

Boot arguments are set within the OpenCore config.plist file under NVRAM -> Add -> 7C436110-AB2A-4BBB-A880-FE41995C9F82 -> boot-args. This XML snippet shows how to set 'agdpmod=pikera e1000=0'.

```xml
<key>NVRAM</key>
<dict>
    <key>Add</key>
    <dict>
        <key>7C436110-AB2A-4BBB-A880-FE41995C9F82</key>
        <dict>
            <key>boot-args</key>
            <string>agdpmod=pikera e1000=0</string>
        </dict>
    </dict>
</dict>
```

--------------------------------

### Monterey 12.3.1 and Newer i225 Ethernet Boot Argument

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/macos-version-support.md

For macOS Monterey 12.3.1 and later, use this boot argument for i225 Ethernet adapters. Apple changed the parameter naming convention, removing the 'dk.' prefix.

```bash
e1000=0
```

--------------------------------

### Convert Hex to Base64

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/device-properties-reference.md

Demonstrates the conversion of a hexadecimal string to its Base64 equivalent. This is often required when formatting binary data for device properties.

```text
Hex: 07 00 9B 3E
Base64: BwCbPg==
```

--------------------------------

### Disable Discrete GPUs and Use Intel Integrated Graphics

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/boot-arguments-reference.md

Add `-wegnoegpu` to disable all discrete GPUs and force the system to use the Intel integrated GPU. This is useful when a discrete GPU is unsupported, for testing iGPU stability, or for reducing power consumption. Note that this may reduce performance for graphically intensive tasks.

```bash
-wegnoegpu
```

--------------------------------

### Monterey Configuration (12.0 - 12.2.1)

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/macos-version-support.md

Configuration settings for macOS Monterey versions 12.0 through 12.2.1, including the i225 ethernet boot argument.

```plist
boot-args: dk.e1000=0           (if i225 present)
Misc.Security.SecureBootModel: j137
```

--------------------------------

### EFI Directory Structure

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/acpi-reference.md

Illustrates the standard directory layout for ACPI files within the EFI/OC/ACPI/ path. File names are typical but may vary based on compilation.

```text
EFI/
└── OC/
    └── ACPI/
        ├── SSDT-PLUG.aml
        ├── SSDT-EC-USBX.aml
        ├── SSDT-AWAC.aml
        ├── SSDT-RHUB.aml
        ├── SSDT-PNLF.aml          (laptop only)
        └── SSDT-GPIO-XOSI.aml     (laptop only)
```

--------------------------------

### Configure iGPU AAPL,ig-platform-id for Laptop UHD 630

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/installation-guide.md

Use AAPL,ig-platform-id 0900A53E for laptops with UHD 630 graphics. This is the recommended setting for optimal performance.

```yaml
AAPL,ig-platform-id
0900A53E
```

--------------------------------

### PCI Path Components Notation

Source: https://github.com/luchina-gabriel/base-efi-intel-10thgen-comet-lake-public/blob/main/_autodocs/device-properties-reference.md

Understand the OpenCore notation for PCI device paths, which is used to address specific hardware components in your system's configuration.

```plaintext
PciRoot(domain)/Pci(bus,device)/Pci(bus,device)/...
```