TCP#

lwIP Socket API

前置阅读:Wi-Fi STA 连接

WS53 的 TCP 示例先通过 Wi-Fi STA 扫描并连接指定 AP,完成 DHCP 后,再启动 TCP Client 或 TCP Server。

学习目标#

  • 理解 Wi-Fi STA、DHCP 和 TCP Socket 的衔接关系。

  • 掌握 TCP Client 的 socket → bind → connect → send 流程。

  • 掌握 TCP Server 的 socket → bind → listen → accept → recv 流程。

  • 根据串口日志定位 Wi-Fi、DHCP、Socket 和对端服务问题。

基本概念#

WS53 网络数据路径#

        flowchart LR
    A[WS53 STA] --> B[扫描 AP]
    B --> C[关联目标 AP]
    C --> D[DHCP 获取 IP]
    D --> E[lwIP TCP Socket]
    E --> F[同网段 PC 或服务器]
    

WS53 使用 lwIP 提供的 BSD Socket 风格接口。TCP 建立可靠、有序的字节流连接,但不保留应用消息边界;一次 send 对应的内容可能被对端一次或多次 recv 取出。

对比项

TCP Client

TCP Server

主动方

WS53 主动连接 PC/服务器

PC/服务器主动连接 WS53

关键调用

connect

bind、listen、accept

地址配置

需要目标 IP 和端口

监听本地端口,地址为 0.0.0.0

示例行为

建立连接后周期发送

接收对端数据并打印

Wi-Fi 前置流程#

TCP 任务不会直接启动 Socket。wifi_sta_sample_init() 首先注册事件回调,并等待 Wi-Fi 初始化完成,随后依次执行以下步骤:

  1. 调用 wifi_sta_enable() 创建 STA 接口。

  2. 调用 wifi_sta_scan() 扫描附近 AP。

  3. 精确匹配 SSID 为 tcp_test 的目标 AP。

  4. 根据扫描结果中的 BSSID 和安全类型,调用 wifi_sta_connect() 发起连接。

  5. 在 wlan0 接口上调用 netifapi_dhcp_start() 启动 DHCP。

  6. 获取到非零 IP 地址后,调用 CmdTcpSample() 创建 TCP 任务。

参数

默认值

SSID

tcp_test

密码

1a2b3c4d

Client 目标 IP

192.168.50.100

TCP 端口

5001

TCP 数据缓冲

100 字节

DHCP 检查

最多 300 次循环

实际使用前应修改源码中的演示 SSID、密码和目标地址。

涉及 API#

API

用途

wifi_register_event_cb()

注册扫描和连接事件

wifi_sta_enable()

启用 Wi-Fi STA

wifi_sta_scan()

扫描 AP

wifi_sta_get_scan_info()

获取扫描结果

wifi_sta_connect()

连接目标 AP

netifapi_netif_find()

查找 wlan0 接口

netifapi_dhcp_start()

启动 DHCP

socket(AF_INET, SOCK_STREAM, 0)

创建 TCP Socket

setsockopt()

设置地址复用和收发超时

bind()

绑定本地地址和端口

listen() / accept()

Server 监听并接受连接

connect()

Client 连接对端

send() / recv()

TCP 数据收发

closesocket()

关闭 Socket

案例说明#

TCP Client#

WS53 连接 192.168.50.100:5001 后,周期创建发送任务,发送 100 字节由字符 0~9 循环填充的测试数据,并打印发送成功或失败日志。Client 不等待对端回复。

TCP Server#

WS53 在本地端口 5001 监听,等待 PC 或其他 TCP Client 连接。连接建立后,Server 循环接收最多 100 字节数据,累计接收字节数并打印内容;对端关闭后退出接收循环。

参数

Client

Server

业务任务优先级

20

5

业务任务栈

0x2000

0x2000

发送任务优先级

2

不使用

TCP 缓冲长度

100 字节

100 字节

发送间隔

约 30 秒

由对端决定

发送超时

10 秒

不使用

关键配置#

Client:

CONFIG_ENABLE_WIFI_SAMPLE=y
CONFIG_SUPPORT_TCP_CLIENT_SAMPLE=y

