sys/dev/terasic/de4led/terasic_de4led_nexus.c

   1 /*-
   2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
   3  *
   4  * Copyright (c) 2012 Robert N. M. Watson
   5  * All rights reserved.
   6  *
   7  * This software was developed by SRI International and the University of
   8  * Cambridge Computer Laboratory under DARPA/AFRL contract (FA8750-10-C-0237)
   9  * ("CTSRD"), as part of the DARPA CRASH research programme.
  10  *
  11  * Redistribution and use in source and binary forms, with or without
  12  * modification, are permitted provided that the following conditions
  13  * are met:
  14  * 1. Redistributions of source code must retain the above copyright
  15  *    notice, this list of conditions and the following disclaimer.
  16  * 2. Redistributions in binary form must reproduce the above copyright
  17  *    notice, this list of conditions and the following disclaimer in the
  18  *    documentation and/or other materials provided with the distribution.
  19  *
  20  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30  * SUCH DAMAGE.
  31  */
  32
  33 #include <sys/cdefs.h>
  34 __FBSDID("$FreeBSD$");
  35
  36 #include <sys/param.h>
  37 #include <sys/bus.h>
  38 #include <sys/condvar.h>
  39 #include <sys/conf.h>
  40 #include <sys/bio.h>
  41 #include <sys/kernel.h>
  42 #include <sys/lock.h>
  43 #include <sys/malloc.h>
  44 #include <sys/module.h>
  45 #include <sys/mutex.h>
  46 #include <sys/rman.h>
  47 #include <sys/systm.h>
  48
  49 #include <machine/bus.h>
  50 #include <machine/resource.h>
  51
  52 #include <dev/terasic/de4led/terasic_de4led.h>
  53
  54 /*
  55  * Nexus bus attachment for the 8-element LED on the Terasic DE-4 FPGA board,
  56  * which is hooked up to the processor via a memory-mapped Avalon bus.
  57  */
  58 static int
  59 terasic_de4led_nexus_probe(device_t dev)
  60 {
  61
  62         device_set_desc(dev, "Terasic DE4 8-element LED");
  63         return (BUS_PROBE_NOWILDCARD);
  64 }
  65
  66 static int
  67 terasic_de4led_nexus_attach(device_t dev)
  68 {
  69         struct terasic_de4led_softc *sc;
  70
  71         sc = device_get_softc(dev);
  72         sc->tdl_dev = dev;
  73         sc->tdl_unit = device_get_unit(dev);
  74         sc->tdl_rid = 0;
  75         sc->tdl_res = bus_alloc_resource_any(dev, SYS_RES_MEMORY,
  76             &sc->tdl_rid, RF_ACTIVE);
  77         if (sc->tdl_res == NULL) {
  78                 device_printf(dev, "couldn't map memory\n");
  79                 return (ENXIO);
  80         }
  81         terasic_de4led_attach(sc);
  82         return (0);
  83 }
  84
  85 static int
  86 terasic_de4led_nexus_detach(device_t dev)
  87 {
  88         struct terasic_de4led_softc *sc;
  89
  90         sc = device_get_softc(dev);
  91         KASSERT(sc->tdl_res != NULL, ("%s: resources not allocated",
  92             __func__));
  93         terasic_de4led_detach(sc);
  94         bus_release_resource(dev, SYS_RES_MEMORY, sc->tdl_rid, sc->tdl_res);
  95         return (0);
  96 }
  97
  98 static device_method_t terasic_de4led_nexus_methods[] = {
  99         DEVMETHOD(device_probe,         terasic_de4led_nexus_probe),
 100         DEVMETHOD(device_attach,        terasic_de4led_nexus_attach),
 101         DEVMETHOD(device_detach,        terasic_de4led_nexus_detach),
 102         { 0, 0 }
 103 };
 104
 105 static driver_t terasic_de4led_nexus_driver = {
 106         "terasic_de4led",
 107         terasic_de4led_nexus_methods,
 108         sizeof(struct terasic_de4led_softc),
 109 };
 110
 111 DRIVER_MODULE(terasic_de4led, nexus, terasic_de4led_nexus_driver,
 112     terasic_de4led_devclass, 0, 0);