Subversion Repositories Kolibri OS

/* ------------------------------------------------------------------------- */

/*									     */

/* i2c.h - definitions for the i2c-bus interface			     */

/*									     */

/* ------------------------------------------------------------------------- */

/*   Copyright (C) 1995-2000 Simon G. Vogl

    This program is free software; you can redistribute it and/or modify

    it under the terms of the GNU General Public License as published by

    the Free Software Foundation; either version 2 of the License, or

    (at your option) any later version.

    This program is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License

    along with this program; if not, write to the Free Software

    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.		     */

/* ------------------------------------------------------------------------- */

/* With some changes from Kyösti Mälkki  and

   Frodo Looijaard  */

#ifndef _LINUX_I2C_H

#define _LINUX_I2C_H

#include 

#ifdef __KERNEL__

#include 

#include 

#include 

/* --- General options ------------------------------------------------	*/

struct i2c_msg;

struct i2c_algorithm;

struct i2c_adapter;

struct i2c_client;

struct i2c_driver;

union i2c_smbus_data;

struct i2c_board_info;

/* Transfer num messages.

 */

extern int i2c_transfer(struct i2c_adapter *adap, struct i2c_msg *msgs,

			int num);

/**

 * struct i2c_driver - represent an I2C device driver

 * @class: What kind of i2c device we instantiate (for detect)

 * @attach_adapter: Callback for bus addition (for legacy drivers)

 * @detach_adapter: Callback for bus removal (for legacy drivers)

 * @probe: Callback for device binding

 * @remove: Callback for device unbinding

 * @shutdown: Callback for device shutdown

 * @suspend: Callback for device suspend

 * @resume: Callback for device resume

 * @alert: Alert callback, for example for the SMBus alert protocol

 * @command: Callback for bus-wide signaling (optional)

 * @driver: Device driver model driver

 * @id_table: List of I2C devices supported by this driver

 * @detect: Callback for device detection

 * @address_list: The I2C addresses to probe (for detect)

 * @clients: List of detected clients we created (for i2c-core use only)

 *

 * The driver.owner field should be set to the module owner of this driver.

 * The driver.name field should be set to the name of this driver.

 *

 * For automatic device detection, both @detect and @address_data must

 * be defined. @class should also be set, otherwise only devices forced

 * with module parameters will be created. The detect function must

 * fill at least the name field of the i2c_board_info structure it is

 * handed upon successful detection, and possibly also the flags field.

 *

 * If @detect is missing, the driver will still work fine for enumerated

 * devices. Detected devices simply won't be supported. This is expected

 * for the many I2C/SMBus devices which can't be detected reliably, and

 * the ones which can always be enumerated in practice.

 *

 * The i2c_client structure which is handed to the @detect callback is

 * not a real i2c_client. It is initialized just enough so that you can

 * call i2c_smbus_read_byte_data and friends on it. Don't do anything

 * else with it. In particular, calling dev_dbg and friends on it is

 * not allowed.

 */

struct i2c_driver {

	unsigned int class;

	/* Notifies the driver that a new bus has appeared or is about to be

	 * removed. You should avoid using this, it will be removed in a

	 * near future.

	 */

	int (*attach_adapter)(struct i2c_adapter *);

	int (*detach_adapter)(struct i2c_adapter *);

	/* Standard driver model interfaces */

	int (*probe)(struct i2c_client *, const struct i2c_device_id *);

	int (*remove)(struct i2c_client *);

	/* driver model interfaces that don't relate to enumeration  */

	void (*shutdown)(struct i2c_client *);

//	int (*suspend)(struct i2c_client *, pm_message_t mesg);

	int (*resume)(struct i2c_client *);

	/* Alert callback, for example for the SMBus alert protocol.

	 * The format and meaning of the data value depends on the protocol.

	 * For the SMBus alert protocol, there is a single bit of data passed

	 * as the alert response's low bit ("event flag").

	 */

	void (*alert)(struct i2c_client *, unsigned int data);

	/* a ioctl like command that can be used to perform specific functions

	 * with the device.

	 */

	int (*command)(struct i2c_client *client, unsigned int cmd, void *arg);

//	struct device_driver driver;

	const struct i2c_device_id *id_table;

	/* Device detection callback for automatic device creation */

//	int (*detect)(struct i2c_client *, struct i2c_board_info *);

	const unsigned short *address_list;

	struct list_head clients;

};

#define to_i2c_driver(d) container_of(d, struct i2c_driver, driver)

