Commit | Line | Data |
---|---|---|
124b13b2 FMH |
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 | ||
b79eb4c1 | 62 | #undef LABPC_DEBUG /* debugging messages */ |
124b13b2 FMH |
63 | |
64 | #include "../comedidev.h" | |
65 | ||
66 | #include <linux/delay.h> | |
5a0e3ad6 | 67 | #include <linux/slab.h> |
124b13b2 FMH |
68 | |
69 | #include "8253.h" | |
70 | #include "8255.h" | |
71 | #include "comedi_fc.h" | |
72 | #include "ni_labpc.h" | |
73 | ||
124b13b2 FMH |
74 | #include <pcmcia/cistpl.h> |
75 | #include <pcmcia/cisreg.h> | |
76 | #include <pcmcia/ds.h> | |
77 | ||
96233181 | 78 | static struct pcmcia_device *pcmcia_cur_dev; |
124b13b2 | 79 | |
da91b269 | 80 | static int labpc_attach(struct comedi_device *dev, struct comedi_devconfig *it); |
124b13b2 | 81 | |
9ad00740 | 82 | static const struct labpc_board_struct labpc_cs_boards[] = { |
124b13b2 | 83 | { |
0a85b6f0 | 84 | .name = "daqcard-1200", |
63a4eca5 BM |
85 | .device_id = 0x103, /* 0x10b is manufacturer id, |
86 | 0x103 is device id */ | |
0a85b6f0 MT |
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 | }, | |
124b13b2 FMH |
97 | /* duplicate entry, to support using alternate name */ |
98 | { | |
0a85b6f0 MT |
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 | }, | |
124b13b2 FMH |
111 | }; |
112 | ||
113 | /* | |
114 | * Useful for shorthand access to the particular board structure | |
115 | */ | |
9ad00740 | 116 | #define thisboard ((const struct labpc_board_struct *)dev->board_ptr) |
124b13b2 | 117 | |
139dfbdf | 118 | static struct comedi_driver driver_labpc_cs = { |
124b13b2 FMH |
119 | .driver_name = "ni_labpc_cs", |
120 | .module = THIS_MODULE, | |
121 | .attach = &labpc_attach, | |
122 | .detach = &labpc_common_detach, | |
8629efa4 | 123 | .num_names = ARRAY_SIZE(labpc_cs_boards), |
124b13b2 | 124 | .board_name = &labpc_cs_boards[0].name, |
9ad00740 | 125 | .offset = sizeof(struct labpc_board_struct), |
124b13b2 FMH |
126 | }; |
127 | ||
da91b269 | 128 | static int labpc_attach(struct comedi_device *dev, struct comedi_devconfig *it) |
124b13b2 FMH |
129 | { |
130 | unsigned long iobase = 0; | |
131 | unsigned int irq = 0; | |
132 | struct pcmcia_device *link; | |
133 | ||
134 | /* allocate and initialize dev->private */ | |
0a4eb4b6 | 135 | if (alloc_private(dev, sizeof(struct labpc_private)) < 0) |
124b13b2 FMH |
136 | return -ENOMEM; |
137 | ||
2696fb57 | 138 | /* get base address, irq etc. based on bustype */ |
124b13b2 FMH |
139 | switch (thisboard->bustype) { |
140 | case pcmcia_bustype: | |
141 | link = pcmcia_cur_dev; /* XXX hack */ | |
142 | if (!link) | |
143 | return -EIO; | |
9a017a91 | 144 | iobase = link->resource[0]->start; |
eb14120f | 145 | irq = link->irq; |
124b13b2 FMH |
146 | break; |
147 | default: | |
148 | printk("bug! couldn't determine board type\n"); | |
149 | return -EINVAL; | |
150 | break; | |
151 | } | |
152 | return labpc_common_attach(dev, iobase, irq, 0); | |
153 | } | |
154 | ||
124b13b2 FMH |
155 | /*====================================================================*/ |
156 | ||
157 | /* | |
158 | The event() function is this driver's Card Services event handler. | |
159 | It will be called by Card Services when an appropriate card status | |
160 | event is received. The config() and release() entry points are | |
161 | used to configure or release a socket, in response to card | |
162 | insertion and ejection events. They are invoked from the dummy | |
163 | event handler. | |
164 | ||
165 | Kernel version 2.6.16 upwards uses suspend() and resume() functions | |
166 | instead of an event() function. | |
167 | */ | |
168 | ||
169 | static void labpc_config(struct pcmcia_device *link); | |
170 | static void labpc_release(struct pcmcia_device *link); | |
171 | static int labpc_cs_suspend(struct pcmcia_device *p_dev); | |
172 | static int labpc_cs_resume(struct pcmcia_device *p_dev); | |
173 | ||
174 | /* | |
175 | The attach() and detach() entry points are used to create and destroy | |
176 | "instances" of the driver, where each instance represents everything | |
177 | needed to manage one actual PCMCIA card. | |
178 | */ | |
179 | ||
180 | static int labpc_cs_attach(struct pcmcia_device *); | |
181 | static void labpc_cs_detach(struct pcmcia_device *); | |
182 | ||
183 | /* | |
184 | You'll also need to prototype all the functions that will actually | |
185 | be used to talk to your device. See 'memory_cs' for a good example | |
186 | of a fully self-sufficient driver; the other drivers rely more or | |
187 | less on other parts of the kernel. | |
188 | */ | |
189 | ||
e3f9f2c8 | 190 | struct local_info_t { |
124b13b2 | 191 | struct pcmcia_device *link; |
124b13b2 FMH |
192 | int stop; |
193 | struct bus_operations *bus; | |
e3f9f2c8 | 194 | }; |
124b13b2 FMH |
195 | |
196 | /*====================================================================== | |
197 | ||
198 | labpc_cs_attach() creates an "instance" of the driver, allocating | |
199 | local data structures for one device. The device is registered | |
200 | with Card Services. | |
201 | ||
202 | The dev_link structure is initialized, but we don't actually | |
203 | configure the card at this point -- we wait until we receive a | |
204 | card insertion event. | |
205 | ||
206 | ======================================================================*/ | |
207 | ||
208 | static int labpc_cs_attach(struct pcmcia_device *link) | |
209 | { | |
e3f9f2c8 | 210 | struct local_info_t *local; |
124b13b2 | 211 | |
55a19b39 | 212 | dev_dbg(&link->dev, "labpc_cs_attach()\n"); |
124b13b2 FMH |
213 | |
214 | /* Allocate space for private device-specific data */ | |
e3f9f2c8 | 215 | local = kzalloc(sizeof(struct local_info_t), GFP_KERNEL); |
124b13b2 FMH |
216 | if (!local) |
217 | return -ENOMEM; | |
218 | local->link = link; | |
219 | link->priv = local; | |
220 | ||
124b13b2 FMH |
221 | pcmcia_cur_dev = link; |
222 | ||
223 | labpc_config(link); | |
224 | ||
225 | return 0; | |
226 | } /* labpc_cs_attach */ | |
227 | ||
228 | /*====================================================================== | |
229 | ||
230 | This deletes a driver "instance". The device is de-registered | |
231 | with Card Services. If it has been released, all local data | |
232 | structures are freed. Otherwise, the structures will be freed | |
233 | when the device is released. | |
234 | ||
235 | ======================================================================*/ | |
236 | ||
237 | static void labpc_cs_detach(struct pcmcia_device *link) | |
238 | { | |
55a19b39 | 239 | dev_dbg(&link->dev, "labpc_cs_detach\n"); |
124b13b2 FMH |
240 | |
241 | /* | |
242 | If the device is currently configured and active, we won't | |
243 | actually delete it yet. Instead, it is marked so that when | |
244 | the release() function is called, that will trigger a proper | |
245 | detach(). | |
246 | */ | |
99bd8f22 JMC |
247 | ((struct local_info_t *)link->priv)->stop = 1; |
248 | labpc_release(link); | |
124b13b2 | 249 | |
92c4bad7 BM |
250 | /* This points to the parent local_info_t struct (may be null) */ |
251 | kfree(link->priv); | |
124b13b2 FMH |
252 | |
253 | } /* labpc_cs_detach */ | |
254 | ||
255 | /*====================================================================== | |
256 | ||
257 | labpc_config() is scheduled to run after a CARD_INSERTION event | |
258 | is received, to configure the PCMCIA socket, and to make the | |
259 | device available to the system. | |
260 | ||
261 | ======================================================================*/ | |
262 | ||
55a19b39 DB |
263 | static int labpc_pcmcia_config_loop(struct pcmcia_device *p_dev, |
264 | cistpl_cftable_entry_t *cfg, | |
265 | cistpl_cftable_entry_t *dflt, | |
266 | unsigned int vcc, | |
267 | void *priv_data) | |
124b13b2 | 268 | { |
55a19b39 DB |
269 | if (cfg->index == 0) |
270 | return -ENODEV; | |
124b13b2 | 271 | |
55a19b39 | 272 | /* Does this card need audio output? */ |
fc301101 | 273 | if (cfg->flags & CISTPL_CFTABLE_AUDIO) |
1ac71e5a | 274 | p_dev->config_flags |= CONF_ENABLE_SPKR; |
c3744138 | 275 | |
55a19b39 | 276 | /* Do we need to allocate an interrupt? */ |
1ac71e5a | 277 | p_dev->config_flags |= CONF_ENABLE_IRQ | CONF_ENABLE_PULSE_IRQ; |
55a19b39 DB |
278 | |
279 | /* IO window settings */ | |
90abdc3b | 280 | p_dev->resource[0]->end = p_dev->resource[1]->end = 0; |
55a19b39 DB |
281 | if ((cfg->io.nwin > 0) || (dflt->io.nwin > 0)) { |
282 | cistpl_io_t *io = (cfg->io.nwin) ? &cfg->io : &dflt->io; | |
90abdc3b DB |
283 | p_dev->io_lines = io->flags & CISTPL_IO_LINES_MASK; |
284 | p_dev->resource[0]->flags &= ~IO_DATA_PATH_WIDTH; | |
285 | p_dev->resource[0]->flags |= | |
286 | pcmcia_io_cfg_data_width(io->flags); | |
287 | p_dev->resource[0]->start = io->win[0].base; | |
288 | p_dev->resource[0]->end = io->win[0].len; | |
55a19b39 | 289 | if (io->nwin > 1) { |
90abdc3b DB |
290 | p_dev->resource[1]->flags = p_dev->resource[0]->flags; |
291 | p_dev->resource[1]->start = io->win[1].base; | |
292 | p_dev->resource[1]->end = io->win[1].len; | |
55a19b39 DB |
293 | } |
294 | /* This reserves IO space but doesn't actually enable it */ | |
90abdc3b | 295 | if (pcmcia_request_io(p_dev) != 0) |
55a19b39 | 296 | return -ENODEV; |
124b13b2 | 297 | } |
c3744138 | 298 | |
55a19b39 DB |
299 | /* If we got this far, we're cool! */ |
300 | return 0; | |
301 | } | |
124b13b2 | 302 | |
124b13b2 | 303 | |
55a19b39 DB |
304 | static void labpc_config(struct pcmcia_device *link) |
305 | { | |
55a19b39 | 306 | int ret; |
124b13b2 | 307 | |
55a19b39 | 308 | dev_dbg(&link->dev, "labpc_config\n"); |
124b13b2 | 309 | |
0f52e86d | 310 | ret = pcmcia_loop_config(link, labpc_pcmcia_config_loop, NULL); |
55a19b39 DB |
311 | if (ret) { |
312 | dev_warn(&link->dev, "no configuration found\n"); | |
313 | goto failed; | |
124b13b2 FMH |
314 | } |
315 | ||
eb14120f DB |
316 | if (!link->irq) |
317 | goto failed; | |
124b13b2 FMH |
318 | |
319 | /* | |
320 | This actually configures the PCMCIA socket -- setting up | |
321 | the I/O windows and the interrupt mapping, and putting the | |
322 | card and host interface into "Memory and IO" mode. | |
323 | */ | |
1ac71e5a DB |
324 | p_dev->config_flags |= CONF_ENABLE_IRQ | CONF_ENABLE_PULSE_IRQ; |
325 | ret = pcmcia_enable_device(link); | |
55a19b39 DB |
326 | if (ret) |
327 | goto failed; | |
124b13b2 | 328 | |
124b13b2 | 329 | /* Finally, report what we've done */ |
7feabb64 | 330 | dev_info(&link->dev, "index 0x%02x", link->config_index); |
1ac71e5a | 331 | printk(", irq %d", link->irq); |
9a017a91 DB |
332 | if (link->resource[0]) |
333 | printk(" & %pR", link->resource[0]); | |
334 | if (link->resource[1]) | |
335 | printk(" & %pR", link->resource[1]); | |
124b13b2 FMH |
336 | printk("\n"); |
337 | ||
338 | return; | |
339 | ||
55a19b39 | 340 | failed: |
124b13b2 FMH |
341 | labpc_release(link); |
342 | ||
343 | } /* labpc_config */ | |
344 | ||
345 | static void labpc_release(struct pcmcia_device *link) | |
346 | { | |
55a19b39 | 347 | dev_dbg(&link->dev, "labpc_release\n"); |
124b13b2 FMH |
348 | |
349 | pcmcia_disable_device(link); | |
350 | } /* labpc_release */ | |
351 | ||
352 | /*====================================================================== | |
353 | ||
354 | The card status event handler. Mostly, this schedules other | |
355 | stuff to run after an event is received. | |
356 | ||
357 | When a CARD_REMOVAL event is received, we immediately set a | |
358 | private flag to block future accesses to this device. All the | |
359 | functions that actually access the device should check this flag | |
360 | to make sure the card is still present. | |
361 | ||
362 | ======================================================================*/ | |
363 | ||
364 | static int labpc_cs_suspend(struct pcmcia_device *link) | |
365 | { | |
e3f9f2c8 | 366 | struct local_info_t *local = link->priv; |
124b13b2 FMH |
367 | |
368 | /* Mark the device as stopped, to block IO until later */ | |
369 | local->stop = 1; | |
370 | return 0; | |
371 | } /* labpc_cs_suspend */ | |
372 | ||
373 | static int labpc_cs_resume(struct pcmcia_device *link) | |
374 | { | |
e3f9f2c8 | 375 | struct local_info_t *local = link->priv; |
124b13b2 FMH |
376 | |
377 | local->stop = 0; | |
378 | return 0; | |
379 | } /* labpc_cs_resume */ | |
380 | ||
381 | /*====================================================================*/ | |
382 | ||
383 | static struct pcmcia_device_id labpc_cs_ids[] = { | |
384 | /* N.B. These IDs should match those in labpc_cs_boards (ni_labpc.c) */ | |
385 | PCMCIA_DEVICE_MANF_CARD(0x010b, 0x0103), /* daqcard-1200 */ | |
386 | PCMCIA_DEVICE_NULL | |
387 | }; | |
388 | ||
389 | MODULE_DEVICE_TABLE(pcmcia, labpc_cs_ids); | |
6c7f8196 AK |
390 | MODULE_AUTHOR("Frank Mori Hess <fmhess@users.sourceforge.net>"); |
391 | MODULE_DESCRIPTION("Comedi driver for National Instruments Lab-PC"); | |
392 | MODULE_LICENSE("GPL"); | |
124b13b2 FMH |
393 | |
394 | struct pcmcia_driver labpc_cs_driver = { | |
395 | .probe = labpc_cs_attach, | |
396 | .remove = labpc_cs_detach, | |
397 | .suspend = labpc_cs_suspend, | |
398 | .resume = labpc_cs_resume, | |
399 | .id_table = labpc_cs_ids, | |
400 | .owner = THIS_MODULE, | |
401 | .drv = { | |
1685e633 | 402 | .name = "daqcard-1200", |
124b13b2 FMH |
403 | }, |
404 | }; | |
405 | ||
406 | static int __init init_labpc_cs(void) | |
407 | { | |
124b13b2 FMH |
408 | pcmcia_register_driver(&labpc_cs_driver); |
409 | return 0; | |
410 | } | |
411 | ||
412 | static void __exit exit_labpc_cs(void) | |
413 | { | |
124b13b2 FMH |
414 | pcmcia_unregister_driver(&labpc_cs_driver); |
415 | } | |
416 | ||
417 | int __init labpc_init_module(void) | |
418 | { | |
419 | int ret; | |
420 | ||
421 | ret = init_labpc_cs(); | |
422 | if (ret < 0) | |
423 | return ret; | |
424 | ||
425 | return comedi_driver_register(&driver_labpc_cs); | |
426 | } | |
427 | ||
428 | void __exit labpc_exit_module(void) | |
429 | { | |
430 | exit_labpc_cs(); | |
431 | comedi_driver_unregister(&driver_labpc_cs); | |
432 | } | |
433 | ||
124b13b2 FMH |
434 | module_init(labpc_init_module); |
435 | module_exit(labpc_exit_module); |