使用顺序 API 开发 LwIP 应用程序 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
LwIP 可以在两种基本模式下使用:主循环模式(“NO_SYS”)(目标系统上没有运行 OS/RTOS)或 OS 模式(TCPIP 线程)(目标系统上有运行的 OS)。在主循环模式下,只能使用原始 API。在OS模式下,可以使用原始API和顺序API。 在OS模式下,lwip堆栈和应用程序在单独的任务中运行。应用程序通过顺序 API 调用与 LwIP 堆栈进行通信,这些 API 调用使用 RTOS 邮箱机制进行进程间通信。 这篇文章重点介绍如何使用 MCUXpresso SDK 中的顺序 API 在 OS 模式下设计 LwIP 应用程序。它适用于 LwIP 初学者。代码片段来自 MCUXpresso SDK2.6。 有关如何使用原始 API 在主循环模式(裸机模式)下设计 LwIP 应用程序,请参阅以下链接: 使用原始 API 开发 LwIP 应用程序 一般来说,LwIP 应用程序包括网络接口设置、LwIP 堆栈初始化、使用 LwIP API 和配置。 1. 启动网络接口 要创建新的网络接口,用户需要为新的struct netif分配空间(但不初始化它的任何部分)并调用netifapi_netif_add : IP4_ADDR(&fsl_netif0_ipaddr, configIP_ADDR0, configIP_ADDR1, configIP_ADDR2, configIP_ADDR3); IP4_ADDR(&fsl_netif0_netmask, configNET_MASK0, configNET_MASK1, configNET_MASK2, configNET_MASK3); IP4_ADDR(&fsl_netif0_gw, configGW_ADDR0, configGW_ADDR1, configGW_ADDR2, configGW_ADDR3); netifapi_netif_add(&fsl_netif0, &fsl_netif0_ipaddr, &fsl_netif0_netmask, &fsl_netif0_gw, &fsl_enet_config0, ethernetif0_init, tcpip_input); 将tcpip_input API 传递给netif_add API 作为输入回调函数,该函数被调用以在协议层堆栈中向上传递入口数据包 接下来,我们需要启用该接口 “up” 状态的接口可用于应用程序的输入和输出操作,“down” 则是相反的状态。因此,在使用接口之前,必须先启用它。启用方式取决于接口获取 IP 地址的方式,我们可以使用静态 IP 地址或 DHCP。 将网络接口设置为默认网络接口 netifapi_netif_set_default(&fsl_netif0); 启动该接口,准备进行处理 netifapi_netif_set_up(&fsl_netif0); 2.初始化LwIP协议栈 调用tcpip_init创建tcpip_thread,该线程独占访问LwIP核心函数。其他线程使用消息框与该线程进行通信。它还启动所有计时器以确保它们在正确的线程上下文中运行。 tcpip_init(NULL, NULL); void tcpip_init(tcpip_init_done_fn initfunc, void *arg) { lwip_init(); tcpip_init_done = initfunc; tcpip_init_done_arg = arg; 如果 (sys_mbox_new(&tcpip_mbox,TCPIP_MBOX_SIZE) != ERR_OK) { LWIP_ASSERT("无法创建 tcpip_thread mbox", 0); } #if LWIP_TCPIP_CORE_LOCKING 如果 (sys_mutex_new(&lock_tcpip_core) != ERR_OK) { LWIP_ASSERT("无法创建lock_tcpip_core", 0); } #endif /* LWIP_TCPIP_CORE_LOCKING */ sys_thread_new(TCPIP_THREAD_NAME,tcpip_thread,NULL,TCPIP_THREAD_STACKSIZE,TCPIP_THREAD_PRIO); } 用户任务的优先级不应超过 tcpip_thread 的优先级 - 在 lwipopts.h 中,tcpip_thread的优先级 #定义 TCPIP_THREAD_PRIO 2 3. 使用顺序 API 如下图所示,客户端建立TCP连接的步骤如下: 使用netconn_new()函数创建连接; 使用netconn_connect()函数连接服务器的地址; 通过 netconn_recv() 和 netconn_write() 函数发送和接收数据。 通过 netconn_close() 函数关闭连接。 服务器端建立TCP连接的步骤如下: 使用netconn_new()函数创建TCP连接; 使用netconn_bind()函数将服务器绑定到一个地址; 使用netconn_listen()函数监听连接; 使用 netconn_accept() 函数接受连接。此调用通常会被阻塞,直到客户端连接到服务器。 通过netconn_write()和netconn_recv()发送和接收数据。 通过 netconn_close() 函数关闭连接。 中间件/lwip/contrib/appa/tcpecho/tcpecho.c 静态空隙 tcpecho_thread ( void *arg) { struct netconn *conn, *newconn; err_t err; LWIP_UNUSED_ARG(参数); /* 创建一个新的连接标识符。*/ /* 将连接绑定到众所周知的端口号 7。*/ #if LWIP_IPV6 conn = netconn_new(NETCONN_TCP_IPV6); netconn_bind(conn,IP6_ADDR_ANY,7); #else /* LWIP_IPV6 */ conn = netconn_new ( NETCONN_TCP ); netconn_bind (conn,IP_ADDR_ANY,7); #endif /* LWIP_IPV6 */ LWIP_ERROR("tcpecho: invalid conn", (conn != NULL), return;); /* 告诉连接进入监听模式。 */ netconn_listen(conn); 而(1){ /* 抓住新的连接。 */ err = netconn_accept(conn, &newconn); /* printf ("接受新连接 %p\n", newconn );*/ /* 处理新的连接。 */ if (err == ERR_OK) { 结构netbuf *buf; void *data; u16_t len; while ((err = netconn_recv (newconn, &buf)) == ERR_OK ) { /* printf ("已收到\n");*/ do { netbuf_data(buf, &data, &len); err = netconn_write (newconn、数据、长度、NETCONN_COPY); #if 0 if (err != ERR_OK) { printf( “ tcpecho :netconn_write:错误\”%s\”\n” ,lwip_strerr(err)); } #endif }当(netbuf_next(buf)> = 0)时; netbuf_delete(buf); } /* printf ("获取 EOF,循环\n");*/ /* 关闭连接并丢弃连接标识符。*/ netconn_close (新连接); netconn_delete (newconn); } } } 从 tcpecho 线程中我们可以看到 首先,通过 API netconn_new 调用参数NETCONN_TCP建立一个新的 TCP 连接。 #定义netconn_new(t)netconn_new_with_proto_and_callback(t,0,NULL) 结构 netconn * netconn_new_with_proto_and_callback(枚举 netconn_type t,u8_t proto,netconn_callback 回调) { 结构 netconn *conn; API_MSG_VAR_DECLARE(msg); API_MSG_VAR_ALLOC_RETURN_NULL(msg); conn = netconn_alloc(t,回调); 如果(conn!= NULL){ err_t err; API_MSG_VAR_REF(msg).msg.n.proto = proto; API_MSG_VAR_REF(msg).conn = conn; err = netconn_apimsg(lwip_netconn_do_newconn, &API_MSG_VAR_REF(msg)); if (err != ERR_OK) { LWIP_ASSERT("释放 conn 而不释放 pcb", conn->pcb.tcp == NULL); LWIP_ASSERT("conn 没有 recvmbox", sys_mbox_valid(&conn->recvmbox)); #if LWIP_TCP LWIP_ASSERT("conn->acceptmbox不应该存在", !sys_mbox_valid(&conn->acceptmbox)); #endif /* LWIP_TCP */ #if !LWIP_NETCONN_SEM_PER_THREAD LWIP_ASSERT("conn 没有 op_completed", sys_sem_valid(&conn->op_completed)); sys_sem_free(&conn->op_completed); #endif /* !LWIP_NETCONN_SEM_PER_THREAD */ sys_mbox_free(&conn->recvmbox); memp_free(MEMP_NETCONN, conn); API_MSG_VAR_FREE(msg); return NULL; } } API_MSG_VAR_FREE(msg); return conn; } 然后,通过调用API函数netconn_bind将新创建的连接绑定到端口7(echo协议)。 接下来,应用程序通过调用API函数netconn_listen来启动连接的监听过程。 在无限的 while(1) 循环中,应用程序通过调用 API 函数 netconn_accept 等待新的连接。当没有传入连接时,此 API 将阻止应用程序任务。 当有传入连接时,应用程序可以通过调用 API 函数 netconn_recv 开始接收数据。传入数据在 netbuf 中接收。 应用程序可以通过调用netbuf API函数netbuf_data来获取接收到的数据。 err_t netbuf_data(结构 netbuf *buf,void **dataptr,u16_t *len) { LWIP_ERROR("netbuf_data: 无效的 buf", (buf != NULL), 返回 ERR_ARG;); LWIP_ERROR("netbuf_data: invalid dataptr", (dataptr != NULL), return ERR_ARG;); LWIP_ERROR("netbuf_data: invalid len", (len != NULL), return ERR_ARG;); 如果 (buf->ptr == NULL) { return ERR_BUF; } *数据指针 = 缓冲区->ptr->有效载荷; *len = buf->ptr->len; return ERR_OK; } 通过调用 API 函数 netconn_write 将接收到的数据发送回(回显)到远程 TCP 客户端。 netconn_close和netconn_delete分别用于关闭和删除netconn连接 4.配置LwIP lwipopts.h是一个用户文件,您可以使用它来完全配置 lwIP 及其所有模块。您不需要定义 lwIP 提供的每个选项;如果您不定义选项,则将使用默认值。因此,你的 lwipopts.h提供了一种覆盖 lwIP 大部分行为的方法。 在多线程模式下,。我们需要将 NO_SYS #define 为 0。 请参考evkbimxrt1050_lwip_tcpecho_freertos\source\lwipopts.h … #if USE_RTOS /** * SYS_LIGHTWEIGHT_PROT==1:如果您希望对某些任务进行任务间保护 * 缓冲区分配、释放和内存期间的关键区域 * 分配和释放。 */ #定义SYS_LIGHTWEIGHT_PROT 1 /** * NO_SYS==0: 使用 RTOS */ #定义NO_SYS 0 /** * LWIP_NETCONN==1: 启用Netconn API (需要使用 api_lib.c) */ #定义LWIP_NETCONN 1 /** * LWIP_SOCKET==1: 启用Socket API (需要使用sockets.c) */ #定义LWIP_SOCKET 1 /** * LWIP_SO_RCVTIMEO==1: 启用套接字/网络连接的接收超时和 * SO_RCVTIMEO处理。 */ #定义LWIP_SO_RCVTIMEO 1 … 回复:使用顺序 API 开发 LwIP 应用程序 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
Daniel, 在进行 netif API 调用之前我不需要建立活动的网络连接吗?如果我在调用 netif_dhcp_start() 时没有连接网线,但稍后我连接了它,我永远不会看到 dhcp 状态变量转到 DHCP_STATE_BOUND。因此,我认为会有一个回调或状态变量让我知道链接何时启动或关闭,但我似乎无法在 MCUXpresso SDK 或 LwIP 中找到它。如何检测和报告链接状态? 谢谢!
View full article