鸿蒙智能车实战：如何用QT和海思HI3861开发板实现远程控制与数据可视化

鸿蒙智能车实战：如何用QT和海思HI3861开发板实现远程控制与数据可视化

最近在捣鼓一个挺有意思的项目，想把手头闲置的海思HI3861开发板利用起来，做个能远程控制、还能实时看到小车状态的小玩意儿。这想法其实源于一次和朋友的闲聊，他说现在很多嵌入式教学项目都停留在“点个灯、读个传感器”的阶段，离真正的“智能”和“交互”还差得远。确实，把硬件跑起来只是第一步，如何让它“活”起来，能和用户进行流畅的交互，才是嵌入式开发从入门到进阶的关键一步。

这个项目就瞄准了这个痛点。它不只是一个简单的遥控车，更是一个微型的、软硬件结合的物联网系统。核心思路是用海思HI3861开发板作为智能车的“大脑”，运行轻量化的系统来处理通信和核心逻辑；再搭配一个STM32作为“执行单元”，专管电机驱动和底层传感器数据采集；最后，在电脑上用QT搭建一个图形化上位机，作为用户的“控制台”和“仪表盘”。这样一来，你不仅能用键盘或鼠标远程操控小车前进后退、转弯调速，还能在电脑屏幕上实时看到小车前方的障碍物距离、电池电量、环境温湿度等信息，所有数据一目了然。

整个过程涉及的知识点很综合：从硬件的选型与连接、嵌入式端的多任务编程与网络通信，到上位机的界面设计与事件处理，再到两者之间稳定、高效的数据协议设计。无论你是刚接触嵌入式，想找一个有挑战性的综合项目来练手，还是已经有一定经验，希望深入理解物联网系统的全栈开发流程，这个项目都能给你带来不少收获。下面，我就把自己从零搭建这个系统的思路、踩过的坑以及最终的解决方案，毫无保留地分享出来。

1. 项目蓝图：从零搭建一个软硬件协同的智能车系统

做任何项目，动手之前先想清楚整体架构，能省去后面一大堆折腾的功夫。我们这个智能车项目，本质上是一个典型的客户端-服务器-执行端三层架构。

客户端就是运行在PC上的QT程序，它负责提供友好的人机交互界面。用户在这里下达指令（比如按下“前进”按钮），也在这里接收并查看从小车传回来的各种状态数据。服务器则运行在海思HI3861开发板上，它是整个系统的通信枢纽和数据中转站。一方面，它要监听来自QT客户端的网络连接和指令；另一方面，它要通过串口与负责具体执行的STM32板子通信，转发指令并获取传感器数据。执行端是STM32开发板，它直接连接着电机驱动模块、超声波测距模块、电压检测电路等，是真正“动手动脚”干活的单元。

为什么选择这样的架构？直接让HI3861连接所有传感器和控制电机不行吗？理论上可以，但这会带来两个问题：一是IO口和计算资源紧张，HI3861作为通信和逻辑控制核心已经有一定负载，再让它处理电机PWM等实时性要求高的任务，可能会影响系统稳定性；二是职责分离，让STM32专精于实时控制和高频数据采集（如超声波测距），HI3861专注于网络通信和上层逻辑，符合模块化设计思想，调试和维护也更方便。

提示：在项目初期规划时，务必明确每个模块的职责边界。HI3861作为主控，核心任务是连接与调度，即连接网络和串口，调度任务间的数据流。具体的“力气活”和“精细活”交给专门的协处理器（如STM32）来完成。

基于这个架构，我们的硬件清单也就清晰了：

软件生态的选择同样关键。HI3861开发板通常搭载OpenHarmony轻量系统，它提供了完善的网络、文件系统和驱动框架，非常适合作为物联网设备的核心。上位机选择QT，是因为它的跨平台特性和强大的图形界面库，能让我们快速构建出专业且美观的控制软件。开发环境则包括：

