树莓派PySide6 QML串口工具开发：从环境搭建到实战优化

1. 项目缘起：为什么要在树莓派上折腾GUI串口工具？

如果你玩过树莓派，大概率不会只满足于在命令行里敲敲打打。无论是想做个桌面级的硬件监控面板，还是开发一个带界面的机器人控制器，甚至只是做一个更直观的串口调试助手，给树莓派项目加上一个图形用户界面（GUI）都是让项目“出圈”、变得实用且酷炫的关键一步。而串口通信，作为嵌入式开发、物联网设备调试、与各种传感器/模块对话的基石，其重要性不言而喻。

但问题来了：在资源有限的树莓派上，如何选择一个既高效、易用，又能做出漂亮界面的GUI方案来驱动串口？网上教程五花八门，有推荐Tkinter的（简单但丑），有说用Web的（跨平台但重），还有直接上C++ Qt的（强大但门槛高）。对于大多数习惯Python的树莓派玩家来说，PySide/PyQt（两者本质是Python对Qt框架的绑定）以及其声明式的QML语言，是一个在性能、美观度和开发效率上取得绝佳平衡的选择。然而，从环境搭建、界面设计到串口通信的整合，每一步都有坑。我花了相当长时间，把PySide6、QML、Python串口库（pyserial）在树莓派上揉搓了一遍，趟平了主要的坑。这篇文章，就是把我从零构建一个树莓派GUI串口工具的全过程、核心原理和那些教程里不会写的细节，毫无保留地分享给你。

2. 技术栈选型深度剖析：PySide6、QML与pyserial的组合逻辑

面对树莓派GUI开发，选型是第一道坎。为什么是PySide6 + QML + pyserial，而不是其他组合？这背后是一套完整的权衡逻辑。

2.1 为什么是PySide6，而不是PyQt5或Tkinter？

首先明确，PySide和PyQt都是Qt公司官方Qt框架的Python绑定。历史上PyQt更早，但PySide是Qt官方（The Qt Company）亲自维护的版本，采用更宽松的LGPL协议，这对于商业应用或不想被GPL传染的开发者更友好。PySide6对应Qt6，是当前的最新版本，带来了更好的HiDPI支持、更现代的API和性能优化。对于树莓派4B及之后的型号（包括树莓派5），其GPU和显示性能已经足够流畅运行Qt6应用。因此，选择PySide6意味着站在了技术栈的前沿，能获得长期支持。

与Tkinter对比，Tkinter是Python标准库，无需额外安装，这是其最大优势。但其控件外观老旧、自定义能力弱、布局管理器不够灵活，做出一个现代化、响应式的界面非常吃力。而Qt提供了近乎无限的自定义能力和一套成熟的设计模式（如信号与槽），在开发复杂交互的桌面应用时，效率和质量远超Tkinter。

2.2 为什么引入QML，而不只用传统的QWidget？

这是本方案的一个关键决策点。Qt传统上使用QWidget通过代码（C++或Python）来构建界面，这种方式逻辑控制力强，但UI与业务逻辑耦合度高，修改界面外观需要重新编译（或运行）代码。

QML是一种声明式语言，类似于JSON的语法，专门用于描述用户界面。它的核心优势在于：

• UI与逻辑分离：.qml文件专门负责界面外观和简单交互，Python文件（或C++）负责核心业务逻辑（如串口数据解析）。两者通过Qt的“信号与槽”机制或属性绑定通信。这极大提高了UI设计的灵活性和可维护性。
• 开发效率高：QML的语法非常直观，拖拽式的设计工具（Qt Design Studio）或纯文本编辑都能快速构建出流畅、带有动画效果的现代化界面。这对于需要频繁调整UI布局的硬件项目原型开发尤其有利。
• 性能优异：QML界面由Qt Quick引擎渲染，大量使用GPU加速，在树莓派这种嵌入式设备上，能保证界面的流畅度，尤其是在处理动态图表、平滑过渡动画时。

对于串口工具这类需要实时更新数据（如接收区文本、信号灯状态）的界面，QML的数据绑定特性简直是神器。你只需要在Python端更新一个数据模型，QML界面会自动刷新，无需手动调用update()之类的方法。

2.3 pyserial：Python串口通信的事实标准

在Python领域，pyserial是操作串口的不二之选。它提供了跨平台的统一API，封装了底层操作系统的串口细节，使用起来简单直接。其核心对象Serial提供了配置波特率、数据位、停止位、校验位以及读写数据的所有方法。在我们的架构中，pyserial将运行在一个独立的线程中，避免阻塞QML/GUI的主事件循环，确保界面始终响应。

