ZigBee案例笔记 - 无线点灯

无线点灯实验概述

ZigBee无线点灯实验（即Basic RF工程），由TI公司提供的学习例程，是入门ZigBee无线通讯的经典实验，暂时没有用到协议栈，但实验所体现出来的数据发送、接收和使用协议栈的数据通讯模式是差不多的，而且 TI 公司的 Basic RF 工程代码段都有进行注释容易看懂及运用，将这个实验掌握后，将可以更好的过渡到协议栈的内容学习

工程关键字

学习无线控制实验需要线简单了解以下几个关键字

• CCM - Counter with CBC-MAC (mode of operation)
• HAL - Hardware Abstraction Layer (硬件抽象层)
• PAN - Personal Area Network （个人局域网）
• RF - Radio Frequency （射频）
• RSSI - Received Signal Strength Indicator (接收信号强度指示)

实验中用到的Basic RF 工程源码CC2530 BasicRF.rar需要用户到TI官网注册下载，所下载的案例源码仅针对TI公司的ZigBee开发板进行配置的，烧录到其他ZigBee开发板需要修改配置后才能正常使用

工程文件夹介绍

Basic RF工程下载连接 TI官网Basic RF工程压缩包下载
拿到工程源码CC2530 BasicRF.rar解压后可以看到目录下有3个文件夹，如图分别是docs文件夹、ide文件夹和source文件夹

将docs文件夹、ide文件夹和source文件夹展开后如下

docs文件夹
打开文件夹里面仅有一个名为 CC2530_Software_Examples 的 PDF 文档，文档的主要内容是介绍 BasicRF 的特点、结构及使用，如果使用 TI 的开发板的话阅读这个文档就可以做 Basic RF 里面的实验了，阅读文档可以知道，Basic RF工程包含三个实验例程：无线点灯、传输质量检测、谱分析应用。
ide文件夹
打开文件夹后会有三个文件夹和一个 cc2530_sw_examples.eww 工程，这个工程是上面提及的三个实验例程工程的集合，也包含了无线点灯的实验工程，在IAR 环境中打开，在 workspace 看到3个实验工程如图

ide\settings文件夹
在每个基础实验的文件夹里面都会有的，主要保存用户工程的 IAR 环境配置

ide\srf05_cc2530\iar文件夹
这里放有三个工程，light_switch.eww、per_test.eww、spectrum_analyzer.eww，如果不习惯cc2530_sw_examples.eww 工程中几个工程集合在一起看，可以在这里直接对应的实验工程

source文件夹
文件夹里面有 apps 文件夹和 components 文件夹

source\apps文件夹
存放 Basic RF 三个实验（light_switch、per_test、spectrum_analyzer）的应用实现的源代码，即用户代码存放的地方

source\components文件夹
包含 BasicRF 的应用程序使用不同组件的源代码

Basic RF软件设计框图简单说明

Hardware layer
硬件层，在最底下，是实现数据传输的基础

Hardware Abstraction layer
它提供了一种接口来访问 TIMER，GPIO，UART，ADC 等硬件资源，这些接口都通过相应的函数进行实现

Basic RF layer
为双向无线传输提供一种简单的协议，Basic RF 由 TI 公司提供，它包含了 IEEE 802.15.4 标准的数据包的收发功能但并没有使用到协议栈，它仅仅是是让两个结点进行简单的通信，也就是说Basic RF 仅仅是包含着 IEEE 802.15.4 标准的一小部分而已。其主要特点有：

• 不会自动加入协议、也不会自动扫描其他节点也没有组网指示灯（LED3）。
• 没有协议栈里面所说的协调器、路由器或者终端的区分，节点的地位都是相等的。
• 没有自动重发的功能。

Basic RF layer 为双向无线通信提供了一个简单的协议，通过这个协议能够进行数据的发送和接收

Application layer
是用户应用层，它相当于用户使用 Basic RF 层和 HAL 的接口，也就是说我们通过在 Application layer 就可以使用到封装好的 Basic RF 和 HAL 的函数

工程操作

TI的Basic RF工程目录下CC2530 BasicRF\ide\srf05_cc2530\iar\light_switch.eww打开无线点灯工程

