【经验】EFR32多协议无线SoC radio configuration私有协议配置

EFR32系列是Silicon Labs公司针对物联网应用推出的多协议无线SoC，覆盖了私有协议、Blue Tooth 、ZigBee、Thread和Z-Wave等无线协议。本文介绍EFR32 radio configuration私有协议配置方法。

1. simple_TRX初始化代码

1.1 初始化API

1）RAIL_Handle_t RAIL_Init(RAIL_Config_t *railCfg,

RAIL_InitCompleteCallbackPtr_t cb);

对射频参数进行初始化，包括频段，数据率，频偏，帧结构，CRC等。

2）uint16_t RAIL_ConfigChannels(RAIL_Handle_t railHandle,

const RAIL_ChannelConfig_t *config,

RAIL_RadioConfigChangedCallback_t cb);

选择进行收发的射频通道。

3) RAIL_Status_t RAIL_ConfigTxPower(RAIL_Handle_t railHandle,

const RAIL_TxPowerConfig_t*config);

对PA进行初始化，必须在配置发射功率之前调用该函数。

4）RAIL_Status_t RAIL_SetTxPower(RAIL_Handle_t railHandle,

RAIL_TxPowerLevel_t powerLevel);

通过调用该API配置发射功率。

5）RAIL_Status_t RAIL_ConfigEvents(RAIL_Handle_t railHandle,

RAIL_Events_t mask,

RAIL_Events_t events);

初始化回调函数，RAIL_Events_t定义了多种回调事件，如发送事件，接收事件，定时事件等。

2. simple_TRX发送代码

2.1 发送API

1） uint16_t RAIL_SetTxFifo(RAIL_Handle_t railHandle,

uint8_t *addr,

uint16_t initLength,

uint16_t size);

Addr：表示TX FIFO的存放地址，通常为程序中定义的一个数组

initLength：表示FIFO初始化的字节数，也就是已经存放的字节数

size：表示整个FIFO的大小

功能：定义一个FIFO，配置FIFO的地址，已经存放的字节，总的FIFO字节。

2）uint16_t RAIL_WriteTxFifo(RAIL_Handle_t railHandle,

const uint8_t *dataPtr,

uint16_t writeLength,

bool reset);

dataPtr: 要写入FIFO的数据存放地址

reset: 可配置为0或1，表示写入FIFO前，是否需要对FIFO复位

功能: 把指定地址的数据写入之前已经定义的FIFO中。

3）RAIL_Status_t RAIL_SetTxTransitions(RAIL_Handle_t railHandle,

const RAIL_StateTransitions_t *transitions);

transitions:定义在发送完成后，射频自动切换的状态

RAIL_RF_STATE_INACTIVE 不工作

RAIL_RF_STATE_RX 接收状态

RAIL_RF_STATE_TX 发射状态

RAIL_RF_STATE_IDLE 待机状态

3．simple_TRX接收代码

3.1 接收API

1）RAIL_RxPacketHandle_t RAIL_GetRxPacketInfo(RAIL_Handle_t railHandle, RAIL_RxPacketHandle_t packetHandle, RAIL_RxPacketInfo_t *pPacketInfo);

该API用于获取所收到的数据包信息，包括数据包长，数据包在FIFO中的位置等

typedef struct RAIL_RxPacketInfo {

RAIL_RxPacketStatus_t packetStatus; ---包状态

uint16_t packetBytes; ---包中的可读字节长度

uint16_t firstPortionBytes; ---由于FIFO是闭环的，这3个参数用在

uint8_t *firstPortionData; ---出现最后部分FIFO存满，部分数据

uint8_t *lastPortionData; ---又回到起始FIFO的情况

} RAIL_RxPacketInfo_t;

2）RAIL_Status_t RAIL_GetRxPacketDetails(RAIL_Handle_t railHandle,

RAIL_RxPacketHandle_t packetHandle,

RAIL_RxPacketDetails_t *pPacketDetails);

该API用于获取所收到的数据包的详细信息，如时间,CRC,RSSI,LQI,同步字等

typedef struct RAIL_RxPacketDetails {

RAIL_PacketTimeStamp_t timeReceived; ---包接收的时间戳

bool crcPassed; ---CRC是否正确

bool isAck; ---指示收到的包是否是期望的ACK

int8_t rssi; ---包的信号强度

uint8_t lqi; ---包的连接质量因子

uint8_t syncWordId; ---同步字

uint8_t subPhyId; ---用于有多个接收途径，大部分为0

uint8_t antennaId; ---指示天线号

uint8_t channelHoppingChannelIndex; ---跳频通道

}

3）RAIL_Status_t RAIL_ReleaseRxPacket(RAIL_Handle_t railHandle,

RAIL_RxPacketHandle_t packetHandle);

该函数在之前调用RAIL_HoldRxPacket(railHandle)后，必须使用。释放RAIL内部的资源，用于接收下一包数据。

4．simple_TRX回调程序

void RAILCb_Generic(RAIL_Handle_t railHandle, RAIL_Events_t events)

{

if( events & RAIL_EVENT_CAL_NEEDED ){

RAIL_Calibrate(railHandle, NULL, RAIL_CAL_ALL_PENDING);

}

if ( events & RAIL_EVENTS_TX_COMPLETION ){

BSP_LedToggle(0);

}

if ( events & RAIL_EVENTS_RX_COMPLETION ){

BSP_LedToggle(1);

if ( (events & RAIL_EVENT_RX_PACKET_RECEIVED) && packetHandle == RAIL_RX_PACKET_HANDLE_INVALID ){

packetHandle = RAIL_HoldRxPacket(railHandle);

}

}

}

1) RAIL_RxPacketHandle_t RAIL_HoldRxPacket(RAIL_Handle_t railHandle);

该函数用于临时存放接收的数据，以及相应的数据信息。该函数必须在回调函数中使用。

常用在触发中断的事件

RAIL_EVENTS_TX_COMPLETION ---数据发送完成（可包括成功发送，发送退出，发送阻塞，数据溢出等）

RAIL_EVENT_TX_PACKET_SENT ---数据成功发送

RAIL_EVENTS_RX_COMPLETION ---数据接收完成（可包括成功接收，接收退出，接收帧错误，数据溢出，地址过滤等）

RAIL_EVENT_RX_PACKET_RECEIVED ---数据成功接收

下边是一个接收数据及接收信号强度打印