📌 Affectation et activation des ports USB, Méthode d'identification des ports via USBInjectAll.kext

[legallou]

Affectation et activation des ports USB

Note de l'auteur :

Polyzargone m'a demandé de recopier, ici, dans la section tutoriel l'un des dossiers que j'ai écrits sur mon site legallou.com, où vous trouverez une installation complète pour un NUC6i3 et une carte mère GA-Z170X-Gaming 5, ainsi que tous les outils nécessaires.

Le tutoriel est le même que sur mon site, seul, la présentation est différente. Sur mon site ayant toute la puissance de Coda du HTLM et des CSS la mise en page est plus agréable.

Introduction

■ Au premier démarrage d'un Hackintosh la plupart du temps seuls les connecteurs USB2 fonctionnent.
■ MacOS supporte au maximum 15 ports USB.

Mais, attention, tous les connecteurs USB3 physiques sont aussi USB2, donc cela fait deux ports logiques.

Par exemple sur ma carte mère GA-Z170X-Gaming 5 il y a quatre USB3 (4,5,8,9) et quatre USB2 (1,2,6,7). Cela fait déjà 12 ports.





En supplément sur mon boîtier, j'ai en face avant deux connecteurs USB3 et deux connecteurs USB2. Cela fait six ports.

Donc, au total (12 + 6) 18 ports. Il faudra dans cette configuration ne pas activer tous les ports, MacOS supportant au maximum que 15 ports USB.

Étapes

Il y a deux grandes étapes :

■ Une étape d'analyse des ports pour connaître leurs noms et adresses ;
■ Suivis de l'étape de création de l'injecteur en se limitant à 15 ports.

En détail

■ Il faut lever la limite de 15 ports USB d'Apple ;
■ Utiliser « USBInjectAll.kext » de RehabMan ;
■ Analyser les ports avec IOJones ;
■ Modifier l'info.plist de mon injecteur avec PlistEdit Pro.

Lorsque ceci sera fini, il faudra enlever « USBInjectAll.kext » et remettre la limite à 15 ports avant de charger votre injecteur personnel.

Gardez bien cela en tête, il ne peut y avoir qu'un seul injecteur *.

* : Pour les possesseurs de cartes-mère Kabylake (série 200), lisez attentivement les explications d'Egon-058 dans le post #32. Il y a quelques étapes supplémentaires à faire pour activer vos ports comme l'utilisation d'un injecteur supplémentaire.

Idem pour les séries 300 et pour les séries x99, il faudra utiliser l'injecteur adéquat (fournis en PJ en fin de tuto).

■ Pour cela il vous faut les logiciels suivants :

• IOJones pour l'analyse des ports.
• PlistEdit Pro pour leur modification.
• Clover Configurator pour modifier une config.plist.

Procédures

◉ 1 - Levez la limite des 15 ports

Cette limitation existe que depuis El Capitan. Pour cela, il faut modifier la config.plist sur votre HackIntosh.

■ Lancez sur votre Hackintosh l'application « Clover Configurator » version 4.40 ou supérieure, celle avec le nouveau menu de "Mount EFI".

■ Cliquez sur « Tools > Mount EFI »




■ Puis cliquez sur « Mount Partition » nouveau menu.





■ Ensuite, cliquez sur la petite maison.

La config.plist de votre SSD va apparaître dans la liste, sélectionnez-la. (Flèche rouge).





