Uhubctl – 控制智能USB集线器上每个端口的USB电源

Hacker News Top 工具

摘要

uhubctl 是一个命令行工具,用于控制智能USB集线器上每个端口的USB电源,支持多种兼容的集线器。

暂无内容
查看原文
查看缓存全文

缓存时间: 2026/07/21 18:39

MVp/uhubctl

来源:https://github.com/mvp/uhubctl

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发布年份停产年份
AcerBE270U 显示器(参见 (https://tinyurl.com/acer550))43.02109:28112016
AmazonBasicsHU3641V1(RPi 问题 (https://goo.gl/CLt46M))43.02109:28112013
AmazonBasicsHU3770V1(RPi 问题 (https://goo.gl/CLt46M))73.02109:28112013
AmazonBasicsHU9003V1EBL, HUC9003V1EBL73.12109:28172018
AmazonBasicsHU9002V1SBL, HU9002V1EBL, HU9002V1ESL, HHU9002V1EZPR01(注意 (https://tinyurl.com/HU9002))103.12109:28172018
AmazonBasicsHUC9002V1SBL, HUC9002V1EBL, HUC9002V1ESL103.12109:28172018
AmazonBasicsU3-7HUB(仅对一个充电端口有效)73.02109:28132020
AnkerAK-68ANHUB-BV7A-0004(注意 (https://git.io/JLnZb))73.02109:08122014
AppleMac Mini M4(仅两个前置端口)23.205AC:800B2024
AppleMacBook Air(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 主板(板载 USB 集线器)62.02012
AsusZ87-PLUS 主板(板载 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 显示器(仅在 USB2 模式下工作)43.005E3:06102018
BenQPD3220U43.105E3:06102019
ByteccBT-UH340(警告 (https://tinyurl.com/BT-UH340-1))43.02109:81102010
CentechCT-USB4HUB ReTRY HUB(注意 (https://github.com/mvp/uhubctl/issues/630))43.00424:27442017
CircuitcoBeagleboard-xM(内部 USB 集线器)42.00424:95142010
Club3DCSV-3242HD Dual Display Docking Station43.02109:28112015
CoolgearUSBG-12U2ML122.005E3:06072015
CypressCY4608 HX2VL(注意 (https://tinyurl.com/CY4608-1))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 显示器(注意 (https://git.io/JUAu8))42.02017
DellS2719DGF 27 英寸 WQHD 游戏显示器53.00424:57342018
DellUltraSharp 1704FPT 17 英寸 LCD 显示器42.00424:A70020052015
DellUltraSharp U2415 24 英寸 LCD 显示器53.02014
DellUltraSharp U3419W 34 英寸曲面显示器63.02020
DellWyse 3040(需要 -f 参数 (https://tinyurl.com/wyse3k))63.02017
Delock6253743.020172021
Delock87445(注意 (https://git.io/Jsuz5))42.005E3:060820092013
ElecomU2H-G4S42.020062011
GigabyteG27Q 显示器(参见 (http://tinyurl.com/G27Q551))43.02109:08172020
GlobalScaleESPRESSObin SBUD102 V513.01D6B:00032017
HardkernelODROID-C4(注意 (https://git.io/JG0mP)43.02020
Hawking TechnologyUH21442.020032008
Hewlett PackardUSB-C Dock G5 5TW10AA53.003F0:076B2019
Hewlett PackardP5Q58UT33.02019
IBMSK-8815 USB Keyboard31.104B3:301A2004
InateckHB2025A(仅 USB2 (https://tinyurl.com/HB2025A-1))43.12109:28222021
IOIU3H415E143.02012
j5createJUH377(注意 (https://tinyurl.com/JUH377))73.02016
j5createJUH470(注意 (https://tinyurl.com/JUH470))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 显示器43.0043E:9A602019
LG Electronics27GL850-B 显示器43.00451:81422019
LG Electronics27UK850-W 显示器23.02018
LG Electronics27UN83A-W 显示器23.00451:81422020
LG Electronics38WK95C-W 显示器43.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 X200 Ultrabase 42X496332.017EF:100520082011
LenovoThinkPad X6 Ultrabase 42W310742.017EF:100020062009
LenovoThinkPlus 4-in-1 USB-C hub 4X90W8649733.02021
LenovoThinkVision T24i-10 显示器42.017EF:06102018
LenovoUSB-C to 4 Port USB-A Hub(仅 USB2 (https://github.com/mvp/uhubctl/issues/625))42.017EF:103A2020
LindyUSB serial converter 4 port41.1058F:92542008
LinksysUSB2HUB4(注意 (https://git.io/JYiDZ))42.020042010
MaplinA08CQ(仅红色端口 (https://tinyurl.com/gh635))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(详情 (https://git.io/JJaFR))43.02019
NVidiaJetson Xavier NX(详情 (https://tinyurl.com/Xavier-NX))43.02020
PhidgetsHUB0003_072.01A40:02012017
Philips346B1C UltraWide 34 英寸曲面显示器43.005E3:06102019
PlugableUSB3-HUB7BC73.02109:08132015
PlugableUSB3-HUB7C(仅对两个充电端口有效)73.02109:08132015
PlugableUSBC-HUB7BC(对 6/7 端口有效,最右侧端口除外)73.02109:08172021
PlugableUSB3-HUB10-C2(仅对两个充电端口有效)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(注意 (https://tinyurl.com/RSH518))73.02109:08172021
RosonwayRSH-A10(参见 (https://tinyurl.com/2ppyyaj8))103.00BDA:04112020
RosonwayRSH-A13(警告 (https://tinyurl.com/RSH-A13))133.12109:28222021
RosonwayRSH-A16(注意 (https://git.io/JTawg),警告 (https://tinyurl.com/RSH-A16))163.00bda:04112020
RosonwayRSH-A37S73.02109:28222021
RosonwayRSH-A104(仅 USB2 (https://tinyurl.com/RSH-A104))43.12109:28222022
RosonwayRSH-ST07C(仅 4 个端口 (https://tinyurl.com/4pjnujrn))73.02109:28222023
RosonwayRSH-ST10C-6(注意 (https://tinyurl.com/428vpa2f))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(警告 (https://tinyurl.com/ycxravwk))43.02109:28172018
StarTechHB31C2A2CB(注意 (https://github.com/mvp/uhubctl/issues/601))53.014B0:013D2020
StarTechHB31C3A1CPD3(注意 (https://github.com/mvp/uhubctl/issues/656))53.114B0:013A2019
SunixSHB4200MA42.00409:005820062009
System TalksSugoi USB2-HUB4X(警告 (https://github.com/mvp/uhubctl/issues/636))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(注意 (https://tinyurl.com/vhusb))43.02024

这个表格绝非完整列表。 如果你的集线器可以在 uhubctl 下工作,但未在上表中列出,请通过 https://github.com/mvp/uhubctl/issues 提交新问题报告,以便我们将其添加到支持列表中。在报告中,请提供确切的产品型号,并添加 uhubctl 的输出,同时请按 FAQ 中描述测试 VBUS 关闭功能。

请注意,很多现代主板都内置了支持此功能的根集线器——你可能根本不需要购买任何外部集线器。

USB 3.0 双性说明

如果你的 USB 3.0 集线器连接到 USB3 上游端口,它会被检测为两个独立的虚拟集线器:USB2 和 USB3,并且你的 USB 设备

相似文章

USB Power Delivery:插接优势

Hacker News Top

本文讨论了USB Power Delivery(PD)和USB Extended Power Range(EPR)的演变与优势,这些技术将为汽车、消费电子和航空航天市场中的各种设备实现更快、更高功率的充电。

Griffin PowerMate macOS USB 驱动程序

Lobsters Hottest

这个开源 Swift 项目为 Griffin PowerMate USB 旋钮提供 macOS 驱动程序,使用户能够将旋转和按钮按下映射为系统范围的滚动和点击事件。它包含一个后台代理程序以及关于 USB HID 交互的详细技术文档。

WhatCable

Product Hunt

WhatCable 帮助您识别 USB-C 线缆的功能。

适用于 Firefox 的 WebUSB 扩展

Lobsters Hottest

一款 Firefox 扩展,通过原生消息传递(native messaging)为浏览器添加 WebUSB 功能,让 Web 应用可以在 Firefox 中访问 USB 设备,提供与 Chrome 相似的支持。