SNIP_CLASSIC_CRYIF_SECTION_8_3_4_5_Key_Generation_Interface

8.3.4.5 Key Generation Interface [SWS_CryIf_91007] Definition of API function CryIf_RandomSeed ⌈ Service Name CryIf_RandomSeed Syntax Std_ReturnType CryIf_RandomSeed ( uint32 cryIfKeyId, const uint8* seedPtr, uint32 seedLength ) Service ID [hex] 0x07 Sync/Async Synchronous Reentrancy Reentrant cryIfKeyId Holds the identifier of the key for which a new seed shall be generated. seedPtr Holds a pointer to the memory location which contains the data to feed the seed. Parameters (in) seedLength Contains the length of the seed in bytes. Parameters (inout) None Parameters (out) None Return value Std_ReturnType E_OK: Request successful E_NOT_OK: Request failed CRYPTO_E_KEY_NOT_VALID: Request failed, the key state of the key identified by cryptoKeyId is "invalid". CRYPTO_E_KEY_EMPTY: Request failed because of uninitialized source key element Description This function shall dispatch the random seed function to the configured crypto driver object. Available via CryIf.h ⌋ [SWS_CryIf_00068] CryIf_RandomSeed API: Report CRYIF_E_UNINIT error Upstream requirements: SRS_CryptoStack_00034, SRS_BSW_00369, SRS_BSW_00406 ⌈If development error detection for the CRYIF is enabled: The function CryIf_RandomSeed shall report CRYIF_E_UNINIT to the DET if the module is not yet initialized.⌋ [SWS_CryIf_00069] CryIf_RandomSeed API: Report CRYIF_E_PARAM_HANDLE error Upstream requirements: SRS_CryptoStack_00034, SRS_BSW_00369 ⌈If development error detection for the CRYIF is enabled: The function CryIf_RandomSeed shall report CRYIF_E_PARAM_HANDLE to the DET if the parameter cryIfKeyId is out of range.⌋ [SWS_CryIf_00070] CryIf_RandomSeed API: Report CRYIF_E_PARAM_POINTER error Upstream requirements: SRS_CryptoStack_00034, SRS_BSW_00369 ⌈If development error detection for the CRYIF is enabled: The function CryIf_RandomSeed shall report CRYIF_E_PARAM_POINTER to the DET if the parameter seedPtr is a null pointer.⌋ [SWS_CryIf_00071] CryIf_RandomSeed API: Report CRYIF_E_PARAM_VALUE error Upstream requirements: SRS_CryptoStack_00034, SRS_BSW_00369 ⌈If development error detection for the CRYIF is enabled: The function CryIf_RandomSeed shall report CRYIF_E_PARAM_VALUE to the DET if seedLength is zero.⌋ [SWS_CryIf_00072] CryIf_RandomSeed API: Forward random seed job to the mapped driver Upstream requirements: SRS_CryptoStack_00104 ⌈If no errors are detected by CRYIF, the service CryIf_RandomSeed shall call Crypto_<vi>_<ai>_RandomSeed for the driver configuration mapped to the service and pass on the return value.⌋ [SWS_CryIf_91008] Definition of API function CryIf_KeyGenerate ⌈ Service Name CryIf_KeyGenerate Syntax Std_ReturnType CryIf_KeyGenerate ( uint32 cryIfKeyId ) Service ID [hex] 0x08 Sync/Async Synchronous Reentrancy Reentrant Parameters (in) cryIfKeyId Holds the identifier of the key which is to be updated with the generated value. Parameters (inout) None Parameters (out) None Return value Std_ReturnType E_OK: Request successful E_NOT_OK: Request failed CRYPTO_E_BUSY: Request failed, Crypto Driver Object is busy CRYPTO_E_KEY_EMPTY: Request failed because of uninitialized source key element CRYPTO_E_KEY_NOT_VALID: Request failed, the key state of the key identified by cryptoKeyId is "invalid". Description This function shall dispatch the key generate function to the configured crypto driver object. Available via CryIf.h ⌋ [SWS_CryIf_00073] CryIf_KeyGenerate API: Report CRYIF_E_UNINIT error Upstream requirements: SRS_CryptoStack_00034, SRS_BSW_00369, SRS_BSW_00406 ⌈If development error detection for the CRYIF module is enabled: The function CryIf_KeyGenerate shall report CRYIF_E_UNINIT to the DET if the module is not yet initialized.⌋ [SWS_CryIf_00074] CryIf_KeyGenerate API: Report CRYIF_E_PARAM_HANDLE error Upstream requirements: SRS_CryptoStack_00034, SRS_BSW_00369 ⌈If development error detection for the CRYIF module is enabled: The function CryIf_KeyGenerate shall report CRYIF_E_PARAM_HANDLE to the DET if the parameter cryIfKeyId is out of range.⌋ [SWS_CryIf_00075] CryIf_KeyGenerate API: Forward key job to the mapped driver Upstream requirements: SRS_CryptoStack_00104 ⌈If no errors are detected by CRYIF, the service CryIf_KeyGenerate shall call Crypto_<vi>_<ai>_KeyGenerate for the driver configuration mapped to the service and pass on the return value.⌋