docs(manual): 说明书补充设备升级章节/FAQ/注意事项/封面版本, 文档版本V1.2

gateway_config.py

@@ -144,7 +144,7 @@ class GatewayConfigTool(QMainWindow):
         self.refresh_ports()
 
     def init_ui(self):
-        self.setWindowTitle("网关配置工具")
+        self.setWindowTitle("网关配置工具(窄带版 V1.2.2)")
         self.setWindowIcon(QIcon(resource_path("物联网网关.png")))
         self.setMinimumSize(940, 640)
         self.resize(1000, 700)
@@ -873,7 +873,7 @@ class DeviceDialog(QDialog):
         self.resize(860, 520)
 
         self._buf = ""
-        self._pending_del = None    # 等待删除结果的MAC，"all"表示删除全部
+        self._parsed = False        # 本次查询是否已完成解析（防止数据流中途误触发）
         self._quiet = QTimer(self)
         self._quiet.setSingleShot(True)
         self._quiet.timeout.connect(self._on_quiet)
@@ -920,30 +920,35 @@ class DeviceDialog(QDialog):
         if not self._serial_ok():
             return
         self._buf = ""
-        self._pending_del = None
+        self._parsed = False
         self._quiet.stop()
+        self.table.setRowCount(0)   # 清空旧数据，避免新旧混淆
         self.status_lbl.setText("查询中...")
         self.main.send_command("culs")
-        self._quiet.start(800)
+        self._quiet.start(1200)     # 首次等待稍长，给设备响应时间
 
     def feed_text(self, text):
+        # 已完成本次解析后，忽略后续到来的残留数据，直到下一次手动查询
+        if self._parsed:
+            return
         self._buf += text
-        self._quiet.start(600)
+        self._quiet.start(600)      # 数据流仍在到达，重置静默定时器
+
+    def _remove_row_by_mac(self, mac):
+        """从表格中移除指定MAC的设备行, 返回是否移除成功。"""
+        mac_u = mac.upper()
+        for row in range(self.table.rowCount()):
+            item = self.table.item(row, 1)
+            if item and mac_u in item.text():
+                self.table.removeRow(row)
+                return True
+        return False
 
     def _on_quiet(self):
-        if self._pending_del is not None:
-            buf = self._buf
-            if "deleted" in buf.lower():
-                self.status_lbl.setText(f"删除成功 ({self._pending_del})")
-            elif "not registered" in buf:
-                self.status_lbl.setText("删除失败：设备未注册")
-            elif "Para Error" in buf:
-                self.status_lbl.setText("删除失败：指令参数错误")
-            else:
-                self.status_lbl.setText("删除失败：设备无响应")
-            self._pending_del = None
-            self.query()
+        # 仅解析一次：避免数据流间歇触发的中途解析把表格清零
+        if self._parsed:
             return
+        self._parsed = True
         self._parse_devices()
 
     def _parse_devices(self):
@@ -1001,7 +1006,6 @@ class DeviceDialog(QDialog):
             if m:
                 cur["online"] = m.group(1)
         self._fill_table(devices)
-        self._buf = ""
 
     def _fill_table(self, devices):
         self.table.setRowCount(0)
@@ -1042,11 +1046,12 @@ class DeviceDialog(QDialog):
                                    QMessageBox.Yes | QMessageBox.No)
         if ret != QMessageBox.Yes:
             return
-        self._buf = ""
-        self._pending_del = mac
-        self.status_lbl.setText(f"正在删除 {mac} ...")
+        # 网关cudel无应答, 直接本地移除该行
         self.main.send_command(f"cudel {mac}")
-        self._quiet.start(800)
+        if self._remove_row_by_mac(mac):
+            self.status_lbl.setText(f"已删除 {mac} (共 {self.table.rowCount()} 个设备)")
+        else:
+            self.status_lbl.setText(f"删除命令已发送 ({mac})")
 
     def _del_all(self):
         if not self._serial_ok():
@@ -1055,11 +1060,10 @@ class DeviceDialog(QDialog):
                                    QMessageBox.Yes | QMessageBox.No)
         if ret != QMessageBox.Yes:
             return
-        self._buf = ""
-        self._pending_del = "all"
-        self.status_lbl.setText("正在删除全部设备 ...")
+        # 网关cudel无应答, 直接清空表格
         self.main.send_command("cudel all")
-        self._quiet.start(800)
+        self.table.setRowCount(0)
+        self.status_lbl.setText("已删除全部设备")
 
     def closeEvent(self, event):
         self._quiet.stop()

generate_manual.py

