Skip to content

Commit 6b60683

Browse files
committed
edit README.md & firmware
1 parent 066325c commit 6b60683

File tree

4 files changed

+102
-0
lines changed

4 files changed

+102
-0
lines changed

README.md

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
# QuecPython 基于小智平台 的 AI 聊天机器人
2+
3+
## 目录
4+
5+
- [介绍](#介绍)
6+
- [功能特性](#功能特性)
7+
- [快速开始](#快速开始)
8+
- [先决条件](#先决条件)
9+
- [安装](#安装)
10+
- [运行应用程序](#运行应用程序)
11+
- [目录结构](#目录结构)
12+
- [贡献](#贡献)
13+
- [许可证](#许可证)
14+
- [支持](#支持)
15+
16+
## 介绍
17+
18+
QuecPython 推出了小智平台 AI 聊天机器人解决方案。该方案基于 websocket 协议,具有跨平台特性,可以适用于大部分 QuecPython 模组。
19+
20+
本案例采用搭载 EC800MCNLE 模组的 AI 开发板。
21+
22+
## 功能特性
23+
24+
- 支持按键语音中断/打断。
25+
- 支持按键语音唤醒。
26+
- 使用 Python 语言,便于二次开发。
27+
28+
## 快速开始
29+
30+
### 先决条件
31+
32+
在开始之前,请确保您具备以下先决条件:
33+
34+
- **硬件:**
35+
- 联系移远官方获取 AI 开发板及配件。
36+
- 电脑(Windows 7、Windows 10 或 Windows 11)
37+
- 喇叭
38+
- 任意 2-5W 功率的喇叭即可
39+
- [移远商城购买链接](https://www.quecmall.com/goods-detail/2c90800c94028da201948249e9f4012d)
40+
41+
- **软件:**
42+
- 调试工具 [QPYcom](https://images.quectel.com/python/2022/12/QPYcom_V3.6.0.zip)
43+
- QuecPython 固件(仓库 fw 目录下有 beta 固件)
44+
- Python 文本编辑器(例如,[VSCode](https://code.visualstudio.com/)[Pycharm](https://www.jetbrains.com/pycharm/download/)
45+
46+
### 安装
47+
48+
1. **克隆仓库**
49+
```bash
50+
git clone https://github.com/QuecPython/solution-xiaozhiAI.git
51+
cd solution-xiaozhiAI
52+
```
53+
54+
3. **烧录固件:**
55+
按照[说明](https://python.quectel.com/doc/Application_guide/zh/dev-tools/QPYcom/qpycom-dw.html#%E4%B8%8B%E8%BD%BD%E5%9B%BA%E4%BB%B6)将固件烧录到开发板上。
56+
57+
### 运行应用程序
58+
59+
1. **连接硬件:**
60+
本案例采用移远 AI 开发板,如有需要请联系官方获取。按照下图进行硬件连接:
61+
62+
<img src="./media/20250425131903.jpg" style="zoom:80%;" />
63+
64+
1. 连接喇叭
65+
2. 连接天线
66+
3. 接入电池
67+
4. 通过 Tpye-C 连接上位机
68+
69+
2. **将代码下载到设备:**
70+
- 启动 QPYcom 调试工具。
71+
- 将数据线连接到计算机。
72+
- 按下开发板上的 **PWRKEY** 按钮启动设备。
73+
- 按照[说明](https://python.quectel.com/doc/Application_guide/zh/dev-tools/QPYcom/qpycom-dw.html#%E4%B8%8B%E8%BD%BD%E8%84%9A%E6%9C%AC)`code` 文件夹中的所有文件导入到模块的文件系统中,保留目录结构。
74+
75+
3. **运行应用程序:**
76+
- 选择 `File` 选项卡。
77+
- 选择 `_main.py` 脚本。
78+
- 右键单击并选择 `Run` 或使用`运行`快捷按钮执行脚本。
79+
80+
4. **按下主按键后,即可对话, 参考运行日志:**
81+
82+
![](./media/20250425132727.png)
83+
84+
5. 参考宣发视频:`media/example_video.mp4`
85+
86+
## 贡献
87+
88+
我们欢迎对本项目的改进做出贡献!请按照以下步骤进行贡献:
89+
90+
1. Fork 此仓库。
91+
2. 创建一个新分支(`git checkout -b feature/your-feature`)。
92+
3. 提交您的更改(`git commit -m 'Add your feature'`)。
93+
4. 推送到分支(`git push origin feature/your-feature`)。
94+
5. 打开一个 Pull Request。
95+
96+
## 许可证
97+
98+
本项目使用 Apache 许可证。详细信息请参阅 [LICENSE](LICENSE) 文件。
99+
100+
## 支持
101+
102+
如果您有任何问题或需要支持,请参阅 [QuecPython 文档](https://python.quectel.com/doc) 或在本仓库中打开一个 issue。

media/20250425131903.jpg

189 KB
Loading

media/20250425132727.png

375 KB
Loading

media/example_video.mp4

9.54 MB
Binary file not shown.

0 commit comments

Comments
 (0)