赛灵思平台 lwIP 断线重连深度解析与实现指南

1. 引言

在基于赛灵思 Zynq / MicroBlaze 的嵌入式网络应用中，lwIP（Lightweight IP）是使用最广泛的 TCP/IP 协议栈。实际部署中，网络环境复杂多变，网线松动、交换机重启、对端服务器崩溃等都会导致 TCP 连接异常中断。若应用不具备自动重连能力，一旦断开就需要人工复位或重启设备，这在无人值守、远程监控等场景下不可接受。

本文将从原理到实践，系统介绍如何在赛灵思平台（以 Zynq-7000 为例）的 lwIP RAW API 模式下实现可靠的 TCP 客户端断线重连机制，包括连接断开检测、资源清理、重连策略以及常见陷阱，并结合实际代码进行讲解。

2. 断线重连的基本原理

TCP 是一个有状态的协议，连接断开通常由以下几种情况触发：

对端主动发送 RST：服务器关闭连接或拒绝连接。

Keep-Alive 超时：长期无数据交互，lwIP 保活探测失败。

重传超时：TCP 段多次重传仍无 ACK，lwIP 判定连接死亡。

本端主动关闭：应用层因错误主动调用 tcp_close() 或 tcp_abort()。

1. 及时感知连接已不可用；

2. 彻底释放旧的协议控制块（PCB）；

3. 重新创建PCB 并发起新的三次握手。

这三个环节缺一不可，尤其是资源清理，如果旧 PCB 没有正确释放，不仅会导致内存泄漏，还可能使后续连接混乱。

3. 连接断开检测：两种互补手段

lwIP RAW API 下，应用层有两种主流方式获知连接已断开：错误回调和状态轮询。两者通常结合使用，前者用于实时响应，后者作为保底。

3.1 使用 tcp_err 错误回调

在连接建立成功后，应立即注册一个错误回调函数。当 lwIP 内核检测到连接发生致命错误（如重传次数达到上限TCP_SYNMAXRTX/TCP_MAXRTX，或接收到 RST）时，会自动调用该回调。

