1 /*======================================================================
3 A driver for PCMCIA parallel port adapters
5 (specifically, for the Quatech SPP-100 EPP card: other cards will
6 probably require driver tweaks)
8 parport_cs.c 1.29 2002/10/11 06:57:41
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/
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.
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.
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.
35 ======================================================================*/
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>
48 #include <linux/parport.h>
49 #include <linux/parport_pc.h>
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>
58 /*====================================================================*/
60 /* Module parameters */
62 MODULE_AUTHOR("David Hinds <dahinds@users.sourceforge.net>");
63 MODULE_DESCRIPTION("PCMCIA parallel port card driver");
64 MODULE_LICENSE("Dual MPL/GPL");
66 #define INT_MODULE_PARM(n, v) static int n = v; module_param(n, int, 0)
68 INT_MODULE_PARM(epp_mode, 1);
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)";
76 #define DEBUG(n, args...)
79 /*====================================================================*/
81 #define FORCE_EPP_MODE 0x08
83 typedef struct parport_info_t {
90 static dev_link_t *parport_attach(void);
91 static void parport_detach(dev_link_t *);
92 static void parport_config(dev_link_t *link);
93 static void parport_cs_release(dev_link_t *);
94 static int parport_event(event_t event, int priority,
95 event_callback_args_t *args);
97 static dev_info_t dev_info = "parport_cs";
98 static dev_link_t *dev_list = NULL;
100 /*======================================================================
102 parport_attach() creates an "instance" of the driver, allocating
103 local data structures for one device. The device is registered
106 ======================================================================*/
108 static dev_link_t *parport_attach(void)
110 parport_info_t *info;
112 client_reg_t client_reg;
115 DEBUG(0, "parport_attach()\n");
117 /* Create new parport device */
118 info = kmalloc(sizeof(*info), GFP_KERNEL);
119 if (!info) return NULL;
120 memset(info, 0, sizeof(*info));
121 link = &info->link; link->priv = info;
123 link->io.Attributes1 = IO_DATA_PATH_WIDTH_8;
124 link->io.Attributes2 = IO_DATA_PATH_WIDTH_8;
125 link->irq.Attributes = IRQ_TYPE_EXCLUSIVE;
126 link->irq.IRQInfo1 = IRQ_LEVEL_ID;
127 link->conf.Attributes = CONF_ENABLE_IRQ;
129 link->conf.IntType = INT_MEMORY_AND_IO;
131 /* Register with Card Services */
132 link->next = dev_list;
134 client_reg.dev_info = &dev_info;
135 client_reg.Version = 0x0210;
136 client_reg.event_callback_args.client_data = link;
137 ret = pcmcia_register_client(&link->handle, &client_reg);
138 if (ret != CS_SUCCESS) {
139 cs_error(link->handle, RegisterClient, ret);
140 parport_detach(link);
145 } /* parport_attach */
147 /*======================================================================
149 This deletes a driver "instance". The device is de-registered
150 with Card Services. If it has been released, all local data
151 structures are freed. Otherwise, the structures will be freed
152 when the device is released.
154 ======================================================================*/
156 static void parport_detach(dev_link_t *link)
161 DEBUG(0, "parport_detach(0x%p)\n", link);
163 /* Locate device structure */
164 for (linkp = &dev_list; *linkp; linkp = &(*linkp)->next)
165 if (*linkp == link) break;
169 if (link->state & DEV_CONFIG)
170 parport_cs_release(link);
173 ret = pcmcia_deregister_client(link->handle);
174 if (ret != CS_SUCCESS)
175 cs_error(link->handle, DeregisterClient, ret);
178 /* Unlink, free device structure */
182 } /* parport_detach */
184 /*======================================================================
186 parport_config() is scheduled to run after a CARD_INSERTION event
187 is received, to configure the PCMCIA socket, and to make the
188 parport device available to the system.
190 ======================================================================*/
192 #define CS_CHECK(fn, ret) \
193 do { last_fn = (fn); if ((last_ret = (ret)) != 0) goto cs_failed; } while (0)
195 void parport_config(dev_link_t *link)
197 client_handle_t handle = link->handle;
198 parport_info_t *info = link->priv;
203 cistpl_cftable_entry_t *cfg = &parse.cftable_entry;
204 cistpl_cftable_entry_t dflt = { 0 };
206 int last_ret, last_fn;
208 DEBUG(0, "parport_config(0x%p)\n", link);
210 tuple.TupleData = (cisdata_t *)buf;
211 tuple.TupleOffset = 0; tuple.TupleDataMax = 255;
212 tuple.Attributes = 0;
213 tuple.DesiredTuple = CISTPL_CONFIG;
214 CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(handle, &tuple));
215 CS_CHECK(GetTupleData, pcmcia_get_tuple_data(handle, &tuple));
216 CS_CHECK(ParseTuple, pcmcia_parse_tuple(handle, &tuple, &parse));
217 link->conf.ConfigBase = parse.config.base;
218 link->conf.Present = parse.config.rmask[0];
221 link->state |= DEV_CONFIG;
223 /* Not sure if this is right... look up the current Vcc */
224 CS_CHECK(GetConfigurationInfo, pcmcia_get_configuration_info(handle, &conf));
226 tuple.DesiredTuple = CISTPL_CFTABLE_ENTRY;
227 tuple.Attributes = 0;
228 CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(handle, &tuple));
230 if (pcmcia_get_tuple_data(handle, &tuple) != 0 ||
231 pcmcia_parse_tuple(handle, &tuple, &parse) != 0)
234 if ((cfg->io.nwin > 0) || (dflt.io.nwin > 0)) {
235 cistpl_io_t *io = (cfg->io.nwin) ? &cfg->io : &dflt.io;
236 link->conf.ConfigIndex = cfg->index;
238 link->conf.ConfigIndex |= FORCE_EPP_MODE;
239 link->io.BasePort1 = io->win[0].base;
240 link->io.NumPorts1 = io->win[0].len;
241 link->io.IOAddrLines = io->flags & CISTPL_IO_LINES_MASK;
243 link->io.BasePort2 = io->win[1].base;
244 link->io.NumPorts2 = io->win[1].len;
246 if (pcmcia_request_io(link->handle, &link->io) != 0)
248 /* If we've got this far, we're done */
253 if (cfg->flags & CISTPL_CFTABLE_DEFAULT) dflt = *cfg;
254 CS_CHECK(GetNextTuple, pcmcia_get_next_tuple(handle, &tuple));
257 CS_CHECK(RequestIRQ, pcmcia_request_irq(handle, &link->irq));
258 CS_CHECK(RequestConfiguration, pcmcia_request_configuration(handle, &link->conf));
260 release_region(link->io.BasePort1, link->io.NumPorts1);
261 if (link->io.NumPorts2)
262 release_region(link->io.BasePort2, link->io.NumPorts2);
263 p = parport_pc_probe_port(link->io.BasePort1, link->io.BasePort2,
264 link->irq.AssignedIRQ, PARPORT_DMA_NONE,
267 printk(KERN_NOTICE "parport_cs: parport_pc_probe_port() at "
268 "0x%3x, irq %u failed\n", link->io.BasePort1,
269 link->irq.AssignedIRQ);
273 p->modes |= PARPORT_MODE_PCSPP;
275 p->modes |= PARPORT_MODE_TRISTATE | PARPORT_MODE_EPP;
277 info->node.major = LP_MAJOR;
278 info->node.minor = p->number;
280 strcpy(info->node.dev_name, p->name);
281 link->dev = &info->node;
283 link->state &= ~DEV_CONFIG_PENDING;
287 cs_error(link->handle, last_fn, last_ret);
289 parport_cs_release(link);
290 link->state &= ~DEV_CONFIG_PENDING;
292 } /* parport_config */
294 /*======================================================================
296 After a card is removed, parport_cs_release() will unregister the
297 device, and release the PCMCIA configuration. If the device is
298 still open, this will be postponed until it is closed.
300 ======================================================================*/
302 void parport_cs_release(dev_link_t *link)
304 parport_info_t *info = link->priv;
306 DEBUG(0, "parport_release(0x%p)\n", link);
309 struct parport *p = info->port;
310 parport_pc_unregister_port(p);
311 request_region(link->io.BasePort1, link->io.NumPorts1,
312 info->node.dev_name);
313 if (link->io.NumPorts2)
314 request_region(link->io.BasePort2, link->io.NumPorts2,
315 info->node.dev_name);
320 pcmcia_release_configuration(link->handle);
321 pcmcia_release_io(link->handle, &link->io);
322 pcmcia_release_irq(link->handle, &link->irq);
324 link->state &= ~DEV_CONFIG;
326 } /* parport_cs_release */
328 static int parport_suspend(struct pcmcia_device *dev)
330 dev_link_t *link = dev_to_instance(dev);
332 link->state |= DEV_SUSPEND;
333 if (link->state & DEV_CONFIG)
334 pcmcia_release_configuration(link->handle);
339 static int parport_resume(struct pcmcia_device *dev)
341 dev_link_t *link = dev_to_instance(dev);
343 link->state &= ~DEV_SUSPEND;
345 pcmcia_request_configuration(link->handle, &link->conf);
350 /*======================================================================
352 The card status event handler. Mostly, this schedules other
353 stuff to run after an event is received.
355 ======================================================================*/
357 int parport_event(event_t event, int priority,
358 event_callback_args_t *args)
360 dev_link_t *link = args->client_data;
362 DEBUG(1, "parport_event(0x%06x)\n", event);
365 case CS_EVENT_CARD_REMOVAL:
366 link->state &= ~DEV_PRESENT;
367 if (link->state & DEV_CONFIG)
368 parport_cs_release(link);
370 case CS_EVENT_CARD_INSERTION:
371 link->state |= DEV_PRESENT | DEV_CONFIG_PENDING;
372 parport_config(link);
376 } /* parport_event */
378 static struct pcmcia_device_id parport_ids[] = {
379 PCMCIA_DEVICE_FUNC_ID(3),
380 PCMCIA_DEVICE_MANF_CARD(0x0137, 0x0003),
383 MODULE_DEVICE_TABLE(pcmcia, parport_ids);
385 static struct pcmcia_driver parport_cs_driver = {
386 .owner = THIS_MODULE,
388 .name = "parport_cs",
390 .attach = parport_attach,
391 .event = parport_event,
392 .detach = parport_detach,
393 .id_table = parport_ids,
394 .suspend = parport_suspend,
395 .resume = parport_resume,
398 static int __init init_parport_cs(void)
400 return pcmcia_register_driver(&parport_cs_driver);
403 static void __exit exit_parport_cs(void)
405 pcmcia_unregister_driver(&parport_cs_driver);
406 BUG_ON(dev_list != NULL);
409 module_init(init_parport_cs);
410 module_exit(exit_parport_cs);