arm_uc_mmCryptoUtils.h

00001 // ----------------------------------------------------------------------------
00002 // Copyright 2016-2017 ARM Ltd.
00003 //
00004 // SPDX-License-Identifier: Apache-2.0
00005 //
00006 // Licensed under the Apache License, Version 2.0 (the "License");
00007 // you may not use this file except in compliance with the License.
00008 // You may obtain a copy of the License at
00009 //
00010 //     http://www.apache.org/licenses/LICENSE-2.0
00011 //
00012 // Unless required by applicable law or agreed to in writing, software
00013 // distributed under the License is distributed on an "AS IS" BASIS,
00014 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
00015 // See the License for the specific language governing permissions and
00016 // limitations under the License.
00017 // ----------------------------------------------------------------------------
00018 
00019 #ifndef MANIFEST_MANAGER_CRYPTO_FSM_H
00020 #define MANIFEST_MANAGER_CRYPTO_FSM_H
00021 
00022 #include "update-client-manifest-manager/update-client-manifest-manager-context.h"
00023 #include "update-client-manifest-manager/update-client-manifest-types.h"
00024 #include "update-client-common/arm_uc_config.h"
00025 
00026 
00027 arm_uc_error_t ARM_UC_mmValidateManifestHash(arm_uc_buffer_t *buffer);
00028 #if defined(ARM_UC_FEATURE_MANIFEST_PUBKEY) && (ARM_UC_FEATURE_MANIFEST_PUBKEY == 1)
00029 arm_uc_error_t ARM_UC_mmValidateSignature(arm_uc_mm_validate_signature_context_t *ctx,
00030                                           void (*applicationEventHandler)(uintptr_t),
00031                                           arm_uc_buffer_t *buffer,
00032                                           arm_uc_buffer_t *certBuffer,
00033                                           uint32_t sigIndex);
00034 #endif /* ARM_UC_FEATURE_MANIFEST_PUBKEY */
00035 #if defined(ARM_UC_FEATURE_MANIFEST_PSK) && (ARM_UC_FEATURE_MANIFEST_PSK == 1)
00036 arm_uc_error_t ARM_UC_mmVerifySignaturePSK(arm_uc_mm_validate_signature_context_t *ctx,
00037                                            void (*applicationEventHandler)(uintptr_t),
00038                                            arm_uc_buffer_t *buffer,
00039                                            uint32_t sigIndex);
00040 #endif /* ARM_UC_FEATURE_MANIFEST_PSK */
00041 arm_uc_error_t ARM_UC_mmGetManifestHashFromBin(arm_uc_buffer_t *buffer, arm_uc_buffer_t *hash);
00042 void ARM_UC_mmGetFirmwareHashFromBin(arm_uc_buffer_t *manifest, arm_uc_buffer_t *hash);
00043 
00044 
00045 struct cryptsize {
00046     uint32_t hashlen;
00047     uint32_t aeslen;
00048 };
00049 
00050 struct cryptsize getCryptInfo(arm_uc_buffer_t *buffer);
00051 /**
00052  * NOTE: This function does no validation. cryptomode must already have been validated by validateCryptoMode
00053  *
00054  * */
00055 arm_uc_mm_crypto_flags_t ARM_UC_mmGetCryptoFlags(uint32_t cryptoMode);
00056 
00057 
00058 #endif // MANIFEST_MANAGER_CRYPTO_FSM_H