Changes between Version 1 and Version 2 of spec/CryIf


Ignore:
Timestamp:
Dec 8, 2022, 5:01:10 PM (17 months ago)
Author:
fujisft-kaji
Comment:

R21-11反映

Legend:

Unmodified
Added
Removed
Modified
  • spec/CryIf

    v1 v2  
    77[[BR]]
    88
    9 {{{#!comment
    10 [執筆開始時削除エリア]ここから
    11 ※コメントごと削除してください
    12 }}}
    13 * '''本項目は、まだ執筆されていません'''
    14 * '''要望等ございましたら、[wiki: Wikiトップページ]にあります[wiki:#本サイトに関して 問い合わせ先]までお願いします'''
     9= 概要 =
     10
     11* API一覧
     12
     13  ||= API =||= ID[[BR]][Dec] =||= ID[[BR]][Hex] =||= R21-11 =||
     14  || [#CryIf_Init CryIf_Init]                                   ||  0|| 0x00||  ○  ||
     15  || [#CryIf_GetVersionInfo CryIf_GetVersionInfo]               ||  1|| 0x01||  ○  ||
     16  || [#CryIf_ProcessJob CryIf_ProcessJob]                       ||  3|| 0x03||  ○  ||
     17  || [#CryIf_CancelJob CryIf_CancelJob]                         || 14|| 0x0e||  ○  ||
     18  || [#CryIf_KeyElementSet CryIf_KeyElementSet]                 ||  4|| 0x04||  ○  ||
     19  || [#CryIf_KeySetValid CryIf_KeySetValid]                     ||  5|| 0x05||  ○  ||
     20  || [#CryIf_KeySetInvalid CryIf_KeySetInvalid]                 || 20|| 0x14||  ○  ||
     21  || [#CryIf_KeyGetStatus CryIf_KeyGetStatus]                   || 19|| 0x13||  ○  ||
     22  || [#CryIf_KeyElementGet CryIf_KeyElementGet]                 ||  6|| 0x06||  ○  ||
     23  || [#CryIf_KeyElementCopy CryIf_KeyElementCopy]               || 15|| 0x0f||  ○  ||
     24  || [#CryIf_KeyElementCopyPartial CryIf_KeyElementCopyPartial] || 18|| 0x12||  ○  ||
     25  || [#CryIf_KeyCopy CryIf_KeyCopy]                             || 16|| 0x10||  ○  ||
     26  || [#CryIf_RandomSeed CryIf_RandomSeed]                       ||  7|| 0x07||  ○  ||
     27  || [#CryIf_KeyGenerate CryIf_KeyGenerate]                     ||  8|| 0x08||  ○  ||
     28  || [#CryIf_KeyDerive CryIf_KeyDerive]                         ||  9|| 0x09||  ○  ||
     29  || [#CryIf_KeyExchangeCalcPubVal CryIf_KeyExchangeCalcPubVal] || 10|| 0x0a||  ○  ||
     30  || [#CryIf_KeyExchangeCalcSecret CryIf_KeyExchangeCalcSecret] || 11|| 0x0b||  ○  ||
     31  || [#CryIf_CallbackNotification CryIf_CallbackNotification]   || 13|| 0x0d||  ○  ||
     32
     33* コンフィギュレーション一覧 (R21-11)
     34  * [#CryIfChannel CryIfChannel] (○)
     35    * [#CryIfChannelId CryIfChannelId] (○)
     36    * [#CryIfDriverObjectRef CryIfDriverObjectRef] (○)
     37  * [#CryIfGeneral CryIfGeneral] (○)
     38    * [#CryIfDevErrorDetect CryIfDevErrorDetect] (○)
     39    * [#CryIfVersionInfoApi CryIfVersionInfoApi] (○)
     40  * [#CryIfKey CryIfKey] (○)
     41    * [#CryIfKeyId CryIfKeyId] (○)
     42    * [#CryIfKeyRef CryIfKeyRef] (○)
     43
     44* エラーコード一覧
     45
     46  ||= エラーコード =||= Dec =||= Hex =||= R21-11 =||
     47  || CRYIF_E_UNINIT            ||  0|| 0x00||  ○  ||
     48  || CRYIF_E_INIT_FAILED       ||  1|| 0x01||  ○  ||
     49  || CRYIF_E_PARAM_POINTER     ||  2|| 0x02||  ○  ||
     50  || CRYIF_E_PARAM_HANDLE      ||  3|| 0x03||  ○  ||
     51  || CRYIF_E_PARAM_VALUE       ||  4|| 0x04||  ○  ||
     52  || CRYIF_E_KEY_SIZE_MISMATCH ||  5|| 0x05||  ○  ||
     53
    1554----
    16 {{{#!comment
    17 [執筆開始時削除エリア]ここまで
    18 ※コメントごと削除してください
    19 }}}
    20 
    21 = 概要 =
     55
     56= API仕様 =
     57
     58== CryIf_Init ==
     59{{{
     60void CryIf_Init (const CryIf_ConfigType* configPtr)
     61}}}
     62
     63== CryIf_GetVersionInfo ==
     64{{{
     65void CryIf_GetVersionInfo (Std_VersionInfoType* versioninfo)
     66}}}
     67
     68== CryIf_ProcessJob ==
     69{{{
     70Std_ReturnType CryIf_ProcessJob (uint32 channelId, Crypto_JobType* job)
     71}}}
     72
     73== CryIf_CancelJob ==
     74{{{
     75Std_ReturnType CryIf_CancelJob (uint32 channelId, Crypto_JobType* job)
     76}}}
     77
     78== CryIf_KeyElementSet ==
     79{{{
     80Std_ReturnType CryIf_KeyElementSet (uint32 cryIfKeyId, uint32 keyElementId, const uint8* keyPtr, uint32 keyLength)
     81}}}
     82
     83== CryIf_KeySetValid ==
     84{{{
     85Std_ReturnType CryIf_KeySetValid (uint32 cryIfKeyId)
     86}}}
     87
     88== CryIf_KeySetInvalid ==
     89{{{
     90Std_ReturnType CryIf_KeySetInvalid (uint32 cryIfKeyId)
     91}}}
     92
     93== CryIf_KeyGetStatus ==
     94{{{
     95Std_ReturnType CryIf_KeyGetStatus (uint32 cryIfKeyId, Crypto_KeyStatusType* keyStatusPtr)
     96}}}
     97
     98== CryIf_KeyElementGet ==
     99{{{
     100Std_ReturnType CryIf_KeyElementGet (uint32 cryIfKeyId, uint32 keyElementId, uint8* resultPtr, uint32* resultLengthPtr)
     101}}}
     102
     103== CryIf_KeyElementCopy ==
     104{{{
     105Std_ReturnType CryIf_KeyElementCopy (uint32 cryIfKeyId, uint32 keyElementId, uint32 targetCryIfKeyId, uint32 targetKeyElementId)
     106}}}
     107
     108== CryIf_KeyElementCopyPartial ==
     109{{{
     110Std_ReturnType CryIf_KeyElementCopyPartial (uint32 cryIfKeyId, uint32 keyElementId, uint32 keyElementSourceOffset, uint32 keyElementTargetOffset, uint32 keyElementCopyLength, uint32 targetCryIfKeyId, uint32 targetKeyElementId)
     111}}}
     112
     113== CryIf_KeyCopy ==
     114{{{
     115Std_ReturnType CryIf_KeyCopy (uint32 cryIfKeyId, uint32 targetCryIfKeyId)
     116}}}
     117
     118== CryIf_RandomSeed ==
     119{{{
     120Std_ReturnType CryIf_RandomSeed (uint32 cryIfKeyId, const uint8* seedPtr, uint32 seedLength)
     121}}}
     122
     123== CryIf_KeyGenerate ==
     124{{{
     125Std_ReturnType CryIf_KeyGenerate (uint32 cryIfKeyId)
     126}}}
     127
     128== CryIf_KeyDerive ==
     129{{{
     130Std_ReturnType CryIf_KeyDerive (uint32 cryIfKeyId, uint32 targetCryIfKeyId)
     131}}}
     132
     133== CryIf_KeyExchangeCalcPubVal ==
     134{{{
     135Std_ReturnType CryIf_KeyExchangeCalcPubVal (uint32 cryIfKeyId, uint8* publicValuePtr, uint32* publicValueLengthPtr)
     136}}}
     137
     138== CryIf_KeyExchangeCalcSecret ==
     139{{{
     140Std_ReturnType CryIf_KeyExchangeCalcSecret (uint32 cryIfKeyId, const uint8* partnerPublicValuePtr, uint32 partnerPublicValueLength)
     141}}}
     142
     143== CryIf_CallbackNotification ==
     144{{{
     145void CryIf_CallbackNotification (Crypto_JobType* job, Crypto_ResultType result)
     146}}}
    22147
    23148----
    24149
    25 = API仕様 =
    26 
    27 ----
    28 
    29150= コンフィギュレーション仕様 =
     151
     152== CryIfChannel ==
     153{{{
     154/AUTOSAR/EcucDefs/CryIf/CryIfChannel
     155}}}
     156* 対象リビジョン: R21-11
     157* SWSタグ: ECUC_CryIf_00002
     158* タイプ: PARAM-CONF-CONTAINER
     159* 多重度: 0..*
     160
     161== CryIfChannelId ==
     162{{{
     163/AUTOSAR/EcucDefs/CryIf/CryIfChannel/CryIfChannelId
     164}}}
     165* 対象リビジョン: R21-11
     166* SWSタグ: ECUC_CryIf_00004
     167* タイプ: INTEGER-PARAM
     168* 多重度: 1
     169* 上限値: 4294967295
     170* 下限値: 0
     171
     172== CryIfDriverObjectRef ==
     173{{{
     174/AUTOSAR/EcucDefs/CryIf/CryIfChannel/CryIfDriverObjectRef
     175}}}
     176* 対象リビジョン: R21-11
     177* SWSタグ: ECUC_CryIf_00005
     178* タイプ: REFERENCE
     179* 多重度: 1
     180* 参照先: [wiki:spec/Crypto#CryptoDriverObject /AUTOSAR/EcucDefs/Crypto/CryptoDriverObjects/CryptoDriverObject]
     181
     182== CryIfGeneral ==
     183{{{
     184/AUTOSAR/EcucDefs/CryIf/CryIfGeneral
     185}}}
     186* 対象リビジョン: R21-11
     187* SWSタグ: ECUC_CryIf_00009
     188* タイプ: PARAM-CONF-CONTAINER
     189* 多重度: 1
     190
     191== CryIfDevErrorDetect ==
     192{{{
     193/AUTOSAR/EcucDefs/CryIf/CryIfGeneral/CryIfDevErrorDetect
     194}}}
     195* 対象リビジョン: R21-11
     196* SWSタグ: ECUC_CryIf_00010
     197* タイプ: BOOLEAN-PARAM
     198* 多重度: 1
     199* デフォルト値: false
     200
     201== CryIfVersionInfoApi ==
     202{{{
     203/AUTOSAR/EcucDefs/CryIf/CryIfGeneral/CryIfVersionInfoApi
     204}}}
     205* 対象リビジョン: R21-11
     206* SWSタグ: ECUC_CryIf_00011
     207* タイプ: BOOLEAN-PARAM
     208* 多重度: 1
     209* デフォルト値: false
     210
     211== CryIfKey ==
     212{{{
     213/AUTOSAR/EcucDefs/CryIf/CryIfKey
     214}}}
     215* 対象リビジョン: R21-11
     216* SWSタグ: ECUC_CryIf_00003
     217* タイプ: PARAM-CONF-CONTAINER
     218* 多重度: 0..*
     219
     220== CryIfKeyId ==
     221{{{
     222/AUTOSAR/EcucDefs/CryIf/CryIfKey/CryIfKeyId
     223}}}
     224* 対象リビジョン: R21-11
     225* SWSタグ: ECUC_CryIf_00007
     226* タイプ: INTEGER-PARAM
     227* 多重度: 1
     228* 上限値: 4294967295
     229* 下限値: 0
     230
     231== CryIfKeyRef ==
     232{{{
     233/AUTOSAR/EcucDefs/CryIf/CryIfKey/CryIfKeyRef
     234}}}
     235* 対象リビジョン: R21-11
     236* SWSタグ: ECUC_CryIf_00008
     237* タイプ: REFERENCE
     238* 多重度: 1
     239* 参照先: [wiki:spec/Crypto#CryptoKey /AUTOSAR/EcucDefs/Crypto/CryptoKeys/CryptoKey]
     240