static void tcp_client_err(void *arg, err_t err) { LWIP_UNUSED_ARG(err); u64_t now = get_time_ms(); u64_t diff_ms = now - client.start_time; tcp_client_close(c_pcb); // 清理PCB c_pcb = NULL; tcp_conn_report(diff_ms, TCP_ABORTED_REMOTE); xil_printf("TCP connection aborted\n\r"); }

其中的tcp_client_close负责安全释放 PCB：

static void tcp_client_close(struct tcp_pcb *pcb) { if (pcb != NULL) { tcp_sent(pcb, NULL); tcp_err(pcb, NULL); err_t err = tcp_close(pcb); if (err != ERR_OK) { tcp_abort(pcb); // 强制中止 } } }

重点：错误回调中绝不能直接调用tcp_close()，因为此时 PCB 可能处于不可预期的状态。最佳实践是先尝试tcp_close()，若返回错误则立即调用tcp_abort()强制释放。清理完成后，必须将全局 PCB 指针置NULL，作为“空闲”标志。

tcp_err 回调在 lwIP 内核检测到连接致命错误时自动调用，例如重传次数达到最大值（TCP_SYNMAXRTX / TCP_MAXRTX）或接收到 RST。在该回调中，绝不能直接调用 tcp_close()，因为此时 PCB 可能处于不可预期的状态。官方推荐调用 tcp_abort() 立即释放资源，或设置一个标志位，由主循环异步处理。

3.2 主循环状态轮询

错误回调可能因内核版本、配置差异而未触发，因此在主循环中周期性检查 PCB 状态是一种可靠补充。

while (1) { if (TcpFastTmrFlag) { if(request_pcb->state == CLOSED || (request_pcb->state == SYN_SENT && request_pcb->nrtx == TCP_SYNMAXRTX))//check conditions for create new tcp connection { start_application(); } tcp_fasttmr(); TcpFastTmrFlag = 0; } if (TcpSlowTmrFlag) { tcp_slowtmr(); TcpSlowTmrFlag = 0; } xemacif_input(netif); /* if connected to the server, start receive data from PL through axidma, then transmit the data to the PC software by TCP*/ if(client_connected && tcp_trans_start)// if tcp connection is setup transfer_data();//call send_received_data() function sent data from ddr else { fdma_wr_set(0); first_trans_start = 0; } }

这里通过检查 state 字段来识别几种情况：

state == CLOSED：连接已经进入关闭状态，但 PCB 尚未被回收。

state == SYN_SENT && nrtx == TCP_SYNMAXRTX：发起连接时重传次数已达上限，连接建立失败。

注意：对 CLOSED 或死掉的 PCB，必须立即清理（调用 tcp_abort 或 tcp_close）后再调用 reconnect_connection，否则新连接会受到影响。

4. 连接清理：彻底释放 PCB 资源

在发起重连前，必须确保旧的 PCB 被彻底释放。在 lwIP 中，PCB 结构体内嵌了发送、接收缓冲区等多种资源，若只把指针置 NULL 而不调用关闭函数，会造成严重的内存泄漏。

标准清理流程（可放在 reconnect_connection 函数开头或单独函数中）：

static void cleanup_connection() { struct tcp_pcb *pcb = c_pcb; if (pcb == NULL) return; // 移除所有回调，防止内核再调用 tcp_arg(pcb, NULL); tcp_sent(pcb, NULL); tcp_recv(pcb, NULL); tcp_poll(pcb, NULL, 0); tcp_err(pcb, NULL); // 尝试主动关闭，若失败则强制中止 err_t err = tcp_close(pcb); if (err != ERR_OK) { tcp_abort(pcb); } c_pcb = NULL; }

关键点：

tcp_close() 只能用于处于 ESTABLISHED、CLOSE_WAIT 等可以正常四次挥手的连接。对于已经僵死的连接（如 SYN_SENT 超时），它会返回 ERR_OK 之外的错误，此时必须用 tcp_abort() 强制销毁。

清理后必须将全局 PCB 指针置 NULL，作为“空闲”标志。

5. 发起重连：reconnect_connection 实现

重连意味着创建全新的 PCB，配置回调，然后发起 tcp_connect。示例实现：

static void reconnect_connection(int conn_id) { // 1. 先清理旧连接 cleanup_connection(); // 2. 创建新 PCB struct tcp_pcb *pcb = tcp_new(); if (pcb == NULL) { xil_printf("Error: tcp_new() failed\r\n"); return; } // 3. 绑定本地端口（可选，通常设置为 0 让 lwIP 自动分配） tcp_bind(pcb, IP_ADDR_ANY, 0); // 4. 注册回调 tcp_arg(pcb, (void*)conn_id); // 传递连接 ID tcp_err(pcb, tcp_client_err); // 必须最先注册 tcp_recv(pcb, tcp_client_recv); tcp_sent(pcb, tcp_client_sent); // 5. 发起连接 ip_addr_t server_ip; IP4_ADDR(&server_ip, 192, 168, 3, 100); // 目标服务器 IP err_t err = tcp_connect(pcb, &server_ip, 5001, tcp_client_connected); if (err != ERR_OK) { xil_printf("tcp_connect failed: %d\r\n", err); tcp_abort(pcb); // 本地错误，立即释放 c_pcb[conn_id] = NULL; return; } // 连接请求已发出，等待 tcp_client_connected 回调 }

注意：

tcp_connect 返回 ERR_OK 仅表示 SYN 段成功发出，连接还没有建立。真正成功时会调用 tcp_client_connected 回调，你需要在该回调中把 c_pcb[conn_id] = pcb，并设置 tcp_recv 等业务处理。

如果 tcp_connect 返回错误（如 ERR_RTE、ERR_MEM），应立即调用 tcp_abort 释放刚创建的 PCB，避免泄漏。

6. 完整的主循环集成

在 main() 的主循环中，除了重连逻辑，还必须包含接收包处理和 lwIP 定时器驱动：

TcpFastTmrFlag 和 TcpSlowTmrFlag 通常由定时器中断服务程序设置，保证 lwIP 定时器以 250ms/500ms 周期执行。

7. 重连策略优化：退避与限制

无脑立即重连可能加剧网络拥塞，尤其在大量设备同时掉线恢复时。建议加入退避策略：

#define MAX_RECONNECT_DELAY 60000 // 60 秒 static int reconnect_delay[TCP_MAX_CONNECTIONS] = {0}; void attempt_reconnect(int conn_id) { if (reconnect_delay[conn_id] == 0) { reconnect_delay[conn_id] = 1000; // 初始延迟 1 秒 } else { reconnect_delay[conn_id] = MIN(reconnect_delay[conn_id] * 2, MAX_RECONNECT_DELAY); } // 可创建一个定时器或使用系统时钟，延迟后调用 reconnect_connection }

如果使用了操作系统（如 FreeRTOS），可以通过任务延时实现；裸机环境下可以用全局计时变量配合状态机。

8. 常见问题与调试技巧

8.1 内存泄漏

重连后 heap 或 memp 内存不断减少，通常是因为旧 PCB 没有被 tcp_abort 彻底销毁。可以在 lwipopts.h 中启用统计信息（LWIP_STATS 和 LWIP_STATS_DISPLAY），定期打印 tcp_pcb_list 数量来诊断。

8.2 重连后收发不正常

注意 tcp_recv 回调中的 pbuf 处理。连接重建后，tcp_recv 的参数 tpcb 已经是新 PCB，确保内部使用的连接上下文指向正确的新 PCB，而不是残留的旧指针。

8.3 快速重连导致 ARP 问题

如果服务器 MAC 地址发生变化，lwIP 可能仍使用缓存的 ARP 表项。可在重连前调用 etharp_cleanup_netif(netif) 清空 ARP 表，或使能 LWIP_ARP_FILTER_NETIF 等选项。

9. 总结

赛灵思平台下基于 lwIP RAW API 的 TCP 断线重连实现，核心在于严谨的状态检测和 PCB 生命周期管理。牢记三个步骤：

检测 —— 通过 tcp_err 回调和主循环轮询 pcb->state，确保及时发现连接断开。

清理 —— 使用 tcp_abort 或 tcp_close 释放旧 PCB，并置空全局指针。

重连 —— 创建新 PCB，重新调用 tcp_connect，并在成功回调中启用业务数据收发。

配合合理的退避策略和资源监控，就能构建一个稳定可靠的长连接 TCP 客户端应用。

本文描述的代码框架已在 Xilinx Zynq-7000 (XC7Z020) 平台上通过实际测试，可广泛应用于工业数据采集、远程控制等需要持续网络连接的场景。