LwIP 提供了三种主要的 API 接口，分别针对不同的应用场景（如实时性、易用性、资源占用等），开发者可根据需求选择。

LwIP 提供了三种主要的 API 接口，分别针对不同的应用场景（如实时性、易用性、资源占用等），开发者可根据需求选择。三种 API 分别是：

1.RAW API（原始 API）

• 特点：
  最底层的 API，直接与 LwIP 内核交互，无操作系统依赖，通过回调函数（callback）处理协议栈事件（如数据接收、连接建立等）。
  不使用线程，所有操作在协议栈的事件处理上下文（通常是中断或定时器回调）中完成，资源占用极低（适合内存/算力受限的嵌入式设备）。

• 核心机制：
  基于事件驱动，例如：

  • 注册recv_callback处理收到的数据；
  • 注册connect_callback处理连接建立结果。

• 适用场景：
  无 OS 的裸机系统、对资源（RAM/ROM）要求严格的嵌入式设备（如单片机）、需要最高效率和实时性的场景。

• 示例（TCP 服务器）：
  通过tcp_listen()创建监听，注册accept回调；新连接到来时，在回调中注册recv回调处理数据。

2.NETCONN API（网络连接 API）

• 特点：
  基于 RAW API 封装的半阻塞式 API，通常与操作系统（OS）配合使用（依赖线程和信号量），提供类似“连接”的抽象（如netconn_new()创建连接、netconn_connect()建立连接）。
  操作可以阻塞（等待事件）或非阻塞，通过函数返回值判断操作结果（如netconn_recv()阻塞等待数据）。

• 核心机制：
  以“连接对象（struct netconn）”为核心，封装了底层的 socket 操作，隐藏了回调细节，提供更直观的函数接口（如netconn_send()、netconn_recv()）。

• 适用场景：
  有操作系统的嵌入式系统（如 RTOS），希望简化开发（避免直接处理回调），同时保持较好的资源效率。

• 示例（TCP 客户端）：

  structnetconn*conn=netconn_new(NETCONN_TCP);netconn_connect(conn,&server_addr,server_port);// 连接服务器netconn_send(conn,"hello");// 发送数据structnetbuf*buf;netconn_recv(conn,&buf);// 阻塞接收数据

3.Socket API（BSD 兼容套接字 API）

• 特点：
  兼容BSD Socket 标准的高层 API，与常见的 Linux/Windows 套接字接口几乎一致（如socket()、bind()、connect()、recv()、send()、select()等）。
  依赖操作系统提供线程支持，操作以阻塞/非阻塞方式进行，开发门槛最低（熟悉 BSD Socket 的开发者可快速上手）。

• 核心机制：
  在 NETCONN API 之上进一步封装，模拟标准套接字的行为，支持select()/poll()等多路复用机制，提供最高的易用性。

• 适用场景：
  有操作系统（如 Linux、RTOS）、希望代码可移植（兼容传统 Socket 程序）、追求开发效率的场景。

• 示例（UDP 通信）：

  intsock=socket(AF_INET,SOCK_DGRAM,0);// 创建 UDP 套接字bind(sock,(structsockaddr*)&local_addr,sizeof(local_addr));sendto(sock,"data",4,0,(structsockaddr*)&peer_addr,sizeof(peer_addr));charbuf[100];recvfrom(sock,buf,sizeof(buf),0,NULL,NULL);// 接收数据

三种 API 的对比总结

选择时需根据系统资源、开发效率、移植性等需求权衡：资源紧张选 RAW API，追求易用性和移植性选 Socket API，中间场景选 NETCONN API。