1 /*********************************************************************
 
   3  *      sir_kthread.c:          dedicated thread to process scheduled
 
   4  *                              sir device setup requests
 
   6  *      Copyright (c) 2002 Martin Diehl
 
   8  *      This program is free software; you can redistribute it and/or 
 
   9  *      modify it under the terms of the GNU General Public License as 
 
  10  *      published by the Free Software Foundation; either version 2 of 
 
  11  *      the License, or (at your option) any later version.
 
  13  ********************************************************************/    
 
  15 #include <linux/module.h>
 
  16 #include <linux/kernel.h>
 
  17 #include <linux/version.h>
 
  18 #include <linux/init.h>
 
  19 #include <linux/smp_lock.h>
 
  20 #include <linux/completion.h>
 
  21 #include <linux/delay.h>
 
  23 #include <net/irda/irda.h>
 
  27 /**************************************************************************
 
  29  * kIrDAd kernel thread and config state machine
 
  33 struct irda_request_queue {
 
  34         struct list_head request_list;
 
  37         struct completion exit;
 
  38         wait_queue_head_t kick, done;
 
  42 static struct irda_request_queue irda_rq_queue;
 
  44 static int irda_queue_request(struct irda_request *rq)
 
  49         if (!test_and_set_bit(0, &rq->pending)) {
 
  50                 spin_lock_irqsave(&irda_rq_queue.lock, flags);
 
  51                 list_add_tail(&rq->lh_request, &irda_rq_queue.request_list);
 
  52                 wake_up(&irda_rq_queue.kick);
 
  53                 atomic_inc(&irda_rq_queue.num_pending);
 
  54                 spin_unlock_irqrestore(&irda_rq_queue.lock, flags);
 
  60 static void irda_request_timer(unsigned long data)
 
  62         struct irda_request *rq = (struct irda_request *)data;
 
  65         spin_lock_irqsave(&irda_rq_queue.lock, flags);
 
  66         list_add_tail(&rq->lh_request, &irda_rq_queue.request_list);
 
  67         wake_up(&irda_rq_queue.kick);
 
  68         spin_unlock_irqrestore(&irda_rq_queue.lock, flags);
 
  71 static int irda_queue_delayed_request(struct irda_request *rq, unsigned long delay)
 
  74         struct timer_list *timer = &rq->timer;
 
  76         if (!test_and_set_bit(0, &rq->pending)) {
 
  77                 timer->expires = jiffies + delay;
 
  78                 timer->function = irda_request_timer;
 
  79                 timer->data = (unsigned long)rq;
 
  80                 atomic_inc(&irda_rq_queue.num_pending);
 
  87 static void run_irda_queue(void)
 
  90         struct list_head *entry, *tmp;
 
  91         struct irda_request *rq;
 
  93         spin_lock_irqsave(&irda_rq_queue.lock, flags);
 
  94         list_for_each_safe(entry, tmp, &irda_rq_queue.request_list) {
 
  95                 rq = list_entry(entry, struct irda_request, lh_request);
 
  97                 spin_unlock_irqrestore(&irda_rq_queue.lock, flags);
 
  99                 clear_bit(0, &rq->pending);
 
 102                 if (atomic_dec_and_test(&irda_rq_queue.num_pending))
 
 103                         wake_up(&irda_rq_queue.done);
 
 105                 spin_lock_irqsave(&irda_rq_queue.lock, flags);
 
 107         spin_unlock_irqrestore(&irda_rq_queue.lock, flags);
 
 110 static int irda_thread(void *startup)
 
 112         DECLARE_WAITQUEUE(wait, current);
 
 116         irda_rq_queue.thread = current;
 
 118         complete((struct completion *)startup);
 
 120         while (irda_rq_queue.thread != NULL) {
 
 122                 /* We use TASK_INTERRUPTIBLE, rather than
 
 123                  * TASK_UNINTERRUPTIBLE.  Andrew Morton made this
 
 124                  * change ; he told me that it is safe, because "signal
 
 125                  * blocking is now handled in daemonize()", he added
 
 126                  * that the problem is that "uninterruptible sleep
 
 127                  * contributes to load average", making user worry.
 
 129                 set_task_state(current, TASK_INTERRUPTIBLE);
 
 130                 add_wait_queue(&irda_rq_queue.kick, &wait);
 
 131                 if (list_empty(&irda_rq_queue.request_list))
 
 134                         __set_task_state(current, TASK_RUNNING);
 
 135                 remove_wait_queue(&irda_rq_queue.kick, &wait);
 
 137                 /* make swsusp happy with our thread */
 
 143 #if LINUX_VERSION_CODE < KERNEL_VERSION(2,5,35)
 
 146         complete_and_exit(&irda_rq_queue.exit, 0);
 
 152 static void flush_irda_queue(void)
 
 154         if (atomic_read(&irda_rq_queue.num_pending)) {
 
 156                 DECLARE_WAITQUEUE(wait, current);
 
 158                 if (!list_empty(&irda_rq_queue.request_list))
 
 161                 set_task_state(current, TASK_UNINTERRUPTIBLE);
 
 162                 add_wait_queue(&irda_rq_queue.done, &wait);
 
 163                 if (atomic_read(&irda_rq_queue.num_pending))
 
 166                         __set_task_state(current, TASK_RUNNING);
 
 167                 remove_wait_queue(&irda_rq_queue.done, &wait);
 
 171 /* substate handler of the config-fsm to handle the cases where we want
 
 172  * to wait for transmit completion before changing the port configuration
 
 175 static int irda_tx_complete_fsm(struct sir_dev *dev)
 
 177         struct sir_fsm *fsm = &dev->fsm;
 
 178         unsigned next_state, delay;
 
 182                 next_state = fsm->substate;     /* default: stay in current substate */
 
 185                 switch(fsm->substate) {
 
 187                 case SIRDEV_STATE_WAIT_XMIT:
 
 188                         if (dev->drv->chars_in_buffer)
 
 189                                 bytes_left = dev->drv->chars_in_buffer(dev);
 
 193                                 next_state = SIRDEV_STATE_WAIT_UNTIL_SENT;
 
 197                         if (dev->speed > 115200)
 
 198                                 delay = (bytes_left*8*10000) / (dev->speed/100);
 
 199                         else if (dev->speed > 0)
 
 200                                 delay = (bytes_left*10*10000) / (dev->speed/100);
 
 203                         /* expected delay (usec) until remaining bytes are sent */
 
 209                         /* sleep some longer delay (msec) */
 
 210                         delay = (delay+999) / 1000;
 
 213                 case SIRDEV_STATE_WAIT_UNTIL_SENT:
 
 214                         /* block until underlaying hardware buffer are empty */
 
 215                         if (dev->drv->wait_until_sent)
 
 216                                 dev->drv->wait_until_sent(dev);
 
 217                         next_state = SIRDEV_STATE_TX_DONE;
 
 220                 case SIRDEV_STATE_TX_DONE:
 
 224                         IRDA_ERROR("%s - undefined state\n", __FUNCTION__);
 
 227                 fsm->substate = next_state;
 
 228         } while (delay == 0);
 
 233  * Function irda_config_fsm
 
 235  * State machine to handle the configuration of the device (and attached dongle, if any).
 
 236  * This handler is scheduled for execution in kIrDAd context, so we can sleep.
 
 237  * however, kIrDAd is shared by all sir_dev devices so we better don't sleep there too
 
 238  * long. Instead, for longer delays we start a timer to reschedule us later.
 
 239  * On entry, fsm->sem is always locked and the netdev xmit queue stopped.
 
 240  * Both must be unlocked/restarted on completion - but only on final exit.
 
 243 static void irda_config_fsm(void *data)
 
 245         struct sir_dev *dev = data;
 
 246         struct sir_fsm *fsm = &dev->fsm;
 
 251         IRDA_DEBUG(2, "%s(), <%ld>\n", __FUNCTION__, jiffies); 
 
 254                 IRDA_DEBUG(3, "%s - state=0x%04x / substate=0x%04x\n",
 
 255                         __FUNCTION__, fsm->state, fsm->substate);
 
 257                 next_state = fsm->state;
 
 262                 case SIRDEV_STATE_DONGLE_OPEN:
 
 263                         if (dev->dongle_drv != NULL) {
 
 264                                 ret = sirdev_put_dongle(dev);
 
 266                                         fsm->result = -EINVAL;
 
 267                                         next_state = SIRDEV_STATE_ERROR;
 
 272                         /* Initialize dongle */
 
 273                         ret = sirdev_get_dongle(dev, fsm->param);
 
 276                                 next_state = SIRDEV_STATE_ERROR;
 
 280                         /* Dongles are powered through the modem control lines which
 
 281                          * were just set during open. Before resetting, let's wait for
 
 282                          * the power to stabilize. This is what some dongle drivers did
 
 283                          * in open before, while others didn't - should be safe anyway.
 
 287                         fsm->substate = SIRDEV_STATE_DONGLE_RESET;
 
 288                         next_state = SIRDEV_STATE_DONGLE_RESET;
 
 294                 case SIRDEV_STATE_DONGLE_CLOSE:
 
 295                         /* shouldn't we just treat this as success=? */
 
 296                         if (dev->dongle_drv == NULL) {
 
 297                                 fsm->result = -EINVAL;
 
 298                                 next_state = SIRDEV_STATE_ERROR;
 
 302                         ret = sirdev_put_dongle(dev);
 
 305                                 next_state = SIRDEV_STATE_ERROR;
 
 308                         next_state = SIRDEV_STATE_DONE;
 
 311                 case SIRDEV_STATE_SET_DTR_RTS:
 
 312                         ret = sirdev_set_dtr_rts(dev,
 
 313                                 (fsm->param&0x02) ? TRUE : FALSE,
 
 314                                 (fsm->param&0x01) ? TRUE : FALSE);
 
 315                         next_state = SIRDEV_STATE_DONE;
 
 318                 case SIRDEV_STATE_SET_SPEED:
 
 319                         fsm->substate = SIRDEV_STATE_WAIT_XMIT;
 
 320                         next_state = SIRDEV_STATE_DONGLE_CHECK;
 
 323                 case SIRDEV_STATE_DONGLE_CHECK:
 
 324                         ret = irda_tx_complete_fsm(dev);
 
 327                                 next_state = SIRDEV_STATE_ERROR;
 
 330                         if ((delay=ret) != 0)
 
 333                         if (dev->dongle_drv) {
 
 334                                 fsm->substate = SIRDEV_STATE_DONGLE_RESET;
 
 335                                 next_state = SIRDEV_STATE_DONGLE_RESET;
 
 338                                 dev->speed = fsm->param;
 
 339                                 next_state = SIRDEV_STATE_PORT_SPEED;
 
 343                 case SIRDEV_STATE_DONGLE_RESET:
 
 344                         if (dev->dongle_drv->reset) {
 
 345                                 ret = dev->dongle_drv->reset(dev);      
 
 348                                         next_state = SIRDEV_STATE_ERROR;
 
 354                         if ((delay=ret) == 0) {
 
 355                                 /* set serial port according to dongle default speed */
 
 356                                 if (dev->drv->set_speed)
 
 357                                         dev->drv->set_speed(dev, dev->speed);
 
 358                                 fsm->substate = SIRDEV_STATE_DONGLE_SPEED;
 
 359                                 next_state = SIRDEV_STATE_DONGLE_SPEED;
 
 363                 case SIRDEV_STATE_DONGLE_SPEED:                         
 
 364                         if (dev->dongle_drv->reset) {
 
 365                                 ret = dev->dongle_drv->set_speed(dev, fsm->param);
 
 368                                         next_state = SIRDEV_STATE_ERROR;
 
 374                         if ((delay=ret) == 0)
 
 375                                 next_state = SIRDEV_STATE_PORT_SPEED;
 
 378                 case SIRDEV_STATE_PORT_SPEED:
 
 379                         /* Finally we are ready to change the serial port speed */
 
 380                         if (dev->drv->set_speed)
 
 381                                 dev->drv->set_speed(dev, dev->speed);
 
 383                         next_state = SIRDEV_STATE_DONE;
 
 386                 case SIRDEV_STATE_DONE:
 
 387                         /* Signal network layer so it can send more frames */
 
 388                         netif_wake_queue(dev->netdev);
 
 389                         next_state = SIRDEV_STATE_COMPLETE;
 
 393                         IRDA_ERROR("%s - undefined state\n", __FUNCTION__);
 
 394                         fsm->result = -EINVAL;
 
 397                 case SIRDEV_STATE_ERROR:
 
 398                         IRDA_ERROR("%s - error: %d\n", __FUNCTION__, fsm->result);
 
 400 #if 0   /* don't enable this before we have netdev->tx_timeout to recover */
 
 401                         netif_stop_queue(dev->netdev);
 
 403                         netif_wake_queue(dev->netdev);
 
 407                 case SIRDEV_STATE_COMPLETE:
 
 408                         /* config change finished, so we are not busy any longer */
 
 409                         sirdev_enable_rx(dev);
 
 413                 fsm->state = next_state;
 
 416         irda_queue_delayed_request(&fsm->rq, msecs_to_jiffies(delay));
 
 419 /* schedule some device configuration task for execution by kIrDAd
 
 420  * on behalf of the above state machine.
 
 421  * can be called from process or interrupt/tasklet context.
 
 424 int sirdev_schedule_request(struct sir_dev *dev, int initial_state, unsigned param)
 
 426         struct sir_fsm *fsm = &dev->fsm;
 
 429         IRDA_DEBUG(2, "%s - state=0x%04x / param=%u\n", __FUNCTION__, initial_state, param);
 
 431         if (down_trylock(&fsm->sem)) {
 
 432                 if (in_interrupt()  ||  in_atomic()  ||  irqs_disabled()) {
 
 433                         IRDA_DEBUG(1, "%s(), state machine busy!\n", __FUNCTION__);
 
 439         if (fsm->state == SIRDEV_STATE_DEAD) {
 
 440                 /* race with sirdev_close should never happen */
 
 441                 IRDA_ERROR("%s(), instance staled!\n", __FUNCTION__);
 
 443                 return -ESTALE;         /* or better EPIPE? */
 
 446         xmit_was_down = netif_queue_stopped(dev->netdev);
 
 447         netif_stop_queue(dev->netdev);
 
 448         atomic_set(&dev->enable_rx, 0);
 
 450         fsm->state = initial_state;
 
 454         INIT_LIST_HEAD(&fsm->rq.lh_request);
 
 456         fsm->rq.func = irda_config_fsm;
 
 459         if (!irda_queue_request(&fsm->rq)) {    /* returns 0 on error! */
 
 460                 atomic_set(&dev->enable_rx, 1);
 
 462                         netif_wake_queue(dev->netdev);          
 
 469 int __init irda_thread_create(void)
 
 471         struct completion startup;
 
 474         spin_lock_init(&irda_rq_queue.lock);
 
 475         irda_rq_queue.thread = NULL;
 
 476         INIT_LIST_HEAD(&irda_rq_queue.request_list);
 
 477         init_waitqueue_head(&irda_rq_queue.kick);
 
 478         init_waitqueue_head(&irda_rq_queue.done);
 
 479         atomic_set(&irda_rq_queue.num_pending, 0);
 
 481         init_completion(&startup);
 
 482         pid = kernel_thread(irda_thread, &startup, CLONE_FS|CLONE_FILES);
 
 486                 wait_for_completion(&startup);
 
 491 void __exit irda_thread_join(void) 
 
 493         if (irda_rq_queue.thread) {
 
 495                 init_completion(&irda_rq_queue.exit);
 
 496                 irda_rq_queue.thread = NULL;
 
 497                 wake_up(&irda_rq_queue.kick);           
 
 498                 wait_for_completion(&irda_rq_queue.exit);