CB5654 快速上手手册

本文介绍如何使用CB5654开发板，实现智能音箱的功能。通过本文的指引，开发者可以学会开发环境的搭建、应用工程的编译与镜像烧录、基本调试方法，掌握YoC SDK的应用程序的开发方法，快速形成产品方案。

CB5654开发板资源如下图所示：

JP9引脚说明，由左至右，靠近SD卡的位1脚

3.1. 开发工具

登录occ.t-head.cn芯片开放社区，进入栏目"开发中心->开发工具"，下载最新版本的CDK集成开发环境安装包，根据CDK安装向导提示安装。

3.2. 驱动安装

在芯片开放社区首页->技术部落->目录->工具中下载CP210x USB to UART驱动，CP210x_Universal_Windows_Driver.zip解压，执行安装程序。

通过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.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
...

6.1. 常用工具栏和快捷键

功能说明

6.2. 调试脚本

调试脚本路径为script/gdbinit，进入调试模式前会先执行脚本命令，示例说明如下：

#设置异常断点
b trap

6.3. 进入调试

编译、烧写完成后，复位开发板开始执行，点击进入调试模式，并再当前运行位置停止。再点击，开始执行。

断点、单步执行、查看变量等基本调试功能可参考CDK自带的帮助文档。

6.4. 调试选项

工程默认优化配置为-Os（最佳Code Size优化），会影响单步调试代码定位的准确性及部分变量的查看，可修改工程编译选项，Optimization选项调整为-Og(在保证调试代码定位准确性的前提下进行Code Size的优化)。

CDK更多使用方法详见CDK Help说明。