1 /****************************************************************************** 2 * 3 * Copyright (C) 2003-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 * This is the private interface file for the NFA device manager. 22 * 23 ******************************************************************************/ 24 #ifndef NFA_DM_INT_H 25 #define NFA_DM_INT_H 26 27 #include "nfa_api.h" 28 #include "nfa_sys.h" 29 #include "nfc_api.h" 30 31 /***************************************************************************** 32 ** Constants and data types 33 *****************************************************************************/ 34 35 /* DM events */ 36 enum { 37 /* device manager local device API events */ 38 NFA_DM_API_ENABLE_EVT = NFA_SYS_EVT_START(NFA_ID_DM), 39 NFA_DM_API_DISABLE_EVT, 40 NFA_DM_API_SET_CONFIG_EVT, 41 NFA_DM_API_GET_CONFIG_EVT, 42 NFA_DM_API_REQUEST_EXCL_RF_CTRL_EVT, 43 NFA_DM_API_RELEASE_EXCL_RF_CTRL_EVT, 44 NFA_DM_API_ENABLE_POLLING_EVT, 45 NFA_DM_API_DISABLE_POLLING_EVT, 46 NFA_DM_API_ENABLE_LISTENING_EVT, 47 NFA_DM_API_DISABLE_LISTENING_EVT, 48 NFA_DM_API_PAUSE_P2P_EVT, 49 NFA_DM_API_RESUME_P2P_EVT, 50 NFA_DM_API_RAW_FRAME_EVT, 51 NFA_DM_API_SET_P2P_LISTEN_TECH_EVT, 52 NFA_DM_API_START_RF_DISCOVERY_EVT, 53 NFA_DM_API_STOP_RF_DISCOVERY_EVT, 54 NFA_DM_API_SET_RF_DISC_DURATION_EVT, 55 NFA_DM_API_SELECT_EVT, 56 NFA_DM_API_UPDATE_RF_PARAMS_EVT, 57 NFA_DM_API_DEACTIVATE_EVT, 58 NFA_DM_API_POWER_OFF_SLEEP_EVT, 59 NFA_DM_API_REG_NDEF_HDLR_EVT, 60 NFA_DM_API_DEREG_NDEF_HDLR_EVT, 61 NFA_DM_API_REG_VSC_EVT, 62 NFA_DM_API_SEND_VSC_EVT, 63 NFA_DM_TIMEOUT_DISABLE_EVT, 64 NFA_DM_API_SET_POWER_SUB_STATE_EVT, 65 NFA_DM_API_SEND_RAW_VS_EVT, 66 NFA_DM_MAX_EVT 67 }; 68 69 /* data type for NFA_DM_API_ENABLE_EVT */ 70 typedef struct { 71 NFC_HDR hdr; 72 tNFA_DM_CBACK* p_dm_cback; 73 tNFA_CONN_CBACK* p_conn_cback; 74 } tNFA_DM_API_ENABLE; 75 76 /* data type for NFA_DM_API_DISABLE_EVT */ 77 typedef struct { 78 NFC_HDR hdr; 79 bool graceful; 80 } tNFA_DM_API_DISABLE; 81 82 /* data type for NFA_DM_API_SET_CONFIG_EVT */ 83 typedef struct { 84 NFC_HDR hdr; 85 tNFA_PMID param_id; 86 uint8_t length; 87 uint8_t* p_data; 88 } tNFA_DM_API_SET_CONFIG; 89 90 /* data type for NFA_DM_API_GET_CONFIG_EVT */ 91 typedef struct { 92 NFC_HDR hdr; 93 uint8_t num_ids; 94 tNFA_PMID* p_pmids; 95 } tNFA_DM_API_GET_CONFIG; 96 97 /* data type for NFA_DM_API_REQ_EXCL_RF_CTRL_EVT */ 98 typedef struct { 99 NFC_HDR hdr; 100 tNFA_TECHNOLOGY_MASK poll_mask; 101 tNFA_LISTEN_CFG listen_cfg; 102 tNFA_CONN_CBACK* p_conn_cback; 103 tNFA_NDEF_CBACK* p_ndef_cback; 104 } tNFA_DM_API_REQ_EXCL_RF_CTRL; 105 106 /* data type for NFA_DM_API_ENABLE_POLLING_EVT */ 107 typedef struct { 108 NFC_HDR hdr; 109 tNFA_TECHNOLOGY_MASK poll_mask; 110 } tNFA_DM_API_ENABLE_POLL; 111 112 /* data type for NFA_DM_API_SET_P2P_LISTEN_TECH_EVT */ 113 typedef struct { 114 NFC_HDR hdr; 115 tNFA_TECHNOLOGY_MASK tech_mask; 116 } tNFA_DM_API_SET_P2P_LISTEN_TECH; 117 118 /* data type for NFA_DM_API_SELECT_EVT */ 119 typedef struct { 120 NFC_HDR hdr; 121 uint8_t rf_disc_id; 122 tNFA_NFC_PROTOCOL protocol; 123 tNFA_INTF_TYPE rf_interface; 124 } tNFA_DM_API_SELECT; 125 126 /* data type for NFA_DM_API_UPDATE_RF_PARAMS_EVT */ 127 typedef struct { 128 NFC_HDR hdr; 129 tNFA_RF_COMM_PARAMS params; 130 } tNFA_DM_API_UPDATE_RF_PARAMS; 131 132 /* data type for NFA_DM_API_DEACTIVATE_EVT */ 133 typedef struct { 134 NFC_HDR hdr; 135 bool sleep_mode; 136 } tNFA_DM_API_DEACTIVATE; 137 138 /* data type for NFA_DM_API_SET_RF_DISC_DURATION_EVT */ 139 typedef struct { 140 NFC_HDR hdr; 141 uint16_t rf_disc_dur_ms; 142 } tNFA_DM_API_SET_RF_DISC_DUR; 143 #define NFA_RF_DISC_DURATION_MAX 0xFFFF 144 145 /* data type for NFA_DM_API_REG_NDEF_HDLR_EVT */ 146 #define NFA_NDEF_FLAGS_HANDLE_WHOLE_MESSAGE 0x01 147 #define NFA_NDEF_FLAGS_WKT_URI 0x02 148 #define NFA_NDEF_FLAGS_WHOLE_MESSAGE_NOTIFIED 0x04 149 150 typedef struct { 151 NFC_HDR hdr; 152 tNFA_HANDLE ndef_type_handle; 153 uint8_t flags; 154 tNFA_NDEF_CBACK* p_ndef_cback; 155 tNFA_TNF tnf; /* Type-name field of record-type that was registered. */ 156 tNFA_NDEF_URI_ID 157 uri_id; /* URI prefix abrieviation (for NFA_RegisterNDefUriHandler) */ 158 uint8_t name_len; /* Length of type name or absolute URI */ 159 uint8_t name[1]; /* Type name or absolute URI of record-type that got was 160 registered. */ 161 } tNFA_DM_API_REG_NDEF_HDLR; 162 163 /* data type for NFA_DM_API_DEREG_NDEF_HDLR_EVT */ 164 typedef struct { 165 NFC_HDR hdr; 166 tNFA_HANDLE ndef_type_handle; 167 } tNFA_DM_API_DEREG_NDEF_HDLR; 168 169 /* data type for NFA_DM_API_REG_VSC_EVT */ 170 typedef struct { 171 NFC_HDR hdr; 172 tNFA_VSC_CBACK* p_cback; 173 bool is_register; 174 } tNFA_DM_API_REG_VSC; 175 176 /* data type for NFA_DM_API_SEND_VSC_EVT */ 177 typedef struct { 178 NFC_HDR hdr; 179 tNFA_VSC_CBACK* p_cback; 180 uint8_t oid; 181 uint8_t cmd_params_len; 182 uint16_t pad; /* add padding to ensure the size is big enough for 183 offset=NCI_VSC_MSG_HDR_SIZE */ 184 uint8_t* p_cmd_params; 185 } tNFA_DM_API_SEND_VSC; 186 187 /* data type for NFA_DM_API_SET_POWER_SUB_STATE_EVT */ 188 typedef struct { 189 NFC_HDR hdr; 190 uint8_t screen_state; 191 } tNFA_DM_API_SET_POWER_SUB_STATE; 192 193 /* union of all data types */ 194 typedef union { 195 /* GKI event buffer header */ 196 NFC_HDR hdr; /* NFA_DM_API_RAW_FRAME_EVT */ 197 /* NFA_DM_API_MULTI_TECH_RSP_EVT */ 198 /* NFA_DM_API_RELEASE_EXCL_RF_CTRL */ 199 /* NFA_DM_API_DISABLE_POLLING_EVT */ 200 /* NFA_DM_API_START_RF_DISCOVERY_EVT */ 201 /* NFA_DM_API_STOP_RF_DISCOVERY_EVT */ 202 tNFA_DM_API_ENABLE enable; /* NFA_DM_API_ENABLE_EVT */ 203 tNFA_DM_API_DISABLE disable; /* NFA_DM_API_DISABLE_EVT */ 204 tNFA_DM_API_SET_CONFIG setconfig; /* NFA_DM_API_SET_CONFIG_EVT */ 205 tNFA_DM_API_GET_CONFIG getconfig; /* NFA_DM_API_GET_CONFIG_EVT */ 206 tNFA_DM_API_SET_RF_DISC_DUR 207 disc_duration; /* NFA_DM_API_SET_RF_DISC_DURATION_EVT */ 208 tNFA_DM_API_REG_NDEF_HDLR reg_ndef_hdlr; /* NFA_DM_API_REG_NDEF_HDLR_EVT */ 209 tNFA_DM_API_DEREG_NDEF_HDLR 210 dereg_ndef_hdlr; /* NFA_DM_API_DEREG_NDEF_HDLR_EVT */ 211 tNFA_DM_API_REQ_EXCL_RF_CTRL 212 req_excl_rf_ctrl; /* NFA_DM_API_REQUEST_EXCL_RF_CTRL */ 213 tNFA_DM_API_ENABLE_POLL enable_poll; /* NFA_DM_API_ENABLE_POLLING_EVT */ 214 tNFA_DM_API_SET_P2P_LISTEN_TECH 215 set_p2p_listen_tech; /* NFA_DM_API_SET_P2P_LISTEN_TECH_EVT */ 216 tNFA_DM_API_SELECT select; /* NFA_DM_API_SELECT_EVT */ 217 tNFA_DM_API_UPDATE_RF_PARAMS 218 update_rf_params; /* NFA_DM_API_UPDATE_RF_PARAMS_EVT */ 219 tNFA_DM_API_DEACTIVATE deactivate; /* NFA_DM_API_DEACTIVATE_EVT */ 220 tNFA_DM_API_SEND_VSC send_vsc; /* NFA_DM_API_SEND_VSC_EVT */ 221 tNFA_DM_API_REG_VSC reg_vsc; /* NFA_DM_API_REG_VSC_EVT */ 222 /* NFA_DM_API_SET_POWER_SUB_STATE_EVT */ 223 tNFA_DM_API_SET_POWER_SUB_STATE set_power_state; 224 } tNFA_DM_MSG; 225 226 /* DM RF discovery state */ 227 enum { 228 NFA_DM_RFST_IDLE, /* idle state */ 229 NFA_DM_RFST_DISCOVERY, /* discovery state */ 230 NFA_DM_RFST_W4_ALL_DISCOVERIES, /* wait for all discoveries state */ 231 NFA_DM_RFST_W4_HOST_SELECT, /* wait for host selection state */ 232 NFA_DM_RFST_POLL_ACTIVE, /* poll mode activated state */ 233 NFA_DM_RFST_LISTEN_ACTIVE, /* listen mode activated state */ 234 NFA_DM_RFST_LISTEN_SLEEP, /* listen mode sleep state */ 235 NFA_DM_RFST_LP_LISTEN, /* Listening in Low Power mode */ 236 NFA_DM_RFST_LP_ACTIVE /* Activated in Low Power mode */ 237 }; 238 typedef uint8_t tNFA_DM_RF_DISC_STATE; 239 240 /* DM RF discovery state machine event */ 241 enum { 242 NFA_DM_RF_DISCOVER_CMD, /* start RF discovery */ 243 NFA_DM_RF_DISCOVER_RSP, /* discover response from NFCC */ 244 NFA_DM_RF_DISCOVER_NTF, /* RF discovery NTF from NFCC */ 245 NFA_DM_RF_DISCOVER_SELECT_CMD, /* select discovered target */ 246 NFA_DM_RF_DISCOVER_SELECT_RSP, /* select response from NFCC */ 247 NFA_DM_RF_INTF_ACTIVATED_NTF, /* RF interface activation NTF from NFCC */ 248 NFA_DM_RF_DEACTIVATE_CMD, /* deactivate RF interface */ 249 NFA_DM_RF_DEACTIVATE_RSP, /* deactivate response from NFCC */ 250 NFA_DM_RF_DEACTIVATE_NTF, /* deactivate RF interface NTF from NFCC */ 251 NFA_DM_LP_LISTEN_CMD, /* NFCC is listening in low power mode */ 252 NFA_DM_CORE_INTF_ERROR_NTF, /* RF interface error NTF from NFCC */ 253 NFA_DM_DISC_SM_MAX_EVENT 254 }; 255 typedef uint8_t tNFA_DM_RF_DISC_SM_EVENT; 256 257 /* DM RF discovery state machine data */ 258 typedef struct { 259 uint8_t rf_disc_id; 260 tNFA_NFC_PROTOCOL protocol; 261 tNFA_INTF_TYPE rf_interface; 262 } tNFA_DM_DISC_SELECT_PARAMS; 263 264 typedef union { 265 tNFC_DISCOVER nfc_discover; /* discovery data from NFCC */ 266 tNFC_DEACT_TYPE deactivate_type; /* deactivation type */ 267 tNFA_DM_DISC_SELECT_PARAMS select; /* selected target information */ 268 } tNFA_DM_RF_DISC_DATA; 269 270 /* Callback event from NFA DM RF Discovery to other NFA sub-modules */ 271 enum { 272 NFA_DM_RF_DISC_START_EVT, /* discovery started with protocol, technology and 273 mode */ 274 NFA_DM_RF_DISC_ACTIVATED_EVT, /* activated with configured protocol, 275 technology and mode */ 276 NFA_DM_RF_DISC_DEACTIVATED_EVT /* deactivated sleep or idle */ 277 }; 278 typedef uint8_t tNFA_DM_RF_DISC_EVT; 279 280 /* Combined NFC Technology and protocol bit mask */ 281 #define NFA_DM_DISC_MASK_PA_T1T 0x00000001 282 #define NFA_DM_DISC_MASK_PA_T2T 0x00000002 283 #define NFA_DM_DISC_MASK_PA_ISO_DEP 0x00000004 284 #define NFA_DM_DISC_MASK_PA_NFC_DEP 0x00000008 285 #define NFA_DM_DISC_MASK_PB_ISO_DEP 0x00000010 286 #define NFA_DM_DISC_MASK_PF_T3T 0x00000020 287 #define NFA_DM_DISC_MASK_PF_NFC_DEP 0x00000040 288 #define NFA_DM_DISC_MASK_P_T5T 0x00000100 289 #define NFA_DM_DISC_MASK_P_B_PRIME 0x00000200 290 #define NFA_DM_DISC_MASK_P_KOVIO 0x00000400 291 #define NFA_DM_DISC_MASK_PAA_NFC_DEP 0x00000800 292 #define NFA_DM_DISC_MASK_PACM_NFC_DEP 0x00000800 293 #define NFA_DM_DISC_MASK_PFA_NFC_DEP 0x00001000 294 /* Legacy/proprietary/non-NFC Forum protocol (e.g Shanghai transit card) */ 295 #define NFA_DM_DISC_MASK_P_LEGACY 0x00002000 296 #define NFA_DM_DISC_MASK_POLL 0x0000FFFF 297 298 #define NFA_DM_DISC_MASK_LA_T1T 0x00010000 299 #define NFA_DM_DISC_MASK_LA_T2T 0x00020000 300 #define NFA_DM_DISC_MASK_LA_ISO_DEP 0x00040000 301 #define NFA_DM_DISC_MASK_LA_NFC_DEP 0x00080000 302 #define NFA_DM_DISC_MASK_LB_ISO_DEP 0x00100000 303 #define NFA_DM_DISC_MASK_LF_T3T 0x00200000 304 #define NFA_DM_DISC_MASK_LF_NFC_DEP 0x00400000 305 #define NFA_DM_DISC_MASK_L_ISO15693 0x01000000 306 #define NFA_DM_DISC_MASK_L_B_PRIME 0x02000000 307 #define NFA_DM_DISC_MASK_LACM_NFC_DEP 0x04000000 308 #define NFA_DM_DISC_MASK_LAA_NFC_DEP 0x04000000 309 #define NFA_DM_DISC_MASK_LFA_NFC_DEP 0x08000000 310 #define NFA_DM_DISC_MASK_L_LEGACY 0x10000000 311 #define NFA_DM_DISC_MASK_LISTEN 0xFFFF0000 312 313 #define NFA_DM_DISC_MASK_NFC_DEP 0x0C481848 314 315 typedef uint32_t tNFA_DM_DISC_TECH_PROTO_MASK; 316 317 /* DM RF discovery host ID */ 318 #define NFA_DM_DISC_HOST_ID_DH NFC_DH_ID 319 typedef uint8_t tNFA_DM_DISC_HOST_ID; 320 321 /* DM deactivation callback type */ 322 typedef void(tNFA_DISCOVER_CBACK)(tNFA_DM_RF_DISC_EVT event, 323 tNFC_DISCOVER* p_data); 324 325 /* DM RF discovery action flags */ 326 /* RF discovery process has been started */ 327 #define NFA_DM_DISC_FLAGS_ENABLED 0x0001 328 /* Stop RF discovery is pending */ 329 #define NFA_DM_DISC_FLAGS_STOPPING 0x0002 330 /* Disable NFA is pending */ 331 #define NFA_DM_DISC_FLAGS_DISABLING 0x0004 332 /* Sleep wakeup in progress */ 333 #define NFA_DM_DISC_FLAGS_CHECKING 0x0008 334 /* Notify sub-module that discovery is starting */ 335 #define NFA_DM_DISC_FLAGS_NOTIFY 0x0010 336 /* command has been sent to NFCC in the state */ 337 #define NFA_DM_DISC_FLAGS_W4_RSP 0x0020 338 /* wait for NTF before changing discovery state */ 339 #define NFA_DM_DISC_FLAGS_W4_NTF 0x0040 340 341 typedef uint16_t tNFA_DM_DISC_FLAGS; 342 343 /* DM Discovery control block */ 344 typedef struct { 345 bool in_use; /* TRUE if used */ 346 tNFA_DISCOVER_CBACK* p_disc_cback; /* discovery callback */ 347 348 tNFA_DM_DISC_FLAGS disc_flags; /* specific action flags */ 349 tNFA_DM_DISC_HOST_ID host_id; /* DH or UICC1/UICC2 */ 350 tNFA_DM_DISC_TECH_PROTO_MASK 351 requested_disc_mask; /* technology and protocol requested */ 352 tNFA_DM_DISC_TECH_PROTO_MASK 353 selected_disc_mask; /* technology and protocol waiting for activation */ 354 } tNFA_DM_DISC_ENTRY; 355 356 /* polling, raw listen, P2P listen, NDEF CE, 2xVSE, 2xUICC */ 357 #define NFA_DM_DISC_NUM_ENTRIES 8 358 359 /* max discovery technology parameters */ 360 #define NFA_DM_MAX_DISC_PARAMS 16 361 362 /* index of listen mode routing table for technologies */ 363 enum { 364 NFA_DM_DISC_LRT_NFC_A, 365 NFA_DM_DISC_LRT_NFC_B, 366 NFA_DM_DISC_LRT_NFC_F, 367 NFA_DM_DISC_LRT_NFC_BP 368 }; 369 370 /* SLP_REQ (HLTA) command */ 371 #define SLP_REQ_CMD 0x5000 372 /* NFA_EE_MAX_TECH_ROUTE. only A, B, F, Bprime are supported by UICC now */ 373 #define NFA_DM_MAX_TECH_ROUTE 4 374 375 /* timeout for waiting deactivation NTF, 376 ** possible delay to send deactivate CMD if all credit wasn't returned 377 ** transport delay (1sec) and max RWT (5sec) 378 */ 379 #define NFA_DM_DISC_TIMEOUT_W4_DEACT_NTF (NFC_DEACTIVATE_TIMEOUT * 1000 + 6000) 380 381 typedef struct { 382 uint16_t disc_duration; /* Disc duration */ 383 tNFA_DM_DISC_FLAGS disc_flags; /* specific action flags */ 384 tNFA_DM_RF_DISC_STATE disc_state; /* RF discovery state */ 385 386 tNFC_RF_TECH_N_MODE activated_tech_mode; /* activated technology and mode */ 387 uint8_t activated_rf_disc_id; /* activated RF discovery ID */ 388 tNFA_INTF_TYPE activated_rf_interface; /* activated RF interface */ 389 tNFA_NFC_PROTOCOL activated_protocol; /* activated protocol */ 390 tNFA_HANDLE activated_handle; /* handle of activated sub-module */ 391 uint8_t activated_sel_res; /* activated tag's SEL_RES response */ 392 393 tNFA_DM_DISC_ENTRY entry[NFA_DM_DISC_NUM_ENTRIES]; 394 395 tNFA_DM_DISC_ENTRY excl_disc_entry; /* exclusive RF discovery */ 396 tNFA_LISTEN_CFG excl_listen_config; /* listen cfg for exclusive-rf mode */ 397 398 uint8_t listen_RT[NFA_DM_MAX_TECH_ROUTE]; /* Host ID for A, B, F, B' 399 technology routing*/ 400 tNFA_DM_DISC_TECH_PROTO_MASK 401 dm_disc_mask; /* technology and protocol waiting for activation */ 402 403 TIMER_LIST_ENT tle; /* timer for waiting deactivation NTF */ 404 TIMER_LIST_ENT kovio_tle; /* timer for Kovio bar code tag presence check */ 405 406 bool deact_pending; /* TRUE if deactivate while checking presence */ 407 bool deact_notify_pending; /* TRUE if notify DEACTIVATED EVT while Stop rf 408 discovery*/ 409 tNFA_DEACTIVATE_TYPE pending_deact_type; /* pending deactivate type */ 410 411 } tNFA_DM_DISC_CB; 412 413 /* NDEF Type Handler Definitions */ 414 /* Default handler entry in ndef_handler table */ 415 #define NFA_NDEF_DEFAULT_HANDLER_IDX 0 416 417 #define NFA_PARAM_ID_INVALID 0xFF 418 419 /* Maximum number of pending SetConfigs */ 420 #define NFA_DM_SETCONFIG_PENDING_MAX 32 421 422 /* NFA_DM flags */ 423 /* DM is enabled */ 424 #define NFA_DM_FLAGS_DM_IS_ACTIVE 0x00000001 425 /* Exclusive RF mode is active */ 426 #define NFA_DM_FLAGS_EXCL_RF_ACTIVE 0x00000002 427 /* Polling is enabled (while not in exclusive RF mode */ 428 #define NFA_DM_FLAGS_POLLING_ENABLED 0x00000004 429 /* send poll stop event */ 430 #define NFA_DM_FLAGS_SEND_POLL_STOP_EVT 0x00000008 431 /* auto reading of NDEF in progress */ 432 #define NFA_DM_FLAGS_AUTO_READING_NDEF 0x00000010 433 /* NFA_DM_ENABLE_EVT is not reported yet */ 434 #define NFA_DM_FLAGS_ENABLE_EVT_PEND 0x00000020 435 /* Send NFA_DEACTIVATED_EVT when deactivated */ 436 #define NFA_DM_FLAGS_SEND_DEACTIVATED_EVT 0x00000040 437 /* NFCC is restoring after back to full power mode */ 438 #define NFA_DM_FLAGS_NFCC_IS_RESTORING 0x00000100 439 /* NFCC power mode is updating */ 440 #define NFA_DM_FLAGS_SETTING_PWR_MODE 0x00000200 441 /* NFA DM is disabling NFC */ 442 #define NFA_DM_FLAGS_DM_DISABLING_NFC 0x00000400 443 /* NFA_SendRawFrame() is called since RF activation */ 444 #define NFA_DM_FLAGS_RAW_FRAME 0x00000800 445 /* NFA_DisableListening() is called and engaged */ 446 #define NFA_DM_FLAGS_LISTEN_DISABLED 0x00001000 447 /* NFA_PauseP2p() is called and engaged */ 448 #define NFA_DM_FLAGS_P2P_PAUSED 0x00002000 449 /* Power Off Sleep */ 450 #define NFA_DM_FLAGS_POWER_OFF_SLEEP 0x00008000 451 /* stored parameters */ 452 typedef struct { 453 uint8_t total_duration[NCI_PARAM_LEN_TOTAL_DURATION]; 454 455 uint8_t la_bit_frame_sdd[NCI_PARAM_LEN_LA_BIT_FRAME_SDD]; 456 uint8_t la_bit_frame_sdd_len; 457 uint8_t la_platform_config[NCI_PARAM_LEN_LA_PLATFORM_CONFIG]; 458 uint8_t la_platform_config_len; 459 uint8_t la_sel_info[NCI_PARAM_LEN_LA_SEL_INFO]; 460 uint8_t la_sel_info_len; 461 uint8_t la_nfcid1[NCI_NFCID1_MAX_LEN]; 462 uint8_t la_nfcid1_len; 463 uint8_t la_hist_by[NCI_MAX_HIS_BYTES_LEN]; 464 uint8_t la_hist_by_len; 465 466 uint8_t lb_sensb_info[NCI_PARAM_LEN_LB_SENSB_INFO]; 467 uint8_t lb_sensb_info_len; 468 uint8_t lb_nfcid0[NCI_PARAM_LEN_LB_NFCID0]; 469 uint8_t lb_nfcid0_len; 470 uint8_t lb_appdata[NCI_PARAM_LEN_LB_APPDATA]; 471 uint8_t lb_appdata_len; 472 uint8_t lb_adc_fo[NCI_PARAM_LEN_LB_ADC_FO]; 473 uint8_t lb_adc_fo_len; 474 uint8_t lb_h_info[NCI_MAX_ATTRIB_LEN]; 475 uint8_t lb_h_info_len; 476 477 uint8_t lf_protocol[NCI_PARAM_LEN_LF_PROTOCOL]; 478 uint8_t lf_protocol_len; 479 uint8_t lf_t3t_flags2[NCI_PARAM_LEN_LF_T3T_FLAGS2]; 480 uint8_t lf_t3t_flags2_len; 481 uint8_t lf_t3t_pmm[NCI_PARAM_LEN_LF_T3T_PMM]; 482 uint8_t lf_t3t_id[NFA_CE_LISTEN_INFO_MAX] 483 [NCI_PARAM_LEN_LF_T3T_ID(NCI_VERSION_2_0)]; 484 485 uint8_t fwi[NCI_PARAM_LEN_FWI]; 486 uint8_t wt[NCI_PARAM_LEN_WT]; 487 uint8_t atr_req_gen_bytes[NCI_MAX_GEN_BYTES_LEN]; 488 uint8_t atr_req_gen_bytes_len; 489 uint8_t atr_res_gen_bytes[NCI_MAX_GEN_BYTES_LEN]; 490 uint8_t atr_res_gen_bytes_len; 491 492 uint8_t pf_rc[NCI_PARAM_LEN_PF_RC]; 493 } tNFA_DM_PARAMS; 494 495 /* 496 ** NFA_NDEF CHO callback 497 ** It returns TRUE if NDEF is handled by connection handover module. 498 */ 499 typedef bool(tNFA_NDEF_CHO_CBACK)(uint32_t ndef_len, uint8_t* p_ndef_data); 500 501 /* DM control block */ 502 typedef struct { 503 uint32_t flags; /* NFA_DM flags (see definitions for NFA_DM_FLAGS_*) */ 504 tNFA_DM_CBACK* p_dm_cback; /* NFA DM callback */ 505 TIMER_LIST_ENT tle; 506 507 /* NFC link connection management */ 508 tNFA_CONN_CBACK* p_conn_cback; /* callback for connection events */ 509 tNFA_TECHNOLOGY_MASK poll_mask; /* technologies being polled */ 510 511 tNFA_CONN_CBACK* p_excl_conn_cback; /* exclusive RF mode callback */ 512 tNFA_NDEF_CBACK* p_excl_ndef_cback; /* ndef callback for exclusive RF mdoe */ 513 514 tNFA_NDEF_CHO_CBACK* 515 p_ndef_cho_cback; /* NDEF callback for static connection handover */ 516 517 tNFA_HANDLE poll_disc_handle; /* discovery handle for polling */ 518 519 uint8_t* p_activate_ntf; /* temp holding activation notfication */ 520 tHAL_API_GET_MAX_NFCEE* get_max_ee; 521 522 tNFC_RF_TECH_N_MODE 523 activated_tech_mode; /* previous activated technology and mode */ 524 uint8_t activated_nfcid[NFC_KOVIO_MAX_LEN]; /* NFCID 0/1/2 or UID of 525 ISO15694/Kovio */ 526 uint8_t activated_nfcid_len; /* length of NFCID or UID */ 527 528 /* NFC link discovery management */ 529 tNFA_DM_DISC_CB disc_cb; 530 531 /* NDEF Type handler */ 532 tNFA_DM_API_REG_NDEF_HDLR* 533 p_ndef_handler[NFA_NDEF_MAX_HANDLERS]; /* ndef handler table */ 534 535 /* stored parameters */ 536 tNFA_DM_PARAMS params; 537 538 /* SetConfig management */ 539 uint32_t setcfg_pending_mask; /* Mask of to indicate whether pending 540 SET_CONFIGs require NFA_DM_SET_CONFIG_EVT. 541 LSB=oldest pending */ 542 uint8_t setcfg_pending_num; /* Number of setconfigs pending */ 543 544 /* NFCC power mode */ 545 uint8_t nfcc_pwr_mode; /* NFA_DM_PWR_MODE_FULL or NFA_DM_PWR_MODE_OFF_SLEEP */ 546 547 uint8_t deactivate_cmd_retry_count; /*number of times the deactivation cmd 548 sent in case of error scenerio */ 549 550 uint8_t power_state; /* current screen/power state */ 551 uint32_t eDtaMode; /* To enable the DTA type modes. */ 552 } tNFA_DM_CB; 553 554 /* Internal function prototypes */ 555 void nfa_dm_ndef_handle_message(tNFA_STATUS status, uint8_t* p_msg_buf, 556 uint32_t len); 557 void nfa_dm_ndef_dereg_all(void); 558 void nfa_dm_act_conn_cback_notify(uint8_t event, tNFA_CONN_EVT_DATA* p_data); 559 void nfa_dm_notify_activation_status(tNFA_STATUS status, 560 tNFA_TAG_PARAMS* p_params); 561 562 bool nfa_dm_act_send_raw_vs(tNFA_DM_MSG* p_data); 563 564 void nfa_dm_disable_complete(void); 565 566 /* Internal functions from nfa_rw */ 567 void nfa_rw_init(void); 568 void nfa_rw_proc_disc_evt(tNFA_DM_RF_DISC_EVT event, tNFC_DISCOVER* p_data, 569 bool excl_rf_not_active); 570 tNFA_STATUS nfa_rw_send_raw_frame(NFC_HDR* p_data); 571 572 /* Internal functions from nfa_ce */ 573 void nfa_ce_init(void); 574 575 /* Pointer to compile-time configuration structure */ 576 extern tNFA_DM_DISC_FREQ_CFG* p_nfa_dm_rf_disc_freq_cfg; 577 extern tNFA_HCI_CFG* p_nfa_hci_cfg; 578 extern tNFA_DM_CFG* p_nfa_dm_cfg; 579 extern uint8_t* p_nfa_dm_ce_cfg; 580 extern uint8_t* p_nfa_dm_gen_cfg; 581 extern uint8_t nfa_ee_max_ee_cfg; 582 extern tNCI_DISCOVER_MAPS* p_nfa_dm_interface_mapping; 583 extern uint8_t nfa_dm_num_dm_interface_mapping; 584 extern bool nfa_poll_bail_out_mode; 585 586 void nfa_dm_poll_disc_cback_dta_wrapper(tNFA_DM_RF_DISC_EVT event, 587 tNFC_DISCOVER* p_data); 588 extern unsigned char appl_dta_mode_flag; 589 590 /* NFA device manager control block */ 591 extern tNFA_DM_CB nfa_dm_cb; 592 593 void nfa_dm_init(void); 594 void nfa_p2p_init(void); 595 #if (NFA_SNEP_INCLUDED == TRUE) 596 void nfa_snep_init(bool is_dta_mode); 597 #else 598 #define nfa_snep_init(is_dta_mode) 599 #endif 600 601 void nfa_dta_init(void); 602 #if (NFC_NFCEE_INCLUDED == TRUE) 603 void nfa_ee_init(void); 604 void nfa_hci_init(void); 605 #else 606 #define nfa_ee_init() 607 #define nfa_hci_init() 608 #endif 609 610 /* Action function prototypes */ 611 bool nfa_dm_enable(tNFA_DM_MSG* p_data); 612 bool nfa_dm_disable(tNFA_DM_MSG* p_data); 613 bool nfa_dm_set_config(tNFA_DM_MSG* p_data); 614 bool nfa_dm_get_config(tNFA_DM_MSG* p_data); 615 bool nfa_dm_act_request_excl_rf_ctrl(tNFA_DM_MSG* p_data); 616 bool nfa_dm_act_release_excl_rf_ctrl(tNFA_DM_MSG* p_data); 617 bool nfa_dm_act_enable_polling(tNFA_DM_MSG* p_data); 618 bool nfa_dm_act_disable_polling(tNFA_DM_MSG* p_data); 619 bool nfa_dm_act_enable_listening(tNFA_DM_MSG* p_data); 620 bool nfa_dm_act_disable_listening(tNFA_DM_MSG* p_data); 621 bool nfa_dm_act_pause_p2p(tNFA_DM_MSG* p_data); 622 bool nfa_dm_act_resume_p2p(tNFA_DM_MSG* p_data); 623 bool nfa_dm_act_send_raw_frame(tNFA_DM_MSG* p_data); 624 bool nfa_dm_set_p2p_listen_tech(tNFA_DM_MSG* p_data); 625 bool nfa_dm_act_start_rf_discovery(tNFA_DM_MSG* p_data); 626 bool nfa_dm_act_stop_rf_discovery(tNFA_DM_MSG* p_data); 627 bool nfa_dm_act_set_rf_disc_duration(tNFA_DM_MSG* p_data); 628 bool nfa_dm_act_select(tNFA_DM_MSG* p_data); 629 bool nfa_dm_act_update_rf_params(tNFA_DM_MSG* p_data); 630 bool nfa_dm_act_deactivate(tNFA_DM_MSG* p_data); 631 bool nfa_dm_act_power_off_sleep(tNFA_DM_MSG* p_data); 632 bool nfa_dm_ndef_reg_hdlr(tNFA_DM_MSG* p_data); 633 bool nfa_dm_ndef_dereg_hdlr(tNFA_DM_MSG* p_data); 634 bool nfa_dm_tout(tNFA_DM_MSG* p_data); 635 bool nfa_dm_act_reg_vsc(tNFA_DM_MSG* p_data); 636 bool nfa_dm_act_send_vsc(tNFA_DM_MSG* p_data); 637 uint16_t nfa_dm_act_get_rf_disc_duration(); 638 bool nfa_dm_act_disable_timeout(tNFA_DM_MSG* p_data); 639 bool nfa_dm_act_nfc_cback_data(tNFA_DM_MSG* p_data); 640 bool nfa_dm_set_power_sub_state(tNFA_DM_MSG* p_data); 641 642 void nfa_dm_proc_nfcc_power_mode(uint8_t nfcc_power_mode); 643 644 /* Main function prototypes */ 645 bool nfa_dm_evt_hdlr(NFC_HDR* p_msg); 646 void nfa_dm_sys_enable(void); 647 void nfa_dm_sys_disable(void); 648 tNFA_STATUS nfa_dm_check_set_config(uint8_t tlv_list_len, uint8_t* p_tlv_list, 649 bool app_init); 650 651 void nfa_dm_conn_cback_event_notify(uint8_t event, tNFA_CONN_EVT_DATA* p_data); 652 653 /* Discovery function prototypes */ 654 void nfa_dm_disc_sm_execute(tNFA_DM_RF_DISC_SM_EVENT event, 655 tNFA_DM_RF_DISC_DATA* p_data); 656 tNFA_HANDLE nfa_dm_add_rf_discover(tNFA_DM_DISC_TECH_PROTO_MASK disc_mask, 657 tNFA_DM_DISC_HOST_ID host_id, 658 tNFA_DISCOVER_CBACK* p_disc_cback); 659 void nfa_dm_delete_rf_discover(tNFA_HANDLE handle); 660 void nfa_dm_start_excl_discovery(tNFA_TECHNOLOGY_MASK poll_tech_mask, 661 tNFA_LISTEN_CFG* p_listen_cfg, 662 tNFA_DISCOVER_CBACK* p_disc_cback); 663 void nfa_dm_rel_excl_rf_control_and_notify(void); 664 void nfa_dm_stop_excl_discovery(void); 665 void nfa_dm_disc_new_state(tNFA_DM_RF_DISC_STATE new_state); 666 667 void nfa_dm_start_rf_discover(void); 668 void nfa_dm_rf_discover_select(uint8_t rf_disc_id, tNFA_NFC_PROTOCOL protocol, 669 tNFA_INTF_TYPE rf_interface); 670 tNFA_STATUS nfa_dm_rf_deactivate(tNFA_DEACTIVATE_TYPE deactivate_type); 671 bool nfa_dm_is_protocol_supported(tNFA_NFC_PROTOCOL protocol, uint8_t sel_res); 672 bool nfa_dm_is_active(void); 673 tNFC_STATUS nfa_dm_disc_sleep_wakeup(void); 674 tNFC_STATUS nfa_dm_disc_start_kovio_presence_check(void); 675 bool nfa_dm_is_raw_frame_session(void); 676 bool nfa_dm_is_p2p_paused(void); 677 678 #if (NFC_NFCEE_INCLUDED == FALSE) 679 #define nfa_ee_get_tech_route(ps, ha) \ 680 memset(ha, NFC_DH_ID, NFA_DM_MAX_TECH_ROUTE); 681 #endif 682 683 #if (BT_TRACE_VERBOSE == TRUE) 684 char* nfa_dm_nfc_revt_2_str(tNFC_RESPONSE_EVT event); 685 #endif 686 687 #endif /* NFA_DM_INT_H */ 688