From 99f5dbd01f44383a8239a52dd180e3bd24b1e018 Mon Sep 17 00:00:00 2001 From: neon ball <35791009+ParaDoX1994@users.noreply.github.com> Date: Fri, 2 May 2025 02:03:42 +0300 Subject: [PATCH] Improve USB 1.1 troubleshoot explainers --- docs/TROUBLESHOOTING.md | 34 ++++++++++++++++++++++------------ 1 file changed, 22 insertions(+), 12 deletions(-) diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md index b72d4af4d..b20d2016d 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/TROUBLESHOOTING.md @@ -299,14 +299,10 @@ The reason for this is that the autopatcher will assume that you will be using t ## Keyboard, Mouse and Trackpad not working in installer or after update -For Macs using legacy USB 1.1 controllers, OpenCore Legacy Patcher can only restore support once it has performed root volume patches. Thus to install macOS, you need to hook up a USB hub between your Mac and Keyboard/Mouse. +Starting from macOS Ventura, USB 1.1 drivers are no longer provided in the operating system. For Macs using legacy USB 1.1 controllers, OpenCore Legacy Patcher can only restore support once it has performed root volume patches which restore the drivers. Thus when installing macOS or after an update, you need to hook up a USB hub between your Mac and keyboard/mouse in order to install the root patches. * For MacBook users, you'll need to find an external keyboard/mouse in addition to the USB hub -More information can be found here: - -* [Legacy UHCI/OHCI support in Ventura #1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021) - Applicable models include: | Family | Year | Model | Notes | @@ -318,18 +314,32 @@ Applicable models include: | Mac mini | Mid 2011 and older | Macmini3,1 - Macmini5,x | | | Mac Pro | Mid 2010 and older | MacPro3,1 - MacPro5,1 | | -::: warning Note - -In macOS Sonoma, this seems to have been further weakened and some hubs may not be functional. - -Alternative way is making sure to enable "Remote Login" in General -> Sharing before updating, which will enable SSH. That means you can take control using Terminal in another system by typing `ssh username@lan-ip-address` and your password. After that run Post Install Volume Patching by typing `/Applications/OpenCore-Patcher.app/Contents/MacOS/OpenCore-Patcher --patch_sys_vol` and finally `sudo reboot`. - -:::
USB1.1 chart
+::: warning Note + +In macOS Sonoma, this seems to have been further weakened and some hubs may not be functional. If you encounter this issue, try another hub. + +::: + +Alternative way for updates is making sure to enable "Remote Login" in General -> Sharing before updating, which will enable SSH. That means you can take control using Terminal in another system and run Post Install Volume Patching. + +**This only applies to updates via Software Update and is not applicable when booting to installer via USB drive.** + +Use the following commands: + +1. `ssh username@lan-ip-address` - Connects via SSH, change username and IP address to the system's +2. `/Applications/OpenCore-Patcher.app/Contents/MacOS/OpenCore-Patcher --patch_sys_vol` - Installs root patches via CLI +3. `sudo reboot`. + +More information can be found here: + +* [Legacy UHCI/OHCI support in Ventura #1021](https://github.com/dortania/OpenCore-Legacy-Patcher/issues/1021) + + ## No T1 functionality after installing Sonoma or newer If you notice your Touchbar etc not working, this means loss of T1 functionality.