2.4 整体架构视图

最终的架构清晰分层：

1. 表示层 (Presentation Layer): 由QML文件定义。包含按钮、文本框、下拉列表、图表等控件。
2. 逻辑层 (Logic Layer): 由Python编写。它创建QML引擎，加载QML界面，并实例化一个或多个“桥梁”对象暴露给QML。同时，它管理着串口工作线程。
3. 串口通信层 (Serial Layer): 同样由Python编写，基于pyserial和threading模块。在一个独立的线程中执行串口的打开、关闭、循环读取和写入操作，通过线程安全的队列或Qt信号将数据传递给逻辑层。

逻辑层充当了QML界面和串口线程之间的中介和协调者。

3. 树莓派开发环境搭建与关键配置避坑

在树莓派上搭建这个开发环境，和普通Linux桌面环境略有不同，有几个关键点容易踩坑。

3.1 系统选择与基础准备

推荐使用树莓派官方或社区维护的桌面版系统，如 Raspberry Pi OS (64-bit) with desktop。这已经预装了图形环境、Python3和pip。首先进行系统更新：

sudo apt update sudo apt full-upgrade -y sudo reboot

3.2 安装PySide6和pyserial

在树莓派上，最稳妥的方式是通过pip安装。但需要注意，Qt6库体积较大，编译安装某些组件可能耗时，因此直接安装预编译的wheel包是最佳选择。

# 安装Python3的包管理工具pip（如果尚未安装） sudo apt install python3-pip -y # 安装PySide6和pyserial pip3 install pyside6 pyserial

注意：如果遇到权限问题，可以添加--user标志安装到用户目录，或者使用虚拟环境（python3 -m venv venv）。对于树莓派这种专属设备，我通常直接全局安装，省去激活环境的麻烦。

3.3 处理可能的依赖缺失

有时直接安装PySide6可能会因为缺少某些系统库而失败。常见的依赖包括OpenGL、字体库等。可以预先安装一批通用开发库：

sudo apt install libgl1-mesa-dev libxkbcommon-x11-0 libdbus-1-3 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-xinerama0 libxcb-xfixes0 -y

安装后再次尝试pip3 install pyside6。

3.4 验证安装与第一个QML程序

创建一个简单的测试文件test_qml.py：

import sys from PySide6.QtCore import QUrl from PySide6.QtGui import QGuiApplication from PySide6.QtQml import QQmlApplicationEngine app = QGuiApplication(sys.argv) engine = QQmlApplicationEngine() engine.load(QUrl.fromLocalFile(‘main.qml‘)) # 需要同目录下的main.qml文件 if not engine.rootObjects(): sys.exit(-1) sys.exit(app.exec())

同目录下创建main.qml：

import QtQuick import QtQuick.Controls Window { width: 400 height: 300 visible: true title: “树莓派QML测试” Text { anchors.centerIn: parent text: “Hello from QML on Raspberry Pi!” font.pixelSize: 24 } }

运行python3 test_qml.py。如果能看到一个窗口显示文字，说明PySide6和QML环境配置成功。这一步至关重要，它排除了图形驱动、OpenGL等底层问题。

3.5 串口权限问题——最常遇到的坑

在Linux系统（包括树莓派OS）上，普通用户默认无法直接访问串口设备（如/dev/ttyAMA0,/dev/ttyUSB0）。你会遇到Permission denied错误。解决方案不是每次都使用sudo，因为用sudo运行你的GUI程序会带来环境变量、用户目录等一系列问题。正确做法是将你的用户加入dialout组，该组通常拥有串口设备的读写权限。

# 将当前用户加入dialout组 sudo usermod -a -G dialout $USER

重要：执行此命令后，必须注销当前用户并重新登录，或者重启树莓派，组权限更改才会生效。之后，你就可以在普通用户模式下正常访问串口了。可以通过ls -l /dev/ttyAMA0命令查看设备所属组是否为dialout。

4. 核心实现：从QML界面到串口数据流的完整链路

环境就绪后，我们开始构建核心应用。我将以一个具备基本发送、接收、清空功能的串口调试助手为例，拆解每一步。

4.1 设计QML用户界面 (main.qml)

QML界面的设计思路是声明式的。我们定义好控件、布局和简单的属性绑定。

