blob: 18cc6a6aeda59206cd07a294be4d352ce7768b12 [file] [log] [blame]
/******************************************************************************
*
* Copyright (C) 2010-2014 Broadcom Corporation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
******************************************************************************/
/******************************************************************************
*
* This is the public interface file for NFA P2P, Broadcom's NFC
* application layer for mobile phones.
*
******************************************************************************/
#ifndef NFA_P2P_API_H
#define NFA_P2P_API_H
#include "llcp_api.h"
#include "nfa_api.h"
/*****************************************************************************
** Constants and data types
*****************************************************************************/
/* NFA P2P Reason of disconnection */
#define NFA_P2P_DISC_REASON_REMOTE_INITIATE \
0x00 /* remote initiated to disconnect */
#define NFA_P2P_DISC_REASON_LOCAL_INITITATE \
0x01 /* local initiated to disconnect */
#define NFA_P2P_DISC_REASON_NO_SERVICE \
0x02 /* no service bound in remote */
#define NFA_P2P_DISC_REASON_REMOTE_REJECT \
0x03 /* remote rejected connection */
#define NFA_P2P_DISC_REASON_FRAME_ERROR \
0x04 /* sending or receiving FRMR PDU */
#define NFA_P2P_DISC_REASON_LLCP_DEACTIVATED \
0x05 /* LLCP link deactivated */
#define NFA_P2P_DISC_REASON_NO_RESOURCE \
0x06 /* Out of resource in local device */
#define NFA_P2P_DISC_REASON_NO_INFORMATION \
0x80 /* Without information */
/* NFA P2P callback events */
/* Server is registered */
#define NFA_P2P_REG_SERVER_EVT 0x00
/* Client is registered */
#define NFA_P2P_REG_CLIENT_EVT 0x01
/* LLCP Link has been activated */
#define NFA_P2P_ACTIVATED_EVT 0x02
#define NFA_P2P_DEACTIVATED_EVT \
0x03 /* LLCP Link has been deactivated */
/* Data link connection request from peer */
#define NFA_P2P_CONN_REQ_EVT 0x04
/* Data link connection has been established */
#define NFA_P2P_CONNECTED_EVT 0x05
/* Data link connection has been disconnected */
#define NFA_P2P_DISC_EVT 0x06
/* Data received from peer */
#define NFA_P2P_DATA_EVT 0x07
/* Status indication of outgoing data */
#define NFA_P2P_CONGEST_EVT 0x08
/* link MIU and Well-Known Service list */
#define NFA_P2P_LINK_INFO_EVT 0x09
#define NFA_P2P_SDP_EVT 0x0A /* Remote SAP of SDP result */
typedef uint8_t tNFA_P2P_EVT;
/* NFA allocates a SAP for server */
#define NFA_P2P_ANY_SAP LLCP_INVALID_SAP
#define NFA_P2P_INVALID_SAP LLCP_INVALID_SAP
/* Recommanded MIU's for connection-oriented */
#define NFA_P2P_MIU_1 \
(NCI_NFC_DEP_MAX_DATA - LLCP_PDU_HEADER_SIZE - LLCP_SEQUENCE_SIZE)
#define NFA_P2P_MIU_2 \
(2 * NCI_NFC_DEP_MAX_DATA - LLCP_PDU_HEADER_SIZE - LLCP_SEQUENCE_SIZE)
#define NFA_P2P_MIU_3 \
(3 * NCI_NFC_DEP_MAX_DATA - LLCP_PDU_HEADER_SIZE - LLCP_SEQUENCE_SIZE)
#define NFA_P2P_MIU_8 \
(8 * NCI_NFC_DEP_MAX_DATA - LLCP_PDU_HEADER_SIZE - LLCP_SEQUENCE_SIZE)
#define NFA_P2P_LLINK_TYPE LLCP_LINK_TYPE_LOGICAL_DATA_LINK
#define NFA_P2P_DLINK_TYPE LLCP_LINK_TYPE_DATA_LINK_CONNECTION
typedef uint8_t tNFA_P2P_LINK_TYPE;
/* Data for NFA_P2P_REG_SERVER_EVT */
typedef struct {
tNFA_HANDLE server_handle; /* NFA_HANDLE_INVALID if failed */
char service_name[LLCP_MAX_SN_LEN + 1];
uint8_t server_sap;
} tNFA_P2P_REG_SERVER;
/* Data for NFA_P2P_REG_CLIENT_EVT */
typedef struct {
tNFA_HANDLE client_handle; /* NFA_HANDLE_INVALID if failed */
} tNFA_P2P_REG_CLIENT;
/* Data for NFA_P2P_ACTIVATED_EVT */
typedef struct {
tNFA_HANDLE handle;
uint16_t local_link_miu;
uint16_t remote_link_miu;
} tNFA_P2P_ACTIVATED;
/* Data for NFA_P2P_DEACTIVATED_EVT */
typedef struct { tNFA_HANDLE handle; } tNFA_P2P_DEACTIVATED;
/* Data for NFA_P2P_CONN_REQ_EVT */
typedef struct {
tNFA_HANDLE server_handle;
tNFA_HANDLE conn_handle;
uint8_t remote_sap;
uint16_t remote_miu;
uint8_t remote_rw;
} tNFA_P2P_CONN_REQ;
/* Data for NFA_P2P_CONNECTED_EVT */
typedef struct {
tNFA_HANDLE client_handle;
tNFA_HANDLE conn_handle;
uint8_t remote_sap;
uint16_t remote_miu;
uint8_t remote_rw;
} tNFA_P2P_CONN;
/* Data for NFA_P2P_DISC_EVT */
typedef struct {
tNFA_HANDLE handle;
uint8_t reason;
} tNFA_P2P_DISC;
/* Data for NFA_P2P_DATA_EVT */
typedef struct {
tNFA_HANDLE handle;
uint8_t remote_sap;
tNFA_P2P_LINK_TYPE link_type;
} tNFA_P2P_DATA;
/* Data for NFA_P2P_CONGEST_EVT */
typedef struct {
tNFA_HANDLE handle;
bool is_congested;
tNFA_P2P_LINK_TYPE link_type;
} tNFA_P2P_CONGEST;
/* Data for NFA_P2P_LINK_INFO_EVT */
typedef struct {
tNFA_HANDLE handle;
uint16_t wks; /* well-known service */
uint16_t local_link_miu;
uint16_t remote_link_miu;
} tNFA_P2P_LINK_INFO;
/* Data for NFA_P2P_SDP_EVT */
typedef struct {
tNFA_HANDLE handle;
uint8_t remote_sap; /* 0x00 if failed */
} tNFA_P2P_SDP;
/* Union of all P2P callback structures */
typedef union {
tNFA_P2P_REG_SERVER reg_server; /* NFA_P2P_REG_SERVER_EVT */
tNFA_P2P_REG_CLIENT reg_client; /* NFA_P2P_REG_CLIENT_EVT */
tNFA_P2P_ACTIVATED activated; /* NFA_P2P_ACTIVATED_EVT */
tNFA_P2P_DEACTIVATED deactivated; /* NFA_P2P_DEACTIVATED_EVT */
tNFA_P2P_CONN_REQ conn_req; /* NFA_P2P_CONN_REQ_EVT */
tNFA_P2P_CONN connected; /* NFA_P2P_CONNECTED_EVT */
tNFA_P2P_DISC disc; /* NFA_P2P_DISC_EVT */
tNFA_P2P_DATA data; /* NFA_P2P_DATA_EVT */
tNFA_P2P_CONGEST congest; /* NFA_P2P_CONGEST_EVT */
tNFA_P2P_LINK_INFO link_info; /* NFA_P2P_LINK_INFO_EVT */
tNFA_P2P_SDP sdp; /* NFA_P2P_SDP_EVT */
} tNFA_P2P_EVT_DATA;
/* NFA P2P callback */
typedef void(tNFA_P2P_CBACK)(tNFA_P2P_EVT event, tNFA_P2P_EVT_DATA* p_data);
/*****************************************************************************
** External Function Declarations
*****************************************************************************/
/*******************************************************************************
**
** Function NFA_P2pRegisterServer
**
** Description This function is called to listen to a SAP as server on
** LLCP.
**
** NFA_P2P_REG_SERVER_EVT will be returned with status and
** handle.
**
** If server_sap is set to NFA_P2P_ANY_SAP, then NFA will
** allocate a SAP between LLCP_LOWER_BOUND_SDP_SAP and
** LLCP_UPPER_BOUND_SDP_SAP Otherwise, server_sap must be
** between (LLCP_SDP_SAP + 1) and LLCP_UPPER_BOUND_SDP_SAP
**
** link_type : NFA_P2P_LLINK_TYPE and/or NFA_P2P_DLINK_TYPE
**
** Note: If RF discovery is started,
** NFA_StopRfDiscovery()/NFA_RF_DISCOVERY_STOPPED_EVT should
** happen before calling this function
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pRegisterServer(uint8_t server_sap,
tNFA_P2P_LINK_TYPE link_type,
char* p_service_name,
tNFA_P2P_CBACK* p_cback);
/*******************************************************************************
**
** Function NFA_P2pRegisterClient
**
** Description This function is called to register a client service on
** LLCP.
**
** NFA_P2P_REG_CLIENT_EVT will be returned with status and
** handle.
**
** link_type : NFA_P2P_LLINK_TYPE and/or NFA_P2P_DLINK_TYPE
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pRegisterClient(tNFA_P2P_LINK_TYPE link_type,
tNFA_P2P_CBACK* p_cback);
/*******************************************************************************
**
** Function NFA_P2pDeregister
**
** Description This function is called to stop listening to a SAP as server
** or stop client service on LLCP.
**
** Note: If this function is called to de-register a server and RF
** discovery is started,
** NFA_StopRfDiscovery()/NFA_RF_DISCOVERY_STOPPED_EVT should
** happen before calling this function
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if handle is not valid
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pDeregister(tNFA_HANDLE handle);
/*******************************************************************************
**
** Function NFA_P2pAcceptConn
**
** Description This function is called to accept a request of data link
** connection to a listening SAP on LLCP after receiving
** NFA_P2P_CONN_REQ_EVT.
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if handle is not valid
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pAcceptConn(tNFA_HANDLE conn_handle, uint16_t miu,
uint8_t rw);
/*******************************************************************************
**
** Function NFA_P2pRejectConn
**
** Description This function is called to reject a request of data link
** connection to a listening SAP on LLCP after receiving
** NFA_P2P_CONN_REQ_EVT.
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if handle is not valid
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pRejectConn(tNFA_HANDLE conn_handle);
/*******************************************************************************
**
** Function NFA_P2pDisconnect
**
** Description This function is called to disconnect an existing or
** connecting data link connection.
**
** discard any pending data on data link connection if flush is
** set to TRUE
**
** NFA_P2P_DISC_EVT will be returned after data link connection
** is disconnected
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if handle is not valid
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pDisconnect(tNFA_HANDLE conn_handle, bool flush);
/*******************************************************************************
**
** Function NFA_P2pConnectByName
**
** Description This function is called to create a connection-oriented
** transport by a service name.
** NFA_P2P_CONNECTED_EVT if success
** NFA_P2P_DISC_EVT if failed
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if client is not registered
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pConnectByName(tNFA_HANDLE client_handle,
char* p_service_name, uint16_t miu,
uint8_t rw);
/*******************************************************************************
**
** Function NFA_P2pConnectBySap
**
** Description This function is called to create a connection-oriented
** transport by a SAP.
** NFA_P2P_CONNECTED_EVT if success
** NFA_P2P_DISC_EVT if failed
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if client is not registered
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pConnectBySap(tNFA_HANDLE client_handle, uint8_t dsap,
uint16_t miu, uint8_t rw);
/*******************************************************************************
**
** Function NFA_P2pSendUI
**
** Description This function is called to send data on connectionless
** transport.
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if handle is not valid
** NFA_STATUS_BAD_LENGTH if data length is more than remote
** link MIU
** NFA_STATUS_CONGESTED if congested
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pSendUI(tNFA_HANDLE handle, uint8_t dsap,
uint16_t length, uint8_t* p_data);
/*******************************************************************************
**
** Function NFA_P2pReadUI
**
** Description This function is called to read data on connectionless
** transport when receiving NFA_P2P_DATA_EVT with
** NFA_P2P_LLINK_TYPE.
**
** - Remote SAP who sent UI PDU is returned.
** - Information of UI PDU up to max_data_len is copied into
** p_data.
** - If more information of UI PDU or more UI PDU in queue then
** more is returned to TRUE.
** - Information of next UI PDU is not concatenated.
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if handle is not valid
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pReadUI(tNFA_HANDLE handle, uint32_t max_data_len,
uint8_t* p_remote_sap, uint32_t* p_data_len,
uint8_t* p_data, bool* p_more);
/*******************************************************************************
**
** Function NFA_P2pFlushUI
**
** Description This function is called to flush data on connectionless
** transport.
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if handle is not valid
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pFlushUI(tNFA_HANDLE handle, uint32_t* p_length);
/*******************************************************************************
**
** Function NFA_P2pSendData
**
** Description This function is called to send data on connection-oriented
** transport.
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if handle is not valid
** NFA_STATUS_BAD_LENGTH if data length is more than remote MIU
** NFA_STATUS_CONGESTED if congested
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pSendData(tNFA_HANDLE conn_handle, uint16_t length,
uint8_t* p_data);
/*******************************************************************************
**
** Function NFA_P2pReadData
**
** Description This function is called to read data on connection-oriented
** transport when receiving NFA_P2P_DATA_EVT with
** NFA_P2P_DLINK_TYPE.
**
** - Information of I PDU is copied into p_data up to
** max_data_len.
** - If more information of I PDU or more I PDU in queue, then
** more is returned to TRUE.
** - Information of next I PDU is not concatenated.
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if handle is not valid
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pReadData(tNFA_HANDLE handle, uint32_t max_data_len,
uint32_t* p_data_len, uint8_t* p_data,
bool* p_more);
/*******************************************************************************
**
** Function NFA_P2pFlushData
**
** Description This function is called to flush data on connection-oriented
** transport.
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if handle is not valid
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pFlushData(tNFA_HANDLE handle, uint32_t* p_length);
/*******************************************************************************
**
** Function NFA_P2pSetLocalBusy
**
** Description This function is called to stop or resume incoming data on
** connection-oriented transport.
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if handle is not valid
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pSetLocalBusy(tNFA_HANDLE conn_handle, bool is_busy);
/*******************************************************************************
**
** Function NFA_P2pGetLinkInfo
**
** Description This function is called to get local/remote link MIU and
** Well-Known Service list encoded as a 16-bit field of
** connected LLCP. NFA_P2P_LINK_INFO_EVT will be returned.
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if server or client is not registered
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pGetLinkInfo(tNFA_HANDLE handle);
/*******************************************************************************
**
** Function NFA_P2pGetRemoteSap
**
** Description This function is called to get SAP associated by service
** name on connected remote LLCP.
** NFA_P2P_SDP_EVT will be returned.
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_BAD_HANDLE if server or client is not registered
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pGetRemoteSap(tNFA_HANDLE handle,
char* p_service_name);
/*******************************************************************************
**
** Function NFA_P2pSetLLCPConfig
**
** Description This function is called to change LLCP config parameters.
** Application must call while LLCP is not activated.
**
** Parameters descriptions (default value)
** - Local Link MIU (LLCP_MIU)
** - Option parameter (LLCP_OPT_VALUE)
** - Response Waiting Time Index (LLCP_WAITING_TIME)
** - Local Link Timeout (LLCP_LTO_VALUE)
** - Inactivity Timeout as initiator role
** (LLCP_INIT_INACTIVITY_TIMEOUT)
** - Inactivity Timeout as target role
** (LLCP_TARGET_INACTIVITY_TIMEOUT)
** - Delay SYMM response (LLCP_DELAY_RESP_TIME)
** - Data link connection timeout
** (LLCP_DATA_LINK_CONNECTION_TOUT)
** - Delay timeout to send first PDU as initiator
** (LLCP_DELAY_TIME_TO_SEND_FIRST_PDU)
**
** Returns NFA_STATUS_OK if successfully initiated
** NFA_STATUS_FAILED otherwise
**
*******************************************************************************/
extern tNFA_STATUS NFA_P2pSetLLCPConfig(uint16_t link_miu, uint8_t opt,
uint8_t wt, uint16_t link_timeout,
uint16_t inact_timeout_init,
uint16_t inact_timeout_target,
uint16_t symm_delay,
uint16_t data_link_timeout,
uint16_t delay_first_pdu_timeout);
/*******************************************************************************
**
** Function NFA_P2pGetLLCPConfig
**
** Description This function is called to read LLCP config parameters.
**
** Parameters descriptions
** - Local Link MIU
** - Option parameter
** - Response Waiting Time Index
** - Local Link Timeout
** - Inactivity Timeout as initiator role
** - Inactivity Timeout as target role
** - Delay SYMM response
** - Data link connection timeout
** - Delay timeout to send first PDU as initiator
**
** Returns None
**
*******************************************************************************/
extern void NFA_P2pGetLLCPConfig(uint16_t* p_link_miu, uint8_t* p_opt,
uint8_t* p_wt, uint16_t* p_link_timeout,
uint16_t* p_inact_timeout_init,
uint16_t* p_inact_timeout_target,
uint16_t* p_symm_delay,
uint16_t* p_data_link_timeout,
uint16_t* p_delay_first_pdu_timeout);
/*******************************************************************************
**
** Function NFA_P2pSetTraceLevel
**
** Description This function sets the trace level for P2P. If called with
** a value of 0xFF, it simply returns the current trace level.
**
** Returns The new or current trace level
**
*******************************************************************************/
extern uint8_t NFA_P2pSetTraceLevel(uint8_t new_level);
#endif /* NFA_P2P_API_H */