st25r3911b_nfca.h

Go to the documentation of this file.

/*
 * Copyright (c) 2019 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
 
#ifndef ST25R3911B_NFCA_H_
#define ST25R3911B_NFCA_H_
 
#include <zephyr/kernel.h>
#include <zephyr/types.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define ST25R3911B_NFCA_EVENT_CNT 2
 
#define ST25R3911B_NFCA_CRC_LEN 2
 
#define ST25R3911B_NFCA_NFCID1_MAX_LEN 10
 
#define ST25R3911B_NFCA_ERR_CRC 1
#define ST25R3911B_NFCA_ERR_PARITY 2
#define ST25R3911B_NFCA_ERR_FRAMING 3
#define ST25R3911B_NFCA_ERR_SOFT_FRAMING 4
#define ST25R3911B_NFCA_ERR_HARD_FRAMING 5
#define ST25R3911B_NFCA_ERR_LAST_BYTE_INCOMPLETE 6
#define ST25R3911B_NFCA_ERR_TRANSMISSION 7
 
enum st25r3911b_nfca_tag_type {
        ST25R3911B_NFCA_TAG_TYPE_T2T,
        ST25R3911B_NFCA_TAG_TYPE_T4T,
        ST25R3911B_NFCA_TAG_TYPE_NFCDEP,
        ST25R3911B_NFCA_TAG_TYPE_T4T_NFCDEP,
        ST25R3911B_NFCA_TAG_TYPE_T1T
};
 
enum st25r3911b_nfca_detect_cmd {
        ST25R3911B_NFCA_DETECT_CMD_ALL_REQ,
        ST25R3911B_NFCA_DETECT_CMD_SENS_REQ
};
 
struct st25r3911b_nfca_buf {
        uint8_t *data;
 
        size_t len;
};
 
struct st25r3911b_nfca_sens_resp {
        uint8_t anticollison;
 
        uint8_t platform_info;
};
 
struct st25r3911b_nfca_tag_info {
        enum st25r3911b_nfca_tag_type type;
 
        struct st25r3911b_nfca_sens_resp sens_resp;
 
        uint8_t sel_resp;
 
        uint8_t nfcid1_len;
 
        uint8_t nfcid1[ST25R3911B_NFCA_NFCID1_MAX_LEN];
 
        bool sleep;
};
 
struct st25r3911b_nfca_crc {
        uint8_t crc[ST25R3911B_NFCA_CRC_LEN];
};
 
struct st25r3911b_nfca_cb {
        void (*field_on)(void);
 
        void (*field_off)(void);
 
        void (*tag_detected)(const struct st25r3911b_nfca_sens_resp *sens_resp);
 
        void (*anticollision_completed)(const struct st25r3911b_nfca_tag_info *tag_info,
                                        int err);
 
        void (*transfer_completed)(const uint8_t *data, size_t len, int err);
 
        void (*rx_timeout)(bool tag_sleep);
 
        void (*tag_sleep)(void);
};
 
int st25r3911b_nfca_init(struct k_poll_event *events, uint8_t cnt,
                          const struct st25r3911b_nfca_cb *cb);
 
int st25r3911b_nfca_field_on(void);
 
int st25r3911b_nfca_field_off(void);
 
int st25r3911b_nfca_tag_detect(enum st25r3911b_nfca_detect_cmd cmd);
 
int st25r3911b_nfca_anticollision_start(void);
 
int st25r3911b_nfca_transfer(const struct st25r3911b_nfca_buf *tx,
                             const struct st25r3911b_nfca_buf *rx,
                             uint32_t fdt, bool auto_crc);
 
static inline int st25r3911b_nfca_transfer_with_crc(const struct st25r3911b_nfca_buf *tx,
                                                    const struct st25r3911b_nfca_buf *rx,
                                                    uint32_t fdt)
{
        return st25r3911b_nfca_transfer(tx, rx, fdt, true);
}
 
static inline int st25r3911b_nfca_transfer_without_crc(const struct st25r3911b_nfca_buf *tx,
                                                       const struct st25r3911b_nfca_buf *rx,
                                                       uint32_t fdt)
{
        return st25r3911b_nfca_transfer(tx, rx, fdt, false);
}
 
int st25r3911b_nfca_tag_sleep(void);
 
int st25r3911b_nfca_crc_calculate(const uint8_t *data, size_t len,
                                  struct st25r3911b_nfca_crc *crc_val);
 
int st25r3911b_nfca_process(void);
 
 
#ifdef __cplusplus
}
#endif
 
#endif /* ST25R3911B_NFCA_H_ */