■ Allez dans « kernel and Kext Patches » fenêtre « KextsToPatch ».
■ Cliquez sur le signe « + » (en bas à gauche de l'image). Une nouvelle ligne va apparaître.






■ Installez le patch Clover suivant pour El Capitan :

• Name : com.apple.driver.usb.AppleUSBXHCI
• Find : 83BD8CFEFFFF10
• Replace : 83BD8CFEFFFF16
• Comment : par exemple « El Capitan USB limite ports de 15 à 30 »
• MachOS : 10.11.x

■ Pour Sierra les valeurs sont différentes, et uniquement 20 ports.

• Name : com.apple.driver.usb.AppleUSBXHCI
• Find : 83BD74FFFFFF10
• Replace : 83BD74FFFFFF16
• Comment : Sierra USB limite ports de 15 à 20
• MachOS : 10.12.x

■ Pour High Sierra les valeurs sont également différentes.

• Name : com.apple.driver.usb.AppleUSBXHCI
• Find : 837D8C10
• Replace : 837D8C19
• Comment : High Sierra USB limite ports de 15 à 24 (10.13 PB1)
• MachOS : 10.13.x

■ Depuis la version 10.13.4 les valeurs ont changé.

• Name : com.apple.driver.usb.AppleUSBXHCI
• Find : 837D880F 0F83A704 0000
• Replace : 837D880F 90909090 9090
• Comment: USB 10.13.6+ by PMHeart
• MatchOS: 10.13.x

■ Pour Mojave les valeurs sont les suivantes :

• Name : com.apple.driver.usb.AppleUSBXHCI
• Find : 83FB0F0F 838F0400 00
• Replace : 83FB0F90 90909090 90
• Comment : disable port limit in XHCI kext (credit DalianSky,Ricky)
• MachOS : 10.14.x

■ Pour Catalina les valeurs sont les suivantes (il y a 2 patches) :

• Name : com.apple.iokit.IOUSBHostFamily
• Find : 83FB0F0F
• Replace : 83FB3F0F
• Comment : #1 USB Port Limit 10.15.x
• MatchOS : 10.15.x

• Name : com.apple.driver.usb.AppleUSBXHCI
• Find : 83F90F0F
• Replace : 83F93F0F
• Comment : #2 USB Port Limit 10.15.x
• MatchOS : 10.15.x

■ Ne cochez pas l'option « Disable.. »

■ Sauvegardez cette nouvelle config.plist par FILE>Save..., dans le dossier /EFI/CLOVER.

◉ 2 - Utilisez USBInjectAll.kext* de RehabMan

■ Télécharger USBInjectAll.kext

■ Placez-le comme d'habitude dans /EFI/CLOVER/Kexts/Other.

* Pour les utilisateurs de séries 200 ou 300, utilisez l'injecteur adéquat (v. les PJ plus bas).

Voilà, la préparation est terminée. Relancer votre Hackintosh.

◉ 3 - Analysez les ports avec IOJones

Téléchargez IOJones si ce n'est pas déjà fait.

Nous allons analyser tous les connecteurs USB un par un.

• En introduisant une clé USB2 pour les connecteurs USB2.
• En introduisant une clé USB2 pour les connecteurs USB3.
• Puis en introduisant une clé USB3 pour les connecteurs USB3.

Vous allez faire une liste très précise que tous les ports avec leur nom HSxx pour les ports USB2, SSxx pour les ports USB3, et leur adresse du type « 03 00 00 00 ».

Lancez IOJones sur le Hackintosh et introduisez dans le premier connecteur USB3 à analyser une clé USB2.
Balayez la fenêtre de gauche de IOJones jusqu'à voir des informations de la couleur verte. (C'est environs au deux tiers vers le bas de la fenêtre).
Dans l'exemple ci-dessous, j'ai mis une clé USB2, le nom du port est HS03 et son code est « 03 00 00 00 ».





Enlevez votre clé USB2, les informations vont passer au rouge.

Maintenant, introduisez une clé USB3 dans ce même port USB3. Recherchez les informations de la couleur verte. Dans mon exemple le nom du port est SS03 et son code est « 13 00 00 00 ».




Voilà vous avez obtenu les deux noms et les deux adresses des ports USB2 et USB3 du connecteur USB3. (HS03 port « 03 00 00 00 », SS03 port « 13 00 00 00 »).

Vous faites cela pour tous les ports USB2 et USB3 qui vous manquent, en notant bien les valeurs du nom SSxx HSxx et la valeur « xx 00 00 00 ». SS pour les ports USB3, HS pour les ports USB2.

Exemple pour la carte mère GA-Z170X-Gaming 5

• Port 1 USB 2 : HS13 0d 00 00 00
• Port 2 USB 2 : HS14 0e 00 00 00
• Port 3 USB-C : ignoré
• Port 4 haut :
  

  • USB 2 : HS09 09 00 00 00 en rouge / ignoré
  • USB 3 : SS09 19 00 00 00

  
  
• Port 5 UBSB 3.1 : ignoré
• Port 6 haut :USB 2 : HS10 0a 00 00 00 supprimé pour rester à 15
• Port 7 bas : USB 2 : HS07 07 00 00 00 supprimé pour rester à 15
• Port 8 haut USB3 :
  

  • USB 2 : HS06 06 00 00 00
  • USB 3 : SS06 16 00 00 00

  
  
  
• Port 9 bas USB3 :
  

  • USB 2 : HS05 05 00 00 00
  • USB 3 : SS05 15 00 00 00

  
  
• Carte mère interne :
  

  • Port USB 2 Bluetooth : HS11 0b 00 00 00

Pas de HS12, SS01, SS02

Les ports USB-C et USB3.1 ne seront vus - au mieux - que comme des ports USB 3.0 et ils ne fonctionneront qu'à 5 Gb/s au lieu des 10 Gb/s qu'ils sont censés supporter. De plus, pour l'instant, mars 2017, l'USB 3.1 ne fonctionne pas correctement sur les Hackintosh. Je les ai sacrifiés au profit des vrais ports USB 3.0.



