Freescale Semiconductor SEC2SWUG Network Card User Manual


 
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
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