blob: 278affeaf03abc01db9351c10faedc7032457d1e [file] [log] [blame]
/*
* Copyright (c) 2018 - 2019, 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 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 the copyright holder nor the names of its
* contributors may be used to endorse or promote products derived from this
* software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER 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 NRF_NFCT_H__
#define NRF_NFCT_H__
#include <nrfx.h>
#ifdef __cplusplus
extern "C" {
#endif
/**
* @defgroup nrf_nfct_hal NFCT HAL
* @{
* @ingroup nrf_nfct
*
* @brief Hardware access layer (HAL) for the Near Field Communication Tag (NFCT) peripheral.
*/
#define NRF_NFCT_CRC_SIZE 2 /**< CRC size in bytes. */
#define NRF_NFCT_DISABLE_ALL_INT 0xFFFFFFFF /**< Value to disable all interrupts. */
/** @brief NFCT tasks. */
typedef enum
{
NRF_NFCT_TASK_ACTIVATE = offsetof(NRF_NFCT_Type, TASKS_ACTIVATE), /**< Activate the NFCT peripheral for the incoming and outgoing frames, change state to activated. */
NRF_NFCT_TASK_DISABLE = offsetof(NRF_NFCT_Type, TASKS_DISABLE), /**< Disable the NFCT peripheral. */
NRF_NFCT_TASK_SENSE = offsetof(NRF_NFCT_Type, TASKS_SENSE), /**< Enable the NFC sense field mode, change state to sense mode. */
NRF_NFCT_TASK_STARTTX = offsetof(NRF_NFCT_Type, TASKS_STARTTX), /**< Start the transmission of an outgoing frame, change state to transmit. */
NRF_NFCT_TASK_ENABLERXDATA = offsetof(NRF_NFCT_Type, TASKS_ENABLERXDATA), /**< Initialize EasyDMA for receive. */
NRF_NFCT_TASK_GOIDLE = offsetof(NRF_NFCT_Type, TASKS_GOIDLE), /**< Force state machine to the IDLE state. */
NRF_NFCT_TASK_GOSLEEP = offsetof(NRF_NFCT_Type, TASKS_GOSLEEP), /**< Force state machine to the SLEEP_A state. */
} nrf_nfct_task_t;
/** @brief NFCT events. */
typedef enum
{
NRF_NFCT_EVENT_READY = offsetof(NRF_NFCT_Type, EVENTS_READY), /**< The NFCT peripheral is ready to receive and send frames. */
NRF_NFCT_EVENT_FIELDDETECTED = offsetof(NRF_NFCT_Type, EVENTS_FIELDDETECTED), /**< Remote NFC field is detected. */
NRF_NFCT_EVENT_FIELDLOST = offsetof(NRF_NFCT_Type, EVENTS_FIELDLOST), /**< Remote NFC field is lost. */
NRF_NFCT_EVENT_TXFRAMESTART = offsetof(NRF_NFCT_Type, EVENTS_TXFRAMESTART), /**< The start of the first symbol of a transmitted frame. */
NRF_NFCT_EVENT_TXFRAMEEND = offsetof(NRF_NFCT_Type, EVENTS_TXFRAMEEND), /**< The end of the last transmitted on-air symbol of a frame. */
NRF_NFCT_EVENT_RXFRAMESTART = offsetof(NRF_NFCT_Type, EVENTS_RXFRAMESTART), /**< The end of the first symbol of a received frame. */
NRF_NFCT_EVENT_RXFRAMEEND = offsetof(NRF_NFCT_Type, EVENTS_RXFRAMEEND), /**< Received data was checked (CRC, parity) and transferred to RAM, and EasyDMA ended accessing the RX buffer. */
NRF_NFCT_EVENT_ERROR = offsetof(NRF_NFCT_Type, EVENTS_ERROR), /**< NFC error reported. The ERRORSTATUS register contains details on the source of the error. */
NRF_NFCT_EVENT_RXERROR = offsetof(NRF_NFCT_Type, EVENTS_RXERROR), /**< NFC RX frame error reported. The FRAMESTATUS.RX register contains details on the source of the error. */
NRF_NFCT_EVENT_ENDRX = offsetof(NRF_NFCT_Type, EVENTS_ENDRX), /**< RX buffer (as defined by PACKETPTR and MAXLEN) in Data RAM full. */
NRF_NFCT_EVENT_ENDTX = offsetof(NRF_NFCT_Type, EVENTS_ENDTX), /**< Transmission of data in RAM ended, and EasyDMA ended accessing the TX buffer. */
NRF_NFCT_EVENT_AUTOCOLRESSTARTED = offsetof(NRF_NFCT_Type, EVENTS_AUTOCOLRESSTARTED), /**< Auto collision resolution process started. */
NRF_NFCT_EVENT_COLLISION = offsetof(NRF_NFCT_Type, EVENTS_COLLISION), /**< NFC auto collision resolution error reported. */
NRF_NFCT_EVENT_SELECTED = offsetof(NRF_NFCT_Type, EVENTS_SELECTED), /**< NFC auto collision resolution successfully completed. */
NRF_NFCT_EVENT_STARTED = offsetof(NRF_NFCT_Type, EVENTS_STARTED), /**< EasyDMA is ready to receive or send frames. */
} nrf_nfct_event_t;
/** @brief NFCT shortcuts. */
typedef enum
{
NRF_NFCT_SHORT_FIELDDETECTED_ACTIVATE_MASK = NFCT_SHORTS_FIELDDETECTED_ACTIVATE_Msk, /**< Shortcut between the FIELDDETECTED event and the ACTIVATE task. */
NRF_NFCT_SHORT_FIELDLOST_SENSE_MASK = NFCT_SHORTS_FIELDLOST_SENSE_Msk, /**< Shortcut between the FIELDLOST event and the SENSE task. */
#if defined(NFCT_SHORTS_TXFRAMEEND_ENABLERXDATA_Msk) || defined(__NRFX_DOXYGEN__)
NRF_NFCT_SHORT_TXFRAMEEND_ENABLERXDATA_MASK = NFCT_SHORTS_TXFRAMEEND_ENABLERXDATA_Msk, /**< Shortcut between the TXFRAMEEND event and the ENABLERXDATA task. */
#endif // defined(NFCT_SHORTS_TXFRAMEEND_ENABLERXDATA_Msk) || defined(__NRFX_DOXYGEN__)
} nrf_nfct_short_mask_t;
/** @brief NFCT interrupts. */
typedef enum
{
NRF_NFCT_INT_READY_MASK = NFCT_INTEN_READY_Msk, /**< Interrupt on READY event. */
NRF_NFCT_INT_FIELDDETECTED_MASK = NFCT_INTEN_FIELDDETECTED_Msk, /**< Interrupt on FIELDDETECTED event. */
NRF_NFCT_INT_FIELDLOST_MASK = NFCT_INTEN_FIELDLOST_Msk, /**< Interrupt on FIELDLOST event. */
NRF_NFCT_INT_TXFRAMESTART_MASK = NFCT_INTEN_TXFRAMESTART_Msk, /**< Interrupt on TXFRAMESTART event. */
NRF_NFCT_INT_TXFRAMEEND_MASK = NFCT_INTEN_TXFRAMEEND_Msk, /**< Interrupt on TXFRAMEEND event. */
NRF_NFCT_INT_RXFRAMESTART_MASK = NFCT_INTEN_RXFRAMESTART_Msk, /**< Interrupt on RXFRAMESTART event. */
NRF_NFCT_INT_RXFRAMEEND_MASK = NFCT_INTEN_RXFRAMEEND_Msk, /**< Interrupt on RXFRAMEEND event. */
NRF_NFCT_INT_ERROR_MASK = NFCT_INTEN_ERROR_Msk, /**< Interrupt on ERROR event. */
NRF_NFCT_INT_RXERROR_MASK = NFCT_INTEN_RXERROR_Msk, /**< Interrupt on RXERROR event. */
NRF_NFCT_INT_ENDRX_MASK = NFCT_INTEN_ENDRX_Msk, /**< Interrupt on ENDRX event. */
NRF_NFCT_INT_ENDTX_MASK = NFCT_INTEN_ENDTX_Msk, /**< Interrupt on ENDTX event. */
NRF_NFCT_INT_AUTOCOLRESSTARTED_MASK = NFCT_INTEN_AUTOCOLRESSTARTED_Msk, /**< Interrupt on AUTOCOLRESSTARTED event. */
NRF_NFCT_INT_COLLISION_MASK = NFCT_INTEN_COLLISION_Msk, /**< Interrupt on COLLISION event. */
NRF_NFCT_INT_SELECTED_MASK = NFCT_INTEN_SELECTED_Msk, /**< Interrupt on SELECTED event. */
NRF_NFCT_INT_STARTED_MASK = NFCT_INTEN_STARTED_Msk, /**< Interrupt on STARTED event. */
} nrf_nfct_int_mask_t;
/** @brief NFC error status bit masks. */
typedef enum
{
NRF_NFCT_ERROR_FRAMEDELAYTIMEOUT_MASK = NFCT_ERRORSTATUS_FRAMEDELAYTIMEOUT_Msk, /**< Timeout of the Frame Delay Timer (no frame transmission started in the FDT window). */
#if defined(NFCT_ERRORSTATUS_NFCFIELDTOOSTRONG_Msk) || defined(__NRFX_DOXYGEN__)
NRF_NFCT_ERROR_NFCFIELDTOOSTRONG_MASK = NFCT_ERRORSTATUS_NFCFIELDTOOSTRONG_Msk, /**< Field level is too high at maximum load resistance. */
#endif // defined(NFCT_ERRORSTATUS_NFCFIELDTOOSTRONG_Msk) || defined(__NRFX_DOXYGEN__)
#if defined(NFCT_ERRORSTATUS_NFCFIELDTOOWEAK_Msk) || defined(__NRFX_DOXYGEN__)
NRF_NFCT_ERROR_NFCFIELDTOOWEAK_MASK = NFCT_ERRORSTATUS_NFCFIELDTOOWEAK_Msk, /**< Field level is too low at minimum load resistance. */
#endif // defined(NFCT_ERRORSTATUS_NFCFIELDTOOWEAK_Msk) || defined(__NRFX_DOXYGEN__)
} nrf_nfct_error_status_t;
/** @brief NFC received frame status bit masks. */
typedef enum
{
NRF_NFCT_RX_FRAME_STATUS_CRC_MASK = NFCT_FRAMESTATUS_RX_CRCERROR_Msk, /**< CRC status mask. */
NRF_NFCT_RX_FRAME_STATUS_PARITY_MASK = NFCT_FRAMESTATUS_RX_PARITYSTATUS_Msk, /**< Parity status mask. */
NRF_NFCT_RX_FRAME_STATUS_OVERRUN_MASK = NFCT_FRAMESTATUS_RX_OVERRUN_Msk, /**< Overrun status mask. */
} nrf_nfct_rx_frame_status_t;
#if defined(NFCT_NFCTAGSTATE_NFCTAGSTATE_Msk) || defined(__NRFX_DOXYGEN__)
/** @brief NFC tag state. */
typedef enum
{
NRF_NFCT_TAG_STATE_DISABLED = NFCT_NFCTAGSTATE_NFCTAGSTATE_Disabled, /**< Disabled or sensing NFC field. */
NRF_NFCT_TAG_STATE_RAMP_UP = NFCT_NFCTAGSTATE_NFCTAGSTATE_RampUp, /**< Ramping up. */
NRF_NFCT_TAG_STATE_IDLE = NFCT_NFCTAGSTATE_NFCTAGSTATE_Idle, /**< Idle. */
NRF_NFCT_TAG_STATE_RECEIVE = NFCT_NFCTAGSTATE_NFCTAGSTATE_Receive, /**< Receiving data. */
NRF_NFCT_TAG_STATE_FRAME_DELAY = NFCT_NFCTAGSTATE_NFCTAGSTATE_FrameDelay, /**< Counting Frame Delay Time since the last symbol of the last received frame. */
NRF_NFCT_TAG_STATE_TRANSMIT = NFCT_NFCTAGSTATE_NFCTAGSTATE_Transmit /**< Transmitting data. */
} nrf_nfct_tag_state_t;
#endif // defined(NFCT_NFCTAGSTATE_NFCTAGSTATE_Msk) || defined(__NRFX_DOXYGEN__)
#if defined (NFCT_SLEEPSTATE_SLEEPSTATE_Msk) || defined(__NRFX_DOXYGEN__)
/**
* @brief NFC tag sleep state.
*
* @details Shows the sleep state during automatic collision resolution
* according to the NFC Forum Activity Technical Specification v2.0.
*/
typedef enum
{
NRF_NFCT_SLEEP_STATE_IDLE = NFCT_SLEEPSTATE_SLEEPSTATE_Idle, /**< 'IDLE' state. */
NRF_NFCT_SLEEP_STATE_SLEEP_A = NFCT_SLEEPSTATE_SLEEPSTATE_SleepA /**< 'SLEEP_A' state. */
} nrf_nfct_sleep_state_t;
#endif // defined (NFCT_SLEEPSTATE_SLEEPSTATE_Msk) || defined(__NRFX_DOXYGEN__)
/** @brief NFC field state bit masks. */
typedef enum
{
NRF_NFCT_FIELD_STATE_PRESENT_MASK = NFCT_FIELDPRESENT_FIELDPRESENT_Msk, /**< Field presence mask. */
NRF_NFCT_FIELD_STATE_LOCK_MASK = NFCT_FIELDPRESENT_LOCKDETECT_Msk /**< Field lock mask. */
} nrf_nfct_field_state_t;
/** @brief NFC frame delay mode for data transmission. */
typedef enum
{
NRF_NFCT_FRAME_DELAY_MODE_FREERUN = NFCT_FRAMEDELAYMODE_FRAMEDELAYMODE_FreeRun, /**< Frame transmission starts when @ref NRF_NFCT_TASK_STARTTX is set (delay timer is not used). */
NRF_NFCT_FRAME_DELAY_MODE_WINDOW = NFCT_FRAMEDELAYMODE_FRAMEDELAYMODE_Window, /**< Frame transmission starts in a window between FRAMEDELAYMIN and FRAMEDELAYMAX. */
NRF_NFCT_FRAME_DELAY_MODE_EXACTVAL = NFCT_FRAMEDELAYMODE_FRAMEDELAYMODE_ExactVal, /**< Frame transmission starts when the delay timer reaches FRAMEDELAYMAX. */
NRF_NFCT_FRAME_DELAY_MODE_WINDOWGRID = NFCT_FRAMEDELAYMODE_FRAMEDELAYMODE_WindowGrid /**< Frame transmission starts in a bit grid between FRAMEDELAYMIN and FRAMEDELAYMAX. */
} nrf_nfct_frame_delay_mode_t;
/** @brief Bit masks for NFC transmission frame configuration. */
typedef enum
{
NRF_NFCT_TX_FRAME_CONFIG_PARITY = NFCT_TXD_FRAMECONFIG_PARITY_Msk, /**< Indicates whether parity is added in the transmitted frames. */
NRF_NFCT_TX_FRAME_CONFIG_DISCARD_START = NFCT_TXD_FRAMECONFIG_DISCARDMODE_Msk, /**< Indicates whether unused bits are discarded at the start or at the end of the transmitted frames. */
NRF_NFCT_TX_FRAME_CONFIG_SOF = NFCT_TXD_FRAMECONFIG_SOF_Msk, /**< Indicates whether SoF symbol is added in the transmitted frames. */
NRF_NFCT_TX_FRAME_CONFIG_CRC16 = NFCT_TXD_FRAMECONFIG_CRCMODETX_Msk /**< Indicates whether CRC is added in the transmitted frames. */
} nrf_nfct_tx_frame_config_t;
/** @brief Bit masks for NFC reception frame configuration. */
typedef enum
{
NRF_NFCT_RX_FRAME_CONFIG_PARITY = NFCT_RXD_FRAMECONFIG_PARITY_Msk, /**< Indicates whether parity is expected in the received frames. */
NRF_NFCT_RX_FRAME_CONFIG_SOF = NFCT_RXD_FRAMECONFIG_SOF_Msk, /**< Indicates whether SoF symbol is expected in the received frames. */
NRF_NFCT_RX_FRAME_CONFIG_CRC16 = NFCT_RXD_FRAMECONFIG_CRCMODERX_Msk /**< Indicates whether CRC is expected and checked in the received frames. */
} nrf_nfct_rx_frame_config_t;
/**
* @brief 'NFCI1 size' NFC field configuration for the SENS_RES frame according to the NFC Forum
* Digital Protocol Technical Specification.
*/
typedef enum
{
NRF_NFCT_SENSRES_NFCID1_SIZE_SINGLE =
NFCT_SENSRES_NFCIDSIZE_NFCID1Single << NFCT_SENSRES_NFCIDSIZE_Pos, /**< Single size NFCID1 (4 bytes). */
NRF_NFCT_SENSRES_NFCID1_SIZE_DOUBLE =
NFCT_SENSRES_NFCIDSIZE_NFCID1Double << NFCT_SENSRES_NFCIDSIZE_Pos, /**< Double size NFCID1 (7 bytes). */
NRF_NFCT_SENSRES_NFCID1_SIZE_TRIPLE =
NFCT_SENSRES_NFCIDSIZE_NFCID1Triple << NFCT_SENSRES_NFCIDSIZE_Pos, /**< Triple size NFCID1 (10 bytes). */
NRF_NFCT_SENSRES_NFCID1_SIZE_DEFAULT =
NFCT_SENSRES_NFCIDSIZE_Msk /**< Default size. Use this option to leave NFCID1 size unchanged. */
} nrf_nfct_sensres_nfcid1_size_t;
/**
* @brief 'Bit frame SDD' NFC field configuration for the SENS_RES frame according to the NFC
* Forum Digital Protocol Technical Specification.
*/
typedef enum
{
NRF_NFCT_SENSRES_BIT_FRAME_SDD_00000 =
NFCT_SENSRES_BITFRAMESDD_SDD00000 << NFCT_SENSRES_BITFRAMESDD_Pos, /**< SDD pattern 00000. */
NRF_NFCT_SENSRES_BIT_FRAME_SDD_00001 =
NFCT_SENSRES_BITFRAMESDD_SDD00001 << NFCT_SENSRES_BITFRAMESDD_Pos, /**< SDD pattern 00001. */
NRF_NFCT_SENSRES_BIT_FRAME_SDD_00010 =
NFCT_SENSRES_BITFRAMESDD_SDD00010 << NFCT_SENSRES_BITFRAMESDD_Pos, /**< SDD pattern 00010. */
NRF_NFCT_SENSRES_BIT_FRAME_SDD_00100 =
NFCT_SENSRES_BITFRAMESDD_SDD00100 << NFCT_SENSRES_BITFRAMESDD_Pos, /**< SDD pattern 00100. */
NRF_NFCT_SENSRES_BIT_FRAME_SDD_01000 =
NFCT_SENSRES_BITFRAMESDD_SDD01000 << NFCT_SENSRES_BITFRAMESDD_Pos, /**< SDD pattern 01000. */
NRF_NFCT_SENSRES_BIT_FRAME_SDD_10000 =
NFCT_SENSRES_BITFRAMESDD_SDD10000 << NFCT_SENSRES_BITFRAMESDD_Pos /**< SDD pattern 10000. */
} nrf_nfct_sensres_bit_frame_sdd_t;
/**
* @brief 'Platofrm Config' NFC field configuration for the SENS_RES frame according to the NFC
* Forum Digital Protocol Technical Specification.
*/
typedef enum
{
/**< SENS_RES 'Platform Config' field (b4-b1) value for Type 1 Tag platform. */
NRF_NFCT_SENSRES_PLATFORM_CONFIG_T1T = 6 << NFCT_SENSRES_PLATFCONFIG_Pos,
/**< SENS_RES 'Platform Config' field (b7-b6) value for any platform except Type 1 Tag platform. */
NRF_NFCT_SENSRES_PLATFORM_CONFIG_OTHER = 0 << NFCT_SENSRES_PLATFCONFIG_Pos
} nrf_nfct_sensres_platform_config_t;
/** @brief Bit masks for SEL_RES NFC frame configuration. */
typedef enum
{
NRF_NFCT_SELRES_CASCADE_MASK = NFCT_SELRES_CASCADE_Msk, /**< SEL_RES Cascade field bit mask. */
NRF_NFCT_SELRES_PROTOCOL_MASK = NFCT_SELRES_PROTOCOL_Msk /**< SEL_RES Protocol field bit mask. */
} nrf_nfct_selres_t;
/**
* @brief Protocol NFC field (bits b7 and b6) configuration for the SEL_RES frame according to
* the NFC Forum Digital Protocol Technical Specification.
*/
typedef enum
{
NRF_NFCT_SELRES_PROTOCOL_T2T = 0, /**< Type 2 Tag platform. */
NRF_NFCT_SELRES_PROTOCOL_T4AT = 1, /**< Type 4A Tag platform. */
NRF_NFCT_SELRES_PROTOCOL_NFCDEP = 2, /**< NFC-DEP Protocol. */
NRF_NFCT_SELRES_PROTOCOL_NFCDEP_T4AT = 3, /**< NFC-DEP Protocol and Type 4A Tag platform). */
} nrf_nfct_selres_protocol_t;
/**
* @brief Function for activating a specific NFCT task.
*
* @param[in] task Task to be activated.
*/
__STATIC_INLINE void nrf_nfct_task_trigger(nrf_nfct_task_t task);
/**
* @brief Function for returning the address of a specific NFCT task register.
*
* @param[in] task Task.
*
* @return Task address.
*/
__STATIC_INLINE uint32_t nrf_nfct_task_address_get(nrf_nfct_task_t task);
/**
* @brief Function for clearing a specific event.
*
* @param[in] event Event.
*/
__STATIC_INLINE void nrf_nfct_event_clear(nrf_nfct_event_t event);
/**
* @brief Function for retrieving the state of the NFCT event.
*
* @param[in] event Event to be checked.
*
* @retval true The event has been generated.
* @retval false The event has not been generated.
*/
__STATIC_INLINE bool nrf_nfct_event_check(nrf_nfct_event_t event);
/**
* @brief Function for returning the address of a specific NFCT event register.
*
* @param[in] event Event.
*
* @return Address.
*/
__STATIC_INLINE uint32_t nrf_nfct_event_address_get(nrf_nfct_event_t event);
/**
* @brief Function for enabling selected shortcuts.
*
* @param[in] short_mask Mask of shortcuts.
*/
__STATIC_INLINE void nrf_nfct_shorts_enable(uint32_t short_mask);
/**
* @brief Function for disabling selected shortcuts.
*
* @param[in] short_mask Mask of shortcuts.
*/
__STATIC_INLINE void nrf_nfct_shorts_disable(uint32_t short_mask);
/**
* @brief Function for retrieving the enabled shortcuts.
*
* @return Flags of the currently enabled shortcuts.
*/
__STATIC_INLINE uint32_t nrf_nfct_shorts_get(void);
/**
* @brief Function for setting shortcuts.
*
* @param[in] short_mask Shortcut mask.
*/
__STATIC_INLINE void nrf_nfct_shorts_set(uint32_t short_mask);
/**
* @brief Function for enabling the selected interrupts.
*
* @param[in] int_mask Interrupt mask.
*/
__STATIC_INLINE void nrf_nfct_int_enable(uint32_t int_mask);
/**
* @brief Function for retrieving the state of the selected interrupts.
*
* @param[in] int_mask Interrupt mask.
*
* @retval true Any of the selected interrupts is enabled.
* @retval false None of the selected interrupts is enabled.
*/
__STATIC_INLINE bool nrf_nfct_int_enable_check(uint32_t int_mask);
/**
* @brief Function for retrieving the information about enabled interrupts.
*
* @return The flags of the enabled interrupts.
*/
__STATIC_INLINE uint32_t nrf_nfct_int_enable_get(void);
/**
* @brief Function for disabling the selected interrupts.
*
* @param[in] int_mask Interrupt mask.
*/
__STATIC_INLINE void nrf_nfct_int_disable(uint32_t int_mask);
/**
* @brief Function for getting the NFCT error status.
*
* @return The NFCT error status flags, defined in @ref nrf_nfct_error_status_t.
*/
__STATIC_INLINE uint32_t nrf_nfct_error_status_get(void);
/**
* @brief Function for clearing the NFCT error status.
*
* @param[in] error_flag Error flags to be cleared, defined in @ref nrf_nfct_error_status_t.
*/
__STATIC_INLINE void nrf_nfct_error_status_clear(uint32_t error_flag);
/**
* @brief Function for getting the NFC frame reception status.
*
* @return The flags of the NFC frame reception status, defined in @ref nrf_nfct_rx_frame_status_t.
*/
__STATIC_INLINE uint32_t nrf_nfct_rx_frame_status_get(void);
/**
* @brief Function for clearing the NFC frame reception status.
*
* @param[in] framestatus_flags Status flags to be cleared, defined in
* @ref nrf_nfct_rx_frame_status_t.
*/
__STATIC_INLINE void nrf_nfct_rx_frame_status_clear(uint32_t framestatus_flags);
#if defined(NFCT_NFCTAGSTATE_NFCTAGSTATE_Msk) || defined(__NRFX_DOXYGEN__)
/**
* @brief Function for getting the NFC tag state.
*
* @retval NRF_NFCT_TAG_STATE_DISABLED NFC tag is disabled.
* @retval NRF_NFCT_TAG_STATE_RAMP_UP NFC tag is ramping up.
* @retval NRF_NFCT_TAG_STATE_IDLE NFC tag is activated and idle.
* @retval NRF_NFCT_TAG_STATE_RECEIVE NFC tag is receiving data.
* @retval NRF_NFCT_TAG_STATE_FRAME_DELAY Frame Delay Timer of the NFC tag is counting ticks
* since the last symbol of the last received frame.
* @retval NRF_NFCT_TAG_STATE_TRANSMIT NFC tag is transmitting data.
*/
__STATIC_INLINE nrf_nfct_tag_state_t nrf_nfct_tag_state_get(void);
#endif // defined(NFCT_NFCTAGSTATE_NFCTAGSTATE_Msk) || defined(__NRFX_DOXYGEN__)
#if defined (NFCT_SLEEPSTATE_SLEEPSTATE_Msk) || defined(__NRFX_DOXYGEN__)
/**
* @brief Function for getting the NFC tag sleep state during the automatic collision resolution.
*
* @details The returned value is the last state before the autimatic collision resolution started.
*
* @retval NRF_NFCT_SLEEP_STATE_IDLE NFC tag was in IDLE state before the automatic
* collision resolution started.
* @retval NRF_NFCT_SLEEP_STATE_SLEEP_A NFC tag was in SLEEP_A state before the automatic
* collision resolution started.
*/
__STATIC_INLINE nrf_nfct_sleep_state_t nrf_nfct_sleep_state_get(void);
#endif // defined (NFCT_SLEEPSTATE_SLEEPSTATE_Msk) || defined(__NRFX_DOXYGEN__)
/**
* @brief Function for getting the status of the external NFC field detection.
*
* @return The NFC field detection status. Status bits can be checked by using
* @ref nrf_nfct_field_state_t.
*/
__STATIC_INLINE uint8_t nrf_nfct_field_status_get(void);
/**
* @brief Function for getting the minimum Frame Delay Time value.
*
* @details This is the minimum value for Frame Delay Timer. It controls the shortest time between
* the last symbol of the last received frame and the start of the transmission of a new
* TX frame.
*
* @return The minimum Frame Delay Time value in 13.56-MHz clock ticks.
*/
__STATIC_INLINE uint16_t nrf_nfct_frame_delay_min_get(void);
/**
* @brief Function for setting the minimum Frame Delay Time value.
*
* @details This is the minimum value for Frame Delay Timer. It controls the shortest time between
* the last symbol of the last received frame and the start of the transmission of a new
* TX frame.
*
* @param[in] frame_delay_min Minimum Frame Delay Time value in 13.56-MHz clock ticks.
*/
__STATIC_INLINE void nrf_nfct_frame_delay_min_set(uint16_t frame_delay_min);
/**
* @brief Function for getting the maximum Frame Delay Time value.
*
* @details This is the maximum value for Frame Delay Timer. It controls the longest time between
* the last symbol of the last received frame and the start of the transmission of a new
* TX frame. If no transmission starts before the Frame Delay Timer timeout,
* @ref NRF_NFCT_ERROR_FRAMEDELAYTIMEOUT_MASK is set.
*
* @return The maximum Frame Delay Time value in 13.56-MHz clock ticks.
*/
__STATIC_INLINE uint32_t nrf_nfct_frame_delay_max_get(void);
/**
* @brief Function for setting the maximum Frame Delay Time value.
*
* @details This is the maximum value for Frame Delay Timer. It controls the longest time between
* the last symbol of the last received frame and the start of the transmission of a new
* TX frame. If no transmission starts before the Frame Delay Timer timeout,
* @ref NRF_NFCT_ERROR_FRAMEDELAYTIMEOUT_MASK is set.
*
* @param[in] frame_delay_max Maximum Frame Delay Time value in 13.56-MHz clock ticks.
*/
__STATIC_INLINE void nrf_nfct_frame_delay_max_set(uint32_t frame_delay_max);
/**
* @brief Function for getting the Frame Delay Mode configuration.
*
* @return The configured Frame Delay Mode.
*/
__STATIC_INLINE nrf_nfct_frame_delay_mode_t nrf_nfct_frame_delay_mode_get(void);
/**
* @brief Function for setting the NFC Frame Delay Mode configuration.
*
* @param[in] frame_delay_mode Frame Delay Mode configuration.
*/
__STATIC_INLINE void nrf_nfct_frame_delay_mode_set(nrf_nfct_frame_delay_mode_t frame_delay_mode);
/**
* @brief Function for getting the pointer to the NFCT RX/TX buffer.
*
* @return The configured pointer to the receive or transmit buffer.
*/
__STATIC_INLINE uint8_t * nrf_nfct_rxtx_buffer_get(void);
/**
* @brief Function for setting the the NFCT RX/TX buffer (address and maximum length).
*
* @note Buffer for the NFC RX/TX data is used by EasyDMA and must be located in RAM.
*
* @param[in] p_rxtx_buf Pointer to the receive or transmit buffer.
* @param[in] max_txrx_len Maximum receive or transmit length in bytes (size of the RAM
* buffer for EasyDMA).
*/
__STATIC_INLINE void nrf_nfct_rxtx_buffer_set(uint8_t * p_rxtx_buf,
uint16_t max_txrx_len);
/**
* @brief Function for getting the NFCT RX/TX maximum buffer length.
*
* @return The configured maximum receive or transmit length in bytes (size of the RX/TX
* buffer for EasyDMA).
*/
__STATIC_INLINE uint16_t nrf_nfct_max_rxtx_length_get(void);
/**
* @brief Function for getting the flags for NFC frame transmission configuration.
*
* @return The flags of the NFCT frame transmission configuration, defined in
* @ref nrf_nfct_tx_frame_config_t.
*/
__STATIC_INLINE uint8_t nrf_nfct_tx_frame_config_get(void);
/**
* @brief Function for setting up the flags of the NFC frame transmission configuration.
*
* @param[in] flags Flags for NFCT TX configuration. Use @ref nrf_nfct_tx_frame_config_t for
* setting.
*/
__STATIC_INLINE void nrf_nfct_tx_frame_config_set(uint8_t flags);
/**
* @brief Function for getting the length of the configured transmission frame.
*
* @note NFC frames do not have to consist of full bytes only, therefore data amount
* for transmission is configured in number of bits.
*
* @return Number of bits to be sent excluding CRC, parity, SoF, and EoF.
*/
__STATIC_INLINE uint16_t nrf_nfct_tx_bits_get(void);
/**
* @brief Function for setting up the NFC frame transmission.
*
* @details Set the number of TX bits excluding CRC, parity, SoF, and EoF.
*
* @note Source of data for transmission is set by using @ref nrf_nfct_rxtx_buffer_set.
* @note NFC frames do not have to consist of full bytes only, therefore data amount
* for transmission is configured in number of bits.
*
* @param[in] tx_bits Overall number of bits to be sent.
*/
__STATIC_INLINE void nrf_nfct_tx_bits_set(uint16_t tx_bits);
/**
* @brief Function for getting the flags of the NFC frame reception configuration.
*
* @return The flags for NFCT frame reception configuration, defined in
* @ref nrf_nfct_rx_frame_config_t.
*/
__STATIC_INLINE uint8_t nrf_nfct_rx_frame_config_get(void);
/**
* @brief Function for setting up the NFC frame reception.
*
* @note Destination for the received data is set using @ref nrf_nfct_rxtx_buffer_set.
*
* @param[in] flags NFCT RX configuration flags. Use @ref nrf_nfct_rx_frame_config_t for setting
* the desired configuration.
*/
__STATIC_INLINE void nrf_nfct_rx_frame_config_set(uint8_t flags);
/**
* @brief Function for getting the number of bits received from the NFC poller.
*
* @param[in] crc_excluded Flag for excluding CRC size from calculation.
*
* @return Number of received bits including or excluding CRC, and excluding parity
* and SoF/EoF framing.
*/
__STATIC_INLINE uint16_t nrf_nfct_rx_bits_get(bool crc_excluded);
/**
* @brief Function for getting the NFCID1 (NFC tag identifier).
*
* @note This function always returns the full configuration of the NFCID1 setting (10 bytes),
* regardless of the NFCID1 size. The NFCID1 size can be configured using
* @ref nrf_nfct_sensres_nfcid1_size_set or @ref nrf_nfct_nfcid1_set.
*
* @param[out] p_nfcid1_buf Pointer to a buffer for the NDFCID1 parameter.
* The NFCID1 values are in little endian order,
* that is: |NFCID1_3RD_LAST|NFCID1_2ND_LAST|NFCID1_LAST|.
*
* @return Configured NFCID1 length
*/
__STATIC_INLINE nrf_nfct_sensres_nfcid1_size_t nrf_nfct_nfcid1_get(uint8_t * p_nfcid1_buf);
/**
* @brief Function for setting the NFCID1 (NFC tag identifier).
*
* @note This function also configures the NFCIDSIZE field in the SENSRES
* register of the NRF_NFCT peripheral.
*
* @param[in] p_nfcid1_buf Pointer to the buffer with NDFCID1 bytes.
* @param[in] nfcid1_size Size of the NFCID1 in bytes.
*/
__STATIC_INLINE void nrf_nfct_nfcid1_set(uint8_t const * p_nfcid1_buf,
nrf_nfct_sensres_nfcid1_size_t nfcid1_size);
#if defined (NFCT_AUTOCOLRESCONFIG_MODE_Msk) || defined(__NRFX_DOXYGEN__)
/**
* @brief Function for getting the setting for the automatic collision resolution.
*
* @details The automatic collision resolution mechanism as defined in ISO 14443-3 and NFC Forum
* Digital Protocol Technical Specification 2.0, section 6.
*
* @retval true If automatic collision resolution is enabled.
* @retval false If automatic collision resolution is disabled.
*/
__STATIC_INLINE bool nrf_nfct_autocolres_is_enabled(void);
/**
* @brief Function for enabling the automatic collision resolution.
*
* @details The automatic collision resolution mechanism as defined in ISO 14443-3 and NFC Forum
* Digital Protocol Technical Specification 2.0, section 6.
*/
__STATIC_INLINE void nrf_nfct_autocolres_enable(void);
/**
* @brief Function for disabling the automatic collision resolution.
*
* @details The automatic collision resolution mechanism as defined in ISO 14443-3 and NFC Forum
* Digital Protocol Technical Specification 2.0, section 6.
*/
__STATIC_INLINE void nrf_nfct_autocolres_disable(void);
#endif // defined (NFCT_AUTOCOLRESCONFIG_MODE_Msk) || defined(__NRFX_DOXYGEN__)
/**
* @brief Function for getting the NFCID1 size from the SENS_RES frame configuration.
*
* @details The SENS_RES frame is handled automatically by the NFCT hardware.
*
* @return NFCID1 (tag identifier) size.
*/
__STATIC_INLINE nrf_nfct_sensres_nfcid1_size_t nrf_nfct_sensres_nfcid1_size_get(void);
/**
* @brief Function for setting the NFCID1 (tag identifier) size.field in the SENS_RES frame
* configuration.
*
* @note The SENS_RES frame is handled automatically by the NFCT hardware.
*
* @param[in] nfcid1_size NFCID1 (tag identifier) size.
*
* @sa nrf_nfct_nfcid1_set()
*/
__STATIC_INLINE void nrf_nfct_sensres_nfcid1_size_set(nrf_nfct_sensres_nfcid1_size_t nfcid1_size);
/**
* @brief Function for getting the Bit Frame SDD field from the SENS_RES frame configuration.
*
* @details The SENS_RES frame is handled automatically by the NFCT hardware.
*
* @return The Bit Frame SDD field configuration.
*/
__STATIC_INLINE nrf_nfct_sensres_bit_frame_sdd_t nrf_nfct_sensres_bit_frame_sdd_get(void);
/**
* @brief Function for setting the Bit Frame SDD field in the SENS_RES frame configuration.
*
* @note The SENS_RES frame is handled automatically by the NFCT hardware.
*
* @param[in] bit_frame_sdd The Bit Frame SDD field configuration.
*/
__STATIC_INLINE void nrf_nfct_sensres_bit_frame_sdd_set(nrf_nfct_sensres_bit_frame_sdd_t bit_frame_sdd);
/**
* @brief Function for getting the Platform Config field from the SENS_RES frame configuration.
*
* @details The SENS_RES frame is handled automatically by the NFCT hardware.
*
* @return The Platform Config field configuration.
*/
__STATIC_INLINE nrf_nfct_sensres_platform_config_t nrf_nfct_sensres_platform_config_get(void);
/**
* @brief Function for setting the Platform Config field in the SENS_RES frame configuration.
*
* @note The SENS_RES frame is handled automatically by the NFCT hardware.
*
* @param[in] platform_config The Platform Config field configuration.
*/
__STATIC_INLINE void nrf_nfct_sensres_platform_config_set(nrf_nfct_sensres_platform_config_t platform_config);
/**
* @brief Function for checking the CASCADE bit of the SEL_RES frame.
*
* @details The CASCADE bit in the SEL_RES register is handled automatically by the NFCT hardware
* and indicates the status of the NFCID1 read operation to the NFC poller according to
* the NFC Forum Digital Protocol Speficiation 2.0, section 6.8.2.
*
* @retval true If NFCID1 read procedure is not complete.
* @retval false If NFCID1 read procedure is complete.
*/
__STATIC_INLINE bool nrf_nfct_selsres_cascade_check(void);
/**
* @brief Function for getting the Protocol field in the SEL_RES frame.
*
* @details The SEL_RES frame is handled automatically by the NFCT hardware.
*
* @return Value of the Protocol field in the SEL_RES frame.
*/
__STATIC_INLINE nrf_nfct_selres_protocol_t nrf_nfct_selsres_protocol_get(void);
/**
* @brief Function for setting the Protocol field in the SEL_RES frame configuration.
*
* @details The SEL_RES frame is handled automatically by the NFCT hardware.
*
* @param[in] sel_res_protocol Value of the Protocol field in the SEL_RES frame.
*/
__STATIC_INLINE void nrf_nfct_selres_protocol_set(nrf_nfct_selres_protocol_t sel_res_protocol);
#ifndef SUPPRESS_INLINE_IMPLEMENTATION
__STATIC_INLINE void nrf_nfct_task_trigger(nrf_nfct_task_t task)
{
*((volatile uint32_t *)((uint8_t *)NRF_NFCT + (uint32_t)task)) = 1UL;
}
__STATIC_INLINE uint32_t nrf_nfct_task_address_get(nrf_nfct_task_t task)
{
return (uint32_t)((uint8_t *)NRF_NFCT + (uint32_t)task);
}
__STATIC_INLINE void nrf_nfct_event_clear(nrf_nfct_event_t event)
{
*((volatile uint32_t *)((uint8_t *)NRF_NFCT + (uint32_t)event)) = 0UL;
__DSB();
}
__STATIC_INLINE bool nrf_nfct_event_check(nrf_nfct_event_t event)
{
return (bool)*(volatile const uint32_t *)((uint8_t *)NRF_NFCT + (uint32_t)event);
}
__STATIC_INLINE uint32_t nrf_nfct_event_address_get(nrf_nfct_event_t event)
{
return (uint32_t)((uint8_t *)NRF_NFCT + (uint32_t)event);
}
__STATIC_INLINE void nrf_nfct_shorts_enable(uint32_t short_mask)
{
NRF_NFCT->SHORTS |= short_mask;
}
__STATIC_INLINE void nrf_nfct_shorts_disable(uint32_t short_mask)
{
NRF_NFCT->SHORTS &= ~short_mask;
}
__STATIC_INLINE uint32_t nrf_nfct_shorts_get(void)
{
return NRF_NFCT->SHORTS;
}
__STATIC_INLINE void nrf_nfct_shorts_set(uint32_t short_mask)
{
NRF_NFCT->SHORTS = short_mask;
}
__STATIC_INLINE void nrf_nfct_int_enable(uint32_t int_mask)
{
NRF_NFCT->INTENSET = int_mask;
}
__STATIC_INLINE bool nrf_nfct_int_enable_check(uint32_t int_mask)
{
return (bool)(NRF_NFCT->INTENSET & int_mask);
}
__STATIC_INLINE uint32_t nrf_nfct_int_enable_get(void)
{
return NRF_NFCT->INTENSET;
}
__STATIC_INLINE void nrf_nfct_int_disable(uint32_t int_mask)
{
NRF_NFCT->INTENCLR = int_mask;
}
__STATIC_INLINE uint32_t nrf_nfct_error_status_get(void)
{
return NRF_NFCT->ERRORSTATUS;
}
__STATIC_INLINE void nrf_nfct_error_status_clear(uint32_t error_flags)
{
NRF_NFCT->ERRORSTATUS = error_flags;
}
__STATIC_INLINE uint32_t nrf_nfct_rx_frame_status_get(void)
{
return NRF_NFCT->FRAMESTATUS.RX;
}
__STATIC_INLINE void nrf_nfct_rx_frame_status_clear(uint32_t framestatus_flags)
{
NRF_NFCT->FRAMESTATUS.RX = framestatus_flags;
}
#if defined(NFCT_NFCTAGSTATE_NFCTAGSTATE_Msk) || defined(__NRFX_DOXYGEN__)
__STATIC_INLINE nrf_nfct_tag_state_t nrf_nfct_tag_state_get(void)
{
return (nrf_nfct_tag_state_t)((NRF_NFCT->NFCTAGSTATE & NFCT_NFCTAGSTATE_NFCTAGSTATE_Msk) >>
NFCT_NFCTAGSTATE_NFCTAGSTATE_Pos);
}
#endif // defined(NFCT_NFCTAGSTATE_NFCTAGSTATE_Msk) || defined(__NRFX_DOXYGEN__)
#if defined (NFCT_SLEEPSTATE_SLEEPSTATE_Msk) || defined(__NRFX_DOXYGEN__)
__STATIC_INLINE nrf_nfct_sleep_state_t nrf_nfct_sleep_state_get(void)
{
return (nrf_nfct_sleep_state_t)((NRF_NFCT->SLEEPSTATE & NFCT_SLEEPSTATE_SLEEPSTATE_Msk) >>
NFCT_SLEEPSTATE_SLEEPSTATE_Pos);
}
#endif // defined (NFCT_SLEEPSTATE_SLEEPSTATE_Msk) || defined(__NRFX_DOXYGEN__)
__STATIC_INLINE uint8_t nrf_nfct_field_status_get(void)
{
return (uint8_t)(NRF_NFCT->FIELDPRESENT);
}
__STATIC_INLINE uint16_t nrf_nfct_frame_delay_min_get(void)
{
return (uint16_t)((NRF_NFCT->FRAMEDELAYMIN & NFCT_FRAMEDELAYMIN_FRAMEDELAYMIN_Msk) >>
NFCT_FRAMEDELAYMIN_FRAMEDELAYMIN_Pos);
}
__STATIC_INLINE void nrf_nfct_frame_delay_min_set(uint16_t frame_delay_min)
{
NRF_NFCT->FRAMEDELAYMIN =
((uint32_t)frame_delay_min << NFCT_FRAMEDELAYMIN_FRAMEDELAYMIN_Pos) &
NFCT_FRAMEDELAYMIN_FRAMEDELAYMIN_Msk;
}
__STATIC_INLINE uint32_t nrf_nfct_frame_delay_max_get(void)
{
return (NRF_NFCT->FRAMEDELAYMAX & NFCT_FRAMEDELAYMAX_FRAMEDELAYMAX_Msk) >>
NFCT_FRAMEDELAYMAX_FRAMEDELAYMAX_Pos;
}
__STATIC_INLINE void nrf_nfct_frame_delay_max_set(uint32_t frame_delay_max)
{
NRF_NFCT->FRAMEDELAYMAX =
((uint32_t)frame_delay_max << NFCT_FRAMEDELAYMAX_FRAMEDELAYMAX_Pos) &
NFCT_FRAMEDELAYMAX_FRAMEDELAYMAX_Msk;
}
__STATIC_INLINE nrf_nfct_frame_delay_mode_t nrf_nfct_frame_delay_mode_get(void)
{
return (nrf_nfct_frame_delay_mode_t)(NRF_NFCT->FRAMEDELAYMODE &
NFCT_FRAMEDELAYMODE_FRAMEDELAYMODE_Msk);
}
__STATIC_INLINE void nrf_nfct_frame_delay_mode_set(nrf_nfct_frame_delay_mode_t frame_delay_mode)
{
NRF_NFCT->FRAMEDELAYMODE = (uint32_t)frame_delay_mode;
}
__STATIC_INLINE uint8_t * nrf_nfct_rxtx_buffer_get(void)
{
return (uint8_t *)(NRF_NFCT->PACKETPTR);
}
__STATIC_INLINE void nrf_nfct_rxtx_buffer_set(uint8_t * p_rxtx_buf,
uint16_t max_txrx_len)
{
NRF_NFCT->PACKETPTR = (uint32_t)p_rxtx_buf;
NRF_NFCT->MAXLEN = ((uint32_t)max_txrx_len << NFCT_MAXLEN_MAXLEN_Pos) &
NFCT_MAXLEN_MAXLEN_Msk;
}
__STATIC_INLINE uint16_t nrf_nfct_max_rxtx_length_get(void)
{
return (uint16_t)((NRF_NFCT->MAXLEN & NFCT_MAXLEN_MAXLEN_Msk) >> NFCT_MAXLEN_MAXLEN_Pos);
}
__STATIC_INLINE uint8_t nrf_nfct_tx_frame_config_get(void)
{
return (uint8_t)(NRF_NFCT->TXD.FRAMECONFIG);
}
__STATIC_INLINE void nrf_nfct_tx_frame_config_set(uint8_t flags)
{
NRF_NFCT->TXD.FRAMECONFIG = flags;
}
__STATIC_INLINE uint16_t nrf_nfct_tx_bits_get(void)
{
return (uint16_t)(NRF_NFCT->TXD.AMOUNT & (NFCT_TXD_AMOUNT_TXDATABITS_Msk |
NFCT_TXD_AMOUNT_TXDATABYTES_Msk));
}
__STATIC_INLINE void nrf_nfct_tx_bits_set(uint16_t tx_bits)
{
NRF_NFCT->TXD.AMOUNT = (tx_bits & (NFCT_TXD_AMOUNT_TXDATABITS_Msk | NFCT_TXD_AMOUNT_TXDATABYTES_Msk));
}
__STATIC_INLINE uint8_t nrf_nfct_rx_frame_config_get(void)
{
return (uint8_t)(NRF_NFCT->RXD.FRAMECONFIG);
}
__STATIC_INLINE void nrf_nfct_rx_frame_config_set(uint8_t flags)
{
NRF_NFCT->RXD.FRAMECONFIG = flags;
}
__STATIC_INLINE uint16_t nrf_nfct_rx_bits_get(bool crc_excluded)
{
uint16_t rx_bits = NRF_NFCT->RXD.AMOUNT & (NFCT_RXD_AMOUNT_RXDATABITS_Msk |
NFCT_RXD_AMOUNT_RXDATABYTES_Msk);
return rx_bits - (crc_excluded ? (8u * NRF_NFCT_CRC_SIZE) : 0);
}
__STATIC_INLINE nrf_nfct_sensres_nfcid1_size_t nrf_nfct_nfcid1_get(uint8_t * p_nfcid1_buf)
{
uint32_t nfcid1_last = NRF_NFCT->NFCID1_LAST;
nrf_nfct_sensres_nfcid1_size_t size =
(nrf_nfct_sensres_nfcid1_size_t)(NRF_NFCT->SENSRES & NFCT_SENSRES_NFCIDSIZE_Msk);
if (size != NRF_NFCT_SENSRES_NFCID1_SIZE_SINGLE)
{
uint32_t nfcid1_2nd_last = NRF_NFCT->NFCID1_2ND_LAST;
if (size == NRF_NFCT_SENSRES_NFCID1_SIZE_TRIPLE)
{
uint32_t nfcid1_3rd_last = NRF_NFCT->NFCID1_3RD_LAST;
*p_nfcid1_buf++ = (uint8_t)(nfcid1_3rd_last >> 16UL);
*p_nfcid1_buf++ = (uint8_t)(nfcid1_3rd_last >> 8UL);
*p_nfcid1_buf++ = (uint8_t)(nfcid1_3rd_last >> 0UL);
}
*p_nfcid1_buf++ = (uint8_t)(nfcid1_2nd_last >> 16UL);
*p_nfcid1_buf++ = (uint8_t)(nfcid1_2nd_last >> 8UL);
*p_nfcid1_buf++ = (uint8_t)(nfcid1_2nd_last >> 0UL);
}
*p_nfcid1_buf++ = (uint8_t)(nfcid1_last >> 24UL);
*p_nfcid1_buf++ = (uint8_t)(nfcid1_last >> 16UL);
*p_nfcid1_buf++ = (uint8_t)(nfcid1_last >> 8UL);
*p_nfcid1_buf++ = (uint8_t)(nfcid1_last >> 0UL);
return size;
}
__STATIC_INLINE void nrf_nfct_nfcid1_set(uint8_t const * p_nfcid1_buf,
nrf_nfct_sensres_nfcid1_size_t nfcid1_size)
{
nrf_nfct_sensres_nfcid1_size_t size = (nfcid1_size == NRF_NFCT_SENSRES_NFCID1_SIZE_DEFAULT) ?
NRF_NFCT_SENSRES_NFCID1_SIZE_DOUBLE : nfcid1_size;
if (size != NRF_NFCT_SENSRES_NFCID1_SIZE_SINGLE)
{
if (size == NRF_NFCT_SENSRES_NFCID1_SIZE_TRIPLE)
{
NRF_NFCT->NFCID1_3RD_LAST = ((uint32_t)p_nfcid1_buf[0] << 16UL) |
((uint32_t)p_nfcid1_buf[1] << 8UL) |
((uint32_t)p_nfcid1_buf[2] << 0UL);
p_nfcid1_buf += 3UL;
}
NRF_NFCT->NFCID1_2ND_LAST = ((uint32_t)p_nfcid1_buf[0] << 16UL) |
((uint32_t)p_nfcid1_buf[1] << 8UL) |
((uint32_t)p_nfcid1_buf[2] << 0UL);
p_nfcid1_buf += 3UL;
}
NRF_NFCT->NFCID1_LAST = ((uint32_t)p_nfcid1_buf[0] << 24UL) |
((uint32_t)p_nfcid1_buf[1] << 16UL) |
((uint32_t)p_nfcid1_buf[2] << 8UL) |
((uint32_t)p_nfcid1_buf[3] << 0UL);
NRF_NFCT->SENSRES = ((NRF_NFCT->SENSRES & ~NFCT_SENSRES_NFCIDSIZE_Msk) |
(uint32_t)size);
}
#if defined (NFCT_AUTOCOLRESCONFIG_MODE_Msk) || defined(__NRFX_DOXYGEN__)
__STATIC_INLINE bool nrf_nfct_autocolres_is_enabled(void)
{
return (NRF_NFCT->AUTOCOLRESCONFIG & NFCT_AUTOCOLRESCONFIG_MODE_Msk) ==
(NFCT_AUTOCOLRESCONFIG_MODE_Enabled << NFCT_AUTOCOLRESCONFIG_MODE_Pos);
}
__STATIC_INLINE void nrf_nfct_autocolres_enable(void)
{
NRF_NFCT->AUTOCOLRESCONFIG =
(NRF_NFCT->AUTOCOLRESCONFIG & ~NFCT_AUTOCOLRESCONFIG_MODE_Msk) |
(NFCT_AUTOCOLRESCONFIG_MODE_Enabled << NFCT_AUTOCOLRESCONFIG_MODE_Pos);
}
__STATIC_INLINE void nrf_nfct_autocolres_disable(void)
{
NRF_NFCT->AUTOCOLRESCONFIG =
(NRF_NFCT->AUTOCOLRESCONFIG & ~NFCT_AUTOCOLRESCONFIG_MODE_Msk) |
(NFCT_AUTOCOLRESCONFIG_MODE_Disabled << NFCT_AUTOCOLRESCONFIG_MODE_Pos);
}
#endif // defined (NFCT_AUTOCOLRESCONFIG_MODE_Msk) || defined(__NRFX_DOXYGEN__)
__STATIC_INLINE nrf_nfct_sensres_nfcid1_size_t nrf_nfct_sensres_nfcid1_size_get(void)
{
return (nrf_nfct_sensres_nfcid1_size_t)(NRF_NFCT->SENSRES & NFCT_SENSRES_NFCIDSIZE_Msk);
}
__STATIC_INLINE void nrf_nfct_sensres_nfcid1_size_set(nrf_nfct_sensres_nfcid1_size_t nfcid1_size)
{
NRF_NFCT->SENSRES = ((NRF_NFCT->SENSRES & ~(NFCT_SENSRES_NFCIDSIZE_Msk)) | (uint32_t)nfcid1_size);
}
__STATIC_INLINE nrf_nfct_sensres_bit_frame_sdd_t nrf_nfct_sensres_bit_frame_sdd_get(void)
{
return (nrf_nfct_sensres_bit_frame_sdd_t)(NRF_NFCT->SENSRES & NFCT_SENSRES_BITFRAMESDD_Msk);
}
__STATIC_INLINE void nrf_nfct_sensres_bit_frame_sdd_set(nrf_nfct_sensres_bit_frame_sdd_t bit_frame_sdd)
{
NRF_NFCT->SENSRES = ((NRF_NFCT->SENSRES & ~(NFCT_SENSRES_BITFRAMESDD_Msk)) | (uint32_t)bit_frame_sdd);
}
__STATIC_INLINE nrf_nfct_sensres_platform_config_t nrf_nfct_sensres_platform_config_get(void)
{
return (nrf_nfct_sensres_platform_config_t)(NRF_NFCT->SENSRES & NFCT_SENSRES_PLATFCONFIG_Msk);
}
__STATIC_INLINE void nrf_nfct_sensres_platform_config_set(nrf_nfct_sensres_platform_config_t platform_config)
{
NRF_NFCT->SENSRES = ((NRF_NFCT->SENSRES & ~(NFCT_SENSRES_PLATFCONFIG_Msk)) | (uint32_t)platform_config);
}
__STATIC_INLINE bool nrf_nfct_selsres_cascade_check(void)
{
return (bool)(NRF_NFCT->SELRES & NFCT_SELRES_CASCADE_Msk);
}
__STATIC_INLINE nrf_nfct_selres_protocol_t nrf_nfct_selsres_protocol_get(void)
{
return (nrf_nfct_selres_protocol_t)((NRF_NFCT->SELRES & NFCT_SELRES_PROTOCOL_Msk) >>
NFCT_SELRES_PROTOCOL_Pos);
}
__STATIC_INLINE void nrf_nfct_selres_protocol_set(nrf_nfct_selres_protocol_t sel_res_protocol)
{
NRF_NFCT->SELRES = (NRF_NFCT->SELRES & ~NFCT_SELRES_PROTOCOL_Msk) |
((uint32_t)sel_res_protocol << NFCT_SELRES_PROTOCOL_Pos);
}
#endif /* SUPPRESS_INLINE_IMPLEMENTATION */
/** @} */
#ifdef __cplusplus
}
#endif
#endif /* NRF_NFCT_H__ */