1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3 * Driver for NXP PN533 NFC Chip - USB transport layer
4 *
5 * Copyright (C) 2011 Instituto Nokia de Tecnologia
6 * Copyright (C) 2012-2013 Tieto Poland
7 */
8
9 #include <linux/device.h>
10 #include <linux/kernel.h>
11 #include <linux/module.h>
12 #include <linux/slab.h>
13 #include <linux/usb.h>
14 #include <linux/nfc.h>
15 #include <linux/netdevice.h>
16 #include <net/nfc/nfc.h>
17 #include "pn533.h"
18
19 #define VERSION "0.1"
20
21 #define PN533_VENDOR_ID 0x4CC
22 #define PN533_PRODUCT_ID 0x2533
23
24 #define SCM_VENDOR_ID 0x4E6
25 #define SCL3711_PRODUCT_ID 0x5591
26
27 #define SONY_VENDOR_ID 0x054c
28 #define PASORI_PRODUCT_ID 0x02e1
29
30 #define ACS_VENDOR_ID 0x072f
31 #define ACR122U_PRODUCT_ID 0x2200
32
33 static const struct usb_device_id pn533_usb_table[] = {
34 { USB_DEVICE(PN533_VENDOR_ID, PN533_PRODUCT_ID),
35 .driver_info = PN533_DEVICE_STD },
36 { USB_DEVICE(SCM_VENDOR_ID, SCL3711_PRODUCT_ID),
37 .driver_info = PN533_DEVICE_STD },
38 { USB_DEVICE(SONY_VENDOR_ID, PASORI_PRODUCT_ID),
39 .driver_info = PN533_DEVICE_PASORI },
40 { USB_DEVICE(ACS_VENDOR_ID, ACR122U_PRODUCT_ID),
41 .driver_info = PN533_DEVICE_ACR122U },
42 { }
43 };
44 MODULE_DEVICE_TABLE(usb, pn533_usb_table);
45
46 struct pn533_usb_phy {
47 struct usb_device *udev;
48 struct usb_interface *interface;
49
50 struct urb *out_urb;
51 struct urb *in_urb;
52
53 struct urb *ack_urb;
54 u8 *ack_buffer;
55
56 struct pn533 *priv;
57 };
58
pn533_recv_response(struct urb * urb)59 static void pn533_recv_response(struct urb *urb)
60 {
61 struct pn533_usb_phy *phy = urb->context;
62 struct sk_buff *skb = NULL;
63
64 if (!urb->status) {
65 skb = alloc_skb(urb->actual_length, GFP_ATOMIC);
66 if (!skb) {
67 nfc_err(&phy->udev->dev, "failed to alloc memory\n");
68 } else {
69 skb_put_data(skb, urb->transfer_buffer,
70 urb->actual_length);
71 }
72 }
73
74 pn533_recv_frame(phy->priv, skb, urb->status);
75 }
76
pn533_submit_urb_for_response(struct pn533_usb_phy * phy,gfp_t flags)77 static int pn533_submit_urb_for_response(struct pn533_usb_phy *phy, gfp_t flags)
78 {
79 phy->in_urb->complete = pn533_recv_response;
80
81 return usb_submit_urb(phy->in_urb, flags);
82 }
83
pn533_recv_ack(struct urb * urb)84 static void pn533_recv_ack(struct urb *urb)
85 {
86 struct pn533_usb_phy *phy = urb->context;
87 struct pn533 *priv = phy->priv;
88 struct pn533_cmd *cmd = priv->cmd;
89 struct pn533_std_frame *in_frame;
90 int rc;
91
92 cmd->status = urb->status;
93
94 switch (urb->status) {
95 case 0:
96 break; /* success */
97 case -ECONNRESET:
98 case -ENOENT:
99 dev_dbg(&phy->udev->dev,
100 "The urb has been stopped (status %d)\n",
101 urb->status);
102 goto sched_wq;
103 case -ESHUTDOWN:
104 default:
105 nfc_err(&phy->udev->dev,
106 "Urb failure (status %d)\n", urb->status);
107 goto sched_wq;
108 }
109
110 in_frame = phy->in_urb->transfer_buffer;
111
112 if (!pn533_rx_frame_is_ack(in_frame)) {
113 nfc_err(&phy->udev->dev, "Received an invalid ack\n");
114 cmd->status = -EIO;
115 goto sched_wq;
116 }
117
118 rc = pn533_submit_urb_for_response(phy, GFP_ATOMIC);
119 if (rc) {
120 nfc_err(&phy->udev->dev,
121 "usb_submit_urb failed with result %d\n", rc);
122 cmd->status = rc;
123 goto sched_wq;
124 }
125
126 return;
127
128 sched_wq:
129 queue_work(priv->wq, &priv->cmd_complete_work);
130 }
131
pn533_submit_urb_for_ack(struct pn533_usb_phy * phy,gfp_t flags)132 static int pn533_submit_urb_for_ack(struct pn533_usb_phy *phy, gfp_t flags)
133 {
134 phy->in_urb->complete = pn533_recv_ack;
135
136 return usb_submit_urb(phy->in_urb, flags);
137 }
138
pn533_usb_send_ack(struct pn533 * dev,gfp_t flags)139 static int pn533_usb_send_ack(struct pn533 *dev, gfp_t flags)
140 {
141 struct pn533_usb_phy *phy = dev->phy;
142 static const u8 ack[6] = {0x00, 0x00, 0xff, 0x00, 0xff, 0x00};
143 /* spec 7.1.1.3: Preamble, SoPC (2), ACK Code (2), Postamble */
144
145 if (!phy->ack_buffer) {
146 phy->ack_buffer = kmemdup(ack, sizeof(ack), flags);
147 if (!phy->ack_buffer)
148 return -ENOMEM;
149 }
150
151 phy->ack_urb->transfer_buffer = phy->ack_buffer;
152 phy->ack_urb->transfer_buffer_length = sizeof(ack);
153 return usb_submit_urb(phy->ack_urb, flags);
154 }
155
156 struct pn533_out_arg {
157 struct pn533_usb_phy *phy;
158 struct completion done;
159 };
160
pn533_usb_send_frame(struct pn533 * dev,struct sk_buff * out)161 static int pn533_usb_send_frame(struct pn533 *dev,
162 struct sk_buff *out)
163 {
164 struct pn533_usb_phy *phy = dev->phy;
165 struct pn533_out_arg arg;
166 void *cntx;
167 int rc;
168
169 if (phy->priv == NULL)
170 phy->priv = dev;
171
172 phy->out_urb->transfer_buffer = out->data;
173 phy->out_urb->transfer_buffer_length = out->len;
174
175 print_hex_dump_debug("PN533 TX: ", DUMP_PREFIX_NONE, 16, 1,
176 out->data, out->len, false);
177
178 arg.phy = phy;
179 init_completion(&arg.done);
180 cntx = phy->out_urb->context;
181 phy->out_urb->context = &arg;
182
183 rc = usb_submit_urb(phy->out_urb, GFP_KERNEL);
184 if (rc)
185 return rc;
186
187 wait_for_completion(&arg.done);
188 phy->out_urb->context = cntx;
189
190 if (dev->protocol_type == PN533_PROTO_REQ_RESP) {
191 /* request for response for sent packet directly */
192 rc = pn533_submit_urb_for_response(phy, GFP_KERNEL);
193 if (rc)
194 goto error;
195 } else if (dev->protocol_type == PN533_PROTO_REQ_ACK_RESP) {
196 /* request for ACK if that's the case */
197 rc = pn533_submit_urb_for_ack(phy, GFP_KERNEL);
198 if (rc)
199 goto error;
200 }
201
202 return 0;
203
204 error:
205 usb_unlink_urb(phy->out_urb);
206 return rc;
207 }
208
pn533_usb_abort_cmd(struct pn533 * dev,gfp_t flags)209 static void pn533_usb_abort_cmd(struct pn533 *dev, gfp_t flags)
210 {
211 struct pn533_usb_phy *phy = dev->phy;
212
213 /* ACR122U does not support any command which aborts last
214 * issued command i.e. as ACK for standard PN533. Additionally,
215 * it behaves stange, sending broken or incorrect responses,
216 * when we cancel urb before the chip will send response.
217 */
218 if (dev->device_type == PN533_DEVICE_ACR122U)
219 return;
220
221 /* An ack will cancel the last issued command */
222 pn533_usb_send_ack(dev, flags);
223
224 /* cancel the urb request */
225 usb_kill_urb(phy->in_urb);
226 }
227
228 /* ACR122 specific structs and functions */
229
230 /* ACS ACR122 pn533 frame definitions */
231 #define PN533_ACR122_TX_FRAME_HEADER_LEN (sizeof(struct pn533_acr122_tx_frame) \
232 + 2)
233 #define PN533_ACR122_TX_FRAME_TAIL_LEN 0
234 #define PN533_ACR122_RX_FRAME_HEADER_LEN (sizeof(struct pn533_acr122_rx_frame) \
235 + 2)
236 #define PN533_ACR122_RX_FRAME_TAIL_LEN 2
237 #define PN533_ACR122_FRAME_MAX_PAYLOAD_LEN PN533_STD_FRAME_MAX_PAYLOAD_LEN
238
239 /* CCID messages types */
240 #define PN533_ACR122_PC_TO_RDR_ICCPOWERON 0x62
241 #define PN533_ACR122_PC_TO_RDR_ESCAPE 0x6B
242
243 #define PN533_ACR122_RDR_TO_PC_ESCAPE 0x83
244
245
246 struct pn533_acr122_ccid_hdr {
247 u8 type;
248 u32 datalen;
249 u8 slot;
250 u8 seq;
251
252 /*
253 * 3 msg specific bytes or status, error and 1 specific
254 * byte for reposnse msg
255 */
256 u8 params[3];
257 } __packed;
258
259 struct pn533_acr122_apdu_hdr {
260 u8 class;
261 u8 ins;
262 u8 p1;
263 u8 p2;
264 } __packed;
265
266 struct pn533_acr122_tx_frame {
267 struct pn533_acr122_ccid_hdr ccid;
268 struct pn533_acr122_apdu_hdr apdu;
269 u8 datalen;
270 u8 data[]; /* pn533 frame: TFI ... */
271 } __packed;
272
273 struct pn533_acr122_rx_frame {
274 struct pn533_acr122_ccid_hdr ccid;
275 u8 data[]; /* pn533 frame : TFI ... */
276 } __packed;
277
pn533_acr122_tx_frame_init(void * _frame,u8 cmd_code)278 static void pn533_acr122_tx_frame_init(void *_frame, u8 cmd_code)
279 {
280 struct pn533_acr122_tx_frame *frame = _frame;
281
282 frame->ccid.type = PN533_ACR122_PC_TO_RDR_ESCAPE;
283 /* sizeof(apdu_hdr) + sizeof(datalen) */
284 frame->ccid.datalen = sizeof(frame->apdu) + 1;
285 frame->ccid.slot = 0;
286 frame->ccid.seq = 0;
287 frame->ccid.params[0] = 0;
288 frame->ccid.params[1] = 0;
289 frame->ccid.params[2] = 0;
290
291 frame->data[0] = PN533_STD_FRAME_DIR_OUT;
292 frame->data[1] = cmd_code;
293 frame->datalen = 2; /* data[0] + data[1] */
294
295 frame->apdu.class = 0xFF;
296 frame->apdu.ins = 0;
297 frame->apdu.p1 = 0;
298 frame->apdu.p2 = 0;
299 }
300
pn533_acr122_tx_frame_finish(void * _frame)301 static void pn533_acr122_tx_frame_finish(void *_frame)
302 {
303 struct pn533_acr122_tx_frame *frame = _frame;
304
305 frame->ccid.datalen += frame->datalen;
306 }
307
pn533_acr122_tx_update_payload_len(void * _frame,int len)308 static void pn533_acr122_tx_update_payload_len(void *_frame, int len)
309 {
310 struct pn533_acr122_tx_frame *frame = _frame;
311
312 frame->datalen += len;
313 }
314
pn533_acr122_is_rx_frame_valid(void * _frame,struct pn533 * dev)315 static bool pn533_acr122_is_rx_frame_valid(void *_frame, struct pn533 *dev)
316 {
317 struct pn533_acr122_rx_frame *frame = _frame;
318
319 if (frame->ccid.type != 0x83)
320 return false;
321
322 if (!frame->ccid.datalen)
323 return false;
324
325 if (frame->data[frame->ccid.datalen - 2] == 0x63)
326 return false;
327
328 return true;
329 }
330
pn533_acr122_rx_frame_size(void * frame)331 static int pn533_acr122_rx_frame_size(void *frame)
332 {
333 struct pn533_acr122_rx_frame *f = frame;
334
335 /* f->ccid.datalen already includes tail length */
336 return sizeof(struct pn533_acr122_rx_frame) + f->ccid.datalen;
337 }
338
pn533_acr122_get_cmd_code(void * frame)339 static u8 pn533_acr122_get_cmd_code(void *frame)
340 {
341 struct pn533_acr122_rx_frame *f = frame;
342
343 return PN533_FRAME_CMD(f);
344 }
345
346 static struct pn533_frame_ops pn533_acr122_frame_ops = {
347 .tx_frame_init = pn533_acr122_tx_frame_init,
348 .tx_frame_finish = pn533_acr122_tx_frame_finish,
349 .tx_update_payload_len = pn533_acr122_tx_update_payload_len,
350 .tx_header_len = PN533_ACR122_TX_FRAME_HEADER_LEN,
351 .tx_tail_len = PN533_ACR122_TX_FRAME_TAIL_LEN,
352
353 .rx_is_frame_valid = pn533_acr122_is_rx_frame_valid,
354 .rx_header_len = PN533_ACR122_RX_FRAME_HEADER_LEN,
355 .rx_tail_len = PN533_ACR122_RX_FRAME_TAIL_LEN,
356 .rx_frame_size = pn533_acr122_rx_frame_size,
357
358 .max_payload_len = PN533_ACR122_FRAME_MAX_PAYLOAD_LEN,
359 .get_cmd_code = pn533_acr122_get_cmd_code,
360 };
361
362 struct pn533_acr122_poweron_rdr_arg {
363 int rc;
364 struct completion done;
365 };
366
pn533_acr122_poweron_rdr_resp(struct urb * urb)367 static void pn533_acr122_poweron_rdr_resp(struct urb *urb)
368 {
369 struct pn533_acr122_poweron_rdr_arg *arg = urb->context;
370
371 print_hex_dump_debug("ACR122 RX: ", DUMP_PREFIX_NONE, 16, 1,
372 urb->transfer_buffer, urb->transfer_buffer_length,
373 false);
374
375 arg->rc = urb->status;
376 complete(&arg->done);
377 }
378
pn533_acr122_poweron_rdr(struct pn533_usb_phy * phy)379 static int pn533_acr122_poweron_rdr(struct pn533_usb_phy *phy)
380 {
381 /* Power on th reader (CCID cmd) */
382 u8 cmd[10] = {PN533_ACR122_PC_TO_RDR_ICCPOWERON,
383 0, 0, 0, 0, 0, 0, 3, 0, 0};
384 char *buffer;
385 int transferred;
386 int rc;
387 void *cntx;
388 struct pn533_acr122_poweron_rdr_arg arg;
389
390 buffer = kmemdup(cmd, sizeof(cmd), GFP_KERNEL);
391 if (!buffer)
392 return -ENOMEM;
393
394 init_completion(&arg.done);
395 cntx = phy->in_urb->context; /* backup context */
396
397 phy->in_urb->complete = pn533_acr122_poweron_rdr_resp;
398 phy->in_urb->context = &arg;
399
400 print_hex_dump_debug("ACR122 TX: ", DUMP_PREFIX_NONE, 16, 1,
401 cmd, sizeof(cmd), false);
402
403 rc = usb_bulk_msg(phy->udev, phy->out_urb->pipe, buffer, sizeof(cmd),
404 &transferred, 5000);
405 kfree(buffer);
406 if (rc || (transferred != sizeof(cmd))) {
407 nfc_err(&phy->udev->dev,
408 "Reader power on cmd error %d\n", rc);
409 return rc ?: -EINVAL;
410 }
411
412 rc = usb_submit_urb(phy->in_urb, GFP_KERNEL);
413 if (rc) {
414 nfc_err(&phy->udev->dev,
415 "Can't submit reader poweron cmd response %d\n", rc);
416 return rc;
417 }
418
419 wait_for_completion(&arg.done);
420 phy->in_urb->context = cntx; /* restore context */
421
422 return arg.rc;
423 }
424
pn533_out_complete(struct urb * urb)425 static void pn533_out_complete(struct urb *urb)
426 {
427 struct pn533_out_arg *arg = urb->context;
428 struct pn533_usb_phy *phy = arg->phy;
429
430 switch (urb->status) {
431 case 0:
432 break; /* success */
433 case -ECONNRESET:
434 case -ENOENT:
435 dev_dbg(&phy->udev->dev,
436 "The urb has been stopped (status %d)\n",
437 urb->status);
438 break;
439 case -ESHUTDOWN:
440 default:
441 nfc_err(&phy->udev->dev,
442 "Urb failure (status %d)\n",
443 urb->status);
444 }
445
446 complete(&arg->done);
447 }
448
pn533_ack_complete(struct urb * urb)449 static void pn533_ack_complete(struct urb *urb)
450 {
451 struct pn533_usb_phy *phy = urb->context;
452
453 switch (urb->status) {
454 case 0:
455 break; /* success */
456 case -ECONNRESET:
457 case -ENOENT:
458 dev_dbg(&phy->udev->dev,
459 "The urb has been stopped (status %d)\n",
460 urb->status);
461 break;
462 case -ESHUTDOWN:
463 default:
464 nfc_err(&phy->udev->dev,
465 "Urb failure (status %d)\n",
466 urb->status);
467 }
468 }
469
470 static const struct pn533_phy_ops usb_phy_ops = {
471 .send_frame = pn533_usb_send_frame,
472 .send_ack = pn533_usb_send_ack,
473 .abort_cmd = pn533_usb_abort_cmd,
474 };
475
pn533_usb_probe(struct usb_interface * interface,const struct usb_device_id * id)476 static int pn533_usb_probe(struct usb_interface *interface,
477 const struct usb_device_id *id)
478 {
479 struct usb_endpoint_descriptor *ep_in, *ep_out;
480 struct pn533 *priv;
481 struct pn533_usb_phy *phy;
482 u32 protocols;
483 enum pn533_protocol_type protocol_type = PN533_PROTO_REQ_ACK_RESP;
484 struct pn533_frame_ops *fops = NULL;
485 unsigned char *in_buf;
486 int in_buf_len = PN533_EXT_FRAME_HEADER_LEN +
487 PN533_STD_FRAME_MAX_PAYLOAD_LEN +
488 PN533_STD_FRAME_TAIL_LEN;
489 int rc;
490
491 phy = devm_kzalloc(&interface->dev, sizeof(*phy), GFP_KERNEL);
492 if (!phy)
493 return -ENOMEM;
494
495 in_buf = kzalloc(in_buf_len, GFP_KERNEL);
496 if (!in_buf)
497 return -ENOMEM;
498
499 phy->udev = interface_to_usbdev(interface);
500 phy->interface = interface;
501
502 rc = usb_find_common_endpoints(interface->cur_altsetting, &ep_in,
503 &ep_out, NULL, NULL);
504 if (rc) {
505 nfc_err(&interface->dev,
506 "Could not find bulk-in or bulk-out endpoint\n");
507 goto error;
508 }
509
510 phy->in_urb = usb_alloc_urb(0, GFP_KERNEL);
511 phy->out_urb = usb_alloc_urb(0, GFP_KERNEL);
512 phy->ack_urb = usb_alloc_urb(0, GFP_KERNEL);
513
514 if (!phy->in_urb || !phy->out_urb || !phy->ack_urb) {
515 rc = -ENOMEM;
516 goto error;
517 }
518
519 usb_fill_bulk_urb(phy->in_urb, phy->udev,
520 usb_rcvbulkpipe(phy->udev, usb_endpoint_num(ep_in)),
521 in_buf, in_buf_len, NULL, phy);
522
523 usb_fill_bulk_urb(phy->out_urb, phy->udev,
524 usb_sndbulkpipe(phy->udev, usb_endpoint_num(ep_out)),
525 NULL, 0, pn533_out_complete, phy);
526 usb_fill_bulk_urb(phy->ack_urb, phy->udev,
527 usb_sndbulkpipe(phy->udev, usb_endpoint_num(ep_out)),
528 NULL, 0, pn533_ack_complete, phy);
529
530 switch (id->driver_info) {
531 case PN533_DEVICE_STD:
532 protocols = PN533_ALL_PROTOCOLS;
533 break;
534
535 case PN533_DEVICE_PASORI:
536 protocols = PN533_NO_TYPE_B_PROTOCOLS;
537 break;
538
539 case PN533_DEVICE_ACR122U:
540 protocols = PN533_NO_TYPE_B_PROTOCOLS;
541 fops = &pn533_acr122_frame_ops;
542 protocol_type = PN533_PROTO_REQ_RESP;
543
544 rc = pn533_acr122_poweron_rdr(phy);
545 if (rc < 0) {
546 nfc_err(&interface->dev,
547 "Couldn't poweron the reader (error %d)\n", rc);
548 goto error;
549 }
550 break;
551
552 default:
553 nfc_err(&interface->dev, "Unknown device type %lu\n",
554 id->driver_info);
555 rc = -EINVAL;
556 goto error;
557 }
558
559 priv = pn53x_common_init(id->driver_info, protocol_type,
560 phy, &usb_phy_ops, fops,
561 &phy->udev->dev);
562
563 if (IS_ERR(priv)) {
564 rc = PTR_ERR(priv);
565 goto error;
566 }
567
568 phy->priv = priv;
569
570 rc = pn533_finalize_setup(priv);
571 if (rc)
572 goto err_clean;
573
574 usb_set_intfdata(interface, phy);
575 rc = pn53x_register_nfc(priv, protocols, &interface->dev);
576 if (rc)
577 goto err_clean;
578
579 return 0;
580
581 err_clean:
582 pn53x_common_clean(priv);
583 error:
584 usb_kill_urb(phy->in_urb);
585 usb_kill_urb(phy->out_urb);
586 usb_kill_urb(phy->ack_urb);
587
588 usb_free_urb(phy->in_urb);
589 usb_free_urb(phy->out_urb);
590 usb_free_urb(phy->ack_urb);
591 kfree(in_buf);
592 kfree(phy->ack_buffer);
593
594 return rc;
595 }
596
pn533_usb_disconnect(struct usb_interface * interface)597 static void pn533_usb_disconnect(struct usb_interface *interface)
598 {
599 struct pn533_usb_phy *phy = usb_get_intfdata(interface);
600
601 if (!phy)
602 return;
603
604 pn53x_unregister_nfc(phy->priv);
605 pn53x_common_clean(phy->priv);
606
607 usb_set_intfdata(interface, NULL);
608
609 usb_kill_urb(phy->in_urb);
610 usb_kill_urb(phy->out_urb);
611 usb_kill_urb(phy->ack_urb);
612
613 kfree(phy->in_urb->transfer_buffer);
614 usb_free_urb(phy->in_urb);
615 usb_free_urb(phy->out_urb);
616 usb_free_urb(phy->ack_urb);
617 kfree(phy->ack_buffer);
618
619 nfc_info(&interface->dev, "NXP PN533 NFC device disconnected\n");
620 }
621
622 static struct usb_driver pn533_usb_driver = {
623 .name = "pn533_usb",
624 .probe = pn533_usb_probe,
625 .disconnect = pn533_usb_disconnect,
626 .id_table = pn533_usb_table,
627 };
628
629 module_usb_driver(pn533_usb_driver);
630
631 MODULE_AUTHOR("Lauro Ramos Venancio <lauro.venancio@openbossa.org>");
632 MODULE_AUTHOR("Aloisio Almeida Jr <aloisio.almeida@openbossa.org>");
633 MODULE_AUTHOR("Waldemar Rymarkiewicz <waldemar.rymarkiewicz@tieto.com>");
634 MODULE_DESCRIPTION("PN533 USB driver ver " VERSION);
635 MODULE_VERSION(VERSION);
636 MODULE_LICENSE("GPL");
637