HN 日本語サマリー

← 一覧へ戻る
プログラミング

uhubctl – スマートUSBハブのポートごとのUSB電源制御

Uhubctl – control USB power per-port on smart USB hubs (github.com)

24 pointsby gregsadetsky9 コメント

要約

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ハブのリストです:

メーカー製品ポート数USBVID:PIDリリースEOL
AcerBE270U monitor (参照)43.02109:28112016
AmazonBasicsHU3641V1 (RPi issue)43.02109:28112013
AmazonBasicsHU3770V1 (RPi issue)73.02109:28112013
AmazonBasicsHU9003V1EBL, HUC9003V1EBL73.12109:28172018
AmazonBasicsHU9002V1SBL, HU9002V1EBL, HU9002V1ESL, HHU9002V1EZPR01 (注記)103.12109:28172018
AmazonBasicsHUC9002V1SBL, HUC9002V1EBL, HUC9002V1ESL103.12109:28172018
AmazonBasicsU3-7HUB (充電ポート1つのみ動作)73.02109:28132020
AnkerAK-68ANHUB-BV7A-0004 (注記)73.02109:08122014
AppleMac Mini M4 (前面ポート2つのみ)23.205AC:800B2024
AppleMacBook Air (Late 2010)22.01D6B:000220102020
ApplePro Display XDR MWPE2LL/A (内部USBハブ)42.005AC:91392019
AppleThunderbolt Display 27" (内部USBハブ)62.020112016
AppleUSB Keyboard With Numeric Pad (内部USBハブ)32.02011
AsusZ77 Sabertooth Motherboard (オンボードUSBハブ)62.02012
AsusZ87-PLUS Motherboard (オンボードUSBハブ)43.020132016
AukeyCB-C5943.02109:28132017
B+B SmartWorxUHR20442.00856:DB002013
B+B SmartWorxUSH30443.004B4:650620172019
Basler200003623443.00451:80462016
BelkinF5U10142.00451:204620052010
BelkinF5U238UKCRL-MOB42.00409:005920042010
BenQPD2700U 4K Monitor (USB2モードのみ動作)43.005E3:06102018
BenQPD3220U43.105E3:06102019
ByteccBT-UH340 (警告)43.02109:81102010
CentechCT-USB4HUB ReTRY HUB (注記)43.00424:27442017
CircuitcoBeagleboard-xM (内部USBハブ)42.00424:95142010
Club3DCSV-3242HD Dual Display Docking Station43.02109:28112015
CoolgearUSBG-12U2ML122.005E3:06072015
CypressCY4608 HX2VL (注記)42.004B4:65702012
D-LinkDUB-2332 rev A133.02022
D-LinkDUB-H4 rev D,E (黒)。注: rev A,C,Fは非対応42.005E3:06082012
D-LinkDUB-H7 rev A (銀)72.02001:F10320052010
D-LinkDUB-H7 rev D,E (黒)。Rev B,C,F,Gは非対応72.005E3:06082012
DellDA300 USB-C Mobile Adapter23.02109:28202018
DellP2416D 24" QHD Monitor (注記)42.02017
DellS2719DGF 27" WQHD Gaming-Monitor53.00424:57342018
DellUltraSharp 1704FPT 17" LCD Monitor42.00424:A70020052015
DellUltraSharp U2415 24" LCD Monitor53.02014
DellUltraSharp U3419W 34" Curved Monitor63.02020
DellWyse 3040 (‐f必須)63.02017
Delock6253743.020172021
Delock87445 (注記)42.005E3:060820092013
ElecomU2H-G4S42.020062011
GigabyteG27Q monitor (参照)43.02109:08172020
GlobalScaleESPRESSObin SBUD102 V513.01D6B:00032017
HardkernelODROID-C4 (注記)43.02020
Hawking TechnologyUH21442.020032008
Hewlett PackardUSB-C Dock G5 5TW10AA53.003F0:076B2019
Hewlett PackardP5Q58UT33.02019
IBMSK-8815 USB Keyboard31.104B3:301A2004
InateckHB2025A (USB2のみ)43.12109:28222021
IOIU3H415E143.02012
j5createJUH377 (注記)73.02016
j5createJUH470 (注記)33.005E3:06102014
Juiced Systems6HUB-0173.00BDA:041120142018
KUNBUS GmbHRevPi Connect (+) / S / SE22.00424:95142018
KUNBUS GmbHRevPi Connect 423.02022
KUNBUS GmbHRevPi Core 3 / S / SE22.00424:95142017
LG Electronics27MD5KL-B monitor43.0043E:9A602019
LG Electronics27GL850-B monitor43.00451:81422019
LG Electronics27UK850-W monitor23.02018
LG Electronics27UN83A-W monitor23.00451:81422020
LG Electronics38WK95C-W monitor43.00451:81422018
LenovoThinkPad Mini Dock Series 3 (433710U)62.017EF:100A2016
LenovoThinkPad Ultra Docking Station (40A20090EU)62.017EF:100F2015
LenovoThinkPad Ultra Docking Station (40AJ0135EU)73.117EF:30702018
LenovoThinkPad USB 3.0 Ultra Dock (40A8) DK-152363.017EF:10142015
LenovoThinkPad X200 Ultrabase 42X496332.017EF:100520082011
LenovoThinkPad X6 Ultrabase 42W310742.017EF:100020062009
LenovoThinkPlus 4-in-1 USB-C hub 4X90W8649733.02021
LenovoThinkVision T24i-10 Monitor42.017EF:06102018
LenovoUSB-C to 4 Port USB-A Hub (USB2のみ)42.017EF:103A2020
LindyUSB serial converter 4 port41.1058F:92542008
LinksysUSB2HUB4 (注記)42.020042010
MaplinA08CQ (赤色ポートのみ動作) (参照)72.00409:005920082011
MetadotDas Keyboard 423.02014
MicrochipEVB951222.02009
MicrochipEVB-USB251772.02008
MicrochipEVB-USB2534BC42.02013
MicrochipEVB-USB580773.02016
MoxaUport-40772.0110A:04072009
NVidiaJetson Nano B01 (詳細)43.02019
NVidiaJetson Orin Nano Devkit (詳細)43.02023
NVidiaJetson Xavier NX (詳細)43.02020
PhidgetsHUB0003_072.01A40:02012017
Philips346B1C UltraWide 34" Curved Monitor43.005E3:06102019
PlugableUSB3-HUB7BC73.02109:08132015
PlugableUSB3-HUB7C (充電ポート2つのみ動作)73.02109:08132015
PlugableUSBC-HUB7BC (6/7ポート動作、一番右は不可)73.02109:08172021
PlugableUSB3-HUB10-C2 (充電ポート2つのみ動作)103.02014
Port IncNWUSB0141.10451:144619992003
Raspberry PiB+, 2B, 3B (下記参照)42.02011
Raspberry Pi3B+ (下記参照)42.00424:25142018
Raspberry Pi4B (下記参照)43.02109:34312019
Raspberry Pi5 (下記参照)43.01D6B:00022023
RenesasuPD720202 PCIe USB 3.0 host controller23.02013
RosewillRHUB-21042.00409:005A20112014
RosonwayRSH-518C (注記)73.02109:08172021
RosonwayRSH-A10 (参照)103.00BDA:04112020
RosonwayRSH-A13 (警告)133.12109:28222021
RosonwayRSH-A16 (注記, 警告)163.00bda:04112020
RosonwayRSH-A37S73.02109:28222021
RosonwayRSH-A104 (USB2のみ)43.12109:28222022
RosonwayRSH-ST07C (4ポートのみ動作) (参照)73.02109:28222023
RosonwayRSH-ST10C-6 (注記)103.10BDA:04232024
Sanwa SupplyUSB-HUB14GPH41.120012003
SatechiMac Mini Hub (M1/M2)43.02109:28172023
SeagateBackup Plus Hub STEL800010023.00BC2:AB442016
Seeed StudioreTerminal CM410403222.00424:25142021
StarTechDKT30CSDHPD3 USB-C Travel Dock33.02109:28172018
StarTechHB30A4AIB (警告)43.02109:28172018
StarTechHB31C2A2CB (注記)53.014B0:013D2020
StarTechHB31C3A1CPD3 (注記)53.114B0:013A2019
SunixSHB4200MA42.00409:005820062009
System TalksSugoi USB2-HUB4X (警告)42.02007
TargusACH155 (ポート3が全ポートを制御)43.02022
TargusPA095UZ22.02004
TargusPAUH212/PAUH212U72.020042009
Texas InstrumentsTUSB4041PAPEVM42.10451:81422015
UUGearMEGA4 (Raspberry Pi 4B用)43.02109:08172021
VirtualHereUSB3 4-port hub (注記)43.02024

