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;
120 link->conf.IntType = INT_MEMORY_AND_IO;
122 link->handle = p_dev;
123 p_dev->instance = link;
125 link->state |= DEV_PRESENT | DEV_CONFIG_PENDING;
126 parport_config(link);
129 } /* parport_attach */
131 /*======================================================================
133 This deletes a driver "instance". The device is de-registered
134 with Card Services. If it has been released, all local data
135 structures are freed. Otherwise, the structures will be freed
136 when the device is released.
138 ======================================================================*/
140 static void parport_detach(struct pcmcia_device *p_dev)
142 dev_link_t *link = dev_to_instance(p_dev);
144 DEBUG(0, "parport_detach(0x%p)\n", link);
146 if (link->state & DEV_CONFIG)
147 parport_cs_release(link);
150 } /* parport_detach */
152 /*======================================================================
154 parport_config() is scheduled to run after a CARD_INSERTION event
155 is received, to configure the PCMCIA socket, and to make the
156 parport device available to the system.
158 ======================================================================*/
160 #define CS_CHECK(fn, ret) \
161 do { last_fn = (fn); if ((last_ret = (ret)) != 0) goto cs_failed; } while (0)
163 void parport_config(dev_link_t *link)
165 client_handle_t handle = link->handle;
166 parport_info_t *info = link->priv;
170 cistpl_cftable_entry_t *cfg = &parse.cftable_entry;
171 cistpl_cftable_entry_t dflt = { 0 };
173 int last_ret, last_fn;
175 DEBUG(0, "parport_config(0x%p)\n", link);
177 tuple.TupleData = (cisdata_t *)buf;
178 tuple.TupleOffset = 0; tuple.TupleDataMax = 255;
179 tuple.Attributes = 0;
180 tuple.DesiredTuple = CISTPL_CONFIG;
181 CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(handle, &tuple));
182 CS_CHECK(GetTupleData, pcmcia_get_tuple_data(handle, &tuple));
183 CS_CHECK(ParseTuple, pcmcia_parse_tuple(handle, &tuple, &parse));
184 link->conf.ConfigBase = parse.config.base;
185 link->conf.Present = parse.config.rmask[0];
188 link->state |= DEV_CONFIG;
190 tuple.DesiredTuple = CISTPL_CFTABLE_ENTRY;
191 tuple.Attributes = 0;
192 CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(handle, &tuple));
194 if (pcmcia_get_tuple_data(handle, &tuple) != 0 ||
195 pcmcia_parse_tuple(handle, &tuple, &parse) != 0)
198 if ((cfg->io.nwin > 0) || (dflt.io.nwin > 0)) {
199 cistpl_io_t *io = (cfg->io.nwin) ? &cfg->io : &dflt.io;
200 link->conf.ConfigIndex = cfg->index;
202 link->conf.ConfigIndex |= FORCE_EPP_MODE;
203 link->io.BasePort1 = io->win[0].base;
204 link->io.NumPorts1 = io->win[0].len;
205 link->io.IOAddrLines = io->flags & CISTPL_IO_LINES_MASK;
207 link->io.BasePort2 = io->win[1].base;
208 link->io.NumPorts2 = io->win[1].len;
210 if (pcmcia_request_io(link->handle, &link->io) != 0)
212 /* If we've got this far, we're done */
217 if (cfg->flags & CISTPL_CFTABLE_DEFAULT) dflt = *cfg;
218 CS_CHECK(GetNextTuple, pcmcia_get_next_tuple(handle, &tuple));
221 CS_CHECK(RequestIRQ, pcmcia_request_irq(handle, &link->irq));
222 CS_CHECK(RequestConfiguration, pcmcia_request_configuration(handle, &link->conf));
224 p = parport_pc_probe_port(link->io.BasePort1, link->io.BasePort2,
225 link->irq.AssignedIRQ, PARPORT_DMA_NONE,
228 printk(KERN_NOTICE "parport_cs: parport_pc_probe_port() at "
229 "0x%3x, irq %u failed\n", link->io.BasePort1,
230 link->irq.AssignedIRQ);
234 p->modes |= PARPORT_MODE_PCSPP;
236 p->modes |= PARPORT_MODE_TRISTATE | PARPORT_MODE_EPP;
238 info->node.major = LP_MAJOR;
239 info->node.minor = p->number;
241 strcpy(info->node.dev_name, p->name);
242 link->dev = &info->node;
244 link->state &= ~DEV_CONFIG_PENDING;
248 cs_error(link->handle, last_fn, last_ret);
250 parport_cs_release(link);
251 link->state &= ~DEV_CONFIG_PENDING;
253 } /* parport_config */
255 /*======================================================================
257 After a card is removed, parport_cs_release() will unregister the
258 device, and release the PCMCIA configuration. If the device is
259 still open, this will be postponed until it is closed.
261 ======================================================================*/
263 void parport_cs_release(dev_link_t *link)
265 parport_info_t *info = link->priv;
267 DEBUG(0, "parport_release(0x%p)\n", link);
270 struct parport *p = info->port;
271 parport_pc_unregister_port(p);
275 pcmcia_disable_device(link->handle);
276 } /* parport_cs_release */
279 static struct pcmcia_device_id parport_ids[] = {
280 PCMCIA_DEVICE_FUNC_ID(3),
281 PCMCIA_DEVICE_MANF_CARD(0x0137, 0x0003),
284 MODULE_DEVICE_TABLE(pcmcia, parport_ids);
286 static struct pcmcia_driver parport_cs_driver = {
287 .owner = THIS_MODULE,
289 .name = "parport_cs",
291 .probe = parport_attach,
292 .remove = parport_detach,
293 .id_table = parport_ids,
296 static int __init init_parport_cs(void)
298 return pcmcia_register_driver(&parport_cs_driver);
301 static void __exit exit_parport_cs(void)
303 pcmcia_unregister_driver(&parport_cs_driver);
306 module_init(init_parport_cs);
307 module_exit(exit_parport_cs);