linux/drivers/gpio/gpio-twl4030.c
<<
>>
Prefs
   1/*
   2 * Access to GPIOs on TWL4030/TPS659x0 chips
   3 *
   4 * Copyright (C) 2006-2007 Texas Instruments, Inc.
   5 * Copyright (C) 2006 MontaVista Software, Inc.
   6 *
   7 * Code re-arranged and cleaned up by:
   8 *      Syed Mohammed Khasim <x0khasim@ti.com>
   9 *
  10 * Initial Code:
  11 *      Andy Lowe / Nishanth Menon
  12 *
  13 * This program is free software; you can redistribute it and/or modify
  14 * it under the terms of the GNU General Public License as published by
  15 * the Free Software Foundation; either version 2 of the License, or
  16 * (at your option) any later version.
  17 *
  18 * This program is distributed in the hope that it will be useful,
  19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21 * GNU General Public License for more details.
  22 *
  23 * You should have received a copy of the GNU General Public License
  24 * along with this program; if not, write to the Free Software
  25 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  26 */
  27
  28#include <linux/module.h>
  29#include <linux/init.h>
  30#include <linux/interrupt.h>
  31#include <linux/kthread.h>
  32#include <linux/irq.h>
  33#include <linux/gpio.h>
  34#include <linux/platform_device.h>
  35#include <linux/of.h>
  36#include <linux/irqdomain.h>
  37
  38#include <linux/i2c/twl.h>
  39
  40/*
  41 * The GPIO "subchip" supports 18 GPIOs which can be configured as
  42 * inputs or outputs, with pullups or pulldowns on each pin.  Each
  43 * GPIO can trigger interrupts on either or both edges.
  44 *
  45 * GPIO interrupts can be fed to either of two IRQ lines; this is
  46 * intended to support multiple hosts.
  47 *
  48 * There are also two LED pins used sometimes as output-only GPIOs.
  49 */
  50
  51/* genirq interfaces are not available to modules */
  52#ifdef MODULE
  53#define is_module()     true
  54#else
  55#define is_module()     false
  56#endif
  57
  58/* GPIO_CTRL Fields */
  59#define MASK_GPIO_CTRL_GPIO0CD1         BIT(0)
  60#define MASK_GPIO_CTRL_GPIO1CD2         BIT(1)
  61#define MASK_GPIO_CTRL_GPIO_ON          BIT(2)
  62
  63/* Mask for GPIO registers when aggregated into a 32-bit integer */
  64#define GPIO_32_MASK                    0x0003ffff
  65
  66struct gpio_twl4030_priv {
  67        struct gpio_chip gpio_chip;
  68        struct mutex mutex;
  69        int irq_base;
  70
  71        /* Bitfields for state caching */
  72        unsigned int usage_count;
  73        unsigned int direction;
  74        unsigned int out_state;
  75};
  76
  77/*----------------------------------------------------------------------*/
  78
  79static inline struct gpio_twl4030_priv *to_gpio_twl4030(struct gpio_chip *chip)
  80{
  81        return container_of(chip, struct gpio_twl4030_priv, gpio_chip);
  82}
  83
  84/*
  85 * To configure TWL4030 GPIO module registers
  86 */
  87static inline int gpio_twl4030_write(u8 address, u8 data)
  88{
  89        return twl_i2c_write_u8(TWL4030_MODULE_GPIO, data, address);
  90}
  91
  92/*----------------------------------------------------------------------*/
  93
  94/*
  95 * LED register offsets from TWL_MODULE_LED base
  96 * PWMs A and B are dedicated to LEDs A and B, respectively.
  97 */
  98
  99#define TWL4030_LED_LEDEN_REG   0x00
 100#define TWL4030_PWMAON_REG      0x01
 101#define TWL4030_PWMAOFF_REG     0x02
 102#define TWL4030_PWMBON_REG      0x03
 103#define TWL4030_PWMBOFF_REG     0x04
 104
 105/* LEDEN bits */
 106#define LEDEN_LEDAON            BIT(0)
 107#define LEDEN_LEDBON            BIT(1)
 108#define LEDEN_LEDAEXT           BIT(2)
 109#define LEDEN_LEDBEXT           BIT(3)
 110#define LEDEN_LEDAPWM           BIT(4)
 111#define LEDEN_LEDBPWM           BIT(5)
 112#define LEDEN_PWM_LENGTHA       BIT(6)
 113#define LEDEN_PWM_LENGTHB       BIT(7)
 114
 115#define PWMxON_LENGTH           BIT(7)
 116
 117/*----------------------------------------------------------------------*/
 118
 119/*
 120 * To read a TWL4030 GPIO module register
 121 */
 122static inline int gpio_twl4030_read(u8 address)
 123{
 124        u8 data;
 125        int ret = 0;
 126
 127        ret = twl_i2c_read_u8(TWL4030_MODULE_GPIO, &data, address);
 128        return (ret < 0) ? ret : data;
 129}
 130
 131/*----------------------------------------------------------------------*/
 132
 133static u8 cached_leden;
 134
 135/* The LED lines are open drain outputs ... a FET pulls to GND, so an
 136 * external pullup is needed.  We could also expose the integrated PWM
 137 * as a LED brightness control; we initialize it as "always on".
 138 */
 139static void twl4030_led_set_value(int led, int value)
 140{
 141        u8 mask = LEDEN_LEDAON | LEDEN_LEDAPWM;
 142        int status;
 143
 144        if (led)
 145                mask <<= 1;
 146
 147        if (value)
 148                cached_leden &= ~mask;
 149        else
 150                cached_leden |= mask;
 151        status = twl_i2c_write_u8(TWL4030_MODULE_LED, cached_leden,
 152                                  TWL4030_LED_LEDEN_REG);
 153}
 154
 155static int twl4030_set_gpio_direction(int gpio, int is_input)
 156{
 157        u8 d_bnk = gpio >> 3;
 158        u8 d_msk = BIT(gpio & 0x7);
 159        u8 reg = 0;
 160        u8 base = REG_GPIODATADIR1 + d_bnk;
 161        int ret = 0;
 162
 163        ret = gpio_twl4030_read(base);
 164        if (ret >= 0) {
 165                if (is_input)
 166                        reg = ret & ~d_msk;
 167                else
 168                        reg = ret | d_msk;
 169
 170                ret = gpio_twl4030_write(base, reg);
 171        }
 172        return ret;
 173}
 174
 175static int twl4030_set_gpio_dataout(int gpio, int enable)
 176{
 177        u8 d_bnk = gpio >> 3;
 178        u8 d_msk = BIT(gpio & 0x7);
 179        u8 base = 0;
 180
 181        if (enable)
 182                base = REG_SETGPIODATAOUT1 + d_bnk;
 183        else
 184                base = REG_CLEARGPIODATAOUT1 + d_bnk;
 185
 186        return gpio_twl4030_write(base, d_msk);
 187}
 188
 189static int twl4030_get_gpio_datain(int gpio)
 190{
 191        u8 d_bnk = gpio >> 3;
 192        u8 d_off = gpio & 0x7;
 193        u8 base = 0;
 194        int ret = 0;
 195
 196        base = REG_GPIODATAIN1 + d_bnk;
 197        ret = gpio_twl4030_read(base);
 198        if (ret > 0)
 199                ret = (ret >> d_off) & 0x1;
 200
 201        return ret;
 202}
 203
 204/*----------------------------------------------------------------------*/
 205
 206static int twl_request(struct gpio_chip *chip, unsigned offset)
 207{
 208        struct gpio_twl4030_priv *priv = to_gpio_twl4030(chip);
 209        int status = 0;
 210
 211        mutex_lock(&priv->mutex);
 212
 213        /* Support the two LED outputs as output-only GPIOs. */
 214        if (offset >= TWL4030_GPIO_MAX) {
 215                u8      ledclr_mask = LEDEN_LEDAON | LEDEN_LEDAEXT
 216                                | LEDEN_LEDAPWM | LEDEN_PWM_LENGTHA;
 217                u8      reg = TWL4030_PWMAON_REG;
 218
 219                offset -= TWL4030_GPIO_MAX;
 220                if (offset) {
 221                        ledclr_mask <<= 1;
 222                        reg = TWL4030_PWMBON_REG;
 223                }
 224
 225                /* initialize PWM to always-drive */
 226                /* Configure PWM OFF register first */
 227                status = twl_i2c_write_u8(TWL4030_MODULE_LED, 0x7f, reg + 1);
 228                if (status < 0)
 229                        goto done;
 230
 231                /* Followed by PWM ON register */
 232                status = twl_i2c_write_u8(TWL4030_MODULE_LED, 0x7f, reg);
 233                if (status < 0)
 234                        goto done;
 235
 236                /* init LED to not-driven (high) */
 237                status = twl_i2c_read_u8(TWL4030_MODULE_LED, &cached_leden,
 238                                         TWL4030_LED_LEDEN_REG);
 239                if (status < 0)
 240                        goto done;
 241                cached_leden &= ~ledclr_mask;
 242                status = twl_i2c_write_u8(TWL4030_MODULE_LED, cached_leden,
 243                                          TWL4030_LED_LEDEN_REG);
 244                if (status < 0)
 245                        goto done;
 246
 247                status = 0;
 248                goto done;
 249        }
 250
 251        /* on first use, turn GPIO module "on" */
 252        if (!priv->usage_count) {
 253                struct twl4030_gpio_platform_data *pdata;
 254                u8 value = MASK_GPIO_CTRL_GPIO_ON;
 255
 256                /* optionally have the first two GPIOs switch vMMC1
 257                 * and vMMC2 power supplies based on card presence.
 258                 */
 259                pdata = chip->dev->platform_data;
 260                if (pdata)
 261                        value |= pdata->mmc_cd & 0x03;
 262
 263                status = gpio_twl4030_write(REG_GPIO_CTRL, value);
 264        }
 265
 266done:
 267        if (!status)
 268                priv->usage_count |= BIT(offset);
 269
 270        mutex_unlock(&priv->mutex);
 271        return status;
 272}
 273
 274static void twl_free(struct gpio_chip *chip, unsigned offset)
 275{
 276        struct gpio_twl4030_priv *priv = to_gpio_twl4030(chip);
 277
 278        mutex_lock(&priv->mutex);
 279        if (offset >= TWL4030_GPIO_MAX) {
 280                twl4030_led_set_value(offset - TWL4030_GPIO_MAX, 1);
 281                goto out;
 282        }
 283
 284        priv->usage_count &= ~BIT(offset);
 285
 286        /* on last use, switch off GPIO module */
 287        if (!priv->usage_count)
 288                gpio_twl4030_write(REG_GPIO_CTRL, 0x0);
 289
 290out:
 291        mutex_unlock(&priv->mutex);
 292}
 293
 294static int twl_direction_in(struct gpio_chip *chip, unsigned offset)
 295{
 296        struct gpio_twl4030_priv *priv = to_gpio_twl4030(chip);
 297        int ret;
 298
 299        mutex_lock(&priv->mutex);
 300        if (offset < TWL4030_GPIO_MAX)
 301                ret = twl4030_set_gpio_direction(offset, 1);
 302        else
 303                ret = -EINVAL;
 304
 305        if (!ret)
 306                priv->direction &= ~BIT(offset);
 307
 308        mutex_unlock(&priv->mutex);
 309
 310        return ret;
 311}
 312
 313static int twl_get(struct gpio_chip *chip, unsigned offset)
 314{
 315        struct gpio_twl4030_priv *priv = to_gpio_twl4030(chip);
 316        int ret;
 317        int status = 0;
 318
 319        mutex_lock(&priv->mutex);
 320        if (!(priv->usage_count & BIT(offset))) {
 321                ret = -EPERM;
 322                goto out;
 323        }
 324
 325        if (priv->direction & BIT(offset))
 326                status = priv->out_state & BIT(offset);
 327        else
 328                status = twl4030_get_gpio_datain(offset);
 329
 330        ret = (status <= 0) ? 0 : 1;
 331out:
 332        mutex_unlock(&priv->mutex);
 333        return ret;
 334}
 335
 336static void twl_set(struct gpio_chip *chip, unsigned offset, int value)
 337{
 338        struct gpio_twl4030_priv *priv = to_gpio_twl4030(chip);
 339
 340        mutex_lock(&priv->mutex);
 341        if (offset < TWL4030_GPIO_MAX)
 342                twl4030_set_gpio_dataout(offset, value);
 343        else
 344                twl4030_led_set_value(offset - TWL4030_GPIO_MAX, value);
 345
 346        if (value)
 347                priv->out_state |= BIT(offset);
 348        else
 349                priv->out_state &= ~BIT(offset);
 350
 351        mutex_unlock(&priv->mutex);
 352}
 353
 354static int twl_direction_out(struct gpio_chip *chip, unsigned offset, int value)
 355{
 356        struct gpio_twl4030_priv *priv = to_gpio_twl4030(chip);
 357        int ret = -EINVAL;
 358
 359        mutex_lock(&priv->mutex);
 360        if (offset < TWL4030_GPIO_MAX)
 361                ret = twl4030_set_gpio_direction(offset, 0);
 362
 363        priv->direction |= BIT(offset);
 364        mutex_unlock(&priv->mutex);
 365
 366        twl_set(chip, offset, value);
 367
 368        return ret;
 369}
 370
 371static int twl_to_irq(struct gpio_chip *chip, unsigned offset)
 372{
 373        struct gpio_twl4030_priv *priv = to_gpio_twl4030(chip);
 374
 375        return (priv->irq_base && (offset < TWL4030_GPIO_MAX))
 376                ? (priv->irq_base + offset)
 377                : -EINVAL;
 378}
 379
 380static struct gpio_chip template_chip = {
 381        .label                  = "twl4030",
 382        .owner                  = THIS_MODULE,
 383        .request                = twl_request,
 384        .free                   = twl_free,
 385        .direction_input        = twl_direction_in,
 386        .get                    = twl_get,
 387        .direction_output       = twl_direction_out,
 388        .set                    = twl_set,
 389        .to_irq                 = twl_to_irq,
 390        .can_sleep              = 1,
 391};
 392
 393/*----------------------------------------------------------------------*/
 394
 395static int gpio_twl4030_pulls(u32 ups, u32 downs)
 396{
 397        u8              message[5];
 398        unsigned        i, gpio_bit;
 399
 400        /* For most pins, a pulldown was enabled by default.
 401         * We should have data that's specific to this board.
 402         */
 403        for (gpio_bit = 1, i = 0; i < 5; i++) {
 404                u8              bit_mask;
 405                unsigned        j;
 406
 407                for (bit_mask = 0, j = 0; j < 8; j += 2, gpio_bit <<= 1) {
 408                        if (ups & gpio_bit)
 409                                bit_mask |= 1 << (j + 1);
 410                        else if (downs & gpio_bit)
 411                                bit_mask |= 1 << (j + 0);
 412                }
 413                message[i] = bit_mask;
 414        }
 415
 416        return twl_i2c_write(TWL4030_MODULE_GPIO, message,
 417                                REG_GPIOPUPDCTR1, 5);
 418}
 419
 420static int gpio_twl4030_debounce(u32 debounce, u8 mmc_cd)
 421{
 422        u8              message[3];
 423
 424        /* 30 msec of debouncing is always used for MMC card detect,
 425         * and is optional for everything else.
 426         */
 427        message[0] = (debounce & 0xff) | (mmc_cd & 0x03);
 428        debounce >>= 8;
 429        message[1] = (debounce & 0xff);
 430        debounce >>= 8;
 431        message[2] = (debounce & 0x03);
 432
 433        return twl_i2c_write(TWL4030_MODULE_GPIO, message,
 434                                REG_GPIO_DEBEN1, 3);
 435}
 436
 437static int gpio_twl4030_remove(struct platform_device *pdev);
 438
 439static struct twl4030_gpio_platform_data *of_gpio_twl4030(struct device *dev)
 440{
 441        struct twl4030_gpio_platform_data *omap_twl_info;
 442
 443        omap_twl_info = devm_kzalloc(dev, sizeof(*omap_twl_info), GFP_KERNEL);
 444        if (!omap_twl_info)
 445                return NULL;
 446
 447        omap_twl_info->use_leds = of_property_read_bool(dev->of_node,
 448                        "ti,use-leds");
 449
 450        of_property_read_u32(dev->of_node, "ti,debounce",
 451                             &omap_twl_info->debounce);
 452        of_property_read_u32(dev->of_node, "ti,mmc-cd",
 453                             (u32 *)&omap_twl_info->mmc_cd);
 454        of_property_read_u32(dev->of_node, "ti,pullups",
 455                             &omap_twl_info->pullups);
 456        of_property_read_u32(dev->of_node, "ti,pulldowns",
 457                             &omap_twl_info->pulldowns);
 458
 459        return omap_twl_info;
 460}
 461
 462static int gpio_twl4030_probe(struct platform_device *pdev)
 463{
 464        struct twl4030_gpio_platform_data *pdata = pdev->dev.platform_data;
 465        struct device_node *node = pdev->dev.of_node;
 466        struct gpio_twl4030_priv *priv;
 467        int ret, irq_base;
 468
 469        priv = devm_kzalloc(&pdev->dev, sizeof(struct gpio_twl4030_priv),
 470                            GFP_KERNEL);
 471        if (!priv)
 472                return -ENOMEM;
 473
 474        /* maybe setup IRQs */
 475        if (is_module()) {
 476                dev_err(&pdev->dev, "can't dispatch IRQs from modules\n");
 477                goto no_irqs;
 478        }
 479
 480        irq_base = irq_alloc_descs(-1, 0, TWL4030_GPIO_MAX, 0);
 481        if (irq_base < 0) {
 482                dev_err(&pdev->dev, "Failed to alloc irq_descs\n");
 483                return irq_base;
 484        }
 485
 486        irq_domain_add_legacy(node, TWL4030_GPIO_MAX, irq_base, 0,
 487                              &irq_domain_simple_ops, NULL);
 488
 489        ret = twl4030_sih_setup(&pdev->dev, TWL4030_MODULE_GPIO, irq_base);
 490        if (ret < 0)
 491                return ret;
 492
 493        priv->irq_base = irq_base;
 494
 495no_irqs:
 496        priv->gpio_chip = template_chip;
 497        priv->gpio_chip.base = -1;
 498        priv->gpio_chip.ngpio = TWL4030_GPIO_MAX;
 499        priv->gpio_chip.dev = &pdev->dev;
 500
 501        mutex_init(&priv->mutex);
 502
 503        if (node)
 504                pdata = of_gpio_twl4030(&pdev->dev);
 505
 506        if (pdata == NULL) {
 507                dev_err(&pdev->dev, "Platform data is missing\n");
 508                return -ENXIO;
 509        }
 510
 511        /*
 512         * NOTE:  boards may waste power if they don't set pullups
 513         * and pulldowns correctly ... default for non-ULPI pins is
 514         * pulldown, and some other pins may have external pullups
 515         * or pulldowns.  Careful!
 516         */
 517        ret = gpio_twl4030_pulls(pdata->pullups, pdata->pulldowns);
 518        if (ret)
 519                dev_dbg(&pdev->dev, "pullups %.05x %.05x --> %d\n",
 520                        pdata->pullups, pdata->pulldowns, ret);
 521
 522        ret = gpio_twl4030_debounce(pdata->debounce, pdata->mmc_cd);
 523        if (ret)
 524                dev_dbg(&pdev->dev, "debounce %.03x %.01x --> %d\n",
 525                        pdata->debounce, pdata->mmc_cd, ret);
 526
 527        /*
 528         * NOTE: we assume VIBRA_CTL.VIBRA_EN, in MODULE_AUDIO_VOICE,
 529         * is (still) clear if use_leds is set.
 530         */
 531        if (pdata->use_leds)
 532                priv->gpio_chip.ngpio += 2;
 533
 534        ret = gpiochip_add(&priv->gpio_chip);
 535        if (ret < 0) {
 536                dev_err(&pdev->dev, "could not register gpiochip, %d\n", ret);
 537                priv->gpio_chip.ngpio = 0;
 538                gpio_twl4030_remove(pdev);
 539                goto out;
 540        }
 541
 542        platform_set_drvdata(pdev, priv);
 543
 544        if (pdata && pdata->setup) {
 545                int status;
 546
 547                status = pdata->setup(&pdev->dev, priv->gpio_chip.base,
 548                                      TWL4030_GPIO_MAX);
 549                if (status)
 550                        dev_dbg(&pdev->dev, "setup --> %d\n", status);
 551        }
 552
 553out:
 554        return ret;
 555}
 556
 557/* Cannot use as gpio_twl4030_probe() calls us */
 558static int gpio_twl4030_remove(struct platform_device *pdev)
 559{
 560        struct twl4030_gpio_platform_data *pdata = pdev->dev.platform_data;
 561        struct gpio_twl4030_priv *priv = platform_get_drvdata(pdev);
 562        int status;
 563
 564        if (pdata && pdata->teardown) {
 565                status = pdata->teardown(&pdev->dev, priv->gpio_chip.base,
 566                                         TWL4030_GPIO_MAX);
 567                if (status) {
 568                        dev_dbg(&pdev->dev, "teardown --> %d\n", status);
 569                        return status;
 570                }
 571        }
 572
 573        status = gpiochip_remove(&priv->gpio_chip);
 574        if (status < 0)
 575                return status;
 576
 577        if (is_module())
 578                return 0;
 579
 580        /* REVISIT no support yet for deregistering all the IRQs */
 581        WARN_ON(1);
 582        return -EIO;
 583}
 584
 585static const struct of_device_id twl_gpio_match[] = {
 586        { .compatible = "ti,twl4030-gpio", },
 587        { },
 588};
 589MODULE_DEVICE_TABLE(of, twl_gpio_match);
 590
 591/* Note:  this hardware lives inside an I2C-based multi-function device. */
 592MODULE_ALIAS("platform:twl4030_gpio");
 593
 594static struct platform_driver gpio_twl4030_driver = {
 595        .driver = {
 596                .name   = "twl4030_gpio",
 597                .owner  = THIS_MODULE,
 598                .of_match_table = of_match_ptr(twl_gpio_match),
 599        },
 600        .probe          = gpio_twl4030_probe,
 601        .remove         = gpio_twl4030_remove,
 602};
 603
 604static int __init gpio_twl4030_init(void)
 605{
 606        return platform_driver_register(&gpio_twl4030_driver);
 607}
 608subsys_initcall(gpio_twl4030_init);
 609
 610static void __exit gpio_twl4030_exit(void)
 611{
 612        platform_driver_unregister(&gpio_twl4030_driver);
 613}
 614module_exit(gpio_twl4030_exit);
 615
 616MODULE_AUTHOR("Texas Instruments, Inc.");
 617MODULE_DESCRIPTION("GPIO interface for TWL4030");
 618MODULE_LICENSE("GPL");
 619