289 lines
8.7 KiB
C
289 lines
8.7 KiB
C
/*********************************************************************
|
|
*
|
|
* Filename: actisys.c
|
|
* Version: 1.0
|
|
* Description: Implementation for the ACTiSYS IR-220L and IR-220L+
|
|
* dongles
|
|
* Status: Beta.
|
|
* Authors: Dag Brattli <dagb@cs.uit.no> (initially)
|
|
* Jean Tourrilhes <jt@hpl.hp.com> (new version)
|
|
* Created at: Wed Oct 21 20:02:35 1998
|
|
* Modified at: Fri Dec 17 09:10:43 1999
|
|
* Modified by: Dag Brattli <dagb@cs.uit.no>
|
|
*
|
|
* Copyright (c) 1998-1999 Dag Brattli, All Rights Reserved.
|
|
* Copyright (c) 1999 Jean Tourrilhes
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License as
|
|
* published by the Free Software Foundation; either version 2 of
|
|
* the License, or (at your option) any later version.
|
|
*
|
|
* Neither Dag Brattli nor University of Tromsø admit liability nor
|
|
* provide warranty for any of this software. This material is
|
|
* provided "AS-IS" and at no charge.
|
|
*
|
|
********************************************************************/
|
|
|
|
/*
|
|
* Changelog
|
|
*
|
|
* 0.8 -> 0.9999 - Jean
|
|
* o New initialisation procedure : much safer and correct
|
|
* o New procedure the change speed : much faster and simpler
|
|
* o Other cleanups & comments
|
|
* Thanks to Lichen Wang @ Actisys for his excellent help...
|
|
*/
|
|
|
|
#include <linux/module.h>
|
|
#include <linux/delay.h>
|
|
#include <linux/tty.h>
|
|
#include <linux/init.h>
|
|
|
|
#include <net/irda/irda.h>
|
|
#include <net/irda/irda_device.h>
|
|
|
|
/*
|
|
* Define the timing of the pulses we send to the dongle (to reset it, and
|
|
* to toggle speeds). Basically, the limit here is the propagation speed of
|
|
* the signals through the serial port, the dongle being much faster. Any
|
|
* serial port support 115 kb/s, so we are sure that pulses 8.5 us wide can
|
|
* go through cleanly . If you are on the wild side, you can try to lower
|
|
* this value (Actisys recommended me 2 us, and 0 us work for me on a P233!)
|
|
*/
|
|
#define MIN_DELAY 10 /* 10 us to be on the conservative side */
|
|
|
|
static int actisys_change_speed(struct irda_task *task);
|
|
static int actisys_reset(struct irda_task *task);
|
|
static void actisys_open(dongle_t *self, struct qos_info *qos);
|
|
static void actisys_close(dongle_t *self);
|
|
|
|
/* These are the baudrates supported, in the order available */
|
|
/* Note : the 220L doesn't support 38400, but we will fix that below */
|
|
static __u32 baud_rates[] = { 9600, 19200, 57600, 115200, 38400 };
|
|
#define MAX_SPEEDS 5
|
|
|
|
static struct dongle_reg dongle = {
|
|
.type = IRDA_ACTISYS_DONGLE,
|
|
.open = actisys_open,
|
|
.close = actisys_close,
|
|
.reset = actisys_reset,
|
|
.change_speed = actisys_change_speed,
|
|
.owner = THIS_MODULE,
|
|
};
|
|
|
|
static struct dongle_reg dongle_plus = {
|
|
.type = IRDA_ACTISYS_PLUS_DONGLE,
|
|
.open = actisys_open,
|
|
.close = actisys_close,
|
|
.reset = actisys_reset,
|
|
.change_speed = actisys_change_speed,
|
|
.owner = THIS_MODULE,
|
|
};
|
|
|
|
/*
|
|
* Function actisys_change_speed (task)
|
|
*
|
|
* There is two model of Actisys dongle we are dealing with,
|
|
* the 220L and 220L+. At this point, only irattach knows with
|
|
* kind the user has requested (it was an argument on irattach
|
|
* command line).
|
|
* So, we register a dongle of each sort and let irattach
|
|
* pick the right one...
|
|
*/
|
|
static int __init actisys_init(void)
|
|
{
|
|
int ret;
|
|
|
|
/* First, register an Actisys 220L dongle */
|
|
ret = irda_device_register_dongle(&dongle);
|
|
if (ret < 0)
|
|
return ret;
|
|
/* Now, register an Actisys 220L+ dongle */
|
|
ret = irda_device_register_dongle(&dongle_plus);
|
|
if (ret < 0) {
|
|
irda_device_unregister_dongle(&dongle);
|
|
return ret;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
static void __exit actisys_cleanup(void)
|
|
{
|
|
/* We have to remove both dongles */
|
|
irda_device_unregister_dongle(&dongle);
|
|
irda_device_unregister_dongle(&dongle_plus);
|
|
}
|
|
|
|
static void actisys_open(dongle_t *self, struct qos_info *qos)
|
|
{
|
|
/* Power on the dongle */
|
|
self->set_dtr_rts(self->dev, TRUE, TRUE);
|
|
|
|
/* Set the speeds we can accept */
|
|
qos->baud_rate.bits &= IR_9600|IR_19200|IR_38400|IR_57600|IR_115200;
|
|
|
|
/* Remove support for 38400 if this is not a 220L+ dongle */
|
|
if (self->issue->type == IRDA_ACTISYS_DONGLE)
|
|
qos->baud_rate.bits &= ~IR_38400;
|
|
|
|
qos->min_turn_time.bits = 0x7f; /* Needs 0.01 ms */
|
|
}
|
|
|
|
static void actisys_close(dongle_t *self)
|
|
{
|
|
/* Power off the dongle */
|
|
self->set_dtr_rts(self->dev, FALSE, FALSE);
|
|
}
|
|
|
|
/*
|
|
* Function actisys_change_speed (task)
|
|
*
|
|
* Change speed of the ACTiSYS IR-220L and IR-220L+ type IrDA dongles.
|
|
* To cycle through the available baud rates, pulse RTS low for a few us.
|
|
*
|
|
* First, we reset the dongle to always start from a known state.
|
|
* Then, we cycle through the speeds by pulsing RTS low and then up.
|
|
* The dongle allow us to pulse quite fast, se we can set speed in one go,
|
|
* which is must faster ( < 100 us) and less complex than what is found
|
|
* in some other dongle drivers...
|
|
* Note that even if the new speed is the same as the current speed,
|
|
* we reassert the speed. This make sure that things are all right,
|
|
* and it's fast anyway...
|
|
* By the way, this function will work for both type of dongles,
|
|
* because the additional speed is at the end of the sequence...
|
|
*/
|
|
static int actisys_change_speed(struct irda_task *task)
|
|
{
|
|
dongle_t *self = (dongle_t *) task->instance;
|
|
__u32 speed = (__u32) task->param; /* Target speed */
|
|
int ret = 0;
|
|
int i = 0;
|
|
|
|
IRDA_DEBUG(4, "%s(), speed=%d (was %d)\n", __FUNCTION__, speed,
|
|
self->speed);
|
|
|
|
/* Go to a known state by reseting the dongle */
|
|
|
|
/* Reset the dongle : set DTR low for 10 us */
|
|
self->set_dtr_rts(self->dev, FALSE, TRUE);
|
|
udelay(MIN_DELAY);
|
|
|
|
/* Go back to normal mode (we are now at 9600 b/s) */
|
|
self->set_dtr_rts(self->dev, TRUE, TRUE);
|
|
|
|
/*
|
|
* Now, we can set the speed requested. Send RTS pulses until we
|
|
* reach the target speed
|
|
*/
|
|
for (i=0; i<MAX_SPEEDS; i++) {
|
|
if (speed == baud_rates[i]) {
|
|
self->speed = baud_rates[i];
|
|
break;
|
|
}
|
|
/* Make sure previous pulse is finished */
|
|
udelay(MIN_DELAY);
|
|
|
|
/* Set RTS low for 10 us */
|
|
self->set_dtr_rts(self->dev, TRUE, FALSE);
|
|
udelay(MIN_DELAY);
|
|
|
|
/* Set RTS high for 10 us */
|
|
self->set_dtr_rts(self->dev, TRUE, TRUE);
|
|
}
|
|
|
|
/* Check if life is sweet... */
|
|
if (i >= MAX_SPEEDS)
|
|
ret = -1; /* This should not happen */
|
|
|
|
/* Basta lavoro, on se casse d'ici... */
|
|
irda_task_next_state(task, IRDA_TASK_DONE);
|
|
|
|
return ret;
|
|
}
|
|
|
|
/*
|
|
* Function actisys_reset (task)
|
|
*
|
|
* Reset the Actisys type dongle. Warning, this function must only be
|
|
* called with a process context!
|
|
*
|
|
* We need to do two things in this function :
|
|
* o first make sure that the dongle is in a state where it can operate
|
|
* o second put the dongle in a know state
|
|
*
|
|
* The dongle is powered of the RTS and DTR lines. In the dongle, there
|
|
* is a big capacitor to accommodate the current spikes. This capacitor
|
|
* takes a least 50 ms to be charged. In theory, the Bios set those lines
|
|
* up, so by the time we arrive here we should be set. It doesn't hurt
|
|
* to be on the conservative side, so we will wait...
|
|
* Then, we set the speed to 9600 b/s to get in a known state (see in
|
|
* change_speed for details). It is needed because the IrDA stack
|
|
* has tried to set the speed immediately after our first return,
|
|
* so before we can be sure the dongle is up and running.
|
|
*/
|
|
static int actisys_reset(struct irda_task *task)
|
|
{
|
|
dongle_t *self = (dongle_t *) task->instance;
|
|
int ret = 0;
|
|
|
|
IRDA_ASSERT(task != NULL, return -1;);
|
|
|
|
self->reset_task = task;
|
|
|
|
switch (task->state) {
|
|
case IRDA_TASK_INIT:
|
|
/* Set both DTR & RTS to power up the dongle */
|
|
/* In theory redundant with power up in actisys_open() */
|
|
self->set_dtr_rts(self->dev, TRUE, TRUE);
|
|
|
|
/* Sleep 50 ms to make sure capacitor is charged */
|
|
ret = msecs_to_jiffies(50);
|
|
irda_task_next_state(task, IRDA_TASK_WAIT);
|
|
break;
|
|
case IRDA_TASK_WAIT:
|
|
/* Reset the dongle : set DTR low for 10 us */
|
|
self->set_dtr_rts(self->dev, FALSE, TRUE);
|
|
udelay(MIN_DELAY);
|
|
|
|
/* Go back to normal mode */
|
|
self->set_dtr_rts(self->dev, TRUE, TRUE);
|
|
|
|
irda_task_next_state(task, IRDA_TASK_DONE);
|
|
self->reset_task = NULL;
|
|
self->speed = 9600; /* That's the default */
|
|
break;
|
|
default:
|
|
IRDA_ERROR("%s(), unknown state %d\n",
|
|
__FUNCTION__, task->state);
|
|
irda_task_next_state(task, IRDA_TASK_DONE);
|
|
self->reset_task = NULL;
|
|
ret = -1;
|
|
break;
|
|
}
|
|
return ret;
|
|
}
|
|
|
|
MODULE_AUTHOR("Dag Brattli <dagb@cs.uit.no> - Jean Tourrilhes <jt@hpl.hp.com>");
|
|
MODULE_DESCRIPTION("ACTiSYS IR-220L and IR-220L+ dongle driver");
|
|
MODULE_LICENSE("GPL");
|
|
MODULE_ALIAS("irda-dongle-2"); /* IRDA_ACTISYS_DONGLE */
|
|
MODULE_ALIAS("irda-dongle-3"); /* IRDA_ACTISYS_PLUS_DONGLE */
|
|
|
|
|
|
/*
|
|
* Function init_module (void)
|
|
*
|
|
* Initialize Actisys module
|
|
*
|
|
*/
|
|
module_init(actisys_init);
|
|
|
|
/*
|
|
* Function cleanup_module (void)
|
|
*
|
|
* Cleanup Actisys module
|
|
*
|
|
*/
|
|
module_exit(actisys_cleanup);
|