この表は決して完全なものではありません。もしお使いのハブが 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 でサポートされているかどうかの確認方法は?
  1. sudo uhubctl を実行します。ハブがリストに表示されない場合、サポートされていません。あるいは、sudo lsusb -v を実行し、「Per-port power switching」を探してください。lsusb の出力にこの行が表示されない場合、ハブはサポートされていません。
  2. VBUS(電圧)オフサポートを確認します: スマートフォン、USBライト、またはUSBファンをハブのUSBポートに接続します。uhubctl を使用してそのポートの電源をオフにし、スマートフォンが充電を停止し、USBライトが消灯し、USBファンが停止することを確認します。VBUSがオフにならない場合、ハブの製造元は実際に電源を切断する回路を含んでいません。そのようなハブはUSBデータ接続を切断することはできますが、電源をオフにすることはできず、サポートされているデバイスとは見なされません。
  3. 上記のテストが成功した場合、新しいイシューを 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 lightUSBライトでモールス信号のメッセージを点滅させる
Webcam USB lightウェブカメラがオン/オフされたときにLEDをオン/オフする
Cinema LightboxiOSホームアプリからシネマライトボックスをオン/オフする
Build Status Light10分以内にビルドステータスライトを作成する
BuildenlightsGitLab/GitHubプロジェクトのビルドステータスを緑/赤ライトで表示
Weather Station天気予報ステーションがフリーズした際にリセットする
sysmoQMOD必要に応じてセルラーモデムをリセットする
Smog SensorRaspberry 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 printerUSB電源制御のためのOctoPrint Webプラグイン
USB fan for Raspberry PiRaspberry Piの過熱を防ぐためにUSBファンの制御
Raspberry Pi Reboot Routerインターネットが機能しない場合にルーターを自動的に再起動する
Control USB Lamp With VoiceSiriとRaspberry Piを使用したUSBランプの音声制御
Control USB LED StripUSB電源LEDライトストリップの制御
Brew beer with Raspberry PiRaspberry Piを使用した自動ビール醸造システム
Webcam On-Air Signウェブカメラ使用時にオンエアサインを自動点灯させる
Do it yourself PPPSuhubctl互換ハブをサポートするためにUSBハブに配線する
Open source PPPS hubuhubctl互換ハブのためのオープンソースハードウェアプロジェクト
Python Wrapper for uhubctlPythonでuhubctlを使用するためのモジュール
labgridハードウェア上の組み込みLinuxをテストするためのフレームワーク
Thermal Camera必要に応じてロボットのサーマルカメラをオン/オフする
Mobile Device Farmuhubctlを使用したデバイスファームのリモートUSB電源サイクリング

Copyright

Copyright (C) 2009-2026 Vadim Mikhailov

このファイルは、GNU General Public License version 2 の条件の下で配布されることがあります。