{
  "added_at": "2026-10-19",
  "additional_evidence_urls": [
    "https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/README.md#L69-L105",
    "https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/README.md#L137-L141",
    "https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/opendbc/dbc/README.md",
    "https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/docs/CARS.md",
    "https://github.com/commaai/opendbc/tree/48c7f06c6f27c41e7169242acb03ef9775658deb/opendbc/can",
    "https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/pyproject.toml",
    "https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/RELEASES.md",
    "https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/LICENSE",
    "https://github.com/commaai/opendbc/releases/tag/v0.3.1",
    "https://pypi.org/project/opendbc/0.3.1/"
  ],
  "category": "protocol-analysis",
  "description_en": "comma.ai's repository of DBC files describing the CAN messages and signals of many car makes, with a Python library that parses and builds CAN messages from those definitions; its porting guide has contributors reverse engineer new messages from recorded drives in the cabana tool. Per-brand car ports built on it parse vehicle state, identify models from ECU firmware versions and generate openpilot's steering, gas and brake messages, while safety code for comma's panda interface restricts which messages can be sent.",
  "description_zh": "comma.ai 维护的 DBC 文件库，描述多个汽车品牌的 CAN 报文与信号，并附带一个依据这些定义解析和构造 CAN 报文的 Python 库；其车型移植指南要求贡献者在 cabana 工具中利用行车记录逆向分析新的报文。基于它的各品牌车型移植代码可解析车辆状态、根据 ECU 固件版本识别车型，并生成 openpilot 的转向、油门和制动报文；面向 comma panda 接口的安全代码则限制哪些报文可以发出。",
  "entry_url": "https://awesomerea.org/resources/opendbc/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/opendbc/",
  "evidence_url": "https://github.com/commaai/opendbc/blob/48c7f06c6f27c41e7169242acb03ef9775658deb/README.md",
  "group": "tools",
  "id": "opendbc",
  "json_url": "https://awesomerea.org/resources/opendbc/record.json",
  "kind": "tool",
  "markdown_url": "https://awesomerea.org/resources/opendbc/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/opendbc/index.md",
  "name": "opendbc",
  "name_zh": "opendbc 汽车 CAN 报文定义库",
  "record_type": "resource",
  "relationship": "foundation",
  "requirements": [
    "Latest release at review: v0.3.1, published 2026-04-22 on GitHub and PyPI; the reviewed master commit is 296 commits ahead of it. docs/CARS.md lists 406 known cars: 341 with upstream support, 14 community, 32 dashcam-only, 16 not compatible and 3 in a custom category. The README says it and that list are the project's only documentation.",
    "The package requires Python 3.11 or 3.12 because pycapnp does not work with 3.13. From a clone, test.sh installs dependencies, builds with SCons, runs the tests and lints; the README roadmap still lists pip install opendbc as open even though PyPI carries the 0.3.x releases. For a live car, the porting guide starts with a comma four and a car-specific harness, and the DBC README connects through a panda.",
    "New definitions come from the analyst's own recorded drives loaded in cabana, which lives in the openpilot repository; the README also points to the commaCarSegments dataset of CAN data from 300 car models. The DBC README recommends recording uncertain signal interpretations as comments, so definitions cover only what contributors have documented for each car.",
    "MIT. The README says panda safety firmware starts with silent CAN buses and that some output modes are disabled in release firmware."
  ],
  "requirements_zh": [
    "审阅时最新版本为 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 总线处于静默状态，部分输出模式在正式版固件中被禁用。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/commaai/opendbc",
  "verification": "source-reviewed",
  "verified_at": "2026-10-19"
}