Skip to content

Add Chromebook specific properties to Skylake and newer config.plist's #420

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
averycblack merged 19 commits into from
May 3, 2023
Merged

Add Chromebook specific properties to Skylake and newer config.plist's #420

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
e78bfed
Fix formatting
meghan06 Mar 2, 2023
c507aec
Added clarification for Chromebook hacks
meghan06 Mar 2, 2023
c72d613
Added extra documentation for Chromebook hacks
meghan06 Mar 2, 2023
acb49f1
Update icelake.md
meghan06 Mar 2, 2023
e387b11
Update icelake.md
meghan06 Mar 2, 2023
161c652
Add clarification for Chromebook hacks
meghan06 Mar 11, 2023
75fa1ca
Update coffee-lake-plus.md
meghan06 Mar 11, 2023
b40d691
Added clarification for Chromebook haks
meghan06 Mar 11, 2023
cf4bedb
Remove the 's' from "Comments"
meghan06 Mar 11, 2023
31a6369
Merge branch 'master' into master
meghan06 Mar 11, 2023
f7cbf0e
Update coffee-lake-plus.md
meghan06 May 3, 2023
eb74bc5
Update icelake.md
meghan06 May 3, 2023
c8e6b2a
Update kaby-lake.md
meghan06 May 3, 2023
7fe5ada
Update skylake.md
meghan06 May 3, 2023
1e8b02c
Fix Lint warnings
meghan06 May 3, 2023
af386b2
Fix Lint warnings (i hope)
meghan06 May 3, 2023
022ae8e
fix lint warnings part 2
meghan06 May 3, 2023
c964d63
Merge branch 'master' into master
meghan06 May 3, 2023
750b95c
Update config-laptop.plist/coffee-lake.md
meghan06 May 3, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions config-laptop.plist/coffee-lake-plus.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,10 +97,11 @@ This section is allowing devices to be pass-through to macOS that are generally
::: tip Info
Settings relating to boot.efi patching and firmware fixes, for us, we need to change the following:

