更新使用说明书至V2.0并同步软件功能

- 界面区域调整:新增功率与激光配置区域说明,通讯日志调整说明
- 新增全功率时段配置、激光控制、设备升级操作说明
- 指令参考新增 fpocfg/laser 指令,去掉 dch ch1 内部切换描述
- Lora频率范围更新为410.1~492.9MHz
- 版本号升级为 V2.0
This commit is contained in:
2026-08-25 15:42:35 +08:00
parent 629a92ff41
commit 03046499ee
2 changed files with 92 additions and 13 deletions
+92 -13
View File
@@ -89,7 +89,7 @@ story = []
story.append(Spacer(1, 6*cm))
story.append(Paragraph("边坡变形监测-变形(位移)<br/>自动测量系统配置工具<br/>使用说明书", style_cover_title))
story.append(Spacer(1, 1.5*cm))
story.append(Paragraph("版本 V1.0", style_cover_sub))
story.append(Paragraph("版本 V2.0", style_cover_sub))
story.append(PageBreak())
# 目录
@@ -106,12 +106,16 @@ toc_items = [
(False, " 4.2 参数配置区域"),
(False, " 4.3 设备参数信息区域"),
(False, " 4.4 低功耗配置区域"),
(False, " 4.5 通讯日志区域"),
(False, " 4.5 功率与激光配置区域"),
(False, " 4.6 通讯日志区域"),
(True, "5 操作指南"),
(False, " 5.1 连接设备"),
(False, " 5.2 查询设备参数"),
(False, " 5.3 修改Lora信道频率"),
(False, " 5.4 发送自定义指令"),
(False, " 5.4 全功率时段配置"),
(False, " 5.5 激光控制"),
(False, " 5.6 设备升级"),
(False, " 5.7 发送自定义指令"),
(True, "6 指令参考"),
(True, "7 常见问题与故障排除"),
]
@@ -131,8 +135,11 @@ features = [
"自动识别并列出本机可用串口",
"通过RS485串口连接激光示踪传感器设备",
"一键查询设备全部参数(软件版本、硬件版本、MAC地址、电池电量、注册状态等)",
"修改Lora无线通信信道频率(410.1MHz ~ 524.9MHz,步进200kHz",
"修改Lora无线通信信道频率(410.1MHz ~ 492.9MHz,步进200kHz",
"查看设备低功耗配置参数(采集间隔、上报时间、紧急上报间隔/时长)",
"查看功率与激光参数,并配置全功率工作时间段",
"控制激光开关及设置自动关闭时间",
"通过通用串口升级协议(V1.1)实现设备固件升级",
"支持发送自定义AT指令",
"通讯日志实时显示,方便调试",
]
@@ -209,16 +216,28 @@ story.append(make_table(
))
story.append(Paragraph("4.2 参数配置区域", style_h2))
story.append(Paragraph("包含Lora参数配置和查询操作:", style_body))
story.append(Paragraph("包含Lora参数、全功率时段配置、激光控制以及查询/升级操作:", style_body))
story.append(Paragraph("Lora 参数:", style_body))
story.append(Paragraph(
"信道频率(fc):下拉选择Lora通信频率,范围410.1MHz ~ 524.9MHz,步进200kHz(共575个信道)。"
"信道频率(fc):下拉选择Lora通信频率,范围410.1MHz ~ 492.9MHz,步进200kHz(共415个信道)。"
'选择后点击"发送"按钮即可修改设备频率。',
style_bullet
))
story.append(Paragraph("查询当前配置:", style_body))
story.append(Paragraph("全功率时段配置:", style_body))
story.append(Paragraph(
'点击"查询当前配置(para)"按钮,向设备发送para指令,查询设备全部参数。查询结果将自动解析并显示在下方的参数信息区域。',
"设置全功率工作时间段:开始时间(0~23时)、持续时间(0~24时,0=关闭),"
'输入后点击"发送"按钮下发配置。',
style_bullet
))
story.append(Paragraph("激光控制:", style_body))
story.append(Paragraph(
'点击"打开"/"关闭"按钮控制激光开关;"自动关闭(min)"设置激光自动关闭时间(0=禁用),点击"设置"下发。',
style_bullet
))
story.append(Paragraph("查询与升级按钮:", style_body))
story.append(Paragraph(
'点击"查询当前配置(para)"按钮,软件向设备发送para指令查询全部参数。'
'查询结果将自动解析并显示在下方参数信息区域。点击"设备升级"按钮可打开设备升级对话框。',
style_bullet
))
@@ -254,14 +273,29 @@ story.append(make_table(
col_widths=[5*cm, 11*cm]
))
story.append(Paragraph("4.5 通讯日志区域", style_h2))
story.append(Paragraph("4.5 功率与激光配置区域", style_h2))
story.append(Paragraph("显示通过para指令查询到的功率与激光运行参数:", style_body))
story.append(make_table(
["参数名称", "说明"],
[
["开始时间", "全功率工作时间段的开始时刻"],
["结束时间", "全功率工作时间段的结束时刻"],
["全功率时长", "全功率工作持续时间"],
["当前模式", "当前工作模式(全功率/低功耗)"],
["激光状态", "激光当前开关状态(ON/OFF"],
["自动关闭", "激光自动关闭时间"],
],
col_widths=[5*cm, 11*cm]
))
story.append(Paragraph("4.6 通讯日志区域", style_h2))
story.append(Paragraph("界面底部,分为左右两部分:", style_body))
story.append(Paragraph("日志窗口:实时显示串口通讯内容,带时间戳。不同类型信息不同颜色区分:", style_body))
story.append(Paragraph("日志窗口:实时显示串口通讯内容。不同类型信息不同颜色区分:", style_body))
story.append(make_table(
["颜色", "含义"],
[
["蓝色", "发送的指令"],
["绿色", "接收到的"],
["绿色", "接收到的"],
["浅绿色", "系统提示信息"],
["红色", "错误信息"],
],
@@ -310,7 +344,44 @@ story.append(Paragraph(
style_warning
))
story.append(Paragraph("5.4 发送自定义指令", style_h2))
story.append(Paragraph("5.4 全功率时段配置", style_h2))
steps = [
"确认串口已成功连接。",
'"参数配置"区域的"全功率时段配置"中输入开始时间(0~23)和持续时间(0~240=关闭)。',
'点击"发送"按钮下发配置。',
'发送后建议点击"查询当前配置"验证配置是否生效。',
]
for i, s in enumerate(steps, 1):
story.append(step(i, s))
story.append(Paragraph("5.5 激光控制", style_h2))
steps = [
"确认串口已成功连接。",
'点击"打开""关闭"按钮控制激光开关。',
"如需要设置自动关闭时间,在\"自动关闭(min)\"框中输入分钟数(0=禁用),点击\"设置\"下发。",
'发送后建议点击"查询当前配置"验证激光状态。',
]
for i, s in enumerate(steps, 1):
story.append(step(i, s))
story.append(Paragraph("5.6 设备升级", style_h2))
story.append(Paragraph("设备升级用于通过通用串口升级协议对设备固件进行升级。升级期间请保持设备供电正常。", style_body))
steps = [
"确认串口已成功连接。",
'点击"参数配置"区域中的"设备升级"按钮,打开设备升级对话框。',
"在对话框中选择要更新的固件文件(.bin),并确认设备MAC地址(默认自动填充本机MAC)。",
'点击"开始升级"按钮,软件通过协议下发固件并向设备逐包传输。',
"握住安装、进度条显示传输进度;升级日志显示握手/下发/完成等过程信息。",
"升级完成后可在同一对话框再次点击\"开始升级\"重复升级,无需关闭重开。",
]
for i, s in enumerate(steps, 1):
story.append(step(i, s))
story.append(Paragraph(
"注意:升级过程中请勿断开串口或断电,否则可能导致设备无法正常启动。",
style_warning
))
story.append(Paragraph("5.7 发送自定义指令", style_h2))
steps = [
"确认串口已成功连接。",
'在通讯日志区域右侧的"自定义指令"输入框中输入AT指令。',
@@ -328,7 +399,10 @@ story.append(make_table(
[
["para", "查询设备全部参数", "para"],
["lora fc <频率值>", "设置Lora信道频率(单位Hz", "lora fc 433100000"],
["(自定义指令)", "在自定义指令输入框中输入任意AT指令", ""],
["fpocfg <开始> <持续>", "设置全功率工作时间段(时,0=关闭)", "fpocfg 8 2"],
["laser on / off", "打开/关闭激光", "laser on"],
["laser time <min>", "设置激光自动关闭时间(0=禁用)", "laser time 10"],
["(自定义指令)", "在自定义指令输入框中输入任意指令", ""],
],
col_widths=[5*cm, 6*cm, 5*cm]
))
@@ -365,6 +439,11 @@ qa_items = [
"1. 点击更多信息;\n"
"2. 点击仍要运行按钮;\n"
"3. 此提示是因为exe未做代码签名,软件本身安全。"),
("点击设备升级后无握手/升级失败",
"1. 确认设备MAC地址正确;\n"
"2. 确认固件文件为正确的.bin文件;\n"
"3. 确认串口连接正常、设备供电稳定;\n"
"4. 查看通讯日志中的设备调试信息辅助排查。"),
]
for q, a in qa_items:
story.append(Paragraph("Q: " + q, style_q))