# XR872开发套件使用指南
# XR872开发套件构成
# 硬件构成
开发套件主要的组成部分见图示，其主要按钮/部件的功能描述如下：
数码管显示器：时间显示、状态通知；
XR872核心板：核心处理器，运行算法；
usb电源指示灯：供电状态显示；
电源开关：控制电源开关；
指示灯：监听WIFI变化、闹钟提醒等；
配网按键：短按打断当前交互状态；长按4s进入声波配网模式，再长按4s进入微信配网模式；
喇叭：音频播放输出。
# 软件构成
软件上功能包含语音唤醒+iFLYOS云端操作系统+离线命令词。
语音唤醒：该套件前端集成了科大讯飞单麦降噪唤醒引擎，通过新一代神经网络降噪、去混响及 AGC 算法对拾取音频进行处理，实现普通环境下 3 米远场语音唤醒成功率 90%以上，近场语音唤醒成功率 95%以上，唤醒响应时间在毫秒级。根据您的需求，我们也提供唤醒词定制、唤醒词深度训练和整机声学测试评估服务，协助您将产品唤醒成功率调优，直到实用、好用水平，共同打造行业标杆产品。
iFLYOS云端操作系统：除了前端的唤醒，套件也集成打通了 iFLYOS 云端操作系统。iFLYOS全链路聚合了语音识别、语义理解、内容（信源）平台、语音合成等能力。
离线命令词：除了iFLYOS 丰富的云端技能和强大的在线处理能力，为解决设备在网络比较差时体验可能会不流畅的问题，我们提供了离线命令词定制服务。当前可以支持 20 个以内的离线命令词定制。设备无论是处于休眠状态还是工作状态，均可以通过语音命中命令词，用户通过 SDK 接口获取命令词标识便可以控制设备，设备与上位机等通信可通过串口实现。
# 参数说明
系统：FreeRtos
智能语音平台：iFLYOS
麦克风阵列： 单麦
芯片：XR872
处理器：Cortex-M4F 384MHz
通信接口：UART/I2C/GPIO
内存：SRAM 416KB
闪存：外挂8MB
WIFI：802.11b/g/n 2.4GHz
供电：4.5V~5.5V，1.5A
功放：3W
# XR872开发套件应用场景
用XR872开发套件可以完成以下内容：
1.在平台上开发语音技能，并将技能绑定到开发套件中体验测试；
2.将开发套件当成主控设备，控制家电；
3.接入了iFLYOS丰富的内容资源和内置技能；
XR872开发套件可应用于儿童玩具、智能台灯、智能闹钟、智能垃圾桶、智能插座、智能交通、智能家电、智能安防、工业自动化等场景的语音控制。
# 体验开发套件的功能
我们收到开发套件后，可以先进行功能体验，体验完成后可对开发套件进行二次定制开发。
那么我们一起来体验一下开发套件的功能吧。
STEP1：套件配网
微信关注公众号：深圳市金源德实业有限公司；也可以直接扫码关注。
开发套件通电开机，开机启动成功后，长按配网键 4S 直至设备提示“进入微信配网”或“声波配网” 模式；
按照配网引导进行配网操作；
设备端语音提示“配网成功”，配网完成；
STEP2：功能体验
对开发套件默认唤醒词“小薇小薇”，开发套件会做出应答；
可以对开发套件说出你想说的话：
比如说“给我讲个故事”、"设置一个8点的闹钟"或者可以与之闲聊。
# 开发套件的二次开发
在体验完开发套件后，就可以着手进行二次开发了。在正式开发之前，可以先下载以下资料，包含产品白皮书、DEMO示例源码和开发手册，或许这些可以帮助你更快完成开发。
XR872开发套件白皮书见：https://cdn.iflyos.cn/docs/xr872/whitepaper.pdf
XR872开发套件SDK开发手册见：https://cdn.iflyos.cn/docs/xr872/development_manual.pdf
XR872开发套件SDK开发环境cygwin64：https://cdn.iflyos.cn/docs/xr872/cygwin64.rar
XR872开发套件串口工具及驱动：https://cdn.iflyos.cn/docs/xr872/tool_driver.zip
XR872开发套件的DEMO示例源码：https://cdn.iflyos.cn/docs/xr872/sdk.zip
# 开发步骤
完成开发套件的二次开发一般需要以下几步：
1.开发技能->2.设备接入->3.SDK开发->4.修改clientid->5.套件配网->6.功能体验。
STEP1.开发技能：
可以点击了解：技能开发文档 (opens new window)
STEP2.设备接入：
可以点击了解：设备接入开发文档 (opens new window)
STEP3.SDK开发：
SDK开发：https://cdn.iflyos.cn/docs/xr872/development_manual.pdf
STEP4.修改clientid：
见STEP3的开发手册，有详细的介绍。
STEP5.套件配网：
见上章节中配网方式，如果之前已经配网成功，此处可直接忽略。
STEP6.功能体验：
以上步骤完成后，可对套件实现的功能进行语音交互控制体验。
# 个性化定制你的开发套件
在套件的二次开发过程中，常常需要更换我们自己的设备clientid、唤醒词、离线命令词等信息。
更换clientid以便将我们开发的技能等绑定到我们的开发套件中；
更换唤醒词，定义我们自己的品牌唤醒词；
离线命令词，需要结合我们实际的应用场景去定义，当前支持20个词以内。
# 更换clientID
在SDK开发手册中有介绍相关的更换方法，更换成功后即可关联平台上的设备配置，体验自定义的语音技能。
# 获取唤醒词、命令词资源
在XR872开发套件中，开发套件默认的只有一个唤醒词“小薇小薇”，不含离线命令词。
如果需要修改唤醒词，增加离线命令词，需要联系技术支持为您打包资源，收到资源后，根据SDK开发手册中的方法进行替换。
获取资源方式:
1.通过 http://support.iflyos.cn/hc/ 提交工单；
2.技术支持邮箱：aiui_support@iflytek.com；
需要将您的唤醒词和命令词列出，命令词不超过20个词。
另外，我们提供唤醒词深定制服务，对远距离和噪音场景的唤醒率提升明显，如果有定制需求请联系商务：黄光辉18110901149。
# 如何获取更多帮助？
开发过程中遇到接入问题，可以通过 http://support.iflyos.cn/hc/ 反馈给我们，我们会在12小时内响应回复，也可以通过邮件联系我们:aiui_support@iflytek.com。如果对文档或者代码实现等有想法和建议，也欢迎通过以上方式反馈你的宝贵建议。