Merci à Barijaona qui a fait ces beaux schémas

◉ 4 - Création de l'injecteur

Téléchargez PlistEdit Pro, si ce n'est pas déjà fait.


Téléchargez mon fichier GA_Z170X_G5_Injector-alg.kext.zip qui va vous servir de base pour créer le vôtre. Vous allez le corriger avec les valeurs de vos ports.

Clic droit dessus et demander à voir le contenu du package.





Dans le dossier « Contents », il y a un seul fichier de nom « info.plist ». Ouvrez-le avec l'application PlistEdit Pro.



Mon injecteur est pour une carte mère Skylake. J'ai utilisé le code Mac « iMac17,1 ».

Il faut absolument que le champ "model" corresponde au SMBios utilisé pour votre configuration. Sinon, l’injecteur ne fonctionnera pas et sera purement et simplement ignoré.

Idem pour le champ « iMac17,1-XHC » qui lui aussi doit correspondre au SMBios utilisé.




Descendez la cascade des sous-dossiers et vous voyez mon port HS03 et son code « 03 00 00 00 ».




Vous faites les modifications que vous désirez en changeant la valeur « data ». Si le port n'existe pas, vous le créer par duplication d'un port existant.
En tenant compte de n'avoir que 15 ports, la limite d'Apple.
Et vous sauvegardez.

Note : Normalement l'UsbConnector Number est à :

• 0 pour l'USB 2 (si le port est à la fois USB 2 et USB 3, utilisez 3)

• 3 pour l'USB 3

• 10 pour l'USB-C (HSXX et SSXX)

• 255 pour les ports internes

Enfin, assurez-vous que le port-count soit égal à la valeur d'adresse la plus élevée de vos ports. Ici, il sera donc de 19 00 00 00 (la valeur utilisée par le SS09).

◉ 5 - Étape finale

Enlevez « USBInjectAll.kext » dans /EFI/CLOVER/Kexts/Other

Mettez à sa place votre injecteur dans /EFI/CLOVER/Kexts/Other

Gardez bien cela en tête, il ne peut y avoir qu'un seul injecteur.

Repassez le nombre de ports à 15 avec application « Clover Configurator ». Il suffit de décocher l'option, sans oublier de sauvegarder la config.plist.

Redémarrez votre HackIntosh et vérifiez le fonctionnement de tout vos connecteurs USB.

Injecteurs spéciaux pour les séries x99, 200 et 300 :

 XHCI_x99_injector.kext.zip ( 2.54 Ko ) Nombre de téléchargements : 44

 XHCI_200_series_injector.kext.zip ( 2.65 Ko ) Nombre de téléchargements : 49

 XHCI_300_series_injector.kext.zip ( 2.64 Ko ) Nombre de téléchargements : 135

Ce message a été modifié par polyzargone - 31 Mar 2020, 17:45.

Raison de l'édition : Ajout patches Catalina

[blackhole]

Merci Alain pour ce tuto fort détaillé!!!

Mais pourrais-tu, STP, apporter quelques "éclaircissements" sur certains points? Afin de permettre aux "Noobs" (et sur certains points à Moi également... ) de mieux comprendre dans quoi ils se "lancent".

"C'est que j'aime les "questions c*nnes" et les "détails"...!!!"

Notamment;

[*]MacOS supporte au maximum 15 ports USB.

- Est-ce "tous" les OS (de SL à Sierra) ou seulement depuis Cap?

Nous allons analyser tous les connecteurs USB un par un.
[indent][list]
[*] En introduisant une clé USB2 pour les connecteurs USB2.
[*]En introduisant une clé USB2 pour les connecteurs USB3.
[*]Puis en introduisant une clé USB3 pour les connecteurs USB3.

Vous allez faire une liste très précise que tous les ports avec leur nom HSxx pour les ports USB2, SSxx pour les ports USB3, et leur adresse du type « 03 00 00 00 ».

Désolé tu risque de me rire au nez, mais c'est pour être sûr.

- Comment fait-on si l'on n'a pas de clé USB3.0 pour la détection des "noms" de ces derniers?
- Est-ce que pour les "numéros" des ports USB3.0, le "numéro" du ports USB2.0 est "toujours" le même?
- Est-ce que (bien-sûr si tu le sais) le "principe" (mon exemple ci-dessous) est le même pour "toutes" les marques de CM (ASUS, MSI GB, ASROCK), ou est-ce qu'il y'a des "variantes"?

