Controller Area Network (CAN)

The Controller Area Network, also known as CAN or the CAN Bus, is the infrastructure used for internal networking in modern automobiles. It is controlled through a low level system of controller nodes, each of which broadcast all of their data onto the bus. It is therefore the responsibility of the listener nodes to filter through the noise, and determine what traffic is relevant to their individual needs/purposes.

These nodes communicate with each other in a way that is, for the most part, unreadable and otherwise useless to humans in its raw form. Therefore, a semi-standardized format was developed by Vector GmbH to facilitate interpreting and translating the raw Signal values (from sensors and modules), into human-readable values and units (for gauges and data-loggers).

This is the .dbc format I'll be focusing on in this repository and its accompanying Wiki.

How are .dbc files created?

Every auto manufacturer has their own proprietary "dictionary" which contains the mappings of their platform's specific adjustment factors/offsets, labels, and units, used to translate the raw sensor values into meaningful data points.

Sometimes these dictionaries (or "databases", "documents") are leaked online, or sold by a disgruntled (former) employee. In most cases, however, enthusiasts such as myself spend countless hours, usually in their own cars, reverse-engineering translations to .dbc files.

This is very much a work in progress.

---

DBC Specification

1. VERSION
2. NS_: New Symbols
3. BU_: Board Units
   • Syntax
   • Examples
4. BO_: Messages
   • Syntax
   • Attributes
   • Examples
5. SG_: Signals
   • Syntax
   • Multiplexers
   • Attributes
6. BA_: Attributes
   • Syntax
   • Definitions
   • Defaults
7. CM_: Comments
   • Syntax
   • Syntax (scoped)
   • Board Units
   • Messages
   • Signals
8. VAL_: Values
   • Syntax
   • Examples

---

Downloadable .dbc files

| Vehicle | File Name | Version | Author | | :-----: | :-------- | :------ | :----: | | BMW E90 | bmw-e90.dbc (raw) | 2021.6.8 | @nberlette | | BMW E39 | bmw-e39.dbc (raw) | 2021.6.6 | translated from .kcd by @kmalinich | | Mazda (2017) | mazda_2017.dbc | -- | @commaai/opendbc | | Lexus RX350 | lexus_rx350.dbc | -- | @commaai/opendbc | | Tesla Model 3 | tesla_model3.dbc | 2020.40.1 | @johnmccalla and @onyx-m2 project | | OBD2 (universal) | obd2.dbc (raw .dbc) | 0.0.1 | csselectronics.com | | J1939 (universal) | j1939.dbc (raw .dbc) | 7.6 | Unknown, from haskell.org |

---

Resources

• Boilerplate .dbc Template
• CANpy Original DBC Specification
• @commaai/opendbc project - open source DBC project
• @kmalinich/node-bmw-ref - BMW KCAN / KBUS / IBUS reference
• loopybunny.co.uk - BMW K-CAN documentation
• canmatrix - translate .dbc files to other filetypes

---

References

• PiSnoop DBC Help
• CAN Format for VBOXII and PRO v4 (pdf)
• J1939 DBC from Haskell.org (dbc)
• CANtool Manual (pdf)