CB5654 快速上手手册
1. 概述
本文介绍如何使用CB5654开发板,实现智能音箱的功能。通过本文的指引,开发者可以学会开发环境的搭建、应用工程的编译与镜像烧录、基本调试方法,掌握YoC SDK的应用程序的开发方法,快速形成产品方案。
2. 开发板介绍
CB5654开发板资源如下图所示:
JP9引脚说明,由左至右,靠近SD卡的位1脚
JP引脚号 | 芯片引脚号 | 引脚名称 | 说明 |
---|---|---|---|
1 | VCC33 | - | - |
2 | 62 | PB4 | PCW_SCLK |
3 | 61 | PB5 | PCW_WS |
4 | 60 | PB6 | PCW_SDI |
5 | 59 | PA7 | PCW_SDO |
6 | - | GND | - |
7 | 53 | PA2 | ADIN2 |
8 | 7 | PC13 | I2C_SDA |
9 | 6 | PC12 | I2C_SCL |
10 | - | GND | - |
11 | 40 | PD8 | RXD3 |
12 | 41 | PD7 | TXD3 |
13 | 45 | PD1 | GPIO2_1/TDI |
14 | 46 | PD0 | GPIO2_0/TCK |
15 | 42 | PD4 | GPIO2_4/TRST |
16 | - | GND | - |
3. 开发环境搭建
3.1. 开发工具
登录occ.t-head.cn芯片开放社区,进入栏目"开发中心->开发工具",下载最新版本的CDK集成开发环境安装包,根据CDK安装向导提示安装。
3.2. 驱动安装
在芯片开放社区首页->技术部落->目录->工具中下载CP210x USB to UART驱动,CP210x_Universal_Windows_Driver.zip解压,执行安装程序。
4. 应用开发
通过CDK工具,可便捷地实现应用方案的编译、烧录和调试。
4.1. 创建工作空间
工作空间可以管理多个工程,方便多个工程切换开发
- 运行CDK,点击菜单Project->New Multi-Project Workspace...
- 输入Workspace Name,选择路径,完成创建
4.2. 创建示例工程
工程创建有下面两种方法
- 在线工程向导
右键点击工作空间
,选择Create New IoT Project...
根据向导选择SC5654芯片->CB5654开发板->smart_speaker_demo,CDK自动下载并创建所选例程。 - 下载工程离线包
芯片开放社区首页->创芯空间->开发板->选择CB5654开发板->产品图谱->smart_speaker例程->资源下载
下载的zip解压到非中文路径中,双击project.cdkproj打开工程。
4.3. 编译及烧录
- 点击工具栏的 开始编译
- 镜像编译完成后,点击工具栏的 进行镜像烧录
5. 例程运行
5.1. 接线
- 使用MicroUsb线连接电脑和开发板的usb调试串口
- 使用MicroUsb线连接电脑和开发板的JTAG进行JTAG调试
- 音箱及MIC连接如图所示(天线可用内置的)
连接提示图
5.2. 设置 WiFi 参数
- 连接串口调试工具,配置为 115200 波特率, 8 数据位,None 校验位,1 停止位,None流控
- 按开发板上的 RESET 按键,reset 开发板
- 等待 串口打印输出。
- 串口中输入 kv 指令设置 wifi参数(ssid, password)
- kv 为 YoC 的 key-value 文件系统,通过 key value 配对的方式 存储
kv set wifi_ssid {ssid}
kv set wifi_psk {password}
- 其中 {ssid} 为 wifi 名字,{password} 为 wifi 密码
- 可以通过
kv get wifi_ssid/wifi_psk
来验证 是否设置正确 - 如果是没有密码的路由器,密码随意填写
- 重新上电开发板
- 等待语音提示
正在启动
,网络连接成功
,并可以观察串口打印输出 wifi 连接成功[ 7.801532][I][netmgr ]start dhcp [ 7.855701][I][netmgr ]IP: 192.168.1.103
5.3. 云服务注册
- 访问www.xfyun.cn,进行实名注册
进入控制台,创建新应用
应用分类选择,例如:智能硬件-机器人-陪伴机器人
申请购买实时语音转写
点击创建的新应用,左侧
语音识别
栏目选择实时语音转写
,点击申请购买
选择套餐,进入购买页面购买说明
选择创建的新应用,确认是
实时转写
包,确认下单。 下单后,重新进入应用界面,会显示剩余时长和过期时间, 界面右边服务认证信息
APPID和APIKEY,后续流程需要使用。关闭IP白名单
点击界面右上角
工单
->提交工单
,工单内容示例如下,审批成功后会短信通知。| 项目 | 内容 | | -------- | ------------------------------------------------------------ | | 标题 | 关闭实时语音转写白名单 | | 问题类型 | 故障与bug | | APPID | 填写服务认证信息中的APPID | | 服务类型 | 其他 | | 问题描述 | 我们的产品在接入实时语音转写webapi时,ip不是固定的,需要将白名单给关闭 |
配置认证信息到设备
用认证信息,组合出如下命令,在设备的串口调试终端中输入,
kv set xf_rasr_appid 5be25...
kv set xf_rasr_apikey 332d2ae4ccc0f70eb271d58a2a605...
5.4. 常用语音命令
交互示例
唤醒,”你好芯宝”,回答在后,再开始说控制命令。
人:你好芯宝
机:在
人:来首歌
语音控制命令
类别 | 示例 |
---|---|
点歌 | 来首歌、来首张学友的歌、播放邓紫棋的泡沫 |
播放控制 | 声音大点、降低音量、停止播放、继续播放 |
其他 | 讲个笑话、杭州的天气、明天的天气、现在几点 |
命令行调试
在串口中输入命令可以调试相关内容 注意:所有命令都需要以换行 \n
结尾
- 输入
help
查看所有支持命令
> help
help : show commands
ping : ping command.
ifconfig : network config
date : date command.
ps : show tasks
free : show memory info
sys : sys comand
...
功能 | 命令示例 | 说明 |
---|---|---|
播放SD卡文件 | ai music file:///fatfs0/1.mp3 |
file:// 协议开头, /fatfs0 SD卡挂载目录, 1.mp3 SD卡中的文件 |
播放网络文件 | ai music http://url/1.mp3 |
|
文字交互 | ai talk “来首歌” |
|
播放提示音 | ai notify 1 |
后面的数字0~7,播放程序集成的提示音 |
音量控制 | ai vol + ai vol - ai vol 40 |
6. 开发工具更多使用说明
6.1. 常用工具栏和快捷键
功能说明
6.2. 调试脚本
调试脚本路径为script/gdbinit,进入调试模式前会先执行脚本命令,示例说明如下:
#设置异常断点
b trap
6.3. 进入调试
编译、烧写完成后,复位开发板开始执行,点击进入调试模式,并再当前运行位置停止。再点击,开始执行。
断点、单步执行、查看变量等基本调试功能可参考CDK自带的帮助文档。
6.4. 调试选项
工程默认优化配置为-Os(最佳Code Size优化),会影响单步调试代码定位的准确性及部分变量的查看,可修改工程编译选项,Optimization选项调整为-Og(在保证调试代码定位准确性的前提下进行Code Size的优化)。
CDK更多使用方法详见CDK Help说明。