droplin/VGKitBoard_2212S: TI锛孋C1101锛屾紨绀烘澘绋嬪簭 @ e42cc141a71a212dad1dc3134ce917a2cfbca2aa

一、项目名称

adapterBoardDriver

二、产品类型

演示板

三、应用场景

无线数据收发、测试通讯距离

四、传感器及驱动接口

无

五、按键

6个

S1按键可以移动光标（选择的项会反显）向上选择设置项，或向上设置数值，可以循环移动选择
S2按键可以返回上一个界面
S3按键可以移动光标（选择的项会反显）向下选择设置项，或向上设置数值，可以循环移动选择
S4按键功能待定
S5按键，功能1：开机界面时，按下进入功能选择界面。功能2：确定选择项目。功能3：退出设置状态

六、LED指示灯

2个
D5蓝色LED，发送成功指示灯灯
D4红色LED，接收成功指示灯灯

七、显示器类型及驱动接口

深圳市晶联讯电子的液晶模块JLX19296G-382-PN 该液晶模块支持4线SPI串行接口和IIC接口，本项目使用IIC接口驱动，显示大小192*96 点阵

八、功耗要求

无

九、供电方式

支持三种供电
USB的MICRO-B插头供电
3*5号电池供电
2pin的PH座子供电，注意电压不能超过5V

十一、尺寸

87mm*131.5mm

十二、射频频段

433MHz、490MHz、868MHz、915MHz

十三、射频芯片方案

SX1268、SX1262、LLCC68

十四、主控芯片方案

AT32F413RCT7该MCU与STM32F103RCT6软硬件兼容

十五、认证要求

无

十六、外部连接接口
P7串口转USB
J1J2MCU的GPIO口
P1microBIT插槽，用于无线模块转接板连接
P7MICRO-B类型USB座子，供电
P6外部供电
P5仿真烧录接口

十七、编译器

MDK-ARM Standard Version: 5.14.0.0

十八、编程语言

C99标准

十九、SDK版本

STM32F10x_StdPeriph_Lib_V3.5.0

二十、功能描述

数据包收发测试

发送测试

主界面-->按键S5-->功能选择Enter RF Transmiter-->按键S5-->进入Packet Tx-->按键S5-->开始发送，同时START会闪烁显示发送完成后，6S内收到ACK，会立即触发重新发送，同时会重新设置重发超时时间（从开始发送到接收到ACK的时间），超时后自动重发，超时重发10次后，重发超时时间自动切换回6S。发送成功D5蓝色LED灯闪烁一下。

如图

413ms为从开始发送到无线收到对方回复的应答所消耗的时间，若该处显示OUT，则表示接收等待ACK超时。
100%为统计的丢包率，重新按下按键S5重新计数
hello world?为无线收到的数据包，其中的?位置的字符每次都会不一样
-004dBm为最新一次无线收到的数据包的信号强度

接收测试

主界面-->按键S5-->功能选择Enter RF Receiver-->按键S5-->进入Packet Rx-->按键S5-->开始接收，同时START会闪烁显示收到数据后D4红色LED灯闪烁一下

如图

11.67mA为当前无线模组的工作电流
-13dBm为最新一次无线收到的数据包的信号强度
hello world2、hello world3、hello world4为无线收到的3个数据包，收到新的数据包时显示会向上滚动

数据收发软件实现

周期性发送流程

按键操作进入发送测试[style=bold,label="myRadio_receiver"]; 按键操作进入发送测试 -> 周期时间到[style=bold,label="myRadio_receiver"]; 周期时间到 -> 调用射频发送[style=bold,label="myRadio_transmit"]; 调用射频发送 -> 发送完成[style=bold,label="产生回调：\nrfRx_callback\n状态值：\nTX_STA_SECCESS"]; 发送完成 -> 重新进入接收状态[style=bold,label="myRadio_receiver"]; } ">
功能参数设置

主界面-->按键S5-->功能选择Enter RF Setting-->按键S5-->进入Setting，按下S1或者S3切换设置项目，确定需要设置的项目后，按下S5进行参数设置，该项的光标会闪烁显示，此时可通过按键S1或者S3上下调节参数。再按下S5退出设置，即可选择其他选项设置。

