当前文档版本为 v1.0.0,您可以访问当前页面的 开发中 版本以获取最近可能的更新。

SDK快速开发指南

1. 概述

本文是 PAN211x代码开发的快速入门指引,旨在帮助使用者快速入门PAN211x 驱动及应用的相关开发。

2 PAN211x EVB 介绍

PAN211x评估板采用我司PAN1080为主控MCU,集成了PAN211x RF模块和必要的外围接口,支持用户通过多种方式进行RF功能评估和开发。评估板提供了丰富的外设接口和配置选项,支持连接OLED显示屏、不同供电模式切换以及RF模块的收发模式选择。

image-20240830113329903关于 PAN211x EVB 开发板硬件的详细介绍,请参考 PAN211x EVB 硬件资源介绍

3 PAN211x EVB开发环境确认

3.1 PC 环境检查

请确认KEIL(推荐5.25版本以上), PAN108x下载依赖的flm文件,Jlink设备等准备就绪。

3.2 快速编译运行一个简单的例程

硬件接线准备,请确认您已经将 PAN108x EVB 板的:

  1. SWD(P46:SWD_CLK,P47:SWD_DAT,GND:SWD_GND)接口通过 JLink 连接至 PC。

  2. UART1接口通过 USB 转串口模块(采用TTL电平)连接至 PC,UART1-Tx:P14,UART1-Rx:P15

  3. 打开一个sample工程,例如01_SDK\example\00_normal\tx\keil下的keil目录下的工程文件tx.uvprojx

  4. 点击Build编译按钮,然后点击Download按钮进行下载(如果缺少FLM文件,KEIL会弹出提示框进行提示)。

  5. 下载完成后会通过串口观察log输出(串口波特率:115200

image-20240830114317046

4 PAN211x KEIL工程介绍

4.1 KEIL工程结构介绍

image-20240830122254603

4.2 简易例程使用说明

4.2.1 配置文件导出

  • 下图为PAN211x常用的典型参数配置列表,用户可通过鼠标单击的方式选择对应的参数配置

img

  • 根据实际需求修改参数配置,配置界面如下图

img

  • 点击”导出配置文件“,跳转到代码预览界面后,点击导出头文件,即可生成配置文件

img

  • 配置头文件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代码工程即可实现参数更改。

image-20240831132443954

注意:使用easy_reg.h头文件的前提是将pan_211.h中EASY_RF定义为1:

#define EASY_RF 1 //使用easy rf配置方式

4.2.2 代码工程导出

  • 选中典型参数配置列表配置1,再点击右下角的”导出工程代码“

image-20240831134240607

  • 选择代码工程要保存的位置后并确定,即可生成”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结构体

img

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