PAN211x SDK快速开发指南

1. 概述

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

2 PAN211x EVB 介绍

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

image-20240830113329903

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 头文件的前提是将 pan211_port.hEASY_RF 定义为 1:

#define EASY_RF     1 

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_port.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