/**

 * struct i2c_client - represent an I2C slave device

 * @flags: I2C_CLIENT_TEN indicates the device uses a ten bit chip address;

 *	I2C_CLIENT_PEC indicates it uses SMBus Packet Error Checking

 * @addr: Address used on the I2C bus connected to the parent adapter.

 * @name: Indicates the type of the device, usually a chip name that's

 *	generic enough to hide second-sourcing and compatible revisions.

 * @adapter: manages the bus segment hosting this I2C device

 * @driver: device's driver, hence pointer to access routines

 * @dev: Driver model device node for the slave.

 * @irq: indicates the IRQ generated by this device (if any)

 * @detected: member of an i2c_driver.clients list or i2c-core's

 *	userspace_devices list

 *

 * An i2c_client identifies a single device (i.e. chip) connected to an

 * i2c bus. The behaviour exposed to Linux is defined by the driver

 * managing the device.

 */

struct i2c_client {

	unsigned short flags;		/* div., see below		*/

	unsigned short addr;		/* chip address - NOTE: 7bit	*/

					/* addresses are stored in the	*/

					/* _LOWER_ 7 bits		*/

	char name[I2C_NAME_SIZE];

	struct i2c_adapter *adapter;	/* the adapter we sit on	*/

    struct i2c_driver *driver;      /* and our access routines      */

	struct device dev;		/* the device structure		*/

	int irq;			/* irq issued by device		*/

	struct list_head detected;

};

#define to_i2c_client(d) container_of(d, struct i2c_client, dev)

extern struct i2c_client *i2c_verify_client(struct device *dev);

/**

 * struct i2c_board_info - template for device creation

 * @type: chip type, to initialize i2c_client.name

 * @flags: to initialize i2c_client.flags

 * @addr: stored in i2c_client.addr

 * @platform_data: stored in i2c_client.dev.platform_data

 * @archdata: copied into i2c_client.dev.archdata

 * @of_node: pointer to OpenFirmware device node

 * @irq: stored in i2c_client.irq

 *

 * I2C doesn't actually support hardware probing, although controllers and

 * devices may be able to use I2C_SMBUS_QUICK to tell whether or not there's

 * a device at a given address.  Drivers commonly need more information than

 * that, such as chip type, configuration, associated IRQ, and so on.

 *

 * i2c_board_info is used to build tables of information listing I2C devices

 * that are present.  This information is used to grow the driver model tree.

 * For mainboards this is done statically using i2c_register_board_info();

 * bus numbers identify adapters that aren't yet available.  For add-on boards,

 * i2c_new_device() does this dynamically with the adapter already known.

 */

struct i2c_board_info {

	char		type[I2C_NAME_SIZE];

	unsigned short	flags;

	unsigned short	addr;

	void		*platform_data;

	struct dev_archdata	*archdata;

#ifdef CONFIG_OF

	struct device_node *of_node;

#endif

	int		irq;

};

/**

 * I2C_BOARD_INFO - macro used to list an i2c device and its address

 * @dev_type: identifies the device type

 * @dev_addr: the device's address on the bus.

 *

 * This macro initializes essential fields of a struct i2c_board_info,

 * declaring what has been provided on a particular board.  Optional

 * fields (such as associated irq, or device-specific platform_data)

 * are provided using conventional syntax.

 */

#define I2C_BOARD_INFO(dev_type, dev_addr) \

	.type = dev_type, .addr = (dev_addr)

/*

 * The following structs are for those who like to implement new bus drivers:

 * i2c_algorithm is the interface to a class of hardware solutions which can

 * be addressed using the same bus algorithms - i.e. bit-banging or the PCF8584

 * to name two of the most common.

 */

struct i2c_algorithm {

	/* If an adapter algorithm can't do I2C-level access, set master_xfer

	   to NULL. If an adapter algorithm can do SMBus access, set

	   smbus_xfer. If set to NULL, the SMBus protocol is simulated

	   using common I2C messages */

	/* master_xfer should return the number of messages successfully

	   processed, or a negative value on error */

	int (*master_xfer)(struct i2c_adapter *adap, struct i2c_msg *msgs,

			   int num);

	int (*smbus_xfer) (struct i2c_adapter *adap, u16 addr,

			   unsigned short flags, char read_write,

			   u8 command, int size, union i2c_smbus_data *data);

	/* To determine what the adapter supports */

	u32 (*functionality) (struct i2c_adapter *);

};

/*

 * i2c_adapter is the structure used to identify a physical i2c bus along

 * with the access algorithms necessary to access it.

 */

struct i2c_adapter {

	struct module *owner;