E-34
DINK32 PowerPC ISA Debugger User’s Manual
For More Information On This Product,
Go to: www.freescale.com
MOTOROLA
MPC8240 I2O Doorbell Driver
agent’s Outbound Message Interrupt Mask Register(OMIMR) and placed in the address
given in the val parameter. The OMISRregister is cleared.
E.3.2
I2C Driver Library
This section provides information about the generic Application Program Interface (API)
to the I2C Driver Library as well as information about the implementation of the
Kahlua-specific I2C Driver Library Internals (DLI).
E.3.2.1
Background
The intended audience for this document is assumed to be familiar with the I2C bus
protocol. It is a companion document to the Kahlua specification and other documentation
which collectively give details of the I2C protocol and the Kahlua implementation. This
document provides information about the software written to access the Kahlua I2C
interface. This software is intended to assist in the development of higher level applications
software that uses the I2C interface.
NOTE
The I2C driver software is currently under development. The
only modes that are functional are the master-transmit and
master-receive in polling mode.
E.3.2.2
Overview
This document consists of these parts:
An Application Program Interface (API) which provides a very simple, generic,
application level programmatic interface to the I2C driver library that hides all
details of the Kahlua-specific implementation of the I2C interface (i.e., control
register, status register, embedded utilities memory block, etc.).
I2C API functions showing the following:
— how the function is called (i.e., function prototype)
— parameter definition possible
— return values
— brief description of what the function does
— an explanation of how the functions are used by an application program
(DINK32 usage employed as examples)
An I2C Driver Library Internals (DLI) which provides information about the lower
level software that is accessing the Kahlua-specific implementation of the I2C
interface.
I2C DLI functions showing the following:
F
n
.