Home | History | Annotate | Line # | Download | only in ic
pcf8584.c revision 1.1
      1 /*	$NetBSD: pcf8584.c,v 1.1 2007/04/14 19:33:29 tnn Exp $ */
      2 
      3 /*-
      4  * Copyright (c) 2007 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Tobias Nygren.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  * 3. All advertising materials mentioning features or use of this software
     19  *    must display the following acknowledgement:
     20  *        This product includes software developed by the NetBSD
     21  *        Foundation, Inc. and its contributors.
     22  * 4. Neither the name of The NetBSD Foundation nor the names of its
     23  *    contributors may be used to endorse or promote products derived
     24  *    from this software without specific prior written permission.
     25  *
     26  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     27  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     28  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     29  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     30  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     32  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     33  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     34  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     35  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     36  * POSSIBILITY OF SUCH DAMAGE.
     37  */
     38 
     39 /*
     40  * Philips PCF8584 I2C Bus Controller
     41  *
     42  * This driver does not yet support multi-master arbitration, concurrent access
     43  * or interrupts, but it should be usable for single-master applications.
     44  * It is currently used by the envctrl(4) driver on sparc64.
     45  */
     46 
     47 #include <sys/cdefs.h>
     48 __KERNEL_RCSID(0, "$NetBSD: pcf8584.c,v 1.1 2007/04/14 19:33:29 tnn Exp $");
     49 
     50 #include <sys/param.h>
     51 #include <sys/device.h>
     52 #include <sys/kernel.h>
     53 #include <sys/systm.h>
     54 #include <sys/condvar.h>
     55 #include <sys/mutex.h>
     56 #include <machine/bus.h>
     57 #include <machine/param.h>
     58 #include <dev/i2c/i2cvar.h>
     59 #include <dev/ic/pcf8584reg.h>
     60 #include <dev/ic/pcf8584var.h>
     61 
     62 static void pcf8584_bus_reset(struct pcf8584_handle *, int);
     63 static int pcf8584_exec(void *, i2c_op_t, i2c_addr_t, const void *, size_t,
     64 			void *, size_t, int);
     65 static int pcf8584_acquire_bus(void *, int);
     66 static void pcf8584_release_bus(void *, int);
     67 static void pcf8584_wait(struct pcf8584_handle *, int);
     68 
     69 /*  Must delay for 500 ns between bus accesses according to manual. */
     70 #define DATA_W(x) (DELAY(1), bus_space_write_1(ha->ha_iot, ha->ha_ioh, 0, x))
     71 #define DATA_R() (DELAY(1), bus_space_read_1(ha->ha_iot, ha->ha_ioh, 0))
     72 #define CSR_W(x) (DELAY(1), bus_space_write_1(ha->ha_iot, ha->ha_ioh, 1, x))
     73 #define STATUS_R() (DELAY(1), bus_space_read_1(ha->ha_iot, ha->ha_ioh, 1))
     74 #define BUSY() ((STATUS_R() & PCF8584_STATUS_BBN) == 0)
     75 #define PENDING() ((STATUS_R() & PCF8584_STATUS_PIN) == 0)
     76 #define NAK() ((STATUS_R() & PCF8584_STATUS_LRB) != 0)
     77 
     78 /*
     79  * Wait for an interrupt.
     80  */
     81 static void
     82 pcf8584_wait(struct pcf8584_handle *ha, int flags)
     83 {
     84 	int timeo;
     85 
     86 	if (flags & I2C_F_POLL) {
     87 		timeo = 20;
     88 		while (timeo && !PENDING()) {
     89 			DELAY(1000);
     90 			timeo--;
     91 		}
     92 	} else {
     93 		mutex_enter(&ha->ha_intrmtx);
     94 		cv_timedwait(&ha->ha_intrcond, &ha->ha_intrmtx, mstohz(20));
     95 		mutex_exit(&ha->ha_intrmtx);
     96 	}
     97 }
     98 
     99 #ifdef notyet
    100 static void
    101 pcf8584_intr(struct pcf8584_handle *ha) {
    102 
    103 	cv_wakeup(&ha->ha_intrcond);
    104 }
    105 #endif
    106 
    107 int
    108 pcf8584_init(struct pcf8584_handle *ha)
    109 {
    110 
    111 	ha->ha_i2c.ic_cookie = ha;
    112 	ha->ha_i2c.ic_acquire_bus = pcf8584_acquire_bus;
    113 	ha->ha_i2c.ic_release_bus = pcf8584_release_bus;
    114 	ha->ha_i2c.ic_exec = pcf8584_exec;
    115 
    116 	mutex_init(&ha->ha_intrmtx, MUTEX_DEFAULT, IPL_NONE);
    117 	cv_init(&ha->ha_intrcond, "pcf8584");
    118 
    119 	pcf8584_bus_reset(ha, I2C_F_POLL);
    120 
    121 	return 0;
    122 }
    123 
    124 /*
    125  * Reset i2c bus.
    126  */
    127 static void
    128 pcf8584_bus_reset(struct pcf8584_handle *ha, int flags)
    129 {
    130 
    131 	/* initialize PCF8584 */
    132 	CSR_W(PCF8584_CTRL_PIN);
    133 	DATA_W(0x55);
    134 	CSR_W(PCF8584_CTRL_PIN | PCF8584_REG_S2);
    135 	DATA_W(PCF8584_CLK_12 | PCF8584_SCL_90);
    136 	CSR_W(PCF8584_CTRL_PIN | PCF8584_CTRL_ESO | PCF8584_CTRL_ACK);
    137 
    138 	/* XXX needs multi-master synchronization delay here */
    139 
    140 	/*
    141 	 * Blindly attempt a write at a nonexistent i2c address (0x7F).
    142 	 * This allows hung i2c devices to pick up the stop condition.
    143 	 */
    144 	DATA_W(0x7F << 1);
    145 	CSR_W(PCF8584_CMD_START);
    146 	pcf8584_wait(ha, flags);
    147 	CSR_W(PCF8584_CMD_STOP);
    148 	pcf8584_wait(ha, flags);
    149 }
    150 
    151 static int
    152 pcf8584_exec(void *cookie, i2c_op_t op, i2c_addr_t addr,
    153     const void *cmdbuf, size_t cmdlen, void *buf,
    154     size_t len, int flags)
    155 {
    156 	int i;
    157 	struct pcf8584_handle *ha = cookie;
    158 	uint8_t *p = buf;
    159 
    160 	KASSERT(cmdlen == 0);
    161 	KASSERT(op == I2C_OP_READ_WITH_STOP || op == I2C_OP_WRITE_WITH_STOP);
    162 
    163 	if (BUSY()) {
    164 		/* We're the only master on the bus, something is wrong. */
    165 		printf("*%s: i2c bus busy!\n", ha->ha_parent->dv_xname);
    166 		pcf8584_bus_reset(ha, flags);
    167 	}
    168 	if (op == I2C_OP_READ_WITH_STOP)
    169 		DATA_W((addr << 1) | 1);
    170 	else
    171 		DATA_W(addr << 1);
    172 
    173 	CSR_W(PCF8584_CMD_START);
    174 	pcf8584_wait(ha, flags);
    175 	if (!PENDING()) {
    176 		printf("%s: no intr after i2c sla\n", ha->ha_parent->dv_xname);
    177 	}
    178 	if (NAK())
    179 		goto fail;
    180 
    181 	if (op == I2C_OP_READ_WITH_STOP) {
    182 		(void) DATA_R();/* dummy read */
    183 		for (i = 0; i < len; i++) {
    184 			/* wait for a byte to arrive */
    185 			pcf8584_wait(ha, flags);
    186 			if (!PENDING()) {
    187 				printf("%s: lost intr during i2c read\n",
    188 				    ha->ha_parent->dv_xname);
    189 				goto fail;
    190 			}
    191 			if (NAK())
    192 				goto fail;
    193 			if (i == len - 1) {
    194 				/*
    195 				 * we're about to read the final byte, so we
    196 				 * set the controller to NAK the following
    197 				 * byte, if any.
    198 				 */
    199 				CSR_W(PCF8584_CMD_NAK);
    200 			}
    201 			*p++ = DATA_R();
    202 		}
    203 		pcf8584_wait(ha, flags);
    204 		if (!PENDING()) {
    205 			printf("%s: no intr on final i2c nak\n",
    206 			    ha->ha_parent->dv_xname);
    207 			goto fail;
    208 		}
    209 		CSR_W(PCF8584_CMD_STOP);
    210 		(void) DATA_R();/* dummy read */
    211 	} else {
    212 		for (i = 0; i < len; i++) {
    213 			DATA_W(*p++);
    214 			pcf8584_wait(ha, flags);
    215 			if (!PENDING()) {
    216 				printf("%s: no intr during i2c write\n",
    217 				    ha->ha_parent->dv_xname);
    218 				goto fail;
    219 			}
    220 			if (NAK())
    221 				goto fail;
    222 		}
    223 		CSR_W(PCF8584_CMD_STOP);
    224 	}
    225 	pcf8584_wait(ha, flags);
    226 	return 0;
    227 fail:
    228 	CSR_W(PCF8584_CMD_STOP);
    229 	pcf8584_wait(ha, flags);
    230 
    231 	return 1;
    232 }
    233 
    234 static int
    235 pcf8584_acquire_bus(void *cookie, int flags)
    236 {
    237 
    238 	/* XXX concurrent access not yet implemented */
    239 	return 0;
    240 }
    241 
    242 static void
    243 pcf8584_release_bus(void *cookie, int flags)
    244 {
    245 
    246 }
    247