• HI3861开发：VS Code + OpenHarmony DevEco Device Tool插件，用于代码编写、编译和烧录。
• STM32开发：Keil MDK或STM32CubeIDE，用于电机控制和传感器数据采集程序的开发。
• QT开发：QT Creator，用于设计和编写上位机界面及网络通信逻辑。

2. 核心通信：打通HI3861、STM32与QT的数据链路

通信是项目的血脉，血脉不通，系统就是瘫痪的。我们这个项目里有两条主要的数据流：一条是HI3861与QT之间的Wi-Fi/TCP流，另一条是HI3861与STM32之间的串口/UART流。

2.1 HI3861上的TCP服务器搭建

HI3861需要扮演一个TCP服务器，等待QT客户端来连接。在OpenHarmony LiteOS-M内核下，我们可以使用标准的BSD Socket API来实现，这和在Linux下写网络程序非常相似。

// 示例：在HI3861上创建TCP服务器 static int create_tcp_server(unsigned int port) { int sockfd = socket(AF_INET, SOCK_STREAM, 0); // 1. 创建socket if (sockfd < 0) { printf("[ERROR] Socket creation failed.\n"); return -1; } struct sockaddr_in server_addr; server_addr.sin_family = AF_INET; server_addr.sin_port = htons(port); // 设置端口，例如8848 server_addr.sin_addr.s_addr = INADDR_ANY; // 监听所有网络接口 // 2. 绑定地址和端口 if (bind(sockfd, (struct sockaddr*)&server_addr, sizeof(server_addr)) < 0) { printf("[ERROR] Bind failed.\n"); close(sockfd); return -1; } // 3. 开始监听，允许最多5个等待连接队列 if (listen(sockfd, 5) < 0) { printf("[ERROR] Listen failed.\n"); close(sockfd); return -1; } printf("[INFO] TCP Server started on port %d.\n", port); // 4. 阻塞等待客户端连接 int client_fd = accept(sockfd, NULL, NULL); if (client_fd < 0) { printf("[ERROR] Accept failed.\n"); close(sockfd); return -1; } printf("[INFO] Client connected! fd: %d\n", client_fd); close(sockfd); // 监听socket可以关闭了，后续用client_fd通信 return client_fd; }

这段代码应该放在一个独立的任务（Task）中运行。一旦accept成功，我们就得到了一个与QT客户端通信的socket描述符client_fd。之后，就可以在这个任务里循环调用read来接收QT发来的指令（如“run”, “stop”），并根据指令内容调用相应的控制函数。

注意：在实际项目中，为了更好的健壮性，通常会将accept和后续的数据读写也放在循环中，以支持多个客户端连接或客户端断开重连。这里为了简化，我们先处理单连接的情况。

2.2 定义HI3861与STM32的串口协议

HI3861和STM32之间通过串口通信，必须定义一个双方都能理解的“语言”，也就是通信协议。我推荐使用JSON格式的字符串，因为它结构清晰，易于人阅读和调试，也方便后续扩展字段。

HI3861发给STM32的指令协议（控制）：

{"control":{"turn":"run", "pwm":{"L_Motor":500, "R_Motor":500}}} {"control":{"turn":"stop"}} {"control":{"power":"on"}}

• turn字段表示运动方向：run(前进)、back(后退)、left(左转)、right(右转)、stop(停止)。
• pwm字段是一个对象，包含了左轮和右轮的电机的PWM占空比值（例如300-1000）。
• power字段用于控制电机总电源的开关。

STM32发给HI3861的数据协议（状态）：

{"status":{"distance":1250, "carPower":7800, "L_speed":320, "R_speed":310}}

• distance：超声波测得的距离，单位毫米。
• carPower：电池电压，单位毫伏。
• L_speed/R_speed：左右轮编码器测得的转速（如果安装了编码器）。

