"Autosar DEM官方文档：汽车电子软件开发详解"

5星 · 超过95%的资源需积分: 48 110 浏览量更新于2024-04-16 6 收藏 2.19MB PDF 举报

MICROSAR Diagnostic Event Manager (DEM)是一种用于汽车电子软件开发的工具，旨在帮助开发人员管理车辆诊断事件并提高系统的稳定性和性能。该工具的官方文档为开发人员提供了详细的技术参考，包括各种功能模块的介绍、操作指南以及示例代码，以帮助他们更好地理解和应用DEM技术。本文档版本为9.5.0，由Thomas Dedler、Alexander Ditte、Matthias Heil、Anna Bosch、Erik Jeglorz、Stefan Hübner、Aswin Vijayamohanan Nair、Savas Ates、Yves Grau、Friederike Schulze等作者共同编写并发布。该文档基于模板版本5.0.0，为开发人员提供了最新的技术参考和操作指南。 MICROSAR Diagnostic Event Manager (DEM)旨在帮助开发人员更好地管理车辆诊断事件，提高系统的稳定性和性能。通过该工具，开发人员可以轻松地添加、修改和删除诊断事件，监控系统运行状态并进行错误诊断和修复。DEM还提供了丰富的API和示例代码，方便开发人员快速上手并应用于实际项目中。在 AUTOSAR DEM官方文档中，开发人员可以找到有关DEM的详细介绍、功能模块、操作指南和示例代码。文档涵盖了DEM的各个方面，包括事件管理、事件存储、事件传输、事件处理等。开发人员可以根据自己的需求和项目要求查阅文档，了解DEM的工作原理和应用方法。综上所述，MICROSAR Diagnostic Event Manager (DEM)是一种强大的工具，可帮助开发人员更好地管理车辆诊断事件，提高系统的稳定性和性能。AUTOSAR DEM官方文档为开发人员提供了详细的技术参考和操作指南，有助于他们更好地理解和应用DEM技术。希望通过学习和使用DEM，开发人员能够开发出更加稳定和高效的汽车电子软件，为汽车行业的发展贡献自己的力量。

Technical Reference MICROSAR Diagnostic Event Manager (Dem) 
© 2018 Vector Informatik GmbH  Version 9.5.0  16 
based on template version 5.0.0 
5.1.13  ApplDem_SyncCompareAndSwap() ............................ 203 
6  Service Ports ................................................................................................. 203 
6.1  Client Server Interface ................................................................... 203 
6.1.1  Provide Ports on Dem Side .......................................... 204 
6.1.1.1  DiagnosticMonitor .................................... 204 
6.1.1.2  DiagnosticInfo and 
GeneralDiagnosticInfo ............................. 204 
6.1.1.3  OperationCycle ........................................ 205 
6.1.1.4  AgingCycle .............................................. 206 
6.1.1.5  ExternalAgingCycle .................................. 206 
6.1.1.6  EnableCondition ...................................... 206 
6.1.1.7  StorageCondition ..................................... 206 
6.1.1.8  IndicatorStatus ......................................... 206 
6.1.1.9  EventStatus ............................................. 207 
6.1.1.10  EvMemOverflowIndication ....................... 207 
6.1.1.11  DTCSuppression ..................................... 207 
6.1.1.12  DemServices ........................................... 208 
6.1.1.13  DcmIf ....................................................... 208 
6.1.1.14  ClearDTC ................................................. 208 
6.1.1.15  EventAvailable ......................................... 208 
6.1.2  Require Ports on Dem Side ......................................... 209 
6.1.2.1  CBInitEvt_<EventName> ......................... 209 
6.1.2.2  CBInitFct_<DtcName>_<N> .................... 209 
6.1.2.3  CBEventUdsStatusChanged 
_<EventName>_<CallbackName> ........... 209 
6.1.2.4  GeneralCBStatusEvt ................................ 210 
6.1.2.5  CBStatusDTC_<CallbackName> ............. 210 
6.1.2.6  CBDataEvt_<EventName> ...................... 210 
6.1.2.7  GeneralCBDataEvt .................................. 210 
6.1.2.8  CBClrEvt_<EventName> ......................... 210 
6.1.2.9  CBReadData_<SyncDataElement> ......... 210 
6.1.2.10  CBFaultDetectCtr_<EventName> ............ 210 
6.1.2.11  CBControlDTCSetting .............................. 211 
6.1.2.12  DemSc ..................................................... 211 
6.1.2.13  ClearDtcNotification 
_<EventMemorySet>_<Notification> ........ 211 
7  Not Supported APIs ....................................................................................... 211 
Configuration ............................................................................................................ 213 
1  Configuration Variants .................................................................................... 213 
2  Configurable Attributes ................................................................................... 213 
3  Configuration of Post-Build Loadable ............................................................. 213 

