nfc.h 5.5 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
/*
 * Copyright (C) 2011 Instituto Nokia de Tecnologia
 *
 * Authors:
 *    Lauro Ramos Venancio <lauro.venancio@openbossa.org>
 *    Aloisio Almeida Jr <aloisio.almeida@openbossa.org>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the
 * Free Software Foundation, Inc.,
 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 */

#ifndef __NET_NFC_H
#define __NET_NFC_H

27
#include <linux/nfc.h>
28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50
#include <linux/device.h>
#include <linux/skbuff.h>

#define nfc_dev_info(dev, fmt, arg...) dev_info((dev), "NFC: " fmt "\n", ## arg)
#define nfc_dev_err(dev, fmt, arg...) dev_err((dev), "NFC: " fmt "\n", ## arg)
#define nfc_dev_dbg(dev, fmt, arg...) dev_dbg((dev), fmt "\n", ## arg)

struct nfc_dev;

/**
 * data_exchange_cb_t - Definition of nfc_data_exchange callback
 *
 * @context: nfc_data_exchange cb_context parameter
 * @skb: response data
 * @err: If an error has occurred during data exchange, it is the
 *	error number. Zero means no error.
 *
 * When a rx or tx package is lost or corrupted or the target gets out
 * of the operating field, err is -EIO.
 */
typedef void (*data_exchange_cb_t)(void *context, struct sk_buff *skb,
								int err);

51 52
struct nfc_target;

53
struct nfc_ops {
54 55
	int (*dev_up)(struct nfc_dev *dev);
	int (*dev_down)(struct nfc_dev *dev);
56 57
	int (*start_poll)(struct nfc_dev *dev,
			  u32 im_protocols, u32 tm_protocols);
58
	void (*stop_poll)(struct nfc_dev *dev);
59 60
	int (*dep_link_up)(struct nfc_dev *dev, struct nfc_target *target,
			   u8 comm_mode, u8 *gb, size_t gb_len);
61
	int (*dep_link_down)(struct nfc_dev *dev);
62
	int (*activate_target)(struct nfc_dev *dev, struct nfc_target *target,
S
Samuel Ortiz 已提交
63
			       u32 protocol);
64 65 66
	void (*deactivate_target)(struct nfc_dev *dev,
				  struct nfc_target *target);
	int (*data_exchange)(struct nfc_dev *dev, struct nfc_target *target,
S
Samuel Ortiz 已提交
67 68
			     struct sk_buff *skb, data_exchange_cb_t cb,
			     void *cb_context);
69
	int (*check_presence)(struct nfc_dev *dev, struct nfc_target *target);
70 71
};

72 73 74
#define NFC_TARGET_IDX_ANY -1
#define NFC_MAX_GT_LEN 48

75 76 77 78 79
struct nfc_target {
	u32 idx;
	u32 supported_protocols;
	u16 sens_res;
	u8 sel_res;
80
	u8 nfcid1_len;
81 82 83 84 85
	u8 nfcid1[NFC_NFCID1_MAXSIZE];
	u8 sensb_res_len;
	u8 sensb_res[NFC_SENSB_RES_MAXSIZE];
	u8 sensf_res_len;
	u8 sensf_res[NFC_SENSF_RES_MAXSIZE];
E
Eric Lapuyade 已提交
86
	u8 hci_reader_gate;
87
	u8 logical_idx;
88 89 90 91 92 93 94
};

struct nfc_genl_data {
	u32 poll_req_pid;
	struct mutex genl_data_mutex;
};

95
struct nfc_dev {
96
	unsigned int idx;
97
	u32 target_next_idx;
98 99 100
	struct nfc_target *targets;
	int n_targets;
	int targets_generation;
101
	struct device dev;
102
	bool dev_up;
103
	bool polling;
104
	struct nfc_target *active_target;
105 106
	bool dep_link_up;
	u32 dep_rf_mode;
107
	struct nfc_genl_data genl_data;
108 109
	u32 supported_protocols;

110 111 112
	int tx_headroom;
	int tx_tailroom;

113 114 115 116
	struct timer_list check_pres_timer;
	struct workqueue_struct *check_pres_wq;
	struct work_struct check_pres_work;

117 118 119 120 121 122 123
	struct nfc_ops *ops;
};
#define to_nfc_dev(_dev) container_of(_dev, struct nfc_dev, dev)

extern struct class nfc_class;

struct nfc_dev *nfc_allocate_device(struct nfc_ops *ops,
S
Samuel Ortiz 已提交
124 125 126
				    u32 supported_protocols,
				    int tx_headroom,
				    int tx_tailroom);
127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148

/**
 * nfc_free_device - free nfc device
 *
 * @dev: The nfc device to free
 */
static inline void nfc_free_device(struct nfc_dev *dev)
{
	put_device(&dev->dev);
}

int nfc_register_device(struct nfc_dev *dev);

void nfc_unregister_device(struct nfc_dev *dev);

/**
 * nfc_set_parent_dev - set the parent device
 *
 * @nfc_dev: The nfc device whose parent is being set
 * @dev: The parent device
 */
static inline void nfc_set_parent_dev(struct nfc_dev *nfc_dev,
S
Samuel Ortiz 已提交
149
				      struct device *dev)
150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184
{
	nfc_dev->dev.parent = dev;
}

/**
 * nfc_set_drvdata - set driver specifc data
 *
 * @dev: The nfc device
 * @data: Pointer to driver specifc data
 */
static inline void nfc_set_drvdata(struct nfc_dev *dev, void *data)
{
	dev_set_drvdata(&dev->dev, data);
}

/**
 * nfc_get_drvdata - get driver specifc data
 *
 * @dev: The nfc device
 */
static inline void *nfc_get_drvdata(struct nfc_dev *dev)
{
	return dev_get_drvdata(&dev->dev);
}

/**
 * nfc_device_name - get the nfc device name
 *
 * @dev: The nfc device whose name to return
 */
static inline const char *nfc_device_name(struct nfc_dev *dev)
{
	return dev_name(&dev->dev);
}

S
Samuel Ortiz 已提交
185
struct sk_buff *nfc_alloc_send_skb(struct nfc_dev *dev, struct sock *sk,
S
Samuel Ortiz 已提交
186 187
				   unsigned int flags, unsigned int size,
				   unsigned int *err);
S
Samuel Ortiz 已提交
188
struct sk_buff *nfc_alloc_recv_skb(unsigned int size, gfp_t gfp);
189

S
Samuel Ortiz 已提交
190
int nfc_set_remote_general_bytes(struct nfc_dev *dev,
S
Samuel Ortiz 已提交
191
				 u8 *gt, u8 gt_len);
192
u8 *nfc_get_local_general_bytes(struct nfc_dev *dev, size_t *gb_len);
S
Samuel Ortiz 已提交
193

S
Samuel Ortiz 已提交
194 195
int nfc_targets_found(struct nfc_dev *dev,
		      struct nfc_target *targets, int ntargets);
E
Eric Lapuyade 已提交
196
int nfc_target_lost(struct nfc_dev *dev, u32 target_idx);
197

198 199 200
int nfc_dep_link_is_up(struct nfc_dev *dev, u32 target_idx,
		       u8 comm_mode, u8 rf_mode);

201 202 203 204
int nfc_tm_activated(struct nfc_dev *dev, u32 protocol, u8 comm_mode,
		     u8 *gb, size_t gb_len);
int nfc_tm_deactivated(struct nfc_dev *dev);

205
#endif /* __NET_NFC_H */