// main.qml import QtQuick import QtQuick.Controls import QtQuick.Layouts ApplicationWindow { id: window width: 800 height: 600 visible: true title: “树莓派串口调试助手” // 定义一个属性，用于接收来自Python的串口列表。这里先用假数据。 property var serialPorts: [“/dev/ttyAMA0”, “/dev/ttyUSB0”, “COM1”] // 这个对象将在Python端被实例化并设置为上下文属性，作为QML调用Python功能的桥梁。 property var serialBridge ColumnLayout { anchors.fill: parent anchors.margins: 10 spacing: 10 // 第一行：串口配置区域 RowLayout { Label { text: “端口:” } ComboBox { id: portComboBox Layout.fillWidth: true model: window.serialPorts // 绑定到窗口的串口列表属性 editable: true // 允许手动输入 } Label { text: “波特率:” } ComboBox { id: baudComboBox Layout.preferredWidth: 120 model: [“9600”, “19200”, “38400”, “57600”, “115200”, “230400”, “460800”, “921600”] currentIndex: 4 // 默认115200 } Button { id: connectButton text: “打开串口” onClicked: { // 调用桥梁对象的方法。如果返回成功，更新按钮状态。 if (window.serialBridge.openSerial(portComboBox.currentText, baudComboBox.currentText)) { text = “关闭串口” sendButton.enabled = true } else { text = “打开串口” sendButton.enabled = false } } } } // 第二行：发送区域 RowLayout { Label { text: “发送区:” } TextField { id: sendTextField Layout.fillWidth: true placeholderText: “输入要发送的字符串或十六进制数据...” onAccepted: sendButton.clicked() // 按回车发送 } CheckBox { id: hexSendCheckBox; text: “Hex发送” } Button { id: sendButton text: “发送” enabled: false // 初始未连接时禁用 onClicked: { if (sendTextField.text) { window.serialBridge.sendData(sendTextField.text, hexSendCheckBox.checked) sendTextField.clear() } } } } // 第三行：接收区域 TextArea { id: receiveTextArea Layout.fillWidth: true Layout.fillHeight: true placeholderText: “接收到的数据将显示在这里...” readOnly: true wrapMode: TextEdit.WrapAnywhere font.family: “Monospace” // 等宽字体，显示十六进制时对齐 } // 第四行：接收控制 RowLayout { Button { text: “清空接收” onClicked: receiveTextArea.clear() } CheckBox { id: hexDisplayCheckBox; text: “Hex显示” } CheckBox { id: autoScrollCheckBox; text: “自动滚动”; checked: true } Item { Layout.fillWidth: true } // 占位弹簧 Label { id: statusLabel; text: “就绪”; color: “green” } } } // 当串口桥梁对象发出`dataReceived`信号时，触发此函数更新接收区。 Connections { target: window.serialBridge // 连接到桥梁对象 function onDataReceived(data, isHex) { var displayText = isHex ? data : data if (autoScrollCheckBox.checked) { receiveTextArea.append(displayText) } else { // 非自动滚动模式下的处理（略复杂，此处简化） receiveTextArea.text += displayText } } function onStatusChanged(message, isError) { statusLabel.text = message statusLabel.color = isError ? “red” : “green” } } }

这个QML文件定义了一个完整的界面，但它自身不具备串口操作能力。serialBridge是一个占位符，它将在Python端被一个真实的Python对象替换。

4.2 构建Python后端逻辑与串口线程 (serial_bridge.py & main.py)

这是整个应用的大脑。我们创建一个SerialBridge类，它继承自QObject，以便能够使用Qt的信号与槽机制与QML通信。

