MT2523 API Reference  LinkIt SDK v4
hal_des.h
1 /* Copyright Statement:
2  *
3  * (C) 2005-2016 MediaTek Inc. All rights reserved.
4  *
5  * This software/firmware and related documentation ("MediaTek Software") are
6  * protected under relevant copyright laws. The information contained herein
7  * is confidential and proprietary to MediaTek Inc. ("MediaTek") and/or its licensors.
8  * Without the prior written permission of MediaTek and/or its licensors,
9  * any reproduction, modification, use or disclosure of MediaTek Software,
10  * and information contained herein, in whole or in part, shall be strictly prohibited.
11  * You may only use, reproduce, modify, or distribute (as applicable) MediaTek Software
12  * if you have agreed to and been bound by the applicable license agreement with
13  * MediaTek ("License Agreement") and been granted explicit permission to do so within
14  * the License Agreement ("Permitted User"). If you are not a Permitted User,
15  * please cease any access or use of MediaTek Software immediately.
16  * BY OPENING THIS FILE, RECEIVER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES
17  * THAT MEDIATEK SOFTWARE RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES
18  * ARE PROVIDED TO RECEIVER ON AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL
19  * WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
20  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.
21  * NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE
22  * SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR
23  * SUPPLIED WITH MEDIATEK SOFTWARE, AND RECEIVER AGREES TO LOOK ONLY TO SUCH
24  * THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. RECEIVER EXPRESSLY ACKNOWLEDGES
25  * THAT IT IS RECEIVER'S SOLE RESPONSIBILITY TO OBTAIN FROM ANY THIRD PARTY ALL PROPER LICENSES
26  * CONTAINED IN MEDIATEK SOFTWARE. MEDIATEK SHALL ALSO NOT BE RESPONSIBLE FOR ANY MEDIATEK
27  * SOFTWARE RELEASES MADE TO RECEIVER'S SPECIFICATION OR TO CONFORM TO A PARTICULAR
28  * STANDARD OR OPEN FORUM. RECEIVER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND
29  * CUMULATIVE LIABILITY WITH RESPECT TO MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE,
30  * AT MEDIATEK'S OPTION, TO REVISE OR REPLACE MEDIATEK SOFTWARE AT ISSUE,
31  * OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY RECEIVER TO
32  * MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE.
33  */
34 
35 #ifndef __HAL_DES_H__
36 #define __HAL_DES_H__
37 #include "hal_platform.h"
38 
39 #ifdef HAL_DES_MODULE_ENABLED
40 
41 #ifdef HAL_DES_USE_PHYSICAL_MEMORY_ADDRESS
42 
143 #else
144 
243 #endif
244 
245 #include "hal_define.h"
246 
247 #ifdef __cplusplus
248 extern "C" {
249 #endif
250 
257 #define HAL_DES_BLOCK_SIZES (8)
258 
261 #define HAL_DES_KEY_LENGTH_64 (8)
262 
265 #define HAL_DES_KEY_LENGTH_128 (16)
266 
269 #define HAL_DES_KEY_LENGTH_192 (24)
270 
273 #define HAL_DES_CBC_IV_LENGTH (8)
274 
286 typedef enum {
287  HAL_DES_STATUS_ERROR = -1,
288  HAL_DES_STATUS_OK = 0
289 } hal_des_status_t;
290 
300 typedef struct {
301  uint8_t *buffer;
302  uint32_t length;
303 } hal_des_buffer_t;
304 
322 hal_des_status_t hal_des_cbc_encrypt(hal_des_buffer_t *encrypted_text,
323  hal_des_buffer_t *plain_text,
324  hal_des_buffer_t *key,
325  uint8_t init_vector[HAL_DES_CBC_IV_LENGTH]);
326 
338 hal_des_status_t hal_des_cbc_decrypt(hal_des_buffer_t *plain_text,
339  hal_des_buffer_t *encrypted_text,
340  hal_des_buffer_t *key,
341  uint8_t init_vector[HAL_DES_CBC_IV_LENGTH]);
342 
343 
354 hal_des_status_t hal_des_ecb_encrypt(hal_des_buffer_t *encrypted_text,
355  hal_des_buffer_t *plain_text,
356  hal_des_buffer_t *key);
357 
368 hal_des_status_t hal_des_ecb_decrypt(hal_des_buffer_t *plain_text,
369  hal_des_buffer_t *encrypted_text,
370  hal_des_buffer_t *key);
371 
372 
373 
374 #ifdef __cplusplus
375 }
376 #endif
377 
382 #endif /*HAL_DES_MODULE_ENABLED*/
383 #endif /* __HAL_DES_H__ */