USB-C 케이블 정체를 까보는 macOS 메뉴바 앱, WhatCable

• USB-C 케이블이 ‘도대체 뭐까지 되는 놈인지’ 보여주는 macOS 메뉴바 앱이 나옴

  • 이름은 WhatCable이고, Mac에 꽂힌 USB-C 케이블의 충전 전력, 데이터 속도, 연결 장치, 활성 전송 모드를 사람이 읽기 쉬운 문장으로 보여줌
  • 같은 USB-C 모양이라도 USB 2.0 충전 전용 케이블부터 240W / 40Gbps Thunderbolt 4 케이블까지 섞여 있는 현실을 겨냥한 도구임

• 핵심 기능은 ‘충전이 왜 느린지’를 바로 찍어주는 진단임

  • 케이블 정격이 충전기보다 낮으면 ‘케이블이 충전 속도를 제한 중’이라고 알려줌
  • Mac이 배터리 상태 때문에 일부러 적게 요청하면 ‘충전기는 96W까지 되지만 현재 30W로 충전 중’처럼 구분해서 보여줌
  • 케이블, 충전기, Mac 중 누가 병목인지 알 수 있으니 책상 밑 케이블 추리쇼가 줄어듦

• 앱이 읽어오는 정보가 꽤 깊음
  • 케이블 e-marker에서 USB 2.0, 5Gbps, 10Gbps, 20Gbps, 40Gbps, 80Gbps 같은 실제 속도와 3A/5A 전류 정격, 칩 벤더를 표시함
  • 충전기 PDO 목록도 보여줘서 5V, 9V, 12V, 15V, 20V 중 어떤 프로필이 광고되고 현재 어떤 프로필이 협상됐는지 볼 수 있음
  • 연결된 USB 저장장치, 허브, 주변기기도 물리 포트 아래에 묶어서 표시하고, 협상된 속도까지 보여줌

sequenceDiagram
    participant 사용자
    participant 메뉴바앱 as 메뉴바 앱
    participant IOKit
    participant 케이블칩 as 케이블 e-marker
    participant 충전기
    사용자->>메뉴바앱: USB-C 포트 상태 확인
    메뉴바앱->>IOKit: 포트와 전원 서비스 조회
    IOKit->>케이블칩: 케이블 식별 정보 읽기
    IOKit->>충전기: PDO와 현재 협상값 확인
    IOKit-->>메뉴바앱: 속도, 전력, 장치 정보 반환
    메뉴바앱-->>사용자: 병목과 케이블 성능을 문장으로 표시

• 엔지니어 모드도 있음

  • 옵션 클릭이나 설정 토글로 내부 IOKit 속성을 그대로 볼 수 있음
  • 메뉴바 앱뿐 아니라 같은 진단 엔진을 쓰는 whatcable CLI도 같이 제공함
  • Homebrew로 설치하면 앱과 CLI 경로 설정이 같이 처리되고, 수동 설치 시에는 앱 번들 안의 바이너리를 직접 심볼릭 링크해야 함

• 지원 조건은 꽤 명확하게 선이 그어져 있음

  • macOS 14 Sonoma 이상이 필요하고, Apple Silicon Mac만 지원함
  • Intel Mac은 Titan Ridge / JHL9580 Thunderbolt 3 컨트롤러를 쓰는데, Apple의 IOKit 드라이버가 USB-PD 협상 상태나 케이블 e-marker VDO를 공개하지 않아서 같은 정보를 뽑을 방법이 없다고 함
  • App Store에도 없음. 앱 샌드박스가 필요한 IOKit 읽기를 막기 때문임

• 구현은 Swift 5.9 기반이고, 앱과 CLI가 공통 코어를 공유함
  • UI는 Sources/WhatCable/ContentView.swift, 사람이 읽기 쉬운 판단 로직은 Sources/WhatCableCore/PortSummary.swift, USB-PD 비트 해석은 Sources/WhatCableCore/PDVDO.swift 쪽에 있음
  • 빌드는 Xcode 15 이상이 필요하고, 스크립트로 universal 앱과 zip 배포물을 만들 수 있음
  • Developer ID 서명, hardened runtime, notarisation, GitHub 릴리스, Homebrew cask 갱신까지 릴리스 파이프라인도 갖춰져 있음

기술 맥락

• WhatCable이 재밌는 이유는 USB-C 문제를 새 하드웨어 없이 소프트웨어로 풀려고 한다는 점이에요. macOS 안에는 이미 포트 상태, 전원 협상, 케이블 식별 정보가 있는데, 보통 사용자는 그걸 볼 방법이 거의 없거든요.

• 이 앱은 IOKit을 골랐기 때문에 메뉴바 앱과 CLI에서 같은 진단 엔진을 공유할 수 있어요. 별도 커널 확장이나 데몬을 깔지 않아도 되고, 공개 접근자로 읽을 수 있는 범위 안에서 문제를 해결한다는 게 장점이에요.

• 대신 이 선택 때문에 제약도 분명해요. Intel Mac에서는 필요한 USB-PD 상태와 e-marker 정보가 공개되지 않아서 지원할 수 없고, App Store 샌드박스 안에서도 필요한 IOKit 접근이 막혀요.

• USB-PD와 e-marker를 같이 보는 것도 중요해요. 충전이 느릴 때 원인이 케이블 정격인지, 충전기 프로필인지, Mac이 현재 적게 요청하는 상태인지 구분해야 실제로 바꿔야 할 부품을 알 수 있으니까요.