2 * Copyright (C) 2011 Instituto Nokia de Tecnologia
5 * Lauro Ramos Venancio <lauro.venancio@openbossa.org>
6 * Aloisio Almeida Jr <aloisio.almeida@openbossa.org>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the
20 * Free Software Foundation, Inc.,
21 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
24 #define pr_fmt(fmt) KBUILD_MODNAME ": %s: " fmt, __func__
26 #include <linux/init.h>
27 #include <linux/kernel.h>
28 #include <linux/module.h>
29 #include <linux/slab.h>
30 #include <linux/nfc.h>
36 int nfc_devlist_generation;
37 DEFINE_MUTEX(nfc_devlist_mutex);
40 * nfc_dev_up - turn on the NFC device
42 * @dev: The nfc device to be turned on
44 * The device remains up until the nfc_dev_down function is called.
46 int nfc_dev_up(struct nfc_dev *dev)
50 pr_debug("dev_name=%s\n", dev_name(&dev->dev));
52 device_lock(&dev->dev);
54 if (!device_is_registered(&dev->dev)) {
65 rc = dev->ops->dev_up(dev);
71 device_unlock(&dev->dev);
76 * nfc_dev_down - turn off the NFC device
78 * @dev: The nfc device to be turned off
80 int nfc_dev_down(struct nfc_dev *dev)
84 pr_debug("dev_name=%s\n", dev_name(&dev->dev));
86 device_lock(&dev->dev);
88 if (!device_is_registered(&dev->dev)) {
98 if (dev->polling || dev->remote_activated) {
103 if (dev->ops->dev_down)
104 dev->ops->dev_down(dev);
109 device_unlock(&dev->dev);
114 * nfc_start_poll - start polling for nfc targets
116 * @dev: The nfc device that must start polling
117 * @protocols: bitset of nfc protocols that must be used for polling
119 * The device remains polling for targets until a target is found or
120 * the nfc_stop_poll function is called.
122 int nfc_start_poll(struct nfc_dev *dev, u32 protocols)
126 pr_debug("dev_name=%s protocols=0x%x\n",
127 dev_name(&dev->dev), protocols);
132 device_lock(&dev->dev);
134 if (!device_is_registered(&dev->dev)) {
144 rc = dev->ops->start_poll(dev, protocols);
149 device_unlock(&dev->dev);
154 * nfc_stop_poll - stop polling for nfc targets
156 * @dev: The nfc device that must stop polling
158 int nfc_stop_poll(struct nfc_dev *dev)
162 pr_debug("dev_name=%s\n", dev_name(&dev->dev));
164 device_lock(&dev->dev);
166 if (!device_is_registered(&dev->dev)) {
176 dev->ops->stop_poll(dev);
177 dev->polling = false;
180 device_unlock(&dev->dev);
184 int nfc_dep_link_up(struct nfc_dev *dev, int target_index, u8 comm_mode)
190 pr_debug("dev_name=%s comm %d\n", dev_name(&dev->dev), comm_mode);
192 if (!dev->ops->dep_link_up)
195 device_lock(&dev->dev);
197 if (!device_is_registered(&dev->dev)) {
202 if (dev->dep_link_up == true) {
207 gb = nfc_llcp_general_bytes(dev, &gb_len);
208 if (gb_len > NFC_MAX_GT_LEN) {
213 rc = dev->ops->dep_link_up(dev, target_index, comm_mode, gb, gb_len);
216 device_unlock(&dev->dev);
220 int nfc_dep_link_down(struct nfc_dev *dev)
224 pr_debug("dev_name=%s\n", dev_name(&dev->dev));
226 if (!dev->ops->dep_link_down)
229 device_lock(&dev->dev);
231 if (!device_is_registered(&dev->dev)) {
236 if (dev->dep_link_up == false) {
241 if (dev->dep_rf_mode == NFC_RF_TARGET) {
246 rc = dev->ops->dep_link_down(dev);
248 dev->dep_link_up = false;
249 nfc_llcp_mac_is_down(dev);
250 nfc_genl_dep_link_down_event(dev);
254 device_unlock(&dev->dev);
258 int nfc_dep_link_is_up(struct nfc_dev *dev, u32 target_idx,
259 u8 comm_mode, u8 rf_mode)
261 dev->dep_link_up = true;
262 dev->dep_rf_mode = rf_mode;
264 nfc_llcp_mac_is_up(dev, target_idx, comm_mode, rf_mode);
266 return nfc_genl_dep_link_up_event(dev, target_idx, comm_mode, rf_mode);
268 EXPORT_SYMBOL(nfc_dep_link_is_up);
271 * nfc_activate_target - prepare the target for data exchange
273 * @dev: The nfc device that found the target
274 * @target_idx: index of the target that must be activated
275 * @protocol: nfc protocol that will be used for data exchange
277 int nfc_activate_target(struct nfc_dev *dev, u32 target_idx, u32 protocol)
281 pr_debug("dev_name=%s target_idx=%u protocol=%u\n",
282 dev_name(&dev->dev), target_idx, protocol);
284 device_lock(&dev->dev);
286 if (!device_is_registered(&dev->dev)) {
291 rc = dev->ops->activate_target(dev, target_idx, protocol);
293 dev->remote_activated = true;
296 device_unlock(&dev->dev);
301 * nfc_deactivate_target - deactivate a nfc target
303 * @dev: The nfc device that found the target
304 * @target_idx: index of the target that must be deactivated
306 int nfc_deactivate_target(struct nfc_dev *dev, u32 target_idx)
310 pr_debug("dev_name=%s target_idx=%u\n",
311 dev_name(&dev->dev), target_idx);
313 device_lock(&dev->dev);
315 if (!device_is_registered(&dev->dev)) {
320 dev->ops->deactivate_target(dev, target_idx);
321 dev->remote_activated = false;
324 device_unlock(&dev->dev);
329 * nfc_data_exchange - transceive data
331 * @dev: The nfc device that found the target
332 * @target_idx: index of the target
333 * @skb: data to be sent
334 * @cb: callback called when the response is received
335 * @cb_context: parameter for the callback function
337 * The user must wait for the callback before calling this function again.
339 int nfc_data_exchange(struct nfc_dev *dev, u32 target_idx, struct sk_buff *skb,
340 data_exchange_cb_t cb, void *cb_context)
344 pr_debug("dev_name=%s target_idx=%u skb->len=%u\n",
345 dev_name(&dev->dev), target_idx, skb->len);
347 device_lock(&dev->dev);
349 if (!device_is_registered(&dev->dev)) {
355 rc = dev->ops->data_exchange(dev, target_idx, skb, cb, cb_context);
358 device_unlock(&dev->dev);
362 int nfc_set_remote_general_bytes(struct nfc_dev *dev, u8 *gb, u8 gb_len)
364 pr_debug("dev_name=%s gb_len=%d\n", dev_name(&dev->dev), gb_len);
366 if (gb_len > NFC_MAX_GT_LEN)
369 return nfc_llcp_set_remote_gb(dev, gb, gb_len);
371 EXPORT_SYMBOL(nfc_set_remote_general_bytes);
374 * nfc_alloc_send_skb - allocate a skb for data exchange responses
376 * @size: size to allocate
379 struct sk_buff *nfc_alloc_send_skb(struct nfc_dev *dev, struct sock *sk,
380 unsigned int flags, unsigned int size,
384 unsigned int total_size;
387 dev->tx_headroom + dev->tx_tailroom + NFC_HEADER_SIZE;
389 skb = sock_alloc_send_skb(sk, total_size, flags & MSG_DONTWAIT, err);
391 skb_reserve(skb, dev->tx_headroom + NFC_HEADER_SIZE);
397 * nfc_alloc_recv_skb - allocate a skb for data exchange responses
399 * @size: size to allocate
402 struct sk_buff *nfc_alloc_recv_skb(unsigned int size, gfp_t gfp)
405 unsigned int total_size;
407 total_size = size + 1;
408 skb = alloc_skb(total_size, gfp);
415 EXPORT_SYMBOL(nfc_alloc_recv_skb);
418 * nfc_targets_found - inform that targets were found
420 * @dev: The nfc device that found the targets
421 * @targets: array of nfc targets found
422 * @ntargets: targets array size
424 * The device driver must call this function when one or many nfc targets
425 * are found. After calling this function, the device driver must stop
426 * polling for targets.
428 int nfc_targets_found(struct nfc_dev *dev,
429 struct nfc_target *targets, int n_targets)
431 pr_debug("dev_name=%s n_targets=%d\n", dev_name(&dev->dev), n_targets);
433 dev->polling = false;
435 spin_lock_bh(&dev->targets_lock);
437 dev->targets_generation++;
440 dev->targets = kmemdup(targets, n_targets * sizeof(struct nfc_target),
445 spin_unlock_bh(&dev->targets_lock);
449 dev->n_targets = n_targets;
450 spin_unlock_bh(&dev->targets_lock);
452 nfc_genl_targets_found(dev);
456 EXPORT_SYMBOL(nfc_targets_found);
458 static void nfc_release(struct device *d)
460 struct nfc_dev *dev = to_nfc_dev(d);
462 pr_debug("dev_name=%s\n", dev_name(&dev->dev));
464 nfc_genl_data_exit(&dev->genl_data);
469 struct class nfc_class = {
471 .dev_release = nfc_release,
473 EXPORT_SYMBOL(nfc_class);
475 static int match_idx(struct device *d, void *data)
477 struct nfc_dev *dev = to_nfc_dev(d);
478 unsigned *idx = data;
480 return dev->idx == *idx;
483 struct nfc_dev *nfc_get_device(unsigned idx)
487 d = class_find_device(&nfc_class, NULL, &idx, match_idx);
491 return to_nfc_dev(d);
495 * nfc_allocate_device - allocate a new nfc device
497 * @ops: device operations
498 * @supported_protocols: NFC protocols supported by the device
500 struct nfc_dev *nfc_allocate_device(struct nfc_ops *ops,
501 u32 supported_protocols,
502 int tx_headroom, int tx_tailroom)
504 static atomic_t dev_no = ATOMIC_INIT(0);
507 if (!ops->start_poll || !ops->stop_poll || !ops->activate_target ||
508 !ops->deactivate_target || !ops->data_exchange)
511 if (!supported_protocols)
514 dev = kzalloc(sizeof(struct nfc_dev), GFP_KERNEL);
518 dev->dev.class = &nfc_class;
519 dev->idx = atomic_inc_return(&dev_no) - 1;
520 dev_set_name(&dev->dev, "nfc%d", dev->idx);
521 device_initialize(&dev->dev);
524 dev->supported_protocols = supported_protocols;
525 dev->tx_headroom = tx_headroom;
526 dev->tx_tailroom = tx_tailroom;
528 spin_lock_init(&dev->targets_lock);
529 nfc_genl_data_init(&dev->genl_data);
531 /* first generation must not be 0 */
532 dev->targets_generation = 1;
536 EXPORT_SYMBOL(nfc_allocate_device);
539 * nfc_register_device - register a nfc device in the nfc subsystem
541 * @dev: The nfc device to register
543 int nfc_register_device(struct nfc_dev *dev)
547 pr_debug("dev_name=%s\n", dev_name(&dev->dev));
549 mutex_lock(&nfc_devlist_mutex);
550 nfc_devlist_generation++;
551 rc = device_add(&dev->dev);
552 mutex_unlock(&nfc_devlist_mutex);
557 rc = nfc_llcp_register_device(dev);
559 pr_err("Could not register llcp device\n");
561 rc = nfc_genl_device_added(dev);
563 pr_debug("The userspace won't be notified that the device %s was added\n",
564 dev_name(&dev->dev));
568 EXPORT_SYMBOL(nfc_register_device);
571 * nfc_unregister_device - unregister a nfc device in the nfc subsystem
573 * @dev: The nfc device to unregister
575 void nfc_unregister_device(struct nfc_dev *dev)
579 pr_debug("dev_name=%s\n", dev_name(&dev->dev));
581 mutex_lock(&nfc_devlist_mutex);
582 nfc_devlist_generation++;
584 /* lock to avoid unregistering a device while an operation
586 device_lock(&dev->dev);
587 device_del(&dev->dev);
588 device_unlock(&dev->dev);
590 mutex_unlock(&nfc_devlist_mutex);
592 nfc_llcp_unregister_device(dev);
594 rc = nfc_genl_device_removed(dev);
596 pr_debug("The userspace won't be notified that the device %s was removed\n",
597 dev_name(&dev->dev));
600 EXPORT_SYMBOL(nfc_unregister_device);
602 static int __init nfc_init(void)
606 pr_info("NFC Core ver %s\n", VERSION);
608 rc = class_register(&nfc_class);
612 rc = nfc_genl_init();
616 /* the first generation must not be 0 */
617 nfc_devlist_generation = 1;
623 rc = nfc_llcp_init();
640 class_unregister(&nfc_class);
644 static void __exit nfc_exit(void)
650 class_unregister(&nfc_class);
653 subsys_initcall(nfc_init);
654 module_exit(nfc_exit);
656 MODULE_AUTHOR("Lauro Ramos Venancio <lauro.venancio@openbossa.org>");
657 MODULE_DESCRIPTION("NFC Core ver " VERSION);
658 MODULE_VERSION(VERSION);
659 MODULE_LICENSE("GPL");