适用于升特的SX1262、SX1268、llcc68射频芯片以及相关射频模块
![]() |
3 luni în urmă | |
---|---|---|
STM32F10x_FWLib | 5 luni în urmă | |
app | 3 luni în urmă | |
core | 5 luni în urmă | |
keil_v5 | 3 luni în urmă | |
peripheral | 3 luni în urmă | |
project | 3 luni în urmă | |
radio | 3 luni în urmă | |
.gitignore | 5 luni în urmă | |
README.md | 3 luni în urmă | |
keilkilll.bat | 5 luni în urmă |
[toc]
软件开发移植,先看这里 跳转
VGdd79SxxxN0S1系列、VG237xSxxxN0Sx系列
序号 | 模块IO | MCU IO | 转接板排针 | 模块功能 | 必需 | 备注 |
---|---|---|---|---|---|---|
1 | RST | PC5 | RST | ✓ | ||
2 | MISO | PA6 | DI | MISO | ✓ | 主机SPI数据接收,从机SPI数据发送,3线SPI可以不接 |
3 | MOSI | PA7 | DO | MOSI | ✓ | 主机SPI数据发送,从机SPI数据接收 |
4 | SCK | PA5 | SCK | SCK | ✓ | 主机SPI时钟输出 |
5 | NSS | PA4 | NSS | NSS | ✓ | 从机SPI片选脚 |
6 | VCC | VCC | ✓ | |||
7 | GND | G | ✓ | |||
8 | DIO3\NC | PB1 | IO3 | N | VG237xSxxxN0SA系列为有源晶体模块,DIO3脚用于内部晶体控制 | |
9 | GND | G | ✓ | |||
10 | DIO1 | PB0 | IO0 | 收发状态中断信号输出 | ✓ | 输出高电平,外部可做上升沿触发检测 |
11 | BUSY | PA2 | BUSY | ✓ | ||
12 | GND | G | ✓ | |||
13 | GND | G | ✓ | |||
14 | ANT | ✓ |
VGdd79SxxxX0Mx系列、VG237xSxxxX0Mx系列
序号 | 模块IO | MCU IO | 转接板排针 | 模块功能 | 必需 | 备注 |
---|---|---|---|---|---|---|
1 | GND | G | ✓ | |||
2 | GND | G | ✓ | |||
3 | RXEN | PB10 | RE | 内部LNA使能 | ✓ | 高电平使能 |
4 | TXEN | PB11 | TE | 内部PA使能 | ✓ | 高电平使能 |
5 | DIO3 | PA2 | IO3 | N | ||
6 | DIO1 | PB0 | IO0 | 收发状态中断信号输出 | ✓ | 输出高电平,外部可做上升沿触发检测 |
7 | GND | G | ✓ | |||
8 | VCC | VCC | ✓ | |||
9 | BUSY | PC5 | IO2 | ✓ | ||
10 | RST | PB1 | IO1 | ✓ | ||
11 | MISO | PA6 | DI | MISO | ✓ | 主机SPI数据接收,从机SPI数据发送,3线SPI可以不接 |
12 | MOSI | PA7 | DO | MOSI | ✓ | 主机SPI数据发送,从机SPI数据接收 |
13 | SCK | PA5 | SCK | SCK | ✓ | 主机SPI时钟输出 |
14 | NSS | PA4 | NSS | NSS | ✓ | 从机SPI片选脚 |
15 | GND | G | ✓ | |||
16 | ANT | ✓ |
说明:
✓
:表示必须连接N
:表示可以根据实际需要选择是否连接P
:表示根据SPI模式选择是否连接X
:表示不需要连接..\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
| └──...
448MHz
的中心频点radio\sx126x-board.c\void SX126xWaitOnBusy( void )
这个函数的busy脚的状态,如果无法往下执行,则表示spi操作失败,需要检查硬件连接或者spi的时序是否正确。LoRa Calculator.exe
计算得到最终的波特率
Micro-B USB 座子,可以用于测试板的供电;连接电脑可以做 TTL 转 USB 功 能,测试板内含 CP2102N 芯片
keil工程已经设置了4个选项:
projecet_AT
:表示该工程的MCU型号选择的是雅特力AT32F413RCT7单片机,不带自定义boot功能,即不设置偏移地址projecet_ST
:表示该工程的MCU型号选择的是ST意法半导体STM32F103RCT6单片机,不带自定义boot功能,即不设置偏移地址projecet_AT_APP
:表示该工程的MCU型号选择的是雅特力AT32F413RCT7单片机,带自定义boot功能,设置偏移地址为0x000C800
projecet_ST_APP
:表示该工程的MCU型号选择的是ST意法半导体STM32F103RCT6单片机,带自定义boot功能,设置偏移地址为0x000C800
模块演示板出厂默认烧录projecet_ST_APP
工程,该工程是带boot功能的,默认选择的Debug工具是CMSIS-DAP Debugger
工具,在Option->Debug->Setting->Flash Download->Programming Algorithm->Start
中设置了起始地址,如果更换了Debug工具,起始地址会恢复默认,需要重新设置起始地址。
keil_v5\Listings\*.bin
软件功能框图
软件开发主要就是涉及射频模块驱动
,与硬件相关的主要就是SPI接口和一些辅助IO口(比如中断信号脚),这部分软件主要放在./radio/myRadio_gpio.c
中。
中断信号是通过回调函数RADIO_GPIO_CALLBACK
的方式从./radio/myRadio_gpio.c
回调到./radio/myRadio.c
中处理,回调函数的方式只是为了方便软件编写,用户可以直接把外部中断函数直接放在./radio/myRadio.c
中处理。
所有的中断入口函数放在.\project\stm32f10x_it.c
,在需要的地方通过回调注册的方式回调中断状态,比如注册回调PB0的中断函数回调:
void rfIrq_callback(uint8_t status, uint32_t param)
{
}
myIrqCallback_rfIrq.thisCb = rfIrq_callback;
EXTILINE0_callbackRegiste(&myIrqCallback_rfIrq);
也可以把void EXTI0_IRQHandler(void)
中断入口函数直接拿来用,注册回调的方式只是为了方便调用。
SPI_HARD
来选择,具体见./radio/myRadio_gpio.c/void myRadio_gpio_init(RADIO_GPIO_CALLBACK cb)
RF_SX126x_EXT_PA_RE
和RF_SX126x_EXT_PA_TE
,如果使用的是小功率模块,这两个引脚可以不用控制myRadio_setTxPower(power);
设置,再去发送数据。射频芯片IO使用:DIO2默认用于射频天线开关控制,软件调用SX126xSetDio2AsRfSwitchCtrl( true );
设置即可。如果是有源晶体模块,需要设置如下:
SX126xSetStandby( STDBY_XOSC );
OperatingMode = MODE_STDBY_XOSC;
SX126xSetDio3AsTcxoCtrl( TCXO_CTRL_3_3V, 1 << 6 ); // convert from ms to SX126x time base
calibParam.Value = 0x7F;
SX126xCalibrate( calibParam );
调用./radio/myRadio.c/myRadio_abort()
函数,将射频模块进入低功耗模式,进入低功耗模式后,射频模块将不接收任何无线信号,只有当射频模块进入接收状态后,才能再次接收无线信号。
void myRadio_abort(void)
{
if (rf_handle == 0)
{
return;
}
RF_SX126x_EXT_PA_TO_IDLE();
State = LOWPOWER;
rf_workProcess = RF_PRC_SLEEP;
Radio.Sleep();
}
调用./radio/myRadio.c/myRadio_receiver()
函数,将射频模块进入接收状态,进入接收状态后,射频模块将接收周围环境中的无线信号,并可以接收数据包。在接收状态或者发送过程不能重新调用该函数,发送需要等待发送完成才能再次调用该函数,不然会打断无线发送。接收到无线数据后,射频模块会通过DIO1
引脚产生输出个信号,然后在./radio/myRadio.c/myRadio_process(void)
函数中读取fifo中的数据包。
休眠唤醒已在底层实现.\radio\sx126x.c\void SX126xCheckDeviceReady( void )
,每次操作SX126xWriteCommand(...)
或者SX126xReadCommand(...)
都会调用SX126xCheckDeviceReady
,休眠状态下可以直接调用myRadio_receiver
进入接收状态。
void myRadio_receiver(void)
{
if (rf_handle == 0)
{
return;
}
RF_SX126x_EXT_PA_TO_RX();
Radio.Rx( rf_rxTimeout );
rf_workProcess = RF_PRC_RX;
}
调用./radio/myRadio.c/myRadio_transmit(rfTxPacket_ts *packet)
函数,将射频模块进入发送状态,进入发送状态后,射频模块将发送数据包,发送完成后才可以调用接收函数进入接收状态,发送完成后,射频模块会通过IRQ
引脚产生输出个信号,然后在./radio/myRadio.c/myRadio_process(void)
函数中读取发送完成状态。
休眠唤醒已在底层实现.\radio\sx126x.c\void SX126xCheckDeviceReady( void )
,每次操作SX126xWriteCommand(...)
或者SX126xReadCommand(...)
都会调用SX126xCheckDeviceReady
。休眠状态下可以直接调用myRadio_transmit
发送无线数据
void myRadio_transmit(rfTxPacket_ts *packet)
{
if (rf_handle == 0)
{
return;
}
RF_SX126x_EXT_PA_TO_TX();
rf_workProcess = RF_PRC_TX;
Radio.Send( packet->payload, packet->len );
}
调用./radio/myRadio.c/myRadio_init(int agr0, void *agr1_ptr)
函数,将射频模块初始化,初始化完成后,射频模块将进入接收状态,该函数会初始化一个默认的参数,如果需要自定义参数,比如频率信道,发射功率,无线波特率等参数,可以调用相关函数接口重新设置:
./radio/myRadio.c/myRadio_setFrequency(uint32_t freq)
:设置射频模块工作频率./radio/myRadio.c/myRadio_setTxPower(uint8_t power)
:设置射频模块发射功率./radio/myRadio.c/void myRadio_setBaudrate(uint32_t br)
:设置射频模块无线波特率有源晶体参数设置:
if ((chipType >= DVTP_VG2379S433N0SA) && (chipType <= DVTP_VGdd79S915N0SA))
{
SX126xEnableTxco(true);
}
用户可以直接调用SX126xEnableTxco(true);
设置即可。
初始化完成后就可以进入接收状态或者发送无线数据包了,具体使用方法可以参考示例代码。
myRadio_gpio_init(myRadio_gpioCallback);
/**-------------------------radio init----------------------------------**/
// Radio initialization
RadioEvents.TxDone = OnTxDone;
RadioEvents.RxDone = OnRxDone;
RadioEvents.TxTimeout = OnTxTimeout;
RadioEvents.RxTimeout = OnRxTimeout;
RadioEvents.RxError = OnRxError;
if ((chipType >= DVTP_VG2379S433N0SA) && (chipType <= DVTP_VGdd79S915N0SA))
{
SX126xEnableTxco(true);
}
Radio.Init( &RadioEvents );
Radio.SetChannel( RF_FREQUENCY );
// #if defined( USE_MODEM_LORA )
if (getLoRaSta())
{
Radio.SetTxConfig( MODEM_LORA, TX_OUTPUT_POWER, 0, LORA_BANDWIDTH,
LORA_SPREADING_FACTOR, LORA_CODINGRATE,
LORA_PREAMBLE_LENGTH, LORA_FIX_LENGTH_PAYLOAD_ON,
true, 0, 0, LORA_IQ_INVERSION_ON, 3000 );
Radio.SetRxConfig( MODEM_LORA, LORA_BANDWIDTH, LORA_SPREADING_FACTOR,
LORA_CODINGRATE, 0, LORA_PREAMBLE_LENGTH,
LORA_SYMBOL_TIMEOUT, LORA_FIX_LENGTH_PAYLOAD_ON,
0, true, 0, 0, LORA_IQ_INVERSION_ON, false );
}
// #elif defined( USE_MODEM_FSK )
else
{
Radio.SetTxConfig( MODEM_FSK, TX_OUTPUT_POWER, FSK_FDEV, 0,
FSK_DATARATE, 0,
FSK_PREAMBLE_LENGTH, FSK_FIX_LENGTH_PAYLOAD_ON,
true, 0, 0, 0, 3000 );
Radio.SetRxConfig( MODEM_FSK, FSK_BANDWIDTH, FSK_DATARATE,
0, FSK_AFC_BANDWIDTH, FSK_PREAMBLE_LENGTH,
0, FSK_FIX_LENGTH_PAYLOAD_ON, 0, false,
0, 0,false, false);
// #else
}
// #error "Please define a frequency band in the compiler options."
// #endif
RF_SX126x_EXT_PA_TO_IDLE();
/**-------------------------radio init end----------------------------------**/
if ((rfRxCallBack )agr1_ptr)
{
rxCb = (rfRxCallBack )agr1_ptr;
}
rf_handle = 0xe5;
调用./radio/myRadio.c/myRadio_process(void)
函数,该函数需要放在主函数中不断判断检测是否有中断触发(可以放在while循环中执行),然后根据中断标志来解析处理。状态处理可以直接在相应的位置处理,或者通过回调函数rxCb
将结果返回上一层处理
void myRadio_process(void)
{
if (rf_handle == 0)
{
return;
}
Radio.IrqProcess();
}
在初始化的时候已经通过回调注册了几个回调函数
RadioEvents.TxDone = OnTxDone;
RadioEvents.RxDone = OnRxDone;
RadioEvents.TxTimeout = OnTxTimeout;
RadioEvents.RxTimeout = OnRxTimeout;
RadioEvents.RxError = OnRxError;
当有相关状态触发时,会通过回调函数将状态回调到./radio/myRadio.c
中对应的函数中执行。
可以通过void myRadio_setBaudrate(uint32_t br)
来设置。
void myRadio_setBaudrate(uint32_t br)
:通过数组选择定义好的几组扩频因子、带宽、码率的组合即可V12 2024年6月21日
V13 2024年6月21日
V14 2024年6月25日
1、本工程驱动软件只提供做演示项目使用,未经过大批量项目验证,客户需谨慎使用,如果使用在正式项目中引发的所有问题,本司概不负责。使用过程若发现任何问题,可及时与本司相关人员联系。 2、本工程所有文件可以用于商业性项目移植,无需向本司申请。