1 /* This is the serial hardware link layer (HLL) for the Gigaset 307x isdn
2 * DECT base (aka Sinus 45 isdn) using the RS232 DECT data module M101,
3 * written as a line discipline.
5 * =====================================================================
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License as
8 * published by the Free Software Foundation; either version 2 of
9 * the License, or (at your option) any later version.
10 * =====================================================================
14 #include <linux/module.h>
15 #include <linux/moduleparam.h>
16 #include <linux/platform_device.h>
17 #include <linux/completion.h>
19 /* Version Information */
20 #define DRIVER_AUTHOR "Tilman Schmidt"
21 #define DRIVER_DESC "Serial Driver for Gigaset 307x using Siemens M101"
23 #define GIGASET_MINORS 1
24 #define GIGASET_MINOR 0
25 #define GIGASET_MODULENAME "ser_gigaset"
26 #define GIGASET_DEVNAME "ttyGS"
28 /* length limit according to Siemens 3070usb-protokoll.doc ch. 2.1 */
29 #define IF_WRITEBUF 264
31 MODULE_AUTHOR(DRIVER_AUTHOR
);
32 MODULE_DESCRIPTION(DRIVER_DESC
);
33 MODULE_LICENSE("GPL");
34 MODULE_ALIAS_LDISC(N_GIGASET_M101
);
36 static int startmode
= SM_ISDN
;
37 module_param(startmode
, int, S_IRUGO
);
38 MODULE_PARM_DESC(startmode
, "initial operation mode");
39 static int cidmode
= 1;
40 module_param(cidmode
, int, S_IRUGO
);
41 MODULE_PARM_DESC(cidmode
, "stay in CID mode when idle");
43 static struct gigaset_driver
*driver
;
45 struct ser_cardstate
{
46 struct platform_device dev
;
47 struct tty_struct
*tty
;
49 struct completion dead_cmp
;
52 static struct platform_driver device_driver
= {
54 .name
= GIGASET_MODULENAME
,
58 static void flush_send_queue(struct cardstate
*);
60 /* transmit data from current open skb
61 * result: number of bytes sent or error code < 0
63 static int write_modem(struct cardstate
*cs
)
65 struct tty_struct
*tty
= cs
->hw
.ser
->tty
;
66 struct bc_state
*bcs
= &cs
->bcs
[0]; /* only one channel */
67 struct sk_buff
*skb
= bcs
->tx_skb
;
68 int sent
= -EOPNOTSUPP
;
70 WARN_ON(!tty
|| !tty
->ops
|| !skb
);
73 dev_kfree_skb_any(skb
);
78 set_bit(TTY_DO_WRITE_WAKEUP
, &tty
->flags
);
80 sent
= tty
->ops
->write(tty
, skb
->data
, skb
->len
);
81 gig_dbg(DEBUG_OUTPUT
, "write_modem: sent %d", sent
);
89 /* skb sent completely */
90 gigaset_skb_sent(bcs
, skb
);
92 gig_dbg(DEBUG_INTR
, "kfree skb (Adr: %lx)!",
94 dev_kfree_skb_any(skb
);
101 * transmit first queued command buffer
102 * result: number of bytes sent or error code < 0
104 static int send_cb(struct cardstate
*cs
)
106 struct tty_struct
*tty
= cs
->hw
.ser
->tty
;
107 struct cmdbuf_t
*cb
, *tcb
;
111 WARN_ON(!tty
|| !tty
->ops
);
115 return 0; /* nothing to do */
118 set_bit(TTY_DO_WRITE_WAKEUP
, &tty
->flags
);
119 sent
= tty
->ops
->write(tty
, cb
->buf
+ cb
->offset
, cb
->len
);
122 gig_dbg(DEBUG_OUTPUT
, "send_cb: write error %d", sent
);
123 flush_send_queue(cs
);
128 gig_dbg(DEBUG_OUTPUT
, "send_cb: sent %d, left %u, queued %u",
129 sent
, cb
->len
, cs
->cmdbytes
);
132 while (cb
&& !cb
->len
) {
133 spin_lock_irqsave(&cs
->cmdlock
, flags
);
134 cs
->cmdbytes
-= cs
->curlen
;
136 cs
->cmdbuf
= cb
= cb
->next
;
139 cs
->curlen
= cb
->len
;
141 cs
->lastcmdbuf
= NULL
;
144 spin_unlock_irqrestore(&cs
->cmdlock
, flags
);
146 if (tcb
->wake_tasklet
)
147 tasklet_schedule(tcb
->wake_tasklet
);
155 * If there is already a skb opened, put data to the transfer buffer
156 * by calling "write_modem".
157 * Otherwise take a new skb out of the queue.
159 static void gigaset_modem_fill(unsigned long data
)
161 struct cardstate
*cs
= (struct cardstate
*) data
;
162 struct bc_state
*bcs
;
163 struct sk_buff
*nextskb
;
167 gig_dbg(DEBUG_OUTPUT
, "%s: no cardstate", __func__
);
172 gig_dbg(DEBUG_OUTPUT
, "%s: no cardstate", __func__
);
176 /* no skb is being sent; send command if any */
178 gig_dbg(DEBUG_OUTPUT
, "%s: send_cb -> %d", __func__
, sent
);
180 /* something sent or error */
183 /* no command to send; get skb */
184 nextskb
= skb_dequeue(&bcs
->squeue
);
186 /* no skb either, nothing to do */
188 bcs
->tx_skb
= nextskb
;
190 gig_dbg(DEBUG_INTR
, "Dequeued skb (Adr: %lx)",
191 (unsigned long) bcs
->tx_skb
);
195 gig_dbg(DEBUG_OUTPUT
, "%s: tx_skb", __func__
);
196 if (write_modem(cs
) < 0)
197 gig_dbg(DEBUG_OUTPUT
, "%s: write_modem failed", __func__
);
201 * throw away all data queued for sending
203 static void flush_send_queue(struct cardstate
*cs
)
210 spin_lock_irqsave(&cs
->cmdlock
, flags
);
211 while ((cb
= cs
->cmdbuf
) != NULL
) {
212 cs
->cmdbuf
= cb
->next
;
213 if (cb
->wake_tasklet
)
214 tasklet_schedule(cb
->wake_tasklet
);
217 cs
->cmdbuf
= cs
->lastcmdbuf
= NULL
;
218 cs
->cmdbytes
= cs
->curlen
= 0;
219 spin_unlock_irqrestore(&cs
->cmdlock
, flags
);
223 dev_kfree_skb_any(cs
->bcs
->tx_skb
);
224 while ((skb
= skb_dequeue(&cs
->bcs
->squeue
)) != NULL
)
225 dev_kfree_skb_any(skb
);
229 /* Gigaset Driver Interface */
230 /* ======================== */
233 * queue an AT command string for transmission to the Gigaset device
235 * cs controller state structure
236 * buf buffer containing the string to send
237 * len number of characters to send
238 * wake_tasklet tasklet to run when transmission is complete, or NULL
240 * number of bytes queued, or error code < 0
242 static int gigaset_write_cmd(struct cardstate
*cs
, struct cmdbuf_t
*cb
)
246 gigaset_dbg_buffer(cs
->mstate
!= MS_LOCKED
?
247 DEBUG_TRANSCMD
: DEBUG_LOCKCMD
,
248 "CMD Transmit", cb
->len
, cb
->buf
);
250 spin_lock_irqsave(&cs
->cmdlock
, flags
);
251 cb
->prev
= cs
->lastcmdbuf
;
253 cs
->lastcmdbuf
->next
= cb
;
256 cs
->curlen
= cb
->len
;
258 cs
->cmdbytes
+= cb
->len
;
260 spin_unlock_irqrestore(&cs
->cmdlock
, flags
);
262 spin_lock_irqsave(&cs
->lock
, flags
);
264 tasklet_schedule(&cs
->write_tasklet
);
265 spin_unlock_irqrestore(&cs
->lock
, flags
);
270 * tty_driver.write_room interface routine
271 * return number of characters the driver will accept to be written
273 * controller state structure
275 * number of characters
277 static int gigaset_write_room(struct cardstate
*cs
)
281 bytes
= cs
->cmdbytes
;
282 return bytes
< IF_WRITEBUF
? IF_WRITEBUF
- bytes
: 0;
286 * tty_driver.chars_in_buffer interface routine
287 * return number of characters waiting to be sent
289 * controller state structure
291 * number of characters
293 static int gigaset_chars_in_buffer(struct cardstate
*cs
)
299 * implementation of ioctl(GIGASET_BRKCHARS)
301 * controller state structure
303 * -EINVAL (unimplemented function)
305 static int gigaset_brkchars(struct cardstate
*cs
, const unsigned char buf
[6])
307 /* not implemented */
313 * Called by "do_action" in ev-layer.c
315 static int gigaset_init_bchannel(struct bc_state
*bcs
)
317 /* nothing to do for M10x */
318 gigaset_bchannel_up(bcs
);
324 * Called by "do_action" in ev-layer.c
326 static int gigaset_close_bchannel(struct bc_state
*bcs
)
328 /* nothing to do for M10x */
329 gigaset_bchannel_down(bcs
);
334 * Set up B channel structure
335 * This is called by "gigaset_initcs" in common.c
337 static int gigaset_initbcshw(struct bc_state
*bcs
)
345 * Free B channel structure
346 * Called by "gigaset_freebcs" in common.c
348 static void gigaset_freebcshw(struct bc_state
*bcs
)
354 * Reinitialize B channel structure
355 * This is called by "bcs_reinit" in common.c
357 static void gigaset_reinitbcshw(struct bc_state
*bcs
)
359 /* nothing to do for M10x */
363 * Free hardware specific device data
364 * This will be called by "gigaset_freecs" in common.c
366 static void gigaset_freecshw(struct cardstate
*cs
)
368 tasklet_kill(&cs
->write_tasklet
);
371 platform_device_unregister(&cs
->hw
.ser
->dev
);
374 static void gigaset_device_release(struct device
*dev
)
376 kfree(container_of(dev
, struct ser_cardstate
, dev
.dev
));
380 * Set up hardware specific device data
381 * This is called by "gigaset_initcs" in common.c
383 static int gigaset_initcshw(struct cardstate
*cs
)
386 struct ser_cardstate
*scs
;
388 scs
= kzalloc(sizeof(struct ser_cardstate
), GFP_KERNEL
);
390 pr_err("out of memory\n");
395 cs
->hw
.ser
->dev
.name
= GIGASET_MODULENAME
;
396 cs
->hw
.ser
->dev
.id
= cs
->minor_index
;
397 cs
->hw
.ser
->dev
.dev
.release
= gigaset_device_release
;
398 rc
= platform_device_register(&cs
->hw
.ser
->dev
);
400 pr_err("error %d registering platform device\n", rc
);
406 tasklet_init(&cs
->write_tasklet
,
407 gigaset_modem_fill
, (unsigned long) cs
);
412 * set modem control lines
414 * card state structure
415 * modem control line state ([TIOCM_DTR]|[TIOCM_RTS])
416 * Called by "gigaset_start" and "gigaset_enterconfigmode" in common.c
417 * and by "if_lock" and "if_termios" in interface.c
419 static int gigaset_set_modem_ctrl(struct cardstate
*cs
, unsigned old_state
,
422 struct tty_struct
*tty
= cs
->hw
.ser
->tty
;
423 unsigned int set
, clear
;
425 WARN_ON(!tty
|| !tty
->ops
);
426 /* tiocmset is an optional tty driver method */
427 if (!tty
->ops
->tiocmset
)
429 set
= new_state
& ~old_state
;
430 clear
= old_state
& ~new_state
;
433 gig_dbg(DEBUG_IF
, "tiocmset set %x clear %x", set
, clear
);
434 return tty
->ops
->tiocmset(tty
, set
, clear
);
437 static int gigaset_baud_rate(struct cardstate
*cs
, unsigned cflag
)
442 static int gigaset_set_line_ctrl(struct cardstate
*cs
, unsigned cflag
)
447 static const struct gigaset_ops ops
= {
448 .write_cmd
= gigaset_write_cmd
,
449 .write_room
= gigaset_write_room
,
450 .chars_in_buffer
= gigaset_chars_in_buffer
,
451 .brkchars
= gigaset_brkchars
,
452 .init_bchannel
= gigaset_init_bchannel
,
453 .close_bchannel
= gigaset_close_bchannel
,
454 .initbcshw
= gigaset_initbcshw
,
455 .freebcshw
= gigaset_freebcshw
,
456 .reinitbcshw
= gigaset_reinitbcshw
,
457 .initcshw
= gigaset_initcshw
,
458 .freecshw
= gigaset_freecshw
,
459 .set_modem_ctrl
= gigaset_set_modem_ctrl
,
460 .baud_rate
= gigaset_baud_rate
,
461 .set_line_ctrl
= gigaset_set_line_ctrl
,
462 .send_skb
= gigaset_m10x_send_skb
, /* asyncdata.c */
463 .handle_input
= gigaset_m10x_input
, /* asyncdata.c */
467 /* Line Discipline Interface */
468 /* ========================= */
470 /* helper functions for cardstate refcounting */
471 static struct cardstate
*cs_get(struct tty_struct
*tty
)
473 struct cardstate
*cs
= tty
->disc_data
;
475 if (!cs
|| !cs
->hw
.ser
) {
476 gig_dbg(DEBUG_ANY
, "%s: no cardstate", __func__
);
479 atomic_inc(&cs
->hw
.ser
->refcnt
);
483 static void cs_put(struct cardstate
*cs
)
485 if (atomic_dec_and_test(&cs
->hw
.ser
->refcnt
))
486 complete(&cs
->hw
.ser
->dead_cmp
);
490 * Called by the tty driver when the line discipline is pushed onto the tty.
491 * Called in process context.
494 gigaset_tty_open(struct tty_struct
*tty
)
496 struct cardstate
*cs
;
499 gig_dbg(DEBUG_INIT
, "Starting HLL for Gigaset M101");
501 pr_info(DRIVER_DESC
"\n");
504 pr_err("%s: no driver structure\n", __func__
);
508 /* allocate memory for our device state and initialize it */
509 cs
= gigaset_initcs(driver
, 1, 1, 0, cidmode
, GIGASET_MODULENAME
);
515 cs
->dev
= &cs
->hw
.ser
->dev
.dev
;
516 cs
->hw
.ser
->tty
= tty
;
517 atomic_set(&cs
->hw
.ser
->refcnt
, 1);
518 init_completion(&cs
->hw
.ser
->dead_cmp
);
521 /* Set the amount of data we're willing to receive per call
522 * from the hardware driver to half of the input buffer size
523 * to leave some reserve.
524 * Note: We don't do flow control towards the hardware driver.
525 * If more data is received than will fit into the input buffer,
526 * it will be dropped and an error will be logged. This should
527 * never happen as the device is slow and the buffer size ample.
529 tty
->receive_room
= RBUFSIZE
/2;
531 /* OK.. Initialization of the datastructures and the HW is done.. Now
532 * startup system and notify the LL that we are ready to run
534 if (startmode
== SM_LOCKED
)
535 cs
->mstate
= MS_LOCKED
;
536 rc
= gigaset_start(cs
);
538 tasklet_kill(&cs
->write_tasklet
);
542 gig_dbg(DEBUG_INIT
, "Startup of HLL done");
546 gig_dbg(DEBUG_INIT
, "Startup of HLL failed");
547 tty
->disc_data
= NULL
;
553 * Called by the tty driver when the line discipline is removed.
554 * Called from process context.
557 gigaset_tty_close(struct tty_struct
*tty
)
559 struct cardstate
*cs
= tty
->disc_data
;
561 gig_dbg(DEBUG_INIT
, "Stopping HLL for Gigaset M101");
564 gig_dbg(DEBUG_INIT
, "%s: no cardstate", __func__
);
568 /* prevent other callers from entering ldisc methods */
569 tty
->disc_data
= NULL
;
572 pr_err("%s: no hw cardstate\n", __func__
);
574 /* wait for running methods to finish */
575 if (!atomic_dec_and_test(&cs
->hw
.ser
->refcnt
))
576 wait_for_completion(&cs
->hw
.ser
->dead_cmp
);
579 /* stop operations */
581 tasklet_kill(&cs
->write_tasklet
);
582 flush_send_queue(cs
);
586 gig_dbg(DEBUG_INIT
, "Shutdown of HLL done");
590 * Called by the tty driver when the tty line is hung up.
591 * Wait for I/O to driver to complete and unregister ISDN device.
592 * This is already done by the close routine, so just call that.
593 * Called from process context.
595 static int gigaset_tty_hangup(struct tty_struct
*tty
)
597 gigaset_tty_close(tty
);
603 * Called in process context only.
604 * May be re-entered by multiple ioctl calling threads.
607 gigaset_tty_ioctl(struct tty_struct
*tty
, struct file
*file
,
608 unsigned int cmd
, unsigned long arg
)
610 struct cardstate
*cs
= cs_get(tty
);
612 int __user
*p
= (int __user
*)arg
;
620 /* unused, always return zero */
622 rc
= put_user(val
, p
);
626 /* flush our buffers and the serial port's buffer */
629 /* no own input buffer to flush */
633 flush_send_queue(cs
);
639 /* pass through to underlying serial device */
640 rc
= n_tty_ioctl_helper(tty
, file
, cmd
, arg
);
648 * Called by the tty driver when a block of data has been received.
649 * Will not be re-entered while running but other ldisc functions
650 * may be called in parallel.
651 * Can be called from hard interrupt level as well as soft interrupt
655 * buf buffer containing received characters
656 * cflags buffer containing error flags for received characters (ignored)
657 * count number of received characters
660 gigaset_tty_receive(struct tty_struct
*tty
, const unsigned char *buf
,
661 char *cflags
, int count
)
663 struct cardstate
*cs
= cs_get(tty
);
664 unsigned tail
, head
, n
;
665 struct inbuf_t
*inbuf
;
671 dev_err(cs
->dev
, "%s: no inbuf\n", __func__
);
678 gig_dbg(DEBUG_INTR
, "buffer state: %u -> %u, receive %u bytes",
682 /* possible buffer wraparound */
683 n
= min_t(unsigned, count
, RBUFSIZE
- tail
);
684 memcpy(inbuf
->data
+ tail
, buf
, n
);
685 tail
= (tail
+ n
) % RBUFSIZE
;
691 /* tail < head and some data left */
695 "inbuf overflow, discarding %d bytes\n",
699 memcpy(inbuf
->data
+ tail
, buf
, count
);
703 gig_dbg(DEBUG_INTR
, "setting tail to %u", tail
);
706 /* Everything was received .. Push data into handler */
707 gig_dbg(DEBUG_INTR
, "%s-->BH", __func__
);
708 gigaset_schedule_event(cs
);
713 * Called by the tty driver when there's room for more data to send.
716 gigaset_tty_wakeup(struct tty_struct
*tty
)
718 struct cardstate
*cs
= cs_get(tty
);
720 clear_bit(TTY_DO_WRITE_WAKEUP
, &tty
->flags
);
723 tasklet_schedule(&cs
->write_tasklet
);
727 static struct tty_ldisc_ops gigaset_ldisc
= {
728 .owner
= THIS_MODULE
,
729 .magic
= TTY_LDISC_MAGIC
,
730 .name
= "ser_gigaset",
731 .open
= gigaset_tty_open
,
732 .close
= gigaset_tty_close
,
733 .hangup
= gigaset_tty_hangup
,
734 .ioctl
= gigaset_tty_ioctl
,
735 .receive_buf
= gigaset_tty_receive
,
736 .write_wakeup
= gigaset_tty_wakeup
,
740 /* Initialization / Shutdown */
741 /* ========================= */
743 static int __init
ser_gigaset_init(void)
747 gig_dbg(DEBUG_INIT
, "%s", __func__
);
748 rc
= platform_driver_register(&device_driver
);
750 pr_err("error %d registering platform driver\n", rc
);
754 /* allocate memory for our driver state and initialize it */
755 driver
= gigaset_initdriver(GIGASET_MINOR
, GIGASET_MINORS
,
756 GIGASET_MODULENAME
, GIGASET_DEVNAME
,
763 rc
= tty_register_ldisc(N_GIGASET_M101
, &gigaset_ldisc
);
765 pr_err("error %d registering line discipline\n", rc
);
773 gigaset_freedriver(driver
);
776 platform_driver_unregister(&device_driver
);
780 static void __exit
ser_gigaset_exit(void)
784 gig_dbg(DEBUG_INIT
, "%s", __func__
);
787 gigaset_freedriver(driver
);
791 rc
= tty_unregister_ldisc(N_GIGASET_M101
);
793 pr_err("error %d unregistering line discipline\n", rc
);
795 platform_driver_unregister(&device_driver
);
798 module_init(ser_gigaset_init
);
799 module_exit(ser_gigaset_exit
);