Home | History | Annotate | Download | only in include
      1 /******************************************************************************
      2  *
      3  *  Copyright (C) 1999-2014 Broadcom Corporation
      4  *
      5  *  Licensed under the Apache License, Version 2.0 (the "License");
      6  *  you may not use this file except in compliance with the License.
      7  *  You may obtain a copy of the License at:
      8  *
      9  *  http://www.apache.org/licenses/LICENSE-2.0
     10  *
     11  *  Unless required by applicable law or agreed to in writing, software
     12  *  distributed under the License is distributed on an "AS IS" BASIS,
     13  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     14  *  See the License for the specific language governing permissions and
     15  *  limitations under the License.
     16  *
     17  ******************************************************************************/
     18 
     19 
     20 /******************************************************************************
     21  *
     22  *  This file contains the definition from NCI specification
     23  *
     24  ******************************************************************************/
     25 
     26 #ifndef NFC_NCI_DEFS_H
     27 #define NFC_NCI_DEFS_H
     28 
     29 #ifdef __cplusplus
     30 extern "C" {
     31 #endif
     32 
     33 #define NCI_BRCM_CO_ID              0x2E
     34 
     35 /* Define the message header size for all NCI Commands and Notifications.
     36 */
     37 #define NCI_MSG_HDR_SIZE        3   /* per NCI spec */
     38 #define NCI_DATA_HDR_SIZE       3   /* per NCI spec */
     39 #define NCI_MAX_PAYLOAD_SIZE    0xFE
     40 #define NCI_MAX_CTRL_SIZE       0xFF/* max control message size */
     41 #define NCI_CTRL_INIT_SIZE      32  /* initial NFCC control payload size */
     42 #define NCI_MAX_VSC_SIZE        0xFF
     43 #define NCI_VSC_MSG_HDR_SIZE    12  /* NCI header (3) + callback function pointer(8; use 8 to be safe) + HCIT (1 byte) */
     44 #define NCI_TL_SIZE             2
     45 
     46 #define NCI_ISO_DEP_MAX_INFO      253   /* Max frame size (256) - Prologue (1) - Epilogue (2) in ISO-DEP, CID and NAD are not used*/
     47 #define NCI_NFC_DEP_MAX_DATA      251   /* Max payload (254) - Protocol Header (3) in NFC-DEP, DID and NAD are not used */
     48 
     49 /* NCI Command and Notification Format:
     50  * 3 byte message header:
     51  * byte 0: MT PBF GID
     52  * byte 1: OID
     53  * byte 2: Message Length */
     54 /* MT: Message Type (byte 0) */
     55 #define NCI_MT_MASK         0xE0
     56 #define NCI_MT_SHIFT        5
     57 #define NCI_MT_DATA         0x00
     58 #define NCI_MT_CMD          1   /* (NCI_MT_CMD << NCI_MT_SHIFT) = 0x20 */
     59 #define NCI_MT_RSP          2   /* (NCI_MT_RSP << NCI_MT_SHIFT) = 0x40 */
     60 #define NCI_MT_NTF          3   /* (NCI_MT_NTF << NCI_MT_SHIFT) = 0x60 */
     61 #define NCI_MT_CFG          4   /* (NCI_MT_CFG << NCI_MT_SHIFT) = 0x80 */
     62 
     63 #define NCI_MTS_CMD         0x20
     64 #define NCI_MTS_RSP         0x40
     65 #define NCI_MTS_NTF         0x60
     66 #define NCI_MTS_CFG         0x80
     67 
     68 #define NCI_NTF_BIT         0x80     /* the tNFC_VS_EVT is a notification */
     69 #define NCI_RSP_BIT         0x40     /* the tNFC_VS_EVT is a response     */
     70 
     71 /* for internal use only; not from specification */
     72 /* the following 2 flags are used in layer_specific for fragmentation/reassembly of data packets */
     73 #define NCI_LS_DATA         0x00
     74 #define NCI_LS_DATA_PBF     0x01
     75 
     76 /* PBF: Packet Boundary Flag (byte 0) */
     77 #define NCI_PBF_MASK        0x10
     78 #define NCI_PBF_SHIFT       4
     79 #define NCI_PBF_NO_OR_LAST  0x00    /* not fragmented or last fragment */
     80 #define NCI_PBF_ST_CONT     0x10    /* start or continuing fragment */
     81 
     82 /* GID: Group Identifier (byte 0) */
     83 #define NCI_GID_MASK        0x0F
     84 #define NCI_GID_SHIFT       0
     85 #define NCI_GID_CORE        0x00    /* 0000b NCI Core group */
     86 #define NCI_GID_RF_MANAGE   0x01    /* 0001b RF Management group */
     87 #define NCI_GID_EE_MANAGE   0x02    /* 0010b NFCEE Management group */
     88 #define NCI_GID_PROP        0x0F    /* 1111b Proprietary */
     89 /* 0111b - 1110b RFU */
     90 
     91 /* OID: Opcode Identifier (byte 1) */
     92 #define NCI_OID_MASK        0x3F
     93 #define NCI_OID_SHIFT       0
     94 
     95 /* For routing */
     96 #define NCI_DH_ID               0   /* for DH */
     97 /* To identify the loopback test */
     98 #define NCI_TEST_ID             0xFE/* for loopback test */
     99 
    100 /* Destination Type */
    101 #define NCI_DEST_TYPE_NFCC      1   /* NFCC - loopback */
    102 #define NCI_DEST_TYPE_REMOTE    2   /* Remote NFC Endpoint */
    103 #define NCI_DEST_TYPE_NFCEE     3   /* NFCEE */
    104 
    105 /* builds byte0 of NCI Command and Notification packet */
    106 #define NCI_MSG_BLD_HDR0(p, mt, gid) \
    107     *(p)++ = (UINT8) (((mt) << NCI_MT_SHIFT) | (gid));
    108 
    109 #define NCI_MSG_PBLD_HDR0(p, mt, pbf, gid) \
    110     *(p)++ = (UINT8) (((mt) << NCI_MT_SHIFT) | ((pbf) << NCI_PBF_SHIFT) | (gid));
    111 
    112 /* builds byte1 of NCI Command and Notification packet */
    113 #define NCI_MSG_BLD_HDR1(p, oid) \
    114     *(p)++ = (UINT8) (((oid) << NCI_OID_SHIFT));
    115 
    116 /* parse byte0 of NCI packet */
    117 #define NCI_MSG_PRS_HDR0(p, mt, pbf, gid) \
    118     mt = (*(p) & NCI_MT_MASK) >> NCI_MT_SHIFT; \
    119     pbf = (*(p) & NCI_PBF_MASK) >> NCI_PBF_SHIFT; \
    120     gid = *(p)++ & NCI_GID_MASK;
    121 
    122 /* parse MT and PBF bits of NCI packet */
    123 #define NCI_MSG_PRS_MT_PBF(p, mt, pbf) \
    124     mt = (*(p) & NCI_MT_MASK) >> NCI_MT_SHIFT; \
    125     pbf = (*(p) & NCI_PBF_MASK) >> NCI_PBF_SHIFT;
    126 
    127 /* parse byte1 of NCI Cmd/Ntf */
    128 #define NCI_MSG_PRS_HDR1(p, oid) \
    129     oid = (*(p) & NCI_OID_MASK); (p)++;
    130 
    131 /* NCI Data Format:
    132  * byte 0: MT(0) PBF CID
    133  * byte 1: RFU
    134  * byte 2: Data Length */
    135 /* CID: Connection Identifier (byte 0) 1-0xF Dynamically assigned (by NFCC), 0 is predefined  */
    136 #define NCI_CID_MASK        0x0F
    137 
    138 /* builds 3-byte message header of NCI Data packet */
    139 #define NCI_DATA_BLD_HDR(p, cid, len) \
    140     *(p)++ = (UINT8) (cid); *(p)++ = 0; *(p)++ = (UINT8) (len);
    141 
    142 #define NCI_DATA_PBLD_HDR(p, pbf, cid, len) \
    143     *(p)++ = (UINT8) (((pbf) << NCI_PBF_SHIFT) | (cid)); *(p)++=0; *(p)++ = (len);
    144 
    145 #define NCI_DATA_PRS_HDR(p, pbf, cid, len) \
    146     (pbf) = (*(p) & NCI_PBF_MASK) >> NCI_PBF_SHIFT; (cid) = (*(p) & NCI_CID_MASK); p++; p++; (len) = *(p)++;
    147 
    148 
    149 /* Logical target ID 0x01-0xFE */
    150 
    151 
    152 
    153 /* Status Codes */
    154 #define NCI_STATUS_OK                   0x00
    155 #define NCI_STATUS_REJECTED             0x01
    156 #define NCI_STATUS_MESSAGE_CORRUPTED    0x02
    157 #define NCI_STATUS_BUFFER_FULL          0xE0
    158 #define NCI_STATUS_FAILED               0x03
    159 #define NCI_STATUS_NOT_INITIALIZED      0x04
    160 #define NCI_STATUS_SYNTAX_ERROR         0x05
    161 #define NCI_STATUS_SEMANTIC_ERROR       0x06
    162 #define NCI_STATUS_UNKNOWN_GID          0x07
    163 #define NCI_STATUS_UNKNOWN_OID          0x08
    164 #define NCI_STATUS_INVALID_PARAM        0x09
    165 #define NCI_STATUS_MSG_SIZE_TOO_BIG     0x0A
    166 /* discovery */
    167 #define NCI_STATUS_ALREADY_STARTED      0xA0
    168 #define NCI_STATUS_ACTIVATION_FAILED    0xA1
    169 #define NCI_STATUS_TEAR_DOWN            0xA2
    170 /* RF Interface */
    171 #define NCI_STATUS_RF_TRANSMISSION_ERR  0xB0
    172 #define NCI_STATUS_RF_PROTOCOL_ERR      0xB1
    173 #define NCI_STATUS_TIMEOUT              0xB2
    174 /* NFCEE Interface */
    175 #define NCI_STATUS_EE_INTF_ACTIVE_FAIL  0xC0
    176 #define NCI_STATUS_EE_TRANSMISSION_ERR  0xC1
    177 #define NCI_STATUS_EE_PROTOCOL_ERR      0xC2
    178 #define NCI_STATUS_EE_TIMEOUT           0xC3
    179 
    180 
    181 typedef UINT8 tNCI_STATUS;
    182 
    183 /* RF Technologies */
    184 #define NCI_RF_TECHNOLOGY_A             0x00
    185 #define NCI_RF_TECHNOLOGY_B             0x01
    186 #define NCI_RF_TECHNOLOGY_F             0x02
    187 #define NCI_RF_TECHNOLOGY_15693         0x03
    188 
    189 /* Bit Rates */
    190 #define NCI_BIT_RATE_106                0x00/* 106 kbit/s */
    191 #define NCI_BIT_RATE_212                0x01/* 212 kbit/s */
    192 #define NCI_BIT_RATE_424                0x02/* 424 kbit/s */
    193 #define NCI_BIT_RATE_848                0x03/* 848 Kbit/s */
    194 #define NCI_BIT_RATE_1696               0x04/* 1696 Kbit/s*/
    195 #define NCI_BIT_RATE_3392               0x05/* 3392 Kbit/s*/
    196 #define NCI_BIT_RATE_6784               0x06/* 6784 Kbit/s*/
    197 
    198 /**********************************************
    199  * NCI Core Group Opcode        - 0
    200  **********************************************/
    201 #define NCI_MSG_CORE_RESET              0
    202 #define NCI_MSG_CORE_INIT               1
    203 #define NCI_MSG_CORE_SET_CONFIG         2
    204 #define NCI_MSG_CORE_GET_CONFIG         3
    205 #define NCI_MSG_CORE_CONN_CREATE        4
    206 #define NCI_MSG_CORE_CONN_CLOSE         5
    207 #define NCI_MSG_CORE_CONN_CREDITS       6
    208 #define NCI_MSG_CORE_GEN_ERR_STATUS     7
    209 #define NCI_MSG_CORE_INTF_ERR_STATUS    8
    210 
    211 /**********************************************
    212  * RF MANAGEMENT Group Opcode    - 1
    213  **********************************************/
    214 #define NCI_MSG_RF_DISCOVER_MAP         0
    215 #define NCI_MSG_RF_SET_ROUTING          1
    216 #define NCI_MSG_RF_GET_ROUTING          2
    217 #define NCI_MSG_RF_DISCOVER             3
    218 #define NCI_MSG_RF_DISCOVER_SELECT      4
    219 #define NCI_MSG_RF_INTF_ACTIVATED       5
    220 #define NCI_MSG_RF_DEACTIVATE           6
    221 #define NCI_MSG_RF_FIELD                7
    222 #define NCI_MSG_RF_T3T_POLLING          8
    223 #define NCI_MSG_RF_EE_ACTION            9
    224 #define NCI_MSG_RF_EE_DISCOVERY_REQ     10
    225 #define NCI_MSG_RF_PARAMETER_UPDATE     11
    226 
    227 /**********************************************
    228  * NFCEE MANAGEMENT Group Opcode - 2
    229  **********************************************/
    230 #define NCI_MSG_NFCEE_DISCOVER          0
    231 #define NCI_MSG_NFCEE_MODE_SET          1
    232 
    233 /**********************************************
    234  * NCI Proprietary  Group       - F
    235  **********************************************/
    236 
    237 /**********************************************
    238  * NCI Core Group Params
    239  **********************************************/
    240 #define NCI_CORE_PARAM_SIZE_RESET       0x01
    241 #define NCI_CORE_PARAM_SIZE_RESET_RSP   0x03
    242 #define NCI_CORE_PARAM_SIZE_RESET_NTF   0x02
    243 
    244 #define NCI_CORE_PARAM_SIZE_INIT        0x00 /* no payload */
    245 #define NCI_CORE_PARAM_SIZE_INIT_RSP    0x11
    246 #define NCI_CORE_INIT_RSP_OFFSET_NUM_INTF   0x05
    247 
    248 #define NCI_CORE_PARAM_SIZE_SET_CONFIG_RSP   0x02    /* Status (1 octet) and number of params */
    249 
    250 
    251 /* octet 0 */
    252 #define NCI_FEAT_DISCOVERY_FREG     0x00000001
    253 #define NCI_FEAT_DISCOVERY_CFGM     0x00000006
    254 /* octet 1 */
    255 #define NCI_FEAT_TECHNOLOGY_ROUTING 0x00000200
    256 #define NCI_FEAT_PROTOCOL_ROUTING   0x00000400
    257 #define NCI_FEAT_AID_ROUTING        0x00000800
    258 /* octet 2 */
    259 #define NCI_FEAT_BATTERY_OFF_MD     0x00010000
    260 #define NCI_FEAT_SWITCH_OFF_MD      0x00020000
    261 
    262 
    263 /* supported Interfaces */
    264 #define NCI_SUP_INTF_FRAME           0x0001
    265 #define NCI_SUP_INTF_ISO_DEP         0x0002
    266 #define NCI_SUP_INTF_NFC_DEP         0x0004
    267 
    268 
    269 
    270 #define NCI_CORE_PARAM_SIZE_CON_CREATE      0x02 /* handle, num_tlv, (tlv) */
    271 #define NCI_CORE_PARAM_SIZE_CON_CREATE_RSP  0x04 /* status, size, credits, conn_id */
    272 #define NCI_CON_CREATE_TAG_EE_INTF          0x00 /* old */
    273 #define NCI_CON_CREATE_TAG_RF_DISC_ID       0x00
    274 #define NCI_CON_CREATE_TAG_NFCEE_VAL        0x01
    275 
    276 #define NCI_CORE_PARAM_SIZE_CON_CLOSE       0x01 /* Conn ID (1 octet) */
    277 #define NCI_CORE_PARAM_SIZE_CON_CLOSE_RSP   0x01 /* Status (1 octet) */
    278 
    279 #define NCI_CORE_PARAM_SIZE_RF_FIELD_NTF            0x01 /* RF Field Status (1 octet) */
    280 
    281 #define NCI_RESET_TYPE_KEEP_CFG         0x00  /* Keep the NCI configuration (if possible) and perform NCI initialization. */
    282 #define NCI_RESET_TYPE_RESET_CFG        0x01  /* Reset the NCI configuration, and perform NCI initialization. */
    283 
    284 #define NCI_RESET_STATUS_KEPT_CFG       0x00  /* NCI Configuration has been kept  */
    285 #define NCI_RESET_STATUS_RESET_CFG      0x01  /* NCI Configuration has been reset */
    286 
    287 #define NCI_RF_STS_NO_REMOTE    0x00 /* No operating field generated by remote device  */
    288 #define NCI_RF_STS_REMOTE       0x01 /* Operating field generated by remote device  */
    289 
    290 
    291 #define NCI_PARAM_SIZE_DISCOVER_NFCEE      0x01 /* Discovery Action (1 octet) */
    292 #define NCI_PARAM_SIZE_DISCOVER_NFCEE_RSP  0x02 /* Status (1 octet)Number of NFCEEs (1 octet) */
    293 
    294 #define NCI_DISCOVER_ACTION_DISABLE     0
    295 #define NCI_DISCOVER_ACTION_ENABLE      1
    296 
    297 #define NCI_EE_DISCOVER_REQ_TYPE_LISTEN     0x01
    298 #define NCI_EE_DISCOVER_REQ_TYPE_POLL       0x02
    299 
    300 #define NCI_RF_PARAM_ID_TECH_N_MODE     0x00  /* RF Technology and Mode   */
    301 #define NCI_RF_PARAM_ID_TX_BIT_RATE     0x01  /* Transmit Bit Rate        */
    302 #define NCI_RF_PARAM_ID_RX_BIT_RATE     0x02  /* Receive Bit Rate         */
    303 #define NCI_RF_PARAM_ID_B_DATA_EX_PARAM 0x03  /* B Data Exchange config param */
    304 
    305 
    306 #define NCI_NFCEE_INTERFACE_APDU         0x00
    307 #define NCI_NFCEE_INTERFACE_HCI_ACCESS   0x01
    308 #define NCI_NFCEE_INTERFACE_T3T          0x02
    309 #define NCI_NFCEE_INTERFACE_TRANSPARENT  0x03
    310 #define NCI_NFCEE_INTERFACE_PROPRIETARY  0x80
    311 
    312 #define NCI_NFCEE_STS_CONN_ACTIVE       0x00
    313 #define NCI_NFCEE_STS_CONN_INACTIVE     0x01
    314 #define NCI_NFCEE_STS_REMOVED           0x02
    315 #define NCI_NUM_NFCEE_STS               3
    316 
    317 #define NCI_CORE_PARAM_SIZE_NFCEE_MODE_SET      0x02 /* Logical Target ID (1 octet)NFCEE Mode (1 octet) */
    318 #define NCI_CORE_PARAM_SIZE_NFCEE_MODE_SET_RSP  0x01 /* Status (1 octet) */
    319 
    320 #define NCI_NFCEE_MD_DEACTIVATE         0x00    /* Deactivate the connected NFCEE */
    321 #define NCI_NFCEE_MD_ACTIVATE           0x01    /* Activate the connected NFCEE */
    322 #define NCI_NUM_NFCEE_MODE              2
    323 
    324 /**********************************************
    325  * NCI Deactivation Type
    326  **********************************************/
    327 #define NCI_DEACTIVATE_TYPE_IDLE        0   /* Idle Mode     */
    328 #define NCI_DEACTIVATE_TYPE_SLEEP       1   /* Sleep Mode    */
    329 #define NCI_DEACTIVATE_TYPE_SLEEP_AF    2   /* Sleep_AF Mode */
    330 #define NCI_DEACTIVATE_TYPE_DISCOVERY   3   /* Discovery     */
    331 
    332 /**********************************************
    333  * NCI Deactivation Reasons
    334  **********************************************/
    335 #define NCI_DEACTIVATE_REASON_DH_REQ        0   /* DH Request       */
    336 #define NCI_DEACTIVATE_REASON_ENDPOINT_REQ  1   /* Endpoint Request */
    337 #define NCI_DEACTIVATE_REASON_RF_LINK_LOSS  2   /* RF Link Loss     */
    338 #define NCI_DEACTIVATE_REASON_NFCB_BAD_AFI  3   /* NFC-B Bad AFI    */
    339 
    340  /**********************************************
    341  * NCI Interface Mode
    342  **********************************************/
    343 #define NCI_INTERFACE_MODE_POLL             1
    344 #define NCI_INTERFACE_MODE_LISTEN           2
    345 #define NCI_INTERFACE_MODE_POLL_N_LISTEN    3
    346 
    347 /**********************************************
    348  * NCI Interface Types
    349  **********************************************/
    350 #define NCI_INTERFACE_EE_DIRECT_RF      0
    351 #define NCI_INTERFACE_FRAME             1
    352 #define NCI_INTERFACE_ISO_DEP           2
    353 #define NCI_INTERFACE_NFC_DEP           3
    354 #define NCI_INTERFACE_MAX               NCI_INTERFACE_NFC_DEP
    355 #define NCI_INTERFACE_FIRST_VS          0x80
    356 typedef UINT8 tNCI_INTF_TYPE;
    357 
    358 /**********************************************
    359  * NCI RF Management / DISCOVERY Group Params
    360  **********************************************/
    361 #define NCI_DISCOVER_PARAM_SIZE_RSP     0x01
    362 
    363 #define NCI_DISCOVER_PARAM_SIZE_SELECT      0x03 /* ID, protocol, interface */
    364 #define NCI_DISCOVER_PARAM_SIZE_SELECT_RSP  0x01 /* Status (1 octet) */
    365 #define NCI_DISCOVER_PARAM_SIZE_STOP        0x00 /*  */
    366 #define NCI_DISCOVER_PARAM_SIZE_STOP_RSP    0x01 /* Status (1 octet) */
    367 #define NCI_DISCOVER_PARAM_SIZE_DEACT       0x01 /* type */
    368 #define NCI_DISCOVER_PARAM_SIZE_DEACT_RSP   0x01 /* Status (1 octet) */
    369 #define NCI_DISCOVER_PARAM_SIZE_DEACT_NTF   0x01 /* type */
    370 
    371 /**********************************************
    372  * Supported Protocols
    373  **********************************************/
    374 #define NCI_PROTOCOL_UNKNOWN            0x00
    375 #define NCI_PROTOCOL_T1T                0x01
    376 #define NCI_PROTOCOL_T2T                0x02
    377 #define NCI_PROTOCOL_T3T                0x03
    378 #define NCI_PROTOCOL_ISO_DEP            0x04
    379 #define NCI_PROTOCOL_NFC_DEP            0x05
    380 
    381 /* Discovery Types/Detected Technology and Mode */
    382 #define NCI_DISCOVERY_TYPE_POLL_A               0x00
    383 #define NCI_DISCOVERY_TYPE_POLL_B               0x01
    384 #define NCI_DISCOVERY_TYPE_POLL_F               0x02
    385 #define NCI_DISCOVERY_TYPE_POLL_A_ACTIVE        0x03
    386 #define NCI_DISCOVERY_TYPE_POLL_F_ACTIVE        0x05
    387 #define NCI_DISCOVERY_TYPE_LISTEN_A             0x80
    388 #define NCI_DISCOVERY_TYPE_LISTEN_B             0x81
    389 #define NCI_DISCOVERY_TYPE_LISTEN_F             0x82
    390 #define NCI_DISCOVERY_TYPE_LISTEN_A_ACTIVE      0x83
    391 #define NCI_DISCOVERY_TYPE_LISTEN_F_ACTIVE      0x85
    392 #define NCI_DISCOVERY_TYPE_POLL_ISO15693        0x06
    393 #define NCI_DISCOVERY_TYPE_LISTEN_ISO15693      0x86
    394 #define NCI_DISCOVERY_TYPE_MAX  NCI_DISCOVERY_TYPE_LISTEN_ISO15693
    395 
    396 typedef UINT8 tNCI_DISCOVERY_TYPE;
    397 
    398 #define NCI_EE_TRIG_7816_SELECT         0x00
    399 #define NCI_EE_TRIG_RF_PROTOCOL         0x01
    400 #define NCI_EE_TRIG_RF_TECHNOLOGY       0x02
    401 #define NCI_EE_TRIG_APP_INIT            0x10
    402 
    403 #define NCI_EE_ACT_TAG_AID              0xC0        /* AID                 */
    404 #define NCI_EE_ACT_TAG_PROTO            0xC1        /* RF protocol         */
    405 #define NCI_EE_ACT_TAG_TECH             0xC2        /* RF technology       */
    406 #define NCI_EE_ACT_TAG_DATA             0xC3        /* hex data for app    */
    407 #define NCI_EE_ACT_TAG_DEBUG            0xC4        /* debug trace         */
    408 
    409 #define NCI_ROUTE_TAG_TECH              0x00        /* Technology based routing  */
    410 #define NCI_ROUTE_TAG_PROTO             0x01        /* Protocol based routing  */
    411 #define NCI_ROUTE_TAG_AID               0x02        /* AID routing */
    412 
    413 #define NCI_ROUTE_PWR_STATE_ON          0x01        /* The device is on */
    414 #define NCI_ROUTE_PWR_STATE_SWITCH_OFF  0x02        /* The device is switched off */
    415 #define NCI_ROUTE_PWR_STATE_BATT_OFF    0x04        /* The device's battery is removed */
    416 
    417 #define NCI_NFCEE_TAG_HW_ID             0x00       /* Hardware / Registration Identification  */
    418 #define NCI_NFCEE_TAG_ATR_BYTES         0x01       /* ATR Bytes  */
    419 #define NCI_NFCEE_TAG_T3T_INFO          0x02       /* T3T Command Set Interface Supplementary Info */
    420 #define NCI_NFCEE_TAG_HCI_HOST_ID       0xA0       /* HCI host ID */
    421 
    422 #define NCI_DISCOVER_NTF_LAST           0x00
    423 #define NCI_DISCOVER_NTF_LAST_ABORT     0x01
    424 #define NCI_DISCOVER_NTF_MORE           0x02
    425 
    426 
    427 /* NCI RF Management Group Params */
    428 #define NCI_RF_PARAM_SIZE_T3T_POLLING   0x04        /* System Code, RC, TSN */
    429 
    430 /**********************************************
    431  * NCI Parameter IDs
    432  **********************************************/
    433 
    434 #define NCI_PARAM_ID_TOTAL_DURATION     0x00
    435 #define NCI_PARAM_ID_CON_DEVICES_LIMIT  0x01
    436 #define NCI_PARAM_ID_PA_BAILOUT         0x08
    437 #define NCI_PARAM_ID_PB_AFI             0x10
    438 #define NCI_PARAM_ID_PB_BAILOUT         0x11
    439 #define NCI_PARAM_ID_PB_ATTRIB_PARAM1   0x12
    440 #define NCI_PARAM_ID_PF_BIT_RATE        0x18
    441 #define NCI_PARAM_ID_PF_RC              0x19
    442 #define NCI_PARAM_ID_PB_H_INFO          0x20
    443 #define NCI_PARAM_ID_PI_BIT_RATE        0x21
    444 
    445 #define NCI_PARAM_ID_BITR_NFC_DEP       0x28
    446 #define NCI_PARAM_ID_ATR_REQ_GEN_BYTES  0x29
    447 #define NCI_PARAM_ID_ATR_REQ_CONFIG     0x2A
    448 
    449 #define NCI_PARAM_ID_LA_BIT_FRAME_SDD   0x30
    450 #define NCI_PARAM_ID_LA_PLATFORM_CONFIG 0x31
    451 #define NCI_PARAM_ID_LA_SEL_INFO        0x32
    452 #define NCI_PARAM_ID_LA_NFCID1          0x33
    453 #define NCI_PARAM_ID_LB_SENSB_INFO      0x38
    454 #define NCI_PARAM_ID_LB_NFCID0          0x39
    455 #define NCI_PARAM_ID_LB_APPDATA         0x3A
    456 #define NCI_PARAM_ID_LB_SFGI            0x3B
    457 #define NCI_PARAM_ID_LB_ADC_FO          0x3C
    458 #define NCI_PARAM_ID_LB_PROTOCOL        NCI_PARAM_ID_LB_SENSB_INFO
    459 
    460 #define NCI_PARAM_ID_LF_T3T_ID1         0x40
    461 #define NCI_PARAM_ID_LF_T3T_ID2         0x41
    462 #define NCI_PARAM_ID_LF_T3T_ID3         0x42
    463 #define NCI_PARAM_ID_LF_T3T_ID4         0x43
    464 #define NCI_PARAM_ID_LF_T3T_ID5         0x44
    465 #define NCI_PARAM_ID_LF_T3T_ID6         0x45
    466 #define NCI_PARAM_ID_LF_T3T_ID7         0x46
    467 #define NCI_PARAM_ID_LF_T3T_ID8         0x47
    468 #define NCI_PARAM_ID_LF_T3T_ID9         0x48
    469 #define NCI_PARAM_ID_LF_T3T_ID10        0x49
    470 #define NCI_PARAM_ID_LF_T3T_ID11        0x4A
    471 #define NCI_PARAM_ID_LF_T3T_ID12        0x4B
    472 #define NCI_PARAM_ID_LF_T3T_ID13        0x4C
    473 #define NCI_PARAM_ID_LF_T3T_ID14        0x4D
    474 #define NCI_PARAM_ID_LF_T3T_ID15        0x4E
    475 #define NCI_PARAM_ID_LF_T3T_ID16        0x4F
    476 #define NCI_PARAM_ID_LF_PROTOCOL        0x50
    477 #define NCI_PARAM_ID_LF_T3T_PMM         0x51
    478 #define NCI_PARAM_ID_LF_T3T_MAX         0x52    /* max num of LF_T3T_ID supported by NFCC (1 for now) */
    479 #define NCI_PARAM_ID_LF_T3T_FLAGS2      0x53
    480 #define NCI_PARAM_ID_LF_CON_BITR_F      0x54
    481 #define NCI_PARAM_ID_FWI                0x58
    482 #define NCI_PARAM_ID_LA_HIST_BY         0x59
    483 #define NCI_PARAM_ID_LB_H_INFO_RSP      0x5A
    484 #define NCI_PARAM_ID_LI_BIT_RATE        0x5B
    485 
    486 #define NCI_PARAM_ID_WT                 0x60
    487 #define NCI_PARAM_ID_ATR_RES_GEN_BYTES  0x61
    488 #define NCI_PARAM_ID_ATR_RSP_CONFIG     0x62
    489 
    490 #define NCI_PARAM_ID_RF_FIELD_INFO      0x80
    491 #define NCI_PARAM_ID_RF_NFCEE_ACTION    0x81
    492 #define NCI_PARAM_ID_NFC_DEP_OP         0x82
    493 
    494 
    495 
    496 /* NCI_PARAM_ID_HOST_LISTEN_MASK (byte1 for DH, byte2 for UICC) */
    497 #define NCI_LISTEN_MASK_A               0x01 /* (0x01 << (NCI_DISCOVERY_TYPE_LISTEN_A_PASSIVE & 0x0F)) */
    498 #define NCI_LISTEN_MASK_B               0x02 /* (0x01 << (NCI_DISCOVERY_TYPE_LISTEN_B_PASSIVE & 0x0F)) */
    499 #define NCI_LISTEN_MASK_F               0x04 /* (0x01 << (NCI_DISCOVERY_TYPE_LISTEN_F_PASSIVE & 0x0F)) */
    500 #define NCI_LISTEN_MASK_A_ACTIVE        0x08 /* (0x01 << (NCI_DISCOVERY_TYPE_LISTEN_A_ACTIVE & 0x0F))  */
    501 #define NCI_LISTEN_MASK_B_PRIME         0x10 /* (0x01 << (NCI_DISCOVERY_TYPE_LISTEN_B_PRIME & 0x0F))   */
    502 #define NCI_LISTEN_MASK_F_ACTIVE        0x20 /* (0x01 << (NCI_DISCOVERY_TYPE_LISTEN_F_ACTIVE & 0x0F))  */
    503 #define NCI_LISTEN_MASK_ISO15693        0x40 /* (0x01 << (NCI_DISCOVERY_TYPE_LISTEN_ISO15693 & 0x0F))  */
    504 
    505 /* Type A Parameters */
    506 #define NCI_PARAM_PLATFORM_T1T      0x0C
    507 #define NCI_PARAM_SEL_INFO_ISODEP   0x20
    508 #define NCI_PARAM_SEL_INFO_NFCDEP   0x40
    509 /**********************************************
    510  * NCI Parameter ID Lens
    511  **********************************************/
    512 #define NCI_PARAM_LEN_TOTAL_DURATION        2
    513 
    514 #define NCI_PARAM_LEN_PA_FSDI               1
    515 
    516 #define NCI_PARAM_LEN_PF_RC                 1
    517 
    518 #define NCI_PARAM_LEN_LA_BIT_FRAME_SDD      1
    519 #define NCI_PARAM_LEN_LA_PLATFORM_CONFIG    1
    520 #define NCI_PARAM_LEN_LA_SEL_INFO           1
    521 
    522 #define NCI_PARAM_LEN_LB_SENSB_INFO         1
    523 #define NCI_PARAM_LEN_LB_NFCID0             4
    524 #define NCI_PARAM_LEN_LB_APPDATA            4
    525 #define NCI_PARAM_LEN_LB_ADC_FO             1
    526 
    527 #define NCI_PARAM_LEN_LF_PROTOCOL           1
    528 #define NCI_PARAM_LEN_LF_T3T_FLAGS2         2
    529 #define NCI_PARAM_LEN_LF_T3T_PMM            8
    530 #define NCI_PARAM_LEN_LF_T3T_ID            10
    531 
    532 #define NCI_PARAM_LEN_FWI                   1
    533 #define NCI_PARAM_LEN_WT                    1
    534 /* GEN_BYTES - variable */
    535 
    536 /* Listen protocol bits - NCI_PARAM_ID_LF_PROTOCOL and NCI_PARAM_ID_LB_SENSB_INFO */
    537 #define NCI_LISTEN_PROTOCOL_ISO_DEP     0x01
    538 #define NCI_LISTEN_PROTOCOL_NFC_DEP     0x02
    539 
    540 #define NCI_DISCOVER_PARAM_SIZE_TEST_RF       0x06
    541 
    542 
    543 /* LF_T3T_FLAGS2 listen bits all-disabled definition */
    544 #define NCI_LF_T3T_FLAGS2_ALL_DISABLED  0x0000
    545 #define NCI_LF_T3T_FLAGS2_ID1_ENABLED   0x0001
    546 
    547 typedef struct
    548 {
    549     UINT16              addr;
    550     UINT8               len;
    551     UINT8               *data;
    552 } NCIP_T1T_SETMEM_CMD_t;
    553 
    554 typedef struct
    555 {
    556     UINT8               status;
    557 } NCIP_T1T_SETMEM_RSP_t;
    558 
    559 typedef struct
    560 {
    561     UINT16              addr;
    562 } NCIP_T1T_GETMEM_CMD_t;
    563 
    564 typedef struct
    565 {
    566     UINT8               status;
    567     UINT8               *data;
    568 } NCIP_T1T_GETMEM_RSP_t;
    569 
    570 typedef struct
    571 {
    572     UINT8               hr0;
    573     UINT8               hr1;
    574 } NCIP_T1T_SETHR_CMD_t;
    575 
    576 typedef struct
    577 {
    578     UINT8               status;
    579 } NCIP_T1T_SETHR_RSP_t;
    580 
    581 
    582 #ifndef NCI_GET_CMD_BUF
    583 #if (!defined (HCI_USE_VARIABLE_SIZE_CMD_BUF) || (HCI_USE_VARIABLE_SIZE_CMD_BUF == FALSE))
    584 /* Allocate fixed-size buffer from HCI_CMD_POOL (default case) */
    585 #define NCI_GET_CMD_BUF(paramlen)    ((BT_HDR *) GKI_getpoolbuf (NFC_NCI_POOL_ID))
    586 #else
    587 /* Allocate smallest possible buffer (for platforms with limited RAM) */
    588 #define NCI_GET_CMD_BUF(paramlen)    ((BT_HDR *) GKI_getbuf ((UINT16) (BT_HDR_SIZE + NCI_MSG_HDR_SIZE + NCI_MSG_OFFSET_SIZE + (paramlen))))
    589 #endif
    590 #endif  /* NCI_GET_CMD_BUF */
    591 
    592 
    593 #define NCI_MAX_AID_LEN     16
    594 
    595 
    596 typedef struct
    597 {
    598     UINT8   type;
    599     UINT8   frequency;
    600 } tNCI_DISCOVER_PARAMS;
    601 
    602 typedef struct
    603 {
    604     UINT8   protocol;
    605     UINT8   mode;
    606     UINT8   intf_type;
    607 } tNCI_DISCOVER_MAPS;
    608 
    609 #define NCI_NFCID1_MAX_LEN    10
    610 #define NCI_T1T_HR_LEN        2
    611 typedef struct
    612 {
    613     UINT8       sens_res[2];/* SENS_RES Response (ATQA). Available after Technology Detection */
    614     UINT8       nfcid1_len;         /* 4, 7 or 10 */
    615     UINT8       nfcid1[NCI_NFCID1_MAX_LEN]; /* AKA NFCID1 */
    616     UINT8       sel_rsp;    /* SEL_RSP (SAK) Available after Collision Resolution */
    617     UINT8       hr_len;     /* 2, if T1T HR0/HR1 is reported */
    618     UINT8       hr[NCI_T1T_HR_LEN]; /* T1T HR0 is in hr[0], HR1 is in hr[1] */
    619 } tNCI_RF_PA_PARAMS;
    620 
    621 
    622 #define NCI_MAX_SENSB_RES_LEN       12
    623 typedef struct
    624 {
    625     UINT8       sensb_res_len;/* Length of SENSB_RES Response (Byte 2 - Byte 12 or 13) Available after Technology Detection */
    626     UINT8       sensb_res[NCI_MAX_SENSB_RES_LEN]; /* SENSB_RES Response (ATQ) */
    627 } tNCI_RF_PB_PARAMS;
    628 
    629 #define NCI_MAX_SENSF_RES_LEN       18
    630 #define NCI_SENSF_RES_OFFSET_PAD0   8
    631 #define NCI_SENSF_RES_OFFSET_RD     16
    632 #define NCI_NFCID2_LEN              8
    633 #define NCI_T3T_PMM_LEN             8
    634 #define NCI_SYSTEMCODE_LEN          2
    635 #define NCI_RF_F_UID_LEN            NCI_NFCID2_LEN
    636 #define NCI_MRTI_CHECK_INDEX        13
    637 #define NCI_MRTI_UPDATE_INDEX       14
    638 typedef struct
    639 {
    640     UINT8       bit_rate;/* NFC_BIT_RATE_212 or NFC_BIT_RATE_424 */
    641     UINT8       sensf_res_len;/* Length of SENSF_RES Response (Byte 2 - Byte 17 or 19) Available after Technology Detection */
    642     UINT8       sensf_res[NCI_MAX_SENSF_RES_LEN]; /* SENSB_RES Response */
    643 } tNCI_RF_PF_PARAMS;
    644 
    645 typedef struct
    646 {
    647     UINT8       nfcid2[NCI_NFCID2_LEN];  /* NFCID2 generated by the Local NFCC for NFC-DEP Protocol.Available for Frame Interface  */
    648 } tNCI_RF_LF_PARAMS;
    649 
    650 typedef struct
    651 {
    652     tNCI_DISCOVERY_TYPE     mode;
    653     union
    654     {
    655         tNCI_RF_PA_PARAMS   pa;
    656         tNCI_RF_PB_PARAMS   pb;
    657         tNCI_RF_PF_PARAMS   pf;
    658         tNCI_RF_LF_PARAMS   lf;
    659     } param; /* Discovery Type specific parameters */
    660 } tNCI_RF_TECH_PARAMS;
    661 
    662 
    663 #ifndef NCI_MAX_ATS_LEN
    664 #define NCI_MAX_ATS_LEN             60
    665 #endif
    666 #ifndef NCI_MAX_HIS_BYTES_LEN
    667 #define NCI_MAX_HIS_BYTES_LEN       50
    668 #endif
    669 #ifndef NCI_MAX_GEN_BYTES_LEN
    670 #define NCI_MAX_GEN_BYTES_LEN       48
    671 #endif
    672 
    673 #define NCI_ATS_T0_INDEX            0
    674 #define NCI_ATS_TC_MASK             0x40
    675 #define NCI_ATS_TB_MASK             0x20
    676 #define NCI_ATS_TA_MASK             0x10
    677 #define NCI_ATS_FSCI_MASK           0x0F
    678 typedef struct
    679 {
    680     UINT8       ats_res_len;  /* Length of ATS RES */
    681     UINT8       ats_res[NCI_MAX_ATS_LEN];  /* ATS RES defined in [DIGPROT] */
    682 } tNCI_INTF_PA_ISO_DEP;
    683 
    684 typedef struct
    685 {
    686     UINT8       rats;  /* RATS */
    687 } tNCI_INTF_LA_ISO_DEP;
    688 
    689 #define NCI_P_GEN_BYTE_INDEX    15
    690 #define NCI_L_GEN_BYTE_INDEX    14
    691 #define NCI_L_NFC_DEP_TO_INDEX  13
    692 typedef struct
    693 {
    694     UINT8       atr_res_len;  /* Length of ATR_RES */
    695     UINT8       atr_res[NCI_MAX_ATS_LEN];  /* ATR_RES (Byte 3 - Byte 17+n) as defined in [DIGPROT] */
    696 } tNCI_INTF_PA_NFC_DEP;
    697 
    698 /* Note: keep tNCI_INTF_PA_NFC_DEP data member in the same order as tNCI_INTF_LA_NFC_DEP */
    699 typedef struct
    700 {
    701     UINT8       atr_req_len;  /* Length of ATR_REQ */
    702     UINT8       atr_req[NCI_MAX_ATS_LEN];  /* ATR_REQ (Byte 3 - Byte 18+n) as defined in [DIGPROT] */
    703 } tNCI_INTF_LA_NFC_DEP;
    704 typedef tNCI_INTF_LA_NFC_DEP tNCI_INTF_LF_NFC_DEP;
    705 typedef tNCI_INTF_PA_NFC_DEP tNCI_INTF_PF_NFC_DEP;
    706 
    707 #define NCI_MAX_ATTRIB_LEN   (10 + NCI_MAX_GEN_BYTES_LEN)
    708 
    709 typedef struct
    710 {
    711     UINT8       attrib_res_len;  /* Length of ATTRIB RES */
    712     UINT8       attrib_res[NCI_MAX_ATTRIB_LEN];  /* ATTRIB RES  as defined in [DIGPROT] */
    713 } tNCI_INTF_PB_ISO_DEP;
    714 
    715 typedef struct
    716 {
    717     UINT8       attrib_req_len;  /* Length of ATTRIB REQ */
    718     UINT8       attrib_req[NCI_MAX_ATTRIB_LEN];  /* ATTRIB REQ (Byte 2 - Byte 10+k) as defined in [DIGPROT] */
    719 } tNCI_INTF_LB_ISO_DEP;
    720 
    721 typedef struct
    722 {
    723     tNCI_INTF_TYPE      type;  /* Interface Type  1 Byte  See Table 67 */
    724     union
    725     {
    726         tNCI_INTF_LA_ISO_DEP    la_iso;
    727         tNCI_INTF_PA_ISO_DEP    pa_iso;
    728         tNCI_INTF_LB_ISO_DEP    lb_iso;
    729         tNCI_INTF_PB_ISO_DEP    pb_iso;
    730         tNCI_INTF_LA_NFC_DEP    la_nfc;
    731         tNCI_INTF_PA_NFC_DEP    pa_nfc;
    732         tNCI_INTF_LF_NFC_DEP    lf_nfc;
    733         tNCI_INTF_PF_NFC_DEP    pf_nfc;
    734     } intf_param;       /* Activation Parameters   0 - n Bytes */
    735 } tNCI_INTF_PARAMS;
    736 
    737 #ifdef __cplusplus
    738 }
    739 #endif
    740 
    741 #endif  /* NFC_NCI_DEFS_H */
    742