Basic RF 还提供了安全通信所使用的 CCM-64 身份验证和数据加密，它的安全性可以通过在工程文件里面定义 SECURITY_CCM，右键工程列表打开Option，如图工程中不需要启用安全通信加密，在SECURITY_CCM前面加上x，取消加密

Basic RF启动流程

确保外围器件没有问题，创建一个 basicRfCfg_t 的数据结构，并初始化其中的成员，在basic_rf.h 代码中可以找到结构体定义

/***********************************************************************************
* TYPEDEFS
*/typedef struct {uint16 myAddr;				//16 位的短地址（就是节点的地址） uint16 panId;				//节点的 PAN IDuint8 channel;				//RF 通道（必须在 11-26 之间）uint8 ackRequest;			//目标确认就置 true 
#ifdef SECURITY_CCM				//是否加密，预定义里取消了加密uint8* securityKey;uint8* securityNonce;
#endif
} basicRfCfg_t;

调用 basicRfInit()函数进行RF无线通信协议的初始化，在 basic_rf.c 代码中可以找到函数定义，函数对 Basic RF 的数据结构初始化，设置节点的传输通道，短地址，PAN ID

uint8 basicRfInit(basicRfCfg_t* pRfConfig)
{if (halRfInit()==FAILED)return FAILED;halIntOff();// Set the protocol configurationpConfig = pRfConfig;rxi.pPayload   = NULL;txState.receiveOn = TRUE;txState.frameCounter = 0;// Set channelhalRfSetChannel(pConfig->channel);// Write the short address and the PAN ID to the CC2520 RAMhalRfSetShortAddr(pConfig->myAddr);halRfSetPanId(pConfig->panId);// if security is enabled, write key and nonce#ifdef SECURITY_CCMbasicRfSecurityInit(pConfig);#endif// Set up receive interrupt (received data or acknowlegment)halRfRxInterruptConfig(basicRfRxFrmDoneIsr);halIntOn();return SUCCESS;
}

Basic RF发送流程

创建一个buffer存放无线发送的指令，调用 basicRfSendPacket()函数发送，并查看其返回值，在 basic_rf.c 中可以找到函数定义，其中传参为目标节点的短地址 destAddr，发送的buffer指针 pPayload 和buffer长度 length，调用函数给目的短地址发送指定长度的数据，发送成功时返回 SUCCESS，失败则返回 FAILED

uint8 basicRfSendPacket(uint16 destAddr, uint8* pPayload, uint8 length)
{uint8 mpduLength;uint8 status;// Turn on receiver if its not onif(!txState.receiveOn) {halRfReceiveOn();}// Check packet lengthlength = min(length, BASIC_RF_MAX_PAYLOAD_SIZE);// Wait until the transceiver is idlehalRfWaitTransceiverReady();// Turn off RX frame done interrupt to avoid interference on the SPI interfacehalRfDisableRxInterrupt();mpduLength = basicRfBuildMpdu(destAddr, pPayload, length);#ifdef SECURITY_CCMhalRfWriteTxBufSecure(txMpdu, mpduLength, length, BASIC_RF_LEN_AUTH, BASIC_RF_SECURITY_M);txState.frameCounter++;     // Increment frame counter field#elsehalRfWriteTxBuf(txMpdu, mpduLength);#endif// Turn on RX frame done interrupt for ACK receptionhalRfEnableRxInterrupt();// Send frame with CCA. return FAILED if not successfulif(halRfTransmit() != SUCCESS) {status = FAILED;}// Wait for the acknowledge to be received, if anyif (pConfig->ackRequest) {txState.ackReceived = FALSE;// We'll enter RX automatically, so just wait until we can be sure that the ack reception should have finished// The timeout consists of a 12-symbol turnaround time, the ack packet duration, and a small marginhalMcuWaitUs((12 * BASIC_RF_SYMBOL_DURATION) + (BASIC_RF_ACK_DURATION) + (2 * BASIC_RF_SYMBOL_DURATION) + 10);// If an acknowledgment has been received (by RxFrmDoneIsr), the ackReceived flag should be setstatus = txState.ackReceived ? SUCCESS : FAILED;} else {status = SUCCESS;}// Turn off the receiver if it should not continue to be enabledif (!txState.receiveOn) {halRfReceiveOff();}if(status == SUCCESS) {txState.txSeqNumber++;}#ifdef SECURITY_CCMhalRfIncNonceTx();          // Increment nonce value
#endifreturn status;
}

