透传的基本概念：

透传就是透明传输的简称。那么什么是透明传输呢？顾名思义，透明传输就是指在传输过程中，对外界完全透明，不需要关系传输过程以及传输协议，终目的是要把传输的内容原封不动的传递给被接收端，发送和接收的内容完全一致。这就相当于把信息直接扔给你想要传输的人，只需要扔（也就是传输）这一个步骤，不需要其他的内容安排。

串口无线透传编程流程:

程序需要实现的功能：

1、 ZigBee 模块接收到从 PC 机发来的消息，然后无线发送出去

2、 ZigBee 模块接收到其他 ZigBee 模块发来的消息，然后发送给 PC 机

发送和接收数据的流程:

发送数据：

填充并注册端点描述符 配置发送模式及目的地址AF_DataRe quest()发送数据

接收数据：

填充并注册端点描述符处理系统事件 SYS_EVENT_MSG 中的AF_INCOMING _MSG_CMD 消息获得消息包中的无线数据

相关的API函数或结构体的介绍:

串口无线透传我们需要掌握以下重点：

 端点描述符

 简单描述符

 如何发送数据

 如何接收数据

我们重点分析四个函数：

 任务的初始化函数

 任务的事件处理函数

 无线消息接收回调函数

 无线消息发送函数

端口描述符的定义：

端点（Endpoint）是协议栈应用层入口，它通常为节点的一个通信部件或设备（如各种类型的传感器、开关、 LED 灯等）也是用户定义的应用对象驻留的地方。端点类似于在计算机 TCP/IP 网络通信中，为方便计算机中不同的进程进行通信，在传输层设置的端口（Port）概念。端点和 IEEE64 位扩展地址、16 位网络短地址一样，是 ZigBee 无线通信的一个重要地址参数，能够为多个应用对象提供逻辑子通道以进行通信。每个 ZigBee 设备支持多达 240 个端点，也就是说，每个设备多可以定义 240 个应用对象。端点 0 必须在ZigBee 设备中具有，它分配给 ZigBee 设备对象（ZD0）使用，端点 255 是端点广播地址，端点 241~254 保留，为以后扩展使用。端点描述符用来描述一个端点，Z-Stack 中的 AF.h 中有关于端点描述符的定义如下：

typedef struct

{

uint8 endPoint;     //端口号

uint8 *task_id;     // 指向任务ID号  Pointer to location of the Application task ID.

// 简单设备描述符  可以通过go to…的方式查看结构体变量的类型

SimpleDescriptionFormat_t *simpleDesc;

afNetworkLatencyReq_t latencyReq;   // 延时，采用默认值初始化即可

} endPointDesc_t;

端点描述符的初始化：

端点描述符需要在应用层 SampleApp.c 文件中的 SampleApp_Init()函数中进行端点填充，并向 AF 层注册端点描述符。第一次对话实验中填充端点描述符的过程如下，该部分代码比较固定。

嵌入式物联网需要学的东西真的非常多，千万不要学错了路线和内容，导致工资要不上去！

无偿分享大家一个资料包，差不多150多G。里面学习内容、面经、项目都比较新也比较全！某鱼上买估计至少要好几十。（点击找小助理领取）

void SampleApp_Init( uint8 task_id )

{

// Fill out the endpoint description.

// 以下四行是对节点描述符进行初始化

// 我们需要手动指定端口号，程序中 SAMPLEAPP_ENDPOINT 的宏值为20，

// 可以使用的端口号范围：1~240，用户可根据需要进行修改。

SampleApp_epDesc.endPoint = SAMPLEAPP_ENDPOINT;

//指定任务 ID，这里我们指向的是当前任务的 ID。

SampleApp_epDesc.task_id = &SampleApp_TaskID;

// 指向简单描述符。我们下边会分析简单描述符的定义。

SampleApp_epDesc.simpleDesc

= (SimpleDescriptionFormat_t *)&SampleApp_SimpleDesc;

// 采用默认值 noLatencyReqs 即可

SampleApp_epDesc.latencyReq = noLatencyReqs;

// Register the endpoint description with the AF

// 用 afRegister()函数向 AF 层注册端点描述符。

afRegister( &SampleApp_epDesc );

}

