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,选择路径,完成创建
    img

4.2. 创建示例工程

工程创建有下面两种方法

  • 在线工程向导
    右键点击工作空间,选择Create New IoT Project... img
    根据向导选择SC5654芯片->CB5654开发板->smart_speaker_demo,CDK自动下载并创建所选例程。
  • 下载工程离线包
    芯片开放社区首页->创芯空间->开发板->选择CB5654开发板->产品图谱->smart_speaker例程->资源下载
    下载的zip解压到非中文路径中,双击project.cdkproj打开工程。

4.3. 编译及烧录

  • 点击工具栏的compile 开始编译
  • 镜像编译完成后,点击工具栏的download 进行镜像烧录

5. 例程运行

5.1. 接线

  • 使用MicroUsb线连接电脑和开发板的usb调试串口
  • 使用MicroUsb线连接电脑和开发板的JTAG进行JTAG调试
  • 音箱及MIC连接如图所示(天线可用内置的)

连接提示图 img

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. 进入调试

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

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

6.4. 调试选项

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

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

results matching ""

    No results matching ""