Loading...
1/*
2 * Shared Transport Line discipline driver Core
3 * This hooks up ST KIM driver and ST LL driver
4 * Copyright (C) 2009-2010 Texas Instruments
5 * Author: Pavan Savoy <pavan_savoy@ti.com>
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 *
20 */
21
22#define pr_fmt(fmt) "(stc): " fmt
23#include <linux/module.h>
24#include <linux/kernel.h>
25#include <linux/tty.h>
26
27#include <linux/seq_file.h>
28#include <linux/skbuff.h>
29
30#include <linux/ti_wilink_st.h>
31
32extern void st_kim_recv(void *, const unsigned char *, long);
33void st_int_recv(void *, const unsigned char *, long);
34/* function pointer pointing to either,
35 * st_kim_recv during registration to receive fw download responses
36 * st_int_recv after registration to receive proto stack responses
37 */
38static void (*st_recv) (void *, const unsigned char *, long);
39
40/********************************************************************/
41static void add_channel_to_table(struct st_data_s *st_gdata,
42 struct st_proto_s *new_proto)
43{
44 pr_info("%s: id %d\n", __func__, new_proto->chnl_id);
45 /* list now has the channel id as index itself */
46 st_gdata->list[new_proto->chnl_id] = new_proto;
47 st_gdata->is_registered[new_proto->chnl_id] = true;
48}
49
50static void remove_channel_from_table(struct st_data_s *st_gdata,
51 struct st_proto_s *proto)
52{
53 pr_info("%s: id %d\n", __func__, proto->chnl_id);
54/* st_gdata->list[proto->chnl_id] = NULL; */
55 st_gdata->is_registered[proto->chnl_id] = false;
56}
57
58/*
59 * called from KIM during firmware download.
60 *
61 * This is a wrapper function to tty->ops->write_room.
62 * It returns number of free space available in
63 * uart tx buffer.
64 */
65int st_get_uart_wr_room(struct st_data_s *st_gdata)
66{
67 struct tty_struct *tty;
68 if (unlikely(st_gdata == NULL || st_gdata->tty == NULL)) {
69 pr_err("tty unavailable to perform write");
70 return -1;
71 }
72 tty = st_gdata->tty;
73 return tty->ops->write_room(tty);
74}
75
76/* can be called in from
77 * -- KIM (during fw download)
78 * -- ST Core (during st_write)
79 *
80 * This is the internal write function - a wrapper
81 * to tty->ops->write
82 */
83int st_int_write(struct st_data_s *st_gdata,
84 const unsigned char *data, int count)
85{
86 struct tty_struct *tty;
87 if (unlikely(st_gdata == NULL || st_gdata->tty == NULL)) {
88 pr_err("tty unavailable to perform write");
89 return -EINVAL;
90 }
91 tty = st_gdata->tty;
92#ifdef VERBOSE
93 print_hex_dump(KERN_DEBUG, "<out<", DUMP_PREFIX_NONE,
94 16, 1, data, count, 0);
95#endif
96 return tty->ops->write(tty, data, count);
97
98}
99
100/*
101 * push the skb received to relevant
102 * protocol stacks
103 */
104static void st_send_frame(unsigned char chnl_id, struct st_data_s *st_gdata)
105{
106 pr_debug(" %s(prot:%d) ", __func__, chnl_id);
107
108 if (unlikely
109 (st_gdata == NULL || st_gdata->rx_skb == NULL
110 || st_gdata->is_registered[chnl_id] == false)) {
111 pr_err("chnl_id %d not registered, no data to send?",
112 chnl_id);
113 kfree_skb(st_gdata->rx_skb);
114 return;
115 }
116 /* this cannot fail
117 * this shouldn't take long
118 * - should be just skb_queue_tail for the
119 * protocol stack driver
120 */
121 if (likely(st_gdata->list[chnl_id]->recv != NULL)) {
122 if (unlikely
123 (st_gdata->list[chnl_id]->recv
124 (st_gdata->list[chnl_id]->priv_data, st_gdata->rx_skb)
125 != 0)) {
126 pr_err(" proto stack %d's ->recv failed", chnl_id);
127 kfree_skb(st_gdata->rx_skb);
128 return;
129 }
130 } else {
131 pr_err(" proto stack %d's ->recv null", chnl_id);
132 kfree_skb(st_gdata->rx_skb);
133 }
134 return;
135}
136
137/**
138 * st_reg_complete -
139 * to call registration complete callbacks
140 * of all protocol stack drivers
141 * This function is being called with spin lock held, protocol drivers are
142 * only expected to complete their waits and do nothing more than that.
143 */
144static void st_reg_complete(struct st_data_s *st_gdata, char err)
145{
146 unsigned char i = 0;
147 pr_info(" %s ", __func__);
148 for (i = 0; i < ST_MAX_CHANNELS; i++) {
149 if (likely(st_gdata != NULL &&
150 st_gdata->is_registered[i] == true &&
151 st_gdata->list[i]->reg_complete_cb != NULL)) {
152 st_gdata->list[i]->reg_complete_cb
153 (st_gdata->list[i]->priv_data, err);
154 pr_info("protocol %d's cb sent %d\n", i, err);
155 if (err) { /* cleanup registered protocol */
156 st_gdata->is_registered[i] = false;
157 if (st_gdata->protos_registered)
158 st_gdata->protos_registered--;
159 }
160 }
161 }
162}
163
164static inline int st_check_data_len(struct st_data_s *st_gdata,
165 unsigned char chnl_id, int len)
166{
167 int room = skb_tailroom(st_gdata->rx_skb);
168
169 pr_debug("len %d room %d", len, room);
170
171 if (!len) {
172 /* Received packet has only packet header and
173 * has zero length payload. So, ask ST CORE to
174 * forward the packet to protocol driver (BT/FM/GPS)
175 */
176 st_send_frame(chnl_id, st_gdata);
177
178 } else if (len > room) {
179 /* Received packet's payload length is larger.
180 * We can't accommodate it in created skb.
181 */
182 pr_err("Data length is too large len %d room %d", len,
183 room);
184 kfree_skb(st_gdata->rx_skb);
185 } else {
186 /* Packet header has non-zero payload length and
187 * we have enough space in created skb. Lets read
188 * payload data */
189 st_gdata->rx_state = ST_W4_DATA;
190 st_gdata->rx_count = len;
191 return len;
192 }
193
194 /* Change ST state to continue to process next
195 * packet */
196 st_gdata->rx_state = ST_W4_PACKET_TYPE;
197 st_gdata->rx_skb = NULL;
198 st_gdata->rx_count = 0;
199 st_gdata->rx_chnl = 0;
200
201 return 0;
202}
203
204/**
205 * st_wakeup_ack - internal function for action when wake-up ack
206 * received
207 */
208static inline void st_wakeup_ack(struct st_data_s *st_gdata,
209 unsigned char cmd)
210{
211 struct sk_buff *waiting_skb;
212 unsigned long flags = 0;
213
214 spin_lock_irqsave(&st_gdata->lock, flags);
215 /* de-Q from waitQ and Q in txQ now that the
216 * chip is awake
217 */
218 while ((waiting_skb = skb_dequeue(&st_gdata->tx_waitq)))
219 skb_queue_tail(&st_gdata->txq, waiting_skb);
220
221 /* state forwarded to ST LL */
222 st_ll_sleep_state(st_gdata, (unsigned long)cmd);
223 spin_unlock_irqrestore(&st_gdata->lock, flags);
224
225 /* wake up to send the recently copied skbs from waitQ */
226 st_tx_wakeup(st_gdata);
227}
228
229/**
230 * st_int_recv - ST's internal receive function.
231 * Decodes received RAW data and forwards to corresponding
232 * client drivers (Bluetooth,FM,GPS..etc).
233 * This can receive various types of packets,
234 * HCI-Events, ACL, SCO, 4 types of HCI-LL PM packets
235 * CH-8 packets from FM, CH-9 packets from GPS cores.
236 */
237void st_int_recv(void *disc_data,
238 const unsigned char *data, long count)
239{
240 char *ptr;
241 struct st_proto_s *proto;
242 unsigned short payload_len = 0;
243 int len = 0;
244 unsigned char type = 0;
245 unsigned char *plen;
246 struct st_data_s *st_gdata = (struct st_data_s *)disc_data;
247 unsigned long flags;
248
249 ptr = (char *)data;
250 /* tty_receive sent null ? */
251 if (unlikely(ptr == NULL) || (st_gdata == NULL)) {
252 pr_err(" received null from TTY ");
253 return;
254 }
255
256 pr_debug("count %ld rx_state %ld"
257 "rx_count %ld", count, st_gdata->rx_state,
258 st_gdata->rx_count);
259
260 spin_lock_irqsave(&st_gdata->lock, flags);
261 /* Decode received bytes here */
262 while (count) {
263 if (st_gdata->rx_count) {
264 len = min_t(unsigned int, st_gdata->rx_count, count);
265 memcpy(skb_put(st_gdata->rx_skb, len), ptr, len);
266 st_gdata->rx_count -= len;
267 count -= len;
268 ptr += len;
269
270 if (st_gdata->rx_count)
271 continue;
272
273 /* Check ST RX state machine , where are we? */
274 switch (st_gdata->rx_state) {
275 /* Waiting for complete packet ? */
276 case ST_W4_DATA:
277 pr_debug("Complete pkt received");
278 /* Ask ST CORE to forward
279 * the packet to protocol driver */
280 st_send_frame(st_gdata->rx_chnl, st_gdata);
281
282 st_gdata->rx_state = ST_W4_PACKET_TYPE;
283 st_gdata->rx_skb = NULL;
284 continue;
285 /* parse the header to know details */
286 case ST_W4_HEADER:
287 proto = st_gdata->list[st_gdata->rx_chnl];
288 plen =
289 &st_gdata->rx_skb->data
290 [proto->offset_len_in_hdr];
291 pr_debug("plen pointing to %x\n", *plen);
292 if (proto->len_size == 1)/* 1 byte len field */
293 payload_len = *(unsigned char *)plen;
294 else if (proto->len_size == 2)
295 payload_len =
296 __le16_to_cpu(*(unsigned short *)plen);
297 else
298 pr_info("%s: invalid length "
299 "for id %d\n",
300 __func__, proto->chnl_id);
301 st_check_data_len(st_gdata, proto->chnl_id,
302 payload_len);
303 pr_debug("off %d, pay len %d\n",
304 proto->offset_len_in_hdr, payload_len);
305 continue;
306 } /* end of switch rx_state */
307 }
308
309 /* end of if rx_count */
310 /* Check first byte of packet and identify module
311 * owner (BT/FM/GPS) */
312 switch (*ptr) {
313 case LL_SLEEP_IND:
314 case LL_SLEEP_ACK:
315 case LL_WAKE_UP_IND:
316 pr_debug("PM packet");
317 /* this takes appropriate action based on
318 * sleep state received --
319 */
320 st_ll_sleep_state(st_gdata, *ptr);
321 /* if WAKEUP_IND collides copy from waitq to txq
322 * and assume chip awake
323 */
324 spin_unlock_irqrestore(&st_gdata->lock, flags);
325 if (st_ll_getstate(st_gdata) == ST_LL_AWAKE)
326 st_wakeup_ack(st_gdata, LL_WAKE_UP_ACK);
327 spin_lock_irqsave(&st_gdata->lock, flags);
328
329 ptr++;
330 count--;
331 continue;
332 case LL_WAKE_UP_ACK:
333 pr_debug("PM packet");
334
335 spin_unlock_irqrestore(&st_gdata->lock, flags);
336 /* wake up ack received */
337 st_wakeup_ack(st_gdata, *ptr);
338 spin_lock_irqsave(&st_gdata->lock, flags);
339
340 ptr++;
341 count--;
342 continue;
343 /* Unknow packet? */
344 default:
345 type = *ptr;
346
347 /* Default case means non-HCILL packets,
348 * possibilities are packets for:
349 * (a) valid protocol - Supported Protocols within
350 * the ST_MAX_CHANNELS.
351 * (b) registered protocol - Checked by
352 * "st_gdata->list[type] == NULL)" are supported
353 * protocols only.
354 * Rules out any invalid protocol and
355 * unregistered protocols with channel ID < 16.
356 */
357
358 if ((type >= ST_MAX_CHANNELS) ||
359 (st_gdata->list[type] == NULL)) {
360 pr_err("chip/interface misbehavior: "
361 "dropping frame starting "
362 "with 0x%02x\n", type);
363 goto done;
364 }
365
366 st_gdata->rx_skb = alloc_skb(
367 st_gdata->list[type]->max_frame_size,
368 GFP_ATOMIC);
369 if (st_gdata->rx_skb == NULL) {
370 pr_err("out of memory: dropping\n");
371 goto done;
372 }
373
374 skb_reserve(st_gdata->rx_skb,
375 st_gdata->list[type]->reserve);
376 /* next 2 required for BT only */
377 st_gdata->rx_skb->cb[0] = type; /*pkt_type*/
378 st_gdata->rx_skb->cb[1] = 0; /*incoming*/
379 st_gdata->rx_chnl = *ptr;
380 st_gdata->rx_state = ST_W4_HEADER;
381 st_gdata->rx_count = st_gdata->list[type]->hdr_len;
382 pr_debug("rx_count %ld\n", st_gdata->rx_count);
383 };
384 ptr++;
385 count--;
386 }
387done:
388 spin_unlock_irqrestore(&st_gdata->lock, flags);
389 pr_debug("done %s", __func__);
390 return;
391}
392
393/**
394 * st_int_dequeue - internal de-Q function.
395 * If the previous data set was not written
396 * completely, return that skb which has the pending data.
397 * In normal cases, return top of txq.
398 */
399static struct sk_buff *st_int_dequeue(struct st_data_s *st_gdata)
400{
401 struct sk_buff *returning_skb;
402
403 pr_debug("%s", __func__);
404 if (st_gdata->tx_skb != NULL) {
405 returning_skb = st_gdata->tx_skb;
406 st_gdata->tx_skb = NULL;
407 return returning_skb;
408 }
409 return skb_dequeue(&st_gdata->txq);
410}
411
412/**
413 * st_int_enqueue - internal Q-ing function.
414 * Will either Q the skb to txq or the tx_waitq
415 * depending on the ST LL state.
416 * If the chip is asleep, then Q it onto waitq and
417 * wakeup the chip.
418 * txq and waitq needs protection since the other contexts
419 * may be sending data, waking up chip.
420 */
421static void st_int_enqueue(struct st_data_s *st_gdata, struct sk_buff *skb)
422{
423 unsigned long flags = 0;
424
425 pr_debug("%s", __func__);
426 spin_lock_irqsave(&st_gdata->lock, flags);
427
428 switch (st_ll_getstate(st_gdata)) {
429 case ST_LL_AWAKE:
430 pr_debug("ST LL is AWAKE, sending normally");
431 skb_queue_tail(&st_gdata->txq, skb);
432 break;
433 case ST_LL_ASLEEP_TO_AWAKE:
434 skb_queue_tail(&st_gdata->tx_waitq, skb);
435 break;
436 case ST_LL_AWAKE_TO_ASLEEP:
437 pr_err("ST LL is illegal state(%ld),"
438 "purging received skb.", st_ll_getstate(st_gdata));
439 kfree_skb(skb);
440 break;
441 case ST_LL_ASLEEP:
442 skb_queue_tail(&st_gdata->tx_waitq, skb);
443 st_ll_wakeup(st_gdata);
444 break;
445 default:
446 pr_err("ST LL is illegal state(%ld),"
447 "purging received skb.", st_ll_getstate(st_gdata));
448 kfree_skb(skb);
449 break;
450 }
451
452 spin_unlock_irqrestore(&st_gdata->lock, flags);
453 pr_debug("done %s", __func__);
454 return;
455}
456
457/*
458 * internal wakeup function
459 * called from either
460 * - TTY layer when write's finished
461 * - st_write (in context of the protocol stack)
462 */
463static void work_fn_write_wakeup(struct work_struct *work)
464{
465 struct st_data_s *st_gdata = container_of(work, struct st_data_s,
466 work_write_wakeup);
467
468 st_tx_wakeup((void *)st_gdata);
469}
470void st_tx_wakeup(struct st_data_s *st_data)
471{
472 struct sk_buff *skb;
473 unsigned long flags; /* for irq save flags */
474 pr_debug("%s", __func__);
475 /* check for sending & set flag sending here */
476 if (test_and_set_bit(ST_TX_SENDING, &st_data->tx_state)) {
477 pr_debug("ST already sending");
478 /* keep sending */
479 set_bit(ST_TX_WAKEUP, &st_data->tx_state);
480 return;
481 /* TX_WAKEUP will be checked in another
482 * context
483 */
484 }
485 do { /* come back if st_tx_wakeup is set */
486 /* woke-up to write */
487 clear_bit(ST_TX_WAKEUP, &st_data->tx_state);
488 while ((skb = st_int_dequeue(st_data))) {
489 int len;
490 spin_lock_irqsave(&st_data->lock, flags);
491 /* enable wake-up from TTY */
492 set_bit(TTY_DO_WRITE_WAKEUP, &st_data->tty->flags);
493 len = st_int_write(st_data, skb->data, skb->len);
494 skb_pull(skb, len);
495 /* if skb->len = len as expected, skb->len=0 */
496 if (skb->len) {
497 /* would be the next skb to be sent */
498 st_data->tx_skb = skb;
499 spin_unlock_irqrestore(&st_data->lock, flags);
500 break;
501 }
502 kfree_skb(skb);
503 spin_unlock_irqrestore(&st_data->lock, flags);
504 }
505 /* if wake-up is set in another context- restart sending */
506 } while (test_bit(ST_TX_WAKEUP, &st_data->tx_state));
507
508 /* clear flag sending */
509 clear_bit(ST_TX_SENDING, &st_data->tx_state);
510}
511
512/********************************************************************/
513/* functions called from ST KIM
514*/
515void kim_st_list_protocols(struct st_data_s *st_gdata, void *buf)
516{
517 seq_printf(buf, "[%d]\nBT=%c\nFM=%c\nGPS=%c\n",
518 st_gdata->protos_registered,
519 st_gdata->is_registered[0x04] == true ? 'R' : 'U',
520 st_gdata->is_registered[0x08] == true ? 'R' : 'U',
521 st_gdata->is_registered[0x09] == true ? 'R' : 'U');
522}
523
524/********************************************************************/
525/*
526 * functions called from protocol stack drivers
527 * to be EXPORT-ed
528 */
529long st_register(struct st_proto_s *new_proto)
530{
531 struct st_data_s *st_gdata;
532 long err = 0;
533 unsigned long flags = 0;
534
535 st_kim_ref(&st_gdata, 0);
536 if (st_gdata == NULL || new_proto == NULL || new_proto->recv == NULL
537 || new_proto->reg_complete_cb == NULL) {
538 pr_err("gdata/new_proto/recv or reg_complete_cb not ready");
539 return -EINVAL;
540 }
541
542 if (new_proto->chnl_id >= ST_MAX_CHANNELS) {
543 pr_err("chnl_id %d not supported", new_proto->chnl_id);
544 return -EPROTONOSUPPORT;
545 }
546
547 if (st_gdata->is_registered[new_proto->chnl_id] == true) {
548 pr_err("chnl_id %d already registered", new_proto->chnl_id);
549 return -EALREADY;
550 }
551
552 /* can be from process context only */
553 spin_lock_irqsave(&st_gdata->lock, flags);
554
555 if (test_bit(ST_REG_IN_PROGRESS, &st_gdata->st_state)) {
556 pr_info(" ST_REG_IN_PROGRESS:%d ", new_proto->chnl_id);
557 /* fw download in progress */
558
559 add_channel_to_table(st_gdata, new_proto);
560 st_gdata->protos_registered++;
561 new_proto->write = st_write;
562
563 set_bit(ST_REG_PENDING, &st_gdata->st_state);
564 spin_unlock_irqrestore(&st_gdata->lock, flags);
565 return -EINPROGRESS;
566 } else if (st_gdata->protos_registered == ST_EMPTY) {
567 pr_info(" chnl_id list empty :%d ", new_proto->chnl_id);
568 set_bit(ST_REG_IN_PROGRESS, &st_gdata->st_state);
569 st_recv = st_kim_recv;
570
571 /* enable the ST LL - to set default chip state */
572 st_ll_enable(st_gdata);
573
574 /* release lock previously held - re-locked below */
575 spin_unlock_irqrestore(&st_gdata->lock, flags);
576
577 /* this may take a while to complete
578 * since it involves BT fw download
579 */
580 err = st_kim_start(st_gdata->kim_data);
581 if (err != 0) {
582 clear_bit(ST_REG_IN_PROGRESS, &st_gdata->st_state);
583 if ((st_gdata->protos_registered != ST_EMPTY) &&
584 (test_bit(ST_REG_PENDING, &st_gdata->st_state))) {
585 pr_err(" KIM failure complete callback ");
586 spin_lock_irqsave(&st_gdata->lock, flags);
587 st_reg_complete(st_gdata, err);
588 spin_unlock_irqrestore(&st_gdata->lock, flags);
589 clear_bit(ST_REG_PENDING, &st_gdata->st_state);
590 }
591 return -EINVAL;
592 }
593
594 spin_lock_irqsave(&st_gdata->lock, flags);
595
596 clear_bit(ST_REG_IN_PROGRESS, &st_gdata->st_state);
597 st_recv = st_int_recv;
598
599 /* this is where all pending registration
600 * are signalled to be complete by calling callback functions
601 */
602 if ((st_gdata->protos_registered != ST_EMPTY) &&
603 (test_bit(ST_REG_PENDING, &st_gdata->st_state))) {
604 pr_debug(" call reg complete callback ");
605 st_reg_complete(st_gdata, 0);
606 }
607 clear_bit(ST_REG_PENDING, &st_gdata->st_state);
608
609 /* check for already registered once more,
610 * since the above check is old
611 */
612 if (st_gdata->is_registered[new_proto->chnl_id] == true) {
613 pr_err(" proto %d already registered ",
614 new_proto->chnl_id);
615 spin_unlock_irqrestore(&st_gdata->lock, flags);
616 return -EALREADY;
617 }
618
619 add_channel_to_table(st_gdata, new_proto);
620 st_gdata->protos_registered++;
621 new_proto->write = st_write;
622 spin_unlock_irqrestore(&st_gdata->lock, flags);
623 return err;
624 }
625 /* if fw is already downloaded & new stack registers protocol */
626 else {
627 add_channel_to_table(st_gdata, new_proto);
628 st_gdata->protos_registered++;
629 new_proto->write = st_write;
630
631 /* lock already held before entering else */
632 spin_unlock_irqrestore(&st_gdata->lock, flags);
633 return err;
634 }
635}
636EXPORT_SYMBOL_GPL(st_register);
637
638/* to unregister a protocol -
639 * to be called from protocol stack driver
640 */
641long st_unregister(struct st_proto_s *proto)
642{
643 long err = 0;
644 unsigned long flags = 0;
645 struct st_data_s *st_gdata;
646
647 pr_debug("%s: %d ", __func__, proto->chnl_id);
648
649 st_kim_ref(&st_gdata, 0);
650 if (!st_gdata || proto->chnl_id >= ST_MAX_CHANNELS) {
651 pr_err(" chnl_id %d not supported", proto->chnl_id);
652 return -EPROTONOSUPPORT;
653 }
654
655 spin_lock_irqsave(&st_gdata->lock, flags);
656
657 if (st_gdata->is_registered[proto->chnl_id] == false) {
658 pr_err(" chnl_id %d not registered", proto->chnl_id);
659 spin_unlock_irqrestore(&st_gdata->lock, flags);
660 return -EPROTONOSUPPORT;
661 }
662
663 if (st_gdata->protos_registered)
664 st_gdata->protos_registered--;
665
666 remove_channel_from_table(st_gdata, proto);
667 spin_unlock_irqrestore(&st_gdata->lock, flags);
668
669 if ((st_gdata->protos_registered == ST_EMPTY) &&
670 (!test_bit(ST_REG_PENDING, &st_gdata->st_state))) {
671 pr_info(" all chnl_ids unregistered ");
672
673 /* stop traffic on tty */
674 if (st_gdata->tty) {
675 tty_ldisc_flush(st_gdata->tty);
676 stop_tty(st_gdata->tty);
677 }
678
679 /* all chnl_ids now unregistered */
680 st_kim_stop(st_gdata->kim_data);
681 /* disable ST LL */
682 st_ll_disable(st_gdata);
683 }
684 return err;
685}
686
687/*
688 * called in protocol stack drivers
689 * via the write function pointer
690 */
691long st_write(struct sk_buff *skb)
692{
693 struct st_data_s *st_gdata;
694 long len;
695
696 st_kim_ref(&st_gdata, 0);
697 if (unlikely(skb == NULL || st_gdata == NULL
698 || st_gdata->tty == NULL)) {
699 pr_err("data/tty unavailable to perform write");
700 return -EINVAL;
701 }
702
703 pr_debug("%d to be written", skb->len);
704 len = skb->len;
705
706 /* st_ll to decide where to enqueue the skb */
707 st_int_enqueue(st_gdata, skb);
708 /* wake up */
709 st_tx_wakeup(st_gdata);
710
711 /* return number of bytes written */
712 return len;
713}
714
715/* for protocols making use of shared transport */
716EXPORT_SYMBOL_GPL(st_unregister);
717
718/********************************************************************/
719/*
720 * functions called from TTY layer
721 */
722static int st_tty_open(struct tty_struct *tty)
723{
724 int err = 0;
725 struct st_data_s *st_gdata;
726 pr_info("%s ", __func__);
727
728 st_kim_ref(&st_gdata, 0);
729 st_gdata->tty = tty;
730 tty->disc_data = st_gdata;
731
732 /* don't do an wakeup for now */
733 clear_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
734
735 /* mem already allocated
736 */
737 tty->receive_room = 65536;
738 /* Flush any pending characters in the driver and discipline. */
739 tty_ldisc_flush(tty);
740 tty_driver_flush_buffer(tty);
741 /*
742 * signal to UIM via KIM that -
743 * installation of N_TI_WL ldisc is complete
744 */
745 st_kim_complete(st_gdata->kim_data);
746 pr_debug("done %s", __func__);
747 return err;
748}
749
750static void st_tty_close(struct tty_struct *tty)
751{
752 unsigned char i = ST_MAX_CHANNELS;
753 unsigned long flags = 0;
754 struct st_data_s *st_gdata = tty->disc_data;
755
756 pr_info("%s ", __func__);
757
758 /* TODO:
759 * if a protocol has been registered & line discipline
760 * un-installed for some reason - what should be done ?
761 */
762 spin_lock_irqsave(&st_gdata->lock, flags);
763 for (i = ST_BT; i < ST_MAX_CHANNELS; i++) {
764 if (st_gdata->is_registered[i] == true)
765 pr_err("%d not un-registered", i);
766 st_gdata->list[i] = NULL;
767 st_gdata->is_registered[i] = false;
768 }
769 st_gdata->protos_registered = 0;
770 spin_unlock_irqrestore(&st_gdata->lock, flags);
771 /*
772 * signal to UIM via KIM that -
773 * N_TI_WL ldisc is un-installed
774 */
775 st_kim_complete(st_gdata->kim_data);
776 st_gdata->tty = NULL;
777 /* Flush any pending characters in the driver and discipline. */
778 tty_ldisc_flush(tty);
779 tty_driver_flush_buffer(tty);
780
781 spin_lock_irqsave(&st_gdata->lock, flags);
782 /* empty out txq and tx_waitq */
783 skb_queue_purge(&st_gdata->txq);
784 skb_queue_purge(&st_gdata->tx_waitq);
785 /* reset the TTY Rx states of ST */
786 st_gdata->rx_count = 0;
787 st_gdata->rx_state = ST_W4_PACKET_TYPE;
788 kfree_skb(st_gdata->rx_skb);
789 st_gdata->rx_skb = NULL;
790 spin_unlock_irqrestore(&st_gdata->lock, flags);
791
792 pr_debug("%s: done ", __func__);
793}
794
795static void st_tty_receive(struct tty_struct *tty, const unsigned char *data,
796 char *tty_flags, int count)
797{
798#ifdef VERBOSE
799 print_hex_dump(KERN_DEBUG, ">in>", DUMP_PREFIX_NONE,
800 16, 1, data, count, 0);
801#endif
802
803 /*
804 * if fw download is in progress then route incoming data
805 * to KIM for validation
806 */
807 st_recv(tty->disc_data, data, count);
808 pr_debug("done %s", __func__);
809}
810
811/* wake-up function called in from the TTY layer
812 * inside the internal wakeup function will be called
813 */
814static void st_tty_wakeup(struct tty_struct *tty)
815{
816 struct st_data_s *st_gdata = tty->disc_data;
817 pr_debug("%s ", __func__);
818 /* don't do an wakeup for now */
819 clear_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
820
821 /*
822 * schedule the internal wakeup instead of calling directly to
823 * avoid lockup (port->lock needed in tty->ops->write is
824 * already taken here
825 */
826 schedule_work(&st_gdata->work_write_wakeup);
827}
828
829static void st_tty_flush_buffer(struct tty_struct *tty)
830{
831 struct st_data_s *st_gdata = tty->disc_data;
832 pr_debug("%s ", __func__);
833
834 kfree_skb(st_gdata->tx_skb);
835 st_gdata->tx_skb = NULL;
836
837 tty_driver_flush_buffer(tty);
838 return;
839}
840
841static struct tty_ldisc_ops st_ldisc_ops = {
842 .magic = TTY_LDISC_MAGIC,
843 .name = "n_st",
844 .open = st_tty_open,
845 .close = st_tty_close,
846 .receive_buf = st_tty_receive,
847 .write_wakeup = st_tty_wakeup,
848 .flush_buffer = st_tty_flush_buffer,
849 .owner = THIS_MODULE
850};
851
852/********************************************************************/
853int st_core_init(struct st_data_s **core_data)
854{
855 struct st_data_s *st_gdata;
856 long err;
857
858 err = tty_register_ldisc(N_TI_WL, &st_ldisc_ops);
859 if (err) {
860 pr_err("error registering %d line discipline %ld",
861 N_TI_WL, err);
862 return err;
863 }
864 pr_debug("registered n_shared line discipline");
865
866 st_gdata = kzalloc(sizeof(struct st_data_s), GFP_KERNEL);
867 if (!st_gdata) {
868 pr_err("memory allocation failed");
869 err = tty_unregister_ldisc(N_TI_WL);
870 if (err)
871 pr_err("unable to un-register ldisc %ld", err);
872 err = -ENOMEM;
873 return err;
874 }
875
876 /* Initialize ST TxQ and Tx waitQ queue head. All BT/FM/GPS module skb's
877 * will be pushed in this queue for actual transmission.
878 */
879 skb_queue_head_init(&st_gdata->txq);
880 skb_queue_head_init(&st_gdata->tx_waitq);
881
882 /* Locking used in st_int_enqueue() to avoid multiple execution */
883 spin_lock_init(&st_gdata->lock);
884
885 err = st_ll_init(st_gdata);
886 if (err) {
887 pr_err("error during st_ll initialization(%ld)", err);
888 kfree(st_gdata);
889 err = tty_unregister_ldisc(N_TI_WL);
890 if (err)
891 pr_err("unable to un-register ldisc");
892 return err;
893 }
894
895 INIT_WORK(&st_gdata->work_write_wakeup, work_fn_write_wakeup);
896
897 *core_data = st_gdata;
898 return 0;
899}
900
901void st_core_exit(struct st_data_s *st_gdata)
902{
903 long err;
904 /* internal module cleanup */
905 err = st_ll_deinit(st_gdata);
906 if (err)
907 pr_err("error during deinit of ST LL %ld", err);
908
909 if (st_gdata != NULL) {
910 /* Free ST Tx Qs and skbs */
911 skb_queue_purge(&st_gdata->txq);
912 skb_queue_purge(&st_gdata->tx_waitq);
913 kfree_skb(st_gdata->rx_skb);
914 kfree_skb(st_gdata->tx_skb);
915 /* TTY ldisc cleanup */
916 err = tty_unregister_ldisc(N_TI_WL);
917 if (err)
918 pr_err("unable to un-register ldisc %ld", err);
919 /* free the global data pointer */
920 kfree(st_gdata);
921 }
922}
1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * Shared Transport Line discipline driver Core
4 * This hooks up ST KIM driver and ST LL driver
5 * Copyright (C) 2009-2010 Texas Instruments
6 * Author: Pavan Savoy <pavan_savoy@ti.com>
7 */
8
9#define pr_fmt(fmt) "(stc): " fmt
10#include <linux/module.h>
11#include <linux/kernel.h>
12#include <linux/tty.h>
13
14#include <linux/seq_file.h>
15#include <linux/skbuff.h>
16
17#include <linux/ti_wilink_st.h>
18
19extern void st_kim_recv(void *, const unsigned char *, long);
20void st_int_recv(void *, const unsigned char *, long);
21/*
22 * function pointer pointing to either,
23 * st_kim_recv during registration to receive fw download responses
24 * st_int_recv after registration to receive proto stack responses
25 */
26static void (*st_recv) (void *, const unsigned char *, long);
27
28/********************************************************************/
29static void add_channel_to_table(struct st_data_s *st_gdata,
30 struct st_proto_s *new_proto)
31{
32 pr_info("%s: id %d\n", __func__, new_proto->chnl_id);
33 /* list now has the channel id as index itself */
34 st_gdata->list[new_proto->chnl_id] = new_proto;
35 st_gdata->is_registered[new_proto->chnl_id] = true;
36}
37
38static void remove_channel_from_table(struct st_data_s *st_gdata,
39 struct st_proto_s *proto)
40{
41 pr_info("%s: id %d\n", __func__, proto->chnl_id);
42/* st_gdata->list[proto->chnl_id] = NULL; */
43 st_gdata->is_registered[proto->chnl_id] = false;
44}
45
46/*
47 * called from KIM during firmware download.
48 *
49 * This is a wrapper function to tty->ops->write_room.
50 * It returns number of free space available in
51 * uart tx buffer.
52 */
53int st_get_uart_wr_room(struct st_data_s *st_gdata)
54{
55 if (unlikely(st_gdata == NULL || st_gdata->tty == NULL)) {
56 pr_err("tty unavailable to perform write");
57 return -1;
58 }
59
60 return tty_write_room(st_gdata->tty);
61}
62
63/*
64 * can be called in from
65 * -- KIM (during fw download)
66 * -- ST Core (during st_write)
67 *
68 * This is the internal write function - a wrapper
69 * to tty->ops->write
70 */
71int st_int_write(struct st_data_s *st_gdata,
72 const unsigned char *data, int count)
73{
74 struct tty_struct *tty;
75 if (unlikely(st_gdata == NULL || st_gdata->tty == NULL)) {
76 pr_err("tty unavailable to perform write");
77 return -EINVAL;
78 }
79 tty = st_gdata->tty;
80#ifdef VERBOSE
81 print_hex_dump(KERN_DEBUG, "<out<", DUMP_PREFIX_NONE,
82 16, 1, data, count, 0);
83#endif
84 return tty->ops->write(tty, data, count);
85
86}
87
88/*
89 * push the skb received to relevant
90 * protocol stacks
91 */
92static void st_send_frame(unsigned char chnl_id, struct st_data_s *st_gdata)
93{
94 pr_debug(" %s(prot:%d) ", __func__, chnl_id);
95
96 if (unlikely
97 (st_gdata == NULL || st_gdata->rx_skb == NULL
98 || st_gdata->is_registered[chnl_id] == false)) {
99 pr_err("chnl_id %d not registered, no data to send?",
100 chnl_id);
101 kfree_skb(st_gdata->rx_skb);
102 return;
103 }
104 /*
105 * this cannot fail
106 * this shouldn't take long
107 * - should be just skb_queue_tail for the
108 * protocol stack driver
109 */
110 if (likely(st_gdata->list[chnl_id]->recv != NULL)) {
111 if (unlikely
112 (st_gdata->list[chnl_id]->recv
113 (st_gdata->list[chnl_id]->priv_data, st_gdata->rx_skb)
114 != 0)) {
115 pr_err(" proto stack %d's ->recv failed", chnl_id);
116 kfree_skb(st_gdata->rx_skb);
117 return;
118 }
119 } else {
120 pr_err(" proto stack %d's ->recv null", chnl_id);
121 kfree_skb(st_gdata->rx_skb);
122 }
123 return;
124}
125
126/*
127 * st_reg_complete - to call registration complete callbacks
128 * of all protocol stack drivers
129 * This function is being called with spin lock held, protocol drivers are
130 * only expected to complete their waits and do nothing more than that.
131 */
132static void st_reg_complete(struct st_data_s *st_gdata, int err)
133{
134 unsigned char i = 0;
135 pr_info(" %s ", __func__);
136 for (i = 0; i < ST_MAX_CHANNELS; i++) {
137 if (likely(st_gdata != NULL &&
138 st_gdata->is_registered[i] == true &&
139 st_gdata->list[i]->reg_complete_cb != NULL)) {
140 st_gdata->list[i]->reg_complete_cb
141 (st_gdata->list[i]->priv_data, err);
142 pr_info("protocol %d's cb sent %d\n", i, err);
143 if (err) { /* cleanup registered protocol */
144 st_gdata->is_registered[i] = false;
145 if (st_gdata->protos_registered)
146 st_gdata->protos_registered--;
147 }
148 }
149 }
150}
151
152static inline int st_check_data_len(struct st_data_s *st_gdata,
153 unsigned char chnl_id, int len)
154{
155 int room = skb_tailroom(st_gdata->rx_skb);
156
157 pr_debug("len %d room %d", len, room);
158
159 if (!len) {
160 /*
161 * Received packet has only packet header and
162 * has zero length payload. So, ask ST CORE to
163 * forward the packet to protocol driver (BT/FM/GPS)
164 */
165 st_send_frame(chnl_id, st_gdata);
166
167 } else if (len > room) {
168 /*
169 * Received packet's payload length is larger.
170 * We can't accommodate it in created skb.
171 */
172 pr_err("Data length is too large len %d room %d", len,
173 room);
174 kfree_skb(st_gdata->rx_skb);
175 } else {
176 /*
177 * Packet header has non-zero payload length and
178 * we have enough space in created skb. Lets read
179 * payload data */
180 st_gdata->rx_state = ST_W4_DATA;
181 st_gdata->rx_count = len;
182 return len;
183 }
184
185 /* Change ST state to continue to process next packet */
186 st_gdata->rx_state = ST_W4_PACKET_TYPE;
187 st_gdata->rx_skb = NULL;
188 st_gdata->rx_count = 0;
189 st_gdata->rx_chnl = 0;
190
191 return 0;
192}
193
194/*
195 * st_wakeup_ack - internal function for action when wake-up ack
196 * received
197 */
198static inline void st_wakeup_ack(struct st_data_s *st_gdata,
199 unsigned char cmd)
200{
201 struct sk_buff *waiting_skb;
202 unsigned long flags = 0;
203
204 spin_lock_irqsave(&st_gdata->lock, flags);
205 /*
206 * de-Q from waitQ and Q in txQ now that the
207 * chip is awake
208 */
209 while ((waiting_skb = skb_dequeue(&st_gdata->tx_waitq)))
210 skb_queue_tail(&st_gdata->txq, waiting_skb);
211
212 /* state forwarded to ST LL */
213 st_ll_sleep_state(st_gdata, (unsigned long)cmd);
214 spin_unlock_irqrestore(&st_gdata->lock, flags);
215
216 /* wake up to send the recently copied skbs from waitQ */
217 st_tx_wakeup(st_gdata);
218}
219
220/*
221 * st_int_recv - ST's internal receive function.
222 * Decodes received RAW data and forwards to corresponding
223 * client drivers (Bluetooth,FM,GPS..etc).
224 * This can receive various types of packets,
225 * HCI-Events, ACL, SCO, 4 types of HCI-LL PM packets
226 * CH-8 packets from FM, CH-9 packets from GPS cores.
227 */
228void st_int_recv(void *disc_data,
229 const unsigned char *data, long count)
230{
231 char *ptr;
232 struct st_proto_s *proto;
233 unsigned short payload_len = 0;
234 int len = 0;
235 unsigned char type = 0;
236 unsigned char *plen;
237 struct st_data_s *st_gdata = (struct st_data_s *)disc_data;
238 unsigned long flags;
239
240 ptr = (char *)data;
241 /* tty_receive sent null ? */
242 if (unlikely(ptr == NULL) || (st_gdata == NULL)) {
243 pr_err(" received null from TTY ");
244 return;
245 }
246
247 pr_debug("count %ld rx_state %ld"
248 "rx_count %ld", count, st_gdata->rx_state,
249 st_gdata->rx_count);
250
251 spin_lock_irqsave(&st_gdata->lock, flags);
252 /* Decode received bytes here */
253 while (count) {
254 if (st_gdata->rx_count) {
255 len = min_t(unsigned int, st_gdata->rx_count, count);
256 skb_put_data(st_gdata->rx_skb, ptr, len);
257 st_gdata->rx_count -= len;
258 count -= len;
259 ptr += len;
260
261 if (st_gdata->rx_count)
262 continue;
263
264 /* Check ST RX state machine , where are we? */
265 switch (st_gdata->rx_state) {
266 /* Waiting for complete packet ? */
267 case ST_W4_DATA:
268 pr_debug("Complete pkt received");
269 /*
270 * Ask ST CORE to forward
271 * the packet to protocol driver
272 */
273 st_send_frame(st_gdata->rx_chnl, st_gdata);
274
275 st_gdata->rx_state = ST_W4_PACKET_TYPE;
276 st_gdata->rx_skb = NULL;
277 continue;
278 /* parse the header to know details */
279 case ST_W4_HEADER:
280 proto = st_gdata->list[st_gdata->rx_chnl];
281 plen =
282 &st_gdata->rx_skb->data
283 [proto->offset_len_in_hdr];
284 pr_debug("plen pointing to %x\n", *plen);
285 if (proto->len_size == 1) /* 1 byte len field */
286 payload_len = *(unsigned char *)plen;
287 else if (proto->len_size == 2)
288 payload_len =
289 __le16_to_cpu(*(unsigned short *)plen);
290 else
291 pr_info("%s: invalid length "
292 "for id %d\n",
293 __func__, proto->chnl_id);
294 st_check_data_len(st_gdata, proto->chnl_id,
295 payload_len);
296 pr_debug("off %d, pay len %d\n",
297 proto->offset_len_in_hdr, payload_len);
298 continue;
299 } /* end of switch rx_state */
300 }
301
302 /* end of if rx_count */
303
304 /*
305 * Check first byte of packet and identify module
306 * owner (BT/FM/GPS)
307 */
308 switch (*ptr) {
309 case LL_SLEEP_IND:
310 case LL_SLEEP_ACK:
311 case LL_WAKE_UP_IND:
312 pr_debug("PM packet");
313 /*
314 * this takes appropriate action based on
315 * sleep state received --
316 */
317 st_ll_sleep_state(st_gdata, *ptr);
318 /*
319 * if WAKEUP_IND collides copy from waitq to txq
320 * and assume chip awake
321 */
322 spin_unlock_irqrestore(&st_gdata->lock, flags);
323 if (st_ll_getstate(st_gdata) == ST_LL_AWAKE)
324 st_wakeup_ack(st_gdata, LL_WAKE_UP_ACK);
325 spin_lock_irqsave(&st_gdata->lock, flags);
326
327 ptr++;
328 count--;
329 continue;
330 case LL_WAKE_UP_ACK:
331 pr_debug("PM packet");
332
333 spin_unlock_irqrestore(&st_gdata->lock, flags);
334 /* wake up ack received */
335 st_wakeup_ack(st_gdata, *ptr);
336 spin_lock_irqsave(&st_gdata->lock, flags);
337
338 ptr++;
339 count--;
340 continue;
341 /* Unknow packet? */
342 default:
343 type = *ptr;
344
345 /*
346 * Default case means non-HCILL packets,
347 * possibilities are packets for:
348 * (a) valid protocol - Supported Protocols within
349 * the ST_MAX_CHANNELS.
350 * (b) registered protocol - Checked by
351 * "st_gdata->list[type] == NULL)" are supported
352 * protocols only.
353 * Rules out any invalid protocol and
354 * unregistered protocols with channel ID < 16.
355 */
356
357 if ((type >= ST_MAX_CHANNELS) ||
358 (st_gdata->list[type] == NULL)) {
359 pr_err("chip/interface misbehavior: "
360 "dropping frame starting "
361 "with 0x%02x\n", type);
362 goto done;
363 }
364
365 st_gdata->rx_skb = alloc_skb(
366 st_gdata->list[type]->max_frame_size,
367 GFP_ATOMIC);
368 if (st_gdata->rx_skb == NULL) {
369 pr_err("out of memory: dropping\n");
370 goto done;
371 }
372
373 skb_reserve(st_gdata->rx_skb,
374 st_gdata->list[type]->reserve);
375 /* next 2 required for BT only */
376 st_gdata->rx_skb->cb[0] = type; /*pkt_type*/
377 st_gdata->rx_skb->cb[1] = 0; /*incoming*/
378 st_gdata->rx_chnl = *ptr;
379 st_gdata->rx_state = ST_W4_HEADER;
380 st_gdata->rx_count = st_gdata->list[type]->hdr_len;
381 pr_debug("rx_count %ld\n", st_gdata->rx_count);
382 }
383 ptr++;
384 count--;
385 }
386done:
387 spin_unlock_irqrestore(&st_gdata->lock, flags);
388 pr_debug("done %s", __func__);
389 return;
390}
391
392/*
393 * st_int_dequeue - internal de-Q function.
394 * If the previous data set was not written
395 * completely, return that skb which has the pending data.
396 * In normal cases, return top of txq.
397 */
398static struct sk_buff *st_int_dequeue(struct st_data_s *st_gdata)
399{
400 struct sk_buff *returning_skb;
401
402 pr_debug("%s", __func__);
403 if (st_gdata->tx_skb != NULL) {
404 returning_skb = st_gdata->tx_skb;
405 st_gdata->tx_skb = NULL;
406 return returning_skb;
407 }
408 return skb_dequeue(&st_gdata->txq);
409}
410
411/*
412 * st_int_enqueue - internal Q-ing function.
413 * Will either Q the skb to txq or the tx_waitq
414 * depending on the ST LL state.
415 * If the chip is asleep, then Q it onto waitq and
416 * wakeup the chip.
417 * txq and waitq needs protection since the other contexts
418 * may be sending data, waking up chip.
419 */
420static void st_int_enqueue(struct st_data_s *st_gdata, struct sk_buff *skb)
421{
422 unsigned long flags = 0;
423
424 pr_debug("%s", __func__);
425 spin_lock_irqsave(&st_gdata->lock, flags);
426
427 switch (st_ll_getstate(st_gdata)) {
428 case ST_LL_AWAKE:
429 pr_debug("ST LL is AWAKE, sending normally");
430 skb_queue_tail(&st_gdata->txq, skb);
431 break;
432 case ST_LL_ASLEEP_TO_AWAKE:
433 skb_queue_tail(&st_gdata->tx_waitq, skb);
434 break;
435 case ST_LL_AWAKE_TO_ASLEEP:
436 pr_err("ST LL is illegal state(%ld),"
437 "purging received skb.", st_ll_getstate(st_gdata));
438 kfree_skb(skb);
439 break;
440 case ST_LL_ASLEEP:
441 skb_queue_tail(&st_gdata->tx_waitq, skb);
442 st_ll_wakeup(st_gdata);
443 break;
444 default:
445 pr_err("ST LL is illegal state(%ld),"
446 "purging received skb.", st_ll_getstate(st_gdata));
447 kfree_skb(skb);
448 break;
449 }
450
451 spin_unlock_irqrestore(&st_gdata->lock, flags);
452 pr_debug("done %s", __func__);
453 return;
454}
455
456/*
457 * internal wakeup function
458 * called from either
459 * - TTY layer when write's finished
460 * - st_write (in context of the protocol stack)
461 */
462static void work_fn_write_wakeup(struct work_struct *work)
463{
464 struct st_data_s *st_gdata = container_of(work, struct st_data_s,
465 work_write_wakeup);
466
467 st_tx_wakeup((void *)st_gdata);
468}
469void st_tx_wakeup(struct st_data_s *st_data)
470{
471 struct sk_buff *skb;
472 unsigned long flags; /* for irq save flags */
473 pr_debug("%s", __func__);
474 /* check for sending & set flag sending here */
475 if (test_and_set_bit(ST_TX_SENDING, &st_data->tx_state)) {
476 pr_debug("ST already sending");
477 /* keep sending */
478 set_bit(ST_TX_WAKEUP, &st_data->tx_state);
479 return;
480 /* TX_WAKEUP will be checked in another
481 * context
482 */
483 }
484 do { /* come back if st_tx_wakeup is set */
485 /* woke-up to write */
486 clear_bit(ST_TX_WAKEUP, &st_data->tx_state);
487 while ((skb = st_int_dequeue(st_data))) {
488 int len;
489 spin_lock_irqsave(&st_data->lock, flags);
490 /* enable wake-up from TTY */
491 set_bit(TTY_DO_WRITE_WAKEUP, &st_data->tty->flags);
492 len = st_int_write(st_data, skb->data, skb->len);
493 skb_pull(skb, len);
494 /* if skb->len = len as expected, skb->len=0 */
495 if (skb->len) {
496 /* would be the next skb to be sent */
497 st_data->tx_skb = skb;
498 spin_unlock_irqrestore(&st_data->lock, flags);
499 break;
500 }
501 kfree_skb(skb);
502 spin_unlock_irqrestore(&st_data->lock, flags);
503 }
504 /* if wake-up is set in another context- restart sending */
505 } while (test_bit(ST_TX_WAKEUP, &st_data->tx_state));
506
507 /* clear flag sending */
508 clear_bit(ST_TX_SENDING, &st_data->tx_state);
509}
510
511/********************************************************************/
512/* functions called from ST KIM
513*/
514void kim_st_list_protocols(struct st_data_s *st_gdata, void *buf)
515{
516 seq_printf(buf, "[%d]\nBT=%c\nFM=%c\nGPS=%c\n",
517 st_gdata->protos_registered,
518 st_gdata->is_registered[0x04] == true ? 'R' : 'U',
519 st_gdata->is_registered[0x08] == true ? 'R' : 'U',
520 st_gdata->is_registered[0x09] == true ? 'R' : 'U');
521}
522
523/********************************************************************/
524/*
525 * functions called from protocol stack drivers
526 * to be EXPORT-ed
527 */
528long st_register(struct st_proto_s *new_proto)
529{
530 struct st_data_s *st_gdata;
531 long err = 0;
532 unsigned long flags = 0;
533
534 st_kim_ref(&st_gdata, 0);
535 if (st_gdata == NULL || new_proto == NULL || new_proto->recv == NULL
536 || new_proto->reg_complete_cb == NULL) {
537 pr_err("gdata/new_proto/recv or reg_complete_cb not ready");
538 return -EINVAL;
539 }
540
541 if (new_proto->chnl_id >= ST_MAX_CHANNELS) {
542 pr_err("chnl_id %d not supported", new_proto->chnl_id);
543 return -EPROTONOSUPPORT;
544 }
545
546 if (st_gdata->is_registered[new_proto->chnl_id] == true) {
547 pr_err("chnl_id %d already registered", new_proto->chnl_id);
548 return -EALREADY;
549 }
550
551 /* can be from process context only */
552 spin_lock_irqsave(&st_gdata->lock, flags);
553
554 if (test_bit(ST_REG_IN_PROGRESS, &st_gdata->st_state)) {
555 pr_info(" ST_REG_IN_PROGRESS:%d ", new_proto->chnl_id);
556 /* fw download in progress */
557
558 add_channel_to_table(st_gdata, new_proto);
559 st_gdata->protos_registered++;
560 new_proto->write = st_write;
561
562 set_bit(ST_REG_PENDING, &st_gdata->st_state);
563 spin_unlock_irqrestore(&st_gdata->lock, flags);
564 return -EINPROGRESS;
565 } else if (st_gdata->protos_registered == ST_EMPTY) {
566 pr_info(" chnl_id list empty :%d ", new_proto->chnl_id);
567 set_bit(ST_REG_IN_PROGRESS, &st_gdata->st_state);
568 st_recv = st_kim_recv;
569
570 /* enable the ST LL - to set default chip state */
571 st_ll_enable(st_gdata);
572
573 /* release lock previously held - re-locked below */
574 spin_unlock_irqrestore(&st_gdata->lock, flags);
575
576 /*
577 * this may take a while to complete
578 * since it involves BT fw download
579 */
580 err = st_kim_start(st_gdata->kim_data);
581 if (err != 0) {
582 clear_bit(ST_REG_IN_PROGRESS, &st_gdata->st_state);
583 if ((st_gdata->protos_registered != ST_EMPTY) &&
584 (test_bit(ST_REG_PENDING, &st_gdata->st_state))) {
585 pr_err(" KIM failure complete callback ");
586 spin_lock_irqsave(&st_gdata->lock, flags);
587 st_reg_complete(st_gdata, err);
588 spin_unlock_irqrestore(&st_gdata->lock, flags);
589 clear_bit(ST_REG_PENDING, &st_gdata->st_state);
590 }
591 return -EINVAL;
592 }
593
594 spin_lock_irqsave(&st_gdata->lock, flags);
595
596 clear_bit(ST_REG_IN_PROGRESS, &st_gdata->st_state);
597 st_recv = st_int_recv;
598
599 /*
600 * this is where all pending registration
601 * are signalled to be complete by calling callback functions
602 */
603 if ((st_gdata->protos_registered != ST_EMPTY) &&
604 (test_bit(ST_REG_PENDING, &st_gdata->st_state))) {
605 pr_debug(" call reg complete callback ");
606 st_reg_complete(st_gdata, 0);
607 }
608 clear_bit(ST_REG_PENDING, &st_gdata->st_state);
609
610 /*
611 * check for already registered once more,
612 * since the above check is old
613 */
614 if (st_gdata->is_registered[new_proto->chnl_id] == true) {
615 pr_err(" proto %d already registered ",
616 new_proto->chnl_id);
617 spin_unlock_irqrestore(&st_gdata->lock, flags);
618 return -EALREADY;
619 }
620
621 add_channel_to_table(st_gdata, new_proto);
622 st_gdata->protos_registered++;
623 new_proto->write = st_write;
624 spin_unlock_irqrestore(&st_gdata->lock, flags);
625 return err;
626 }
627 /* if fw is already downloaded & new stack registers protocol */
628 else {
629 add_channel_to_table(st_gdata, new_proto);
630 st_gdata->protos_registered++;
631 new_proto->write = st_write;
632
633 /* lock already held before entering else */
634 spin_unlock_irqrestore(&st_gdata->lock, flags);
635 return err;
636 }
637}
638EXPORT_SYMBOL_GPL(st_register);
639
640/*
641 * to unregister a protocol -
642 * to be called from protocol stack driver
643 */
644long st_unregister(struct st_proto_s *proto)
645{
646 long err = 0;
647 unsigned long flags = 0;
648 struct st_data_s *st_gdata;
649
650 pr_debug("%s: %d ", __func__, proto->chnl_id);
651
652 st_kim_ref(&st_gdata, 0);
653 if (!st_gdata || proto->chnl_id >= ST_MAX_CHANNELS) {
654 pr_err(" chnl_id %d not supported", proto->chnl_id);
655 return -EPROTONOSUPPORT;
656 }
657
658 spin_lock_irqsave(&st_gdata->lock, flags);
659
660 if (st_gdata->is_registered[proto->chnl_id] == false) {
661 pr_err(" chnl_id %d not registered", proto->chnl_id);
662 spin_unlock_irqrestore(&st_gdata->lock, flags);
663 return -EPROTONOSUPPORT;
664 }
665
666 if (st_gdata->protos_registered)
667 st_gdata->protos_registered--;
668
669 remove_channel_from_table(st_gdata, proto);
670 spin_unlock_irqrestore(&st_gdata->lock, flags);
671
672 if ((st_gdata->protos_registered == ST_EMPTY) &&
673 (!test_bit(ST_REG_PENDING, &st_gdata->st_state))) {
674 pr_info(" all chnl_ids unregistered ");
675
676 /* stop traffic on tty */
677 if (st_gdata->tty) {
678 tty_ldisc_flush(st_gdata->tty);
679 stop_tty(st_gdata->tty);
680 }
681
682 /* all chnl_ids now unregistered */
683 st_kim_stop(st_gdata->kim_data);
684 /* disable ST LL */
685 st_ll_disable(st_gdata);
686 }
687 return err;
688}
689
690/*
691 * called in protocol stack drivers
692 * via the write function pointer
693 */
694long st_write(struct sk_buff *skb)
695{
696 struct st_data_s *st_gdata;
697 long len;
698
699 st_kim_ref(&st_gdata, 0);
700 if (unlikely(skb == NULL || st_gdata == NULL
701 || st_gdata->tty == NULL)) {
702 pr_err("data/tty unavailable to perform write");
703 return -EINVAL;
704 }
705
706 pr_debug("%d to be written", skb->len);
707 len = skb->len;
708
709 /* st_ll to decide where to enqueue the skb */
710 st_int_enqueue(st_gdata, skb);
711 /* wake up */
712 st_tx_wakeup(st_gdata);
713
714 /* return number of bytes written */
715 return len;
716}
717
718/* for protocols making use of shared transport */
719EXPORT_SYMBOL_GPL(st_unregister);
720
721/********************************************************************/
722/*
723 * functions called from TTY layer
724 */
725static int st_tty_open(struct tty_struct *tty)
726{
727 struct st_data_s *st_gdata;
728 pr_info("%s ", __func__);
729
730 st_kim_ref(&st_gdata, 0);
731 st_gdata->tty = tty;
732 tty->disc_data = st_gdata;
733
734 /* don't do an wakeup for now */
735 clear_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
736
737 /* mem already allocated
738 */
739 tty->receive_room = 65536;
740 /* Flush any pending characters in the driver and discipline. */
741 tty_ldisc_flush(tty);
742 tty_driver_flush_buffer(tty);
743 /*
744 * signal to UIM via KIM that -
745 * installation of N_TI_WL ldisc is complete
746 */
747 st_kim_complete(st_gdata->kim_data);
748 pr_debug("done %s", __func__);
749
750 return 0;
751}
752
753static void st_tty_close(struct tty_struct *tty)
754{
755 unsigned char i;
756 unsigned long flags;
757 struct st_data_s *st_gdata = tty->disc_data;
758
759 pr_info("%s ", __func__);
760
761 /*
762 * TODO:
763 * if a protocol has been registered & line discipline
764 * un-installed for some reason - what should be done ?
765 */
766 spin_lock_irqsave(&st_gdata->lock, flags);
767 for (i = ST_BT; i < ST_MAX_CHANNELS; i++) {
768 if (st_gdata->is_registered[i] == true)
769 pr_err("%d not un-registered", i);
770 st_gdata->list[i] = NULL;
771 st_gdata->is_registered[i] = false;
772 }
773 st_gdata->protos_registered = 0;
774 spin_unlock_irqrestore(&st_gdata->lock, flags);
775 /*
776 * signal to UIM via KIM that -
777 * N_TI_WL ldisc is un-installed
778 */
779 st_kim_complete(st_gdata->kim_data);
780 st_gdata->tty = NULL;
781 /* Flush any pending characters in the driver and discipline. */
782 tty_ldisc_flush(tty);
783 tty_driver_flush_buffer(tty);
784
785 spin_lock_irqsave(&st_gdata->lock, flags);
786 /* empty out txq and tx_waitq */
787 skb_queue_purge(&st_gdata->txq);
788 skb_queue_purge(&st_gdata->tx_waitq);
789 /* reset the TTY Rx states of ST */
790 st_gdata->rx_count = 0;
791 st_gdata->rx_state = ST_W4_PACKET_TYPE;
792 kfree_skb(st_gdata->rx_skb);
793 st_gdata->rx_skb = NULL;
794 spin_unlock_irqrestore(&st_gdata->lock, flags);
795
796 pr_debug("%s: done ", __func__);
797}
798
799static void st_tty_receive(struct tty_struct *tty, const unsigned char *data,
800 const char *tty_flags, int count)
801{
802#ifdef VERBOSE
803 print_hex_dump(KERN_DEBUG, ">in>", DUMP_PREFIX_NONE,
804 16, 1, data, count, 0);
805#endif
806
807 /*
808 * if fw download is in progress then route incoming data
809 * to KIM for validation
810 */
811 st_recv(tty->disc_data, data, count);
812 pr_debug("done %s", __func__);
813}
814
815/*
816 * wake-up function called in from the TTY layer
817 * inside the internal wakeup function will be called
818 */
819static void st_tty_wakeup(struct tty_struct *tty)
820{
821 struct st_data_s *st_gdata = tty->disc_data;
822 pr_debug("%s ", __func__);
823 /* don't do an wakeup for now */
824 clear_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
825
826 /*
827 * schedule the internal wakeup instead of calling directly to
828 * avoid lockup (port->lock needed in tty->ops->write is
829 * already taken here
830 */
831 schedule_work(&st_gdata->work_write_wakeup);
832}
833
834static void st_tty_flush_buffer(struct tty_struct *tty)
835{
836 struct st_data_s *st_gdata = tty->disc_data;
837 pr_debug("%s ", __func__);
838
839 kfree_skb(st_gdata->tx_skb);
840 st_gdata->tx_skb = NULL;
841
842 tty_driver_flush_buffer(tty);
843 return;
844}
845
846static struct tty_ldisc_ops st_ldisc_ops = {
847 .num = N_TI_WL,
848 .name = "n_st",
849 .open = st_tty_open,
850 .close = st_tty_close,
851 .receive_buf = st_tty_receive,
852 .write_wakeup = st_tty_wakeup,
853 .flush_buffer = st_tty_flush_buffer,
854 .owner = THIS_MODULE
855};
856
857/********************************************************************/
858int st_core_init(struct st_data_s **core_data)
859{
860 struct st_data_s *st_gdata;
861 long err;
862
863 err = tty_register_ldisc(&st_ldisc_ops);
864 if (err) {
865 pr_err("error registering %d line discipline %ld",
866 N_TI_WL, err);
867 return err;
868 }
869 pr_debug("registered n_shared line discipline");
870
871 st_gdata = kzalloc(sizeof(struct st_data_s), GFP_KERNEL);
872 if (!st_gdata) {
873 pr_err("memory allocation failed");
874 err = -ENOMEM;
875 goto err_unreg_ldisc;
876 }
877
878 /* Initialize ST TxQ and Tx waitQ queue head. All BT/FM/GPS module skb's
879 * will be pushed in this queue for actual transmission.
880 */
881 skb_queue_head_init(&st_gdata->txq);
882 skb_queue_head_init(&st_gdata->tx_waitq);
883
884 /* Locking used in st_int_enqueue() to avoid multiple execution */
885 spin_lock_init(&st_gdata->lock);
886
887 err = st_ll_init(st_gdata);
888 if (err) {
889 pr_err("error during st_ll initialization(%ld)", err);
890 goto err_free_gdata;
891 }
892
893 INIT_WORK(&st_gdata->work_write_wakeup, work_fn_write_wakeup);
894
895 *core_data = st_gdata;
896 return 0;
897err_free_gdata:
898 kfree(st_gdata);
899err_unreg_ldisc:
900 tty_unregister_ldisc(&st_ldisc_ops);
901 return err;
902}
903
904void st_core_exit(struct st_data_s *st_gdata)
905{
906 long err;
907 /* internal module cleanup */
908 err = st_ll_deinit(st_gdata);
909 if (err)
910 pr_err("error during deinit of ST LL %ld", err);
911
912 if (st_gdata != NULL) {
913 /* Free ST Tx Qs and skbs */
914 skb_queue_purge(&st_gdata->txq);
915 skb_queue_purge(&st_gdata->tx_waitq);
916 kfree_skb(st_gdata->rx_skb);
917 kfree_skb(st_gdata->tx_skb);
918 /* TTY ldisc cleanup */
919 tty_unregister_ldisc(&st_ldisc_ops);
920 /* free the global data pointer */
921 kfree(st_gdata);
922 }
923}