drivers/staging/comedi/drivers/ni_labpc_cs.c

   1 /*
   2     comedi/drivers/ni_labpc_cs.c
   3     Driver for National Instruments daqcard-1200 boards
   4     Copyright (C) 2001, 2002, 2003 Frank Mori Hess <fmhess@users.sourceforge.net>
   5
   6     PCMCIA crap is adapted from dummy_cs.c 1.31 2001/08/24 12:13:13
   7     from the pcmcia package.
   8     The initial developer of the pcmcia dummy_cs.c code is David A. Hinds
   9     <dahinds@users.sourceforge.net>.  Portions created by David A. Hinds
  10     are Copyright (C) 1999 David A. Hinds.
  11
  12     This program is free software; you can redistribute it and/or modify
  13     it under the terms of the GNU General Public License as published by
  14     the Free Software Foundation; either version 2 of the License, or
  15     (at your option) any later version.
  16
  17     This program is distributed in the hope that it will be useful,
  18     but WITHOUT ANY WARRANTY; without even the implied warranty of
  19     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20     GNU General Public License for more details.
  21
  22     You should have received a copy of the GNU General Public License
  23     along with this program; if not, write to the Free Software
  24     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  25
  26 ************************************************************************
  27 */
  28 /*
  29 Driver: ni_labpc_cs
  30 Description: National Instruments Lab-PC (& compatibles)
  31 Author: Frank Mori Hess <fmhess@users.sourceforge.net>
  32 Devices: [National Instruments] DAQCard-1200 (daqcard-1200)
  33 Status: works
  34
  35 Thanks go to Fredrik Lingvall for much testing and perseverance in
  36 helping to debug daqcard-1200 support.
  37
  38 The 1200 series boards have onboard calibration dacs for correcting
  39 analog input/output offsets and gains.  The proper settings for these
  40 caldacs are stored on the board's eeprom.  To read the caldac values
  41 from the eeprom and store them into a file that can be then be used by
  42 comedilib, use the comedi_calibrate program.
  43
  44 Configuration options:
  45   none
  46
  47 The daqcard-1200 has quirky chanlist requirements
  48 when scanning multiple channels.  Multiple channel scan
  49 sequence must start at highest channel, then decrement down to
  50 channel 0.  Chanlists consisting of all one channel
  51 are also legal, and allow you to pace conversions in bursts.
  52
  53 */
  54
  55 /*
  56
  57 NI manuals:
  58 340988a (daqcard-1200)
  59
  60 */
  61
  62 #undef LABPC_DEBUG  /* debugging messages */
  63
  64 #include "../comedidev.h"
  65
  66 #include <linux/delay.h>
  67 #include <linux/slab.h>
  68
  69 #include "8253.h"
  70 #include "8255.h"
  71 #include "comedi_fc.h"
  72 #include "ni_labpc.h"
  73
  74 #include <pcmcia/cistpl.h>
  75 #include <pcmcia/cisreg.h>
  76 #include <pcmcia/ds.h>
  77
  78 static struct pcmcia_device *pcmcia_cur_dev;
  79
  80 static int labpc_attach(struct comedi_device *dev, struct comedi_devconfig *it);
  81
  82 static const struct labpc_board_struct labpc_cs_boards[] = {
  83         {
  84          .name = "daqcard-1200",
  85          .device_id = 0x103,    /* 0x10b is manufacturer id,
  86                                    0x103 is device id */
  87          .ai_speed = 10000,
  88          .bustype = pcmcia_bustype,
  89          .register_layout = labpc_1200_layout,
  90          .has_ao = 1,
  91          .ai_range_table = &range_labpc_1200_ai,
  92          .ai_range_code = labpc_1200_ai_gain_bits,
  93          .ai_range_is_unipolar = labpc_1200_is_unipolar,
  94          .ai_scan_up = 0,
  95          .memory_mapped_io = 0,
  96          },
  97         /* duplicate entry, to support using alternate name */
  98         {
  99          .name = "ni_labpc_cs",
 100          .device_id = 0x103,
 101          .ai_speed = 10000,
 102          .bustype = pcmcia_bustype,
 103          .register_layout = labpc_1200_layout,
 104          .has_ao = 1,
 105          .ai_range_table = &range_labpc_1200_ai,
 106          .ai_range_code = labpc_1200_ai_gain_bits,
 107          .ai_range_is_unipolar = labpc_1200_is_unipolar,
 108          .ai_scan_up = 0,
 109          .memory_mapped_io = 0,
 110          },
 111 };
 112
 113 /*
 114  * Useful for shorthand access to the particular board structure
 115  */
 116 #define thisboard ((const struct labpc_board_struct *)dev->board_ptr)
 117
 118 static struct comedi_driver driver_labpc_cs = {
 119         .driver_name = "ni_labpc_cs",
 120         .module = THIS_MODULE,
 121         .attach = &labpc_attach,
 122         .detach = &labpc_common_detach,
 123         .num_names = ARRAY_SIZE(labpc_cs_boards),
 124         .board_name = &labpc_cs_boards[0].name,
 125         .offset = sizeof(struct labpc_board_struct),
 126 };
 127
 128 static int labpc_attach(struct comedi_device *dev, struct comedi_devconfig *it)
 129 {
 130         unsigned long iobase = 0;
 131         unsigned int irq = 0;
 132         struct pcmcia_device *link;
 133
 134         /* allocate and initialize dev->private */
 135         if (alloc_private(dev, sizeof(struct labpc_private)) < 0)
 136                 return -ENOMEM;
 137
 138         /*  get base address, irq etc. based on bustype */
 139         switch (thisboard->bustype) {
 140         case pcmcia_bustype:
 141                 link = pcmcia_cur_dev;  /* XXX hack */
 142                 if (!link)
 143                         return -EIO;
 144                 iobase = link->resource[0]->start;
 145                 irq = link->irq;
 146                 break;
 147         default:
 148                 pr_err("bug! couldn't determine board type\n");
 149                 return -EINVAL;
 150                 break;
 151         }
 152         return labpc_common_attach(dev, iobase, irq, 0);
 153 }
 154
 155 static void labpc_config(struct pcmcia_device *link);
 156 static void labpc_release(struct pcmcia_device *link);
 157 static int labpc_cs_suspend(struct pcmcia_device *p_dev);
 158 static int labpc_cs_resume(struct pcmcia_device *p_dev);
 159
 160 static int labpc_cs_attach(struct pcmcia_device *);
 161 static void labpc_cs_detach(struct pcmcia_device *);
 162
 163 struct local_info_t {
 164         struct pcmcia_device *link;
 165         int stop;
 166         struct bus_operations *bus;
 167 };
 168
 169 static int labpc_cs_attach(struct pcmcia_device *link)
 170 {
 171         struct local_info_t *local;
 172
 173         dev_dbg(&link->dev, "labpc_cs_attach()\n");
 174
 175         /* Allocate space for private device-specific data */
 176         local = kzalloc(sizeof(struct local_info_t), GFP_KERNEL);
 177         if (!local)
 178                 return -ENOMEM;
 179         local->link = link;
 180         link->priv = local;
 181
 182         pcmcia_cur_dev = link;
 183
 184         labpc_config(link);
 185
 186         return 0;
 187 }                               /* labpc_cs_attach */
 188
 189 static void labpc_cs_detach(struct pcmcia_device *link)
 190 {
 191         ((struct local_info_t *)link->priv)->stop = 1;
 192         labpc_release(link);
 193
 194         /* This points to the parent local_info_t struct (may be null) */
 195         kfree(link->priv);
 196
 197 }
 198
 199 static int labpc_pcmcia_config_loop(struct pcmcia_device *p_dev,
 200                                 void *priv_data)
 201 {
 202         if (p_dev->config_index == 0)
 203                 return -EINVAL;
 204
 205         return pcmcia_request_io(p_dev);
 206 }
 207
 208
 209 static void labpc_config(struct pcmcia_device *link)
 210 {
 211         int ret;
 212
 213         dev_dbg(&link->dev, "labpc_config\n");
 214
 215         link->config_flags |= CONF_ENABLE_IRQ | CONF_ENABLE_PULSE_IRQ |
 216                 CONF_AUTO_AUDIO | CONF_AUTO_SET_IO;
 217
 218         ret = pcmcia_loop_config(link, labpc_pcmcia_config_loop, NULL);
 219         if (ret) {
 220                 dev_warn(&link->dev, "no configuration found\n");
 221                 goto failed;
 222         }
 223
 224         if (!link->irq)
 225                 goto failed;
 226
 227         ret = pcmcia_enable_device(link);
 228         if (ret)
 229                 goto failed;
 230
 231         return;
 232
 233 failed:
 234         labpc_release(link);
 235
 236 }                               /* labpc_config */
 237
 238 static void labpc_release(struct pcmcia_device *link)
 239 {
 240         dev_dbg(&link->dev, "labpc_release\n");
 241
 242         pcmcia_disable_device(link);
 243 }                               /* labpc_release */
 244
 245 static int labpc_cs_suspend(struct pcmcia_device *link)
 246 {
 247         struct local_info_t *local = link->priv;
 248
 249         /* Mark the device as stopped, to block IO until later */
 250         local->stop = 1;
 251         return 0;
 252 }                               /* labpc_cs_suspend */
 253
 254 static int labpc_cs_resume(struct pcmcia_device *link)
 255 {
 256         struct local_info_t *local = link->priv;
 257
 258         local->stop = 0;
 259         return 0;
 260 }                               /* labpc_cs_resume */
 261
 262 static const struct pcmcia_device_id labpc_cs_ids[] = {
 263         /* N.B. These IDs should match those in labpc_cs_boards (ni_labpc.c) */
 264         PCMCIA_DEVICE_MANF_CARD(0x010b, 0x0103),        /* daqcard-1200 */
 265         PCMCIA_DEVICE_NULL
 266 };
 267
 268 MODULE_DEVICE_TABLE(pcmcia, labpc_cs_ids);
 269 MODULE_AUTHOR("Frank Mori Hess <fmhess@users.sourceforge.net>");
 270 MODULE_DESCRIPTION("Comedi driver for National Instruments Lab-PC");
 271 MODULE_LICENSE("GPL");
 272
 273 static struct pcmcia_driver labpc_cs_driver = {
 274         .probe = labpc_cs_attach,
 275         .remove = labpc_cs_detach,
 276         .suspend = labpc_cs_suspend,
 277         .resume = labpc_cs_resume,
 278         .id_table = labpc_cs_ids,
 279         .owner = THIS_MODULE,
 280         .name = "daqcard-1200",
 281 };
 282
 283 static int __init init_labpc_cs(void)
 284 {
 285         pcmcia_register_driver(&labpc_cs_driver);
 286         return 0;
 287 }
 288
 289 static void __exit exit_labpc_cs(void)
 290 {
 291         pcmcia_unregister_driver(&labpc_cs_driver);
 292 }
 293
 294 static int __init labpc_init_module(void)
 295 {
 296         int ret;
 297
 298         ret = init_labpc_cs();
 299         if (ret < 0)
 300                 return ret;
 301
 302         return comedi_driver_register(&driver_labpc_cs);
 303 }
 304
 305 static void __exit labpc_exit_module(void)
 306 {
 307         exit_labpc_cs();
 308         comedi_driver_unregister(&driver_labpc_cs);
 309 }
 310
 311 module_init(labpc_init_module);
 312 module_exit(labpc_exit_module);