Type，设置选择对应的模组型号，当前demo板的固件可能会兼容多个型号的模组，比如以下型号的模组可以共用一套驱动固件
1. VG2212S433N0S1
Chnl，设置当前模组的无线信道，信道对应的无线率会根据Type类型和Step信道间隔的设置而改变
Step，信道间隔，即每个信道之间的频率带宽，该设置需根据实际情况而定，不宜太小，过小的间隔可能会造成不同信道的设备串频造成干扰。
TxPower，无线发射功率。发射功率越大，功耗越高，相应的通讯距离也会越远
RfBr，无线波特率。无线波特率的大小即传输速率的大小，无线波特率越大，传输消耗时间越小，相应的传输距离越短，反之则越远。最终的通讯距离，在排除外在因素的情况下，可以从无线发射功率和无线波特率这两个参数评估

二十一、备注说明

射频驱动移植
需要将文件夹radio中的API全部移植，与硬件相关的已全部定义在radio/myRadio_gpio.c中，若目标平台也是C语言环境，将文件夹radio中的文件拷贝过来后，只需对应的修改radio/myRadio_gpio.c文件中的GPIO定义既可，由于myRadio_gpio.c中用到的GPIO是宏定义在project/board.h，所以也需要将radio/board.h中的定义移植过来。如果MCU平台也是相近的，只需修改project/board.h中对应的宏定义即可。
本公司为了统一demo程序，将射频相关的操作重新定义了一层，详见radio/myRadio.c，无线应用开发，可以参考借鉴。

射频芯片驱动IO口说明

驱动IO口均定义在project/board.h中
1. BOARD_GPIO_SPI_CLK
2. BOARD_GPIO_SPI_MISO
3. BOARD_GPIO_SPI_MOSI
4. BOARD_GPIO_SPI_CSN
5. BOARD_GPIO_SPI_GPIOA -> 直连射频芯片的RST引脚，上电初始化需要用到
6. BOARD_GPIO_SPI_GPIOB -> 直连射频芯片的IO1引脚，用于接收芯片操作的中断响应输出指示，本工程该引脚用于做发送接收中断响应指示，用户可以配置中断映射功能
7. BOARD_GPIO_SPI_GPIOC -> 直连射频芯片的IO3引脚，用于接收芯片操作的中断响应输出指示，本工程该引脚未使用，用户可以配置中断映射功能
8. BOARD_GPIO_SPI_GPIOD -> 直连射频芯片的busy引脚，用于检测射频芯片工作状态是否忙状态，
9. 其他IO口未使用，可根据实际情况移植
  
  无线应用开发注意事项
  
  无线频率
避免使用中心频率为射频芯片使用的晶体频率整数倍的，比如晶体频率为32MHz，就需要避免使用448MHz的中心频点

驱动调试
首先保证SPI通讯正常，具体SPI时序需根据射频芯片要求设置，可通过示波器或者逻辑分析仪进行硬件分析
SPI通讯正常后，进一步调试查看寄存器操作，读写寄存器，若能正常操作，基本可判定移植成功了

通讯距离

影响无线传输距离的因素
无线电频谱，包括使用的无线频段和无线波特率
发射功率
天线增益，不同增益的天线对无线信号的接收效果影响很大
路径损耗，主要是包括无线使用的周围环境，比如楼宇、树木山峰遮挡
其他的无线信号干扰

二十二、软件开发

开发注意事项
休眠sleep sleep有两种状态：params.Fields.WarmStart = 1;和params.Fields.WarmStart = 0; params.Fields.WarmStart = 1:可以直接调用Radio.Rx和Radio.Send params.Fields.WarmStart = 0:需要重新配置初始化才能调用Radio.Rx和Radio.Send

工程文件架构

有源温补晶体

电压：3.3V。@SX126xSetDio3AsTcxoCtrl( TCXO_CTRL_3_3V, RADIO_TCXO_SETUP_TIME << 6 );

