]> bbs.cooldavid.org Git - net-next-2.6.git/blame - drivers/net/irda/actisys.c
Convert files to UTF-8 and some cleanups
[net-next-2.6.git] / drivers / net / irda / actisys.c
CommitLineData
1da177e4
LT
1/*********************************************************************
2 *
3 * Filename: actisys.c
4 * Version: 1.0
5 * Description: Implementation for the ACTiSYS IR-220L and IR-220L+
6 * dongles
7 * Status: Beta.
8 * Authors: Dag Brattli <dagb@cs.uit.no> (initially)
9 * Jean Tourrilhes <jt@hpl.hp.com> (new version)
10 * Created at: Wed Oct 21 20:02:35 1998
11 * Modified at: Fri Dec 17 09:10:43 1999
12 * Modified by: Dag Brattli <dagb@cs.uit.no>
13 *
14 * Copyright (c) 1998-1999 Dag Brattli, All Rights Reserved.
15 * Copyright (c) 1999 Jean Tourrilhes
16 *
17 * This program is free software; you can redistribute it and/or
18 * modify it under the terms of the GNU General Public License as
19 * published by the Free Software Foundation; either version 2 of
20 * the License, or (at your option) any later version.
21 *
96de0e25 22 * Neither Dag Brattli nor University of Tromsø admit liability nor
1da177e4
LT
23 * provide warranty for any of this software. This material is
24 * provided "AS-IS" and at no charge.
25 *
26 ********************************************************************/
27
28/*
29 * Changelog
30 *
31 * 0.8 -> 0.9999 - Jean
32 * o New initialisation procedure : much safer and correct
33 * o New procedure the change speed : much faster and simpler
34 * o Other cleanups & comments
35 * Thanks to Lichen Wang @ Actisys for his excellent help...
36 */
37
38#include <linux/module.h>
39#include <linux/delay.h>
40#include <linux/tty.h>
41#include <linux/init.h>
42
43#include <net/irda/irda.h>
44#include <net/irda/irda_device.h>
45
46/*
47 * Define the timing of the pulses we send to the dongle (to reset it, and
48 * to toggle speeds). Basically, the limit here is the propagation speed of
49 * the signals through the serial port, the dongle being much faster. Any
50 * serial port support 115 kb/s, so we are sure that pulses 8.5 us wide can
51 * go through cleanly . If you are on the wild side, you can try to lower
52 * this value (Actisys recommended me 2 us, and 0 us work for me on a P233!)
53 */
54#define MIN_DELAY 10 /* 10 us to be on the conservative side */
55
56static int actisys_change_speed(struct irda_task *task);
57static int actisys_reset(struct irda_task *task);
58static void actisys_open(dongle_t *self, struct qos_info *qos);
59static void actisys_close(dongle_t *self);
60
61/* These are the baudrates supported, in the order available */
62/* Note : the 220L doesn't support 38400, but we will fix that below */
63static __u32 baud_rates[] = { 9600, 19200, 57600, 115200, 38400 };
64#define MAX_SPEEDS 5
65
66static struct dongle_reg dongle = {
67 .type = IRDA_ACTISYS_DONGLE,
68 .open = actisys_open,
69 .close = actisys_close,
70 .reset = actisys_reset,
71 .change_speed = actisys_change_speed,
72 .owner = THIS_MODULE,
73};
74
75static struct dongle_reg dongle_plus = {
76 .type = IRDA_ACTISYS_PLUS_DONGLE,
77 .open = actisys_open,
78 .close = actisys_close,
79 .reset = actisys_reset,
80 .change_speed = actisys_change_speed,
81 .owner = THIS_MODULE,
82};
83
84/*
85 * Function actisys_change_speed (task)
86 *
87 * There is two model of Actisys dongle we are dealing with,
88 * the 220L and 220L+. At this point, only irattach knows with
89 * kind the user has requested (it was an argument on irattach
90 * command line).
91 * So, we register a dongle of each sort and let irattach
92 * pick the right one...
93 */
94static int __init actisys_init(void)
95{
96 int ret;
97
98 /* First, register an Actisys 220L dongle */
99 ret = irda_device_register_dongle(&dongle);
100 if (ret < 0)
101 return ret;
102 /* Now, register an Actisys 220L+ dongle */
103 ret = irda_device_register_dongle(&dongle_plus);
104 if (ret < 0) {
105 irda_device_unregister_dongle(&dongle);
106 return ret;
107 }
108 return 0;
109}
110
111static void __exit actisys_cleanup(void)
112{
113 /* We have to remove both dongles */
114 irda_device_unregister_dongle(&dongle);
115 irda_device_unregister_dongle(&dongle_plus);
116}
117
118static void actisys_open(dongle_t *self, struct qos_info *qos)
119{
120 /* Power on the dongle */
121 self->set_dtr_rts(self->dev, TRUE, TRUE);
122
123 /* Set the speeds we can accept */
124 qos->baud_rate.bits &= IR_9600|IR_19200|IR_38400|IR_57600|IR_115200;
125
126 /* Remove support for 38400 if this is not a 220L+ dongle */
127 if (self->issue->type == IRDA_ACTISYS_DONGLE)
128 qos->baud_rate.bits &= ~IR_38400;
129
130 qos->min_turn_time.bits = 0x7f; /* Needs 0.01 ms */
131}
132
133static void actisys_close(dongle_t *self)
134{
135 /* Power off the dongle */
136 self->set_dtr_rts(self->dev, FALSE, FALSE);
137}
138
139/*
140 * Function actisys_change_speed (task)
141 *
142 * Change speed of the ACTiSYS IR-220L and IR-220L+ type IrDA dongles.
143 * To cycle through the available baud rates, pulse RTS low for a few us.
144 *
145 * First, we reset the dongle to always start from a known state.
146 * Then, we cycle through the speeds by pulsing RTS low and then up.
147 * The dongle allow us to pulse quite fast, se we can set speed in one go,
148 * which is must faster ( < 100 us) and less complex than what is found
149 * in some other dongle drivers...
150 * Note that even if the new speed is the same as the current speed,
151 * we reassert the speed. This make sure that things are all right,
152 * and it's fast anyway...
153 * By the way, this function will work for both type of dongles,
154 * because the additional speed is at the end of the sequence...
155 */
156static int actisys_change_speed(struct irda_task *task)
157{
158 dongle_t *self = (dongle_t *) task->instance;
159 __u32 speed = (__u32) task->param; /* Target speed */
160 int ret = 0;
161 int i = 0;
162
163 IRDA_DEBUG(4, "%s(), speed=%d (was %d)\n", __FUNCTION__, speed,
164 self->speed);
165
166 /* Go to a known state by reseting the dongle */
167
168 /* Reset the dongle : set DTR low for 10 us */
169 self->set_dtr_rts(self->dev, FALSE, TRUE);
170 udelay(MIN_DELAY);
171
172 /* Go back to normal mode (we are now at 9600 b/s) */
173 self->set_dtr_rts(self->dev, TRUE, TRUE);
174
175 /*
176 * Now, we can set the speed requested. Send RTS pulses until we
177 * reach the target speed
178 */
179 for (i=0; i<MAX_SPEEDS; i++) {
180 if (speed == baud_rates[i]) {
181 self->speed = baud_rates[i];
182 break;
183 }
184 /* Make sure previous pulse is finished */
185 udelay(MIN_DELAY);
186
187 /* Set RTS low for 10 us */
188 self->set_dtr_rts(self->dev, TRUE, FALSE);
189 udelay(MIN_DELAY);
190
191 /* Set RTS high for 10 us */
192 self->set_dtr_rts(self->dev, TRUE, TRUE);
193 }
194
195 /* Check if life is sweet... */
196 if (i >= MAX_SPEEDS)
197 ret = -1; /* This should not happen */
198
199 /* Basta lavoro, on se casse d'ici... */
200 irda_task_next_state(task, IRDA_TASK_DONE);
201
202 return ret;
203}
204
205/*
206 * Function actisys_reset (task)
207 *
208 * Reset the Actisys type dongle. Warning, this function must only be
209 * called with a process context!
210 *
211 * We need to do two things in this function :
212 * o first make sure that the dongle is in a state where it can operate
213 * o second put the dongle in a know state
214 *
215 * The dongle is powered of the RTS and DTR lines. In the dongle, there
216 * is a big capacitor to accommodate the current spikes. This capacitor
217 * takes a least 50 ms to be charged. In theory, the Bios set those lines
218 * up, so by the time we arrive here we should be set. It doesn't hurt
219 * to be on the conservative side, so we will wait...
220 * Then, we set the speed to 9600 b/s to get in a known state (see in
221 * change_speed for details). It is needed because the IrDA stack
222 * has tried to set the speed immediately after our first return,
223 * so before we can be sure the dongle is up and running.
224 */
225static int actisys_reset(struct irda_task *task)
226{
227 dongle_t *self = (dongle_t *) task->instance;
228 int ret = 0;
229
230 IRDA_ASSERT(task != NULL, return -1;);
231
232 self->reset_task = task;
233
234 switch (task->state) {
235 case IRDA_TASK_INIT:
236 /* Set both DTR & RTS to power up the dongle */
237 /* In theory redundant with power up in actisys_open() */
238 self->set_dtr_rts(self->dev, TRUE, TRUE);
239
240 /* Sleep 50 ms to make sure capacitor is charged */
241 ret = msecs_to_jiffies(50);
242 irda_task_next_state(task, IRDA_TASK_WAIT);
243 break;
244 case IRDA_TASK_WAIT:
245 /* Reset the dongle : set DTR low for 10 us */
246 self->set_dtr_rts(self->dev, FALSE, TRUE);
247 udelay(MIN_DELAY);
248
249 /* Go back to normal mode */
250 self->set_dtr_rts(self->dev, TRUE, TRUE);
251
252 irda_task_next_state(task, IRDA_TASK_DONE);
253 self->reset_task = NULL;
254 self->speed = 9600; /* That's the default */
255 break;
256 default:
257 IRDA_ERROR("%s(), unknown state %d\n",
258 __FUNCTION__, task->state);
259 irda_task_next_state(task, IRDA_TASK_DONE);
260 self->reset_task = NULL;
261 ret = -1;
262 break;
263 }
264 return ret;
265}
266
267MODULE_AUTHOR("Dag Brattli <dagb@cs.uit.no> - Jean Tourrilhes <jt@hpl.hp.com>");
268MODULE_DESCRIPTION("ACTiSYS IR-220L and IR-220L+ dongle driver");
269MODULE_LICENSE("GPL");
270MODULE_ALIAS("irda-dongle-2"); /* IRDA_ACTISYS_DONGLE */
271MODULE_ALIAS("irda-dongle-3"); /* IRDA_ACTISYS_PLUS_DONGLE */
272
273
274/*
275 * Function init_module (void)
276 *
277 * Initialize Actisys module
278 *
279 */
280module_init(actisys_init);
281
282/*
283 * Function cleanup_module (void)
284 *
285 * Cleanup Actisys module
286 *
287 */
288module_exit(actisys_cleanup);