Update documentation (An MCP-based Chatbot)

This commit is contained in:
Xiaoxia
2025-06-04 04:17:49 +08:00
parent 336eff728d
commit 16ec95f6d5
25 changed files with 484 additions and 267 deletions

View File

@ -388,9 +388,9 @@ choice IOT_PROTOCOL
help
IoT 协议,用于获取设备状态与发送控制指令
config IOT_PROTOCOL_MCP
bool "MCP协议 2024-11-05"
bool "MCP 2024-11-05"
config IOT_PROTOCOL_XIAOZHI
bool "小智IoT协议 1.0"
bool "Xiaozhi IoT 1.0 (Deprecated)"
endchoice
endmenu

View File

@ -111,7 +111,7 @@ mkdir main/boards/my-custom-board
一个基本的开发板类定义包含以下几个部分:
1. **类定义**:继承自`WifiBoard``ML307Board`
1. **类定义**:继承自`WifiBoard``Ml307Board`
2. **初始化函数**包括I2C、显示屏、按钮、IoT等组件的初始化
3. **虚函数重写**:如`GetAudioCodec()``GetDisplay()``GetBacklight()`
4. **注册开发板**:使用`DECLARE_BOARD`宏注册开发板
@ -301,20 +301,21 @@ DECLARE_BOARD(MyCustomBoard);
- AXP2101
- 其他可用的PMIC
### 4. IoT设备
### 4. MCP设备控制
可以添加各种IoT设备让AI能够"看到"和控制:
- Speaker (扬声器)
- Screen (屏幕)
- Battery (电池)
- Light (灯光)
可以添加各种MCP工具让AI能够使用:
- Speaker (扬声器控制)
- Screen (屏幕亮度调节)
- Battery (电池电量读取)
- Light (灯光控制)
- 等...
## 开发板类继承关系
- `Board` - 基础板级类
- `WifiBoard` - WiFi连接的开发板
- `ML307Board` - 使用4G模块的开发板
- `WifiBoard` - Wi-Fi连接的开发板
- `Ml307Board` - 使用4G模块的开发板
- `DualNetworkBoard` - 支持Wi-Fi与4G网络切换的开发板
## 开发技巧
@ -327,7 +328,7 @@ DECLARE_BOARD(MyCustomBoard);
1. **显示屏不正常**检查SPI配置、镜像设置和颜色反转设置
2. **音频无输出**检查I2S配置、PA使能引脚和编解码器地址
3. **无法连接网络**检查WiFi凭据和网络配置
3. **无法连接网络**检查Wi-Fi凭据和网络配置
4. **无法与服务器通信**检查MQTT或WebSocket配置
## 参考资料

View File

@ -1,5 +1,7 @@
# 物联网控制模块
> ⚠️ **注意:本模块已不推荐使用。请使用"MCP协议"来实现物联网控制,获得更好的兼容性与功能支持。**
本模块实现了小智AI语音聊天机器人的物联网控制功能使用户可以通过语音指令控制接入到ESP32开发板的各种物联网设备。
## 工作原理

View File

@ -60,6 +60,7 @@ Http* Ota::SetupHttp() {
if (has_serial_number_) {
http->SetHeader("Serial-Number", serial_number_.c_str());
}
http->SetHeader("User-Agent", std::string(BOARD_NAME "/") + app_desc->version);
http->SetHeader("Accept-Language", Lang::CODE);
http->SetHeader("Content-Type", "application/json");