GitHub/nrf51_2in13_epd
1
0
Fork 0
mirror of https://gitee.com/muyuchl/nrf51_2in13_epd.git synced 2025-12-14 17:58:13 +08:00
Code Issues Packages Projects Releases Wiki Activity

copy project from century 2in6 esl project

Browse Source
This commit is contained in:
muyuchl
2025-04-26 13:14:26 +08:00
commit 2c9b333b97
1507 changed files with 460409 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

733
COMPONENTS/nfc/t2t_lib/hal_t2t/hal_nfc_t2t.c Normal file
View File

@@ -0,0 +1,733 @@
/**
* Copyright (c) 2015 - 2017, Nordic Semiconductor ASA
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form, except as embedded into a Nordic
* Semiconductor ASA integrated circuit in a product or a software update for
* such product, must reproduce the above copyright notice, this list of
* conditions and the following disclaimer in the documentation and/or other
* materials provided with the distribution.
*
* 3. Neither the name of Nordic Semiconductor ASA nor the names of its
* contributors may be used to endorse or promote products derived from this
* software without specific prior written permission.
*
* 4. This software, with or without modification, must only be used with a
* Nordic Semiconductor ASA integrated circuit.
*
* 5. Any software provided in binary form under this license must not be reverse
* engineered, decompiled, modified and/or disassembled.
*
* THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
* OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
* GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
*/
#include "sdk_config.h"
#if NFC_HAL_ENABLED
#include "hal_nfc_t2t.h"
#include <stdint.h>
#include <stdbool.h>
#include "nfc_t2t_lib.h"
#include "nfc_fixes.h"
#include "nrf.h"
#include "app_util_platform.h"
#include "nordic_common.h"
#include "nrf_drv_clock.h"
#define NRF_LOG_MODULE_NAME "HAL_NFC"
#if HAL_NFC_CONFIG_LOG_ENABLED
#define NRF_LOG_LEVEL HAL_NFC_CONFIG_LOG_LEVEL
#define NRF_LOG_INFO_COLOR HAL_NFC_CONFIG_INFO_COLOR
#define NRF_LOG_DEBUG_COLOR HAL_NFC_CONFIG_DEBUG_COLOR
#else // HAL_NFC_CONFIG_LOG_ENABLED
#define NRF_LOG_LEVEL 0
#endif // HAL_NFC_CONFIG_LOG_ENABLED
#include "nrf_log.h"
#if HAL_NFC_CONFIG_DEBUG_PIN_ENABLED
#include "nrf_gpio.h"
#define HAL_NFC_DEBUG_PIN_CONFIG(pin_num) nrf_gpio_cfg_output(pin_num)
#define HAL_NFC_DEBUG_PIN_CLEAR(pin_num) nrf_gpio_pin_clear(pin_num)
#define HAL_NFC_DEBUG_PIN_SET(pin_num) nrf_gpio_pin_set(pin_num)
#define HAL_NFC_DEBUG_PINS_INITIALIZE() \
do{ \
HAL_NFC_DEBUG_PIN_CONFIG(HAL_NFC_HCLOCK_OFF_DEBUG_PIN); \
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_HCLOCK_OFF_DEBUG_PIN); \
HAL_NFC_DEBUG_PIN_CONFIG(HAL_NFC_HCLOCK_ON_DEBUG_PIN); \
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_HCLOCK_ON_DEBUG_PIN); \
HAL_NFC_DEBUG_PIN_CONFIG(HAL_NFC_NFC_EVENT_DEBUG_PIN); \
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_NFC_EVENT_DEBUG_PIN); \
HAL_NFC_DEBUG_PIN_CONFIG(HAL_NFC_DETECT_EVENT_DEBUG_PIN); \
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_DETECT_EVENT_DEBUG_PIN); \
HAL_NFC_DEBUG_PIN_CONFIG(HAL_NFC_TIMER4_EVENT_DEBUG_PIN); \
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_TIMER4_EVENT_DEBUG_PIN); \
} while(0)
#else
#define HAL_NFC_DEBUG_PIN_CLEAR(pin_num)
#define HAL_NFC_DEBUG_PIN_SET(pin_num)
#define HAL_NFC_DEBUG_PINS_INITIALIZE()
#endif // HAL_NFC_CONFIG_DEBUG_PIN_ENABLED
/* NFC library version history:
* #define NFC_LIB_VERSION 0x00 first experimental version intended for nRF52 IC rev. Engineering A (PCA10036, part of nRF52 Preview Development Kit)
* #define NFC_LIB_VERSION 0x01 experimental version intended for nRF52 IC rev. Engineering B (PCA10040, part of nRF52 Development Kit)
* #define NFC_LIB_VERSION 0x02 experimental version intended for fix IC-12826 and fix: not released HFCLK in SENSE mode
* #define NFC_LIB_VERSION 0x03 experimental version intended for support logging module
* #define NFC_LIB_VERSION 0x04 experimental version intended for nRF52840 IC rev. Engineering A (PCA10056, part of nRF52840 Preview Development Kit). Removed PCA10036 support.
*/
#define NFC_LIB_VERSION 0x03u /**< Internal: current NFC lib. version */
#define T2T_INTERNAL_BYTES_NR 10u /**< Number of internal bytes defined by Type 2 Tag Operation Technical Specification */
#define T2T_INTERNAL_BYTE_SN0_SHIFT 0u /**< Internal Byte SN0, NRF_FICR->NFC.TAGHEADER0.MFGID which is Manufacturer ID */
#define T2T_INTERNAL_BYTE_SN1_SHIFT 8u /**< Internal Byte SN1, NRF_FICR->NFC.TAGHEADER0.UID0 */
#define T2T_INTERNAL_BYTE_SN2_SHIFT 16u /**< Internal Byte SN2, NRF_FICR->NFC.TAGHEADER0.UID1 */
#define T2T_INTERNAL_BYTE_SN3_SHIFT 0u /**< Internal Byte SN3, NRF_FICR->NFC.TAGHEADER1.UID3 */
#define T2T_INTERNAL_BYTE_SN4_SHIFT 8u /**< Internal Byte SN4, NRF_FICR->NFC.TAGHEADER1.UID4 */
#define T2T_INTERNAL_BYTE_SN5_SHIFT 16u /**< Internal Byte SN5, NRF_FICR->NFC.TAGHEADER1.UID5 */
#define T2T_INTERNAL_BYTE_SN6_SHIFT 24u /**< Internal Byte SN6, NRF_FICR->NFC.TAGHEADER1.UID6 */
#define CASCADE_TAG_BYTE 0x88u /**< Constant defined by ISO/EIC 14443-3 */
#define NFCID1_2ND_LAST_BYTE2_SHIFT 16u /**< Shift value for NFC ID byte 2 */
#define NFCID1_2ND_LAST_BYTE1_SHIFT 8u /**< Shift value for NFC ID byte 1 */
#define NFCID1_2ND_LAST_BYTE0_SHIFT 0u /**< Shift value for NFC ID byte 0 */
#define NFCID1_LAST_BYTE3_SHIFT 24u /**< Shift value for NFC ID byte 3 */
#define NFCID1_LAST_BYTE2_SHIFT 16u /**< Shift value for NFC ID byte 2 */
#define NFCID1_LAST_BYTE1_SHIFT 8u /**< Shift value for NFC ID byte 1 */
#define NFCID1_LAST_BYTE0_SHIFT 0u /**< Shift value for NFC ID byte 0 */
#define NFC_RX_BUFFER_SIZE 16u /**< NFC Rx data buffer size */
#define T2T_READ_CMD 0x30u /**< Type 2 Tag Read command identifier */
#define NFC_SLP_REQ_CMD 0x50u /**< NFC SLP_REQ command identifier */
#define NFC_CRC_SIZE 2u /**< CRC size in bytes */
#ifdef HAL_NFC_NRF52840_ENGINEERING_A_WORKAROUND
#define NRF_NFCT_ERRORSTATUS_ALL (NFCT_ERRORSTATUS_FRAMEDELAYTIMEOUT_Msk) /**< Mask for clearing all error flags in NFCT_ERRORSTATUS register */
#else
#define NRF_NFCT_ERRORSTATUS_ALL (NFCT_ERRORSTATUS_NFCFIELDTOOWEAK_Msk | \
NFCT_ERRORSTATUS_NFCFIELDTOOSTRONG_Msk | \
NFCT_ERRORSTATUS_FRAMEDELAYTIMEOUT_Msk) /**< Mask for clearing all error flags in NFCT_ERRORSTATUS register */
#endif // HAL_NFC_NRF52840_ENGINEERING_A_WORKAROUND
#define NRF_NFCT_FRAMESTATUS_RX_MSK (NFCT_FRAMESTATUS_RX_OVERRUN_Msk | \
NFCT_FRAMESTATUS_RX_PARITYSTATUS_Msk | \
NFCT_FRAMESTATUS_RX_CRCERROR_Msk) /**< Mask for clearing all flags in NFCT_FRAMESTATUS_RX register */
#define NFC_FIELD_ON_MASK NFCT_FIELDPRESENT_LOCKDETECT_Msk /**< Mask for checking FIELDPRESENT register for state: FIELD ON. */
#define NFC_FIELD_OFF_MASK NFCT_FIELDPRESENT_FIELDPRESENT_Msk /**< Mask for checking FIELDPRESENT register for state: FIELD OFF. */
typedef enum
{
NFC_FIELD_STATE_NONE, /**< Initial value indicating no NFCT Field events. */
NFC_FIELD_STATE_OFF, /**< NFCT FIELDLOST Event has been set. */
NFC_FIELD_STATE_ON, /**< NFCT FIELDDETECTED Event has been set. */
NFC_FIELD_STATE_UNKNOWN /**< Both NFCT Field Events have been set - ambiguous state. */
}nfct_field_sense_state_t;
/* Static function declarations */
static inline void nrf_nfct_event_clear(volatile uint32_t * p_event);
static inline void nrf_nfct_clock_event_handler(nrf_drv_clock_evt_type_t event);
static inline void nrf_nfct_field_event_handler(volatile nfct_field_sense_state_t field_state);
/* Static data */
static hal_nfc_callback_t m_nfc_lib_callback = (hal_nfc_callback_t) NULL; /**< Callback to nfc_lib layer */
static void * m_nfc_lib_context; /**< Callback execution context */
static volatile uint8_t m_nfc_rx_buffer[NFC_RX_BUFFER_SIZE] = {0}; /**< Buffer for NFC Rx data */
static volatile bool m_slp_req_received = false; /**< Flag indicating that SLP_REQ Command was received */
static volatile bool m_field_on = false; /**< Flag indicating that NFC Tag field is present */
static nrf_drv_clock_handler_item_t m_clock_handler_item; /**< Clock event handler item structure */
#ifndef HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
static volatile uint32_t m_nfc_fieldpresent_mask = NFC_FIELD_OFF_MASK; /**< Mask used for NFC Field polling in NFCT_FIELDPRESENT register */
#endif // HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
#ifdef HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
#define NRF_NFCT_POWER (*(uint32_t volatile *)(0x40005FFC))
#define NFC_HAL_FIELDPRESENT_MASK (NFCT_FIELDPRESENT_LOCKDETECT_Msk | \
NFCT_FIELDPRESENT_FIELDPRESENT_Msk)
#define NFC_HAL_FIELDPRESENT_IS_LOST ((NFCT_FIELDPRESENT_FIELDPRESENT_NoField << \
NFCT_FIELDPRESENT_FIELDPRESENT_Pos) | \
(NFCT_FIELDPRESENT_LOCKDETECT_NotLocked << \
NFCT_FIELDPRESENT_LOCKDETECT_Pos))
#ifndef HAL_NFC_FIELD_TIMER_PERIOD
#define HAL_NFC_FIELD_TIMER_PERIOD 100 /* unit - us */
#endif
static inline void hal_nfc_re_setup(void);
static void hal_nfc_field_check(void);
static void field_timer_with_callback_config()
{
NRF_TIMER4->MODE = TIMER_MODE_MODE_Timer << TIMER_MODE_MODE_Pos;
NRF_TIMER4->BITMODE = TIMER_BITMODE_BITMODE_08Bit << TIMER_BITMODE_BITMODE_Pos;
NRF_TIMER4->PRESCALER = 4 << TIMER_PRESCALER_PRESCALER_Pos;
NRF_TIMER4->CC[0] = HAL_NFC_FIELD_TIMER_PERIOD << TIMER_CC_CC_Pos;
NRF_TIMER4->SHORTS = TIMER_SHORTS_COMPARE0_CLEAR_Enabled << TIMER_SHORTS_COMPARE0_CLEAR_Pos;
NRF_TIMER4->INTENSET = TIMER_INTENSET_COMPARE0_Set << TIMER_INTENSET_COMPARE0_Pos;
NVIC_ClearPendingIRQ(TIMER4_IRQn);
NVIC_SetPriority(TIMER4_IRQn, APP_IRQ_PRIORITY_LOW);
NVIC_EnableIRQ(TIMER4_IRQn);
}
void TIMER4_IRQHandler(void)
{
HAL_NFC_DEBUG_PIN_SET(HAL_NFC_TIMER4_EVENT_DEBUG_PIN);
hal_nfc_field_check();
NRF_TIMER4->EVENTS_COMPARE[0] = 0;
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_TIMER4_EVENT_DEBUG_PIN);
}
#endif // HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
/**
* @brief Common part of setup used for NFCT initialization and reinitialization.
*/
#ifdef HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
static void hal_nfc_common_hw_setup(uint8_t * const nfc_internal)
#else
static inline void hal_nfc_common_hw_setup(uint8_t * const nfc_internal)
#endif // HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
{
uint32_t nfc_tag_header0 = NRF_FICR->NFC.TAGHEADER0;
uint32_t nfc_tag_header1 = NRF_FICR->NFC.TAGHEADER1;
/* Begin: Bugfix for FTPAN-98 */
#ifdef HAL_NFC_NRF52840_ENGINEERING_A_WORKAROUND
*(volatile uint32_t *)0x4000568C = 0x00038148;
#endif
/* End: Bugfix for FTPAN-98 */
#ifdef HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
NRF_NFCT->INTENSET = (NFCT_INTENSET_FIELDDETECTED_Enabled << NFCT_INTENSET_FIELDDETECTED_Pos);
#else
NRF_NFCT->INTENSET = (NFCT_INTENSET_FIELDDETECTED_Enabled << NFCT_INTENSET_FIELDDETECTED_Pos) |
(NFCT_INTENSET_FIELDLOST_Enabled << NFCT_INTENSET_FIELDLOST_Pos);
#endif
NRF_NFCT->INTENSET = (NFCT_INTENSET_ERROR_Enabled << NFCT_INTENSET_ERROR_Pos) |
(NFCT_INTENSET_SELECTED_Enabled << NFCT_INTENSET_SELECTED_Pos);
/* According to ISO/IEC 14443-3 */
nfc_internal[0] = (uint8_t) (LSB_32(nfc_tag_header0 >> T2T_INTERNAL_BYTE_SN0_SHIFT)); //SN0
nfc_internal[1] = (uint8_t) (LSB_32(nfc_tag_header0 >> T2T_INTERNAL_BYTE_SN1_SHIFT)); //SN1
nfc_internal[2] = (uint8_t) (LSB_32(nfc_tag_header0 >> T2T_INTERNAL_BYTE_SN2_SHIFT)); //SN2
nfc_internal[3] = (uint8_t) ((CASCADE_TAG_BYTE) ^ nfc_internal[0] ^
nfc_internal[1] ^ nfc_internal[2]); //BCC0 = CASCADE_TAG_BYTE ^ SN0 ^ SN1 ^ SN2
nfc_internal[4] = (uint8_t) (LSB_32(nfc_tag_header1 >> T2T_INTERNAL_BYTE_SN3_SHIFT)); //SN3
nfc_internal[5] = (uint8_t) (LSB_32(nfc_tag_header1 >> T2T_INTERNAL_BYTE_SN4_SHIFT)); //SN4
nfc_internal[6] = (uint8_t) (LSB_32(nfc_tag_header1 >> T2T_INTERNAL_BYTE_SN5_SHIFT)); //SN5
nfc_internal[7] = (uint8_t) (LSB_32(nfc_tag_header1 >> T2T_INTERNAL_BYTE_SN6_SHIFT)); //SN6
nfc_internal[8] = (uint8_t) (nfc_internal[4] ^ nfc_internal[5] ^
nfc_internal[6] ^ nfc_internal[7]); //BCC1 = SN3 ^ SN4 ^ SN5 ^ SN6
nfc_internal[9] = (uint8_t) (NFC_LIB_VERSION); //For internal use
/* MSB of NFCID1_2ND_LAST register is not used - always 0 */
NRF_NFCT->NFCID1_2ND_LAST = ((uint32_t) nfc_internal[0] << NFCID1_2ND_LAST_BYTE2_SHIFT) |
((uint32_t) nfc_internal[1] << NFCID1_2ND_LAST_BYTE1_SHIFT) |
((uint32_t) nfc_internal[2] << NFCID1_2ND_LAST_BYTE0_SHIFT);
NRF_NFCT->NFCID1_LAST = ((uint32_t) nfc_internal[4] << NFCID1_LAST_BYTE3_SHIFT) |
((uint32_t) nfc_internal[5] << NFCID1_LAST_BYTE2_SHIFT) |
((uint32_t) nfc_internal[6] << NFCID1_LAST_BYTE1_SHIFT) |
((uint32_t) nfc_internal[7] << NFCID1_LAST_BYTE0_SHIFT);
/* Begin: Bugfix for FTPAN-25 (IC-9929) */
/* Workaround for wrong SENSRES values require using SDD00001, but here SDD00100 is used
because it's required to operate with Windows Phone */
NRF_NFCT->SENSRES =
(NFCT_SENSRES_NFCIDSIZE_NFCID1Double << NFCT_SENSRES_NFCIDSIZE_Pos) |
(NFCT_SENSRES_BITFRAMESDD_SDD00100 << NFCT_SENSRES_BITFRAMESDD_Pos);
/* End: Bugfix for FTPAN-25 (IC-9929)*/
}
ret_code_t hal_nfc_setup(hal_nfc_callback_t callback, void * p_context)
{
uint8_t nfc_internal[T2T_INTERNAL_BYTES_NR];
m_nfc_lib_callback = callback;
m_nfc_lib_context = p_context;
hal_nfc_common_hw_setup(nfc_internal);
(void) nfc_t2t_internal_set((uint8_t *) nfc_internal, sizeof(nfc_internal));
/* Initialize SDK Clock module for handling high precission clock requests */
m_clock_handler_item.event_handler = nrf_nfct_clock_event_handler;
m_clock_handler_item.p_next = NULL;
ret_code_t err_code = nrf_drv_clock_init();
#ifdef HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
field_timer_with_callback_config();
#endif // HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
NRF_LOG_INFO("Init\r\n");
HAL_NFC_DEBUG_PINS_INITIALIZE();
if ((err_code == NRF_SUCCESS) || (err_code == NRF_ERROR_MODULE_ALREADY_INITIALIZED))
{
return NRF_SUCCESS;
}
else
{
return NRF_ERROR_INTERNAL;
}
}
/**@brief Function for clearing an event flag in NRF_NFCT registers.
*
* @param[in] p_event Pointer to event register.
*
*/
static inline void nrf_nfct_event_clear(volatile uint32_t * p_event)
{
*p_event = 0;
/* Perform read to ensure clearing is effective */
volatile uint32_t dummy = *p_event;
(void)dummy;
}
/**@brief Function for handling events from Clock Module.
*
* @param[in] event Clock event.
*
*/
static inline void nrf_nfct_clock_event_handler(nrf_drv_clock_evt_type_t event)
{
switch(event)
{
case NRF_DRV_CLOCK_EVT_HFCLK_STARTED:
/* Activate NFCT only when HFXO is running */
HAL_NFC_DEBUG_PIN_SET(HAL_NFC_HCLOCK_ON_DEBUG_PIN); //DEBUG!
NRF_NFCT->TASKS_ACTIVATE = 1;
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_HCLOCK_ON_DEBUG_PIN); //DEBUG!
break;
default:
/* No implementation required */
break;
}
}
#ifdef HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
static inline void nrf_nfct_field_lost_hfclk_handle(void)
{
/* Begin: Bugfix for FTPAN-116 (IC-12886) NFCT won't release HFCLK */
// reset the NFC for release HFCLK
__DMB();
NRF_NFCT_POWER = 0;
__DMB();
NRF_NFCT_POWER = 1;
/* END: Bugfix for FTPAN-116 (IC-12886) NFCT won't release HFCLK */
}
#endif // HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
#ifndef HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
/**@brief Function for evaluating and handling NFC field events.
*
* @param[in] field_state Current field state.
*
*/
static inline void nrf_nfct_field_event_handler(volatile nfct_field_sense_state_t field_state)
{
if (field_state == NFC_FIELD_STATE_UNKNOWN)
{
/* Probe NFC field */
uint32_t field_present = NRF_NFCT->FIELDPRESENT;
if (field_present & m_nfc_fieldpresent_mask)
{
field_state = NFC_FIELD_STATE_ON;
}
else
{
field_state = NFC_FIELD_STATE_OFF;
}
}
/* Field event service */
switch(field_state)
{
case NFC_FIELD_STATE_ON:
if (!m_field_on)
{
HAL_NFC_DEBUG_PIN_SET(HAL_NFC_HCLOCK_ON_DEBUG_PIN); //DEBUG!
nrf_drv_clock_hfclk_request(&m_clock_handler_item);
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_HCLOCK_ON_DEBUG_PIN); //DEBUG!
}
m_field_on = true;
break;
case NFC_FIELD_STATE_OFF:
HAL_NFC_DEBUG_PIN_SET(HAL_NFC_HCLOCK_OFF_DEBUG_PIN); //DEBUG!
/* Begin: Bugfix for FTPAN-116 (IC-12886) NFCT won't release HFCLK */
#ifdef HAL_NFC_NRF52840_ENGINEERING_A_WORKAROUND
*(volatile uint32_t *)0x40005010 = 1;
#endif // HAL_NFC_NRF52840_ENGINEERING_A_WORKAROUND
/* END: Bugfix for FTPAN-116 (IC-12886) NFCT won't release HFCLK */
NRF_NFCT->TASKS_SENSE = 1;
nrf_drv_clock_hfclk_release();
m_field_on = false;
NRF_NFCT->INTENCLR =
(NFCT_INTENCLR_RXFRAMEEND_Clear << NFCT_INTENCLR_RXFRAMEEND_Pos) |
(NFCT_INTENCLR_RXERROR_Clear << NFCT_INTENCLR_RXERROR_Pos);
/* Change mask to FIELD_OFF state - trigger FIELD_ON even if HW has not locked to the field */
m_nfc_fieldpresent_mask = NFC_FIELD_OFF_MASK;
if ((m_nfc_lib_callback != NULL) )
{
m_nfc_lib_callback(m_nfc_lib_context, HAL_NFC_EVENT_FIELD_OFF, 0, 0);
}
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_HCLOCK_OFF_DEBUG_PIN); //DEBUG!
break;
default:
/* No implementation required */
break;
}
}
#endif // HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
/* This function is used by nfc_lib for unit testing only */
ret_code_t hal_nfc_parameter_set(hal_nfc_param_id_t id, void * p_data, size_t data_length)
{
(void)id;
(void)p_data;
(void)data_length;
return NRF_SUCCESS;
}
/* This function is used by nfc_lib for unit testing only */
ret_code_t hal_nfc_parameter_get(hal_nfc_param_id_t id, void * p_data, size_t * p_max_data_length)
{
(void)id;
(void)p_data;
(void)p_max_data_length;
return NRF_SUCCESS;
}
ret_code_t hal_nfc_start(void)
{
NRF_NFCT->ERRORSTATUS = NRF_NFCT_ERRORSTATUS_ALL;
NVIC_ClearPendingIRQ(NFCT_IRQn);
NVIC_SetPriority(NFCT_IRQn, APP_IRQ_PRIORITY_LOW);
NVIC_EnableIRQ(NFCT_IRQn);
NRF_NFCT->TASKS_SENSE = 1;
NRF_LOG_INFO("Start\r\n");
return NRF_SUCCESS;
}
ret_code_t hal_nfc_send(const uint8_t * p_data, size_t data_length)
{
if (data_length == 0)
{
return NRF_ERROR_DATA_SIZE;
}
/* Ignore previous TX END events, SW takes care only for data frames which tranmission is triggered in this function */
nrf_nfct_event_clear(&NRF_NFCT->EVENTS_TXFRAMEEND);
NRF_NFCT->PACKETPTR = (uint32_t) p_data;
NRF_NFCT->TXD.AMOUNT = (data_length << NFCT_TXD_AMOUNT_TXDATABYTES_Pos) &
NFCT_TXD_AMOUNT_TXDATABYTES_Msk;
NRF_NFCT->INTENSET = (NFCT_INTENSET_TXFRAMEEND_Enabled << NFCT_INTENSET_TXFRAMEEND_Pos);
NRF_NFCT->TASKS_STARTTX = 1;
NRF_LOG_INFO("Send\r\n");
return NRF_SUCCESS;
}
ret_code_t hal_nfc_stop(void)
{
NRF_NFCT->TASKS_DISABLE = 1;
NRF_LOG_INFO("Stop\r\n");
return NRF_SUCCESS;
}
ret_code_t hal_nfc_done(void)
{
m_nfc_lib_callback = (hal_nfc_callback_t) NULL;
return NRF_SUCCESS;
}
void NFCT_IRQHandler(void)
{
nfct_field_sense_state_t current_field = NFC_FIELD_STATE_NONE;
HAL_NFC_DEBUG_PIN_SET(HAL_NFC_NFC_EVENT_DEBUG_PIN); //DEBUG!
if (NRF_NFCT->EVENTS_FIELDDETECTED && (NRF_NFCT->INTEN & NFCT_INTEN_FIELDDETECTED_Msk))
{
nrf_nfct_event_clear(&NRF_NFCT->EVENTS_FIELDDETECTED);
HAL_NFC_DEBUG_PIN_SET(HAL_NFC_DETECT_EVENT_DEBUG_PIN); //DEBUG!
current_field = NFC_FIELD_STATE_ON;
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_DETECT_EVENT_DEBUG_PIN); //DEBUG!
NRF_LOG_DEBUG("Field detected\r\n");
}
#ifndef HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
if (NRF_NFCT->EVENTS_FIELDLOST && (NRF_NFCT->INTEN & NFCT_INTEN_FIELDLOST_Msk))
{
nrf_nfct_event_clear(&NRF_NFCT->EVENTS_FIELDLOST);
current_field =
(current_field == NFC_FIELD_STATE_NONE) ? NFC_FIELD_STATE_OFF : NFC_FIELD_STATE_UNKNOWN;
NRF_LOG_DEBUG("Field lost\r\n");
}
#endif // HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
/* Perform actions if any FIELD event is active */
if (current_field != NFC_FIELD_STATE_NONE)
{
nrf_nfct_field_event_handler(current_field);
}
if (NRF_NFCT->EVENTS_RXFRAMEEND && (NRF_NFCT->INTEN & NFCT_INTEN_RXFRAMEEND_Msk))
{
/* Take into account only number of whole bytes */
uint32_t rx_data_size = ((NRF_NFCT->RXD.AMOUNT & NFCT_RXD_AMOUNT_RXDATABYTES_Msk) >>
NFCT_RXD_AMOUNT_RXDATABYTES_Pos) - NFC_CRC_SIZE;
nrf_nfct_event_clear(&NRF_NFCT->EVENTS_RXFRAMEEND);
/* Look for Tag 2 Type READ Command */
if (m_nfc_rx_buffer[0] == T2T_READ_CMD)
{
if(m_nfc_lib_callback != NULL)
{
/* This callback should trigger transmission of READ Response */
m_nfc_lib_callback(m_nfc_lib_context,
HAL_NFC_EVENT_DATA_RECEIVED,
(void*)m_nfc_rx_buffer,
rx_data_size);
}
}
else
{
/* Indicate that SLP_REQ was received - this will cause FRAMEDELAYTIMEOUT error */
if(m_nfc_rx_buffer[0] == NFC_SLP_REQ_CMD)
{
m_slp_req_received = true;
}
/* Not a READ Command, so wait for next frame reception */
NRF_NFCT->TASKS_ENABLERXDATA = 1;
}
NRF_LOG_DEBUG("Rx fend\r\n");
}
if (NRF_NFCT->EVENTS_TXFRAMEEND && (NRF_NFCT->INTEN & NFCT_INTEN_TXFRAMEEND_Msk))
{
nrf_nfct_event_clear(&NRF_NFCT->EVENTS_TXFRAMEEND);
/* Disable TX END event to ignore frame transmission other than READ response */
NRF_NFCT->INTENCLR = (NFCT_INTENCLR_TXFRAMEEND_Clear << NFCT_INTENCLR_TXFRAMEEND_Pos);
/* Set up for reception */
NRF_NFCT->PACKETPTR = (uint32_t) m_nfc_rx_buffer;
NRF_NFCT->MAXLEN = NFC_RX_BUFFER_SIZE;
NRF_NFCT->TASKS_ENABLERXDATA = 1;
if (m_nfc_lib_callback != NULL)
{
m_nfc_lib_callback(m_nfc_lib_context, HAL_NFC_EVENT_DATA_TRANSMITTED, 0, 0);
}
NRF_LOG_DEBUG("Tx fend\r\n");
}
if (NRF_NFCT->EVENTS_SELECTED && (NRF_NFCT->INTEN & NFCT_INTEN_SELECTED_Msk))
{
nrf_nfct_event_clear(&NRF_NFCT->EVENTS_SELECTED);
/* Clear also RX END and RXERROR events because SW does not take care of commands which were received before selecting the tag */
nrf_nfct_event_clear(&NRF_NFCT->EVENTS_RXFRAMEEND);
nrf_nfct_event_clear(&NRF_NFCT->EVENTS_RXERROR);
/* Set up registers for EasyDMA and start receiving packets */
NRF_NFCT->PACKETPTR = (uint32_t) m_nfc_rx_buffer;
NRF_NFCT->MAXLEN = NFC_RX_BUFFER_SIZE;
NRF_NFCT->TASKS_ENABLERXDATA = 1;
NRF_NFCT->INTENSET = (NFCT_INTENSET_RXFRAMEEND_Enabled << NFCT_INTENSET_RXFRAMEEND_Pos) |
(NFCT_INTENSET_RXERROR_Enabled << NFCT_INTENSET_RXERROR_Pos);
/* At this point any previous error status can be ignored */
NRF_NFCT->FRAMESTATUS.RX = NRF_NFCT_FRAMESTATUS_RX_MSK;
NRF_NFCT->ERRORSTATUS = NRF_NFCT_ERRORSTATUS_ALL;
#ifndef HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
/* Change mask to FIELD_ON state - trigger FIELD_ON only if HW has locked to the field */
m_nfc_fieldpresent_mask = NFC_FIELD_ON_MASK;
#endif
if (m_nfc_lib_callback != NULL)
{
m_nfc_lib_callback(m_nfc_lib_context, HAL_NFC_EVENT_FIELD_ON, 0, 0);
}
NRF_LOG_DEBUG("Selected\r\n");
}
if (NRF_NFCT->EVENTS_RXERROR && (NRF_NFCT->INTEN & NFCT_INTEN_RXERROR_Msk))
{
uint32_t rx_status = NRF_NFCT->FRAMESTATUS.RX;
nrf_nfct_event_clear(&NRF_NFCT->EVENTS_RXERROR);
NRF_LOG_DEBUG("Rx error (0x%x)\r\n", (unsigned int) rx_status);
(void) rx_status;
/* Clear rx frame status */
NRF_NFCT->FRAMESTATUS.RX = NRF_NFCT_FRAMESTATUS_RX_MSK;
}
if (NRF_NFCT->EVENTS_ERROR && (NRF_NFCT->INTEN & NFCT_INTEN_ERROR_Msk))
{
uint32_t err_status = NRF_NFCT->ERRORSTATUS;
nrf_nfct_event_clear(&NRF_NFCT->EVENTS_ERROR);
/* Clear FRAMEDELAYTIMEOUT error (expected HW behaviour) when SLP_REQ command was received */
if ((err_status & NFCT_ERRORSTATUS_FRAMEDELAYTIMEOUT_Msk) && m_slp_req_received)
{
NRF_NFCT->ERRORSTATUS = NFCT_ERRORSTATUS_FRAMEDELAYTIMEOUT_Msk;
m_slp_req_received = false;
NRF_LOG_DEBUG("Error (SLP_REQ)\r\n");
}
/* Report any other error */
err_status &= ~NFCT_ERRORSTATUS_FRAMEDELAYTIMEOUT_Msk;
if (err_status)
{
NRF_LOG_DEBUG("Error (0x%x)\r\n", (unsigned int) err_status);
}
/* Clear error status */
NRF_NFCT->ERRORSTATUS = NRF_NFCT_ERRORSTATUS_ALL;
}
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_NFC_EVENT_DEBUG_PIN); //DEBUG!
}
#ifdef HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
#ifdef HAL_NFC_NRF52840_ENGINEERING_A_WORKAROUND
#error Wrong workaround combination
#endif
static uint32_t field_state_cnt = 0;
/**
* @brief Function for evaluating and handling NFC fieldlost event.
*/
static void hal_nfc_field_check(void)
{
uint32_t nfc_fieldpresen_masked;
nfc_fieldpresen_masked = NRF_NFCT->FIELDPRESENT & NFC_HAL_FIELDPRESENT_MASK;
if (nfc_fieldpresen_masked == NFC_HAL_FIELDPRESENT_IS_LOST)
{
++field_state_cnt;
if (field_state_cnt > 7)
{
HAL_NFC_DEBUG_PIN_SET(HAL_NFC_HCLOCK_OFF_DEBUG_PIN); //DEBUG!
NRF_TIMER4->TASKS_SHUTDOWN = 1;
nrf_drv_clock_hfclk_release();
nrf_nfct_field_lost_hfclk_handle();
if ((m_nfc_lib_callback != NULL))
{
m_nfc_lib_callback(m_nfc_lib_context, HAL_NFC_EVENT_FIELD_OFF, 0, 0);
}
m_field_on = false;
/* Begin: Bugfix for FTPAN-116 (IC-12886) NFCT won't release HFCLK */
// resume the NFCT to initialized state
hal_nfc_re_setup();
/* End: Bugfix for FTPAN-116 (IC-12886) NFCT won't release HFCLK */
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_HCLOCK_OFF_DEBUG_PIN); //DEBUG!
}
return;
}
field_state_cnt = 0;
}
/**
* @brief Function for enablinge hight precision clock and start eveluating fieldlost event.
*/
static inline void nrf_nfct_field_event_handler(volatile nfct_field_sense_state_t field_state)
{
if (!m_field_on)
{
HAL_NFC_DEBUG_PIN_SET(HAL_NFC_HCLOCK_ON_DEBUG_PIN); //DEBUG!
nrf_drv_clock_hfclk_request(&m_clock_handler_item);
NRF_TIMER4->TASKS_CLEAR = 1;
NRF_TIMER4->TASKS_START = 1;
field_state_cnt = 0;
HAL_NFC_DEBUG_PIN_CLEAR(HAL_NFC_HCLOCK_ON_DEBUG_PIN); //DEBUG!
}
m_field_on = true;
}
/**
* @brief Function for resume the NFCT to initialized state after software's reset.
*/
static inline void hal_nfc_re_setup(void)
{
uint8_t nfc_internal[T2T_INTERNAL_BYTES_NR];
hal_nfc_common_hw_setup(nfc_internal);
NRF_LOG_INFO("Reinitialize\r\n");
}
#endif // HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
#endif // NFC_HAL_ENABLED

