项目概述
Air Management 是一套面向空气悬挂控制器的移动端控制系统，基于 uni-app + Vue 3 开发，主要用于车载空气悬挂设备的连接、控制、参数配置、故障提示与固件升级。
项目核心目标不是做一个普通的“蓝牙控制面板”，而是把空气悬挂设备的连接、实时状态、参数管理、自检校准、设备激活、OTA 升级和后台版本发布整合成一套完整可交付方案。
项目背景
空气悬挂类设备在实际使用中，往往同时面临几个问题：
- 设备需要通过蓝牙与手机稳定连接，且不同平台兼容性要求高
- 控制操作要求实时、直观，不能只停留在简单按钮控制
- 参数设置较多，涉及气罐压力、点火联动、精度、负载平衡等设备能力
- 设备交付后仍需要远程升级，降低售后返修和人工维护成本
- 控制器、遥控器等多个硬件模块的版本管理，需要配套后台统一发布
这个项目围绕以上需求，完成了移动端控制 App 与 OTA 固件管理后台的联动实现。
核心功能
1. 蓝牙连接与设备鉴权
- 支持 BLE 蓝牙设备搜索、连接、断开与状态监听
- 自动识别指定设备名称前缀，过滤无关设备
- 支持设备序列号读取与密码校验
- 支持缓存设备信息与缓存密码，优化二次连接体验
- 对 iOS / Android 的蓝牙扫描、MTU、写入分片等差异做了兼容处理
2. 实时空气悬挂控制
- 首页实时显示四轮压力 / 高度数据
- 显示当前挡位、气罐压力、电压、温度、联动状态、系统告警等关键状态
- 支持预置挡位切换
- 支持单轮 / 前后轮充放气控制
- 支持长按连续控制与停止保护，降低误操作风险
- 支持高度记忆模式与气压记忆模式两套工作逻辑
3. 参数设置与高级配置
- 气罐压力设置
- 点火 / 熄火联动设置
- 模式选择
- 精度设置
- 负载平衡开关
- 多语言切换（中文、日文、英文）
参数修改后，App 会向设备发送指令，并重新读取硬件实际值进行校验，避免“界面显示已修改、设备实际未生效”的问题。
4. 设备自检与校准辅助
- 提供系统自检流程入口
- 支持高度模式下的自检 / 校准流程
- 提供高度尺工具等辅助页面
这部分能力适合安装调试、售后检测和设备校准场景，能减少人工经验依赖。
5. 设备激活与系统信息管理
- 支持读取设备激活状态
- 支持输入激活码完成设备激活
- 支持读取 ECU 版本、序列号、App 版本等系统信息
- 支持实时解析设备上报告警，并提供告警清除能力
这让 App 不只是“控制工具”，也承担了设备交付和售后服务入口的角色。
6. OTA 在线升级
- 支持主板与遥控器两个升级对象
- 支持读取当前版本、检测最新版本、展示升级说明
- 支持固件下载、分包发送、进度展示、校验与取消重试
- 根据不同硬件通道采用不同升级策略，兼顾效率和稳定性
项目中已经实现从 App 检查版本，到下载固件，再到通过蓝牙向设备写入升级包的完整链路。
7. OTA 固件管理后台
除移动端外，项目还配套开发了一个轻量级 OTA 管理后台：
- 支持上传
.xlbin/.bin固件文件 - 自动解析版本号、匹配码、内容偏移、长度和校验值
- 支持主板 / 遥控器多通道版本管理
- 支持版本发布、编辑说明、删除版本
- 提供 App 可直接调用的最新版本接口
技术亮点
- 基于自定义蓝牙通信协议进行命令封包、响应匹配与数据解析
- 对 BLE 写入长度、MTU、分片发送、重试机制做了专门处理
- 实时状态数据与页面 UI 解耦，方便控制页、系统页、设置页共享能力
- OTA 升级链路支持匹配码校验、分包传输、写入重试、最终校验
- 采用较轻量的后台方案完成固件发布闭环，减少运维复杂度
项目价值
从业务角度，这个项目解决了智能空气悬挂产品从“能控制”到“可量产、可交付、可维护”的关键问题：
- 提升用户端控制体验，减少复杂硬件操作门槛
- 降低安装调试与售后支持成本
- 通过 OTA 能力减少返厂升级需求
- 通过固件后台实现版本统一管理，避免升级流程混乱
- 为后续设备系列扩展、多型号通道管理预留了基础能力
适用场景
- 改装车空气悬挂控制系统
- 智能悬挂控制器配套 App
- 需要 BLE 连接与 OTA 升级的车载硬件产品
- 需要移动端控制 + 设备参数配置 + 固件后台发布的一体化项目
案例总结
Air Management 不是单点页面开发，而是一个覆盖设备连接、实时控制、参数配置、故障处理、设备激活、在线升级和后台版本管理的完整智能硬件配套方案。
对于智能车载硬件项目来说，这类系统的价值不在于页面数量，而在于是否真正打通了“设备使用 + 设备维护 + 设备升级”的全流程。这个项目已经具备这一闭环能力。
