wenhongquan cc90255848 新增 Windows 便携版 exe 打包支持并移除 RS485 方向脚控制 1 неделя назад
..
README_WINDOWS_EXE.md cc90255848 新增 Windows 便携版 exe 打包支持并移除 RS485 方向脚控制 1 неделя назад
build_exe.bat cc90255848 新增 Windows 便携版 exe 打包支持并移除 RS485 方向脚控制 1 неделя назад
dzxj_dtu.spec cc90255848 新增 Windows 便携版 exe 打包支持并移除 RS485 方向脚控制 1 неделя назад
launcher.py cc90255848 新增 Windows 便携版 exe 打包支持并移除 RS485 方向脚控制 1 неделя назад
requirements_windows.txt cc90255848 新增 Windows 便携版 exe 打包支持并移除 RS485 方向脚控制 1 неделя назад

README_WINDOWS_EXE.md

Windows 便携版 exe(打包与使用说明)

把本项目的后端(Flask + Socket.IO)和前端(frontend/dist)打成一个 单文件 exe, 在 Windows 电脑上双击即可运行,用浏览器管理 DTU/线架(现场调试、演示、PC 端应急操作)。

注意:这不是给 RK 板子用的安装包。设备端仍跑 Linux + systemctl + /dev/ttyS8; 本 exe 是「在 Windows 电脑上跑的同一套管理端」。

一、构建(在 Windows 上)

前置:Python 3.10+(勾选 Add to PATH)、Node.js(构建前端时需要)。

:: 在项目根目录执行
packaging\build_exe.bat

脚本会依次:检查/构建前端 → 建 .venv-exe 虚拟环境装依赖 → PyInstaller 打包。

产物:dist\dzxj_dtu.exe(单文件,约 14.7 MB)。

手动构建等价命令:

python -m venv .venv-exe
.venv-exe\Scripts\activate
pip install -r packaging\requirements_windows.txt
python -m PyInstaller --noconfirm --clean --distpath dist --workpath build\pyinstaller packaging\dzxj_dtu.spec

二、使用

  1. 把 dzxj_dtu.exe 拷到任意目录双击运行(控制台窗口会显示地址和数据目录)。
  2. 程序自动打开浏览器 http://127.0.0.1:5001/;端口被占用时会直接打开已有实例。
  3. 首次运行会在 exe 同级创建 data\ 目录:

    dzxj_dtu.exe
    data\
    serial_config.json   串口配置(首次运行自动识别 USB-RS485 口)
    dtu_config.json      DTU 身份/地址段/端口映射
    mqtt_config.json     MQTT 连接参数
    devices.json         线架绑定表(地址↔UID)
    backups\             配置自动快照
    
  4. 网页里「串口」页选 COM 口(USB-RS485,9600 8N1)连接,即可按地址段扫描线架。

关闭控制台窗口或按 Ctrl+C 即退出。

三、可选环境变量

变量 默认 说明
DZXJ_HOST 127.0.0.1 监听地址;局域网其它设备要访问就设 0.0.0.0(会触发防火墙提示)
FLASK_PORT 5001 监听端口
DZXJ_DATA_DIR exe同级\data 配置/快照存放目录
LOG_LEVEL INFO 日志级别

设置方式(临时):set DZXJ_HOST=0.0.0.0 && dzxj_dtu.exe

四、Windows 版功能差异

功能 说明
串口 / MODBUS-RTU / 线架扫描 / 读卡 / 下发卡号 ✅ 正常(用 USB-RS485 的 COM 口)
MQTT 上行/下行、注册、告警 ✅ 正常
Web 管理界面(Vue 前端) ✅ 内嵌在 exe 内
DHT11 温湿度 ❌ 无 GPIO,启动时已自动关闭(DHT11_ENABLED=false)
Nextion 串口屏 ❌ 默认端口 /dev/ttyS9 不存在,启动时已自动关闭(NEXTION_ENABLED=false)
「重启服务」按钮 ❌ 没有 systemd,提示关闭程序后重开(/api/system/restart_service 返回 400)
固件 OTA 脚本、网络静态 IP 配置 ⚠️ 依赖 Linux 工具(ip/nmcli/reboot),不可用

五、排障

  • 双击闪退:在 cmd 里执行 dzxj_dtu.exe 看报错;常见原因是端口被占用或杀软拦截。
  • 浏览器没自动打开:手动访问控制台打印的地址。
  • 找不到串口:确认 CH340/CP210x 驱动已装,设备管理器里能看到 COM 口。
  • 中文乱码:chcp 65001 后重新运行,或把控制台字体改成支持中文的字体。
  • 打包报 frontend/dist 不存在:先 cd frontend && npm install && npm run build。