SuperAPI AI 工具集

whatcable-macos-usb-inspector

通用与其它

查看项目

更新于 10-15 22:33

技能介绍

用途:WhatCable 是一款 macOS 14+ 菜单栏应用(Swift/SwiftUI),通过读取 IOKit 服务,用通俗语言展示插入 Mac 的每个 USB-C 线缆实际具备的能力,包括传输速度、供电等级、e-marker 数据、PDO 配置以及所连设备身份,并提供充电诊断。

主要能力:读取 AppleHPMInterfaceType10/11/12(M3 及以后)与 AppleTCControllerType10(M1/M2)端口的每口状态、传输类型、插头方向、e-marker 是否存在;读取 IOPortFeaturePowerSource 获取完整 PDO 列表与实时协商 PDO;通过 IOPortTransportComponentCCUSBPDSOP 解析 PD Discover Identity VDO(SOP 为对端,SOP' 为线缆 e-marker)。按 USB PD 3.x 规范解码线缆 e-marker VDO,得到数据速率(USB 2.0、5/10/20/40 Gbps 等)与 VBUS 电流能力(≤3A、3A、5A)。界面按端口给出简洁结论,并输出充电诊断。

使用方式:开发运行用 swift run WhatCable;构建通用二进制发行版用 ./scripts/build-app.sh,产物为 dist/WhatCable.app 与 dist/WhatCable.zip。需要 Swift 5.9 / Xcode 15+、macOS 14(Sonoma)或更高。签名与公证需将 .env.example 复制为 .env,填写 DEVELOPER_ID 与 NOTARY_PROFILE,并用 xcrun notarytool store-credentials 存入凭据后再执行构建脚本。调试时按住 Option 点击可切换显示原始 IOKit 属性。

适用场景:排查 USB-C 线缆是否限制充电速度或数据传输速率;确认线缆是否带 e-marker 芯片;查看端口协商到的 PDO 与瓦数;区分设备连接、仅充电、慢速线缆或无连接。

限制:仅支持 macOS 14+,依赖 IOKit 服务名,不同 Mac 世代需匹配对应服务名;无 e-marker 的线缆不提供 VDO,属预期现象;PDO 列表可能因设备不支持 PD 或端口仅供电而为空;PD 3.2 EPR AVS PDO 位布局不同,可能显示错误瓦数;构建与公证需要开发者账号与凭据,否则可能出现 Gatekeeper 警告。资料未提供官方分发渠道、收费方式或价格信息。