1 /*********************************************************************
3 * Filename: irda_device.c
5 * Description: Utility functions used by the device drivers
6 * Status: Experimental.
7 * Author: Dag Brattli <dagb@cs.uit.no>
8 * Created at: Sat Oct 9 09:22:27 1999
9 * Modified at: Sun Jan 23 17:41:24 2000
10 * Modified by: Dag Brattli <dagb@cs.uit.no>
12 * Copyright (c) 1999-2000 Dag Brattli, All Rights Reserved.
13 * Copyright (c) 2000-2001 Jean Tourrilhes <jt@hpl.hp.com>
15 * This program is free software; you can redistribute it and/or
16 * modify it under the terms of the GNU General Public License as
17 * published by the Free Software Foundation; either version 2 of
18 * the License, or (at your option) any later version.
20 * This program is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 * GNU General Public License for more details.
25 * You should have received a copy of the GNU General Public License
26 * along with this program; if not, write to the Free Software
27 * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
30 ********************************************************************/
32 #include <linux/string.h>
33 #include <linux/proc_fs.h>
34 #include <linux/skbuff.h>
35 #include <linux/capability.h>
37 #include <linux/if_ether.h>
38 #include <linux/if_arp.h>
39 #include <linux/netdevice.h>
40 #include <linux/init.h>
41 #include <linux/tty.h>
42 #include <linux/kmod.h>
43 #include <linux/spinlock.h>
45 #include <asm/ioctls.h>
46 #include <asm/uaccess.h>
50 #include <net/irda/irda_device.h>
51 #include <net/irda/irlap.h>
52 #include <net/irda/timer.h>
53 #include <net/irda/wrapper.h>
55 static void __irda_task_delete(struct irda_task
*task
);
57 static hashbin_t
*dongles
= NULL
;
58 static hashbin_t
*tasks
= NULL
;
60 #ifdef CONFIG_IRDA_DEBUG
61 static const char *task_state
[] = {
68 "IRDA_TASK_CHILD_INIT",
69 "IRDA_TASK_CHILD_WAIT",
70 "IRDA_TASK_CHILD_DONE",
72 #endif /* CONFIG_IRDA_DEBUG */
74 static void irda_task_timer_expired(void *data
);
76 int __init
irda_device_init( void)
78 dongles
= hashbin_new(HB_NOLOCK
);
79 if (dongles
== NULL
) {
80 IRDA_WARNING("IrDA: Can't allocate dongles hashbin!\n");
83 spin_lock_init(&dongles
->hb_spinlock
);
85 tasks
= hashbin_new(HB_LOCK
);
87 IRDA_WARNING("IrDA: Can't allocate tasks hashbin!\n");
88 hashbin_delete(dongles
, NULL
);
92 /* We no longer initialise the driver ourselves here, we let
93 * the system do it for us... - Jean II */
98 static void __exit
leftover_dongle(void *arg
)
100 struct dongle_reg
*reg
= arg
;
101 IRDA_WARNING("IrDA: Dongle type %x not unregistered\n",
105 void __exit
irda_device_cleanup(void)
107 IRDA_DEBUG(4, "%s()\n", __FUNCTION__
);
109 hashbin_delete(tasks
, (FREE_FUNC
) __irda_task_delete
);
111 hashbin_delete(dongles
, leftover_dongle
);
115 * Function irda_device_set_media_busy (self, status)
117 * Called when we have detected that another station is transmitting
118 * in contention mode.
120 void irda_device_set_media_busy(struct net_device
*dev
, int status
)
122 struct irlap_cb
*self
;
124 IRDA_DEBUG(4, "%s(%s)\n", __FUNCTION__
, status
? "TRUE" : "FALSE");
126 self
= (struct irlap_cb
*) dev
->atalk_ptr
;
128 /* Some drivers may enable the receive interrupt before calling
129 * irlap_open(), or they may disable the receive interrupt
130 * after calling irlap_close().
131 * The IrDA stack is protected from this in irlap_driver_rcv().
132 * However, the driver calls directly the wrapper, that calls
133 * us directly. Make sure we protect ourselves.
135 if (!self
|| self
->magic
!= LAP_MAGIC
)
139 self
->media_busy
= TRUE
;
141 irlap_start_mbusy_timer(self
, SMALLBUSY_TIMEOUT
);
143 irlap_start_mbusy_timer(self
, MEDIABUSY_TIMEOUT
);
144 IRDA_DEBUG( 4, "Media busy!\n");
146 self
->media_busy
= FALSE
;
147 irlap_stop_mbusy_timer(self
);
150 EXPORT_SYMBOL(irda_device_set_media_busy
);
154 * Function irda_device_is_receiving (dev)
156 * Check if the device driver is currently receiving data
159 int irda_device_is_receiving(struct net_device
*dev
)
161 struct if_irda_req req
;
164 IRDA_DEBUG(2, "%s()\n", __FUNCTION__
);
166 if (!dev
->do_ioctl
) {
167 IRDA_ERROR("%s: do_ioctl not impl. by device driver\n",
172 ret
= dev
->do_ioctl(dev
, (struct ifreq
*) &req
, SIOCGRECEIVING
);
176 return req
.ifr_receiving
;
179 void irda_task_next_state(struct irda_task
*task
, IRDA_TASK_STATE state
)
181 IRDA_DEBUG(2, "%s(), state = %s\n", __FUNCTION__
, task_state
[state
]);
185 EXPORT_SYMBOL(irda_task_next_state
);
187 static void __irda_task_delete(struct irda_task
*task
)
189 del_timer(&task
->timer
);
194 void irda_task_delete(struct irda_task
*task
)
196 /* Unregister task */
197 hashbin_remove(tasks
, (long) task
, NULL
);
199 __irda_task_delete(task
);
201 EXPORT_SYMBOL(irda_task_delete
);
204 * Function irda_task_kick (task)
206 * Tries to execute a task possible multiple times until the task is either
207 * finished, or askes for a timeout. When a task is finished, we do post
208 * processing, and notify the parent task, that is waiting for this task
211 static int irda_task_kick(struct irda_task
*task
)
217 IRDA_DEBUG(2, "%s()\n", __FUNCTION__
);
219 IRDA_ASSERT(task
!= NULL
, return -1;);
220 IRDA_ASSERT(task
->magic
== IRDA_TASK_MAGIC
, return -1;);
222 /* Execute task until it's finished, or askes for a timeout */
224 timeout
= task
->function(task
);
226 IRDA_ERROR("%s: error in task handler!\n",
228 irda_task_delete(task
);
231 } while ((timeout
== 0) && (task
->state
!= IRDA_TASK_DONE
));
234 IRDA_ERROR("%s: Error executing task!\n", __FUNCTION__
);
235 irda_task_delete(task
);
239 /* Check if we are finished */
240 if (task
->state
== IRDA_TASK_DONE
) {
241 del_timer(&task
->timer
);
243 /* Do post processing */
245 task
->finished(task
);
249 /* Check if parent is waiting for us to complete */
250 if (task
->parent
->state
== IRDA_TASK_CHILD_WAIT
) {
251 task
->parent
->state
= IRDA_TASK_CHILD_DONE
;
253 /* Stop timer now that we are here */
254 del_timer(&task
->parent
->timer
);
256 /* Kick parent task */
257 irda_task_kick(task
->parent
);
260 irda_task_delete(task
);
261 } else if (timeout
> 0) {
262 irda_start_timer(&task
->timer
, timeout
, (void *) task
,
263 irda_task_timer_expired
);
266 IRDA_DEBUG(0, "%s(), not finished, and no timeout!\n",
275 * Function irda_task_execute (instance, function, finished)
277 * This function registers and tries to execute tasks that may take some
278 * time to complete. We do it this hairy way since we may have been
279 * called from interrupt context, so it's not possible to use
281 * Two important notes :
282 * o Make sure you irda_task_delete(task); in case you delete the
284 * o No real need to lock when calling this function, but you may
285 * want to lock within the task handler.
288 struct irda_task
*irda_task_execute(void *instance
,
289 IRDA_TASK_CALLBACK function
,
290 IRDA_TASK_CALLBACK finished
,
291 struct irda_task
*parent
, void *param
)
293 struct irda_task
*task
;
295 IRDA_DEBUG(2, "%s()\n", __FUNCTION__
);
297 task
= kmalloc(sizeof(struct irda_task
), GFP_ATOMIC
);
301 task
->state
= IRDA_TASK_INIT
;
302 task
->instance
= instance
;
303 task
->function
= function
;
304 task
->finished
= finished
;
305 task
->parent
= parent
;
307 task
->magic
= IRDA_TASK_MAGIC
;
309 init_timer(&task
->timer
);
312 hashbin_insert(tasks
, (irda_queue_t
*) task
, (long) task
, NULL
);
314 /* No time to waste, so lets get going! */
315 return irda_task_kick(task
) ? NULL
: task
;
317 EXPORT_SYMBOL(irda_task_execute
);
320 * Function irda_task_timer_expired (data)
322 * Task time has expired. We now try to execute task (again), and restart
323 * the timer if the task has not finished yet
325 static void irda_task_timer_expired(void *data
)
327 struct irda_task
*task
;
329 IRDA_DEBUG(2, "%s()\n", __FUNCTION__
);
331 task
= (struct irda_task
*) data
;
333 irda_task_kick(task
);
337 * Function irda_device_setup (dev)
339 * This function should be used by low level device drivers in a similar way
340 * as ether_setup() is used by normal network device drivers
342 static void irda_device_setup(struct net_device
*dev
)
344 dev
->hard_header_len
= 0;
345 dev
->addr_len
= LAP_ALEN
;
347 dev
->type
= ARPHRD_IRDA
;
348 dev
->tx_queue_len
= 8; /* Window size + 1 s-frame */
350 memset(dev
->broadcast
, 0xff, LAP_ALEN
);
353 dev
->flags
= IFF_NOARP
;
357 * Funciton alloc_irdadev
358 * Allocates and sets up an IRDA device in a manner similar to
361 struct net_device
*alloc_irdadev(int sizeof_priv
)
363 return alloc_netdev(sizeof_priv
, "irda%d", irda_device_setup
);
365 EXPORT_SYMBOL(alloc_irdadev
);
368 * Function irda_device_init_dongle (self, type, qos)
370 * Initialize attached dongle.
372 * Important : request_module require us to call this function with
373 * a process context and irq enabled. - Jean II
375 dongle_t
*irda_device_dongle_init(struct net_device
*dev
, int type
)
377 struct dongle_reg
*reg
;
378 dongle_t
*dongle
= NULL
;
382 spin_lock(&dongles
->hb_spinlock
);
383 reg
= hashbin_find(dongles
, type
, NULL
);
386 /* Try to load the module needed */
387 if (!reg
&& capable(CAP_SYS_MODULE
)) {
388 spin_unlock(&dongles
->hb_spinlock
);
390 request_module("irda-dongle-%d", type
);
392 spin_lock(&dongles
->hb_spinlock
);
393 reg
= hashbin_find(dongles
, type
, NULL
);
397 if (!reg
|| !try_module_get(reg
->owner
) ) {
398 IRDA_ERROR("IrDA: Unable to find requested dongle type %x\n",
403 /* Allocate dongle info for this instance */
404 dongle
= kmalloc(sizeof(dongle_t
), GFP_KERNEL
);
408 memset(dongle
, 0, sizeof(dongle_t
));
410 /* Bind the registration info to this particular instance */
415 spin_unlock(&dongles
->hb_spinlock
);
418 EXPORT_SYMBOL(irda_device_dongle_init
);
421 * Function irda_device_dongle_cleanup (dongle)
423 int irda_device_dongle_cleanup(dongle_t
*dongle
)
425 IRDA_ASSERT(dongle
!= NULL
, return -1;);
427 dongle
->issue
->close(dongle
);
428 module_put(dongle
->issue
->owner
);
433 EXPORT_SYMBOL(irda_device_dongle_cleanup
);
436 * Function irda_device_register_dongle (dongle)
438 int irda_device_register_dongle(struct dongle_reg
*new)
440 spin_lock(&dongles
->hb_spinlock
);
441 /* Check if this dongle has been registered before */
442 if (hashbin_find(dongles
, new->type
, NULL
)) {
443 IRDA_MESSAGE("%s: Dongle type %x already registered\n",
444 __FUNCTION__
, new->type
);
446 /* Insert IrDA dongle into hashbin */
447 hashbin_insert(dongles
, (irda_queue_t
*) new, new->type
, NULL
);
449 spin_unlock(&dongles
->hb_spinlock
);
453 EXPORT_SYMBOL(irda_device_register_dongle
);
456 * Function irda_device_unregister_dongle (dongle)
458 * Unregister dongle, and remove dongle from list of registered dongles
461 void irda_device_unregister_dongle(struct dongle_reg
*dongle
)
465 spin_lock(&dongles
->hb_spinlock
);
466 node
= hashbin_remove(dongles
, dongle
->type
, NULL
);
468 IRDA_ERROR("%s: dongle not found!\n", __FUNCTION__
);
469 spin_unlock(&dongles
->hb_spinlock
);
471 EXPORT_SYMBOL(irda_device_unregister_dongle
);
473 #ifdef CONFIG_ISA_DMA_API
475 * Function setup_dma (idev, buffer, count, mode)
477 * Setup the DMA channel. Commonly used by LPC FIR drivers
480 void irda_setup_dma(int channel
, dma_addr_t buffer
, int count
, int mode
)
484 flags
= claim_dma_lock();
486 disable_dma(channel
);
487 clear_dma_ff(channel
);
488 set_dma_mode(channel
, mode
);
489 set_dma_addr(channel
, buffer
);
490 set_dma_count(channel
, count
);
493 release_dma_lock(flags
);
495 EXPORT_SYMBOL(irda_setup_dma
);