【lwip】第二篇：使用lwip的netconn接口编写TCP服务器
一、netconn介绍
参考链接：https://lwip.fandom.com/wiki/Netconn_API
netconn API 是一个顺序API，旨在使lwip协议栈更易于使用（与事件驱动的原始 API 相比），同时仍保留零拷贝功能。
要使用netconnAPI，需要一个操作系统，因为这个API需要使用线程。协议栈核心中的所有数据包处理(输入和输出)都是在一个专用线程内完成的-Tcpip线程)。应用程序线程使用邮箱和信号量与此专用线程通信。
二、netconn API
/*
创建netconn
t：netconn的类型，可取
NETCONN_TCP
NETCONN_UDP
NETCONN_UDPLITE
NETCONN_UDPNOCHKSUM
NETCONN_RAW
返回：netconn句柄
*/
#define netconn_new(t) netconn_new_with_proto_and_callback(t, 0, NULL)
struct netconn* netconn_new_with_proto_and_callback(enum netconn_type t, u8_t proto, netconn_callback callback)
/*
删除netconn
conn：netconn句柄
*/
err_t netconn_delete(struct netconn *conn);
/*
获得netconn的ip和端口
conn：netconn句柄
addr：保存获取的ip
port：保存获取的端口
local：为1时获取本地地址、为1时获取远端地址
*/
err_t netconn_getaddr(struct netconn *conn, ip_addr_t *addr, u16_t *port, u8_t local);
/*
绑定本地ip地址到netconn
conn：netconn句柄
addr：本地ip
port：本地端口
*/
err_t netconn_bind(struct netconn *conn, ip_addr_t *addr, u16_t port);
/*
连接到远端ip和端口
conn：客户端本地ip
port：客户端本地端口
*/
err_t netconn_connect(struct netconn *conn, ip_addr_t *addr, u16_t port);
/*
仅可用于UDP，断开连接
conn：netconn句柄
*/
err_t netconn_disconnect (struct netconn *conn);
/*
将tcp的连接切换成listen模式
conn：netconn句柄
*/
#define netconn_listen(conn) netconn_listen_with_backlog(conn, TCP_DEFAULT_LISTEN_BACKLOG)
/*
tcp服务器获取新建立的连接，也就是监听到的连接
conn：旧的连接
new_conn：新的连接
*/
err_t netconn_accept(struct netconn *conn, struct netconn **new_conn)
/*
接收数据
conn：连接
new_buf：数据包结构体
*/
err_t netconn_recv(struct netconn *conn, struct netbuf **new_buf);
/*
tcp发送数据
conn：连接
dataptr：发送缓冲区
size：发送大小
apiflag：标志
*/
#define netconn_write(conn, dataptr, size, apiflags) \
netconn_write_partly(conn, dataptr, size, apiflags, NULL)
/*
关闭tcp连接
conn：连接
*/
err_t netconn_close(struct netconn *conn);
/*
udp发送数据
conn：连接
buf：数据包结构体
*/
err_t netconn_send(struct netconn *conn, struct netbuf *buf);
三、netconn示例：编写TCP服务器
#include "my_netconn.h"
#include "lwip/opt.h"
#include "usart.h"
#if LWIP_NETCONN
#include "lwip/sys.h"
#include "lwip/api.h"
#define TCPECHO_THREAD_PRIO (osPriorityAboveNormal)
static void mytcp_thread(void *arg)
{
struct netconn *conn, *newconn;
err_t err;
u8_t tx_buf[20];//发送缓冲区
u16_t rx_len=0;
u8_t *temp = "cnt:%d\r\n";
u16_t cnt =0;//要通过TCP显示的计数值
LWIP_UNUSED_ARG(arg);
/* Create a new connection identifier. */
/* Bind connection to well known port number 7. */
conn = netconn_new(NETCONN_TCP);
netconn_bind(conn, IP_ADDR_ANY, 7);
LWIP_ERROR("my tcpdemo: invalid conn", (conn != NULL), return;);
/* Tell connection to go into listening mode. */
netconn_listen(conn);
/* Grab new connection. */
err = netconn_accept(conn, &newconn);
printf("accepted new connection %p\n", newconn);
/* Process the new connection. */
if (err == ERR_OK)
{
while (1)
{
sprintf(tx_buf,temp,cnt);
tx_len = strlen((const char *)tx_buf);
cnt++;
err = netconn_write(newconn, tx_buf, tx_len, NETCONN_COPY);
vTaskDelay(1000);
}
}
}
//创建tcp线程
void mytcp_init(void)
{
sys_thread_new("tcpecho_thread", mytcp_thread, NULL, (configMINIMAL_STACK_SIZE*2), TCPECHO_THREAD_PRIO);
}
#endif /* LWIP_NETCONN */
四、测试
五、总结
使用netconn api首先使用netconn_new创建一个连接，接着可以对这个连接进行删除、查询ip和端口、绑定ip和端口、连接远端地址、监听、接收连接、接收数据、发送数据、关闭连接。非常简单的实现了TCP服务器。