简单设备描述符的定义：

typedef struct

{

uint8          EndPoint;                // 端口号

uint16         AppProfId;               // 应用规范ID

uint16         AppDeviceId;             // 应用设备ID

uint8          AppDevVer:4;             // 应用版本设备号

uint8          Reserved:4;              // 保留  AF_V1_SUPPORT uses for AppFlags:4.

uint8          AppNumInClusters;        // 输入簇的个数

cId_t         *pAppInClusterList;       // 输入簇的列表

uint8          AppNumOutClusters;       // 输出簇的个数

cId_t         *pAppOutClusterList;      // 输出簇的列表

} SimpleDescriptionFormat_t;

简单设备描述符的初始化：

宏定义在SampleApp.h文件中

#define SAMPLEAPP_ENDPOINT           20   // 端口号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

初始化在SampleApp.c文件中

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];  应用规范ID

SAMPLEAPP_DEVICEID,              //  uint16 AppDeviceId[2];  应用设备ID

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  AppNumInClusters;  输出簇命令个数

(cId_t *)SampleApp_ClusterList   //  uint8 *pAppOutClusterList;输出簇列表

};

发送数据函数详解：

【1】 afStatus_t AF_DataRequest(

afAddrType_t *dstAddr, //包含目的节点的网络地址以及发送数据的格式，如广播、组播或单播。

endPointDesc_t *srcEP,//某一个节点上不同的端口 （endpoint） ，我们可以理解为 TCP/IP 中的端口。

uint16cID,//该参数主要是为了区分不同的命令，对应简单描述符中的输出群集

uint16 len,//该参数标识了发送数据的长度。

uint8 *buf,//该参数是指向发送缓冲区的指针。

uint8 *transID,//该参数是指向发送序号的指针。可以用来检测丢包率，由OSAL维护。

uint8 options,//取默认值 AF_DISCV_ROUTE 即可。

uint8 radius//取默认值 AF_DEFAULT_RADIUS 即可。

)

【2】对于发送数据函数AF_DataRequest函数的具体实现，

只需要理解zigbee协议栈是通过发送函数实现广播、组播、单播的即可。

【3】这里重点关注AF_DataRequest函数的第一个参数，可以通过go to……的方式跳转到第一个参数的变量类型：

第一个参数是一个结构体：如下

typedef struct

{

union

{

uint16      shortAddr;   //代表节点的网络地址

ZLongAddr_t extAddr;

} addr;

afAddrMode_t addrMode;   //重点关注这个变量，他代表我的发送形式

uint8 endPoint;

uint16 panId;  // used for the INTER_PAN feature

} afAddrType_t;

afAddrMode_t变量是一个枚举类型：

typedef enum

{

afAddrNotPresent = AddrNotPresent,

afAddr16Bit      = Addr16Bit,     //代表单播

afAddr64Bit      = Addr64Bit,

afAddrGroup      = AddrGroup,     //代表组播

afAddrBroadcast  = AddrBroadcast  //代表广播

} afAddrMode_t;

上述使用到的Addr16Bit,AddrGroup,,AddrBroadcast是一个常数，在zigbee协议栈中具有定义：如下

enum

{

AddrNotPresent = 0,

AddrGroup = 1,

Addr16Bit = 2,

Addr64Bit = 3,

AddrBroadcast = 15

};

接收数据函数详解：