在HI3861端，我们需要编写串口初始化函数和发送函数。发送函数就是将格式化好的JSON字符串通过串口发送出去。

// HI3861 串口发送示例 #include "hi_uart.h" #define UART_IDX HI_UART_IDX_2 // 假设使用UART2 void send_to_stm32(const char* json_str) { hi_uart_write(UART_IDX, (uint8_t*)json_str, strlen(json_str)); } // 例如，发送前进指令 void motor_forward(int left_pwm, int right_pwm) { char cmd_buf[128]; sprintf(cmd_buf, "{\"control\":{\"turn\":\"run\",\"pwm\":{\"L_Motor\":%d,\"R_Motor\":%d}}}", left_pwm, right_pwm); send_to_stm32(cmd_buf); printf("Sent: %s\n", cmd_buf); }

在STM32端，则需要编写一个串口中断服务程序或使用DMA来接收数据，然后解析JSON字符串，提取出指令和参数，最终控制电机动作。

2.3 QT客户端的网络通信实现

QT端作为TCP客户端，其核心是QTcpSocket类。我们需要实现连接服务器、发送指令和接收数据三个基本功能。

首先，在QT的界面类（例如MainWindow）中声明一个QTcpSocket对象：

// 在头文件中 #include <QTcpSocket> private: QTcpSocket *tcpSocket;

在构造函数或连接按钮的槽函数中，进行连接：

// 连接服务器 tcpSocket = new QTcpSocket(this); connect(tcpSocket, &QTcpSocket::connected, this, &MainWindow::onConnected); connect(tcpSocket, &QTcpSocket::readyRead, this, &MainWindow::onReadyRead); connect(tcpSocket, QOverload<QAbstractSocket::SocketError>::of(&QAbstractSocket::errorOccurred), this, &MainWindow::onError); tcpSocket->connectToHost(QHostAddress("192.168.1.100"), 8848); // 替换为HI3861的实际IP

发送指令非常简单，比如绑定一个按钮的点击事件：

void MainWindow::on_btnForward_clicked() { if(tcpSocket->state() == QAbstractSocket::ConnectedState) { tcpSocket->write("run"); } }

接收数据则在readyRead信号的槽函数中处理。这里有个关键点：HI3861发送的数据可能是多个传感器值拼接在一起的字符串（例如"1250 7800 25.60 45.30"），我们需要按照约定的格式进行解析。