# serial_bridge.py import sys import threading import queue from PySide6.QtCore import QObject, Signal, Slot import serial import serial.tools.list_ports class SerialBridge(QObject): # 定义信号：当串口收到数据时发出 dataReceived = Signal(str, bool) # (data, is_hex_mode) # 定义信号：当串口状态变化时发出（如打开成功、出错、关闭） statusChanged = Signal(str, bool) # (message, is_error) def __init__(self): super().__init__() self.serial_port = None self.serial_thread = None self.read_thread_running = False self.data_queue = queue.Queue() # 用于线程间传递接收到的数据 @Slot(result=list) def get_available_ports(self): """获取可用串口列表，供QML下拉框调用""" ports = [port.device for port in serial.tools.list_ports.comports()] # 在树莓派上，可能需要额外添加硬件串口 /dev/ttyAMA0 if “/dev/ttyAMA0” not in ports: ports.insert(0, “/dev/ttyAMA0”) return ports @Slot(str, str, result=bool) def open_serial(self, port, baudrate): """打开或关闭串口""" if self.serial_port and self.serial_port.is_open: # 如果串口已打开，则关闭它 self._close_serial() self.statusChanged.emit(“串口已关闭”, False) return False # 返回False表示当前状态是“关闭” else: # 尝试打开串口 try: self.serial_port = serial.Serial( port=port, baudrate=int(baudrate), bytesize=serial.EIGHTBITS, parity=serial.PARITY_NONE, stopbits=serial.STOPBITS_ONE, timeout=1 # 读超时，秒 ) if self.serial_port.is_open: self.statusChanged.emit(f“已连接到 {port} @ {baudrate}bps”, False) # 启动读线程 self.read_thread_running = True self.serial_thread = threading.Thread(target=self._read_serial_thread, daemon=True) self.serial_thread.start() return True # 返回True表示当前状态是“打开” except Exception as e: error_msg = f“打开串口失败: {e}” self.statusChanged.emit(error_msg, True) print(error_msg) return False def _close_serial(self): """内部方法：关闭串口和线程""" self.read_thread_running = False if self.serial_thread and self.serial_thread.is_alive(): self.serial_thread.join(timeout=2) # 等待线程结束，最多2秒 if self.serial_port and self.serial_port.is_open: self.serial_port.close() self.serial_port = None def _read_serial_thread(self): """串口数据读取线程函数""" while self.read_thread_running and self.serial_port and self.serial_port.is_open: try: # 读取数据，如果超时（timeout设置）则返回空字节 data = self.serial_port.read(self.serial_port.in_waiting or 1) if data: # 将数据放入队列，由主线程通过定时器或信号取出并发送给QML。 # 但更直接的方式是，在线程内通过信号发射（Qt信号是线程安全的）。 # 注意：将字节数据转换为字符串。这里假设是文本，实际可能需要十六进制显示。 try: text_data = data.decode(‘utf-8’, errors=‘ignore’) self.dataReceived.emit(text_data, False) # 假设文本模式 except: # 如果解码失败，可能是二进制数据，用十六进制表示 hex_data = data.hex(‘ ‘).upper() # 例如 “48 65 6C 6C 6F” self.dataReceived.emit(hex_data, True) except (serial.SerialException, OSError) as e: self.statusChanged.emit(f“读串口错误: {e}”, True) self.read_thread_running = False break except Exception as e: # 其他异常，记录并继续 print(f“读线程内部错误: {e}”) @Slot(str, bool) def send_data(self, data, is_hex=False): """发送数据到串口""" if not self.serial_port or not self.serial_port.is_open: self.statusChanged.emit(“串口未连接，无法发送”, True) return try: if is_hex: # 处理十六进制发送：去除空格，将字符串转换为字节 data = data.replace(‘ ‘, ‘’).replace(‘\n’, ‘’).replace(‘\r’, ‘’) try: bytes_to_send = bytes.fromhex(data) except ValueError as e: self.statusChanged.emit(f“十六进制数据格式错误: {e}”, True) return else: # 文本发送，确保以字节形式发送，可添加换行符（根据需求） bytes_to_send = (data + ‘\n’).encode(‘utf-8’) # 示例：添加换行 self.serial_port.write(bytes_to_send) self.serial_port.flush() # 确保数据发出 # 可以发射一个信号表示发送成功（可选） except Exception as e: self.statusChanged.emit(f“发送失败: {e}”, True) @Slot() def close_serial(self): """供应用退出时清理资源""" self._close_serial()

接下来是主程序main.py，它负责创建应用、设置QML上下文并启动事件循环。

# main.py import sys from pathlib import Path from PySide6.QtCore import QUrl from PySide6.QtGui import QGuiApplication from PySide6.QtQml import QQmlApplicationEngine, QmlElement from PySide6.QtQuick import QQuickView # 导入我们写的桥梁类 from serial_bridge import SerialBridge def main(): app = QGuiApplication(sys.argv) # 创建QML引擎 engine = QQmlApplicationEngine() # 实例化我们的串口桥梁对象 serial_bridge = SerialBridge() # 将桥梁对象暴露给QML，在QML中可以通过 `serialBridge` 标识符访问 engine.rootContext().setContextProperty(“serialBridge”, serial_bridge) # 加载QML文件 qml_file = Path(__file__).parent / “main.qml” if not qml_file.exists(): print(f“错误：找不到QML文件 {qml_file}”) sys.exit(-1) engine.load(QUrl.fromLocalFile(str(qml_file))) if not engine.rootObjects(): print(“错误：加载QML失败，未创建根对象。”) sys.exit(-1) # 应用退出时，确保关闭串口 app.aboutToQuit.connect(serial_bridge.close_serial) sys.exit(app.exec()) if __name__ == “__main__”: main()

