/*
* Copyright (C) 2010 NXP Semiconductors
*
* 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.
*/
/*!
* =========================================================================== *
* *
* *
* \file phHciNfc_LinkMgmt.c *
* \brief HCI Link Management Gate Routines. *
* *
* *
* Project: NFC-FRI-1.1 *
* *
* $Date: Thu Feb 11 18:52:19 2010 $ *
* $Author: ing04880 $ *
* $Revision: 1.11 $ *
* $Aliases: NFC_FRI1.1_WK1007_R33_1,NFC_FRI1.1_WK1007_R33_4,NFC_FRI1.1_WK1017_PREP1,NFC_FRI1.1_WK1017_R34_1,NFC_FRI1.1_WK1017_R34_2,NFC_FRI1.1_WK1023_R35_1 $ *
* *
* =========================================================================== *
*/
/*
***************************** Header File Inclusion ****************************
*/
#include <phNfcCompId.h>
#include <phHciNfc_Pipe.h>
#include <phHciNfc_LinkMgmt.h>
#include <phOsalNfc.h>
/*
****************************** Macro Definitions *******************************
*/
#define REC_ERROR_INDEX 0x01U
#define REC_RETRY_LEN 0x02U
/*
*************************** Structure and Enumeration ***************************
*/
/** \defgroup grp_hci_nfc HCI Link Management Component
*
*
*/
typedef enum phHciNfc_LinkMgmt_Seq{
LINK_MGMT_PIPE_OPEN = 0x00U,
LINK_MGMT_GET_REC_ERROR,
LINK_MGMT_SET_REC_ERROR,
LINK_MGMT_PIPE_CLOSE
} phHciNfc_LinkMgmt_Seq_t;
typedef struct phHciNfc_LinkMgmt_Info{
phHciNfc_LinkMgmt_Seq_t link_cur_seq;
phHciNfc_LinkMgmt_Seq_t link_next_seq;
phHciNfc_Pipe_Info_t *p_pipe_info;
/* Rec Error Count Number from the Host Controller */
uint16_t hc_rec_error;
/* Rec Error Count Number of the Terminal Host */
uint16_t rec_error;
} phHciNfc_LinkMgmt_Info_t;
/*
*************************** Static Function Declaration **************************
*/
static
NFCSTATUS
phHciNfc_LinkMgmt_InfoUpdate(
phHciNfc_sContext_t *psHciContext,
phHal_sHwReference_t *pHwRef,
uint8_t index,
uint8_t *reg_value,
uint8_t reg_length
);
static
NFCSTATUS
phHciNfc_Recv_LinkMgmt_Response(
void *psHciContext,
void *pHwRef,
uint8_t *pResponse,
#ifdef ONE_BYTE_LEN
uint8_t length
#else
uint16_t length
#endif
);
/*
*************************** Function Definitions ***************************
*/
/*!
* \brief Initialisation of Link Managment Gate.
*
* This function initialses the Link Management gate and
* populates the Link Management Information Structure
*
*/
NFCSTATUS
phHciNfc_LinkMgmt_Initialise(
phHciNfc_sContext_t *psHciContext,
void *pHwRef
)
{
NFCSTATUS status = NFCSTATUS_SUCCESS;
phHciNfc_Pipe_Info_t *p_pipe_info = NULL;
phHciNfc_LinkMgmt_Info_t *p_link_mgmt_info=NULL;
uint8_t link_pipe_id = (uint8_t)HCI_UNKNOWN_PIPE_ID;
if( ( NULL == psHciContext )
|| (NULL == pHwRef )
)
{
status = PHNFCSTVAL(CID_NFC_HCI, NFCSTATUS_INVALID_PARAMETER);
}
else
{
if( ( NULL == psHciContext->p_link_mgmt_info )
&& (phHciNfc_Allocate_Resource((void **)(&p_link_mgmt_info),
sizeof(phHciNfc_LinkMgmt_Info_t))== NFCSTATUS_SUCCESS)
)
{
psHciContext->p_link_mgmt_info = p_link_mgmt_info;
p_link_mgmt_info->link_cur_seq = LINK_MGMT_PIPE_OPEN;
p_link_mgmt_info->link_next_seq = LINK_MGMT_PIPE_OPEN;
p_link_mgmt_info->p_pipe_info = NULL;
}
else
{
p_link_mgmt_info = (phHciNfc_LinkMgmt_Info_t *)
psHciContext->p_link_mgmt_info ;
}
if( NULL == p_link_mgmt_info )
{
status = PHNFCSTVAL(CID_NFC_HCI,
NFCSTATUS_INVALID_HCI_INFORMATION);
}
#ifdef ESTABLISH_SESSION
else if( hciMode_Session == psHciContext->hci_mode )
{
status = NFCSTATUS_SUCCESS;
}
#endif
else
{
switch(p_link_mgmt_info->link_cur_seq )
{
/* Link Mgmt pipe open sequence */
case LINK_MGMT_PIPE_OPEN:
{
if(phHciNfc_Allocate_Resource((void **)(&p_pipe_info),
sizeof(phHciNfc_Pipe_Info_t))!= NFCSTATUS_SUCCESS)
{
status = PHNFCSTVAL(CID_NFC_HCI,
NFCSTATUS_INSUFFICIENT_RESOURCES);
}
else
{
/* Populate the pipe information in the pipe handle */
((phHciNfc_Pipe_Info_t *)p_pipe_info)->pipe.pipe_id =
PIPETYPE_STATIC_LINK;
((phHciNfc_Pipe_Info_t *)p_pipe_info)->recv_resp =
&phHciNfc_Recv_LinkMgmt_Response;
psHciContext->p_pipe_list[PIPETYPE_STATIC_LINK] =
p_pipe_info ;
status = phHciNfc_Open_Pipe( psHciContext,
pHwRef,p_pipe_info );
if(status == NFCSTATUS_SUCCESS)
{
p_link_mgmt_info->p_pipe_info = p_pipe_info ;
p_link_mgmt_info->link_next_seq =
LINK_MGMT_GET_REC_ERROR;
status = NFCSTATUS_PENDING;
}
}
break;
}
case LINK_MGMT_GET_REC_ERROR:
{
p_pipe_info = p_link_mgmt_info->p_pipe_info;
if(NULL == p_pipe_info )
{
status = PHNFCSTVAL(CID_NFC_HCI,
NFCSTATUS_INVALID_HCI_SEQUENCE);
}
else
{
p_pipe_info->reg_index = REC_ERROR_INDEX;
link_pipe_id = PIPETYPE_STATIC_LINK ;
status =
phHciNfc_Send_Generic_Cmd( psHciContext, pHwRef,
link_pipe_id, (uint8_t)ANY_GET_PARAMETER );
if(NFCSTATUS_PENDING == status )
{
p_link_mgmt_info->link_next_seq =
LINK_MGMT_PIPE_CLOSE;
status = NFCSTATUS_SUCCESS;
}
}
break;
}
case LINK_MGMT_SET_REC_ERROR:
{
p_pipe_info = p_link_mgmt_info->p_pipe_info;
if(NULL == p_pipe_info )
{
status = PHNFCSTVAL(CID_NFC_HCI,
NFCSTATUS_INVALID_HCI_SEQUENCE);
}
else
{
p_pipe_info->reg_index = REC_ERROR_INDEX;
link_pipe_id = PIPETYPE_STATIC_LINK ;
status =
phHciNfc_Send_Generic_Cmd( psHciContext, pHwRef,
link_pipe_id, (uint8_t)ANY_GET_PARAMETER );
if(NFCSTATUS_PENDING == status )
{
p_link_mgmt_info->link_next_seq =
LINK_MGMT_PIPE_CLOSE;
status = NFCSTATUS_SUCCESS;
}
}
break;
}
default:
{
status = PHNFCSTVAL(CID_NFC_HCI, NFCSTATUS_INVALID_HCI_SEQUENCE);
break;
}
}/* End of the Sequence Switch */
}/* End of the Link Info Memory Check */
} /* End of Null Context Check */
return status;
}
/*!
* \brief Opens the Link Management Pipe of the Link Management Gate.
*
* This function Opens the Link Management Pipe of the Link Management
* Gate and Confirms that the HCI Link is behaving as expected.
*/
NFCSTATUS
phHciNfc_LinkMgmt_Open(
phHciNfc_sContext_t *psHciContext,
void *pHwRef
)
{
NFCSTATUS status = NFCSTATUS_SUCCESS;
if( (NULL == psHciContext) || (NULL == pHwRef) )
{
status = PHNFCSTVAL(CID_NFC_HCI, NFCSTATUS_INVALID_PARAMETER);
}
else
{
phHciNfc_LinkMgmt_Info_t *p_link_mgmt_info=
(phHciNfc_LinkMgmt_Info_t *)psHciContext->p_link_mgmt_info ;
if(( NULL != p_link_mgmt_info ) &&
( NULL != p_link_mgmt_info->p_pipe_info ))
{
status = phHciNfc_Open_Pipe( psHciContext,
pHwRef, p_link_mgmt_info->p_pipe_info );
if(status == NFCSTATUS_SUCCESS)
{
status = NFCSTATUS_PENDING;
}
}
else
{
status = PHNFCSTVAL(CID_NFC_HCI, NFCSTATUS_NOT_ALLOWED);
}/* End of the Identity Info Memory Check */
} /* End of Null Context Check */
return status;
}
NFCSTATUS
phHciNfc_LinkMgmt_Release(
phHciNfc_sContext_t *psHciContext,
void *pHwRef
)
{
NFCSTATUS status = NFCSTATUS_SUCCESS;
phHciNfc_LinkMgmt_Info_t *p_link_mgmt_info=NULL;
if( (NULL == psHciContext) || (NULL == pHwRef) )
{
status = PHNFCSTVAL(CID_NFC_HCI, NFCSTATUS_INVALID_PARAMETER);
}
else
{
if( NULL != psHciContext->p_link_mgmt_info )
{
p_link_mgmt_info = (phHciNfc_LinkMgmt_Info_t *)
psHciContext->p_link_mgmt_info ;
status = phHciNfc_Close_Pipe( psHciContext,
pHwRef, p_link_mgmt_info->p_pipe_info );
}
else
{
status = PHNFCSTVAL(CID_NFC_HCI, NFCSTATUS_NOT_ALLOWED);
}/* End of the Identity Info Memory Check */
} /* End of Null Context Check */
return status;
}
/*!
* \brief Receives the HCI Response from the corresponding peripheral device.
*
* This function receives the HCI Command Response from the connected NFC
* Pheripheral device.
*/
static
NFCSTATUS
phHciNfc_Recv_LinkMgmt_Response(
void *psContext,
void *pHwRef,
uint8_t *pResponse,
#ifdef ONE_BYTE_LEN
uint8_t length
#else
uint16_t length
#endif
)
{
phHciNfc_sContext_t *psHciContext =
(phHciNfc_sContext_t *)psContext ;
phHciNfc_LinkMgmt_Info_t *p_link_mgmt_info=NULL;
NFCSTATUS status = NFCSTATUS_SUCCESS;
uint8_t prev_cmd = ANY_GET_PARAMETER;
if( (NULL == psHciContext) || (NULL == pHwRef) )
{
status = PHNFCSTVAL(CID_NFC_HCI, NFCSTATUS_INVALID_PARAMETER);
}
else if( NULL == psHciContext->p_link_mgmt_info )
{
status = PHNFCSTVAL(CID_NFC_HCI, NFCSTATUS_FEATURE_NOT_SUPPORTED);
}
else
{
p_link_mgmt_info = (phHciNfc_LinkMgmt_Info_t *)
psHciContext->p_link_mgmt_info ;
prev_cmd = p_link_mgmt_info->p_pipe_info->prev_msg ;
switch(prev_cmd)
{
case ANY_GET_PARAMETER:
{
status = phHciNfc_LinkMgmt_InfoUpdate(psHciContext,
(phHal_sHwReference_t *)pHwRef,
p_link_mgmt_info->p_pipe_info->reg_index,
&pResponse[HCP_HEADER_LEN],
(uint8_t)(length - HCP_HEADER_LEN));
break;
}
case ANY_SET_PARAMETER:
{
status = PHNFCSTVAL(CID_NFC_HCI,
NFCSTATUS_FEATURE_NOT_SUPPORTED);
break;
}
case ANY_OPEN_PIPE:
{
break;
}
case ANY_CLOSE_PIPE:
{
phOsalNfc_FreeMemory(p_link_mgmt_info->p_pipe_info);
p_link_mgmt_info->p_pipe_info = NULL;
psHciContext->p_pipe_list[PIPETYPE_STATIC_LINK] = NULL;
break;
}
default:
{
status = PHNFCSTVAL(CID_NFC_HCI,
NFCSTATUS_INVALID_HCI_RESPONSE);
break;
}
}
if( NFCSTATUS_SUCCESS == status )
{
if( NULL != p_link_mgmt_info->p_pipe_info)
{
p_link_mgmt_info->p_pipe_info->prev_status = NFCSTATUS_SUCCESS;
}
p_link_mgmt_info->link_cur_seq = p_link_mgmt_info->link_next_seq;
}
}
return status;
}
static
NFCSTATUS
phHciNfc_LinkMgmt_InfoUpdate(
phHciNfc_sContext_t *psHciContext,
phHal_sHwReference_t *pHwRef,
uint8_t index,
uint8_t *reg_value,
uint8_t reg_length
)
{
phHciNfc_LinkMgmt_Info_t *p_link_mgmt_info=NULL;
NFCSTATUS status = NFCSTATUS_SUCCESS;
uint8_t i=0;
if( (NULL == psHciContext)
|| (NULL == pHwRef)
|| (NULL == reg_value)
|| (reg_length == 0)
)
{
status = PHNFCSTVAL(CID_NFC_HCI, NFCSTATUS_INVALID_PARAMETER);
}
else if ( NULL == psHciContext->p_link_mgmt_info )
{
status = PHNFCSTVAL(CID_NFC_HCI, NFCSTATUS_INVALID_HCI_INFORMATION);
}
else
{
p_link_mgmt_info = (phHciNfc_LinkMgmt_Info_t *)
psHciContext->p_link_mgmt_info ;
if (REC_ERROR_INDEX == index)
{
HCI_PRINT_BUFFER("\tHost Controller REC Error Count :",reg_value,reg_length);
/* p_link_mgmt_info->hc_rec_error = reg_value[i] ; */
for(i=0 ;(reg_length == REC_RETRY_LEN)&&(i < reg_length); i++)
{
p_link_mgmt_info->hc_rec_error |=
(uint16_t)(reg_value[i] << (BYTE_SIZE * i));
}
}
else
{
status = PHNFCSTVAL(CID_NFC_HCI, NFCSTATUS_INVALID_HCI_INFORMATION);
} /* End of the Index Check */
} /* End of Context and the Link information validity check */
return status;
}