190
COMPONENTS/nfc/t2t_lib/hal_t2t/hal_nfc_t2t.h Normal file
View File

@@ -0,0 +1,190 @@
/**
* Copyright (c) 2015 - 2017, Nordic Semiconductor ASA
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form, except as embedded into a Nordic
* Semiconductor ASA integrated circuit in a product or a software update for
* such product, must reproduce the above copyright notice, this list of
* conditions and the following disclaimer in the documentation and/or other
* materials provided with the distribution.
*
* 3. Neither the name of Nordic Semiconductor ASA nor the names of its
* contributors may be used to endorse or promote products derived from this
* software without specific prior written permission.
*
* 4. This software, with or without modification, must only be used with a
* Nordic Semiconductor ASA integrated circuit.
*
* 5. Any software provided in binary form under this license must not be reverse
* engineered, decompiled, modified and/or disassembled.
*
* THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
* OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
* GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
*/
#ifndef HAL_NFC_H__
#define HAL_NFC_H__
/** @file
* @defgroup nfc_t2t_hal NFC Type 2 Tag HAL
* @{
* @ingroup nfc_t2t
* @brief @tagAPI52 Hardware abstraction layer for the NFC Type 2 Tag library.
*
* @note Before the NFCT peripheral enters ACTIVATED state, the HFXO must be running.
* To fulfill this requirement and allow other software modules to also request the HFXO, the NFC Type 4 Tag HAL uses @ref nrf_drv_clock module.
*
*/
#include <stdint.h>
#include <string.h>
#include <sdk_errors.h>
/** @brief Events passed to the upper-layer callback function. */
typedef enum {
HAL_NFC_EVENT_FIELD_ON, ///< Field is detected.
HAL_NFC_EVENT_FIELD_OFF, ///< Field is lost.
HAL_NFC_EVENT_DATA_RECEIVED, ///< Data is received.
HAL_NFC_EVENT_DATA_TRANSMITTED ///< Data is Transmitted.
} hal_nfc_event_t;
/** @brief Parameter IDs for set/get function. */
typedef enum {
HAL_NFC_PARAM_ID_TESTING, ///< Used for unit tests.
HAL_NFC_PARAM_ID_UNKNOWN
} hal_nfc_param_id_t;
/** @brief Callback from HAL_NFC layer into the upper layer.
*
* If event == HAL_NFC_EVENT_DATA_RECEIVED:
* p_data points to the received packet. The memory belongs to the HAL_NFC layer and
* is guaranteed to be valid only until the callback returns.
*
* If event == HAL_NFC_EVENT_DATA_TRANSMITTED:
* p_data points to the transmitted packet. The memory belongs to the application.
*
* If event == \<Other event\>:
* p_data definition is event-specific (to be defined).
*
* @param[in] p_context Context for callback execution.
* @param[in] event The event that occurred.
* @param[in] p_data Received/transmitted data or NULL.
* @param[in] data_length Size of the received/transmitted packet.
*/
typedef void (* hal_nfc_callback_t)(void * p_context,
hal_nfc_event_t event,
const uint8_t * p_data,
size_t data_length);
/** @brief Function for initializing the NFC layer.
*
* This function provides a pointer to a callback function and the callback context
* to the NFC layer.
*
* @param[in] callback Pointer to the callback function.
* @param[in] p_context Context of callback.
*
* @retval NRF_SUCCESS If the NFC layer was initialized successfully. If one
* of the arguments was invalid, an error code is returned.
*/
ret_code_t hal_nfc_setup(hal_nfc_callback_t callback, void * p_context);
/** @brief Function for setting a HAL_NFC parameter.
*
* This function allows to set any parameter defined as available by HAL_NFC.
*
* @param[in] id ID of the parameter to set.
* @param[in] p_data Pointer to the buffer containing the data to set.
* @param[in] data_length Size of the buffer containing the data to set.
*
* @retval NRF_SUCCESS If the parameter was set successfully. If one of the arguments
* was invalid (for example, wrong data length), an error code
* is returned.
*/
ret_code_t hal_nfc_parameter_set(hal_nfc_param_id_t id, void * p_data, size_t data_length);
/** @brief Function for querying a HAL_NFC parameter value.
*
* The queried value will be placed into the passed data buffer. If the buffer
* is too small, maxDataLength will contain the required buffer size.
*
* @param[in] id ID of the parameter to query.
* @param[in] p_data Pointer to a buffer receiving the queried data.
* @param[in, out] p_max_data_length Size of the buffer. It receives the required size if buffer is too small.
*
* @retval NRF_SUCCESS If the parameter was received successfully. If one of the arguments
* was invalid (for example, the buffer was too small), an error code
* is returned.
*/
ret_code_t hal_nfc_parameter_get(hal_nfc_param_id_t id, void * p_data, size_t * p_max_data_length);
/** @brief Function for starting the NFC subsystem.
*
* After this function completes, NFC readers will be able to detect the chip.
*
* @retval NRF_SUCCESS If the NFC subsystem was started successfully. If the NFC
* subsystem could not be started, an error code is returned.
*/
ret_code_t hal_nfc_start(void);
/** @brief Function for sending a packet to the connected NFC reader.
*
* The provided data buffer belongs to the caller and is guaranteed to be
* valid until the HAL_NFC_EVENT_DATA_TRANSMITTED event is received by the
* callback.
*
* @param[in] p_data The data packet to send.
* @param[in] data_length Size of the packet in bytes.
*
* @retval NRF_SUCCESS If the packet was sent. Otherwise, an error code is returned.
*/
ret_code_t hal_nfc_send(const uint8_t * p_data, size_t data_length);
/** @brief Function for stopping the NFC subsystem.
*
* After this function returns, NFC readers will no longer be able to connect
* to the chip.
*
* @retval NRF_SUCCESS If the NFC subsystem was stopped. Otherwise, an error code
* is returned.
*/
ret_code_t hal_nfc_stop(void);
/** @brief Function for releasing resources.
*
* After this call returns, the callback is considered invalid and no more
* events will be posted to it.
*
* @retval NRF_SUCCESS This function always succeeds.
*/
ret_code_t hal_nfc_done(void);
/** @} */
#endif /* HAL_NFC_H__ */

