Skip to content

Instantly share code, notes, and snippets.

@GOROman
Created August 7, 2026 07:19
Show Gist options
  • Select an option

  • Save GOROman/606dd286ffabd520fac6719bb41ccf4f to your computer and use it in GitHub Desktop.

Select an option

Save GOROman/606dd286ffabd520fac6719bb41ccf4f to your computer and use it in GitHub Desktop.
Codex Micro 識別・検出条件解析

Codex Micro 識別・検出条件解析

解析日: 2026-08-07

Codexアプリの主な検出条件

項目
Vendor ID 0x303A(10進12346
Product ID 0x8360(10進33632
Vendor Usage Page 0xFF00(10進65280
Vendor Usage 0x01
Device Type codex_micro
Layout universal

CodexアプリはBluetooth表示名だけでは検出しない。OSが公開するHID Interfaceに、対象VID/PIDとVendor Usage Pageが存在することが重要。

BLE表示情報

項目 互換値の例
GAP Device Name Codex Micro #1
Manufacturer Work Louder
Product Codex Micro
Serial デバイス固有値
Version 0x0001

表示名はBluetooth設定画面の名称に影響するが、Codexアプリ内の検出成否はHID DescriptorとPnP情報に強く依存する。

Vendor HID Top-Level Collection

Usage Page 0xFF00
Usage      0x01
Collection Application
Report ID  0x06

このTop-Level CollectionがmacOS上で独立したHID Interfaceとして列挙される。CodexアプリはそのInterface pathを開く。

PnP ID

Device Information Service 0x180AのPnP ID 0x2A50例:

01 3A 30 60 83 01 00
部分 意味
01 VID Source
3A 30 VID 0x303A little-endian
60 83 PID 0x8360 little-endian
01 00 Version 0x0001 little-endian

Bluetoothキャッシュ

macOSとiOSはBLE名、GATT構造、bond情報をキャッシュする。Firmware側で名前やDescriptorを変更した場合、次が必要になることがある。

  1. OS側で既存デバイスの登録を解除
  2. デバイス側のbond情報を消去
  3. BluetoothをOFF/ON
  4. 再ペアリング
  5. HID topologyが更新されない場合はMacを再起動

名前だけ変更しても古いnimble表示が残る場合は、GAP名ではなくキャッシュされたAdvertising名またはbond情報が原因になり得る。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment