rte_checksum.h

Go to the documentation of this file.

 
#ifndef RTE_CHECKSUM_H
#define RTE_CHECKSUM_H
 
#include <stdint.h>
#include <stddef.h>
#include "rte/utils/status/rte_status.h"
#include "rte/utils/types/rte_types.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* ============================================================================
 * Types & Constants
 * ========================================================================== */

typedef enum {
    RTE_CRC64_ERTMS,

    RTE_CRC64_ISO,

    RTE_CRC64_XZ
} rte_crc64_polynomial_t;

typedef uint64_t rte_crc64_t;

typedef struct {
    rte_crc64_t computed;  
    rte_crc64_t expected;  
    uint8_t match;          
} rte_checksum_result_t;
 
/* ============================================================================
 * API: CRC-64 Computation
 * ========================================================================== */

rte_status_t rte_checksum_crc64_init(rte_crc64_polynomial_t polynomial);

rte_crc64_t rte_checksum_crc64(const uint8_t *data, size_t size);

rte_status_t rte_checksum_crc64_verify(const uint8_t *data,
                                         size_t size,
                                         rte_crc64_t expected_crc,
                                         rte_checksum_result_t *result_out);

rte_crc64_polynomial_t rte_checksum_crc64_get_polynomial(void);
 
/* ============================================================================
 * API: Vital Channel Data Wrapper
 * ========================================================================== */

typedef struct {
    uint32_t sequence_number;  
    uint32_t sender_id;        
    uint32_t timestamp_ms;     
    uint8_t  payload_size;     
    uint8_t  padding;          
    uint16_t reserved;         
 
    uint8_t  payload[248];     
    rte_crc64_t crc64;        
} rte_vital_message_t;

rte_status_t rte_checksum_vital_message_create(
    rte_vital_message_t *msg_out,
    uint32_t sender_id,
    uint32_t sequence,
    const uint8_t *payload,
    size_t payload_size
);

rte_status_t rte_checksum_vital_message_verify(
    const rte_vital_message_t *msg,
    uint32_t expected_sequence,
    uint8_t *payload_out,
    size_t payload_max_size,
    uint8_t *payload_size_out
);
 
/* ============================================================================
 * API: Statistics & Diagnostics
 * ========================================================================== */

typedef struct {
    uint32_t total_checksums;       
    uint32_t verification_passes;   
    uint32_t verification_failures; 
    uint32_t sequence_errors;       
    uint32_t payload_oversize;      
} rte_checksum_stats_t;

rte_status_t rte_checksum_get_stats(rte_checksum_stats_t *stats_out);

rte_status_t rte_checksum_reset_stats(void);
 
#ifdef __cplusplus
}
#endif

 
#endif /* RTE_CHECKSUM_H */