4.3 关键机制解析：信号与槽、线程安全与数据流

1. 信号与槽 (Signals & Slots)：这是Qt的核心通信机制。在我们的代码中：

   • SerialBridge类定义了dataReceived和statusChanged两个信号。
   • 在QML的Connections元素中，我们将这些信号连接到对应的处理函数（如onDataReceived）。
   • 当Python端的串口线程调用self.dataReceived.emit(...)时，QML端的函数会自动被调用。这是一种松耦合的、类型安全的通信方式。

2. 线程安全：串口读写（尤其是读）是阻塞操作，绝不能放在GUI主线程中，否则界面会卡死。我们创建了独立的threading.Thread来执行_read_serial_thread函数。

   • 关键点：在PySide6/PyQt中，从非主线程直接调用GUI操作或修改QML属性是危险的，会导致崩溃。正确的做法是使用线程安全的机制，例如：
     • 使用Qt信号：正如我们所做的，信号发射是线程安全的。我们在子线程中发射信号，Qt内部会安排在主线程中调用连接的槽函数。
     • 使用QMetaObject.invokeMethod：也可以调用主线程对象的方法。
   • 我们的dataReceived信号就是在子线程中发射，最终在QML的主线程上下文中被处理，从而安全地更新TextArea的内容。

3. 数据流：

   • 发送路径：QML按钮点击 -> 调用serialBridge.sendData()槽 -> Python主线程 ->pyserial写入串口设备。
   • 接收路径：串口硬件 ->pyserial读取（子线程） -> 解码/格式化 -> 发射dataReceived信号 -> QML主线程接收信号 -> 更新UI显示。

5. 功能增强与实战优化技巧

一个基础的串口工具已经完成，但要让它变得好用、健壮，还需要添加更多功能和优化。

5.1 自动检测串口热插拔

目前的端口列表是打开时获取的静态列表。对于USB转串口设备，热插拔很常见。我们可以利用Qt的定时器或QFileSystemWatcher来定期刷新端口列表。

在SerialBridge类中添加：

from PySide6.QtCore import QTimer ... def __init__(self): ... self.port_list_timer = QTimer() self.port_list_timer.timeout.connect(self._update_port_list) self.port_list_timer.start(2000) # 每2秒检测一次 self._last_port_list = [] def _update_port_list(self): current_ports = self.get_available_ports() if current_ports != self._last_port_list: self._last_port_list = current_ports # 发射一个信号通知QML端口列表已更新 self.portListUpdated.emit(current_ports) # 需要先定义这个信号

在QML中，监听这个信号并更新ComboBox的model。

5.2 接收数据的显示优化

• 时间戳：在每条接收到的数据前添加时间戳，对于调试协议非常有用。可以在Python端发射信号前格式化时间，也可以将原始数据和时间一起发射，由QML决定如何显示。
• 暂停滚动：当用户正在查看历史数据时，自动滚动会干扰。我们的界面已经有了“自动滚动”复选框，在onDataReceived处理函数中需要根据其状态决定是append（追加并滚动到底部）还是直接修改text属性（不触发滚动）。
• 大流量处理：如果串口数据速率极高（如115200bps持续发送），频繁更新QML的TextArea会导致界面卡顿。解决方案是：
  1. 在Python端进行数据缓冲，比如累积一定数量（如1024字节）或一定时间（如100毫秒）的数据后再发射一次信号，减少信号发射频率。
  2. 在QML端，考虑使用ListView或TableView配合自定义模型来显示数据，它们对于大量数据项的性能远优于TextArea。

5.3 发送功能的增强

• 周期发送：添加一个复选框和输入框，允许设置定时发送（如每1000ms发送一次）。这需要用到QML的Timer元素或Python端的QTimer。
• 发送文件：实现一个选择文件并逐行或按块发送的功能。注意要在单独的线程中进行，避免阻塞UI。
• 发送历史：将发送过的命令保存在一个列表中，可以通过下拉框或快捷键快速选择再次发送。

5.4 应用打包与部署

