设备控制(Modbus 地址配置)
时监控
操作页展示设备运行参数与状态:
| 参数 | 说明 |
|---|---|
| 高度角度 | 当前跟踪高度角 |
| 方位角度 | 当前方位角 |
| 目标角度 | 控制目标值 |
| 电机电流 | 实时电机电流 |
| 电池电压/温度 | 电源状态 |
| 电源电压 | 供电电压 |
状态面板展示多种告警标志:倾角异常、过流、超限、大风、时钟故障、电源异常等。
4.3 控制命令
| 操作 | 说明 |
|---|---|
| 自动 | 启动自动跟踪模式 |
| 手动 | 切换手动控制模式 |
| 向东/向西 | 手动微调 |
| 放平 | 支架放平 |
| 标定 | 角度传感器标定 |
| 雪天/雨天/避风/清洗 | 场景化保护与控制 |
| 指定角度 | 设定目标角度 |
| 校时 | 设备时间同步 |
4.4 调试工具
内置串口调试工具,支持 Hex 指令手工输入与发送、响应日志记录、收发标记,便于现场工程师诊断通信问题。
4.5 分控设备管理
当主控设备下挂分控设备时,支持分控设备的独立参数查看与控制。
| 操作 | 设置 | 分控 |
|---|---|---|
五、用户体验设计
5.1 产品选择入口
首页提供三张产品卡片入口(NCU / 单轴 TCU / 双轴 TCU),每张卡片包含产品图标、名称与简要说明,点击即进入对应的单页应用。
5.2 多语言支持
内置简体中文、English、Português 三语界面,语言切换在首页右上角以下拉菜单呈现,选择后立即生效并持久化到 localStorage。
5.3 双色主题
支持亮色模式与暗色模式,主题偏好通过 localStorage 持久化,页面顶部右侧按钮一键切换。完整的 CSS 变量体系(--bg-primary、--text-primary、--primary-color等),所有组件自动适配当前主题。
5.4 响应式设计
卡片、栅格系统适配移动端屏幕,底部导航栏取代传统侧边栏,符合移动端操作习惯。页面禁止浏览器默认的拉手势刷新与回弹效果,提供接近原生 APP 的交互体验。
| 操作 | 设置 | 我的 |
|---|---|---|
六、性能与部署
6.1 PWA 支持
项目集成了 Service Worker,用户可将应用添加到主屏幕(A2HS),实现离线可用和类原生启动体验。
6.2 构建产物
- 目标框架:net10.0
- 运行时:Blazor WebAssembly(.NET IL 裁剪 + AOT 可选)
- 输出:纯静态文件(HTML + CSS + JS + WASM)
- 部署方式:任意静态文件服务器(Nginx、IIS、CDN)
6.3 浏览器兼容
| 功能 | 最低版本 |
|---|---|
| Blazor WebAssembly | 现代浏览器(Chrome / Edge / Firefox / Safari) |
| Web Bluetooth | Chrome 56+、Edge 79+ |
| PWA Service Worker | 所有主流浏览器 |
七、总结
基于 Blazor WebAssembly + Web Bluetooth 的光伏设备调试软件,在免安装、跨平台、易分发三个维度上解决了传统调试工具的痛点。项目充分发挥了 .NET 生态在工业软件领域的成熟度,同时利用现代 Web 标准的设备接入能力,在浏览器环境中实现了原本需要原生应用才能完成的 BLE 通信与 Modbus 协议交互。
这套技术栈为光伏跟踪、微电网、电机控制等同类工业 IoT 场景提供了可复用的前端架
