Interface_srpcserver
-----以灯的状态操作位例
网关与客户端通过Socket API通信，Socket API在socket_server.c中实现，socket_server.c中不只实现了网关与客户端的通信，还对客户端进行了简单的管理，如建立[c1] ，因为可能有多个客户端连接到同时连接到同一个网关。Socket API是在LwIP的基础上实现的，这一底层通信过程，我们不需要知道它具体怎么实现（但是在具体开发环节中还是需要大量修改和添加功能），只需要知道怎么用Socket API通信。下面就假设网关已经接收到了来自客户端clientFd的命令信息存在*pBuf指向的内存,后面我将介绍网关如何处理这个命令消息。首先调用下面的函数
void RPSC_ProcessIncoming(uint8_t *pBuf, uint32_t clientFd)
功能：处理客户端发送到网关的命令信息
参数：pBuf –网关收到的命令信息
{
rpcsProcessMsg_t func;
func = rpcsProcessIncoming[(pBuf[SRPC_FUNC_ID] & ~(0x80))];
if (func)
{
(*func)(pBuf, clientFd);
}
else
{
printf("Error: no processing function for CMD 0x%x\n", pBuf[SRPC_FUNC_ID]);
}
}
解释：在interface_srpcserver.c的宏定义中定义了这样一个指针函数类型：
typedef uint8_t (*rpcsProcessMsg_t)(uint8_t *pBuf, uint32_t clientFd);
http://zhidao.baidu.com/question/170422609.html[c2]
第一行定义了一个这样的函数指针
第二行pBuf[SRPC_FUNC_ID] & ~(0x80)。这里的SRPC_FUNC_ID是在interface_srpcserver.h中定义的一个宏定义常数0，pBuf[SRPC_FUNC_ID]就是pBuf的第一个字节的值，由SRPC消息格式可知，第一个字节表示CMD ID，即标识网关收到的是哪个命令，如收到的命令为设置灯的状态，则CMD ID为：RPCS_SET_DEV_STATE 0x82（在nterface_srpcserver.h中已定义），0x82& ~(0x80)得到的结果为２，因此func = rpcsProcessIncoming［２］，由字符串数组rpcsProcessIncoming[]（在interface_srpcserver.c的开始已定义）可知rpcsProcessIncoming［２］即为RPCS_ZLL_setDeviceState，自此我们完成了命令的解析，也就是说我们知道了客户端要求网关来干什么，接下来的if语句 执行 (*func)(pBuf, clientFd);即为上述定义的指针函数，还是以设置灯的状态的命令为例，前面我们已经得到func即为RPCS_ZLL_setDeviceState，因此这里实际上调用的函数为：
static uint8_t RPCS_ZLL_setDeviceState(uint8_t *pBuf, uint32_t clientFd)
SRPC消息格式 | ||
CMD字节 | 命令长度（N） | 数据 |
1字节 | 1字节 | n个字节 |
接下来顺藤摸瓜，我们看看这个函数，用户通过客户端发送命令想改变灯的状态，这个命令已经被网关接收到了，接下来网关就要通过[c3] 发送命令给CC2531来控制终端节点，CC2531是不能直接转发处理客户端发送给网关的命令的，因此网关需对命令解析，提取出需要通过串口传递给CC2531的参数，下面这个函数即实现了此功能。在此还是以设置灯的状态命令为例，RPCS_SET_DEV_STATE消息格式如表所示：
RPCS_SET_DEV_STATE消息格式 | ||
字节 | 描述 | 值 |
1 | 命令ID Command ID | 0X82 |
1 | 长度 Length | 13 |
1 | 地址模式 Address Mode | 1 = 组播或2 =单播 1=groupcast OR 2=unicast |
2 | 网络地址 Network Address | NwkAddr或组ID NwkAddr OR Group ID |
6 | 保留的 Reserved | 0 |
1 | 端点 Endpoint | 设备端点或为0xFF Devices Endpoint OR 0xFF |
2 | 保留的 Reserved | 0 |
1 | 状态 State | 0或1（开启或关闭） 0 or 1 (on or off) |
static uint8_t RPCS_ZLL_setDeviceState(uint8_t *pBuf, uint32_t clientFd)
功能：This function exposes an interface to set a devices on/off attribute.
打开一个接口来设置灯的开/关属性
参数：pBuf - incomin messages 网关接收到的命令消息
static uint8_t RPCS_ZLL_setDeviceState(uint8_t *pBuf, uint32_t clientFd)
{
uint8_t endpoint, addrMode;
uint16_t dstAddr;
bool state;
//increment past SRPC header
pBuf+=2;
//由 SRPC消息格式可知命令的前两个字节标识命令的ID及命令的长度，这两个字节是告诉网关该如何处理这个命令，并不需要转发给主机接口，因此指针+2跳过
addrMode = (afAddrMode_t)*pBuf++;
// 由RPCS_SET_DEV_STATE消息格式可知第三个字节标识 地址模式 Address Mode
dstAddr = BUILD_UINT16(pBuf[0], pBuf[1]);
//网络地址由两个字节构成，BUILD_UINT16是在hal_defs.h中定义的一个函数方法，将两个字节组合成一个16位无符号整数
pBuf += Z_EXTADDR_LEN;//指针跳过保留字节，Z_EXTADDR_LEN即为保留字节的个数
endpoint = *pBuf++; //从命令中提取端点ＩＤ
// index past panId
pBuf += 2;// 指针跳过两个保留字节
state = (bool)*pBuf; //从命令中提取 状态
// Set light state on/off
参数已经全部从命令中提取出来了，下面就要通过串口发送参数到CC2531，这是通过下面的函数完成的
zllSocSetState(state, dstAddr, endpoint, addrMode);
return 0;
}
zllSocSetState(state, dstAddr, endpoint, addrMode)在
这个函数实现了通过串口发送数据到CC2531的功能，具体实现在zllSocCmd.c中，这个[z4] 接口的问题在此不再叙述
以上网关完成了一个完整的命令处理过程，主要由三个函数完成：
void RPSC_ProcessIncoming(uint8_t *pBuf, uint32_t clientFd) 解析命令
static uint8_t RPCS_ZLL_setDeviceState(uint8_t *pBuf, uint32_t clientFd) 提取参数
zllSocSetState(state, dstAddr, endpoint, addrMode); 主机接口发送命令
上面我是以“设置灯的状态”命令为例的，这个功能不需要网关返回数据给客户端，如果客户端发送的命令为“获取灯的状态”，则网关还需将灯的状态信息返回给客户端。前面的过程与上例相同，
void RPSC_ProcessIncoming(uint8_t *pBuf, uint32_t clientFd) 解析命令
static uint8_t RPCS_ZLL_getDeviceState(uint8_t *pBuf, uint32_t clientFd) 提取参数
zllSocGetState(dstAddr, endpoint, addrMode); 主机接口发送命令
假设通过主机接口获得了“灯的状态”存放在变量state中，接下来我们就要将这个状态数据返回给客户端。这是就需要调用函数：
void RPCS_ZLL_CallBack_getStateRsp(uint8_t state, uint16_t srcAddr, uint8_t endpoint, uint32_t clientFd)
{
uint8_t *pSrpcMessage, *pBuf;
//RpcMessage contains function ID param Data Len and param data
pSrpcMessage = malloc(2+ 4);
pBuf = pSrpcMessage; //使两个指针指向同一内存
//Set func ID in RPCS buffer
*pBuf++ = RPCS_GET_DEV_STATE_RSP;
//param size
*pBuf++ = 4;
*pBuf++ = srcAddr & 0xFF;
*pBuf++ = (srcAddr & 0xFF00) >> 8;
*pBuf++ = endpoint;
*pBuf++ = state & 0xFF;
//Store the device that sent the request, for now send to all clients
srpcSendAll(pSrpcMessage);
//printf("RPCS_ZLL_CallBack_addSceneRsp--\n");
return;
}
上面的函数是按照下面的命令格式来装载数据的，最后调用srpcSendAll(pSrpcMessage); 函数将封装好的信息发送给所有客户端
RPCS_GET_DEV_STATE_RSP消息格式 | ||
字节 | 描述 | 值 |
1 | 命令ID Command ID | 0X07 |
1 | 长度 Length | 0x4 |
2 | 网络地址 Network Address | 0x1234 |
1 | 端点 End Point | 0X56 |
1 | 状态 state | 0X0 |
srpcSendAll(pSrpcMessage);是通过调用socket_server.c中的
int32 socketSeverSendAllclients(uint8* buf, uint32 len)来实现的
参考Linux gateway远程过程调用设计方法，下面面对的问题主要就是:
一. 在LwIP的基础上能不能实现类似Linux gateway的socket_server；
二. Interface_srpcserver能不能准确移植到STM32中
中[c5]
四. 主机接口与interface_srpcserver如何实现数据交互
[c1]如何做的？不同的客户端如何区分的？
[c2]这个附注加得好，别人就可以更好的学习相关的内容了，以便共同提高。
[c3]也就是吕慧珍和谢红涛正在做移植的部分。
[z4]红色字体表示的为Interface_srpcserver与主机接口交互部分
[c5]这部分吕慧珍他们正在做，应该问题不大。