Basic RF接收流程

调用basicRfPacketIsReady()函数检测节点是否准备好读取新的数据包，在 basic_rf.c 中可以找到函数定义，如果准备好则返回TURE

uint8 basicRfPacketIsReady(void)
{return rxi.isReady;
}

调用 basicRfReceive()函数，把收到的数据复制到接收节点的buffer 中，代码可以在 basic_rf.c 中可以找到函数定义，函数接收来自 Basic RF 层的数据包，并为所接收的数据和 RSSI 值配置缓冲区

uint8 basicRfReceive(uint8* pRxData, uint8 len, int16* pRssi)
{// Accessing shared variables -> this is a critical region// Critical region starthalIntOff();memcpy(pRxData, rxi.pPayload, min(rxi.length, len));if(pRssi != NULL) {if(rxi.rssi < 128){*pRssi = rxi.rssi - halRfGetRssiOffset();}else{*pRssi = (rxi.rssi - 256) - halRfGetRssiOffset();}}rxi.isReady = FALSE;halIntOn();// Critical region endreturn min(rxi.length, len);
}

无线点灯案例

上面的配置流程了解了无线点灯的代码配置流程后，开始修改工程源码，无线点灯实验需要用到2块ZigBee节点板，一块作为ZigBee无线发送节点（按键发送无线指令），另一块作为ZigBee无线接收节点（接收无线指令控灯），在Basic RF工程中功能实现的代码都在light_switch.c文件中，开头用宏定义配置了节点主要参数，包含发送节点和接收节点的16位短地址、RF通道、PAN ID等关键参数

/***********************************************************************************
* CONSTANTS
*/
// Application parameters
#define RF_CHANNEL                25      // 2.4 GHz RF channel// BasicRF address definitions
#define PAN_ID                0x2007
#define SWITCH_ADDR           0x2520
#define LIGHT_ADDR            0xBEEF
#define APP_PAYLOAD_LENGTH        1
#define LIGHT_TOGGLE_CMD          0// Application states
#define IDLE                      0
#define SEND_CMD                  1// Application role
#define NONE                      0
#define SWITCH                    1
#define LIGHT                     2
#define APP_MODES                 2

创建发送节点和接收节点的buffer，创建节点结构体

/***********************************************************************************
* LOCAL VARIABLES
*/
static uint8 pTxData[APP_PAYLOAD_LENGTH];
static uint8 pRxData[APP_PAYLOAD_LENGTH];
static basicRfCfg_t basicRfConfig;

在main函数里有很多配置是实验中用不到的，比如LCD屏幕显示、遥感按键操作等，可以直接屏蔽不需要的代码部分，修改后的main函数如下（屏蔽部分已删除，详细可自行查看工程），main函数中配置了发送节点/接收节点的结构体共同部分（PAN_ID、RF_CHANNEL、TRUE），初始化板级硬件和RF无线功能、关闭板载LED，然后是按照不同节点进入不同的节点函数进行循环（发送节点进入appSwitch()函数，屏蔽appLight()函数，接收节点进入appLight()函数，屏蔽appSwitch()函数），工程不会运行到HAL_ASSERT(FALSE)函数，以下为发送节点的main函数

void main(void)
{// Config basicRFbasicRfConfig.panId = PAN_ID;basicRfConfig.channel = RF_CHANNEL;basicRfConfig.ackRequest = TRUE;
#ifdef SECURITY_CCMbasicRfConfig.securityKey = key;
#endif// Initalise board peripheralshalBoardInit();// Initalise hal_rfif(halRfInit()==FAILED) {HAL_ASSERT(FALSE);}// Indicate that device is poweredhalLedClear(1);halLedClear(2);//无线点灯核心函数appSwitch();
//    appLight();// Role is undefined. This code should not be reachedHAL_ASSERT(FALSE);
}

