thinkpad-acpi: handle some new HKEY 0x60xx events
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / drivers / tty / n_gsm.c
blobc4b0ef1a38747d683208a0f4de0de11a8e8d8630
1 /*
2 * n_gsm.c GSM 0710 tty multiplexor
3 * Copyright (c) 2009/10 Intel Corporation
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License version 2 as
7 * published by the Free Software Foundation.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
18 * * THIS IS A DEVELOPMENT SNAPSHOT IT IS NOT A FINAL RELEASE *
20 * TO DO:
21 * Mostly done: ioctls for setting modes/timing
22 * Partly done: hooks so you can pull off frames to non tty devs
23 * Restart DLCI 0 when it closes ?
24 * Test basic encoding
25 * Improve the tx engine
26 * Resolve tx side locking by adding a queue_head and routing
27 * all control traffic via it
28 * General tidy/document
29 * Review the locking/move to refcounts more (mux now moved to an
30 * alloc/free model ready)
31 * Use newest tty open/close port helpers and install hooks
32 * What to do about power functions ?
33 * Termios setting and negotiation
34 * Do we need a 'which mux are you' ioctl to correlate mux and tty sets
38 #include <linux/types.h>
39 #include <linux/major.h>
40 #include <linux/errno.h>
41 #include <linux/signal.h>
42 #include <linux/fcntl.h>
43 #include <linux/sched.h>
44 #include <linux/interrupt.h>
45 #include <linux/tty.h>
46 #include <linux/ctype.h>
47 #include <linux/mm.h>
48 #include <linux/string.h>
49 #include <linux/slab.h>
50 #include <linux/poll.h>
51 #include <linux/bitops.h>
52 #include <linux/file.h>
53 #include <linux/uaccess.h>
54 #include <linux/module.h>
55 #include <linux/timer.h>
56 #include <linux/tty_flip.h>
57 #include <linux/tty_driver.h>
58 #include <linux/serial.h>
59 #include <linux/kfifo.h>
60 #include <linux/skbuff.h>
61 #include <linux/gsmmux.h>
63 static int debug;
64 module_param(debug, int, 0600);
66 #define T1 (HZ/10)
67 #define T2 (HZ/3)
68 #define N2 3
70 /* Use long timers for testing at low speed with debug on */
71 #ifdef DEBUG_TIMING
72 #define T1 HZ
73 #define T2 (2 * HZ)
74 #endif
77 * Semi-arbitary buffer size limits. 0710 is normally run with 32-64 byte
78 * limits so this is plenty
80 #define MAX_MRU 512
81 #define MAX_MTU 512
84 * Each block of data we have queued to go out is in the form of
85 * a gsm_msg which holds everything we need in a link layer independant
86 * format
89 struct gsm_msg {
90 struct gsm_msg *next;
91 u8 addr; /* DLCI address + flags */
92 u8 ctrl; /* Control byte + flags */
93 unsigned int len; /* Length of data block (can be zero) */
94 unsigned char *data; /* Points into buffer but not at the start */
95 unsigned char buffer[0];
99 * Each active data link has a gsm_dlci structure associated which ties
100 * the link layer to an optional tty (if the tty side is open). To avoid
101 * complexity right now these are only ever freed up when the mux is
102 * shut down.
104 * At the moment we don't free DLCI objects until the mux is torn down
105 * this avoid object life time issues but might be worth review later.
108 struct gsm_dlci {
109 struct gsm_mux *gsm;
110 int addr;
111 int state;
112 #define DLCI_CLOSED 0
113 #define DLCI_OPENING 1 /* Sending SABM not seen UA */
114 #define DLCI_OPEN 2 /* SABM/UA complete */
115 #define DLCI_CLOSING 3 /* Sending DISC not seen UA/DM */
117 /* Link layer */
118 spinlock_t lock; /* Protects the internal state */
119 struct timer_list t1; /* Retransmit timer for SABM and UA */
120 int retries;
121 /* Uplink tty if active */
122 struct tty_port port; /* The tty bound to this DLCI if there is one */
123 struct kfifo *fifo; /* Queue fifo for the DLCI */
124 struct kfifo _fifo; /* For new fifo API porting only */
125 int adaption; /* Adaption layer in use */
126 u32 modem_rx; /* Our incoming virtual modem lines */
127 u32 modem_tx; /* Our outgoing modem lines */
128 int dead; /* Refuse re-open */
129 /* Flow control */
130 int throttled; /* Private copy of throttle state */
131 int constipated; /* Throttle status for outgoing */
132 /* Packetised I/O */
133 struct sk_buff *skb; /* Frame being sent */
134 struct sk_buff_head skb_list; /* Queued frames */
135 /* Data handling callback */
136 void (*data)(struct gsm_dlci *dlci, u8 *data, int len);
139 /* DLCI 0, 62/63 are special or reseved see gsmtty_open */
141 #define NUM_DLCI 64
144 * DLCI 0 is used to pass control blocks out of band of the data
145 * flow (and with a higher link priority). One command can be outstanding
146 * at a time and we use this structure to manage them. They are created
147 * and destroyed by the user context, and updated by the receive paths
148 * and timers
151 struct gsm_control {
152 u8 cmd; /* Command we are issuing */
153 u8 *data; /* Data for the command in case we retransmit */
154 int len; /* Length of block for retransmission */
155 int done; /* Done flag */
156 int error; /* Error if any */
160 * Each GSM mux we have is represented by this structure. If we are
161 * operating as an ldisc then we use this structure as our ldisc
162 * state. We need to sort out lifetimes and locking with respect
163 * to the gsm mux array. For now we don't free DLCI objects that
164 * have been instantiated until the mux itself is terminated.
166 * To consider further: tty open versus mux shutdown.
169 struct gsm_mux {
170 struct tty_struct *tty; /* The tty our ldisc is bound to */
171 spinlock_t lock;
173 /* Events on the GSM channel */
174 wait_queue_head_t event;
176 /* Bits for GSM mode decoding */
178 /* Framing Layer */
179 unsigned char *buf;
180 int state;
181 #define GSM_SEARCH 0
182 #define GSM_START 1
183 #define GSM_ADDRESS 2
184 #define GSM_CONTROL 3
185 #define GSM_LEN 4
186 #define GSM_DATA 5
187 #define GSM_FCS 6
188 #define GSM_OVERRUN 7
189 #define GSM_LEN0 8
190 #define GSM_LEN1 9
191 #define GSM_SSOF 10
192 unsigned int len;
193 unsigned int address;
194 unsigned int count;
195 int escape;
196 int encoding;
197 u8 control;
198 u8 fcs;
199 u8 received_fcs;
200 u8 *txframe; /* TX framing buffer */
202 /* Methods for the receiver side */
203 void (*receive)(struct gsm_mux *gsm, u8 ch);
204 void (*error)(struct gsm_mux *gsm, u8 ch, u8 flag);
205 /* And transmit side */
206 int (*output)(struct gsm_mux *mux, u8 *data, int len);
208 /* Link Layer */
209 unsigned int mru;
210 unsigned int mtu;
211 int initiator; /* Did we initiate connection */
212 int dead; /* Has the mux been shut down */
213 struct gsm_dlci *dlci[NUM_DLCI];
214 int constipated; /* Asked by remote to shut up */
216 spinlock_t tx_lock;
217 unsigned int tx_bytes; /* TX data outstanding */
218 #define TX_THRESH_HI 8192
219 #define TX_THRESH_LO 2048
220 struct gsm_msg *tx_head; /* Pending data packets */
221 struct gsm_msg *tx_tail;
223 /* Control messages */
224 struct timer_list t2_timer; /* Retransmit timer for commands */
225 int cretries; /* Command retry counter */
226 struct gsm_control *pending_cmd;/* Our current pending command */
227 spinlock_t control_lock; /* Protects the pending command */
229 /* Configuration */
230 int adaption; /* 1 or 2 supported */
231 u8 ftype; /* UI or UIH */
232 int t1, t2; /* Timers in 1/100th of a sec */
233 int n2; /* Retry count */
235 /* Statistics (not currently exposed) */
236 unsigned long bad_fcs;
237 unsigned long malformed;
238 unsigned long io_error;
239 unsigned long bad_size;
240 unsigned long unsupported;
245 * Mux objects - needed so that we can translate a tty index into the
246 * relevant mux and DLCI.
249 #define MAX_MUX 4 /* 256 minors */
250 static struct gsm_mux *gsm_mux[MAX_MUX]; /* GSM muxes */
251 static spinlock_t gsm_mux_lock;
254 * This section of the driver logic implements the GSM encodings
255 * both the basic and the 'advanced'. Reliable transport is not
256 * supported.
259 #define CR 0x02
260 #define EA 0x01
261 #define PF 0x10
263 /* I is special: the rest are ..*/
264 #define RR 0x01
265 #define UI 0x03
266 #define RNR 0x05
267 #define REJ 0x09
268 #define DM 0x0F
269 #define SABM 0x2F
270 #define DISC 0x43
271 #define UA 0x63
272 #define UIH 0xEF
274 /* Channel commands */
275 #define CMD_NSC 0x09
276 #define CMD_TEST 0x11
277 #define CMD_PSC 0x21
278 #define CMD_RLS 0x29
279 #define CMD_FCOFF 0x31
280 #define CMD_PN 0x41
281 #define CMD_RPN 0x49
282 #define CMD_FCON 0x51
283 #define CMD_CLD 0x61
284 #define CMD_SNC 0x69
285 #define CMD_MSC 0x71
287 /* Virtual modem bits */
288 #define MDM_FC 0x01
289 #define MDM_RTC 0x02
290 #define MDM_RTR 0x04
291 #define MDM_IC 0x20
292 #define MDM_DV 0x40
294 #define GSM0_SOF 0xF9
295 #define GSM1_SOF 0x7E
296 #define GSM1_ESCAPE 0x7D
297 #define GSM1_ESCAPE_BITS 0x20
298 #define XON 0x11
299 #define XOFF 0x13
301 static const struct tty_port_operations gsm_port_ops;
304 * CRC table for GSM 0710
307 static const u8 gsm_fcs8[256] = {
308 0x00, 0x91, 0xE3, 0x72, 0x07, 0x96, 0xE4, 0x75,
309 0x0E, 0x9F, 0xED, 0x7C, 0x09, 0x98, 0xEA, 0x7B,
310 0x1C, 0x8D, 0xFF, 0x6E, 0x1B, 0x8A, 0xF8, 0x69,
311 0x12, 0x83, 0xF1, 0x60, 0x15, 0x84, 0xF6, 0x67,
312 0x38, 0xA9, 0xDB, 0x4A, 0x3F, 0xAE, 0xDC, 0x4D,
313 0x36, 0xA7, 0xD5, 0x44, 0x31, 0xA0, 0xD2, 0x43,
314 0x24, 0xB5, 0xC7, 0x56, 0x23, 0xB2, 0xC0, 0x51,
315 0x2A, 0xBB, 0xC9, 0x58, 0x2D, 0xBC, 0xCE, 0x5F,
316 0x70, 0xE1, 0x93, 0x02, 0x77, 0xE6, 0x94, 0x05,
317 0x7E, 0xEF, 0x9D, 0x0C, 0x79, 0xE8, 0x9A, 0x0B,
318 0x6C, 0xFD, 0x8F, 0x1E, 0x6B, 0xFA, 0x88, 0x19,
319 0x62, 0xF3, 0x81, 0x10, 0x65, 0xF4, 0x86, 0x17,
320 0x48, 0xD9, 0xAB, 0x3A, 0x4F, 0xDE, 0xAC, 0x3D,
321 0x46, 0xD7, 0xA5, 0x34, 0x41, 0xD0, 0xA2, 0x33,
322 0x54, 0xC5, 0xB7, 0x26, 0x53, 0xC2, 0xB0, 0x21,
323 0x5A, 0xCB, 0xB9, 0x28, 0x5D, 0xCC, 0xBE, 0x2F,
324 0xE0, 0x71, 0x03, 0x92, 0xE7, 0x76, 0x04, 0x95,
325 0xEE, 0x7F, 0x0D, 0x9C, 0xE9, 0x78, 0x0A, 0x9B,
326 0xFC, 0x6D, 0x1F, 0x8E, 0xFB, 0x6A, 0x18, 0x89,
327 0xF2, 0x63, 0x11, 0x80, 0xF5, 0x64, 0x16, 0x87,
328 0xD8, 0x49, 0x3B, 0xAA, 0xDF, 0x4E, 0x3C, 0xAD,
329 0xD6, 0x47, 0x35, 0xA4, 0xD1, 0x40, 0x32, 0xA3,
330 0xC4, 0x55, 0x27, 0xB6, 0xC3, 0x52, 0x20, 0xB1,
331 0xCA, 0x5B, 0x29, 0xB8, 0xCD, 0x5C, 0x2E, 0xBF,
332 0x90, 0x01, 0x73, 0xE2, 0x97, 0x06, 0x74, 0xE5,
333 0x9E, 0x0F, 0x7D, 0xEC, 0x99, 0x08, 0x7A, 0xEB,
334 0x8C, 0x1D, 0x6F, 0xFE, 0x8B, 0x1A, 0x68, 0xF9,
335 0x82, 0x13, 0x61, 0xF0, 0x85, 0x14, 0x66, 0xF7,
336 0xA8, 0x39, 0x4B, 0xDA, 0xAF, 0x3E, 0x4C, 0xDD,
337 0xA6, 0x37, 0x45, 0xD4, 0xA1, 0x30, 0x42, 0xD3,
338 0xB4, 0x25, 0x57, 0xC6, 0xB3, 0x22, 0x50, 0xC1,
339 0xBA, 0x2B, 0x59, 0xC8, 0xBD, 0x2C, 0x5E, 0xCF
342 #define INIT_FCS 0xFF
343 #define GOOD_FCS 0xCF
346 * gsm_fcs_add - update FCS
347 * @fcs: Current FCS
348 * @c: Next data
350 * Update the FCS to include c. Uses the algorithm in the specification
351 * notes.
354 static inline u8 gsm_fcs_add(u8 fcs, u8 c)
356 return gsm_fcs8[fcs ^ c];
360 * gsm_fcs_add_block - update FCS for a block
361 * @fcs: Current FCS
362 * @c: buffer of data
363 * @len: length of buffer
365 * Update the FCS to include c. Uses the algorithm in the specification
366 * notes.
369 static inline u8 gsm_fcs_add_block(u8 fcs, u8 *c, int len)
371 while (len--)
372 fcs = gsm_fcs8[fcs ^ *c++];
373 return fcs;
377 * gsm_read_ea - read a byte into an EA
378 * @val: variable holding value
379 * c: byte going into the EA
381 * Processes one byte of an EA. Updates the passed variable
382 * and returns 1 if the EA is now completely read
385 static int gsm_read_ea(unsigned int *val, u8 c)
387 /* Add the next 7 bits into the value */
388 *val <<= 7;
389 *val |= c >> 1;
390 /* Was this the last byte of the EA 1 = yes*/
391 return c & EA;
395 * gsm_encode_modem - encode modem data bits
396 * @dlci: DLCI to encode from
398 * Returns the correct GSM encoded modem status bits (6 bit field) for
399 * the current status of the DLCI and attached tty object
402 static u8 gsm_encode_modem(const struct gsm_dlci *dlci)
404 u8 modembits = 0;
405 /* FC is true flow control not modem bits */
406 if (dlci->throttled)
407 modembits |= MDM_FC;
408 if (dlci->modem_tx & TIOCM_DTR)
409 modembits |= MDM_RTC;
410 if (dlci->modem_tx & TIOCM_RTS)
411 modembits |= MDM_RTR;
412 if (dlci->modem_tx & TIOCM_RI)
413 modembits |= MDM_IC;
414 if (dlci->modem_tx & TIOCM_CD)
415 modembits |= MDM_DV;
416 return modembits;
420 * gsm_print_packet - display a frame for debug
421 * @hdr: header to print before decode
422 * @addr: address EA from the frame
423 * @cr: C/R bit from the frame
424 * @control: control including PF bit
425 * @data: following data bytes
426 * @dlen: length of data
428 * Displays a packet in human readable format for debugging purposes. The
429 * style is based on amateur radio LAP-B dump display.
432 static void gsm_print_packet(const char *hdr, int addr, int cr,
433 u8 control, const u8 *data, int dlen)
435 if (!(debug & 1))
436 return;
438 pr_info("%s %d) %c: ", hdr, addr, "RC"[cr]);
440 switch (control & ~PF) {
441 case SABM:
442 pr_cont("SABM");
443 break;
444 case UA:
445 pr_cont("UA");
446 break;
447 case DISC:
448 pr_cont("DISC");
449 break;
450 case DM:
451 pr_cont("DM");
452 break;
453 case UI:
454 pr_cont("UI");
455 break;
456 case UIH:
457 pr_cont("UIH");
458 break;
459 default:
460 if (!(control & 0x01)) {
461 pr_cont("I N(S)%d N(R)%d",
462 (control & 0x0E) >> 1, (control & 0xE) >> 5);
463 } else switch (control & 0x0F) {
464 case RR:
465 pr_cont("RR(%d)", (control & 0xE0) >> 5);
466 break;
467 case RNR:
468 pr_cont("RNR(%d)", (control & 0xE0) >> 5);
469 break;
470 case REJ:
471 pr_cont("REJ(%d)", (control & 0xE0) >> 5);
472 break;
473 default:
474 pr_cont("[%02X]", control);
478 if (control & PF)
479 pr_cont("(P)");
480 else
481 pr_cont("(F)");
483 if (dlen) {
484 int ct = 0;
485 while (dlen--) {
486 if (ct % 8 == 0) {
487 pr_cont("\n");
488 pr_debug(" ");
490 pr_cont("%02X ", *data++);
491 ct++;
494 pr_cont("\n");
499 * Link level transmission side
503 * gsm_stuff_packet - bytestuff a packet
504 * @ibuf: input
505 * @obuf: output
506 * @len: length of input
508 * Expand a buffer by bytestuffing it. The worst case size change
509 * is doubling and the caller is responsible for handing out
510 * suitable sized buffers.
513 static int gsm_stuff_frame(const u8 *input, u8 *output, int len)
515 int olen = 0;
516 while (len--) {
517 if (*input == GSM1_SOF || *input == GSM1_ESCAPE
518 || *input == XON || *input == XOFF) {
519 *output++ = GSM1_ESCAPE;
520 *output++ = *input++ ^ GSM1_ESCAPE_BITS;
521 olen++;
522 } else
523 *output++ = *input++;
524 olen++;
526 return olen;
529 static void hex_packet(const unsigned char *p, int len)
531 int i;
532 for (i = 0; i < len; i++) {
533 if (i && (i % 16) == 0) {
534 pr_cont("\n");
535 pr_debug("");
537 pr_cont("%02X ", *p++);
539 pr_cont("\n");
543 * gsm_send - send a control frame
544 * @gsm: our GSM mux
545 * @addr: address for control frame
546 * @cr: command/response bit
547 * @control: control byte including PF bit
549 * Format up and transmit a control frame. These do not go via the
550 * queueing logic as they should be transmitted ahead of data when
551 * they are needed.
553 * FIXME: Lock versus data TX path
556 static void gsm_send(struct gsm_mux *gsm, int addr, int cr, int control)
558 int len;
559 u8 cbuf[10];
560 u8 ibuf[3];
562 switch (gsm->encoding) {
563 case 0:
564 cbuf[0] = GSM0_SOF;
565 cbuf[1] = (addr << 2) | (cr << 1) | EA;
566 cbuf[2] = control;
567 cbuf[3] = EA; /* Length of data = 0 */
568 cbuf[4] = 0xFF - gsm_fcs_add_block(INIT_FCS, cbuf + 1, 3);
569 cbuf[5] = GSM0_SOF;
570 len = 6;
571 break;
572 case 1:
573 case 2:
574 /* Control frame + packing (but not frame stuffing) in mode 1 */
575 ibuf[0] = (addr << 2) | (cr << 1) | EA;
576 ibuf[1] = control;
577 ibuf[2] = 0xFF - gsm_fcs_add_block(INIT_FCS, ibuf, 2);
578 /* Stuffing may double the size worst case */
579 len = gsm_stuff_frame(ibuf, cbuf + 1, 3);
580 /* Now add the SOF markers */
581 cbuf[0] = GSM1_SOF;
582 cbuf[len + 1] = GSM1_SOF;
583 /* FIXME: we can omit the lead one in many cases */
584 len += 2;
585 break;
586 default:
587 WARN_ON(1);
588 return;
590 gsm->output(gsm, cbuf, len);
591 gsm_print_packet("-->", addr, cr, control, NULL, 0);
595 * gsm_response - send a control response
596 * @gsm: our GSM mux
597 * @addr: address for control frame
598 * @control: control byte including PF bit
600 * Format up and transmit a link level response frame.
603 static inline void gsm_response(struct gsm_mux *gsm, int addr, int control)
605 gsm_send(gsm, addr, 0, control);
609 * gsm_command - send a control command
610 * @gsm: our GSM mux
611 * @addr: address for control frame
612 * @control: control byte including PF bit
614 * Format up and transmit a link level command frame.
617 static inline void gsm_command(struct gsm_mux *gsm, int addr, int control)
619 gsm_send(gsm, addr, 1, control);
622 /* Data transmission */
624 #define HDR_LEN 6 /* ADDR CTRL [LEN.2] DATA FCS */
627 * gsm_data_alloc - allocate data frame
628 * @gsm: GSM mux
629 * @addr: DLCI address
630 * @len: length excluding header and FCS
631 * @ctrl: control byte
633 * Allocate a new data buffer for sending frames with data. Space is left
634 * at the front for header bytes but that is treated as an implementation
635 * detail and not for the high level code to use
638 static struct gsm_msg *gsm_data_alloc(struct gsm_mux *gsm, u8 addr, int len,
639 u8 ctrl)
641 struct gsm_msg *m = kmalloc(sizeof(struct gsm_msg) + len + HDR_LEN,
642 GFP_ATOMIC);
643 if (m == NULL)
644 return NULL;
645 m->data = m->buffer + HDR_LEN - 1; /* Allow for FCS */
646 m->len = len;
647 m->addr = addr;
648 m->ctrl = ctrl;
649 m->next = NULL;
650 return m;
654 * gsm_data_kick - poke the queue
655 * @gsm: GSM Mux
657 * The tty device has called us to indicate that room has appeared in
658 * the transmit queue. Ram more data into the pipe if we have any
660 * FIXME: lock against link layer control transmissions
663 static void gsm_data_kick(struct gsm_mux *gsm)
665 struct gsm_msg *msg = gsm->tx_head;
666 int len;
667 int skip_sof = 0;
669 /* FIXME: We need to apply this solely to data messages */
670 if (gsm->constipated)
671 return;
673 while (gsm->tx_head != NULL) {
674 msg = gsm->tx_head;
675 if (gsm->encoding != 0) {
676 gsm->txframe[0] = GSM1_SOF;
677 len = gsm_stuff_frame(msg->data,
678 gsm->txframe + 1, msg->len);
679 gsm->txframe[len + 1] = GSM1_SOF;
680 len += 2;
681 } else {
682 gsm->txframe[0] = GSM0_SOF;
683 memcpy(gsm->txframe + 1 , msg->data, msg->len);
684 gsm->txframe[msg->len + 1] = GSM0_SOF;
685 len = msg->len + 2;
688 if (debug & 4) {
689 pr_debug("gsm_data_kick:\n");
690 hex_packet(gsm->txframe, len);
693 if (gsm->output(gsm, gsm->txframe + skip_sof,
694 len - skip_sof) < 0)
695 break;
696 /* FIXME: Can eliminate one SOF in many more cases */
697 gsm->tx_head = msg->next;
698 if (gsm->tx_head == NULL)
699 gsm->tx_tail = NULL;
700 gsm->tx_bytes -= msg->len;
701 kfree(msg);
702 /* For a burst of frames skip the extra SOF within the
703 burst */
704 skip_sof = 1;
709 * __gsm_data_queue - queue a UI or UIH frame
710 * @dlci: DLCI sending the data
711 * @msg: message queued
713 * Add data to the transmit queue and try and get stuff moving
714 * out of the mux tty if not already doing so. The Caller must hold
715 * the gsm tx lock.
718 static void __gsm_data_queue(struct gsm_dlci *dlci, struct gsm_msg *msg)
720 struct gsm_mux *gsm = dlci->gsm;
721 u8 *dp = msg->data;
722 u8 *fcs = dp + msg->len;
724 /* Fill in the header */
725 if (gsm->encoding == 0) {
726 if (msg->len < 128)
727 *--dp = (msg->len << 1) | EA;
728 else {
729 *--dp = (msg->len >> 7); /* bits 7 - 15 */
730 *--dp = (msg->len & 127) << 1; /* bits 0 - 6 */
734 *--dp = msg->ctrl;
735 if (gsm->initiator)
736 *--dp = (msg->addr << 2) | 2 | EA;
737 else
738 *--dp = (msg->addr << 2) | EA;
739 *fcs = gsm_fcs_add_block(INIT_FCS, dp , msg->data - dp);
740 /* Ugly protocol layering violation */
741 if (msg->ctrl == UI || msg->ctrl == (UI|PF))
742 *fcs = gsm_fcs_add_block(*fcs, msg->data, msg->len);
743 *fcs = 0xFF - *fcs;
745 gsm_print_packet("Q> ", msg->addr, gsm->initiator, msg->ctrl,
746 msg->data, msg->len);
748 /* Move the header back and adjust the length, also allow for the FCS
749 now tacked on the end */
750 msg->len += (msg->data - dp) + 1;
751 msg->data = dp;
753 /* Add to the actual output queue */
754 if (gsm->tx_tail)
755 gsm->tx_tail->next = msg;
756 else
757 gsm->tx_head = msg;
758 gsm->tx_tail = msg;
759 gsm->tx_bytes += msg->len;
760 gsm_data_kick(gsm);
764 * gsm_data_queue - queue a UI or UIH frame
765 * @dlci: DLCI sending the data
766 * @msg: message queued
768 * Add data to the transmit queue and try and get stuff moving
769 * out of the mux tty if not already doing so. Take the
770 * the gsm tx lock and dlci lock.
773 static void gsm_data_queue(struct gsm_dlci *dlci, struct gsm_msg *msg)
775 unsigned long flags;
776 spin_lock_irqsave(&dlci->gsm->tx_lock, flags);
777 __gsm_data_queue(dlci, msg);
778 spin_unlock_irqrestore(&dlci->gsm->tx_lock, flags);
782 * gsm_dlci_data_output - try and push data out of a DLCI
783 * @gsm: mux
784 * @dlci: the DLCI to pull data from
786 * Pull data from a DLCI and send it into the transmit queue if there
787 * is data. Keep to the MRU of the mux. This path handles the usual tty
788 * interface which is a byte stream with optional modem data.
790 * Caller must hold the tx_lock of the mux.
793 static int gsm_dlci_data_output(struct gsm_mux *gsm, struct gsm_dlci *dlci)
795 struct gsm_msg *msg;
796 u8 *dp;
797 int len, size;
798 int h = dlci->adaption - 1;
800 len = kfifo_len(dlci->fifo);
801 if (len == 0)
802 return 0;
804 /* MTU/MRU count only the data bits */
805 if (len > gsm->mtu)
806 len = gsm->mtu;
808 size = len + h;
810 msg = gsm_data_alloc(gsm, dlci->addr, size, gsm->ftype);
811 /* FIXME: need a timer or something to kick this so it can't
812 get stuck with no work outstanding and no buffer free */
813 if (msg == NULL)
814 return -ENOMEM;
815 dp = msg->data;
816 switch (dlci->adaption) {
817 case 1: /* Unstructured */
818 break;
819 case 2: /* Unstructed with modem bits. Always one byte as we never
820 send inline break data */
821 *dp += gsm_encode_modem(dlci);
822 len--;
823 break;
825 WARN_ON(kfifo_out_locked(dlci->fifo, dp , len, &dlci->lock) != len);
826 __gsm_data_queue(dlci, msg);
827 /* Bytes of data we used up */
828 return size;
832 * gsm_dlci_data_output_framed - try and push data out of a DLCI
833 * @gsm: mux
834 * @dlci: the DLCI to pull data from
836 * Pull data from a DLCI and send it into the transmit queue if there
837 * is data. Keep to the MRU of the mux. This path handles framed data
838 * queued as skbuffs to the DLCI.
840 * Caller must hold the tx_lock of the mux.
843 static int gsm_dlci_data_output_framed(struct gsm_mux *gsm,
844 struct gsm_dlci *dlci)
846 struct gsm_msg *msg;
847 u8 *dp;
848 int len, size;
849 int last = 0, first = 0;
850 int overhead = 0;
852 /* One byte per frame is used for B/F flags */
853 if (dlci->adaption == 4)
854 overhead = 1;
856 /* dlci->skb is locked by tx_lock */
857 if (dlci->skb == NULL) {
858 dlci->skb = skb_dequeue(&dlci->skb_list);
859 if (dlci->skb == NULL)
860 return 0;
861 first = 1;
863 len = dlci->skb->len + overhead;
865 /* MTU/MRU count only the data bits */
866 if (len > gsm->mtu) {
867 if (dlci->adaption == 3) {
868 /* Over long frame, bin it */
869 kfree_skb(dlci->skb);
870 dlci->skb = NULL;
871 return 0;
873 len = gsm->mtu;
874 } else
875 last = 1;
877 size = len + overhead;
878 msg = gsm_data_alloc(gsm, dlci->addr, size, gsm->ftype);
880 /* FIXME: need a timer or something to kick this so it can't
881 get stuck with no work outstanding and no buffer free */
882 if (msg == NULL)
883 return -ENOMEM;
884 dp = msg->data;
886 if (dlci->adaption == 4) { /* Interruptible framed (Packetised Data) */
887 /* Flag byte to carry the start/end info */
888 *dp++ = last << 7 | first << 6 | 1; /* EA */
889 len--;
891 memcpy(dp, skb_pull(dlci->skb, len), len);
892 __gsm_data_queue(dlci, msg);
893 if (last)
894 dlci->skb = NULL;
895 return size;
899 * gsm_dlci_data_sweep - look for data to send
900 * @gsm: the GSM mux
902 * Sweep the GSM mux channels in priority order looking for ones with
903 * data to send. We could do with optimising this scan a bit. We aim
904 * to fill the queue totally or up to TX_THRESH_HI bytes. Once we hit
905 * TX_THRESH_LO we get called again
907 * FIXME: We should round robin between groups and in theory you can
908 * renegotiate DLCI priorities with optional stuff. Needs optimising.
911 static void gsm_dlci_data_sweep(struct gsm_mux *gsm)
913 int len;
914 /* Priority ordering: We should do priority with RR of the groups */
915 int i = 1;
917 while (i < NUM_DLCI) {
918 struct gsm_dlci *dlci;
920 if (gsm->tx_bytes > TX_THRESH_HI)
921 break;
922 dlci = gsm->dlci[i];
923 if (dlci == NULL || dlci->constipated) {
924 i++;
925 continue;
927 if (dlci->adaption < 3)
928 len = gsm_dlci_data_output(gsm, dlci);
929 else
930 len = gsm_dlci_data_output_framed(gsm, dlci);
931 if (len < 0)
932 break;
933 /* DLCI empty - try the next */
934 if (len == 0)
935 i++;
940 * gsm_dlci_data_kick - transmit if possible
941 * @dlci: DLCI to kick
943 * Transmit data from this DLCI if the queue is empty. We can't rely on
944 * a tty wakeup except when we filled the pipe so we need to fire off
945 * new data ourselves in other cases.
948 static void gsm_dlci_data_kick(struct gsm_dlci *dlci)
950 unsigned long flags;
952 spin_lock_irqsave(&dlci->gsm->tx_lock, flags);
953 /* If we have nothing running then we need to fire up */
954 if (dlci->gsm->tx_bytes == 0)
955 gsm_dlci_data_output(dlci->gsm, dlci);
956 else if (dlci->gsm->tx_bytes < TX_THRESH_LO)
957 gsm_dlci_data_sweep(dlci->gsm);
958 spin_unlock_irqrestore(&dlci->gsm->tx_lock, flags);
962 * Control message processing
967 * gsm_control_reply - send a response frame to a control
968 * @gsm: gsm channel
969 * @cmd: the command to use
970 * @data: data to follow encoded info
971 * @dlen: length of data
973 * Encode up and queue a UI/UIH frame containing our response.
976 static void gsm_control_reply(struct gsm_mux *gsm, int cmd, u8 *data,
977 int dlen)
979 struct gsm_msg *msg;
980 msg = gsm_data_alloc(gsm, 0, dlen + 2, gsm->ftype);
981 if (msg == NULL)
982 return;
983 msg->data[0] = (cmd & 0xFE) << 1 | EA; /* Clear C/R */
984 msg->data[1] = (dlen << 1) | EA;
985 memcpy(msg->data + 2, data, dlen);
986 gsm_data_queue(gsm->dlci[0], msg);
990 * gsm_process_modem - process received modem status
991 * @tty: virtual tty bound to the DLCI
992 * @dlci: DLCI to affect
993 * @modem: modem bits (full EA)
995 * Used when a modem control message or line state inline in adaption
996 * layer 2 is processed. Sort out the local modem state and throttles
999 static void gsm_process_modem(struct tty_struct *tty, struct gsm_dlci *dlci,
1000 u32 modem)
1002 int mlines = 0;
1003 u8 brk = modem >> 6;
1005 /* Flow control/ready to communicate */
1006 if (modem & MDM_FC) {
1007 /* Need to throttle our output on this device */
1008 dlci->constipated = 1;
1010 if (modem & MDM_RTC) {
1011 mlines |= TIOCM_DSR | TIOCM_DTR;
1012 dlci->constipated = 0;
1013 gsm_dlci_data_kick(dlci);
1015 /* Map modem bits */
1016 if (modem & MDM_RTR)
1017 mlines |= TIOCM_RTS | TIOCM_CTS;
1018 if (modem & MDM_IC)
1019 mlines |= TIOCM_RI;
1020 if (modem & MDM_DV)
1021 mlines |= TIOCM_CD;
1023 /* Carrier drop -> hangup */
1024 if (tty) {
1025 if ((mlines & TIOCM_CD) == 0 && (dlci->modem_rx & TIOCM_CD))
1026 if (!(tty->termios->c_cflag & CLOCAL))
1027 tty_hangup(tty);
1028 if (brk & 0x01)
1029 tty_insert_flip_char(tty, 0, TTY_BREAK);
1031 dlci->modem_rx = mlines;
1035 * gsm_control_modem - modem status received
1036 * @gsm: GSM channel
1037 * @data: data following command
1038 * @clen: command length
1040 * We have received a modem status control message. This is used by
1041 * the GSM mux protocol to pass virtual modem line status and optionally
1042 * to indicate break signals. Unpack it, convert to Linux representation
1043 * and if need be stuff a break message down the tty.
1046 static void gsm_control_modem(struct gsm_mux *gsm, u8 *data, int clen)
1048 unsigned int addr = 0;
1049 unsigned int modem = 0;
1050 struct gsm_dlci *dlci;
1051 int len = clen;
1052 u8 *dp = data;
1053 struct tty_struct *tty;
1055 while (gsm_read_ea(&addr, *dp++) == 0) {
1056 len--;
1057 if (len == 0)
1058 return;
1060 /* Must be at least one byte following the EA */
1061 len--;
1062 if (len <= 0)
1063 return;
1065 addr >>= 1;
1066 /* Closed port, or invalid ? */
1067 if (addr == 0 || addr >= NUM_DLCI || gsm->dlci[addr] == NULL)
1068 return;
1069 dlci = gsm->dlci[addr];
1071 while (gsm_read_ea(&modem, *dp++) == 0) {
1072 len--;
1073 if (len == 0)
1074 return;
1076 tty = tty_port_tty_get(&dlci->port);
1077 gsm_process_modem(tty, dlci, modem);
1078 if (tty) {
1079 tty_wakeup(tty);
1080 tty_kref_put(tty);
1082 gsm_control_reply(gsm, CMD_MSC, data, clen);
1086 * gsm_control_rls - remote line status
1087 * @gsm: GSM channel
1088 * @data: data bytes
1089 * @clen: data length
1091 * The modem sends us a two byte message on the control channel whenever
1092 * it wishes to send us an error state from the virtual link. Stuff
1093 * this into the uplink tty if present
1096 static void gsm_control_rls(struct gsm_mux *gsm, u8 *data, int clen)
1098 struct tty_struct *tty;
1099 unsigned int addr = 0 ;
1100 u8 bits;
1101 int len = clen;
1102 u8 *dp = data;
1104 while (gsm_read_ea(&addr, *dp++) == 0) {
1105 len--;
1106 if (len == 0)
1107 return;
1109 /* Must be at least one byte following ea */
1110 len--;
1111 if (len <= 0)
1112 return;
1113 addr >>= 1;
1114 /* Closed port, or invalid ? */
1115 if (addr == 0 || addr >= NUM_DLCI || gsm->dlci[addr] == NULL)
1116 return;
1117 /* No error ? */
1118 bits = *dp;
1119 if ((bits & 1) == 0)
1120 return;
1121 /* See if we have an uplink tty */
1122 tty = tty_port_tty_get(&gsm->dlci[addr]->port);
1124 if (tty) {
1125 if (bits & 2)
1126 tty_insert_flip_char(tty, 0, TTY_OVERRUN);
1127 if (bits & 4)
1128 tty_insert_flip_char(tty, 0, TTY_PARITY);
1129 if (bits & 8)
1130 tty_insert_flip_char(tty, 0, TTY_FRAME);
1131 tty_flip_buffer_push(tty);
1132 tty_kref_put(tty);
1134 gsm_control_reply(gsm, CMD_RLS, data, clen);
1137 static void gsm_dlci_begin_close(struct gsm_dlci *dlci);
1140 * gsm_control_message - DLCI 0 control processing
1141 * @gsm: our GSM mux
1142 * @command: the command EA
1143 * @data: data beyond the command/length EAs
1144 * @clen: length
1146 * Input processor for control messages from the other end of the link.
1147 * Processes the incoming request and queues a response frame or an
1148 * NSC response if not supported
1151 static void gsm_control_message(struct gsm_mux *gsm, unsigned int command,
1152 u8 *data, int clen)
1154 u8 buf[1];
1155 switch (command) {
1156 case CMD_CLD: {
1157 struct gsm_dlci *dlci = gsm->dlci[0];
1158 /* Modem wishes to close down */
1159 if (dlci) {
1160 dlci->dead = 1;
1161 gsm->dead = 1;
1162 gsm_dlci_begin_close(dlci);
1165 break;
1166 case CMD_TEST:
1167 /* Modem wishes to test, reply with the data */
1168 gsm_control_reply(gsm, CMD_TEST, data, clen);
1169 break;
1170 case CMD_FCON:
1171 /* Modem wants us to STFU */
1172 gsm->constipated = 1;
1173 gsm_control_reply(gsm, CMD_FCON, NULL, 0);
1174 break;
1175 case CMD_FCOFF:
1176 /* Modem can accept data again */
1177 gsm->constipated = 0;
1178 gsm_control_reply(gsm, CMD_FCOFF, NULL, 0);
1179 /* Kick the link in case it is idling */
1180 gsm_data_kick(gsm);
1181 break;
1182 case CMD_MSC:
1183 /* Out of band modem line change indicator for a DLCI */
1184 gsm_control_modem(gsm, data, clen);
1185 break;
1186 case CMD_RLS:
1187 /* Out of band error reception for a DLCI */
1188 gsm_control_rls(gsm, data, clen);
1189 break;
1190 case CMD_PSC:
1191 /* Modem wishes to enter power saving state */
1192 gsm_control_reply(gsm, CMD_PSC, NULL, 0);
1193 break;
1194 /* Optional unsupported commands */
1195 case CMD_PN: /* Parameter negotiation */
1196 case CMD_RPN: /* Remote port negotation */
1197 case CMD_SNC: /* Service negotation command */
1198 default:
1199 /* Reply to bad commands with an NSC */
1200 buf[0] = command;
1201 gsm_control_reply(gsm, CMD_NSC, buf, 1);
1202 break;
1207 * gsm_control_response - process a response to our control
1208 * @gsm: our GSM mux
1209 * @command: the command (response) EA
1210 * @data: data beyond the command/length EA
1211 * @clen: length
1213 * Process a response to an outstanding command. We only allow a single
1214 * control message in flight so this is fairly easy. All the clean up
1215 * is done by the caller, we just update the fields, flag it as done
1216 * and return
1219 static void gsm_control_response(struct gsm_mux *gsm, unsigned int command,
1220 u8 *data, int clen)
1222 struct gsm_control *ctrl;
1223 unsigned long flags;
1225 spin_lock_irqsave(&gsm->control_lock, flags);
1227 ctrl = gsm->pending_cmd;
1228 /* Does the reply match our command */
1229 command |= 1;
1230 if (ctrl != NULL && (command == ctrl->cmd || command == CMD_NSC)) {
1231 /* Our command was replied to, kill the retry timer */
1232 del_timer(&gsm->t2_timer);
1233 gsm->pending_cmd = NULL;
1234 /* Rejected by the other end */
1235 if (command == CMD_NSC)
1236 ctrl->error = -EOPNOTSUPP;
1237 ctrl->done = 1;
1238 wake_up(&gsm->event);
1240 spin_unlock_irqrestore(&gsm->control_lock, flags);
1244 * gsm_control_transmit - send control packet
1245 * @gsm: gsm mux
1246 * @ctrl: frame to send
1248 * Send out a pending control command (called under control lock)
1251 static void gsm_control_transmit(struct gsm_mux *gsm, struct gsm_control *ctrl)
1253 struct gsm_msg *msg = gsm_data_alloc(gsm, 0, ctrl->len + 1,
1254 gsm->ftype|PF);
1255 if (msg == NULL)
1256 return;
1257 msg->data[0] = (ctrl->cmd << 1) | 2 | EA; /* command */
1258 memcpy(msg->data + 1, ctrl->data, ctrl->len);
1259 gsm_data_queue(gsm->dlci[0], msg);
1263 * gsm_control_retransmit - retransmit a control frame
1264 * @data: pointer to our gsm object
1266 * Called off the T2 timer expiry in order to retransmit control frames
1267 * that have been lost in the system somewhere. The control_lock protects
1268 * us from colliding with another sender or a receive completion event.
1269 * In that situation the timer may still occur in a small window but
1270 * gsm->pending_cmd will be NULL and we just let the timer expire.
1273 static void gsm_control_retransmit(unsigned long data)
1275 struct gsm_mux *gsm = (struct gsm_mux *)data;
1276 struct gsm_control *ctrl;
1277 unsigned long flags;
1278 spin_lock_irqsave(&gsm->control_lock, flags);
1279 ctrl = gsm->pending_cmd;
1280 if (ctrl) {
1281 gsm->cretries--;
1282 if (gsm->cretries == 0) {
1283 gsm->pending_cmd = NULL;
1284 ctrl->error = -ETIMEDOUT;
1285 ctrl->done = 1;
1286 spin_unlock_irqrestore(&gsm->control_lock, flags);
1287 wake_up(&gsm->event);
1288 return;
1290 gsm_control_transmit(gsm, ctrl);
1291 mod_timer(&gsm->t2_timer, jiffies + gsm->t2 * HZ / 100);
1293 spin_unlock_irqrestore(&gsm->control_lock, flags);
1297 * gsm_control_send - send a control frame on DLCI 0
1298 * @gsm: the GSM channel
1299 * @command: command to send including CR bit
1300 * @data: bytes of data (must be kmalloced)
1301 * @len: length of the block to send
1303 * Queue and dispatch a control command. Only one command can be
1304 * active at a time. In theory more can be outstanding but the matching
1305 * gets really complicated so for now stick to one outstanding.
1308 static struct gsm_control *gsm_control_send(struct gsm_mux *gsm,
1309 unsigned int command, u8 *data, int clen)
1311 struct gsm_control *ctrl = kzalloc(sizeof(struct gsm_control),
1312 GFP_KERNEL);
1313 unsigned long flags;
1314 if (ctrl == NULL)
1315 return NULL;
1316 retry:
1317 wait_event(gsm->event, gsm->pending_cmd == NULL);
1318 spin_lock_irqsave(&gsm->control_lock, flags);
1319 if (gsm->pending_cmd != NULL) {
1320 spin_unlock_irqrestore(&gsm->control_lock, flags);
1321 goto retry;
1323 ctrl->cmd = command;
1324 ctrl->data = data;
1325 ctrl->len = clen;
1326 gsm->pending_cmd = ctrl;
1327 gsm->cretries = gsm->n2;
1328 mod_timer(&gsm->t2_timer, jiffies + gsm->t2 * HZ / 100);
1329 gsm_control_transmit(gsm, ctrl);
1330 spin_unlock_irqrestore(&gsm->control_lock, flags);
1331 return ctrl;
1335 * gsm_control_wait - wait for a control to finish
1336 * @gsm: GSM mux
1337 * @control: control we are waiting on
1339 * Waits for the control to complete or time out. Frees any used
1340 * resources and returns 0 for success, or an error if the remote
1341 * rejected or ignored the request.
1344 static int gsm_control_wait(struct gsm_mux *gsm, struct gsm_control *control)
1346 int err;
1347 wait_event(gsm->event, control->done == 1);
1348 err = control->error;
1349 kfree(control);
1350 return err;
1355 * DLCI level handling: Needs krefs
1359 * State transitions and timers
1363 * gsm_dlci_close - a DLCI has closed
1364 * @dlci: DLCI that closed
1366 * Perform processing when moving a DLCI into closed state. If there
1367 * is an attached tty this is hung up
1370 static void gsm_dlci_close(struct gsm_dlci *dlci)
1372 del_timer(&dlci->t1);
1373 if (debug & 8)
1374 pr_debug("DLCI %d goes closed.\n", dlci->addr);
1375 dlci->state = DLCI_CLOSED;
1376 if (dlci->addr != 0) {
1377 struct tty_struct *tty = tty_port_tty_get(&dlci->port);
1378 if (tty) {
1379 tty_hangup(tty);
1380 tty_kref_put(tty);
1382 kfifo_reset(dlci->fifo);
1383 } else
1384 dlci->gsm->dead = 1;
1385 wake_up(&dlci->gsm->event);
1386 /* A DLCI 0 close is a MUX termination so we need to kick that
1387 back to userspace somehow */
1391 * gsm_dlci_open - a DLCI has opened
1392 * @dlci: DLCI that opened
1394 * Perform processing when moving a DLCI into open state.
1397 static void gsm_dlci_open(struct gsm_dlci *dlci)
1399 /* Note that SABM UA .. SABM UA first UA lost can mean that we go
1400 open -> open */
1401 del_timer(&dlci->t1);
1402 /* This will let a tty open continue */
1403 dlci->state = DLCI_OPEN;
1404 if (debug & 8)
1405 pr_debug("DLCI %d goes open.\n", dlci->addr);
1406 wake_up(&dlci->gsm->event);
1410 * gsm_dlci_t1 - T1 timer expiry
1411 * @dlci: DLCI that opened
1413 * The T1 timer handles retransmits of control frames (essentially of
1414 * SABM and DISC). We resend the command until the retry count runs out
1415 * in which case an opening port goes back to closed and a closing port
1416 * is simply put into closed state (any further frames from the other
1417 * end will get a DM response)
1420 static void gsm_dlci_t1(unsigned long data)
1422 struct gsm_dlci *dlci = (struct gsm_dlci *)data;
1423 struct gsm_mux *gsm = dlci->gsm;
1425 switch (dlci->state) {
1426 case DLCI_OPENING:
1427 dlci->retries--;
1428 if (dlci->retries) {
1429 gsm_command(dlci->gsm, dlci->addr, SABM|PF);
1430 mod_timer(&dlci->t1, jiffies + gsm->t1 * HZ / 100);
1431 } else
1432 gsm_dlci_close(dlci);
1433 break;
1434 case DLCI_CLOSING:
1435 dlci->retries--;
1436 if (dlci->retries) {
1437 gsm_command(dlci->gsm, dlci->addr, DISC|PF);
1438 mod_timer(&dlci->t1, jiffies + gsm->t1 * HZ / 100);
1439 } else
1440 gsm_dlci_close(dlci);
1441 break;
1446 * gsm_dlci_begin_open - start channel open procedure
1447 * @dlci: DLCI to open
1449 * Commence opening a DLCI from the Linux side. We issue SABM messages
1450 * to the modem which should then reply with a UA, at which point we
1451 * will move into open state. Opening is done asynchronously with retry
1452 * running off timers and the responses.
1455 static void gsm_dlci_begin_open(struct gsm_dlci *dlci)
1457 struct gsm_mux *gsm = dlci->gsm;
1458 if (dlci->state == DLCI_OPEN || dlci->state == DLCI_OPENING)
1459 return;
1460 dlci->retries = gsm->n2;
1461 dlci->state = DLCI_OPENING;
1462 gsm_command(dlci->gsm, dlci->addr, SABM|PF);
1463 mod_timer(&dlci->t1, jiffies + gsm->t1 * HZ / 100);
1467 * gsm_dlci_begin_close - start channel open procedure
1468 * @dlci: DLCI to open
1470 * Commence closing a DLCI from the Linux side. We issue DISC messages
1471 * to the modem which should then reply with a UA, at which point we
1472 * will move into closed state. Closing is done asynchronously with retry
1473 * off timers. We may also receive a DM reply from the other end which
1474 * indicates the channel was already closed.
1477 static void gsm_dlci_begin_close(struct gsm_dlci *dlci)
1479 struct gsm_mux *gsm = dlci->gsm;
1480 if (dlci->state == DLCI_CLOSED || dlci->state == DLCI_CLOSING)
1481 return;
1482 dlci->retries = gsm->n2;
1483 dlci->state = DLCI_CLOSING;
1484 gsm_command(dlci->gsm, dlci->addr, DISC|PF);
1485 mod_timer(&dlci->t1, jiffies + gsm->t1 * HZ / 100);
1489 * gsm_dlci_data - data arrived
1490 * @dlci: channel
1491 * @data: block of bytes received
1492 * @len: length of received block
1494 * A UI or UIH frame has arrived which contains data for a channel
1495 * other than the control channel. If the relevant virtual tty is
1496 * open we shovel the bits down it, if not we drop them.
1499 static void gsm_dlci_data(struct gsm_dlci *dlci, u8 *data, int len)
1501 /* krefs .. */
1502 struct tty_port *port = &dlci->port;
1503 struct tty_struct *tty = tty_port_tty_get(port);
1504 unsigned int modem = 0;
1506 if (debug & 16)
1507 pr_debug("%d bytes for tty %p\n", len, tty);
1508 if (tty) {
1509 switch (dlci->adaption) {
1510 /* Unsupported types */
1511 /* Packetised interruptible data */
1512 case 4:
1513 break;
1514 /* Packetised uininterruptible voice/data */
1515 case 3:
1516 break;
1517 /* Asynchronous serial with line state in each frame */
1518 case 2:
1519 while (gsm_read_ea(&modem, *data++) == 0) {
1520 len--;
1521 if (len == 0)
1522 return;
1524 gsm_process_modem(tty, dlci, modem);
1525 /* Line state will go via DLCI 0 controls only */
1526 case 1:
1527 default:
1528 tty_insert_flip_string(tty, data, len);
1529 tty_flip_buffer_push(tty);
1531 tty_kref_put(tty);
1536 * gsm_dlci_control - data arrived on control channel
1537 * @dlci: channel
1538 * @data: block of bytes received
1539 * @len: length of received block
1541 * A UI or UIH frame has arrived which contains data for DLCI 0 the
1542 * control channel. This should contain a command EA followed by
1543 * control data bytes. The command EA contains a command/response bit
1544 * and we divide up the work accordingly.
1547 static void gsm_dlci_command(struct gsm_dlci *dlci, u8 *data, int len)
1549 /* See what command is involved */
1550 unsigned int command = 0;
1551 while (len-- > 0) {
1552 if (gsm_read_ea(&command, *data++) == 1) {
1553 int clen = *data++;
1554 len--;
1555 /* FIXME: this is properly an EA */
1556 clen >>= 1;
1557 /* Malformed command ? */
1558 if (clen > len)
1559 return;
1560 if (command & 1)
1561 gsm_control_message(dlci->gsm, command,
1562 data, clen);
1563 else
1564 gsm_control_response(dlci->gsm, command,
1565 data, clen);
1566 return;
1572 * Allocate/Free DLCI channels
1576 * gsm_dlci_alloc - allocate a DLCI
1577 * @gsm: GSM mux
1578 * @addr: address of the DLCI
1580 * Allocate and install a new DLCI object into the GSM mux.
1582 * FIXME: review locking races
1585 static struct gsm_dlci *gsm_dlci_alloc(struct gsm_mux *gsm, int addr)
1587 struct gsm_dlci *dlci = kzalloc(sizeof(struct gsm_dlci), GFP_ATOMIC);
1588 if (dlci == NULL)
1589 return NULL;
1590 spin_lock_init(&dlci->lock);
1591 dlci->fifo = &dlci->_fifo;
1592 if (kfifo_alloc(&dlci->_fifo, 4096, GFP_KERNEL) < 0) {
1593 kfree(dlci);
1594 return NULL;
1597 skb_queue_head_init(&dlci->skb_list);
1598 init_timer(&dlci->t1);
1599 dlci->t1.function = gsm_dlci_t1;
1600 dlci->t1.data = (unsigned long)dlci;
1601 tty_port_init(&dlci->port);
1602 dlci->port.ops = &gsm_port_ops;
1603 dlci->gsm = gsm;
1604 dlci->addr = addr;
1605 dlci->adaption = gsm->adaption;
1606 dlci->state = DLCI_CLOSED;
1607 if (addr)
1608 dlci->data = gsm_dlci_data;
1609 else
1610 dlci->data = gsm_dlci_command;
1611 gsm->dlci[addr] = dlci;
1612 return dlci;
1616 * gsm_dlci_free - release DLCI
1617 * @dlci: DLCI to destroy
1619 * Free up a DLCI. Currently to keep the lifetime rules sane we only
1620 * clean up DLCI objects when the MUX closes rather than as the port
1621 * is closed down on both the tty and mux levels.
1623 * Can sleep.
1625 static void gsm_dlci_free(struct gsm_dlci *dlci)
1627 struct tty_struct *tty = tty_port_tty_get(&dlci->port);
1628 if (tty) {
1629 tty_vhangup(tty);
1630 tty_kref_put(tty);
1632 del_timer_sync(&dlci->t1);
1633 dlci->gsm->dlci[dlci->addr] = NULL;
1634 kfifo_free(dlci->fifo);
1635 kfree(dlci);
1639 * LAPBish link layer logic
1643 * gsm_queue - a GSM frame is ready to process
1644 * @gsm: pointer to our gsm mux
1646 * At this point in time a frame has arrived and been demangled from
1647 * the line encoding. All the differences between the encodings have
1648 * been handled below us and the frame is unpacked into the structures.
1649 * The fcs holds the header FCS but any data FCS must be added here.
1652 static void gsm_queue(struct gsm_mux *gsm)
1654 struct gsm_dlci *dlci;
1655 u8 cr;
1656 int address;
1657 /* We have to sneak a look at the packet body to do the FCS.
1658 A somewhat layering violation in the spec */
1660 if ((gsm->control & ~PF) == UI)
1661 gsm->fcs = gsm_fcs_add_block(gsm->fcs, gsm->buf, gsm->len);
1662 if (gsm->encoding == 0){
1663 /* WARNING: gsm->received_fcs is used for gsm->encoding = 0 only.
1664 In this case it contain the last piece of data
1665 required to generate final CRC */
1666 gsm->fcs = gsm_fcs_add(gsm->fcs, gsm->received_fcs);
1668 if (gsm->fcs != GOOD_FCS) {
1669 gsm->bad_fcs++;
1670 if (debug & 4)
1671 pr_debug("BAD FCS %02x\n", gsm->fcs);
1672 return;
1674 address = gsm->address >> 1;
1675 if (address >= NUM_DLCI)
1676 goto invalid;
1678 cr = gsm->address & 1; /* C/R bit */
1680 gsm_print_packet("<--", address, cr, gsm->control, gsm->buf, gsm->len);
1682 cr ^= 1 - gsm->initiator; /* Flip so 1 always means command */
1683 dlci = gsm->dlci[address];
1685 switch (gsm->control) {
1686 case SABM|PF:
1687 if (cr == 0)
1688 goto invalid;
1689 if (dlci == NULL)
1690 dlci = gsm_dlci_alloc(gsm, address);
1691 if (dlci == NULL)
1692 return;
1693 if (dlci->dead)
1694 gsm_response(gsm, address, DM);
1695 else {
1696 gsm_response(gsm, address, UA);
1697 gsm_dlci_open(dlci);
1699 break;
1700 case DISC|PF:
1701 if (cr == 0)
1702 goto invalid;
1703 if (dlci == NULL || dlci->state == DLCI_CLOSED) {
1704 gsm_response(gsm, address, DM);
1705 return;
1707 /* Real close complete */
1708 gsm_response(gsm, address, UA);
1709 gsm_dlci_close(dlci);
1710 break;
1711 case UA:
1712 case UA|PF:
1713 if (cr == 0 || dlci == NULL)
1714 break;
1715 switch (dlci->state) {
1716 case DLCI_CLOSING:
1717 gsm_dlci_close(dlci);
1718 break;
1719 case DLCI_OPENING:
1720 gsm_dlci_open(dlci);
1721 break;
1723 break;
1724 case DM: /* DM can be valid unsolicited */
1725 case DM|PF:
1726 if (cr)
1727 goto invalid;
1728 if (dlci == NULL)
1729 return;
1730 gsm_dlci_close(dlci);
1731 break;
1732 case UI:
1733 case UI|PF:
1734 case UIH:
1735 case UIH|PF:
1736 #if 0
1737 if (cr)
1738 goto invalid;
1739 #endif
1740 if (dlci == NULL || dlci->state != DLCI_OPEN) {
1741 gsm_command(gsm, address, DM|PF);
1742 return;
1744 dlci->data(dlci, gsm->buf, gsm->len);
1745 break;
1746 default:
1747 goto invalid;
1749 return;
1750 invalid:
1751 gsm->malformed++;
1752 return;
1757 * gsm0_receive - perform processing for non-transparency
1758 * @gsm: gsm data for this ldisc instance
1759 * @c: character
1761 * Receive bytes in gsm mode 0
1764 static void gsm0_receive(struct gsm_mux *gsm, unsigned char c)
1766 unsigned int len;
1768 switch (gsm->state) {
1769 case GSM_SEARCH: /* SOF marker */
1770 if (c == GSM0_SOF) {
1771 gsm->state = GSM_ADDRESS;
1772 gsm->address = 0;
1773 gsm->len = 0;
1774 gsm->fcs = INIT_FCS;
1776 break;
1777 case GSM_ADDRESS: /* Address EA */
1778 gsm->fcs = gsm_fcs_add(gsm->fcs, c);
1779 if (gsm_read_ea(&gsm->address, c))
1780 gsm->state = GSM_CONTROL;
1781 break;
1782 case GSM_CONTROL: /* Control Byte */
1783 gsm->fcs = gsm_fcs_add(gsm->fcs, c);
1784 gsm->control = c;
1785 gsm->state = GSM_LEN0;
1786 break;
1787 case GSM_LEN0: /* Length EA */
1788 gsm->fcs = gsm_fcs_add(gsm->fcs, c);
1789 if (gsm_read_ea(&gsm->len, c)) {
1790 if (gsm->len > gsm->mru) {
1791 gsm->bad_size++;
1792 gsm->state = GSM_SEARCH;
1793 break;
1795 gsm->count = 0;
1796 if (!gsm->len)
1797 gsm->state = GSM_FCS;
1798 else
1799 gsm->state = GSM_DATA;
1800 break;
1802 gsm->state = GSM_LEN1;
1803 break;
1804 case GSM_LEN1:
1805 gsm->fcs = gsm_fcs_add(gsm->fcs, c);
1806 len = c;
1807 gsm->len |= len << 7;
1808 if (gsm->len > gsm->mru) {
1809 gsm->bad_size++;
1810 gsm->state = GSM_SEARCH;
1811 break;
1813 gsm->count = 0;
1814 if (!gsm->len)
1815 gsm->state = GSM_FCS;
1816 else
1817 gsm->state = GSM_DATA;
1818 break;
1819 case GSM_DATA: /* Data */
1820 gsm->buf[gsm->count++] = c;
1821 if (gsm->count == gsm->len)
1822 gsm->state = GSM_FCS;
1823 break;
1824 case GSM_FCS: /* FCS follows the packet */
1825 gsm->received_fcs = c;
1826 if (c == GSM0_SOF) {
1827 gsm->state = GSM_SEARCH;
1828 break;
1830 gsm_queue(gsm);
1831 gsm->state = GSM_SSOF;
1832 break;
1833 case GSM_SSOF:
1834 if (c == GSM0_SOF) {
1835 gsm->state = GSM_SEARCH;
1836 break;
1838 break;
1843 * gsm1_receive - perform processing for non-transparency
1844 * @gsm: gsm data for this ldisc instance
1845 * @c: character
1847 * Receive bytes in mode 1 (Advanced option)
1850 static void gsm1_receive(struct gsm_mux *gsm, unsigned char c)
1852 if (c == GSM1_SOF) {
1853 /* EOF is only valid in frame if we have got to the data state
1854 and received at least one byte (the FCS) */
1855 if (gsm->state == GSM_DATA && gsm->count) {
1856 /* Extract the FCS */
1857 gsm->count--;
1858 gsm->fcs = gsm_fcs_add(gsm->fcs, gsm->buf[gsm->count]);
1859 gsm->len = gsm->count;
1860 gsm_queue(gsm);
1861 gsm->state = GSM_START;
1862 return;
1864 /* Any partial frame was a runt so go back to start */
1865 if (gsm->state != GSM_START) {
1866 gsm->malformed++;
1867 gsm->state = GSM_START;
1869 /* A SOF in GSM_START means we are still reading idling or
1870 framing bytes */
1871 return;
1874 if (c == GSM1_ESCAPE) {
1875 gsm->escape = 1;
1876 return;
1879 /* Only an unescaped SOF gets us out of GSM search */
1880 if (gsm->state == GSM_SEARCH)
1881 return;
1883 if (gsm->escape) {
1884 c ^= GSM1_ESCAPE_BITS;
1885 gsm->escape = 0;
1887 switch (gsm->state) {
1888 case GSM_START: /* First byte after SOF */
1889 gsm->address = 0;
1890 gsm->state = GSM_ADDRESS;
1891 gsm->fcs = INIT_FCS;
1892 /* Drop through */
1893 case GSM_ADDRESS: /* Address continuation */
1894 gsm->fcs = gsm_fcs_add(gsm->fcs, c);
1895 if (gsm_read_ea(&gsm->address, c))
1896 gsm->state = GSM_CONTROL;
1897 break;
1898 case GSM_CONTROL: /* Control Byte */
1899 gsm->fcs = gsm_fcs_add(gsm->fcs, c);
1900 gsm->control = c;
1901 gsm->count = 0;
1902 gsm->state = GSM_DATA;
1903 break;
1904 case GSM_DATA: /* Data */
1905 if (gsm->count > gsm->mru) { /* Allow one for the FCS */
1906 gsm->state = GSM_OVERRUN;
1907 gsm->bad_size++;
1908 } else
1909 gsm->buf[gsm->count++] = c;
1910 break;
1911 case GSM_OVERRUN: /* Over-long - eg a dropped SOF */
1912 break;
1917 * gsm_error - handle tty error
1918 * @gsm: ldisc data
1919 * @data: byte received (may be invalid)
1920 * @flag: error received
1922 * Handle an error in the receipt of data for a frame. Currently we just
1923 * go back to hunting for a SOF.
1925 * FIXME: better diagnostics ?
1928 static void gsm_error(struct gsm_mux *gsm,
1929 unsigned char data, unsigned char flag)
1931 gsm->state = GSM_SEARCH;
1932 gsm->io_error++;
1936 * gsm_cleanup_mux - generic GSM protocol cleanup
1937 * @gsm: our mux
1939 * Clean up the bits of the mux which are the same for all framing
1940 * protocols. Remove the mux from the mux table, stop all the timers
1941 * and then shut down each device hanging up the channels as we go.
1944 void gsm_cleanup_mux(struct gsm_mux *gsm)
1946 int i;
1947 struct gsm_dlci *dlci = gsm->dlci[0];
1948 struct gsm_msg *txq;
1950 gsm->dead = 1;
1952 spin_lock(&gsm_mux_lock);
1953 for (i = 0; i < MAX_MUX; i++) {
1954 if (gsm_mux[i] == gsm) {
1955 gsm_mux[i] = NULL;
1956 break;
1959 spin_unlock(&gsm_mux_lock);
1960 WARN_ON(i == MAX_MUX);
1962 del_timer_sync(&gsm->t2_timer);
1963 /* Now we are sure T2 has stopped */
1964 if (dlci) {
1965 dlci->dead = 1;
1966 gsm_dlci_begin_close(dlci);
1967 wait_event_interruptible(gsm->event,
1968 dlci->state == DLCI_CLOSED);
1970 /* Free up any link layer users */
1971 for (i = 0; i < NUM_DLCI; i++)
1972 if (gsm->dlci[i])
1973 gsm_dlci_free(gsm->dlci[i]);
1974 /* Now wipe the queues */
1975 for (txq = gsm->tx_head; txq != NULL; txq = gsm->tx_head) {
1976 gsm->tx_head = txq->next;
1977 kfree(txq);
1979 gsm->tx_tail = NULL;
1981 EXPORT_SYMBOL_GPL(gsm_cleanup_mux);
1984 * gsm_activate_mux - generic GSM setup
1985 * @gsm: our mux
1987 * Set up the bits of the mux which are the same for all framing
1988 * protocols. Add the mux to the mux table so it can be opened and
1989 * finally kick off connecting to DLCI 0 on the modem.
1992 int gsm_activate_mux(struct gsm_mux *gsm)
1994 struct gsm_dlci *dlci;
1995 int i = 0;
1997 init_timer(&gsm->t2_timer);
1998 gsm->t2_timer.function = gsm_control_retransmit;
1999 gsm->t2_timer.data = (unsigned long)gsm;
2000 init_waitqueue_head(&gsm->event);
2001 spin_lock_init(&gsm->control_lock);
2002 spin_lock_init(&gsm->tx_lock);
2004 if (gsm->encoding == 0)
2005 gsm->receive = gsm0_receive;
2006 else
2007 gsm->receive = gsm1_receive;
2008 gsm->error = gsm_error;
2010 spin_lock(&gsm_mux_lock);
2011 for (i = 0; i < MAX_MUX; i++) {
2012 if (gsm_mux[i] == NULL) {
2013 gsm_mux[i] = gsm;
2014 break;
2017 spin_unlock(&gsm_mux_lock);
2018 if (i == MAX_MUX)
2019 return -EBUSY;
2021 dlci = gsm_dlci_alloc(gsm, 0);
2022 if (dlci == NULL)
2023 return -ENOMEM;
2024 gsm->dead = 0; /* Tty opens are now permissible */
2025 return 0;
2027 EXPORT_SYMBOL_GPL(gsm_activate_mux);
2030 * gsm_free_mux - free up a mux
2031 * @mux: mux to free
2033 * Dispose of allocated resources for a dead mux. No refcounting
2034 * at present so the mux must be truely dead.
2036 void gsm_free_mux(struct gsm_mux *gsm)
2038 kfree(gsm->txframe);
2039 kfree(gsm->buf);
2040 kfree(gsm);
2042 EXPORT_SYMBOL_GPL(gsm_free_mux);
2045 * gsm_alloc_mux - allocate a mux
2047 * Creates a new mux ready for activation.
2050 struct gsm_mux *gsm_alloc_mux(void)
2052 struct gsm_mux *gsm = kzalloc(sizeof(struct gsm_mux), GFP_KERNEL);
2053 if (gsm == NULL)
2054 return NULL;
2055 gsm->buf = kmalloc(MAX_MRU + 1, GFP_KERNEL);
2056 if (gsm->buf == NULL) {
2057 kfree(gsm);
2058 return NULL;
2060 gsm->txframe = kmalloc(2 * MAX_MRU + 2, GFP_KERNEL);
2061 if (gsm->txframe == NULL) {
2062 kfree(gsm->buf);
2063 kfree(gsm);
2064 return NULL;
2066 spin_lock_init(&gsm->lock);
2068 gsm->t1 = T1;
2069 gsm->t2 = T2;
2070 gsm->n2 = N2;
2071 gsm->ftype = UIH;
2072 gsm->initiator = 0;
2073 gsm->adaption = 1;
2074 gsm->encoding = 1;
2075 gsm->mru = 64; /* Default to encoding 1 so these should be 64 */
2076 gsm->mtu = 64;
2077 gsm->dead = 1; /* Avoid early tty opens */
2079 return gsm;
2081 EXPORT_SYMBOL_GPL(gsm_alloc_mux);
2084 * gsmld_output - write to link
2085 * @gsm: our mux
2086 * @data: bytes to output
2087 * @len: size
2089 * Write a block of data from the GSM mux to the data channel. This
2090 * will eventually be serialized from above but at the moment isn't.
2093 static int gsmld_output(struct gsm_mux *gsm, u8 *data, int len)
2095 if (tty_write_room(gsm->tty) < len) {
2096 set_bit(TTY_DO_WRITE_WAKEUP, &gsm->tty->flags);
2097 return -ENOSPC;
2099 if (debug & 4) {
2100 pr_debug("-->%d bytes out\n", len);
2101 hex_packet(data, len);
2103 gsm->tty->ops->write(gsm->tty, data, len);
2104 return len;
2108 * gsmld_attach_gsm - mode set up
2109 * @tty: our tty structure
2110 * @gsm: our mux
2112 * Set up the MUX for basic mode and commence connecting to the
2113 * modem. Currently called from the line discipline set up but
2114 * will need moving to an ioctl path.
2117 static int gsmld_attach_gsm(struct tty_struct *tty, struct gsm_mux *gsm)
2119 int ret;
2121 gsm->tty = tty_kref_get(tty);
2122 gsm->output = gsmld_output;
2123 ret = gsm_activate_mux(gsm);
2124 if (ret != 0)
2125 tty_kref_put(gsm->tty);
2126 return ret;
2131 * gsmld_detach_gsm - stop doing 0710 mux
2132 * @tty: tty atttached to the mux
2133 * @gsm: mux
2135 * Shutdown and then clean up the resources used by the line discipline
2138 static void gsmld_detach_gsm(struct tty_struct *tty, struct gsm_mux *gsm)
2140 WARN_ON(tty != gsm->tty);
2141 gsm_cleanup_mux(gsm);
2142 tty_kref_put(gsm->tty);
2143 gsm->tty = NULL;
2146 static void gsmld_receive_buf(struct tty_struct *tty, const unsigned char *cp,
2147 char *fp, int count)
2149 struct gsm_mux *gsm = tty->disc_data;
2150 const unsigned char *dp;
2151 char *f;
2152 int i;
2153 char buf[64];
2154 char flags;
2156 if (debug & 4) {
2157 pr_debug("Inbytes %dd\n", count);
2158 hex_packet(cp, count);
2161 for (i = count, dp = cp, f = fp; i; i--, dp++) {
2162 flags = *f++;
2163 switch (flags) {
2164 case TTY_NORMAL:
2165 gsm->receive(gsm, *dp);
2166 break;
2167 case TTY_OVERRUN:
2168 case TTY_BREAK:
2169 case TTY_PARITY:
2170 case TTY_FRAME:
2171 gsm->error(gsm, *dp, flags);
2172 break;
2173 default:
2174 WARN_ONCE("%s: unknown flag %d\n",
2175 tty_name(tty, buf), flags);
2176 break;
2179 /* FASYNC if needed ? */
2180 /* If clogged call tty_throttle(tty); */
2184 * gsmld_chars_in_buffer - report available bytes
2185 * @tty: tty device
2187 * Report the number of characters buffered to be delivered to user
2188 * at this instant in time.
2190 * Locking: gsm lock
2193 static ssize_t gsmld_chars_in_buffer(struct tty_struct *tty)
2195 return 0;
2199 * gsmld_flush_buffer - clean input queue
2200 * @tty: terminal device
2202 * Flush the input buffer. Called when the line discipline is
2203 * being closed, when the tty layer wants the buffer flushed (eg
2204 * at hangup).
2207 static void gsmld_flush_buffer(struct tty_struct *tty)
2212 * gsmld_close - close the ldisc for this tty
2213 * @tty: device
2215 * Called from the terminal layer when this line discipline is
2216 * being shut down, either because of a close or becsuse of a
2217 * discipline change. The function will not be called while other
2218 * ldisc methods are in progress.
2221 static void gsmld_close(struct tty_struct *tty)
2223 struct gsm_mux *gsm = tty->disc_data;
2225 gsmld_detach_gsm(tty, gsm);
2227 gsmld_flush_buffer(tty);
2228 /* Do other clean up here */
2229 gsm_free_mux(gsm);
2233 * gsmld_open - open an ldisc
2234 * @tty: terminal to open
2236 * Called when this line discipline is being attached to the
2237 * terminal device. Can sleep. Called serialized so that no
2238 * other events will occur in parallel. No further open will occur
2239 * until a close.
2242 static int gsmld_open(struct tty_struct *tty)
2244 struct gsm_mux *gsm;
2246 if (tty->ops->write == NULL)
2247 return -EINVAL;
2249 /* Attach our ldisc data */
2250 gsm = gsm_alloc_mux();
2251 if (gsm == NULL)
2252 return -ENOMEM;
2254 tty->disc_data = gsm;
2255 tty->receive_room = 65536;
2257 /* Attach the initial passive connection */
2258 gsm->encoding = 1;
2259 return gsmld_attach_gsm(tty, gsm);
2263 * gsmld_write_wakeup - asynchronous I/O notifier
2264 * @tty: tty device
2266 * Required for the ptys, serial driver etc. since processes
2267 * that attach themselves to the master and rely on ASYNC
2268 * IO must be woken up
2271 static void gsmld_write_wakeup(struct tty_struct *tty)
2273 struct gsm_mux *gsm = tty->disc_data;
2274 unsigned long flags;
2276 /* Queue poll */
2277 clear_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
2278 gsm_data_kick(gsm);
2279 if (gsm->tx_bytes < TX_THRESH_LO) {
2280 spin_lock_irqsave(&gsm->tx_lock, flags);
2281 gsm_dlci_data_sweep(gsm);
2282 spin_unlock_irqrestore(&gsm->tx_lock, flags);
2287 * gsmld_read - read function for tty
2288 * @tty: tty device
2289 * @file: file object
2290 * @buf: userspace buffer pointer
2291 * @nr: size of I/O
2293 * Perform reads for the line discipline. We are guaranteed that the
2294 * line discipline will not be closed under us but we may get multiple
2295 * parallel readers and must handle this ourselves. We may also get
2296 * a hangup. Always called in user context, may sleep.
2298 * This code must be sure never to sleep through a hangup.
2301 static ssize_t gsmld_read(struct tty_struct *tty, struct file *file,
2302 unsigned char __user *buf, size_t nr)
2304 return -EOPNOTSUPP;
2308 * gsmld_write - write function for tty
2309 * @tty: tty device
2310 * @file: file object
2311 * @buf: userspace buffer pointer
2312 * @nr: size of I/O
2314 * Called when the owner of the device wants to send a frame
2315 * itself (or some other control data). The data is transferred
2316 * as-is and must be properly framed and checksummed as appropriate
2317 * by userspace. Frames are either sent whole or not at all as this
2318 * avoids pain user side.
2321 static ssize_t gsmld_write(struct tty_struct *tty, struct file *file,
2322 const unsigned char *buf, size_t nr)
2324 int space = tty_write_room(tty);
2325 if (space >= nr)
2326 return tty->ops->write(tty, buf, nr);
2327 set_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
2328 return -ENOBUFS;
2332 * gsmld_poll - poll method for N_GSM0710
2333 * @tty: terminal device
2334 * @file: file accessing it
2335 * @wait: poll table
2337 * Called when the line discipline is asked to poll() for data or
2338 * for special events. This code is not serialized with respect to
2339 * other events save open/close.
2341 * This code must be sure never to sleep through a hangup.
2342 * Called without the kernel lock held - fine
2345 static unsigned int gsmld_poll(struct tty_struct *tty, struct file *file,
2346 poll_table *wait)
2348 unsigned int mask = 0;
2349 struct gsm_mux *gsm = tty->disc_data;
2351 poll_wait(file, &tty->read_wait, wait);
2352 poll_wait(file, &tty->write_wait, wait);
2353 if (tty_hung_up_p(file))
2354 mask |= POLLHUP;
2355 if (!tty_is_writelocked(tty) && tty_write_room(tty) > 0)
2356 mask |= POLLOUT | POLLWRNORM;
2357 if (gsm->dead)
2358 mask |= POLLHUP;
2359 return mask;
2362 static int gsmld_config(struct tty_struct *tty, struct gsm_mux *gsm,
2363 struct gsm_config *c)
2365 int need_close = 0;
2366 int need_restart = 0;
2368 /* Stuff we don't support yet - UI or I frame transport, windowing */
2369 if ((c->adaption != 1 && c->adaption != 2) || c->k)
2370 return -EOPNOTSUPP;
2371 /* Check the MRU/MTU range looks sane */
2372 if (c->mru > MAX_MRU || c->mtu > MAX_MTU || c->mru < 8 || c->mtu < 8)
2373 return -EINVAL;
2374 if (c->n2 < 3)
2375 return -EINVAL;
2376 if (c->encapsulation > 1) /* Basic, advanced, no I */
2377 return -EINVAL;
2378 if (c->initiator > 1)
2379 return -EINVAL;
2380 if (c->i == 0 || c->i > 2) /* UIH and UI only */
2381 return -EINVAL;
2383 * See what is needed for reconfiguration
2386 /* Timing fields */
2387 if (c->t1 != 0 && c->t1 != gsm->t1)
2388 need_restart = 1;
2389 if (c->t2 != 0 && c->t2 != gsm->t2)
2390 need_restart = 1;
2391 if (c->encapsulation != gsm->encoding)
2392 need_restart = 1;
2393 if (c->adaption != gsm->adaption)
2394 need_restart = 1;
2395 /* Requires care */
2396 if (c->initiator != gsm->initiator)
2397 need_close = 1;
2398 if (c->mru != gsm->mru)
2399 need_restart = 1;
2400 if (c->mtu != gsm->mtu)
2401 need_restart = 1;
2404 * Close down what is needed, restart and initiate the new
2405 * configuration
2408 if (need_close || need_restart) {
2409 gsm_dlci_begin_close(gsm->dlci[0]);
2410 /* This will timeout if the link is down due to N2 expiring */
2411 wait_event_interruptible(gsm->event,
2412 gsm->dlci[0]->state == DLCI_CLOSED);
2413 if (signal_pending(current))
2414 return -EINTR;
2416 if (need_restart)
2417 gsm_cleanup_mux(gsm);
2419 gsm->initiator = c->initiator;
2420 gsm->mru = c->mru;
2421 gsm->mtu = c->mtu;
2422 gsm->encoding = c->encapsulation;
2423 gsm->adaption = c->adaption;
2424 gsm->n2 = c->n2;
2426 if (c->i == 1)
2427 gsm->ftype = UIH;
2428 else if (c->i == 2)
2429 gsm->ftype = UI;
2431 if (c->t1)
2432 gsm->t1 = c->t1;
2433 if (c->t2)
2434 gsm->t2 = c->t2;
2436 /* FIXME: We need to separate activation/deactivation from adding
2437 and removing from the mux array */
2438 if (need_restart)
2439 gsm_activate_mux(gsm);
2440 if (gsm->initiator && need_close)
2441 gsm_dlci_begin_open(gsm->dlci[0]);
2442 return 0;
2445 static int gsmld_ioctl(struct tty_struct *tty, struct file *file,
2446 unsigned int cmd, unsigned long arg)
2448 struct gsm_config c;
2449 struct gsm_mux *gsm = tty->disc_data;
2451 switch (cmd) {
2452 case GSMIOC_GETCONF:
2453 memset(&c, 0, sizeof(c));
2454 c.adaption = gsm->adaption;
2455 c.encapsulation = gsm->encoding;
2456 c.initiator = gsm->initiator;
2457 c.t1 = gsm->t1;
2458 c.t2 = gsm->t2;
2459 c.t3 = 0; /* Not supported */
2460 c.n2 = gsm->n2;
2461 if (gsm->ftype == UIH)
2462 c.i = 1;
2463 else
2464 c.i = 2;
2465 pr_debug("Ftype %d i %d\n", gsm->ftype, c.i);
2466 c.mru = gsm->mru;
2467 c.mtu = gsm->mtu;
2468 c.k = 0;
2469 if (copy_to_user((void *)arg, &c, sizeof(c)))
2470 return -EFAULT;
2471 return 0;
2472 case GSMIOC_SETCONF:
2473 if (copy_from_user(&c, (void *)arg, sizeof(c)))
2474 return -EFAULT;
2475 return gsmld_config(tty, gsm, &c);
2476 default:
2477 return n_tty_ioctl_helper(tty, file, cmd, arg);
2482 /* Line discipline for real tty */
2483 struct tty_ldisc_ops tty_ldisc_packet = {
2484 .owner = THIS_MODULE,
2485 .magic = TTY_LDISC_MAGIC,
2486 .name = "n_gsm",
2487 .open = gsmld_open,
2488 .close = gsmld_close,
2489 .flush_buffer = gsmld_flush_buffer,
2490 .chars_in_buffer = gsmld_chars_in_buffer,
2491 .read = gsmld_read,
2492 .write = gsmld_write,
2493 .ioctl = gsmld_ioctl,
2494 .poll = gsmld_poll,
2495 .receive_buf = gsmld_receive_buf,
2496 .write_wakeup = gsmld_write_wakeup
2500 * Virtual tty side
2503 #define TX_SIZE 512
2505 static int gsmtty_modem_update(struct gsm_dlci *dlci, u8 brk)
2507 u8 modembits[5];
2508 struct gsm_control *ctrl;
2509 int len = 2;
2511 if (brk)
2512 len++;
2514 modembits[0] = len << 1 | EA; /* Data bytes */
2515 modembits[1] = dlci->addr << 2 | 3; /* DLCI, EA, 1 */
2516 modembits[2] = gsm_encode_modem(dlci) << 1 | EA;
2517 if (brk)
2518 modembits[3] = brk << 4 | 2 | EA; /* Valid, EA */
2519 ctrl = gsm_control_send(dlci->gsm, CMD_MSC, modembits, len + 1);
2520 if (ctrl == NULL)
2521 return -ENOMEM;
2522 return gsm_control_wait(dlci->gsm, ctrl);
2525 static int gsm_carrier_raised(struct tty_port *port)
2527 struct gsm_dlci *dlci = container_of(port, struct gsm_dlci, port);
2528 /* Not yet open so no carrier info */
2529 if (dlci->state != DLCI_OPEN)
2530 return 0;
2531 if (debug & 2)
2532 return 1;
2533 return dlci->modem_rx & TIOCM_CD;
2536 static void gsm_dtr_rts(struct tty_port *port, int onoff)
2538 struct gsm_dlci *dlci = container_of(port, struct gsm_dlci, port);
2539 unsigned int modem_tx = dlci->modem_tx;
2540 if (onoff)
2541 modem_tx |= TIOCM_DTR | TIOCM_RTS;
2542 else
2543 modem_tx &= ~(TIOCM_DTR | TIOCM_RTS);
2544 if (modem_tx != dlci->modem_tx) {
2545 dlci->modem_tx = modem_tx;
2546 gsmtty_modem_update(dlci, 0);
2550 static const struct tty_port_operations gsm_port_ops = {
2551 .carrier_raised = gsm_carrier_raised,
2552 .dtr_rts = gsm_dtr_rts,
2556 static int gsmtty_open(struct tty_struct *tty, struct file *filp)
2558 struct gsm_mux *gsm;
2559 struct gsm_dlci *dlci;
2560 struct tty_port *port;
2561 unsigned int line = tty->index;
2562 unsigned int mux = line >> 6;
2564 line = line & 0x3F;
2566 if (mux >= MAX_MUX)
2567 return -ENXIO;
2568 /* FIXME: we need to lock gsm_mux for lifetimes of ttys eventually */
2569 if (gsm_mux[mux] == NULL)
2570 return -EUNATCH;
2571 if (line == 0 || line > 61) /* 62/63 reserved */
2572 return -ECHRNG;
2573 gsm = gsm_mux[mux];
2574 if (gsm->dead)
2575 return -EL2HLT;
2576 dlci = gsm->dlci[line];
2577 if (dlci == NULL)
2578 dlci = gsm_dlci_alloc(gsm, line);
2579 if (dlci == NULL)
2580 return -ENOMEM;
2581 port = &dlci->port;
2582 port->count++;
2583 tty->driver_data = dlci;
2584 tty_port_tty_set(port, tty);
2586 dlci->modem_rx = 0;
2587 /* We could in theory open and close before we wait - eg if we get
2588 a DM straight back. This is ok as that will have caused a hangup */
2589 set_bit(ASYNCB_INITIALIZED, &port->flags);
2590 /* Start sending off SABM messages */
2591 gsm_dlci_begin_open(dlci);
2592 /* And wait for virtual carrier */
2593 return tty_port_block_til_ready(port, tty, filp);
2596 static void gsmtty_close(struct tty_struct *tty, struct file *filp)
2598 struct gsm_dlci *dlci = tty->driver_data;
2599 if (dlci == NULL)
2600 return;
2601 if (tty_port_close_start(&dlci->port, tty, filp) == 0)
2602 return;
2603 gsm_dlci_begin_close(dlci);
2604 tty_port_close_end(&dlci->port, tty);
2605 tty_port_tty_set(&dlci->port, NULL);
2608 static void gsmtty_hangup(struct tty_struct *tty)
2610 struct gsm_dlci *dlci = tty->driver_data;
2611 tty_port_hangup(&dlci->port);
2612 gsm_dlci_begin_close(dlci);
2615 static int gsmtty_write(struct tty_struct *tty, const unsigned char *buf,
2616 int len)
2618 struct gsm_dlci *dlci = tty->driver_data;
2619 /* Stuff the bytes into the fifo queue */
2620 int sent = kfifo_in_locked(dlci->fifo, buf, len, &dlci->lock);
2621 /* Need to kick the channel */
2622 gsm_dlci_data_kick(dlci);
2623 return sent;
2626 static int gsmtty_write_room(struct tty_struct *tty)
2628 struct gsm_dlci *dlci = tty->driver_data;
2629 return TX_SIZE - kfifo_len(dlci->fifo);
2632 static int gsmtty_chars_in_buffer(struct tty_struct *tty)
2634 struct gsm_dlci *dlci = tty->driver_data;
2635 return kfifo_len(dlci->fifo);
2638 static void gsmtty_flush_buffer(struct tty_struct *tty)
2640 struct gsm_dlci *dlci = tty->driver_data;
2641 /* Caution needed: If we implement reliable transport classes
2642 then the data being transmitted can't simply be junked once
2643 it has first hit the stack. Until then we can just blow it
2644 away */
2645 kfifo_reset(dlci->fifo);
2646 /* Need to unhook this DLCI from the transmit queue logic */
2649 static void gsmtty_wait_until_sent(struct tty_struct *tty, int timeout)
2651 /* The FIFO handles the queue so the kernel will do the right
2652 thing waiting on chars_in_buffer before calling us. No work
2653 to do here */
2656 static int gsmtty_tiocmget(struct tty_struct *tty, struct file *filp)
2658 struct gsm_dlci *dlci = tty->driver_data;
2659 return dlci->modem_rx;
2662 static int gsmtty_tiocmset(struct tty_struct *tty, struct file *filp,
2663 unsigned int set, unsigned int clear)
2665 struct gsm_dlci *dlci = tty->driver_data;
2666 unsigned int modem_tx = dlci->modem_tx;
2668 modem_tx &= clear;
2669 modem_tx |= set;
2671 if (modem_tx != dlci->modem_tx) {
2672 dlci->modem_tx = modem_tx;
2673 return gsmtty_modem_update(dlci, 0);
2675 return 0;
2679 static int gsmtty_ioctl(struct tty_struct *tty, struct file *filp,
2680 unsigned int cmd, unsigned long arg)
2682 return -ENOIOCTLCMD;
2685 static void gsmtty_set_termios(struct tty_struct *tty, struct ktermios *old)
2687 /* For the moment its fixed. In actual fact the speed information
2688 for the virtual channel can be propogated in both directions by
2689 the RPN control message. This however rapidly gets nasty as we
2690 then have to remap modem signals each way according to whether
2691 our virtual cable is null modem etc .. */
2692 tty_termios_copy_hw(tty->termios, old);
2695 static void gsmtty_throttle(struct tty_struct *tty)
2697 struct gsm_dlci *dlci = tty->driver_data;
2698 if (tty->termios->c_cflag & CRTSCTS)
2699 dlci->modem_tx &= ~TIOCM_DTR;
2700 dlci->throttled = 1;
2701 /* Send an MSC with DTR cleared */
2702 gsmtty_modem_update(dlci, 0);
2705 static void gsmtty_unthrottle(struct tty_struct *tty)
2707 struct gsm_dlci *dlci = tty->driver_data;
2708 if (tty->termios->c_cflag & CRTSCTS)
2709 dlci->modem_tx |= TIOCM_DTR;
2710 dlci->throttled = 0;
2711 /* Send an MSC with DTR set */
2712 gsmtty_modem_update(dlci, 0);
2715 static int gsmtty_break_ctl(struct tty_struct *tty, int state)
2717 struct gsm_dlci *dlci = tty->driver_data;
2718 int encode = 0; /* Off */
2720 if (state == -1) /* "On indefinitely" - we can't encode this
2721 properly */
2722 encode = 0x0F;
2723 else if (state > 0) {
2724 encode = state / 200; /* mS to encoding */
2725 if (encode > 0x0F)
2726 encode = 0x0F; /* Best effort */
2728 return gsmtty_modem_update(dlci, encode);
2731 static struct tty_driver *gsm_tty_driver;
2733 /* Virtual ttys for the demux */
2734 static const struct tty_operations gsmtty_ops = {
2735 .open = gsmtty_open,
2736 .close = gsmtty_close,
2737 .write = gsmtty_write,
2738 .write_room = gsmtty_write_room,
2739 .chars_in_buffer = gsmtty_chars_in_buffer,
2740 .flush_buffer = gsmtty_flush_buffer,
2741 .ioctl = gsmtty_ioctl,
2742 .throttle = gsmtty_throttle,
2743 .unthrottle = gsmtty_unthrottle,
2744 .set_termios = gsmtty_set_termios,
2745 .hangup = gsmtty_hangup,
2746 .wait_until_sent = gsmtty_wait_until_sent,
2747 .tiocmget = gsmtty_tiocmget,
2748 .tiocmset = gsmtty_tiocmset,
2749 .break_ctl = gsmtty_break_ctl,
2754 static int __init gsm_init(void)
2756 /* Fill in our line protocol discipline, and register it */
2757 int status = tty_register_ldisc(N_GSM0710, &tty_ldisc_packet);
2758 if (status != 0) {
2759 pr_err("n_gsm: can't register line discipline (err = %d)\n",
2760 status);
2761 return status;
2764 gsm_tty_driver = alloc_tty_driver(256);
2765 if (!gsm_tty_driver) {
2766 tty_unregister_ldisc(N_GSM0710);
2767 pr_err("gsm_init: tty allocation failed.\n");
2768 return -EINVAL;
2770 gsm_tty_driver->owner = THIS_MODULE;
2771 gsm_tty_driver->driver_name = "gsmtty";
2772 gsm_tty_driver->name = "gsmtty";
2773 gsm_tty_driver->major = 0; /* Dynamic */
2774 gsm_tty_driver->minor_start = 0;
2775 gsm_tty_driver->type = TTY_DRIVER_TYPE_SERIAL;
2776 gsm_tty_driver->subtype = SERIAL_TYPE_NORMAL;
2777 gsm_tty_driver->flags = TTY_DRIVER_REAL_RAW | TTY_DRIVER_DYNAMIC_DEV
2778 | TTY_DRIVER_HARDWARE_BREAK;
2779 gsm_tty_driver->init_termios = tty_std_termios;
2780 /* Fixme */
2781 gsm_tty_driver->init_termios.c_lflag &= ~ECHO;
2782 tty_set_operations(gsm_tty_driver, &gsmtty_ops);
2784 spin_lock_init(&gsm_mux_lock);
2786 if (tty_register_driver(gsm_tty_driver)) {
2787 put_tty_driver(gsm_tty_driver);
2788 tty_unregister_ldisc(N_GSM0710);
2789 pr_err("gsm_init: tty registration failed.\n");
2790 return -EBUSY;
2792 pr_debug("gsm_init: loaded as %d,%d.\n",
2793 gsm_tty_driver->major, gsm_tty_driver->minor_start);
2794 return 0;
2797 static void __exit gsm_exit(void)
2799 int status = tty_unregister_ldisc(N_GSM0710);
2800 if (status != 0)
2801 pr_err("n_gsm: can't unregister line discipline (err = %d)\n",
2802 status);
2803 tty_unregister_driver(gsm_tty_driver);
2804 put_tty_driver(gsm_tty_driver);
2807 module_init(gsm_init);
2808 module_exit(gsm_exit);
2811 MODULE_LICENSE("GPL");
2812 MODULE_ALIAS_LDISC(N_GSM0710);