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 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 *);
94 /*======================================================================
96 parport_attach() creates an "instance" of the driver, allocating
97 local data structures for one device. The device is registered
100 ======================================================================*/
102 static int parport_attach(struct pcmcia_device *p_dev)
104 parport_info_t *info;
107 DEBUG(0, "parport_attach()\n");
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 = &info->link; link->priv = info;
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;
121 link->conf.IntType = INT_MEMORY_AND_IO;
123 link->handle = p_dev;
124 p_dev->instance = link;
126 link->state |= DEV_PRESENT | DEV_CONFIG_PENDING;
127 parport_config(link);
130 } /* parport_attach */
132 /*======================================================================
134 This deletes a driver "instance". The device is de-registered
135 with Card Services. If it has been released, all local data
136 structures are freed. Otherwise, the structures will be freed
137 when the device is released.
139 ======================================================================*/
141 static void parport_detach(struct pcmcia_device *p_dev)
143 dev_link_t *link = dev_to_instance(p_dev);
145 DEBUG(0, "parport_detach(0x%p)\n", link);
147 if (link->state & DEV_CONFIG)
148 parport_cs_release(link);
151 } /* parport_detach */
153 /*======================================================================
155 parport_config() is scheduled to run after a CARD_INSERTION event
156 is received, to configure the PCMCIA socket, and to make the
157 parport device available to the system.
159 ======================================================================*/
161 #define CS_CHECK(fn, ret) \
162 do { last_fn = (fn); if ((last_ret = (ret)) != 0) goto cs_failed; } while (0)
164 void parport_config(dev_link_t *link)
166 client_handle_t handle = link->handle;
167 parport_info_t *info = link->priv;
172 cistpl_cftable_entry_t *cfg = &parse.cftable_entry;
173 cistpl_cftable_entry_t dflt = { 0 };
175 int last_ret, last_fn;
177 DEBUG(0, "parport_config(0x%p)\n", link);
179 tuple.TupleData = (cisdata_t *)buf;
180 tuple.TupleOffset = 0; tuple.TupleDataMax = 255;
181 tuple.Attributes = 0;
182 tuple.DesiredTuple = CISTPL_CONFIG;
183 CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(handle, &tuple));
184 CS_CHECK(GetTupleData, pcmcia_get_tuple_data(handle, &tuple));
185 CS_CHECK(ParseTuple, pcmcia_parse_tuple(handle, &tuple, &parse));
186 link->conf.ConfigBase = parse.config.base;
187 link->conf.Present = parse.config.rmask[0];
190 link->state |= DEV_CONFIG;
192 /* Not sure if this is right... look up the current Vcc */
193 CS_CHECK(GetConfigurationInfo, pcmcia_get_configuration_info(handle, &conf));
195 tuple.DesiredTuple = CISTPL_CFTABLE_ENTRY;
196 tuple.Attributes = 0;
197 CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(handle, &tuple));
199 if (pcmcia_get_tuple_data(handle, &tuple) != 0 ||
200 pcmcia_parse_tuple(handle, &tuple, &parse) != 0)
203 if ((cfg->io.nwin > 0) || (dflt.io.nwin > 0)) {
204 cistpl_io_t *io = (cfg->io.nwin) ? &cfg->io : &dflt.io;
205 link->conf.ConfigIndex = cfg->index;
207 link->conf.ConfigIndex |= FORCE_EPP_MODE;
208 link->io.BasePort1 = io->win[0].base;
209 link->io.NumPorts1 = io->win[0].len;
210 link->io.IOAddrLines = io->flags & CISTPL_IO_LINES_MASK;
212 link->io.BasePort2 = io->win[1].base;
213 link->io.NumPorts2 = io->win[1].len;
215 if (pcmcia_request_io(link->handle, &link->io) != 0)
217 /* If we've got this far, we're done */
222 if (cfg->flags & CISTPL_CFTABLE_DEFAULT) dflt = *cfg;
223 CS_CHECK(GetNextTuple, pcmcia_get_next_tuple(handle, &tuple));
226 CS_CHECK(RequestIRQ, pcmcia_request_irq(handle, &link->irq));
227 CS_CHECK(RequestConfiguration, pcmcia_request_configuration(handle, &link->conf));
229 p = parport_pc_probe_port(link->io.BasePort1, link->io.BasePort2,
230 link->irq.AssignedIRQ, PARPORT_DMA_NONE,
233 printk(KERN_NOTICE "parport_cs: parport_pc_probe_port() at "
234 "0x%3x, irq %u failed\n", link->io.BasePort1,
235 link->irq.AssignedIRQ);
239 p->modes |= PARPORT_MODE_PCSPP;
241 p->modes |= PARPORT_MODE_TRISTATE | PARPORT_MODE_EPP;
243 info->node.major = LP_MAJOR;
244 info->node.minor = p->number;
246 strcpy(info->node.dev_name, p->name);
247 link->dev = &info->node;
249 link->state &= ~DEV_CONFIG_PENDING;
253 cs_error(link->handle, last_fn, last_ret);
255 parport_cs_release(link);
256 link->state &= ~DEV_CONFIG_PENDING;
258 } /* parport_config */
260 /*======================================================================
262 After a card is removed, parport_cs_release() will unregister the
263 device, and release the PCMCIA configuration. If the device is
264 still open, this will be postponed until it is closed.
266 ======================================================================*/
268 void parport_cs_release(dev_link_t *link)
270 parport_info_t *info = link->priv;
272 DEBUG(0, "parport_release(0x%p)\n", link);
275 struct parport *p = info->port;
276 parport_pc_unregister_port(p);
280 pcmcia_disable_device(link->handle);
281 } /* parport_cs_release */
283 static int parport_suspend(struct pcmcia_device *dev)
285 dev_link_t *link = dev_to_instance(dev);
287 link->state |= DEV_SUSPEND;
288 if (link->state & DEV_CONFIG)
289 pcmcia_release_configuration(link->handle);
294 static int parport_resume(struct pcmcia_device *dev)
296 dev_link_t *link = dev_to_instance(dev);
298 link->state &= ~DEV_SUSPEND;
300 pcmcia_request_configuration(link->handle, &link->conf);
305 static struct pcmcia_device_id parport_ids[] = {
306 PCMCIA_DEVICE_FUNC_ID(3),
307 PCMCIA_DEVICE_MANF_CARD(0x0137, 0x0003),
310 MODULE_DEVICE_TABLE(pcmcia, parport_ids);
312 static struct pcmcia_driver parport_cs_driver = {
313 .owner = THIS_MODULE,
315 .name = "parport_cs",
317 .probe = parport_attach,
318 .remove = parport_detach,
319 .id_table = parport_ids,
320 .suspend = parport_suspend,
321 .resume = parport_resume,
324 static int __init init_parport_cs(void)
326 return pcmcia_register_driver(&parport_cs_driver);
329 static void __exit exit_parport_cs(void)
331 pcmcia_unregister_driver(&parport_cs_driver);
334 module_init(init_parport_cs);
335 module_exit(exit_parport_cs);