twi_primitives.h

adi black fin chip connect to cmos sensor

/*****************************************************************************
*	TWI_primitives.h
*   
*	Copyright (c) 2007 Analog Devices, Inc.  All Rights Reserved.
*   This software is proprietary to Analog Devices, Inc. and its
*	licensors.
*  
* 	CHANGES:  10/24/2007  1.00  - initial public release
*
*	SOFTWARE: 	VisualDSP++ 5.0 August 2007 Update
* 
* 	HARDWARE: 	BF561 EZ-Kit Lite Board Rev 1.4
*				Micron MTV9022 or MTV9032 Sensor
*
*
*	8 / 16 - bit read write routines making use of I2C_BF561_asm routines
*
*	DESCRIPTION:
* 
*	This header defines functions that  will read/write a vector of 8 or 16-bit 
* 	values from/to a device, starting from an address.
*
* 
*	PARAMETERS:
*
*		addr_size_16:	false if addresses are 8-bit wide
*						true if addresses are 16-bit wide
*
*		data_size_16:	false if data values are 8-bit wide
*						true if data values are 16-bit wide
*
*		TWIBase_Addr:	base address (8-bit)
*
*		start_address:	register address of first value in vector 
*						(will be incremented for each value by the routines)
*
*		values:			pointer to first value in vector 
*						(vector is always 16-bit, in case of 8-bit values, 
*						use only lower bytes)
*
*		Num_Transactions: Number of values to be written/read
*	
*
* 	RETURN VALUE:
*
*		returns number of successful transactions. 
*		If less than Num_Transactions parameters, indicates an error.
******************************************************************************/


#define MAX_NUM_ENTRIES		(256)		// DO NOT set this bigger than 256!

// Prototypes
unsigned int I2C_Reg_Write(bool addr_size_16, bool data_size_16, unsigned char TWIBase_Addr, unsigned short start_address, unsigned short* values, int Num_Transactions);
unsigned int I2C_Reg_Read(bool addr_size_16, bool data_size_16, unsigned char TWIBase_Addr, unsigned short start_address, unsigned short* values, int Num_Transactions);