36
COMPONENTS/nfc/t2t_lib/license.txt Normal file
View File

@@ -0,0 +1,36 @@
Copyright (c) 2015 - 2017, Telit Communications Cyprus Ltd
All rights reserved.
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form, except as embedded into a Nordic
Semiconductor ASA integrated circuit in a product or a software update for
such product, must reproduce the above copyright notice, this list of
conditions and the following disclaimer in the documentation and/or other
materials provided with the distribution.
3. Neither the name of Nordic Semiconductor ASA nor the names of its
contributors may be used to endorse or promote products derived from this
software without specific prior written permission.
4. This software, with or without modification, must only be used with a
Nordic Semiconductor ASA integrated circuit.
5. Any software provided in binary form under this license must not be reverse
engineered, decompiled, modified and/or disassembled.
THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

76
COMPONENTS/nfc/t2t_lib/nfc_fixes.h Normal file
View File

@@ -0,0 +1,76 @@
/**
* Copyright (c) 2015 - 2017, Nordic Semiconductor ASA
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form, except as embedded into a Nordic
* Semiconductor ASA integrated circuit in a product or a software update for
* such product, must reproduce the above copyright notice, this list of
* conditions and the following disclaimer in the documentation and/or other
* materials provided with the distribution.
*
* 3. Neither the name of Nordic Semiconductor ASA nor the names of its
* contributors may be used to endorse or promote products derived from this
* software without specific prior written permission.
*
* 4. This software, with or without modification, must only be used with a
* Nordic Semiconductor ASA integrated circuit.
*
* 5. Any software provided in binary form under this license must not be reverse
* engineered, decompiled, modified and/or disassembled.
*
* THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
* OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
* GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
*/
#ifndef NFC_FIXES_H__
#define NFC_FIXES_H__
#include <stdint.h>
/** @file
* @defgroup nfc_fixes NFC fixes and workarounds
* @{
* @ingroup nfc_t2t
* @brief @tagAPI52 Fixes for hardware-related anomalies.
*
* If you are using PCA10040 (part of nRF52 Development Kit),
* you must define the macro HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND in order to apply
* workarounds for the following anomalies:
* - 79. NFCT: A false EVENTS_FIELDDETECTED event occurs after the field is lost.
* - 116. NFCT does not release HFCLK when switching from ACTIVATED to SENSE mode.
*
* If you are using PCA10056 (part of nRF52840 Development Kit),
* you must define the macro HAL_NFC_NRF52840_ENGINEERING_A_WORKAROUND in order to apply
* workarounds for the following anomalies:
* - 98. NFCT: The NFCT is not able to communicate with the peer.
* - 116. NFCT does not release HFCLK when switching from ACTIVATED to SENSE mode.
*
* The current code contains a patch for anomaly 25 (NFCT: Reset value of
* SENSRES register is incorrect), so that it now works on Windows Phone.
*/
#ifdef BOARD_PCA10040 // assume nRF52832 chip in IC rev. Engineering B or Engineering C
#define HAL_NFC_ENGINEERING_BC_FTPAN_WORKAROUND
#elif defined(BOARD_PCA10056) // assume nRF52840 chip in IC rev. Engineering A
#define HAL_NFC_NRF52840_ENGINEERING_A_WORKAROUND
#endif
/** @} */
#endif /* NFC_FIXES_H__ */

