at91_spi.c revision 310156
1/*- 2 * Copyright (c) 2006 M. Warner Losh. 3 * Copyright (c) 2011-2012 Ian Lepore. 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 * 15 * THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18 * ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE 19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25 * SUCH DAMAGE. 26 */ 27 28#include "opt_platform.h" 29 30#include <sys/cdefs.h> 31__FBSDID("$FreeBSD: stable/11/sys/arm/at91/at91_spi.c 310156 2016-12-16 15:33:21Z manu $"); 32 33#include <sys/param.h> 34#include <sys/systm.h> 35#include <sys/bus.h> 36#include <sys/conf.h> 37#include <sys/kernel.h> 38#include <sys/lock.h> 39#include <sys/mbuf.h> 40#include <sys/malloc.h> 41#include <sys/module.h> 42#include <sys/rman.h> 43#include <sys/sx.h> 44 45#include <machine/bus.h> 46 47#include <arm/at91/at91var.h> 48#include <arm/at91/at91_spireg.h> 49#include <arm/at91/at91_pdcreg.h> 50 51#include <dev/spibus/spi.h> 52#include <dev/spibus/spibusvar.h> 53 54#ifdef FDT 55#include <dev/fdt/fdt_common.h> 56#include <dev/ofw/ofw_bus.h> 57#include <dev/ofw/ofw_bus_subr.h> 58#endif 59 60#include "spibus_if.h" 61 62struct at91_spi_softc 63{ 64 device_t dev; /* Myself */ 65 void *intrhand; /* Interrupt handle */ 66 struct resource *irq_res; /* IRQ resource */ 67 struct resource *mem_res; /* Memory resource */ 68 bus_dma_tag_t dmatag; /* bus dma tag for transfers */ 69 bus_dmamap_t map[4]; /* Maps for the transaction */ 70 struct sx xfer_mtx; /* Enforce one transfer at a time */ 71 uint32_t xfer_done; /* interrupt<->mainthread signaling */ 72}; 73 74#define CS_TO_MR(cs) ((~(1 << (cs)) & 0x0f) << 16) 75 76static inline uint32_t 77RD4(struct at91_spi_softc *sc, bus_size_t off) 78{ 79 80 return (bus_read_4(sc->mem_res, off)); 81} 82 83static inline void 84WR4(struct at91_spi_softc *sc, bus_size_t off, uint32_t val) 85{ 86 87 bus_write_4(sc->mem_res, off, val); 88} 89 90/* bus entry points */ 91static int at91_spi_attach(device_t dev); 92static int at91_spi_detach(device_t dev); 93static int at91_spi_probe(device_t dev); 94static int at91_spi_transfer(device_t dev, device_t child, 95 struct spi_command *cmd); 96 97/* helper routines */ 98static void at91_getaddr(void *arg, bus_dma_segment_t *segs, int nsegs, 99 int error); 100static int at91_spi_activate(device_t dev); 101static void at91_spi_deactivate(device_t dev); 102static void at91_spi_intr(void *arg); 103 104static int 105at91_spi_probe(device_t dev) 106{ 107#ifdef FDT 108 if (!ofw_bus_is_compatible(dev, "atmel,at91rm9200-spi")) 109 return (ENXIO); 110#endif 111 device_set_desc(dev, "AT91 SPI"); 112 return (0); 113} 114 115static int 116at91_spi_attach(device_t dev) 117{ 118 struct at91_spi_softc *sc; 119 int err; 120 uint32_t csr; 121 122 sc = device_get_softc(dev); 123 124 sc->dev = dev; 125 sx_init(&sc->xfer_mtx, device_get_nameunit(dev)); 126 127 /* 128 * Allocate resources. 129 */ 130 err = at91_spi_activate(dev); 131 if (err) 132 goto out; 133 134#ifdef FDT 135 /* 136 * Disable devices need to hold their resources, so return now and not attach 137 * the spibus, setup interrupt handlers, etc. 138 */ 139 if (!ofw_bus_status_okay(dev)) 140 return 0; 141#endif 142 143 /* 144 * Set up the hardware. 145 */ 146 147 WR4(sc, SPI_CR, SPI_CR_SWRST); 148 /* "Software Reset must be Written Twice" erratum */ 149 WR4(sc, SPI_CR, SPI_CR_SWRST); 150 WR4(sc, SPI_IDR, 0xffffffff); 151 152 WR4(sc, SPI_MR, (0xf << 24) | SPI_MR_MSTR | SPI_MR_MODFDIS | 153 CS_TO_MR(0)); 154 155 /* 156 * For now, run the bus at the slowest speed possible as otherwise we 157 * may encounter data corruption on transmit as seen with ETHERNUT5 158 * and AT45DB321D even though both board and slave device can take 159 * more. 160 * This also serves as a work-around for the "NPCSx rises if no data 161 * data is to be transmitted" erratum. The ideal workaround for the 162 * latter is to take the chip select control away from the peripheral 163 * and manage it directly as a GPIO line. The easy solution is to 164 * slow down the bus so dramatically that it just never gets starved 165 * as may be seen when the OCHI controller is running and consuming 166 * memory and APB bandwidth. 167 * Also, currently we lack a way for lettting both the board and the 168 * slave devices take their maximum supported SPI clocks into account. 169 * Also, we hard-wire SPI mode to 3. 170 */ 171 csr = SPI_CSR_CPOL | (4 << 16) | (0xff << 8); 172 WR4(sc, SPI_CSR0, csr); 173 WR4(sc, SPI_CSR1, csr); 174 WR4(sc, SPI_CSR2, csr); 175 WR4(sc, SPI_CSR3, csr); 176 177 WR4(sc, SPI_CR, SPI_CR_SPIEN); 178 179 WR4(sc, PDC_PTCR, PDC_PTCR_TXTDIS); 180 WR4(sc, PDC_PTCR, PDC_PTCR_RXTDIS); 181 WR4(sc, PDC_RNPR, 0); 182 WR4(sc, PDC_RNCR, 0); 183 WR4(sc, PDC_TNPR, 0); 184 WR4(sc, PDC_TNCR, 0); 185 WR4(sc, PDC_RPR, 0); 186 WR4(sc, PDC_RCR, 0); 187 WR4(sc, PDC_TPR, 0); 188 WR4(sc, PDC_TCR, 0); 189 RD4(sc, SPI_RDR); 190 RD4(sc, SPI_SR); 191 192 device_add_child(dev, "spibus", -1); 193 bus_generic_attach(dev); 194out: 195 if (err) 196 at91_spi_deactivate(dev); 197 return (err); 198} 199 200static int 201at91_spi_detach(device_t dev) 202{ 203 204 return (EBUSY); /* XXX */ 205} 206 207static int 208at91_spi_activate(device_t dev) 209{ 210 struct at91_spi_softc *sc; 211 int err, i, rid; 212 213 sc = device_get_softc(dev); 214 err = ENOMEM; 215 216 rid = 0; 217 sc->mem_res = bus_alloc_resource_any(dev, SYS_RES_MEMORY, &rid, 218 RF_ACTIVE); 219 if (sc->mem_res == NULL) 220 goto out; 221 222 rid = 0; 223 sc->irq_res = bus_alloc_resource_any(dev, SYS_RES_IRQ, &rid, 224 RF_ACTIVE); 225 if (sc->irq_res == NULL) 226 goto out; 227 err = bus_setup_intr(dev, sc->irq_res, INTR_TYPE_MISC | INTR_MPSAFE, 228 NULL, at91_spi_intr, sc, &sc->intrhand); 229 if (err != 0) 230 goto out; 231 232 err = bus_dma_tag_create(bus_get_dma_tag(dev), 1, 0, 233 BUS_SPACE_MAXADDR_32BIT, BUS_SPACE_MAXADDR, NULL, NULL, 2048, 1, 234 2048, BUS_DMA_ALLOCNOW, NULL, NULL, &sc->dmatag); 235 if (err != 0) 236 goto out; 237 238 for (i = 0; i < 4; i++) { 239 err = bus_dmamap_create(sc->dmatag, 0, &sc->map[i]); 240 if (err != 0) 241 goto out; 242 } 243out: 244 if (err != 0) 245 at91_spi_deactivate(dev); 246 return (err); 247} 248 249static void 250at91_spi_deactivate(device_t dev) 251{ 252 struct at91_spi_softc *sc; 253 int i; 254 255 sc = device_get_softc(dev); 256 bus_generic_detach(dev); 257 258 for (i = 0; i < 4; i++) 259 if (sc->map[i]) 260 bus_dmamap_destroy(sc->dmatag, sc->map[i]); 261 262 if (sc->dmatag) 263 bus_dma_tag_destroy(sc->dmatag); 264 265 if (sc->intrhand) 266 bus_teardown_intr(dev, sc->irq_res, sc->intrhand); 267 sc->intrhand = NULL; 268 if (sc->irq_res) 269 bus_release_resource(dev, SYS_RES_IRQ, 270 rman_get_rid(sc->irq_res), sc->irq_res); 271 sc->irq_res = NULL; 272 273 if (sc->mem_res) 274 bus_release_resource(dev, SYS_RES_MEMORY, 275 rman_get_rid(sc->mem_res), sc->mem_res); 276 sc->mem_res = NULL; 277} 278 279static void 280at91_getaddr(void *arg, bus_dma_segment_t *segs, int nsegs __unused, 281 int error) 282{ 283 284 if (error != 0) 285 return; 286 *(bus_addr_t *)arg = segs[0].ds_addr; 287} 288 289static int 290at91_spi_transfer(device_t dev, device_t child, struct spi_command *cmd) 291{ 292 struct at91_spi_softc *sc; 293 bus_addr_t addr; 294 int err, i, j, mode[4]; 295 uint32_t cs; 296 297 KASSERT(cmd->tx_cmd_sz == cmd->rx_cmd_sz, 298 ("%s: TX/RX command sizes should be equal", __func__)); 299 KASSERT(cmd->tx_data_sz == cmd->rx_data_sz, 300 ("%s: TX/RX data sizes should be equal", __func__)); 301 302 /* get the proper chip select */ 303 spibus_get_cs(child, &cs); 304 305 sc = device_get_softc(dev); 306 i = 0; 307 308 sx_xlock(&sc->xfer_mtx); 309 310 /* 311 * Disable transfers while we set things up. 312 */ 313 WR4(sc, PDC_PTCR, PDC_PTCR_TXTDIS | PDC_PTCR_RXTDIS); 314 315 /* 316 * PSCDEC = 0 has a range of 0..3 for chip select. We 317 * don't support PSCDEC = 1 which has a range of 0..15. 318 */ 319 if (cs > 3) { 320 device_printf(dev, 321 "Invalid chip select %d requested by %s\n", cs, 322 device_get_nameunit(child)); 323 err = EINVAL; 324 goto out; 325 } 326 327#ifdef SPI_CHIP_SELECT_HIGH_SUPPORT 328 /* 329 * The AT91RM9200 couldn't do CS high for CS 0. Other chips can, but we 330 * don't support that yet, or other spi modes. 331 */ 332 if (at91_is_rm92() && cs == 0 && 333 (cmd->flags & SPI_CHIP_SELECT_HIGH) != 0) { 334 device_printf(dev, 335 "Invalid chip select high requested by %s for cs 0.\n", 336 device_get_nameunit(child)); 337 err = EINVAL; 338 goto out; 339 } 340#endif 341 err = (RD4(sc, SPI_MR) & ~0x000f0000) | CS_TO_MR(cs); 342 WR4(sc, SPI_MR, err); 343 344 /* 345 * Set up the TX side of the transfer. 346 */ 347 if ((err = bus_dmamap_load(sc->dmatag, sc->map[i], cmd->tx_cmd, 348 cmd->tx_cmd_sz, at91_getaddr, &addr, 0)) != 0) 349 goto out; 350 WR4(sc, PDC_TPR, addr); 351 WR4(sc, PDC_TCR, cmd->tx_cmd_sz); 352 bus_dmamap_sync(sc->dmatag, sc->map[i], BUS_DMASYNC_PREWRITE); 353 mode[i++] = BUS_DMASYNC_POSTWRITE; 354 if (cmd->tx_data_sz > 0) { 355 if ((err = bus_dmamap_load(sc->dmatag, sc->map[i], 356 cmd->tx_data, cmd->tx_data_sz, at91_getaddr, &addr, 0)) != 357 0) 358 goto out; 359 WR4(sc, PDC_TNPR, addr); 360 WR4(sc, PDC_TNCR, cmd->tx_data_sz); 361 bus_dmamap_sync(sc->dmatag, sc->map[i], BUS_DMASYNC_PREWRITE); 362 mode[i++] = BUS_DMASYNC_POSTWRITE; 363 } 364 365 /* 366 * Set up the RX side of the transfer. 367 */ 368 if ((err = bus_dmamap_load(sc->dmatag, sc->map[i], cmd->rx_cmd, 369 cmd->rx_cmd_sz, at91_getaddr, &addr, 0)) != 0) 370 goto out; 371 WR4(sc, PDC_RPR, addr); 372 WR4(sc, PDC_RCR, cmd->rx_cmd_sz); 373 bus_dmamap_sync(sc->dmatag, sc->map[i], BUS_DMASYNC_PREREAD); 374 mode[i++] = BUS_DMASYNC_POSTREAD; 375 if (cmd->rx_data_sz > 0) { 376 if ((err = bus_dmamap_load(sc->dmatag, sc->map[i], 377 cmd->rx_data, cmd->rx_data_sz, at91_getaddr, &addr, 0)) != 378 0) 379 goto out; 380 WR4(sc, PDC_RNPR, addr); 381 WR4(sc, PDC_RNCR, cmd->rx_data_sz); 382 bus_dmamap_sync(sc->dmatag, sc->map[i], BUS_DMASYNC_PREREAD); 383 mode[i++] = BUS_DMASYNC_POSTREAD; 384 } 385 386 /* 387 * Start the transfer, wait for it to complete. 388 */ 389 sc->xfer_done = 0; 390 WR4(sc, SPI_IER, SPI_SR_RXBUFF); 391 WR4(sc, PDC_PTCR, PDC_PTCR_TXTEN | PDC_PTCR_RXTEN); 392 do 393 err = tsleep(&sc->xfer_done, PCATCH | PZERO, "at91_spi", hz); 394 while (sc->xfer_done == 0 && err != EINTR); 395 396 /* 397 * Stop the transfer and clean things up. 398 */ 399 WR4(sc, PDC_PTCR, PDC_PTCR_TXTDIS | PDC_PTCR_RXTDIS); 400 if (err == 0) 401 for (j = 0; j < i; j++) 402 bus_dmamap_sync(sc->dmatag, sc->map[j], mode[j]); 403out: 404 for (j = 0; j < i; j++) 405 bus_dmamap_unload(sc->dmatag, sc->map[j]); 406 407 sx_xunlock(&sc->xfer_mtx); 408 409 return (err); 410} 411 412static void 413at91_spi_intr(void *arg) 414{ 415 struct at91_spi_softc *sc; 416 uint32_t sr; 417 418 sc = (struct at91_spi_softc*)arg; 419 420 sr = RD4(sc, SPI_SR) & RD4(sc, SPI_IMR); 421 if ((sr & SPI_SR_RXBUFF) != 0) { 422 sc->xfer_done = 1; 423 WR4(sc, SPI_IDR, SPI_SR_RXBUFF); 424 wakeup(&sc->xfer_done); 425 } 426 if ((sr & ~SPI_SR_RXBUFF) != 0) { 427 device_printf(sc->dev, "Unexpected ISR %#x\n", sr); 428 WR4(sc, SPI_IDR, sr & ~SPI_SR_RXBUFF); 429 } 430} 431 432static devclass_t at91_spi_devclass; 433 434static device_method_t at91_spi_methods[] = { 435 /* Device interface */ 436 DEVMETHOD(device_probe, at91_spi_probe), 437 DEVMETHOD(device_attach, at91_spi_attach), 438 DEVMETHOD(device_detach, at91_spi_detach), 439 440 /* spibus interface */ 441 DEVMETHOD(spibus_transfer, at91_spi_transfer), 442 443 DEVMETHOD_END 444}; 445 446static driver_t at91_spi_driver = { 447 "spi", 448 at91_spi_methods, 449 sizeof(struct at91_spi_softc), 450}; 451 452#ifdef FDT 453DRIVER_MODULE(at91_spi, simplebus, at91_spi_driver, at91_spi_devclass, NULL, 454 NULL); 455#else 456DRIVER_MODULE(at91_spi, atmelarm, at91_spi_driver, at91_spi_devclass, NULL, 457 NULL); 458#endif 459