Freescale Semiconductor SEC2SWUG 4.6 AES Requests

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0

Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 19

Individual Request Type Descriptions

4.6 AES Requests

4.6.1 AESA_CRYPT_REQ

COMMON_REQ_PREAMBLE

unsigned long keyBytes ; /* 16, 24, or 32 by tes */

unsigned char *keyData;

unsigned long inIvByte s; /* 0 or 16 bytes */

unsigned char *inIvData ;

unsigned long inBytes; /* multiple of 8 byte s */

unsigned char *inData;

unsigned char *outData; /* output lengt h = input length */

unsigned long outCtxBy tes; /* 0 or 8 bytes */

unsigned char *outCtxDa ta;

NUM_AESA_CRYPT_DESC defines the number of descriptors within the DPD_AESA_CRYPT_GROUP that use this

request.

DPD_AESA_CRYPT_GROUP (0x6000) defines the group for all descriptors within this request.

Table 13. HMAC_PAD_REQ Valid Descriptors (opId)

Descriptors Value Function Description

DPD_SHA256_LDCTX_HMAC_ULCTX 0x4A00 Load context, then use an SHA-256 hash algorithm,

then store the resulting HMAC context

DPD_MD5_LDCTX_HMAC_ULCTX 0x4A01 Load context, then use an MD5 hash algorithm, then

store the resulting HMAC context

DPD_SHA_LDCTX_HMAC_ULCTX 0x4A02 Load context, then use an SHA-1 hash algorithm,

then store the resulting HMAC context

DPD_SHA256_LDCTX_HMAC_PAD_ULCTX 0x4A03 Load context, then use an SHA-256 IDGS hash

algorithm, then store the resulting padded HMAC

context

DPD_MD5_LDCTX_HMAC_PAD_ULCTX 0x4A04 Load context, then use an MD5 IDGS hash algorithm,

then store the resulting padded HMAC context

DPD_SHA_LDCTX_HMAC_PAD_ULCTX 0x4A05 Load context, then use an SHA-1 IDGS hash

algorithm, then store the resulting padded HMAC

context

Contents

Main Freescale Semiconductor 1Overview SEC2SWUG Rev. 0, 02/2005 SEC 2.0 Reference Device Driver Users Guide Table1. Acronyms and Ab breviations 2 Device Driver Components 2.1 Device Driver Structure 2.1.1 Driver Initialization Routine 2.1.2 Request Dispatch Routine 2.1.3 Process Request Routine 2.1.4 Interrupt Service Routine 2.1.5 Deferred Service Routine 3 User Interface 3.1 A pplication Interface 3.2 Error Handling 3.3 Global Definitions 3.3.1 I/O Control Codes 3.3.2 Channel Definitions 3.3.3 Operation ID (opId) Masks A complete list of the error status results that may be returned to the callback routines follows: 3.3.4 Return Codes Page 3.3.5 Miscellaneous Request Structures 3.3.5.1 STATUS_REQ Structure 3.3.5.2 SEC2_NOTIFY_ON_ERROR_CT X Structure 3.3.6 Process Request Structures issue of the user's request. 3.3.7 Scatter-Gather Buffer Management 3.3.7.1 Building the Local Scatter/Gather List with EXT_SCATTER_ELEM ENT 3.3.7.2 Scatter Buffer Marking 3.3.7.3 Direct Scatter-Gather Usage Example 4 Individual Request Type Descriptions 4.1 Random Number Requests 4.1.1 RNG_REQ 4.2 DES Requests 4.2.1 DES_CBC_CRYPT_REQ 4.3 ARC4 Requests 4.3.1 ARC4_LOADCTX_CRYPT_REQ 4.3.2 ARC4_LOADKEY_CRYPT_UNLOADCTX_REQ 4.4 Hash Requests 4.4.1 HASH_REQ 4.5 HMAC Requests 4.5.1 HMAC_PAD_REQ use this request. 4.6 AES Requests 4.6.1 AESA_CRYPT_REQ 4.7 Integer Public Key Requests 4.7.1 MOD_EXP_REQ 4.7.2 MOD_SS_EXP_REQ 4.7.3 MOD_R2MODN_REQ 4.7.4 MOD_RRMODP_REQ 4.7.5 MOD_2OP_REQ Table19. MOD_2OP_REQ Valid Descriptors (opId) 4.8 ECC Public Key Requests 4.8.1 ECC_POINT_REQ Table19. MOD_2OP_REQ Valid Descriptors (opId) (continued) 4.8.2 ECC_2OP_REQ 4.8.3 ECC_SPKBUILD_REQ 4.8.4 ECC_PTADD_DBL_REQ 4.9 IPSec Requests 4.9.1 IPSEC_CBC_REQ Table23. ECC_PTADD_DBL_REQ Valid Descriptor (opId) DPD_EC_FPADD DPD_EC_FPDBL DPD_EC_F2MADD DPD_EC_F2MDBL Page 4.9.2 IPSEC_ECB_REQ 4.9.3 IPSEC_AES_CBC_REQ 4.9.4 IPSEC_AES_ECB_REQ 4.9.5 IPSEC_ESP_REQ Page Page 4.10 802.11 Protocol Requests 4.10.1 CCMP_REQ 4.11 SRTP Protocol Requests 4.11.1 SRTP_REQ Table 29. CCMP_REQ Valid Descriptors (opId) 5 Sample Code The following sections provide sample codes for DES and IPSec. 5.1 DES Sample Table 30. SRTP_REQ Valid Descriptors (opId) DPD_SRTP_OUTBOUND DPD_SRTP_INBOUND 5.2 IPSEC Sample Page 6Linux Environment 6.1 Installation 6.1.1 Driver Source 6.1.2 Device Inode 6.2 Operation 7 VxWorks Environment 7.1 Installation 7.2 Building the Interface Modules 7.3 BSP Integration 8 Porting 8.1 Header Files 8.2 C Source Files 8.3 Interrupt Service Routine 8.4 Conditional Compilation 8.5 Debug Messaging 8.6 Distribution Archive SEC2SWUG Rev. 0 02/2005 PRELIMINARYSUBJECT TO CHANGE WITHOUT NOTICE How to Reach Us: