sysmoti2c.h

Freescale mpc834x 的VxWorks平台的BSP源代码。

/* sysMotI2c.h - I2C Driver Header Module */

/* Copyright 1984-2005 Wind River Systems, Inc. */
/* Copyright 1996-2000 Motorola, Inc. All Rights Reserved */

/*
modification history
--------------------
01a,28feb00,rhk  created from version 01b, MV2100 BSP.
*/

/*
DESCRIPTION

I2C Driver Header Module
*/

#ifndef	INCsysMotI2ch
	#define	INCsysMotI2ch

	#ifdef __cplusplus
extern "C" {
	#endif

/* device types */

	#define MPC834X_I2C_CONTROLLER		0
	#define I2C_DRV_TYPE 				MPC834X_I2C_CONTROLLER
    

	
	#define I2C_DEVICE_TYPE_EEPROM_AT24C256		    0
	#define I2C_DEVICE_TYPE_TEMP_SENSOR_AD7417	    1
    #define I2C_DEVICE_TYPE_IOPORT_PCA9555          2

/* driver device data template (os + driver-specifics) */

	typedef struct i2cDev 
	{
		unsigned int deviceAddress;		/* address of the I2C device */
		int          deviceType;		/* device type: 0 = EEPROM, 1 = other */
		unsigned int blockSize;			/* logical block size in bytes */
		unsigned int blockOffset;		/* logical block offset from zero of start */
		unsigned int blockTotal;		/* number of logical blocks from offset */
		unsigned int controlAddress;	/* controller address */
		unsigned int pageSize;			/* page size in number of blocks */
		unsigned int controlWord;		/* control word */
		unsigned int sysClkRate;		/* system clock rate */
	} 
	i2cDev_t;

/* driver command packet */

	typedef struct i2cCmdPckt 
	{
		int command;		/* command identifier */
		int status;			/* status (error code) */
		unsigned int memoryAddress;	/* memory address */
		unsigned int blockNumber;	/* block number */
		unsigned int nBlocks;	/* number of blocks (bytes) to transfer */
		unsigned int eCount;	/* expected data count */
		unsigned int aCount;	/* actual data count */
		int deviceType ;
	} 
	i2cCmdPckt_t;


typedef struct {
    int     unit ;
    UINT32  baseAdrs ;
} I2C_DRV_CTRL ;



/* ioctl flags */

	#define I2C_IOCTL_WR			0
	#define I2C_IOCTL_RD			1
	#define I2C_IOCTL_RMW_OR 		2
	#define I2C_IOCTL_RMW_AND 		3
	#define I2C_IOCTL_RMW_AND_OR 	4
	
/* command identifiers */

	#define I2C_READOP	0	/* read operation */
	#define I2C_WRITOP	1	/* write operation */
	#define I2C_FRMTOP	2	/* format operation */
	#define I2C_CHCKOP	3	/* check operation */

	#define I2C_BYTE_NUM_MASK	0x700
	#define I2C_BYTE_NUM_SHIFT	7

/* controller specific function pointers table template */

	typedef struct i2cDrvRoutines 
	{
		int (*pI2cCycleStart)();	/* start cycle */
		int (*pI2cCycleStop)();	/* stop cycle */
		int (*pI2cCycleRead)();	/* read cycle */
		int (*pI2cCycleWrite)();	/* write cycle */
		int (*pI2cCycleAckIn)();	/* acknowledge in cycle */
		int (*pI2cCycleAckOut)();	/* acknowledge out cycle */
		int (*pI2cKnownState)();	/* known state */
		void (*pI2cDelay)();	/* delay routine */
	} 
	i2cDrvRoutines_t;

/* routine call macros */

/*
 * Note: this driver could dynamically assign function pointers
 * but ROM based switch statements are not permitted so the 
 * function pointers are set here for the specific board BSP.
 */
	#define I2C_CYCLE_START(x)		i2cCycleMpc834xStart(x)
	#define I2C_CYCLE_STOP(x)		i2cCycleMpc834xStop(x)
	#define I2C_CYCLE_READ(x,ad,y)	i2cCycleMpc834xRead(x,ad,y)
	#define I2C_CYCLE_WRITE(x,wd)	i2cCycleMpc834xWrite(x,wd)
	#define I2C_CYCLE_ACKIN(x)		i2cCycleMpc834xAckIn(x)
	#define I2C_CYCLE_ACKOUT(x)	    i2cCycleMpc834xAckOut(x)
	#define I2C_KNOWN_STATE(x)		i2cCycleMpc834xKnownState(x)
	#define I2C_DELAY(d)		    i2cCycleMpc834xDelay(d)

/* error codes */

	#define I2C_ERROR_CYCLE_START	1	/* start cycle */
	#define I2C_ERROR_CYCLE_STOP	2	/* stop cycle */
	#define I2C_ERROR_CYCLE_READ	3	/* read cycle */
	#define I2C_ERROR_CYCLE_WRITE	4	/* write cycle */
	#define I2C_ERROR_CYCLE_ACKIN	5	/* acknowledge in cycle */
	#define I2C_ERROR_CYCLE_ACKOUT	6	/* acknowledge out cycle */
	#define I2C_ERROR_KNOWN_STATE	7	/* known state */
	#define I2C_ERROR_CYCLE_TIMEOUT	(1<<16)	/* cycle timed out */


	UINT8 i2cIoctl (
					   UINT32   ioctlflg,	 /* input/ouput control flag
										  * 0, write
										  * 1, read
										  * 2, read/modify/write (ORing)
										  * 3, read/modify/write (ANDing)
										  * 4, read/modify/write (AND/ORing)
										  */
					   UINT32   address,	 /* address of device register to be operated upon */
					   UINT8    bdata1,	 /* data item 1 for read/write operation */
					   UINT8    bdata2	 /* data item 2 for read/write operation */
					   ) ;

	STATUS i2cDrvInit (
                      int       unit,
					  int       i2cControllerType	  /* I2C controller type */
					  ) ;

	int i2cRead (
                int             unit,
				UINT32          deviceAddress,	/* Device's I2C bus address */
				int             deviceType,
				unsigned int    startBlk,	/* starting block to read, or temp reg # */
				unsigned int    numBlks,	/* number of blocks to read, or temp reg size (1 or 2) */
				char *          pBuf			/* pointer to buffer to receive data */
				) ;

	int i2cWrite (
                 int            unit,
				 UINT32         deviceAddress,	 /* Device's I2C bus address */
				 int            deviceType,
				 unsigned int   startBlk,	 /* starting block to write */
				 unsigned int   numBlks,	 /* number of blocks to write */
				 char *         pBuf			 /* pointer to buffer of send data */
				 ) ;

	int i2cDoOp (
                int             unit,
				UINT32          deviceAddress,		/* device I2C bus address */
				i2cCmdPckt_t *  pI2cCmdPacket		/* pointer to command packet */
				) ;

	unsigned int i2cAddressMunge (
								 unsigned int deviceAddress
								 );

	#ifdef __cplusplus
}
	#endif

#endif /* INCsysMotI2ch */