ab_gp_ertms_train_packets.h

Go to the documentation of this file.

 
#ifndef AB_GP_ERTMS_TRAIN_PACKETS_H
#define AB_GP_ERTMS_TRAIN_PACKETS_H
 
#include "../ab_gp_ertms_types.h"
 
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define RBC_MAX_GRADIENT_SEGMENTS 8U
#define RBC_MAX_SPEED_SEGMENTS    8U
#define RBC_MAX_LINKING_ITEMS     8U
#define RBC_MAX_TSR_ITEMS         4U
#define RBC_MAX_TEXT_MESSAGE_LEN  128U
 
/* ========================================================================= */
/* Standard ETCS Packet Numbers (NID_PACKET)                                 */
/* ========================================================================= */
#define RBC_PACKET_0_POSITION_REPORT           0U
#define RBC_PACKET_1_POSITION_REPORT_2BG       1U
#define RBC_PACKET_3_NATIONAL_VALUES           3U
#define RBC_PACKET_5_LINKING_INFO              5U
#define RBC_PACKET_12_LEVEL_2_3_MA             12U
#define RBC_PACKET_15_LEVEL_2_3_MA_SSP         15U
#define RBC_PACKET_21_GRADIENT_PROFILE         21U
#define RBC_PACKET_27_STATIC_SPEED_PROFILE     27U
#define RBC_PACKET_41_LEVEL_TRANSITION_ORDER   41U
#define RBC_PACKET_57_MA_REQUEST_PARAMS        57U
#define RBC_PACKET_58_POSITION_REPORT_PARAMS   58U
#define RBC_PACKET_65_TEMPORARY_SPEED_RESTRICT 65U
#define RBC_PACKET_66_TSR_REVOCATION           66U
#define RBC_PACKET_72_TEXT_MESSAGE             72U
#define RBC_PACKET_131_RBC_TRANSITION_ORDER    131U
 
/* ========================================================================= */
/* Packet 0: Position Report (Train -> RBC)                                  */
/* Subset-026 Section 7.4.2.1 / 8.4.4.4                                      */
/* ========================================================================= */
typedef struct rbc_packet_0_position_report_s
{
    rbc_q_scale_t   q_scale;       
    rbc_nid_lrbg_t  nid_lrbg;      
    rbc_distance_m_t d_lrbg;       
    rbc_q_dirlrbg_t q_dirlrbg;     
    rbc_q_dlrbg_t   q_dlrbg;       
    uint32_t        l_doubtover;   
    uint32_t        l_doubtunder;  
    rbc_speed_kmh_t v_train;       
    rbc_m_mode_t    m_mode;        
    rbc_m_level_t   m_level;       
} rbc_packet_0_position_report_t;
 
/* ========================================================================= */
/* Packet 1: Position Report based on two balise groups (Train -> RBC)       */
/* Subset-026 Section 7.4.3.2 - extension of Packet 0 for a single balise    */
/* group with unknown LRBG orientation: adds NID_PRVLRBG (a second BG,       */
/* used only as a directional reference for the rest of the packet's own    */
/* fields). A reduced field subset relative to Packet 0 below (nid_lrbg,     */
/* d_lrbg, v_train, m_mode, m_level - no q_scale/q_dirlrbg/q_dlrbg/          */
/* l_doubtover/l_doubtunder of its own) plus this one extra field -         */
/* used by GP for the post-EoM idle heartbeat (ab_gp_proc_dispatch.c's own  */
/* handle_msg_136()), where the LRBG's own orientation is genuinely no      */
/* longer being actively tracked, matching this packet's real-world intent. */
/* ========================================================================= */
typedef struct rbc_packet_1_position_report_2bg_s
{
    rbc_nid_lrbg_t  nid_lrbg;      
    rbc_nid_lrbg_t  nid_prvlrbg;   
    rbc_distance_m_t d_lrbg;       
    rbc_speed_kmh_t v_train;       
    rbc_m_mode_t    m_mode;        
    rbc_m_level_t   m_level;       
} rbc_packet_1_position_report_2bg_t;
 
/* ========================================================================= */
/* Packet 3: National Values (RBC -> Train)                                  */
/* Subset-026 Section 7.4.2.3                                                */
/* ========================================================================= */
typedef struct rbc_packet_3_national_values_s
{
    rbc_speed_kmh_t v_nvshunt;     
    rbc_speed_kmh_t v_nvstff;      
    rbc_speed_kmh_t v_nvunfit;     
    uint16_t        t_nvcontact;   
    uint16_t        d_nvroll;      
} rbc_packet_3_national_values_t;
 
/* ========================================================================= */
/* Packet 5: Linking Information (RBC -> Train)                              */
/* Subset-026 Section 7.4.2.5                                                */
/* ========================================================================= */
typedef struct rbc_linking_item_s
{
    rbc_nid_bg_t    nid_bg;        
    rbc_distance_m_t d_link;       
    rbc_q_dir_t     q_linkdir;     
} rbc_linking_item_t;
 
typedef struct rbc_packet_5_linking_s
{
    uint8_t            link_count;
    rbc_linking_item_t links[RBC_MAX_LINKING_ITEMS];
} rbc_packet_5_linking_t;
 
