hookvision-rk

钢包工位视频监测系统

基于 Python + PySide6 + OpenCV 的跨平台钢包工位监测系统，支持 RTSP 视频预览、RFID/Modbus 自动工位切换、AI 识别标注（MQTT）。

功能特性

• 双路 RTSP 实时视频预览（左/右摄像头）
• RFID Socket 或 Modbus TCP 自动触发工位切换
• 自动/手动模式切换
• AI 模块 MQTT 接入，支持目标检测标注
• 空闲超时自动清空工位
• 多工位配置管理
• 跨平台支持（Windows / Linux）

安装与运行

方式一：源码运行（开发环境）

1. 安装 Python 3.8+
2. 安装依赖：pip install -r requirements.txt
3. 根据现场修改 config.dev.ini
4. 运行：python main.py --dev

方式二：二进制一键部署（生产环境，推荐）

部署包为 PyInstaller 编译的二进制版本，不含 Python 源码，无需安装 Python 环境，支持离线部署。

一键部署

bash deploy/deploy.sh <目标IP> <用户名> <密码>

# 示例
bash deploy/deploy.sh 192.168.1.211 root 123456

脚本自动完成：构建 → 传输 → 离线安装依赖 → 注册 systemd 服务 → 开机自启

手动部署

# 1. 构建部署包
bash deploy/pack.sh deploy/

# 2. 传输到目标设备
scp -r deploy/hookvision_rk3578 root@<RK3578_IP>:/tmp/

# 3. 在目标设备上安装
cd /tmp/hookvision_rk3578 && sudo bash install.sh

部署目录结构

目标设备安装后的目录：

/opt/hookvision/                    # 安装目录
├── hookvision/                     # 二进制可执行文件
│   ├── HookVision                  # 主程序（ELF 可执行）
│   ├── _internal/                  # PyInstaller 打包的依赖库
│   ├── config.ini                  # 配置文件
│   ├── config.prod.ini             # 生产环境配置
│   └── config.dev.ini              # 开发环境配置
├── start.sh                        # 启动脚本
└── install.sh                      # 安装脚本

配置文件

文件	用途
/opt/hookvision/config.prod.ini	生产环境配置（部署后修改此文件）
/opt/hookvision/config.dev.ini	开发环境配置

修改配置后重启服务生效：

sudo systemctl restart hookvision

配置项说明

配置节	说明
[RFID]	RFID 读卡器 TCP 连接参数
[Modbus]	Modbus TCP 连接及轮询参数
[AI]	MQTT 服务器地址及订阅主题
[AI:N]	AI 模块 N 的 broker 地址和端口
[Bucket:N]	工位 N 的左右摄像头 RTSP 地址、MQTT 主题、AI 模块编号

服务管理

部署后通过 systemd 管理服务：

systemctl start hookvision         # 启动
systemctl stop hookvision          # 停止
systemctl restart hookvision       # 重启
systemctl status hookvision        # 查看状态
journalctl -u hookvision -f        # 查看实时日志

开机自启已默认启用。

部署时还会自动设置屏幕永不熄屏（禁用屏幕保护和 DPMS 休眠），确保设备常亮显示。

项目文件说明

文件/目录	说明
main.py	程序入口
hookvision/	核心业务代码
assets/	图标、语音等资源
config.dev.ini	开发环境配置
config.prod.ini	生产环境配置
HookVision-linux.spec	PyInstaller Linux 打包配置
deploy/pack.sh	部署包构建脚本
deploy/deploy.sh	一键部署脚本
deploy/hookvision_rk3578/debs/	离线 .deb 系统依赖包

注意事项

• RTSP 地址需包含用户名密码（如 rtsp://user:pass@ip:port/...）
• 确保摄像头或 NVR 的 RTSP 服务已开启
• 一键部署需要目标设备 SSH 可达，且安装了 sshpass（脚本会自动安装）

许可证

内部使用