beautypg.com

Freescale Semiconductor SEC2SWUG User Manual

Sec 2.0 reference device driver user’s guide, 1overview, Freescale semiconductor

background image

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

© Freescale Semiconductor, Inc., 2005. All rights reserved.

PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE

Freescale Semiconductor

1

Overview

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

Table of contents