12. 12
SampleApp.c
/*****************************************************************************
Filename: SampleApp.c
Description: Sample Application (no Profile).
*****************************************************************************/
/****************************************************************************
This application isn't intended to do anything useful, it is intended to be
a simple example of an application's structure. This application sends it's
messages either as broadcast or broadcast filtered group messages. The other
(more normal) message addressing is unicast. Most of the other sample appli-
cations are written to support the unicast message model.
Key control:
SW1: Sends a flash command to all devices in Group 1.
SW2: Adds/Removes (toggles) this device in and out of Group 1. This will
enable and disable the reception of the flash command.
*****************************************************************************/
/************************* INCLUDES **************************/
… 略 …
/************************* MACROS ***************************/
/************************* CONSTANTS ************************/
17. 17
OSAL_BasicApp.c
// Filename: OSAL_BasicApp.c
#include "ZComDef.h"
#include "hal_drivers.h"
#include "OSAL.h"
#include "OSAL_Tasks.h"
#include "BasicApp.h"
/********* GLOBAL VARIABLES ********/
// The order in this table must be identical to the task
// initialization calls below in osalInitTask.
const pTaskEventHandlerFn tasksArr[] = {
Hal_ProcessEvent,
BasicApp_ProcessEvent
};
const uint8 tasksCnt = sizeof( tasksArr ) / sizeof( tasksArr[0] );
uint16 *tasksEvents;
/********* FUNCTIONS **********/
/*******************************************************
* @fn osalInitTasks
* @brief This function invokes the initialization
* function for each task.
* @param void
* @return none
*/
void osalInitTasks( void )
{
uint8 taskID = 0;
tasksEvents = (uint16 *)osal_mem_alloc( sizeof( uint16 ) * tasksCnt);
osal_memset( tasksEvents, 0, (sizeof( uint16 ) * tasksCnt));
Hal_Init( taskID++ );
BasicApp_Init( taskID );
}
18. 18
BasicApp.h
// BasicApp.h
#ifndef BasicApp_H
#define BasicApp_H
#include "ZComDef.h"
/******* CONSTANTS ********/
// These constants are only for example and should be
// changed to the device's needs
#define BasicApp_ENDPOINT 10
#define BasicApp_PROFID 0x0F04
#define BasicApp_DEVICEID 0x0001
#define BasicApp_DEVICE_VERSION 0
#define BasicApp_FLAGS 0
#define BasicApp_MAX_CLUSTERS 1
#define BasicApp_CLUSTERID 1
// Application Events (OSAL) - These are bit weighted definitions.
#define BasicApp_SEND_MSG_EVT 0x0001
/********* FUNCTIONS *********/
/* Task Initialization for the Generic Application */
extern void BasicApp_Init( byte task_id );
/* Task Event Processor for the Generic Application */
extern UINT16 BasicApp_ProcessEvent( byte task_id, UINT16 events );
#endif /* BasicApp_H */
19. 19
BasicApp.c
// BasicApp.c
/******* INCLUDES ********/
#include "OSAL.h"
#include "AF.h"
#include "ZDApp.h"
//#include "ZDObject.h"
//#include "ZDProfile.h"
#include "BasicApp.h"
#include "DebugTrace.h"
#if !defined( WIN32 )
#include "OnBoard.h"
#endif
/* HAL */
#include "hal_lcd.h"
#include "hal_led.h"
#include "hal_key.h"
#include "hal_uart.h"
/******* GLOBAL VARIABLES *******/
// This list should be filled with Application specific Cluster IDs.
const cId_t BasicApp_ClusterList[BasicApp_MAX_CLUSTERS] =
{
BasicApp_CLUSTERID
};
const SimpleDescriptionFormat_t BasicApp_SimpleDesc =
{
BasicApp_ENDPOINT, // int Endpoint;
BasicApp_PROFID, // uint16 AppProfId[2];
BasicApp_DEVICEID, // uint16 AppDeviceId[2];
BasicApp_DEVICE_VERSION, // int AppDevVer:4;
BasicApp_FLAGS, // int AppFlags:4;
BasicApp_MAX_CLUSTERS, // byte AppNumInClusters;
(cId_t *)BasicApp_ClusterList, // byte *pAppInClusterList;
BasicApp_MAX_CLUSTERS, // byte AppNumInClusters;
(cId_t *)BasicApp_ClusterList // byte *pAppInClusterList;
};
endPointDesc_t BasicApp_epDesc;
/******* LOCAL VARIABLES *******/
byte BasicApp_TaskID; // Task ID for internal task/event processing
// This variable will be received when
// BasicApp_Init() is called.
afAddrType_t BasicApp_DstAddr;
20. 20
/******* LOCAL FUNCTIONS *******/
static void BasicApp_HandleKeys( byte shift, byte keys );
static void BasicApp_MessageMSGCB( afIncomingMSGPacket_t *pckt );
/******* PUBLIC FUNCTIONS *****/
/*********************************************************************
* @fn BasicApp_Init
* @brief Initialization function for the Basic App Task.
* This is called during initialization and should contain
* any application specific initialization (ie. hardware
* initialization/setup, table initialization, power up
* notificaiton ... ).
* @param task_id - the ID assigned by OSAL. This ID should be
* used to send messages and set timers.
* @return none
*/
void BasicApp_Init( uint8 task_id )
{
BasicApp_TaskID = task_id;
// Register for all key events - This app will handle all key events
RegisterForKeys( BasicApp_TaskID );
// Update the display
#if defined ( LCD_SUPPORTED )
HalLcdWriteString( "BasicApp", HAL_LCD_LINE_1 );
#endif
}
21. 21
/***********************************************************************************************
* @fn BasicApp_ProcessEvent
* @brief Generic Application Task event processor. This function is called to process
* all events for the task. Events include timers, messages and any other user
* defined events.
* @param task_id - The OSAL assigned task ID.
* @param events - events to process. This is a bit map and can contain more than one event.
* @return none
*/
uint16 BasicApp_ProcessEvent( uint8 task_id, uint16 events )
{
afIncomingMSGPacket_t *MSGpkt;
(void)task_id; // Intentionally unreferenced parameter
if ( events & SYS_EVENT_MSG )
{
MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( BasicApp_TaskID );
while ( MSGpkt )
{
switch ( MSGpkt->hdr.event )
{
case KEY_CHANGE:
BasicApp_HandleKeys( ((keyChange_t *)MSGpkt)->state, ((keyChange_t *)MSGpkt)->keys );
break;
case AF_INCOMING_MSG_CMD:
BasicApp_MessageMSGCB( MSGpkt );
break;
default:
break;
}
22. 22
// Release the memory
osal_msg_deallocate( (uint8 *)MSGpkt );
// Next
MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( BasicApp_TaskID );
}
// return unprocessed events
return (events ^ SYS_EVENT_MSG);
}
// Send a message out - This event is generated by a timer
// (setup in BasicApp_Init()).
if ( events & BasicApp_SEND_MSG_EVT )
{
return (events ^ BasicApp_SEND_MSG_EVT);
}
// Discard unknown events
return 0;
}
23. 23
/*********************************************************************
* @fn BasicApp_HandleKeys
* @brief Handles all key events for this device.
* @param shift - true if in shift/alt.
* @param keys - bit field for key events. Valid entries:
HAL_KEY_SW_4, HAL_KEY_SW_3, HAL_KEY_SW_2, HAL_KEY_SW_1
* @return none
*/
static void BasicApp_HandleKeys( uint8 shift, uint8 keys )
{
// Shift is used to make each button/switch dual purpose.
if ( shift ) {
if ( keys & HAL_KEY_SW_1 ) {
}
if ( keys & HAL_KEY_SW_2 ) {
}
if ( keys & HAL_KEY_SW_3 ) {
}
if ( keys & HAL_KEY_SW_4 ) {
}
} else {
if ( keys & HAL_KEY_SW_1 ) {
}
if ( keys & HAL_KEY_SW_2 ) {
}
if ( keys & HAL_KEY_SW_3 ) {
}
if ( keys & HAL_KEY_SW_4 )
{
}
}
}
24. 24
/******** LOCAL FUNCTIONS *******/
/*********************************************************************
* @fn BasicApp_MessageMSGCB
* @brief Data message processor callback. This function processes
* any incoming data - probably from other devices. So, based
* on cluster ID, perform the intended action.
* @param none
*
* @return none
*/
static void BasicApp_MessageMSGCB( afIncomingMSGPacket_t *pkt )
{
switch ( pkt->clusterId )
{
case BasicApp_CLUSTERID:
// "the" message
#if defined( LCD_SUPPORTED )
HalLcdWriteScreen( (char*)pkt->cmd.Data, "rcvd" );
#elif defined( WIN32 )
WPRINTSTR( pkt->cmd.Data );
#endif
break;
}
}
25. 25
練習1:使用LED驅動程式
打開HAL API手冊,找到LED Service。
練習使用
HalLedSet()
HalLedBlink()
HalLedEnterSleep()
HalLedExitSleep()
// @fn BasicApp_HandleKeys
static void BasicApp_HandleKeys( uint8 shift, uint8 keys )
{
// Shift is used to make each button/switch dual purpose.
if ( shift ) {
...略...
} else {
if ( keys & HAL_KEY_SW_1 ) {
}
if ( keys & HAL_KEY_SW_2 ) {
}
if ( keys & HAL_KEY_SW_3 ) {
}
if ( keys & HAL_KEY_SW_4 )
{
}
}
}
26. 26
練習2:使用LCD驅動程式
打開HAL API手冊,找到LCD Service。
練習使用
HalLcdWriteString()
HalLcdWriteValue()
HalLcdWriteScreen()
HalLcdWriteStringValue()
HalLcdWriteStringValueValue()
HalLcdDisplayPercentBar()
// @fn BasicApp_HandleKeys
static void BasicApp_HandleKeys( uint8 shift, uint8 keys )
{
// Shift is used to make each button/switch dual purpose.
if ( shift ) {
...略...
} else {
if ( keys & HAL_KEY_SW_1 ) {
}
if ( keys & HAL_KEY_SW_2 ) {
}
if ( keys & HAL_KEY_SW_3 ) {
}
if ( keys & HAL_KEY_SW_4 )
{
}
}
}
56. 56
在f8wConfig.cfg組態檔設定PAN ID
PAN_ID = 0xFFFF & device = Coordinator:
Device uses IEEE address to choose a PAN_ID (last 2 bytes)
PAN_ID = 0xFFFF & device = Router 或 End Device
Device will join any available PAN
PAN_ID ≠ 0xFFFF & device = Coordinator
Device will use the set value for the PAN_ID
PAN_ID ≠ 0xFFFF & device = Router 或 End Device
Device will ONLY join a PAN that has this PAN_ID
62. 62
修改FlyApp.c
/**** INCLUDES ****/
#include "OSAL.h"
#include "AF.h"
#include "ZDApp.h"
#include "ZDObject.h"
#include "ZDProfile.h"
#include "FlyApp.h"
#include "DebugTrace.h"
... 略 ...
/***** LOCAL VARIABLES *****/
byte FlyApp_TaskID; // Task ID for internal task/event processing
// This variable will be received when
// FlyApp_Init() is called.
devStates_t FlyApp_NwkState;
byte FlyApp_TransID; // This is the unique message ID (counter)
afAddrType_t FlyApp_DstAddr;
/**** LOCAL FUNCTIONS ****/
static void FlyApp_ProcessZDOMsgs( zdoIncomingMsg_t *inMsg );
static void FlyApp_HandleKeys( byte shift, byte keys );
static void FlyApp_MessageMSGCB( afIncomingMSGPacket_t *pckt );
static void FlyApp_SendTheMessage( void );
const cId_t
FlyApp_ClusterList[FLYAPP_MAX_CLUSTERS] =
{
FLYAPP_CLUSTERID
};
const SimpleDescriptionFormat_t FlyApp_SimpleDesc =
{
FLYAPP_ENDPOINT, // int Endpoint;
FLYAPP_PROFID, // uint16 AppProfId[2];
FLYAPP_DEVICEID, // uint16 AppDeviceId[2];
FLYAPP_DEVICE_VERSION, // int AppDevVer:4;
FLYAPP_FLAGS, // int AppFlags:4;
FLYAPP_MAX_CLUSTERS, // byte AppNumInClusters;
(cId_t *)FlyApp_ClusterList, // byte *pAppInClusterList;
FLYAPP_MAX_CLUSTERS, // byte AppNumInClusters;
(cId_t *)FlyApp_ClusterList // byte *pAppInClusterList;
};
endPointDesc_t FlyApp_epDesc;
63. 63
void FlyApp_Init( uint8 task_id )
{
FlyApp_TaskID = task_id;
FlyApp_NwkState = DEV_INIT;
FlyApp_TransID = 0;
// Device hardware initialization can be added here or in main() (Zmain.c).
// If the hardware is application specific - add it here.
// If the hardware is other parts of the device add it in main().
FlyApp_DstAddr.addrMode = (afAddrMode_t)AddrNotPresent;
FlyApp_DstAddr.endPoint = 0;
FlyApp_DstAddr.addr.shortAddr = 0;
// Fill out the endpoint description.
FlyApp_epDesc.endPoint = FLYAPP_ENDPOINT;
FlyApp_epDesc.task_id = &FlyApp_TaskID;
FlyApp_epDesc.simpleDesc = (SimpleDescriptionFormat_t *)&FlyApp_SimpleDesc;
FlyApp_epDesc.latencyReq = noLatencyReqs;
// Register the endpoint description with the AF
afRegister( &FlyApp_epDesc );
// Register for all key events - This app will handle all key events
RegisterForKeys( FlyApp_TaskID );
// Update the display
#if defined ( LCD_SUPPORTED )
HalLcdWriteString( "FlyApp", HAL_LCD_LINE_1 );
#endif
ZDO_RegisterForZDOMsg( FlyApp_TaskID, End_Device_Bind_rsp );
ZDO_RegisterForZDOMsg( FlyApp_TaskID, Match_Desc_rsp );
}
見 ZDProfile.h
手冊 Z-Stack API.pdf
64. 64
uint16 FlyApp_ProcessEvent( uint8 task_id, uint16 events )
{
afIncomingMSGPacket_t *MSGpkt;
afDataConfirm_t *afDataConfirm;
// Data Confirmation message fields
byte sentEP;
ZStatus_t sentStatus;
byte sentTransID; // This should match the value sent
(void)task_id; // Intentionally unreferenced parameter
if ( events & SYS_EVENT_MSG )
{
MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( FlyApp_TaskID );
while ( MSGpkt )
{
switch ( MSGpkt->hdr.event )
{
case ZDO_CB_MSG:
FlyApp_ProcessZDOMsgs( (zdoIncomingMsg_t *)MSGpkt );
break;
case KEY_CHANGE:
FlyApp_HandleKeys( ((keyChange_t *)MSGpkt)->state, ((keyChange_t *)MSGpkt)->keys );
break;
65. 65
case AF_DATA_CONFIRM_CMD:
// This message is received as a confirmation of a data packet sent.
// The status is of ZStatus_t type [defined in ZComDef.h]
// The message fields are defined in AF.h
afDataConfirm = (afDataConfirm_t *)MSGpkt;
sentEP = afDataConfirm->endpoint;
sentStatus = afDataConfirm->hdr.status;
sentTransID = afDataConfirm->transID;
(void)sentEP;
(void)sentTransID;
// Action taken when confirmation is received.
if ( sentStatus != ZSuccess ) {
// The data wasn't delivered -- Do something
}
break;
case AF_INCOMING_MSG_CMD:
FlyApp_MessageMSGCB( MSGpkt );
break;
case ZDO_STATE_CHANGE:
FlyApp_NwkState = (devStates_t)(MSGpkt->hdr.status);
if ( (FlyApp_NwkState == DEV_ZB_COORD) || (FlyApp_NwkState == DEV_ROUTER)
|| (FlyApp_NwkState == DEV_END_DEVICE) )
{
// Start sending "the" message in a regular interval.
osal_start_timerEx( FlyApp_TaskID, FLYAPP_SEND_MSG_EVT, FLYAPP_SEND_MSG_TIMEOUT );
}
break;
default:
break;
}
66. 66
// Release the memory
osal_msg_deallocate( (uint8 *)MSGpkt );
// Next
MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( FlyApp_TaskID );
} // while ( MSGpkt )
// return unprocessed events
return (events ^ SYS_EVENT_MSG);
}
// Send a message out - This event is generated by a timer
// (setup in FlyApp_Init()).
if ( events & FLYAPP_SEND_MSG_EVT )
{
// Send "the" message
FlyApp_SendTheMessage();
// Setup to send message again
osal_start_timerEx( FlyApp_TaskID,
FLYAPP_SEND_MSG_EVT,
FLYAPP_SEND_MSG_TIMEOUT );
// return unprocessed events
return (events ^ FLYAPP_SEND_MSG_EVT);
}
// Discard unknown events
return 0;
}
67. 67
static void FlyApp_ProcessZDOMsgs( zdoIncomingMsg_t *inMsg )
{
switch ( inMsg->clusterID )
{
case End_Device_Bind_rsp:
if ( ZDO_ParseBindRsp( inMsg ) == ZSuccess ) {
// Light LED
HalLedSet( HAL_LED_4, HAL_LED_MODE_ON );
}
#if defined( BLINK_LEDS )
else {
// Flash LED to show failure
HalLedSet ( HAL_LED_4, HAL_LED_MODE_FLASH );
}
#endif
break;
case Match_Desc_rsp:
ZDO_ActiveEndpointRsp_t *pRsp = ZDO_ParseEPListRsp( inMsg );
if ( pRsp ) {
if ( pRsp->status == ZSuccess && pRsp->cnt ) {
FlyApp_DstAddr.addrMode = (afAddrMode_t)Addr16Bit;
FlyApp_DstAddr.addr.shortAddr = pRsp->nwkAddr;
// Take the first endpoint, Can be changed to search through endpoints
FlyApp_DstAddr.endPoint = pRsp->epList[0];
// Light LED
HalLedSet( HAL_LED_4, HAL_LED_MODE_ON );
}
osal_mem_free( pRsp );
}
break;
}
}
68. 68
static void FlyApp_HandleKeys( uint8 shift, uint8 keys )
{
zAddrType_t dstAddr;
// Shift is used to make each button/switch dual purpose.
if ( shift ) {
... 略 ...
} else {
if ( keys & HAL_KEY_SW_1 ) {
// Since SW1 isn't used for anything else in this application...
#if defined( SWITCH1_BIND )
// we can use SW1 to simulate SW2 for devices that only have one switch,
keys |= HAL_KEY_SW_2;
#elif defined( SWITCH1_MATCH )
// or use SW1 to simulate SW4 for devices that only have one switch
keys |= HAL_KEY_SW_4;
#endif
}
if ( keys & HAL_KEY_SW_2 ) {
HalLedSet ( HAL_LED_4, HAL_LED_MODE_OFF );
// Initiate an End Device Bind Request for the mandatory endpoint
dstAddr.addrMode = Addr16Bit;
dstAddr.addr.shortAddr = 0x0000; // Coordinator
ZDP_EndDeviceBindReq( &dstAddr, NLME_GetShortAddr(),
FlyApp_epDesc.endPoint,
FLYAPP_PROFID,
FLYAPP_MAX_CLUSTERS, (cId_t *)FlyApp_ClusterList,
FLYAPP_MAX_CLUSTERS, (cId_t *)FlyApp_ClusterList,
FALSE );
}
78. 78
void FlyApp_Init( uint8 task_id )
{
FlyApp_TaskID = task_id;
FlyApp_NwkState = DEV_INIT;
FlyApp_TransID = 0;
// Device hardware initialization can be added here or in main() (Zmain.c).
// If the hardware is application specific - add it here.
// If the hardware is other parts of the device add it in main().
FlyApp_DstAddr.addrMode = (afAddrMode_t)AddrNotPresent;
FlyApp_DstAddr.endPoint = 0;
FlyApp_DstAddr.addr.shortAddr = 0;
// Fill out the endpoint description.
FlyApp_epDesc.endPoint = FLYAPP_ENDPOINT;
FlyApp_epDesc.task_id = &FlyApp_TaskID;
FlyApp_epDesc.simpleDesc = (SimpleDescriptionFormat_t *)&FlyApp_SimpleDesc;
FlyApp_epDesc.latencyReq = noLatencyReqs;
// Register the endpoint description with the AF
afRegister( &FlyApp_epDesc );
// Register for all key events - This app will handle all key events
RegisterForKeys( FlyApp_TaskID );
// Update the display
#if defined ( LCD_SUPPORTED )
HalLcdWriteString( "FlyApp", HAL_LCD_LINE_1 );
#endif
ZDO_RegisterForZDOMsg( FlyApp_TaskID, End_Device_Bind_rsp );
ZDO_RegisterForZDOMsg( FlyApp_TaskID, Match_Desc_rsp );
}
見 ZDProfile.h
手冊 Z-Stack API.pdf
80. 80
uint16 FlyApp_ProcessEvent( uint8 task_id, uint16 events )
{
afIncomingMSGPacket_t *MSGpkt;
afDataConfirm_t *afDataConfirm;
// Data Confirmation message fields
byte sentEP;
ZStatus_t sentStatus;
byte sentTransID; // This should match the value sent
(void)task_id; // Intentionally unreferenced parameter
if ( events & SYS_EVENT_MSG )
{
MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( FlyApp_TaskID );
while ( MSGpkt )
{
switch ( MSGpkt->hdr.event )
{
case ZDO_CB_MSG:
FlyApp_ProcessZDOMsgs( (zdoIncomingMsg_t *)MSGpkt );
break;
case KEY_CHANGE:
FlyApp_HandleKeys( ((keyChange_t *)MSGpkt)->state, ((keyChange_t *)MSGpkt)->keys );
break;
81. 81
case AF_DATA_CONFIRM_CMD:
// This message is received as a confirmation of a data packet sent.
// The status is of ZStatus_t type [defined in ZComDef.h]
// The message fields are defined in AF.h
afDataConfirm = (afDataConfirm_t *)MSGpkt;
sentEP = afDataConfirm->endpoint;
sentStatus = afDataConfirm->hdr.status;
sentTransID = afDataConfirm->transID;
(void)sentEP;
(void)sentTransID;
HalLedSet ( HAL_LED_1, HAL_LED_MODE_TOGGLE );
// Action taken when confirmation is received.
if ( sentStatus != ZSuccess ) {
// The data wasn't delivered -- Do something
}
break;
case AF_INCOMING_MSG_CMD:
FlyApp_MessageMSGCB( MSGpkt );
break;
case ZDO_STATE_CHANGE:
FlyApp_NwkState = (devStates_t)(MSGpkt->hdr.status);
if ( (FlyApp_NwkState == DEV_ZB_COORD) || (FlyApp_NwkState == DEV_ROUTER)
|| (FlyApp_NwkState == DEV_END_DEVICE) )
{
// Start sending "the" message in a regular interval.
osal_start_timerEx( FlyApp_TaskID, FLYAPP_SEND_MSG_EVT, FLYAPP_SEND_MSG_TIMEOUT );
}
break;
default:
break;
}
82. 82
// Release the memory
osal_msg_deallocate( (uint8 *)MSGpkt );
// Next
MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( FlyApp_TaskID );
}
// return unprocessed events
return (events ^ SYS_EVENT_MSG);
}
// Send a message out - This event is generated by a timer
// (setup in FlyApp_Init()).
if ( events & FLYAPP_SEND_MSG_EVT )
{
// Send "the" message
FlyApp_SendTheMessage();
// Setup to send message again
osal_start_timerEx( FlyApp_TaskID,
FLYAPP_SEND_MSG_EVT,
FLYAPP_SEND_MSG_TIMEOUT );
// return unprocessed events
return (events ^ FLYAPP_SEND_MSG_EVT);
}
// Discard unknown events
return 0;
}
83. 83
FlyApp_ProcessZDOMsgs()
當ED綁定請求成功時會點亮LED4,若請求失敗則會閃爍LED4。綁定資
訊會自動地被儲存。若是match descriptor request綁定成功,一樣會點
亮LED4並存下綁定資訊。
static void FlyApp_ProcessZDOMsgs( zdoIncomingMsg_t *inMsg )
{
switch ( inMsg->clusterID ) {
case End_Device_Bind_rsp:
if ( ZDO_ParseBindRsp( inMsg ) == ZSuccess ) {
// Light LED
HalLedSet( HAL_LED_4, HAL_LED_MODE_ON );
}
#if defined( BLINK_LEDS )
else {
HalLedSet ( HAL_LED_4, HAL_LED_MODE_FLASH ); // Flash LED to show failure
}
#endif
break;
case Match_Desc_rsp:
{
ZDO_ActiveEndpointRsp_t *pRsp = ZDO_ParseEPListRsp( inMsg );
if ( pRsp ) {
if ( pRsp->status == ZSuccess && pRsp->cnt ) {
FlyApp_DstAddr.addrMode = (afAddrMode_t)Addr16Bit;
FlyApp_DstAddr.addr.shortAddr = pRsp->nwkAddr;
// Take the first endpoint, Can be changed to search through endpoints
FlyApp_DstAddr.endPoint = pRsp->epList[0];
HalLedSet( HAL_LED_4, HAL_LED_MODE_ON ); // Light LED
}
osal_mem_free( pRsp );
}
}
break;
}
}
API手冊
見上一章p.54 / ZDProfile.h
API手冊
84. 84
FlyApp_HandleKeys()
若SW2被按下: 發出end device bind request (手動綁定)。
若SW4被按下: 發出match descriptor request (自動綁定)。
static void FlyApp_HandleKeys( uint8 shift, uint8 keys )
{
zAddrType_t dstAddr;
if ( shift ) { // Shift is used to make each button/switch dual purpose.
if ( keys & HAL_KEY_SW_1 ) { }
if ( keys & HAL_KEY_SW_2 ) { }
if ( keys & HAL_KEY_SW_3 ) { }
if ( keys & HAL_KEY_SW_4 ) { }
} else {
if ( keys & HAL_KEY_SW_1 ) {
// Since SW1 isn't used for anything else in this application...
#if defined( SWITCH1_BIND )
// we can use SW1 to simulate SW2 for devices that only have one switch,
keys |= HAL_KEY_SW_2;
#elif defined( SWITCH1_MATCH )
// or use SW1 to simulate SW4 for devices that only have one switch
keys |= HAL_KEY_SW_4;
#endif
}
102. 102
在FlyApp.c的全域變數區段增加cluster list
增加的cluster list等一下在本地建立綁定表時會用到。
/*********************************************************************
* GLOBAL VARIABLES
*/
// This list is for our new timeout control cluster
const cId_t FlyApp_ClusterCtrlList[FLYAPP_MAX_CTRL_CLUSTERS] =
{
FLYAPP_TIMEOUT_CLUSTER
};
103. 103
新增Descriptor
新增第2個Simple Descriptor跟Endpoint Descriptor以便跟舊的data cluster做
區分。新的cluster我們也會向AF註冊,然後在綁定時用到。
// Simple Descriptor for Control Clusters
const SimpleDescriptionFormat_t FlyApp_SimpleCtrlDesc =
{
FLYAPP_CTRL_ENDPOINT, // int Endpoint;
FLYAPP_PROFID, // uint16 AppProfId[2];
FLYAPP_DEVICEID, // uint16 AppDeviceId[2];
FLYAPP_DEVICE_VERSION, // int AppDevVer:4;
FLYAPP_FLAGS, // int AppFlags:4;
#if !defined(COORDINATOR) // Router and End Device
0, // no input clusters
(cId_t *) NULL,
FLYAPP_MAX_CTRL_CLUSTERS, // byte AppNumOutClusters;
(cId_t *)FlyApp_ClusterCtrlList, // byte *pAppOutClusterList;
#endif
#if defined(COORDINATOR) // Coordinator
FLYAPP_MAX_CTRL_CLUSTERS, // byte AppNumInClusters;
(cId_t *)FlyApp_ClusterCtrlList, // byte *pAppInClusterList;
0, // no output clusters
(cId_t *) NULL,
#endif
};
// Endpoint Descriptor for Control Clusters
#if !defined(COORDINATOR)
endPointDesc_t FlyApp_ctrlEpDesc;
#endif
109. 109
static void FlyApp_HandleKeys( uint8 shift, uint8 keys )
{
zAddrType_t dstAddr;
// Shift is used to make each button/switch dual purpose.
if ( shift )
{
// 略
}
else
{
if ( keys & HAL_KEY_SW_1 )
{
#if !defined(COORDINATOR)
HalLedSet ( HAL_LED_4, HAL_LED_MODE_OFF );
dstAddr.addrMode = Addr16Bit;
dstAddr.addr.shortAddr = 0x0000; // Coordinator
ZDP_EndDeviceBindReq( &dstAddr, NLME_GetShortAddr(),
FlyApp_ctrlEpDesc.endPoint,
FLYAPP_PROFID,
FLYAPP_MAX_CTRL_CLUSTERS, (cId_t *)FlyApp_ClusterCtrlList,
FLYAPP_MAX_CTRL_CLUSTERS, (cId_t *)FlyApp_ClusterCtrlList,
FALSE );
#endif
// Since SW1 isn't used for anything else in this application...
#if defined( SWITCH1_BIND )
// we can use SW1 to simulate SW2 for devices that only have one switch,
keys |= HAL_KEY_SW_2;
#elif defined( SWITCH1_MATCH )
// or use SW1 to simulate SW4 for devices that only have one switch
keys |= HAL_KEY_SW_4;
#endif
}
122. 122
SampleApp.h
/********** CONSTANTS ************/
#define SAMPLEAPP_ENDPOINT 20
#define SAMPLEAPP_PROFID 0x0F08
#define SAMPLEAPP_DEVICEID 0x0001
#define SAMPLEAPP_DEVICE_VERSION 0
#define SAMPLEAPP_FLAGS 0
#define SAMPLEAPP_MAX_CLUSTERS 2
#define SAMPLEAPP_PERIODIC_CLUSTERID 1
#define SAMPLEAPP_FLASH_CLUSTERID 2
// Send Message Timeout
#define SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT 5000 // Every 5 seconds
// Application Events (OSAL) - These are bit weighted definitions.
#define SAMPLEAPP_SEND_PERIODIC_MSG_EVT 0x0001
// Group ID for Flash Command
#define SAMPLEAPP_FLASH_GROUP 0x0001
// Flash Command Duration - in milliseconds
#define SAMPLEAPP_FLASH_DURATION 1000
/********** FUNCTIONS ***********/
/* Task Initialization for the Generic Application */
extern void SampleApp_Init( uint8 task_id );
/* Task Event Processor for the Generic Application */
extern UINT16 SampleApp_ProcessEvent( uint8 task_id, uint16 events );
123. 123
SampleApp.c
/********** GLOBAL VARIABLES ***********/
// This list should be filled with Application specific Cluster IDs.
const cId_t SampleApp_ClusterList[SAMPLEAPP_MAX_CLUSTERS] =
{
SAMPLEAPP_PERIODIC_CLUSTERID,
SAMPLEAPP_FLASH_CLUSTERID
};
const SimpleDescriptionFormat_t SampleApp_SimpleDesc =
{
SAMPLEAPP_ENDPOINT, // int Endpoint;
SAMPLEAPP_PROFID, // uint16 AppProfId[2];
SAMPLEAPP_DEVICEID, // uint16 AppDeviceId[2];
SAMPLEAPP_DEVICE_VERSION, // int AppDevVer:4;
SAMPLEAPP_FLAGS, // int AppFlags:4;
SAMPLEAPP_MAX_CLUSTERS, // uint8 AppNumInClusters;
(cId_t *)SampleApp_ClusterList, // uint8 *pAppInClusterList;
SAMPLEAPP_MAX_CLUSTERS, // uint8 AppNumOutClusters;
(cId_t *)SampleApp_ClusterList // uint8 *pAppOutClusterList;
};
// This is the Endpoint/Interface description. It is defined here, but
// filled-in in SampleApp_Init(). Another way to go would be to fill
// in the structure here and make it a "const" (in code space). The
// way it's defined in this sample app it is define in RAM.
endPointDesc_t SampleApp_epDesc;
124. 124
/*********************************************************************
* LOCAL VARIABLES
*/
uint8 SampleApp_TaskID; // Task ID for internal task/event processing
// This variable will be received when
// SampleApp_Init() is called.
devStates_t SampleApp_NwkState;
uint8 SampleApp_TransID; // This is the unique message ID (counter)
afAddrType_t SampleApp_Periodic_DstAddr;
afAddrType_t SampleApp_Flash_DstAddr;
aps_Group_t SampleApp_Group;
uint8 SampleAppPeriodicCounter = 0;
uint8 SampleAppFlashCounter = 0;
/*********************************************************************
* LOCAL FUNCTIONS
*/
void SampleApp_HandleKeys( uint8 shift, uint8 keys );
void SampleApp_MessageMSGCB( afIncomingMSGPacket_t *pckt );
void SampleApp_SendPeriodicMessage( void );
void SampleApp_SendFlashMessage( uint16 flashTime );
125. 125
void SampleApp_Init( uint8 task_id )
{
SampleApp_TaskID = task_id;
SampleApp_NwkState = DEV_INIT;
SampleApp_TransID = 0;
#if defined ( BUILD_ALL_DEVICES )
// The "Demo" target: We are looking at a jumper (defined in SampleAppHw.c)
// to be jumpered together - if they are - we will start up a coordinator.
// Otherwise, the device will start as a router.
if ( readCoordinatorJumper() )
zgDeviceLogicalType = ZG_DEVICETYPE_COORDINATOR;
else
zgDeviceLogicalType = ZG_DEVICETYPE_ROUTER;
#endif // BUILD_ALL_DEVICES
#if defined ( HOLD_AUTO_START )
// HOLD_AUTO_START is a compile option that will suppress ZDApp from starting
// the device and wait for the application to start the device.
ZDOInitDevice(0);
#endif
// Setup for the periodic message's destination address Broadcast to everyone
SampleApp_Periodic_DstAddr.addrMode = (afAddrMode_t)AddrBroadcast;
SampleApp_Periodic_DstAddr.endPoint = SAMPLEAPP_ENDPOINT;
SampleApp_Periodic_DstAddr.addr.shortAddr = 0xFFFF;
// Setup for the flash command's destination address - Group 1
SampleApp_Flash_DstAddr.addrMode = (afAddrMode_t)afAddrGroup;
SampleApp_Flash_DstAddr.endPoint = SAMPLEAPP_ENDPOINT;
SampleApp_Flash_DstAddr.addr.shortAddr = SAMPLEAPP_FLASH_GROUP;
126. 126
// Fill out the endpoint description.
SampleApp_epDesc.endPoint = SAMPLEAPP_ENDPOINT;
SampleApp_epDesc.task_id = &SampleApp_TaskID;
SampleApp_epDesc.simpleDesc
= (SimpleDescriptionFormat_t *)&SampleApp_SimpleDesc;
SampleApp_epDesc.latencyReq = noLatencyReqs;
// Register the endpoint description with the AF
afRegister( &SampleApp_epDesc );
// Register for all key events - This app will handle all key events
RegisterForKeys( SampleApp_TaskID );
// By default, all devices start out in Group 1
SampleApp_Group.ID = 0x0001;
osal_memcpy( SampleApp_Group.name, "Group 1", 7 );
aps_AddGroup( SAMPLEAPP_ENDPOINT, &SampleApp_Group );
#if defined ( LCD_SUPPORTED )
HalLcdWriteString( "SampleApp", HAL_LCD_LINE_1 );
#endif
}
127. 127
uint16 SampleApp_ProcessEvent( uint8 task_id, uint16 events )
{
afIncomingMSGPacket_t *MSGpkt;
(void)task_id; // Intentionally unreferenced parameter
if ( events & SYS_EVENT_MSG ) {
MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( SampleApp_TaskID );
while ( MSGpkt )
{
switch ( MSGpkt->hdr.event )
{
// Received when a key is pressed
case KEY_CHANGE:
SampleApp_HandleKeys( ((keyChange_t *)MSGpkt)->state, ((keyChange_t *)MSGpkt)->keys );
break;
// Received when a messages is received (OTA) for this endpoint
case AF_INCOMING_MSG_CMD:
SampleApp_MessageMSGCB( MSGpkt );
break;
// Received whenever the device changes state in the network
case ZDO_STATE_CHANGE:
SampleApp_NwkState = (devStates_t)(MSGpkt->hdr.status);
if ( (SampleApp_NwkState == DEV_ZB_COORD)
|| (SampleApp_NwkState == DEV_ROUTER)
|| (SampleApp_NwkState == DEV_END_DEVICE) ) {
// Start sending the periodic message in a regular interval.
osal_start_timerEx( SampleApp_TaskID,
SAMPLEAPP_SEND_PERIODIC_MSG_EVT,
SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT );
} else {
// Device is no longer in the network
}
break;
128. 128
default:
break;
}
// Release the memory
osal_msg_deallocate( (uint8 *)MSGpkt );
// Next - if one is available
MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( SampleApp_TaskID );
}
// return unprocessed events
return (events ^ SYS_EVENT_MSG);
}
// Send a message out - This event is generated by a timer
// (setup in SampleApp_Init()).
if ( events & SAMPLEAPP_SEND_PERIODIC_MSG_EVT )
{
// Send the periodic message
SampleApp_SendPeriodicMessage();
// Setup to send message again in normal period (+ a little jitter)
osal_start_timerEx( SampleApp_TaskID, SAMPLEAPP_SEND_PERIODIC_MSG_EVT,
(SAMPLEAPP_SEND_PERIODIC_MSG_TIMEOUT + (osal_rand() & 0x00FF)) );
// return unprocessed events
return (events ^ SAMPLEAPP_SEND_PERIODIC_MSG_EVT);
}
// Discard unknown events
return 0;
}
129. 129
void SampleApp_HandleKeys( uint8 shift, uint8 keys )
{
(void)shift; // Intentionally unreferenced parameter
if ( keys & HAL_KEY_SW_1 )
{
/* This key sends the Flash Command is sent to Group 1.
* This device will not receive the Flash Command from this
* device (even if it belongs to group 1).
*/
SampleApp_SendFlashMessage( SAMPLEAPP_FLASH_DURATION );
}
if ( keys & HAL_KEY_SW_2 )
{
/* The Flash Command is sent to Group 1.
* This key toggles this device in and out of group 1.
* If this device doesn't belong to group 1, this application
* will not receive the Flash command sent to group 1.
*/
aps_Group_t *grp;
grp = aps_FindGroup( SAMPLEAPP_ENDPOINT, SAMPLEAPP_FLASH_GROUP );
if ( grp )
{
// Remove from the group
aps_RemoveGroup( SAMPLEAPP_ENDPOINT, SAMPLEAPP_FLASH_GROUP );
}
else
{
// Add to the flash group
aps_AddGroup( SAMPLEAPP_ENDPOINT, &SampleApp_Group );
}
}
}
140. 140
case ZDO_STATE_CHANGE:
// If the device has started up, notify the application
if (pMsg->status == DEV_END_DEVICE ||
pMsg->status == DEV_ROUTER ||
pMsg->status == DEV_ZB_COORD )
{
SAPI_StartConfirm( ZB_SUCCESS );
}
else if (pMsg->status == DEV_HOLD ||
pMsg->status == DEV_INIT)
{
SAPI_StartConfirm( ZB_INIT );
}
break;
case ZDO_MATCH_DESC_RSP_SENT:
SAPI_AllowBindConfirm( ((ZDO_MatchDescRspSent_t *)pMsg)->nwkAddr );
break;
case KEY_CHANGE:
#if ( SAPI_CB_FUNC )
zb_HandleKeys( ((keyChange_t *)pMsg)->state, ((keyChange_t *)pMsg)->keys );
#endif
break;
case SAPICB_DATA_CNF:
SAPI_SendDataConfirm( (uint8)((sapi_CbackEvent_t *)pMsg)->data,
((sapi_CbackEvent_t *)pMsg)->hdr.status );
break;
case SAPICB_BIND_CNF:
SAPI_BindConfirm( ((sapi_CbackEvent_t *)pMsg)->data,
((sapi_CbackEvent_t *)pMsg)->hdr.status );
break;
回調 zb_StartConfirm()
回調 zb_AllowBindConfirm()
回調 zb_HandleKeys()
回調 zb_SendDataConfirm()
回調 zb_BindConfirm()
141. 141
case SAPICB_START_CNF:
SAPI_StartConfirm( ((sapi_CbackEvent_t *)pMsg)->hdr.status );
break;
default:
// User messages should be handled by user or passed to the application
if ( pMsg->event >= ZB_USER_MSG ) {
}
break;
}
// Release the memory
osal_msg_deallocate( (uint8 *) pMsg );
// Next
pMsg = (osal_event_hdr_t *) osal_msg_receive( task_id );
}
// Return unprocessed events
return (events ^ SYS_EVENT_MSG);
}
if ( events & ZB_ALLOW_BIND_TIMER ) {
afSetMatch(sapi_epDesc.simpleDesc->EndPoint, FALSE);
return (events ^ ZB_ALLOW_BIND_TIMER);
}
if ( events & ZB_BIND_TIMER ) {
// Send bind confirm callback to application
SAPI_BindConfirm( sapi_bindInProgress, ZB_TIMEOUT );
sapi_bindInProgress = 0xffff;
return (events ^ ZB_BIND_TIMER);
}
回調 zb_StartConfirm()
回調 zb_BindConfirm()
142. 142
if ( events & ZB_ENTRY_EVENT )
{
uint8 startOptions;
// Give indication to application of device startup
#if ( SAPI_CB_FUNC )
zb_HandleOsalEvent( ZB_ENTRY_EVENT );
#endif
// LED off cancels HOLD_AUTO_START blink set in the stack
HalLedSet (HAL_LED_4, HAL_LED_MODE_OFF);
zb_ReadConfiguration( ZCD_NV_STARTUP_OPTION, sizeof(uint8), &startOptions );
if ( startOptions & ZCD_STARTOPT_AUTO_START ) {
zb_StartRequest();
} else {
// blink leds and wait for external input to config and restart
HalLedBlink(HAL_LED_2, 0, 50, 500);
}
return (events ^ ZB_ENTRY_EVENT );
}
// This must be the last event to be processed
if ( events & ( ZB_USER_EVENTS ) ) {
// User events are passed to the application
#if ( SAPI_CB_FUNC )
zb_HandleOsalEvent( events );
#endif
// Do not return here, return 0 later
}
// Discard unknown events
return 0;
}
回調 zb_HandleOsalEvent()
回調 zb_HandleOsalEvent()
144. 144
SimpleCollector.c
/**************************************************************************************************
Filename: SimpleCollector.c
Description: Sample application utilizing the Simple API.
/****** INCLUDES *****/
... 略 ...
#include "sapi.h"
#include "SimpleApp.h"
/****** CONSTANTS ******/
// Application States
#define APP_INIT 0
#define APP_START 1
// Application osal event identifiers
#define MY_START_EVT 0x0001
// Same definitions as in SimpleSensor.c
#define TEMP_REPORT 0x01
#define BATTERY_REPORT 0x02
/***** LOCAL VARIABLES ******/
static uint8 myAppState = APP_INIT;
static uint8 myStartRetryDelay = 10;
/***** GLOBAL VARIABLES ******/
// Inputs and Outputs for Collector device
#define NUM_OUT_CMD_COLLECTOR 0
#define NUM_IN_CMD_COLLECTOR 1
// List of output and input commands for Collector device
const cId_t zb_InCmdList[NUM_IN_CMD_COLLECTOR] =
{
SENSOR_REPORT_CMD_ID
};
// Define SimpleDescriptor for Collector device
const SimpleDescriptionFormat_t zb_SimpleDesc =
{
MY_ENDPOINT_ID, // Endpoint
MY_PROFILE_ID, // Profile ID
DEV_ID_COLLECTOR, // Device ID
DEVICE_VERSION_COLLECTOR, // Device Version
0, // Reserved
NUM_IN_CMD_COLLECTOR, // Number of Input Commands
(cId_t *) zb_InCmdList, // Input Command List
NUM_OUT_CMD_COLLECTOR, // Number of Output Commands
(cId_t *) NULL // Output Command List
};
145. 145
/******************************************************************************
* @fn zb_HandleOsalEvent
* @brief The zb_HandleOsalEvent function is called by the operating
* system when a task event is set
*/
void zb_HandleOsalEvent( uint16 event )
{
}
/*********************************************************************
* @fn zb_HandleKeys
* @brief Handles all key events for this device.
void zb_HandleKeys( uint8 shift, uint8 keys )
{
uint8 startOptions;
uint8 logicalType;
... 略 ...
if ( keys & HAL_KEY_SW_1 )
{
if ( myAppState == APP_INIT )
{
// In the init state, keys are used to indicate the logical mode.
// Key 1 starts device as a coordinator
zb_ReadConfiguration( ZCD_NV_LOGICAL_TYPE, sizeof(uint8), &logicalType );
if ( logicalType != ZG_DEVICETYPE_ENDDEVICE )
{
logicalType = ZG_DEVICETYPE_COORDINATOR;
zb_WriteConfiguration(ZCD_NV_LOGICAL_TYPE, sizeof(uint8), &logicalType);
}
// Do more configuration if necessary and then restart device with auto-start bit set
// write endpoint to simple desc...dont pass it in start req..then reset
見sapi.c
146. 146
zb_ReadConfiguration( ZCD_NV_STARTUP_OPTION, sizeof(uint8), &startOptions );
startOptions = ZCD_STARTOPT_AUTO_START;
zb_WriteConfiguration( ZCD_NV_STARTUP_OPTION, sizeof(uint8), &startOptions );
zb_SystemReset();
} else {
// Turn ON Allow Bind mode indefinitely
zb_AllowBind( 0xFF );
HalLedSet( HAL_LED_1, HAL_LED_MODE_ON );
}
}
if ( keys & HAL_KEY_SW_2 )
{
if ( myAppState == APP_INIT ) {
// In the init state, keys are used to indicate the logical mode.
// Key 2 starts device as a router
zb_ReadConfiguration( ZCD_NV_LOGICAL_TYPE, sizeof(uint8), &logicalType );
if ( logicalType != ZG_DEVICETYPE_ENDDEVICE ) {
logicalType = ZG_DEVICETYPE_ROUTER;
zb_WriteConfiguration(ZCD_NV_LOGICAL_TYPE, sizeof(uint8), &logicalType);
}
zb_ReadConfiguration( ZCD_NV_STARTUP_OPTION, sizeof(uint8), &startOptions );
startOptions = ZCD_STARTOPT_AUTO_START;
zb_WriteConfiguration( ZCD_NV_STARTUP_OPTION, sizeof(uint8), &startOptions );
zb_SystemReset();
} else {
// Turn OFF Allow Bind mode indefinitely
zb_AllowBind( 0x00 );
HalLedSet( HAL_LED_1, HAL_LED_MODE_OFF );
}
}
... 略 ...
}
}
147. 147
/******************************************************************************
* @fn zb_StartConfirm
* @brief The zb_StartConfirm callback is called by the ZigBee stack
* after a start request operation completes
void zb_StartConfirm( uint8 status )
{
// If the device sucessfully started, change state to running
if ( status == ZB_SUCCESS )
{
myAppState = APP_START;
}
else
{
// Try again later with a delay
osal_start_timerEx( sapi_TaskID, MY_START_EVT, myStartRetryDelay );
}
}
/**********************************************************
* @fn zb_SendDataConfirm
* @brief The zb_SendDataConfirm callback function
* is called by the ZigBee after a send data
* operation completes
void zb_SendDataConfirm( uint8 handle, uint8 status )
{
}
/**********************************************************
* @fn zb_BindConfirm
* @brief The zb_BindConfirm callback is called
* by the ZigBee stack after a bind operation
* completes.
void zb_BindConfirm( uint16 commandId, uint8 status )
{
}
/****************************************
* @fn zb_AllowBindConfirm
* @brief Indicates when another
* device attempted to bind
* to this device
void zb_AllowBindConfirm( uint16 source )
{
}
/******************************************
* @fn zb_FindDeviceConfirm
* @brief The zb_FindDeviceConfirm
* callback function is called
* by the stack when a find device
* operation completes.
void zb_FindDeviceConfirm( uint8 searchType,
uint8 *searchKey, uint8 *result )
{
}
148. 148
/******************************************************************************
* @fn zb_ReceiveDataIndication
* @brief The zb_ReceiveDataIndication callback function is called
* asynchronously by the ZigBee stack to notify the application
* when data is received from a peer device.
*
* @param source - The short address of the peer device that sent the data
* command - The commandId associated with the data
* len - The number of bytes in the pData parameter
* pData - The data sent by the peer device
CONST uint8 strDevice[] = "Device:0x";
CONST uint8 strTemp[] = "Temp: ";
CONST uint8 strBattery[] = "Battery: ";
void zb_ReceiveDataIndication( uint16 source, uint16 command, uint16 len, uint8 *pData )
{
uint8 buf[32];
uint8 *pBuf;
uint8 tmpLen;
uint8 sensorReading;
if (command == SENSOR_REPORT_CMD_ID)
{
// Received report from a sensor
sensorReading = pData[1];
// If tool available, write to serial port
tmpLen = (uint8)osal_strlen( (char*)strDevice );
pBuf = osal_memcpy( buf, strDevice, tmpLen );
_ltoa( source, pBuf, 16 );
pBuf += 4;
*pBuf++ = ' ';