MZ-AI03
AI离线语音模块
产品说明书
目录
1、产品信息概述
1.1 功能描述
1.2 硬件说明
1.3 软件说明
1.4 使用前准备
2、产品调试
3、开发平台操作教程
3.1 软件说明
3.2 注册账号
3.3通信串口确认
3.4设备确认
3.5下载代码
4、代码教程
4.1 系统初始化设置
4.2 如何打开附送Demo
4.3 基础对话教程
4.4 控制单路继电器教程
4.5 控制两路继电器教程
4.6 RS485通信教程
4.7 串口命令接收教程
4.8 综合测试教程
4.9 Type-C串口使用教程
4.10 无唤醒词教程
1、产品信息概述
1.1 功能描述
本识别模块集成了麦克风和扬声器，无需外接麦克风和喇叭扬声器，可唤醒后进行离线语音识别，当识别到的语音内容与原先设置的内容一致时进行语音回应，或RS485通信输出，或继电器开关量输出，语音识别距离最高可达百米，最佳识别距离为小于15米。本识别模块可应用于RS485通信设备的控制，电气设备的控制，家电的控制，PLC通信控制，儿童玩具等。
1.2 硬件说明
Type-C接口代码下载：连接电脑，利用串口进行代码下载；
麦克风：语音接收，距离15米之内最佳，空旷房间100米可正常使用；
扬声器：语音播放输出；
RS485通信：RS485通信接口；
两路继电器开关量输出：继电器开关量输出；
电源：
交流AC220V版本：(注意安全)连接市电AC220V，请关电操作。
直流版本：直流DC9V至DC30V电源均可
连线参考：
外接电源AC220V；
继电器外接的灯也可以其他用电设备，电源AC110V/AC220V或不大于直流DC30V，电流不超过5A.
1.3 软件说明
提供的资料包如下：
说明书：产品使用说明
软件安装：软件开发平台（即开发环境）
参考代码：参考代码Demo例程
1.4 使用前准备
A安装USB驱动：
在资料包的02-软件安装文件夹中找到“USB_驱动_CH341SER.rar”，解压后进行安装。
B安装开发环境：
在资料包的02-软件安装文件夹中找到“开发环境_twenBlock.zip”，解压后进行安装。软件也可以在官方网直接下载.
2、产品调试
把附件USB线一端连接盒子，一端连接电脑：
A 设备通电后，扬声器会播放：欢迎使用语音助手，用小白小白唤醒我
B 盒子唤醒：对着盒子说：小白小白，盒子答复：我在呢。这表示唤醒成功，可进行对话。
C 唤醒之后的对话测试如下：
提问：打开所有灯
回答：所有灯已打开
提问：关闭所有灯
回答：所有灯已关闭
3、开发平台操作教程
3.1 软件说明
安装好软件后打开，初始界面如下，如果提示需要更新软件则下载最新版本安装即可。
3.2 注册账号
点击左上角小房子，点击登录，注册一个账号
3.3通信串口确认
完成注册后登录，插上设备后，把鼠标放在下图红色框框的位置，会弹出下拉，选择“COM-CH340K”,COM后面的数字每个电脑不一样，可以在“我的电脑”-“管理”-“设备管理器”中查看：
3.4设备确认
点击“设备XXXXX”选择ASRPRO
3.5下载代码
点击右上角的“生成模型”，特别是自己有修改代码之后，一定要点“生成模型”，一次需要1-3分钟的间隔，注意好把握时间：
点击右上角的“2M编译下载”：
烧录完成后自动关闭烧录窗口，烧录完成。
4、代码教程
4.1 系统初始化设置
4、代码教程
4.1 系统初始化设置
图26 初始化设置
语音播报人：点击下拉箭头，可以选择各个播报的声音
语音合成音量：文字合成的音量大小，建议10
语速：语音播报的速度，建议10
上电播报语音：通电后播放的语音，鼠标点击即可修改，不需要上电播报的删除留空白即可
退出播报语音：断电后播放的语音，鼠标点击即可修改，不需要上电播报的删除留空白即可
设置播报音量：设备对话时候播报的音量大小
唤醒：可以选择唤醒词或永远唤醒，唤醒词唤醒需要通过唤醒词唤醒后才能对话，永远唤醒则一上电即可进行对话.
PA_0 ~ PC_4各个引脚的设置：
A: PA5和PA6控制继电器1和继电器2，输出低电平继电器不导通，输出高电平继电器导通。
B:串口1对应RS485通信。
C:串口0对应的是Type-C口，即USB转串口。
备注：语音模块关于引脚，只需要设置PA5、PA6、串口0、串口1即可。
4.2 如何打开附送Demo
把鼠标放在平台左上角的“项目”，点击“打开项目”
图27打开项目
在资料包的“03-参考代码”中选择参考的Demo：
图28资料包中的03-参考代码
列举了6个参考代码，打开任意即可。
图29提供的参考例子
4.3 基础对话教程
打开资料包中03-参考代码中的“0-基础对话”代码，打开后如下：
图30 0-基础对话
上电初始化设置如下：
图31初始化设置
此例子只要实现跟盒子的基本对话，没有其他功能，关于引脚和串口也无需设置，引脚和串口在后面我们再说明。盒子上电即播报“你好，我是您的智能语音助手，请用你好小白唤醒我”，对话采用唤醒词唤醒，且维持唤醒状态15秒，15秒内没有接收到唤醒词则退出唤醒状态，退出时播报“我休息了，用你好小白唤醒我”。
唤醒下的对话如下：
图32唤醒后的对话
第一句当语音唤醒“你好小白”时，引脚无动作，串口无动作，语音回复“我在呢”。也就是盒子在听到“你好小白”时进入唤醒状态，且回复“我在呢”，然后就可以等待接收下面对话内容。可以看到第一行下面有个小箭头：
图33小箭头凸起
也就是先完成前提条件，后面才可以执行对话，如果没有用“你好小白”唤醒盒子即没有完成前提条件，那你直接跟盒子说如“今天天气”、“你几岁了”、“你会做什么”、“给我讲个笑话吧”这些都无法识别，盒子没有反应。可执行的各个语音识别无先后优先级划分，当唤醒后，各个语音识别都是同个优先级无所谓的前置条件。
图34前提条件和可执行内容
如果唤醒了盒子即完成前提条件“你好小白”，则下面的对话盒子会回复相关内容。
图35对话回复
如果想要增加对话的内容，点击一下随意一条“当语音识别”，然后鼠标右键点击复制
图36复制内容
会出现复制的内容：
图37复制的内容
用鼠标左键按住拖动，放在“当语音唤醒”这个前提条件下面就行，任意位置都可以，各个“当语音识别”均无优先级，如下图两个位置，效果是一样的。
图38鼠标左键按住拖动
放置好之后，鼠标点击一下识别内容，写上自己想要的对话内容。如果不需要语音回复，则在“语音回复”后面不要输入内容留空白即可，那么就没有语音回复。
图39点击修改内容
如增加对话“今天星期几”，回复“今天星期一”：
图40点击修改内容
以上操作，也可以利用系统工具添加内容，点击左边的“配置模式”：
图41点击配置模式
此时会出现可以添加的内容：
图42配置模式的可添加内容
添加哪个模块则鼠标点击对应模块即可，这里我们点击“当语音识别”，其他的我们后续再说明，鼠标点击：
图43鼠标左键单击
此时看到会添加此模块：
图44 新添加的模块
鼠标左键拖动此新添加的模块，放置任意位置连接起来：
图45连接好新的模块
再修改一下对话内容，这样我们就添加新的识别对话完成。
图46修改对话内容
如果想要添加多个唤醒词，最多5个唤醒词，则同样添加“当语音唤醒”，也可以在原来内容上复制，如下：
图47新添加唤醒词最多5个
添加唤醒词需要放置在语音识别模块的前面：
图48放置唤醒词于语音识别前面
各个唤醒词无先后优先级，如下图5个唤醒词说任意一个都可以，无优先级：
图49唤醒词无优先级
修改或添加新功能后，记得要保存，鼠标放在“项目”上，点击“本地保存”即可。
图50本地保存下次可打开
4.4 控制单路继电器教程
PA5控制继电器1，高电平打开继电器，低电平关闭继电器，对应Y1 C1
PA6控制继电器2，高电平打开继电器，低电平关闭继电器，对应Y2 C2
打开资料包中的“03-参考代码”中选择参考的“控制单路继电器”：
图51控制单路继电器例子
这里以控制继电器1进行说明，PA5引脚必须设置为输出且低电平，即上电不开启继电器，如果看不到PA5引脚，点击下拉箭头选择PA5即可，如下图：
图52PA5设置输出低电平
在对话内容，先用“你好小白”唤醒盒子，在对其说“打开第一个继电器”或“关闭第一个继电器”，就会执行下图绿色方框中引脚的动作，同时回复“已经打开第一个继电器”或“已经关闭第一个继电器”：
图53执行内容
执行动作点击下拉箭头均可修改，这里控制继电器，所以必须PA5输出高电平或低电平。
图54修改内容(这里控制继电器，无须修改)
当用“你好小白”唤醒后，说“打开第一个继电器”盒子回复：“已经打开第一个继电器”，说明继电器已经打开
此时第一路继电器开启，继电器相当于一个开关，开启继电器相当于闭合开关:
图56 继电器等效电路
4.5 控制两路继电器教程
PA5控制继电器1，高电平打开继电器，低电平关闭继电器。
PA6控制继电器2，高电平打开继电器，低电平关闭继电器。
打开资料包中的“03-参考代码”中选择参考的“控制两路继电器”：
图58控制两路继电器例子
PA6和PA5引脚同时必须设置为输出且低电平，即上电不开启继电器，如果看不到引脚，点击下拉箭头选择PA5和PA6即可，如下图：
图59 PA5和PA6设置输出低电平
在对话内容，先用“你好小白”唤醒盒子，再对其说“打开第一个继电器”或“关闭第一个继电器”，“打开第二个继电器”或“关闭第二个继电器”，就会执行下图黄色方框中引脚的动作，同时回复绿色方框对应的内容如“已经打开第一个继电器”或“已经关闭第一个继电器”：
图60执行内容
在同时控制两个继电器时，“当语音识别”里的内容要一样，如下图红色和绿色方框，同时对应的控制动作也要一样，如黄色方框，这样就可以同时开启两个继电器或者关闭：
图61同时控制继电器
继电器相当于一个开关，开启继电器相当于闭合开关，关闭继电器相当于断开开关，等效如下图：
图62两路继电器等效图
当用“你好小白”唤醒后，
说“打开第一个继电器”盒子回复：“已经打开第一个继电器”，说明第一个继电器已经打开；
说“打开第二个继电器”盒子回复：“已经打开第二个继电器”，说明第二个继电器已经打开；
同时也可以说“打开所有继电器”和“关闭所有继电器”：
4.6 RS485通信教程
RS485通信使用到模块的串口1。
4.6.1 输出字符串
打开资料包中的“03-参考代码”中选择参考的“串口输出字符串”：
图64串口输出字符串例子
初始化如下，串口1波特率设置为9600，点击下拉可以修改，后面使用PA2 PA3引脚：
图65串口初始化
下面是对话的内容，在“当语音识别”中，如下图红色方框，串口下拉选择“1”，后面选择“输出字符串”，紧接输入字符串内容如下图“HelloWorld!”“Turn on”“Turn off”：
图66串口对话内容
当用“你好小白”唤醒后，RS485输出字符串“HelloWorld!”,语音回复“我在呢”;
唤醒后说“打开第一个继电器”，RS485