📚 课程目录第3章网络编程基础

3. 网络编程基础

在 RT-Thread 上做网络与 IoT 开发，第一步不是急着写 MQTT 或 HTTP，而是把“数据从应用层一路走到网线/射频”的路径看清楚。TCP/IP 协议栈是分层协作的，Socket 是应用层访问协议栈的统一入口，阻塞与非阻塞决定线程如何等待数据，调试工具则帮助我们在链路、IP、端口、报文四个层面定位问题。本节把这四件事串成一条可操作的开发主线。

一、TCP/IP 分层模型：数据如何被逐层封装

TCP/IP 通常划分为四层：应用层、传输层、网络层（IP 层）、网络接口层。RT-Thread 的 SAL（Socket Abstraction Layer）位于应用层与传输层之间，向上提供标准 BSD Socket，向下可对接 lwIP、W5500、ESP8266 等不同协议栈或网卡。理解分层的关键是“封装”与“解封装”：发送时每层加自己的头部，接收时逐层剥离并校验。

以一次 TCP 发送为例：应用层产生业务数据；传输层加 TCP 头（源端口、目的端口、序号、确认号、标志位）；网络层加 IP 头（源 IP、目的 IP、协议号、TTL）；网络接口层加以太网头（源 MAC、目的 MAC、类型）并计算 FCS。接收端反向剥离，最终把数据交给对应 Socket 的接收缓冲区。

二、Socket 编程接口：TCP 客户端与服务端的调用时序

Socket 是协议栈暴露给应用层的“文件描述符式”接口。RT-Thread 中常用接口包括：socket() 创建套接字，bind() 绑定本地地址与端口，listen() 进入监听，accept() 取出已完成三次握手的连接，connect() 发起连接，send()/recv() 收发数据，close() 关闭并释放资源。TCP 服务端必须先 bind+listen，客户端通常直接 connect。

/* TCP 客户端核心流程（RT-Thread SAL） */
int sock = socket(AF_INET, SOCK_STREAM, 0);
struct sockaddr_in server;
server.sin_family = AF_INET;
server.sin_port   = htons(1883);
server.sin_addr.s_addr = inet_addr("192.168.1.100");

if (connect(sock, (struct sockaddr *)&server, sizeof(server)) == 0) {
    send(sock, "hello", 5, 0);
    recv(sock, buf, sizeof(buf), 0);
}
closesocket(sock);

需要特别注意字节序：端口和 IP 必须用 htons()、htonl() 转成网络字节序；inet_addr() 或 inet_pton() 用于点分十进制转二进制。服务端 accept 返回的是“新连接套接字”，原监听套接字继续用于接受后续连接，二者不能混用。

三、阻塞与非阻塞 IO：等待策略决定系统实时性

默认创建的 Socket 是阻塞的：调用 recv() 时若接收缓冲区无数据，线程会挂起，直到有数据、连接关闭或出错。阻塞模式编程简单，但一个线程只能服务一个连接，容易拖慢其他任务。非阻塞模式下，recv() 无数据立即返回 -1 并置 errno 为 EAGAIN，需要配合轮询或 select()/poll() 多路复用。

对比项	阻塞 IO	非阻塞 IO
无数据时行为	线程挂起等待	立即返回 EAGAIN
编程复杂度	低，顺序逻辑清晰	高，需事件循环或 select
并发能力	一连接一线程	单线程可管理多连接
实时性影响	可能长期占用线程	可控，适合多任务
典型场景	简单客户端、调试	MQTT 长连接、多路服务器

在 RT-Thread 中，可通过 select() 同时等待多个 Socket 的可读事件，再对就绪的 Socket 调用 recv()，这样既避免阻塞整个线程，也避免空轮询浪费 CPU。

四、常见网络调试工具与排障思路

网络问题往往跨层出现，建议按“物理链路 → IP 连通性 → 端口可达性 → 应用报文”的顺序排查。常用工具包括：ping 验证 IP 层连通与 RTT；ifconfig 查看本机 IP、掩码、网关和网卡状态；netstat 查看监听端口与连接状态；telnet 或 nc 测试 TCP 端口是否可连；tcpdump 抓包分析握手、重传、RST；Wireshark 做协议级解码。

# 在 PC 端测试设备端口是否开放
ping 192.168.1.50
telnet 192.168.1.50 1883
nc -zv 192.168.1.50 1883

# 在设备端查看网络状态（RT-Thread 常用命令）
ifconfig
netstat -an
ping 192.168.1.1

常见误区：只 ping 通就认为“网络没问题”。ping 走 ICMP，不能证明 TCP 端口开放；端口不通可能是防火墙、服务未 listen、bind 地址错误或 accept 未调用。另一个误区是忽略 errno，把 EAGAIN 当成致命错误直接关闭连接，导致非阻塞逻辑频繁断线。

五、案例复盘：一次 MQTT 连接失败的定位过程

某设备使用 RT-Thread + lwIP 连接 MQTT 服务器，现象是 connect() 返回 -1。按层排查：先用 ifconfig 确认设备已获取 192.168.1.50；再 ping 192.168.1.100 通，说明 IP 层正常；PC 端 telnet 192.168.1.100 1883 也通，说明服务器端口开放；最后检查设备代码，发现 server.sin_port 直接写了 1883 而未用 htons()，在小端平台上端口被解释为 0x5B07，连接自然失败。改为 htons(1883) 后连接成功。这个案例说明：分层模型不仅是理论，更是排障顺序；Socket 参数中的字节序、地址结构体长度、返回值检查，都是最容易踩的坑。

掌握本节内容后，应能画出一次 TCP 通信的封装路径，能写出正确的客户端/服务端 Socket 调用序列，能根据实时性要求选择阻塞或非阻塞模型，并能用 ping、netstat、telnet、tcpdump 等工具按层定位问题。这些能力是后续 MQTT、HTTP、CoAP 等 IoT 协议开发的基础。