2 * Copyright (c) 2012 Oleksandr Tymoshenko <gonzo@freebsd.org>
3 * Copyright (c) 2012 Luiz Otavio O Souza.
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
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.
15 * THIS SOFTWARE IS PROVIDED BY THE 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 THE 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
28 #include <sys/cdefs.h>
29 __FBSDID("$FreeBSD$");
31 #include <sys/param.h>
32 #include <sys/systm.h>
35 #include <sys/kernel.h>
36 #include <sys/module.h>
39 #include <sys/mutex.h>
41 #include <sys/sysctl.h>
43 #include <machine/bus.h>
44 #include <machine/cpu.h>
45 #include <machine/cpufunc.h>
46 #include <machine/resource.h>
47 #include <machine/fdt.h>
48 #include <machine/intr.h>
50 #include <dev/fdt/fdt_common.h>
51 #include <dev/ofw/ofw_bus.h>
52 #include <dev/ofw/ofw_bus_subr.h>
54 #include <arm/broadcom/bcm2835/bcm2835_gpio.h>
61 #define dprintf(fmt, args...) do { printf("%s(): ", __func__); \
62 printf(fmt,##args); } while (0)
64 #define dprintf(fmt, args...)
67 #define BCM_GPIO_PINS 54
68 #define BCM_GPIO_DEFAULT_CAPS (GPIO_PIN_INPUT | GPIO_PIN_OUTPUT | \
69 GPIO_PIN_PULLUP | GPIO_PIN_PULLDOWN)
71 struct bcm_gpio_sysctl {
72 struct bcm_gpio_softc *sc;
76 struct bcm_gpio_softc {
79 struct resource * sc_mem_res;
80 struct resource * sc_irq_res;
81 bus_space_tag_t sc_bst;
82 bus_space_handle_t sc_bsh;
86 int sc_ro_pins[BCM_GPIO_PINS];
87 struct gpio_pin sc_gpio_pins[BCM_GPIO_PINS];
88 struct bcm_gpio_sysctl sc_sysctl[BCM_GPIO_PINS];
97 #define BCM_GPIO_LOCK(_sc) mtx_lock(&_sc->sc_mtx)
98 #define BCM_GPIO_UNLOCK(_sc) mtx_unlock(&_sc->sc_mtx)
99 #define BCM_GPIO_LOCK_ASSERT(_sc) mtx_assert(&_sc->sc_mtx, MA_OWNED)
101 #define BCM_GPIO_GPFSEL(_bank) 0x00 + _bank * 4
102 #define BCM_GPIO_GPSET(_bank) 0x1c + _bank * 4
103 #define BCM_GPIO_GPCLR(_bank) 0x28 + _bank * 4
104 #define BCM_GPIO_GPLEV(_bank) 0x34 + _bank * 4
105 #define BCM_GPIO_GPPUD(_bank) 0x94
106 #define BCM_GPIO_GPPUDCLK(_bank) 0x98 + _bank * 4
108 #define BCM_GPIO_WRITE(_sc, _off, _val) \
109 bus_space_write_4(_sc->sc_bst, _sc->sc_bsh, _off, _val)
110 #define BCM_GPIO_READ(_sc, _off) \
111 bus_space_read_4(_sc->sc_bst, _sc->sc_bsh, _off)
114 bcm_gpio_pin_is_ro(struct bcm_gpio_softc *sc, int pin)
118 for (i = 0; i < sc->sc_ro_npins; i++)
119 if (pin == sc->sc_ro_pins[i])
125 bcm_gpio_get_function(struct bcm_gpio_softc *sc, uint32_t pin)
127 uint32_t bank, func, offset;
129 /* Five banks, 10 pins per bank, 3 bits per pin. */
131 offset = (pin - bank * 10) * 3;
134 func = (BCM_GPIO_READ(sc, BCM_GPIO_GPFSEL(bank)) >> offset) & 7;
141 bcm_gpio_func_str(uint32_t nfunc, char *buf, int bufsize)
146 strncpy(buf, "input", bufsize);
148 case BCM_GPIO_OUTPUT:
149 strncpy(buf, "output", bufsize);
152 strncpy(buf, "alt0", bufsize);
155 strncpy(buf, "alt1", bufsize);
158 strncpy(buf, "alt2", bufsize);
161 strncpy(buf, "alt3", bufsize);
164 strncpy(buf, "alt4", bufsize);
167 strncpy(buf, "alt5", bufsize);
170 strncpy(buf, "invalid", bufsize);
175 bcm_gpio_str_func(char *func, uint32_t *nfunc)
178 if (strcasecmp(func, "input") == 0)
179 *nfunc = BCM_GPIO_INPUT;
180 else if (strcasecmp(func, "output") == 0)
181 *nfunc = BCM_GPIO_OUTPUT;
182 else if (strcasecmp(func, "alt0") == 0)
183 *nfunc = BCM_GPIO_ALT0;
184 else if (strcasecmp(func, "alt1") == 0)
185 *nfunc = BCM_GPIO_ALT1;
186 else if (strcasecmp(func, "alt2") == 0)
187 *nfunc = BCM_GPIO_ALT2;
188 else if (strcasecmp(func, "alt3") == 0)
189 *nfunc = BCM_GPIO_ALT3;
190 else if (strcasecmp(func, "alt4") == 0)
191 *nfunc = BCM_GPIO_ALT4;
192 else if (strcasecmp(func, "alt5") == 0)
193 *nfunc = BCM_GPIO_ALT5;
201 bcm_gpio_func_flag(uint32_t nfunc)
206 return (GPIO_PIN_INPUT);
207 case BCM_GPIO_OUTPUT:
208 return (GPIO_PIN_OUTPUT);
214 bcm_gpio_set_function(struct bcm_gpio_softc *sc, uint32_t pin, uint32_t f)
216 uint32_t bank, data, offset;
218 /* Must be called with lock held. */
219 BCM_GPIO_LOCK_ASSERT(sc);
221 /* Five banks, 10 pins per bank, 3 bits per pin. */
223 offset = (pin - bank * 10) * 3;
225 data = BCM_GPIO_READ(sc, BCM_GPIO_GPFSEL(bank));
226 data &= ~(7 << offset);
227 data |= (f << offset);
228 BCM_GPIO_WRITE(sc, BCM_GPIO_GPFSEL(bank), data);
232 bcm_gpio_set_pud(struct bcm_gpio_softc *sc, uint32_t pin, uint32_t state)
234 uint32_t bank, offset;
236 /* Must be called with lock held. */
237 BCM_GPIO_LOCK_ASSERT(sc);
240 offset = pin - 32 * bank;
242 BCM_GPIO_WRITE(sc, BCM_GPIO_GPPUD(0), state);
244 BCM_GPIO_WRITE(sc, BCM_GPIO_GPPUDCLK(bank), (1 << offset));
246 BCM_GPIO_WRITE(sc, BCM_GPIO_GPPUD(0), 0);
247 BCM_GPIO_WRITE(sc, BCM_GPIO_GPPUDCLK(bank), 0);
251 bcm_gpio_set_alternate(device_t dev, uint32_t pin, uint32_t nfunc)
253 struct bcm_gpio_softc *sc;
256 sc = device_get_softc(dev);
259 /* Disable pull-up or pull-down on pin. */
260 bcm_gpio_set_pud(sc, pin, BCM_GPIO_NONE);
262 /* And now set the pin function. */
263 bcm_gpio_set_function(sc, pin, nfunc);
265 /* Update the pin flags. */
266 for (i = 0; i < sc->sc_gpio_npins; i++) {
267 if (sc->sc_gpio_pins[i].gp_pin == pin)
270 if (i < sc->sc_gpio_npins)
271 sc->sc_gpio_pins[i].gp_flags = bcm_gpio_func_flag(nfunc);
277 bcm_gpio_pin_configure(struct bcm_gpio_softc *sc, struct gpio_pin *pin,
284 * Manage input/output.
286 if (flags & (GPIO_PIN_INPUT|GPIO_PIN_OUTPUT)) {
287 pin->gp_flags &= ~(GPIO_PIN_INPUT|GPIO_PIN_OUTPUT);
288 if (flags & GPIO_PIN_OUTPUT) {
289 pin->gp_flags |= GPIO_PIN_OUTPUT;
290 bcm_gpio_set_function(sc, pin->gp_pin,
293 pin->gp_flags |= GPIO_PIN_INPUT;
294 bcm_gpio_set_function(sc, pin->gp_pin,
299 /* Manage Pull-up/pull-down. */
300 pin->gp_flags &= ~(GPIO_PIN_PULLUP|GPIO_PIN_PULLDOWN);
301 if (flags & (GPIO_PIN_PULLUP|GPIO_PIN_PULLDOWN)) {
302 if (flags & GPIO_PIN_PULLUP) {
303 pin->gp_flags |= GPIO_PIN_PULLUP;
304 bcm_gpio_set_pud(sc, pin->gp_pin, BCM_GPIO_PULLUP);
306 pin->gp_flags |= GPIO_PIN_PULLDOWN;
307 bcm_gpio_set_pud(sc, pin->gp_pin, BCM_GPIO_PULLDOWN);
310 bcm_gpio_set_pud(sc, pin->gp_pin, BCM_GPIO_NONE);
316 bcm_gpio_pin_max(device_t dev, int *maxpin)
319 *maxpin = BCM_GPIO_PINS - 1;
324 bcm_gpio_pin_getcaps(device_t dev, uint32_t pin, uint32_t *caps)
326 struct bcm_gpio_softc *sc = device_get_softc(dev);
329 for (i = 0; i < sc->sc_gpio_npins; i++) {
330 if (sc->sc_gpio_pins[i].gp_pin == pin)
334 if (i >= sc->sc_gpio_npins)
338 *caps = sc->sc_gpio_pins[i].gp_caps;
345 bcm_gpio_pin_getflags(device_t dev, uint32_t pin, uint32_t *flags)
347 struct bcm_gpio_softc *sc = device_get_softc(dev);
350 for (i = 0; i < sc->sc_gpio_npins; i++) {
351 if (sc->sc_gpio_pins[i].gp_pin == pin)
355 if (i >= sc->sc_gpio_npins)
359 *flags = sc->sc_gpio_pins[i].gp_flags;
366 bcm_gpio_pin_getname(device_t dev, uint32_t pin, char *name)
368 struct bcm_gpio_softc *sc = device_get_softc(dev);
371 for (i = 0; i < sc->sc_gpio_npins; i++) {
372 if (sc->sc_gpio_pins[i].gp_pin == pin)
376 if (i >= sc->sc_gpio_npins)
380 memcpy(name, sc->sc_gpio_pins[i].gp_name, GPIOMAXNAME);
387 bcm_gpio_pin_setflags(device_t dev, uint32_t pin, uint32_t flags)
389 struct bcm_gpio_softc *sc = device_get_softc(dev);
392 for (i = 0; i < sc->sc_gpio_npins; i++) {
393 if (sc->sc_gpio_pins[i].gp_pin == pin)
397 if (i >= sc->sc_gpio_npins)
400 /* We never touch on read-only/reserved pins. */
401 if (bcm_gpio_pin_is_ro(sc, pin))
404 /* Check for unwanted flags. */
405 if ((flags & sc->sc_gpio_pins[i].gp_caps) != flags)
408 /* Can't mix input/output together. */
409 if ((flags & (GPIO_PIN_INPUT|GPIO_PIN_OUTPUT)) ==
410 (GPIO_PIN_INPUT|GPIO_PIN_OUTPUT))
413 /* Can't mix pull-up/pull-down together. */
414 if ((flags & (GPIO_PIN_PULLUP|GPIO_PIN_PULLDOWN)) ==
415 (GPIO_PIN_PULLUP|GPIO_PIN_PULLDOWN))
418 bcm_gpio_pin_configure(sc, &sc->sc_gpio_pins[i], flags);
424 bcm_gpio_pin_set(device_t dev, uint32_t pin, unsigned int value)
426 struct bcm_gpio_softc *sc = device_get_softc(dev);
427 uint32_t bank, offset;
430 for (i = 0; i < sc->sc_gpio_npins; i++) {
431 if (sc->sc_gpio_pins[i].gp_pin == pin)
435 if (i >= sc->sc_gpio_npins)
438 /* We never write to read-only/reserved pins. */
439 if (bcm_gpio_pin_is_ro(sc, pin))
443 offset = pin - 32 * bank;
447 BCM_GPIO_WRITE(sc, BCM_GPIO_GPSET(bank), (1 << offset));
449 BCM_GPIO_WRITE(sc, BCM_GPIO_GPCLR(bank), (1 << offset));
456 bcm_gpio_pin_get(device_t dev, uint32_t pin, unsigned int *val)
458 struct bcm_gpio_softc *sc = device_get_softc(dev);
459 uint32_t bank, offset, reg_data;
462 for (i = 0; i < sc->sc_gpio_npins; i++) {
463 if (sc->sc_gpio_pins[i].gp_pin == pin)
467 if (i >= sc->sc_gpio_npins)
471 offset = pin - 32 * bank;
474 reg_data = BCM_GPIO_READ(sc, BCM_GPIO_GPLEV(bank));
476 *val = (reg_data & (1 << offset)) ? 1 : 0;
482 bcm_gpio_pin_toggle(device_t dev, uint32_t pin)
484 struct bcm_gpio_softc *sc = device_get_softc(dev);
485 uint32_t bank, data, offset;
488 for (i = 0; i < sc->sc_gpio_npins; i++) {
489 if (sc->sc_gpio_pins[i].gp_pin == pin)
493 if (i >= sc->sc_gpio_npins)
496 /* We never write to read-only/reserved pins. */
497 if (bcm_gpio_pin_is_ro(sc, pin))
501 offset = pin - 32 * bank;
504 data = BCM_GPIO_READ(sc, BCM_GPIO_GPLEV(bank));
505 if (data & (1 << offset))
506 BCM_GPIO_WRITE(sc, BCM_GPIO_GPCLR(bank), (1 << offset));
508 BCM_GPIO_WRITE(sc, BCM_GPIO_GPSET(bank), (1 << offset));
515 bcm_gpio_get_ro_pins(struct bcm_gpio_softc *sc)
518 pcell_t pins[BCM_GPIO_PINS];
521 /* Find the gpio node to start. */
522 gpio = ofw_bus_get_node(sc->sc_dev);
524 len = OF_getproplen(gpio, "broadcom,read-only");
525 if (len < 0 || len > sizeof(pins))
528 if (OF_getprop(gpio, "broadcom,read-only", &pins, len) < 0)
531 sc->sc_ro_npins = len / sizeof(pcell_t);
533 device_printf(sc->sc_dev, "read-only pins: ");
534 for (i = 0; i < sc->sc_ro_npins; i++) {
535 sc->sc_ro_pins[i] = fdt32_to_cpu(pins[i]);
538 printf("%d", sc->sc_ro_pins[i]);
548 bcm_gpio_func_proc(SYSCTL_HANDLER_ARGS)
551 struct bcm_gpio_softc *sc;
552 struct bcm_gpio_sysctl *sc_sysctl;
559 /* Get the current pin function. */
560 nfunc = bcm_gpio_get_function(sc, sc_sysctl->pin);
561 bcm_gpio_func_str(nfunc, buf, sizeof(buf));
563 error = sysctl_handle_string(oidp, buf, sizeof(buf), req);
564 if (error != 0 || req->newptr == NULL)
567 /* Parse the user supplied string and check for a valid pin function. */
568 if (bcm_gpio_str_func(buf, &nfunc) != 0)
571 /* Update the pin alternate function. */
572 bcm_gpio_set_alternate(sc->sc_dev, sc_sysctl->pin, nfunc);
578 bcm_gpio_sysctl_init(struct bcm_gpio_softc *sc)
581 struct bcm_gpio_sysctl *sc_sysctl;
582 struct sysctl_ctx_list *ctx;
583 struct sysctl_oid *tree_node, *pin_node, *pinN_node;
584 struct sysctl_oid_list *tree, *pin_tree, *pinN_tree;
588 * Add per-pin sysctl tree/handlers.
590 ctx = device_get_sysctl_ctx(sc->sc_dev);
591 tree_node = device_get_sysctl_tree(sc->sc_dev);
592 tree = SYSCTL_CHILDREN(tree_node);
593 pin_node = SYSCTL_ADD_NODE(ctx, tree, OID_AUTO, "pin",
594 CTLFLAG_RW, NULL, "GPIO Pins");
595 pin_tree = SYSCTL_CHILDREN(pin_node);
597 for (i = 0; i < sc->sc_gpio_npins; i++) {
599 snprintf(pinbuf, sizeof(pinbuf), "%d", i);
600 pinN_node = SYSCTL_ADD_NODE(ctx, pin_tree, OID_AUTO, pinbuf,
601 CTLFLAG_RD, NULL, "GPIO Pin");
602 pinN_tree = SYSCTL_CHILDREN(pinN_node);
604 sc->sc_sysctl[i].sc = sc;
605 sc_sysctl = &sc->sc_sysctl[i];
607 sc_sysctl->pin = sc->sc_gpio_pins[i].gp_pin;
608 SYSCTL_ADD_PROC(ctx, pinN_tree, OID_AUTO, "function",
609 CTLFLAG_RW | CTLTYPE_STRING, sc_sysctl,
610 sizeof(struct bcm_gpio_sysctl), bcm_gpio_func_proc,
611 "A", "Pin Function");
616 bcm_gpio_get_reserved_pins(struct bcm_gpio_softc *sc)
618 int i, j, len, npins;
619 pcell_t pins[BCM_GPIO_PINS];
620 phandle_t gpio, node, reserved;
623 /* Get read-only pins. */
624 if (bcm_gpio_get_ro_pins(sc) != 0)
627 /* Find the gpio/reserved pins node to start. */
628 gpio = ofw_bus_get_node(sc->sc_dev);
629 node = OF_child(gpio);
635 while ((node != 0) && (reserved == 0)) {
636 len = OF_getprop(node, "name", name,
639 if (strcmp(name, "reserved") == 0)
641 node = OF_peer(node);
647 /* Get the reserved pins. */
648 len = OF_getproplen(reserved, "broadcom,pins");
649 if (len < 0 || len > sizeof(pins))
652 if (OF_getprop(reserved, "broadcom,pins", &pins, len) < 0)
655 npins = len / sizeof(pcell_t);
658 device_printf(sc->sc_dev, "reserved pins: ");
659 for (i = 0; i < npins; i++) {
662 printf("%d", fdt32_to_cpu(pins[i]));
663 /* Some pins maybe already on the list of read-only pins. */
664 if (bcm_gpio_pin_is_ro(sc, fdt32_to_cpu(pins[i])))
666 sc->sc_ro_pins[j++ + sc->sc_ro_npins] = fdt32_to_cpu(pins[i]);
668 sc->sc_ro_npins += j;
677 bcm_gpio_probe(device_t dev)
679 if (!ofw_bus_is_compatible(dev, "broadcom,bcm2835-gpio"))
682 device_set_desc(dev, "BCM2708/2835 GPIO controller");
683 return (BUS_PROBE_DEFAULT);
687 bcm_gpio_attach(device_t dev)
689 struct bcm_gpio_softc *sc = device_get_softc(dev);
696 mtx_init(&sc->sc_mtx, "bcm gpio", "gpio", MTX_DEF);
699 sc->sc_mem_res = bus_alloc_resource_any(dev, SYS_RES_MEMORY, &rid,
701 if (!sc->sc_mem_res) {
702 device_printf(dev, "cannot allocate memory window\n");
706 sc->sc_bst = rman_get_bustag(sc->sc_mem_res);
707 sc->sc_bsh = rman_get_bushandle(sc->sc_mem_res);
710 sc->sc_irq_res = bus_alloc_resource_any(dev, SYS_RES_IRQ, &rid,
712 if (!sc->sc_irq_res) {
713 bus_release_resource(dev, SYS_RES_MEMORY, 0, sc->sc_mem_res);
714 device_printf(dev, "cannot allocate interrupt\n");
719 gpio = ofw_bus_get_node(sc->sc_dev);
721 if (!OF_hasprop(gpio, "gpio-controller"))
722 /* Node is not a GPIO controller. */
726 * Find the read-only pins. These are pins we never touch or bad
727 * things could happen.
729 if (bcm_gpio_get_reserved_pins(sc) == -1)
732 /* Initialize the software controlled pins. */
733 for (i = 0, j = 0; j < BCM_GPIO_PINS; j++) {
734 if (bcm_gpio_pin_is_ro(sc, j))
736 snprintf(sc->sc_gpio_pins[i].gp_name, GPIOMAXNAME,
738 func = bcm_gpio_get_function(sc, j);
739 sc->sc_gpio_pins[i].gp_pin = j;
740 sc->sc_gpio_pins[i].gp_caps = BCM_GPIO_DEFAULT_CAPS;
741 sc->sc_gpio_pins[i].gp_flags = bcm_gpio_func_flag(func);
744 sc->sc_gpio_npins = i;
746 bcm_gpio_sysctl_init(sc);
748 device_add_child(dev, "gpioc", device_get_unit(dev));
749 device_add_child(dev, "gpiobus", device_get_unit(dev));
750 return (bus_generic_attach(dev));
754 bus_release_resource(dev, SYS_RES_IRQ, 0, sc->sc_irq_res);
756 bus_release_resource(dev, SYS_RES_MEMORY, 0, sc->sc_mem_res);
761 bcm_gpio_detach(device_t dev)
767 static device_method_t bcm_gpio_methods[] = {
768 /* Device interface */
769 DEVMETHOD(device_probe, bcm_gpio_probe),
770 DEVMETHOD(device_attach, bcm_gpio_attach),
771 DEVMETHOD(device_detach, bcm_gpio_detach),
774 DEVMETHOD(gpio_pin_max, bcm_gpio_pin_max),
775 DEVMETHOD(gpio_pin_getname, bcm_gpio_pin_getname),
776 DEVMETHOD(gpio_pin_getflags, bcm_gpio_pin_getflags),
777 DEVMETHOD(gpio_pin_getcaps, bcm_gpio_pin_getcaps),
778 DEVMETHOD(gpio_pin_setflags, bcm_gpio_pin_setflags),
779 DEVMETHOD(gpio_pin_get, bcm_gpio_pin_get),
780 DEVMETHOD(gpio_pin_set, bcm_gpio_pin_set),
781 DEVMETHOD(gpio_pin_toggle, bcm_gpio_pin_toggle),
786 static devclass_t bcm_gpio_devclass;
788 static driver_t bcm_gpio_driver = {
791 sizeof(struct bcm_gpio_softc),
794 DRIVER_MODULE(bcm_gpio, simplebus, bcm_gpio_driver, bcm_gpio_devclass, 0, 0);