開発ドキュメント

小智ファームウェアの改造、拡張、コントリビュートに必要な資料：ESP-IDF 環境構築、ソース構造から WebSocket / MQTT+UDP / MCP プロトコル、各機能モジュールの実装まで。

開発環境

ESP-IDF 環境構築
ツールチェーンのインストール、依存関係と初回ビルド
コードスタイルガイド
clang-format、C++23 ベースラインとエラー処理規約

ソースとアーキテクチャ

ファームウェアコードガイド
ディレクトリ構造、ステートマシンと開発ルール
拡張ポイント
ネットワーク形態、ウェイクワード、MCP とリソースのカスタマイズ

通信プロトコル

WebSocket プロトコル
接続確立、hello ハンドシェイクとメッセージ型
Web クライアントによるデバッグ
open-xiaozhi-client：接続・フレームログ・手動 JSON・MCP
MQTT + UDP ハイブリッド
制御チャネルとオーディオチャネルの分離
MCP プロトコル
デバイスツール呼び出し：仕様と使用ガイド

機能実装

BluFi 設定
BLE で Wi-Fi を設定
絵文字エモーション
emotion メッセージと表情切替プロトコル
Glyph Push 拡張
サーバーがデバイスフォントにないグリフを配信
非同期音声通知
notify メッセージと Ogg Opus ストリーミング再生

カスタマイズ

カスタムボードガイド
ボードディレクトリの追加とビルド
カスタム Assets
ウェイクワード、フォント、絵文字とチャット背景のパッケージ化