Z-Stack协议学习笔记1--发送函数AF_DataRequest

typedef struct

{

union

{

uint16 shortAddr;

} addr;

afAddrMode_t addrMode; //afAddrMode_t是一个枚举类型 模式参数

byte endPoint; //指定的端点号 端点241—254保留端点 范围 1-240

} afAddrType_t;

typedef enum

{

afAddrNotPresent = AddrNotPresent, //按照绑定表进行绑定传输

afAddr16Bit = Addr16Bit, // 指定目标网络地址进行单薄传输 16位

afAddrGroup = AddrGroup, // 组播传输

afAddrBroadcast = AddrBroadcast //广播传输

} afAddrMode_t;

enum

{

AddrNotPresent = 0,

AddrGroup = 1,

Addr16Bit = 2,

Addr64Bit = 3, // 指定IEEE地址进行单播传输 64位

AddrBroadcast = 15

};

typedef struct

{

byte endPoint; //端点号

byte *task_id; // Pointer to location of the Application task ID.

SimpleDescriptionFormat_t *simpleDesc; //设备的简单描述

afNetworkLatencyReq_t latencyReq; //枚举结构 必须用 noLatencyReqs 填充

} endPointDesc_t;

目标设备的简单描述结构

typedef struct

{

byte EndPoint; //EP ID (EP=End Point)

uint16 AppProfId; // profile ID（剖面ID）

uint16 AppDeviceId; // Device ID

byte AppDevVer:4; //Device Version 0x00 为 Version 1.0

byte Reserved:4; // AF_V1_SUPPORT uses for AppFlags:4.

byte AppNumInClusters; //终端支持的输入簇的个数

cId_t *pAppInClusterList;        //指向输入Cluster ID列表的指针

byte AppNumOutClusters;    //输出簇的个数

cId_t *pAppOutClusterList; //指向输出Cluseter ID列表的指针

} SimpleDescriptionFormat_t;

typedef enum

{

noLatencyReqs,

fastBeacons,

slowBeacons

} afNetworkLatencyReq_t;

typedef enum

{

afStatus_SUCCESS,

afStatus_FAILED = 0x80,

afStatus_MEM_FAIL,

afStatus_INVALID_PARAMETER

} afStatus_t;

afStatus_t AF_DataRequest( afAddrType_t *dstAddr, endPointDesc_t *srcEP,

uint16 cID, uint16 len, uint8 *buf, uint8 *transID,

uint8 options, uint8 radius )

{

pDescCB pfnDescCB;

ZStatus_t stat;

APSDE_DataReq_t req;

afDataReqMTU_t mtu;

// Verify source end point 判断源节点是否为空

if ( srcEP == NULL )

{

return afStatus_INVALID_PARAMETER;

}

#if !defined( REFLECTOR )

if ( dstAddr->addrMode == afAddrNotPresent )

{

return afStatus_INVALID_PARAMETER;

}

#endif

// Verify destination address 判断目的地址

req.dstAddr.addr.shortAddr = dstAddr->addr.shortAddr;

// Validate broadcasting 判断地址的模式

if ( ( dstAddr->addrMode == afAddr16Bit ) ||

( dstAddr->addrMode == afAddrBroadcast ) )

{

// Check for valid broadcast values 核对有效的广播值

if( ADDR_NOT_BCAST != NLME_IsAddressBroadcast( dstAddr->addr.shortAddr ) )

{

// Force mode to broadcast 强制转换成广播模式

dstAddr->addrMode = afAddrBroadcast;

}

else

{

// Address is not a valid broadcast type 地址不是一个有效的广播地址类型

if ( dstAddr->addrMode == afAddrBroadcast )

{

return afStatus_INVALID_PARAMETER;

}

}

}

else if ( dstAddr->addrMode != afAddrGroup &&

dstAddr->addrMode != afAddrNotPresent )

{

return afStatus_INVALID_PARAMETER;

}

req.dstAddr.addrMode = dstAddr->addrMode;

req.profileID = ZDO_PROFILE_ID;

if ( (pfnDescCB = afGetDescCB( srcEP )) )

{

uint16 *pID = (uint16 *)(pfnDescCB(

AF_DESCRIPTOR_PROFILE_ID, srcEP->endPoint ));

if ( pID )

{

req.profileID = *pID;

osal_mem_free( pID );

}

}

else if ( srcEP->simpleDesc )

{

req.profileID = srcEP->simpleDesc->AppProfId;

}

req.txOptions = 0;

if ( ( options & AF_ACK_REQUEST ) &&

( req.dstAddr.addrMode != AddrBroadcast ) &&

( req.dstAddr.addrMode != AddrGroup ) )

{

req.txOptions |= APS_TX_OPTIONS_ACK;

}

if ( options & AF_SKIP_ROUTING )

{

req.txOptions |= APS_TX_OPTIONS_SKIP_ROUTING;

}

if ( options & AF_EN_SECURITY )

{

req.txOptions |= APS_TX_OPTIONS_SECURITY_ENABLE;

mtu.aps.secure = TRUE;

}

else

{

mtu.aps.secure = FALSE;

}

mtu.kvp = FALSE;

req.transID = *transID;

req.srcEP = srcEP->endPoint;

req.dstEP = dstAddr->endPoint;

req.clusterID = cID;

req.asduLen = len;

req.asdu = buf;

req.discoverRoute = TRUE;//(uint8)((options & AF_DISCV_ROUTE)
? 1 : 0);

req.radiusCounter = radius;

if (len > afDataReqMTU( &mtu ) )

{

if (apsfSendFragmented)

{

req.txOptions |= AF_FRAGMENTED | APS_TX_OPTIONS_ACK;

stat = (*apsfSendFragmented)( &req );

}

else

{

stat = afStatus_INVALID_PARAMETER;

}

}

else

{

stat = APSDE_DataReq( &req );

}

/*

* If this is an EndPoint-to-EndPoint message on the same device, it will not

* get added to the NWK databufs. So it will not go OTA and it will not get

* a MACCB_DATA_CONFIRM_CMD callback. Thus it is necessary to generate the

* AF_DATA_CONFIRM_CMD here. Note that APSDE_DataConfirm() only generates one

* message with the first in line TransSeqNumber, even on a multi message.

* Also note that a reflected msg will not have its confirmation generated

* here.

*/

if ( (req.dstAddr.addrMode == Addr16Bit) &&

(req.dstAddr.addr.shortAddr == NLME_GetShortAddr()) )

{

afDataConfirm( srcEP->endPoint, *transID, stat );

}

if ( stat == afStatus_SUCCESS )

{

(*transID)++;

}

return (afStatus_t)stat;

}