1 /* $NetBSD: sunxi_rsb.c,v 1.16 2025/09/16 11:55:17 thorpej Exp $ */ 2 3 /*- 4 * Copyright (c) 2014-2017 Jared McNeill <jmcneill (at) invisible.ca> 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 17 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 18 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 19 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 21 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 22 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 23 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 24 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 * SUCH DAMAGE. 27 */ 28 29 #include <sys/cdefs.h> 30 __KERNEL_RCSID(0, "$NetBSD: sunxi_rsb.c,v 1.16 2025/09/16 11:55:17 thorpej Exp $"); 31 32 #include <sys/param.h> 33 #include <sys/bus.h> 34 #include <sys/device.h> 35 #include <sys/intr.h> 36 #include <sys/systm.h> 37 #include <sys/kernel.h> 38 #include <sys/mutex.h> 39 #include <sys/condvar.h> 40 41 #include <dev/i2c/i2cvar.h> 42 43 #include <dev/fdt/fdtvar.h> 44 45 #include <arm/sunxi/sunxi_rsb.h> 46 47 enum sunxi_rsb_type { 48 SUNXI_P2WI, 49 SUNXI_RSB, 50 }; 51 52 static const struct device_compatible_entry compat_data[] = { 53 { .compat = "allwinner,sun6i-a31-p2wi", .value = SUNXI_P2WI }, 54 { .compat = "allwinner,sun8i-a23-rsb", .value = SUNXI_RSB }, 55 DEVICE_COMPAT_EOL 56 }; 57 58 #define RSB_ADDR_PMIC_PRIMARY 0x3a3 59 #define RSB_ADDR_PMIC_SECONDARY 0x745 60 #define RSB_ADDR_PERIPH_IC 0xe89 61 62 /* 63 * Device address to Run-time address mappings. 64 * 65 * Run-time address (RTA) is an 8-bit value used to address the device during 66 * a read or write transaction. The following are valid RTAs: 67 * 0x17 0x2d 0x3a 0x4e 0x59 0x63 0x74 0x8b 0x9c 0xa6 0xb1 0xc5 0xd2 0xe8 0xff 68 * 69 * Allwinner uses RTA 0x2d for the primary PMIC, 0x3a for the secondary PMIC, 70 * and 0x4e for the peripheral IC (where applicable). 71 */ 72 static const struct { 73 uint16_t addr; 74 uint8_t rta; 75 } rsb_rtamap[] = { 76 { .addr = RSB_ADDR_PMIC_PRIMARY, .rta = 0x2d }, 77 { .addr = RSB_ADDR_PMIC_SECONDARY, .rta = 0x3a }, 78 { .addr = RSB_ADDR_PERIPH_IC, .rta = 0x4e }, 79 { .addr = 0, .rta = 0 } 80 }; 81 82 struct sunxi_rsb_softc { 83 device_t sc_dev; 84 bus_space_tag_t sc_bst; 85 bus_space_handle_t sc_bsh; 86 enum sunxi_rsb_type sc_type; 87 struct i2c_controller sc_ic; 88 kmutex_t sc_intr_lock; 89 kcondvar_t sc_intr_wait; 90 device_t sc_i2cdev; 91 void *sc_ih; 92 uint32_t sc_stat; 93 bool sc_busy; 94 95 uint16_t sc_rsb_last_da; 96 }; 97 98 #define RSB_READ(sc, reg) \ 99 bus_space_read_4((sc)->sc_bst, (sc)->sc_bsh, (reg)) 100 #define RSB_WRITE(sc, reg, val) \ 101 bus_space_write_4((sc)->sc_bst, (sc)->sc_bsh, (reg), (val)) 102 103 static int sunxi_rsb_exec(void *, i2c_op_t, i2c_addr_t, const void *, 104 size_t, void *, size_t, int); 105 106 static int sunxi_rsb_intr(void *); 107 static int sunxi_rsb_wait(struct sunxi_rsb_softc *, int); 108 static int sunxi_rsb_rsb_config(struct sunxi_rsb_softc *, 109 uint8_t, i2c_addr_t, int); 110 111 static int sunxi_rsb_match(device_t, cfdata_t, void *); 112 static void sunxi_rsb_attach(device_t, device_t, void *); 113 114 CFATTACH_DECL_NEW(sunxi_rsb, sizeof(struct sunxi_rsb_softc), 115 sunxi_rsb_match, sunxi_rsb_attach, NULL, NULL); 116 117 static int 118 sunxi_rsb_match(device_t parent, cfdata_t cf, void *aux) 119 { 120 struct fdt_attach_args * const faa = aux; 121 122 return of_compatible_match(faa->faa_phandle, compat_data); 123 } 124 125 static void 126 sunxi_rsb_attach(device_t parent, device_t self, void *aux) 127 { 128 struct sunxi_rsb_softc * const sc = device_private(self); 129 struct fdt_attach_args * const faa = aux; 130 const int phandle = faa->faa_phandle; 131 struct fdtbus_reset *rst; 132 struct clk *clk; 133 char intrstr[128]; 134 bus_addr_t addr; 135 bus_size_t size; 136 137 if (fdtbus_get_reg(phandle, 0, &addr, &size) != 0) { 138 aprint_error(": couldn't get registers\n"); 139 return; 140 } 141 142 if (!fdtbus_intr_str(phandle, 0, intrstr, sizeof(intrstr))) { 143 aprint_error(": couldn't decode interrupt\n"); 144 return; 145 } 146 147 if ((clk = fdtbus_clock_get_index(phandle, 0)) != NULL) 148 if (clk_enable(clk) != 0) { 149 aprint_error(": couldn't enable clock\n"); 150 return; 151 } 152 if ((rst = fdtbus_reset_get_index(phandle, 0)) != NULL) 153 if (fdtbus_reset_deassert(rst) != 0) { 154 aprint_error(": couldn't de-assert reset\n"); 155 return; 156 } 157 158 sc->sc_dev = self; 159 sc->sc_type = of_compatible_lookup(phandle, compat_data)->value; 160 sc->sc_bst = faa->faa_bst; 161 if (bus_space_map(sc->sc_bst, addr, size, 0, &sc->sc_bsh) != 0) { 162 aprint_error(": couldn't map registers\n"); 163 return; 164 } 165 166 mutex_init(&sc->sc_intr_lock, MUTEX_DEFAULT, IPL_SCHED); 167 cv_init(&sc->sc_intr_wait, "sunxirsb"); 168 169 aprint_naive("\n"); 170 aprint_normal(": %s\n", sc->sc_type == SUNXI_P2WI ? "P2WI" : "RSB"); 171 172 sc->sc_ih = fdtbus_intr_establish_xname(phandle, 0, IPL_VM, 0, 173 sunxi_rsb_intr, sc, device_xname(self)); 174 if (sc->sc_ih == NULL) { 175 aprint_error_dev(self, "couldn't establish interrupt on %s\n", 176 intrstr); 177 return; 178 } 179 aprint_normal_dev(self, "interrupting on %s\n", intrstr); 180 181 iic_tag_init(&sc->sc_ic); 182 sc->sc_ic.ic_cookie = sc; 183 sc->sc_ic.ic_exec = sunxi_rsb_exec; 184 185 iicbus_attach(self, &sc->sc_ic); 186 } 187 188 static int 189 sunxi_rsb_intr(void *priv) 190 { 191 struct sunxi_rsb_softc *sc = priv; 192 uint32_t stat; 193 194 stat = RSB_READ(sc, RSB_STAT_REG); 195 if ((stat & RSB_STAT_MASK) == 0) 196 return 0; 197 198 RSB_WRITE(sc, RSB_STAT_REG, stat & RSB_STAT_MASK); 199 200 mutex_enter(&sc->sc_intr_lock); 201 sc->sc_stat |= stat; 202 cv_broadcast(&sc->sc_intr_wait); 203 mutex_exit(&sc->sc_intr_lock); 204 205 return 1; 206 } 207 208 static int 209 sunxi_rsb_soft_reset(struct sunxi_rsb_softc *sc) 210 { 211 int retry = 1000; 212 213 RSB_WRITE(sc, RSB_CTRL_REG, RSB_CTRL_SOFT_RESET); 214 while (--retry > 0) { 215 if ((RSB_READ(sc, RSB_CTRL_REG) & RSB_CTRL_SOFT_RESET) == 0) 216 break; 217 delay(10); 218 } 219 if (retry == 0) 220 return EIO; 221 222 return 0; 223 } 224 225 static int 226 sunxi_rsb_wait(struct sunxi_rsb_softc *sc, int flags) 227 { 228 int error = 0, retry; 229 230 /* Wait up to 5 seconds for a transfer to complete */ 231 sc->sc_stat = 0; 232 for (retry = (flags & I2C_F_POLL) ? 100 : 5; retry > 0; retry--) { 233 if (flags & I2C_F_POLL) { 234 sc->sc_stat |= RSB_READ(sc, RSB_STAT_REG); 235 } else { 236 error = cv_timedwait(&sc->sc_intr_wait, 237 &sc->sc_intr_lock, hz); 238 if (error && error != EWOULDBLOCK) { 239 break; 240 } 241 } 242 if (sc->sc_stat & RSB_STAT_MASK) { 243 break; 244 } 245 if (flags & I2C_F_POLL) { 246 delay(10000); 247 } 248 } 249 if (retry == 0) 250 error = EAGAIN; 251 252 if (flags & I2C_F_POLL) { 253 RSB_WRITE(sc, RSB_STAT_REG, 254 sc->sc_stat & RSB_STAT_MASK); 255 } 256 257 if (error) { 258 /* Abort transaction */ 259 device_printf(sc->sc_dev, "transfer timeout, error = %d\n", 260 error); 261 RSB_WRITE(sc, RSB_CTRL_REG, 262 RSB_CTRL_ABORT_TRANS); 263 return error; 264 } 265 266 if (sc->sc_stat & RSB_STAT_LOAD_BSY) { 267 device_printf(sc->sc_dev, "transfer busy\n"); 268 return EBUSY; 269 } 270 if (sc->sc_stat & RSB_STAT_TRANS_ERR) { 271 device_printf(sc->sc_dev, "transfer error, id 0x%02" PRIx64 272 "\n", __SHIFTOUT(sc->sc_stat, RSB_STAT_TRANS_ERR_ID)); 273 return EIO; 274 } 275 276 return 0; 277 } 278 279 static int 280 sunxi_rsb_rsb_config(struct sunxi_rsb_softc *sc, uint8_t rta, i2c_addr_t da, 281 int flags) 282 { 283 uint32_t dar, ctrl; 284 285 KASSERT(mutex_owned(&sc->sc_intr_lock)); 286 287 RSB_WRITE(sc, RSB_STAT_REG, 288 RSB_READ(sc, RSB_STAT_REG) & RSB_STAT_MASK); 289 290 dar = __SHIFTIN(rta, RSB_DAR_RTA); 291 dar |= __SHIFTIN(da, RSB_DAR_DA); 292 RSB_WRITE(sc, RSB_DAR_REG, dar); 293 RSB_WRITE(sc, RSB_CMD_REG, RSB_CMD_IDX_SRTA); 294 295 /* Make sure the controller is idle */ 296 ctrl = RSB_READ(sc, RSB_CTRL_REG); 297 if (ctrl & RSB_CTRL_START_TRANS) { 298 device_printf(sc->sc_dev, "device is busy\n"); 299 return EBUSY; 300 } 301 302 /* Start the transfer */ 303 RSB_WRITE(sc, RSB_CTRL_REG, 304 ctrl | RSB_CTRL_START_TRANS); 305 306 return sunxi_rsb_wait(sc, flags); 307 } 308 309 static int 310 sunxi_rsb_exec(void *priv, i2c_op_t op, i2c_addr_t addr, 311 const void *cmdbuf, size_t cmdlen, void *buf, size_t len, int flags) 312 { 313 struct sunxi_rsb_softc *sc = priv; 314 uint32_t dlen, ctrl; 315 uint8_t rta; 316 int error, i; 317 318 if (cmdlen != 1 || (len != 1 && len != 2 && len != 4)) 319 return EINVAL; 320 321 mutex_enter(&sc->sc_intr_lock); 322 323 error = sunxi_rsb_soft_reset(sc); 324 if (error != 0) { 325 mutex_exit(&sc->sc_intr_lock); 326 device_printf(sc->sc_dev, "soft reset timed out\n"); 327 return error; 328 } 329 330 if ((flags & I2C_F_POLL) == 0) { 331 /* Enable interrupts */ 332 RSB_WRITE(sc, RSB_INTE_REG, 333 RSB_INTE_LOAD_BSY_ENB | 334 RSB_INTE_TRANS_ERR_ENB | 335 RSB_INTE_TRANS_OVER_ENB); 336 RSB_WRITE(sc, RSB_CTRL_REG, 337 RSB_CTRL_GLOBAL_INT_ENB); 338 } 339 340 if (sc->sc_type == SUNXI_RSB && sc->sc_rsb_last_da != addr) { 341 /* Lookup run-time address for given device address */ 342 for (rta = 0, i = 0; rsb_rtamap[i].rta != 0; i++) 343 if (rsb_rtamap[i].addr == addr) { 344 rta = rsb_rtamap[i].rta; 345 break; 346 } 347 if (rta == 0) { 348 mutex_exit(&sc->sc_intr_lock); 349 device_printf(sc->sc_dev, 350 "RTA not known for address %#x\n", addr); 351 return ENXIO; 352 } 353 error = sunxi_rsb_rsb_config(sc, rta, addr, flags); 354 if (error) { 355 device_printf(sc->sc_dev, 356 "SRTA failed, flags = %x, error = %d\n", 357 flags, error); 358 sc->sc_rsb_last_da = 0; 359 goto done; 360 } 361 362 sc->sc_rsb_last_da = addr; 363 } 364 365 /* Data byte register */ 366 RSB_WRITE(sc, RSB_DADDR0_REG, *(const uint8_t *)cmdbuf); 367 368 if (I2C_OP_WRITE_P(op)) { 369 uint8_t *pbuf = buf; 370 uint32_t data; 371 /* Write data */ 372 switch (len) { 373 case 1: 374 data = pbuf[0]; 375 break; 376 case 2: 377 data = pbuf[0] | (pbuf[1] << 8); 378 break; 379 case 4: 380 data = pbuf[0] | (pbuf[1] << 8) | 381 (pbuf[2] << 16) | (pbuf[3] << 24); 382 break; 383 default: 384 error = EINVAL; 385 goto done; 386 } 387 RSB_WRITE(sc, RSB_DATA0_REG, data); 388 } 389 390 if (sc->sc_type == SUNXI_RSB) { 391 uint8_t cmd; 392 if (I2C_OP_WRITE_P(op)) { 393 switch (len) { 394 case 1: cmd = RSB_CMD_IDX_WR8; break; 395 case 2: cmd = RSB_CMD_IDX_WR16; break; 396 case 4: cmd = RSB_CMD_IDX_WR32; break; 397 default: error = EINVAL; goto done; 398 } 399 } else { 400 switch (len) { 401 case 1: cmd = RSB_CMD_IDX_RD8; break; 402 case 2: cmd = RSB_CMD_IDX_RD16; break; 403 case 4: cmd = RSB_CMD_IDX_RD32; break; 404 default: error = EINVAL; goto done; 405 } 406 } 407 RSB_WRITE(sc, RSB_CMD_REG, cmd); 408 } 409 410 /* Program data length register; if reading, set read/write bit */ 411 dlen = __SHIFTIN(len - 1, RSB_DLEN_ACCESS_LENGTH); 412 if (I2C_OP_READ_P(op)) { 413 dlen |= RSB_DLEN_READ_WRITE_FLAG; 414 } 415 RSB_WRITE(sc, RSB_DLEN_REG, dlen); 416 417 /* Make sure the controller is idle */ 418 ctrl = RSB_READ(sc, RSB_CTRL_REG); 419 if (ctrl & RSB_CTRL_START_TRANS) { 420 device_printf(sc->sc_dev, "device is busy\n"); 421 error = EBUSY; 422 goto done; 423 } 424 425 /* Start the transfer */ 426 RSB_WRITE(sc, RSB_CTRL_REG, 427 ctrl | RSB_CTRL_START_TRANS); 428 429 error = sunxi_rsb_wait(sc, flags); 430 if (error) 431 goto done; 432 433 if (I2C_OP_READ_P(op)) { 434 uint32_t data = RSB_READ(sc, RSB_DATA0_REG); 435 switch (len) { 436 case 4: 437 *(uint32_t *)buf = data; 438 break; 439 case 2: 440 *(uint16_t *)buf = data & 0xffff; 441 break; 442 case 1: 443 *(uint8_t *)buf = data & 0xff; 444 break; 445 default: 446 error = EINVAL; 447 goto done; 448 } 449 } 450 451 error = 0; 452 453 done: 454 RSB_WRITE(sc, RSB_CTRL_REG, 0); 455 mutex_exit(&sc->sc_intr_lock); 456 457 return error; 458 } 459