OTA-QL 是面向雷达设备的完整 OTA(空中升级)固件管理系统,支持 TCP 和 MQTT(S) 远程固件升级协议。系统包含服务端、Web 管理面板、桌面监控工具和 3D 雷达数据可视化演示模块。
当前版本: V20.1
项目类型: 物联网管理系统
开发周期: 2024-2026
项目状态: 生产环境,管理 500+ 设备
| 组件 | 技术栈 | 职责 |
|---|---|---|
| Go Server | Go + cmux + MQTT | 设备网关、HTTPS API、MQTT broker、协议路由 |
| Web 管理面板 | HTML/CSS/JS | 设备注册、固件管理、OTA 推送、用户认证 |
| 桌面监控工具 | Python + PySide6 | 实时设备监控、批量操作、日志追踪、虚拟滚动 |
| 3D 雷达演示 | Python + PyQt/Three.js | 雷达点云可视化、实时数据流展示、3D 目标追踪 |
| Device Protocol | TCP/MQTT + Protobuf | 双协议设备通信、自动切换和回退 |
┌─────────────────────────────────────────────────────────────────┐
│ OTA-QL 系统 │
└─────────────────────────────────────────────────────────────────┘
│
┌─────────────────────┼─────────────────────┬─────────────┐
│ │ │ │
▼ ▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐ ┌──────────┐
│ Go OTA Server │ │ Web 管理面板 │ │ 桌面监控工具 │ │3D 雷达演示│
│(cmux 网关) │ │(设备/固件管理)│ │(批量操作) │ │(数据可视化)│
└───────┬───────┘ └───────────────┘ └───────────────┘ └──────────┘
│
├─── TCP V2 协议 ────→ 设备群组 A
│
└─── MQTT(S) 协议 ───→ 设备群组 B
│
▼
固件推送 / 状态监控 / 日志追踪
- TCP V2 协议:直连设备,低延迟固件推送
- MQTT(S) 协议:云端中继,支持 NAT 穿透
- 自动协议切换:根据网络环境智能选择协议
- 故障回退机制:升级失败自动恢复到旧版本
- 批量推送:支持最多 500 设备并发升级
- 分组管理:按设备类型、固件版本、区域分组
- 进度追踪:实时显示每台设备的升级进度
- 大批次排队:超过并发上限自动排队等候
- 实时设备列表:虚拟滚动技术支持大规模设备展示
- OTA 进度可视化:实时进度条、状态标识、完成百分比
- 实时日志流:固件烧录日志实时推送和过滤
- 批量操作面板:一键全选、批量推送、批量重启
- 设备健康检查:连接状态、固件版本、异常告警
- 点云实时渲染:3D 空间中实时显示雷达点云数据
- 目标追踪可视化:运动目标轨迹追踪和预测
- 多维数据展示:距离、速度、角度、能量的多维可视化
- 回放与录制:雷达数据录制和离线回放功能
- 性能优化:支持高帧率实时数据流渲染
- 设备注册与管理:设备列表、信息编辑、批量导入
- 固件版本控制:版本上传、发布管理、历史版本追溯
- OTA 推送接口:Web 界面和 RESTful API 双通道
- 实时进度监控:推送状态仪表板、设备状态统计
- 用户认证授权:JWT 认证、角色权限、操作审计
- 设备黑名单:异常设备自动拦截和隔离
- 自动设备注销:长期离线设备自动清理
- 拦截日志持久化:完整的安全审计追踪
- 网关地址白名单:只允许授权网关接入
- cmux 端口复用:单端口同时支持 HTTPS、TCP、MQTT
- 协程池管理:高效的 Go 协程资源管理
- 流控机制:防止网络拥塞和设备过载
- 队列缓冲:大批次任务自动排队和限流
- TCP/MQTT 双协议:适配不同网络环境
- Protobuf 序列化:高效的二进制数据传输
- 协议自动切换:网络故障时无感知切换
- 向后兼容:支持多版本协议共存
- 桌面监控工具:专业的设备管理和批量操作界面
- 虚拟滚动优化:流畅展示数千台设备
- 实时数据流:WebSocket 推送设备状态和日志
- 日志持久化:完整的操作审计和故障追溯
- 3D 雷达演示:直观展示雷达工作原理和数据质量
- 实时点云渲染:高性能 3D 图形引擎
- 多维数据分析:支持多种雷达数据格式解析
后端服务:
- Go - 核心 OTA 服务和设备网关
- cmux - 端口复用和协议路由
- MQTT Broker - 消息队列和设备通信
- Protobuf - 高效序列化协议
Web 前端:
- HTML/CSS/JavaScript - 管理界面
- WebSocket - 实时数据推送
- RESTful API - 标准化接口
桌面监控工具:
- Python 3.x - 核心开发语言
- PySide6 / PyQt6 - 跨平台桌面 UI 框架
- 虚拟滚动控件 - 大规模列表性能优化
- 异步 IO - 非阻塞网络通信
3D 可视化:
- Python + PyQt - 桌面端 3D 渲染
- Three.js - Web 端 3D 图形
- 点云处理库 - 雷达数据解析和处理
基础设施:
- Docker - 容器化部署
- systemd - 服务守护和自动重启
- SQLite / JSON - 轻量级数据存储
ota/
├── server/ # Go OTA 服务
│ ├── gateway/ # cmux 网关和协议路由
│ ├── ota/ # 固件推送核心逻辑
│ ├── mqtt/ # MQTT broker 集成
│ └── api/ # RESTful API 服务
├── web/ # Web 管理面板
│ ├── dashboard/ # 仪表板和统计
│ ├── device/ # 设备管理界面
│ └── firmware/ # 固件版本管理
├── monitor/ # 桌面监控工具
│ ├── ui/ # PySide6 界面
│ ├── device_list/ # 虚拟滚动设备列表
│ └── batch_ops/ # 批量操作逻辑
├── radar_viz/ # 3D 雷达可视化演示
│ ├── 3d_viewer/ # 点云 3D 渲染器
│ ├── data_parser/ # 雷达数据解析
│ └── replay/ # 数据录制和回放
├── device/ # 设备端协议实现
│ ├── tcp_client/ # TCP 协议客户端
│ └── mqtt_client/ # MQTT 协议客户端
└── docs/ # 文档和部署指南
- 桌面监控工具:批量操作和实时监控
- 3D 雷达演示:点云可视化和数据分析
生产环境 OTA 管理系统,展示高并发处理、双协议支持、批量固件管理和专业数据可视化能力。