You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Kevin Roscom 4925c2a999 transit connect 2015 2 months ago
.github/workflows fix generator test and linter (#323) 1 year ago
can Update fron arnepilot 1 year ago
generator add more Toyota CRUISE_STATE values (#339) 1 year ago
site_scons/site_tools cython dependency scanner 1 year ago
.gitignore Scons cython builder (#316) 2 years ago
.pre-commit-config.yaml fix generator test and linter (#323) 1 year ago
Dockerfile Scons cython builder (#316) 2 years ago
ESR.dbc Add files via upload (#147) 3 years ago
README.md Add reference to CANdevStudio in README file 2 years ago
SConstruct Scons cython builder (#316) 2 years ago
__init__.py make opendbc import work, and ignore junk 5 years ago
acura_ilx_2016_can_generated.dbc Fix comments syntax (#324) 1 year ago
acura_ilx_2016_nidec.dbc Honda Nidec: added wrong config radar value 4 years ago
acura_rdx_2018_can_generated.dbc Fix comments syntax (#324) 1 year ago
acura_rdx_2020_can_generated.dbc Honda - steer down to zero (#317) 1 year ago
bmw_e9x_e8x.dbc Fix all typos in opendbc (#299) 2 years ago
cadillac_ct6_chassis.dbc Cadillac: typo 4 years ago
cadillac_ct6_object.dbc Fix all typos in opendbc (#299) 2 years ago
cadillac_ct6_powertrain.dbc Remove non ascii characters 3 years ago
chrysler_pacifica_2017_hybrid.dbc Pacifica: Add cruise state indicator (#332) 1 year ago
chrysler_pacifica_2017_hybrid_private_fusion.dbc change chrysler radar to all big endian to avoid OP can parser bug (#141) 3 years ago
ford_cgea1_2_bodycan_2011.dbc Fix manually created dbc files (#154) 3 years ago
ford_cgea1_2_ptcan_2011.dbc Fix manually created dbc files (#154) 3 years ago
ford_fusion_2018_adas.dbc Fix manually created dbc files (#154) 3 years ago
ford_fusion_2018_pt.dbc Fix manually created dbc files (#154) 3 years ago
ford_lincoln_base_pt.dbc Ford: Add new base DBC. (#287) 2 years ago
ford_transit_connect_2015.dbc transit connect 2015 2 months ago
gm_global_a_chassis.dbc GM: typo 4 years ago
gm_global_a_high_voltage_management.dbc Fixed up cell voltage readings and added more commands (#220) 2 years ago
gm_global_a_lowspeed.dbc Volt: switch to parsing ACC buttons from powertrain CAN (#74) 4 years ago
gm_global_a_lowspeed_1818125.dbc Fix non-standard units in GM global A lowspeed (#327) 1 year ago
gm_global_a_object.dbc Fix all typos in opendbc (#299) 2 years ago
gm_global_a_powertrain.dbc Fix GM message signal sizes 2 years ago
gm_global_a_powertrain_expansion.dbc Fixed up cell voltage readings and added more commands (#220) 2 years ago
honda_accord_lx15t_2018_can_generated.dbc Honda - steer down to zero (#317) 1 year ago
honda_accord_s2t_2018_can_generated.dbc Honda - steer down to zero (#317) 1 year ago
honda_accord_touring_2016_can.dbc Fixes and new message for VW MQB, fix for Accord Touring (#193) 3 years ago
honda_civic_hatchback_ex_2017_can_generated.dbc Honda - steer down to zero (#317) 1 year ago
honda_civic_sedan_16_diesel_2019_can_generated.dbc Honda - steer down to zero (#317) 1 year ago
honda_civic_touring_2016_can_generated.dbc Fix comments syntax (#324) 1 year ago
honda_clarity_hybrid_2018_can_generated.dbc Fix comments syntax (#324) 1 year ago
honda_crv_ex_2017_body_generated.dbc Fix comments syntax (#324) 1 year ago
honda_crv_ex_2017_can_generated.dbc Honda - steer down to zero (#317) 1 year ago
honda_crv_executive_2016_can_generated.dbc Fix comments syntax (#324) 1 year ago
honda_crv_hybrid_2019_can_generated.dbc Honda - steer down to zero (#317) 1 year ago
honda_crv_touring_2016_can_generated.dbc Fix comments syntax (#324) 1 year ago
honda_fit_ex_2018_can_generated.dbc Fix comments syntax (#324) 1 year ago
honda_fit_hybrid_2018_can_generated.dbc Fix comments syntax (#324) 1 year ago
honda_hrv_touring_2019_can_generated.dbc Fix comments syntax (#324) 1 year ago
honda_insight_ex_2019_can_generated.dbc Honda - steer down to zero (#317) 1 year ago
honda_odyssey_exl_2018_generated.dbc Fix comments syntax (#324) 1 year ago
honda_odyssey_extreme_edition_2018_china_can_generated.dbc Fix comments syntax (#324) 1 year ago
honda_pilot_touring_2017_can_generated.dbc Fix comments syntax (#324) 1 year ago
honda_ridgeline_black_edition_2017_can_generated.dbc Fix comments syntax (#324) 1 year ago
hyundai_2015_ccan.dbc Remove non ascii characters 3 years ago
hyundai_2015_mcan.dbc add hyundai 2015 (#63) 4 years ago
hyundai_i30_2014.dbc add hyundai_i30_2014.dbc 5 years ago
hyundai_kia_generic.dbc hyundai: better hda signal def (#342) 1 year ago
lexus_ct200h_2018_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
lexus_gs300h_2017_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
lexus_is_2018_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
lexus_nx300_2018_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
lexus_nx300h_2018_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
lexus_rx_350_2016_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
lexus_rx_hybrid_2017_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
luxgen_s5_2015.dbc fixed to luxgen dbc file 3 years ago
mazda_3_2019.dbc Introduce the new mazda 3 2019/2020 dbc 2 years ago
mazda_2017.dbc Mazda: add missing static bits, tidy up endianness (#263) 2 years ago
mercedes_benz_e350_2010.dbc Update mercedes e350 dbc (#112) 4 years ago
nissan_leaf_2018.dbc Fix wrong message sizes in Nissan 2 years ago
nissan_x_trail_2017.dbc Update X-trail HUD message name, added SPEED_MPH signal (#269) 2 years ago
ocelot_can.dbc Update ocelot_can.dbc 1 year ago
ocelot_can.ini fix syntax errors 1 year ago
ocelot_controls.dbc unify actuators and ocelot 3 months ago
ocelot_smart_roadster_pt.dbc Update fron arnepilot 1 year ago
requirements.txt fix pycapnp 2 years ago
subaru_forester_2017_generated.dbc Fix comments syntax (#324) 1 year ago
subaru_global_2017_generated.dbc Fix comments syntax (#324) 1 year ago
subaru_global_2020_hybrid_generated.dbc Fix comments syntax (#324) 1 year ago
subaru_outback_2015_generated.dbc Fix comments syntax (#324) 1 year ago
subaru_outback_2019_generated.dbc Fix comments syntax (#324) 1 year ago
tesla_can.dbc Fix manually created dbc files (#154) 3 years ago
tesla_radar.dbc DBC for the Bosch Radar for Tesla (#158) 3 years ago
toyota_2017_ref_pt.dbc Remove non ascii characters 3 years ago
toyota_adas.dbc Toyota: better name for adas bdc files 3 years ago
toyota_avalon_2017_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
toyota_camry_hybrid_2018_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
toyota_corolla_2017_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
toyota_highlander_2017_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
toyota_highlander_hybrid_2018_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
toyota_iQ_2009_can.dbc Fix all typos in opendbc (#299) 2 years ago
toyota_nodsu_hybrid_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
toyota_nodsu_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
toyota_prius_2010_pt.dbc Added CRUISE_STATE value 11 description (timer_3sec) (#328) 1 year ago
toyota_prius_2017_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
toyota_rav4_2017_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
toyota_rav4_hybrid_2017_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
toyota_sienna_xle_2018_pt_generated.dbc add more Toyota CRUISE_STATE values (#339) 1 year ago
toyota_tss2_adas.dbc Toyota: better name for adas bdc files 3 years ago
volvo_v40_2017_pt.dbc Volvo DBC files for C1MCA and EUCD platform (#291) 2 years ago
volvo_v60_2015_pt.dbc Volvo DBC files for C1MCA and EUCD platform (#291) 2 years ago
vw_golf_mk4.dbc Updates for Volkswagen support (#191) 3 years ago
vw_mqb_2010.dbc Add SWA_01 message detail and CRC support for VW MQB (#236) 2 years ago

README.md

opendbc

The project to democratize access to the decoder ring of your car.

DBC file basics

A DBC file encodes, in a humanly readable way, the information needed to understand a vehicle's CAN bus traffic. A vehicle might have multiple CAN buses and every CAN bus is represented by its own dbc file. Wondering what's the DBC file format? Here and Here a couple of good overviews.

How to start reverse engineering cars

opendbc is integrated with cabana.

Use panda to connect your car to a computer.

How to use reverse engineered DBC

To create custom CAN simulations or send reverse engineered signals back to the car you can use CANdevStudio project.

DBC file preprocessor

DBC files for different models of the same brand have a lot of overlap. Therefore, we wrote a preprocessor to create DBC files from a brand DBC file and a model specific DBC file. The source DBC files can be found in the generator folder. After changing one of the files run the generator.py script to regenerate the output files. These output files will be placed in the root of the opendbc repository and are suffixed by _generated.

Good practices for contributing to opendbc

  • Comments: the best way to store comments is to add them directly to the DBC files. For example:

    CM_ SG_ 490 LONG_ACCEL "wheel speed derivative, noisy and zero snapping";
    

    is a comment that refers to signal LONG_ACCEL in message 490. Using comments is highly recommended, especially for doubts and uncertainties. cabana can easily display/add/edit comments to signals and messages.

  • Units: when applicable, it's recommended to convert signals into physical units, by using a proper signal factor. Using a SI unit is preferred, unless a non-SI unit rounds the signal factor much better. For example:

    SG_ VEHICLE_SPEED : 7|15@0+ (0.00278,0) [0|70] "m/s" PCM
    

    is better than:

    SG_ VEHICLE_SPEED : 7|15@0+ (0.00620,0) [0|115] "mph" PCM
    

    However, the cleanest option is really:

    SG_ VEHICLE_SPEED : 7|15@0+ (0.01,0) [0|250] "kph" PCM
    
  • Signal size: always use the smallest amount of bits possible. For example, let's say I'm reverse engineering the gas pedal position and I've determined that it's in a 3 bytes message. For 0% pedal position I read a message value of 0x00 0x00 0x00, while for 100% of pedal position I read 0x64 0x00 0x00: clearly, the gas pedal position is within the first byte of the message and I might be tempted to define the signal GAS_POS as:

    SG_ GAS_POS : 7|8@0+ (1,0) [0|100] "%" PCM
    

    However, I can't be sure that the very first bit of the message is referred to the pedal position: I haven't seen it changing! Therefore, a safer way of defining the signal is:

    SG_ GAS_POS : 6|7@0+ (1,0) [0|100] "%" PCM
    

    which leaves the first bit unallocated. This prevents from very erroneous reading of the gas pedal position, in case the first bit is indeed used for something else.