drivers/parport/parport_cs.c

   1 /*======================================================================
   2
   3     A driver for PCMCIA parallel port adapters
   4
   5     (specifically, for the Quatech SPP-100 EPP card: other cards will
   6     probably require driver tweaks)
   7
   8     parport_cs.c 1.29 2002/10/11 06:57:41
   9
  10     The contents of this file are subject to the Mozilla Public
  11     License Version 1.1 (the "License"); you may not use this file
  12     except in compliance with the License. You may obtain a copy of
  13     the License at http://www.mozilla.org/MPL/
  14
  15     Software distributed under the License is distributed on an "AS
  16     IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
  17     implied. See the License for the specific language governing
  18     rights and limitations under the License.
  19
  20     The initial developer of the original code is David A. Hinds
  21     <dahinds@users.sourceforge.net>.  Portions created by David A. Hinds
  22     are Copyright (C) 1999 David A. Hinds.  All Rights Reserved.
  23
  24     Alternatively, the contents of this file may be used under the
  25     terms of the GNU General Public License version 2 (the "GPL"), in
  26     which case the provisions of the GPL are applicable instead of the
  27     above.  If you wish to allow the use of your version of this file
  28     only under the terms of the GPL and not to allow others to use
  29     your version of this file under the MPL, indicate your decision
  30     by deleting the provisions above and replace them with the notice
  31     and other provisions required by the GPL.  If you do not delete
  32     the provisions above, a recipient may use your version of this
  33     file under either the MPL or the GPL.
  34
  35 ======================================================================*/
  36
  37 #include <linux/kernel.h>
  38 #include <linux/module.h>
  39 #include <linux/init.h>
  40 #include <linux/sched.h>
  41 #include <linux/ptrace.h>
  42 #include <linux/slab.h>
  43 #include <linux/string.h>
  44 #include <linux/timer.h>
  45 #include <linux/ioport.h>
  46 #include <linux/major.h>
  47
  48 #include <linux/parport.h>
  49 #include <linux/parport_pc.h>
  50
  51 #include <pcmcia/cs_types.h>
  52 #include <pcmcia/cs.h>
  53 #include <pcmcia/cistpl.h>
  54 #include <pcmcia/ds.h>
  55 #include <pcmcia/cisreg.h>
  56 #include <pcmcia/ciscode.h>
  57
  58 /*====================================================================*/
  59
  60 /* Module parameters */
  61
  62 MODULE_AUTHOR("David Hinds <dahinds@users.sourceforge.net>");
  63 MODULE_DESCRIPTION("PCMCIA parallel port card driver");
  64 MODULE_LICENSE("Dual MPL/GPL");
  65
  66 #define INT_MODULE_PARM(n, v) static int n = v; module_param(n, int, 0)
  67
  68 INT_MODULE_PARM(epp_mode, 1);
  69
  70 #ifdef PCMCIA_DEBUG
  71 INT_MODULE_PARM(pc_debug, PCMCIA_DEBUG);
  72 #define DEBUG(n, args...) if (pc_debug>(n)) printk(KERN_DEBUG args)
  73 static char *version =
  74 "parport_cs.c 1.29 2002/10/11 06:57:41 (David Hinds)";
  75 #else
  76 #define DEBUG(n, args...)
  77 #endif
  78
  79 /*====================================================================*/
  80
  81 #define FORCE_EPP_MODE  0x08
  82
  83 typedef struct parport_info_t {
  84         struct pcmcia_device    *p_dev;
  85     int                 ndev;
  86     dev_node_t          node;
  87     struct parport      *port;
  88 } parport_info_t;
  89
  90 static void parport_detach(struct pcmcia_device *p_dev);
  91 static void parport_config(dev_link_t *link);
  92 static void parport_cs_release(dev_link_t *);
  93
  94 /*======================================================================
  95
  96     parport_attach() creates an "instance" of the driver, allocating
  97     local data structures for one device.  The device is registered
  98     with Card Services.
  99
 100 ======================================================================*/
 101
 102 static int parport_attach(struct pcmcia_device *p_dev)
 103 {
 104     parport_info_t *info;
 105     dev_link_t *link = dev_to_instance(p_dev);
 106
 107     DEBUG(0, "parport_attach()\n");
 108
 109     /* Create new parport device */
 110     info = kmalloc(sizeof(*info), GFP_KERNEL);
 111     if (!info) return -ENOMEM;
 112     memset(info, 0, sizeof(*info));
 113     link->priv = info;
 114     info->p_dev = p_dev;
 115
 116     link->io.Attributes1 = IO_DATA_PATH_WIDTH_8;
 117     link->io.Attributes2 = IO_DATA_PATH_WIDTH_8;
 118     link->irq.Attributes = IRQ_TYPE_EXCLUSIVE;
 119     link->irq.IRQInfo1 = IRQ_LEVEL_ID;
 120     link->conf.Attributes = CONF_ENABLE_IRQ;
 121     link->conf.IntType = INT_MEMORY_AND_IO;
 122
 123     link->state |= DEV_PRESENT | DEV_CONFIG_PENDING;
 124     parport_config(link);
 125
 126     return 0;
 127 } /* parport_attach */
 128
 129 /*======================================================================
 130
 131     This deletes a driver "instance".  The device is de-registered
 132     with Card Services.  If it has been released, all local data
 133     structures are freed.  Otherwise, the structures will be freed
 134     when the device is released.
 135
 136 ======================================================================*/
 137
 138 static void parport_detach(struct pcmcia_device *p_dev)
 139 {
 140     dev_link_t *link = dev_to_instance(p_dev);
 141
 142     DEBUG(0, "parport_detach(0x%p)\n", link);
 143
 144     if (link->state & DEV_CONFIG)
 145         parport_cs_release(link);
 146
 147     kfree(link->priv);
 148 } /* parport_detach */
 149
 150 /*======================================================================
 151
 152     parport_config() is scheduled to run after a CARD_INSERTION event
 153     is received, to configure the PCMCIA socket, and to make the
 154     parport device available to the system.
 155
 156 ======================================================================*/
 157
 158 #define CS_CHECK(fn, ret) \
 159 do { last_fn = (fn); if ((last_ret = (ret)) != 0) goto cs_failed; } while (0)
 160
 161 void parport_config(dev_link_t *link)
 162 {
 163     client_handle_t handle = link->handle;
 164     parport_info_t *info = link->priv;
 165     tuple_t tuple;
 166     u_short buf[128];
 167     cisparse_t parse;
 168     cistpl_cftable_entry_t *cfg = &parse.cftable_entry;
 169     cistpl_cftable_entry_t dflt = { 0 };
 170     struct parport *p;
 171     int last_ret, last_fn;
 172
 173     DEBUG(0, "parport_config(0x%p)\n", link);
 174
 175     tuple.TupleData = (cisdata_t *)buf;
 176     tuple.TupleOffset = 0; tuple.TupleDataMax = 255;
 177     tuple.Attributes = 0;
 178     tuple.DesiredTuple = CISTPL_CONFIG;
 179     CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(handle, &tuple));
 180     CS_CHECK(GetTupleData, pcmcia_get_tuple_data(handle, &tuple));
 181     CS_CHECK(ParseTuple, pcmcia_parse_tuple(handle, &tuple, &parse));
 182     link->conf.ConfigBase = parse.config.base;
 183     link->conf.Present = parse.config.rmask[0];
 184
 185     /* Configure card */
 186     link->state |= DEV_CONFIG;
 187
 188     tuple.DesiredTuple = CISTPL_CFTABLE_ENTRY;
 189     tuple.Attributes = 0;
 190     CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(handle, &tuple));
 191     while (1) {
 192         if (pcmcia_get_tuple_data(handle, &tuple) != 0 ||
 193                 pcmcia_parse_tuple(handle, &tuple, &parse) != 0)
 194             goto next_entry;
 195
 196         if ((cfg->io.nwin > 0) || (dflt.io.nwin > 0)) {
 197             cistpl_io_t *io = (cfg->io.nwin) ? &cfg->io : &dflt.io;
 198             link->conf.ConfigIndex = cfg->index;
 199             if (epp_mode)
 200                 link->conf.ConfigIndex |= FORCE_EPP_MODE;
 201             link->io.BasePort1 = io->win[0].base;
 202             link->io.NumPorts1 = io->win[0].len;
 203             link->io.IOAddrLines = io->flags & CISTPL_IO_LINES_MASK;
 204             if (io->nwin == 2) {
 205                 link->io.BasePort2 = io->win[1].base;
 206                 link->io.NumPorts2 = io->win[1].len;
 207             }
 208             if (pcmcia_request_io(link->handle, &link->io) != 0)
 209                 goto next_entry;
 210             /* If we've got this far, we're done */
 211             break;
 212         }
 213
 214     next_entry:
 215         if (cfg->flags & CISTPL_CFTABLE_DEFAULT) dflt = *cfg;
 216         CS_CHECK(GetNextTuple, pcmcia_get_next_tuple(handle, &tuple));
 217     }
 218
 219     CS_CHECK(RequestIRQ, pcmcia_request_irq(handle, &link->irq));
 220     CS_CHECK(RequestConfiguration, pcmcia_request_configuration(handle, &link->conf));
 221
 222     p = parport_pc_probe_port(link->io.BasePort1, link->io.BasePort2,
 223                               link->irq.AssignedIRQ, PARPORT_DMA_NONE,
 224                               NULL);
 225     if (p == NULL) {
 226         printk(KERN_NOTICE "parport_cs: parport_pc_probe_port() at "
 227                "0x%3x, irq %u failed\n", link->io.BasePort1,
 228                link->irq.AssignedIRQ);
 229         goto failed;
 230     }
 231
 232     p->modes |= PARPORT_MODE_PCSPP;
 233     if (epp_mode)
 234         p->modes |= PARPORT_MODE_TRISTATE | PARPORT_MODE_EPP;
 235     info->ndev = 1;
 236     info->node.major = LP_MAJOR;
 237     info->node.minor = p->number;
 238     info->port = p;
 239     strcpy(info->node.dev_name, p->name);
 240     link->dev_node = &info->node;
 241
 242     link->state &= ~DEV_CONFIG_PENDING;
 243     return;
 244
 245 cs_failed:
 246     cs_error(link->handle, last_fn, last_ret);
 247 failed:
 248     parport_cs_release(link);
 249     link->state &= ~DEV_CONFIG_PENDING;
 250
 251 } /* parport_config */
 252
 253 /*======================================================================
 254
 255     After a card is removed, parport_cs_release() will unregister the
 256     device, and release the PCMCIA configuration.  If the device is
 257     still open, this will be postponed until it is closed.
 258
 259 ======================================================================*/
 260
 261 void parport_cs_release(dev_link_t *link)
 262 {
 263         parport_info_t *info = link->priv;
 264
 265         DEBUG(0, "parport_release(0x%p)\n", link);
 266
 267         if (info->ndev) {
 268                 struct parport *p = info->port;
 269                 parport_pc_unregister_port(p);
 270         }
 271         info->ndev = 0;
 272
 273         pcmcia_disable_device(link->handle);
 274 } /* parport_cs_release */
 275
 276
 277 static struct pcmcia_device_id parport_ids[] = {
 278         PCMCIA_DEVICE_FUNC_ID(3),
 279         PCMCIA_DEVICE_MANF_CARD(0x0137, 0x0003),
 280         PCMCIA_DEVICE_NULL
 281 };
 282 MODULE_DEVICE_TABLE(pcmcia, parport_ids);
 283
 284 static struct pcmcia_driver parport_cs_driver = {
 285         .owner          = THIS_MODULE,
 286         .drv            = {
 287                 .name   = "parport_cs",
 288         },
 289         .probe          = parport_attach,
 290         .remove         = parport_detach,
 291         .id_table       = parport_ids,
 292 };
 293
 294 static int __init init_parport_cs(void)
 295 {
 296         return pcmcia_register_driver(&parport_cs_driver);
 297 }
 298
 299 static void __exit exit_parport_cs(void)
 300 {
 301         pcmcia_unregister_driver(&parport_cs_driver);
 302 }
 303
 304 module_init(init_parport_cs);
 305 module_exit(exit_parport_cs);