..\adapterBoardDriver_xxxxxxxxxxxxxxx_Vxx
├──app \\常用应用模块封装
|  └──
├──core    \\MCU内核文件
|  └──
├──STM32F10x_FWLib \\MCU官方库函数
└──
├──image   \\md文件显示用的图片
|  └──
├──keil_v5 \\keil编译器工程文件，包含编译生成的HEX文件
|  └──Object  \\编译生成的HEX文件在此文件夹
├──peripheral  \\项目用到的MCU外设
|  └──
├──project \\项目的主函数和GPIO定义包含文件
|  └──
├──radio   \\射频底层驱动文件
|  ├──myRadio_gpio.c  \\射频驱动接口硬件初始化
|  └──myRadio.c   \\为无线应用通用封装API

无线应用通用封装API-radio/myRadio.c

初始化-void myRadio_init(int agr0, void *agr1_ptr) 射频芯片驱动IO口初始化-myRadio_gpio_init() 射频基本参数初始化
射频运行底层执行API-void myRadio_process(void) 放在while循环中执行
射频进入休眠API-void myRadio_abort(void)
获取无线中心频率-uint32_t myRadio_getFrequency(void)
设置无线中心频率-void myRadio_setFrequency(uint32_t freq)
获取发射功率-int8_t myRadio_getTxPower(void)
设置发射功率-void myRadio_setTxPower(int8_t power)
获取无线波特率-uint8_t myRadio_getBaudrate(void)
设置无线波特率-void myRadio_setBaudrate(uint8_t br)
进入数据包发射模式-void myRadio_transmit(rfTxPacket_ts *packet)
进入数据包接收模式-void myRadio_receiver(void)
无线特殊模式功能-void myRadio_setCtrl(controlMode_te mode, uint32_t value) 单载波发射功能，预留进入direct模式，预留连续调制波，预留
射频中断回调函数void myRadio_gpioCallback(uint8_t index) 外部中断检测定义在myRadio_gpio.c
其他，官方未定义，属于第三方定义的常用API，不同厂家的射频方案不一定都能用

