Home | History | Annotate | Line # | Download | only in i2c
gttwsi_core.c revision 1.4
      1 /*	$NetBSD: gttwsi_core.c,v 1.4 2018/05/03 02:08:52 jmcneill Exp $	*/
      2 /*
      3  * Copyright (c) 2008 Eiji Kawauchi.
      4  * All rights reserved.
      5  *
      6  * Redistribution and use in source and binary forms, with or without
      7  * modification, are permitted provided that the following conditions
      8  * are met:
      9  * 1. Redistributions of source code must retain the above copyright
     10  *    notice, this list of conditions and the following disclaimer.
     11  * 2. Redistributions in binary form must reproduce the above copyright
     12  *    notice, this list of conditions and the following disclaimer in the
     13  *    documentation and/or other materials provided with the distribution.
     14  * 3. All advertising materials mentioning features or use of this software
     15  *    must display the following acknowledgement:
     16  *      This product includes software developed for the NetBSD Project by
     17  *      Eiji Kawauchi.
     18  * 4. The name of the author may not be used to endorse or promote products
     19  *    derived from this software without specific prior written permission
     20  *
     21  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
     22  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
     23  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
     24  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
     25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
     26  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
     30  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     31  */
     32 /*
     33  * Copyright (c) 2005 Brocade Communcations, inc.
     34  * All rights reserved.
     35  *
     36  * Written by Matt Thomas for Brocade Communcations, Inc.
     37  *
     38  * Redistribution and use in source and binary forms, with or without
     39  * modification, are permitted provided that the following conditions
     40  * are met:
     41  * 1. Redistributions of source code must retain the above copyright
     42  *    notice, this list of conditions and the following disclaimer.
     43  * 2. Redistributions in binary form must reproduce the above copyright
     44  *    notice, this list of conditions and the following disclaimer in the
     45  *    documentation and/or other materials provided with the distribution.
     46  * 3. The name of Brocade Communications, Inc. may not be used to endorse
     47  *    or promote products derived from this software without specific prior
     48  *    written permission.
     49  *
     50  * THIS SOFTWARE IS PROVIDED BY BROCADE COMMUNICATIONS, INC. ``AS IS'' AND
     51  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     52  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     53  * ARE DISCLAIMED.  IN NO EVENT SHALL EITHER BROCADE COMMUNICATIONS, INC. BE
     54  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     55  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     56  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     57  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     58  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     59  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
     60  * OF THE POSSIBILITY OF SUCH DAMAGE.
     61  */
     62 //#define TWSI_DEBUG
     63 
     64 /*
     65  * Marvell Two-Wire Serial Interface (aka I2C) master driver
     66  */
     67 
     68 #include <sys/cdefs.h>
     69 __KERNEL_RCSID(0, "$NetBSD: gttwsi_core.c,v 1.4 2018/05/03 02:08:52 jmcneill Exp $");
     70 #include "locators.h"
     71 
     72 #include <sys/param.h>
     73 #include <sys/bus.h>
     74 #include <sys/condvar.h>
     75 #include <sys/device.h>
     76 #include <sys/errno.h>
     77 #include <sys/kernel.h>
     78 #include <sys/mutex.h>
     79 #include <sys/systm.h>
     80 
     81 #include <dev/i2c/i2cvar.h>
     82 
     83 #include <dev/i2c/gttwsireg.h>
     84 #include <dev/i2c/gttwsivar.h>
     85 
     86 static int	gttwsi_acquire_bus(void *, int);
     87 static void	gttwsi_release_bus(void *, int);
     88 static int	gttwsi_send_start(void *v, int flags);
     89 static int	gttwsi_send_stop(void *v, int flags);
     90 static int	gttwsi_initiate_xfer(void *v, i2c_addr_t addr, int flags);
     91 static int	gttwsi_read_byte(void *v, uint8_t *valp, int flags);
     92 static int	gttwsi_write_byte(void *v, uint8_t val, int flags);
     93 
     94 static int	gttwsi_wait(struct gttwsi_softc *, uint32_t, uint32_t, int);
     95 
     96 static inline uint32_t
     97 gttwsi_default_read_4(struct gttwsi_softc *sc, uint32_t reg)
     98 {
     99 	uint32_t val = bus_space_read_4(sc->sc_bust, sc->sc_bush, reg);
    100 #ifdef TWSI_DEBUG
    101 	printf("I2C:R:%02x:%02x\n", reg, val);
    102 #else
    103 	DELAY(TWSI_READ_DELAY);
    104 #endif
    105 	return val;
    106 }
    107 
    108 static inline void
    109 gttwsi_default_write_4(struct gttwsi_softc *sc, uint32_t reg, uint32_t val)
    110 {
    111 	bus_space_write_4(sc->sc_bust, sc->sc_bush, reg, val);
    112 #ifdef TWSI_DEBUG
    113 	printf("I2C:W:%02x:%02x\n", reg, val);
    114 #else
    115 	DELAY(TWSI_WRITE_DELAY);
    116 #endif
    117 	return;
    118 }
    119 
    120 static inline uint32_t
    121 gttwsi_read_4(struct gttwsi_softc *sc, uint32_t reg)
    122 {
    123 	return sc->sc_reg_read(sc, reg);
    124 }
    125 
    126 static inline void
    127 gttwsi_write_4(struct gttwsi_softc *sc, uint32_t reg, uint32_t val)
    128 {
    129 	return sc->sc_reg_write(sc, reg, val);
    130 }
    131 
    132 /* ARGSUSED */
    133 void
    134 gttwsi_attach_subr(device_t self, bus_space_tag_t iot, bus_space_handle_t ioh)
    135 {
    136 	struct gttwsi_softc * const sc = device_private(self);
    137 	prop_dictionary_t cfg = device_properties(self);
    138 
    139 	aprint_naive("\n");
    140 	aprint_normal(": Marvell TWSI controller\n");
    141 
    142 	sc->sc_dev = self;
    143 	sc->sc_bust = iot;
    144 	sc->sc_bush = ioh;
    145 
    146 	if (sc->sc_reg_read == NULL)
    147 		sc->sc_reg_read = gttwsi_default_read_4;
    148 	if (sc->sc_reg_write == NULL)
    149 		sc->sc_reg_write = gttwsi_default_write_4;
    150 
    151 	mutex_init(&sc->sc_buslock, MUTEX_DEFAULT, IPL_VM);
    152 	mutex_init(&sc->sc_mtx, MUTEX_DEFAULT, IPL_BIO);
    153 	cv_init(&sc->sc_cv, device_xname(self));
    154 
    155 	prop_dictionary_get_bool(cfg, "iflg-rwc", &sc->sc_iflg_rwc);
    156 
    157 	sc->sc_started = false;
    158 	sc->sc_i2c.ic_cookie = sc;
    159 	sc->sc_i2c.ic_acquire_bus = gttwsi_acquire_bus;
    160 	sc->sc_i2c.ic_release_bus = gttwsi_release_bus;
    161 	sc->sc_i2c.ic_exec = NULL;
    162 	sc->sc_i2c.ic_send_start = gttwsi_send_start;
    163 	sc->sc_i2c.ic_send_stop = gttwsi_send_stop;
    164 	sc->sc_i2c.ic_initiate_xfer = gttwsi_initiate_xfer;
    165 	sc->sc_i2c.ic_read_byte = gttwsi_read_byte;
    166 	sc->sc_i2c.ic_write_byte = gttwsi_write_byte;
    167 
    168 	/*
    169 	 * Put the controller into Soft Reset.
    170 	 */
    171 	/* reset */
    172 	gttwsi_write_4(sc, TWSI_SOFTRESET, SOFTRESET_VAL);
    173 
    174 }
    175 
    176 void
    177 gttwsi_config_children(device_t self)
    178 {
    179 	struct gttwsi_softc * const sc = device_private(self);
    180 	struct i2cbus_attach_args iba;
    181 
    182 	memset(&iba, 0, sizeof(iba));
    183 	iba.iba_tag = &sc->sc_i2c;
    184 
    185 	(void) config_found_ia(sc->sc_dev, "i2cbus", &iba, iicbus_print);
    186 }
    187 
    188 int
    189 gttwsi_intr(void *arg)
    190 {
    191 	struct gttwsi_softc *sc = arg;
    192 	uint32_t val;
    193 
    194 	val = gttwsi_read_4(sc, TWSI_CONTROL);
    195 	if (val & CONTROL_IFLG) {
    196 		gttwsi_write_4(sc, TWSI_CONTROL, val & ~CONTROL_INTEN);
    197 		mutex_enter(&sc->sc_mtx);
    198 		cv_signal(&sc->sc_cv);
    199 		mutex_exit(&sc->sc_mtx);
    200 
    201 		return 1;	/* handled */
    202 	}
    203 	return 0;
    204 }
    205 
    206 /* ARGSUSED */
    207 static int
    208 gttwsi_acquire_bus(void *arg, int flags)
    209 {
    210 	struct gttwsi_softc *sc = arg;
    211 
    212 	mutex_enter(&sc->sc_buslock);
    213 	return 0;
    214 }
    215 
    216 /* ARGSUSED */
    217 static void
    218 gttwsi_release_bus(void *arg, int flags)
    219 {
    220 	struct gttwsi_softc *sc = arg;
    221 
    222 	mutex_exit(&sc->sc_buslock);
    223 }
    224 
    225 static int
    226 gttwsi_send_start(void *v, int flags)
    227 {
    228 	struct gttwsi_softc *sc = v;
    229 	int expect;
    230 
    231 	KASSERT(mutex_owned(&sc->sc_buslock));
    232 
    233 	if (sc->sc_started)
    234 		expect = STAT_RSCT;
    235 	else
    236 		expect = STAT_SCT;
    237 	sc->sc_started = true;
    238 	return gttwsi_wait(sc, CONTROL_START, expect, flags);
    239 }
    240 
    241 static int
    242 gttwsi_send_stop(void *v, int flags)
    243 {
    244 	struct gttwsi_softc *sc = v;
    245 	int retry = TWSI_RETRY_COUNT;
    246 	uint32_t control;
    247 
    248 	KASSERT(mutex_owned(&sc->sc_buslock));
    249 
    250 	sc->sc_started = false;
    251 
    252 	/* Interrupt is not generated for STAT_NRS. */
    253 	control = CONTROL_STOP | CONTROL_TWSIEN;
    254 	if (sc->sc_iflg_rwc)
    255 		control |= CONTROL_IFLG;
    256 	gttwsi_write_4(sc, TWSI_CONTROL, control);
    257 	while (retry > 0) {
    258 		if (gttwsi_read_4(sc, TWSI_STATUS) == STAT_NRS)
    259 			return 0;
    260 		retry--;
    261 		DELAY(TWSI_STAT_DELAY);
    262 	}
    263 
    264 	aprint_error_dev(sc->sc_dev, "send STOP failed\n");
    265 	return -1;
    266 }
    267 
    268 static int
    269 gttwsi_initiate_xfer(void *v, i2c_addr_t addr, int flags)
    270 {
    271 	struct gttwsi_softc *sc = v;
    272 	uint32_t data, expect;
    273 	int error, read;
    274 
    275 	KASSERT(mutex_owned(&sc->sc_buslock));
    276 
    277 	gttwsi_send_start(v, flags);
    278 
    279 	read = (flags & I2C_F_READ) != 0;
    280 	if (read)
    281 		expect = STAT_ARBT_AR;
    282 	else
    283 		expect = STAT_AWBT_AR;
    284 
    285 	/*
    286 	 * First byte contains whether this xfer is a read or write.
    287 	 */
    288 	data = read;
    289 	if (addr > 0x7f) {
    290 		/*
    291 		 * If this is a 10bit request, the first address byte is
    292 		 * 0b11110<b9><b8><r/w>.
    293 		 */
    294 		data |= 0xf0 | ((addr & 0x300) >> 7);
    295 		gttwsi_write_4(sc, TWSI_DATA, data);
    296 		error = gttwsi_wait(sc, 0, expect, flags);
    297 		if (error)
    298 			return error;
    299 		/*
    300 		 * The first address byte has been sent, now to send
    301 		 * the second one.
    302 		 */
    303 		if (read)
    304 			expect = STAT_SARBT_AR;
    305 		else
    306 			expect = STAT_SAWBT_AR;
    307 		data = (uint8_t)addr;
    308 	} else
    309 		data |= (addr << 1);
    310 
    311 	gttwsi_write_4(sc, TWSI_DATA, data);
    312 	return gttwsi_wait(sc, 0, expect, flags);
    313 }
    314 
    315 static int
    316 gttwsi_read_byte(void *v, uint8_t *valp, int flags)
    317 {
    318 	struct gttwsi_softc *sc = v;
    319 	int error;
    320 
    321 	KASSERT(mutex_owned(&sc->sc_buslock));
    322 
    323 	if (flags & I2C_F_LAST)
    324 		error = gttwsi_wait(sc, 0, STAT_MRRD_ANT, flags);
    325 	else
    326 		error = gttwsi_wait(sc, CONTROL_ACK, STAT_MRRD_AT, flags);
    327 	if (!error)
    328 		*valp = gttwsi_read_4(sc, TWSI_DATA);
    329 	if ((flags & (I2C_F_LAST | I2C_F_STOP)) == (I2C_F_LAST | I2C_F_STOP))
    330 		error = gttwsi_send_stop(sc, flags);
    331 	return error;
    332 }
    333 
    334 static int
    335 gttwsi_write_byte(void *v, uint8_t val, int flags)
    336 {
    337 	struct gttwsi_softc *sc = v;
    338 	int error;
    339 
    340 	KASSERT(mutex_owned(&sc->sc_buslock));
    341 
    342 	gttwsi_write_4(sc, TWSI_DATA, val);
    343 	error = gttwsi_wait(sc, 0, STAT_MTDB_AR, flags);
    344 	if (flags & I2C_F_STOP)
    345 		gttwsi_send_stop(sc, flags);
    346 	return error;
    347 }
    348 
    349 static int
    350 gttwsi_wait(struct gttwsi_softc *sc, uint32_t control, uint32_t expect,
    351 	    int flags)
    352 {
    353 	uint32_t status;
    354 	int timo, error = 0;
    355 
    356 	KASSERT(mutex_owned(&sc->sc_buslock));
    357 
    358 	DELAY(5);
    359 	if (!(flags & I2C_F_POLL))
    360 		control |= CONTROL_INTEN;
    361 	if (sc->sc_iflg_rwc)
    362 		control |= CONTROL_IFLG;
    363 	gttwsi_write_4(sc, TWSI_CONTROL, control | CONTROL_TWSIEN);
    364 
    365 	timo = 0;
    366 	for (;;) {
    367 		control = gttwsi_read_4(sc, TWSI_CONTROL);
    368 		if (control & CONTROL_IFLG)
    369 			break;
    370 		if (!(flags & I2C_F_POLL)) {
    371 			mutex_enter(&sc->sc_mtx);
    372 			error = cv_timedwait_sig(&sc->sc_cv, &sc->sc_mtx, hz);
    373 			mutex_exit(&sc->sc_mtx);
    374 			if (error)
    375 				return error;
    376 		}
    377 		DELAY(TWSI_RETRY_DELAY);
    378 		if (timo++ > 1000000)	/* 1sec */
    379 			break;
    380 	}
    381 
    382 	status = gttwsi_read_4(sc, TWSI_STATUS);
    383 	if (status != expect) {
    384 		aprint_error_dev(sc->sc_dev,
    385 		    "unexpected status 0x%x: expect 0x%x\n", status, expect);
    386 		return EIO;
    387 	}
    388 	return error;
    389 }
    390