Home | History | Annotate | Line # | Download | only in linux
i2c.h revision 1.5.4.3
      1  1.5.4.2       tls /*	$NetBSD: i2c.h,v 1.5.4.3 2017/12/03 11:37:59 jdolecek Exp $	*/
      2  1.5.4.2       tls 
      3  1.5.4.2       tls /*-
      4  1.5.4.3  jdolecek  * Copyright (c) 2015 The NetBSD Foundation, Inc.
      5  1.5.4.2       tls  * All rights reserved.
      6  1.5.4.2       tls  *
      7  1.5.4.2       tls  * This code is derived from software contributed to The NetBSD Foundation
      8  1.5.4.2       tls  * by Taylor R. Campbell.
      9  1.5.4.2       tls  *
     10  1.5.4.2       tls  * Redistribution and use in source and binary forms, with or without
     11  1.5.4.2       tls  * modification, are permitted provided that the following conditions
     12  1.5.4.2       tls  * are met:
     13  1.5.4.2       tls  * 1. Redistributions of source code must retain the above copyright
     14  1.5.4.2       tls  *    notice, this list of conditions and the following disclaimer.
     15  1.5.4.2       tls  * 2. Redistributions in binary form must reproduce the above copyright
     16  1.5.4.2       tls  *    notice, this list of conditions and the following disclaimer in the
     17  1.5.4.2       tls  *    documentation and/or other materials provided with the distribution.
     18  1.5.4.2       tls  *
     19  1.5.4.2       tls  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     20  1.5.4.2       tls  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     21  1.5.4.2       tls  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     22  1.5.4.2       tls  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     23  1.5.4.2       tls  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     24  1.5.4.2       tls  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     25  1.5.4.2       tls  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     26  1.5.4.2       tls  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     27  1.5.4.2       tls  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     28  1.5.4.2       tls  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     29  1.5.4.2       tls  * POSSIBILITY OF SUCH DAMAGE.
     30  1.5.4.2       tls  */
     31  1.5.4.2       tls 
     32  1.5.4.2       tls #ifndef _LINUX_I2C_H_
     33  1.5.4.2       tls #define _LINUX_I2C_H_
     34  1.5.4.2       tls 
     35  1.5.4.2       tls #include <sys/types.h>
     36  1.5.4.2       tls #include <sys/device_if.h>
     37  1.5.4.2       tls #include <sys/queue.h>		/* XXX include order botch: i2cvar.h needs */
     38  1.5.4.3  jdolecek #include <sys/systm.h>
     39  1.5.4.2       tls 
     40  1.5.4.2       tls #include <dev/i2c/i2cvar.h>
     41  1.5.4.2       tls 
     42  1.5.4.3  jdolecek #include <linux/pm.h>
     43  1.5.4.3  jdolecek 
     44  1.5.4.2       tls struct i2c_adapter;
     45  1.5.4.2       tls struct i2c_algorithm;
     46  1.5.4.2       tls struct i2c_msg;
     47  1.5.4.2       tls 
     48  1.5.4.2       tls #define	I2C_NAME_SIZE	20
     49  1.5.4.2       tls 
     50  1.5.4.3  jdolecek /*
     51  1.5.4.3  jdolecek  * I2C_M_*: i2c_msg flags
     52  1.5.4.3  jdolecek  */
     53  1.5.4.3  jdolecek #define	I2C_M_RD		0x01 /* xfer is read, not write */
     54  1.5.4.3  jdolecek #define	I2C_M_NOSTART		0x02 /* don't initiate xfer */
     55  1.5.4.3  jdolecek #define	I2C_M_TEN		0x04 /* 10-bit chip address */
     56  1.5.4.2       tls 
     57  1.5.4.3  jdolecek /*
     58  1.5.4.3  jdolecek  * I2C_CLASS_*: i2c_adapter classes
     59  1.5.4.3  jdolecek  */
     60  1.5.4.3  jdolecek #define	I2C_CLASS_DDC	0x01
     61  1.5.4.2       tls 
     62  1.5.4.3  jdolecek /*
     63  1.5.4.3  jdolecek  * I2C_FUNC_*: i2c_adapter functionality bits
     64  1.5.4.3  jdolecek  */
     65  1.5.4.3  jdolecek #define	I2C_FUNC_I2C			0x01
     66  1.5.4.3  jdolecek #define	I2C_FUNC_NOSTART		0x02
     67  1.5.4.3  jdolecek #define	I2C_FUNC_SMBUS_EMUL		0x04
     68  1.5.4.3  jdolecek #define	I2C_FUNC_SMBUS_READ_BLOCK_DATA	0x08
     69  1.5.4.3  jdolecek #define	I2C_FUNC_SMBUS_BLOCK_PROC_CALL	0x10
     70  1.5.4.3  jdolecek #define	I2C_FUNC_10BIT_ADDR		0x20
     71  1.5.4.2       tls 
     72  1.5.4.3  jdolecek /*
     73  1.5.4.3  jdolecek  * struct i2c_msg: A single i2c message request on a particular
     74  1.5.4.3  jdolecek  * address.  Read if I2C_M_RD is set, write otherwise.
     75  1.5.4.3  jdolecek  */
     76  1.5.4.3  jdolecek struct i2c_msg {
     77  1.5.4.3  jdolecek 	i2c_addr_t	addr;
     78  1.5.4.3  jdolecek 	uint16_t	flags;	/* I2C_M_* */
     79  1.5.4.3  jdolecek 	uint16_t	len;
     80  1.5.4.3  jdolecek 	uint8_t		*buf;
     81  1.5.4.2       tls };
     82  1.5.4.2       tls 
     83  1.5.4.3  jdolecek /*
     84  1.5.4.3  jdolecek  * struct i2c_adapter: An i2c bus controller.
     85  1.5.4.3  jdolecek  */
     86  1.5.4.2       tls struct i2c_adapter {
     87  1.5.4.2       tls 	char		 		name[I2C_NAME_SIZE];
     88  1.5.4.2       tls 	const struct i2c_algorithm	*algo;
     89  1.5.4.2       tls 	void				*algo_data;
     90  1.5.4.2       tls 	int				retries;
     91  1.5.4.2       tls 	struct module			*owner;
     92  1.5.4.3  jdolecek 	unsigned int			class; /* I2C_CLASS_* */
     93  1.5.4.2       tls 	struct {
     94  1.5.4.2       tls 		device_t	parent;
     95  1.5.4.3  jdolecek 	}				dev;
     96  1.5.4.2       tls 	void				*i2ca_adapdata;
     97  1.5.4.2       tls };
     98  1.5.4.2       tls 
     99  1.5.4.3  jdolecek /*
    100  1.5.4.3  jdolecek  * struct i2c_algorithm: A procedure for transferring an i2c message on
    101  1.5.4.3  jdolecek  * an i2c bus, along with a set of flags describing its functionality.
    102  1.5.4.3  jdolecek  */
    103  1.5.4.3  jdolecek struct i2c_algorithm {
    104  1.5.4.3  jdolecek 	int		(*master_xfer)(struct i2c_adapter *, struct i2c_msg *,
    105  1.5.4.3  jdolecek 			    int);
    106  1.5.4.3  jdolecek 	uint32_t	(*functionality)(struct i2c_adapter *);
    107  1.5.4.3  jdolecek };
    108  1.5.4.3  jdolecek 
    109  1.5.4.3  jdolecek /*
    110  1.5.4.3  jdolecek  * struct i2c_board_info: Parameters to find an i2c bus and a slave on
    111  1.5.4.3  jdolecek  * it.  type is the name of an i2c driver; addr is the slave address;
    112  1.5.4.3  jdolecek  * platform_data is an extra parameter to pass to the i2c driver.
    113  1.5.4.3  jdolecek  */
    114  1.5.4.3  jdolecek struct i2c_board_info {
    115  1.5.4.3  jdolecek 	char			type[I2C_NAME_SIZE];
    116  1.5.4.3  jdolecek 	uint16_t		addr;
    117  1.5.4.3  jdolecek 	uint16_t		flags;
    118  1.5.4.3  jdolecek 	void			*platform_data;
    119  1.5.4.3  jdolecek };
    120  1.5.4.3  jdolecek 
    121  1.5.4.3  jdolecek #define	I2C_BOARD_INFO(board_type, board_addr)		\
    122  1.5.4.3  jdolecek 	.type = (board_type),				\
    123  1.5.4.3  jdolecek 	.addr = (board_addr)
    124  1.5.4.3  jdolecek 
    125  1.5.4.3  jdolecek /*
    126  1.5.4.3  jdolecek  * struct i2c_client: An i2c slave device at a particular address on a
    127  1.5.4.3  jdolecek  * particular bus.
    128  1.5.4.3  jdolecek  */
    129  1.5.4.3  jdolecek struct i2c_client {
    130  1.5.4.3  jdolecek 	struct i2c_adapter	*adapter;
    131  1.5.4.3  jdolecek 	uint16_t		addr;
    132  1.5.4.3  jdolecek 	uint16_t		flags;
    133  1.5.4.3  jdolecek };
    134  1.5.4.3  jdolecek 
    135  1.5.4.3  jdolecek /*
    136  1.5.4.3  jdolecek  * struct i2c_device_id: Device id naming a class of i2c slave devices
    137  1.5.4.3  jdolecek  * and parameters to the driver for the devices.
    138  1.5.4.3  jdolecek  */
    139  1.5.4.3  jdolecek struct i2c_device_id {
    140  1.5.4.3  jdolecek 	char		name[I2C_NAME_SIZE];
    141  1.5.4.3  jdolecek 	unsigned long	driver_data;
    142  1.5.4.3  jdolecek };
    143  1.5.4.3  jdolecek 
    144  1.5.4.3  jdolecek /*
    145  1.5.4.3  jdolecek  * struct i2c_driver: A driver for a class of i2c slave devices.  We
    146  1.5.4.3  jdolecek  * don't actually use this.
    147  1.5.4.3  jdolecek  */
    148  1.5.4.3  jdolecek struct i2c_driver {
    149  1.5.4.3  jdolecek 	int	(*probe)(struct i2c_client *, const struct i2c_device_id *);
    150  1.5.4.3  jdolecek 	int	(*remove)(struct i2c_client *);
    151  1.5.4.3  jdolecek 	struct {
    152  1.5.4.3  jdolecek 		char			name[I2C_NAME_SIZE];
    153  1.5.4.3  jdolecek 		const struct dev_pm_ops	pm;
    154  1.5.4.3  jdolecek 	}	driver;
    155  1.5.4.3  jdolecek };
    156  1.5.4.3  jdolecek 
    157  1.5.4.3  jdolecek /*
    158  1.5.4.3  jdolecek  * Adapter management.  We don't register these in a global database
    159  1.5.4.3  jdolecek  * like Linux, so these are just stubs.
    160  1.5.4.3  jdolecek  */
    161  1.5.4.2       tls static inline int
    162  1.5.4.2       tls i2c_add_adapter(struct i2c_adapter *adapter __unused)
    163  1.5.4.2       tls {
    164  1.5.4.3  jdolecek 
    165  1.5.4.2       tls 	return 0;
    166  1.5.4.2       tls }
    167  1.5.4.2       tls 
    168  1.5.4.2       tls static inline void
    169  1.5.4.2       tls i2c_del_adapter(struct i2c_adapter *adapter __unused)
    170  1.5.4.2       tls {
    171  1.5.4.2       tls }
    172  1.5.4.2       tls 
    173  1.5.4.2       tls static inline void *
    174  1.5.4.2       tls i2c_get_adapdata(const struct i2c_adapter *adapter)
    175  1.5.4.2       tls {
    176  1.5.4.2       tls 
    177  1.5.4.2       tls 	return adapter->i2ca_adapdata;
    178  1.5.4.2       tls }
    179  1.5.4.2       tls 
    180  1.5.4.2       tls static inline void
    181  1.5.4.2       tls i2c_set_adapdata(struct i2c_adapter *adapter, void *data)
    182  1.5.4.2       tls {
    183  1.5.4.2       tls 
    184  1.5.4.2       tls 	adapter->i2ca_adapdata = data;
    185  1.5.4.2       tls }
    186  1.5.4.2       tls 
    187  1.5.4.2       tls /* XXX Make the nm output a little more greppable...  */
    188  1.5.4.3  jdolecek #define	i2c_master_recv		linux_i2c_master_recv
    189  1.5.4.3  jdolecek #define	i2c_master_send		linux_i2c_master_send
    190  1.5.4.3  jdolecek #define	i2c_new_device		linux_i2c_new_device
    191  1.5.4.3  jdolecek #define	i2c_transfer		linux_i2c_transfer
    192  1.5.4.3  jdolecek #define	i2c_unregister_device	linux_i2c_unregister_device
    193  1.5.4.3  jdolecek 
    194  1.5.4.3  jdolecek int	i2c_master_send(const struct i2c_client *, const char *, int);
    195  1.5.4.3  jdolecek int	i2c_master_recv(const struct i2c_client *, char *, int);
    196  1.5.4.3  jdolecek struct i2c_client *
    197  1.5.4.3  jdolecek 	i2c_new_device(struct i2c_adapter *, const struct i2c_board_info *);
    198  1.5.4.2       tls int	i2c_transfer(struct i2c_adapter *, struct i2c_msg *, int);
    199  1.5.4.3  jdolecek void	i2c_unregister_device(struct i2c_client *);
    200  1.5.4.2       tls 
    201  1.5.4.2       tls #endif  /* _LINUX_I2C_H_ */
    202