DBC-File-Format-Documentation

DBCFileFormatDocumentationIDBCFileFormatDocumentationVersion01/2007ThisspecificationasreleasedbyVectorisintendedforthepurposeofinformationonlyandisprovidedonan"ASIS"basisonly.Totheextentadmissiblebylaw,Vectordisclaimsanywarrantiesorliabilitiesfromtheuseofthisspecification.Theunauthorizeduse,e.g.copying,displayingorotheruseofanycontentfromthisdocumentisaviolationofthelawandintellectualpropertyrights.Youmustnotdistributethisspecificationtoanyoneoutsideofthedepartmentortheprojectforwhichyourcom-panyhasreceivedthisspecification,andinparticularthedistributionoutsideyourcompanyisexpresslyinadmissible.©2007VectorInformatikGmbHAllrightsreserved.DBCFileFormatDocumentationIIDocumentManagementRevisionHistoryVersionEditorDescription1.0of2007-02-09QuSpecificationcreatedTableofcontents1Introduction..................................................................................................................12GeneralDefinitions......................................................................................................13StructureoftheDBCFile.............................................................................................24VersionandNewSymbolSpecification......................................................................35BitTimingDefinition....................................................................................................36NodeDefinitions...........................................................................................................37ValueTableDefinitions................................................................................................37.1ValueDescriptions(ValueEncodings).................................................................................48MessageDefinitions.....................................................................................................48.1SignalDefinitions..................................................................................................................48.2DefinitionofMessageTransmitters......................................................................................68.3SignalValueDescriptions(ValueEncodings)......................................................................69EnvironmentVariableDefinitions...............................................................................69.1EnvironmentVariableValueDescriptions............................................................................710SignalTypeandSignalGroupDefinitions.........................................................711CommentDefinitions...........................................................................................712UserDefinedAttributeDefinitions......................................................................812.1AttributeDefinitions..............................................................................................................812.2AttributeValues....................................................................................................................813Examples..............................................................................................................8DBCFileFormatDocumentationVersion01/200712007,VectorInformatikGmbHDBC_File_Format_Documentation.docVersion1.0dated2007-02-091IntroductionTheDBCfiledescribesthecommunicationofasingleCANnetwork.Thisinforma-tionissufficienttomonitorandanalyzethenetworkandtosimulatenodesnotphysicallyavailable(remainingbussimulation).TheDBCfilecanalsobeusedtodevelopthecommunicationsoftwareofanelec-troniccontrolunitwhichshallbepartoftheCANnetwork.ThefunctionalbehavioroftheECUisnotaddressedbytheDBCfile.2GeneralDefinitionsThefollowinggeneralelementsareusedinthisdocumentation:unsigned_integer:anunsignedintegersigned_integer:asignedintegerdouble:adoubleprecisionfloatnumberchar_string:anarbitrarystringconsistingofanyprintablecharac-tersexceptdoublehyphens('"').C_identifier:avalidC_identifier.C_identifiershavetostartwithamalphacharacteroranunderscoreandmayfurtherconsistofalpha-numericcharactersandunderscores.C_identifier=(alpha_char|'_'){alpha_num_char|'_'}C-identifiersusedinDBCfilesmayhavealengthofupto128characters.Tobecompatibletooldertoolsthelengthshouldnotexceed32characters.OtherstringsusedinDBCfilesmaybeofanarbitrarylength.ThekeywordsusedinDBCfilesoidentifythetypeofanobjectaregiveninthefollowingtable:KeywordObjectTypeBU_NetworkNodeBO_MessageSG_SignalEV_EnvironmentVariableThesyntaxisdescribedusingtheextendedBNFnotation(Backus-Naur-Format).SymbolMeaning=Anameontheleftofthe=isdefinedusingthesyntaxontheright(syntaxrule).;Thesemicolonterminatesadefinition.|Theverticalbarindicatesanalternative.DBCFileFormatDocumentationVersion01/200722007,VectorInformatikGmbHDBC_File_Format_Documentation.docVersion1.0dated2007-02-09[…]Thedefinitionswithinbracketsareoptional(zerooroneoccurrence).{…}Thedefinitionswithinbracesrepeated(zeroormultipleoccurrences)(…)Parenthesesdefinegroupedelements.'…'Textinhyphenshastoappearasdefined.(*…*)Comment.3StructureoftheDBCFileTheDBCfileformathasthefollowingoverallstructure:DBC_file=versionnew_symbolsbit_timing(*obsoletebutrequired*)nodesvalue_tablesmessagesmessage_transmittersenvironment_variablesenvironment_variables_datasignal_typescommentsattribute_definitionssigtype_attr_listattribute_defaultsattribute_valuesvalue_descriptionscategory_definitions(*obsolete*)categories(*obsolete*)filter(*obsolete*)signal_type_refssignal_groupssignal_extended_value_type_list;DBCfilesdescribingthebasiccommunicationofaCANnetworkincludethefol-lowingsections:•Bit_timingThissectionisrequiredbutisnormallyempty.•nodesThissectionisrequiredanddefinesthenetworknodes.•messagesThissectiondefinesthemessagesandthesignals.Thefollowingsectionsaren'tusedinnormalDBCfiles.Theyaredefinedhereforthesakeofcompletenessonly:•signal_types•sigtype_attr_list•category_definitions•categoriesDBCFileFormatDocumentationVersion01/200732007,VectorInformatikGmbHDBC_File_Format_Documentation.docVersion1.0dated2007-02-09•filter•signal_type_refs•signal_extended_value_type_listDBCfilesthatdescribetheCANcommunicationanddon'tdefineanyadditionaldataforsystemorremainingbussimulationsdon'tincludeenvironmentvariables.4VersionandNewSymbolSpecificationTheDBCfilescontainaheaderwiththeversionandthenewsymbolentries.TheversioneitherisemptyorisastringusedbyCANdbeditor.version=['VERSION''"'{CANdb_version_string}'"'];new_symbols=['_NS'':'['CM_']['BA_DEF_']['BA_']['VAL_']['CAT_DEF_']['CAT_']['FILTER']['BA_DEF_DEF_']['EV_DATA_']['ENVVAR_DATA_']['SGTYPE_']['SGTYPE_VAL_']['BA_DEF_SGTYPE_']['BA_SGTYPE_']['SIG_TYPE_REF_']['VAL_TABLE_']['SIG_GROUP_']['SIG_VALTYPE_']['SIGTYPE_VALTYPE_']['BO_TX_BU_']['BA_DEF_REL_']['BA_REL_']['BA_DEF_DEF_REL_']['BU_SG_REL_']['BU_EV_REL_']['BU_BO_REL_']];5BitTimingDefinitionThebittimingsectiondefinesthebaudrateandthesettingsoftheBTRregistersofthenetworkThissectionisobsoleteandnotusedanymore.Neverthelesshekeyword'BS_'mustappearintheDBCfile.bit_timing='BS_:'[baudrate':'BTR1','BTR2];baudrate=unsigned_integer;BTR1=unsigned_integer;BTR2=unsigned_integer;6NodeDefinitionsThenodesectiondefinesthenamesofallparticipatingnodesThenamesdefinedinthissectionhavetobeuniquewithinthissection.nodes='BU_:'{node_name};node_name=C_identifier;7ValueTableDefinitionsThevaluetablesectiondefinestheglobalvaluetables.Thevaluedescriptionsinvaluetablesdefinevalueencodingsforsignalrawvalues.IncommonlyusedDBCfilestheglobalvaluetablesaren'tused,butthevaluedescriptionsaredefinedforeachsignalindependently.value_tables={value_table};DBCFileFormatDocumentationVersion01/200742007,VectorInformatikGmbHDBC_File_Format_Documentation.docVersion1.0dated2007-02-09value_table='VAL_TABLE_'value_table_name{value_description}';';value_table_name=C_identifier;7.1ValueDescriptions(ValueEncodings)Avaluedescriptiondefinesatextualdescriptionforasinglevalue.Thisvaluemayeitherbeasignalrawvaluetransferredonthebusorthevalueofanenvironmentvariableinaremainingbussimulation.value_description=doublechar_string;8MessageDefinitionsThemessagesectiondefinesthenamesofallframesintheclusteraswellastheirpropertiesandthesignalstransferredontheframes.messages={message};message=BO_message_idmessage_name':'message_sizetrans-mitter{signal};message_id=unsigned_integer;Themessage'sCAN-ID.TheCAN-IDhastobeuniquewithintheDBCfile.IfthemostsignificantbitoftheCAN-IDisset,theIDisanextendedCANID.Theex-tendedCANIDcanbedeterminedbymaskingoutthemostsignificantbitwiththemask0xCFFFFFFF.message_name=C_identifier;Thenamesdefinedinthissectionhavetobeuniquewithinthesetofmessages.message_size=unsigned_integer;Themessage_sizespecifiesthesizeofthemessageinbytes.transmitter=node_name|'Vector__XXX';Thetransmitternamespecifiesthenameofthenodetransmittingthemessage.Thesendernamehastobedefinedinthesetofnodenamesinthenodesection.Ifthemassageshallhavenosender,thestring'Vector__XXX'hastobegivenhere.8.1SignalDefinitionsThemessage'ssignalsectionlistsallsignalsplacedonthemessage,theirpositioninthemessage'sdatafieldandtheirproperties.signal='SG_'signal_namemultiplexer_indicator':'start_bit'|'signal_size'@'byte_ordervalue_type'('factor','offset')''['minimum'|'maximum']'unitreceiver{','receiver};signal_name=C_identifier;Thenamesdefinedherehavetobeuniqueforthesignalsofasinglemessage.DBCFileFormatDocumentationVersion01/200752007,VectorInformatikGmbHDBC_File_Format_Documentation.docVersion1.0dated2007-02-09multiplexer_indicator=''|'M'|mmultiplexer_switch_value;Themultiplexerindicatordefineswhetherthesignalisanormalsignal,amulti-plexerswitchformultiplexedsignals,oramultiplexedsignal.A'M'(uppercase)characterdefinesthesignalasthemultiplexerswitch.Onlyonesignalwithinasinglemessagecanbethemultiplexerswitch.A'm'(lowercase)characterfollowedbyanunsignedintegerdefinesthesignalasbeingmultiplexedbythemultiplexerswitch.Themultiplexedsignalistransferredinthemessageiftheswitchvalueofthemultiplexersignalisequaltoitsmultiplexer_switch_value.start_bit=unsigned_integer;Thestart_bitvaluespecifiesthepositionofthesignalwithinthedatafieldoftheframe.ForsignalswithbyteorderIntel(littleendian)thepositionoftheleast-significantbitisgiven.ForsignalswithbyteorderMotorola(bigendian)theposi-tionofthemostsignificantbitisgiven.Thebitsarecountedinasawtoothmanner.Thestartbithastobeintherangeof0to(8*message_size-1).signal_size=unsigned_integer;Thesignal_sizespecifiesthesizeofthesignalinbitsbyte_order='0'|'1';(*0=littleendian,1=bigendian*)Thebyte_formatis0ifthesignal'sbyteorderisIntel(littleendian)or1ifthebyteorderisMotorola(bigendian).value_type='+'|'-';(*+=unsigned,-=signed*)Thevalue_typedefinesthesignalasbeingoftypeunsigned(-)orsigned(-).factor=double;offset=double;Thefactorandoffsetdefinethelinearconversionruletoconvertthesignalsrawvalueintothesignal'sphysicalvalueandviceversa:physical_value=raw_value*factor+offsetraw_value=(physical_value–offset)/factorAscanbeseenintheconversionruleformulasthefactormustnotbe0.minimum=double;maximum=double;Theminimumandmaximumdefinetherangeofvalidphysicalvaluesofthesignal.unit=char_string;receiver=node_name|'Vector__XXX';Thereceivernamespecifiesthereceiverofthesignal.Thereceivernamehastobedefinedinthesetofnodenamesinthenodesection.Ifthesignalshallhavenoreceiver,thestring'Vector__XXX'hastobegivenhere.Signalswithvaluetypes'float'and'double'haveadditionalentriesinthesig-nal_valtype_listsection.DBCFileFormatDocumentationVersion01/200762007,VectorInformatikGmbHDBC_File_Format_Documentation.docVersion1.0dated2007-02-09signal_extended_value_type_list='SIG_VALTYPE_'message_idsig-nal_namesignal_extended_value_type';';signal_extended_value_type='0'|'1'|'2'|'3';(*0=signedorunsignedinteger,1=32-bitIEEE-float,2=64-bitIEEE-double*)8.2DefinitionofMessageTransmittersThemessagetransmittersectionenablesthedefinitionofmultipletransmitternodesofasinglenode.Thisisusedtodescribecommunicationdataforhigher-layerprotocols.ThisisnotusedtodefineCANlayer-2communication.message_transmitters={message_transmitter};Message_transmitter='BO_TX_BU_'message_id':'{transmitter}';';8.3SignalValueDescriptions(ValueEncodings)Signalvaluedescriptionsdefineencodingsforspecificsignalrawvalues.value_descriptions={value_descriptions_for_signal|value_descriptions_for_env_var};value_descriptions_for_signal='VAL_'message_idsignal_name{value_description}';';9EnvironmentVariableDefinitionsIntheenvironmentvariablessectiontheenvironmentvariablesfortheusageinsystemsimulationandremainingbussimulationtoolsaredefined.environment_variables={environment_variable}environment_variable='EV_'env_var_name':'env_var_type'['mini-mum'|'maximum']'unitinitial_valueev_idaccess_typeac-cess_node{','access_node}';';env_var_name=C_identifier;env_var_type='0'|'1'|'2';(*0=integer,1=float,2=string*)minimum=double;maximum=double;initial_value=double;ev_id=unsigned_integer;(*obsolete*)access_type='DUMMY_NODE_VECTOR0'|'DUMMY_NODE_VECTOR1'|'DUMMY_NODE_VECTOR2'|'DUMMY_NODE_VECTOR3';(*0=unrestricted,1=read,2=write,3=readWrite*)access_node=node_name|'VECTOR_XXX';Theentriesintheenvironmentvariablesdatasectiondefinetheenvironmentslistedhereasbeingofthedatatype"Data".Environmentvariablesofthistypecanstoreanarbitrarybinarydataofthegivenlength.Thelengthisgiveninbytes.environment_variables_data=environment_variable_data;DBCFileFormatDocumentationVersion01/200772007,VectorInformatikGmbHDBC_File_Format_Documentation.docVersion1.0dated2007-02-09environment_variable_data='ENVVAR_DATA_'env_var_name':'data_size';';data_size=unsigned_integer;9.1EnvironmentVariableValueDescriptionsThevaluedescriptionsforenvironmentvariablesprovidetextualrepresentationsofspecificvaluesofthevariable.value_descriptions_for_env_var='VAL_'env_var_aname{value_description}';';10SignalTypeandSignalGroupDefinitionsSignaltypesareusedtodefinethecommonpropertiesofseveralsignals.TheyarenormallynotusedinDBCfiles.signal_types={signal_type};signal_type='SGTYPE_'signal_type_name':'signal_size'@'byte_ordervalue_type'('factor','offset')''['minimum'|'maximum']'unitdefault_value','value_table';';signal_type_name=C_identifier;default_value=double;value_table=value_table_name;signal_type_refs={signal_type_ref};signal_type_ref='SGTYPE_'message_idsignal_name':'sig-nal_type_name';';Signalgroupsareusedtodefineagroupofsignalswithinamessages,e.g.tode-finethatthesignalsofagrouphavetobeupdatedincommon.signal_groups='SIG_GROUP_'message_idsignal_group_namerepeti-tions':'{signal_name}';';signal_group_name=C_identifier;repetitions=unsigned_integer;11CommentDefinitionsThecommentsectioncontainstheobjectcomments.Foreachobjecthavingacomment,anentrywiththeobject'stypeidentificationisdefinedinthissection.comments={comment};comment='CM_'(char_string|'BU_'node_namechar_string|'BO_'message_idchar_string|'SG_'message_idsignal_namechar_string|'EV_'env_var_namechar_string)';';DBCFileFormatDocumentationVersion01/200782007,VectorInformatikGmbHDBC_File_Format_Documentation.docVersion1.0dated2007-02-0912UserDefinedAttributeDefinitionsUserdefinedattributesareameanstoextendtheobjectpropertiesoftheDBCfile.Theseadditionalattributeshavetobedefinedusinganattributedefinitionwithanattributedefaultvalue.Foreachobjecthavingavaluedefinedfortheattributeanattributevalueentryhastobedefined.Ifnoattributevalueentryisdefinedforanobjectthevalueoftheobject'sattributeistheattribute'sdefault.12.1AttributeDefinitionsattribute_definitions={attribute_definition};attribute_definition='BA_DEF_'object_typeattribute_nameattrib-ute_value_type';';object_type=''|'BU_'|'BO_'|'SG_'|'EV_';attribute_name='"'C_identifier'"';attribute_value_type='INT'signed_integersigned_integer|'HEX'signed_integersigned_integer|'FLOAT'doubledouble|'STRING'|'ENUM'[char_string{','char_string}]attribute_defaults={attribute_default};attribute_default='BA_DEF_DEF_'attribute_nameattribute_value';';attribute_value=unsigned_integer|signed_integer|double|char_string;12.2AttributeValuesattribute_values={attribute_value_for_object};attribute_value_for_object='BA_'attribute_name(attribute_value|'BU_'node_nameattribute_value|'BO_'message_idattribute_value|'SG_'message_idsignal_nameattribute_value|'EV_'env_var_nameattribute_value)';';13ExamplesVERSION""NS_:NS_DESC_CM_BA_DEF_BA_VAL_CAT_DEF_CAT_FILTERBA_DEF_DEF_DBCFileFormatDocumentationVersion01/200792007,VectorInformatikGmbHDBC_File_Format_Documentation.docVersion1.0dated2007-02-09EV_DATA_ENVVAR_DATA_SGTYPE_SGTYPE_VAL_BA_DEF_SGTYPE_BA_SGTYPE_SIG_TYPE_REF_VAL_TABLE_SIG_GROUP_SIG_VALTYPE_SIGTYPE_VALTYPE_BO_TX_BU_BA_DEF_REL_BA_REL_BA_DEF_DEF_REL_BU_SG_REL_BU_EV_REL_BU_BO_REL_BS_:BU_:EngineGatewayBO_100EngineData:8EngineSG_PetrolLevel:24|8@1+(1,0)[0|255]"l"GatewaySG_EngPower:48|16@1+(0.01,0)[0|150]"kW"GatewaySG_EngForce:32|16@1+(1,0)[0|0]"N"GatewaySG_IdleRunning:23|1@1+(1,0)[0|0]""GatewaySG_EngTemp:16|7@1+(2,-50)[-50|150]"degC"GatewaySG_EngSpeed:0|16@1+(1,0)[0|8000]"rpm"GatewayCM_"CANcommunicationmatrixforpowertrainelectronics*******************************************************implemented:turnlights,warninglights,windows";VAL_100IdleRunning0"Running"1"Idle";