Linux Audio

Check our new training course

Loading...
Note: File does not exist in v6.2.
  1/*
  2 *  Texas Instrument's NFC Driver For Shared Transport.
  3 *
  4 *  NFC Driver acts as interface between NCI core and
  5 *  TI Shared Transport Layer.
  6 *
  7 *  Copyright (C) 2011 Texas Instruments, Inc.
  8 *
  9 *  Written by Ilan Elias <ilane@ti.com>
 10 *
 11 *  Acknowledgements:
 12 *  This file is based on btwilink.c, which was written
 13 *  by Raja Mani and Pavan Savoy.
 14 *
 15 *  This program is free software; you can redistribute it and/or modify
 16 *  it under the terms of the GNU General Public License version 2 as
 17 *  published by the Free Software Foundation.
 18 *
 19 *  This program is distributed in the hope that it will be useful,
 20 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 21 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 22 *  GNU General Public License for more details.
 23 *
 24 *  You should have received a copy of the GNU General Public License
 25 *  along with this program; if not, write to the Free Software
 26 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 27 *
 28 */
 29#include <linux/platform_device.h>
 30#include <linux/module.h>
 31#include <linux/types.h>
 32#include <linux/firmware.h>
 33#include <linux/nfc.h>
 34#include <net/nfc/nci.h>
 35#include <net/nfc/nci_core.h>
 36#include <linux/ti_wilink_st.h>
 37
 38#define NFCWILINK_CHNL			12
 39#define NFCWILINK_OPCODE		7
 40#define NFCWILINK_MAX_FRAME_SIZE	300
 41#define NFCWILINK_HDR_LEN		4
 42#define NFCWILINK_OFFSET_LEN_IN_HDR	1
 43#define NFCWILINK_LEN_SIZE		2
 44#define NFCWILINK_REGISTER_TIMEOUT	8000	/* 8 sec */
 45#define NFCWILINK_CMD_TIMEOUT		5000	/* 5 sec */
 46
 47#define BTS_FILE_NAME_MAX_SIZE		40
 48#define BTS_FILE_HDR_MAGIC		0x42535442
 49#define BTS_FILE_CMD_MAX_LEN		0xff
 50#define BTS_FILE_ACTION_TYPE_SEND_CMD	1
 51
 52#define NCI_VS_NFCC_INFO_CMD_GID	0x2f
 53#define NCI_VS_NFCC_INFO_CMD_OID	0x12
 54#define NCI_VS_NFCC_INFO_RSP_GID	0x4f
 55#define NCI_VS_NFCC_INFO_RSP_OID	0x12
 56
 57struct nfcwilink_hdr {
 58	__u8 chnl;
 59	__u8 opcode;
 60	__le16 len;
 61} __packed;
 62
 63struct nci_vs_nfcc_info_cmd {
 64	__u8 gid;
 65	__u8 oid;
 66	__u8 plen;
 67} __packed;
 68
 69struct nci_vs_nfcc_info_rsp {
 70	__u8 gid;
 71	__u8 oid;
 72	__u8 plen;
 73	__u8 status;
 74	__u8 hw_id;
 75	__u8 sw_ver_x;
 76	__u8 sw_ver_z;
 77	__u8 patch_id;
 78} __packed;
 79
 80struct bts_file_hdr {
 81	__le32 magic;
 82	__le32 ver;
 83	__u8 rfu[24];
 84	__u8 actions[0];
 85} __packed;
 86
 87struct bts_file_action {
 88	__le16 type;
 89	__le16 len;
 90	__u8 data[0];
 91} __packed;
 92
 93struct nfcwilink {
 94	struct platform_device		*pdev;
 95	struct nci_dev			*ndev;
 96	unsigned long			flags;
 97
 98	char				st_register_cb_status;
 99	long				(*st_write) (struct sk_buff *);
100
101	struct completion		completed;
102
103	struct nci_vs_nfcc_info_rsp	nfcc_info;
104};
105
106/* NFCWILINK driver flags */
107enum {
108	NFCWILINK_RUNNING,
109	NFCWILINK_FW_DOWNLOAD,
110};
111
112static int nfcwilink_send(struct sk_buff *skb);
113
114static inline struct sk_buff *nfcwilink_skb_alloc(unsigned int len, gfp_t how)
115{
116	struct sk_buff *skb;
117
118	skb = alloc_skb(len + NFCWILINK_HDR_LEN, how);
119	if (skb)
120		skb_reserve(skb, NFCWILINK_HDR_LEN);
121
122	return skb;
123}
124
125static void nfcwilink_fw_download_receive(struct nfcwilink *drv,
126						struct sk_buff *skb)
127{
128	struct nci_vs_nfcc_info_rsp *rsp = (void *)skb->data;
129
130	/* Detect NCI_VS_NFCC_INFO_RSP and store the result */
131	if ((skb->len > 3) && (rsp->gid == NCI_VS_NFCC_INFO_RSP_GID) &&
132		(rsp->oid == NCI_VS_NFCC_INFO_RSP_OID)) {
133		memcpy(&drv->nfcc_info, rsp,
134			sizeof(struct nci_vs_nfcc_info_rsp));
135	}
136
137	kfree_skb(skb);
138
139	complete(&drv->completed);
140}
141
142static int nfcwilink_get_bts_file_name(struct nfcwilink *drv, char *file_name)
143{
144	struct nci_vs_nfcc_info_cmd *cmd;
145	struct sk_buff *skb;
146	unsigned long comp_ret;
147	int rc;
148
149	nfc_dev_dbg(&drv->pdev->dev, "get_bts_file_name entry");
150
151	skb = nfcwilink_skb_alloc(sizeof(struct nci_vs_nfcc_info_cmd),
152					GFP_KERNEL);
153	if (!skb) {
154		nfc_dev_err(&drv->pdev->dev,
155				"no memory for nci_vs_nfcc_info_cmd");
156		return -ENOMEM;
157	}
158
159	skb->dev = (void *)drv->ndev;
160
161	cmd = (struct nci_vs_nfcc_info_cmd *)
162			skb_put(skb, sizeof(struct nci_vs_nfcc_info_cmd));
163	cmd->gid = NCI_VS_NFCC_INFO_CMD_GID;
164	cmd->oid = NCI_VS_NFCC_INFO_CMD_OID;
165	cmd->plen = 0;
166
167	drv->nfcc_info.plen = 0;
168
169	rc = nfcwilink_send(skb);
170	if (rc)
171		return rc;
172
173	comp_ret = wait_for_completion_timeout(&drv->completed,
174				msecs_to_jiffies(NFCWILINK_CMD_TIMEOUT));
175	nfc_dev_dbg(&drv->pdev->dev, "wait_for_completion_timeout returned %ld",
176			comp_ret);
177	if (comp_ret == 0) {
178		nfc_dev_err(&drv->pdev->dev,
179				"timeout on wait_for_completion_timeout");
180		return -ETIMEDOUT;
181	}
182
183	nfc_dev_dbg(&drv->pdev->dev, "nci_vs_nfcc_info_rsp: plen %d, status %d",
184			drv->nfcc_info.plen,
185			drv->nfcc_info.status);
186
187	if ((drv->nfcc_info.plen != 5) || (drv->nfcc_info.status != 0)) {
188		nfc_dev_err(&drv->pdev->dev,
189				"invalid nci_vs_nfcc_info_rsp");
190		return -EINVAL;
191	}
192
193	snprintf(file_name, BTS_FILE_NAME_MAX_SIZE,
194			"TINfcInit_%d.%d.%d.%d.bts",
195			drv->nfcc_info.hw_id,
196			drv->nfcc_info.sw_ver_x,
197			drv->nfcc_info.sw_ver_z,
198			drv->nfcc_info.patch_id);
199
200	nfc_dev_info(&drv->pdev->dev, "nfcwilink FW file name: %s", file_name);
201
202	return 0;
203}
204
205static int nfcwilink_send_bts_cmd(struct nfcwilink *drv, __u8 *data, int len)
206{
207	struct nfcwilink_hdr *hdr = (struct nfcwilink_hdr *)data;
208	struct sk_buff *skb;
209	unsigned long comp_ret;
210	int rc;
211
212	nfc_dev_dbg(&drv->pdev->dev, "send_bts_cmd entry");
213
214	/* verify valid cmd for the NFC channel */
215	if ((len <= sizeof(struct nfcwilink_hdr)) ||
216		(len > BTS_FILE_CMD_MAX_LEN) ||
217		(hdr->chnl != NFCWILINK_CHNL) ||
218		(hdr->opcode != NFCWILINK_OPCODE)) {
219		nfc_dev_err(&drv->pdev->dev,
220			"ignoring invalid bts cmd, len %d, chnl %d, opcode %d",
221			len, hdr->chnl, hdr->opcode);
222		return 0;
223	}
224
225	/* remove the ST header */
226	len -= sizeof(struct nfcwilink_hdr);
227	data += sizeof(struct nfcwilink_hdr);
228
229	skb = nfcwilink_skb_alloc(len, GFP_KERNEL);
230	if (!skb) {
231		nfc_dev_err(&drv->pdev->dev, "no memory for bts cmd");
232		return -ENOMEM;
233	}
234
235	skb->dev = (void *)drv->ndev;
236
237	memcpy(skb_put(skb, len), data, len);
238
239	rc = nfcwilink_send(skb);
240	if (rc)
241		return rc;
242
243	comp_ret = wait_for_completion_timeout(&drv->completed,
244				msecs_to_jiffies(NFCWILINK_CMD_TIMEOUT));
245	nfc_dev_dbg(&drv->pdev->dev, "wait_for_completion_timeout returned %ld",
246			comp_ret);
247	if (comp_ret == 0) {
248		nfc_dev_err(&drv->pdev->dev,
249				"timeout on wait_for_completion_timeout");
250		return -ETIMEDOUT;
251	}
252
253	return 0;
254}
255
256static int nfcwilink_download_fw(struct nfcwilink *drv)
257{
258	unsigned char file_name[BTS_FILE_NAME_MAX_SIZE];
259	const struct firmware *fw;
260	__u16 action_type, action_len;
261	__u8 *ptr;
262	int len, rc;
263
264	nfc_dev_dbg(&drv->pdev->dev, "download_fw entry");
265
266	set_bit(NFCWILINK_FW_DOWNLOAD, &drv->flags);
267
268	rc = nfcwilink_get_bts_file_name(drv, file_name);
269	if (rc)
270		goto exit;
271
272	rc = request_firmware(&fw, file_name, &drv->pdev->dev);
273	if (rc) {
274		nfc_dev_err(&drv->pdev->dev, "request_firmware failed %d", rc);
275
276		/* if the file is not found, don't exit with failure */
277		if (rc == -ENOENT)
278			rc = 0;
279
280		goto exit;
281	}
282
283	len = fw->size;
284	ptr = (__u8 *)fw->data;
285
286	if ((len == 0) || (ptr == NULL)) {
287		nfc_dev_dbg(&drv->pdev->dev,
288				"request_firmware returned size %d", len);
289		goto release_fw;
290	}
291
292	if (__le32_to_cpu(((struct bts_file_hdr *)ptr)->magic) !=
293			BTS_FILE_HDR_MAGIC) {
294		nfc_dev_err(&drv->pdev->dev, "wrong bts magic number");
295		rc = -EINVAL;
296		goto release_fw;
297	}
298
299	/* remove the BTS header */
300	len -= sizeof(struct bts_file_hdr);
301	ptr += sizeof(struct bts_file_hdr);
302
303	while (len > 0) {
304		action_type =
305			__le16_to_cpu(((struct bts_file_action *)ptr)->type);
306		action_len =
307			__le16_to_cpu(((struct bts_file_action *)ptr)->len);
308
309		nfc_dev_dbg(&drv->pdev->dev, "bts_file_action type %d, len %d",
310				action_type, action_len);
311
312		switch (action_type) {
313		case BTS_FILE_ACTION_TYPE_SEND_CMD:
314			rc = nfcwilink_send_bts_cmd(drv,
315					((struct bts_file_action *)ptr)->data,
316					action_len);
317			if (rc)
318				goto release_fw;
319			break;
320		}
321
322		/* advance to the next action */
323		len -= (sizeof(struct bts_file_action) + action_len);
324		ptr += (sizeof(struct bts_file_action) + action_len);
325	}
326
327release_fw:
328	release_firmware(fw);
329
330exit:
331	clear_bit(NFCWILINK_FW_DOWNLOAD, &drv->flags);
332	return rc;
333}
334
335/* Called by ST when registration is complete */
336static void nfcwilink_register_complete(void *priv_data, char data)
337{
338	struct nfcwilink *drv = priv_data;
339
340	nfc_dev_dbg(&drv->pdev->dev, "register_complete entry");
341
342	/* store ST registration status */
343	drv->st_register_cb_status = data;
344
345	/* complete the wait in nfc_st_open() */
346	complete(&drv->completed);
347}
348
349/* Called by ST when receive data is available */
350static long nfcwilink_receive(void *priv_data, struct sk_buff *skb)
351{
352	struct nfcwilink *drv = priv_data;
353	int rc;
354
355	nfc_dev_dbg(&drv->pdev->dev, "receive entry, len %d", skb->len);
356
357	if (!skb)
358		return -EFAULT;
359
360	if (!drv) {
361		kfree_skb(skb);
362		return -EFAULT;
363	}
364
365	/* strip the ST header
366	(apart for the chnl byte, which is not received in the hdr) */
367	skb_pull(skb, (NFCWILINK_HDR_LEN-1));
368
369	if (test_bit(NFCWILINK_FW_DOWNLOAD, &drv->flags)) {
370		nfcwilink_fw_download_receive(drv, skb);
371		return 0;
372	}
373
374	skb->dev = (void *) drv->ndev;
375
376	/* Forward skb to NCI core layer */
377	rc = nci_recv_frame(skb);
378	if (rc < 0) {
379		nfc_dev_err(&drv->pdev->dev, "nci_recv_frame failed %d", rc);
380		return rc;
381	}
382
383	return 0;
384}
385
386/* protocol structure registered with ST */
387static struct st_proto_s nfcwilink_proto = {
388	.chnl_id = NFCWILINK_CHNL,
389	.max_frame_size = NFCWILINK_MAX_FRAME_SIZE,
390	.hdr_len = (NFCWILINK_HDR_LEN-1),	/* not including chnl byte */
391	.offset_len_in_hdr = NFCWILINK_OFFSET_LEN_IN_HDR,
392	.len_size = NFCWILINK_LEN_SIZE,
393	.reserve = 0,
394	.recv = nfcwilink_receive,
395	.reg_complete_cb = nfcwilink_register_complete,
396	.write = NULL,
397};
398
399static int nfcwilink_open(struct nci_dev *ndev)
400{
401	struct nfcwilink *drv = nci_get_drvdata(ndev);
402	unsigned long comp_ret;
403	int rc;
404
405	nfc_dev_dbg(&drv->pdev->dev, "open entry");
406
407	if (test_and_set_bit(NFCWILINK_RUNNING, &drv->flags)) {
408		rc = -EBUSY;
409		goto exit;
410	}
411
412	nfcwilink_proto.priv_data = drv;
413
414	init_completion(&drv->completed);
415	drv->st_register_cb_status = -EINPROGRESS;
416
417	rc = st_register(&nfcwilink_proto);
418	if (rc < 0) {
419		if (rc == -EINPROGRESS) {
420			comp_ret = wait_for_completion_timeout(
421			&drv->completed,
422			msecs_to_jiffies(NFCWILINK_REGISTER_TIMEOUT));
423
424			nfc_dev_dbg(&drv->pdev->dev,
425			"wait_for_completion_timeout returned %ld",
426			comp_ret);
427
428			if (comp_ret == 0) {
429				/* timeout */
430				rc = -ETIMEDOUT;
431				goto clear_exit;
432			} else if (drv->st_register_cb_status != 0) {
433				rc = drv->st_register_cb_status;
434				nfc_dev_err(&drv->pdev->dev,
435				"st_register_cb failed %d", rc);
436				goto clear_exit;
437			}
438		} else {
439			nfc_dev_err(&drv->pdev->dev,
440				"st_register failed %d", rc);
441			goto clear_exit;
442		}
443	}
444
445	/* st_register MUST fill the write callback */
446	BUG_ON(nfcwilink_proto.write == NULL);
447	drv->st_write = nfcwilink_proto.write;
448
449	if (nfcwilink_download_fw(drv)) {
450		nfc_dev_err(&drv->pdev->dev, "nfcwilink_download_fw failed %d",
451				rc);
452		/* open should succeed, even if the FW download failed */
453	}
454
455	goto exit;
456
457clear_exit:
458	clear_bit(NFCWILINK_RUNNING, &drv->flags);
459
460exit:
461	return rc;
462}
463
464static int nfcwilink_close(struct nci_dev *ndev)
465{
466	struct nfcwilink *drv = nci_get_drvdata(ndev);
467	int rc;
468
469	nfc_dev_dbg(&drv->pdev->dev, "close entry");
470
471	if (!test_and_clear_bit(NFCWILINK_RUNNING, &drv->flags))
472		return 0;
473
474	rc = st_unregister(&nfcwilink_proto);
475	if (rc)
476		nfc_dev_err(&drv->pdev->dev, "st_unregister failed %d", rc);
477
478	drv->st_write = NULL;
479
480	return rc;
481}
482
483static int nfcwilink_send(struct sk_buff *skb)
484{
485	struct nci_dev *ndev = (struct nci_dev *)skb->dev;
486	struct nfcwilink *drv = nci_get_drvdata(ndev);
487	struct nfcwilink_hdr hdr = {NFCWILINK_CHNL, NFCWILINK_OPCODE, 0x0000};
488	long len;
489
490	nfc_dev_dbg(&drv->pdev->dev, "send entry, len %d", skb->len);
491
492	if (!test_bit(NFCWILINK_RUNNING, &drv->flags)) {
493		kfree_skb(skb);
494		return -EINVAL;
495	}
496
497	/* add the ST hdr to the start of the buffer */
498	hdr.len = cpu_to_le16(skb->len);
499	memcpy(skb_push(skb, NFCWILINK_HDR_LEN), &hdr, NFCWILINK_HDR_LEN);
500
501	/* Insert skb to shared transport layer's transmit queue.
502	 * Freeing skb memory is taken care in shared transport layer,
503	 * so don't free skb memory here.
504	 */
505	len = drv->st_write(skb);
506	if (len < 0) {
507		kfree_skb(skb);
508		nfc_dev_err(&drv->pdev->dev, "st_write failed %ld", len);
509		return -EFAULT;
510	}
511
512	return 0;
513}
514
515static struct nci_ops nfcwilink_ops = {
516	.open = nfcwilink_open,
517	.close = nfcwilink_close,
518	.send = nfcwilink_send,
519};
520
521static int nfcwilink_probe(struct platform_device *pdev)
522{
523	static struct nfcwilink *drv;
524	int rc;
525	__u32 protocols;
526
527	nfc_dev_dbg(&pdev->dev, "probe entry");
528
529	drv = kzalloc(sizeof(struct nfcwilink), GFP_KERNEL);
530	if (!drv) {
531		rc = -ENOMEM;
532		goto exit;
533	}
534
535	drv->pdev = pdev;
536
537	protocols = NFC_PROTO_JEWEL_MASK
538			| NFC_PROTO_MIFARE_MASK | NFC_PROTO_FELICA_MASK
539			| NFC_PROTO_ISO14443_MASK
540			| NFC_PROTO_NFC_DEP_MASK;
541
542	drv->ndev = nci_allocate_device(&nfcwilink_ops,
543					protocols,
544					NFCWILINK_HDR_LEN,
545					0);
546	if (!drv->ndev) {
547		nfc_dev_err(&pdev->dev, "nci_allocate_device failed");
548		rc = -ENOMEM;
549		goto free_exit;
550	}
551
552	nci_set_parent_dev(drv->ndev, &pdev->dev);
553	nci_set_drvdata(drv->ndev, drv);
554
555	rc = nci_register_device(drv->ndev);
556	if (rc < 0) {
557		nfc_dev_err(&pdev->dev, "nci_register_device failed %d", rc);
558		goto free_dev_exit;
559	}
560
561	dev_set_drvdata(&pdev->dev, drv);
562
563	goto exit;
564
565free_dev_exit:
566	nci_free_device(drv->ndev);
567
568free_exit:
569	kfree(drv);
570
571exit:
572	return rc;
573}
574
575static int nfcwilink_remove(struct platform_device *pdev)
576{
577	struct nfcwilink *drv = dev_get_drvdata(&pdev->dev);
578	struct nci_dev *ndev;
579
580	nfc_dev_dbg(&pdev->dev, "remove entry");
581
582	if (!drv)
583		return -EFAULT;
584
585	ndev = drv->ndev;
586
587	nci_unregister_device(ndev);
588	nci_free_device(ndev);
589
590	kfree(drv);
591
592	dev_set_drvdata(&pdev->dev, NULL);
593
594	return 0;
595}
596
597static struct platform_driver nfcwilink_driver = {
598	.probe = nfcwilink_probe,
599	.remove = nfcwilink_remove,
600	.driver = {
601		.name = "nfcwilink",
602		.owner = THIS_MODULE,
603	},
604};
605
606/* ------- Module Init/Exit interfaces ------ */
607static int __init nfcwilink_init(void)
608{
609	printk(KERN_INFO "NFC Driver for TI WiLink");
610
611	return platform_driver_register(&nfcwilink_driver);
612}
613
614static void __exit nfcwilink_exit(void)
615{
616	platform_driver_unregister(&nfcwilink_driver);
617}
618
619module_init(nfcwilink_init);
620module_exit(nfcwilink_exit);
621
622/* ------ Module Info ------ */
623
624MODULE_AUTHOR("Ilan Elias <ilane@ti.com>");
625MODULE_DESCRIPTION("NFC Driver for TI Shared Transport");
626MODULE_LICENSE("GPL");