linux/drivers/pcmcia/cs.c
<<
>>
Prefs
   1/*
   2 * cs.c -- Kernel Card Services - core services
   3 *
   4 * This program is free software; you can redistribute it and/or modify
   5 * it under the terms of the GNU General Public License version 2 as
   6 * published by the Free Software Foundation.
   7 *
   8 * The initial developer of the original code is David A. Hinds
   9 * <dahinds@users.sourceforge.net>.  Portions created by David A. Hinds
  10 * are Copyright (C) 1999 David A. Hinds.  All Rights Reserved.
  11 *
  12 * (C) 1999             David A. Hinds
  13 */
  14
  15#include <linux/module.h>
  16#include <linux/moduleparam.h>
  17#include <linux/init.h>
  18#include <linux/kernel.h>
  19#include <linux/string.h>
  20#include <linux/major.h>
  21#include <linux/errno.h>
  22#include <linux/slab.h>
  23#include <linux/mm.h>
  24#include <linux/interrupt.h>
  25#include <linux/timer.h>
  26#include <linux/ioport.h>
  27#include <linux/delay.h>
  28#include <linux/pm.h>
  29#include <linux/device.h>
  30#include <linux/kthread.h>
  31#include <linux/freezer.h>
  32#include <asm/irq.h>
  33
  34#include <pcmcia/ss.h>
  35#include <pcmcia/cistpl.h>
  36#include <pcmcia/cisreg.h>
  37#include <pcmcia/ds.h>
  38#include "cs_internal.h"
  39
  40
  41/* Module parameters */
  42
  43MODULE_AUTHOR("David Hinds <dahinds@users.sourceforge.net>");
  44MODULE_DESCRIPTION("Linux Kernel Card Services");
  45MODULE_LICENSE("GPL");
  46
  47#define INT_MODULE_PARM(n, v) static int n = v; module_param(n, int, 0444)
  48
  49INT_MODULE_PARM(setup_delay,    10);            /* centiseconds */
  50INT_MODULE_PARM(resume_delay,   20);            /* centiseconds */
  51INT_MODULE_PARM(shutdown_delay, 3);             /* centiseconds */
  52INT_MODULE_PARM(vcc_settle,     40);            /* centiseconds */
  53INT_MODULE_PARM(reset_time,     10);            /* usecs */
  54INT_MODULE_PARM(unreset_delay,  10);            /* centiseconds */
  55INT_MODULE_PARM(unreset_check,  10);            /* centiseconds */
  56INT_MODULE_PARM(unreset_limit,  30);            /* unreset_check's */
  57
  58/* Access speed for attribute memory windows */
  59INT_MODULE_PARM(cis_speed,      300);           /* ns */
  60
  61
  62socket_state_t dead_socket = {
  63        .csc_mask       = SS_DETECT,
  64};
  65EXPORT_SYMBOL(dead_socket);
  66
  67
  68/* List of all sockets, protected by a rwsem */
  69LIST_HEAD(pcmcia_socket_list);
  70EXPORT_SYMBOL(pcmcia_socket_list);
  71
  72DECLARE_RWSEM(pcmcia_socket_list_rwsem);
  73EXPORT_SYMBOL(pcmcia_socket_list_rwsem);
  74
  75
  76struct pcmcia_socket *pcmcia_get_socket(struct pcmcia_socket *skt)
  77{
  78        struct device *dev = get_device(&skt->dev);
  79        if (!dev)
  80                return NULL;
  81        return dev_get_drvdata(dev);
  82}
  83EXPORT_SYMBOL(pcmcia_get_socket);
  84
  85
  86void pcmcia_put_socket(struct pcmcia_socket *skt)
  87{
  88        put_device(&skt->dev);
  89}
  90EXPORT_SYMBOL(pcmcia_put_socket);
  91
  92
  93static void pcmcia_release_socket(struct device *dev)
  94{
  95        struct pcmcia_socket *socket = dev_get_drvdata(dev);
  96
  97        complete(&socket->socket_released);
  98}
  99
 100static int pccardd(void *__skt);
 101
 102/**
 103 * pcmcia_register_socket - add a new pcmcia socket device
 104 * @socket: the &socket to register
 105 */
 106int pcmcia_register_socket(struct pcmcia_socket *socket)
 107{
 108        struct task_struct *tsk;
 109        int ret;
 110
 111        if (!socket || !socket->ops || !socket->dev.parent || !socket->resource_ops)
 112                return -EINVAL;
 113
 114        dev_dbg(&socket->dev, "pcmcia_register_socket(0x%p)\n", socket->ops);
 115
 116        /* try to obtain a socket number [yes, it gets ugly if we
 117         * register more than 2^sizeof(unsigned int) pcmcia
 118         * sockets... but the socket number is deprecated
 119         * anyways, so I don't care] */
 120        down_write(&pcmcia_socket_list_rwsem);
 121        if (list_empty(&pcmcia_socket_list))
 122                socket->sock = 0;
 123        else {
 124                unsigned int found, i = 1;
 125                struct pcmcia_socket *tmp;
 126                do {
 127                        found = 1;
 128                        list_for_each_entry(tmp, &pcmcia_socket_list, socket_list) {
 129                                if (tmp->sock == i)
 130                                        found = 0;
 131                        }
 132                        i++;
 133                } while (!found);
 134                socket->sock = i - 1;
 135        }
 136        list_add_tail(&socket->socket_list, &pcmcia_socket_list);
 137        up_write(&pcmcia_socket_list_rwsem);
 138
 139#ifndef CONFIG_CARDBUS
 140        /*
 141         * If we do not support Cardbus, ensure that
 142         * the Cardbus socket capability is disabled.
 143         */
 144        socket->features &= ~SS_CAP_CARDBUS;
 145#endif
 146
 147        /* set proper values in socket->dev */
 148        dev_set_drvdata(&socket->dev, socket);
 149        socket->dev.class = &pcmcia_socket_class;
 150        dev_set_name(&socket->dev, "pcmcia_socket%u", socket->sock);
 151
 152        /* base address = 0, map = 0 */
 153        socket->cis_mem.flags = 0;
 154        socket->cis_mem.speed = cis_speed;
 155
 156        INIT_LIST_HEAD(&socket->cis_cache);
 157
 158        init_completion(&socket->socket_released);
 159        init_completion(&socket->thread_done);
 160        mutex_init(&socket->skt_mutex);
 161        mutex_init(&socket->ops_mutex);
 162        spin_lock_init(&socket->thread_lock);
 163
 164        if (socket->resource_ops->init) {
 165                mutex_lock(&socket->ops_mutex);
 166                ret = socket->resource_ops->init(socket);
 167                mutex_unlock(&socket->ops_mutex);
 168                if (ret)
 169                        goto err;
 170        }
 171
 172        tsk = kthread_run(pccardd, socket, "pccardd");
 173        if (IS_ERR(tsk)) {
 174                ret = PTR_ERR(tsk);
 175                goto err;
 176        }
 177
 178        wait_for_completion(&socket->thread_done);
 179        if (!socket->thread) {
 180                dev_warn(&socket->dev,
 181                         "PCMCIA: warning: socket thread did not start\n");
 182                return -EIO;
 183        }
 184
 185        pcmcia_parse_events(socket, SS_DETECT);
 186
 187        /*
 188         * Let's try to get the PCMCIA module for 16-bit PCMCIA support.
 189         * If it fails, it doesn't matter -- we still have 32-bit CardBus
 190         * support to offer, so this is not a failure mode.
 191         */
 192        request_module_nowait("pcmcia");
 193
 194        return 0;
 195
 196 err:
 197        down_write(&pcmcia_socket_list_rwsem);
 198        list_del(&socket->socket_list);
 199        up_write(&pcmcia_socket_list_rwsem);
 200        return ret;
 201} /* pcmcia_register_socket */
 202EXPORT_SYMBOL(pcmcia_register_socket);
 203
 204
 205/**
 206 * pcmcia_unregister_socket - remove a pcmcia socket device
 207 * @socket: the &socket to unregister
 208 */
 209void pcmcia_unregister_socket(struct pcmcia_socket *socket)
 210{
 211        if (!socket)
 212                return;
 213
 214        dev_dbg(&socket->dev, "pcmcia_unregister_socket(0x%p)\n", socket->ops);
 215
 216        if (socket->thread)
 217                kthread_stop(socket->thread);
 218
 219        /* remove from our own list */
 220        down_write(&pcmcia_socket_list_rwsem);
 221        list_del(&socket->socket_list);
 222        up_write(&pcmcia_socket_list_rwsem);
 223
 224        /* wait for sysfs to drop all references */
 225        if (socket->resource_ops->exit) {
 226                mutex_lock(&socket->ops_mutex);
 227                socket->resource_ops->exit(socket);
 228                mutex_unlock(&socket->ops_mutex);
 229        }
 230        wait_for_completion(&socket->socket_released);
 231} /* pcmcia_unregister_socket */
 232EXPORT_SYMBOL(pcmcia_unregister_socket);
 233
 234
 235struct pcmcia_socket *pcmcia_get_socket_by_nr(unsigned int nr)
 236{
 237        struct pcmcia_socket *s;
 238
 239        down_read(&pcmcia_socket_list_rwsem);
 240        list_for_each_entry(s, &pcmcia_socket_list, socket_list)
 241                if (s->sock == nr) {
 242                        up_read(&pcmcia_socket_list_rwsem);
 243                        return s;
 244                }
 245        up_read(&pcmcia_socket_list_rwsem);
 246
 247        return NULL;
 248
 249}
 250EXPORT_SYMBOL(pcmcia_get_socket_by_nr);
 251
 252static int socket_reset(struct pcmcia_socket *skt)
 253{
 254        int status, i;
 255
 256        dev_dbg(&skt->dev, "reset\n");
 257
 258        skt->socket.flags |= SS_OUTPUT_ENA | SS_RESET;
 259        skt->ops->set_socket(skt, &skt->socket);
 260        udelay((long)reset_time);
 261
 262        skt->socket.flags &= ~SS_RESET;
 263        skt->ops->set_socket(skt, &skt->socket);
 264
 265        msleep(unreset_delay * 10);
 266        for (i = 0; i < unreset_limit; i++) {
 267                skt->ops->get_status(skt, &status);
 268
 269                if (!(status & SS_DETECT))
 270                        return -ENODEV;
 271
 272                if (status & SS_READY)
 273                        return 0;
 274
 275                msleep(unreset_check * 10);
 276        }
 277
 278        dev_err(&skt->dev, "time out after reset\n");
 279        return -ETIMEDOUT;
 280}
 281
 282/*
 283 * socket_setup() and socket_shutdown() are called by the main event handler
 284 * when card insertion and removal events are received.
 285 * socket_setup() turns on socket power and resets the socket, in two stages.
 286 * socket_shutdown() unconfigures a socket and turns off socket power.
 287 */
 288static void socket_shutdown(struct pcmcia_socket *s)
 289{
 290        int status;
 291
 292        dev_dbg(&s->dev, "shutdown\n");
 293
 294        if (s->callback)
 295                s->callback->remove(s);
 296
 297        mutex_lock(&s->ops_mutex);
 298        s->state &= SOCKET_INUSE | SOCKET_PRESENT;
 299        msleep(shutdown_delay * 10);
 300        s->state &= SOCKET_INUSE;
 301
 302        /* Blank out the socket state */
 303        s->socket = dead_socket;
 304        s->ops->init(s);
 305        s->ops->set_socket(s, &s->socket);
 306        s->lock_count = 0;
 307        kfree(s->fake_cis);
 308        s->fake_cis = NULL;
 309        s->functions = 0;
 310
 311        /* From here on we can be sure that only we (that is, the
 312         * pccardd thread) accesses this socket, and all (16-bit)
 313         * PCMCIA interactions are gone. Therefore, release
 314         * ops_mutex so that we don't get a sysfs-related lockdep
 315         * warning.
 316         */
 317        mutex_unlock(&s->ops_mutex);
 318
 319#ifdef CONFIG_CARDBUS
 320        cb_free(s);
 321#endif
 322
 323        /* give socket some time to power down */
 324        msleep(100);
 325
 326        s->ops->get_status(s, &status);
 327        if (status & SS_POWERON) {
 328                dev_err(&s->dev,
 329                        "*** DANGER *** unable to remove socket power\n");
 330        }
 331
 332        s->state &= ~SOCKET_INUSE;
 333}
 334
 335static int socket_setup(struct pcmcia_socket *skt, int initial_delay)
 336{
 337        int status, i;
 338
 339        dev_dbg(&skt->dev, "setup\n");
 340
 341        skt->ops->get_status(skt, &status);
 342        if (!(status & SS_DETECT))
 343                return -ENODEV;
 344
 345        msleep(initial_delay * 10);
 346
 347        for (i = 0; i < 100; i++) {
 348                skt->ops->get_status(skt, &status);
 349                if (!(status & SS_DETECT))
 350                        return -ENODEV;
 351
 352                if (!(status & SS_PENDING))
 353                        break;
 354
 355                msleep(100);
 356        }
 357
 358        if (status & SS_PENDING) {
 359                dev_err(&skt->dev, "voltage interrogation timed out\n");
 360                return -ETIMEDOUT;
 361        }
 362
 363        if (status & SS_CARDBUS) {
 364                if (!(skt->features & SS_CAP_CARDBUS)) {
 365                        dev_err(&skt->dev, "cardbus cards are not supported\n");
 366                        return -EINVAL;
 367                }
 368                skt->state |= SOCKET_CARDBUS;
 369        } else
 370                skt->state &= ~SOCKET_CARDBUS;
 371
 372        /*
 373         * Decode the card voltage requirements, and apply power to the card.
 374         */
 375        if (status & SS_3VCARD)
 376                skt->socket.Vcc = skt->socket.Vpp = 33;
 377        else if (!(status & SS_XVCARD))
 378                skt->socket.Vcc = skt->socket.Vpp = 50;
 379        else {
 380                dev_err(&skt->dev, "unsupported voltage key\n");
 381                return -EIO;
 382        }
 383
 384        if (skt->power_hook)
 385                skt->power_hook(skt, HOOK_POWER_PRE);
 386
 387        skt->socket.flags = 0;
 388        skt->ops->set_socket(skt, &skt->socket);
 389
 390        /*
 391         * Wait "vcc_settle" for the supply to stabilise.
 392         */
 393        msleep(vcc_settle * 10);
 394
 395        skt->ops->get_status(skt, &status);
 396        if (!(status & SS_POWERON)) {
 397                dev_err(&skt->dev, "unable to apply power\n");
 398                return -EIO;
 399        }
 400
 401        status = socket_reset(skt);
 402
 403        if (skt->power_hook)
 404                skt->power_hook(skt, HOOK_POWER_POST);
 405
 406        return status;
 407}
 408
 409/*
 410 * Handle card insertion.  Setup the socket, reset the card,
 411 * and then tell the rest of PCMCIA that a card is present.
 412 */
 413static int socket_insert(struct pcmcia_socket *skt)
 414{
 415        int ret;
 416
 417        dev_dbg(&skt->dev, "insert\n");
 418
 419        mutex_lock(&skt->ops_mutex);
 420        if (skt->state & SOCKET_INUSE) {
 421                mutex_unlock(&skt->ops_mutex);
 422                return -EINVAL;
 423        }
 424        skt->state |= SOCKET_INUSE;
 425
 426        ret = socket_setup(skt, setup_delay);
 427        if (ret == 0) {
 428                skt->state |= SOCKET_PRESENT;
 429
 430                dev_notice(&skt->dev, "pccard: %s card inserted into slot %d\n",
 431                           (skt->state & SOCKET_CARDBUS) ? "CardBus" : "PCMCIA",
 432                           skt->sock);
 433
 434#ifdef CONFIG_CARDBUS
 435                if (skt->state & SOCKET_CARDBUS) {
 436                        cb_alloc(skt);
 437                        skt->state |= SOCKET_CARDBUS_CONFIG;
 438                }
 439#endif
 440                dev_dbg(&skt->dev, "insert done\n");
 441                mutex_unlock(&skt->ops_mutex);
 442
 443                if (!(skt->state & SOCKET_CARDBUS) && (skt->callback))
 444                        skt->callback->add(skt);
 445        } else {
 446                mutex_unlock(&skt->ops_mutex);
 447                socket_shutdown(skt);
 448        }
 449
 450        return ret;
 451}
 452
 453static int socket_suspend(struct pcmcia_socket *skt)
 454{
 455        if ((skt->state & SOCKET_SUSPEND) && !(skt->state & SOCKET_IN_RESUME))
 456                return -EBUSY;
 457
 458        mutex_lock(&skt->ops_mutex);
 459        /* store state on first suspend, but not after spurious wakeups */
 460        if (!(skt->state & SOCKET_IN_RESUME))
 461                skt->suspended_state = skt->state;
 462
 463        skt->socket = dead_socket;
 464        skt->ops->set_socket(skt, &skt->socket);
 465        if (skt->ops->suspend)
 466                skt->ops->suspend(skt);
 467        skt->state |= SOCKET_SUSPEND;
 468        skt->state &= ~SOCKET_IN_RESUME;
 469        mutex_unlock(&skt->ops_mutex);
 470        return 0;
 471}
 472
 473static int socket_early_resume(struct pcmcia_socket *skt)
 474{
 475        mutex_lock(&skt->ops_mutex);
 476        skt->socket = dead_socket;
 477        skt->ops->init(skt);
 478        skt->ops->set_socket(skt, &skt->socket);
 479        if (skt->state & SOCKET_PRESENT)
 480                skt->resume_status = socket_setup(skt, resume_delay);
 481        skt->state |= SOCKET_IN_RESUME;
 482        mutex_unlock(&skt->ops_mutex);
 483        return 0;
 484}
 485
 486static int socket_late_resume(struct pcmcia_socket *skt)
 487{
 488        int ret = 0;
 489
 490        mutex_lock(&skt->ops_mutex);
 491        skt->state &= ~(SOCKET_SUSPEND | SOCKET_IN_RESUME);
 492        mutex_unlock(&skt->ops_mutex);
 493
 494        if (!(skt->state & SOCKET_PRESENT)) {
 495                ret = socket_insert(skt);
 496                if (ret == -ENODEV)
 497                        ret = 0;
 498                return ret;
 499        }
 500
 501        if (skt->resume_status) {
 502                socket_shutdown(skt);
 503                return 0;
 504        }
 505
 506        if (skt->suspended_state != skt->state) {
 507                dev_dbg(&skt->dev,
 508                        "suspend state 0x%x != resume state 0x%x\n",
 509                        skt->suspended_state, skt->state);
 510
 511                socket_shutdown(skt);
 512                return socket_insert(skt);
 513        }
 514
 515        if (!(skt->state & SOCKET_CARDBUS) && (skt->callback))
 516                ret = skt->callback->early_resume(skt);
 517        return ret;
 518}
 519
 520/*
 521 * Finalize the resume. In case of a cardbus socket, we have
 522 * to rebind the devices as we can't be certain that it has been
 523 * replaced, or not.
 524 */
 525static int socket_complete_resume(struct pcmcia_socket *skt)
 526{
 527        int ret = 0;
 528#ifdef CONFIG_CARDBUS
 529        if (skt->state & SOCKET_CARDBUS) {
 530                /* We can't be sure the CardBus card is the same
 531                 * as the one previously inserted. Therefore, remove
 532                 * and re-add... */
 533                cb_free(skt);
 534                ret = cb_alloc(skt);
 535                if (ret)
 536                        cb_free(skt);
 537        }
 538#endif
 539        return ret;
 540}
 541
 542/*
 543 * Resume a socket.  If a card is present, verify its CIS against
 544 * our cached copy.  If they are different, the card has been
 545 * replaced, and we need to tell the drivers.
 546 */
 547static int socket_resume(struct pcmcia_socket *skt)
 548{
 549        int err;
 550        if (!(skt->state & SOCKET_SUSPEND))
 551                return -EBUSY;
 552
 553        socket_early_resume(skt);
 554        err = socket_late_resume(skt);
 555        if (!err)
 556                err = socket_complete_resume(skt);
 557        return err;
 558}
 559
 560static void socket_remove(struct pcmcia_socket *skt)
 561{
 562        dev_notice(&skt->dev, "pccard: card ejected from slot %d\n", skt->sock);
 563        socket_shutdown(skt);
 564}
 565
 566/*
 567 * Process a socket card detect status change.
 568 *
 569 * If we don't have a card already present, delay the detect event for
 570 * about 20ms (to be on the safe side) before reading the socket status.
 571 *
 572 * Some i82365-based systems send multiple SS_DETECT events during card
 573 * insertion, and the "card present" status bit seems to bounce.  This
 574 * will probably be true with GPIO-based card detection systems after
 575 * the product has aged.
 576 */
 577static void socket_detect_change(struct pcmcia_socket *skt)
 578{
 579        if (!(skt->state & SOCKET_SUSPEND)) {
 580                int status;
 581
 582                if (!(skt->state & SOCKET_PRESENT))
 583                        msleep(20);
 584
 585                skt->ops->get_status(skt, &status);
 586                if ((skt->state & SOCKET_PRESENT) &&
 587                     !(status & SS_DETECT))
 588                        socket_remove(skt);
 589                if (!(skt->state & SOCKET_PRESENT) &&
 590                    (status & SS_DETECT))
 591                        socket_insert(skt);
 592        }
 593}
 594
 595static int pccardd(void *__skt)
 596{
 597        struct pcmcia_socket *skt = __skt;
 598        int ret;
 599
 600        skt->thread = current;
 601        skt->socket = dead_socket;
 602        skt->ops->init(skt);
 603        skt->ops->set_socket(skt, &skt->socket);
 604
 605        /* register with the device core */
 606        ret = device_register(&skt->dev);
 607        if (ret) {
 608                dev_warn(&skt->dev, "PCMCIA: unable to register socket\n");
 609                skt->thread = NULL;
 610                complete(&skt->thread_done);
 611                return 0;
 612        }
 613        ret = pccard_sysfs_add_socket(&skt->dev);
 614        if (ret)
 615                dev_warn(&skt->dev, "err %d adding socket attributes\n", ret);
 616
 617        complete(&skt->thread_done);
 618
 619        /* wait for userspace to catch up */
 620        msleep(250);
 621
 622        set_freezable();
 623        for (;;) {
 624                unsigned long flags;
 625                unsigned int events;
 626                unsigned int sysfs_events;
 627
 628                spin_lock_irqsave(&skt->thread_lock, flags);
 629                events = skt->thread_events;
 630                skt->thread_events = 0;
 631                sysfs_events = skt->sysfs_events;
 632                skt->sysfs_events = 0;
 633                spin_unlock_irqrestore(&skt->thread_lock, flags);
 634
 635                mutex_lock(&skt->skt_mutex);
 636                if (events & SS_DETECT)
 637                        socket_detect_change(skt);
 638
 639                if (sysfs_events) {
 640                        if (sysfs_events & PCMCIA_UEVENT_EJECT)
 641                                socket_remove(skt);
 642                        if (sysfs_events & PCMCIA_UEVENT_INSERT)
 643                                socket_insert(skt);
 644                        if ((sysfs_events & PCMCIA_UEVENT_SUSPEND) &&
 645                                !(skt->state & SOCKET_CARDBUS)) {
 646                                if (skt->callback)
 647                                        ret = skt->callback->suspend(skt);
 648                                else
 649                                        ret = 0;
 650                                if (!ret) {
 651                                        socket_suspend(skt);
 652                                        msleep(100);
 653                                }
 654                        }
 655                        if ((sysfs_events & PCMCIA_UEVENT_RESUME) &&
 656                                !(skt->state & SOCKET_CARDBUS)) {
 657                                ret = socket_resume(skt);
 658                                if (!ret && skt->callback)
 659                                        skt->callback->resume(skt);
 660                        }
 661                        if ((sysfs_events & PCMCIA_UEVENT_REQUERY) &&
 662                                !(skt->state & SOCKET_CARDBUS)) {
 663                                if (!ret && skt->callback)
 664                                        skt->callback->requery(skt);
 665                        }
 666                }
 667                mutex_unlock(&skt->skt_mutex);
 668
 669                if (events || sysfs_events)
 670                        continue;
 671
 672                if (kthread_should_stop())
 673                        break;
 674
 675                set_current_state(TASK_INTERRUPTIBLE);
 676
 677                schedule();
 678
 679                /* make sure we are running */
 680                __set_current_state(TASK_RUNNING);
 681
 682                try_to_freeze();
 683        }
 684
 685        /* shut down socket, if a device is still present */
 686        if (skt->state & SOCKET_PRESENT) {
 687                mutex_lock(&skt->skt_mutex);
 688                socket_remove(skt);
 689                mutex_unlock(&skt->skt_mutex);
 690        }
 691
 692        /* remove from the device core */
 693        pccard_sysfs_remove_socket(&skt->dev);
 694        device_unregister(&skt->dev);
 695
 696        return 0;
 697}
 698
 699/*
 700 * Yenta (at least) probes interrupts before registering the socket and
 701 * starting the handler thread.
 702 */
 703void pcmcia_parse_events(struct pcmcia_socket *s, u_int events)
 704{
 705        unsigned long flags;
 706        dev_dbg(&s->dev, "parse_events: events %08x\n", events);
 707        if (s->thread) {
 708                spin_lock_irqsave(&s->thread_lock, flags);
 709                s->thread_events |= events;
 710                spin_unlock_irqrestore(&s->thread_lock, flags);
 711
 712                wake_up_process(s->thread);
 713        }
 714} /* pcmcia_parse_events */
 715EXPORT_SYMBOL(pcmcia_parse_events);
 716
 717/**
 718 * pcmcia_parse_uevents() - tell pccardd to issue manual commands
 719 * @s:          the PCMCIA socket we wan't to command
 720 * @events:     events to pass to pccardd
 721 *
 722 * userspace-issued insert, eject, suspend and resume commands must be
 723 * handled by pccardd to avoid any sysfs-related deadlocks. Valid events
 724 * are PCMCIA_UEVENT_EJECT (for eject), PCMCIA_UEVENT__INSERT (for insert),
 725 * PCMCIA_UEVENT_RESUME (for resume), PCMCIA_UEVENT_SUSPEND (for suspend)
 726 * and PCMCIA_UEVENT_REQUERY (for re-querying the PCMCIA card).
 727 */
 728void pcmcia_parse_uevents(struct pcmcia_socket *s, u_int events)
 729{
 730        unsigned long flags;
 731        dev_dbg(&s->dev, "parse_uevents: events %08x\n", events);
 732        if (s->thread) {
 733                spin_lock_irqsave(&s->thread_lock, flags);
 734                s->sysfs_events |= events;
 735                spin_unlock_irqrestore(&s->thread_lock, flags);
 736
 737                wake_up_process(s->thread);
 738        }
 739}
 740EXPORT_SYMBOL(pcmcia_parse_uevents);
 741
 742
 743/* register pcmcia_callback */
 744int pccard_register_pcmcia(struct pcmcia_socket *s, struct pcmcia_callback *c)
 745{
 746        int ret = 0;
 747
 748        /* s->skt_mutex also protects s->callback */
 749        mutex_lock(&s->skt_mutex);
 750
 751        if (c) {
 752                /* registration */
 753                if (s->callback) {
 754                        ret = -EBUSY;
 755                        goto err;
 756                }
 757
 758                s->callback = c;
 759
 760                if ((s->state & (SOCKET_PRESENT|SOCKET_CARDBUS)) == SOCKET_PRESENT)
 761                        s->callback->add(s);
 762        } else
 763                s->callback = NULL;
 764 err:
 765        mutex_unlock(&s->skt_mutex);
 766
 767        return ret;
 768}
 769EXPORT_SYMBOL(pccard_register_pcmcia);
 770
 771
 772/* I'm not sure which "reset" function this is supposed to use,
 773 * but for now, it uses the low-level interface's reset, not the
 774 * CIS register.
 775 */
 776
 777int pcmcia_reset_card(struct pcmcia_socket *skt)
 778{
 779        int ret;
 780
 781        dev_dbg(&skt->dev, "resetting socket\n");
 782
 783        mutex_lock(&skt->skt_mutex);
 784        do {
 785                if (!(skt->state & SOCKET_PRESENT)) {
 786                        dev_dbg(&skt->dev, "can't reset, not present\n");
 787                        ret = -ENODEV;
 788                        break;
 789                }
 790                if (skt->state & SOCKET_SUSPEND) {
 791                        dev_dbg(&skt->dev, "can't reset, suspended\n");
 792                        ret = -EBUSY;
 793                        break;
 794                }
 795                if (skt->state & SOCKET_CARDBUS) {
 796                        dev_dbg(&skt->dev, "can't reset, is cardbus\n");
 797                        ret = -EPERM;
 798                        break;
 799                }
 800
 801                if (skt->callback)
 802                        skt->callback->suspend(skt);
 803                mutex_lock(&skt->ops_mutex);
 804                ret = socket_reset(skt);
 805                mutex_unlock(&skt->ops_mutex);
 806                if ((ret == 0) && (skt->callback))
 807                        skt->callback->resume(skt);
 808
 809                ret = 0;
 810        } while (0);
 811        mutex_unlock(&skt->skt_mutex);
 812
 813        return ret;
 814} /* reset_card */
 815EXPORT_SYMBOL(pcmcia_reset_card);
 816
 817
 818static int pcmcia_socket_uevent(struct device *dev,
 819                                struct kobj_uevent_env *env)
 820{
 821        struct pcmcia_socket *s = container_of(dev, struct pcmcia_socket, dev);
 822
 823        if (add_uevent_var(env, "SOCKET_NO=%u", s->sock))
 824                return -ENOMEM;
 825
 826        return 0;
 827}
 828
 829
 830static struct completion pcmcia_unload;
 831
 832static void pcmcia_release_socket_class(struct class *data)
 833{
 834        complete(&pcmcia_unload);
 835}
 836
 837
 838#ifdef CONFIG_PM
 839
 840static int __pcmcia_pm_op(struct device *dev,
 841                          int (*callback) (struct pcmcia_socket *skt))
 842{
 843        struct pcmcia_socket *s = container_of(dev, struct pcmcia_socket, dev);
 844        int ret;
 845
 846        mutex_lock(&s->skt_mutex);
 847        ret = callback(s);
 848        mutex_unlock(&s->skt_mutex);
 849
 850        return ret;
 851}
 852
 853static int pcmcia_socket_dev_suspend_noirq(struct device *dev)
 854{
 855        return __pcmcia_pm_op(dev, socket_suspend);
 856}
 857
 858static int pcmcia_socket_dev_resume_noirq(struct device *dev)
 859{
 860        return __pcmcia_pm_op(dev, socket_early_resume);
 861}
 862
 863static int __used pcmcia_socket_dev_resume(struct device *dev)
 864{
 865        return __pcmcia_pm_op(dev, socket_late_resume);
 866}
 867
 868static void __used pcmcia_socket_dev_complete(struct device *dev)
 869{
 870        WARN(__pcmcia_pm_op(dev, socket_complete_resume),
 871                "failed to complete resume");
 872}
 873
 874static const struct dev_pm_ops pcmcia_socket_pm_ops = {
 875        /* dev_resume may be called with IRQs enabled */
 876        SET_SYSTEM_SLEEP_PM_OPS(NULL,
 877                                pcmcia_socket_dev_resume)
 878
 879        /* late suspend must be called with IRQs disabled */
 880        .suspend_noirq = pcmcia_socket_dev_suspend_noirq,
 881        .freeze_noirq = pcmcia_socket_dev_suspend_noirq,
 882        .poweroff_noirq = pcmcia_socket_dev_suspend_noirq,
 883
 884        /* early resume must be called with IRQs disabled */
 885        .resume_noirq = pcmcia_socket_dev_resume_noirq,
 886        .thaw_noirq = pcmcia_socket_dev_resume_noirq,
 887        .restore_noirq = pcmcia_socket_dev_resume_noirq,
 888        .complete = pcmcia_socket_dev_complete,
 889};
 890
 891#define PCMCIA_SOCKET_CLASS_PM_OPS (&pcmcia_socket_pm_ops)
 892
 893#else /* CONFIG_PM */
 894
 895#define PCMCIA_SOCKET_CLASS_PM_OPS NULL
 896
 897#endif /* CONFIG_PM */
 898
 899struct class pcmcia_socket_class = {
 900        .name = "pcmcia_socket",
 901        .dev_uevent = pcmcia_socket_uevent,
 902        .dev_release = pcmcia_release_socket,
 903        .class_release = pcmcia_release_socket_class,
 904        .pm = PCMCIA_SOCKET_CLASS_PM_OPS,
 905};
 906EXPORT_SYMBOL(pcmcia_socket_class);
 907
 908
 909static int __init init_pcmcia_cs(void)
 910{
 911        init_completion(&pcmcia_unload);
 912        return class_register(&pcmcia_socket_class);
 913}
 914
 915static void __exit exit_pcmcia_cs(void)
 916{
 917        class_unregister(&pcmcia_socket_class);
 918        wait_for_completion(&pcmcia_unload);
 919}
 920
 921subsys_initcall(init_pcmcia_cs);
 922module_exit(exit_pcmcia_cs);
 923
 924