sys/dev/raid/twa/twa_freebsd.c

   1 /*-
   2  * Copyright (c) 2003-04 3ware, Inc.
   3  * Copyright (c) 2000 Michael Smith
   4  * Copyright (c) 2000 BSDi
   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 AND CONTRIBUTORS ``AS IS'' AND
  17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24  * LIABILITY, 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  *      $FreeBSD$
  29  * $DragonFly: src/sys/dev/raid/twa/twa_freebsd.c,v 1.5 2005/02/04 02:55:48 dillon Exp $
  30  */
  31
  32 /*
  33  * 3ware driver for 9000 series storage controllers.
  34  *
  35  * Author: Vinod Kashyap
  36  */
  37
  38
  39 #include "twa_includes.h"
  40
  41 static void     twa_setup_data_dmamap(void *arg, bus_dma_segment_t *segs,
  42                                                 int nsegments, int error);
  43 static void     twa_setup_request_dmamap(void *arg, bus_dma_segment_t *segs,
  44                                                 int nsegments, int error);
  45
  46 MALLOC_DEFINE(TWA_MALLOC_CLASS, "twa commands", "twa commands");
  47
  48
  49 static  d_open_t                twa_open;
  50 static  d_close_t               twa_close;
  51 static  d_ioctl_t               twa_ioctl_wrapper;
  52
  53 static struct cdevsw twa_cdevsw = {
  54         "twa",
  55         TWA_CDEV_MAJOR,
  56         0,
  57         NULL,
  58         0,
  59         twa_open,
  60         twa_close,
  61         noread,
  62         nowrite,
  63         twa_ioctl_wrapper,
  64         nopoll,
  65         nommap,
  66         nostrategy,
  67         nodump,
  68         nopsize,
  69 };
  70
  71 static devclass_t       twa_devclass;
  72
  73
  74 /*
  75  * Function name:       twa_open
  76  * Description:         Called when the controller is opened.
  77  *                      Simply marks the controller as open.
  78  *
  79  * Input:               dev     -- control device corresponding to the ctlr
  80  *                      flags   -- mode of open
  81  *                      fmt     -- device type (character/block etc.)
  82  *                      proc    -- current process
  83  * Output:              None
  84  * Return value:        0       -- success
  85  *                      non-zero-- failure
  86  */
  87 static int
  88 twa_open(dev_t dev, int flags, int fmt, d_thread_t *proc)
  89 {
  90         int                     unit = minor(dev);
  91         struct twa_softc        *sc = devclass_get_softc(twa_devclass, unit);
  92
  93         sc->twa_state |= TWA_STATE_OPEN;
  94         return(0);
  95 }
  96
  97
  98
  99 /*
 100  * Function name:       twa_close
 101  * Description:         Called when the controller is closed.
 102  *                      Simply marks the controller as not open.
 103  *
 104  * Input:               dev     -- control device corresponding to the ctlr
 105  *                      flags   -- mode of corresponding open
 106  *                      fmt     -- device type (character/block etc.)
 107  *                      proc    -- current process
 108  * Output:              None
 109  * Return value:        0       -- success
 110  *                      non-zero-- failure
 111  */
 112 static int
 113 twa_close(dev_t dev, int flags, int fmt, d_thread_t *proc)
 114 {
 115         int                     unit = minor(dev);
 116         struct twa_softc        *sc = devclass_get_softc(twa_devclass, unit);
 117
 118         sc->twa_state &= ~TWA_STATE_OPEN;
 119         return(0);
 120 }
 121
 122
 123
 124 /*
 125  * Function name:       twa_ioctl_wrapper
 126  * Description:         Called when an ioctl is posted to the controller.
 127  *                      Simply calls the ioctl handler.
 128  *
 129  * Input:               dev     -- control device corresponding to the ctlr
 130  *                      cmd     -- ioctl cmd
 131  *                      buf     -- ptr to buffer in kernel memory, which is
 132  *                                 a copy of the input buffer in user-space
 133  *                      flags   -- mode of corresponding open
 134  *                      proc    -- current process
 135  * Output:              buf     -- ptr to buffer in kernel memory, which will
 136  *                                 be copied to the output buffer in user-space
 137  * Return value:        0       -- success
 138  *                      non-zero-- failure
 139  */
 140 static int
 141 twa_ioctl_wrapper(dev_t dev, u_long cmd, caddr_t buf,
 142                                         int flags, d_thread_t *proc)
 143 {
 144         struct twa_softc        *sc = (struct twa_softc *)(dev->si_drv1);
 145
 146         return(twa_ioctl(sc, cmd, buf));
 147 }
 148
 149
 150
 151 static int      twa_probe (device_t dev);
 152 static int      twa_attach (device_t dev);
 153 static void     twa_free (struct twa_softc *sc);
 154 static int      twa_detach (device_t dev);
 155 static int      twa_shutdown (device_t dev);
 156 static int      twa_suspend (device_t dev);
 157 static int      twa_resume (device_t dev);
 158 static void     twa_pci_intr(void *arg);
 159 static void     twa_intrhook (void *arg);
 160
 161 static device_method_t  twa_methods[] = {
 162         /* Device interface */
 163         DEVMETHOD(device_probe,         twa_probe),
 164         DEVMETHOD(device_attach,        twa_attach),
 165         DEVMETHOD(device_detach,        twa_detach),
 166         DEVMETHOD(device_shutdown,      twa_shutdown),
 167         DEVMETHOD(device_suspend,       twa_suspend),
 168         DEVMETHOD(device_resume,        twa_resume),
 169
 170         DEVMETHOD(bus_print_child,      bus_generic_print_child),
 171         DEVMETHOD(bus_driver_added,     bus_generic_driver_added),
 172         {0, 0}
 173 };
 174
 175 static driver_t twa_pci_driver = {
 176         "twa",
 177         twa_methods,
 178         sizeof(struct twa_softc)
 179 };
 180
 181 DRIVER_MODULE(twa, pci, twa_pci_driver, twa_devclass, 0, 0);
 182
 183
 184
 185 /*
 186  * Function name:       twa_probe
 187  * Description:         Called at driver load time.  Claims 9000 ctlrs.
 188  *
 189  * Input:               dev     -- bus device corresponding to the ctlr
 190  * Output:              None
 191  * Return value:        <= 0    -- success
 192  *                      > 0     -- failure
 193  */
 194 static int
 195 twa_probe(device_t dev)
 196 {
 197         static u_int8_t first_ctlr = 1;
 198
 199         twa_dbg_print(3, "entered");
 200
 201         if ((pci_get_vendor(dev) == TWA_VENDOR_ID) &&
 202                         (pci_get_device(dev) == TWA_DEVICE_ID_9K)) {
 203                 device_set_desc(dev, TWA_DEVICE_NAME);
 204                 /* Print the driver version only once. */
 205                 if (first_ctlr) {
 206                         printf("3ware device driver for 9000 series storage controllers, version: %s\n",
 207                                         TWA_DRIVER_VERSION_STRING);
 208                         first_ctlr = 0;
 209                 }
 210                 return(0);
 211         }
 212         return(ENXIO);
 213 }
 214
 215
 216
 217 /*
 218  * Function name:       twa_attach
 219  * Description:         Allocates pci resources; updates sc; adds a node to the
 220  *                      sysctl tree to expose the driver version; makes calls
 221  *                      to initialize ctlr, and to attach to CAM.
 222  *
 223  * Input:               dev     -- bus device corresponding to the ctlr
 224  * Output:              None
 225  * Return value:        0       -- success
 226  *                      non-zero-- failure
 227  */
 228 static int
 229 twa_attach(device_t dev)
 230 {
 231         struct twa_softc        *sc = device_get_softc(dev);
 232         u_int32_t               command;
 233         int                     res_id;
 234         int                     error;
 235         dev_t                   xdev;
 236
 237         twa_dbg_dprint_enter(3, sc);
 238
 239         /* Initialize the softc structure. */
 240         sc->twa_bus_dev = dev;
 241
 242         sysctl_ctx_init(&sc->twa_sysctl_ctx);
 243         sc->twa_sysctl_tree = SYSCTL_ADD_NODE(&sc->twa_sysctl_ctx,
 244                                 SYSCTL_STATIC_CHILDREN(_hw), OID_AUTO,
 245                                 device_get_nameunit(dev), CTLFLAG_RD, 0, "");
 246         if (sc->twa_sysctl_tree == NULL) {
 247                 twa_printf(sc, "Cannot add sysctl tree node.\n");
 248                 return(ENXIO);
 249         }
 250         SYSCTL_ADD_STRING(&sc->twa_sysctl_ctx, SYSCTL_CHILDREN(sc->twa_sysctl_tree),
 251                                 OID_AUTO, "driver_version", CTLFLAG_RD,
 252                                 TWA_DRIVER_VERSION_STRING, 0, "TWA driver version");
 253
 254         /* Make sure we are going to be able to talk to this board. */
 255         command = pci_read_config(dev, PCIR_COMMAND, 2);
 256         if ((command & PCIM_CMD_PORTEN) == 0) {
 257                 twa_printf(sc, "Register window not available.\n");
 258                 return(ENXIO);
 259         }
 260
 261         /* Force the busmaster enable bit on, in case the BIOS forgot. */
 262         command |= PCIM_CMD_BUSMASTEREN;
 263         pci_write_config(dev, PCIR_COMMAND, command, 2);
 264
 265         /* Allocate the PCI register window. */
 266         res_id = TWA_IO_CONFIG_REG;
 267         if ((sc->twa_io_res = bus_alloc_resource(dev, SYS_RES_IOPORT, &res_id,
 268                                         0, ~0, 1, RF_ACTIVE)) == NULL) {
 269                 twa_printf(sc, "can't allocate register window.\n");
 270                 twa_free(sc);
 271                 return(ENXIO);
 272         }
 273         sc->twa_bus_tag = rman_get_bustag(sc->twa_io_res);
 274         sc->twa_bus_handle = rman_get_bushandle(sc->twa_io_res);
 275
 276         /* Allocate and connect our interrupt. */
 277         res_id = 0;
 278         if ((sc->twa_irq_res = bus_alloc_resource(sc->twa_bus_dev, SYS_RES_IRQ,
 279                                         &res_id, 0, ~0, 1,
 280                                         RF_SHAREABLE | RF_ACTIVE)) == NULL) {
 281                 twa_printf(sc, "Can't allocate interrupt.\n");
 282                 twa_free(sc);
 283                 return(ENXIO);
 284         }
 285         if (bus_setup_intr(sc->twa_bus_dev, sc->twa_irq_res, INTR_TYPE_CAM,
 286                                 twa_pci_intr, sc, &sc->twa_intr_handle)) {
 287                 twa_printf(sc, "Can't set up interrupt.\n");
 288                 twa_free(sc);
 289                 return(ENXIO);
 290         }
 291
 292         /* Initialize the driver for this controller. */
 293         if ((error = twa_setup(sc))) {
 294                 twa_free(sc);
 295                 return(error);
 296         }
 297
 298         /* Print some information about the controller and configuration. */
 299         twa_describe_controller(sc);
 300
 301         /* Create the control device. */
 302         cdevsw_add(&twa_cdevsw, -1, device_get_unit(sc->twa_bus_dev));
 303         xdev = make_dev(&twa_cdevsw, device_get_unit(sc->twa_bus_dev),
 304                         UID_ROOT, GID_OPERATOR, S_IRUSR | S_IWUSR,
 305                         "twa%d", device_get_unit(sc->twa_bus_dev));
 306         xdev->si_drv1 = sc;
 307
 308         /*
 309          * Schedule ourselves to bring the controller up once interrupts are
 310          * available.  This isn't strictly necessary, since we disable
 311          * interrupts while probing the controller, but it is more in keeping
 312          * with common practice for other disk devices.
 313          */
 314         sc->twa_ich.ich_func = twa_intrhook;
 315         sc->twa_ich.ich_arg = sc;
 316         sc->twa_ich.ich_desc = "twa";
 317         if (config_intrhook_establish(&sc->twa_ich) != 0) {
 318                 twa_printf(sc, "Can't establish configuration hook.\n");
 319                 twa_free(sc);
 320                 return(ENXIO);
 321         }
 322
 323         if ((error = twa_cam_setup(sc))) {
 324                 twa_free(sc);
 325                 return(error);
 326         }
 327         return(0);
 328 }
 329
 330
 331
 332 /*
 333  * Function name:       twa_free
 334  * Description:         Performs clean-up at the time of going down.
 335  *
 336  * Input:               sc      -- ptr to per ctlr structure
 337  * Output:              None
 338  * Return value:        None
 339  */
 340 static void
 341 twa_free(struct twa_softc *sc)
 342 {
 343         struct twa_request      *tr;
 344
 345         twa_dbg_dprint_enter(3, sc);
 346
 347         /* Detach from CAM */
 348         twa_cam_detach(sc);
 349
 350         /* Destroy dma handles. */
 351
 352         bus_dmamap_unload(sc->twa_dma_tag, sc->twa_cmd_map);
 353         while ((tr = twa_dequeue_free(sc)) != NULL)
 354                 bus_dmamap_destroy(sc->twa_dma_tag, tr->tr_dma_map);
 355
 356         /* Free all memory allocated so far. */
 357         if (sc->twa_req_buf)
 358                 free(sc->twa_req_buf, TWA_MALLOC_CLASS);
 359         if (sc->twa_cmd_pkt_buf)
 360                 bus_dmamem_free(sc->twa_dma_tag, sc->twa_cmd_pkt_buf,
 361                                         sc->twa_cmd_map);
 362         if (sc->twa_aen_queue[0])
 363                 free (sc->twa_aen_queue[0], M_DEVBUF);
 364
 365         /* Destroy the data-transfer DMA tag. */
 366         if (sc->twa_dma_tag)
 367                 bus_dma_tag_destroy(sc->twa_dma_tag);
 368
 369         /* Disconnect the interrupt handler. */
 370         if (sc->twa_intr_handle)
 371                 bus_teardown_intr(sc->twa_bus_dev, sc->twa_irq_res,
 372                                         sc->twa_intr_handle);
 373         if (sc->twa_irq_res != NULL)
 374                 bus_release_resource(sc->twa_bus_dev, SYS_RES_IRQ,
 375                                         0, sc->twa_irq_res);
 376
 377         /* Release the register window mapping. */
 378         if (sc->twa_io_res != NULL)
 379                 bus_release_resource(sc->twa_bus_dev, SYS_RES_IOPORT,
 380                                         TWA_IO_CONFIG_REG, sc->twa_io_res);
 381
 382         cdevsw_remove(&twa_cdevsw, -1, device_get_unit(sc->twa_bus_dev));
 383
 384         sysctl_ctx_free(&sc->twa_sysctl_ctx);
 385 }
 386
 387
 388
 389 /*
 390  * Function name:       twa_detach
 391  * Description:         Called when the controller is being detached from
 392  *                      the pci bus.
 393  *
 394  * Input:               dev     -- bus device corresponding to the ctlr
 395  * Output:              None
 396  * Return value:        0       -- success
 397  *                      non-zero-- failure
 398  */
 399 static int
 400 twa_detach(device_t dev)
 401 {
 402         struct twa_softc        *sc = device_get_softc(dev);
 403         int                     s;
 404         int                     error;
 405
 406         twa_dbg_dprint_enter(3, sc);
 407
 408         error = EBUSY;
 409         s = splcam();
 410         if (sc->twa_state & TWA_STATE_OPEN)
 411                 goto out;
 412
 413         /* Shut the controller down. */
 414         if ((error = twa_shutdown(dev)))
 415                 goto out;
 416
 417         /* Free all resources associated with this controller. */
 418         twa_free(sc);
 419         error = 0;
 420
 421 out:
 422         splx(s);
 423         return(error);
 424 }
 425
 426
 427
 428 /*
 429  * Function name:       twa_shutdown
 430  * Description:         Called at unload/shutdown time.  Lets the controller
 431  *                      know that we are going down.
 432  *
 433  * Input:               dev     -- bus device corresponding to the ctlr
 434  * Output:              None
 435  * Return value:        0       -- success
 436  *                      non-zero-- failure
 437  */
 438 static int
 439 twa_shutdown(device_t dev)
 440 {
 441         struct twa_softc        *sc = device_get_softc(dev);
 442         int                     s;
 443         int                     error = 0;
 444
 445         twa_dbg_dprint_enter(3, sc);
 446
 447         s = splcam();
 448
 449         /* Disconnect from the controller. */
 450         error = twa_deinit_ctlr(sc);
 451
 452         splx(s);
 453         return(error);
 454 }
 455
 456
 457
 458 /*
 459  * Function name:       twa_suspend
 460  * Description:         Called to suspend I/O before hot-swapping PCI ctlrs.
 461  *                      Doesn't do much as of now.
 462  *
 463  * Input:               dev     -- bus device corresponding to the ctlr
 464  * Output:              None
 465  * Return value:        0       -- success
 466  *                      non-zero-- failure
 467  */
 468 static int
 469 twa_suspend(device_t dev)
 470 {
 471         struct twa_softc        *sc = device_get_softc(dev);
 472         int                     s;
 473
 474         twa_dbg_dprint_enter(3, sc);
 475
 476         s = splcam();
 477         sc->twa_state |= TWA_STATE_SUSPEND;
 478
 479         twa_disable_interrupts(sc);
 480         splx(s);
 481
 482         return(1);
 483 }
 484
 485
 486
 487 /*
 488  * Function name:       twa_resume
 489  * Description:         Called to resume I/O after hot-swapping PCI ctlrs.
 490  *                      Doesn't do much as of now.
 491  *
 492  * Input:               dev     -- bus device corresponding to the ctlr
 493  * Output:              None
 494  * Return value:        0       -- success
 495  *                      non-zero-- failure
 496  */
 497 static int
 498 twa_resume(device_t dev)
 499 {
 500         struct twa_softc        *sc = device_get_softc(dev);
 501
 502         twa_dbg_dprint_enter(3, sc);
 503
 504         sc->twa_state &= ~TWA_STATE_SUSPEND;
 505         twa_enable_interrupts(sc);
 506
 507         return(1);
 508 }
 509
 510
 511
 512 /*
 513  * Function name:       twa_pci_intr
 514  * Description:         Interrupt handler.  Wrapper for twa_interrupt.
 515  *
 516  * Input:               arg     -- ptr to per ctlr structure
 517  * Output:              None
 518  * Return value:        None
 519  */
 520 static void
 521 twa_pci_intr(void *arg)
 522 {
 523         struct twa_softc        *sc = (struct twa_softc *)arg;
 524
 525         twa_interrupt(sc);
 526 }
 527
 528
 529
 530 /*
 531  * Function name:       twa_intrhook
 532  * Description:         Callback for us to enable interrupts.
 533  *
 534  * Input:               arg     -- ptr to per ctlr structure
 535  * Output:              None
 536  * Return value:        None
 537  */
 538 static void
 539 twa_intrhook(void *arg)
 540 {
 541         struct twa_softc        *sc = (struct twa_softc *)arg;
 542
 543         twa_dbg_dprint(4, sc, "twa_intrhook Entered");
 544
 545         /* Pull ourselves off the intrhook chain. */
 546         config_intrhook_disestablish(&sc->twa_ich);
 547
 548         /* Enable interrupts. */
 549         twa_enable_interrupts(sc);
 550 }
 551
 552
 553
 554 /*
 555  * Function name:       twa_write_pci_config
 556  * Description:         Writes to the PCI config space.
 557  *
 558  * Input:               sc      -- ptr to per ctlr structure
 559  *                      value   -- value to be written
 560  *                      size    -- # of bytes to be written
 561  * Output:              None
 562  * Return value:        None
 563  */
 564 void
 565 twa_write_pci_config(struct twa_softc *sc, u_int32_t value, int size)
 566 {
 567         pci_write_config(sc->twa_bus_dev, PCIR_STATUS, value, size);
 568 }
 569
 570
 571
 572 /*
 573  * Function name:       twa_alloc_req_pkts
 574  * Description:         Allocates memory for, and initializes request pkts,
 575  *                      and queues them in the free queue.
 576  *
 577  * Input:               sc      -- ptr to per ctlr structure
 578  *                      num_reqs-- # of request pkts to allocate and initialize.
 579  * Output:              None
 580  * Return value:        0       -- success
 581  *                      non-zero-- failure
 582  */
 583 int
 584 twa_alloc_req_pkts(struct twa_softc *sc, int num_reqs)
 585 {
 586         struct twa_request      *tr;
 587         int                     i;
 588
 589         sc->twa_req_buf = malloc(num_reqs * sizeof(struct twa_request),
 590                                         TWA_MALLOC_CLASS, M_INTWAIT);
 591
 592         /* Allocate the bus DMA tag appropriate for PCI. */
 593         if (bus_dma_tag_create(NULL,                    /* parent */
 594                                 TWA_ALIGNMENT,          /* alignment */
 595                                 0,                      /* boundary */
 596                                 BUS_SPACE_MAXADDR,      /* lowaddr */
 597                                 BUS_SPACE_MAXADDR,      /* highaddr */
 598                                 NULL, NULL,             /* filter, filterarg */
 599                                 TWA_Q_LENGTH *
 600                                 (sizeof(struct twa_command_packet)),/* maxsize */
 601                                 TWA_MAX_SG_ELEMENTS,    /* nsegments */
 602                                 BUS_SPACE_MAXSIZE_32BIT,/* maxsegsize */
 603                                 BUS_DMA_ALLOCNOW,       /* flags */
 604                                 &sc->twa_dma_tag        /* tag */)) {
 605                 twa_printf(sc, "Can't allocate DMA tag.\n");
 606                 return(ENOMEM);
 607         }
 608
 609         /* Allocate memory for cmd pkts. */
 610         if (bus_dmamem_alloc(sc->twa_dma_tag,
 611                                 (void *)(&(sc->twa_cmd_pkt_buf)),
 612                                 BUS_DMA_WAITOK, &(sc->twa_cmd_map)))
 613                 return(ENOMEM);
 614
 615         bus_dmamap_load(sc->twa_dma_tag, sc->twa_cmd_map,
 616                                 sc->twa_cmd_pkt_buf,
 617                                 num_reqs * sizeof(struct twa_command_packet),
 618                                 twa_setup_request_dmamap, sc, 0);
 619         bzero(sc->twa_req_buf, num_reqs * sizeof(struct twa_request));
 620         bzero(sc->twa_cmd_pkt_buf,
 621                         num_reqs * sizeof(struct twa_command_packet));
 622
 623         for (i = 0; i < num_reqs; i++) {
 624                 tr = &(sc->twa_req_buf[i]);
 625                 tr->tr_command = &(sc->twa_cmd_pkt_buf[i]);
 626                 tr->tr_cmd_phys = sc->twa_cmd_pkt_phys +
 627                                         (i * sizeof(struct twa_command_packet));
 628                 tr->tr_request_id = i;
 629                 tr->tr_sc = sc;
 630                 sc->twa_lookup[i] = tr;
 631
 632                 /*
 633                  * Create a map for data buffers.  maxsize (256 * 1024) used in
 634                  * bus_dma_tag_create above should suffice the bounce page needs
 635                  * for data buffers, since the max I/O size we support is 128KB.
 636                  * If we supported I/O's bigger than 256KB, we would have to
 637                  * create a second dma_tag, with the appropriate maxsize.
 638                  */
 639                 if (bus_dmamap_create(sc->twa_dma_tag, 0,
 640                                                 &tr->tr_dma_map))
 641                         return(ENOMEM);
 642
 643                 /* Insert request into the free queue. */
 644                 twa_release_request(tr);
 645         }
 646         return(0);
 647 }
 648
 649
 650
 651 /*
 652  * Function name:       twa_fillin_sgl
 653  * Description:         Fills in the scatter/gather list.
 654  *
 655  * Input:               sgl     -- ptr to sg list
 656  *                      segs    -- ptr to fill the sg list from
 657  *                      nsegments--# of segments
 658  * Output:              None
 659  * Return value:        None
 660  */
 661 static void
 662 twa_fillin_sgl(struct twa_sg *sgl, bus_dma_segment_t *segs, int nsegments)
 663 {
 664         int     i;
 665
 666         for (i = 0; i < nsegments; i++) {
 667                 sgl[i].address = segs[i].ds_addr;
 668                 sgl[i].length = segs[i].ds_len;
 669         }
 670 }
 671
 672
 673
 674 /*
 675  * Function name:       twa_setup_data_dmamap
 676  * Description:         Callback of bus_dmamap_load for the buffer associated
 677  *                      with data.  Updates the cmd pkt (size/sgl_entries
 678  *                      fields, as applicable) to reflect the number of sg
 679  *                      elements.
 680  *
 681  * Input:               arg     -- ptr to request pkt
 682  *                      segs    -- ptr to a list of segment descriptors
 683  *                      nsegments--# of segments
 684  *                      error   -- 0 if no errors encountered before callback,
 685  *                                 non-zero if errors were encountered
 686  * Output:              None
 687  * Return value:        None
 688  */
 689 static void
 690 twa_setup_data_dmamap(void *arg, bus_dma_segment_t *segs,
 691                                         int nsegments, int error)
 692 {
 693         struct twa_request              *tr = (struct twa_request *)arg;
 694         struct twa_command_packet       *cmdpkt = tr->tr_command;
 695         struct twa_command_9k           *cmd9k;
 696         union twa_command_7k            *cmd7k;
 697         u_int8_t                        sgl_offset;
 698
 699         twa_dbg_dprint_enter(10, tr->tr_sc);
 700
 701         if ((tr->tr_flags & TWA_CMD_IN_PROGRESS) &&
 702                         (tr->tr_cmd_pkt_type & TWA_CMD_PKT_TYPE_EXTERNAL))
 703                 twa_allow_new_requests(tr->tr_sc, (void *)(tr->tr_private));
 704
 705         if (error == EFBIG) {
 706                 tr->tr_error = error;
 707                 goto out;
 708         }
 709
 710         if (tr->tr_cmd_pkt_type & TWA_CMD_PKT_TYPE_9K) {
 711                 cmd9k = &(cmdpkt->command.cmd_pkt_9k);
 712                 twa_fillin_sgl(&(cmd9k->sg_list[0]), segs, nsegments);
 713                 cmd9k->sgl_entries += nsegments - 1;
 714         } else {
 715                 /* It's a 7000 command packet. */
 716                 cmd7k = &(cmdpkt->command.cmd_pkt_7k);
 717                 if ((sgl_offset = cmdpkt->command.cmd_pkt_7k.generic.sgl_offset))
 718                         twa_fillin_sgl((struct twa_sg *)
 719                                         (((u_int32_t *)cmd7k) + sgl_offset),
 720                                         segs, nsegments);
 721                 /* Modify the size field, based on sg address size. */
 722                 cmd7k->generic.size +=
 723                                 ((TWA_64BIT_ADDRESSES ? 3 : 2) * nsegments);
 724         }
 725
 726         if (tr->tr_flags & TWA_CMD_DATA_IN)
 727                 bus_dmamap_sync(tr->tr_sc->twa_dma_tag, tr->tr_dma_map,
 728                                                         BUS_DMASYNC_PREREAD);
 729         if (tr->tr_flags & TWA_CMD_DATA_OUT) {
 730                 /*
 731                  * If we're using an alignment buffer, and we're
 732                  * writing data, copy the real data out.
 733                  */
 734                 if (tr->tr_flags & TWA_CMD_DATA_COPY_NEEDED)
 735                         bcopy(tr->tr_real_data, tr->tr_data, tr->tr_real_length);
 736                 bus_dmamap_sync(tr->tr_sc->twa_dma_tag, tr->tr_dma_map,
 737                                                 BUS_DMASYNC_PREWRITE);
 738         }
 739         error = twa_submit_io(tr);
 740
 741 out:
 742         if (error) {
 743                 twa_unmap_request(tr);
 744                 /*
 745                  * If the caller had been returned EINPROGRESS, and he has
 746                  * registered a callback for handling completion, the callback
 747                  * will never get called because we were unable to submit the
 748                  * request.  So, free up the request right here.
 749                  */
 750                 if ((tr->tr_flags & TWA_CMD_IN_PROGRESS) && (tr->tr_callback))
 751                         twa_release_request(tr);
 752         }
 753 }
 754
 755
 756
 757 /*
 758  * Function name:       twa_setup_request_dmamap
 759  * Description:         Callback of bus_dmamap_load for the buffer associated
 760  *                      with a cmd pkt.
 761  *
 762  * Input:               arg     -- ptr to request pkt
 763  *                      segs    -- ptr to a list of segment descriptors
 764  *                      nsegments--# of segments
 765  *                      error   -- 0 if no errors encountered before callback,
 766  *                                 non-zero if errors were encountered
 767  * Output:              None
 768  * Return value:        None
 769  */
 770 static void
 771 twa_setup_request_dmamap(void *arg, bus_dma_segment_t *segs,
 772                                                 int nsegments, int error)
 773 {
 774         struct twa_softc        *sc = (struct twa_softc *)arg;
 775
 776         twa_dbg_dprint_enter(10, sc);
 777
 778         sc->twa_cmd_pkt_phys = segs[0].ds_addr;
 779 }
 780
 781
 782
 783 /*
 784  * Function name:       twa_map_request
 785  * Description:         Maps a cmd pkt and data associated with it, into
 786  *                      DMA'able memory.
 787  *
 788  * Input:               tr      -- ptr to request pkt
 789  * Output:              None
 790  * Return value:        0       -- success
 791  *                      non-zero-- failure
 792  */
 793 int
 794 twa_map_request(struct twa_request *tr)
 795 {
 796         struct twa_softc        *sc = tr->tr_sc;
 797         int                     error = 0;
 798
 799         twa_dbg_dprint_enter(10, sc);
 800
 801         /* If the command involves data, map that too. */
 802         if (tr->tr_data != NULL) {
 803                 /*
 804                  * It's sufficient for the data pointer to be 4-byte aligned
 805                  * to work with 9000.  However, if 4-byte aligned addresses
 806                  * are passed to bus_dmamap_load, we can get back sg elements
 807                  * that are not 512-byte multiples in size.  So, we will let
 808                  * only those buffers that are 512-byte aligned to pass
 809                  * through, and bounce the rest, so as to make sure that we
 810                  * always get back sg elements that are 512-byte multiples
 811                  * in size.
 812                  */
 813                 if (((vm_offset_t)tr->tr_data % 512) || (tr->tr_length % 512)) {
 814                         tr->tr_flags |= TWA_CMD_DATA_COPY_NEEDED;
 815                         tr->tr_real_data = tr->tr_data; /* save original data pointer */
 816                         tr->tr_real_length = tr->tr_length; /* save original data length */
 817                         tr->tr_length = (tr->tr_length + 511) & ~511;
 818                         tr->tr_data = malloc(tr->tr_length, TWA_MALLOC_CLASS, M_INTWAIT);
 819                 }
 820
 821                 /*
 822                  * Map the data buffer into bus space and build the s/g list.
 823                  */
 824                 if ((error = bus_dmamap_load(sc->twa_dma_tag, tr->tr_dma_map,
 825                                         tr->tr_data, tr->tr_length,
 826                                         twa_setup_data_dmamap, tr,
 827                                         BUS_DMA_WAITOK))) {
 828                         if (error == EINPROGRESS) {
 829                                 tr->tr_flags |= TWA_CMD_IN_PROGRESS;
 830                                 if (tr->tr_cmd_pkt_type & TWA_CMD_PKT_TYPE_EXTERNAL)
 831                                         twa_disallow_new_requests(sc);
 832                                 error = 0;
 833                         } else {
 834                                 /* Free alignment buffer if it was used. */
 835                                 if (tr->tr_flags & TWA_CMD_DATA_COPY_NEEDED) {
 836                                         free(tr->tr_data, TWA_MALLOC_CLASS);
 837                                         tr->tr_data = tr->tr_real_data; /* restore 'real' data pointer */
 838                                         tr->tr_length = tr->tr_real_length;/* restore 'real' data length */
 839                                 }
 840                         }
 841                 } else
 842                         error = tr->tr_error;
 843
 844         } else
 845                 if ((error = twa_submit_io(tr)))
 846                         twa_unmap_request(tr);
 847
 848         return(error);
 849 }
 850
 851
 852
 853 /*
 854  * Function name:       twa_unmap_request
 855  * Description:         Undoes the mapping done by twa_map_request.
 856  *
 857  * Input:               tr      -- ptr to request pkt
 858  * Output:              None
 859  * Return value:        None
 860  */
 861 void
 862 twa_unmap_request(struct twa_request *tr)
 863 {
 864         struct twa_softc        *sc = tr->tr_sc;
 865         u_int8_t                cmd_status;
 866
 867         twa_dbg_dprint_enter(10, sc);
 868
 869         /* If the command involved data, unmap that too. */
 870         if (tr->tr_data != NULL) {
 871                 if (tr->tr_cmd_pkt_type & TWA_CMD_PKT_TYPE_9K)
 872                         cmd_status = tr->tr_command->command.cmd_pkt_9k.status;
 873                 else
 874                         cmd_status = tr->tr_command->command.cmd_pkt_7k.generic.status;
 875
 876                 if (tr->tr_flags & TWA_CMD_DATA_IN) {
 877                         bus_dmamap_sync(sc->twa_dma_tag,
 878                                         tr->tr_dma_map, BUS_DMASYNC_POSTREAD);
 879
 880                         /*
 881                          * If we are using a bounce buffer, and we are reading
 882                          * data, copy the real data in.
 883                          */
 884                         if (tr->tr_flags & TWA_CMD_DATA_COPY_NEEDED)
 885                                 if (cmd_status == 0)
 886                                         bcopy(tr->tr_data, tr->tr_real_data,
 887                                                         tr->tr_real_length);
 888                 }
 889                 if (tr->tr_flags & TWA_CMD_DATA_OUT)
 890                         bus_dmamap_sync(sc->twa_dma_tag, tr->tr_dma_map,
 891                                                         BUS_DMASYNC_POSTWRITE);
 892
 893                 bus_dmamap_unload(sc->twa_dma_tag, tr->tr_dma_map);
 894         }
 895
 896         /* Free alignment buffer if it was used. */
 897         if (tr->tr_flags & TWA_CMD_DATA_COPY_NEEDED) {
 898                 free(tr->tr_data, TWA_MALLOC_CLASS);
 899                 tr->tr_data = tr->tr_real_data; /* restore 'real' data pointer */
 900                 tr->tr_length = tr->tr_real_length;/* restore 'real' data length */
 901         }
 902 }
 903
 904
 905
 906 #ifdef TWA_DEBUG
 907 void    twa_report(void);
 908 void    twa_reset_stats(void);
 909 void    twa_print_request(struct twa_request *tr, int req_type);
 910
 911
 912
 913 /*
 914  * Function name:       twa_report
 915  * Description:         For being called from ddb.  Prints controller stats,
 916  *                      and requests, if any, that are in the wrong queue.
 917  *
 918  * Input:               None
 919  * Output:              None
 920  * Return value:        None
 921  */
 922 void
 923 twa_report(void)
 924 {
 925         struct twa_softc        *sc;
 926         struct twa_request      *tr;
 927         int                     s;
 928         int                     i;
 929
 930         s = splcam();
 931         for (i = 0; (sc = devclass_get_softc(twa_devclass, i)) != NULL; i++) {
 932                 twa_print_controller(sc);
 933                 TAILQ_FOREACH(tr, &sc->twa_busy, tr_link)
 934                         twa_print_request(tr, TWA_CMD_BUSY);
 935                 TAILQ_FOREACH(tr, &sc->twa_complete, tr_link)
 936                         twa_print_request(tr, TWA_CMD_COMPLETE);
 937         }
 938         splx(s);
 939 }
 940
 941
 942
 943 /*
 944  * Function name:       twa_reset_stats
 945  * Description:         For being called from ddb.
 946  *                      Resets some controller stats.
 947  *
 948  * Input:               None
 949  * Output:              None
 950  * Return value:        None
 951  */
 952 void
 953 twa_reset_stats(void)
 954 {
 955         struct twa_softc        *sc;
 956         int                     s;
 957         int                     i;
 958
 959         s = splcam();
 960         for (i = 0; (sc = devclass_get_softc(twa_devclass, i)) != NULL; i++) {
 961                 sc->twa_qstats[TWAQ_FREE].q_max = 0;
 962                 sc->twa_qstats[TWAQ_BUSY].q_max = 0;
 963                 sc->twa_qstats[TWAQ_PENDING].q_max = 0;
 964                 sc->twa_qstats[TWAQ_COMPLETE].q_max = 0;
 965         }
 966         splx(s);
 967 }
 968
 969
 970
 971 /*
 972  * Function name:       twa_print_request
 973  * Description:         Prints a given request if it's in the wrong queue.
 974  *
 975  * Input:               tr      -- ptr to request pkt
 976  *                      req_type-- expected status of the given request
 977  * Output:              None
 978  * Return value:        None
 979  */
 980 void
 981 twa_print_request(struct twa_request *tr, int req_type)
 982 {
 983         struct twa_softc                *sc = tr->tr_sc;
 984         struct twa_command_packet       *cmdpkt = tr->tr_command;
 985         struct twa_command_9k           *cmd9k;
 986         union twa_command_7k            *cmd7k;
 987         u_int8_t                        *cdb;
 988         int                             cmd_phys_addr;
 989
 990         if (tr->tr_status != req_type) {
 991                 twa_printf(sc, "Invalid %s request %p in queue! req_type = %x, queue_type = %x\n",
 992                         (tr->tr_cmd_pkt_type & TWA_CMD_PKT_TYPE_INTERNAL) ? "INTERNAL" : "EXTERNAL",
 993                         tr, tr->tr_status, req_type);
 994
 995                 if (tr->tr_cmd_pkt_type & TWA_CMD_PKT_TYPE_9K) {
 996                         cmd9k = &(cmdpkt->command.cmd_pkt_9k);
 997                         cmd_phys_addr = cmd9k->sg_list[0].address;
 998                         twa_printf(sc, "9K cmd = %x %x %x %x %x %x %x %x %x\n",
 999                                         cmd9k->command.opcode,
1000                                         cmd9k->command.reserved,
1001                                         cmd9k->unit,
1002                                         cmd9k->request_id,
1003                                         cmd9k->status,
1004                                         cmd9k->sgl_offset,
1005                                         cmd9k->sgl_entries,
1006                                         cmd_phys_addr,
1007                                         cmd9k->sg_list[0].length);
1008                         cdb = (u_int8_t *)(cmdpkt->command.cmd_pkt_9k.cdb);
1009                         twa_printf(sc, "cdb = %x %x %x %x %x %x %x %x %x %x %x %x %x %x %x %x\n",
1010                                 cdb[0], cdb[1], cdb[2], cdb[3], cdb[4], cdb[5], cdb[6], cdb[7],
1011                                 cdb[8], cdb[9], cdb[10], cdb[11], cdb[12], cdb[13], cdb[14], cdb[15]);
1012                 } else {
1013                         cmd7k = &(cmdpkt->command.cmd_pkt_7k);
1014                         twa_printf(sc, "7K cmd = %x %x %x %x %x %x %x %x %x\n",
1015                                         cmd7k->generic.opcode,
1016                                         cmd7k->generic.sgl_offset,
1017                                         cmd7k->generic.size,
1018                                         cmd7k->generic.request_id,
1019                                         cmd7k->generic.unit,
1020                                         cmd7k->generic.host_id,
1021                                         cmd7k->generic.status,
1022                                         cmd7k->generic.flags,
1023                                         cmd7k->generic.count);
1024                 }
1025
1026                 cmd_phys_addr = (int)(tr->tr_cmd_phys);
1027                 twa_printf(sc, "cmdphys=0x%x data=%p length=0x%x\n",
1028                                 cmd_phys_addr, tr->tr_data, tr->tr_length);
1029                 twa_printf(sc, "req_id=0x%x flags=0x%x callback=%p private=%p\n",
1030                                         tr->tr_request_id, tr->tr_flags,
1031                                         tr->tr_callback, tr->tr_private);
1032         }
1033 }
1034 #endif