结论:foxBMS 2 的 CAN 报文定义是 41 条组件级报文,属于开源电池管理开发平台自身的协议,不是任何量产整车的网络地图。使用它之前有两件事必须先定:一是它的许可证是分裂的——软件走 BSD-3-Clause,硬件与文档走 CC-BY-4.0,两者的义务不同;二是它描述的是一个可自由配置的 BMS 平台,报文语义随配置而变,不能按固定车型档案的方式套用。
41 条报文的定位:组件级而非整车级
foxBMS 2 的自我定位是「第一个模块化的开源 BMS 开发平台」,提供硬件与软件的完整开源环境,用于控制各种规模的现代复杂电化学储能系统。它的 CAN 定义文件放在工具链目录下,共 41 条报文,覆盖的是 BMS 这个部件对外发布的量,而不是整车广播网络。
这两者的差别在接入时非常关键:整车 DBC 里,同一个 ID 的含义由车型年款固定;而 BMS 平台的报文含义取决于使用者怎么配置电池包、从控数量和告警策略。因此把 foxBMS 2 的报文表当作某台车的解码依据,方向就是错的。
| 判据维度 | 组件级 BMS 报文(本例) | 整车级广播 DBC |
|---|---|---|
| 描述对象 | BMS 部件自身对外接口 | 整车多个 ECU 的广播网络 |
| 报文规模 | 41 条 | 常见数十至上百条 |
| 语义决定方 | 使用者的平台配置 | 车型年款与制造商 |
| 跨车复用 | 可在不同储能系统间复用 | 通常绑定具体车型 |
| 验证途径 | 按自身配置与实测标定 | 抓包比对原车行为 |
双许可证:软件与硬件文档分开授权
这个项目采用了罕见的双轨授权,而且分界线非常清楚:软件部分用 BSD 3-Clause,硬件与文档部分用 CC BY 4.0。归档时两份许可证全文都被保留了下来,这本身就是一种可核验的合规姿态。
| 授权对象 | 许可证 | SPDX 标识 | 文本文件 | 核心义务 |
|---|---|---|---|---|
| 软件 | BSD 3-Clause License | BSD-3-Clause | BSD-3-Clause.txt | 保留版权声明,不以作者名义背书 |
| 硬件与文档 | Creative Commons Attribution 4.0 International | CC-BY-4.0 | CC-BY-4.0.txt | 署名;允许商用与再分发 |
除了法定条款,项目还提出了一个软性请求:在硬件、软件、文档或宣传材料中使用时,建议采用「本产品使用了 foxBMS 的部分」「本产品包含 foxBMS 的部分」或「本产品衍生自 foxBMS」这类表述。这不构成额外义务,但对追溯来源有帮助。项目由 Fraunhofer IISB 维护,并已通过开源硬件协会认证,OSHWA UID 为 DE000128。
为什么硬件走 CC-BY 而不是 BSD
电路原理图与布局属于硬件设计成果,用面向代码的许可证去授权会留下大量解释空白。CC-BY-4.0 是面向任意作品的署名型许可,允许商用与再分发,只保留署名一项主要义务,与硬件设计的传播方式更匹配。这也是为什么在引用其 BMS 硬件设计时必须带上署名,而不能只保留软件侧那份 BSD 声明。
平台能覆盖哪些储能体系
判断一份 BMS 报文定义是否适用于自己的项目,先看它面向的电化学体系。foxBMS 2 明确列出了已成功应用的储能类型,覆盖范围远超常见的三元/铁锂电池。
| 储能类型 | 备注 |
|---|---|
| 锂离子电池 | 常规锂电体系 |
| 固态电池 | Solid State Batteries |
| 锂硫电池 | Lithium-Sulfur |
| 钠离子电池 | Sodium-Ion |
| 锂离子电容 | LIC |
| 双电层电容 | EDLC,超级电容 |
| 液流电池 | RFB,例如全钒液流 |
| 燃料电池 | FC |
项目还说明这些体系可以混合组合使用,并应用于多个领域。这一点直接影响报文的使用方式:不同化学体系的单体电压范围、温度窗口与均衡策略都不同,报文里的量纲与告警阈值必然要跟着配置走。
仓库结构与文档入口
归档保留了根目录的 README 与许可证说明。从 README 可以还原出仓库的标准目录划分,这对定位 CAN 定义文件与文档很有帮助。
| 目录 | 内容 |
|---|---|
| 仓库根目录 | 许可证信息、安装说明、变更日志链接、主构建脚本 |
| cli | 与仓库交互的命令行工具 |
| conf | 全部高层配置 |
| docs | 文档源文件 |
| hardware | 硬件原理图与布局信息 |
| src | BMS 嵌入式软件的全部源文件 |
| tests | 嵌入式源码、工具链与脚本的测试 |
| tools | 构建 foxBMS 二进制所需的工具与附加工具 |
每个子目录都带一份说明其内容的 README。变更日志位于 docs/general/changelog.rst,文档构建产物由项目方持续发布,最新发布版与历史构建均可查阅。CAN 定义文件本身位于工具链目录下的 dbc 子目录。
常见问题
foxBMS 2 的 41 条报文能用来解码某台量产电动车吗?
不能。这 41 条是 BMS 平台自身部件的对外接口定义,属于组件级数据,不是生产车辆的 DBC。它的报文语义随使用者的平台配置而变,只能用于自建或参照该平台的储能系统。
软件部分和硬件部分可以只遵守其中一个许可证吗?
不可以。授权是分裂的:软件走 BSD-3-Clause,硬件与文档走 CC-BY-4.0,两者义务不同。引用硬件设计或文档时必须履行 CC-BY-4.0 的署名义务,不能只用软件侧那份 BSD 声明覆盖全部内容。
CC-BY-4.0 允许商业使用吗?
允许。CC BY 4.0 国际许可允许商用与再分发,主要义务是署名。项目另外建议在宣传材料中使用「本产品使用了 foxBMS 的部分」这类表述,这是请求而非强制条款。
OSHWA UID DE000128 意味着什么?
它表示 foxBMS 2 已通过开源硬件协会的开源硬件认证,认证编号 DE000128。这是对项目硬件开放程度的第三方确认,不等于对任何具体电池系统的安全认证或性能背书。
这套 BMS 支持哪些电池化学体系?
项目列出锂离子、固态、锂硫、钠离子、锂离子电容、双电层电容(超级电容)、液流电池(如全钒液流)以及燃料电池,并说明这些体系可以混合组合使用,覆盖多个应用领域。
延伸阅读
- 商用车 DBC 知识包的许可证链:16 条报文与四类来源分级 —— 另一份把许可证核对前置的档案
- Nissan Leaf ZE0:LBC 块数据与只读遥测 —— 量产车电池管理报文的对照样例
- Outlander PHEV 的 CAN 日志:双通道同录与三条总线怎么分工 —— 混动电池报文的采集方式
- 2330 份 DBC、294 个来源:公开 CAN 数据集的收录与分级 —— 组件级与整车级定义的分级口径
- 车型数据库 —— 按车型查阅更多 CAN 档案
参考资料
- 项目 01 ——
public-can-dbc-datasets/additional/foxbms2/README.md(项目定位、支持的储能体系、仓库目录结构、开源硬件认证与许可证概述) - 项目 01 ——
public-can-dbc-datasets/additional/foxbms2/LICENSE.md(软件 BSD-3-Clause 与硬件文档 CC-BY-4.0 的分工、SPDX 标识与署名请求) - 项目 01 ——
public-can-dbc-datasets/additional/foxbms2/CC-BY-4.0.txt(硬件与文档所适用的许可全文) - 项目 01 ——
public-can-dbc-datasets/additional/foxbms2/BSD-3-Clause.txt(软件所适用的许可全文)
免责声明
本文所述报文规模、许可证分工与平台能力均来自公开仓库的说明文件,未经在具体电池系统上的独立验证。报文语义取决于使用者的平台配置,不同电池化学体系、从控数量与告警策略会导致差异。涉及安全相关用途时请仅作参考,并以实际测量与官方资料为准。
更新记录
- 2026-10-14 初稿
发表回复