Linux Audio

Check our new training course

Loading...
v4.6
  1/*
  2 *  Shared Transport Line discipline driver Core
  3 *	Init Manager module responsible for GPIO control
  4 *	and firmware download
  5 *  Copyright (C) 2009-2010 Texas Instruments
  6 *  Author: Pavan Savoy <pavan_savoy@ti.com>
  7 *
  8 *  This program is free software; you can redistribute it and/or modify
  9 *  it under the terms of the GNU General Public License version 2 as
 10 *  published by the Free Software Foundation.
 11 *
 12 *  This program is distributed in the hope that it will be useful,
 13 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 14 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 15 *  GNU General Public License for more details.
 16 *
 17 *  You should have received a copy of the GNU General Public License
 18 *  along with this program; if not, write to the Free Software
 19 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 20 *
 21 */
 22
 23#define pr_fmt(fmt) "(stk) :" fmt
 24#include <linux/platform_device.h>
 25#include <linux/jiffies.h>
 26#include <linux/firmware.h>
 27#include <linux/delay.h>
 28#include <linux/wait.h>
 29#include <linux/gpio.h>
 30#include <linux/debugfs.h>
 31#include <linux/seq_file.h>
 32#include <linux/sched.h>
 33#include <linux/sysfs.h>
 34#include <linux/tty.h>
 35
 36#include <linux/skbuff.h>
 37#include <linux/ti_wilink_st.h>
 38#include <linux/module.h>
 39
 
 40#define MAX_ST_DEVICES	3	/* Imagine 1 on each UART for now */
 41static struct platform_device *st_kim_devices[MAX_ST_DEVICES];
 42
 43/**********************************************************************/
 44/* internal functions */
 45
 46/**
 47 * st_get_plat_device -
 48 *	function which returns the reference to the platform device
 49 *	requested by id. As of now only 1 such device exists (id=0)
 50 *	the context requesting for reference can get the id to be
 51 *	requested by a. The protocol driver which is registering or
 52 *	b. the tty device which is opened.
 53 */
 54static struct platform_device *st_get_plat_device(int id)
 55{
 56	return st_kim_devices[id];
 57}
 58
 59/**
 60 * validate_firmware_response -
 61 *	function to return whether the firmware response was proper
 62 *	in case of error don't complete so that waiting for proper
 63 *	response times out
 64 */
 65static void validate_firmware_response(struct kim_data_s *kim_gdata)
 66{
 67	struct sk_buff *skb = kim_gdata->rx_skb;
 68	if (!skb)
 69		return;
 70
 71	/* these magic numbers are the position in the response buffer which
 72	 * allows us to distinguish whether the response is for the read
 73	 * version info. command
 74	 */
 75	if (skb->data[2] == 0x01 && skb->data[3] == 0x01 &&
 76			skb->data[4] == 0x10 && skb->data[5] == 0x00) {
 77		/* fw version response */
 78		memcpy(kim_gdata->resp_buffer,
 79				kim_gdata->rx_skb->data,
 80				kim_gdata->rx_skb->len);
 81		complete_all(&kim_gdata->kim_rcvd);
 82		kim_gdata->rx_state = ST_W4_PACKET_TYPE;
 83		kim_gdata->rx_skb = NULL;
 84		kim_gdata->rx_count = 0;
 85	} else if (unlikely(skb->data[5] != 0)) {
 86		pr_err("no proper response during fw download");
 87		pr_err("data6 %x", skb->data[5]);
 88		kfree_skb(skb);
 89		return;		/* keep waiting for the proper response */
 90	}
 91	/* becos of all the script being downloaded */
 92	complete_all(&kim_gdata->kim_rcvd);
 93	kfree_skb(skb);
 94}
 95
 96/* check for data len received inside kim_int_recv
 97 * most often hit the last case to update state to waiting for data
 98 */
 99static inline int kim_check_data_len(struct kim_data_s *kim_gdata, int len)