发送节点函数appSwitch()，将点灯指令放到pTxData发送数组中，配置发送节点短地址后初始化节点结构体，发送节点不需要做无线接收调用basicRfReceiveOff()函数关闭无线接收功能；在while循环中判断按键是否按下，按下则调用basicRfSendPacket()函数发送无线信息，LED2闪烁提示无线信息已发送，随后进入低功耗模式等待按键再次按下

static void appSwitch()
{
#ifdef ASSY_EXP4618_CC2420halLcdClearLine(1);halLcdWriteSymbol(HAL_LCD_SYMBOL_TX, 1);
#endifpTxData[0] = LIGHT_TOGGLE_CMD;// Initialize BasicRFbasicRfConfig.myAddr = SWITCH_ADDR;if(basicRfInit(&basicRfConfig)==FAILED) {HAL_ASSERT(FALSE);}// Keep Receiver off when not needed to save powerbasicRfReceiveOff();// Main loop
while (TRUE) {
// 按键判断if( halButtonPushed() == HAL_BUTTON_1 ) {basicRfSendPacket(LIGHT_ADDR, pTxData, APP_PAYLOAD_LENGTH);HAL_LED_TGL_2();halMcuWaitMs(50);HAL_LED_TGL_2();// Put MCU to sleep. It will wake up on joystick interrupthalIntOff();halMcuSetLowPowerMode(HAL_MCU_LPM_3); // Will turn on global// interrupt enablehalIntOn();}}
}

接收节点函数appLight()（需要屏蔽main函数中的appSwitch()），配置接收节点短地址后初始化节点结构体，basicRfReceiveOn()函数打开无线接收功能，在while循环中检测接收节点是否做好接收无线数据包的准备，然后判断是否收到数据包；在收到数据包后判断无线指令是否为点灯指令，是的话闪烁LED2提示成功接收无线消息，将LED1状态进行反转完成控灯操作

static void appLight()
{
//    halLcdWriteLine(HAL_LCD_LINE_1, "Light");
//    halLcdWriteLine(HAL_LCD_LINE_2, "Ready");#ifdef ASSY_EXP4618_CC2420halLcdClearLine(1);halLcdWriteSymbol(HAL_LCD_SYMBOL_RX, 1);
#endif// Initialize BasicRFbasicRfConfig.myAddr = LIGHT_ADDR;if(basicRfInit(&basicRfConfig)==FAILED) {HAL_ASSERT(FALSE);}basicRfReceiveOn();// Main loopwhile (TRUE) {while(!basicRfPacketIsReady());if(basicRfReceive(pRxData, APP_PAYLOAD_LENGTH, NULL)>0) {if(pRxData[0] == LIGHT_TOGGLE_CMD) {HAL_LED_TGL_2();halMcuWaitMs(50);HAL_LED_TGL_2();halLedToggle(1);}}}
}

如果所用到的ZigBee开发板并不是TI公司的开发板，需要检查工程中的按键引脚和LED引脚定义是否可以直接应用到所用的ZigBee开发板上，在hal_board.h文件中找到LED和按键的端口引脚宏定义，按照ZigBee开发板原理图做对应修改

// LEDs
#define HAL_BOARD_IO_LED_1_PORT        1   // Green
#define HAL_BOARD_IO_LED_1_PIN         0
#define HAL_BOARD_IO_LED_2_PORT        1   // Red
#define HAL_BOARD_IO_LED_2_PIN         1
#define HAL_BOARD_IO_LED_3_PORT        1   // Yellow
#define HAL_BOARD_IO_LED_3_PIN         4
#define HAL_BOARD_IO_LED_4_PORT        0   // Orange
#define HAL_BOARD_IO_LED_4_PIN         1// Buttons
#define HAL_BOARD_IO_BTN_1_PORT        1   // Button S1 by YUAN
#define HAL_BOARD_IO_BTN_1_PIN         2

无线点灯现象

工程编译成功后分别上传至ZigBee发送节点和ZigBee接收节点

按下发送节点的按键进行控制指令发送，观察接收节点板的LED1状态