Merge remote-tracking branch 'origin/nr_ue_sib19_ta' into integration_2025_w50 (!3638)

NR UE: calculate TA based on SIB19 information in NTN mode, if autonomous TA is not enabled

To achieve the goal, the hyper frame number (HFN) is introduced at the NR UE
PHY, MAC and RRC layers.

Besides this, we also implemented an orbit propagation to improve the accuracy
of N_UE_TA_adj, and a fix to keep the N_TA from RAR and MAC CE.

Fixes #981

openair2/COMMON/mac_messages_types.h

@@ -121,6 +121,7 @@ typedef struct RrcMacBcchDataInd_s {
 } RrcMacBcchDataInd;
 
 typedef struct NRRrcMacBcchDataInd_s {
+  uint32_t  hfn;
   uint32_t  frame;
   uint8_t   slot;
   uint32_t  sdu_size;
@@ -134,6 +135,7 @@ typedef struct NRRrcMacBcchDataInd_s {
 } NRRrcMacBcchDataInd;
 
 typedef struct NRRrcMacSBcchDataInd_s {
+  uint32_t  hfn;
   uint32_t  frame;
   uint8_t   slot;
   uint32_t  sdu_size;

openair2/COMMON/rrc_messages_types.h

@@ -438,6 +438,7 @@ typedef struct rrc_subframe_process_s {
 } RrcSubframeProcess;
 
 typedef struct nrrrc_frame_process_s {
+  int hfn;
   int frame;
   int gnb_id;
 } NRRrcFrameProcess;
@@ -475,6 +476,8 @@ typedef struct {
 typedef struct {
   NR_CellGroupConfig_t *cellGroupConfig;
   NR_UE_NR_Capability_t *UE_NR_Capability;
+  int hfn;
+  int frame;
 } nr_mac_rrc_config_cg_t;
 typedef struct {
   NR_BCCH_BCH_Message_t *bcch;
@@ -487,6 +490,8 @@ typedef struct {
 } nr_mac_rrc_config_sib1_t;
 typedef struct {
   NR_SIB19_r17_t *sib19;
+  int hfn;
+  int frame;
   bool can_start_ra;
 } nr_mac_rrc_config_other_sib_t;