100{
101	register int room = skb_tailroom(kim_gdata->rx_skb);
102
103	pr_debug("len %d room %d", len, room);
104
105	if (!len) {
106		validate_firmware_response(kim_gdata);
107	} else if (len > room) {
108		/* Received packet's payload length is larger.
109		 * We can't accommodate it in created skb.
110		 */
111		pr_err("Data length is too large len %d room %d", len,
112			   room);
113		kfree_skb(kim_gdata->rx_skb);
114	} else {
115		/* Packet header has non-zero payload length and
116		 * we have enough space in created skb. Lets read
117		 * payload data */
118		kim_gdata->rx_state = ST_W4_DATA;
119		kim_gdata->rx_count = len;
120		return len;
121	}
122
123	/* Change ST LL state to continue to process next
124	 * packet */
125	kim_gdata->rx_state = ST_W4_PACKET_TYPE;
126	kim_gdata->rx_skb = NULL;
127	kim_gdata->rx_count = 0;
128
129	return 0;
130}
131
132/**
133 * kim_int_recv - receive function called during firmware download
134 *	firmware download responses on different UART drivers
135 *	have been observed to come in bursts of different
136 *	tty_receive and hence the logic
137 */
138static void kim_int_recv(struct kim_data_s *kim_gdata,
139	const unsigned char *data, long count)
140{
141	const unsigned char *ptr;
142	int len = 0, type = 0;
143	unsigned char *plen;
144
145	pr_debug("%s", __func__);
146	/* Decode received bytes here */
147	ptr = data;
148	if (unlikely(ptr == NULL)) {
149		pr_err(" received null from TTY ");
150		return;
151	}
152
153	while (count) {
154		if (kim_gdata->rx_count) {
155			len = min_t(unsigned int, kim_gdata->rx_count, count);
156			memcpy(skb_put(kim_gdata->rx_skb, len), ptr, len);
157			kim_gdata->rx_count -= len;
158			count -= len;
159			ptr += len;
160
161			if (kim_gdata->rx_count)
162				continue;
163
164			/* Check ST RX state machine , where are we? */
165			switch (kim_gdata->rx_state) {
166				/* Waiting for complete packet ? */
167			case ST_W4_DATA:
168				pr_debug("Complete pkt received");
169				validate_firmware_response(kim_gdata);
170				kim_gdata->rx_state = ST_W4_PACKET_TYPE;
171				kim_gdata->rx_skb = NULL;
172				continue;
173				/* Waiting for Bluetooth event header ? */
174			case ST_W4_HEADER:
175				plen =
176				(unsigned char *)&kim_gdata->rx_skb->data[1];
177				pr_debug("event hdr: plen 0x%02x\n", *plen);
178				kim_check_data_len(kim_gdata, *plen);
179				continue;
180			}	/* end of switch */
181		}		/* end of if rx_state */
182		switch (*ptr) {
183			/* Bluetooth event packet? */
184		case 0x04:
185			kim_gdata->rx_state = ST_W4_HEADER;
186			kim_gdata->rx_count = 2;
187			type = *ptr;
188			break;
189		default:
190			pr_info("unknown packet");
191			ptr++;
192			count--;
193			continue;
194		}
195		ptr++;
196		count--;
197		kim_gdata->rx_skb =
198			alloc_skb(1024+8, GFP_ATOMIC);
199		if (!kim_gdata->rx_skb) {
200			pr_err("can't allocate mem for new packet");
201			kim_gdata->rx_state = ST_W4_PACKET_TYPE;
202			kim_gdata->rx_count = 0;
203			return;
204		}
205		skb_reserve(kim_gdata->rx_skb, 8);
206		kim_gdata->rx_skb->cb[0] = 4;
207		kim_gdata->rx_skb->cb[1] = 0;
208
209	}
210	return;
211}
212
213static long read_local_version(struct kim_data_s *kim_gdata, char *bts_scr_name)
214{
215	unsigned short version = 0, chip = 0, min_ver = 0, maj_ver = 0;
216	const char read_ver_cmd[] = { 0x01, 0x01, 0x10, 0x00 };
217	long timeout;
218
219	pr_debug("%s", __func__);
220
221	reinit_completion(&kim_gdata->kim_rcvd);
222	if (4 != st_int_write(kim_gdata->core_data, read_ver_cmd, 4)) {
223		pr_err("kim: couldn't write 4 bytes");
224		return -EIO;
225	}
226
227	timeout = wait_for_completion_interruptible_timeout(
228		&kim_gdata->kim_rcvd, msecs_to_jiffies(CMD_RESP_TIME));
229	if (timeout <= 0) {
230		pr_err(" waiting for ver info- timed out or received signal");
231		return timeout ? -ERESTARTSYS : -ETIMEDOUT;
232	}
233	reinit_completion(&kim_gdata->kim_rcvd);
234	/* the positions 12 & 13 in the response buffer provide with the
235	 * chip, major & minor numbers
236	 */
237
238	version =
239		MAKEWORD(kim_gdata->resp_buffer[12],
240				kim_gdata->resp_buffer[13]);
241	chip = (version & 0x7C00) >> 10;
242	min_ver = (version & 0x007F);
243	maj_ver = (version & 0x0380) >> 7;
244
245	if (version & 0x8000)
246		maj_ver |= 0x0008;
247
248	sprintf(bts_scr_name, "ti-connectivity/TIInit_%d.%d.%d.bts",
249		chip, maj_ver, min_ver);
250
251	/* to be accessed later via sysfs entry */
252	kim_gdata->version.full = version;
253	kim_gdata->version.chip = chip;
254	kim_gdata->version.maj_ver = maj_ver;
255	kim_gdata->version.min_ver = min_ver;
256
257	pr_info("%s", bts_scr_name);
258	return 0;
259}
260
261static void skip_change_remote_baud(unsigned char **ptr, long *len)
262{
263	unsigned char *nxt_action, *cur_action;
264	cur_action = *ptr;
265
266	nxt_action = cur_action + sizeof(struct bts_action) +
267		((struct bts_action *) cur_action)->size;
268
269	if (((struct bts_action *) nxt_action)->type != ACTION_WAIT_EVENT) {
270		pr_err("invalid action after change remote baud command");
271	} else {
272		*ptr = *ptr + sizeof(struct bts_action) +
273			((struct bts_action *)cur_action)->size;
274		*len = *len - (sizeof(struct bts_action) +
275				((struct bts_action *)cur_action)->size);
276		/* warn user on not commenting these in firmware */
277		pr_warn("skipping the wait event of change remote baud");
278	}
279}
280
281/**
282 * download_firmware -
283 *	internal function which parses through the .bts firmware
284 *	script file intreprets SEND, DELAY actions only as of now
285 */
286static long download_firmware(struct kim_data_s *kim_gdata)
287{
288	long err = 0;
289	long len = 0;
290	unsigned char *ptr = NULL;
291	unsigned char *action_ptr = NULL;
292	unsigned char bts_scr_name[40] = { 0 };	/* 40 char long bts scr name? */
293	int wr_room_space;
294	int cmd_size;
295	unsigned long timeout;
296
297	err = read_local_version(kim_gdata, bts_scr_name);
298	if (err != 0) {
299		pr_err("kim: failed to read local ver");
300		return err;
301	}
302	err =
303	    request_firmware(&kim_gdata->fw_entry, bts_scr_name,
304			     &kim_gdata->kim_pdev->dev);
305	if (unlikely((err != 0) || (kim_gdata->fw_entry->data == NULL) ||
306		     (kim_gdata->fw_entry->size == 0))) {
307		pr_err(" request_firmware failed(errno %ld) for %s", err,
308			   bts_scr_name);
309		return -EINVAL;
310	}
311	ptr = (void *)kim_gdata->fw_entry->data;
312	len = kim_gdata->fw_entry->size;
313	/* bts_header to remove out magic number and
314	 * version
315	 */
316	ptr += sizeof(struct bts_header);
317	len -= sizeof(struct bts_header);
318
319	while (len > 0 && ptr) {
320		pr_debug(" action size %d, type %d ",
321			   ((struct bts_action *)ptr)->size,
322			   ((struct bts_action *)ptr)->type);
323
324		switch (((struct bts_action *)ptr)->type) {
325		case ACTION_SEND_COMMAND:	/* action send */
326			pr_debug("S");
327			action_ptr = &(((struct bts_action *)ptr)->data[0]);
328			if (unlikely
329			    (((struct hci_command *)action_ptr)->opcode ==
330			     0xFF36)) {
331				/* ignore remote change
332				 * baud rate HCI VS command */
333				pr_warn("change remote baud"
334				    " rate command in firmware");
335				skip_change_remote_baud(&ptr, &len);
336				break;
337			}
338			/*
339			 * Make sure we have enough free space in uart
340			 * tx buffer to write current firmware command
341			 */
342			cmd_size = ((struct bts_action *)ptr)->size;
343			timeout = jiffies + msecs_to_jiffies(CMD_WR_TIME);
344			do {
345				wr_room_space =
346					st_get_uart_wr_room(kim_gdata->core_data);
347				if (wr_room_space < 0) {
348					pr_err("Unable to get free "
349							"space info from uart tx buffer");
350					release_firmware(kim_gdata->fw_entry);
351					return wr_room_space;
352				}
353				mdelay(1); /* wait 1ms before checking room */
354			} while ((wr_room_space < cmd_size) &&
355					time_before(jiffies, timeout));
356
357			/* Timeout happened ? */
358			if (time_after_eq(jiffies, timeout)) {
359				pr_err("Timeout while waiting for free "
360						"free space in uart tx buffer");
361				release_firmware(kim_gdata->fw_entry);
362				return -ETIMEDOUT;
363			}
364			/* reinit completion before sending for the
365			 * relevant wait
366			 */
367			reinit_completion(&kim_gdata->kim_rcvd);
368
369			/*
370			 * Free space found in uart buffer, call st_int_write
371			 * to send current firmware command to the uart tx
372			 * buffer.
373			 */
374			err = st_int_write(kim_gdata->core_data,
375			((struct bts_action_send *)action_ptr)->data,
376					   ((struct bts_action *)ptr)->size);
377			if (unlikely(err < 0)) {
378				release_firmware(kim_gdata->fw_entry);
379				return err;
380			}
381			/*
382			 * Check number of bytes written to the uart tx buffer
383			 * and requested command write size
384			 */
385			if (err != cmd_size) {
386				pr_err("Number of bytes written to uart "
387						"tx buffer are not matching with "
388						"requested cmd write size");
389				release_firmware(kim_gdata->fw_entry);
390				return -EIO;
391			}
392			break;
393		case ACTION_WAIT_EVENT:  /* wait */
394			pr_debug("W");
395			err = wait_for_completion_interruptible_timeout(
396					&kim_gdata->kim_rcvd,
397					msecs_to_jiffies(CMD_RESP_TIME));
398			if (err <= 0) {
399				pr_err("response timeout/signaled during fw download ");
400				/* timed out */
401				release_firmware(kim_gdata->fw_entry);
402				return err ? -ERESTARTSYS : -ETIMEDOUT;
403			}
404			reinit_completion(&kim_gdata->kim_rcvd);
405			break;
406		case ACTION_DELAY:	/* sleep */
407			pr_info("sleep command in scr");
408			action_ptr = &(((struct bts_action *)ptr)->data[0]);
409			mdelay(((struct bts_action_delay *)action_ptr)->msec);
410			break;
411		}
412		len =
413		    len - (sizeof(struct bts_action) +
414			   ((struct bts_action *)ptr)->size);
415		ptr =
416		    ptr + sizeof(struct bts_action) +
417		    ((struct bts_action *)ptr)->size;
418	}
419	/* fw download complete */
420	release_firmware(kim_gdata->fw_entry);
421	return 0;
422}
423
424/**********************************************************************/
425/* functions called from ST core */
426/* called from ST Core, when REG_IN_PROGRESS (registration in progress)
427 * can be because of
428 * 1. response to read local version
429 * 2. during send/recv's of firmware download
430 */
431void st_kim_recv(void *disc_data, const unsigned char *data, long count)
432{
433	struct st_data_s	*st_gdata = (struct st_data_s *)disc_data;
434	struct kim_data_s	*kim_gdata = st_gdata->kim_data;
435
436	/* proceed to gather all data and distinguish read fw version response
437	 * from other fw responses when data gathering is complete
438	 */
439	kim_int_recv(kim_gdata, data, count);
 
 
 
 
 
 
440	return;
441}
442
443/* to signal completion of line discipline installation
444 * called from ST Core, upon tty_open
445 */
446void st_kim_complete(void *kim_data)
447{
448	struct kim_data_s	*kim_gdata = (struct kim_data_s *)kim_data;
449	complete(&kim_gdata->ldisc_installed);
450}
451
452/**
453 * st_kim_start - called from ST Core upon 1st registration
454 *	This involves toggling the chip enable gpio, reading
455 *	the firmware version from chip, forming the fw file name
456 *	based on the chip version, requesting the fw, parsing it
457 *	and perform download(send/recv).
458 */
459long st_kim_start(void *kim_data)
460{
461	long err = 0;
462	long retry = POR_RETRY_COUNT;
463	struct ti_st_plat_data	*pdata;
464	struct kim_data_s	*kim_gdata = (struct kim_data_s *)kim_data;
465
466	pr_info(" %s", __func__);
467	pdata = kim_gdata->kim_pdev->dev.platform_data;
468
469	do {
470		/* platform specific enabling code here */
471		if (pdata->chip_enable)
472			pdata->chip_enable(kim_gdata);
473
474		/* Configure BT nShutdown to HIGH state */
475		gpio_set_value_cansleep(kim_gdata->nshutdown, GPIO_LOW);
476		mdelay(5);	/* FIXME: a proper toggle */
477		gpio_set_value_cansleep(kim_gdata->nshutdown, GPIO_HIGH);
478		mdelay(100);
479		/* re-initialize the completion */
480		reinit_completion(&kim_gdata->ldisc_installed);
481		/* send notification to UIM */
482		kim_gdata->ldisc_install = 1;
483		pr_info("ldisc_install = 1");
484		sysfs_notify(&kim_gdata->kim_pdev->dev.kobj,
485				NULL, "install");
486		/* wait for ldisc to be installed */
487		err = wait_for_completion_interruptible_timeout(
488			&kim_gdata->ldisc_installed, msecs_to_jiffies(LDISC_TIME));
489		if (!err) {
490			/* ldisc installation timeout,
491			 * flush uart, power cycle BT_EN */
492			pr_err("ldisc installation timeout");
493			err = st_kim_stop(kim_gdata);
494			continue;
495		} else {
496			/* ldisc installed now */
497			pr_info("line discipline installed");
498			err = download_firmware(kim_gdata);
499			if (err != 0) {
500				/* ldisc installed but fw download failed,
501				 * flush uart & power cycle BT_EN */
502				pr_err("download firmware failed");
503				err = st_kim_stop(kim_gdata);
504				continue;
505			} else {	/* on success don't retry */
506				break;
507			}
508		}
509	} while (retry--);
510	return err;
511}
512
513/**
514 * st_kim_stop - stop communication with chip.
515 *	This can be called from ST Core/KIM, on the-
516 *	(a) last un-register when chip need not be powered there-after,
517 *	(b) upon failure to either install ldisc or download firmware.
518 *	The function is responsible to (a) notify UIM about un-installation,
519 *	(b) flush UART if the ldisc was installed.
520 *	(c) reset BT_EN - pull down nshutdown at the end.
521 *	(d) invoke platform's chip disabling routine.
522 */
523long st_kim_stop(void *kim_data)
524{
525	long err = 0;
526	struct kim_data_s	*kim_gdata = (struct kim_data_s *)kim_data;
527	struct ti_st_plat_data	*pdata =
528		kim_gdata->kim_pdev->dev.platform_data;
529	struct tty_struct	*tty = kim_gdata->core_data->tty;
530
531	reinit_completion(&kim_gdata->ldisc_installed);
532
533	if (tty) {	/* can be called before ldisc is installed */
534		/* Flush any pending characters in the driver and discipline. */
535		tty_ldisc_flush(tty);
536		tty_driver_flush_buffer(tty);
 
537	}
538
539	/* send uninstall notification to UIM */
540	pr_info("ldisc_install = 0");
541	kim_gdata->ldisc_install = 0;
542	sysfs_notify(&kim_gdata->kim_pdev->dev.kobj, NULL, "install");
543
544	/* wait for ldisc to be un-installed */
545	err = wait_for_completion_interruptible_timeout(
546		&kim_gdata->ldisc_installed, msecs_to_jiffies(LDISC_TIME));
547	if (!err) {		/* timeout */
548		pr_err(" timed out waiting for ldisc to be un-installed");
549		err = -ETIMEDOUT;
550	}
551
552	/* By default configure BT nShutdown to LOW state */
553	gpio_set_value_cansleep(kim_gdata->nshutdown, GPIO_LOW);
554	mdelay(1);
555	gpio_set_value_cansleep(kim_gdata->nshutdown, GPIO_HIGH);
556	mdelay(1);
557	gpio_set_value_cansleep(kim_gdata->nshutdown, GPIO_LOW);
558
559	/* platform specific disable */
560	if (pdata->chip_disable)
561		pdata->chip_disable(kim_gdata);
562	return err;
563}
564
565/**********************************************************************/
566/* functions called from subsystems */
567/* called when debugfs entry is read from */
568
569static int show_version(struct seq_file *s, void *unused)
570{
571	struct kim_data_s *kim_gdata = (struct kim_data_s *)s->private;
572	seq_printf(s, "%04X %d.%d.%d\n", kim_gdata->version.full,
573			kim_gdata->version.chip, kim_gdata->version.maj_ver,
574			kim_gdata->version.min_ver);
575	return 0;
576}
577
578static int show_list(struct seq_file *s, void *unused)
579{
580	struct kim_data_s *kim_gdata = (struct kim_data_s *)s->private;
581	kim_st_list_protocols(kim_gdata->core_data, s);
582	return 0;
583}
584
585static ssize_t show_install(struct device *dev,
586		struct device_attribute *attr, char *buf)
587{
588	struct kim_data_s *kim_data = dev_get_drvdata(dev);
589	return sprintf(buf, "%d\n", kim_data->ldisc_install);
590}
591
592#ifdef DEBUG
593static ssize_t store_dev_name(struct device *dev,
594		struct device_attribute *attr, const char *buf, size_t count)
595{
596	struct kim_data_s *kim_data = dev_get_drvdata(dev);
597	pr_debug("storing dev name >%s<", buf);
598	strncpy(kim_data->dev_name, buf, count);
599	pr_debug("stored dev name >%s<", kim_data->dev_name);
600	return count;
601}
602
603static ssize_t store_baud_rate(struct device *dev,
604		struct device_attribute *attr, const char *buf, size_t count)
605{
606	struct kim_data_s *kim_data = dev_get_drvdata(dev);
607	pr_debug("storing baud rate >%s<", buf);
608	sscanf(buf, "%ld", &kim_data->baud_rate);
609	pr_debug("stored baud rate >%ld<", kim_data->baud_rate);
610	return count;
611}
612#endif	/* if DEBUG */
613
614static ssize_t show_dev_name(struct device *dev,
615		struct device_attribute *attr, char *buf)
616{
617	struct kim_data_s *kim_data = dev_get_drvdata(dev);
618	return sprintf(buf, "%s\n", kim_data->dev_name);
619}
620
621static ssize_t show_baud_rate(struct device *dev,
622		struct device_attribute *attr, char *buf)
623{
624	struct kim_data_s *kim_data = dev_get_drvdata(dev);
625	return sprintf(buf, "%d\n", kim_data->baud_rate);
626}
627
628static ssize_t show_flow_cntrl(struct device *dev,
629		struct device_attribute *attr, char *buf)
630{
631	struct kim_data_s *kim_data = dev_get_drvdata(dev);
632	return sprintf(buf, "%d\n", kim_data->flow_cntrl);
633}
634
635/* structures specific for sysfs entries */
636static struct kobj_attribute ldisc_install =
637__ATTR(install, 0444, (void *)show_install, NULL);
638
639static struct kobj_attribute uart_dev_name =
640#ifdef DEBUG	/* TODO: move this to debug-fs if possible */
641__ATTR(dev_name, 0644, (void *)show_dev_name, (void *)store_dev_name);
642#else
643__ATTR(dev_name, 0444, (void *)show_dev_name, NULL);
644#endif
645
646static struct kobj_attribute uart_baud_rate =
647#ifdef DEBUG	/* TODO: move to debugfs */
648__ATTR(baud_rate, 0644, (void *)show_baud_rate, (void *)store_baud_rate);
649#else
650__ATTR(baud_rate, 0444, (void *)show_baud_rate, NULL);
651#endif
652
653static struct kobj_attribute uart_flow_cntrl =
654__ATTR(flow_cntrl, 0444, (void *)show_flow_cntrl, NULL);
655
656static struct attribute *uim_attrs[] = {
657	&ldisc_install.attr,
658	&uart_dev_name.attr,
659	&uart_baud_rate.attr,
660	&uart_flow_cntrl.attr,
661	NULL,
662};
663
664static struct attribute_group uim_attr_grp = {
665	.attrs = uim_attrs,
666};
667
668/**
669 * st_kim_ref - reference the core's data
670 *	This references the per-ST platform device in the arch/xx/
671 *	board-xx.c file.
672 *	This would enable multiple such platform devices to exist
673 *	on a given platform
674 */
675void st_kim_ref(struct st_data_s **core_data, int id)
676{
677	struct platform_device	*pdev;
678	struct kim_data_s	*kim_gdata;
679	/* get kim_gdata reference from platform device */
680	pdev = st_get_plat_device(id);
681	if (!pdev)
682		goto err;
683	kim_gdata = platform_get_drvdata(pdev);
684	if (!kim_gdata)
685		goto err;
686
687	*core_data = kim_gdata->core_data;
688	return;
689err:
690	*core_data = NULL;
691}
692
693static int kim_version_open(struct inode *i, struct file *f)
694{
695	return single_open(f, show_version, i->i_private);
696}
697
698static int kim_list_open(struct inode *i, struct file *f)
699{
700	return single_open(f, show_list, i->i_private);
701}
702
703static const struct file_operations version_debugfs_fops = {
704	/* version info */
705	.open = kim_version_open,
706	.read = seq_read,
707	.llseek = seq_lseek,
708	.release = single_release,
709};
710static const struct file_operations list_debugfs_fops = {
711	/* protocols info */
712	.open = kim_list_open,
713	.read = seq_read,
714	.llseek = seq_lseek,
715	.release = single_release,
716};
717
718/**********************************************************************/
719/* functions called from platform device driver subsystem
720 * need to have a relevant platform device entry in the platform's
721 * board-*.c file
722 */
723
724static struct dentry *kim_debugfs_dir;
725static int kim_probe(struct platform_device *pdev)
726{
 
727	struct kim_data_s	*kim_gdata;
728	struct ti_st_plat_data	*pdata = pdev->dev.platform_data;
729	int err;
730
731	if ((pdev->id != -1) && (pdev->id < MAX_ST_DEVICES)) {
732		/* multiple devices could exist */
733		st_kim_devices[pdev->id] = pdev;
734	} else {
735		/* platform's sure about existence of 1 device */
736		st_kim_devices[0] = pdev;
737	}
738
739	kim_gdata = kzalloc(sizeof(struct kim_data_s), GFP_ATOMIC);
740	if (!kim_gdata) {
741		pr_err("no mem to allocate");
742		return -ENOMEM;
743	}
744	platform_set_drvdata(pdev, kim_gdata);
745
746	err = st_core_init(&kim_gdata->core_data);
747	if (err != 0) {
748		pr_err(" ST core init failed");
749		err = -EIO;
750		goto err_core_init;
751	}
752	/* refer to itself */
753	kim_gdata->core_data->kim_data = kim_gdata;
754
755	/* Claim the chip enable nShutdown gpio from the system */
756	kim_gdata->nshutdown = pdata->nshutdown_gpio;
757	err = gpio_request(kim_gdata->nshutdown, "kim");
758	if (unlikely(err)) {
759		pr_err(" gpio %d request failed ", kim_gdata->nshutdown);
760		return err;
761	}
762
763	/* Configure nShutdown GPIO as output=0 */
764	err = gpio_direction_output(kim_gdata->nshutdown, 0);
765	if (unlikely(err)) {
766		pr_err(" unable to configure gpio %d", kim_gdata->nshutdown);
767		return err;
768	}
769	/* get reference of pdev for request_firmware
770	 */
771	kim_gdata->kim_pdev = pdev;
772	init_completion(&kim_gdata->kim_rcvd);
773	init_completion(&kim_gdata->ldisc_installed);
774
775	err = sysfs_create_group(&pdev->dev.kobj, &uim_attr_grp);
776	if (err) {
777		pr_err("failed to create sysfs entries");
778		goto err_sysfs_group;
779	}
780
781	/* copying platform data */
782	strncpy(kim_gdata->dev_name, pdata->dev_name, UART_DEV_NAME_LEN);
783	kim_gdata->flow_cntrl = pdata->flow_cntrl;
784	kim_gdata->baud_rate = pdata->baud_rate;
785	pr_info("sysfs entries created\n");
786
787	kim_debugfs_dir = debugfs_create_dir("ti-st", NULL);
788	if (!kim_debugfs_dir) {
789		pr_err(" debugfs entries creation failed ");
790		return 0;
 
791	}
792
793	debugfs_create_file("version", S_IRUGO, kim_debugfs_dir,
794				kim_gdata, &version_debugfs_fops);
795	debugfs_create_file("protocols", S_IRUGO, kim_debugfs_dir,
796				kim_gdata, &list_debugfs_fops);
 
797	return 0;
798
799err_sysfs_group:
800	st_core_exit(kim_gdata->core_data);
801
802err_core_init:
803	kfree(kim_gdata);
804
805	return err;
806}
807
808static int kim_remove(struct platform_device *pdev)
809{
810	/* free the GPIOs requested */
811	struct ti_st_plat_data	*pdata = pdev->dev.platform_data;
812	struct kim_data_s	*kim_gdata;
813
814	kim_gdata = platform_get_drvdata(pdev);
815
816	/* Free the Bluetooth/FM/GPIO
817	 * nShutdown gpio from the system
818	 */
819	gpio_free(pdata->nshutdown_gpio);
820	pr_info("nshutdown GPIO Freed");
821
822	debugfs_remove_recursive(kim_debugfs_dir);
823	sysfs_remove_group(&pdev->dev.kobj, &uim_attr_grp);
824	pr_info("sysfs entries removed");
825
826	kim_gdata->kim_pdev = NULL;
827	st_core_exit(kim_gdata->core_data);
828
829	kfree(kim_gdata);
830	kim_gdata = NULL;
831	return 0;
832}
833
834static int kim_suspend(struct platform_device *pdev, pm_message_t state)
835{
836	struct ti_st_plat_data	*pdata = pdev->dev.platform_data;
837
838	if (pdata->suspend)
839		return pdata->suspend(pdev, state);
840
841	return 0;
842}
843
844static int kim_resume(struct platform_device *pdev)
845{
846	struct ti_st_plat_data	*pdata = pdev->dev.platform_data;
847
848	if (pdata->resume)
849		return pdata->resume(pdev);
850
851	return 0;
852}
853
854/**********************************************************************/
855/* entry point for ST KIM module, called in from ST Core */
856static struct platform_driver kim_platform_driver = {
857	.probe = kim_probe,
858	.remove = kim_remove,
859	.suspend = kim_suspend,
860	.resume = kim_resume,
861	.driver = {
862		.name = "kim",
 
863	},
864};
865
866module_platform_driver(kim_platform_driver);
867
868MODULE_AUTHOR("Pavan Savoy <pavan_savoy@ti.com>");
869MODULE_DESCRIPTION("Shared Transport Driver for TI BT/FM/GPS combo chips ");
870MODULE_LICENSE("GPL");
v3.5.6
  1/*
  2 *  Shared Transport Line discipline driver Core
  3 *	Init Manager module responsible for GPIO control
  4 *	and firmware download
  5 *  Copyright (C) 2009-2010 Texas Instruments
  6 *  Author: Pavan Savoy <pavan_savoy@ti.com>
  7 *
  8 *  This program is free software; you can redistribute it and/or modify
  9 *  it under the terms of the GNU General Public License version 2 as
 10 *  published by the Free Software Foundation.
 11 *
 12 *  This program is distributed in the hope that it will be useful,
 13 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 14 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 15 *  GNU General Public License for more details.
 16 *
 17 *  You should have received a copy of the GNU General Public License
 18 *  along with this program; if not, write to the Free Software
 19 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 20 *
 21 */
 22
 23#define pr_fmt(fmt) "(stk) :" fmt
 24#include <linux/platform_device.h>
 25#include <linux/jiffies.h>
 26#include <linux/firmware.h>
 27#include <linux/delay.h>
 28#include <linux/wait.h>
 29#include <linux/gpio.h>
 30#include <linux/debugfs.h>
 31#include <linux/seq_file.h>
 32#include <linux/sched.h>
 33#include <linux/sysfs.h>
 34#include <linux/tty.h>
 35
 36#include <linux/skbuff.h>
 37#include <linux/ti_wilink_st.h>
 38#include <linux/module.h>
 39
 40
 41#define MAX_ST_DEVICES	3	/* Imagine 1 on each UART for now */
 42static struct platform_device *st_kim_devices[MAX_ST_DEVICES];
 43
 44/**********************************************************************/
 45/* internal functions */
 46
 47/**
 48 * st_get_plat_device -
 49 *	function which returns the reference to the platform device
 50 *	requested by id. As of now only 1 such device exists (id=0)
 51 *	the context requesting for reference can get the id to be
 52 *	requested by a. The protocol driver which is registering or
 53 *	b. the tty device which is opened.
 54 */
 55static struct platform_device *st_get_plat_device(int id)
 56{
 57	return st_kim_devices[id];
 58}
 59
 60/**
 61 * validate_firmware_response -
 62 *	function to return whether the firmware response was proper
 63 *	in case of error don't complete so that waiting for proper
 64 *	response times out
 65 */
 66void validate_firmware_response(struct kim_data_s *kim_gdata)
 67{
 68	struct sk_buff *skb = kim_gdata->rx_skb;
 69	if (unlikely(skb->data[5] != 0)) {
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 70		pr_err("no proper response during fw download");
 71		pr_err("data6 %x", skb->data[5]);
 72		kfree_skb(skb);
 73		return;		/* keep waiting for the proper response */
 74	}
 75	/* becos of all the script being downloaded */
 76	complete_all(&kim_gdata->kim_rcvd);
 77	kfree_skb(skb);
 78}
 79
 80/* check for data len received inside kim_int_recv
 81 * most often hit the last case to update state to waiting for data
 82 */
 83static inline int kim_check_data_len(struct kim_data_s *kim_gdata, int len)
 84{
 85	register int room = skb_tailroom(kim_gdata->rx_skb);
 86
 87	pr_debug("len %d room %d", len, room);
 88
 89	if (!len) {
 90		validate_firmware_response(kim_gdata);
 91	} else if (len > room) {
 92		/* Received packet's payload length is larger.
 93		 * We can't accommodate it in created skb.
 94		 */
 95		pr_err("Data length is too large len %d room %d", len,
 96			   room);
 97		kfree_skb(kim_gdata->rx_skb);
 98	} else {
 99		/* Packet header has non-zero payload length and
100		 * we have enough space in created skb. Lets read
101		 * payload data */
102		kim_gdata->rx_state = ST_W4_DATA;
103		kim_gdata->rx_count = len;
104		return len;
105	}
106
107	/* Change ST LL state to continue to process next
108	 * packet */
109	kim_gdata->rx_state = ST_W4_PACKET_TYPE;
110	kim_gdata->rx_skb = NULL;
111	kim_gdata->rx_count = 0;
112
113	return 0;
114}
115
116/**
117 * kim_int_recv - receive function called during firmware download
118 *	firmware download responses on different UART drivers
119 *	have been observed to come in bursts of different
120 *	tty_receive and hence the logic
121 */
122void kim_int_recv(struct kim_data_s *kim_gdata,
123	const unsigned char *data, long count)
124{
125	const unsigned char *ptr;
126	int len = 0, type = 0;
127	unsigned char *plen;
128
129	pr_debug("%s", __func__);
130	/* Decode received bytes here */
131	ptr = data;
132	if (unlikely(ptr == NULL)) {
133		pr_err(" received null from TTY ");
134		return;
135	}
136
137	while (count) {
138		if (kim_gdata->rx_count) {
139			len = min_t(unsigned int, kim_gdata->rx_count, count);
140			memcpy(skb_put(kim_gdata->rx_skb, len), ptr, len);
141			kim_gdata->rx_count -= len;
142			count -= len;
143			ptr += len;
144
145			if (kim_gdata->rx_count)
146				continue;
147
148			/* Check ST RX state machine , where are we? */
149			switch (kim_gdata->rx_state) {
150				/* Waiting for complete packet ? */
151			case ST_W4_DATA:
152				pr_debug("Complete pkt received");
153				validate_firmware_response(kim_gdata);
154				kim_gdata->rx_state = ST_W4_PACKET_TYPE;
155				kim_gdata->rx_skb = NULL;
156				continue;
157				/* Waiting for Bluetooth event header ? */
158			case ST_W4_HEADER:
159				plen =
160				(unsigned char *)&kim_gdata->rx_skb->data[1];
161				pr_debug("event hdr: plen 0x%02x\n", *plen);
162				kim_check_data_len(kim_gdata, *plen);
163				continue;
164			}	/* end of switch */
165		}		/* end of if rx_state */
166		switch (*ptr) {
167			/* Bluetooth event packet? */
168		case 0x04:
169			kim_gdata->rx_state = ST_W4_HEADER;
170			kim_gdata->rx_count = 2;
171			type = *ptr;
172			break;
173		default:
174			pr_info("unknown packet");
175			ptr++;
176			count--;
177			continue;
178		}
179		ptr++;
180		count--;
181		kim_gdata->rx_skb =
182			alloc_skb(1024+8, GFP_ATOMIC);
183		if (!kim_gdata->rx_skb) {
184			pr_err("can't allocate mem for new packet");
185			kim_gdata->rx_state = ST_W4_PACKET_TYPE;
186			kim_gdata->rx_count = 0;
187			return;
188		}
189		skb_reserve(kim_gdata->rx_skb, 8);
190		kim_gdata->rx_skb->cb[0] = 4;
191		kim_gdata->rx_skb->cb[1] = 0;
192
193	}
194	return;
195}
196
197static long read_local_version(struct kim_data_s *kim_gdata, char *bts_scr_name)
198{
199	unsigned short version = 0, chip = 0, min_ver = 0, maj_ver = 0;
200	const char read_ver_cmd[] = { 0x01, 0x01, 0x10, 0x00 };
 
201
202	pr_debug("%s", __func__);
203
204	INIT_COMPLETION(kim_gdata->kim_rcvd);
205	if (4 != st_int_write(kim_gdata->core_data, read_ver_cmd, 4)) {
206		pr_err("kim: couldn't write 4 bytes");
207		return -EIO;
208	}
209
210	if (!wait_for_completion_timeout
211	    (&kim_gdata->kim_rcvd, msecs_to_jiffies(CMD_RESP_TIME))) {
212		pr_err(" waiting for ver info- timed out ");
213		return -ETIMEDOUT;
214	}
215	INIT_COMPLETION(kim_gdata->kim_rcvd);
 
 
 
 
216
217	version =
218		MAKEWORD(kim_gdata->resp_buffer[13],
219				kim_gdata->resp_buffer[14]);
220	chip = (version & 0x7C00) >> 10;
221	min_ver = (version & 0x007F);
222	maj_ver = (version & 0x0380) >> 7;
223
224	if (version & 0x8000)
225		maj_ver |= 0x0008;
226
227	sprintf(bts_scr_name, "TIInit_%d.%d.%d.bts", chip, maj_ver, min_ver);
 
228
229	/* to be accessed later via sysfs entry */
230	kim_gdata->version.full = version;
231	kim_gdata->version.chip = chip;
232	kim_gdata->version.maj_ver = maj_ver;
233	kim_gdata->version.min_ver = min_ver;
234
235	pr_info("%s", bts_scr_name);
236	return 0;
237}
238
239void skip_change_remote_baud(unsigned char **ptr, long *len)
240{
241	unsigned char *nxt_action, *cur_action;
242	cur_action = *ptr;
243
244	nxt_action = cur_action + sizeof(struct bts_action) +
245		((struct bts_action *) cur_action)->size;
246
247	if (((struct bts_action *) nxt_action)->type != ACTION_WAIT_EVENT) {
248		pr_err("invalid action after change remote baud command");
249	} else {
250		*ptr = *ptr + sizeof(struct bts_action) +
251			((struct bts_action *)cur_action)->size;
252		*len = *len - (sizeof(struct bts_action) +
253				((struct bts_action *)cur_action)->size);
254		/* warn user on not commenting these in firmware */
255		pr_warn("skipping the wait event of change remote baud");
256	}
257}
258
259/**
260 * download_firmware -
261 *	internal function which parses through the .bts firmware
262 *	script file intreprets SEND, DELAY actions only as of now
263 */
264static long download_firmware(struct kim_data_s *kim_gdata)
265{
266	long err = 0;
267	long len = 0;
268	unsigned char *ptr = NULL;
269	unsigned char *action_ptr = NULL;
270	unsigned char bts_scr_name[30] = { 0 };	/* 30 char long bts scr name? */
271	int wr_room_space;
272	int cmd_size;
273	unsigned long timeout;
274
275	err = read_local_version(kim_gdata, bts_scr_name);
276	if (err != 0) {
277		pr_err("kim: failed to read local ver");
278		return err;
279	}
280	err =
281	    request_firmware(&kim_gdata->fw_entry, bts_scr_name,
282			     &kim_gdata->kim_pdev->dev);
283	if (unlikely((err != 0) || (kim_gdata->fw_entry->data == NULL) ||
284		     (kim_gdata->fw_entry->size == 0))) {
285		pr_err(" request_firmware failed(errno %ld) for %s", err,
286			   bts_scr_name);
287		return -EINVAL;
288	}
289	ptr = (void *)kim_gdata->fw_entry->data;
290	len = kim_gdata->fw_entry->size;
291	/* bts_header to remove out magic number and
292	 * version
293	 */
294	ptr += sizeof(struct bts_header);
295	len -= sizeof(struct bts_header);
296
297	while (len > 0 && ptr) {
298		pr_debug(" action size %d, type %d ",
299			   ((struct bts_action *)ptr)->size,
300			   ((struct bts_action *)ptr)->type);
301
302		switch (((struct bts_action *)ptr)->type) {
303		case ACTION_SEND_COMMAND:	/* action send */
304			pr_debug("S");
305			action_ptr = &(((struct bts_action *)ptr)->data[0]);
306			if (unlikely
307			    (((struct hci_command *)action_ptr)->opcode ==
308			     0xFF36)) {
309				/* ignore remote change
310				 * baud rate HCI VS command */
311				pr_warn("change remote baud"
312				    " rate command in firmware");
313				skip_change_remote_baud(&ptr, &len);
314				break;
315			}
316			/*
317			 * Make sure we have enough free space in uart
318			 * tx buffer to write current firmware command
319			 */
320			cmd_size = ((struct bts_action *)ptr)->size;
321			timeout = jiffies + msecs_to_jiffies(CMD_WR_TIME);
322			do {
323				wr_room_space =
324					st_get_uart_wr_room(kim_gdata->core_data);
325				if (wr_room_space < 0) {
326					pr_err("Unable to get free "
327							"space info from uart tx buffer");
328					release_firmware(kim_gdata->fw_entry);
329					return wr_room_space;
330				}
331				mdelay(1); /* wait 1ms before checking room */
332			} while ((wr_room_space < cmd_size) &&
333					time_before(jiffies, timeout));
334
335			/* Timeout happened ? */
336			if (time_after_eq(jiffies, timeout)) {
337				pr_err("Timeout while waiting for free "
338						"free space in uart tx buffer");
339				release_firmware(kim_gdata->fw_entry);
340				return -ETIMEDOUT;
341			}
342			/* reinit completion before sending for the
343			 * relevant wait
344			 */
345			INIT_COMPLETION(kim_gdata->kim_rcvd);
346
347			/*
348			 * Free space found in uart buffer, call st_int_write
349			 * to send current firmware command to the uart tx
350			 * buffer.
351			 */
352			err = st_int_write(kim_gdata->core_data,
353			((struct bts_action_send *)action_ptr)->data,
354					   ((struct bts_action *)ptr)->size);
355			if (unlikely(err < 0)) {
356				release_firmware(kim_gdata->fw_entry);
357				return err;
358			}
359			/*
360			 * Check number of bytes written to the uart tx buffer
361			 * and requested command write size
362			 */
363			if (err != cmd_size) {
364				pr_err("Number of bytes written to uart "
365						"tx buffer are not matching with "
366						"requested cmd write size");
367				release_firmware(kim_gdata->fw_entry);
368				return -EIO;
369			}
370			break;
371		case ACTION_WAIT_EVENT:  /* wait */
372			pr_debug("W");
373			if (!wait_for_completion_timeout
374					(&kim_gdata->kim_rcvd,
375					 msecs_to_jiffies(CMD_RESP_TIME))) {
376				pr_err("response timeout during fw download ");
 
377				/* timed out */
378				release_firmware(kim_gdata->fw_entry);
379				return -ETIMEDOUT;
380			}
381			INIT_COMPLETION(kim_gdata->kim_rcvd);
382			break;
383		case ACTION_DELAY:	/* sleep */
384			pr_info("sleep command in scr");
385			action_ptr = &(((struct bts_action *)ptr)->data[0]);
386			mdelay(((struct bts_action_delay *)action_ptr)->msec);
387			break;
388		}
389		len =
390		    len - (sizeof(struct bts_action) +
391			   ((struct bts_action *)ptr)->size);
392		ptr =
393		    ptr + sizeof(struct bts_action) +
394		    ((struct bts_action *)ptr)->size;
395	}
396	/* fw download complete */
397	release_firmware(kim_gdata->fw_entry);
398	return 0;
399}
400
401/**********************************************************************/
402/* functions called from ST core */
403/* called from ST Core, when REG_IN_PROGRESS (registration in progress)
404 * can be because of
405 * 1. response to read local version
406 * 2. during send/recv's of firmware download
407 */
408void st_kim_recv(void *disc_data, const unsigned char *data, long count)
409{
410	struct st_data_s	*st_gdata = (struct st_data_s *)disc_data;
411	struct kim_data_s	*kim_gdata = st_gdata->kim_data;
412
413	/* copy to local buffer */
414	if (unlikely(data[4] == 0x01 && data[5] == 0x10 && data[0] == 0x04)) {
415		/* must be the read_ver_cmd */
416		memcpy(kim_gdata->resp_buffer, data, count);
417		complete_all(&kim_gdata->kim_rcvd);
418		return;
419	} else {
420		kim_int_recv(kim_gdata, data, count);
421		/* either completes or times out */
422	}
423	return;
424}
425
426/* to signal completion of line discipline installation
427 * called from ST Core, upon tty_open
428 */
429void st_kim_complete(void *kim_data)
430{
431	struct kim_data_s	*kim_gdata = (struct kim_data_s *)kim_data;
432	complete(&kim_gdata->ldisc_installed);
433}
434
435/**
436 * st_kim_start - called from ST Core upon 1st registration
437 *	This involves toggling the chip enable gpio, reading
438 *	the firmware version from chip, forming the fw file name
439 *	based on the chip version, requesting the fw, parsing it
440 *	and perform download(send/recv).
441 */
442long st_kim_start(void *kim_data)
443{
444	long err = 0;
445	long retry = POR_RETRY_COUNT;
446	struct ti_st_plat_data	*pdata;
447	struct kim_data_s	*kim_gdata = (struct kim_data_s *)kim_data;
448
449	pr_info(" %s", __func__);
450	pdata = kim_gdata->kim_pdev->dev.platform_data;
451
452	do {
453		/* platform specific enabling code here */
454		if (pdata->chip_enable)
455			pdata->chip_enable(kim_gdata);
456
457		/* Configure BT nShutdown to HIGH state */
458		gpio_set_value(kim_gdata->nshutdown, GPIO_LOW);
459		mdelay(5);	/* FIXME: a proper toggle */
460		gpio_set_value(kim_gdata->nshutdown, GPIO_HIGH);
461		mdelay(100);
462		/* re-initialize the completion */
463		INIT_COMPLETION(kim_gdata->ldisc_installed);
464		/* send notification to UIM */
465		kim_gdata->ldisc_install = 1;
466		pr_info("ldisc_install = 1");
467		sysfs_notify(&kim_gdata->kim_pdev->dev.kobj,
468				NULL, "install");
469		/* wait for ldisc to be installed */
470		err = wait_for_completion_timeout(&kim_gdata->ldisc_installed,
471				msecs_to_jiffies(LDISC_TIME));
472		if (!err) {
473			/* ldisc installation timeout,
474			 * flush uart, power cycle BT_EN */
475			pr_err("ldisc installation timeout");
476			err = st_kim_stop(kim_gdata);
477			continue;
478		} else {
479			/* ldisc installed now */
480			pr_info("line discipline installed");
481			err = download_firmware(kim_gdata);
482			if (err != 0) {
483				/* ldisc installed but fw download failed,
484				 * flush uart & power cycle BT_EN */
485				pr_err("download firmware failed");
486				err = st_kim_stop(kim_gdata);
487				continue;
488			} else {	/* on success don't retry */
489				break;
490			}
491		}
492	} while (retry--);
493	return err;
494}
495
496/**
497 * st_kim_stop - stop communication with chip.
498 *	This can be called from ST Core/KIM, on the-
499 *	(a) last un-register when chip need not be powered there-after,
500 *	(b) upon failure to either install ldisc or download firmware.
501 *	The function is responsible to (a) notify UIM about un-installation,
502 *	(b) flush UART if the ldisc was installed.
503 *	(c) reset BT_EN - pull down nshutdown at the end.
504 *	(d) invoke platform's chip disabling routine.
505 */
506long st_kim_stop(void *kim_data)
507{
508	long err = 0;
509	struct kim_data_s	*kim_gdata = (struct kim_data_s *)kim_data;
510	struct ti_st_plat_data	*pdata =
511		kim_gdata->kim_pdev->dev.platform_data;
512	struct tty_struct	*tty = kim_gdata->core_data->tty;
513
514	INIT_COMPLETION(kim_gdata->ldisc_installed);
515
516	if (tty) {	/* can be called before ldisc is installed */
517		/* Flush any pending characters in the driver and discipline. */
518		tty_ldisc_flush(tty);
519		tty_driver_flush_buffer(tty);
520		tty->ops->flush_buffer(tty);
521	}
522
523	/* send uninstall notification to UIM */
524	pr_info("ldisc_install = 0");
525	kim_gdata->ldisc_install = 0;
526	sysfs_notify(&kim_gdata->kim_pdev->dev.kobj, NULL, "install");
527
528	/* wait for ldisc to be un-installed */
529	err = wait_for_completion_timeout(&kim_gdata->ldisc_installed,
530			msecs_to_jiffies(LDISC_TIME));
531	if (!err) {		/* timeout */
532		pr_err(" timed out waiting for ldisc to be un-installed");
533		return -ETIMEDOUT;
534	}
535
536	/* By default configure BT nShutdown to LOW state */
537	gpio_set_value(kim_gdata->nshutdown, GPIO_LOW);
538	mdelay(1);
539	gpio_set_value(kim_gdata->nshutdown, GPIO_HIGH);
540	mdelay(1);
541	gpio_set_value(kim_gdata->nshutdown, GPIO_LOW);
542
543	/* platform specific disable */
544	if (pdata->chip_disable)
545		pdata->chip_disable(kim_gdata);
546	return err;
547}
548
549/**********************************************************************/
550/* functions called from subsystems */
551/* called when debugfs entry is read from */
552
553static int show_version(struct seq_file *s, void *unused)
554{
555	struct kim_data_s *kim_gdata = (struct kim_data_s *)s->private;
556	seq_printf(s, "%04X %d.%d.%d\n", kim_gdata->version.full,
557			kim_gdata->version.chip, kim_gdata->version.maj_ver,
558			kim_gdata->version.min_ver);
559	return 0;
560}
561
562static int show_list(struct seq_file *s, void *unused)
563{
564	struct kim_data_s *kim_gdata = (struct kim_data_s *)s->private;
565	kim_st_list_protocols(kim_gdata->core_data, s);
566	return 0;
567}
568
569static ssize_t show_install(struct device *dev,
570		struct device_attribute *attr, char *buf)
571{
572	struct kim_data_s *kim_data = dev_get_drvdata(dev);
573	return sprintf(buf, "%d\n", kim_data->ldisc_install);
574}
575
576#ifdef DEBUG
577static ssize_t store_dev_name(struct device *dev,
578		struct device_attribute *attr, const char *buf, size_t count)
579{
580	struct kim_data_s *kim_data = dev_get_drvdata(dev);
581	pr_debug("storing dev name >%s<", buf);
582	strncpy(kim_data->dev_name, buf, count);
583	pr_debug("stored dev name >%s<", kim_data->dev_name);
584	return count;
585}
586
587static ssize_t store_baud_rate(struct device *dev,
588		struct device_attribute *attr, const char *buf, size_t count)
589{
590	struct kim_data_s *kim_data = dev_get_drvdata(dev);
591	pr_debug("storing baud rate >%s<", buf);
592	sscanf(buf, "%ld", &kim_data->baud_rate);
593	pr_debug("stored baud rate >%ld<", kim_data->baud_rate);
594	return count;
595}
596#endif	/* if DEBUG */
597
598static ssize_t show_dev_name(struct device *dev,
599		struct device_attribute *attr, char *buf)
600{
601	struct kim_data_s *kim_data = dev_get_drvdata(dev);
602	return sprintf(buf, "%s\n", kim_data->dev_name);
603}
604
605static ssize_t show_baud_rate(struct device *dev,
606		struct device_attribute *attr, char *buf)
607{
608	struct kim_data_s *kim_data = dev_get_drvdata(dev);
609	return sprintf(buf, "%ld\n", kim_data->baud_rate);
610}
611
612static ssize_t show_flow_cntrl(struct device *dev,
613		struct device_attribute *attr, char *buf)
614{
615	struct kim_data_s *kim_data = dev_get_drvdata(dev);
616	return sprintf(buf, "%d\n", kim_data->flow_cntrl);
617}
618
619/* structures specific for sysfs entries */
620static struct kobj_attribute ldisc_install =
621__ATTR(install, 0444, (void *)show_install, NULL);
622
623static struct kobj_attribute uart_dev_name =
624#ifdef DEBUG	/* TODO: move this to debug-fs if possible */
625__ATTR(dev_name, 0644, (void *)show_dev_name, (void *)store_dev_name);
626#else
627__ATTR(dev_name, 0444, (void *)show_dev_name, NULL);
628#endif
629
630static struct kobj_attribute uart_baud_rate =
631#ifdef DEBUG	/* TODO: move to debugfs */
632__ATTR(baud_rate, 0644, (void *)show_baud_rate, (void *)store_baud_rate);
633#else
634__ATTR(baud_rate, 0444, (void *)show_baud_rate, NULL);
635#endif
636
637static struct kobj_attribute uart_flow_cntrl =
638__ATTR(flow_cntrl, 0444, (void *)show_flow_cntrl, NULL);
639
640static struct attribute *uim_attrs[] = {
641	&ldisc_install.attr,
642	&uart_dev_name.attr,
643	&uart_baud_rate.attr,
644	&uart_flow_cntrl.attr,
645	NULL,
646};
647
648static struct attribute_group uim_attr_grp = {
649	.attrs = uim_attrs,
650};
651
652/**
653 * st_kim_ref - reference the core's data
654 *	This references the per-ST platform device in the arch/xx/
655 *	board-xx.c file.
656 *	This would enable multiple such platform devices to exist
657 *	on a given platform
658 */
659void st_kim_ref(struct st_data_s **core_data, int id)
660{
661	struct platform_device	*pdev;
662	struct kim_data_s	*kim_gdata;
663	/* get kim_gdata reference from platform device */
664	pdev = st_get_plat_device(id);
665	if (!pdev) {
666		*core_data = NULL;
667		return;
668	}
669	kim_gdata = dev_get_drvdata(&pdev->dev);
 
670	*core_data = kim_gdata->core_data;
 
 
 
671}
672
673static int kim_version_open(struct inode *i, struct file *f)
674{
675	return single_open(f, show_version, i->i_private);
676}
677
678static int kim_list_open(struct inode *i, struct file *f)
679{
680	return single_open(f, show_list, i->i_private);
681}
682
683static const struct file_operations version_debugfs_fops = {
684	/* version info */
685	.open = kim_version_open,
686	.read = seq_read,
687	.llseek = seq_lseek,
688	.release = single_release,
689};
690static const struct file_operations list_debugfs_fops = {
691	/* protocols info */
692	.open = kim_list_open,
693	.read = seq_read,
694	.llseek = seq_lseek,
695	.release = single_release,
696};
697
698/**********************************************************************/
699/* functions called from platform device driver subsystem
700 * need to have a relevant platform device entry in the platform's
701 * board-*.c file
702 */
703
704struct dentry *kim_debugfs_dir;
705static int kim_probe(struct platform_device *pdev)
706{
707	long status;
708	struct kim_data_s	*kim_gdata;
709	struct ti_st_plat_data	*pdata = pdev->dev.platform_data;
 
710
711	if ((pdev->id != -1) && (pdev->id < MAX_ST_DEVICES)) {
712		/* multiple devices could exist */
713		st_kim_devices[pdev->id] = pdev;
714	} else {
715		/* platform's sure about existence of 1 device */
716		st_kim_devices[0] = pdev;
717	}
718
719	kim_gdata = kzalloc(sizeof(struct kim_data_s), GFP_ATOMIC);
720	if (!kim_gdata) {
721		pr_err("no mem to allocate");
722		return -ENOMEM;
723	}
724	dev_set_drvdata(&pdev->dev, kim_gdata);
725
726	status = st_core_init(&kim_gdata->core_data);
727	if (status != 0) {
728		pr_err(" ST core init failed");
729		return -EIO;
 
730	}
731	/* refer to itself */
732	kim_gdata->core_data->kim_data = kim_gdata;
733
734	/* Claim the chip enable nShutdown gpio from the system */
735	kim_gdata->nshutdown = pdata->nshutdown_gpio;
736	status = gpio_request(kim_gdata->nshutdown, "kim");
737	if (unlikely(status)) {
738		pr_err(" gpio %ld request failed ", kim_gdata->nshutdown);
739		return status;
740	}
741
742	/* Configure nShutdown GPIO as output=0 */
743	status = gpio_direction_output(kim_gdata->nshutdown, 0);
744	if (unlikely(status)) {
745		pr_err(" unable to configure gpio %ld", kim_gdata->nshutdown);
746		return status;
747	}
748	/* get reference of pdev for request_firmware
749	 */
750	kim_gdata->kim_pdev = pdev;
751	init_completion(&kim_gdata->kim_rcvd);
752	init_completion(&kim_gdata->ldisc_installed);
753
754	status = sysfs_create_group(&pdev->dev.kobj, &uim_attr_grp);
755	if (status) {
756		pr_err("failed to create sysfs entries");
757		return status;
758	}
759
760	/* copying platform data */
761	strncpy(kim_gdata->dev_name, pdata->dev_name, UART_DEV_NAME_LEN);
762	kim_gdata->flow_cntrl = pdata->flow_cntrl;
763	kim_gdata->baud_rate = pdata->baud_rate;
764	pr_info("sysfs entries created\n");
765
766	kim_debugfs_dir = debugfs_create_dir("ti-st", NULL);
767	if (IS_ERR(kim_debugfs_dir)) {
768		pr_err(" debugfs entries creation failed ");
769		kim_debugfs_dir = NULL;
770		return -EIO;
771	}
772
773	debugfs_create_file("version", S_IRUGO, kim_debugfs_dir,
774				kim_gdata, &version_debugfs_fops);
775	debugfs_create_file("protocols", S_IRUGO, kim_debugfs_dir,
776				kim_gdata, &list_debugfs_fops);
777	pr_info(" debugfs entries created ");
778	return 0;
 
 
 
 
 
 
 
 
779}
780
781static int kim_remove(struct platform_device *pdev)
782{
783	/* free the GPIOs requested */
784	struct ti_st_plat_data	*pdata = pdev->dev.platform_data;
785	struct kim_data_s	*kim_gdata;
786
787	kim_gdata = dev_get_drvdata(&pdev->dev);
788
789	/* Free the Bluetooth/FM/GPIO
790	 * nShutdown gpio from the system
791	 */
792	gpio_free(pdata->nshutdown_gpio);
793	pr_info("nshutdown GPIO Freed");
794
795	debugfs_remove_recursive(kim_debugfs_dir);
796	sysfs_remove_group(&pdev->dev.kobj, &uim_attr_grp);
797	pr_info("sysfs entries removed");
798
799	kim_gdata->kim_pdev = NULL;
800	st_core_exit(kim_gdata->core_data);
801
802	kfree(kim_gdata);
803	kim_gdata = NULL;
804	return 0;
805}
806
807int kim_suspend(struct platform_device *pdev, pm_message_t state)
808{
809	struct ti_st_plat_data	*pdata = pdev->dev.platform_data;
810
811	if (pdata->suspend)
812		return pdata->suspend(pdev, state);
813
814	return -EOPNOTSUPP;
815}
816
817int kim_resume(struct platform_device *pdev)
818{
819	struct ti_st_plat_data	*pdata = pdev->dev.platform_data;
820
821	if (pdata->resume)
822		return pdata->resume(pdev);
823
824	return -EOPNOTSUPP;
825}
826
827/**********************************************************************/
828/* entry point for ST KIM module, called in from ST Core */
829static struct platform_driver kim_platform_driver = {
830	.probe = kim_probe,
831	.remove = kim_remove,
832	.suspend = kim_suspend,
833	.resume = kim_resume,
834	.driver = {
835		.name = "kim",
836		.owner = THIS_MODULE,
837	},
838};
839
840module_platform_driver(kim_platform_driver);
841
842MODULE_AUTHOR("Pavan Savoy <pavan_savoy@ti.com>");
843MODULE_DESCRIPTION("Shared Transport Driver for TI BT/FM/GPS combo chips ");
844MODULE_LICENSE("GPL");