06-DCM模块软件使用说明 恒润协议栈UDS部分的DCM模块使用说明书

【实例简介】
此文档是购买恒润协议栈时，UDS部分的DCM模块使用说明书，可对照autoSAR规范来看 此文档是购买恒润协议栈时，UDS部分的DCM模块使用说明书，可对照autoSAR规范来看
恒润科技 HIRAIN TECHNOLOGIES 文件状态: ]草稿 「√]正式发布 []正在修改 文件起草分工 刘小燕 编制:刘小燕签名:刘小燕日期:201104-10 审核:马秋英签名:马秋英日期:2011-05-10 批准:陈昆盛签名:陈昆盛日期:2011-05-10 所有权声明 该文档及其所含信息是恒润科技有限公司的财产。该文档及其所含信息的复制、使用及披 露必须得到恒涧科技有限公司的书面授权。 第I页 恒润科技 HIRAIN TECHNOLOGIES 更改历史 版本 更改描述 史改日期 史改人 1.0初始版本 20l1-04-10 刘小燕 11更新 2012-01-15 刘小燕 第Ⅱ页 恒润科技 HIRAIN TECHNOLOGIES 目录 文档介绍 目的 适用范围 13读者对象 l1l1 1.4 参考文档. 术语和缩写 2DCM模块 .4·4···“· 21功能概述. ll1 2.2 输入条件 模块关系图.… 2.4 文件组成 2.4.1内核文件 2 2.4.1.1Dcmh. 3 2.4.1.2 Dcm_ Typcs. h +++ 2.4.1.3Dcm.c,…………… 2.4.1.4 Dcm cbk. h 2.4.1.5 Dcm Cbk.c 242配置文件 242.1 Dcm Cfe.h…… 2.4.2.2 Dcm Cfg.c…,,,,,,,…,…,…,…… 2.4.2.3 Dcm lcfg.c........… ·· 2.4.3应用程序回调函数文件 24.3.1 App dcm. h...… 24.3.2 App dcm.c……… 4 25资源占用. 2.6接口函数使用说明 26DCM与 CanT接口 2.6.1. 1 Dcm StartofReception.... 4 2.6.1.2 Dcm CopyRX Data 2.6.1.3 Dcm CopyTxData 2.6. 1 4 Dcm rxIndication 2.6.1. 5 Dcm TxConfirmation 262DCM与应用程序接口 2.6.2.1 Dcm init.……… 1t“ 2.6.2.2 Dcm Main Function 2.6.2. 3 DsdInternal Processing Done..... ··· 2.6.2.4 DsdInternal SetNegresponse 2.6.2.5 DslInternal RCRResponsePending 2.6.2.6 DsdInternal Processing DoneNoResponse 2.6.2.7 Dcm GetSecurityLevel 2. 6.2.8 Dcm GetSesCtrIType 2.6.2.9 Dcm Rcsct To Dcfaultscssion 26.2.10 DsdInternal SecurityAccessKey Compared…… 12 第Ⅲ页 恒润科技 HIRAIN TECHNOLOGIES 2.6.2.ll DsdInternal routine Started 263应用程序回调函数接口 …13 2.6.3. 1 App DiagnosticActivc 13 2.6.3.2 App DefaultSession ∴13 2.6.3.3 App defaultSession Post 14 2.6.3. 4 App ExtendedSession 14 2.6.3.5 App ExtendedSession Post 15 2.6.3.6 App hardreset 2.6.3.7 App HardResetPost 16 2.6.3.8 App ClearDiagnosticInformation 16 2.6.3. 9 App RcportNumbcrOfDTCBy StatusMask 16 2.6.3. 10 App ReportDTCBy StatusMask 17 2.6.3.11 pp reportdtcSnapshortrecordbydtCNumber 2.6.3. 12 App ReportDTCExtendedDataRecordByDTCNumber 18 2.6.3.13 pp report supporteddto 18 2.6.3.144 App rcad<OxF010 ++··++++““ 19 2.6.3.15 App GetSeed L<1>…………… ∴19 2.6.3. 16 App CompareKey l<1> 19 2.6.3.17 pp EnablerxAndlx 2.6.3. 18 App EnablerxAndDisableTx .20 2.6.3.19 App disableR XAndIx 2.6.3.20 App Write<0xFO10>……… 21 2.6.3.21 pproutin ControlStart< Ox5800>.…………2 2.6.3.22 AppRoutinControlStop<0x5800>...... 2.6.3.23 pproutin Controlresult ox5800> 22 2.6.3. 24 App DTCRecordOn 23 6.3. 25 App DTCRecordoff 2.6.3.26 App ShortTermAdjustment <0x5001> 2.6.3.27 Return controltoEcu <oxs001> 24 2.7 配置参数使用说明 24 271 Pre-compilel配置参数(宏)表 24 2.7,2 Pre-Compilel配置参数(变量) 2.7.2.1 st uint8 g CurrentSidM 2.7.2.2 const DcmDsdService Table* g CurrentDcmDsdService Table 34 2.7.2. 3 const uint32 gCurentDcmDsdServiceTableSize 4 2.7.2.4 DcmDsdSubService gDcmDsdSub Service 273Link-lime配置参数 2.7.3. 1 const uint32 gDcmDspNon DefaultSessionS3Server 35 2.7.3.2 const DcmDspSession Row gDcmDsp Sessionrow 2.7.3.3 const DcmDsp Security Row g DcmDspSecurityRow 35 2.7.3. 4 const uint 16 dcmDspMaxDidToRead 2.7.3.5 const Dcm 22 Servicelnfo Type g DcmDsdSubService 22 36 2.7.3.6 const unt8 gMemory Address Format 2.7.3.7 const unt8 gMcmory Siz c Format 2.7.3.8 const DcmDspReadMemory RangeInfo gDcmDspReadMemory RangeInfo_ 23.36 第IV页 恒润科技 HIRAIN TECHNOLOGIES 2.7.3.9 const Dcm 24 ServiceInfo Type g DcmDsdSub Service 24 2.7.3.10 const Dcm 2A Servicelnlo Type gDcmDsdSubService 2A 2.7.3.11 const Dcm 2C ScrviccInfoTypc gDcmDsdSubScrvicc 20 38 2.7.3.12 const Dcm 2E Servicelnfo Type gDcmDsdSub Service 2E 2.7.3.13 const Dcm 2F Servicelnfo Type gDcmDsdSubService 2F.. 2.7.3. 14 const DcmDspRoutine DcmDspRoutineldentifierTable 31 40 2.7.3.15 DcmDsp WriteMermory RangeInfo gDcmDsp WriteMemoryRangelnfo 3D 3时序图 单帧请求单帧肯定响应 43 单帧请求否定响应 44 单帧请求多帧肯定响应 3.4 多帧请求单帧肯定响. 多帧请求否定响应… 47 36多帧请求多帧肯定响应…. ∴48 37需要较长处理时间的诊断冋调函数 +++ 4注意事项… .50 5源代码示例 6软件局限性. 此行切勿 第V页 恒润科技 HIRAIN TECHNOLOGIES 1文档介绍 1目的 本文档描述DCM软件模块如何集成与使用。 2适用范围 本文档适用DCM软件模块的集成和测试阶段。 13读者对象 本文档预期读者对象为: 1)顾客代表 2)项目成员 3)高层经理 14参考文档 标号 标题 版本/修改日期 ISO 14229-1pdf 10.07.2004 ISO 15765-3 pdf 10.25.2004 3 AUTOSAR _SWS_Diagnostic Communication Manager.pdf V4.0.0/08.12.2009 4 AUTOSAR TR CImplementationRules pdf Vl.0.5/03.12.2009 1.5术语和缩写 名称 含义 DCM Diagnostic communication management,诊断通信管理 UDS Unified Diagnostic service,统一诊断服务 SID Service identifier,服务标识符 DID Data Identifier,数据标识符 RID Routine identifier,例程标识符 DTC Diagnostic Trouble Code,诊断故障码 2DCM模块 21功能概述 DCM模块遵循ISO14229-1和ISO15765-3,实现UDS诊断通信服务。它为应用程序 提供了基于服务、子功能和DID的接口数,可以保证应用程序可以专注于诊断策略的 实现,而关心UDS协议本身的解析和处理。 2.2输入条件 输入信息由以下两部分内容组成 1)诊断相关规范。包含整车厂通用诊断规范和ECU相关诊断规范。 2)诊断数据库(cd格式) 3)其他诊断相关的文件,如通信规范、通信数据库、诊断调査问卷等 第1页/共52页 恒润科技 HIRAIN TECHNOLOGIES 诊断数据库(cd格式)文件通常由整车厂进行设计并释放给供应商。 DCM模块的所有配置项都基于诊断数据库(cd文件)文件实现,所以通信数据库 (cd文件)文件是非常重要的输入条件。因为在诊断数据库文件中定义了所有的诊断服务 信息,比如需要读写哪些DID信息。 23模块关系图 APP Dem SetDTCFiltero Dem GetStatusOfDTCO Appl ServiceName10 Dem GetDTCStatusAvailability Mask Appl ServiceName 2( Dem GctNumbcrOfFilteredDTCO D tNext filtered Dem gctNctxtFiltcredRccordo Appl Se Dem GetNextFilteredDTCAndFDCO Note: pleasc check Dem GctNcxtFilteredDTCAndSeverityo App Dem. c for these Den GetDTCByOccurrenceTime( Dcm Init( functions' Names Dem gctScverity OfDTC( Deim_ Main Function Den GetSupportedDTC AndStatusO Dem GetTranslationTypeo Den Get Freeze FrameDataByDTCO DEM Dem Getsizeoffreezeframee DCM Dem getextendeddata record Dem GetSizeofExtendedData RecordByDTCO Dem ClearITCO Dem DisableDTCSettingo Dcm StartOfReceptiono Dem EnableDTCSetting( Dcm Copy RxDataO Dcm RxIndicationO Dcm Copy TxDataO Pdur Dcm Transmit PduR 24文件组成 DCM模块由下面十个文件组成 1)Dcm. h 2)Dcm Types. h cm. c 4)Dcm Cbk.h 5Dcm Cbk c 6) Dcm Cfg. h 7)Dcm Cfg.c 8)Dcm Lcfg. c )App dcm. h 10)App Dcm.c 24.1内核文件 第2页/共52页 【实例截图】
【核心代码】