Changes between Version 4 and Version 5 of spec/Dlt


Ignore:
Timestamp:
Nov 12, 2014, 6:21:48 PM (9 years ago)
Author:
fujisft-shigihara
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • spec/Dlt

    v4 v5  
    77[[BR]]
    88
    9 {{{#!comment
    10 [執筆開始時削除エリア]ここから
    11 ※コメントごと削除してください
    12 }}}
    13 * '''本項目は、まだ執筆されていません'''
    14 * '''執筆して頂ける方は、本注意書きを削除の上、執筆をお願いします(詳しくは本Wikiのソースコードをご参照ください)'''
    15 * '''質問事項等がございましたら、[http://dev.toppers.jp/trac/ap/wiki/ Wikiトップページ]にあります[http://dev.toppers.jp/trac/ap/wiki/WikiStart#%E5%95%8F%E3%81%84%E5%90%88%E3%82%8F%E3%81%9B%E5%85%88 問い合わせ先]までお願いします'''
     9= 概要 =
     10
     11* API一覧
     12
     13  ||= API =||= ID[[BR]][Dec] =||= ID[[BR]][Hex] =||
     14  || [#Dlt_Init Dlt_Init]                                         ||  1|| 0x01||
     15  || [#Dlt_GetVersionInfo Dlt_GetVersionInfo]                     ||  2|| 0x02||
     16  || [#Dlt_SendLogMessage Dlt_SendLogMessage]                     ||  3|| 0x03||
     17  || [#Dlt_SendTraceMessage Dlt_SendTraceMessage]                 ||  4|| 0x04||
     18  || [#Dlt_RegisterContext Dlt_RegisterContext]                   ||  5|| 0x05||
     19  || [#Dlt_DemTriggerOnEventStatus Dlt_DemTriggerOnEventStatus]   || 21|| 0x15||
     20  || [#Dlt_DetForwardErrorTrace Dlt_DetForwardErrorTrace]         ||  7|| 0x07||
     21  || [#Dlt_ActivateEvent Dlt_ActivateEvent]                       || 17|| 0x11||
     22  || [#Dlt_ReadData Dlt_ReadData]                                 ||  8|| 0x08||
     23  || [#Dlt_ReadDataLength Dlt_ReadDataLength]                     ||  9|| 0x09||
     24  || [#Dlt_WriteData Dlt_WriteData]                               || 10|| 0x0A||
     25  || [#Dlt_ConditionCheckRead Dlt_ConditionCheckRead]             || 11|| 0x0B||
     26  || [#Dlt_ComProvideRxBuffer Dlt_ComProvideRxBuffer]             || 13|| 0x0D||
     27  || [#Dlt_ComProvideTxBuffer Dlt_ComProvideTxBuffer]             || 14|| 0x0E||
     28  || [#Dlt_ComRxIndication Dlt_ComRxIndication]                   || 15|| 0x0F||
     29  || [#Dlt_ComTxConfirmation Dlt_ComTxConfirmation]               || 16|| 0x10||
     30  || [#Dlt_SetLogLevel_SESSION Dlt_SetLogLevel_<SESSION>]         || 17|| 0x11||
     31  || [#Dlt_SetTraceStatus_SESSION Dlt_SetTraceStatus_<SESSION>]   || 18|| 0x12||
     32  || [#Dlt_SetVerboseMode_SESSION Dlt_SetVerboseMode_<SESSION>]   || 19|| 0x13||
     33  || [#Dlt_InjectCall_SESSION Dlt_InjectCall_<SESSION>]           || 20|| 0x14||
     34  || [#Dlt_ComTransmit Dlt_ComTransmit]                           || 18|| 0x12||
     35  || [#Dlt_ComCancelTransmitRequest Dlt_ComCancelTransmitRequest] || 19|| 0x13||
     36  || [#Dlt_ComSetInterfaceStatus Dlt_ComSetInterfaceStatus]       || 20|| 0x14||
     37
     38* コンフィギュレーション一覧
     39  * [#DltGeneral DltGeneral]
     40    * [#DltDevErrorDetect DltDevErrorDetect]
     41    * [#DltImplementAppIdContextIdQuery DltImplementAppIdContextIdQuery]
     42    * [#DltImplementExtendedHeader DltImplementExtendedHeader]
     43    * [#DltImplementFilterMessages DltImplementFilterMessages]
     44    * [#DltImplementNVRamStorage DltImplementNVRamStorage]
     45    * [#DltImplementSWCInjection DltImplementSWCInjection]
     46    * [#DltImplementTimestamp DltImplementTimestamp]
     47    * [#DltImplementVerboseMode DltImplementVerboseMode]
     48    * [#DltImplementVfbTrace DltImplementVfbTrace]
     49    * [#DltVfbTraceLogLevel DltVfbTraceLogLevel]
     50    * [#DltGptChannel DltGptChannel]
     51  * [#DltMemory DltMemory]
     52    * [#DltInitBufferSize DltInitBufferSize]
     53    * [#DltMaxCountAppIds DltMaxCountAppIds]
     54    * [#DltMaxCountContextIds DltMaxCountContextIds]
     55    * [#DltMaxCountContextIdsPerAppId DltMaxCountContextIdsPerAppId]
     56    * [#DltMessageBufferSize DltMessageBufferSize]
     57  * [#DltMultipleConfigurationContainer DltMultipleConfigurationContainer]
     58    * [#DltNvRamBlockRef DltNvRamBlockRef]
     59    * [#DltBandwidth DltBandwidth]
     60      * [#DltBandwidthForComModule DltBandwidthForComModule]
     61      * [#DltBandwidthForDiagChannel DltBandwidthForDiagChannel]
     62      * [#DltTimePeriodTrafficShaping DltTimePeriodTrafficShaping]
     63    * [#DltMessageFiltering DltMessageFiltering]
     64      * [#DltDefaultMaxLogLevel DltDefaultMaxLogLevel]
     65      * [#DltDefaultTraceStatus DltDefaultTraceStatus]
     66      * [#DltFactoryDefaultMaxLogLevel DltFactoryDefaultMaxLogLevel]
     67      * [#DltFilterMessages DltFilterMessages]
     68    * [#DltProtocol DltProtocol]
     69      * [#DltEcuId DltEcuId]
     70      * [#DltHeaderPayloadEndianes DltHeaderPayloadEndianes]
     71      * [#DltHeaderUseEcuId DltHeaderUseEcuId]
     72      * [#DltHeaderUseExtendedHeader DltHeaderUseExtendedHeader]
     73      * [#DltHeaderUseSessionID DltHeaderUseSessionID]
     74      * [#DltHeaderUseTimestamp DltHeaderUseTimestamp]
     75      * [#DltMaxMessageLength DltMaxMessageLength]
     76      * [#DltUseVerboseMode DltUseVerboseMode]
     77  * [#DltVfbTrace DltVfbTrace]
     78    * [#DltVfbTraceFunction DltVfbTraceFunction]
     79    * [#DltBswModuleEntryRef DltBswModuleEntryRef]
     80
     81* エラーコード一覧
     82
     83  ||= エラーコード =||= Dec =||= Hex =||
     84  || DLT_E_WRONG_PARAMETERS      ||  1|| 0x01||
     85  || DLT_E_ERROR_IN_PROV_SERVICE ||  2|| 0x02||
     86  || DLT_E_COM_FAILURE           ||  3|| 0x03||
     87  || DLT_E_ERROR_TO_MANY_CONTEXT ||  4|| 0x04||
     88  || DLT_E_MSG_LOOSE             ||  5|| 0x05||
     89  || DLT_E_PARAM_POINTER         ||  6|| 0x06||
     90
    1691----
    17 {{{#!comment
    18 [執筆開始時削除エリア]ここまで
    19 ※コメントごと削除してください
    20 }}}
    21 
    22 = 概要 =
     92
     93= API仕様 =
     94
     95== Dlt_Init ==
     96{{{
     97void Dlt_Init(const Dlt_ConfigType* config)
     98}}}
     99
     100== Dlt_GetVersionInfo ==
     101{{{
     102void Dlt_GetVersionInfo(Std_VersionInfoType* versioninfo)
     103}}}
     104
     105== Dlt_SendLogMessage ==
     106{{{
     107Dlt_ReturnType Dlt_SendLogMessage(Dlt_SessionIDType session_id, const Dlt_MessageLogInfoType* log_info, const uint8* log_data, uint16 log_data_length)
     108}}}
     109
     110== Dlt_SendTraceMessage ==
     111{{{
     112Dlt_ReturnType Dlt_SendTraceMessage(Dlt_SessionIDType session_id, const Dlt_MessageTraceInfoType* trace_info, const uint8* trace_data, uint16 trace_data_length)
     113}}}
     114
     115== Dlt_RegisterContext ==
     116{{{
     117Dlt_ReturnType Dlt_RegisterContext(Dlt_SessionIDType session_id, Dlt_ApplicationIDType app_id, Dlt_ContextIDType context_id, const uint8* app_description, uint8 len_app_description, const uint8* context_description, uint8 len_context_description)
     118}}}
     119
     120== Dlt_DemTriggerOnEventStatus ==
     121{{{
     122void Dlt_DemTriggerOnEventStatus(Dem_EventIdType EventId, Dem_EventStatusExtendedType EventStatusOld, Dem_EventStatusExtendedType EventStatusNew)
     123}}}
     124
     125== Dlt_DetForwardErrorTrace ==
     126{{{
     127void Dlt_DetForwardErrorTrace(uint16 ModuleId, uint8 InstanceId, uint16 ApiId, uint8 ErrorId)
     128}}}
     129
     130== Dlt_ActivateEvent ==
     131{{{
     132Std_ReturnType Dlt_ActivateEvent(uint8 RoeEventID, Dcm_RoeStateType RoeState)
     133}}}
     134
     135== Dlt_ReadData ==
     136{{{
     137Std_ReturnType Dlt_ReadData(Dcm_OpStatusType OpStatus, uint8* data)
     138}}}
     139
     140== Dlt_ReadDataLength ==
     141{{{
     142Std_ReturnType Dlt_ReadDataLength(uint16* DataLength)
     143}}}
     144
     145== Dlt_WriteData ==
     146{{{
     147Std_ReturnType Dlt_WriteData(uint8* data, uint16 dataLength, Dcm_OpStatusType OpStatus, Dcm_NegativeResponseCodeType* ErrorCode)
     148}}}
     149
     150== Dlt_ConditionCheckRead ==
     151{{{
     152Std_ReturnType Dlt_ConditionCheckRead(Dcm_OpStatusType OpStatus, Dcm_NegativeResponseCodeType* ErrorCode)
     153}}}
     154
     155== Dlt_ComProvideRxBuffer ==
     156{{{
     157BufReq_ReturnType Dlt_ComProvideRxBuffer(PduIdType DltRxPduId, PduLengthType TpSduLength, PduInfoType** PduInfoPtr)
     158}}}
     159
     160== Dlt_ComProvideTxBuffer ==
     161{{{
     162BufReq_ReturnType Dlt_ComProvideTxBuffer(PduIdType DltTxPduId, PduInfoType** PduInfoPtr, uint16 Length)
     163}}}
     164
     165== Dlt_ComRxIndication ==
     166{{{
     167void Dlt_ComRxIndication(PduIdType DltRxPduId, NotifResultType Result)
     168}}}
     169
     170== Dlt_ComTxConfirmation ==
     171{{{
     172void Dlt_ComTxConfirmation(PduIdType DltTxPduId, NotifResultType Result)
     173}}}
     174
     175== Dlt_SetLogLevel_<SESSION> ==
     176{{{
     177void Dlt_SetLogLevel_<SESSION>(Dlt_ApplicationIDType app_id, Dlt_ContextIDType context_id, Dlt_MessageLogLevelType loglevel)
     178}}}
     179
     180== Dlt_SetTraceStatus_<SESSION> ==
     181{{{
     182void Dlt_SetTraceStatus_<SESSION>(Dlt_ApplicationIDType app_id, Dlt_ContextIDType context_id, boolean new_trace_status)
     183}}}
     184
     185== Dlt_SetVerboseMode_<SESSION> ==
     186{{{
     187void Dlt_SetVerboseMode_<SESSION>(Dlt_ApplicationIDType app_id, Dlt_ContextIDType context_id, boolean is_verbose_mode)
     188}}}
     189
     190== Dlt_InjectCall_<SESSION> ==
     191{{{
     192void Dlt_InjectCall_<SESSION>(Dlt_ApplicationIDType app_id, Dlt_ContextIDType context_id, uint32 service_id, uint32 data_length, const uint8* data)
     193}}}
     194
     195== Dlt_ComTransmit ==
     196{{{
     197Std_ReturnType Dlt_ComTransmit(PduIdType DltTxPduId, PduInfoType* PduInfoPtr)
     198}}}
     199
     200== Dlt_ComCancelTransmitRequest ==
     201{{{
     202Std_ReturnType Dlt_ComCancelTransmitRequest(PduIdType PduId)
     203}}}
     204
     205== Dlt_ComSetInterfaceStatus ==
     206{{{
     207Dlt_ReturnType Dlt_ComSetInterfaceStatus(uint8[4] com_interface, uint8 new_status)
     208}}}
    23209
    24210----
    25211
    26 = API仕様 =
    27 
    28 ----
    29 
    30212= コンフィギュレーション仕様 =
     213
     214== !DltGeneral ==
     215{{{
     216/AUTOSAR/EcucDefs/Dlt/DltGeneral
     217}}}
     218* 型：Container
     219* 多重度：1
     220
     221== !DltDevErrorDetect ==
     222{{{
     223/AUTOSAR/EcucDefs/Dlt/DltGeneral/DltDevErrorDetect
     224}}}
     225* 型：!BooleanParam
     226* 多重度：1
     227
     228== !DltImplementAppIdContextIdQuery ==
     229{{{
     230/AUTOSAR/EcucDefs/Dlt/DltGeneral/DltImplementAppIdContextIdQuery
     231}}}
     232* 型：!BooleanParam
     233* 多重度：1
     234
     235== !DltImplementExtendedHeader ==
     236{{{
     237/AUTOSAR/EcucDefs/Dlt/DltGeneral/DltImplementExtendedHeader
     238}}}
     239* 型：!BooleanParam
     240* 多重度：1
     241
     242== !DltImplementFilterMessages ==
     243{{{
     244/AUTOSAR/EcucDefs/Dlt/DltGeneral/DltImplementFilterMessages
     245}}}
     246* 型：!BooleanParam
     247* 多重度：1
     248
     249== DltImplementNVRamStorage ==
     250{{{
     251/AUTOSAR/EcucDefs/Dlt/DltGeneral/DltImplementNVRamStorage
     252}}}
     253* 型：!BooleanParam
     254* 多重度：1
     255
     256== DltImplementSWCInjection ==
     257{{{
     258/AUTOSAR/EcucDefs/Dlt/DltGeneral/DltImplementSWCInjection
     259}}}
     260* 型：!BooleanParam
     261* 多重度：1
     262
     263== !DltImplementTimestamp ==
     264{{{
     265/AUTOSAR/EcucDefs/Dlt/DltGeneral/DltImplementTimestamp
     266}}}
     267* 型：!BooleanParam
     268* 多重度：1
     269
     270== !DltImplementVerboseMode ==
     271{{{
     272/AUTOSAR/EcucDefs/Dlt/DltGeneral/DltImplementVerboseMode
     273}}}
     274* 型：!BooleanParam
     275* 多重度：1
     276
     277== !DltImplementVfbTrace ==
     278{{{
     279/AUTOSAR/EcucDefs/Dlt/DltGeneral/DltImplementVfbTrace
     280}}}
     281* 型：!BooleanParam
     282* 多重度：1
     283
     284== !DltVfbTraceLogLevel ==
     285{{{
     286/AUTOSAR/EcucDefs/Dlt/DltGeneral/DltVfbTraceLogLevel
     287}}}
     288* 型：!IntegerParam
     289* 多重度：1
     290
     291== !DltGptChannel ==
     292{{{
     293/AUTOSAR/EcucDefs/Dlt/DltGeneral/DltGptChannel
     294}}}
     295* 型：Reference
     296* 多重度：1
     297
     298== !DltMemory ==
     299{{{
     300/AUTOSAR/EcucDefs/Dlt/DltMemory
     301}}}
     302* 型：Container
     303* 多重度：1
     304
     305== !DltInitBufferSize ==
     306{{{
     307/AUTOSAR/EcucDefs/Dlt/DltMemory/DltInitBufferSize
     308}}}
     309* 型：!IntegerParam
     310* 多重度：1
     311
     312== !DltMaxCountAppIds ==
     313{{{
     314/AUTOSAR/EcucDefs/Dlt/DltMemory/DltMaxCountAppIds
     315}}}
     316* 型：!IntegerParam
     317* 多重度：1
     318
     319== !DltMaxCountContextIds ==
     320{{{
     321/AUTOSAR/EcucDefs/Dlt/DltMemory/DltMaxCountContextIds
     322}}}
     323* 型：!IntegerParam
     324* 多重度：1
     325
     326== !DltMaxCountContextIdsPerAppId ==
     327{{{
     328/AUTOSAR/EcucDefs/Dlt/DltMemory/DltMaxCountContextIdsPerAppId
     329}}}
     330* 型：!IntegerParam
     331* 多重度：1
     332
     333== !DltMessageBufferSize ==
     334{{{
     335/AUTOSAR/EcucDefs/Dlt/DltMemory/DltMessageBufferSize
     336}}}
     337* 型：!IntegerParam
     338* 多重度：1
     339
     340== !DltMultipleConfigurationContainer ==
     341{{{
     342/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer
     343}}}
     344* 型：Container
     345* 多重度：1
     346
     347== !DltNvRamBlockRef ==
     348{{{
     349/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltNvRamBlockRef
     350}}}
     351* 型：Reference
     352* 多重度：1
     353
     354== !DltBandwidth ==
     355{{{
     356/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltBandwidth
     357}}}
     358* 型：Container
     359* 多重度：1
     360
     361== !DltBandwidthForComModule ==
     362{{{
     363/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltBandwidth/DltBandwidthForComModule
     364}}}
     365* 型：!IntegerParam
     366* 多重度：1
     367
     368== !DltBandwidthForDiagChannel ==
     369{{{
     370/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltBandwidth/DltBandwidthForDiagChannel
     371}}}
     372* 型：!IntegerParam
     373* 多重度：1
     374
     375== !DltTimePeriodTrafficShaping ==
     376{{{
     377/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltBandwidth/DltTimePeriodTrafficShaping
     378}}}
     379* 型：!FloatParam
     380* 多重度：1
     381
     382== !DltMessageFiltering ==
     383{{{
     384/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltMessageFiltering
     385}}}
     386* 型：Container
     387* 多重度：1
     388
     389== !DltDefaultMaxLogLevel ==
     390{{{
     391/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltMessageFiltering/DltDefaultMaxLogLevel
     392}}}
     393* 型：!IntegerParam
     394* 多重度：1
     395
     396== !DltDefaultTraceStatus ==
     397{{{
     398/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltMessageFiltering/DltDefaultTraceStatus
     399}}}
     400* 型：!BooleanParam
     401* 多重度：1
     402
     403== !DltFactoryDefaultMaxLogLevel ==
     404{{{
     405/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltMessageFiltering/DltFactoryDefaultMaxLogLevel
     406}}}
     407* 型：!IntegerParam
     408* 多重度：1
     409
     410== !DltFilterMessages ==
     411{{{
     412/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltMessageFiltering/DltFilterMessages
     413}}}
     414* 型：!BooleanParam
     415* 多重度：1
     416
     417== !DltProtocol ==
     418{{{
     419/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltProtocol
     420}}}
     421* 型：Container
     422* 多重度：1
     423
     424== !DltEcuId ==
     425{{{
     426/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltProtocol/DltEcuId
     427}}}
     428* 型：!StringParam
     429* 多重度：1
     430
     431== !DltHeaderPayloadEndianes ==
     432{{{
     433/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltProtocol/DltHeaderPayloadEndianes
     434}}}
     435* 型：!EnumerationParam
     436* 多重度：1
     437
     438== !DltHeaderUseEcuId ==
     439{{{
     440/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltProtocol/DltHeaderUseEcuId
     441}}}
     442* 型：!BooleanParam
     443* 多重度：1
     444
     445== !DltHeaderUseExtendedHeader ==
     446{{{
     447/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltProtocol/DltHeaderUseExtendedHeader
     448}}}
     449* 型：!BooleanParam
     450* 多重度：1
     451
     452== DltHeaderUseSessionID ==
     453{{{
     454/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltProtocol/DltHeaderUseSessionID
     455}}}
     456* 型：!BooleanParam
     457* 多重度：1
     458
     459== !DltHeaderUseTimestamp ==
     460{{{
     461/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltProtocol/DltHeaderUseTimestamp
     462}}}
     463* 型：!BooleanParam
     464* 多重度：1
     465
     466== !DltMaxMessageLength ==
     467{{{
     468/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltProtocol/DltMaxMessageLength
     469}}}
     470* 型：!IntegerParam
     471* 多重度：1
     472
     473== !DltUseVerboseMode ==
     474{{{
     475/AUTOSAR/EcucDefs/Dlt/DltMultipleConfigurationContainer/DltProtocol/DltUseVerboseMode
     476}}}
     477* 型：!BooleanParam
     478* 多重度：1
     479
     480== !DltVfbTrace ==
     481{{{
     482/AUTOSAR/EcucDefs/Dlt/DltVfbTrace
     483}}}
     484* 型：Container
     485* 多重度：0..*
     486
     487== !DltVfbTraceFunction ==
     488{{{
     489/AUTOSAR/EcucDefs/Dlt/DltVfbTrace/DltVfbTraceFunction
     490}}}
     491* 型：!FunctionName
     492* 多重度：1
     493
     494== !DltBswModuleEntryRef ==
     495{{{
     496/AUTOSAR/EcucDefs/Dlt/DltVfbTrace/DltBswModuleEntryRef
     497}}}
     498* 型：Reference
     499* 多重度：1
     500