c51631617a
* Update ACC_02.SetSpeed to use a more accurate m/s formula instead of kmh * Fixes to LWI vs EPS calculations for steering angles, clarify descriptions of each. * Endianness fixes * Add ESP_15 and PSD_04/05/06 * Testing PSD interpretation * Correct message info for ESP_08 * Additional authoritative message names and IDs * OpenDBC updates * OpenDBC updates * DBC cleanup, CRC support, restore VIN_01 mux lost during Cabana editing. * Add the PQ heading control assist message. * OpenDBC updates * Add a pointer to the VIN_1 mux. * Probable EPS_1 message * Add comment about rate-limiting on Getriebe_11 counter signal. * Rename CRC->CHECKSUM for upstream of a minimum viable VW port. Per my Discord talk with @rbiasini, to reduce OP core code diffs a bit, we will temporarily (ab)use CHECKSUM to store a CRC like Pedal is doing today. After the port is upstreamed, we will look at updating the core OP code to support dynamic CRC and counter signal names, and revert the DBC signal names back to canonical (MSG_NAME_CRC, MSG_NAME_BZ, etc). I will update the OP core CRC support PR shortly. * OpenDBC updates * OpenDBC updates * Probable EPS_1 message * Updates for Volkswagen support (#191) * Update ACC_02.SetSpeed to use a more accurate m/s formula instead of kmh * Fixes to LWI vs EPS calculations for steering angles, clarify descriptions of each. * Endianness fixes * Add ESP_15 and PSD_04/05/06 * Testing PSD interpretation * Correct message info for ESP_08 * Additional authoritative message names and IDs * OpenDBC updates * OpenDBC updates * DBC cleanup, CRC support, restore VIN_01 mux lost during Cabana editing. * Add the PQ heading control assist message. * Add a pointer to the VIN_1 mux. * Add comment about rate-limiting on Getriebe_11 counter signal. * Rename CRC->CHECKSUM for upstream of a minimum viable VW port. Per my Discord talk with @rbiasini, to reduce OP core code diffs a bit, we will temporarily (ab)use CHECKSUM to store a CRC like Pedal is doing today. After the port is upstreamed, we will look at updating the core OP code to support dynamic CRC and counter signal names, and revert the DBC signal names back to canonical (MSG_NAME_CRC, MSG_NAME_BZ, etc). I will update the OP core CRC support PR shortly. * Lexus is adjustment (#192) * Add 581 for ISH gas pedal signal * Add STEER_ANGLE in 608 STEER_TORQUE_SENSOR (similar to TSS2) * Change STEER_TORQUE_EPS factor in 608 STEER_TORQUE_SENSOR to 1.0 * Re-generate lexus_is_2018 * reduce factor to 0.77 * Fix steer angle factor for toyota * OpenDBC updates * Create luxgen_s5_2014.dbc (#101) * Create luxgen_s5_2015.dbc * Update luxgen_s5_2015.dbc * Update luxgen_s5_2015.dbc * fixed to luxgen dbc file * EV_Gearshift message * EV_Gearshift message for e-Golf support without a separate gearbox. * Corrected byte order on two signals. * Corrected byte order on several homebrewed VW MQB signals. |
||
---|---|---|
generator | ||
.gitignore | ||
ESR.dbc | ||
README.md | ||
__init__.py | ||
acura_ilx_2016_can_generated.dbc | ||
acura_ilx_2016_nidec.dbc | ||
acura_rdx_2018_can_generated.dbc | ||
cadillac_ct6_chassis.dbc | ||
cadillac_ct6_object.dbc | ||
cadillac_ct6_powertrain.dbc | ||
chrysler_pacifica_2017_hybrid.dbc | ||
chrysler_pacifica_2017_hybrid_private_fusion.dbc | ||
ford_cgea1_2_bodycan_2011.dbc | ||
ford_cgea1_2_ptcan_2011.dbc | ||
ford_fusion_2018_adas.dbc | ||
ford_fusion_2018_pt.dbc | ||
gm_global_a_chassis.dbc | ||
gm_global_a_lowspeed.dbc | ||
gm_global_a_lowspeed_1818125.dbc | ||
gm_global_a_object.dbc | ||
gm_global_a_powertrain.dbc | ||
honda_accord_lx15t_2018_can_generated.dbc | ||
honda_accord_s2t_2018_can_generated.dbc | ||
honda_accord_touring_2016_can.dbc | ||
honda_civic_hatchback_ex_2017_can_generated.dbc | ||
honda_civic_touring_2016_can_generated.dbc | ||
honda_clarity_hybrid_2018_can.dbc | ||
honda_crv_ex_2017_can_generated.dbc | ||
honda_crv_hybrid_2019_can_generated.dbc | ||
honda_crv_touring_2016_can_generated.dbc | ||
honda_fit_ex_2018_can_generated.dbc | ||
honda_fit_hybrid_2018_can_generated.dbc | ||
honda_insight_ex_2019_can_generated.dbc | ||
honda_odyssey_exl_2018_generated.dbc | ||
honda_odyssey_extreme_edition_2018_china_can_generated.dbc | ||
honda_pilot_touring_2017_can_generated.dbc | ||
honda_ridgeline_black_edition_2017_can_generated.dbc | ||
hyundai_2015_ccan.dbc | ||
hyundai_2015_mcan.dbc | ||
hyundai_i30_2014.dbc | ||
hyundai_kia_generic.dbc | ||
lexus_ct200h_2018_pt_generated.dbc | ||
lexus_gs300h_2017_pt_generated.dbc | ||
lexus_is_2018_pt_generated.dbc | ||
lexus_rx_350_2016_pt_generated.dbc | ||
lexus_rx_hybrid_2017_pt_generated.dbc | ||
luxgen_s5_2015.dbc | ||
mazda_cx5_gt_2017.dbc | ||
mercedes_benz_e350_2010.dbc | ||
nissan_2017.dbc | ||
subaru_crosstrek_2018.dbc | ||
subaru_global_2017.dbc | ||
subaru_outback_2015_eyesight.dbc | ||
subaru_outback_2016_eyesight.dbc | ||
tesla_can.dbc | ||
tesla_radar.dbc | ||
toyota_2017_ref_pt.dbc | ||
toyota_adas.dbc | ||
toyota_avalon_2017_pt_generated.dbc | ||
toyota_camry_hybrid_2018_pt_generated.dbc | ||
toyota_corolla_2017_pt_generated.dbc | ||
toyota_highlander_2017_pt_generated.dbc | ||
toyota_highlander_hybrid_2018_pt_generated.dbc | ||
toyota_iQ_2009_can.dbc | ||
toyota_nodsu_hybrid_pt_generated.dbc | ||
toyota_nodsu_pt_generated.dbc | ||
toyota_prius_2010_pt.dbc | ||
toyota_prius_2017_pt_generated.dbc | ||
toyota_rav4_2017_pt_generated.dbc | ||
toyota_rav4_hybrid_2017_pt_generated.dbc | ||
toyota_sienna_xle_2018_pt_generated.dbc | ||
toyota_tss2_adas.dbc | ||
vw_golf_mk4.dbc | ||
vw_mqb_2010.dbc |
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.
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 message490
. 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's 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 read0x64 0x00 0x00
: clearly, the gas pedal position is within the first byte of the message and I might be tempted to define the signalGAS_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.