SDK快速开发指南¶
1. 概述¶
本文是 PAN211x代码开发的快速入门指引,旨在帮助使用者快速入门PAN211x 驱动及应用的相关开发。
2 PAN211x EVB 介绍¶
PAN211x评估板采用我司PAN1080为主控MCU,集成了PAN211x RF模块和必要的外围接口,支持用户通过多种方式进行RF功能评估和开发。评估板提供了丰富的外设接口和配置选项,支持连接OLED显示屏、不同供电模式切换以及RF模块的收发模式选择。
关于 PAN211x EVB 开发板硬件的详细介绍,请参考 PAN211x EVB 硬件资源介绍。
3 PAN211x EVB开发环境确认¶
3.1 PC 环境检查¶
请确认KEIL(推荐5.25版本以上), PAN108x下载依赖的flm文件,Jlink设备等准备就绪。
3.2 快速编译运行一个简单的例程¶
硬件接线准备,请确认您已经将 PAN108x EVB 板的:
SWD(P46:SWD_CLK,P47:SWD_DAT,GND:SWD_GND)接口通过 JLink 连接至 PC。
UART1接口通过 USB 转串口模块(采用TTL电平)连接至 PC,UART1-Tx:
P14
,UART1-Rx:P15
。打开一个sample工程,例如
01_SDK\example\00_normal\tx\keil
下的keil目录下的工程文件tx.uvprojx
。点击
Build
编译按钮,然后点击Download
按钮进行下载(如果缺少FLM文件,KEIL会弹出提示框进行提示)。下载完成后会通过串口观察log输出(串口波特率:115200)
4 PAN211x KEIL工程介绍¶
4.1 KEIL工程结构介绍¶
4.2 简易例程使用说明¶
4.2.1 配置文件导出¶
下图为PAN211x常用的典型参数配置列表,用户可通过鼠标单击的方式选择对应的参数配置
根据实际需求修改参数配置,配置界面如下图
点击”导出配置文件“,跳转到代码预览界面后,点击导出头文件,即可生成配置文件
配置头文件
easy_reg.h
的预览界面如下图,点击右上方的‘’导出头文件“按钮即可生成easy_reg.h
。以
01_SDK\example\00_normal\tx
例程为例,如果用户要更改RF参数配置,只要将生成的easy_reg.h
头文件替代01_SDK\example\00_normal\tx\src
目录下的easy_reg.h
后,再编译KEIL代码工程即可实现参数更改。
注意:使用easy_reg.h头文件的前提是将pan_211.h中EASY_RF定义为1:
#define EASY_RF 1 //使用easy rf配置方式
4.2.2 代码工程导出¶
选中典型参数配置列表配置1,再点击右下角的”导出工程代码“
选择代码工程要保存的位置后并确定,即可生成”PAN211_Xn297NormalTx_134329“类似格式的PAN211x代码工程,打开
PAN211_Xn297NormalTx_134329\example\00_normal\tx\keil\tx.uvprojx
,再进行编译下载即可快速进行PAN211x的发送功能演示。
编译运行效果(通过串口输出的log信息)
CPU @ 64000000Hz
SPI-3LINE
Tx[1]
00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10 11 12 13 14 15 16 17 18 19 1a 1b 1c 1d 1e 1f
Tx[2]
00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10 11 12 13 14 15 16 17 18 19 1a 1b 1c 1d 1e 1f
Tx[3]
00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10 11 12 13 14 15 16 17 18 19 1a 1b 1c 1d 1e 1f
4.3 通用例程使用说明¶
4.3.1 编译开关配置¶
以01_SDK\example\01_normal_setup\tx\keil为示例进行说明,将pan211.h中的EASY_RF定义为0后,将使用用户自定义的配置参数进行代码编译。
//pan211.h
#define EASY_RF 0 //不使用easy rf配置方式
此种方式对于用户浏览代码比较友好,用户只要通过修改gRfConfig结构体中的各配置参数,然后再调用PAN211_SetUpConfig即可实现对PAN211x的参数配置,缺点是编译出的固件会比较大。
4.3.2 gRfConfig结构体¶
4.3.3 编译运行效果¶
编译01_SDK\example\01_normal_setup\tx\keil后再下载到PAN211x EVB板,运行串口日志如下:
CPU @ 64000000Hz
SPI-3LINE
Tx[1]
00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10 11 12 13 14 15 16 17 18 19 1a 1b 1c 1d 1e 1f
Tx[2]
00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10 11 12 13 14 15 16 17 18 19 1a 1b 1c 1d 1e 1f
Tx[3]
00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10 11 12 13 14 15 16 17 18 19 1a 1b 1c 1d 1e 1f