# opendbc 汽车 CAN 报文定义库

> comma.ai 维护的 DBC 文件库，描述多个汽车品牌的 CAN 报文与信号，并附带一个依据这些定义解析和构造 CAN 报文的 Python 库；其车型移植指南要求贡献者在 cabana 工具中利用行车记录逆向分析新的报文。基于它的各品牌车型移植代码可解析车辆状态、根据 ECU 固件版本识别车型，并生成 openpilot 的转向、油门和制动报文；面向 comma panda 接口的安全代码则限制哪些报文可以发出。

- 类型：工具
- 目标：协议
- 类别：协议分析工具
- 关联：基础工具
- 来源复核于：2026-10-19
- 收录于：2026-10-19
- 原始资源：<https://github.com/commaai/opendbc>
- 一手来源：<https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/opendbc/>
- 记录 JSON：<https://awesomerea.org/resources/opendbc/record.json>
- 英文版：[English](https://awesomerea.org/resources/opendbc/index.md)

## 使用条件与局限

- 审阅时最新版本为 v0.3.1，于 2026-04-22 发布在 GitHub 和 PyPI；所审阅的 master 提交比它多 296 个提交。docs/CARS.md 列出 406 款已知车型：341 款为上游支持，14 款为社区支持，32 款仅支持行车记录仪模式，16 款不兼容，另有 3 款属于自定义类别。README 称它与这份车型列表就是项目的全部文档。
- 软件包要求 Python 3.11 或 3.12，因为 pycapnp 无法在 3.13 上运行。克隆仓库后，test.sh 会安装依赖、用 SCons 构建、运行测试并执行代码检查；尽管 PyPI 上已有 0.3.x 版本，README 路线图仍将 pip install opendbc 列为未完成事项。连接实车时，移植指南以 comma four 和适配具体车型的线束为起点，DBC README 则通过 panda 连接。
- 新的报文定义来自分析者自己的行车记录，并在 openpilot 仓库中的 cabana 工具里分析；README 还提到 commaCarSegments 数据集，其中包含 300 款车型的 CAN 数据。DBC README 建议把不确定的信号解释写成注释，因此这些定义只涵盖贡献者已为各车型记录的内容。
- 采用 MIT 许可。README 称 panda 安全固件启动时 CAN 总线处于静默状态，部分输出模式在正式版固件中被禁用。

## 一手来源

1. <https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/README.md>
2. <https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/README.md#L69-L105>
3. <https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/README.md#L137-L141>
4. <https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/opendbc/dbc/README.md>
5. <https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/docs/CARS.md>
6. <https://github.com/commaai/opendbc/tree/48c7f06c6f27c41e7169242acb03ef9775658deb/opendbc/can>
7. <https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/pyproject.toml>
8. <https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/RELEASES.md>
9. <https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/LICENSE>
10. <https://github.com/commaai/opendbc/releases/tag/v0.3.1>
11. <https://pypi.org/project/opendbc/0.3.1/>

## 同分区更多条目：协议

- [FISSURE 射频信号分析与协议发现框架](https://awesomerea.org/zh/resources/fissure/index.md) · 工具
- [friTap TLS 密钥提取与流量解密工具](https://awesomerea.org/zh/resources/fritap/index.md) · 工具
- [pbtk Protobuf 逆向工具集](https://awesomerea.org/zh/resources/pbtk/index.md) · 工具
- [SteamKit Steam 网络协议库](https://awesomerea.org/zh/resources/steamkit/index.md) · 工具
- [protobuf-inspector 未知定义 Protobuf 解析工具](https://awesomerea.org/zh/resources/protobuf-inspector/index.md) · 工具
- [libimobiledevice iOS 设备协议库](https://awesomerea.org/zh/resources/libimobiledevice/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。