diff --git a/generate_manual.py b/generate_manual.py index 8dbd515..a967c43 100644 --- a/generate_manual.py +++ b/generate_manual.py @@ -89,7 +89,7 @@ story = [] story.append(Spacer(1, 6*cm)) story.append(Paragraph("边坡变形监测-变形(位移)
自动测量系统配置工具
使用说明书", 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~24,0=关闭)。', + '点击"发送"按钮下发配置。', + '发送后建议点击"查询当前配置"验证配置是否生效。', +] +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 ", "设置激光自动关闭时间(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)) diff --git a/边坡变形监测配置工具使用说明书.pdf b/边坡变形监测配置工具使用说明书.pdf index dea5072..b961af8 100644 Binary files a/边坡变形监测配置工具使用说明书.pdf and b/边坡变形监测配置工具使用说明书.pdf differ