/* ========================================================================= */
/* Packet 12/15: Movement Authority (RBC -> Train)                           */
/* Subset-026 Section 7.4.2.11 / 7.4.2.14                                    */
/* ========================================================================= */
typedef struct rbc_packet_15_ma_s
{
    uint32_t         ma_seq;        
    rbc_distance_m_t ma_length;     
    rbc_speed_kmh_t  v_loa;         
    uint32_t         t_loa_s;       
    bool             has_section_timer;
    uint32_t         t_section_s;   
    rbc_distance_m_t d_sectiontimerstoploc; 
} rbc_packet_15_ma_t;
 
/* ========================================================================= */
/* Packet 21: Gradient Profile (RBC -> Train)                                */
/* Subset-026 Section 7.4.2.18                                               */
/* ========================================================================= */
typedef struct rbc_gradient_segment_s
{
    rbc_distance_m_t       d_gradient; 
    rbc_gradient_permille_t g_a;       
} rbc_gradient_segment_t;
 
typedef struct rbc_packet_21_gradient_profile_s
{
    uint8_t                segment_count;
    rbc_gradient_segment_t segments[RBC_MAX_GRADIENT_SEGMENTS];
} rbc_packet_21_gradient_profile_t;
 
/* ========================================================================= */
/* Packet 27: Static Speed Profile - SSP (RBC -> Train)                      */
/* Subset-026 Section 7.4.2.22                                               */
/* ========================================================================= */
typedef struct rbc_speed_segment_s
{
    rbc_distance_m_t d_static;      
    rbc_speed_kmh_t  v_static;      
    rbc_q_front_t    q_front;       
} rbc_speed_segment_t;
 
typedef struct rbc_packet_27_ssp_s
{
    uint8_t             segment_count;
    rbc_speed_segment_t segments[RBC_MAX_SPEED_SEGMENTS];
} rbc_packet_27_ssp_t;
 
/* ========================================================================= */
/* Packet 41: Level Transition Order (RBC -> Train)                          */
/* Subset-026 Section 7.4.2.32                                               */
/* ========================================================================= */
typedef struct rbc_packet_41_level_transition_s
{
    rbc_m_level_t    m_leveltr;     
    rbc_nid_ntc_t    nid_ntc;       
    rbc_distance_m_t d_leveltr;     
    rbc_distance_m_t l_ackleveltr;  
} rbc_packet_41_level_transition_t;
 
/* ========================================================================= */
/* Packet 57: MA Request Parameters (RBC -> Train)                           */
/* Subset-026 Section 7.4.2.44                                               */
/* ========================================================================= */
typedef struct rbc_packet_57_ma_request_params_s
{
    uint32_t         t_mar_s;       
    rbc_distance_m_t d_mar_m;       
} rbc_packet_57_ma_request_params_t;
 
/* ========================================================================= */
/* Packet 58: Position Report Parameters (RBC -> Train)                      */
/* Subset-026 Section 7.4.2.45                                               */
/* ========================================================================= */
typedef struct rbc_packet_58_pr_params_s
{
    uint32_t         t_cycloc_s;    
    rbc_distance_m_t d_cycloc_m;    
} rbc_packet_58_pr_params_t;
 
/* ========================================================================= */
/* Packet 65: Temporary Speed Restriction (RBC -> Train)                     */
/* Subset-026 Section 7.4.2.49                                               */
/* ========================================================================= */
typedef struct rbc_packet_65_tsr_s
{
    rbc_nid_tsr_t    nid_tsr;       
    rbc_distance_m_t d_tsr;         
    rbc_distance_m_t l_tsr;         
    rbc_speed_kmh_t  v_tsr;         
    rbc_q_front_t    q_front;       
} rbc_packet_65_tsr_t;
 
/* ========================================================================= */
/* Packet 66: TSR Revocation (RBC -> Train)                                  */
/* Subset-026 Section 7.4.2.50                                               */
/* ========================================================================= */
typedef struct rbc_packet_66_tsr_revoke_s
{
    rbc_nid_tsr_t nid_tsr;          
} rbc_packet_66_tsr_revoke_t;
 
/* ========================================================================= */
/* Packet 72: Plain Text Message to Driver DMI (RBC -> Train)                */
/* Subset-026 Section 7.4.2.54                                               */
/* ========================================================================= */
typedef struct rbc_packet_72_text_message_s
{
    bool     ack_required;
    uint32_t duration_s;
    char     text[RBC_MAX_TEXT_MESSAGE_LEN];
} rbc_packet_72_text_message_t;
 
/* ========================================================================= */
/* Packet 131: RBC Transition Order (RBC -> Train)                          */
/* Subset-026 Section 7.4.2.27                                               */
/* ========================================================================= */
typedef struct rbc_packet_131_rbc_transition_s
{
    rbc_distance_m_t d_rbctr;           
    uint16_t         nid_c;             
    uint16_t         nid_rbc;           
    uint64_t         nid_radio;         
    bool             q_sleepingsession; 
} rbc_packet_131_rbc_transition_t;
 
#ifdef __cplusplus
}
#endif
 
#endif /* RBC_TRAIN_PACKETS_H */