ホーム>プログラミング関連>C# ソースコード
ダウンロード

うーハブctl

uhubctlスマート USB ハブのポートごとに USB 電源を制御するユーティリティです。スマート ハブは、ポートごとの電源スイッチングを実装するハブとして定義されます。

このコードの元のアイデアは、新部豊氏による Hub-ctrl.c からインスピレーションを受けました: https://www.gniibe.org/development/ac-power-control-by-USB-hub

対応USBハブ

実際にポートごとの電源切り替えをサポートしているハブはほとんどないことに注意してください。中にはもう製造されていないものもあり、見つけるのが難しい場合があります。

これは、既知の互換性のある USB ハブのリストです。

メーカー製品ポートUSB VID:PIDリリースEOL
エイサーBE270U モニター (参照) 4 3.0 2109:2811 2016年
アマゾンベーシックHU3641V1 (RPi の問題) 4 3.0 2109:2811 2013年
アマゾンベーシックHU3770V1 (RPi の問題) 7 3.0 2109:2811 2013年
アマゾンベーシックHU9003V1EBL、HUC9003V1EBL 7 3.1 2109:2817 2018年
アマゾンベーシックHU9002V1SBL、HU9002V1EBL、HU9002V1ESL（注） 10 3.1 2109:2817 2018年
アマゾンベーシックHUC9002V1SBL、HUC9002V1EBL、HUC9002V1ESL 10 3.1 2109:2817 2018年
アマゾンベーシックU3-7HUB (1 つの充電ポートでのみ動作) 7 3.0 2109:2813 2020年
アンカーAK-68ANHUB-BV7A-0004(注) 7 3.0 2109:0812 2014年
りんごPro Display XDR MWPE2LL/A (内蔵 USB ハブ) 4 2.0 05AC:9139 2019年
りんごThunderbolt Display 27 インチ (内蔵 USB ハブ) 6 2.0 2011年2016年
りんごテンキー付き USB キーボード (内蔵 USB ハブ) 3 2.0 2011年
エイスースZ77 Sabertooth マザーボード (オンボード USB ハブ) 6 2.0 2012年
エイスースZ87-PLUS マザーボード (オンボード USB ハブ) 4 3.0 2013年2016年
オーキーCB-C59 4 3.0 2109:2813 2017年
B+B スマートワークスUHR204 4 2.0 0856:DB00 2013年
B+B スマートワークスUSH304 4 3.0 04B4:6506 2017年2019年
バスラー2000036234 4 3.0 0451:8046 2016年
ベルキンF5U101 4 2.0 0451:2046 2005年2010年
ベルキンF5U238UKCRL-MOB 4 2.0 0409:0059 2004年2010年
ベンキューPD2700U 4K モニター (USB2 モードでのみ動作) 4 3.0 05E3:0610 2018年
ベンキューPD3220U 4 3.1 05E3:0610 2019年
バイトテックBT-UH340（警告） 4 3.0 2109:8110 2010年
センテックCT-USB4HUB リトライハブ4 3.0 0424:2744 2017年
サーキットコBeagleboard-xM (内蔵 USB ハブ) 4 2.0 0424:9514 2010年
クラブ3D CSV-3242HD デュアル ディスプレイ ドッキング ステーション4 3.0 2109:2811 2015年
クールギアUSBG-12U2ML 12 2.0 05e3:0607 2015年
サイプレスCY4608 HX2VL 開発キット (注) 4 2.0 04B4:6570 2012年
DリンクDUB-H4 Rev D、E (ブラック)。注: Rev A、C、F はサポートされていません4 2.0 05E3:0608 2012年
DリンクDUB-H7 Rev A（シルバー） 7 2.0 2001:F103 2005年2010年
DリンクDUB-H7 rev D、E (ブラック)。 Rev B、C、F、G はサポートされていません7 2.0 05E3:0608 2012年
デルP2416D 24 インチ QHD モニター (注) 4 2.0 2017年
デルS2719DGF 27 インチ WQHD ゲーミング モニター5 3.0 0424:5734 2018年
デルUltraSharp 1704FPT 17 インチ LCD モニター4 2.0 0424:A700 2005年2015年
デルUltraSharp U2415 24 インチ LCD モニター5 3.0 2014年
デルUltraSharp U3419W 34 インチ曲面モニター6 3.0 2020年
デルWyse 3040 (-f が必要) 6 3.0 2017年
デロック62537 4 3.0 2017年2021年
デロック87445 (注) 4 2.0 05E3:0608 2009年2013年
エレコムU2H-G4S 4 2.0 2006年2011年
ギガバイトG27Q モニター (「 4 3.0 2109:0817 2020年
グローバルスケールエスプレッソビン SBUD102 V5 1 3.0 1D6B:0003 2017年
ハードカーネルODROID-C4（注） 4 3.0 2020年
ホーキングテクノロジーUH214 4 2.0 2003年2008年
ヒューレット・パッカードUSB-C ドック G5 5TW10AA 5 3.0 03F0:076B 2019年
ヒューレット・パッカードP5Q58UT 3 3.0 2019年
イナテックHB2025A (USB2のみ) 4 3.1 2109:2822 2021年
オイオイU3H415E1 4 3.0 2012年
j5create JUH377(注) 7 3.0 2016年
j5create JUH470(注) 3 3.0 05E3:0610 2014年
ジュースシステム6HUB-01 7 3.0 0BDA:0411 2014年2018年
クンバス社RevPi コネクト (+) / S / SE 2 2.0 0424:9514 2018年
クンバス社RevPi コネクト 4 2 3.0 2022年
クンバス社RevPiコア3/S/SE 2 2.0 0424:9514 2017年
LGエレクトロニクス27MD5KL-Bモニター4 3.0 043E:9A60 2019年
LGエレクトロニクス27GL850-Bモニター4 3.0 0451:8142 2019年
LGエレクトロニクス27UK850-Wモニター2 3.0 2018年
LGエレクトロニクス27UN83A-Wモニター2 3.0 0451:8142 2020年
LGエレクトロニクス38WK95C-Wモニター4 3.0 0451:8142 2018年
レノボThinkPad ウルトラ ドッキング ステーション (40A20090EU) 6 2.0 17EF:100F 2015年
レノボThinkPad ウルトラ ドッキング ステーション (40AJ0135EU) 7 3.1 17EF:3070 2018年
レノボThinkPad X200 ウルトラベース 42X4963 3 2.0 17EF:1005 2008年2011年
レノボThinkPad X6 ウルトラベース 42W3107 4 2.0 17EF:1000 2006年2009年
レノボThinkPlus 4-in-1 USB-C ハブ 4X90W86497 3 3.0 2021年
レノボThinkVision T24i-10 モニター4 2.0 17EF:0610 2018年
レノボUSB-C - 4 ポート USB-A ハブ4 2.0 17EF:103A 2020年
リンディUSBシリアルコンバータ4ポート4 1.1 058F:9254 2008年
リンクシスUSB2HUB4(注) 4 2.0 2004年2010年
マップリンA08CQ 7 2.0 0409:0059 2008年2011年
メタドットダス キーボード 4 2 3.0 2014年
マイクロチップEVB9512 2 2.0 2009年
マイクロチップEVB-USB2517 7 2.0 2008年
マイクロチップEVB-USB2534BC 4 2.0 2013年
マイクロチップEVB-USB5807 7 3.0 2016年
お灸うぽーと-407 7 2.0 110A:0407 2009年
エヌビディアJetson Nano B01（詳細） 4 3.0 2019年
エヌビディアJetson Xavier NX (詳細) 4 3.0 2020年
フィジェットHUB0003_0 7 2.0 1A40:0201 2017年
フィリップス346B1C ウルトラワイド 34 インチ曲面モニター4 3.0 05E3:0610 2019年
プラグ可能USB3-HUB7BC 7 3.0 2109:0813 2015年
プラグ可能USB3-HUB7C (2 つの充電ポートでのみ機能) 7 3.0 2109:0813 2015年
プラグ可能USBC-HUB7BC (右端ではなく、6/7 ポートで動作します) 7 3.0 2109:0817 2021年
プラグ可能USB3-HUB10-C2 (2 つの充電ポートでのみ機能) 10 3.0 2014年
ポート株式会社NWUSB01 4 1.1 0451:1446 1999年2003年
ラズベリーパイB+、2B、3B (下記参照) 4 2.0 2011年
ラズベリーパイ3B+ (下記を参照) 4 2.0 0424:2514 2018年
ラズベリーパイ4B (下記参照) 4 3.0 2109:3431 2019年
ラズベリーパイ5 (下記参照) 4 3.0 1d6b:0002 2023年
ルネサスuPD720202 PCIe USB 3.0 ホスト コントローラー2 3.0 2013年
ローズウィルRHUB-210 4 2.0 0409:005A 2011年2014年
ロゾンウェイRSH-518C（注） 7 3.0 2109:0817 2021年
ロゾンウェイRSH-A10（参照） 10 3.0 0bda:0411 2020年
ロゾンウェイRSH-A13（警告） 13 3.1 2109:2822 2021年
ロゾンウェイRSH-A16（注、警告） 16 3.0 0bda:0411 2020年
ロゾンウェイRSH-A104（USB2のみ） 4 3.1 2109:2822 2022年
ロゾンウェイRSH-A107（別名育愛A107-5） 7 3.1 0bda:5411 2022年
ロゾンウェイRSH-ST07C（4台のみ） 7 3.0 2109:2822 2023年
サンワサプライUSB-HUB14GPH 4 1.1 2001年2003年
シーゲイトバックアッププラスハブ STEL8000100 2 3.0 0BC2:AB44 2016年
シードスタジオリターミナル CM4104032 2 2.0 0424:2514 2021年
スターテックDKT30CSDHPD3 USB-C トラベル ドック3 3.0 2109:2817 2018年
スターテックHB30A4AIB（警告） 4 3.0 2109:2817 2018年
サニックスSHB4200MA 4 2.0 0409:0058 2006年2009年
システムトークすごいUSB2-HUB4X 4 2.0 2007年
ターガスPA095UZ 2 2.0 2004年
ターガスPAUH212/PAUH212U 7 2.0 2004年2009年
テキサス・インスツルメンツTUSB4041PAPEVM 4 2.1 0451:8142 2015年
ユーギアMEGA4 (Raspberry Pi 4B用) 4 3.0 2109:0817 2021年
仮想ここUSB3 4ポートハブ(注) 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 (Ubuntu/Debian、Redhat/Fedora/CentOS、Arch Linux、Gentoo、openSUSE、Buildroot)、FreeBSD、NetBSD、SunOS、MacOS 上でコンパイルして動作することがテストされています。

uhubctl Windows 上でコンパイルされますが、 libusb winusb.sysドライバーを使用しているため、Windows では USB 電源の切り替えが機能しません。Microsoft によれば、このドライバーは必要な USB 制御要求をサポートしていません。この問題は、 libusb Windows 上で別のドライバーのサポートを開始すると修正される可能性があります。

pkg-configインストールすることを強くお勧めします (多くのプラットフォームではデフォルトで提供されています)。

まず、ライブラリ libusb-1.0 (バージョン 1.0.12 以降、1.0.16 以降を推奨) をインストールする必要があります。

  • Ubuntu: sudo apt-get install libusb-1.0-0-dev
  • Redhat: sudo yum install libusb1-devel
  • OpenSUSE: sudo zypper install libusb-1_0-devel
  • MacOS: brew install libusb 、またはsudo port install libusb-devel
  • FreeBSD: libusb はデフォルトで含まれています
  • NetBSD: sudo pkgin install libusb1 gmake pkg-config
  • Windows: 未定?

uhubctl ソースを取得してコンパイルするには、次のようにします。 

 git clone https://github.com/mvp/uhubctl
cd uhubctl
make

これにより、 uhubctlバイナリが生成されるはずです。以下を使用して、システムに/usr/sbin/uhubctlとしてインストールできます。 

 sudo make install

一部の OS (FreeBSD/NetBSD など) では、ビルドの代わりにgmake使用する必要があることに注意してください。

また、MacOS では、Homebrew タップを使用して、必要な依存関係をすべて含むuhubctlワンショットでインストールできます。 

 brew tap mvp/uhubctl https://github.com/mvp/uhubctl
brew install uhubctl

master ブランチからビルド/インストールするには、 --HEADを使用します。 

 brew install uhubctl --HEAD

使用法

️ 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 (場所) パラメーターを使用して制御する特定のハブを選択する必要があります。ハブの場所を見つけるには、パラメータを指定せずにuhubctl実行するだけです。ハブの場所はbx.yzのようになります。 bは USB バス番号、 x 、 y 、 z ... は、特定の USB バスのルート ハブから始まるチェーン内のすべてのハブのポート番号です。このアドレスは半安定です。USB デバイスを同じ物理 USB ポートに抜き差ししても (または、電源をオフ/オンにして) 変更されません (この方法は Linux カーネルでも使用されます)。

Linux USB 権限

Linux では、 udev USB 権限を設定する必要があります (それ以外の場合は、 sudo uhubctl使用して root として実行する必要があります)。

Linux カーネル 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=="usb", MODE="0666", ATTR{idVendor}=="2001"
# Linux 6.0 or later (its ok to have this block present for older Linux kernels):
SUBSYSTEM=="usb", DRIVER=="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=="usb", MODE="0666", ATTR{idVendor}=="2109"
SUBSYSTEM=="usb", DRIVER=="usb", MODE="0666", ATTR{idVendor}=="1d6b"

ワイドオープンモード0666が気に入らない場合は、次のようにグループごとにアクセスを制限できます。 

 SUBSYSTEM=="usb", DRIVER=="usb", MODE="0664", GROUP="dialout"
# Linux 6.0 or later (its ok to have this block present for older Linux kernels):
SUBSYSTEM=="usb", DRIVER=="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 ルールがここに提供されています。

よくある質問

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 カーネルの問題であり、Linux カーネル 6.0 以降を搭載したシステムでは uhubctl 2.5.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 カーネルの問題であり、Linux カーネル 6.0 以降を搭載したシステムでは uhubctl 2.5.0 以降で修正されています。

まだ Linux 5.x 以前を使用している場合:

これを修正するには、オプション-r N使用できます。N は 10 ～ 1000 の数値です。uhubctl uhubctl電源を何度も続けてオフにしようとするため、それを抑制する必要があります。

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 ...

複数の 4 ポート ハブが検出されましたが、7 ポート ハブが 1 つしか接続されていません

多くのハブ メーカーは、基本的な 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 ポートに接続して、ポートの電源を個別に制御できます。また、UUGear MEGA4 など、Raspberry Pi 専用に設計されたハブもサポートされています。

参考までに、サポートされている Raspberry Pi モデルには次の内部 USB トポロジがあります。

ラズベリーパイ B+、2B、3B

  • 単一のハブ1-1 、ポート 2 ～ 5 が連動し、すべてポート2によって制御されます。 

     uhubctl -l 1-1 -p 2 -a 0

    ポート3 、 4 、 5を制御しようとしても何も起こりません。ポート1イーサネット + WiFi の電力を制御します。

ラズベリーパイ 3B+

  • メイン ハブ1-1 、4 つのポートすべてが連動し、すべてポート2によって制御されます (セカンダリ ハブ ポートもオフになります)。ポート1以下のハブ1-1.1に接続し、ポート2と3外部に配線され、ポート4配線されません。 

     uhubctl -l 1-1 -p 2 -a 0

  • セカンダリ ハブ1-1.1 (メインにデイジーチェーン接続): 3 つのポート。ポート1はイーサネット + WiFi に使用され、ポート2と3外部に配線されます。

ラズベリーパイ4B

️ VL805 ファームウェアが00137adより古い場合 ( sudo rpi-eeprom-updateで確認してください)、RPi 4B で電源切り替えが機能するようにファームウェアを更新する必要があります。

  • USB2 ハブ1 、1 ポート、以下のハブ1-1のみを接続します。

  • USB2 ハブ1-1ポート連動、以下の USB3 ハブ2へのデュアル: 

     uhubctl -l 1-1 -a 0

  • USB3 ハブ2ポート連動、上記の USB2 ハブ1-1へのデュアル: 

     uhubctl -l 2 -a 0

  • USB2ハブ3ポート、OTGコントローラー。電源切り替えはサポートされていません。

ラズベリーパイ5

Raspberry Pi 5 には、USB2 ポートが 2 つと USB3 ポートが 2 つ (合計 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 つの異なる論理 USB ハブに属しているにもかかわらず、4 つのポートすべてが 1 つのグループにまとめられています。

VBUS 電源をオフにするには、次の方法ですべてのオンボード ハブとポートにわたって 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 を使用した注目すべきプロジェクト

プロジェクト説明
モールス信号USBライトUSBライトでモールス信号のメッセージをフラッシュ
ウェブカメラUSBライトWebカメラのオン/オフに合わせてLEDをオン/オフします
シネマ ライトボックスiOSホームアプリからシネマライトボックスをオン/オフにする
ビルドステータスライト10 分以内にビルド ステータス ライトを作成します
ビルデンライトGitLab/GitHub プロジェクトのビルド ステータスが緑/赤のライトで表示される
気象観測所ウェザーステーションがフリーズした場合にリセットする
シスモQMOD必要に応じてセルラーモデムをリセットする
スモッグセンサーRaspberry Piベースのスモッグセンサーの電源リセット
恐ろしいクラスター必要に応じて Raspberry Pi クラスター ノードの電源をオン/オフします
理想的なミュージックサーバーオーディオ品質を向上させるために未使用の USB ポートをオフにします
ファントムロードのない USB ドライブ電力を節約するために必要な場合にのみ USB ドライブに電力を供給します
USBドライブのデータ復旧故障したUSBハードドライブからデータを回復する
3Dプリンターへの電源制御USB電源制御用のOctoPrint Webプラグイン
Raspberry Pi用USBファンUSBファンを制御してRaspberry Piの過熱を防ぎます
Raspberry Pi 再起動ルーターインターネットが機能していない場合はルーターを自動的に再起動します
USBランプを音声で制御Siri と Raspberry Pi を使用した USB ランプの音声制御
制御USB LEDストリップUSB 電源による LED ライト ストリップの制御
Raspberry Piでビールを醸造するRaspberry Piを使った自動ビール醸造システム
ウェブカメラのオンエアサインウェブカメラの使用中に標識を自動的に点灯します
自分でやる PPPS uhubctl をサポートするには、USB ハブにワイヤをはんだ付けします。
オープンソースのPPPSハブuhubctl 互換ハブのオープンソース ハードウェア プロジェクト
uhubctl の Python ラッパーPythonでuhubctlを使用するためのモジュール
ラボグリッドハードウェア上の組み込み Linux をテストするためのフレームワーク

著作権

著作権 (C) 2009-2024 ヴァディム・ミハイロフ

このファイルは、GNU General Public License バージョン 2 の利用規約に基づいて配布できます。

拡大する
追加情報
関連アプリ
おすすめ
関連情報 すべて