259
COMPONENTS/nfc/t2t_lib/nfc_t2t_lib.h Normal file
View File

@@ -0,0 +1,259 @@
/**
* Copyright (c) 2015 - 2017, Telit Communications Cyprus Ltd
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form, except as embedded into a Nordic
* Semiconductor ASA integrated circuit in a product or a software update for
* such product, must reproduce the above copyright notice, this list of
* conditions and the following disclaimer in the documentation and/or other
* materials provided with the distribution.
*
* 3. Neither the name of Nordic Semiconductor ASA nor the names of its
* contributors may be used to endorse or promote products derived from this
* software without specific prior written permission.
*
* 4. This software, with or without modification, must only be used with a
* Nordic Semiconductor ASA integrated circuit.
*
* 5. Any software provided in binary form under this license must not be reverse
* engineered, decompiled, modified and/or disassembled.
*
* THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
* OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
* GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
*/
#ifndef NFC_T2T_LIB_H__
#define NFC_T2T_LIB_H__
/** @file
*
* @addtogroup nfc_api
*
* @defgroup nfc_t2t NFC Type 2 Tag
* @ingroup nfc_api
* @brief Implementation of NFC Type 2 Tag.
*
* @defgroup nfc_t2t_lib NFC tag 2 type emulation library
* @{
* @ingroup nfc_t2t
* @brief The T2T emulation library interface.
*/
#include <string.h>
#include <sdk_errors.h>
#define NFC_T2T_SIZEOF_INTERNAL_BYTES 10 ///< T2T internal byte size.
#define NFC_T2T_MAX_PAYLOAD_SIZE 988 ///< Maximum NDEF message size.
#define NFC_T2T_MAX_PAYLOAD_SIZE_RAW 1008 ///< No NDEF-TLV and no implicit lock bytes at the end.
/** @brief Events passed to the callback function. */
typedef enum
{
NFC_T2T_EVENT_NONE,
///< Not used.
NFC_T2T_EVENT_FIELD_ON,
///< NFC tag has detected external NFC field and was selected by an NFC polling device.
NFC_T2T_EVENT_FIELD_OFF,
///< External NFC field has been removed.
NFC_T2T_EVENT_DATA_READ,
///< NFC polling device has read all tag data.
/**<
* Repeated reading in the same session i.e. before @ref NFC_T2T_EVENT_FIELD_OFF event,
* will not trigger another @ref NFC_T2T_EVENT_DATA_READ event.
*/
NFC_T2T_EVENT_STOPPED
///< Reference to the application NFC callback has been released using @ref nfc_t2t_done.
} nfc_t2t_event_t;
typedef enum
{
NFC_T2T_PARAM_TESTING ///< Used for unit tests.
} nfc_t2t_param_id_t;
/** @brief Callback to pass events from NFC T2T Library to application.
*
* @param[in] p_context Application context for callback execution.
* @param[in] event The event that occurred.
* @param[in] p_data Data to send to the application (event specific).
* @param[in] data_length Length of the data.
*/
typedef void (*nfc_t2t_callback_t)(void * p_context,
nfc_t2t_event_t event,
const uint8_t * p_data,
size_t data_length);
/** @brief Function for registering the application callback for event signaling.
*
* The callback will be called by NFC T2T Library to notify the application of relevant
* events. It will be called from the HAL_NFC callback context.
*
* @param[in] callback Function pointer to the callback.
* @param[in] p_context Pointer to a memory area used by the callback for execution (optional).
*
* @retval NRF_SUCCESS If the application callback was registered successfully. If one
* of the arguments was invalid, an error code is returned.
*/
ret_code_t nfc_t2t_setup(nfc_t2t_callback_t callback, void * p_context);
/** @brief Function for setting an NFC parameter.
*
* @note Not implemented. For future use.
*
* This function allows to set any parameter defined as available by HAL_NFC.
*
* @param[in] id ID of the parameter to set.
* @param[in] p_data Pointer to a buffer containing the data to set.
* @param[in] data_length Size of the buffer containing the data to set.
*
* @retval NRF_SUCCESS If the parameter was set successfully. If one of the arguments
* was invalid (for example, a wrong data length), an error code
* is returned.
*/
ret_code_t nfc_t2t_parameter_set(nfc_t2t_param_id_t id, void * p_data, size_t data_length);
/** @brief Function for querying an NFC parameter value.
*
* @note Not implemented. For future use.
*
* The queried value will be placed into the passed data buffer. If the buffer
* is too small, p_max_data_length will contain the required buffer size. If the
* buffer is big enough, p_max_data_length will contain the actual size of the
* data.
*
* @param[in] id ID of the parameter to query.
* @param[in] p_data Pointer to a buffer receiving the queried data.
* @param[in, out] p_max_data_length Size of the buffer, receives actual size of queried data.
*
* @retval NRF_SUCCESS If the parameter was received successfully. If one of the arguments
* was invalid (for example, the buffer was too small), an error code
* is returned.
*/
ret_code_t nfc_t2t_parameter_get(nfc_t2t_param_id_t id, void * p_data, size_t * p_max_data_length);
/** @brief Function for registering the payload to send on reception of a READ request.
*
* The payload is considered to only contain the NDEF message to deliver to a
* reader. The required NDEF TLV will be created implicitly by NFC T2T Library.
*
* The pointer to the payload must stay valid for the duration of the library
* execution, or until it is explicitly released.
*
* If the pointer is not NULL, but the length is zero, the paypload is
* considered to be an empty NDEF message.
*
* If a new payload is registered, the previously registered one is considered
* released.
*
* Passing a NULL pointer releases the current payload without registering a
* new one.
*
* If an invalid size is given (too big), the function returns with an error
* and the currently registered payload is left unchanged.
*
* @param[in] p_payload Pointer to the memory area containing the payload to send.
* @param[in] payload_length Size of the payload in bytes.
*
* @retval NRF_SUCCESS If the operation was successful. If one
* of the arguments was invalid, an error code is returned.
*/
ret_code_t nfc_t2t_payload_set(const uint8_t * p_payload, size_t payload_length);
/** @brief Function for registering the raw payload to send on reception of a READ request.
*
* The payload will be delivered directly as-is to the reader, without
* implicitly adding an NDEF TLV container. This can be used if the
* application wants to define the TLVs itself, for example, to provide a different
* memory layout.
*
* The pointer to the payload must stay valid for the duration of the library
* execution, or until it is explicitly released.
*
* If a new payload is registered, the previously registered one is considered
* released.
*
* Passing a NULL pointer releases the current payload, without registering a
* new one.
*
* If an invalid size is given (too big), the function returns with an error
* and the currently registered payload is left unchanged.
*
* @param[in] p_payload Pointer to the memory area containing the payload to send.
* @param[in] payload_length Size of the payload in bytes.
*
* @retval NRF_SUCCESS If the operation was successful. If one
* of the arguments was invalid, an error code is returned.
*/
ret_code_t nfc_t2t_payload_raw_set(const uint8_t * p_payload, size_t payload_length);
/** @brief Function for registering the sequence of internal bytes.
*
* This refers to the first 10 bytes of the tag memory. The library will set
* a sensible default for these bytes. The application can use this function
* to override the default.
*
* Passing a NULL pointer reverts back to the default sequence.
* The data will be copied by NFC T2T Library, so the memory does not have to remain valid
* after the function returns.
*
* @note When modifying the internal bytes, remember that they must be consistent
* with the NFC hardware register settings (see @ref nfc_t2t_format_internal).
*
* @param[in] p_data Pointer to the memory area containing the data.
* @param[in] data_length Size of the data in bytes.
*
* @retval NRF_SUCCESS If the operation was successful. If the data was not NULL and the
* data length was not 10, an error code is returned.
*/
ret_code_t nfc_t2t_internal_set(const uint8_t * p_data, size_t data_length);
/** @brief Function for activating the NFC frontend.
*
* You must call this function so that events are posted to the application
* callback.
*
* @retval NRF_SUCCESS If the NFC frontend was activated successfully. If the lower layer
* could not be started, an error code is returned.
*/
ret_code_t nfc_t2t_emulation_start(void);
/** @brief Function for deactivating the NFC frontend.
*
* After calling this function, no more events will be posted to the
* application callback.
*
* @retval NRF_SUCCESS If the NFC frontend was deactivated successfully. If the lower layer
* could not be stopped, an error code is returned.
*/
ret_code_t nfc_t2t_emulation_stop(void);
/** @brief Function for releasing the reference to the application callback.
*
* After calling this function, the passed callback pointer is no longer
* considered valid.
*
* @retval NRF_SUCCESS This function always succeeds.
*/
ret_code_t nfc_t2t_done(void);
/** @} */
#endif // NFC_T2T_LIB_H__

BIN
COMPONENTS/nfc/t2t_lib/nfc_t2t_lib_gcc.a Normal file
View File

Binary file not shown.

BIN
COMPONENTS/nfc/t2t_lib/nfc_t2t_lib_iar.a Normal file
View File

Binary file not shown.

BIN
COMPONENTS/nfc/t2t_lib/nfc_t2t_lib_keil.lib Normal file
View File

Binary file not shown.