
/*
 * Copyright (c) 1999-2000 by Sun Microsystems, Inc.
 * All rights reserved.
 */

#ifndef _I2C_SVC_H
#define	_I2C_SVC_H

#pragma ident	"@(#)i2c_svc.h	1.1	00/01/03 SMI"

#ifdef	__cplusplus
extern "C" {
#endif

/*
 * I2C interface return values
 */
#define	I2C_SUCCESS	0
#define	I2C_FAILURE	-1
#define	I2C_INCOMPLETE  -2

/*
 * Used for flags in i2c_transfer_alloc()
 */
#define	I2C_SLEEP	0x01
#define	I2C_NOSLEEP	0x02

/*
 * Version for i2c_transfer_t.i2c_version
 */
#define	I2C_XFER_REV	0

/*
 * Version for i2c_svc_t.i2c_nexus_version
 */
#define	I2C_NEXUS_REV	0


/*
 * Valid transfer flags for i2c_transfer.flags
 */
#define	I2C_WR		0x01	/* write */
#define	I2C_RD		0x02	/* read */
#define	I2C_WR_RD	0x04	/* write then read */

/*
 * Developer's note: i2c_transfer_copyout is sensitive to
 * the ordering of i2c_transfer structure fields.  If any fields
 * are changed, make sure to review i2c_transfer_copyout for
 * possible changes.
 *
 * Fields prefixed with 'I' are input fields passed to the
 * i2c_transfer function, while those prefixed with 'O'
 * are returned from the transfer function.
 */
typedef struct i2c_transfer {
	uint16_t		i2c_version; /* I: Set to I2C_XFER_REV_0 */
	uchar_t			*i2c_wbuf;   /* I: pointer to write buffer */
	uchar_t			*i2c_rbuf;   /* I: pointer to read buffer */
	int			i2c_flags;   /* I: description of transfer */
	uint16_t		i2c_wlen;    /* I: length of write buffer */
	uint16_t		i2c_rlen;    /* I: length of read buffer */
	uint16_t		i2c_w_resid; /* O: bytes not written */
	uint16_t		i2c_r_resid; /* O: bytes not read */
	int16_t			i2c_result;  /* O: return value */
} i2c_transfer_t;

typedef struct i2c_client_hdl *i2c_client_hdl_t;

/*
 * i2c_nexus_reg is passed to the I2C services module
 * through the i2c_nexus_register() interface by the nexus
 * driver.  It contains a version plus the pointer to
 * the functions that I2C services calls.
 */
typedef struct i2c_nexus_reg {
	int	i2c_nexus_version; /* set to I2C_NEXUS_REV_0 */
	int	(*i2c_nexus_transfer)(dev_info_t *dip, struct i2c_transfer *);
} i2c_nexus_reg_t;

/*
 * Interfaces for I2C client drivers
 */
int i2c_client_register(dev_info_t *dip, i2c_client_hdl_t *i2c_hdl);
void i2c_client_unregister(i2c_client_hdl_t i2c_hdl);
int i2c_transfer(i2c_client_hdl_t i2c_hdl, i2c_transfer_t *i2c_tran);
int i2c_transfer_alloc(i2c_client_hdl_t i2c_hdl,
			i2c_transfer_t **i2c,
			uint16_t wlen,
			uint16_t rlen,
			uint_t flags);
void i2c_transfer_free(i2c_client_hdl_t i2c_hdl, i2c_transfer_t *i2c);

/*
 * Interfaces for I2C nexus drivers
 */
void i2c_nexus_register(dev_info_t *dip, i2c_nexus_reg_t *nexus_reg);
void i2c_nexus_unregister(dev_info_t *dip);

#ifdef	__cplusplus
}
#endif

#endif /* _I2C_SVC_H */