Technical Reference MICROSAR Diagnostic Event Manager (Dem) 
© 2018 Vector Informatik GmbH  Version 9.5.0  18 
based on template version 5.0.0 
Illustrations 
Figure 2-1  AUTOSAR 4.1 Architecture Overview ....................................................... 24 
Figure 2-2  Interfaces to adjacent modules of the Dem ............................................... 25 
Figure 3-1  Dem Architecture Overview ...................................................................... 30 
Figure 3-2  Dem states ............................................................................................... 35 
Figure 3-3  Effect of Precondition ‘Event Storage’ and Displacement on Status Bits ... 40 
Figure 3-4  Behavior of the Aging Counter .................................................................. 43 
Figure 3-5  Environmental Data Layout ....................................................................... 50 
Figure 3-6  User Controlled WarningIndicatorRequest ................................................ 64 
Figure 3-7  Concurrent Clear Requests ...................................................................... 72 
Figure 4-1  Include structure ....................................................................................... 76 
Figure 4-2  NvM behavior ........................................................................................... 89 
Figure 4-3  Multi-Partition memory write access ......................................................... 93 
 
Tables 
Table 1-1   Component history.................................................................................... 22 
Table 3-1   Supported AUTOSAR standard conform features ..................................... 26 
Table 3-2   Not supported AUTOSAR standard conform features ............................... 28 
Table 3-3   Features provided beyond the AUTOSAR standard .................................. 29 
Table 3-4   Configuration of status bit processing ....................................................... 40 
Table 3-5   Aging algorithms ....................................................................................... 42 
Table 3-6   Immediate aging ....................................................................................... 43 
Table 3-7   DTC status combination ........................................................................... 57 
Table 3-8   NVRAM write frequency ........................................................................... 59 
Table 3-9   Service IDs ............................................................................................... 67 
Table 3-10   Additional Service IDs ............................................................................... 68 
Table 3-11   Errors reported to Det ............................................................................... 68 
Table 3-12   Diagnostic messages where content is provided by Dem ......................... 70 
Table 3-13   J1939 DTC Status to be cleared ............................................................... 71 
Table 4-1   Static files ................................................................................................. 74 
Table 4-2   Generated files ......................................................................................... 75 
Table 4-3   Compiler abstraction and memory mapping, constant sections ................ 77 
Table 4-4   Compiler abstraction and memory mapping, variable sections ................. 78 
Table 4-5   Exclusive Area 0 ....................................................................................... 80 
Table 4-6   Exclusive Area 1 ....................................................................................... 81 
Table 4-7   Exclusive Area 2 ....................................................................................... 82 
Table 4-8   Exclusive Area 3 ....................................................................................... 84 
Table 4-9   Exclusive Area 4 ....................................................................................... 85 
Table 4-10   NvRam blocks .......................................................................................... 86 
Table 4-11   NvRam initialization .................................................................................. 87 
Table 4-12   Dem runnable entities ............................................................................... 91 
Table 5-1   Measurement item Dem_Cfg_StatusData ................................................. 94 
Table 5-2   Measurement item Dem_Cfg_EventMaxDebounceValues[] ...................... 94 
Table 5-3   Measurement item Dem_Cfg_PrimaryEntry_<Number> ........................... 95 
Table 5-4   Error Codes possible during Post-Build initialization failure ....................... 96 
Table 5-5   Supported DEM PBL parameters ............................................................ 100 
Table 6-1   Dem_GetVersionInfo() ............................................................................ 102 
Table 6-2   Dem_MasterMainFunction() ................................................................... 103 
Table 6-3   Dem_SatelliteMainFunction() .................................................................. 103 
Table 6-4   Dem_MainFunction() .............................................................................. 104 
Table 6-5  Dem_MasterPreInit() .............................................................................. 105 

