drivers/isdn/hisax/teles_cs.c

   1 /* $Id: teles_cs.c,v 1.1.2.2 2004/01/25 15:07:06 keil Exp $ */
   2 /*======================================================================
   3
   4     A teles S0 PCMCIA client driver
   5
   6     Based on skeleton by David Hinds, dhinds@allegro.stanford.edu
   7     Written by Christof Petig, christof.petig@wtal.de
   8
   9     Also inspired by ELSA PCMCIA driver
  10     by Klaus Lichtenwalder <Lichtenwalder@ACM.org>
  11
  12     Extentions to new hisax_pcmcia by Karsten Keil
  13
  14     minor changes to be compatible with kernel 2.4.x
  15     by Jan.Schubert@GMX.li
  16
  17 ======================================================================*/
  18
  19 #include <linux/kernel.h>
  20 #include <linux/module.h>
  21 #include <linux/init.h>
  22 #include <linux/ptrace.h>
  23 #include <linux/slab.h>
  24 #include <linux/string.h>
  25 #include <linux/timer.h>
  26 #include <linux/ioport.h>
  27 #include <asm/io.h>
  28 #include <asm/system.h>
  29
  30 #include <pcmcia/cs_types.h>
  31 #include <pcmcia/cs.h>
  32 #include <pcmcia/cistpl.h>
  33 #include <pcmcia/cisreg.h>
  34 #include <pcmcia/ds.h>
  35 #include "hisax_cfg.h"
  36
  37 MODULE_DESCRIPTION("ISDN4Linux: PCMCIA client driver for Teles PCMCIA cards");
  38 MODULE_AUTHOR("Christof Petig, christof.petig@wtal.de, Karsten Keil, kkeil@suse.de");
  39 MODULE_LICENSE("GPL");
  40
  41
  42 /*====================================================================*/
  43
  44 /* Parameters that can be set with 'insmod' */
  45
  46 static int protocol = 2;        /* EURO-ISDN Default */
  47 module_param(protocol, int, 0);
  48
  49 /*====================================================================*/
  50
  51 /*
  52    The event() function is this driver's Card Services event handler.
  53    It will be called by Card Services when an appropriate card status
  54    event is received.  The config() and release() entry points are
  55    used to configure or release a socket, in response to card insertion
  56    and ejection events.  They are invoked from the teles_cs event
  57    handler.
  58 */
  59
  60 static int teles_cs_config(struct pcmcia_device *link) __devinit ;
  61 static void teles_cs_release(struct pcmcia_device *link);
  62
  63 /*
  64    The attach() and detach() entry points are used to create and destroy
  65    "instances" of the driver, where each instance represents everything
  66    needed to manage one actual PCMCIA card.
  67 */
  68
  69 static void teles_detach(struct pcmcia_device *p_dev) __devexit ;
  70
  71 /*
  72    A linked list of "instances" of the teles_cs device.  Each actual
  73    PCMCIA card corresponds to one device instance, and is described
  74    by one struct pcmcia_device structure (defined in ds.h).
  75
  76    You may not want to use a linked list for this -- for example, the
  77    memory card driver uses an array of struct pcmcia_device pointers, where minor
  78    device numbers are used to derive the corresponding array index.
  79 */
  80
  81 /*
  82    A driver needs to provide a dev_node_t structure for each device
  83    on a card.  In some cases, there is only one device per card (for
  84    example, ethernet cards, modems).  In other cases, there may be
  85    many actual or logical devices (SCSI adapters, memory cards with
  86    multiple partitions).  The dev_node_t structures need to be kept
  87    in a linked list starting at the 'dev' field of a struct pcmcia_device
  88    structure.  We allocate them in the card's private data structure,
  89    because they generally shouldn't be allocated dynamically.
  90    In this case, we also provide a flag to indicate if a device is
  91    "stopped" due to a power management event, or card ejection.  The
  92    device IO routines can use a flag like this to throttle IO to a
  93    card that is not ready to accept it.
  94 */
  95
  96 typedef struct local_info_t {
  97         struct pcmcia_device    *p_dev;
  98     dev_node_t          node;
  99     int                 busy;
 100     int                 cardnr;
 101 } local_info_t;
 102
 103 /*======================================================================
 104
 105     teles_attach() creates an "instance" of the driver, allocatingx
 106     local data structures for one device.  The device is registered
 107     with Card Services.
 108
 109     The dev_link structure is initialized, but we don't actually
 110     configure the card at this point -- we wait until we receive a
 111     card insertion event.
 112
 113 ======================================================================*/
 114
 115 static int __devinit teles_probe(struct pcmcia_device *link)
 116 {
 117     local_info_t *local;
 118
 119     dev_dbg(&link->dev, "teles_attach()\n");
 120
 121     /* Allocate space for private device-specific data */
 122     local = kzalloc(sizeof(local_info_t), GFP_KERNEL);
 123     if (!local) return -ENOMEM;
 124     local->cardnr = -1;
 125
 126     local->p_dev = link;
 127     link->priv = local;
 128
 129     /*
 130       General socket configuration defaults can go here.  In this
 131       client, we assume very little, and rely on the CIS for almost
 132       everything.  In most clients, many details (i.e., number, sizes,
 133       and attributes of IO windows) are fixed by the nature of the
 134       device, and can be hard-wired here.
 135     */
 136     link->io.NumPorts1 = 96;
 137     link->io.Attributes1 = IO_DATA_PATH_WIDTH_AUTO;
 138     link->io.IOAddrLines = 5;
 139
 140     link->conf.Attributes = CONF_ENABLE_IRQ;
 141     link->conf.IntType = INT_MEMORY_AND_IO;
 142
 143     return teles_cs_config(link);
 144 } /* teles_attach */
 145
 146 /*======================================================================
 147
 148     This deletes a driver "instance".  The device is de-registered
 149     with Card Services.  If it has been released, all local data
 150     structures are freed.  Otherwise, the structures will be freed
 151     when the device is released.
 152
 153 ======================================================================*/
 154
 155 static void __devexit teles_detach(struct pcmcia_device *link)
 156 {
 157         local_info_t *info = link->priv;
 158
 159         dev_dbg(&link->dev, "teles_detach(0x%p)\n", link);
 160
 161         info->busy = 1;
 162         teles_cs_release(link);
 163
 164         kfree(info);
 165 } /* teles_detach */
 166
 167 /*======================================================================
 168
 169     teles_cs_config() is scheduled to run after a CARD_INSERTION event
 170     is received, to configure the PCMCIA socket, and to make the
 171     device available to the system.
 172
 173 ======================================================================*/
 174
 175 static int teles_cs_configcheck(struct pcmcia_device *p_dev,
 176                                 cistpl_cftable_entry_t *cf,
 177                                 cistpl_cftable_entry_t *dflt,
 178                                 unsigned int vcc,
 179                                 void *priv_data)
 180 {
 181         int j;
 182
 183         if ((cf->io.nwin > 0) && cf->io.win[0].base) {
 184                 printk(KERN_INFO "(teles_cs: looks like the 96 model)\n");
 185                 p_dev->io.BasePort1 = cf->io.win[0].base;
 186                 if (!pcmcia_request_io(p_dev, &p_dev->io))
 187                         return 0;
 188         } else {
 189                 printk(KERN_INFO "(teles_cs: looks like the 97 model)\n");
 190                 for (j = 0x2f0; j > 0x100; j -= 0x10) {
 191                         p_dev->io.BasePort1 = j;
 192                         if (!pcmcia_request_io(p_dev, &p_dev->io))
 193                                 return 0;
 194                 }
 195         }
 196         return -ENODEV;
 197 }
 198
 199 static int __devinit teles_cs_config(struct pcmcia_device *link)
 200 {
 201     local_info_t *dev;
 202     int i;
 203     IsdnCard_t icard;
 204
 205     dev_dbg(&link->dev, "teles_config(0x%p)\n", link);
 206     dev = link->priv;
 207
 208     i = pcmcia_loop_config(link, teles_cs_configcheck, NULL);
 209     if (i != 0)
 210         goto cs_failed;
 211
 212     if (!link->irq)
 213         goto cs_failed;
 214
 215     i = pcmcia_request_configuration(link, &link->conf);
 216     if (i != 0)
 217       goto cs_failed;
 218
 219     /* At this point, the dev_node_t structure(s) should be
 220        initialized and arranged in a linked list at link->dev. *//*  */
 221     sprintf(dev->node.dev_name, "teles");
 222     dev->node.major = dev->node.minor = 0x0;
 223
 224     link->dev_node = &dev->node;
 225
 226     /* Finally, report what we've done */
 227     printk(KERN_INFO "%s: index 0x%02x:",
 228            dev->node.dev_name, link->conf.ConfigIndex);
 229     if (link->conf.Attributes & CONF_ENABLE_IRQ)
 230             printk(", irq %d", link->irq);
 231     if (link->io.NumPorts1)
 232         printk(", io 0x%04x-0x%04x", link->io.BasePort1,
 233                link->io.BasePort1+link->io.NumPorts1-1);
 234     if (link->io.NumPorts2)
 235         printk(" & 0x%04x-0x%04x", link->io.BasePort2,
 236                link->io.BasePort2+link->io.NumPorts2-1);
 237     printk("\n");
 238
 239     icard.para[0] = link->irq;
 240     icard.para[1] = link->io.BasePort1;
 241     icard.protocol = protocol;
 242     icard.typ = ISDN_CTYPE_TELESPCMCIA;
 243
 244     i = hisax_init_pcmcia(link, &(((local_info_t*)link->priv)->busy), &icard);
 245     if (i < 0) {
 246         printk(KERN_ERR "teles_cs: failed to initialize Teles PCMCIA %d at i/o %#x\n",
 247                 i, link->io.BasePort1);
 248         teles_cs_release(link);
 249         return -ENODEV;
 250     }
 251
 252     ((local_info_t*)link->priv)->cardnr = i;
 253     return 0;
 254
 255 cs_failed:
 256     teles_cs_release(link);
 257     return -ENODEV;
 258 } /* teles_cs_config */
 259
 260 /*======================================================================
 261
 262     After a card is removed, teles_cs_release() will unregister the net
 263     device, and release the PCMCIA configuration.  If the device is
 264     still open, this will be postponed until it is closed.
 265
 266 ======================================================================*/
 267
 268 static void teles_cs_release(struct pcmcia_device *link)
 269 {
 270     local_info_t *local = link->priv;
 271
 272     dev_dbg(&link->dev, "teles_cs_release(0x%p)\n", link);
 273
 274     if (local) {
 275         if (local->cardnr >= 0) {
 276             /* no unregister function with hisax */
 277             HiSax_closecard(local->cardnr);
 278         }
 279     }
 280
 281     pcmcia_disable_device(link);
 282 } /* teles_cs_release */
 283
 284 static int teles_suspend(struct pcmcia_device *link)
 285 {
 286         local_info_t *dev = link->priv;
 287
 288         dev->busy = 1;
 289
 290         return 0;
 291 }
 292
 293 static int teles_resume(struct pcmcia_device *link)
 294 {
 295         local_info_t *dev = link->priv;
 296
 297         dev->busy = 0;
 298
 299         return 0;
 300 }
 301
 302
 303 static struct pcmcia_device_id teles_ids[] = {
 304         PCMCIA_DEVICE_PROD_ID12("TELES", "S0/PC", 0x67b50eae, 0xe9e70119),
 305         PCMCIA_DEVICE_NULL,
 306 };
 307 MODULE_DEVICE_TABLE(pcmcia, teles_ids);
 308
 309 static struct pcmcia_driver teles_cs_driver = {
 310         .owner          = THIS_MODULE,
 311         .drv            = {
 312                 .name   = "teles_cs",
 313         },
 314         .probe          = teles_probe,
 315         .remove         = __devexit_p(teles_detach),
 316         .id_table       = teles_ids,
 317         .suspend        = teles_suspend,
 318         .resume         = teles_resume,
 319 };
 320
 321 static int __init init_teles_cs(void)
 322 {
 323         return pcmcia_register_driver(&teles_cs_driver);
 324 }
 325
 326 static void __exit exit_teles_cs(void)
 327 {
 328         pcmcia_unregister_driver(&teles_cs_driver);
 329 }
 330
 331 module_init(init_teles_cs);
 332 module_exit(exit_teles_cs);