Enfichage à chaud des périphériques USB avec la commande cfgadm

Les tâches suivantes sont décrites dans cette section :

• Affichage des informations du bus USB (cfgadm)

• Annulation de la configuration d'un périphérique USB

• Configuration d'un périphérique USB

• Déconnexion logique d'un périphérique USB

• Connexion logique d'un périphérique USB

• Déconnexion logique d'une sous-arborescence de périphériques USB

• Réinitialisation d'un périphérique USB

• Modification de la configuration par défaut d'un périphérique USB multiconfiguration

Vous pouvez ajouter et supprimer un périphérique USB d'un système en cours d'exécution sans utiliser la commande cfgadm. Cependant, un périphérique USB peut également être logiquement enfiché à chaud sans être retiré physiquement. Ce scénario est pratique lorsque vous travaillez à distance et que vous avez besoin de désactiver ou de réinitialiser un périphérique USB non opérationnel. La commande cfgadm permet également d'afficher l'arborescence des périphériques USB, y compris les informations sur les fabricants et les produits.

La commande cfgadm affiche des informations sur les points d'attache, qui sont des emplacements du système où peuvent se produire les opérations de reconfiguration dynamique.

Un point d'attache se compose des éléments suivants :

• Un occupant, qui représente une ressource matérielle, tel qu'un périphérique USB, qui peut être configurée dans le système.

• Un réceptacle, qui est l'emplacement qui accepte l'occupant, tel qu'un port USB.

Les points d'attache sont représentés à l'aide d'ID de point d'attache logiques et physiques (Ap_Id). L'Ap_Id physique est le nom du chemin d'accès physique du point d'attache. L'Ap_Id logique est une alternative conviviale à l'Ap_Id physique. Pour plus d'informations sur les Ap_Id, reportez-vous à cfgadm_usb(1M).

La commande cfgadm fournit les informations d'état du périphérique USB ci-dessous.

Les sections suivantes décrivent l'enfichage logiciel à chaud d'un périphérique USB à l'aide de la commande cfgadm. Tous les exemples d'informations sur des périphériques USB fournis dans ces sections ont été tronqués de manière à ne contenir que les informations pertinentes.

Affichage des informations du bus USB (cfgadm)

Pour des exemples d'utilisation de la commande prtconf pour afficher les informations de configuration, reportez-vous à Affichage des informations sur les périphériques USB.

1. Affichez les informations sur le bus USB.

   Par exemple :

   $ cfgadm
   Ap_Id                    Type         Receptacle   Occupant     Condition
   usb0/4.5                 usb-hub      connected    configured   ok
   usb0/4.5.1               usb-device   connected    configured   ok
   usb0/4.5.2               usb-printer  connected    configured   ok
   usb0/4.5.3               usb-mouse    connected    configured   ok
   usb0/4.5.4               usb-device   connected    configured   ok
   usb0/4.5.5               usb-storage  connected    configured   ok
   usb0/4.5.6               usb-communi  connected    configured   ok
   usb0/4.5.7               unknown      empty        unconfigured ok

   Dans l'exemple ci-dessus, usb0/4.5.1 identifie un périphérique connecté au port 1 du hub externe de deuxième niveau, qui est connecté au port 5 du hub externe de premier niveau, lequel est connecté au port 4 du hub root du premier contrôleur USB.

2. Affichez les informations sur les périphériques USB.

   Par exemple :

   $ cfgadm -l -s "cols=ap_id:info"
   Ap_Id       Information
    usb0/4.5.1  Mfg: Inside Out Networks Product: Edgeport/421 NConfigs: 1 
   Config: 0  : ...
    usb0/4.5.2  Mfg: <undef> Product: <undef>   NConfigs: 1 Config: 0 ...
    usb0/4.5.3  Mfg: Mitsumi Product: Apple USB Mouse NConfigs: 1
   Config: 0 ...
    usb0/4.5.4  Mfg: NMB  Product: NMB USB KB/PS2 M NConfigs: 1 Config: 0
    usb0/4.5.5  Mfg: Hagiwara Sys-Com  Product: SmartMedia R/W  NConfigs: 1 
   Config: 0 : ...
    usb0/4.5.6  Mfg: 3Com Inc.  Product: U.S.Robotics 56000 Voice USB Modem 
   NConfigs: 2 ...
    usb0/4.5.7

Annulation de la configuration d'un périphérique USB

Vous pouvez annuler la configuration d'un périphérique USB qui est toujours physiquement connecté au système. Cependant, un pilote ne s'attachera jamais au périphérique. Notez qu'un périphérique USB figure toujours dans les résultats de la commande prtconf, même après que la configuration du périphérique a été annulée.

1. Connectez-vous en tant qu'administrateur.
2. Annulez la configuration du périphérique USB.

   Par exemple :

   # cfgadm -c unconfigure usb0/4.7
   Unconfigure the device: /devices/pci@8,700000/usb@5,3/hub@4:4.7
   This operation will suspend activity on the USB device
   Continue (yes/no)? y

3. Assurez-vous que la configuration du périphérique a été annulée.

   Par exemple :

   # cfgadm  
   Ap_Id                    Type         Receptacle   Occupant     Condition
   usb0/4.5                 usb-hub      connected    configured   ok
   usb0/4.5.1               usb-device   connected    configured   ok
   usb0/4.5.2               usb-printer  connected    configured   ok
   usb0/4.5.3               usb-mouse    connected    configured   ok
   usb0/4.5.4               usb-device   connected    configured   ok
   usb0/4.5.5               usb-storage  connected    configured   ok
   usb0/4.5.6               usb-communi  connected    configured   ok
   usb0/4.5.7               unknown      empty        unconfigured ok
   usb0/4.6                 usb-storage  connected    configured   ok
   usb0/4.7                 usb-storage  connected    unconfigured ok