Server:

CONFIG_ENABLE_WIFI_SAMPLE=y
CONFIG_SUPPORT_TCP_SERVER_SAMPLE=y

两个 TCP 角色位于同一个 Kconfig choice 中,不能同时选择。

宏

值

作用

TCP_SAMPLE_DEFAULT_PORT

5001

Client 目标端口和 Server 监听端口

TCP_SAMPLE_DEFAULT_TCP_SAMPLE_BUFLEN

100

TCP 缓冲长度

TCP_SAMPLE_DEFAULT_RX_TIMEOUT

60

Server 接收超时,按当前源码换算为 60 毫秒;宏注释中的秒与实现不一致

TCP_SAMPLE_DEFAULT_TX_TIMEOUT

10

Client 发送超时,单位:秒

WIFI_TCP_SAMPLE_DST_IP

192.168.50.100

Client 默认目标 IP

WIFI_SSID

tcp_test

演示 SSID

WIFI_TEST

1a2b3c4d

演示密码

案例操作指导#

第一步:准备对端#

  • Client 模式:在 192.168.50.100 上准备 TCP Server,监听 5001。

  • Server 模式:准备 PC 端 TCP Client,等待 WS53 获取 DHCP 地址后连接 WS53_IP:5001。

  • 确保 PC 与 WS53 在同一局域网,防火墙允许 TCP 5001。

第二步:修改网络参数#

编辑 src/application/samples/wifi/tcp_sample/tcp_sample.c:

#define WIFI_TCP_SAMPLE_DST_IP "192.168.50.100"
#define WIFI_SSID "tcp_test"
#define WIFI_TEST "1a2b3c4d"
#define TCP_SAMPLE_DEFAULT_PORT 5001

第三步:编译和烧录#

fbb build ws53_liteos_app
fbb flash ws53_liteos_app

完整步骤请参考快速入门。

第四步:验证 Wi-Fi#

确认串口依次出现 Scan start、Connect succ、DHCP start 和 STA DHCP success。扫描不到目标 SSID 或 DHCP 超时,程序会回到初始化状态并重新扫描。

第五步:验证 TCP#

Client 模式确认出现 Start TcpSample client 和 Send Packet Succ;对端应收到 100 字节测试数据。Server 模式确认出现 Start TcpSample Server,从 PC 连接 WS53_IP:5001 并发送 hello ws53,串口应看到 Recv Msg。

代码详解#

1. 文件结构#

src/application/samples/wifi/
├── tcp_sample/
│   ├── tcp_sample.c       # STA 前置流程、Socket 和 Client/Server 任务
│   └── CMakeLists.txt
└── Kconfig

2. TCP Client 创建连接#

sock = socket(AF_INET, SOCK_STREAM, 0);
setsockopt(sock, SOL_SOCKET, SO_REUSEADDR, &reuse, sizeof(reuse));
bind(sock, local, addrLen);
context->trafficSock = sock;
connect(sock, remote, addrLen);

3. TCP Server 接收连接#

sock = socket(AF_INET, SOCK_STREAM, 0);
setsockopt(sock, SOL_SOCKET, SO_REUSEADDR, &reuse, sizeof(reuse));
bind(sock, local, addrLen);
listen(sock, 0);
accept(sock, remote, &addrLen);

Server 绑定 IPADDR_ANY,当前 backlog 参数为 0,只适合单连接演示。

4. Server 接收循环#

while (context->isFinish == FALSE) {
    recvLen = recv(context->trafficSock, context->param.buffer,
                   context->param.bufLen, 0);
    if (recvLen > 0) {
        context->param.total += (uint32_t)recvLen;
        PRINT("Recv Msg");
    }
}

5. Client 周期发送#

Client 建立连接后创建发送任务,使用共享缓冲区发送 100 字节数据;主任务约每 30 秒再次创建发送任务。源码用互斥锁保护共享上下文,但发送成功路径没有调用 osal_mutex_unlock()。修正该问题前,后续发送任务可能阻塞在同一互斥锁上,不能把首次发送成功当作周期发送已经稳定运行。