LwIP 提供了三种主要的 API 接口,分别针对不同的应用场景(如实时性、易用性、资源占用等),开发者可根据需求选择。
2026/7/27 12:55:34 网站建设 项目流程

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 APINETCONN APISocket API
依赖无 OS需 OS(线程支持)需 OS(线程支持)
编程模式事件驱动(回调)半阻塞(函数调用)阻塞/非阻塞(类 BSD)
资源占用极低中等较高
易用性低(需理解内核机制)高(兼容标准)
实时性高(无线程切换)中(依赖 OS 调度)
典型应用裸机单片机RTOS 嵌入式系统带 OS 的嵌入式/PC

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

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询