1 /*        $NetBSD: iopi2c.c,v 1.11 2021/08/07 16:18:46 thorpej Exp $  */
2 
3 /*
4  * Copyright (c) 2003 Wasabi Systems, Inc.
5  * All rights reserved.
6  *
7  * Written by Jason R. Thorpe for Wasabi Systems, Inc.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  * 3. All advertising materials mentioning features or use of this software
18  *    must display the following acknowledgement:
19  *        This product includes software developed for the NetBSD Project by
20  *        Wasabi Systems, Inc.
21  * 4. The name of Wasabi Systems, Inc. may not be used to endorse
22  *    or promote products derived from this software without specific prior
23  *    written permission.
24  *
25  * THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND
26  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL WASABI SYSTEMS, INC
29  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35  * POSSIBILITY OF SUCH DAMAGE.
36  */
37 
38 /*
39  * Intel i80321 I/O Processor I2C Controller Unit support.
40  */
41 
42 #include <sys/cdefs.h>
43 __KERNEL_RCSID(0, "$NetBSD: iopi2c.c,v 1.11 2021/08/07 16:18:46 thorpej Exp $");
44 
45 #include <sys/param.h>
46 #include <sys/mutex.h>
47 #include <sys/systm.h>
48 #include <sys/device.h>
49 #include <sys/kernel.h>
50 
51 #include <sys/bus.h>
52 #include <machine/intr.h>
53 
54 #include <dev/i2c/i2cvar.h>
55 
56 #include <arm/xscale/iopi2creg.h>
57 #include <arm/xscale/iopi2cvar.h>
58 
59 static int iopiic_send_start(void *, int);
60 static int iopiic_send_stop(void *, int);
61 static int iopiic_initiate_xfer(void *, uint16_t, int);
62 static int iopiic_read_byte(void *, uint8_t *, int);
63 static int iopiic_write_byte(void *, uint8_t, int);
64 
65 void
iopiic_attach(struct iopiic_softc * sc)66 iopiic_attach(struct iopiic_softc *sc)
67 {
68           struct i2cbus_attach_args iba;
69 
70           iic_tag_init(&sc->sc_i2c);
71           sc->sc_i2c.ic_cookie = sc;
72           sc->sc_i2c.ic_send_start = iopiic_send_start;
73           sc->sc_i2c.ic_send_stop = iopiic_send_stop;
74           sc->sc_i2c.ic_initiate_xfer = iopiic_initiate_xfer;
75           sc->sc_i2c.ic_read_byte = iopiic_read_byte;
76           sc->sc_i2c.ic_write_byte = iopiic_write_byte;
77 
78           memset(&iba, 0, sizeof(iba));
79           iba.iba_tag = &sc->sc_i2c;
80           config_found(sc->sc_dev, &iba, iicbus_print, CFARGS_NONE);
81 }
82 
83 #define   IOPIIC_TIMEOUT                100       /* protocol timeout, in uSecs */
84 
85 static int
iopiic_wait(struct iopiic_softc * sc,int bit,int flags)86 iopiic_wait(struct iopiic_softc *sc, int bit, int flags)
87 {
88           uint32_t isr;
89           int timeout, error=0;
90 
91           /* XXX We never sleep, we always poll.  Fix me. */
92 
93           /*
94            * For some reason, we seem to run into problems if we poll
95            * the ISR while the transfer is in progress--at least on the
96            * i80312.  The condition that we're looking for never seems
97            * to appear on a read, and it's not clear why; perhaps reads
98            * of the I2C register file interfere with its proper operation?
99            * For now, just delay for a while up front.
100            *
101            * We _really_ need this to be interrupt-driven, but a problem
102            * with that is that the i80312 has no way to mask interrupts...
103            * So we need to deal with that.  For DMA and AAU, too, for that
104            * matter.
105            * Note that delay(100) doesn't quite work on the npwr w/ m41t00.
106            */
107           delay(110);
108           for (timeout = IOPIIC_TIMEOUT; timeout != 0; timeout--) {
109                     isr = bus_space_read_4(sc->sc_st, sc->sc_sh, IIC_ISR);
110                     if (isr & (bit | IIC_ISR_BED))
111                               break;
112                     delay(1);
113           }
114 
115           if (isr & (IIC_ISR_BED | (bit & IIC_ISR_ALD)))
116                     error = EIO;
117           else if (isr & (bit & ~IIC_ISR_ALD))
118                     error = 0;
119           else
120                     error = ETIMEDOUT;
121 
122           if (error)
123                     device_printf(sc->sc_dev,
124                         "iopiic_wait, (%08x) error %d: ISR = 0x%08x\n",
125                         bit, error, isr);
126 
127           /*
128            * The IIC_ISR is Read/Clear apart from the bottom 4 bits, which are
129            * read-only. So simply write back our copy of the ISR to clear any
130            * latched status.
131            */
132           bus_space_write_4(sc->sc_st, sc->sc_sh, IIC_ISR, isr);
133 
134           return (error);
135 }
136 
137 static int
iopiic_send_start(void * cookie,int flags)138 iopiic_send_start(void *cookie, int flags)
139 {
140           struct iopiic_softc *sc = cookie;
141 
142           /*
143            * This may only work in conjunction with a data transfer;
144            * we might need to un-export the "start" primitive.
145            */
146           bus_space_write_4(sc->sc_st, sc->sc_sh, IIC_ICR,
147               sc->sc_icr | IIC_ICR_START);
148           delay(IOPIIC_TIMEOUT);
149 
150           return (0);
151 }
152 
153 static int
iopiic_send_stop(void * cookie,int flags)154 iopiic_send_stop(void *cookie, int flags)
155 {
156           struct iopiic_softc *sc = cookie;
157 
158           /*
159            * The STOP bit is only used in conjunction with
160            * a data transfer, so we need to use MA in this
161            * case.
162            *
163            * Consider adding an I2C_F_STOP so we can
164            * do a read-with-STOP and write-with-STOP.
165            */
166           bus_space_write_4(sc->sc_st, sc->sc_sh, IIC_ICR,
167               sc->sc_icr | IIC_ICR_MA);
168           delay(IOPIIC_TIMEOUT);
169 
170           return (0);
171 }
172 
173 static int
iopiic_initiate_xfer(void * cookie,uint16_t addr,int flags)174 iopiic_initiate_xfer(void *cookie, uint16_t addr, int flags)
175 {
176           struct iopiic_softc *sc = cookie;
177           int error, rd_req = (flags & I2C_F_READ) != 0;
178           uint32_t idbr;
179 
180           /* We only support 7-bit addressing. */
181           if ((addr & 0x78) == 0x78)
182                     return (EINVAL);
183 
184           idbr = (addr << 1) | (rd_req ? 1 : 0);
185           bus_space_write_4(sc->sc_st, sc->sc_sh, IIC_IDBR, idbr);
186           bus_space_write_4(sc->sc_st, sc->sc_sh, IIC_ICR,
187               sc->sc_icr | IIC_ICR_START | IIC_ICR_TB);
188 
189           error = iopiic_wait(sc, IIC_ISR_ITE, flags);
190 #if 0
191           if (error)
192                     device_printf(sc->sc_dev, "failed to initiate %s xfer\n",
193                         rd_req ? "read" : "write");
194 #endif
195           return (error);
196 }
197 
198 static int
iopiic_read_byte(void * cookie,uint8_t * bytep,int flags)199 iopiic_read_byte(void *cookie, uint8_t *bytep, int flags)
200 {
201           struct iopiic_softc *sc = cookie;
202           int error, last_byte = (flags & I2C_F_LAST) != 0,
203               send_stop = (flags & I2C_F_STOP) != 0;
204 
205           bus_space_write_4(sc->sc_st, sc->sc_sh, IIC_ICR,
206               sc->sc_icr | IIC_ICR_TB | (last_byte ? IIC_ICR_NACK : 0) |
207               (send_stop ? IIC_ICR_STOP : 0));
208           if ((error = iopiic_wait(sc, IIC_ISR_IRF | IIC_ISR_ALD, flags)) == 0)
209                     *bytep = bus_space_read_4(sc->sc_st, sc->sc_sh, IIC_IDBR);
210 #if 0
211           if (error)
212                     device_printf(sc->sc_dev, "read byte failed\n");
213 #endif
214 
215           return (error);
216 }
217 
218 static int
iopiic_write_byte(void * cookie,uint8_t byte,int flags)219 iopiic_write_byte(void *cookie, uint8_t byte, int flags)
220 {
221           struct iopiic_softc *sc = cookie;
222           int error, send_stop = (flags & I2C_F_STOP) != 0;
223 
224           bus_space_write_4(sc->sc_st, sc->sc_sh, IIC_IDBR, byte);
225           bus_space_write_4(sc->sc_st, sc->sc_sh, IIC_ICR,
226               sc->sc_icr | IIC_ICR_TB | (send_stop ? IIC_ICR_STOP : 0));
227           error = iopiic_wait(sc, IIC_ISR_ITE | IIC_ISR_ALD, flags);
228 
229 #if 0
230           if (error)
231                     device_printf(sc->sc_dev, "write byte failed\n");
232 #endif
233 
234           return (error);
235 }
236