maki/openairinterface5g
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Reorganize and document nr_neighbour_cell_t structure

Browse Source 
- Add comprehensive documentation header explaining the structure's role
  as single source of truth for neighbor cell information across multiple
  protocols (NGAP/XnAP handover, measurement config, DU validation, SIB3/SIB4)

- Add detailed field comments documenting protocol-specific mappings:
  * Core identification fields (gNB_ID, nrcell_id, physicalCellId)
  * Frequency/RF parameters (absoluteFrequencySSB, subcarrierSpacing, band)
  * Handover target identification (plmn, tac)

- Document NGAP/XnAP IE mappings for plmn and tac fields
This commit is contained in:
Guido Casati
2026-04-10 10:22:50 +02:00
parent 4569ef199d
commit da7054092a
1 changed files with 17 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
openair2/RRC/NR/nr_rrc_defs.h
+17
View File
@@ -378,14 +378,31 @@ typedef struct {
nr_neighbour_cell_sib4_freq_t freq_cfg; nr_neighbour_cell_sib4_freq_t freq_cfg;
} nr_inter_freq_cfg_t; } nr_inter_freq_cfg_t;
/** @brief Neighbor cell configuration structure
* Single source of truth for neighbor cell information, used across multiple protocols/scopes:
* - Handover (NGAP/XnAP): for target gNB (ID, plmn, tac, nrcell_id, physicalCellId)
* - Measurement (MeasConfig): physicalCellId, absoluteFrequencySSB, band
* - DU validation: all fields validated against actual cell information
* - SIB3/SIB4 generation: physicalCellId, absoluteFrequencySSB, subcarrierSpacing, band
* References:
* - 3GPP TS 38.331 (RRC) for SIB3/SIB4 and MeasConfig
* - 3GPP TS 38.413 (NGAP) / TS 38.423 (XnAP) for target cell identification */
typedef struct { typedef struct {
// gNB identifier (for target node in NGAP/XnAP handover)
uint32_t gNB_ID; uint32_t gNB_ID;
// NR Cell Global Identifier (for NGAP/XnAP handover, DU validation)
uint64_t nrcell_id; uint64_t nrcell_id;
// Physical Cell ID (PCI) (used in HandoverPreparationInformation and MeasObjectNR)
int physicalCellId; int physicalCellId;
// SSB absolute frequency (ARFCN) (for MeasObjectNR, intra/inter-frequency determination)
int absoluteFrequencySSB; int absoluteFrequencySSB;
// SSB subcarrier spacing (for MeasObjectNR/SIB4)
int subcarrierSpacing; int subcarrierSpacing;
// Frequency band indicator (for MeasObjectNR/SIB4)
int band; int band;
// PLMN identity (for target node in NGAP/XnAP handover)
plmn_id_t plmn; plmn_id_t plmn;
// Tracking Area Code (for target node in NGAP/XnAP handover)
uint32_t tac; uint32_t tac;
// SIB3 (intra-frequency neighbor cell-specific offsets) // SIB3 (intra-frequency neighbor cell-specific offsets)
nr_neighbour_cell_sib3_t sib3; nr_neighbour_cell_sib3_t sib3;