uhubctl – スマートUSBハブのポートごとのUSB電源制御
Uhubctl – control USB power per-port on smart USB hubs (github.com)
要約
uhubctlは、スマートUSBハブのポートごとのUSB電源を制御するためのユーティリティです。スマートハブとは、ポートごとに電源スイッチング機能を実装しているものを指します。このツールは、特定のUSBハブの電源を個別にオン/オフすることで、接続されたデバイスの管理や省電力化を可能にします。互換性のあるUSBハブのリストも提供されており、ユーザーは自分の環境で利用できるかを確認できます。
全文翻訳
uhubctl
uhubctl は、スマートUSBハブのポートごとにUSB電源を制御するためのユーティリティです。スマートハブとは、ポートごとの電源スイッチ機能を実装しているものを指します。
このコードの元々のアイデアは、Niibe Yutaka氏による hub-ctrl.c から着想を得ています: https://www.gniibe.org/development/ac-power-control-by-USB-hub
互換性のあるUSBハブ
注意点として、ポートごとの電源スイッチ機能を正しくサポートしているUSBハブは多くありません。製造中止になったものもあり、入手が困難な場合があります。
以下は、既知の互換性のあるUSBハブのリストです:
| メーカー | 製品 | ポート数 | USB | VID:PID | リリース | EOL |
|---|---|---|---|---|---|---|
| Acer | BE270U monitor (参照) | 4 | 3.0 | 2109:2811 | 2016 | |
| AmazonBasics | HU3641V1 (RPi issue) | 4 | 3.0 | 2109:2811 | 2013 | |
| AmazonBasics | HU3770V1 (RPi issue) | 7 | 3.0 | 2109:2811 | 2013 | |
| AmazonBasics | HU9003V1EBL, HUC9003V1EBL | 7 | 3.1 | 2109:2817 | 2018 | |
| AmazonBasics | HU9002V1SBL, HU9002V1EBL, HU9002V1ESL, HHU9002V1EZPR01 (注記) | 10 | 3.1 | 2109:2817 | 2018 | |
| AmazonBasics | HUC9002V1SBL, HUC9002V1EBL, HUC9002V1ESL | 10 | 3.1 | 2109:2817 | 2018 | |
| AmazonBasics | U3-7HUB (充電ポート1つのみ動作) | 7 | 3.0 | 2109:2813 | 2020 | |
| Anker | AK-68ANHUB-BV7A-0004 (注記) | 7 | 3.0 | 2109:0812 | 2014 | |
| Apple | Mac Mini M4 (前面ポート2つのみ) | 2 | 3.2 | 05AC:800B | 2024 | |
| Apple | MacBook Air (Late 2010) | 2 | 2.0 | 1D6B:0002 | 2010 | 2020 |
| Apple | Pro Display XDR MWPE2LL/A (内部USBハブ) | 4 | 2.0 | 05AC:9139 | 2019 | |
| Apple | Thunderbolt Display 27" (内部USBハブ) | 6 | 2.0 | 2011 | 2016 | |
| Apple | USB Keyboard With Numeric Pad (内部USBハブ) | 3 | 2.0 | 2011 | ||
| Asus | Z77 Sabertooth Motherboard (オンボードUSBハブ) | 6 | 2.0 | 2012 | ||
| Asus | Z87-PLUS Motherboard (オンボードUSBハブ) | 4 | 3.0 | 2013 | 2016 | |
| Aukey | CB-C59 | 4 | 3.0 | 2109:2813 | 2017 | |
| B+B SmartWorx | UHR204 | 4 | 2.0 | 0856:DB00 | 2013 | |
| B+B SmartWorx | USH304 | 4 | 3.0 | 04B4:6506 | 2017 | 2019 |
| Basler | 2000036234 | 4 | 3.0 | 0451:8046 | 2016 | |
| Belkin | F5U101 | 4 | 2.0 | 0451:2046 | 2005 | 2010 |
| Belkin | F5U238UKCRL-MOB | 4 | 2.0 | 0409:0059 | 2004 | 2010 |
| BenQ | PD2700U 4K Monitor (USB2モードのみ動作) | 4 | 3.0 | 05E3:0610 | 2018 | |
| BenQ | PD3220U | 4 | 3.1 | 05E3:0610 | 2019 | |
| Bytecc | BT-UH340 (警告) | 4 | 3.0 | 2109:8110 | 2010 | |
| Centech | CT-USB4HUB ReTRY HUB (注記) | 4 | 3.0 | 0424:2744 | 2017 | |
| Circuitco | Beagleboard-xM (内部USBハブ) | 4 | 2.0 | 0424:9514 | 2010 | |
| Club3D | CSV-3242HD Dual Display Docking Station | 4 | 3.0 | 2109:2811 | 2015 | |
| Coolgear | USBG-12U2ML | 12 | 2.0 | 05E3:0607 | 2015 | |
| Cypress | CY4608 HX2VL (注記) | 4 | 2.0 | 04B4:6570 | 2012 | |
| D-Link | DUB-2332 rev A1 | 3 | 3.0 | 2022 | ||
| D-Link | DUB-H4 rev D,E (黒)。注: rev A,C,Fは非対応 | 4 | 2.0 | 05E3:0608 | 2012 | |
| D-Link | DUB-H7 rev A (銀) | 7 | 2.0 | 2001:F103 | 2005 | 2010 |
| D-Link | DUB-H7 rev D,E (黒)。Rev B,C,F,Gは非対応 | 7 | 2.0 | 05E3:0608 | 2012 | |
| Dell | DA300 USB-C Mobile Adapter | 2 | 3.0 | 2109:2820 | 2018 | |
| Dell | P2416D 24" QHD Monitor (注記) | 4 | 2.0 | 2017 | ||
| Dell | S2719DGF 27" WQHD Gaming-Monitor | 5 | 3.0 | 0424:5734 | 2018 | |
| Dell | UltraSharp 1704FPT 17" LCD Monitor | 4 | 2.0 | 0424:A700 | 2005 | 2015 |
| Dell | UltraSharp U2415 24" LCD Monitor | 5 | 3.0 | 2014 | ||
| Dell | UltraSharp U3419W 34" Curved Monitor | 6 | 3.0 | 2020 | ||
| Dell | Wyse 3040 (‐f必須) | 6 | 3.0 | 2017 | ||
| Delock | 62537 | 4 | 3.0 | 2017 | 2021 | |
| Delock | 87445 (注記) | 4 | 2.0 | 05E3:0608 | 2009 | 2013 |
| Elecom | U2H-G4S | 4 | 2.0 | 2006 | 2011 | |
| Gigabyte | G27Q monitor (参照) | 4 | 3.0 | 2109:0817 | 2020 | |
| GlobalScale | ESPRESSObin SBUD102 V5 | 1 | 3.0 | 1D6B:0003 | 2017 | |
| Hardkernel | ODROID-C4 (注記) | 4 | 3.0 | 2020 | ||
| Hawking Technology | UH214 | 4 | 2.0 | 2003 | 2008 | |
| Hewlett Packard | USB-C Dock G5 5TW10AA | 5 | 3.0 | 03F0:076B | 2019 | |
| Hewlett Packard | P5Q58UT | 3 | 3.0 | 2019 | ||
| IBM | SK-8815 USB Keyboard | 3 | 1.1 | 04B3:301A | 2004 | |
| Inateck | HB2025A (USB2のみ) | 4 | 3.1 | 2109:2822 | 2021 | |
| IOI | U3H415E1 | 4 | 3.0 | 2012 | ||
| j5create | JUH377 (注記) | 7 | 3.0 | 2016 | ||
| j5create | JUH470 (注記) | 3 | 3.0 | 05E3:0610 | 2014 | |
| Juiced Systems | 6HUB-01 | 7 | 3.0 | 0BDA:0411 | 2014 | 2018 |
| KUNBUS GmbH | RevPi Connect (+) / S / SE | 2 | 2.0 | 0424:9514 | 2018 | |
| KUNBUS GmbH | RevPi Connect 4 | 2 | 3.0 | 2022 | ||
| KUNBUS GmbH | RevPi Core 3 / S / SE | 2 | 2.0 | 0424:9514 | 2017 | |
| LG Electronics | 27MD5KL-B monitor | 4 | 3.0 | 043E:9A60 | 2019 | |
| LG Electronics | 27GL850-B monitor | 4 | 3.0 | 0451:8142 | 2019 | |
| LG Electronics | 27UK850-W monitor | 2 | 3.0 | 2018 | ||
| LG Electronics | 27UN83A-W monitor | 2 | 3.0 | 0451:8142 | 2020 | |
| LG Electronics | 38WK95C-W monitor | 4 | 3.0 | 0451:8142 | 2018 | |
| Lenovo | ThinkPad Mini Dock Series 3 (433710U) | 6 | 2.0 | 17EF:100A | 2016 | |
| Lenovo | ThinkPad Ultra Docking Station (40A20090EU) | 6 | 2.0 | 17EF:100F | 2015 | |
| Lenovo | ThinkPad Ultra Docking Station (40AJ0135EU) | 7 | 3.1 | 17EF:3070 | 2018 | |
| Lenovo | ThinkPad USB 3.0 Ultra Dock (40A8) DK-1523 | 6 | 3.0 | 17EF:1014 | 2015 | |
| Lenovo | ThinkPad X200 Ultrabase 42X4963 | 3 | 2.0 | 17EF:1005 | 2008 | 2011 |
| Lenovo | ThinkPad X6 Ultrabase 42W3107 | 4 | 2.0 | 17EF:1000 | 2006 | 2009 |
| Lenovo | ThinkPlus 4-in-1 USB-C hub 4X90W86497 | 3 | 3.0 | 2021 | ||
| Lenovo | ThinkVision T24i-10 Monitor | 4 | 2.0 | 17EF:0610 | 2018 | |
| Lenovo | USB-C to 4 Port USB-A Hub (USB2のみ) | 4 | 2.0 | 17EF:103A | 2020 | |
| Lindy | USB serial converter 4 port | 4 | 1.1 | 058F:9254 | 2008 | |
| Linksys | USB2HUB4 (注記) | 4 | 2.0 | 2004 | 2010 | |
| Maplin | A08CQ (赤色ポートのみ動作) (参照) | 7 | 2.0 | 0409:0059 | 2008 | 2011 |
| Metadot | Das Keyboard 4 | 2 | 3.0 | 2014 | ||
| Microchip | EVB9512 | 2 | 2.0 | 2009 | ||
| Microchip | EVB-USB2517 | 7 | 2.0 | 2008 | ||
| Microchip | EVB-USB2534BC | 4 | 2.0 | 2013 | ||
| Microchip | EVB-USB5807 | 7 | 3.0 | 2016 | ||
| Moxa | Uport-407 | 7 | 2.0 | 110A:0407 | 2009 | |
| NVidia | Jetson Nano B01 (詳細) | 4 | 3.0 | 2019 | ||
| NVidia | Jetson Orin Nano Devkit (詳細) | 4 | 3.0 | 2023 | ||
| NVidia | Jetson Xavier NX (詳細) | 4 | 3.0 | 2020 | ||
| Phidgets | HUB0003_0 | 7 | 2.0 | 1A40:0201 | 2017 | |
| Philips | 346B1C UltraWide 34" Curved Monitor | 4 | 3.0 | 05E3:0610 | 2019 | |
| Plugable | USB3-HUB7BC | 7 | 3.0 | 2109:0813 | 2015 | |
| Plugable | USB3-HUB7C (充電ポート2つのみ動作) | 7 | 3.0 | 2109:0813 | 2015 | |
| Plugable | USBC-HUB7BC (6/7ポート動作、一番右は不可) | 7 | 3.0 | 2109:0817 | 2021 | |
| Plugable | USB3-HUB10-C2 (充電ポート2つのみ動作) | 10 | 3.0 | 2014 | ||
| Port Inc | NWUSB01 | 4 | 1.1 | 0451:1446 | 1999 | 2003 |
| Raspberry Pi | B+, 2B, 3B (下記参照) | 4 | 2.0 | 2011 | ||
| Raspberry Pi | 3B+ (下記参照) | 4 | 2.0 | 0424:2514 | 2018 | |
| Raspberry Pi | 4B (下記参照) | 4 | 3.0 | 2109:3431 | 2019 | |
| Raspberry Pi | 5 (下記参照) | 4 | 3.0 | 1D6B:0002 | 2023 | |
| Renesas | uPD720202 PCIe USB 3.0 host controller | 2 | 3.0 | 2013 | ||
| Rosewill | RHUB-210 | 4 | 2.0 | 0409:005A | 2011 | 2014 |
| Rosonway | RSH-518C (注記) | 7 | 3.0 | 2109:0817 | 2021 | |
| Rosonway | RSH-A10 (参照) | 10 | 3.0 | 0BDA:0411 | 2020 | |
| Rosonway | RSH-A13 (警告) | 13 | 3.1 | 2109:2822 | 2021 | |
| Rosonway | RSH-A16 (注記, 警告) | 16 | 3.0 | 0bda:0411 | 2020 | |
| Rosonway | RSH-A37S | 7 | 3.0 | 2109:2822 | 2021 | |
| Rosonway | RSH-A104 (USB2のみ) | 4 | 3.1 | 2109:2822 | 2022 | |
| Rosonway | RSH-ST07C (4ポートのみ動作) (参照) | 7 | 3.0 | 2109:2822 | 2023 | |
| Rosonway | RSH-ST10C-6 (注記) | 10 | 3.1 | 0BDA:0423 | 2024 | |
| Sanwa Supply | USB-HUB14GPH | 4 | 1.1 | 2001 | 2003 | |
| Satechi | Mac Mini Hub (M1/M2) | 4 | 3.0 | 2109:2817 | 2023 | |
| Seagate | Backup Plus Hub STEL8000100 | 2 | 3.0 | 0BC2:AB44 | 2016 | |
| Seeed Studio | reTerminal CM4104032 | 2 | 2.0 | 0424:2514 | 2021 | |
| StarTech | DKT30CSDHPD3 USB-C Travel Dock | 3 | 3.0 | 2109:2817 | 2018 | |
| StarTech | HB30A4AIB (警告) | 4 | 3.0 | 2109:2817 | 2018 | |
| StarTech | HB31C2A2CB (注記) | 5 | 3.0 | 14B0:013D | 2020 | |
| StarTech | HB31C3A1CPD3 (注記) | 5 | 3.1 | 14B0:013A | 2019 | |
| Sunix | SHB4200MA | 4 | 2.0 | 0409:0058 | 2006 | 2009 |
| System Talks | Sugoi USB2-HUB4X (警告) | 4 | 2.0 | 2007 | ||
| Targus | ACH155 (ポート3が全ポートを制御) | 4 | 3.0 | 2022 | ||
| Targus | PA095UZ | 2 | 2.0 | 2004 | ||
| Targus | PAUH212/PAUH212U | 7 | 2.0 | 2004 | 2009 | |
| Texas Instruments | TUSB4041PAPEVM | 4 | 2.1 | 0451:8142 | 2015 | |
| UUGear | MEGA4 (Raspberry Pi 4B用) | 4 | 3.0 | 2109:0817 | 2021 | |
| VirtualHere | USB3 4-port hub (注記) | 4 | 3.0 | 2024 |
この表は決して完全なものではありません。もしお使いのハブが uhubctl で動作するにも関わらず、上記リストにない場合は、https://github.com/mvp/uhubctl/issues で新しいイシューを開いて報告してください。報告の際には、正確な製品モデルと uhubctl の出力を提供し、FAQの「VBUSオフサポート」セクションに記載されている方法でテストした結果を添えてください。
また、多くの最新マザーボードには、この機能をサポートする内蔵ルートハブが搭載されているため、外部ハブを購入する必要がない場合もあります。
USB 3.0 の二重性に関する注意
USB 3.0 ハブが USB3 アップストリームポートに接続されている場合、USB2 と USB3 の2つの独立した仮想ハブとして検出されます。USBデバイスは、その機能と接続速度に応じて、USB2 または USB3 仮想ハブに接続されます。このようなハブの電源を制御するには、電源のオフ/オン操作が効果を発揮するために、USB2 と USB3 の両方の仮想ハブで電源をオフ/オンする必要があります。uhubctl はこれを自動的に行おうとします(オプション -e でこの動作を無効にしない限り)。
残念ながら、多くのハブはデータUSB接続を切断しますが、一部のハブではVBUS(電源供給)をポートから切断しない場合があります。これにより、接続された電話が uhubctl によって電源オフされたポートから充電を続ける可能性があります。
インストール
Linux および MacOS では、uhubctl は標準のパッケージマネージャーで利用可能で、以下のコマンドでインストールできます:
- MacOS:
brew install uhubctlまたはsudo port install uhubctl- ⚠️ MacOS 26+ では libusb 1.0.30 以降が必要です! (参照)
- Ubuntu/Debian/Raspbian:
sudo apt install uhubctl - Redhat/EPEL/Fedora/CentOS:
sudo yum install uhubctl - OpenSUSE:
sudo zypper install uhubctl - FreeBSD:
cd /usr/ports/sysutils/uhubctl && sudo make install
ただし、標準パッケージマネージャーからインストールされた uhubctl は、最新バージョンではない、あるいは現在のバージョンから大きく遅れている可能性があります。最新リリース の uhubctl バージョンがパッケージマネージャーのものより新しい場合、ソースからコンパイルしてインストールする必要があるかもしれません。その場合は、以下の手順に従ってください。
コンパイル
このユーティリティは、Linux (Ubuntu/Debian/Raspbian, Redhat/EPEL/Fedora/CentOS, Arch Linux, Gentoo, openSUSE, Buildroot), FreeBSD, NetBSD, SunOS, および MacOS でコンパイルおよび動作することがテストされています。
uhubctl は Windows でもコンパイルできますが、USB電源スイッチ機能は Windows では動作しません。これは、libusb が winusb.sys ドライバーを使用しており、Microsoft によると 必要なUSB制御リクエスト をサポートしていないためです。これは、libusb が Windows で別のドライバーをサポートするようになれば修正される可能性があります。
ユーティリティ pkgconf (または pkg-config) がインストールされていることが強く推奨されます(多くの場合デフォルトでインストールされています)。
まず、ライブラリ libusb-1.0 をインストールする必要があります(バージョン 1.0.13 以降が必要、1.0.23 以降を推奨):
- Ubuntu:
sudo apt-get install libusb-1.0-0-dev pkgconf - Redhat:
sudo yum install libusb1-devel pkgconf - OpenSUSE:
sudo zypper install libusb-1_0-devel pkgconf - MacOS:
brew install libusb pkgconf、またはsudo port install libusb-devel pkgconf - FreeBSD:
pkg install gmake pkgconf(libusb はデフォルトで含まれています) - NetBSD:
sudo pkgin install libusb1 gmake pkgconf - Windows: 未定?
uhubctl ソースを取得してコンパイルするには:
git clone https://github.com/mvp/uhubctl
cd uhubctl
make
これにより uhubctl バイナリが生成されるはずです。システムに /usr/sbin/uhubctl としてインストールするには:
sudo make install
一部のOS(例: FreeBSD/NetBSD)では、ビルドに gmake を使用する必要があることに注意してください。
使用方法
⚠️ Linux では、
sudoを使用するか、後述のUSB権限設定を行ってください!
サポートされているすべてのハブを一覧表示するには:
uhubctl
USBポートの電源を以下のように制御できます:
uhubctl -a off -p 2
これは、デフォルトのスマートハブに対して、ポート2 (-p 2) の電源をオフ (-a off または -a 0) にすることを意味します。サポートされているアクションは off/on/cycle/toggle (または 0/1/2/3) です。cycle は、電源をオフにし、遅延(-d で設定可能)を待ってから再度オンにすることを意味します。ポートはコンマ区切りのリスト、または範囲指定(例: 2、2,4、2-5、1-2,5-8)が可能です。
⚠️ 内蔵USBポートの電源をオフにすると、キーボードやマウスが使えなくなる可能性があるため、どのポートをオフにするか注意してください!
複数のスマートUSBハブが接続されている場合、-l (location) パラメータを使用して特定のハブを選択する必要があります。ハブの場所を見つけるには、パラメータなしで uhubctl を実行するだけです。ハブの場所は b-x.y.z のような形式で、b はUSBバス番号、x, y, z... は、指定されたUSBバスのルートハブから始まるすべてのハブのチェーン上のポート番号です。このアドレスは半安定しており、USBデバイスを同じ物理USBポートに抜き差ししたり、電源をオフ/オンしたりしても変更されません(この方法はLinuxカーネルでも使用されています)。
Linux USB 権限設定
Linux では、udev USB 権限を設定する必要があります(そうしないと、sudo uhubctl としてルート権限で実行する必要があります)。
Linux Kernel 6.0 以降では、USBハブポートのオン/オフを切り替えるための標準インターフェースがあり、uhubctl は(libusb の代わりに)これを使用してポートステータスを設定しようとします。そのため、6.0+ カーネルを実行しているシステムには追加のルールがあります。古いカーネルバージョンのシステムでこれらのルールが存在しても問題ありません。
USB 権限を修正するには、まず sudo uhubctl を実行し、制御する必要があるハブのすべての vid:pid をメモします。次に、以下の udev ルールをファイル /etc/udev/rules.d/52-usb.rules に追加します(2001 をお使いのハブのベンダーIDに置き換えるか、ATTR{idVendor} フィルターを完全に削除して、任意のUSBハブへのアクセスを許可します)。
SUBSYSTEM=="usb", DRIVER=="hub|usb", MODE="0666", ATTR{idVendor}=="2001"
# Linux 6.0 以降 (古いLinuxカーネルでもこのブロックが存在しても問題ありません):
SUBSYSTEM=="usb", DRIVER=="hub|usb", \
RUN="/bin/sh -c \"chmod -f 666 $sys$devpath/*port*/disable || true\""
USB3 ハブの場合、一部のハブは同じチップの USB2 と USB3 コンポーネントで異なるベンダーIDを使用するため、uhubctl が正しく機能するには両方の権限が必要になることに注意してください。例えば、Raspberry Pi 4B の場合、次の2行を追加する必要があります(または idVendor フィルターを削除します)。
SUBSYSTEM=="usb", DRIVER=="hub|usb", MODE="0666", ATTR{idVendor}=="2109"
SUBSYSTEM=="usb", DRIVER=="hub|usb", MODE="0666", ATTR{idVendor}=="1d6b"
広範なアクセスモード 0666 が気に入らない場合は、グループでアクセスを制限できます。
SUBSYSTEM=="usb", DRIVER=="hub|usb", MODE="0664", GROUP="dialout"
# Linux 6.0 以降 (古いLinuxカーネルでもこのブロックが存在しても問題ありません):
SUBSYSTEM=="usb", DRIVER=="hub|usb", \
RUN+="/bin/sh -c \"chown -f root:dialout $sys$devpath/*port*/disable || true\"" \
RUN+="/bin/sh -c \"chmod -f 660 $sys$devpath/*port*/disable || true\""
そして、許可されたユーザーを dialout グループに追加します。
sudo usermod -a -G dialout $USER
udev ルール変更を有効にするには、システムを再起動するか、以下を実行します。
sudo udevadm trigger --attr-match=subsystem=usb
便宜上、すぐに使える udev ルールがこちらで提供されています。
FAQ
USBポートごとの電源スイッチ機能とは何ですか?
USB 2.0 仕様によると、USBハブは電源スイッチ機能なし、ギャング(全ポート同時)電源スイッチ機能、またはポートごと(個別)電源スイッチ機能をアドバタイズできます。注意点として、デフォルトでは uhubctl はポートごとの電源スイッチ機能をサポートするUSBハブのみを検出します(ただし、-f オプションを使用してサポートされていないハブでの操作を強制することは可能です)。ハードウェアがサポートする電源スイッチの種類は、sudo lsusb -v を使用して確認できます。
電源スイッチ機能なし:
wHubCharacteristic 0x000a
No power switching (usb 1.0)
Per-port overcurrent protection
ギャング電源スイッチ機能:
wHubCharacteristic 0x0008
Ganged power switching
Per-port overcurrent protection
ポートごと電源スイッチ機能:
wHubCharacteristic 0x0009
Per-port power switching
Per-port overcurrent protection
私のUSBハブが uhubctl でサポートされているかどうかの確認方法は?
sudo uhubctlを実行します。ハブがリストに表示されない場合、サポートされていません。あるいは、sudo lsusb -vを実行し、「Per-port power switching」を探してください。lsusbの出力にこの行が表示されない場合、ハブはサポートされていません。- VBUS(電圧)オフサポートを確認します: スマートフォン、USBライト、またはUSBファンをハブのUSBポートに接続します。
uhubctlを使用してそのポートの電源をオフにし、スマートフォンが充電を停止し、USBライトが消灯し、USBファンが停止することを確認します。VBUSがオフにならない場合、ハブの製造元は実際に電源を切断する回路を含んでいません。そのようなハブはUSBデータ接続を切断することはできますが、電源をオフにすることはできず、サポートされているデバイスとは見なされません。 - 上記のテストが成功した場合、新しいイシューを https://github.com/mvp/uhubctl/issues で開いてハブを報告してください。これにより、サポートされているデバイスのリストに追加できます。すでにリストされているサポートされているモデルの異なるハードウェアリビジョンでない限り、サポートされていないハブを報告しないでください。
Linuxでポート電源オフ後にUSBデバイスが削除されない
USBポートの電源をオフにした後、udev はイベントを受け取らないため、デバイスファイルはそのまま残ります。しかし、デバイスファイルにアクセスしようとするとIOエラーが発生します。
これはLinuxカーネルの 問題 であり、uhubctl 2.5.0 以降の Linux kernel 6.0 以降のシステムでは 修正 されています。
Linux 5.x 以前を使用している場合は、この問題に対する回避策を使用できます。
sudo uhubctl -a off -l ${location} -p ${port}
sudo udevadm trigger --action=remove /sys/bus/usb/devices/${location}.${port}/
デバイスファイルは udev によって削除されますが、USBデバイスは lsusb で引き続き表示されます。パス /sys/bus/usb/devices/${location}.${port} は、デバイスがそのポートで検出された場合にのみ存在します。電源を再度オンにすると、デバイスは正常に再列挙されるはずです(udevadm を再度呼び出す必要はありません)。
Linuxで数秒後に電源が戻ってしまう
カーネルの一部のデバイスドライバーは、USBデバイスがオフになることに驚き、自動的に電源を戻そうとします。
これはLinuxカーネルの 問題 であり、uhubctl 2.5.0 以降の Linux kernel 6.0 以降のシステムでは 修正 されています。
Linux 5.x 以前を使用している場合:
-r N オプションを使用できます。ここで N は 10 から 1000 までの数値です。これにより、uhubctl は電源を短時間に何度もオフにしようとし、それによって抑制されるはずです。
電源オフ前に、問題のデバイスのUSB認証を無効にすると役立ちます。
echo 0 > sudo tee /sys/bus/usb/devices/${location}.${port}/authorized
デバイスがUSBマスストレージの場合、uhubctl を呼び出す前に udisksctl を呼び出すと役立ちます。
sudo udisksctl power-off --block-device /dev/disk/...
sudo uhubctl -a off ...
接続されているのは1つの7ポートハブだけなのに、複数の4ポートハブが検出される
多くのハブメーカーは、基本的な4ポートUSBチップを使用してUSBハブを構築しています。例えば、7ポートハブを作成するために、2つの4ポートハブをデイジーチェーン接続します。1ポートはデイジーチェーン接続に使用され、4+4-1=7ポートハブになります。同様に、10ポートハブは、3つの4ポートハブをデイジーチェーン接続して構築される可能性があり、4+4+4-2=10個の利用可能なポートが得られます。
内部ハブをデイジーチェーン接続するために使用されるポートの電源状態を変更しようとしないでください。そうすると、内部ハブ回路が混乱し、予期しない動作が発生します。
Raspberry Pi は指定したポートだけでなく、すべてのポートの電源をオフにする
これは Raspberry Pi ハードウェア設計の制限です。回避策として、サポートされているリストから外部USBハブを購入し、Raspberry Pi の任意のUSBポートに接続し、そのポートの電源を個別に制御できます。また、Raspberry Pi 専用に設計されたサポートされているハブもあります。例えば、UUGear MEGA4 です。
参考までに、サポートされている Raspberry Pi モデルは以下の内部USBトポロジーを持っています。
Raspberry Pi B+, 2B, 3B
-
単一ハブ
1-1、ポート 2-5 はギャング化され、すべてポート2で制御されます:uhubctl -l 1-1 -p 2 -a 0ポート
3、4、5を制御しようとしても何も起こりません。ポート1はイーサネット+WiFiの電源を制御します。
Raspberry Pi 3B+
-
メインハブ
1-1、全4ポートギャング化され、すべてポート2で制御されます(セカンダリハブポートもオフになります)。ポート1はハブ1-1を接続し、ポート2と3は外部に配線され、ポート4は配線されていません。uhubctl -l 1-1 -p 2 -a 0 -
セカンダリハブ
1-1.1(メインハブにデイジーチェーン接続): 3ポート、ポート1はイーサネット+WiFi用、ポート2と3は外部に配線されています。
Raspberry Pi 4B
⚠️ VL805 ファームウェアが
00137adより古い場合(sudo rpi-eeprom-updateで確認)、電源スイッチ機能を RPi 4B で動作させるには ファームウェアを更新 する必要があります。
-
USB2 ハブ
1、1ポート、ハブ1-1のみを接続します。 -
USB2 ハブ
1-1、4ポートギャング化、USB3 ハブ2のデュアル:uhubctl -l 1-1 -a 0 -
USB3 ハブ
2、4ポートギャング化、USB2 ハブ1-1のデュアル:uhubctl -l 2 -a 0 -
USB2 ハブ
3、1ポート、OTGコントローラー。電源スイッチはサポートされていません。
Raspberry Pi 5
Raspberry Pi 5 には2つのUSB2ポートと2つのUSB3ポート(合計4つ)があります。これらのポートは、非常に奇妙な構成で4つの独立したUSBハブ 1、2、3、4 に接続されています(ただし、OSとハードウェアリビジョンによっては、関心のあるハブは 2、3、4、5 になる場合があります)。USB3デバイスが青いソケットに接続されている場合、USB3ハブ 2 または 4 で検出されます。USB2デバイスがいずれかのソケットに接続されている場合、またはUSB3デバイスが黒いソケットに接続されている場合、USB2ハブ 1 または 3 で検出されます。USB2/USB3接続タイプに関わらず、青いソケットは常にポート 1、黒いソケットは常にポート 2 です。
4つのUSBオンボードハブはそれぞれポートごとの電源スイッチ機能をサポートしていると広告されていますが、実際にはそうではありません。実際には、Raspberry Pi 5 の全4ポートは、4つの異なる論理USBハブに属しているにも関わらず、1つのグループにギャング化されています。
VBUS電源をオフにするには、すべてのオンボードハブとポートで無効にする必要があります。
uhubctl -l 2 -a 0
uhubctl -l 4 -a 0
オンに戻すには:
uhubctl -l 2 -a 1
uhubctl -l 4 -a 1
注意点として、VBUS電源はすべてのポートがオフの場合にのみ低下します。いずれか1つのポートを有効にすると、すべての4ポートのVBUS電源が戻ります。
uhubctl を使用している注目プロジェクト
| プロジェクト | 説明 |
|---|---|
| Morse code USB light | USBライトでモールス信号のメッセージを点滅させる |
| Webcam USB light | ウェブカメラがオン/オフされたときにLEDをオン/オフする |
| Cinema Lightbox | iOSホームアプリからシネマライトボックスをオン/オフする |
| Build Status Light | 10分以内にビルドステータスライトを作成する |
| Buildenlights | GitLab/GitHubプロジェクトのビルドステータスを緑/赤ライトで表示 |
| Weather Station | 天気予報ステーションがフリーズした際にリセットする |
| sysmoQMOD | 必要に応じてセルラーモデムをリセットする |
| Smog Sensor | Raspberry Piベースの煙センサー電源リセット |
| Terrible Cluster | 必要に応じてRaspberry Piクラスターノードの電源をオン/オフする |
| Ideal Music Server | オーディオ品質向上のため未使用のUSBポートをオフにする |
| USB drives with no phantom load | 必要時のみUSBドライブに電源を供給して電力を節約する |
| USB drive data recovery | 故障したUSBハードドライブからデータを復旧する |
| Control power to 3D printer | USB電源制御のためのOctoPrint Webプラグイン |
| USB fan for Raspberry Pi | Raspberry Piの過熱を防ぐためにUSBファンの制御 |
| Raspberry Pi Reboot Router | インターネットが機能しない場合にルーターを自動的に再起動する |
| Control USB Lamp With Voice | SiriとRaspberry Piを使用したUSBランプの音声制御 |
| Control USB LED Strip | USB電源LEDライトストリップの制御 |
| Brew beer with Raspberry Pi | Raspberry Piを使用した自動ビール醸造システム |
| Webcam On-Air Sign | ウェブカメラ使用時にオンエアサインを自動点灯させる |
| Do it yourself PPPS | uhubctl互換ハブをサポートするためにUSBハブに配線する |
| Open source PPPS hub | uhubctl互換ハブのためのオープンソースハードウェアプロジェクト |
| Python Wrapper for uhubctl | Pythonでuhubctlを使用するためのモジュール |
| labgrid | ハードウェア上の組み込みLinuxをテストするためのフレームワーク |
| Thermal Camera | 必要に応じてロボットのサーマルカメラをオン/オフする |
| Mobile Device Farm | uhubctlを使用したデバイスファームのリモートUSB電源サイクリング |
Copyright
Copyright (C) 2009-2026 Vadim Mikhailov
このファイルは、GNU General Public License version 2 の条件の下で配布されることがあります。