主题
12. 固件管理
固件管理用于维护设备 OTA 升级包，支持固件上传、版本管理、发布与下线，为设备远程升级提供基础。
12.1 设备固件
菜单路径：固件管理/设备固件
权限要求：查看需 firmware:device:view 权限
12.1.1 固件列表
固件列表显示所有设备固件包，包含以下信息：
- 固件名称
- 版本号
- 状态：草稿（draft）、已发布（active）、已下线（deprecated）
- OTA 协议类型
- 适用产品
- 文件大小
- 创建/更新时间
- 操作：查看详情、编辑、发布、下线、删除、下载等
12.1.2 搜索和筛选
支持按以下条件筛选：
- 固件名称：模糊搜索
- 版本号：模糊搜索
- 状态：草稿 / 已发布 / 已下线
- 适用产品：按产品型号筛选
- OTA 协议：按协议类型筛选
12.1.3 新建固件
权限要求：firmware:device:create
- 点击 「新建固件」
- 填写固件信息：
- 固件名称（必填）
- 版本号（必填）
- OTA 协议类型（必填）
- 升级类型（如全量升级 full）
- 适用产品（可多选）
- 硬件平台、兼容硬件、源固件版本等（按需填写）
- 上传固件文件
- 备注（可选）
- 保存后固件处于 草稿 状态
12.1.4 固件详情
点击 「详情」 可查看完整信息：
- 固件 ID、名称、版本、状态
- OTA 协议与协议参数
- 文件信息（文件名、大小、校验值）
- 适用产品、兼容硬件、源固件版本
- 回退版本、备注等
支持 下载固件包（需查看权限）。
12.1.5 固件状态流转
| 操作 | 权限 | 说明 |
|---|---|---|
| 发布 | firmware:device:publish | 将草稿（draft）发布为已发布（active），可供 OTA 使用 |
| 下线 | firmware:device:deprecate | 将已发布（active）下线为已下线（deprecated） |
| 编辑 | firmware:device:edit | 修改固件元数据与适用产品 |
| 删除 | firmware:device:delete | 仅可删除 草稿 状态固件 |
注意：已发布固件需先下线才能删除；删除操作不可恢复。
12.1.6 与设备升级的关系
- 在 网关详情 中可对网关执行固件升级（需
gateway:control:upgrade权限） - 设备 OTA 升级需使用 已发布 状态且 适用产品匹配 的固件包
- 具体升级入口与流程取决于设备/网关的产品型号与 OTA 协议配置
12.2 权限说明
12.2.1 菜单权限
firmware:device:view：查看设备固件列表与详情
12.2.2 操作权限
firmware:device:create：创建设备固件包firmware:device:edit：编辑设备固件包firmware:device:publish：发布固件包firmware:device:deprecate：下线固件包firmware:device:delete：删除草稿固件包
12.3 常见问题
Q: 无法发布固件？
A: 检查：
- 是否有
firmware:device:publish权限 - 固件是否处于草稿状态
- 固件文件是否已上传完整
Q: 设备升级时找不到固件？
A: 检查：
- 固件是否已发布（active 状态）
- 固件的适用产品是否包含该设备的产品型号
- OTA 协议类型是否与设备匹配
Q: 能否删除已发布的固件？
A: 不能直接删除。需先执行 下线 操作，且通常仅草稿状态固件允许删除。
更多跨模块问题见 常见问题索引。
下一步：了解了固件管理后，可以学习 视频中心 管理摄像头与实况监控。