| Quirk | Enabled |
| :--- | :--- |
| Quirk | Enabled | Comment |
| :--- | :--- | :--- |
| DevirtualiseMmio | YES |
| EnableWriteUnprotector | NO |
| ProtectMemoryRegions| YES | Only for Chromebooks, leave disabled otherwise. |
| ProtectUefiServices | YES |
| RebuildAppleMemoryMap | YES |
| SyncRuntimePermissions | YES |
Expand All @@ -117,6 +118,8 @@ Settings relating to boot.efi patching and firmware fixes, for us, we need to ch
* **EnableWriteUnprotector**: NO
* This quirk and RebuildAppleMemoryMap can commonly conflict, recommended to enable the latter on newer platforms and disable this entry.
* However, due to issues with OEMs not using the latest EDKII builds you may find that the above combo will result in early boot failures. This is due to missing the `MEMORY_ATTRIBUTE_TABLE` and such we recommend disabling RebuildAppleMemoryMap and enabling EnableWriteUnprotector. More info on this is covered in the [troubleshooting section](/troubleshooting/extended/kernel-issues.md#stuck-on-eb-log-exitbs-start)
* **ProtectMemoryRegions**: YES
* Patches memory region types for incorrectly mapped CSM/MMIO regions. Necessary for all Chromebooks that utilize coreboot UEFI firmware.
* **ProtectUefiServices**: YES
* Protects UEFI services from being overridden by the firmware, mainly relevant for VMs, Icelake and Z390 systems'
* If on Z390, **enable this quirk**
Expand Down Expand Up @@ -553,6 +556,7 @@ System Integrity Protection bitmask
| boot-args | Description |
| :--- | :--- |
| **-wegnoegpu** | Used for disabling all other GPUs than the integrated Intel iGPU, useful for those wanting to run newer versions of macOS where their dGPU isn't supported |
| **-igfxnotelemetryload** | Prevents iGPU telemetry from loading. iGPU telemetry may cause a freeze during startup on certain laptops such as Chromebooks on macOS 10.15 and higher, see [here](https://github.com/acidanthera/WhateverGreen#intel-hd-graphics) for more information.

* **csr-active-config**: `00000000`
* Settings for 'System Integrity Protection' (SIP). It is generally recommended to change this with `csrutil` via the recovery partition.
Expand Down
9 changes: 7 additions & 2 deletions config-laptop.plist/coffee-lake.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -96,11 +96,13 @@ This section is allowing spaces to be pass-through to macOS that are generally i
::: tip Info
Settings relating to boot.efi patching and firmware fixes, for us, we need to change the following:

| Quirk | Enabled |
| :--- | :--- |
| Quirk | Enabled | Comment |
| :--- | :--- | :--- |
| EnableWriteUnprotector | NO |
| ProtectMemoryRegions| YES | Only for Chromebooks, leave disabled otherwise. |
| RebuildAppleMemoryMap | YES |
| SyncRuntimePermissions | YES |

:::

::: details More in-depth Info
Expand All @@ -112,6 +114,8 @@ Settings relating to boot.efi patching and firmware fixes, for us, we need to ch
* **EnableWriteUnprotector**: NO
* This quirk and RebuildAppleMemoryMap can commonly conflict, recommended to enable the latter on newer platforms and disable this entry.
* However, due to issues with OEMs not using the latest EDKII builds you may find that the above combo will result in early boot failures. This is due to missing the `MEMORY_ATTRIBUTE_TABLE` and such we recommend disabling RebuildAppleMemoryMap and enabling EnableWriteUnprotector. More info on this is covered in the [troubleshooting section](/troubleshooting/extended/kernel-issues.md#stuck-on-eb-log-exitbs-start)
* **ProtectMemoryRegions**: YES
* Patches memory region types for incorrectly mapped CSM/MMIO regions. Necessary for all Chromebooks that utilize coreboot UEFI firmware.
* **ProvideCustomSlide**: YES
* Used for Slide variable calculation. However the necessity of this quirk is determined by `OCABC: Only N/256 slide values are usable!` message in the debug log. If the message `OCABC: All slides are usable! You can disable ProvideCustomSlide!` is present in your log, you can disable `ProvideCustomSlide`.
* **RebuildAppleMemoryMap**: YES
Expand Down Expand Up @@ -522,6 +526,7 @@ System Integrity Protection bitmask
| boot-args | Description |
| :--- | :--- |
| **-wegnoegpu** | Used for disabling all other GPUs than the integrated Intel iGPU, useful for those wanting to run newer versions of macOS where their dGPU isn't supported |
| **-igfxnotelemetryload** | Prevents iGPU telemetry from loading. iGPU telemetry may cause a freeze during startup on certain laptops such as Chromebooks on macOS 10.15 and higher, see [here](https://github.com/acidanthera/WhateverGreen#intel-hd-graphics) for more information.

* **csr-active-config**: `00000000`
* Settings for 'System Integrity Protection' (SIP). It is generally recommended to change this with `csrutil` via the recovery partition.
Expand Down
10 changes: 7 additions & 3 deletions config-laptop.plist/icelake.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,18 +94,19 @@ This section is allowing devices to be pass-through to macOS that are generally
### Quirks

::: tip Info

Settings relating to boot.efi patching and firmware fixes, for us, we need to change the following:

| Quirk | Enabled |
| :--- | :--- |
| Quirk | Enabled | Comment |
| :--- | :--- | :--- |
| DevirtualiseMmio | YES |
| EnableWriteUnprotector | NO |
| ProtectMemoryRegions | YES | Chromebooks only, fixes kernel panics triggered by shutdown/restart. |
| ProtectUefiServices | YES |
| RebuildAppleMemoryMap | YES |
| SetupVirtualMap | NO |
| SyncRuntimePermissions | YES |
:::

::: details More in-depth Info

* **AvoidRuntimeDefrag**: YES
Expand All @@ -117,6 +118,8 @@ Settings relating to boot.efi patching and firmware fixes, for us, we need to ch
* **EnableWriteUnprotector**: NO
* This quirk and RebuildAppleMemoryMap can commonly conflict, recommended to enable the latter on newer platforms and disable this entry.
* However, due to issues with OEMs not using the latest EDKII builds you may find that the above combo will result in early boot failures. This is due to missing the `MEMORY_ATTRIBUTE_TABLE` and such we recommend disabling RebuildAppleMemoryMap and enabling EnableWriteUnprotector. More info on this is covered in the [troubleshooting section](/troubleshooting/extended/kernel-issues.md#stuck-on-eb-log-exitbs-start)
* **ProtectMemoryRegions**: YES
* Patches memory region types for incorrectly mapped CSM/MMIO regions. Necessary for all Chromebooks that utilize coreboot UEFI firmware.
* **ProtectUefiServices**: YES
* Protects UEFI services from being overridden by the firmware, mainly relevant for VMs, Icelake and Z390 systems'
* If on Z390, **enable this quirk**
Expand Down Expand Up @@ -517,6 +520,7 @@ System Integrity Protection bitmask
| boot-args | Description |
| :--- | :--- |
| **-wegnoegpu** | Used for disabling all other GPUs than the integrated Intel iGPU, useful for those wanting to run newer versions of macOS where their dGPU isn't supported |
| **-igfxnotelemetryload** | Prevents iGPU telemetry from loading. iGPU telemetry may cause a freeze during startup on certain laptops such as Chromebooks on macOS 10.15 and higher, see [here](https://github.com/acidanthera/WhateverGreen#intel-hd-graphics) for more information. |

* **csr-active-config**: `00000000`
* Settings for 'System Integrity Protection' (SIP). It is generally recommended to change this with `csrutil` via the recovery partition.
Expand Down
3 changes: 2 additions & 1 deletion config-laptop.plist/kaby-lake.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,7 @@ This section is allowing spaces to be pass-through to macOS that are generally i
### Quirks

::: tip Info

Settings relating to boot.efi patching and firmware fixes. For most users, leave it as default.

* **ProtectMemoryRegions**: YES
Expand Down Expand Up @@ -604,7 +605,7 @@ System Integrity Protection bitmask
| boot-args | Description |
| :--- | :--- |
| **-wegnoegpu** | Used for disabling all other GPUs than the integrated Intel iGPU, useful for those wanting to run newer versions of macOS where their dGPU isn't supported |
|**-igfxnotelemetryload** | Prevents iGPU telemetry from loading. iGPU telemetry may cause a freeze during startup on certain laptops such as Chromebooks on macOS 10.15 and higher, see [here](https://github.com/acidanthera/WhateverGreen#intel-hd-graphics) for more information.
| **-igfxnotelemetryload** | Prevents iGPU telemetry from loading. iGPU telemetry may cause a freeze during startup on certain laptops such as Chromebooks on macOS 10.15 and higher, see [here](https://github.com/acidanthera/WhateverGreen#intel-hd-graphics) for more information.

* **csr-active-config**: `00000000`
* Settings for 'System Integrity Protection' (SIP). It is generally recommended to change this with `csrutil` via the recovery partition.
Expand Down
10 changes: 9 additions & 1 deletion config-laptop.plist/skylake.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,12 @@ This section is allowing spaces to be pass-through to macOS that are generally i
### Quirks

::: tip Info
Settings relating to boot.efi patching and firmware fixes, for us, we leave it as default

Settings relating to boot.efi patching and firmware fixes. For most users, leave it as default.

* **ProtectMemoryRegions**: YES
* Fixes shutdown/restart on some Chromebooks that would otherwise result in a `AppleEFINVRAM` kernel panic.

:::
::: details More in-depth Info

Expand All @@ -103,6 +108,8 @@ Settings relating to boot.efi patching and firmware fixes, for us, we leave it a
* Enables slide variables to be used in safe mode.
* **EnableWriteUnprotector**: YES
* Needed to remove write protection from CR0 register.
* **ProtectMemoryRegions**: YES
* Patches memory region types for incorrectly mapped CSM/MMIO regions. Necessary for all Chromebooks that utilize coreboot UEFI firmware.
* **ProvideCustomSlide**: YES
* Used for Slide variable calculation. However the necessity of this quirk is determined by `OCABC: Only N/256 slide values are usable!` message in the debug log. If the message `OCABC: All slides are usable! You can disable ProvideCustomSlide!` is present in your log, you can disable `ProvideCustomSlide`.
* **SetupVirtualMap**: YES
Expand Down Expand Up @@ -514,6 +521,7 @@ System Integrity Protection bitmask
| boot-args | Description |
| :--- | :--- |
| **-wegnoegpu** | Used for disabling all other GPUs than the integrated Intel iGPU, useful for those wanting to run newer versions of macOS where their dGPU isn't supported |
| **-igfxnotelemetryload** | Prevents iGPU telemetry from loading. iGPU telemetry may cause a freeze during startup on certain laptops such as Chromebooks on macOS 10.15 and higher, see [here](https://github.com/acidanthera/WhateverGreen#intel-hd-graphics) for more information. |

* **csr-active-config**: `00000000`
* Settings for 'System Integrity Protection' (SIP). It is generally recommended to change this with `csrutil` via the recovery partition.
Expand Down