4. RT-Thread网络框架
RT-Thread 的网络能力并不是“一个协议栈打天下”，而是通过分层与抽象把应用、协议栈、网卡驱动解耦。理解这套框架的关键，是抓住三个核心对象：SAL（Socket Abstraction Layer，套接字抽象层）、netdev（网卡设备层）以及协议栈接入方式。它们共同决定了应用代码能否跨协议栈复用、驱动能否被统一管理、组件之间如何依赖。
一、核心原理：三层解耦与统一接口
RT-Thread 网络框架自上而下可理解为三层：应用层通过标准 BSD Socket API 调用 SAL；SAL 根据当前选定的协议栈，把请求分发到具体协议栈实现；协议栈再通过 netdev 提供的网卡设备接口收发数据帧。netdev 位于协议栈与网卡驱动之间，向上提供统一的 rt_netdev_ops 操作集，向下屏蔽不同以太网、Wi-Fi、4G 模组的差异。
SAL 的价值在于“一次编写，多协议栈运行”。当系统同时存在 lwIP、AT Socket、WIZnet 等协议栈时，SAL 通过 sal_socket 结构体维护协议栈注册表，应用调用 socket()、connect()、send() 时，SAL 会查找对应协议栈的 ops 并转发。netdev 的价值在于“网卡即设备”，每张网卡注册后拥有独立名称（如 e0、w0），可被协议栈绑定、被 ifconfig 查看、被 ping 测试。
二、方法流程：从网卡注册到 Socket 通信
一个典型的网络初始化流程如下：
- 驱动注册网卡：网卡驱动调用
rt_netdev_add()，把struct netdev加入 netdev 链表，并指定ops与名称。 - 协议栈绑定网卡：lwIP 通过
netif_add()把 netdev 包装为netif，设置 IP、掩码、网关。 - SAL 注册协议栈：调用
sal_proto_stack_register()，把协议栈的sal_socket_ops注册进 SAL。 - 应用调用 Socket：应用使用标准 BSD API，SAL 根据
domain/type/protocol选择协议栈并转发。 - 数据收发：协议栈通过 netdev 的
send/recv与驱动交互，完成帧的发送与接收。
/* 网卡注册示例（伪代码） */
struct netdev *dev = rt_netdev_add("e0", ð_ops, RT_NULL);
rt_netdev_set_ip(dev, "192.168.1.100", "255.255.255.0", "192.168.1.1");
rt_netdev_set_up(dev);
/* SAL 协议栈注册 */
sal_proto_stack_register(&lwip_sal_ops);
/* 应用层标准调用 */
int fd = socket(AF_INET, SOCK_STREAM, 0);
connect(fd, (struct sockaddr *)&addr, sizeof(addr));
send(fd, "hello", 5, 0);
三、组件依赖关系与接入方式对比
RT-Thread 的协议栈接入方式主要有三类：lwIP 原生接入、AT Socket 接入、硬件协议栈接入。它们对 netdev 的依赖程度不同，配置项也不同。下表给出对比清单：
| 接入方式 | 典型组件 | 是否依赖 netdev | 适用场景 | 关键配置 |
|---|---|---|---|---|
| lwIP 原生 | lwIP 2.x | 是，必须绑定 netdev | 以太网、Wi-Fi 高速通信 | RT_USING_LWIP、RT_USING_NETDEV |
| AT Socket | AT 组件 + SAL | 否，直接走 AT 通道 | 4G Cat.1、NB-IoT、Wi-Fi 模组 | RT_USING_AT、AT_USING_SOCKET |
| 硬件协议栈 | WIZnet W5500 | 可选，通常独立 | MCU 资源紧张、硬件卸载 | RT_USING_WIZNET、SPI 驱动 |
| 多协议栈共存 | SAL 统一调度 | 按协议栈而定 | 同时使用以太网与 4G | SAL_USING_LWIP、SAL_USING_AT |
socket() 的 domain 与协议栈注册顺序选择实现。若应用需要指定走某张网卡，可通过 SO_BINDTODEVICE 或路由表控制。
四、案例与误区复盘
案例：某产品使用 STM32 + 4G 模组，应用层用 MQTT 组件。开发者发现 socket() 返回失败，排查后确认只开启了 lwIP 而未开启 AT Socket，SAL 找不到可用协议栈。修正 rtconfig.h 后问题解决：
#define RT_USING_SAL
#define SAL_USING_AT
#define AT_USING_SOCKET
#define RT_USING_AT
常见误区：
- 误区一：认为 SAL 是协议栈本身。SAL 只是抽象层，不实现 TCP/IP，必须至少注册一个协议栈。
- 误区二：网卡注册后忘记
rt_netdev_set_up()，导致链路始终 down，ping不通。 - 误区三：AT Socket 场景下仍去配置 lwIP 的 IP 地址，实际上 IP 由模组分配，应通过 AT 命令查询。
- 误区四：多协议栈共存时未设置默认网卡，导致数据从错误接口发出。
ifconfig 查看 netdev 状态与 IP；再用 ping 验证链路；最后用 list_device 确认网卡设备已注册。若 SAL 层异常，检查 sal_proto_stack_register() 是否被调用。
总结来说，SAL 解决“应用接口统一”，netdev 解决“网卡管理统一”，协议栈接入方式解决“不同通信模组如何融入同一框架”。三者依赖关系清晰：应用依赖 SAL，SAL 依赖协议栈，协议栈依赖 netdev，netdev 依赖具体驱动。掌握这条依赖链，就能在 RT-Thread 上灵活组合以太网、Wi-Fi、4G 等网络能力。