diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js old mode 100755 new mode 100644 index 3baec780b..2d7f19ca5 --- a/docs/.vuepress/config.js +++ b/docs/.vuepress/config.js @@ -112,6 +112,7 @@ module.exports = { 'UNINSTALL', 'ICNS', 'WINDOWS', + 'UNIVERSALCONTROL', ] }, { diff --git a/docs/POST-INSTALL.md b/docs/POST-INSTALL.md index 3fccebdcd..f38125d68 100644 --- a/docs/POST-INSTALL.md +++ b/docs/POST-INSTALL.md @@ -41,7 +41,7 @@ Note: Machines with non-Metal GPUs cannot enable SIP in Big Sur either due to pa | :--- | :--- | :--- | | ![](../images/OCLP-GUI-Settings-SIP-Enabled.png) | ![](../images/OCLP-GUI-Settings-SIP-Root-Patch.png) | ![](../images/OCLP-GUI-Settings-SIP-Disabled.png) | -::: warning +:::warning If you're unsure whether you should enable SIP, leave as-is. Systems where you have already ran the Post Install Root Patching cannot enable SIP without potentially breaking the current install. @@ -49,11 +49,22 @@ If you're unsure whether you should enable SIP, leave as-is. Systems where you h ## Applying Post Install Volume Patches -Users with OCLP v0.4.4 or higher will be prompted to install these patches after installation or whenever patches are not detected on the system. We recommend rebuilding OpenCore with the latest version of OCLP to take advantage of these new features. +Post Install Volume Patches, sometimes also called root patches, are patches that have to be installed on disk for some older Macs to gain back functionality. + +OCLP v0.4.4 and higher include an autopatcher, which will automatically root patch your system but **only if the USB install media was created within OCLP.** + +Users with OCLP v0.4.4 or higher will also be prompted to install these patches after macOS updates or whenever patches are not detected on the system. We recommend rebuilding OpenCore with the latest version of OCLP to take advantage of these new features. + + + +In OCLP v0.4.5 a new indicator was added to help users to see if, when and on what version the system was root patched. Note that the "Available patches" section above this does not track the status and will always show the patches that are available, whether they're installed or not. + +| Automatic install prompt in 0.4.4+ | Last patched status in 0.4.5+ | +| :--- | :--- | +| ![](../images/OCLP-GUI-root-patch-update.png) | ![](../images/OCLP-GUI-Root-Patch-Status.png) | + -In v0.4.5 a new indicator was added to help users to see if, when and on what version the system was root patched. Note that the "Available patches" section above this does not track the status and will always show the patches that are available, whether they're installed or not. -![](../images/OCLP-GUI-Root-Patch-Status.png) ### Running Post Install patches manually @@ -65,7 +76,7 @@ If you're using OCLP v0.4.3 or earlier, or need to run the patcher manually, you | ![](../images/OCLP-GUI-Root-Patch.png) | ![](../images/OCLP-GUI-Root-Patch-Finished.png) | -::: warning +:::warning With OpenCore Legacy Patcher versions prior to v0.4.4, Root Patching requires a network connection by default to grab associated resources. If your system is having difficulties with wifi or ethernet, you can grab the newest release : @@ -73,7 +84,7 @@ With OpenCore Legacy Patcher versions prior to v0.4.4, Root Patching requires a ::: -::: details Unsupported GPUs in macOS Big Sur +:::details Unsupported GPUs in macOS Big Sur * NVIDIA: * Tesla (8000 - 300 series) @@ -85,7 +96,7 @@ With OpenCore Legacy Patcher versions prior to v0.4.4, Root Patching requires a ::: -::: details Unsupported GPUs in macOS Monterey +:::details Unsupported GPUs in macOS Monterey * NVIDIA: * Tesla (8000 - 300 series) @@ -99,7 +110,7 @@ With OpenCore Legacy Patcher versions prior to v0.4.4, Root Patching requires a ::: -::: details Unsupported Wireless Cards in macOS Monterey +:::details Unsupported Wireless Cards in macOS Monterey * Broadcom: * BCM94328 diff --git a/docs/TESTED.md b/docs/TESTED.md index c1ba251ec..2ffe69eb8 100644 --- a/docs/TESTED.md +++ b/docs/TESTED.md @@ -2,7 +2,7 @@ To aid users in troubleshooting, we've compiled a list of users who've reported success with OpenCore Legacy patcher as well as the version used. This should aid users in verifying whether issues with the patcher are regression-related with newer versions. -### MacBook +::: details MacBook | SMBIOS | Tested | Tester | Model | Version | Comment | | :--- | :--- | :--- | :--- | :--- | :--- | @@ -15,12 +15,14 @@ To aid users in troubleshooting, we've compiled a list of users who've reported | ^^ | ^^ | AlexSakha67 | ^^ | 0.0.20 | ^^ | | MacBook8,1 | NO | N/A | N/A | N/A | ^^ | -### MacBook Air +::: + +::: details MacBook Air | SMBIOS | Tested | Tester | Model | Version | Comment | | :--- | :--- | :--- | :--- | :--- | :--- | -| MacBookAir2,1 | NO | N/A | N/A | N/A | N/A | -| MacBookAir3,1 | YES | uvesten | Stock | 0.3.3 | ^^ | +| MacBookAir2,1 | YES | Bruno | Stock | 0.4.5 | Slow to the point of being unusable. | +| MacBookAir3,1 | ^^ | uvesten | Stock | 0.3.3 | N/A | | MacBookAir3,2 | ^^ | houser42 | ^^ | Unknown | ^^ | | MacBookAir4,1 | NO | N/A | N/A | N/A | ^^ | | MacBookAir4,2 | YES | bdwilson1907 | Stock | 0.3.1 | Intermittent keyboard backlight | @@ -32,7 +34,9 @@ To aid users in troubleshooting, we've compiled a list of users who've reported | MacBookAir6,1 | NO | N/A | N/A | N/A | N/A | | MacBookAir6,2 | ^^ | ^^ | ^^ | ^^ | ^^ | -### MacBook Pro +::: + +::: details MacBook Pro | SMBIOS | Tested | Tester | Model | Version | Comment | | :--- | :--- | :--- | :--- | :--- | :--- | @@ -40,91 +44,101 @@ To aid users in troubleshooting, we've compiled a list of users who've reported | MacBookPro5,1 | ^^ | GURU_Jasho#5736 | ^^ | 0.0.21 | ^^ | | MacBookPro5,2 | ^^ | hvds | ^^ | ^^ | ^^ | | MacBookPro5,3 | ^^ | kommtzeitkonrad | ^^ | 0.0.22 | ^^ | -| MacBookPro5,4 | NO | N/A | N/A | N/A | N/A | -| MacBookPro5,5 | ^^ | ^^ | ^^ | ^^ | ^^ | -| MacBookPro6,1 | ^^ | ^^ | ^^ | ^^ | ^^ | +| MacBookPro5,4 | NO | N/A | N/A | N/A | ^^ | +| MacBookPro5,5 | YES | ASentientHedgehog | Stock | - | ^^ | +| ^^ | ^^ | ParaDoX1994 | Stock | 0.4.5 | Camera/Bluetooth not working (connector broken) | +| MacBookPro6,1 | NO | N/A | N/A | N/A | N/A | | MacBookPro6,2 | YES | Jakeluke | Stock | Unknown | dGPU broken | | MacBookPro7,1 | ^^ | fussel132 | ^^ | 0.1.2 | N/A -| ^^ | ^^ | casey1234 | Upgraded SSD | 0.3.3 | ^^ | -| MacBookPro8,1 | ^^ | AvaQueen | Stock | 0.0.19 | ^^ | -| MacBookPro8,1 | ^^ | charly-black | Upgraded BCM94331PCIEBT4CAX | 0.3.1 | ^^ | +| ^^ | ^^ | casey1234 | Upgraded | 0.3.3 | Upgraded SSD | +| MacBookPro8,1 | YES | AvaQueen | Stock | 0.0.19 | ^^ | +| MacBookPro8,1 | ^^ | charly-black | Upgraded | 0.3.1 | Upgraded BCM94331PCIEBT4CAX | | MacBookPro8,2 | ^^ | air.man | Stock | 0.0.22 | dGPU disabled | | ^^ | ^^ | cboukouv | ^^ | 0.0.19 | N/A | | MacBookPro8,3 | ^^ | lulujyc | ^^ | 0.1.4 | dGPU disabled | -| MacBookPro9,1 | ^^ | jbdamiano | Stock | 0.0.19 | N/A | +| MacBookPro9,1 | YES | jbdamiano | Stock | 0.0.19 | N/A | | ^^ | ^^ | dennes544 | ^^ | ^^ | ^^ | | ^^ | ^^ | cgrazy | ^^ | ^^ | ^^ | | ^^ | ^^ | LIPA85 | ^^ | ^^ | ^^ | -| MacBookPro9,2 | ^^ | alexx17xx | ^^ | ^^ | ^^ | +| MacBookPro9,2 | YES | alexx17xx | ^^ | ^^ | ^^ | | ^^ | ^^ | Arvxistanx | ^^ | ^^ | ^^ | | ^^ | ^^ | CyberDroid1 | ^^ | 0.0.16 | ^^ | -| ^^ | ^^ | woefi | Upgraded BCM94331CAX | 0.0.13 | ^^ | -| ^^ | ^^ | whgmkeller | Stock | 0.0.11 | ^^ | +| ^^ | ^^ | woefi | Upgraded | 0.0.13 | Upgraded BCM94331CAX | +| ^^ | ^^ | whgmkeller | Stock | 0.0.11 | N/A | | ^^ | ^^ | vinaypundith | Unknown | 0.0.7 | ^^ | -| ^^ | ^^ | casey1234 | Upgraded RAM and SSD | 0.3.3 | ^^ | -| ^^ | ^^ | crystall1nedev | ^^ | 0.4.4 | ^^ | -| MacBookPro10,1 | ^^ | traviswparker | Stock | 0.0.14 | ^^ | -| ^^ | ^^ | il-rollino | Upgraded BCM94360CSAX | 0.0.21 | ^^ | +| ^^ | ^^ | casey1234 | Upgraded | 0.3.3 | Upgraded RAM and SSD | +| ^^ | ^^ | crystall1nedev | Upgraded | 0.4.4 | ^^ | +| MacBookPro10,1 | YES | traviswparker | Stock | 0.0.14 | ^^ | +| ^^ | ^^ | il-rollino | Upgraded | 0.0.21 | Upgraded BCM94360CSAX | | MacBookPro10,2 | ^^ | akidone | ^^ | 0.3.0 | ^^ | -| MacBookPro11,1 | ^^ | ParaDoX1994 | Stock | 0.4.4 | ^^ | +| MacBookPro11,1 | YES | ParaDoX1994 | Stock | 0.4.4 | N/A | | MacBookPro11,2 | ^^ | casey1234 | ^^ | 0.3.3 | ^^ | -| MacBookPro11,3 | NO | N/A | N/A | N/A | ^^ | +| MacBookPro11,3 | NO | N/A | N/A | N/A | N/A | +::: -### Mac mini +::: details Mac mini | SMBIOS | Tested | Tester | Model | Version | Comment | | :--- | :--- | :--- | :--- | :--- | :--- | -| Macmini3,1 | NO | N/A | N/A | N/A | N/A | -| Macmini4,1 | YES | Towster15#6369 | Stock | 0.4.4 | Does not have internal SATA cable, booted and installed to SSD over USB 2.0 instead | -| Macmini5,1 | NO | N/A | N/A | N/A | N/A | -| Macmini5,2 | YES | charly-black | Dual Core 2.7GHz
AMD HD6630M | Patcher Version 0.3.1 | ^^ | -| Macmini5,3 | ^^ | ^^ | ^^ | ^^ | ^^ | -| Macmini6,1 | ^^ | cicofz | Stock | 0.0.21 | ^^ | +| Macmini3,1 | YES | ASentientHedgehog | Stock | N/A | N/A | +| Macmini4,1 | YES | Towster15#6369 | ^^ | 0.4.4 | Does not have internal SATA cable, booted and installed to SSD over USB 2.0 instead | +| ^^ | ^^ | MykolaG | ^^ | 0.4.5 | SD card reader possibly broken. | +| Macmini5,1 | YES | MykolaG | ^^ | 0.4.5 | N/A | +| Macmini5,2 | ^^ | charly-black | ^^ | 0.3.1 | ^^ | +| ^^ | ^^ | MykolaG | ^^ | 0.4.5 | SD card reader possibly broken. | +| Macmini5,3 | NO | N/A | N/A | N/A | N/A | +| Macmini6,1 | YES | cicofz | Stock | 0.0.21 | ^^ | | ^^ | ^^ | Stig124 | ^^ | 0.0.19 | ^^ | | ^^ | ^^ | mwidjaya | ^^ |0.0.18 | ^^ | -| Macmini6,2 | ^^ | Shelbs | ^^ | 0.0.16 | ^^ | +| ^^| ^^ | MykolaG | ^^ | 0.4.5 | ^^ | +| Macmini6,2 | ^^ | Shelbs | ^^ | 0.0.16 | ^^ | +| Macmini7,1 | YES | MykolaG | ^^ | 0.4.5 | ^^ | +| Macmini8,1 | ^^ | ^^ | ^^ | 0.4.5 | ^^ | +::: -### iMac +::: details iMac | SMBIOS | Tested | Tester | Model | Version | Comment | | :--- | :--- | :--- | :--- | :--- | :--- | -| iMac7,1 | YES | lulujyc | iMac 20-inch
Upgraded BCM94352HMB | 0.3.1 | The USB 1.1 controller is unstable on Big Sur+, using USB hubs (forcing USB 2.0) can fix unrecognized keyboard/ mouse. | -| iMac8,1 | ^^ | EduCovas | Stock | 0.0.21 | N/A | -| iMac9,1 | ^^ | Allanrfox | ^^ | ^^ | ^^ | +| iMac7,1 | YES | lulujyc | Upgraded | 0.3.1 | Upgraded with BCM94352HMB

The USB 1.1 controller is unstable on Big Sur+, using USB hubs (forcing USB 2.0) can fix unrecognized keyboard/ mouse. | +| iMac8,1 | YES | EduCovas | Stock | 0.0.21 | N/A | +| iMac9,1 | YES | Allanrfox | ^^ | ^^ | ^^ | | ^^ | ^^ | Jakeluke | ^^ | ^^ | ^^ | -| iMac10,1 | ^^ | Ausdauersportler | Upgraded WX4150 | Unknown | ^^ | -| iMac11,1 | ^^ | internetzel | - Upgraded RX580 mobile | ^^ | ^^ | -| iMac11,2 | ^^ | MykolaG | Stock | 0.0.21 | ^^ | +| iMac10,1 | YES | Ausdauersportler | Upgraded | Unknown | Upgraded with WX4150 | +| iMac11,1 | ^^ | internetzel | ^^ | ^^ | Upgraded RX580 mobile | +| iMac11,2 | ^^ | MykolaG | Stock | 0.0.21 | N/A | | ^^ | ^^ | iMac-iPad | ^^ | ^^ | ^^ | | ^^ | ^^ | vinaypundith | Unknown | 0.0.19 | ^^ | -| iMac11,3 | ^^ | Ausdauersportler | Upgraded Polaris GPU
Upgraded BCM943602CDP | 0.0.21 | ^^ | -| iMac12,1 | ^^ | shnockdu | Upgraded Kepler GPU | ^^ | ^^ | -| ^^ | ^^ | StephN999 | Upgraded WX4150 GPU
BCM94360CD| ^^ | ^^ | -| iMac12,2 | ^^ | Ausdauersportler | Upgraded Polaris GPU
Upgraded BCM943602CDP | ^^ | ^^ | -| iMac13,1 | ^^ | alexx17xx | Stock | 0.0.19 | ^^ | +| iMac11,3 | ^^ | Ausdauersportler | Upgraded | 0.0.21 | Upgraded with Polaris GPU and BCM943602CDP | +| iMac12,1 | YES | shnockdu | ^^ | ^^ | Upgraded with Kepler GPU | +| ^^ | ^^ | StephN999 | ^^ | ^^ | Upgraded with WX4150 GPU and BCM94360CD | +| iMac12,2 | ^^ | Ausdauersportler | ^^ | ^^ | Upgraded with Polaris GPU and BCM943602CDP | +| iMac13,1 | YES | alexx17xx | Stock | 0.0.19 | N/A | | iMac13,2 | ^^ | Alain13 | ^^ | ^^ | ^^ | | ^^ | ^^ | algernonpule | ^^ | ^^ | ^^ | | iMac13,3 | NO | N/A | N/A | N/A | ^^ | -| iMac14,1 | YES | woefi | Upgraded NVMe | 0.0.21 | ^^ | -| ^^ | ^^ | mikeboss | Stock | 0.0.19 | ^^ | +| iMac14,1 | YES | woefi | Upgraded | 0.0.21 | Upgraded NVMe | +| ^^ | ^^ | mikeboss | Stock | 0.0.19 | N/A | | iMac14,2 | ^^ | OKonnel | ^^ | 0.0.22 | ^^ | | ^^ | ^^ | mibaxx | ^^ | 0.0.21 | ^^ | -| iMac14,3 | NO | N/A | N/A | N/A | ^^ | -| iMac15,1 | YES | JakubMazur | Upgraded RAM
Upgraded Radeon R9 M295X
Upgraded Quad-Core Intel Core i7 | 0.4.1 | ^^ | +| iMac14,3 | ^^ | StupeFied | ^^ | 0.4.5 | ^^ | +| iMac15,1 | YES | JakubMazur | Upgraded | 0.4.1 | Upgraded RAM, Radeon R9 M295X and Quad-Core Intel Core i7 | +::: -### Mac Pro +::: details Mac Pro | SMBIOS | Tested | Tester | Model | Version | Comment | | :--- | :--- | :--- | :--- | :--- | :--- | -| MacPro3,1 | YES | MykolaG | Upgraded RX 470
Upgraded BCM94360CD
Stock Bluetooth card removed | 0.1.6 | N/A | -| ^^ | ^^ | christiann |Upgraded RX 560
Upgraded BCM94322
Stock Bluetooth card removed | 0.0.21 | ^^ | -| ^^ | ^^ | gw463 | Upgraded GTX 680
Upgraded BCM94360 | 0.0.22 | ^^ | -| ^^ | ^^ | AlexSakha67 | Upgraded R9 280 | 0.0.20 | ^^ | -| ^^ | ^^ | nekton1 | Upgraded GTX 680 | ^^ | ^^ | -| ^^ | ^^ | Pri-est | Unknown | 0.0.9 | ^^ | -| ^^ | ^^ | vinaypundith | Upgraded GTX 680
Upgraded BCM94360CD | 0.0.6 | ^^ | -| ^^ | ^^ | ParaDoX1994 | Upgraded HD 7950
Stock Bluetooth card removed | 0.4.4 | ^^ | -| MacPro4,1 | ^^ | vinaypundith | Unknown | 0.0.9 | ^^ | -| MacPro5,1 | ^^ | woefi | Upgraded with RX 580 | 0.0.21 | ^^ | -| ^^ | ^^ | Mabrouk Oscar | Unknown | ^^ | ^^ | -| ^^ | ^^ | astuffedtiger | MacPro4,1 flashed to 5,1 | 0.0.18 | ^^ | +| MacPro3,1 | YES | MykolaG | Upgraded | 0.1.6 | Upgraded RX 470 and BCM94360CD.
Stock Bluetooth card removed. | +| ^^ | ^^ | christiann | ^^ | 0.0.21 | Upgraded RX 560 and BCM94322.
Stock Bluetooth card removed. | +| ^^ | ^^ | gw463 | ^^ | 0.0.22 | Upgraded GTX 680 and BCM94360 | +| ^^ | ^^ | AlexSakha67 | ^^ | 0.0.20 | Upgraded R9 280 | +| ^^ | ^^ | nekton1 | ^^ | ^^ | Upgraded GTX 680 | +| ^^ | ^^ | Pri-est | Unknown | 0.0.9 | N/A | +| ^^ | ^^ | vinaypundith | Upgraded | 0.0.6 | Upgraded with GTX 680 and BCM94360CD. | +| ^^ | ^^ | ParaDoX1994 | ^^ | 0.4.4 | Upgraded with HD 7950.
Stock Bluetooth card removed. | +| MacPro4,1 | YES | vinaypundith | Unknown | 0.0.9 | N/A | +| MacPro5,1 | ^^ | woefi | Upgraded | 0.0.21 | Upgraded with RX 580. | +| ^^ | ^^ | Mabrouk Oscar | Unknown | ^^ | N/A | +| ^^ | ^^ | astuffedtiger | Flashed | 0.0.18 | MacPro4,1 flashed to 5,1 | +::: diff --git a/docs/UNIVERSALCONTROL.md b/docs/UNIVERSALCONTROL.md new file mode 100644 index 000000000..c07555b32 --- /dev/null +++ b/docs/UNIVERSALCONTROL.md @@ -0,0 +1,227 @@ +# Universal Control on unsupported Macs + +Introduced in macOS 12 Monterey, Universal Control is a feature that allows a Mac to control other Macs and/or iPads, share input devices, and share files across them simultaneously. With OpenCore and FeatureUnlock, Universal Control can be unlocked for most unsupported Macs, so long as they meet the technical requirements. + +* Note: Following page is primarily for hobbiests, no proper support is provided outside of Discord support (see bottom of page) + +## Enabling Universal Control + +If you meet all the requirements, in most cases you can go to Display Preferences and tick the Universal Control settings to enable it. If you're planning to use Universal Control with an iPad, make sure to enable Universal Control on the iPad as well. + + +| Display Preferences | Universal Control settings | +| :--- | :--- | +| ![](../images/UC-enable-1.png) | ![OCLP GUI Build Finished](../images/UC-enable-2.png) | + + +Most Macs 2011 and above should work out of the box. However, older Macs like 2008-2011 MacBook Pro's require upgrading to a newer Wi-Fi/Bluetooth card. More info in the [requirements section.](#requirements-for-universal-control) + +Some Monterey-native models are blacklisted, check the [blacklisted models section](#blacklisted-models) for more info. + +## Requirements for Universal Control + +Technical requirements: + +* Wi-Fi 4 (802.11n) +* Bluetooth 4.0 +* macOS Monterey 12.4 or newer +* iPadOS 15.4 or newer (if applicable) +* OpenCore Legacy Patcher 0.4.3 or newer + +Check the [table of models](#table-of-models) below whether you need to upgrade hardware and exactly what hardware is required to be changed based on the offending Macs. Refer for help on how to upgrade the Wi-Fi card on older 2008-2011 models on the Discord channel [#hardware](https://discord.gg/rqdPgH8xSN) if required. + + + +Other requirements: + +* All devices signed into the same iCloud account. +* Two Factor Authentication enabled with your Apple ID. +* Bluetooth and WiFi enabled, neither needs to be connected so long as they are enabled. +* Handoff turned on from iCloud settings. +* The devices in question to be in close proximity. + + +### Table of models + +This table shows which models do and don't support Universal Control out of box (OOB) and what is required to gain support. + +::: details MacBook + +| SMBIOS | WiFi/BT version | UC OOB | Comment | +|------------|-----------------|------------|---------| +| MacBook4,1 | Wi-Fi 4 / BT 2.0 EDR | NO | Use the Mac Pro Wi-Fi upgrade kit to upgrade to BCM94360 | +| MacBook5,1 | ^^ | ^^ | ^^ | +| MacBook5,2 | WiFi 4 / BT 2.1 EDR | ^^ | ^^ | +| MacBook6,1 | ^^ | ^^ | Upgrade to BCM94360 | +| MacBook7,1 | ^^ | ^^ | ^^ | +| MacBook8,1 | WiFi 5 + BT 4.0 | YES | Universal Control will work. | + +::: + +::: details MacBook Air + +| SMBIOS | WiFi/BT version | UC OOB | Comment | +|--------|-----------------|------------|---------| +| MacBookAir2,1 | Wi-Fi 4 / BT 2.1 EDR | NO | Replace the card with BCM94360 and disconnect/disable the BT module. | +| MacBookAir3,1 | ^^ | ^^ | ^^ | +| MacBookAir3,2 | ^^ | ^^ | ^^ | +| MacBookAir4,1 | Wi-Fi 4 + BT 4.0 | YES | Universal Control will work. | +| MacBookAir4,2 | ^^ | ^^ | ^^ | +| MacBookAir5,1 | ^^ | ^^ | ^^ | +| MacBookAir5,2 | ^^ | ^^ | ^^ | +| MacBookAir6,1 | Wi-Fi 5 + BT 4.0 | ^^ | ^^ | +| MacBookAir6,2 | ^^ | ^^ | ^^ | +| MacBookAir7,1 | ^^ | NO | Hardware supports UC.
[**Spoofing required.**](#blacklisted-models)| +| MacBookAir7,2 | ^^ | ^^ | ^^ | + + +::: + +::: details MacBook Pro + +| SMBIOS | WiFi/BT version | UC OOB | Comment | +|--------|-----------------|-------------|---------| +| MacBookPro4,1 | Wi-Fi 4 / BT 2.1 EDR | NO | Use the Mac Pro Wi-Fi upgrade kit to upgrade to BCM94360 | +| MacBookPro5,1 | ^^ | ^^ | Upgrading to BCM94331 requires some heavy case hardware modifications, so instead use a USB BT 4.0 dongle | +| MacBookPro5,2 | ^^ | ^^ | ^^ | +| MacBookPro5,3 | ^^ | ^^ | ^^ | +| MacBookPro5,4 | ^^ | ^^ | ^^ | +| MacBookPro5,5 | ^^ | ^^ | ^^ | +| MacBookPro6,1 | ^^ | ^^ | ^^ | +| MacBookPro6,2 | ^^ | ^^ | ^^ | +| MacBookPro7,1 | ^^ | ^^ | ^^ | +| MacBookPro8,1 | Wi-Fi 4 + BT 2.1 EDR | ^^ | Upgrade to BCM94331 | +| MacBookPro8,2 | ^^ | ^^ | ^^ | +| MacBookPro9,1 | Wi-Fi 4 + BT 4.0 | YES | Universal Control will work. | +| MacBookPro9,2 | ^^ | ^^ | ^^ | +| MacBookPro10,1 | ^^ | ^^ | ^^ | +| MacBookPro10,2 | ^^ | ^^ | ^^ | +| MacBookPro11,1 | Wi-Fi 5 + BT 4.0 | ^^ | ^^ | +| MacBookPro11,2 | ^^ | ^^ | ^^ | +| MacBookPro11,3 | ^^ | ^^ | ^^ | +| MacBookPro11,4 | Wi-Fi 5 + BT 4.2 | NO | Hardware supports UC.
[**Spoofing required.**](#blacklisted-models) | +| MacBookPro11,5 | ^^ | ^^ | ^^ | +| MacBookPro12,1 | ^^ | ^^ | ^^ | +::: + +:::details Mac mini + +| SMBIOS | WiFi/BT version | UC OOB | Comment | +|--------|-----------------|------------|---------| +| Macmini3,1 | Wi-Fi 4 + BT 2.1 EDR | NO | Upgrade requires some heavy electrical and case modifications, so instead used a USB BT 4.0 dongle. | +| Macmini4,1 | ^^ | ^^ | Upgrade to BCM94360. | +| Macmini5,1 | Wi-Fi 4 + BT 4.0 | YES | Universal Control will work. | +| Macmini5,2 | ^^ | ^^ | ^^ | +| Macmini5,3 | ^^ | ^^ | ^^ | +| Macmini6,1 | ^^ | ^^ | ^^ | +| Macmini6,2 | ^^ | ^^ | ^^ | +| Macmini7,1 | Wi-Fi 5 + BT 4.0 | NO | Hardware supports UC.
[**Spoofing required.**](#blacklisted-models) | + +::: + + +:::details iMac + +| SMBIOS | WiFi/BT version | UC OOB | Comment | +|----------|-----------------|------------|---------| +| iMac7,1 | Wi-Fi 4 + BT 2.0 EDR | NO | Use the Mac Pro Wi-Fi upgrade kit to upgrade to BCM94360 (soldering required for BT) +| iMac8,1 | ^^ | ^^ | ^^ | +| iMac9,1 | Wi-Fi 4 / BT 2.1 EDR | ^^ | ^^ | +| iMac10,1 | ^^ | ^^ | ^^ | +| iMac11,1 | ^^ | ^^ | ^^ | +| iMac11,2 | ^^ | ^^ | ^^ | +| iMac11,3 | ^^ | ^^ | ^^ | +| iMac12,1 | ^^ | ^^ | ^^ | +| iMac12,2 | ^^ | ^^ | ^^ | +| iMac13,1 | Wi-Fi 4 + BT 4.0 | YES | Universal Control will work. | +| iMac13,2 | ^^ | ^^ | ^^ | +| iMac13,3 | ^^ | ^^ | ^^ | +| iMac14,1 | Wi-Fi 5 + BT 4.0 | ^^ | ^^ | +| iMac14,2 | ^^ | ^^ | ^^ | +| iMac14,3 | ^^ | ^^ | ^^ | +| iMac14,4 | ^^ | ^^ | ^^ | +| iMac15,1 | ^^ | ^^ | ^^ | +| iMac16,1 | Wi-Fi 5 + BT 4.2 | NO | Hardware supports UC.
[**Spoofing required.**](#blacklisted-models) | +| iMac16,2 | ^^ | ^^ | ^^ | + +::: + +:::details Mac Pro + +| SMBIOS | WiFi/BT version | UC OOB | Comment | +|-----------|-----------------|---------|---------| +| MacPro3,1 | Wi-Fi 4 + BT 2.0 EDR | NO | Use the Mac Pro Wi-Fi upgrade kit to upgrade to BCM94360. | +| MacPro4,1 | Wi-Fi 4 + BT 2.1 EDR | ^^ | Use the Mac Pro Wi-Fi upgrade kit to upgrade to BCM94360 (soldering required for BT) | +| MacPro5,1 | ^^ | ^^ | ^^ | +| MacPro6,1 | Wi-Fi 5 + BT 4.0 | ^^ | Hardware supports UC.
[**Spoofing required.**](#blacklisted-models) | + +* Note: Some older Mac Pro configurations may not have shipped with a WiFi card in the base model + + +::: +## Blacklisted models + +The following models are blacklisted from using Universal Control by Apple: + +- MacBookAir7,x - MacBook Air Early 2015 11" / 13" +- MacBookPro11,4 - MacBook Pro Mid 2015 15" (Intel Iris) +- MacBookPro11,5 - MacBook Pro Mid 2015 15" (dGPU) +- MacBookPro12,x - MacBook Pro Early 2015 13" +- iMac16,x - iMac Late 2015 21" +- Macmini7,x - Mac mini 2014 +- MacPro6,x - Mac Pro Late 2013 + +The hardware in these models is capable but due to blacklisting, the only solution to use Universal Control on the models above is to spoof their SMBIOS. SMBIOS spoofing essentially fools some aspects of macOS to think they are running on a different machine. + +With SMBIOS Spoofing, the Universal Control handshake recognizes a different SMBIOS and thus grants a blacklisted Mac to connect to other iPads and Macs with Universal Control. + +| Situation | Condition | Solution | +|-----------|-----------|---------| +| Mac <-> Mac connection | Monterey-unsupported | No spoofing needed | +| Mac <-> iPad connection | Monterey-unsupported | No spoofing needed | +| Mac <-> Mac connection | One or both are blacklisted |Spoofing required on blacklisted Macs | +| Mac <-> iPad connection | Blacklisted Mac | Spoofing required on blacklisted Mac | + +:::warning + +Before we continue, please keep in mind SMBIOS Spoofing is an advanced feature of OpenCore, that with reckless usage of it, could potentially screw things around and leave your installation non-working. Once you boot into a spoofed state, it is highly recommended you stay spoofed, and avoid booting macOS without OpenCore. + +::: + +### How to spoof + +Firstly, run the GUI version of OpenCore Legacy Patcher, go to **Settings** and tick **Allow native models**. + +**Note:** Unless you are building OpenCore on a different machine than it's targeted for, **do not** change the model in this main settings view. It is important to understand that OCLP targets this model regardless of what you may have spoofed to, as your Mac is still what the Native SMBIOS shows. + +Secondly, go to **SMBIOS Settings**, tick **Allow Native Spoofs**, set SMBIOS Spoof Level to **Moderate**. Set SMBIOS Spoof Model to **one next to your native model in the table for spoofed models below.** + + +::: details Table for spoofed models (click to expand) + +Any model after the list of officially blacklisted Macs should be supported, but these are the earliest Macs with Universal Control support, and thus chosen for the sake of simplicity. + +**Reminder:** Macs that are not listed on this table work without spoofing, including systems that do not natively support Monterey as long as the other requirements are met, since they aren't blacklisted. + + +| Mac by name | Native SMBIOS | Spoof SMBIOS | Tested | Tested by | +|-------------|---------------|--------------|--------|-----------| +| MacBook Air Early 2015 11" / 13" | MacBookAir7,x | MacBookAir8,1 | YES | Hzlph | +| MacBook Pro Early 2015 13" | MacBookPro12,x | MacBookPro13,1 | ^^ | ^^ | +| MacBook Pro Mid 2015 15" | MacBookPro11,4 / 11,5 | MacBookPro13,3 | ^^ | ^^ +| iMac Late 2015 21" | iMac16,x | iMac18,2 | ^^ | ^^ +| Mac mini Late 2014 | Macmini7,x | MacMini8,1 | NO | N/A | +| Mac Pro Late 2013 | MacPro6,x | MacPro7,1 | YES | Crystall1nedev | + +::: + +| Main Settings view | SMBIOS settings | +| :--- | :--- | +| ![](../images/OCLP-allow-native-models.png) | ![](../images/OCLP-smbios-settings.png) | + + +Build and install OpenCore again, reboot back to the OS. Enable Universal Control as explained in [Enabling Universal Control section.](#enabling-universal-control) + + + +You should now be prompted to log back into iCloud by your Mac. This means you were successful, otherwise, verify you are correctly following the steps listed above, or else ask on the Discord group for assistance on [#misc-help](https://discord.gg/rqdPgH8xSN). diff --git a/docs/UPDATE.md b/docs/UPDATE.md index eb45085a1..8fc078325 100644 --- a/docs/UPDATE.md +++ b/docs/UPDATE.md @@ -1,6 +1,6 @@ -# Updating OpenCore and Co +# Updating OpenCore and Patches -With OpenCore Legacy Patcher, generally there's very little reason for users to update the OpenCore installed on their machine unless you feel there's a benefit with new versions for your setup. +With OpenCore Legacy Patcher, generally there's very little reason for users to update the OpenCore installed on their machine unless you feel there's a benefit with new versions for your setup, e.g. Bluetooth has stopped working with a new macOS update. For those who do wish to update, it's actually quite easy. Simply [download the latest release](https://github.com/dortania/OpenCore-Legacy-Patcher/releases) and rerun the patcher: diff --git a/images/OCLP-GUI-Root-Patch-Status.png b/images/OCLP-GUI-Root-Patch-Status.png index 79d2b908d..9e075ea94 100644 Binary files a/images/OCLP-GUI-Root-Patch-Status.png and b/images/OCLP-GUI-Root-Patch-Status.png differ diff --git a/images/OCLP-GUI-root-patch-update.png b/images/OCLP-GUI-root-patch-update.png new file mode 100644 index 000000000..f4fa00c32 Binary files /dev/null and b/images/OCLP-GUI-root-patch-update.png differ diff --git a/images/OCLP-allow-native-models.png b/images/OCLP-allow-native-models.png new file mode 100644 index 000000000..60269bd6d Binary files /dev/null and b/images/OCLP-allow-native-models.png differ diff --git a/images/OCLP-smbios-settings.png b/images/OCLP-smbios-settings.png new file mode 100644 index 000000000..5b0d71228 Binary files /dev/null and b/images/OCLP-smbios-settings.png differ diff --git a/images/UC-enable-1.png b/images/UC-enable-1.png new file mode 100644 index 000000000..8c3a7b5e5 Binary files /dev/null and b/images/UC-enable-1.png differ diff --git a/images/UC-enable-2.png b/images/UC-enable-2.png new file mode 100644 index 000000000..6995707a9 Binary files /dev/null and b/images/UC-enable-2.png differ