FX 固件发行说明
概述
这是 BATCAM FX 固件的公开发行历史。本文档按照从最新版本开始的顺序整理了各版本的新增功能与变更事项,涵盖 v1.0.2 之后的发行版本。本文档涵盖的最新发行版本为 v1.0.4(2025.11.25)。
根据发行版本的不同,除主机固件版本(v1.0.x)之外,还可能一并包含 SbRIO 固件更新,这两个版本均可通过设备信息 API 进行确认。
-
固件安装方法请参阅 Web 软件更新 或 Shell 软件更新 文档。
-
REST API 的完整规范可在 FX API 演练场 中查看。
确认已安装的版本
设备上安装的固件版本可通过 REST API GET /setting/status(设备信息查询)进行确认。该端点需要 HTTP Basic 认证,并返回 BATCAM FX 的硬件信息与固件版本。确认版本后,如有新固件,建议进行更新。
{ "error": 0, "result": { "hardware_id": "3287162925128", "sbrio_version": "1.0.14", "firmware_version": "v0.0.1" }}响应中的 firmware_version 对应本发行说明中的版本,通过 sbrio_version 可以确认各发行版本所包含的 SbRIO 固件版本。详细规范请参阅 FX API 演练场。
兼容性注意事项 (Breaking Changes)
以下是可能影响 WebSocket·REST·RTSP 对接客户端的变更事项。以下述版本为基准在其与旧版本之间切换时,请先确认相应项目。
| 版本 | 变更事项 | 参考 |
|---|---|---|
| v1.0.3-beta (2025.07.26) | 将 timestamp 格式变更为 ISO 8601 | — |
| v1.0.3-beta (2025.06.04) | 变更为 WebSocket Level Trigger ID 从 100 开始使用 | — |
| v1.0.2 | 变更为 WebSocket 数据接收使用 Protobuf 3 | Python Protobuf 示例 |
| v1.0.2 | 摄像头麦克风采样率变更 (96kHz → 200kHz) 及相关 API 变更 | FX API 演练场 |
| v1.0.2 | 固件更新页面路径变更 ({IP}/firmware → {IP}) | Web 软件更新 |
| v1.0.2 | 移除 RTSP 中的音频支持 | — |
版本摘要
| 版本 | 发行日期 | 主要变更事项 |
|---|---|---|
| v1.0.4 | 2025.11.25 | 更新 SbRIO 固件 2.0.9 |
| v1.0.3 | 2025.10.04 | 启用音频 24bit、移除 Gain 设置、SbRIO 固件 2.0.8 |
| v1.0.3-beta | 2025.03.10 ~ 2025.09.10 | 支持 ROS 2 Humble、AI PRPD 分类器、Beamforming Overlay、ROS_DOMAIN_ID 设置 |
| v1.0.2 | 2024.11.06 | 迁移至 nginx、ONVIF Discovery、200kHz 采样、WebSocket Protobuf 3 |
v1.0.4 (2025.11.25)
变更事项
- SbRIO 固件更新 (2.0.9)
v1.0.3 (2025.10.04)
变更事项
-
反映 v1.0.3-beta 的所有修复事项
-
SbRIO 固件更新 (2.0.8)
-
移除 Gain 设置并启用音频 24bit
-
禁用 Auto Gain
v1.0.3-beta
v1.0.3-beta 经过多次发行。各发行日期的变更事项如下。
2025.09.10
-
SbRIO 固件更新 (2.0.8g)
-
在 PRPD 分类器预处理器中部分启用 CUDA 核心的使用
-
优化 CPU 使用量
-
修复 Protobuf 兼容性问题
-
新增用于 LTE 模块测试的 iperf3
-
修复电源模块 (nvpmodel)
2025.08.07
-
改进音频信号处理同步逻辑
-
解决 Gain 问题
-
变更为在控制器更新时同时使用 lftp、scp 两种路径
-
开始提供 LTE 模块的对应支持
2025.07.26
-
将 timestamp 格式变更为 ISO 8601
-
优化内存分配
-
变更 SbRIO 固件更新时的传输方式(禁用 TFTP,引入 scp)
-
应用日志轮转 (log rotate)
2025.06.04
-
变更为 WebSocket Level Trigger ID 从 100 开始使用
-
新增用于固件更新重新分区的
_min版本支持
2025.03.10
-
SbRIO 固件更新 (2.0.7)
-
支持 ROS 2 Humble — 请参阅 ROS 集成 文档
-
支持 AI 功能
-
支持使用自研 AI 的 PRPD 分类器功能 (WebSocket, ROS 2) — 请参阅 AI PRPD 分类器 文档
-
新增 CUDA 支持
-
-
支持自研 Beamforming Overlay 功能 (WebSocket, ROS 2)
-
支持新增的 API (Overlay Setting, ROS Domain ID Setting) — 规范请参阅 FX API 演练场
💡 参考:v1.0.3-beta 中新增的 ROS 2 · Beamforming Overlay 功能的详细使用方法,可在 ROS 固件 BF Overlay (Beta) 文档中查看。
v1.0.2 (2024.11.06)
新增功能
- 新增 ONVIF Discovery 服务
变更事项
-
HTTP 模块变更 (lighttpd → nginx)
-
CGI 模块变更 (cgi → gunicorn)
-
WS 事件压缩算法变更及流水线改进
-
SbRIO 固件更新 (1.0.15)
-
系统 BSP 更新
-
固件更新页面路径变更 (
{IP}/firmware→{IP}) -
RTSP 模块变更 (simple-rtsp-server → mediamtx)
-
移除 RTSP 中的音频支持
-
摄像头麦克风采样率变更 (96kHz → 200kHz)
- 相关 API 也随之一并变更。变更后的规范请参阅 FX API 演练场。
-
变更为 WebSocket 数据接收使用 Protobuf 3
💡 参考:自 v1.0.2 起,固件更新页面的访问路径已从
{IP}/firmware变更为{IP}。通过 Web 浏览器进行更新的步骤请参阅 Web 软件更新 文档。
相关文档
-
Web 软件更新 · Shell 软件更新 — 固件安装步骤
-
FX API 演练场 — REST API 参考(
/setting/status等) -
ROS 集成 — 基于 ROS 2 的数据对接
-
AI PRPD 分类器 · Beamforming Overlay · ROS_DOMAIN_ID 设置 — v1.0.3-beta 中新增的功能
-
Python Protobuf 示例 — WebSocket Protobuf 消息处理示例