GDOx_CFG[5:0]	Description
0 （0x00）	与 RX FIFO 关联：当 RX FIFO 填充到或高于 RX FIFO 阈值时断言。当 RX FIFO 耗尽到同一阈值以下时取消断言
1 （0x01）	与 RX FIFO 关联：当 RX FIFO 填充到或高于 RX FIFO 阈值或到达数据包末尾时断言。当 RX FIFO 为空时取消断言。
2 （0x02）	与 TX FIFO 关联：当 TX FIFO 填充等于或高于 TX FIFO 阈值时断言。当 TX FIFO 低于同一阈值时取消断言
3 （0x03）	与 TX FIFO 关联：当 TX FIFO 已满时断言。当 TX FIFO 耗尽到低于 TX FIFO 阈值时取消断言。
4 （0x04）	断言 RX FIFO 何时溢出。刷新 FIFO 时取消断言。
5 （0x05）	断言 TX FIFO 何时溢出。刷新 FIFO 时取消断言。
6 （0x06）	在发送/接收同步字时断言，并在数据包末尾取消断言。在 RX 中，当数据包由于地址或最大长度过滤而被丢弃或无线电进入RXFIFO_OVERFLOW状态时，引脚也将取消置位。在TX 如果 TX FIFO 下溢，引脚将取消置位。
7 （0x07）	在收到 CRC OK 的数据包时断言。从 RX FIFO 读取第一个字节时取消断言
8 （0x08）	达到前导码质量。当 PQI 高于编程的 PQT 值时断言。当芯片重新进入 RX 状态（MARCSTATE=0x0D）或 PQI 低于编程的 PQT 值时取消置位
9 （0x09）	清晰的渠道评估。当 RSSI 级别低于阈值时为高（取决于当前CCA_MODE设置）
10 （0x0A）	锁定检测器输出。如果锁定检测器输出具有正转换或逻辑持续高电平，则PLL处于锁定状态。要检查PLL锁定，应将锁定检测器输出用作MCU的中断
11 （0x0B）	串行时钟。以同步串行模式与数据同步。在RX模式下，当GDOx_INV=0时，CC1101在下降沿设置数据。在TX模式下，当GDOx_INV=0.
12 （0x0C）	串行同步数据输出。用于同步串行模式。
13 （0x0D）	串行数据输出。用于异步串行模式。
14 （0x0E）	载体感。如果 RSSI 级别高于阈值，则为高。进入空闲模式时清除
15 （0x0F）	CRC_OK。最后的CRC比较匹配。进入/重新启动 RX 模式时清除。
16 （0x10）
到
21 （0x15）	保留 – 用于测试
22 （0x16）	RX_HARD_DATA[1]。可与RX_SYMBOL_TICK一起使用，用于替代串行RX输出
23 （0x17）	RX_HARD_DATA[0].可与RX_SYMBOL_TICK一起使用，用于替代串行RX输出
24 （0x18）
到
26 （0x1A）	保留 – 用于测试
27 （0x1B）	PA_PD. 注意：PA_PD在睡眠和 TX 状态下将具有相同的信号电平。要在使用 SLEEP 状态的应用中控制外部 PA 或 RX/TX 开关，建议改用 GDOx_CFGx=0x2F
28 （0x1C）	LNA_PD. 注意：LNA_PD在睡眠和接收状态下将具有相同的信号电平。要在使用 SLEEP 状态的应用中控制外部 LNA 或 RX/TX 开关，建议改用 GDOx_CFGx=0x2F
29 （0x1D）	RX_SYMBOL_TICK。可与RX_HARD_DATA一起使用，用于替代串行RX输出
30 （0x1E）
到
35 （0x23）保留 – 用于测试
36 （0x24）	WOR_EVNT0
37 （0x25）	WOR_EVNT1
38 （0x26）	CLK_256
39 （0x27）	CLK_32k
40 （0x28）	保留 – 用于测试
41 （0x29）	CHIP_RDYn
42 （0x2A）	保留 – 用于测试
43 （0x2B）	XOSC_STABLE
44 （0x2C）	保留 – 用于测试
45 （0x2D）	保留 – 用于测试
46 （0x2E）	高阻抗（3 态）
47 （0x2F）	HW 为 0（通过设置 GDOx_INV=1 实现 HW1）。可用于控制外部 LNA/PA 或 RX/TX 开关
48 (0x30)	CLK_XOSC/1 Note: There are 3 GDO pins, but only one CLK_XOSC/n can be selected as an output at any time. If CLK_XOSC/n is to be monitored on one of the GDO pins, the other two GDO pins must be configured to values less than 0x30. The GDO0
49 (0x31)	CLK_XOSC/1.5
50 (0x32)	CLK_XOSC/2
51 (0x33)	CLK_XOSC/3
52 (0x34)	CLK_XOSC/4
53 (0x35)	CLK_XOSC/6
54 (0x36)	CLK_XOSC/8
55 (0x37)	CLK_XOSC/12
56 (0x38)	CLK_XOSC/16
57 (0x39)	CLK_XOSC/24
58 (0x3A)	CLK_XOSC/32
59 (0x3B)	CLK_XOSC/48
60 (0x3C)	CLK_XOSC/64
61 (0x3D)	CLK_XOSC/96
62 (0x3E)	CLK_XOSC/128
63 (0x3F)	CLK_XOSC/192

版本更新

V04

二十三、免责说明

1、本工程驱动软件只提供做演示项目使用，未经过大批量项目验证，客户需谨慎使用，如果使用在正式项目中引发的所有问题，本司概不负责。使用过程若发现任何问题，可及时与本司相关人员联系。 2、本工程所有文件可以用于商业性项目移植，无需向本司申请。

README.md 12 KB V膿sture Neapstr膩d膩ts

一、项目名称

二、产品类型

三、应用场景

四、传感器及驱动接口

五、按键

六、LED指示灯

七、显示器类型及驱动接口

八、功耗要求

九、供电方式

十一、尺寸

十二、射频频段

十三、射频芯片方案

十四、主控芯片方案

十五、认证要求

十六、外部连接接口

十七、编译器

十八、编程语言

十九、SDK版本

二十、功能描述

数据包收发测试

发送测试

接收测试

数据收发软件实现

周期性发送流程

功能参数设置

二十一、备注说明

射频驱动移植

射频芯片驱动IO口说明

无线应用开发注意事项

无线频率

驱动调试

通讯距离

二十二、软件开发

开发注意事项

工程文件架构

有源温补晶体

无线应用通用封装API-radio/myRadio.c

版本更新

V04

二十三、免责说明

README.md 12 KB

V膿sture Neapstr膩d膩ts