CB6502M快速上手手册
1. 概述
本文介绍如何使用CB6502M开发板进行ADC电压值采集的功能演示。通过本文的指引，开发者可以学会开发环境的搭建、应用工程的编译与镜像烧录、基本调试方法，快速上手CB6502M的开发。
2. 开发板介绍
CB6502M开发板全貌如下图所示，资源介绍请参见CB6502M开发板用户手册。
3. 开发环境搭建
3.1. 开发工具
登录occ.t-head.cn芯片开放社区，进入栏目"开发中心->集成开发环境"，下载最新版本的CDK集成开发环境安装包，根据CDK安装向导提示安装。
3.2. 驱动安装
应用开发依赖USB转串口驱动(PL2303-Prolific-Driver)和调试器驱动。用户可检查PC的设备管理器，确认驱动是否已安装。如果未安装，可下载相关驱动后直接安装。安装成功后的设备管理器如下图所示：
4. 应用开发
通过CDK工具，可便捷地实现应用方案的编译、烧录和调试。
4.1. 创建工作空间
工作空间可以管理多个工程，方便多个工程切换开发
- 运行CDK，点击菜单Project->New Multi-Project Workspace...
- 输入Workspace Name，选择路径,完成创建
4.2. 创建示例工程
工程创建有下面两种方法
在线工程向导
右键点击工作空间，选择Create New IoT Project...
根据向导选择：平头哥半导体有限公司 -> CH2201(平台芯片) -> CB6502M LoRaWA应用开发板 -> 电池电压监测示例，输入工程名称，点击Finish后，CDK将自动下载并创建所选例程。
下载工程离线包
平头哥芯片开放社区（OCC）首页 -> 芯片空间 -> CH2201（平台芯片） -> 开发板 -> CB6502M LoRaWAN应用开发板 -> 产品图谱 -> 电池电压监测示例 -> 资源下载
下载相应的资源包，并把zip包解压到非中文路径中，双击project.cdkproj打开工程。
4.3. 烧录许可证
右键点击工程名->Open Flash Programmer->YoC-CB6502M-KP打开FlashProgrammer，试用默认配置，点击Start开始烧录。烧录完成，按开发板复位键，完成初始化。
注意：
- 开发板只要烧录一次许可证即可
- YoC SDK支持安全引导机制，许可证记录了安全引导机制中所需的密钥信息。在应用开发前，需要使用烧录软件进行许可证的烧录，应用程序才能正确引导启动。
- 烧录软件自带的许可证为研发密钥，用于开发测试阶段。
4.4. 编译及烧录
- 点击工具栏的
开始编译 - 镜像编译完成后，点击工具栏的
进行镜像烧录。
4.5. CDK调试
4.5.1. 常用工具栏和快捷键
功能说明
4.5.2. 串口调试工具
CDK集成了串口调试工具，如下图所示：
具体使用可参照CDK帮助文档 -> 串口窗格
4.5.3. 调试脚本
调试脚本路径为script/gdbinit，示例说明如下：
#复位开发板
reset
#代码在eflash中直接执行，需要配置该命令
set debug-in-rom on
#设置默认断点
hb main
4.5.4. 进入调试
编译、烧写完成后，点击
进入调试模式，运行点先停止在上述脚本配置的位置。再点击
，开始执行。
断点、单步执行、查看变量等基本调试功能可参考CDK自带的帮助文档。
4.5.5. 调试选项
工程默认优化配置为-Os（最佳Code Size优化），会影响单步调试代码定位的准确性及部分变量的查看，可修改工程编译选项，Optimization选项调整为-Og(在保证调试代码定位准确性的前提下进行Code Size的优化)。
CDK更多使用方法详见CDK Help说明。
5. 例程运行
以CB6502M开发板为例，示例程序的运行步骤为：
5.1. 接线
CB6502M开发板J34引脚图
ADC接线
| 开发板J34 | 开发板J34 |
|---|---|
| ADC | VDDIO |
接线参照下图
5.2. 运行结果展示
连接打印串口和调试口
打印串口的串口调试工具配置为：
波特率: 115200, 数据位: 8, 校验位: None, 停止位: 1, 流控: None
下载编译好的镜像至CB6502M开发板
按RESET按键，复位开发板，串口将打印如下信息
[ 0.330928][I][init ]OS version: 7.0.2
[ 0.363208][D][adc_fetch_voltage_demo]Enter APP mode
[ 0.416401][D][adc_fetch_voltage_demo]read battery: 3299 mv //采集的电压值。单位mv