blob: c2aee4875b6562db2ec64b7a8c2f7b17ca1b6408 [file] [log] [blame]
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -03001/*
2 * Copyright (C) 2011 Instituto Nokia de Tecnologia
3 *
4 * Authors:
5 * Lauro Ramos Venancio <lauro.venancio@openbossa.org>
6 * Aloisio Almeida Jr <aloisio.almeida@openbossa.org>
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 as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 *
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.
17 *
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.
22 */
23
24#ifndef __NET_NFC_H
25#define __NET_NFC_H
26
Ilan Eliasd5a2ca62012-01-17 11:06:43 +020027#include <linux/nfc.h>
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -030028#include <linux/device.h>
29#include <linux/skbuff.h>
30
Joe Perches073a6252013-04-05 12:27:38 -070031#define nfc_info(dev, fmt, ...) dev_info((dev), "NFC: " fmt, ##__VA_ARGS__)
32#define nfc_err(dev, fmt, ...) dev_err((dev), "NFC: " fmt, ##__VA_ARGS__)
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -030033
Eric Lapuyade08f13ac2013-09-03 11:51:00 +020034struct nfc_phy_ops {
35 int (*write)(void *dev_id, struct sk_buff *skb);
36 int (*enable)(void *dev_id);
37 void (*disable)(void *dev_id);
38};
39
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -030040struct nfc_dev;
41
42/**
43 * data_exchange_cb_t - Definition of nfc_data_exchange callback
44 *
45 * @context: nfc_data_exchange cb_context parameter
46 * @skb: response data
47 * @err: If an error has occurred during data exchange, it is the
48 * error number. Zero means no error.
49 *
50 * When a rx or tx package is lost or corrupted or the target gets out
51 * of the operating field, err is -EIO.
52 */
53typedef void (*data_exchange_cb_t)(void *context, struct sk_buff *skb,
54 int err);
55
Eric Lapuyade90099432012-05-07 12:31:13 +020056struct nfc_target;
57
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -030058struct nfc_ops {
Ilan Elias8b3fe7b2011-09-18 11:19:33 +030059 int (*dev_up)(struct nfc_dev *dev);
60 int (*dev_down)(struct nfc_dev *dev);
Samuel Ortizfe7c5802012-05-15 15:57:06 +020061 int (*start_poll)(struct nfc_dev *dev,
62 u32 im_protocols, u32 tm_protocols);
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -030063 void (*stop_poll)(struct nfc_dev *dev);
Eric Lapuyade90099432012-05-07 12:31:13 +020064 int (*dep_link_up)(struct nfc_dev *dev, struct nfc_target *target,
65 u8 comm_mode, u8 *gb, size_t gb_len);
Samuel Ortiz1ed28f62011-12-14 16:43:09 +010066 int (*dep_link_down)(struct nfc_dev *dev);
Eric Lapuyade90099432012-05-07 12:31:13 +020067 int (*activate_target)(struct nfc_dev *dev, struct nfc_target *target,
Samuel Ortiz0a40acb2012-03-05 01:03:53 +010068 u32 protocol);
Eric Lapuyade90099432012-05-07 12:31:13 +020069 void (*deactivate_target)(struct nfc_dev *dev,
70 struct nfc_target *target);
Samuel Ortizbe9ae4c2012-05-16 15:55:48 +020071 int (*im_transceive)(struct nfc_dev *dev, struct nfc_target *target,
Samuel Ortiz0a40acb2012-03-05 01:03:53 +010072 struct sk_buff *skb, data_exchange_cb_t cb,
73 void *cb_context);
Samuel Ortizbe9ae4c2012-05-16 15:55:48 +020074 int (*tm_send)(struct nfc_dev *dev, struct sk_buff *skb);
Eric Lapuyade90099432012-05-07 12:31:13 +020075 int (*check_presence)(struct nfc_dev *dev, struct nfc_target *target);
Samuel Ortiz9ea71872013-07-31 01:19:43 +020076 int (*fw_download)(struct nfc_dev *dev, const char *firmware_name);
Samuel Ortiz0a946302013-05-10 11:57:06 +020077
78 /* Secure Element API */
79 int (*discover_se)(struct nfc_dev *dev);
80 int (*enable_se)(struct nfc_dev *dev, u32 se_idx);
81 int (*disable_se)(struct nfc_dev *dev, u32 se_idx);
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -030082};
83
Samuel Ortiz1ed28f62011-12-14 16:43:09 +010084#define NFC_TARGET_IDX_ANY -1
85#define NFC_MAX_GT_LEN 48
Ilan Elias767f19a2012-08-15 11:46:24 +030086#define NFC_ATR_RES_GT_OFFSET 15
Samuel Ortiz1ed28f62011-12-14 16:43:09 +010087
Lauro Ramos Venancio4d12b8b2011-07-01 19:31:34 -030088struct nfc_target {
89 u32 idx;
90 u32 supported_protocols;
91 u16 sens_res;
92 u8 sel_res;
Ilan Elias288e0712011-12-22 11:51:54 +020093 u8 nfcid1_len;
Ilan Eliasd5a2ca62012-01-17 11:06:43 +020094 u8 nfcid1[NFC_NFCID1_MAXSIZE];
Samuel Ortiz322bce92013-05-27 15:29:11 +020095 u8 nfcid2_len;
96 u8 nfcid2[NFC_NFCID2_MAXSIZE];
Ilan Eliasd5a2ca62012-01-17 11:06:43 +020097 u8 sensb_res_len;
98 u8 sensb_res[NFC_SENSB_RES_MAXSIZE];
99 u8 sensf_res_len;
100 u8 sensf_res[NFC_SENSF_RES_MAXSIZE];
Eric Lapuyade8b8d2e02012-04-10 19:43:06 +0200101 u8 hci_reader_gate;
Samuel Ortizc4fbb652012-04-10 19:43:09 +0200102 u8 logical_idx;
Lauro Ramos Venancio4d12b8b2011-07-01 19:31:34 -0300103};
104
Samuel Ortizfed7c252013-05-10 15:28:38 +0200105/**
106 * nfc_se - A structure for NFC accessible secure elements.
107 *
108 * @idx: The secure element index. User space will enable or
109 * disable a secure element by its index.
110 * @type: The secure element type. It can be SE_UICC or
111 * SE_EMBEDDED.
112 * @state: The secure element state, either enabled or disabled.
113 *
114 */
115struct nfc_se {
116 struct list_head list;
117 u32 idx;
118 u16 type;
119 u16 state;
120};
121
Lauro Ramos Venancio4d12b8b2011-07-01 19:31:34 -0300122struct nfc_genl_data {
Eric W. Biederman15e47302012-09-07 20:12:54 +0000123 u32 poll_req_portid;
Lauro Ramos Venancio4d12b8b2011-07-01 19:31:34 -0300124 struct mutex genl_data_mutex;
125};
126
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -0300127struct nfc_dev {
Samuel Ortiz7eda8b8e92012-10-22 15:57:58 +0200128 int idx;
Eric Lapuyade01ae0ee2012-04-10 19:43:10 +0200129 u32 target_next_idx;
Lauro Ramos Venancio4d12b8b2011-07-01 19:31:34 -0300130 struct nfc_target *targets;
131 int n_targets;
132 int targets_generation;
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -0300133 struct device dev;
Ilan Elias8b3fe7b2011-09-18 11:19:33 +0300134 bool dev_up;
Samuel Ortiz9ea71872013-07-31 01:19:43 +0200135 bool fw_download_in_progress;
Samuel Ortizf212ad52012-05-31 00:02:26 +0200136 u8 rf_mode;
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -0300137 bool polling;
Eric Lapuyade90099432012-05-07 12:31:13 +0200138 struct nfc_target *active_target;
Samuel Ortiz1ed28f62011-12-14 16:43:09 +0100139 bool dep_link_up;
Lauro Ramos Venancio4d12b8b2011-07-01 19:31:34 -0300140 struct nfc_genl_data genl_data;
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -0300141 u32 supported_protocols;
142
Samuel Ortizfed7c252013-05-10 15:28:38 +0200143 struct list_head secure_elements;
Samuel Ortiz390a1bd2012-12-19 19:11:32 +0100144
Samuel Ortize8753042011-08-19 15:47:11 +0200145 int tx_headroom;
146 int tx_tailroom;
147
Eric Lapuyadec8d56ae2012-04-10 19:43:12 +0200148 struct timer_list check_pres_timer;
Eric Lapuyadec8d56ae2012-04-10 19:43:12 +0200149 struct work_struct check_pres_work;
150
Eric Lapuyadef0c91032012-11-26 18:06:27 +0100151 bool shutting_down;
152
Samuel Ortizbe055b22013-04-11 11:52:20 +0200153 struct rfkill *rfkill;
154
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -0300155 struct nfc_ops *ops;
156};
157#define to_nfc_dev(_dev) container_of(_dev, struct nfc_dev, dev)
158
159extern struct class nfc_class;
160
161struct nfc_dev *nfc_allocate_device(struct nfc_ops *ops,
Samuel Ortiz0a40acb2012-03-05 01:03:53 +0100162 u32 supported_protocols,
163 int tx_headroom,
164 int tx_tailroom);
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -0300165
166/**
167 * nfc_free_device - free nfc device
168 *
169 * @dev: The nfc device to free
170 */
171static inline void nfc_free_device(struct nfc_dev *dev)
172{
173 put_device(&dev->dev);
174}
175
176int nfc_register_device(struct nfc_dev *dev);
177
178void nfc_unregister_device(struct nfc_dev *dev);
179
180/**
181 * nfc_set_parent_dev - set the parent device
182 *
183 * @nfc_dev: The nfc device whose parent is being set
184 * @dev: The parent device
185 */
186static inline void nfc_set_parent_dev(struct nfc_dev *nfc_dev,
Samuel Ortiz0a40acb2012-03-05 01:03:53 +0100187 struct device *dev)
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -0300188{
189 nfc_dev->dev.parent = dev;
190}
191
192/**
193 * nfc_set_drvdata - set driver specifc data
194 *
195 * @dev: The nfc device
196 * @data: Pointer to driver specifc data
197 */
198static inline void nfc_set_drvdata(struct nfc_dev *dev, void *data)
199{
200 dev_set_drvdata(&dev->dev, data);
201}
202
203/**
204 * nfc_get_drvdata - get driver specifc data
205 *
206 * @dev: The nfc device
207 */
208static inline void *nfc_get_drvdata(struct nfc_dev *dev)
209{
210 return dev_get_drvdata(&dev->dev);
211}
212
213/**
214 * nfc_device_name - get the nfc device name
215 *
216 * @dev: The nfc device whose name to return
217 */
218static inline const char *nfc_device_name(struct nfc_dev *dev)
219{
220 return dev_name(&dev->dev);
221}
222
Samuel Ortiz7c7cd3b2011-12-14 16:43:06 +0100223struct sk_buff *nfc_alloc_send_skb(struct nfc_dev *dev, struct sock *sk,
Samuel Ortiz0a40acb2012-03-05 01:03:53 +0100224 unsigned int flags, unsigned int size,
225 unsigned int *err);
Samuel Ortiz7c7cd3b2011-12-14 16:43:06 +0100226struct sk_buff *nfc_alloc_recv_skb(unsigned int size, gfp_t gfp);
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -0300227
Samuel Ortiz541d9202011-12-14 16:43:10 +0100228int nfc_set_remote_general_bytes(struct nfc_dev *dev,
Samuel Ortiz0a40acb2012-03-05 01:03:53 +0100229 u8 *gt, u8 gt_len);
Samuel Ortizab73b752012-04-10 12:51:52 +0200230u8 *nfc_get_local_general_bytes(struct nfc_dev *dev, size_t *gb_len);
Samuel Ortiz541d9202011-12-14 16:43:10 +0100231
Eric Lapuyade352a5f52013-07-19 14:57:55 +0200232int nfc_fw_download_done(struct nfc_dev *dev, const char *firmware_name,
233 u32 result);
Eric Lapuyadeef041582013-07-19 14:56:08 +0200234
Samuel Ortiz0a40acb2012-03-05 01:03:53 +0100235int nfc_targets_found(struct nfc_dev *dev,
236 struct nfc_target *targets, int ntargets);
Eric Lapuyadee1da0ef2012-04-10 19:43:05 +0200237int nfc_target_lost(struct nfc_dev *dev, u32 target_idx);
Lauro Ramos Venancio4d12b8b2011-07-01 19:31:34 -0300238
Samuel Ortiz1ed28f62011-12-14 16:43:09 +0100239int nfc_dep_link_is_up(struct nfc_dev *dev, u32 target_idx,
240 u8 comm_mode, u8 rf_mode);
241
Samuel Ortizfc40a8c2012-06-01 13:21:13 +0200242int nfc_tm_activated(struct nfc_dev *dev, u32 protocol, u8 comm_mode,
243 u8 *gb, size_t gb_len);
244int nfc_tm_deactivated(struct nfc_dev *dev);
Samuel Ortiz73167ce2012-05-31 00:05:50 +0200245int nfc_tm_data_received(struct nfc_dev *dev, struct sk_buff *skb);
Samuel Ortizfc40a8c2012-06-01 13:21:13 +0200246
Eric Lapuyade456411c2012-06-11 13:49:51 +0200247void nfc_driver_failure(struct nfc_dev *dev, int err);
248
Samuel Ortizfed7c252013-05-10 15:28:38 +0200249int nfc_add_se(struct nfc_dev *dev, u32 se_idx, u16 type);
250int nfc_remove_se(struct nfc_dev *dev, u32 se_idx);
Arron Wangd8eb18e2013-08-23 16:02:08 +0800251struct nfc_se *nfc_find_se(struct nfc_dev *dev, u32 se_idx);
Samuel Ortizfed7c252013-05-10 15:28:38 +0200252
Lauro Ramos Venancio3e256b82011-07-01 19:31:33 -0300253#endif /* __NET_NFC_H */