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 int parport_config(struct pcmcia_device *link);
  92 static void parport_cs_release(struct pcmcia_device *);
  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_probe(struct pcmcia_device *link)
 103 {
 104     parport_info_t *info;
 105
 106     DEBUG(0, "parport_attach()\n");
 107
 108     /* Create new parport device */
 109     info = kmalloc(sizeof(*info), GFP_KERNEL);
 110     if (!info) return -ENOMEM;
 111     memset(info, 0, sizeof(*info));
 112     link->priv = info;
 113     info->p_dev = link;
 114
 115     link->io.Attributes1 = IO_DATA_PATH_WIDTH_8;
 116     link->io.Attributes2 = IO_DATA_PATH_WIDTH_8;
 117     link->irq.Attributes = IRQ_TYPE_EXCLUSIVE;
 118     link->irq.IRQInfo1 = IRQ_LEVEL_ID;
 119     link->conf.Attributes = CONF_ENABLE_IRQ;
 120     link->conf.IntType = INT_MEMORY_AND_IO;
 121
 122     return parport_config(link);
 123 } /* parport_attach */
 124
 125 /*======================================================================
 126
 127     This deletes a driver "instance".  The device is de-registered
 128     with Card Services.  If it has been released, all local data
 129     structures are freed.  Otherwise, the structures will be freed
 130     when the device is released.
 131
 132 ======================================================================*/
 133
 134 static void parport_detach(struct pcmcia_device *link)
 135 {
 136     DEBUG(0, "parport_detach(0x%p)\n", link);
 137
 138     parport_cs_release(link);
 139
 140     kfree(link->priv);
 141 } /* parport_detach */
 142
 143 /*======================================================================
 144
 145     parport_config() is scheduled to run after a CARD_INSERTION event
 146     is received, to configure the PCMCIA socket, and to make the
 147     parport device available to the system.
 148
 149 ======================================================================*/
 150
 151 #define CS_CHECK(fn, ret) \
 152 do { last_fn = (fn); if ((last_ret = (ret)) != 0) goto cs_failed; } while (0)
 153
 154 static int parport_config(struct pcmcia_device *link)
 155 {
 156     parport_info_t *info = link->priv;
 157     tuple_t tuple;
 158     u_short buf[128];
 159     cisparse_t parse;
 160     cistpl_cftable_entry_t *cfg = &parse.cftable_entry;
 161     cistpl_cftable_entry_t dflt = { 0 };
 162     struct parport *p;
 163     int last_ret, last_fn;
 164
 165     DEBUG(0, "parport_config(0x%p)\n", link);
 166
 167     tuple.TupleData = (cisdata_t *)buf;
 168     tuple.TupleOffset = 0; tuple.TupleDataMax = 255;
 169     tuple.Attributes = 0;
 170     tuple.DesiredTuple = CISTPL_CONFIG;
 171     CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(link, &tuple));
 172     CS_CHECK(GetTupleData, pcmcia_get_tuple_data(link, &tuple));
 173     CS_CHECK(ParseTuple, pcmcia_parse_tuple(link, &tuple, &parse));
 174     link->conf.ConfigBase = parse.config.base;
 175     link->conf.Present = parse.config.rmask[0];
 176
 177     tuple.DesiredTuple = CISTPL_CFTABLE_ENTRY;
 178     tuple.Attributes = 0;
 179     CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(link, &tuple));
 180     while (1) {
 181         if (pcmcia_get_tuple_data(link, &tuple) != 0 ||
 182                 pcmcia_parse_tuple(link, &tuple, &parse) != 0)
 183             goto next_entry;
 184
 185         if ((cfg->io.nwin > 0) || (dflt.io.nwin > 0)) {
 186             cistpl_io_t *io = (cfg->io.nwin) ? &cfg->io : &dflt.io;
 187             link->conf.ConfigIndex = cfg->index;
 188             if (epp_mode)
 189                 link->conf.ConfigIndex |= FORCE_EPP_MODE;
 190             link->io.BasePort1 = io->win[0].base;
 191             link->io.NumPorts1 = io->win[0].len;
 192             link->io.IOAddrLines = io->flags & CISTPL_IO_LINES_MASK;
 193             if (io->nwin == 2) {
 194                 link->io.BasePort2 = io->win[1].base;
 195                 link->io.NumPorts2 = io->win[1].len;
 196             }
 197             if (pcmcia_request_io(link, &link->io) != 0)
 198                 goto next_entry;
 199             /* If we've got this far, we're done */
 200             break;
 201         }
 202
 203     next_entry:
 204         if (cfg->flags & CISTPL_CFTABLE_DEFAULT) dflt = *cfg;
 205         CS_CHECK(GetNextTuple, pcmcia_get_next_tuple(link, &tuple));
 206     }
 207
 208     CS_CHECK(RequestIRQ, pcmcia_request_irq(link, &link->irq));
 209     CS_CHECK(RequestConfiguration, pcmcia_request_configuration(link, &link->conf));
 210
 211     p = parport_pc_probe_port(link->io.BasePort1, link->io.BasePort2,
 212                               link->irq.AssignedIRQ, PARPORT_DMA_NONE,
 213                               NULL);
 214     if (p == NULL) {
 215         printk(KERN_NOTICE "parport_cs: parport_pc_probe_port() at "
 216                "0x%3x, irq %u failed\n", link->io.BasePort1,
 217                link->irq.AssignedIRQ);
 218         goto failed;
 219     }
 220
 221     p->modes |= PARPORT_MODE_PCSPP;
 222     if (epp_mode)
 223         p->modes |= PARPORT_MODE_TRISTATE | PARPORT_MODE_EPP;
 224     info->ndev = 1;
 225     info->node.major = LP_MAJOR;
 226     info->node.minor = p->number;
 227     info->port = p;
 228     strcpy(info->node.dev_name, p->name);
 229     link->dev_node = &info->node;
 230
 231     return 0;
 232
 233 cs_failed:
 234     cs_error(link, last_fn, last_ret);
 235 failed:
 236     parport_cs_release(link);
 237     return -ENODEV;
 238 } /* parport_config */
 239
 240 /*======================================================================
 241
 242     After a card is removed, parport_cs_release() will unregister the
 243     device, and release the PCMCIA configuration.  If the device is
 244     still open, this will be postponed until it is closed.
 245
 246 ======================================================================*/
 247
 248 void parport_cs_release(struct pcmcia_device *link)
 249 {
 250         parport_info_t *info = link->priv;
 251
 252         DEBUG(0, "parport_release(0x%p)\n", link);
 253
 254         if (info->ndev) {
 255                 struct parport *p = info->port;
 256                 parport_pc_unregister_port(p);
 257         }
 258         info->ndev = 0;
 259
 260         pcmcia_disable_device(link);
 261 } /* parport_cs_release */
 262
 263
 264 static struct pcmcia_device_id parport_ids[] = {
 265         PCMCIA_DEVICE_FUNC_ID(3),
 266         PCMCIA_DEVICE_MANF_CARD(0x0137, 0x0003),
 267         PCMCIA_DEVICE_NULL
 268 };
 269 MODULE_DEVICE_TABLE(pcmcia, parport_ids);
 270
 271 static struct pcmcia_driver parport_cs_driver = {
 272         .owner          = THIS_MODULE,
 273         .drv            = {
 274                 .name   = "parport_cs",
 275         },
 276         .probe          = parport_probe,
 277         .remove         = parport_detach,
 278         .id_table       = parport_ids,
 279 };
 280
 281 static int __init init_parport_cs(void)
 282 {
 283         return pcmcia_register_driver(&parport_cs_driver);
 284 }
 285
 286 static void __exit exit_parport_cs(void)
 287 {
 288         pcmcia_unregister_driver(&parport_cs_driver);
 289 }
 290
 291 module_init(init_parport_cs);
 292 module_exit(exit_parport_cs);