/* * NFC Digital Protocol stack * Copyright (c) 2013, Intel Corporation. * * This program is free software; you can redistribute it and/or modify it * under the terms and conditions of the GNU General Public License, * version 2, as published by the Free Software Foundation. * * This program is distributed in the hope 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. * */ #ifndef __NFC_DIGITAL_H #define __NFC_DIGITAL_H #include #include /** * Configuration types for in_configure_hw and tg_configure_hw. */ enum { NFC_DIGITAL_CONFIG_RF_TECH = 0, NFC_DIGITAL_CONFIG_FRAMING, }; /** * RF technology values passed as param argument to in_configure_hw and * tg_configure_hw for NFC_DIGITAL_CONFIG_RF_TECH configuration type. */ enum { NFC_DIGITAL_RF_TECH_106A = 0, NFC_DIGITAL_RF_TECH_212F, NFC_DIGITAL_RF_TECH_424F, NFC_DIGITAL_RF_TECH_ISO15693, NFC_DIGITAL_RF_TECH_106B, NFC_DIGITAL_RF_TECH_LAST, }; /** * Framing configuration passed as param argument to in_configure_hw and * tg_configure_hw for NFC_DIGITAL_CONFIG_FRAMING configuration type. */ enum { NFC_DIGITAL_FRAMING_NFCA_SHORT = 0, NFC_DIGITAL_FRAMING_NFCA_STANDARD, NFC_DIGITAL_FRAMING_NFCA_STANDARD_WITH_CRC_A, NFC_DIGITAL_FRAMING_NFCA_ANTICOL_COMPLETE, NFC_DIGITAL_FRAMING_NFCA_T1T, NFC_DIGITAL_FRAMING_NFCA_T2T, NFC_DIGITAL_FRAMING_NFCA_T4T, NFC_DIGITAL_FRAMING_NFCA_NFC_DEP, NFC_DIGITAL_FRAMING_NFCF, NFC_DIGITAL_FRAMING_NFCF_T3T, NFC_DIGITAL_FRAMING_NFCF_NFC_DEP, NFC_DIGITAL_FRAMING_NFC_DEP_ACTIVATED, NFC_DIGITAL_FRAMING_ISO15693_INVENTORY, NFC_DIGITAL_FRAMING_ISO15693_T5T, NFC_DIGITAL_FRAMING_NFCB, NFC_DIGITAL_FRAMING_NFCB_T4T, NFC_DIGITAL_FRAMING_LAST, }; #define DIGITAL_MDAA_NFCID1_SIZE 3 struct digital_tg_mdaa_params { u16 sens_res; u8 nfcid1[DIGITAL_MDAA_NFCID1_SIZE]; u8 sel_res; u8 nfcid2[NFC_NFCID2_MAXSIZE]; u16 sc; }; struct nfc_digital_dev; /** * nfc_digital_cmd_complete_t - Definition of command result callback * * @ddev: nfc_digital_device ref * @arg: user data * @resp: response data * * resp pointer can be an error code and will be checked with IS_ERR() macro. * The callback is responsible for freeing resp sk_buff. */ typedef void (*nfc_digital_cmd_complete_t)(struct nfc_digital_dev *ddev, void *arg, struct sk_buff *resp); /** * Device side NFC Digital operations * * Initiator mode: * @in_configure_hw: Hardware configuration for RF technology and communication * framing in initiator mode. This is a synchronous function. * @in_send_cmd: Initiator mode data exchange using RF technology and framing * previously set with in_configure_hw. The peer response is returned * through callback cb. If an io error occurs or the peer didn't reply * within the specified timeout (ms), the error code is passed back through * the resp pointer. This is an asynchronous function. * * Target mode: Only NFC-DEP protocol is supported in target mode. * @tg_configure_hw: Hardware configuration for RF technology and communication * framing in target mode. This is a synchronous function. * @tg_send_cmd: Target mode data exchange using RF technology and framing * previously set with tg_configure_hw. The peer next command is returned * through callback cb. If an io error occurs or the peer didn't reply * within the specified timeout (ms), the error code is passed back through * the resp pointer. This is an asynchronous function. * @tg_listen: Put the device in listen mode waiting for data from the peer * device. This is an asynchronous function. * @tg_listen_mdaa: If supported, put the device in automatic listen mode with * mode detection and automatic anti-collision. In this mode, the device * automatically detects the RF technology and executes the anti-collision * detection using the command responses specified in mdaa_params. The * mdaa_params structure contains SENS_RES, NFCID1, and SEL_RES for 106A RF * tech. NFCID2 and system code (sc) for 212F and 424F. The driver returns * the NFC-DEP ATR_REQ command through cb. The digital stack deducts the RF * tech by analyzing the SoD of the frame containing the ATR_REQ command. * This is an asynchronous function. * @tg_listen_md: If supported, put the device in automatic listen mode with * mode detection but without automatic anti-collision. In this mode, the * device automatically detects the RF technology. What the actual * RF technology is can be retrieved by calling @tg_get_rf_tech. * The digital stack will then perform the appropriate anti-collision * sequence. This is an asynchronous function. * @tg_get_rf_tech: Required when @tg_listen_md is supported, unused otherwise. * Return the RF Technology that was detecte