foxBMS 2 的 CAN 报文:41 条组件级定义与双许可证边界

作者:

在

结论: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 支持哪些电池化学体系?

项目列出锂离子、固态、锂硫、钠离子、锂离子电容、双电层电容(超级电容)、液流电池(如全钒液流)以及燃料电池,并说明这些体系可以混合组合使用,覆盖多个应用领域。

延伸阅读

参考资料

  • 项目 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 初稿

评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注