Skip to content
/ hub-ctrl Public
forked from codazoda/hub-ctrl.c

Control USB power on a port by port basis on some USB hubs.

Notifications You must be signed in to change notification settings

yy502/hub-ctrl

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 

Repository files navigation

Credit

Originally created by NIIBE Yutaka and published to Github by Joel Dare on 31 Jan 2013.

I forked the code and stated editing as of 8 Sep 2016

Dependency

For Ubuntu:

sudo apt-get install libusb-dev

Plus the GCC tool chain.

Compiling

To compile the hub-ctrl.c program run the following compile command.

gcc -o hub-ctrl hub-ctrl.c -lusb -std=c99

That results in an executable binary called hub-ctrl.

Usage

List hubs and ports (colour-coded in actual use):

$ sudo ./hub-ctrl
Hub 0 (Bus 1, Dev 4) - ganged power switching
 ├─ Port  1:  power
 ├─ Port  2:  power
 ├─ Port  3:  power connect enable
 ├─ Port  4:  power
 ├─ Port  5:  power highspeed connect enable
 ├─ Port  6:  power
 └─ Port  7:  power
Hub 1 (Bus 1, Dev 2) - individual power switching
 ├─ Port  1:  power highspeed connect enable
 ├─ Port  2: 
 ├─ Port  3:  power highspeed connect enable
 ├─ Port  4:  power
 └─ Port  5:  power
Hub 2 (Bus 1, Dev 1) - ganged power switching
 └─ Port  1:  power highspeed connect enable

Note [Hub number] or [Bus number plus Device number] and Port number of your target port/device. To control its power:

# use hub and port number to locate device/port
#   -p 0 = off; 1 = on
$ sudo ./hub-ctrl -H 0 -P 3 -p 0

or

# use bus, device and port number to locate device/port
$ sudo ./hub-ctrl -B 1 -D 4 -P 3 -p 0

A useful command to get more information of USB devices including hierarchy of chained USB hubs is:

$ lsusb -t
/:  Bus 01.Port 1: Dev 1, Class=root_hub, Driver=dwc_otg/1p, 480M
    |__ Port 1: Dev 2, If 0, Class=Hub, Driver=hub/5p, 480M
        |__ Port 1: Dev 3, If 0, Class=Vendor Specific Class, Driver=smsc95xx, 480M
        |__ Port 3: Dev 4, If 0, Class=Hub, Driver=hub/7p, 480M
            |__ Port 3: Dev 25, If 0, Class=Human Interface Device, Driver=usbhid, 12M
            |__ Port 3: Dev 25, If 1, Class=Human Interface Device, Driver=usbhid, 12M
            |__ Port 5: Dev 6, If 0, Class=Mass Storage, Driver=usb-storage, 480M

Known Issues

  • No validation of command-line arguments
  • Some USB ports turn back on automatically after being turned off.

TODO

  • Add device description/type in port status lines. This is particularly useful in identifying chained hubs so you don't accidentally turn off an entire hub by powering off the port that it connects to. See above output of lsusb -t for an example - turning off bus 1 port 3 dev 4 will kill the 7-port hub. This relationship isn't clear in the output of sudo ./hub-ctrl.
  • Convert to python script as I'm more comfortable with it.

About

Control USB power on a port by port basis on some USB hubs.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 100.0%