YuanHongbin/LaserTracing_ConfigureAPP
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

宽带版：exe文件名与属性补充版本号V1.0.0，同步说明书生成脚本并生成宽带版说明书

Browse Source
This commit is contained in:
YuanHongbin
2026-09-07 17:29:21 +08:00
parent 1d0b4b2fd1
commit 4a6ff717c4
4 changed files with 75 additions and 106 deletions
Download Patch File Download Diff File Expand all files Collapse all files
generate_manual.py
+73 -104
View File
@@ -1,5 +1,10 @@
# -*- coding: utf-8 -*-
"""生成边坡变形监测配置工具使用说明书（PDF格式）"""
# 生成配置工具使用说明书（PDF格式）
# 用法: python generate_manual.py narrow -> 生成窄带版说明书
# python generate_manual.py wide -> 生成宽带版说明书
import os
import sys
from reportlab.lib.pagesizes import A4
from reportlab.lib.units import cm, mm
from reportlab.lib.colors import HexColor, black, white
@@ -11,7 +16,25 @@ from reportlab.platypus import (
)
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
import os
# ── 版本与型号配置 ──
SOFTWARE_VERSION = "V1.0.0"
arg = sys.argv[1].lower() if len(sys.argv) > 1 else "narrow"
if arg in ("wide", "broadband", "宽带"):
EDITION = "宽带版"
FC_RANGE = "433.1MHz ~ 492.6MHz"
FC_CHANNELS = 120
FC_EXAMPLE = "433100000"
else:
EDITION = "窄带版"
FC_RANGE = "470.1MHz ~ 492.6MHz"
FC_CHANNELS = 46
FC_EXAMPLE = "470100000"
FC_STEP = "500kHz"
EXE_NAME = f"边坡变形监测-变形(位移)自动测量系统配置工具({EDITION} {SOFTWARE_VERSION}).exe"
PDF_NAME = f"边坡变形监测-变形(位移)自动测量系统配置工具使用说明书({EDITION} {SOFTWARE_VERSION}).pdf"
# 注册中文字体
font_dir = os.path.join(os.environ.get("WINDIR", r"C:\Windows"), "Fonts")
@@ -75,10 +98,7 @@ def step(num, text):
return Paragraph(str(num) + ". " + text, style_step)
# 构建文档
output_path = os.path.join(
os.path.dirname(os.path.abspath(__file__)),
"边坡变形监测配置工具使用说明书.pdf"
)
output_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), PDF_NAME)
doc = SimpleDocTemplate(output_path, pagesize=A4,
leftMargin=2.5*cm, rightMargin=2.5*cm,
topMargin=2.5*cm, bottomMargin=2.5*cm)
@@ -87,9 +107,9 @@ story = []
# 封面
story.append(Spacer(1, 6*cm))
story.append(Paragraph("边坡变形监测-变形(位移)<br/>自动测量系统配置工具<br/>使用说明书", style_cover_title))
story.append(Paragraph("边坡变形监测-变形(位移)<br/>自动测量系统配置工具(" + EDITION + ")<br/>使用说明书", style_cover_title))
story.append(Spacer(1, 1.5*cm))
story.append(Paragraph("版本 V2.0", style_cover_sub))
story.append(Paragraph("版本 " + SOFTWARE_VERSION, style_cover_sub))
story.append(PageBreak())
# 目录
@@ -99,23 +119,20 @@ toc_items = [
(True, "2 运行环境"),
(True, "3 软件安装与启动"),
(False, " 3.1 安装"),
(False, " 3.2 ��动"),
(False, " 3.2 启动"),
(False, " 3.3 USB转串口驱动安装"),
(True, "4 软件界面说明"),
(False, " 4.1 串口连接区域"),
(False, " 4.2 参数配置区域"),
(False, " 4.3 设备参数信息区域"),
(False, " 4.4 低功耗配置区域"),
(False, " 4.5 功率与激光配置区域"),
(False, " 4.6 通讯日志区域"),
(False, " 4.5 通讯日志区域"),
(True, "5 操作指南"),
(False, " 5.1 连接设备"),
(False, " 5.2 查询设备参数"),
(False, " 5.3 修改Lora信道频率"),
(False, " 5.4 全功率时段配置"),
(False, " 5.5 激光控制"),
(False, " 5.6 设备升级"),
(False, " 5.7 发送自定义指令"),
(False, " 5.4 设备升级"),
(False, " 5.5 发送自定义指令"),
(True, "6 指令参考"),
(True, "7 常见问题与故障排除"),
]
@@ -126,7 +143,7 @@ story.append(PageBreak())
# 1 软件概述
story.append(Paragraph("1 软件概述", style_h1))
story.append(Paragraph(
"边坡变形监测-变形(位移)自动测量系统配置工具是一款用于激光示踪传感器设备的网关参数配置软件。"
"边坡变形监测-变形(位移)自动测量系统配置工具(" + EDITION + ")是一款用于激光示踪传感器设备的网关参数配置软件。"
"软件通过RS485串口与传感器设备进行通信，支持查询设备参数、修改Lora无线通信频率、发送自定义指令等操作。",
style_body
))
@@ -135,10 +152,10 @@ features = [
"自动识别并列出本机可用串口",
"通过RS485串口连接激光示踪传感器设备",
"一键查询设备全部参数（软件版本、硬件版本、MAC地址、电池电量、注册状态等）",
"修改Lora无线通信信道频率（410.1MHz ~ 492.9MHz，步进200kHz）",
"修改Lora无线通信信道频率（" + FC_RANGE + "，步进" + FC_STEP + "，共" + str(FC_CHANNELS) + "个信道，信道0起始）",
"波特率支持修改（内置2400~115200常用波特率，也可手动输入）",
"查看设备低功耗配置参数（采集间隔、上报时间、紧急上报间隔/时长）",
"查看功率与激光参数，并配置全功率工作时间段",
"控制激光开关及设置自动关闭时间",
"注册状态自动转换为\"已注册/未注册\"显示",
"通过通用串口升级协议（V1.1）实现设备固件升级",
"支持发送自定义AT指令",
"通讯日志实时显示，方便调试",
@@ -165,17 +182,17 @@ story.append(Paragraph("3 软件安装与启动", style_h1))
story.append(Paragraph("3.1 安装", style_h2))
story.append(Paragraph(
'本软件为绿色免安装版本，无需安装过程。将"边坡变形监测-变形(位移)自动测量系统配置工具.exe"文件复制到电脑任意目录即可使用。',
"本软件为绿色免安装版本，无需安装过程。将\"" + EXE_NAME + "\"文件复制到电脑任意目录即可使用。",
style_body
))
story.append(Paragraph("3.2 启动", style_h2))
story.append(Paragraph(
'双击"边坡变形监测-变形(位移)自动测量系统配置工具.exe"文件即可启动软件。',
"双击\"" + EXE_NAME + "\"文件即可启动软件。窗口标题栏显示软件型号（" + EDITION + "）与版本号（" + SOFTWARE_VERSION + "）。",
style_body
))
story.append(Paragraph(
'注意：如果Windows弹出"Windows已保护你的电脑"提示，请点击"更多信息"->"仍要运行"。',
"注意：如果Windows弹出\"Windows已保护你的电脑\"提示，请点击\"更多信息\"->\"仍要运行\"。",
style_body
))
@@ -192,7 +209,7 @@ story.append(make_table(
))
story.append(Spacer(1, 6))
story.append(Paragraph(
'驱动安装成功后，将USB转RS485线插入电脑，在"设备管理器->端口(COM和LPT)"中应能看到对应的COM口编号。',
"驱动安装成功后，将USB转RS485线插入电脑，在\"设备管理器->端口(COM和LPT)\"中应能看到对应的COM口编号。",
style_body
))
@@ -205,8 +222,8 @@ story.append(Paragraph("位于界面顶部，用于选择和配置串口连接
story.append(make_table(
["项目", "说明", "默认值"],
[
["串口选择", '下拉框选择可用串口，点击"刷新"按钮可重新扫描', "自动选择第一个"],
["波特率", "串口通信速率", "9600 bps"],
["串口选择", "下拉框选择可用串口，点击\"刷新\"按钮可重新扫描", "自动选择第一个"],
["波特率", "串口通信速率，可编辑下拉框，内置常用波特率，也可手动输入", "9600 bps"],
["数据位", "每帧数据位数", "8"],
["停止位", "停止位位数", "1"],
["校验", "奇偶校验方式", "None（无校验）"],
@@ -216,28 +233,18 @@ 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 ~ 492.9MHz，步进200kHz（共415个信道）。"
'选择后点击"发送"按钮即可修改设备频率。',
style_bullet
))
story.append(Paragraph("全功率时段配置：", style_body))
story.append(Paragraph(
"设置全功率工作时间段：开始时间(0~23时)、持续时间(0~24时，0=关闭)，"
'输入后点击"发送"按钮下发配置。',
style_bullet
))
story.append(Paragraph("激光控制：", style_body))
story.append(Paragraph(
'点击"打开"/"关闭"按钮控制激光开关；"自动关闭(min)"设置激光自动关闭时间（0=禁用），点击"设置"下发。',
"信道频率(fc)：下拉选择Lora通信频率，范围" + FC_RANGE + "，步进" + FC_STEP
+ "（共" + str(FC_CHANNELS) + "个信道，信道0起始，即信道0对应" + FC_RANGE.split(" ~ ")[0] + "）。"
"选择后点击\"发送\"按钮即可修改设备频率。",
style_bullet
))
story.append(Paragraph("查询与升级按钮：", style_body))
story.append(Paragraph(
'点击"查询当前配置(para)"按钮，软件向设备发送para指令查询全部参数。'
'查询结果将自动解析并显示在下方参数信息区域。点击"设备升级"按钮可打开设备升级对话框。',
"点击\"查询当前配置(para)\"按钮，软件向设备发送para指令查询全部参数。"
"查询结果将自动解析并显示在下方参数信息区域。点击\"设备升级\"按钮可打开设备升级对话框。",
style_bullet
))
@@ -254,7 +261,7 @@ story.append(make_table(
["通信方式", "设备当前通信方式（CommInf）"],
["设备标识", "设备唯一标识（DeviceSign）"],
["网关MAC", "所连接网关的MAC地址"],
["注册状态", "设备在网关上的注册状态"],
["注册状态", "设备在网关上的注册状态，自动显示为\"已注册\"或\"未注册\""],
["Lora频率", "当前Lora通信频率"],
],
col_widths=[4*cm, 12*cm]
@@ -273,22 +280,7 @@ story.append(make_table(
col_widths=[5*cm, 11*cm]
))
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("4.5 通讯日志区域", style_h2))
story.append(Paragraph("界面底部，分为左右两部分：", style_body))
story.append(Paragraph("日志窗口：实时显示串口通讯内容。不同类型信息用不同颜色区分：", style_body))
story.append(make_table(
@@ -302,7 +294,7 @@ story.append(make_table(
col_widths=[4*cm, 12*cm]
))
story.append(Spacer(1, 6))
story.append(Paragraph('自定义指令：右侧面板可输入自定义AT指令，点击"发送"或按Enter键发送。', style_body))
story.append(Paragraph("自定义指令：右侧面板可输入自定义AT指令，点击\"发送\"或按Enter键发送。", style_body))
# 5 操作指南
story.append(Paragraph("5 操作指南", style_h1))
@@ -311,18 +303,18 @@ story.append(Paragraph("5.1 连接设备", style_h2))
steps = [
"将USB转RS485串口线连接到电脑USB接口。",
"将RS485线的A、B端分别连接到传感器设备的RS485接口（注意A接A、B接B）。",
'启动软件，在"串口连接"区域点击"刷新"按钮扫描可用串口。',
"启动软件，在\"串口连接\"区域点击\"刷新\"按钮扫描可用串口。",
"在下拉框中选择对应的COM口。",
"确认波特率等参数与设备一致（默认9600, 8N1）。",
'点击"打开串口"按钮，按钮文字变为"关闭串口"即表示连接成功。通讯日志中将显示连接信息。',
"确认波特率等参数与设备一致（默认9600, 8N1，波特率可直接修改）。",
"点击\"打开串口\"按钮，按钮文字变为\"关闭串口\"即表示连接成功。通讯日志中将显示连接信息。",
]
for i, s in enumerate(steps, 1):
story.append(step(i, s))
story.append(Paragraph("5.2 查询设备参数", style_h2))
steps = [
'确认串口已成功连接（按钮显示"关闭串口"）。',
'点击"查询当前配置(para)"按钮。',
"确认串口已成功连接（按钮显示\"关闭串口\"）。",
"点击\"查询当前配置(para)\"按钮。",
"软件将发送para指令，设备返回参数信息后自动解析。",
"设备参数信息和低功耗配置区域将显示查询到的数值。",
"Lora频率下拉框也会同步更新为当前设备频率。",
@@ -333,9 +325,9 @@ for i, s in enumerate(steps, 1):
story.append(Paragraph("5.3 修改Lora信道频率", style_h2))
steps = [
"确认串口已成功连接。",
'在"Lora 参数"区域的下拉框中选择目标信道频率。',
'点击"发送"按钮，软件将发送"lora fc <频率值>"指令。',
'发送后建议点击"查询当前配置"验证修改是否成功。',
"在\"Lora 参数\"区域的下拉框中选择目标信道频率。",
"点击\"发送\"按钮，软件将发送\"lora fc <频率值>\"指令。",
"发送后建议点击\"查询当前配置\"验证修改是否成功。",
]
for i, s in enumerate(steps, 1):
story.append(step(i, s))
@@ -344,34 +336,14 @@ story.append(Paragraph(
style_warning
))
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("5.4 设备升级", style_h2))
story.append(Paragraph("设备升级用于通过通用串口升级协议对设备固件进行升级。升级期间请保持设备供电正常。", style_body))
steps = [
"确认串口已成功连接。",
'点击"参数配置"区域中的"设备升级"按钮，打开设备升级对话框。',
"点击\"参数配置\"区域中的\"设备升级\"按钮，打开设备升级对话框。",
"在对话框中选择要更新的固件文件（.bin），并确认设备MAC地址（默认自动填充本机MAC）。",
'点击"开始升级"按钮，软件通过协议下发固件并向设备逐包传输。',
"握住安装、进度条显示传输进度；升级日志显示握手/下发/完成等过程信息。",
"点击\"开始升级\"按钮，软件通过协议下发固件并向设备逐包传输。",
"弹出进度条显示传输进度；升级日志显示握手/下发/完成等过程信息。",
"升级完成后可在同一对话框再次点击\"开始升级\"重复升级，无需关闭重开。",
]
for i, s in enumerate(steps, 1):
@@ -381,11 +353,11 @@ story.append(Paragraph(
style_warning
))
story.append(Paragraph("5.7 发送自定义指令", style_h2))
story.append(Paragraph("5.5 发送自定义指令", style_h2))
steps = [
"确认串口已成功连接。",
'在通讯日志区域右侧的"自定义指令"输入框中输入AT指令。',
'点击"发送"按钮或按Enter键发送。',
"在通讯日志区域右侧的\"自定义指令\"输入框中输入AT指令。",
"点击\"发送\"按钮或按Enter键发送。",
"通讯日志中将显示发送的指令和设备的回应。",
]
for i, s in enumerate(steps, 1):
@@ -398,10 +370,7 @@ story.append(make_table(
["指令", "功能", "示例"],
[
["para", "查询设备全部参数", "para"],
["lora fc <频率值>", "设置Lora信道频率（单位Hz）", "lora fc 433100000"],
["fpocfg <开始> <持续>", "设置全功率工作时间段（时，0=关闭）", "fpocfg 8 2"],
["laser on / off", "打开/关闭激光", "laser on"],
["laser time <min>", "设置激光自动关闭时间（0=禁用）", "laser time 10"],
["lora fc <频率值>", "设置Lora信道频率（单位Hz）", "lora fc " + FC_EXAMPLE],
["（自定义指令）", "在自定义指令输入框中输入任意指令", "—"],
],
col_widths=[5*cm, 6*cm, 5*cm]
@@ -417,8 +386,8 @@ qa_items = [
"1. 检查USB转RS485线是否已插入电脑；\n"
"2. 检查设备管理器中是否出现对应的COM口；\n"
"3. 确认USB转串口驱动已正确安装；\n"
'4. 点击"刷新"按钮重新扫描。'),
('点击"打开串口"后提示连接失败',
"4. 点击\"刷新\"按钮重新扫描。"),
("点击\"打开串口\"后提示连接失败",
"1. 确认该COM口未被其他软件占用（如串口助手、Keil等）；\n"
"2. 尝试拔插USB线后重试；\n"
"3. 尝试更换USB接口。"),
@@ -431,11 +400,11 @@ qa_items = [
"1. 确认传感器和网关使用相同的Lora信道频率；\n"
"2. 修改频率后需等待设备重新连接；\n"
"3. 可通过para命令验证当前频率设置。"),
('参数信息区域显示 "-"',
("参数信息区域显示 \"-\"",
"1. 表示尚未查询或未收到设备回应；\n"
'2. 请先点击"查询当前配置"按钮；\n'
"2. 请先点击\"查询当前配置\"按钮；\n"
"3. 检查串口连接是否正常。"),
('Windows提示"已保护你的电脑"无法运行',
("Windows提示\"已保护你的电脑\"无法运行",
"1. 点击更多信息；\n"
"2. 点击仍要运行按钮；\n"
"3. 此提示是因为exe未做代码签名，软件本身安全。"),
@@ -451,4 +420,4 @@ for q, a in qa_items:
# 生成PDF
doc.build(story)
print("说明书已生成: " + output_path)
print("说明书已生成: " + output_path)
version_info.py
+2 -2
View File
@@ -19,11 +19,11 @@ VSVersionInfo(
"080404b0",
[
StringStruct("CompanyName", ""),
StringStruct("FileDescription", "边坡变形监测-变形(位移)自动测量系统配置工具(宽带版)"),
StringStruct("FileDescription", "边坡变形监测-变形(位移)自动测量系统配置工具(宽带版 V1.0.0)"),
StringStruct("FileVersion", "1.0.0.0"),
StringStruct("InternalName", "laser_tracing_config"),
StringStruct("LegalCopyright", ""),
StringStruct("OriginalFilename", "边坡变形监测-变形(位移)自动测量系统配置工具(宽带版).exe"),
StringStruct("OriginalFilename", "边坡变形监测-变形(位移)自动测量系统配置工具(宽带版 V1.0.0).exe"),
StringStruct("ProductName", "边坡变形监测-变形(位移)自动测量系统配置工具"),
StringStruct("ProductVersion", "1.0.0.0"),
],
边坡变形监测-变形(位移)自动测量系统配置工具使用说明书(宽带版 V1.0.0).pdf
BIN
View File
Binary file not shown.
边坡变形监测配置工具使用说明书.pdf
BIN
View File
Binary file not shown.