Freescale Semiconductor SEC2SWUG User Interface, Application Interface, Deferred Service Routine

Page 5

User Interface

2.1.5 Deferred Service Routine

The ProcessingComplete() routine completes the request outside of the interrupt service routine, and runs in a non-ISR context. This routine depends on the IsrMsgQId queue and processes messages written to the queue by the interrupt service routine. This function will determine which request is complete, and notify the calling task using any handler specified by that calling task. It will then check the remaining content of the process request queue, and schedule any queued requests.

3 User Interface

3.1 Application Interface

In order to make a request of the SEC2 device, the calling application populates a request structure with information describing the request. These structures are described in Section 4, “Individual Request Type Descriptions,” and include items such as operation ID, channel, callback routines (success and error), and data.

Once the request is prepared, the application calls ioctl() with the prepared request. This function is a standard system call used by operating system I/O subsystems to implement special-purpose functions. It typically follows the format:

int ioctl(int fd, /* file descriptor */

int function, /* function code */

int arg /* arbitrary argument (driver dependent) */

The function code (second argument) is defined as the I/O control code. This code will specify the driver-specific operation to be performed by the device in question. The third argument is the pointer to the SEC2 user request structure which contains information needed by the driver to perform the function requested.

The following is a list of guidelines to be followed by the end-user application when preparing a request structure:

•The first member of every request structure is an operation ID (opID). The operation ID is used by the device driver to determine the format of the request structure.

•While all requests have a “channel” member, it's presence is a holdover from earlier variations of the security engine. For SEC2, it no longer has a valid use, and is retained solely to maintaining request compatibility for applications written for older security engines.

•All process request structures have a status member. This value is filled in by the device driver when the interrupt for the operation occurs and it reflects the status of the operation as indicated by the interrupt. The valid values for this status member are DONE (normal status) or ERROR (error status).

•All process request structures have two notify members, notify and notify_on_error. These notify members can be used by the device driver to notify the application when its request has been completed. They may be the same function, or different, as required by the caller's operational requirements.

•All process request structures have a next request member. This allows the application to chain multiple process requests together.

•It is the application's choice to use a notifier function or to poll the status member.

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

Freescale Semiconductor

PRELIMINARY—SUBJECT TO CHANGE WITHOUT NOTICE

5

Page 4 Page 6
Image 5
Page 4 Page 6
Contents Freescale Semiconductor OverviewOverview Acronyms and AbbreviationsTerm Meaning SEC 2.0 Reference Device Driver User’s Guide, RevDevice Driver Structure Device Driver ComponentsDevice Driver Components End-User ApplicationDriver Initialization Routine Interrupt Service RoutineRequest Dispatch Routine Process Request RoutineUser Interface Deferred Service RoutineApplication Interface User Interface= Dpdaesacbcencryptcrypt Error Handling1 I/O Control Codes Global DefinitionsChannel Definitions Second and Third Arguments in the ioctl FunctionOperation ID opId Masks Callback Error Status Return CodeReturn Codes Channel DefinesSEC2CHAERROR SEC2ADDRESSPROBLEMSEC2PARITYSYSTEMERROR SEC2TEAERRORMiscellaneous Request Structures SEC2CANCELLEDREQUESTSEC2INVALIDADDRESS Define DescriptionStatusreq Process Request StructuresScatter-Gather Buffer Management NotifyonerrorDirect Scatter-Gather Usage Example Random Number Requests Individual Request Type DescriptionsDES Requests RngreqDescryptreq ARC4 Requests1 ARC4LOADCTXCRYPTREQ Descbccryptreq Valid Descriptors opIdARC4LOADKEYCRYPTUNLOADCTXREQ Valid Descriptor opId 2 ARC4LOADKEYCRYPTUNLOADCTXREQARC4LOADCTXCRYPTREQ Valid Descriptor opId Hashreq Valid Descriptors 0x4400 opId Hash RequestsHashreq Hashreq Valid Descriptors 0x4500 opId Hmac RequestsHmacpadreq Hmacpadreq Valid Descriptors opId AES RequestsAesacryptreq Modexpreq Integer Public Key RequestsAesacryptreq Valid Descriptors opId Modexpreq Valid Descriptor opIdMODR2MODNREQ ModssexpreqModssexpreq Valid Descriptor opId Dpdmmssrsaexp5 MOD2OPREQ ModrrmodpreqModrrmodpreq Valid Descriptor opId 0x5300MOD2OPREQ Valid Descriptors opId Value Function Description MOD2OPREQ Valid Descriptors opId ECC Public Key RequestsEccpointreq Eccpointreq Valid Descriptors opId 2 ECC2OPREQECC2OPREQ Valid Descriptors opId EccspkbuildreqEccspkbuildreq Valid Descriptor opId DpdecspkbuildulctxEccptadddblreq IPSec RequestsIpseccbcreq Eccptadddblreq Valid Descriptor opIdIpseccbcreq Valid Descriptors opId Descriptors Ipsececbreq Valid Descriptors opId IpsececbreqIpsecaescbcreq Valid Descriptors opId IpsecaescbcreqIpsecaesecbreq Ipsecaesecbreq Valid Descriptors opId IpsecespreqIpsecespreq Valid Descriptors opId DPDIPSECESPOUTTDESCBCCRPTMD5PAD DpdipsecespinsdescbcdcrptshapadDpdipsecespouttdescbccrptshapad DPDIPSECESPINTDESCBCDCRPTMD5PADSrtp Protocol Requests 10 802.11 Protocol RequestsCcmpreq SrtpreqSrtpreq Valid Descriptors opId Sample CodeDES Sample Ipsec Sample PRELIMINARY-SUBJECT to Change Without Notice Operation InstallationLinux Environment VxWorks Environment Driver Operation in User ModeDriver Module License Macro VxWorks EnvironmentBuilding the Interface Modules PortingBSP Integration VxWorks Interface Module VariablesSource Files Interrupt Service RoutineHeader Files Distribution Archive Conditional CompilationDebug Messaging How to Reach Us

SEC2SWUG specifications

Freescale Semiconductor, a prominent player in the semiconductor industry, has made significant strides in developing robust solutions tailored for the automotive and industrial sectors. One such innovation is the SEC2SWUG (Security Configuration to Software User Guide), a comprehensive framework designed to enhance security protocols across various applications.

The SEC2SWUG is particularly vital in an era where cybersecurity threats are increasingly sophisticated. This tool is built to help developers implement security measures seamlessly during the software design phase, ensuring products are resilient against potential vulnerabilities. One of the main features of the SEC2SWUG is its versatility; it can be applied across a wide range of microcontrollers and processors offered by Freescale. This is particularly advantageous for engineers who require a consistent security approach across different platforms.

In terms of technology, the SEC2SWUG incorporates advanced cryptographic algorithms, allowing for data encryption, decryption, and authentication processes. This ensures that sensitive information remains secure, particularly in automotive applications where vehicle-to-everything (V2X) communication is becoming paramount. Moreover, the guide details the implementation of secure boot processes, which verify the integrity of firmware before it executes, bolstering overall system security.

Another key characteristic of SEC2SWUG is its user-friendliness. Freescale has focused on creating a resource that not only provides theoretical knowledge but also practical guidelines, making it easier for developers to integrate security protocols into their projects. The guide features clear annotations, example code snippets, and troubleshooting tips, which enhance the developer experience and facilitate a smoother transition from concept to execution.

Additionally, SEC2SWUG is designed to be scalable. As industries evolve, the demand for security measures will only grow, and this framework ensures that developers can adapt their solutions accordingly. Whether working on embedded systems, IoT applications, or complex automotive networks, the SEC2SWUG offers a robust security foundation.

In conclusion, Freescale Semiconductor's SEC2SWUG is a vital tool for engineers and developers looking to embed security into their applications. With its focus on advanced technologies and user-centric design, the SEC2SWUG stands at the forefront of secure software development, addressing the critical need for safety in interconnected systems.
Top Page Image Contents