Freescale-semiconductor SEC2SWUG Manuel d'utilisateur télécharger pdf

This document contains information on a new product. Specifications and information herein

are subject to change without notice.

PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE

Freescale Semiconductor

1Overview

The SEC2 device driver manages the operation of the SEC 2.0

commonly instantiated into PowerQUICC processors. It is a fully

functional component, meant to serve as an example of application

interaction with the SEC2 core.

The driver is coded in ANSI C. In it’s design, an attempt has been

made to write a device driver that is as operating system agnostic

as practical. Where necessary, operating system dependencies are

identified and Section 8, “Porting” addresses them.

Testing has been accomplished on VxWorks 5.5 and LinuxPPC

using kernel version 2.4.27.

Application interfaces to this driver are implemented through the

ioctl() function call. Requests made through this interface can

be broken down into specific components, including

miscellaneous requests and process requests. The miscellaneous

requests are any requests not related to the direct processing of

data by the SEC2 core.

Process requests comprise the majority of the requests and all are

executed using the same

ioctl() access point. Structures needed

to compose these requests are described in detail in Section 3.3.6,

“Process Request Structures.”

Throughout the document, the acronyms CHA (crypto hardware

accelerator) and EU (execution unit) are used interchangeably.

SEC2SWUG

Rev. 0, 02/2005

Contents

1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

2. Device Driver Components . . . . . . . . . . . . . . . . . . . . 3

3. User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

4. Individual Request Type Descriptions . . . . . . . . . . . 14

5. Sample Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

6. Linux Environment . . . . . . . . . . . . . . . . . . . . . . . . . . 39

7. VxWorks Environment . . . . . . . . . . . . . . . . . . . . . . . 40

8. Porting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

SEC 2.0 Reference Device Driver

User’s Guide

1 2 3 4 5 6 ... 43 44

Résumé du contenu

Page 1 - User’s Guide

This document contains information on a new product. Specifications and information herein are subject to change without notice.© Freescale Semiconduc

Page 2

SEC 2.0 Reference Device Driver User’s Guide, Rev. 010 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorUser Interface3.3.5 Miscell

Page 3 - 2 Device Driver Components

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 11User Interface STATUS_REQ

Page 4 - 2.1.3 Process Request Routine

SEC 2.0 Reference Device Driver User’s Guide, Rev. 012 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorUser InterfaceThe additiona

Page 5 - 3 User Interface

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 13User Interfacescatter-compo

Page 6 - 3.2 Error Handling

SEC 2.0 Reference Device Driver User’s Guide, Rev. 014 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorIndividual Request Type Des

Page 7 - 3.3 Global Definitions

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 15Individual Request Type Des

Page 8 - 3.3.4 Return Codes

SEC 2.0 Reference Device Driver User’s Guide, Rev. 016 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorIndividual Request Type Des

Page 9

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 17Individual Request Type Des

Page 10 - 3.3.5.1 STATUS_REQ Structure

SEC 2.0 Reference Device Driver User’s Guide, Rev. 018 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorIndividual Request Type Des

Page 11

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 19Individual Request Type Des

Page 12

SEC 2.0 Reference Device Driver User’s Guide, Rev. 02 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorOverviewBoth acronyms indica

Page 13

SEC 2.0 Reference Device Driver User’s Guide, Rev. 020 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorIndividual Request Type Des

Page 14 - 4.2 DES Requests

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 21Individual Request Type Des

Page 15 - 4.3 ARC4 Requests

SEC 2.0 Reference Device Driver User’s Guide, Rev. 022 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorIndividual Request Type Des

Page 16

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 23Individual Request Type Des

Page 17 - 4.4 Hash Requests

SEC 2.0 Reference Device Driver User’s Guide, Rev. 024 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorIndividual Request Type Des

Page 18 - 4.5 HMAC Requests

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 25Individual Request Type Des

Page 19 - 4.6 AES Requests

SEC 2.0 Reference Device Driver User’s Guide, Rev. 026 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorIndividual Request Type Des

Page 20 - 4.7.1 MOD_EXP_REQ

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 27Individual Request Type Des

Page 21 - 4.7.3 MOD_R2MODN_REQ

SEC 2.0 Reference Device Driver User’s Guide, Rev. 028 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorIndividual Request Type Des

Page 22 - 4.7.5 MOD_2OP_REQ

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 29Individual Request Type Des

Page 23

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 3Device Driver Components2 De

Page 24 - 4.8 ECC Public Key Requests

SEC 2.0 Reference Device Driver User’s Guide, Rev. 030 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorIndividual Request Type Des

Page 25 - 4.8.2 ECC_2OP_REQ

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 31Individual Request Type Des

Page 26 - 4.8.3 ECC_SPKBUILD_REQ

SEC 2.0 Reference Device Driver User’s Guide, Rev. 032 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorIndividual Request Type Des

Page 27 - 4.9 IPSec Requests

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 33Individual Request Type Des

Page 28

SEC 2.0 Reference Device Driver User’s Guide, Rev. 034 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorIndividual Request Type Des

Page 29 - 4.9.2 IPSEC_ECB_REQ

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 35Individual Request Type Des

Page 30 - 4.9.3 IPSEC_AES_CBC_REQ

SEC 2.0 Reference Device Driver User’s Guide, Rev. 036 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorSample Codeunsigned long i

Page 31 - 4.9.4 IPSEC_AES_ECB_REQ

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 37Sample CodedesencReq.status

Page 32 - 4.9.5 IPSEC_ESP_REQ

SEC 2.0 Reference Device Driver User’s Guide, Rev. 038 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorSample CodeipsecReq.hashKey

Page 33

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 39Linux Environment6Linux Env

Page 34

SEC 2.0 Reference Device Driver User’s Guide, Rev. 04 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorDevice Driver Components2.1.

Page 35 - 4.11 SRTP Protocol Requests

SEC 2.0 Reference Device Driver User’s Guide, Rev. 040 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorVxWorks Environment6.2.2 Dr

Page 36 - 5 Sample Code

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 41PortingOnce the modules are

Page 37 - 5.2 IPSEC Sample

SEC 2.0 Reference Device Driver User’s Guide, Rev. 042 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorPortingOnly a few of the fi

Page 38

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 43Porting8.4 Conditional Comp

Page 39 - 6Linux Environment

SEC2SWUGRev. 002/2005PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale™ and the Freescale logo are trademarks of Freescale Semiconductor, Inc. Th

Page 40 - 7 VxWorks Environment

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 5User Interface2.1.5 Deferred

Page 41 - 8 Porting

SEC 2.0 Reference Device Driver User’s Guide, Rev. 06 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorUser Interface3.2 Error Hand

Page 42 - 8.3 Interrupt Service Routine

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 7User Interface /* in callba

Page 43 - 8.6 Distribution Archive

SEC 2.0 Reference Device Driver User’s Guide, Rev. 08 PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE Freescale SemiconductorUser InterfaceThe NUM_CHAS d

Page 44 - How to Reach Us:

SEC 2.0 Reference Device Driver User’s Guide, Rev. 0Freescale Semiconductor PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE 9User InterfaceSEC2_CHA_NOT_A

Commentaires sur ces manuels

Pas de commentaire

Freescale-semiconductor SEC2SWUG Manuel d'utilisateur

Naviguer en ligne ou télécharger Manuel d'utilisateur pour Matériel Freescale-semiconductor SEC2SWUG. Freescale Semiconductor SEC2SWUG User Manual Manuel d'utilisatio

Résumé du contenu

Commentaires sur ces manuels

Produits connexes et manuels pour Matériel Freescale-semiconductor SEC2SWUG