Home

cyberboard-cli — Research Notes

AngryMiao CyberBoard R4 のリバースエンジニアリング過程で書いた調査スクリプトと プロトコル実験のアーカイブ。プロジェクトルートを Python project として綺麗に保つため、 リポジトリのツリーからここ(wiki)へ移設した(90 続29-30)。

蒸留済みの確定知見は repo の .claude/rules/(00〜40)+ 90-research-log.md にある。 ここに残すのは原始的な調査資材(再 mine 用のスクリプト・実験ノート・実験データ)。

実験ノート

• frame-limit-256 — フレーム数上限が 256(2^8)であることの実機確定。
• keymap-matrix — 25×8 matrix マップ / キーコード #MMPPUUUU の decode / レイヤモデル。
• partial-write — 部分書込非対応(JSON_START が設定フラッシュ全消去)の実証。
• perkey-layout — per-key LED 物理配置の web 抽出 + TUI レンダラ(index マップは未確定 🔴)。

各実験のスクリプト・データは experiments/<name>/ 配下にそのまま保管(ページとは別ファイル)。

解析スクリプト(_re/)

• _re/zscan.py — PyInstaller バイナリ内 zlib ストリームのブルートスキャナ(初動の静的解析)。
• _re/verify_encoding.py — TransJsonCmd/JsonToCmd の chunking を移植し、 既知正解 JSON で 64B フレーム化を実データ検証したもの。

⚠ 逆コンパイル原典(decompiled/・dc3/・AM_Master_extracted/)は AM Master の著作物ゆえ 移設しない(repo でも gitignore でローカル限定)。