5 miscellaneous request structures, 1 status_req structure, 2 sec2_notify_on_error_ctx structure – Freescale Semiconductor SEC2SWUG User Manual

Page 10

Advertising
background image

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

10

PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE

Freescale Semiconductor

User Interface

3.3.5 Miscellaneous Request Structures

3.3.5.1 STATUS_REQ Structure

Used to indicate the internal state of the

SEC2

core as well as the driver after the occurrence of an event. Returned

as a pointer by

GetStatus()

and embedded in all requests. This structure is defined in

Sec2Notify.h

Each element is a copy of the contents of the same register in the

SEC2

driver. This structure is also known as

SEC2_STATUS

through a typedef.

unsigned long ChaAssignmentStatusRegister[2];

unsigned long InterruptControlRegister[2];

unsigned long InterruptStatusRegister[2];

unsigned long IdRegister;

unsigned long ChannelStatusRegister[NUM_CHANNELS][2];

unsigned long ChannelConfigurationRegister[NUM_CHANNELS][2];

unsigned long CHAInterruptStatusRegister[NUM_CHAS][2];

unsigned long QueueEntryDepth;

unsigned long FreeChannels;

unsigned long FreeAfhas;

unsigned long FreeDesas;

unsigned long FreeMdhas;

unsigned long FreePkhas;

unsigned long FreeAesas;

unsigned long FreeKeas;

unsigned long BlockSize;

3.3.5.2 SEC2_NOTIFY_ON_ERROR_CTX Structure

Structure returned to the

notify_on_error

callback routine that was setup in the initial process request. This

structure contains the original request structure as well as an error and driver status.

unsigned long errorcode; // Error that the request generated

void *request; // Pointer to original request

SEC2_CANCELLED_REQUEST

Error due to canceled request

-1010

SEC2_INVALID_ADDRESS

Error due to a

NULL

request

-1011

Table 5. Callback Error Status Return Code (continued)

Define Description

Value

Advertising