开发完成后，你可能希望将其打包成一个独立的可执行文件，方便在其他树莓派上运行，而无需安装Python环境。

使用PyInstaller打包：

1. 安装PyInstaller：pip3 install pyinstaller
2. 在项目目录下创建打包规范文件spec，或者直接使用命令行。由于涉及QML文件，需要确保它们被正确打包进最终程序。

pyinstaller --onefile --windowed --add-data “main.qml:.” --hidden-import PySide6.QtQml --hidden-import PySide6.QtQuick main.py

• --onefile: 打包成单个可执行文件。
• --windowed: 不显示控制台窗口（对于GUI应用）。
• --add-data “main.qml:.”: 将main.qml文件添加到打包中，冒号后是程序运行时的相对路径（.表示当前目录）。
• --hidden-import: 显式引入一些PyInstaller可能无法自动分析到的模块。

打包过程中的坑：

• QML文件路径：打包后，程序的当前目录可能变化。在main.py中加载QML文件时，不能再用__file__来定位。可以使用sys._MEIPASS（PyInstaller运行时设置的临时目录）或Qt的资源系统（.qrc文件）来管理QML文件。更简单的方法是使用QUrl(“qrc:/main.qml”)，但这需要将QML文件编译进Qt资源文件。
• 树莓派架构：在树莓派上打包的程序通常只能在同一架构（如arm64）的树莓派上运行。如果你想在x86电脑上开发并交叉编译给树莓派，过程会复杂很多，通常建议直接在树莓派上进行打包操作。

5.5 性能与内存监控

在树莓派上长期运行GUI应用，需要注意资源消耗。可以使用top或htop命令监控内存和CPU使用情况。如果发现内存持续增长（内存泄漏），可能的原因有：

• QML中未正确销毁动态创建的对象。
• Python端有循环引用导致垃圾回收器无法释放对象。确保在应用退出时（aboutToQuit信号）正确断开连接、停止线程、释放资源（如我们做的close_serial）。

6. 进阶探索：QML美化与硬件交互扩展

基础功能稳定后，我们可以让工具变得更专业、更强大。

6.1 使用Qt Quick Controls 2 实现现代化界面

我们之前使用的是基本的QtQuick.Controls。Qt Quick Controls 2提供了更多风格化、Material Design或iOS风格的控件。要使用它，只需在QML文件开头导入：

import QtQuick.Controls 2.15

然后就可以使用RoundButton、SwitchDelegate、ProgressBar、SwipeView等更精美的控件。你还可以通过修改ApplicationWindow的Material.theme或Palette来轻松切换明暗主题。

6.2 集成图表显示

对于显示波形、传感器数据变化趋势，图表是刚需。Qt提供了QtCharts模块，它也有QML接口。

1. 首先确保安装了对应的Python包：pip3 install PySide6-Charts（注意：Qt6的Charts模块可能需要单独安装或确认PySide6版本包含它）。
2. 在QML中导入：import QtCharts 2.15。
3. 然后就可以在QML中定义ChartView、LineSeries等。Python后端负责解析串口数据（如提取出数值），然后通过更新绑定到图表序列的数据模型，实时驱动图表刷新。

6.3 与树莓派GPIO或其他硬件接口联动

这才是树莓派的精髓所在。你的GUI串口工具可以成为一个集成的硬件控制中心。

• 控制GPIO：你可以使用RPi.GPIO或更现代的gpiozero库。在Python后端，除了串口桥梁，再创建一个GpioBridge对象暴露给QML。这样，你可以在QML界面中添加按钮，点击后通过信号调用Python方法，来控制树莓派上的某个引脚输出高电平，进而控制继电器、LED等。
• 读取传感器：同样，可以创建一个线程定期读取DHT11温湿度传感器、DS18B20温度传感器等的数据，然后通过信号发送到QML界面显示。
• 摄像头预览：结合picamera2库，你甚至可以在QML界面中嵌入一个实时的摄像头预览画面。这需要将摄像头帧数据转换为QML可显示的图像格式（如QImage），并通过一个自定义的QML项或Image元素的source属性进行更新，技术复杂度较高，但完全可行。

通过将串口通信、GPIO控制、传感器数据采集、图表显示等功能全部整合到一个现代化的QML界面中，你就能在树莓派上构建出一个功能强大、界面专业的工业级或创客级硬件监控与控制平台。这远远超出了一个简单串口调试工具的范畴，展现了PySide6+QML在嵌入式GUI开发上的巨大潜力。