Technical Reference MICROSAR Diagnostic Event Manager (Dem) 
© 2018 Vector Informatik GmbH  Version 9.5.0  19 
based on template version 5.0.0 
Table 6-6  Dem_SatellitePreInit() ............................................................................. 106 
Table 6-7   Dem_PreInit() ......................................................................................... 107 
Table 6-8  Dem_MasterInit() .................................................................................... 108 
Table 6-9  Dem_SatelliteInit() .................................................................................. 109 
Table 6-10   Dem_Init() ............................................................................................... 110 
Table 6-11   Dem_InitMemory() ................................................................................... 111 
Table 6-12   Dem_Shutdown() .................................................................................... 112 
Table 6-13   Dem_SetEventStatus() ........................................................................... 114 
Table 6-14   Dem_ResetEventStatus() ....................................................................... 115 
Table 6-15   Dem_ResetEventDebounceStatus() ....................................................... 116 
Table 6-16   Dem_PrestoreFreezeFrame() ................................................................. 117 
Table 6-17   Dem_ClearPrestoredFreezeFrame() ...................................................... 118 
Table 6-18   Dem_SetOperationCycleState().............................................................. 119 
Table 6-19   Dem_GetOperationCycleState ............................................................... 120 
Table 6-20   Dem_GetEventUdsStatus() .................................................................... 121 
Table 6-21   Dem_GetMonitorStatus() ........................................................................ 122 
Table 6-22   Dem_GetEventFailed() ........................................................................... 123 
Table 6-23   Dem_GetEventTested() .......................................................................... 124 
Table 6-24   Dem_GetDTCOfEvent() .......................................................................... 125 
Table 6-25   Dem_GetEventAvailable() ...................................................................... 126 
Table 6-26   Dem_SetEnableCondition() .................................................................... 127 
Table 6-27   Dem_SetStorageCondition() ................................................................... 128 
Table 6-28   Dem_GetFaultDetectionCounter() .......................................................... 129 
Table 6-29   Dem_GetIndicatorStatus() ...................................................................... 130 
Table 6-30   Dem_GetEventFreezeFrameDataEx() .................................................... 131 
Table 6-31   Dem_GetEventExtendedDataRecordEx() ............................................... 132 
Table 6-32   Dem_GetEventEnableCondition() ........................................................... 133 
Table 6-33   Dem_GetEventMemoryOverflow() .......................................................... 134 
Table 6-34   Dem_GetNumberOfEventMemoryEntries() ............................................. 135 
Table 6-35   Dem_PostRunRequested() ..................................................................... 136 
Table 6-36   Dem_SetWIRStatus () ............................................................................ 137 
Table 6-37   Dem_GetWIRStatus () ............................................................................ 138 
Table 6-38   Dem_SetDTCSuppression() ................................................................... 139 
Table 6-39   Dem_SetEventAvailable() ....................................................................... 140 
Table 6-40   Dem_ClearDTC() .................................................................................... 141 
Table 6-41   Dem_RequestNvSynchronization() ......................................................... 142 
Table 6-42   Dem_GetDebouncingOfEvent() .............................................................. 143 
Table 6-43   Dem_SelectDTC() .................................................................................. 145 
Table 6-44   Dem_GetDTCSelectionResult() .............................................................. 146 
Table 6-45   Dem_GetEventIdOfDTC() ....................................................................... 147 
Table 6-46   Dem_GetDTCSuppression() ................................................................... 148 
Table 6-47   Dem_ReportErrorStatus() ....................................................................... 149 
Table 6-48   Dem_SetDTCFilter() ............................................................................... 151 
Table 6-49   Dem_GetNumberOfFilteredDTC() .......................................................... 152 
Table 6-50   Dem_GetNextFilteredDTC() ................................................................... 153 
Table 6-51   Dem_GetNextFilteredDTCAndFDC() ...................................................... 154 
Table 6-52   Dem_GetNextFilteredDTCAndSeverity() ................................................ 155 
Table 6-53   Dem_SetFreezeFrameRecordFilter() ...................................................... 156 
Table 6-54   Dem_GetNextFilteredRecord() ............................................................... 157 
Table 6-55   Dem_GetStatusOfDTC() ......................................................................... 158 
Table 6-56   Dem_GetDTCStatusAvailabilityMask() ................................................... 159 
Table 6-57   Dem_GetDTCByOccurrenceTime() ........................................................ 160 
Table 6-58   Dem_GetTranslationType() ..................................................................... 161 
Table 6-59   Dem_GetSeverityOfDTC() ...................................................................... 162 