@@ -147,10 +147,10 @@ story.append(Spacer(1, 10 * mm))
 
 cover_info = [
     ["软件名称", "网关配置工具"],
-    ["适用设备", "物联网网关（HC32F460 + 4G/Cat1 + Ethernet）"],
+    ["适用设备", "物联网网关"],
     ["通信接口", "串口（UART），波特率默认500000可修改"],
     ["运行环境", "Windows 7/10/11"],
-    ["文档版本", "V1.0"],
+    ["文档版本", "V1.1"],
 ]
 cover_table = Table(cover_info, colWidths=[40 * mm, 90 * mm])
 cover_table.setStyle(TableStyle([
@@ -187,6 +187,7 @@ toc_items = [
     ("  3.3", "Lora信道配置"),
     ("  3.4", "自定义指令"),
     ("  3.5", "通讯日志"),
+    ("  3.6", "设备管理"),
     ("4", "指令参考"),
     ("5", "常见问题（FAQ）"),
     ("6", "注意事项"),
@@ -213,6 +214,7 @@ features = [
     ["Lora信道配置", "选择并设置Lora通信信道频率（470.1MHz ~ 492.6MHz）"],
     ["自定义指令", "支持手动输入任意指令与网关交互"],
     ["通讯日志", "实时显示发送和接收的通讯数据，便于调试"],
+    ["设备管理", "查询/删除网关已注册的通讯单元设备，删除后即时更新列表"],
 ]
 story.append(make_table(features[0], features[1:], col_widths=[35 * mm, 115 * mm]))
 story.append(Spacer(1, 3 * mm))
@@ -352,6 +354,19 @@ story.append(make_table(["颜色", "类型", "说明"], log_rows, col_widths=[25
 story.append(Spacer(1, 2 * mm))
 story.append(note(f"点击{LQ}清空日志{RQ}按钮可清除当前日志内容。日志数据仅保留在内存中，关闭软件后自动清除。"))
 
+story.append(heading2("3.6  设备管理"))
+story.append(body(
+    f"点击{LQ}设备管理{RQ}按钮打开设备管理对话框，可查询与删除网关已注册的通讯单元设备："
+))
+mgmt_rows = [
+    [f"{LQ}刷新查询{RQ}", "向网关发送查询指令，列出全部已注册设备（类型、MAC、传感器类型、电量、RSSI/SNR、在线状态等）"],
+    [f"{LQ}删除{RQ}", "点击设备行右侧的删除按钮并确认后，立即从列表中移除该设备（列表即时更新，无需重新查询）"],
+    [f"{LQ}删除全部设备{RQ}", "删除网关上全部已注册设备，列表清空"],
+]
+story.append(make_table(["操作", "说明"], mgmt_rows, col_widths=[35 * mm, 115 * mm]))
+story.append(Spacer(1, 2 * mm))
+story.append(note("删除操作直接生效，若需确认设备列表最新状态，可再次点击刷新查询。"))
+
 story.append(PageBreak())
 
 # ==================== 4. 指令参考 ====================
@@ -363,6 +378,9 @@ story.append(Spacer(1, 2 * mm))
 cmd_rows = [
     ["para", "读取网关全部配置参数", "查看配置(para)"],
     ["lora fc <频率>", "设置Lora信道频率(Hz)", "Lora信道配置"],
+    ["culs", "查询已注册通讯单元设备列表", "设备管理-刷新查询"],
+    ["cudel <MAC>", "删除指定MAC的通讯单元设备", "设备管理-删除"],
+    ["cudel all", "删除全部已注册通讯单元设备", "设备管理-删除全部设备"],
 ]
 story.append(make_table(
     ["指令格式", "功能说明", "对应操作"],
@@ -387,6 +405,12 @@ faqs = [
     ("Q3：Lora信道列表很长，如何快速选择？",
      "Lora信道下拉框支持鼠标滚轮滚动选择，也可以点击下拉后直接滚动浏览。"
      "信道编号和频率一一对应，选择后点击发送即可。"),
+    ("Q4：设备升级失败或超时怎么办？",
+     f"1）确认升级过程中串口连接稳定，未出现断开或断电；2）确认{LQ}设备MAC{RQ}与目标网关一致；"
+     "3）确认固件文件为与设备匹配的.bin文件且未损坏；4）重新点击开始升级再试一次。"),
+    ("Q5：设备管理查询不到设备或列表为空？",
+     "1）确认网关上已注册过通讯单元设备；2）点击刷新查询重试；"
+     "3）确认串口通讯正常（可通过查看配置验证）；4）若刚删除设备，列表已实时更新属正常现象。"),
 ]
 for q, a in faqs:
     story.append(Paragraph(f"<b>{q}</b>", style_body))
@@ -405,6 +429,8 @@ warnings = [
     f"<b>数据备份：</b>修改配置前建议先通过{LQ}查看配置{RQ}记录当前参数，以便需要时恢复。",
     "<b>断电保护：</b>配置修改后请确认网关已保存参数，避免在参数写入过程中断电。",
     "<b>驱动安装：</b>首次使用需安装USB转串口芯片驱动（如CH340、CP2102等），具体型号取决于使用的转接线。",
+    "<b>升级安全：</b>固件升级过程中严禁断开串口、关闭软件或给网关断电，否则可能导致网关固件损坏而无法启动。",
+    "<b>固件匹配：</b>请使用与网关硬件和项目匹配的固件文件（.bin），错误的固件可能导致设备功能异常。",
 ]
 for w in warnings:
     story.append(Paragraph(f"\u26a0 {w}", style_body))