felica_poller_i.h

#pragma once
 
#include "felica_poller.h"
#include <toolbox/bit_buffer.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define FELICA_POLLER_MAX_BUFFER_SIZE (256U)
 
#define FELICA_POLLER_POLLING_FWT (200000U)
 
// FeliCa spec section 4.4.3: 1 ≤ n ≤ 32
#define FELICA_REQUEST_SERVICE_MAX_NODES (32U)
 
#define FELICA_POLLER_CMD_POLLING_REQ_CODE  (0x00U)
#define FELICA_POLLER_CMD_POLLING_RESP_CODE (0x01U)
 
typedef enum {
    FelicaPollerCommandClassVariable, 
    FelicaPollerCommandClassFixed, 
    FelicaPollerCommandClassMutualAuth,
    FelicaPollerCommandClassRead,
    FelicaPollerCommandClassWrite,
    FelicaPollerCommandClassOther,
} FelicaPollerCommandClass;
 
typedef enum {
    FelicaPollerStateIdle,
    FelicaPollerStateActivated,
    FelicaPollerStateListSystem,
    FelicaPollerStateSelectSystemIndex,
    FelicaPollerStateAuthenticateInternal,
    FelicaPollerStateAuthenticateExternal,
    FelicaPollerStateTraverseStandardSystem,
    FelicaPollerStateReadStandardBlocks,
    FelicaPollerStateReadLiteBlocks,
    FelicaPollerStateReadSuccess,
    FelicaPollerStateReadFailed,
 
    FelicaPollerStateNum
} FelicaPollerState;
 
struct FelicaPoller {
    Nfc* nfc;
    FelicaPollerState state;
    FelicaAuthentication auth;
 
    FelicaData* data;
    BitBuffer* tx_buffer;
    BitBuffer* rx_buffer;
 
    NfcGenericEvent general_event;
    FelicaPollerEvent felica_event;
    FelicaPollerEventData felica_event_data;
    NfcGenericCallback callback;
    uint8_t block_index;
    uint8_t systems_read;
    uint8_t systems_total;
    // IDm/PMm obtained from the initial (wildcard) activation Polling - this is the
    // card's own identity, distinct from whatever System is currently selected via
    // instance->data->idm while traversing. Restored into instance->data on success/
    // failure so the saved/displayed IDm always reflects the card, not the last
    // System visited.
    FelicaIDm card_idm;
    FelicaPMm card_pmm;
    void* context;
};
 
typedef struct {
    uint16_t system_code;
    uint8_t request_code;
    uint8_t time_slot;
} FelicaPollerPollingCommand;
 
typedef struct {
    FelicaIDm idm;
    FelicaPMm pmm;
    uint8_t request_data[2];
} FelicaPollerPollingResponse;
 
typedef union {
    FelicaData* data;
} FelicaPollerContextData;
 
const FelicaData* felica_poller_get_data(FelicaPoller* instance);
 
FelicaError felica_poller_polling(
    FelicaPoller* instance,
    const FelicaPollerPollingCommand* cmd,
    FelicaPollerPollingResponse* resp);
 
FelicaError felica_poller_write_blocks(
    const FelicaPoller* instance,
    const uint8_t block_count,
    const uint8_t* const block_numbers,
    const uint8_t* data,
    FelicaPollerWriteCommandResponse** const response_ptr);
 
FelicaError felica_poller_frame_exchange(
    const FelicaPoller* instance,
    const BitBuffer* tx_buffer,
    BitBuffer* rx_buffer,
    uint32_t fwt);
 
uint32_t felica_poller_get_fwt(
    const FelicaPoller* instance,
    FelicaPollerCommandClass command_class,
    uint8_t units);
 
FelicaError felica_poller_list_service_by_cursor(
    FelicaPoller* instance,
    uint16_t cursor,
    FelicaListServiceCommandResponse** response_ptr);
 
FelicaError felica_poller_list_system_code(
    FelicaPoller* instance,
    FelicaListSystemCodeCommandResponse** response_ptr);
 
FelicaError felica_poller_request_service(
    FelicaPoller* instance,
    const uint16_t* codes,
    uint8_t code_count,
    uint16_t* key_versions_out);
 
#ifdef __cplusplus
}
#endif