当设备接收到无线数据后，操作系统会将该数据封装成一个消息然后放入消息队列中，同时设置系统事件SYS_EVENT_MSG ，应用层的事件处理函数 SampleApp_ProcessEvent 会处理这个事件，他首先会将消息从消息队列中取出，根据消息的 ID 判断该消息是否就是接收到的数据，标识接收到新数据的消息 ID 是 AF_INCOMING_MSG_CMD，其中 AF_ INCOMING_MSG_CMD 的值是 0x1a，这是在 ZigBee 协议栈中定义好的，用户不可更改。

具体的事件处理函数代码如下所示，这部分代码比较固定，我们只需要熟悉这种事件处理结构即可。

// 事件处理函数

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 messages is received (OTA) for this endpoint

case AF_INCOMING_MSG_CMD://接收数据事件,调用函数AF_DataRequest()接收数据

SampleApp_MessageMSGCB( MSGpkt );//调用回调函数对收到的数据进行处理

break;

default:

break;

}

// Release the memory   事件处理完了，释放消息占用的内存

osal_msg_deallocate( (uint8 *)MSGpkt );

// Next - if one is available 指针指向下一个放在缓冲区的待处理的事件，

//返回while ( MSGpkt )重新处理事件，直到缓冲区没有等待处理事件为止

MSGpkt = (afIncomingMSGPacket_t *)osal_msg_receive( SampleApp_TaskID );

}

// return unprocessed events   返回未处理的事件

return (events ^ SYS_EVENT_MSG);

}

// Discard unknown events

return 0;

}

SampleApp_MessageMSGCB( MSGpkt );函数使用说明：

// 接收到消息，消息处理回调函数

void SampleApp_MessageMSGCB( afIncomingMSGPacket_t *pkt )

{

uint16 flashTime;

switch ( pkt->clusterId )

{

case SAMPLEAPP_PERIODIC_CLUSTERID:

HalUARTWrite (0, (pkt->cmd).Data, ((pkt->cmd).DataLength));

break;

case SAMPLEAPP_FLASH_CLUSTERID:

flashTime = BUILD_UINT16(pkt->cmd.Data[1], pkt->cmd.Data[2] );

HalLedBlink( HAL_LED_4, 4, 50, (flashTime / 4) );

break;

}

}

思考两个问题：

为什么要根据SAMPLEAPP_ PERIODIC_CLUSTERID 才能得到正确的数据呢？

在 ZigBee 网络中进行通信时需要注意的，两者如果想进行通信，需要具有相同的 Cluster ID，而且一个选择“输入” ，另一个选择“输出”（在简单描述符中填充） 。

收到的数据在哪里？

在 pkt 指向的那个结构体里，我们去看下 afIncomingMSGPacket_t 的真面目了。

接收数据的存放位置：

typedef struct

{

osal_event_hdr_t hdr;     /* OSAL Message header */

uint16 groupId;           /* Message's group ID - 0 if not set */

uint16 clusterId;         /* Message's cluster ID */

afAddrType_t srcAddr;     /* Source Address, if endpoint is STUBAPS_INTER_PAN_EP,

it's an InterPAN message */

uint16 macDestAddr;       /* MAC header destination short address */

uint8 endPoint;           /* destination endpoint */

uint8 wasBroadcast;       /* TRUE if network destination was a broadcast address */

uint8 LinkQuality;        /* The link quality of the received data frame */

uint8 correlation;        /* The raw correlation value of the received data frame */

int8  rssi;               /* The received RF power in units dBm */

uint8 SecurityUse;        /* deprecated */

uint32 timestamp;         /* receipt timestamp from MAC */

uint8 nwkSeqNum;          /* network header frame sequence number */

afMSGCommandFormat_t cmd; /* Application Data */

} afIncomingMSGPacket_t;

afMSGCommandFormat_t结构体的声明：

typedef struct

{

uint8   TransSeqNumber;   //用于存储发送序列号；

uint16  DataLength;              //用于存储接收到的数据长度；

uint8  *Data;            //数据接收后放在一个缓冲区，该参数就是指向缓冲区的指针；

} afMSGCommandFormat_t;