1. 上位机点一下、开发板回一帧:为什么用 QUdpSocket 而不是自封 socket
上位机界面往往就一个按键加一个 TextLabel:点按键,开发板把当前状态回传,标签里显示出来。这类需求用 Qt 做,很多人第一反应是找第三方网络库,或者自己包一层 BSD socket,其实 Qt 这套代码开发工具里自带的 QUdpSocket 就够用——构造、发、收各一个函数,底层描述符的生命周期它自己管。选 UDP 而不是 TCP,是因为这里传的是一问一答的短状态帧,丢一帧最多标签空一下,再点一次就行;换成 TCP,反而要额外处理粘包、断线重连。下面按「上位机怎么绑端口、怎么收发,开发板怎么部署,联调时哪里会翻车」的顺序走一遍。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. QUdpSocket 的收发骨架:bind、readyRead 与数据报边界
2.1 构造只是拿到对象,bind 才真正占住端口
Recv_Socket = new QUdpSocket(); 这一行能编译、能跑,但如果你只写这一行就去连 readyRead,界面上点多少次按键都不会有反应。原因很直接:QUdpSocket 构造出来只是一个对象,还没和本机的某个 UDP 端口建立关联;没有关联,内核收到数据报也不知道该交给谁,readyRead 自然不触发。
常见做法是在窗口初始化时补一次 bind,再连信号槽:
cpp复制// 头文件里声明:QUdpSocket *Recv_Socket = nullptr;
// kUdpPort 是两端约定的端口常量,上位机和开发板用同一个值
Recv_Socket = new QUdpSocket(); // 定义一个通信用的文件描述符
bool ok = Recv_Socket->bind(QHostAddress::AnyIPv4, kUdpPort);
if (!ok) {
// 端口被占用或权限不足,必须处理,不能静默失败
qDebug() << "bind failed:" << Recv_Socket->errorString();
}
connect(Recv_Socket, SIGNAL(readyRead()), this, SLOT(Recv_Message()));
逻辑说明:new QUdpSocket() 只负责创建对象;bind() 把对象绑到本机地址和端口,之后内核才会把发到这个端口的数据报交给它,readyRead() 才有机会发出。connect 那一行就是标准的信号槽写法,信号是 readyRead(),槽是 Recv_Message()。
参数说明:第一个参数用 QHostAddress::AnyIPv4,表示监听本机所有 IPv4 网卡,而不是只监听某一块;上位机如果有多块网卡,写死某个地址反而会漏收。第二个参数是端口,建议定义成常量,别在发送处和绑定处各写一个数字——这两个数字对不上,就是后面排查里最常见的一类问题。bind 的返回值一定要看,返回 false 时 errorString() 会给出原因,常见的是端口已被别的进程占用。
2.2 readDatagram 的三个出参,ip 和 port 是回复的钥匙
整条链路里最关键的是这一行:
cpp复制char buf[BUFSZ]; // BUFSZ 要大于你最长的一帧报文
QHostAddress ip;
quint16 port = 0;
qint64 n = Recv_Socket->readDatagram(buf, sizeof(buf), &ip, &port);
if (n < 0) {
qDebug() << "read error:" << Recv_Socket->errorString();
return;
}
逻辑说明:readDatagram 一次取走一个数据报,返回值 n 是实际读到的字节数,失败时返回 -1。第三个、第四个参数是出参,Qt 会把「这个数据报是从哪个地址、哪个端口发来的」填进去。注意这两个出参是来源地址,不是目的地址——很多新手在这里想当然,以为读完就能直接拿来回复,实际上必须先把它们存起来,回复时才有目标。
参数说明:buf 的大小决定了单次能接多长的报文,超过这个长度会被截断,而且 Qt 不会替你报错,你只会看到界面上的字符串少了半截;所以 BUFSZ 要按你协议里最长的帧来定,宁可留一点余量。sizeof(buf) 传的是缓冲区容量,不是期望长度。ip 和 port 在调用前不需要初始化,调用后才有意义,但如果 readDatagram 返回 -1,就不要拿它们去发数据。
2.3 writeDatagram 之前,先确认 ip 和 port 不是空的
发送这一侧的调用是 Recv_Socket->writeDatagram(buf, ip, port);。在 Qt 里,第一个参数实际要的是 QByteArray,所以更稳妥的写法是显式构造:
cpp复制QByteArray payload(buf, n); // 按实际读到的长度构造,别用 sizeof(buf)
qint64 sent = Recv_Socket->writeDatagram(payload, ip, port);
if (sent < 0) {
qDebug() << "send error:" << Recv_Socket->errorString();
}
逻辑说明:这里把「收到什么就回什么」的链路闭合了——ip 和 port 来自上一步的 readDatagram 出参,payload 来自收到的字节。UDP 是无连接的,writeDatagram 返回成功只代表数据报交给了内核,不代表对方一定收到;返回 -1 才是真正的本地错误,比如地址无效、缓冲区满。
参数说明:QByteArray(buf, n) 的第二个参数是长度,一定要用 readDatagram 的返回值,而不是 sizeof(buf),否则会把缓冲区末尾的垃圾字节一起发出去。目标地址为空地址、端口为 0 时,发送会失败,这也是为什么 2.2 里强调要把出参存下来、并且判断读成功再发。同一个 QUdpSocket 既能收也能发,不必为了发送再 new 一个对象。
3. 上位机侧:把按键点击接成一次完整的 UDP 往返
3.1 按键槽函数只干一件事:把请求发到 192.168.5.100
界面上的网络通信按键可以直接转到槽,自动生成槽函数。槽里不要塞业务逻辑,只负责把一帧请求发出去:
cpp复制void MainWindow::on_pushButton_clicked()
{
QByteArray req = "GET_STATUS"; // 请求内容,两端约定即可
qint64 sent = Recv_Socket->writeDatagram(
req,
QHostAddress("192.168.5.100"), // 开发板静态地址
kUdpPort); // 与板端绑定的端口一致
if (sent < 0) {
ui->textLabel->setText("发送失败:" + Recv_Socket->errorString());
}
}
逻辑说明:按键点一次发一帧,目标固定是开发板的静态地址,端口是两端约定的同一个常量。这里不复用 2.2 里的 ip/port 出参,因为这是「主动发起」的方向,和「收到再回」是两条路径,目标本来就不一样。
参数说明:QHostAddress 直接收字符串构造,比先解析成整数再塞进结构体省事;地址写成开发板实际设置的静态地址,改板子地址时这里要同步改,建议也提成常量,和端口放在一起。发送失败时把 errorString() 打到界面上,比只显示「失败」有用得多。
3.2 Recv_Message 里把字节转成 QString 再上屏
槽函数 Recv_Message() 是在 readyRead() 触发后被调用的,里面要做的就是把字节读出来、转成文本、塞进 TextLabel:
cpp复制void MainWindow::Recv_Message()
{
char buf[BUFSZ];
QHostAddress ip;
quint16 port = 0;
qint64 n = Recv_Socket->readDatagram(buf, sizeof(buf), &ip, &port);
if (n <= 0) return;
// 保存来源,后面要回给这个地址
m_peerIp = ip;
m_peerPort = port;
QString text = QString::fromUtf8(buf, static_cast<int>(n));
ui->textLabel->setText(text);
}
逻辑说明:先读、再判长度、再转换、最后上屏。m_peerIp 和 m_peerPort 是成员变量,这里顺手把来源存下来,后续如果需要「收到后再回一帧」就直接用它们,不必重新解析。字符串转换用 fromUtf8,并显式传入 n;不传长度的话,Qt 会按 \0 截断,遇到二进制报文就丢了后半段。
参数说明:n <= 0 直接返回,避免把空报文或错误当成正常数据显示。static_cast<int>(n) 是把 qint64 收窄成 QString 构造需要的长度参数;报文长度远小于 int 上限,这里安全。如果板端发的是 GBK 编码,这里要相应换成 fromLocal8Bit,编码对不上就是后面排查里的「乱码」现象。
3.3 对端地址存成成员变量,别在槽里重新解析
把来源地址存成员变量看起来是多此一举,实际是省掉一类隐蔽问题:
cpp复制// 头文件里
QHostAddress m_peerIp;
quint16 m_peerPort = 0;
// 收到后回复
if (!m_peerIp.isNull() && m_peerPort != 0) {
Recv_Socket->writeDatagram(QByteArray("ACK"), m_peerIp, m_peerPort);
}
逻辑说明:m_peerIp 和 m_peerPort 只在 readDatagram 成功后赋值,回复前先判空。这样「谁问就回谁」,不依赖界面上手动填的地址,避免上位机换网段后回复发到旧地址。
参数说明:isNull() 判断地址是否有效,m_peerPort != 0 判断端口是否已赋值;两个条件缺一不可,只判地址的话,端口还是 0 时发送照样失败。这里的 ACK 只是示意负载,实际内容按你的协议来。
4. 开发板侧:Server.c 的改写、192.168.5.100 与交叉编译
4.1 在 UDP_Server.c 上改:谁发来的,就回给谁
板端程序不需要从零写,在原来的 UDP_Server.c 上改就行。核心逻辑是:收到上位机的数据报后,从 recvfrom 里拿到对方的地址和端口,再用同一个地址端口 sendto 回去。常见的最小骨架是这样:
c复制#include <stdio.h>
#include <string.h>
#include <arpa/inet.h>
#include <sys/socket.h>
int main(void)
{
int fd = socket(AF_INET, SOCK_DGRAM, 0);
if (fd < 0) { perror("socket"); return -1; }
struct sockaddr_in addr;
memset(&addr, 0, sizeof(addr));
addr.sin_family = AF_INET;
addr.sin_addr.s_addr = htonl(INADDR_ANY); /* 监听本机所有地址 */
addr.sin_port = htons(UDP_PORT); /* 与上位机约定的端口 */
if (bind(fd, (struct sockaddr *)&addr, sizeof(addr)) < 0) {
perror("bind");
return -1;
}
char buf[BUFSZ];
struct sockaddr_in peer;
socklen_t peer_len = sizeof(peer);
for (;;) {
ssize_t n = recvfrom(fd, buf, sizeof(buf), 0,
(struct sockaddr *)&peer, &peer_len);
if (n <= 0) continue;
/* 对方地址就在 peer 里,直接原路返回 */
const char *reply = "BOARD_OK";
sendto(fd, reply, strlen(reply), 0,
(struct sockaddr *)&peer, peer_len);
}
return 0;
}
逻辑说明:recvfrom 的第五、第六个参数是出参,和上位机的 readDatagram 是一个道理——内核把发送方地址填进 peer。sendto 直接拿 peer 当目标,就实现了「谁发来的就回给谁」,不需要在代码里写死上位机地址。
参数说明:htons(UDP_PORT) 把主机字节序转成网络字节序,端口直接写数字或宏都行,但必须和上位机一致。INADDR_ANY 表示不限定网卡。BUFSZ 要和上位机的缓冲区匹配。peer_len 每次调用前会被 recvfrom 更新,正常不需要手动重置。
4.2 静态 IP 设成 192.168.5.100,网段必须和上位机一致
板端要能被上位机直接寻址,就得有一个固定地址。我习惯把开发板设成 192.168.5.100,这个地址要和我们服务器程序、上位机程序里写的目的地址保持一致。设置方式按板端系统来,常见的是临时配一下:
bash复制# 板端执行,网卡名以实际为准(eth0 / end0 等)
ifconfig eth0 192.168.5.100
逻辑说明:这条命令只改运行时的地址,重启后失效;量产或长期联调时再写进启动脚本或网络配置文件。上位机那一侧的地址必须在同一网段,比如 192.168.5.x,且不能和板子重复。
参数说明:网卡名不能照抄,用 ifconfig -a 或 ip addr 先确认;地址最后一段不要和上位机撞。改完先在 PC 上 ping 192.168.5.100,通了再往下走,不通就先查网线、网段和板端地址是否真的生效——这一步跳过,后面所有「收不到」的问题都会混在一起。
4.3 挂载 Ubuntu 目录,交叉编译 Server.c 再上板运行
我习惯把 Ubuntu 上的一个目录挂到开发板,这样编译产物不用来回拷。先在 Ubuntu 侧把目录共享出去,板端挂载:
bash复制# 板端挂载,Ubuntu_IP 换成运行 Ubuntu 的主机地址
mount -t nfs <Ubuntu_IP>:/home/share /mnt
逻辑说明:挂载成功后,Ubuntu 上编译出的可执行文件在板端 /mnt 下就能直接看到,改一次编译一次,省掉 scp 或 U 盘。
参数说明:<Ubuntu_IP> 是占位,填实际地址;/home/share 是 Ubuntu 侧导出的目录,/mnt 是板端挂载点,两个路径按你的环境改。挂载失败先看 Ubuntu 侧共享有没有开、两边网络通不通。
编译在 Ubuntu 上做,用交叉编译工具,不能用本机的 gcc:
bash复制# CROSS_COMPILE 换成你的工具链前缀,例如 arm-linux-gnueabihf-
${CROSS_COMPILE}gcc Server.c -o Server
逻辑说明:交叉编译出来的 Server 是板端架构的二进制,PC 上直接跑会报「无法执行二进制文件」,这是正常的。编译完把 Server 放到挂载目录,板端就能看到。
参数说明:工具链前缀必须和板子的 CPU 架构匹配,ARM 板用 ARM 工具链,RISC-V 板用 RISC-V 工具链;前缀写错,编译可能成功但上板跑不起来。输出文件名用 -o 指定,和后面运行的命令保持一致。上板后:
bash复制# 板端运行
chmod +x /mnt/Server
/mnt/Server
逻辑说明:先加执行权限再运行;程序起来后不打印任何东西是正常的,它在等数据报。这时回上位机点按键,TextLabel 里应该能看到板端回的内容。
5. 避坑与排查:收不到、回错人、显示乱码
5.1 点按键没反应,readyRead 一次都没触发
现象:上位机界面点按键后 TextLabel 一直空白,调试输出里也没有任何接收日志。
原因:最常见的是没调 bind,或者绑定的端口和发送目标端口不是同一个。new QUdpSocket() 只创建对象,不占端口;端口不一致时,数据报到了本机也会被内核丢掉。
解决:先确认 bind 的返回值是 true,再把上位机绑定的端口、按键里 writeDatagram 的目标端口、板端 htons(UDP_PORT) 三处对齐。三处里只要有一处不同,链路就是断的。
5.2 板端收到了,但回复发不出去
现象:板端 recvfrom 能返回正数,说明请求到了;但上位机始终收不到回复。
原因:recvfrom 的 peer 出参没填对,或者 sendto 用了一个自己拼的地址。另一种情况是 peer_len 没有按 recvfrom 的返回值更新,地址结构不完整。
解决:sendto 的地址参数直接用 recvfrom 填好的 peer,不要另建结构体;peer_len 传给 recvfrom 后由它更新,sendto 时原样传回即可。板端可以先加一行打印,把 inet_ntoa(peer.sin_addr) 和 ntohs(peer.sin_port) 打出来,确认来源地址是不是上位机。
5.3 上位机显示乱码或者只剩半截
现象:TextLabel 里出现乱码,或者只显示了报文的前几个字符。
原因:编码不一致,或者 QString 构造时没传长度、按 \0 截断了。板端发 GBK、上位机按 UTF-8 解,必然乱码;报文里带 \0 时,不传长度的构造会提前结束。
解决:两端统一编码,板端发 UTF-8、上位机用 QString::fromUtf8(buf, n);如果历史代码是 GBK,就换成 fromLocal8Bit(buf, n)。长度参数一定用 readDatagram 的返回值,不要用 sizeof(buf)。
5.4 交叉编译的程序上板报「无法执行」
现象:Server 在 Ubuntu 上编译通过,拷到板端运行时报格式错误或「无法执行二进制文件」。
原因:用了本机 gcc 而不是交叉编译工具,或者工具链前缀和板子架构不匹配。
解决:确认编译命令用的是 ${CROSS_COMPILE}gcc,前缀和板子 CPU 对上;用 file Server 看一眼产物架构,和板端 uname -m 对一下,对不上就换工具链重编。
5.5 上位机 ping 不通 192.168.5.100
现象:板端程序已启动,但上位机连 ping 都不通。
原因:两边不在同一网段,或者板端静态地址没真正生效、网卡名写错。
解决:先在板端 ifconfig 确认地址确实挂上去了,再在上位机看本机地址是不是 192.168.5.x 网段;网段不同就改上位机地址,别去改板端去迁就。网卡名用 ip addr 核对,写错网卡的配置命令不会报错,但地址不会生效。
6. 进阶:先本机回环,再上板联调
UDP 联调最耗时间的不是写代码,而是分不清「是网络不通还是代码写错」。我的做法是:板子先不动,在同一台 PC 上起两个 QUdpSocket 做回环,把收发逻辑先验一遍。
cpp复制// 本机回环验证:一个绑 A 端口,一个绑 B 端口,互发
QUdpSocket a, b;
a.bind(QHostAddress::LocalHost, kPortA);
b.bind(QHostAddress::LocalHost, kPortB);
a.writeDatagram(QByteArray("ping"), QHostAddress::LocalHost, kPortB);
// b 的 readyRead 触发后
char buf[BUFSZ];
QHostAddress from;
quint16 fromPort = 0;
qint64 n = b.readDatagram(buf, sizeof(buf), &from, &fromPort);
// 这里重点看 from 和 fromPort 是不是 a 的地址和端口
这段代码的价值在于:它把「地址和端口出参到底填了什么」直接暴露出来。from 和 fromPort 打印一次,你就能确认 readDatagram 的出参顺序没记反、writeDatagram 的目标地址没传错。本机回环通了,再上板;上板不通,问题就缩小到网络层,而不是代码层。
报文格式上,裸字符串能跑通之后,建议加一个极简的头,方便快速判断「这包是不是我的」:
| 字段 | 长度 | 作用 |
|---|---|---|
| 魔数 | 2 字节 | 固定值,收到先比对,不是就丢 |
| 负载长度 | 2 字节 | 后面负载的字节数,防止半截包 |
| 负载 | N 字节 | 实际状态文本 |
这个头不是协议标准,只是示例,字段和长度按你的实际需求改。加了长度字段之后,上位机在 readDatagram 返回后先校验 n 是否够头长、负载长度是否和 n 对得上,对不上就丢,别硬转字符串。
还有一个小习惯:BUFSZ 和端口常量统一放在一个头文件里,上位机和板端各自 include 同一份定义。血泪经验是,端口在两处各写一个数字,改了一处忘了另一处,排查半天最后发现是数字不一致。
从那以后我每次接 UDP,都先在单机上跑一遍回环、把出参打印出来确认,再动板子;上板后先 ping、再发固定字符串、最后才换真实报文。这套顺序看起来慢,实际省掉的返工远多于多花的那几分钟。希望帮到你。