Configuration d'un périphérique USB

1. Connectez-vous en tant qu'administrateur.
2. Configurez un périphérique USB.

   Par exemple :

   # cfgadm -c configure usb0/4.7 

3. Vérifiez que le périphérique USB est configuré.

   Par exemple :

   # cfgadm usb0/4.7
   Ap_Id                  Type         Receptacle  Occupant    Condition
   usb0/4.7               usb-storage  connected   configured  ok

Déconnexion logique d'un périphérique USB

Si vous souhaitez supprimer un périphérique USB du système et du résultat de la commande prtconf, mais que vous ne vous trouvez pas physiquement près du système, déconnectez-le logiquement. Le périphérique est toujours physiquement connecté. Cependant, le périphérique est logiquement déconnecté, inutilisable et invisible pour le système.

1. Connectez-vous en tant qu'administrateur.
2. Déconnectez un périphérique USB.

   Par exemple :

   # cfgadm -c disconnect -y usb0/4.7

3. Vérifiez que le périphérique est déconnecté.

   Par exemple :

   # cfgadm usb0/4.7
   Ap_Id                  Type      Receptacle    Occupant      Condition
   usb0/4.7               unknown   disconnected  unconfigured  ok

Connexion logique d'un périphérique USB

Cette procédure permet de connecter logiquement un périphérique USB qui a été précédemment déconnecté logiquement ou dont la configuration a été annulée.

1. Connectez-vous en tant qu'administrateur.
2. Connectez un périphérique USB.

   Par exemple :

   # cfgadm -c configure usb0/4.7

3. Vérifiez que le périphérique est connecté.

   Par exemple :

   # cfgadm usb0/4.7
   Ap_Id                  Type         Receptacle  Occupant    Condition
   usb0/4.7               usb-storage  connected   configured  ok

   Le périphérique est désormais disponible et visible pour le système.

Déconnexion logique d'une sous-arborescence de périphériques USB

Cette procédure permet de déconnecter une sous-arborescence de périphériques USB, c'est-à-dire la hiérarchie (ou l'arborescence) de périphériques connectés à un hub.

1. Connectez-vous en tant qu'administrateur.
2. Supprimez une arborescence de périphériques USB.

   Par exemple :

   # cfgadm -c disconnect -y usb0/4

3. Vérifiez que la sous-arborescence de périphériques USB est déconnectée.

   Par exemple :

   # cfgadm usb0/4
   Ap_Id                  Type       Receptacle   Occupant     Condition
   usb0/4                 unknown    disconnected unconfigured ok

Réinitialisation d'un périphérique USB

Si un périphérique USB se comporte de manière imprévisible, exécutez la commande cfgadm pour le réinitialiser, ce qui a pour effet de supprimer et de recréer logiquement le périphérique.

1. Connectez-vous en tant qu'administrateur.
2. Assurez-vous que le périphérique n'est pas en cours d'utilisation.
3. Réinitialisez le périphérique.

   Par exemple :

   # cfgadm -x usb_reset -y usb0/4.7

4. Vérifiez que le périphérique est connecté.

   Par exemple :

   # cfgadm usb0/4.7
   Ap_Id                  Type         Receptacle   Occupant     Condition
   usb0/4.7               usb-storage  connected    configured   ok

Modification de la configuration par défaut d'un périphérique USB multiconfiguration

Gardez à l'esprit les points suivants lorsque vous travaillez avec des périphériques USB multiconfiguration :

• La configuration d'un périphérique USB définit la façon dont un périphérique se présente au système d'exploitation. Cette méthode est différente de la configuration d'un périphérique système décrite dans d'autres sections sur la commande cfgadm.

• Certains périphériques USB prennent en charge plusieurs configurations, mais une seule configuration peut être active à la fois.

• Les périphériques multiconfiguration peuvent être identifiés en examinant le résultat de la commande cfgadm -lv. Nconfigs sera supérieur à 1.

• La configuration USB par défaut est la configuration 1. La configuration actuelle est identifiée dans la résultat de la commande cfgadm -lv en tant que Config.

• Les modifications apportées à la configuration par défaut sont conservées après les réinitialisations, les suppressions à chaud et la reconfiguration du périphérique, à condition que le périphérique soit reconnecté au même port.

1. Assurez-vous que le périphérique n'est pas en cours d'utilisation.
2. Modifiez la configuration USB par défaut.

   Par exemple :

   # cfgadm -x usb_config -o config=2 usb0/4
      Setting the device: /devices/pci@1f,0/usb@c,3:4
      to USB configuration 2
      This operation will suspend activity on the USB device
      Continue (yes/no)? yes

3. Vérifiez que le périphérique a changé.

   Par exemple :

   # cfgadm -lv usb0/4
   Ap_Id  Receptacle   Occupant     Condition  Information When  Type    
        Busy     Phys_Id
   usb0/4 connected    unconfigured ok         Mfg: Sun  2000   
   Product: USB-B0B0 aka Robotech
   With 6 EPPS High Clk Mode   NConfigs: 7  Config: 2  : EVAL Board Setup  
   unavailable
   usb-device   n        /devices/pci@1f,0/usb@c,3:4

   Notez que Config: indique maintenant 2.