void MainWindow::onReadyRead() { QByteArray data = tcpSocket->readAll(); QString dataStr = QString::fromLatin1(data); // 假设是ASCII/Latin1编码 // 假设数据格式为："距离 电量 温度 湿度"，每个字段固定8字符 if(dataStr.length() >= 32) { // 4个字段*8字符=32 int distance = dataStr.mid(0, 8).trimmed().toInt(); int power = dataStr.mid(8, 8).trimmed().toInt(); float temp = dataStr.mid(16, 8).trimmed().toFloat(); float humidity = dataStr.mid(24, 8).trimmed().toFloat(); // 更新UI显示 ui->labelDistance->setText(QString("距离: %1 mm").arg(distance)); ui->labelPower->setText(QString("电量: %1 mV").arg(power)); // ... 更新其他标签 } }

3. 嵌入式端实战：HI3861的多任务与数据融合处理

在HI3861上，我们需要同时处理好几件事：等待并响应网络指令、读取串口传来的传感器数据、控制本地外设（如OLED、RGB灯）。如果把这些逻辑全部塞进main函数的while(1)循环里，代码会变得难以维护，且响应不及时。这时，多任务（或多线程）编程就成了最佳选择。

OpenHarmony LiteOS-M提供了基于CMSIS-RTOS API的任务管理功能。我们可以创建两个主要任务：

• Task_Network：负责TCP通信，循环读取客户端指令并执行。
• Task_Sensor：负责读取温湿度传感器，并处理来自STM32的串口状态数据。

3.1 创建与调度任务

首先，定义两个任务函数：

void Task_Network(void *argument) { int client_fd = create_tcp_server(8848); char recv_buf[32]; while (1) { memset(recv_buf, 0, sizeof(recv_buf)); int len = read(client_fd, recv_buf, sizeof(recv_buf)-1); if(len > 0) { process_command(recv_buf); // 处理接收到的命令 } osDelay(10); // 让出CPU，避免空转 } } void Task_Sensor(void *argument) { float temp = 0.0, humi = 0.0; int distance = 0, power = 0; while (1) { // 1. 读取SHT20温湿度 SHT20_ReadData(&temp, &humi); // 2. 尝试从串口读取STM32发来的状态数据 read_uart_from_stm32(&distance, &power); // 3. 将整合后的数据发送给QT客户端（可在网络任务中发送，这里先存储到全局变量） update_sensor_data(distance, power, temp, humi); osDelay(100); // 100ms读取一次传感器，频率适中 } }

然后，在系统初始化后创建这两个任务：

void my_app_init() { osThreadAttr_t attr = {0}; attr.name = "NetTask"; attr.stack_size = 4096; attr.priority = osPriorityNormal; osThreadNew(Task_Network, NULL, &attr); attr.name = "SensorTask"; osThreadNew(Task_Sensor, NULL, &attr); } // 使用SYS_RUN宏在系统启动时自动调用 SYS_RUN(my_app_init);

3.2 优化数据传输：避免卡死与数据错乱

在实际测试中，我遇到了两个典型问题，也是很多物联网项目会遇到的坑。

问题一：数据发送过快导致程序或网络卡死。如果传感器任务每100ms读取一次数据，并立即通过TCP发送，那么每秒就是10次。对于简单的状态数据，这个频率不算高，但如果网络稍有延迟或QT端处理稍慢，数据包就可能堆积，最终导致缓冲区满、程序阻塞。我的解决方案是条件发送：只在数据发生变化时才发送。

// 在Task_Network或专门的数据发送任务中 static int last_sent_distance = -1; static float last_sent_temp = -100.0; void check_and_send_data(int client_fd, int curr_dist, float curr_temp) { if(curr_dist != last_sent_distance || fabs(curr_temp - last_sent_temp) > 0.1) { char data_packet[64]; sprintf(data_packet, "%-8d%-8.2f", curr_dist, curr_temp); // 固定格式 write(client_fd, data_packet, strlen(data_packet)); last_sent_distance = curr_dist; last_sent_temp = curr_temp; } }

这样，只有当距离变化超过1毫米或温度变化超过0.1度时，才发送一次数据，极大地减少了网络流量和数据处理压力。

问题二：多数据拼接传输导致QT端解析错乱。最初我尝试将距离、电量、温度、湿度四个数据用空格拼接成一个字符串发送，如"1234 5678 23.5 65.0"。但在QT端用split(' ')解析时，偶尔会出现数组越界或数据对应错误。原因是字符串传输可能因网络问题被拆分成多个包接收。更稳健的方法是使用固定长度字段或添加分隔符。

• 固定长度：如之前代码所示，每个数据分配固定宽度（如8字符），不足部分用空格或0填充。QT端按固定宽度切割。
• 分隔符：使用逗号、分号等不常见于数据本身的字符作为分隔，并在QT端做严格的格式校验。例如："1234;5678;23.5;65.0\n"。

3.3 关键外设驱动集成与BUILD.gn配置

要让HI3861控制OLED显示IP，读取温湿度，点亮RGB灯，你需要将相应的驱动代码集成到工程中。通常，开发板供应商会提供这些外设的驱动示例（hal_bsp_xxx.c和hal_bsp_xxx.h）。

集成时最关键的一步是正确配置BUILD.gn文件。这个文件告诉编译系统需要编译哪些源文件，以及头文件的搜索路径在哪里。很多初学者在这里栽跟头。

static_library("my_smart_car") { # 你的组件名称 sources = [ "./main.c", # 你的主程序文件 "./my_network.c", "./my_sensor.c", # 引入板级支持包(BSP)中的驱动 "//vendor/your_company/fs_hi3861/common/bsp/src/hal_bsp_ssd1306.c", "//vendor/your_company/fs_hi3861/common/bsp/src/hal_bsp_sht20.c", "//vendor/your_company/fs_hi3861/common/bsp/src/hal_bsp_aw2013.c", "//vendor/your_company/fs_hi3861/common/bsp/src/hal_bsp_wifi.c", ] include_dirs = [ "//utils/native/lite/include", "//vendor/your_company/fs_hi3861/common/bsp/include", # BSP头文件路径 "//kernel/liteos_m/kal/cmsis", ".", # 当前目录，方便引用自己的头文件 ] }

注意：每次修改BUILD.gn文件后，必须执行重新构建（rebuild），而不是增量构建，否则修改可能不会生效。这是很多编译错误的根源。

4. QT上位机：打造直观易用的控制与可视化界面

一个美观、响应迅速的上位机是项目的门面，也是用户体验的关键。QT的QWidget或QML都能胜任，这里我们使用传统的QWidget进行快速开发。

4.1 界面布局与键盘控制

使用QT Designer拖拽控件可以快速搭建界面。主要区域包括：

1. 视频/图像显示区：用一个QLabel来显示小车摄像头回传的画面（如果未来扩展）。
2. 数据仪表盘：用多个QLabel或QLCDNumber控件来实时显示距离、电量、温湿度。
3. 控制面板：放置QPushButton作为前进、后退、左转、右转、停止等按钮。
4. 功能按钮：控制RGB灯开关、蜂鸣器、速度加减等。

为了让控制更跟手，我们实现键盘映射。重写窗口的keyPressEvent函数，将键盘按键与按钮点击事件关联起来。

void MainWindow::keyPressEvent(QKeyEvent *event) { switch(event->key()) { case Qt::Key_W: on_btnForward_clicked(); // 触发前进按钮的槽函数 break; case Qt::Key_S: on_btnBackward_clicked(); break; case Qt::Key_A: on_btnLeft_clicked(); break; case Qt::Key_D: on_btnRight_clicked(); break; case Qt::Key_Space: on_btnStop_clicked(); break; case Qt::Key_Q: on_btnSpeedUp_clicked(); // 加速 break; case Qt::Key_E: on_btnSpeedDown_clicked(); // 减速 break; default: QWidget::keyPressEvent(event); } }

这样，用户就可以像玩电脑游戏一样用WASD键来控制小车，体验非常流畅。

4.2 数据可视化与动态更新

仅仅用数字显示传感器数据有些枯燥。我们可以用QT的绘图功能QPainter或更简单的进度条QProgressBar来让数据“动起来”。

例如，用进度条表示电量：

// 假设电量范围是0-10000mV，对应0-100% int power_mv = 7800; // 从socket读取到的值 int percentage = (power_mv - 6000) * 100 / (8400 - 6000); // 假设6000mV为0%，8400mV为100% percentage = qBound(0, percentage, 100); // 限制在0-100之间 ui->progressBarPower->setValue(percentage); ui->progressBarPower->setFormat(QString("%1% (%2mV)").arg(percentage).arg(power_mv));

对于距离，可以模拟一个雷达图或简单的距离警示条。当距离小于某个阈值（如20厘米）时，改变颜色或发出警告音。

void MainWindow::updateDistance(int dist_mm) { ui->labelDistance->setText(QString("%1 mm").arg(dist_mm)); if(dist_mm < 200) { // 距离小于20厘米 ui->labelDistance->setStyleSheet("color: red; font-weight: bold;"); if(dist_mm < 100) { // 可以发送一个指令让小车自动停止或后退 tcpSocket->write("stop"); QApplication::beep(); // 系统提示音 } } else { ui->labelDistance->setStyleSheet("color: black;"); } }

4.3 工程化与部署技巧

一个专业的QT项目还需要考虑以下几点：

• 资源文件管理：将界面用到的图片（如背景图、按钮图标）添加到QT的资源系统（.qrc文件）中，这样在代码中可以用:/images/button.png这样的路径访问，编译后资源会嵌入到可执行文件中，方便分发。

  <RCC> <qresource prefix="/"> <file>images/background.jpg</file> <file>icons/forward.png</file> </qresource> </RCC>

• 多界面与登录：可以设计一个登录窗口LoginDialog，验证成功后，再显示主控制窗口MainWindow。这能增加项目的完整性和趣味性。
• 跨平台编译：在Windows上开发完成后，可以在Linux或macOS上重新编译，QT的跨平台特性使得部署非常方便。记得处理好平台相关的路径分隔符（/vs\）和网络库链接。

5. 调试、优化与功能扩展思路

项目联调是最考验耐心和细心的阶段。我的经验是分模块调试，逐层打通。

1. 先调通STM32与电机/传感器：确保STM32能正确读取超声波数据、控制电机转动。可以用串口调试助手打印数据验证。
2. 再调通HI3861与STM32的串口通信：在HI3861端编写简单的测试程序，发送固定的JSON指令，看STM32能否正确解析并执行。同时，让STM32定时发送状态数据，看HI3861能否正确接收并解析。
3. 然后调通HI3861的网络服务：先用电脑上的网络调试工具（如NetAssist）连接HI3861的TCP服务器，手动发送“run”、“stop”等字符串，看HI3861能否收到并打印日志。同时，让HI3861定时发送测试数据，看调试工具能否收到。
4. 最后整合QT上位机：将QT客户端连接到HI3861，点击按钮发送指令，观察小车动作；同时检查QT界面是否能正确显示HI3861发回的数据。

在整个过程中，日志输出是必不可少的调试手段。在关键节点（如收到网络数据、发送串口指令、解析JSON成功/失败）处添加printf打印信息，能快速定位问题所在。

关于优化，除了前面提到的条件发送数据以减少流量，还可以考虑：

• 数据打包：将多个短小的数据包合并成一个稍大的包发送，减少TCP/IP协议头的开销。
• 心跳机制：QT端定时（如每秒）发送一个心跳包（如"ping"），HI3861回复"pong"。用于检测连接是否断开，并在断开时尝试重连。
• 指令队列：在HI3861端，如果收到连续快速的操作指令（如快速连续点击前进、后退），可以将指令放入队列顺序执行，避免电机控制逻辑混乱。

这个基础框架搭建好后，扩展空间非常大。你可以尝试：

• 加入摄像头模块，在QT端显示实时视频流，实现第一人称视角（FPV）驾驶。
• 集成简单的AI模型，比如在QT端用OpenCV处理摄像头画面，实现车道线识别或交通标志识别，然后将识别结果作为控制指令发给小车。
• 探索鸿蒙的分布式能力：如果未来有多个HI3861设备，可以研究如何利用鸿蒙的分布式软总线进行设备间自发现和协同工作。
• 设计更复杂的控制算法：在STM32端实现PID控制，让小车速度更稳定；或者在HI3861端实现简单的自动避障逻辑。

这个项目从硬件连接到软件编程，从底层驱动到上层应用，完整地走了一遍物联网智能设备的开发流程。我最深的体会是，嵌入式开发不再是孤立地写单片机代码，而是要学会构建一个系统。你需要考虑模块间的接口、数据的流动、异常的处理。当你在电脑前按下按键，看到几米外的小车应声而动，屏幕上实时跳动着它的“生命体征”时，那种跨越物理空间的控制感和成就感，是点灯实验无法比拟的。希望这个详细的实践记录，能为你打开一扇通往更广阔嵌入式世界的大门。