t1_block.h

Go to the documentation of this file.

 
#pragma once
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif

#define T1_INF_MAX 254

#define T1_DEFAULT_IFSC 32

#define T1_LEN_RESERVED 0xFF

typedef enum {
    T1_BLOCK_I,  
    T1_BLOCK_R,  
    T1_BLOCK_S,  
} t1_block_kind_t;

typedef enum {
    T1_R_OK         = 0x00, 
    T1_R_EDC_ERR    = 0x01, 
    T1_R_OTHER_ERR  = 0x02, 
} t1_r_error_t;

typedef enum {
    T1_S_RESYNCH_REQ  = 0x00,
    T1_S_IFS_REQ      = 0x01,
    T1_S_ABORT_REQ    = 0x02,
    T1_S_WTX_REQ      = 0x03,
    T1_S_RESYNCH_RESP = 0x20,
    T1_S_IFS_RESP     = 0x21,
    T1_S_ABORT_RESP   = 0x22,
    T1_S_WTX_RESP     = 0x23,
} t1_s_subtype_t;

typedef struct {
    uint8_t nad;
    uint8_t pcb;
    t1_block_kind_t kind;
    /* I-block fields. */
    uint8_t i_ns;       
    bool    i_more;     
    /* R-block fields. */
    uint8_t r_nr;       
    t1_r_error_t r_err; 
    /* S-block fields. */
    t1_s_subtype_t s_subtype;
    /* Payload. */
    const uint8_t *inf;
    uint8_t inf_len;
    /* EDC validation. */
    bool edc_ok;
    bool use_crc;       
} t1_block_t;

typedef enum {
    T1_OK = 0,
    T1_ERR_SHORT,        
    T1_ERR_LEN,          
    T1_ERR_INF_TOO_BIG,  
    T1_ERR_EDC,          
    T1_ERR_PCB,          
    T1_ERR_OUT_BUF,      
    T1_ERR_NULL,         
} t1_status_t;

uint8_t t1_lrc(const uint8_t *buf, size_t len);

uint16_t t1_crc(const uint8_t *buf, size_t len);

t1_status_t t1_block_encode_i(uint8_t nad, uint8_t ns, bool more,
                              const uint8_t *inf, uint8_t inf_len,
                              bool use_crc,
                              uint8_t *out, size_t out_cap, size_t *out_len);

t1_status_t t1_block_encode_r(uint8_t nad, uint8_t nr, t1_r_error_t err,
                              bool use_crc,
                              uint8_t *out, size_t out_cap, size_t *out_len);

t1_status_t t1_block_encode_s(uint8_t nad, t1_s_subtype_t subtype,
                              const uint8_t *inf, uint8_t inf_len,
                              bool use_crc,
                              uint8_t *out, size_t out_cap, size_t *out_len);

t1_status_t t1_block_decode(const uint8_t *buf, size_t buf_len, bool use_crc,
                            t1_block_t *out);
 
#ifdef __cplusplus
}
#endif