Technical Reference MICROSAR Diagnostic Event Manager (Dem) 
© 2018 Vector Informatik GmbH  Version 9.5.0  20 
based on template version 5.0.0 
Table 6-60   Dem_GetFunctionalUnitOfDTC() ............................................................ 163 
Table 6-61   Dem_DisableDTCRecordUpdate() .......................................................... 164 
Table 6-62   Dem_EnableDTCRecordUpdate() .......................................................... 165 
Table 6-63   Dem_SelectFreezeFrameData () ............................................................ 166 
Table 6-64   Dem_GetFreezeFrameDataByDTC() ...................................................... 167 
Table 6-65   Dem_GetSizeOfFreezeFrameByDTC() ................................................... 168 
Table 6-66   Dem_SelectExtendedDataRecordBy() .................................................... 169 
Table 6-67   Dem_GetNextExtendedDataRecord () .................................................... 170 
Table 6-68   Dem_GetSizeOfExtendedDataRecordByDTC() ...................................... 171 
Table 6-69   Dem_DisableDTCSetting() ..................................................................... 172 
Table 6-70   Dem_EnableDTCSetting() ...................................................................... 173 
Table 6-71   Dem_J1939DcmClearDTC() ................................................................... 175 
Table 6-72   Dem_J1939DcmFirstDTCwithLampStatus() ........................................... 176 
Table 6-73   Dem_J1939DcmGetNextDTCwithLampStatus () .................................... 177 
Table 6-74   Dem_J1939DcmGetNextFilteredDTC() ................................................... 178 
Table 6-75   Dem_J1939DcmGetNextFreezeFrame() ................................................ 179 
Table 6-76   Dem_J1939DcmGetNextSPNInFreezeFrame() ...................................... 180 
Table 6-77   Dem_J1939DcmGetNumberOfFilteredDTC () ......................................... 181 
Table 6-78   Dem_J1939DcmSetDTCFilter() .............................................................. 183 
Table 6-79   Dem_J1939DcmSetFreezeFrameFilter() ................................................ 184 
Table 6-80   Dem_J1939DcmReadDiagnosticReadiness1() ....................................... 185 
Table 6-81   Services used by the Dem ...................................................................... 186 
Table 6-82   EcuM_BswErrorHook() ........................................................................... 187 
Table 6-83   Dem_NvM_JobFinished() ....................................................................... 188 
Table 6-84   Dem_NvM_InitAdminData() .................................................................... 189 
Table 6-85   Dem_NvM_InitStatusData() .................................................................... 190 
Table 6-86   Dem_NvM_InitDebounceData() .............................................................. 191 
Table 6-87   Dem_NvM_InitEventAvailableData() ....................................................... 192 
Table 6-88   CBClrEvt_<EventName>() ...................................................................... 193 
Table 6-89   CBDataEvt_<EventName>() ................................................................... 194 
Table 6-90   CBFaultDetectCtr_<EventName>() ......................................................... 195 
Table 6-91   CBInitEvt_<EventName>() ...................................................................... 196 
Table 6-92   CBInitFct_<N>() ...................................................................................... 196 
Table 6-93   CBReadData_<SyncDataElement>() ...................................................... 197 
Table 6-94   CBStatusDTC_<CallbackName>() .......................................................... 198 
Table 6-95   CBEventUdsStatusChanged_<EventName>_<CallbackName>() ........... 199 
Table 6-96   GeneralCBDataEvt() ............................................................................... 199 
Table 6-97   GeneralCBStatusEvt() ............................................................................ 200 
Table 6-98   <Module>_ClearDtcNotification_<DemEventMemorySet> 
_<ShortName>() ..................................................................................... 201 
Table 6-99   <Module>_ DemTriggerOnMonitorStatus() ............................................. 202 
Table 6-100   ApplDem_SyncCompareAndSwap() ....................................................... 203 
Table 6-101   DiagnosticMonitor ................................................................................... 204 
Table 6-102   DiagnosticInfo and GeneralDiagnosticInfo .............................................. 205 
Table 6-103   OperationCycle ....................................................................................... 206 
Table 6-104   EnableCondition ..................................................................................... 206 
Table 6-105   StorageCondition .................................................................................... 206 
Table 6-106   IndicatorStatus ........................................................................................ 206 
Table 6-107   EventStatus ............................................................................................ 207 
Table 6-108   EvMemOverflowIndication ...................................................................... 207 
Table 6-109   DTCSuppression .................................................................................... 207 
Table 6-110   DemServices .......................................................................................... 208 
Table 6-111   ClearDTC ............................................................................................... 208 
Table 6-112   EventAvailable ........................................................................................ 209 