GOROman

Codex Micro プロトコル解析 索引

解析日: 2026-08-07

Codexデスクトップアプリ、Work LouderデバイスSDK、Codex Micro実機のHID Report Map、M5Stack Core2互換実装で確認した通信仕様を、機能ごとのPublic Gistへ分割した索引。

個別解析

1. LED制御プロトコル解析

• 6個のAgent LED、外周、通常キー照明

GOROman

Codex Micro / Work Louder JSON-RPCメソッド一覧

解析日: 2026-08-07

Codexアプリ統合で確認したメソッド

Method	方向	用途
device.status	Host → Device	Firmware、Profile、Layer、Battery取得
sys.version	Host → Device	Firmware version取得

GOROman

Codex Micro Focused App通知解析

解析日: 2026-08-07

host.focused_app

ホストで現在フォーカスされているアプリ情報をデバイスへ通知するJSON-RPC。デバイス側の画面表示やコンテキスト別Profile切り替えに利用できる。

{

GOROman

Codex Micro 識別・検出条件解析

解析日: 2026-08-07

Codexアプリの主な検出条件

項目	値
Vendor ID	0x303A（10進12346）
Product ID	0x8360（10進33632）

GOROman

Codex Micro Device Status・Battery解析

解析日: 2026-08-07

device.status

CodexアプリはVendor JSON-RPCでFirmware、Profile、Layer、バッテリーをまとめて取得する。

リクエスト:

GOROman

Codex Micro Vendor HID JSON-RPC Transport解析

解析日: 2026-08-07

Transport

Codex独自通信はHID Report ID 6、Usage Page 0xFF00を使う。

Channel	値	用途

GOROman

Codex Micro アナログスティック解析

解析日: 2026-08-07

結論

Codex Micro右上の入力はロータリーダイヤルではなく、角度と中心からの距離を通知するアナログスティックとして扱われる。

通知はVendor HID Report ID 6のv.oai.radを使用する。

GOROman

Codex Micro キー・マイクイベント解析

解析日: 2026-08-07

通知メソッド

キー入力はVendor HID Report ID 6のInput Reportとして、v.oai.hid通知で送られる。

完全形式:

GOROman

Codex Micro HID Report解析

解析日: 2026-08-07

Report ID一覧

Report ID	Usage Page	用途	データ長
1	0x01 / 0x07	Keyboard	8 bytes
2	0x0C	Consumer Control	2 bytes

GOROman

Codex Micro BLE GATT Characteristic一覧

解析日: 2026-08-07

概要

Codex MicroはBluetooth LEのHID over GATT Profile（HOGP）として動作する。独自サービスだけで機能を公開する構成ではなく、標準HID Service 0x1812内の複数のReport Characteristic 0x2A4Dを、Report Reference Descriptor 0x2908で区別する。

CharacteristicのAttribute Handleは接続ごとに変わり得るため固定値として扱わない。