2019-05-31 08:09:57 +00:00
|
|
|
/* SPDX-License-Identifier: GPL-2.0-only */
|
2014-03-25 05:51:47 +00:00
|
|
|
/*
|
|
|
|
|
* Copyright (C) 2014 STMicroelectronics SAS. All rights reserved.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifndef __LOCAL_ST21NFCA_H_
|
|
|
|
|
#define __LOCAL_ST21NFCA_H_
|
|
|
|
|
|
|
|
|
|
#include <net/nfc/hci.h>
|
2015-10-25 21:54:18 +00:00
|
|
|
#include <linux/skbuff.h>
|
|
|
|
|
#include <linux/workqueue.h>
|
2014-05-20 20:21:59 +00:00
|
|
|
|
2014-03-25 05:51:47 +00:00
|
|
|
#define HCI_MODE 0
|
|
|
|
|
|
|
|
|
|
/* framing in HCI mode */
|
|
|
|
|
#define ST21NFCA_SOF_EOF_LEN 2
|
|
|
|
|
|
|
|
|
|
/* Almost every time value is 0 */
|
|
|
|
|
#define ST21NFCA_HCI_LLC_LEN 1
|
|
|
|
|
|
|
|
|
|
/* Size in worst case :
|
|
|
|
|
* In normal case CRC len = 2 but byte stuffing
|
|
|
|
|
* may appear in case one CRC byte = ST21NFCA_SOF_EOF
|
|
|
|
|
*/
|
|
|
|
|
#define ST21NFCA_HCI_LLC_CRC 4
|
|
|
|
|
|
|
|
|
|
#define ST21NFCA_HCI_LLC_LEN_CRC (ST21NFCA_SOF_EOF_LEN + \
|
|
|
|
|
ST21NFCA_HCI_LLC_LEN + \
|
|
|
|
|
ST21NFCA_HCI_LLC_CRC)
|
|
|
|
|
#define ST21NFCA_HCI_LLC_MIN_SIZE (1 + ST21NFCA_HCI_LLC_LEN_CRC)
|
|
|
|
|
|
|
|
|
|
/* Worst case when adding byte stuffing between each byte */
|
|
|
|
|
#define ST21NFCA_HCI_LLC_MAX_PAYLOAD 29
|
|
|
|
|
#define ST21NFCA_HCI_LLC_MAX_SIZE (ST21NFCA_HCI_LLC_LEN_CRC + 1 + \
|
|
|
|
|
ST21NFCA_HCI_LLC_MAX_PAYLOAD)
|
|
|
|
|
|
2015-10-25 21:54:18 +00:00
|
|
|
/* Reader RF commands */
|
|
|
|
|
#define ST21NFCA_WR_XCHG_DATA 0x10
|
|
|
|
|
|
|
|
|
|
#define ST21NFCA_DEVICE_MGNT_GATE 0x01
|
|
|
|
|
#define ST21NFCA_RF_READER_F_GATE 0x14
|
|
|
|
|
#define ST21NFCA_RF_CARD_F_GATE 0x24
|
|
|
|
|
#define ST21NFCA_APDU_READER_GATE 0xf0
|
|
|
|
|
#define ST21NFCA_CONNECTIVITY_GATE 0x41
|
2014-03-25 05:51:47 +00:00
|
|
|
|
2015-10-25 21:54:18 +00:00
|
|
|
/*
|
|
|
|
|
* ref ISO7816-3 chap 8.1. the initial character TS is followed by a
|
|
|
|
|
* sequence of at most 32 characters.
|
|
|
|
|
*/
|
|
|
|
|
#define ST21NFCA_ESE_MAX_LENGTH 33
|
|
|
|
|
#define ST21NFCA_ESE_HOST_ID 0xc0
|
|
|
|
|
|
|
|
|
|
#define DRIVER_DESC "HCI NFC driver for ST21NFCA"
|
2014-03-25 05:51:47 +00:00
|
|
|
|
2015-10-25 21:54:18 +00:00
|
|
|
#define ST21NFCA_HCI_MODE 0
|
|
|
|
|
#define ST21NFCA_NUM_DEVICES 256
|
2014-03-25 05:51:47 +00:00
|
|
|
|
2015-10-26 06:50:11 +00:00
|
|
|
#define ST21NFCA_VENDOR_OUI 0x0080E1 /* STMicroelectronics */
|
|
|
|
|
#define ST21NFCA_FACTORY_MODE 2
|
|
|
|
|
|
NFC: st21nfca: Adding support for secure element
st21nfca has 1 physical SWP line and can support up to 2 secure elements
(UICC & eSE) thanks to an external switch managed with a gpio.
The platform integrator needs to specify thanks to 2 initialization
properties, uicc-present and ese-present, if it is suppose to have uicc
and/or ese. Of course if the platform does not have an external switch,
only one kind of secure element can be supported. Those parameters are
under platform integrator responsibilities.
During initialization, the white_list will be set according to those
parameters.
The discovery_se function will assume a secure element is physically
present according to uicc-present and ese-present values and will add it
to the secure element list. On ese activation, the atr is retrieved to
calculate a command exchange timeout based on the first atr(TB) value.
The se_io will allow to transfer data over SWP. 2 kind of events may appear
after a data is sent over:
- ST21NFCA_EVT_TRANSMIT_DATA when receiving an apdu answer
- ST21NFCA_EVT_WTX_REQUEST when the secure element needs more time than
expected to compute a command. If this timeout expired, a first recovery
tentative consist to send a simple software reset proprietary command.
If this tentative still fail, a second recovery tentative consist to send
a hardware reset proprietary command.
This function is only relevant for eSE like secure element.
This patch also change the way a pipe is referenced. There can be
different pipe connected to the same gate with different host destination
(ex: CONNECTIVITY). In order to keep host information every pipe are
reference with a tuple (gate, host). In order to reduce changes, we are
keeping unchanged the way a gate is addressed on the Terminal Host.
However, this is working because we consider the apdu reader gate is only
present on the eSE slot also the connectivity gate cannot give a reliable
value; it will give the latest stored pipe value.
Signed-off-by: Christophe Ricard <christophe-h.ricard@st.com>
Signed-off-by: Samuel Ortiz <sameo@linux.intel.com>
2015-01-27 00:18:19 +00:00
|
|
|
struct st21nfca_se_status {
|
|
|
|
|
bool is_ese_present;
|
|
|
|
|
bool is_uicc_present;
|
|
|
|
|
};
|
|
|
|
|
|
2014-03-25 05:51:47 +00:00
|
|
|
enum st21nfca_state {
|
|
|
|
|
ST21NFCA_ST_COLD,
|
|
|
|
|
ST21NFCA_ST_READY,
|
|
|
|
|
};
|
|
|
|
|
|
2015-10-26 06:50:11 +00:00
|
|
|
/**
|
|
|
|
|
* enum nfc_vendor_cmds - supported nfc vendor commands
|
|
|
|
|
*
|
|
|
|
|
* @FACTORY_MODE: Allow to set the driver into a mode where no secure element
|
|
|
|
|
* are activated. It does not consider any NFC_ATTR_VENDOR_DATA.
|
|
|
|
|
* @HCI_CLEAR_ALL_PIPES: Allow to execute a HCI clear all pipes command.
|
|
|
|
|
* It does not consider any NFC_ATTR_VENDOR_DATA.
|
|
|
|
|
* @HCI_DM_PUT_DATA: Allow to configure specific CLF registry as for example
|
|
|
|
|
* RF trimmings or low level drivers configurations (I2C, SPI, SWP).
|
|
|
|
|
* @HCI_DM_UPDATE_AID: Allow to configure an AID routing into the CLF routing
|
|
|
|
|
* table following RF technology, CLF mode or protocol.
|
|
|
|
|
* @HCI_DM_GET_INFO: Allow to retrieve CLF information.
|
|
|
|
|
* @HCI_DM_GET_DATA: Allow to retrieve CLF configurable data such as low
|
|
|
|
|
* level drivers configurations or RF trimmings.
|
|
|
|
|
* @HCI_DM_LOAD: Allow to load a firmware into the CLF. A complete
|
|
|
|
|
* packet can be more than 8KB.
|
|
|
|
|
* @HCI_DM_RESET: Allow to run a CLF reset in order to "commit" CLF
|
|
|
|
|
* configuration changes without CLF power off.
|
|
|
|
|
* @HCI_GET_PARAM: Allow to retrieve an HCI CLF parameter (for example the
|
|
|
|
|
* white list).
|
|
|
|
|
* @HCI_DM_FIELD_GENERATOR: Allow to generate different kind of RF
|
|
|
|
|
* technology. When using this command to anti-collision is done.
|
|
|
|
|
* @HCI_LOOPBACK: Allow to echo a command and test the Dh to CLF
|
|
|
|
|
* connectivity.
|
|
|
|
|
*/
|
|
|
|
|
enum nfc_vendor_cmds {
|
|
|
|
|
FACTORY_MODE,
|
|
|
|
|
HCI_CLEAR_ALL_PIPES,
|
|
|
|
|
HCI_DM_PUT_DATA,
|
|
|
|
|
HCI_DM_UPDATE_AID,
|
|
|
|
|
HCI_DM_GET_INFO,
|
|
|
|
|
HCI_DM_GET_DATA,
|
|
|
|
|
HCI_DM_LOAD,
|
|
|
|
|
HCI_DM_RESET,
|
|
|
|
|
HCI_GET_PARAM,
|
|
|
|
|
HCI_DM_FIELD_GENERATOR,
|
|
|
|
|
HCI_LOOPBACK,
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
struct st21nfca_vendor_info {
|
|
|
|
|
struct completion req_completion;
|
|
|
|
|
struct sk_buff *rx_skb;
|
|
|
|
|
};
|
|
|
|
|
|
2015-10-25 21:54:18 +00:00
|
|
|
struct st21nfca_dep_info {
|
|
|
|
|
struct sk_buff *tx_pending;
|
|
|
|
|
struct work_struct tx_work;
|
|
|
|
|
u8 curr_nfc_dep_pni;
|
|
|
|
|
u32 idx;
|
|
|
|
|
u8 to;
|
|
|
|
|
u8 did;
|
|
|
|
|
u8 bsi;
|
|
|
|
|
u8 bri;
|
|
|
|
|
u8 lri;
|
|
|
|
|
} __packed;
|
|
|
|
|
|
|
|
|
|
struct st21nfca_se_info {
|
|
|
|
|
u8 atr[ST21NFCA_ESE_MAX_LENGTH];
|
|
|
|
|
struct completion req_completion;
|
|
|
|
|
|
|
|
|
|
struct timer_list bwi_timer;
|
|
|
|
|
int wt_timeout; /* in msecs */
|
|
|
|
|
bool bwi_active;
|
|
|
|
|
|
|
|
|
|
struct timer_list se_active_timer;
|
|
|
|
|
bool se_active;
|
|
|
|
|
int expected_pipes;
|
|
|
|
|
int count_pipes;
|
|
|
|
|
|
|
|
|
|
bool xch_error;
|
|
|
|
|
|
|
|
|
|
se_io_cb_t cb;
|
|
|
|
|
void *cb_context;
|
|
|
|
|
};
|
|
|
|
|
|
2014-03-25 05:51:47 +00:00
|
|
|
struct st21nfca_hci_info {
|
|
|
|
|
struct nfc_phy_ops *phy_ops;
|
|
|
|
|
void *phy_id;
|
|
|
|
|
|
|
|
|
|
struct nfc_hci_dev *hdev;
|
NFC: st21nfca: Adding support for secure element
st21nfca has 1 physical SWP line and can support up to 2 secure elements
(UICC & eSE) thanks to an external switch managed with a gpio.
The platform integrator needs to specify thanks to 2 initialization
properties, uicc-present and ese-present, if it is suppose to have uicc
and/or ese. Of course if the platform does not have an external switch,
only one kind of secure element can be supported. Those parameters are
under platform integrator responsibilities.
During initialization, the white_list will be set according to those
parameters.
The discovery_se function will assume a secure element is physically
present according to uicc-present and ese-present values and will add it
to the secure element list. On ese activation, the atr is retrieved to
calculate a command exchange timeout based on the first atr(TB) value.
The se_io will allow to transfer data over SWP. 2 kind of events may appear
after a data is sent over:
- ST21NFCA_EVT_TRANSMIT_DATA when receiving an apdu answer
- ST21NFCA_EVT_WTX_REQUEST when the secure element needs more time than
expected to compute a command. If this timeout expired, a first recovery
tentative consist to send a simple software reset proprietary command.
If this tentative still fail, a second recovery tentative consist to send
a hardware reset proprietary command.
This function is only relevant for eSE like secure element.
This patch also change the way a pipe is referenced. There can be
different pipe connected to the same gate with different host destination
(ex: CONNECTIVITY). In order to keep host information every pipe are
reference with a tuple (gate, host). In order to reduce changes, we are
keeping unchanged the way a gate is addressed on the Terminal Host.
However, this is working because we consider the apdu reader gate is only
present on the eSE slot also the connectivity gate cannot give a reliable
value; it will give the latest stored pipe value.
Signed-off-by: Christophe Ricard <christophe-h.ricard@st.com>
Signed-off-by: Samuel Ortiz <sameo@linux.intel.com>
2015-01-27 00:18:19 +00:00
|
|
|
struct st21nfca_se_status *se_status;
|
2014-03-25 05:51:47 +00:00
|
|
|
|
|
|
|
|
enum st21nfca_state state;
|
|
|
|
|
|
|
|
|
|
struct mutex info_lock;
|
|
|
|
|
|
|
|
|
|
int async_cb_type;
|
|
|
|
|
data_exchange_cb_t async_cb;
|
|
|
|
|
void *async_cb_context;
|
|
|
|
|
|
2014-05-20 20:21:59 +00:00
|
|
|
struct st21nfca_dep_info dep_info;
|
NFC: st21nfca: Adding support for secure element
st21nfca has 1 physical SWP line and can support up to 2 secure elements
(UICC & eSE) thanks to an external switch managed with a gpio.
The platform integrator needs to specify thanks to 2 initialization
properties, uicc-present and ese-present, if it is suppose to have uicc
and/or ese. Of course if the platform does not have an external switch,
only one kind of secure element can be supported. Those parameters are
under platform integrator responsibilities.
During initialization, the white_list will be set according to those
parameters.
The discovery_se function will assume a secure element is physically
present according to uicc-present and ese-present values and will add it
to the secure element list. On ese activation, the atr is retrieved to
calculate a command exchange timeout based on the first atr(TB) value.
The se_io will allow to transfer data over SWP. 2 kind of events may appear
after a data is sent over:
- ST21NFCA_EVT_TRANSMIT_DATA when receiving an apdu answer
- ST21NFCA_EVT_WTX_REQUEST when the secure element needs more time than
expected to compute a command. If this timeout expired, a first recovery
tentative consist to send a simple software reset proprietary command.
If this tentative still fail, a second recovery tentative consist to send
a hardware reset proprietary command.
This function is only relevant for eSE like secure element.
This patch also change the way a pipe is referenced. There can be
different pipe connected to the same gate with different host destination
(ex: CONNECTIVITY). In order to keep host information every pipe are
reference with a tuple (gate, host). In order to reduce changes, we are
keeping unchanged the way a gate is addressed on the Terminal Host.
However, this is working because we consider the apdu reader gate is only
present on the eSE slot also the connectivity gate cannot give a reliable
value; it will give the latest stored pipe value.
Signed-off-by: Christophe Ricard <christophe-h.ricard@st.com>
Signed-off-by: Samuel Ortiz <sameo@linux.intel.com>
2015-01-27 00:18:19 +00:00
|
|
|
struct st21nfca_se_info se_info;
|
2015-10-26 06:50:11 +00:00
|
|
|
struct st21nfca_vendor_info vendor_info;
|
2014-05-20 20:21:59 +00:00
|
|
|
};
|
2014-03-25 05:51:47 +00:00
|
|
|
|
2015-10-25 21:54:18 +00:00
|
|
|
int st21nfca_hci_probe(void *phy_id, struct nfc_phy_ops *phy_ops,
|
|
|
|
|
char *llc_name, int phy_headroom, int phy_tailroom,
|
|
|
|
|
int phy_payload, struct nfc_hci_dev **hdev,
|
2015-10-26 06:50:11 +00:00
|
|
|
struct st21nfca_se_status *se_status);
|
2015-10-25 21:54:18 +00:00
|
|
|
void st21nfca_hci_remove(struct nfc_hci_dev *hdev);
|
2014-05-20 20:21:59 +00:00
|
|
|
|
2015-10-25 21:54:18 +00:00
|
|
|
int st21nfca_dep_event_received(struct nfc_hci_dev *hdev,
|
|
|
|
|
u8 event, struct sk_buff *skb);
|
|
|
|
|
int st21nfca_tm_send_dep_res(struct nfc_hci_dev *hdev, struct sk_buff *skb);
|
|
|
|
|
|
|
|
|
|
int st21nfca_im_send_atr_req(struct nfc_hci_dev *hdev, u8 *gb, size_t gb_len);
|
|
|
|
|
int st21nfca_im_send_dep_req(struct nfc_hci_dev *hdev, struct sk_buff *skb);
|
|
|
|
|
void st21nfca_dep_init(struct nfc_hci_dev *hdev);
|
|
|
|
|
void st21nfca_dep_deinit(struct nfc_hci_dev *hdev);
|
|
|
|
|
|
|
|
|
|
int st21nfca_connectivity_event_received(struct nfc_hci_dev *hdev, u8 host,
|
|
|
|
|
u8 event, struct sk_buff *skb);
|
|
|
|
|
int st21nfca_apdu_reader_event_received(struct nfc_hci_dev *hdev,
|
|
|
|
|
u8 event, struct sk_buff *skb);
|
|
|
|
|
|
|
|
|
|
int st21nfca_hci_discover_se(struct nfc_hci_dev *hdev);
|
|
|
|
|
int st21nfca_hci_enable_se(struct nfc_hci_dev *hdev, u32 se_idx);
|
|
|
|
|
int st21nfca_hci_disable_se(struct nfc_hci_dev *hdev, u32 se_idx);
|
|
|
|
|
int st21nfca_hci_se_io(struct nfc_hci_dev *hdev, u32 se_idx,
|
|
|
|
|
u8 *apdu, size_t apdu_length,
|
|
|
|
|
se_io_cb_t cb, void *cb_context);
|
|
|
|
|
|
|
|
|
|
void st21nfca_se_init(struct nfc_hci_dev *hdev);
|
|
|
|
|
void st21nfca_se_deinit(struct nfc_hci_dev *hdev);
|
2014-05-20 20:21:59 +00:00
|
|
|
|
2015-10-26 06:50:11 +00:00
|
|
|
int st21nfca_hci_loopback_event_received(struct nfc_hci_dev *ndev, u8 event,
|
|
|
|
|
struct sk_buff *skb);
|
|
|
|
|
int st21nfca_vendor_cmds_init(struct nfc_hci_dev *ndev);
|
|
|
|
|
|
2014-03-25 05:51:47 +00:00
|
|
|
#endif /* __LOCAL_ST21NFCA_H_ */
|
