广州周立功单片机发展有限公司Tel:(020)38730916387309173873097638730977Fax:38730925 特殊说明和如果调用本函数来绑定本地IP和本地端口,系统自动使用默认P和一个空闲的端口;该函 注意点 数可用于TCP或UDP通讯任务 表5 listen函数 函数名称| listen( 所属文件 zlg socket. c 函数原型 int listen( SOCKET* s, uint6 backlog) 功能描述设定TCP服务器需要监听的连接数 编译 「调用者用户的TCP服务器任务 函数参数|:已创建的 SOCKET指针 backlog:需要监听的连接数 函数返回-1:需要监听的连接数比最多可建立的连接数还大 .2: backlog=0 3:已创建的 SOCKET所使用的通讯协议不是TCP协议 -4:需要监听的连接数比可建立的连接数还大 backlog的值:表示设定成功 调用模块 特殊说明只适用于TCP连接 和注意点 accep 函数 函数名称 accepto 所属文件 g socket.c 函数原型| uint8 accept( SOCKET*s, struct sockaddr,adr, int 'addrlen) 功能描述用于TCP服务器确认客户机的连接 编译开关无 调用者 P服务器任务 函数参数|:已创建的 SOCKET指针adr:连接后保存对方的IP和端口 adr的长度 函数返回0xF:没有客户机的连接 返回值小于 MAX TCP LINKS:已经与客户机建立连接,返回值是“连接序号” 调用模块|无 特殊说明只适用于TCP连接,本函数不阻塞,它属于超时退出 和注意点 表7recv函数 函数名称|rvO 所属文件| zlg socket. c 函数原型| untiE6reco( uint8 num, uints8buf, intl6len, int flags) 功能描述TCP通讯连接建立后,读取所得到的数据 编译开关无 调用者 用户的TCP任务 函数参数mum:从 accept0(或 connecto函数)函数获取的“连接序号” buf:接收缓存区起始地址 len:接收的数据长度 fags:保留 函数返回读取的数据长度,为0表示没有数据 调用模块 OSTimeDly(0广州周立功单片机发展有限公司 Tel: (020) 38730916 38730917 38730976 38730977 Fax: 38730925 特殊说明和 注意点 如果调用本函数来绑定本地 IP 和本地端口，系统自动使用默认 IP 和一个空闲的端口; 该函 数可用于 TCP 或 UDP 通讯任务 表 5 listen 函数 函数名称 listen() 所属文件 zlg_socket.c 函数原型 int listen( SOCKET * s, uint16 backlog ) 功能描述 设定 TCP 服务器需要监听的连接数 编译开关 无 调用者 用户的 TCP 服务器任务 函数参数 s：已创建的 SOCKET 指针 backlog：需要监听的连接数 函数返回 值 -1：需要监听的连接数比最多可建立的连接数还大 -2：backlog＝0 -3：已创建的 SOCKET 所使用的通讯协议不是 TCP 协议 -4：需要监听的连接数比可建立的连接数还大 backlog 的值：表示设定成功 调用模块 无 特殊说明 和注意点 只适用于 TCP 连接 表 6 accept 函数 函数名称 accept() 所属文件 zlg_socket.c 函数原型 uint8 accept( SOCKET * s, struct sockaddr * addr, int *addrlen ) 功能描述 用于 TCP 服务器确认客户机的连接 编译开关 无 调用者 用户的 TCP 服务器任务 函数参数 s：已创建的 SOCKET 指针 addr：连接后保存对方的 IP 和端口 addrlen：addr 的长度 函数返回 值 0xFF：没有客户机的连接 返回值小于 MAX_TCP_LINKS：已经与客户机建立连接，返回值是“连接序号” 调用模块 无 特殊说明 和注意点 只适用于 TCP 连接，本函数不阻塞，它属于超时退出。 表 7 recv 函数 函数名称 recv() 所属文件 zlg_socket.c 函数原型 uint16 recv( uint8 num, uint8 *buf, uint16 len, int flags ) 功能描述 TCP 通讯连接建立后，读取所得到的数据。 编译开关 无 调用者 用户的 TCP 任务 函数参数 num：从 accept()（或 connect()函数）函数获取的 “连接序号” buf：接收缓存区起始地址 len：接收的数据长度 flags：保留 函数返回 值 读取的数据长度，为 0 表示没有数据 调用模块 OSTimeDly(10); - 7 -