Je m'explique, exemples (c'est "au pif"), si l'on a "détecté" l'"ID" d'un port USB2.0 (à l'aide de seulement une clé USB2.0 bien entendu) sur un port USB3.0 en:
- HS01 - 01 00 00 00, est-ce que l'"ID" du même port mais pour l'USB3.0 sera toujours SS01 - 11 00 00 00
- HS03 - 03 00 00 00, est-ce que l'"ID" du même port mais pour l'USB3.0 sera toujours SS03 - 13 00 00 00
- HS06 - 06 00 00 00, est-ce que l'"ID" du même port mais pour l'USB3.0 sera toujours SS06 - 16 00 00 00
- Etc...

En bref, je sais pas si j'ai été clair dans ma questions...

[*]Port 3 USB-C : ignoré

[*]Port 5 UBSB 3.1 : ignoré

Pour ces 2 ports là, car n'ayant pas de périphériques pour les tester, c'est parce qu'il son "non-comptabilisés dans la gestion "classic" (diront-nous) des ports USB2.0 et 3.0 par MacOS", "Natifs", "Non-fonctionnels du faite de les avoir ignorés", "simplement non-fonctionnels sous MacOS"...???

J'espère que je ne t'ai pas trop "embrouillé" avec mes questions?

Et encore MERCI pour ton travail et ta participation à la communauté grâce à ton tuto!!!

Ce message a été modifié par blackhole - 15 Mar 2017, 17:25.

[polyzargone]

Je me permet de répondre :

[*]MacOS supporte au maximum 15 ports USB.

- Est-ce "tous" les OS (de SL à Sierra) ou seulement depuis Cap?

Non, cela ne concerne que El Capitan et Sierra et probablement tous les macOS suivants. Pour les autres, la limitation des ports n'existe tout simplement pas.

- Comment fait-on si l'on n'a pas de clé USB3.0 pour la détection des "noms" de ces derniers?

Là, c'est plutôt gênant et à part essayer de les deviner, il n'y a pas grand chose à faire.

- Est-ce que pour les "numéros" des ports USB3.0, le "numéro" du ports USB2.0 est "toujours" le même?

En principe oui. En tous cas, je n'ai jamais vu de port qui ne correspondait pas à son équivalent USB3. Donc ça devrait faciliter la "devinette" en ce qui concerne les adresses puisqu'il y a de très fortes chances qu'un port HS06 corresponde à un port SS06 par exemple et que l'adresse 06 00 00 00 en HS devienne 16 00 00 00 en SS.

- Est-ce que (bien-sûr si tu le sais) le "principe" (mon exemple ci-dessous) est le même pour "toutes" les marques de CM (ASUS, MSI GB, ASROCK), ou est-ce qu'il y'a des "variantes"?

Oui du moment que le ou les contrôleur(s) USB sont des Intel. Pour les autres chipsets (ASMedia, Renesas, VIA, etc.), ça ne fonctionnera pas. Ce qui ne veut pas nécessairement dire qu'ils ne seront pas reconnus du tout par macOS .

Pour ces cas là, il vaut mieux passer par GenericUSBXHCI.kext. Mais c'est sans garantie…

Je m'explique, exemples (c'est "au pif"), si l'on a "détecté" l'"ID" d'un port USB2.0 (à l'aide de seulement une clé USB2.0 bien entendu) sur un port USB3.0 en:
- HS01 - 01 00 00 00, est-ce que l'"ID" du même port mais pour l'USB3.0 sera toujours SS01 - 11 00 00 00
- HS03 - 03 00 00 00, est-ce que l'"ID" du même port mais pour l'USB3.0 sera toujours SS03 - 13 00 00 00
- HS06 - 06 00 00 00, est-ce que l'"ID" du même port mais pour l'USB3.0 sera toujours SS06 - 16 00 00 00
- Etc...

Voilà, c'est ça . En tous cas, c'est généralement le cas.

[*]Port 3 USB-C : ignoré

[*]Port 5 UBSB 3.1 : ignoré

Pour ces 2 ports là, car n'ayant pas de périphériques pour les tester, c'est parce qu'il son "non-comptabilisés dans la gestion "classic" (diront-nous) des ports USB2.0 et 3.0 par MacOS", "Natifs", "Non-fonctionnels du faite de les avoir ignorés", "simplement non-fonctionnels sous MacOS"...???

C'est principalement parce qu'ils ne seront vus - au mieux - que comme des ports USB 3.0 et qu'ils ne fonctionneront qu'à 5 Gb/s au lieu des 10 Gb/s qu'ils sont sensés supporter. Du coup, il vaut mieux les sacrifier au profit des vrais ports USB 3.0.

Pour l'instant et à ma connaissance, l'USB 3.1 ne fonctionne pas correctement sur les Hackintosh. Ça évoluera peut-être… .