腾讯云小微方案设计指南¶
开发入门¶
概述¶
本文为我司语音芯片和腾讯云小微对接的开发使用指南，以方便开发人员快速进行项目开发。
开发环境¶
以下是开发过程中需要的软件和硬件：
- IDE开发软件
- 串口升级工具
- 启英离在线开发板
IDE开发软件¶
SDK中所有的应用可以通过IAR IDE开发软件编译以及使用，有关该软件的更多信息请访问: ☞https://www.iar.com/iar-embedded-workbench/， 用户可以自行联系IAR公司或其经销商采购该软件并使用。为避免产生兼容性问题，建议使用以下版本。
串口升级工具¶
我司提供CI110系列芯片所使用的串口升级工具PACK_UPDATE_TOOL.exe，用于烧录及升级固件使用，详细使用请见烧录相关章节。
开发板介绍¶
标准离在线方案开发板为CI-B03GT04S-MT+CI-B03GT03S-MB。若您还没有开发板，请您联系启英泰伦商务获取开发板。
开发板型号：
底板型号：CI-B03GT03S-MB
模块型号：离在线语音模块CI-B03GT04S-MT
开发板使用说明
- 输入电源5V/GND
使用时请接入5V电源(可使用>1A的TYPE-C接口电源进行供电)。
- 模式选择支持升级模式、正常模式
短接PG和EN —> 升级模式：通过本司的串口升级工具，更新Flash 里面的固件。
不进行任何短接 —> 正常模式：不能进行串口升级。如果Flash里固件正确，系统正常启动。
注意：短接SEL和EN或者PG和EN，必须重新上电，才会起作用。如果短接PG和EN后，1s内没有使用串口升级工 具进行升级，系统仍然会正常启动。
- 语音固件CI1103烧录接口(1103_RX0和1103_TX0）
处于升级模式时，TX0、RX0用于串口升级使用，升级完成进入系统后，TX0用于Log输出。
- WIFI固件烧录接口(7698_RX,7698_TX,GND）
处于升级时，7698_RX、7698_TX用于串口升级使用，升级完成进入系统后，7698_TX用于Log输出。
- 麦克风底座
使用时请插入麦克风。
- 喇叭底座
使用时请插入喇叭。
开发流程¶
腾讯云小微平台相关操作¶
如需进行开发，需要在腾讯云小微平台上申请账号，可以联系启英商务支持。如果仅做DEMO，则可不关注此部分。
注册登录腾讯云小微开放平台¶
登录 ☞ 腾讯云小微开放平台，点击右上角 登录，注册一个腾讯云小微开放平台开发者账号。
注意：通过以上步骤注册的账号拥有最高权限。请妥善保存您的账号，避免您创建的硬件产品、App、设备运行或者用户数据受到安全风险。
开发者账号注册后，使用已注册的账号登录 ☞ 腾讯云小微开放平台。可以创建设备产品和云端技能，并进行调试。产品和技能发布，需要通过后台审核。
完成认证：开发者认证账号是指在 ☞ 腾讯云小微开放平台 注册的账号，并且填写企业相关信息后，通过腾讯云小微的认证。
有关开发者认证的具体操作流程，请参见 ☞ 开发者认证流程。
应用创建与技能配置¶
云小微开放平台支持用户根据自身需求创建自定义应用。
- 选择设备开放平台 点击进入。
- 创建应用 点击 设备平台下的 新建应用
- 配置设备系统与应用场景
选择预期接入应用的设备，其中有屏设备包换手机应用、车载设备、电视、手表、有屏机器人、有屏音响等，无屏设备主要包换无屏音响、耳机、微信公众号、无屏机器人等。不同的设备可支持的操作系统也不同，需要根据您的实际情况进行选择。
- 填写应用基本信息
输入应用名称和应用描述并选择页面展示方式。
- 设备应用版本号
填写版本号，格式为x.x.x.x，例如1.0.0.0。版本号生效以后将无法修改。版本号主要用来配合终端版本的更新，也可以用版本号来区分所创建的应用。
- 点击**下一步**,查看创建的应用相关信息，添加应用描述后，再点击**完成**，即完成应用创建与技能配置。
应用配置¶
- 基本信息配置
应用建立后，可以查看和配置信息
- 版本信息配置
开发者可在【应用版本】-【技能配置】中进行技能的修改。如需上线正式环境给外部用户使用，请务必先发布。
-
更多配置请查看 ☞腾讯云小微应用和技能配置。需要配合商务同步进行。
-
厂商APP接入
DMSDK是Device Management SDK的缩写。DMSDK被设备对应的伴生App接入，为伴生App提供账号授权、设备绑定、音乐服务授权、闹钟管理和音色控制等一系列接口，作为伴生App与TVS硬件设备之间的桥梁，让用户能够使用伴生App管理自己的TVS智能设备。 腾讯云小微平台提供了Android和IOS SDK。接入请查看 ☞厂商APP接入说明。
启英泰伦平台相关操作¶
注册登录AI平台¶
登录 ☞ 启英泰伦语音AI平台，若还没有账号，请先点击**还没有账号**进行**注册**，免费获取一个启英泰伦语音AI开发者账号。
注意：使用我司语音AI平台，还需签订**NDA保密协议**及**AI平台使用协议**，若有其他疑问，请联系我司商务人员。通过以上步骤注册的账号拥有最高权限。请妥善保存您的账号，避免您的用户数据受到安全风险。
语音固件下载¶
点击**菜单栏**，选择**开发资料**，下载 CI110X_Combine_Cloud_v170-代码.rar和 CI110X_Combine_Cloud_v170-说明.rar两个压缩文件。 其中CI110X_Combine_Cloud_v170-代码.rar为 CI1103对接WIFI源代码。CI110X_Combine_Cloud_v170-说明.rar为CI1103和WIFI端固件,及说明文档、烧录工具。
注意：使用该固件和代码，仅供体验腾讯云小微效果使用。LICENSE有效期为3个月，可以联系技术支持另行提供。
{： .center}
SDK整体架构介绍¶
| 文件名 | 作用 |
|---|---|
| components | 目录为组件，包括播放器、ASR识别、按键、传感器、FreeRTOS操作系统等 |
| doc | 文档目录 |
| driver | 目录包括CI110系列芯片底层驱动 |
| platform | 目录包括平台相关配置 |
| sample | 目录包括示例工程 |
| startup | 目录包括CI110系列芯片启动代码 |
| system | 目录包括系统相关代码、中断处理程序文件 |
| tools | 工具目录，主要是合并、打包升级工具 |
示例工程介绍¶
示例工程路径：CI110X_FROM_SERVER170\sample\internal\sample_media\
| 工程文件 | 作用 |
|---|---|
| sample_media | 腾讯云小微离在线语音样例工程 |
任务创建及用户层初始化¶
在sample_light_main.c的vTaskCreate函数中创建vTask_voice_deal；vTask_uart_recevie_data;task_uart_send三个task。 vTask_voice_deal为处理语音数据发送。vTask_uart_recevie_data为处理接收到的WIFI端发送的数据。task_uart_send为底层处理UART数据发送。
/* 串口任务 */
misc_varialbes_init();
if(!get_need_start_ota())
{
xTaskCreate(vTask_voice_deal,"vtaskvoice", 512, NULL, 4, &vTask_voice_deal_handle);
}
xTaskCreate(vTask_uart_recevie_data,"vtaskrecv",512,NULL,4,NULL);
xTaskCreate(task_uart_send,"task_uart_send",256,NULL,4,NULL);
离线语音识别处理¶
在system_msg_deal.c的userapp_deal_asr_msg函数中进行语音识别处理。
userapp_deal_asr_msg(asr_rev_data);
Images 相关¶
CI110X_Combine_Cloud_v1.70-说明\固件_CI1103_AW7698_云小微_DEMO_20201224_V400目录下： - 固件_CI1103_CHD_SDK1.7.0_UART_M150_20201224_V400.bin：CI1103固件 - 固件_AW7698_4.12.0_TENCENT_WIFI_DEMO_20201224_V400.zip：MT7698 WIFI固件
DEMO固件烧录方式¶
CI1103固件烧录，请参考CI110X_Combine_Cloud_v1.70-说明\demo_tools 目录下《CI110X 固件加载升级操作方法及注意事项 V1.0.pdf》 WIFI固件烧录，请参考CI110X_Combine_Cloud_v1.70-说明\demo_tools 目录下《MTK7698 下载工具使用说明.pdf》
开发新的应用产品¶
请与启英泰伦商务联系，获取WIFI端SDK源码、相关说明文档及技术支持。
相关链接¶
更多SDK基础介绍，请访问 ☞CI110系列芯片SDK。
想了解腾讯云小微，请访问 ☞腾讯云小微介绍 。