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

Paging (F1AP): add F1 paging library (9.2.6.1 3GPP TS 38.473)

Browse Source 
Add F1AP Paging library and new message type to follow the existing F1AP
library pattern and to support multi-cell paging and both RAN UE (I-RNTI)
and CN UE (5G-S-TMSI) paging identities at the library level per TS 38.473.

* New library (f1ap_paging.c/h, f1ap_lib_includes.h, CMakeLists.txt)
  - Implement encode/decode/copy/eq/free for F1AP Paging (procedure 9.2.6).
  - Add ASN.1 includes for Paging, PagingIdentity, CN/RAN UE identities.
  - Enables unit testing of Paging enc/dec in f1ap_lib_test.c.

* New types in f1ap_messages_types.h (existing f1ap_paging_ind_t unchanged)
  - f1ap_paging_t: UE Identity Index, paging identity (union + type enum),
    optional paging_drx, paging_priority, paging_origin, and paging_cells[].
  - f1ap_paging_cell_item_t, f1ap_paging_identity_type_t, f1ap_paging_identity_t
    for multi-cell list and RAN/CN identity discrimination.
  - Paging Origin IE is optional per F1AP 8.7.1.2.

Tests: test_f1ap_paging() roundtrip and copy for CN UE (5G-S-TMSI) and
RAN UE (I-RNTI) cases, with optional IEs.
This commit is contained in:
Guido Casati
2026-02-17 12:25:58 +01:00
parent b026e6b4ee
commit 08f0f9369c
7 changed files with 541 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
openair2/F1AP/tests/f1ap_lib_test.c
+75
View File
@@ -44,6 +44,7 @@
#include "lib/f1ap_interface_management.h"
#include "lib/f1ap_ue_context.h"
#include "lib/f1ap_positioning.h"
#include "lib/f1ap_paging.h"
void exit_function(const char *file, const char *function, const int line, const char *s, const int assert)
{
@@ -2383,6 +2384,79 @@ static void test_f1ap_positioning_measurement_update()
printf("%s() successful\n", __func__);
}
/** @brief Test F1 Paging encode/decode roundtrip and copy operations */
static void test_f1ap_paging_rt(f1ap_paging_t *orig)
{
F1AP_F1AP_PDU_t *f1enc = encode_f1ap_paging(orig);
F1AP_F1AP_PDU_t *f1dec = f1ap_encode_decode(f1enc);
f1ap_msg_free(f1enc);
f1ap_paging_t decoded = {0};
bool ret = decode_f1ap_paging(&decoded, f1dec);
AssertFatal(ret, "decode_f1ap_paging(): could not decode message\n");
f1ap_msg_free(f1dec);
ret = eq_f1ap_paging(orig, &decoded);
AssertFatal(ret, "eq_f1ap_paging(): decoded message doesn't match\n");
free_f1ap_paging(&decoded);
f1ap_paging_t cp = cp_f1ap_paging(orig);
ret = eq_f1ap_paging(orig, &cp);
AssertFatal(ret, "eq_f1ap_paging(): copied message doesn't match\n");
free_f1ap_paging(&cp);
}
/** @brief Test F1 Paging encoding/decoding */
static void test_f1ap_paging(void)
{
// Test with CN UE Paging Identity (5G-S-TMSI)
{
f1ap_paging_t orig = {0};
orig.ue_identity_index_value = 123;
orig.identity_type = F1AP_PAGING_IDENTITY_CN_UE;
orig.identity.cn_ue_paging_identity = 0x1234567890AB;
orig.drx = malloc_or_fail(sizeof(*orig.drx));
*orig.drx = F1AP_PAGING_DRX_32;
orig.n_cells = 2;
orig.cells = calloc_or_fail(orig.n_cells, sizeof(*orig.cells));
orig.cells[0].plmn.mcc = 208;
orig.cells[0].plmn.mnc = 95;
orig.cells[0].plmn.mnc_digit_length = 2;
orig.cells[0].nr_cellid = 123456;
orig.cells[1].plmn.mcc = 208;
orig.cells[1].plmn.mnc = 93;
orig.cells[1].plmn.mnc_digit_length = 2;
orig.cells[1].nr_cellid = 789012;
test_f1ap_paging_rt(&orig);
free_f1ap_paging(&orig);
}
// Test with RAN UE Paging Identity (I-RNTI)
{
f1ap_paging_t orig = {0};
orig.ue_identity_index_value = 456;
orig.identity_type = F1AP_PAGING_IDENTITY_RAN_UE;
orig.identity.ran_ue_paging_identity = 0x1234567890;
orig.drx = NULL;
orig.priority = malloc_or_fail(sizeof(*orig.priority));
*orig.priority = F1AP_PAGING_PRIO_LEVEL3;
orig.origin = malloc_or_fail(sizeof(*orig.origin));
*orig.origin = F1AP_PAGING_ORIGIN_NON_3GPP;
orig.n_cells = 1;
orig.cells = calloc_or_fail(orig.n_cells, sizeof(*orig.cells));
orig.cells[0].plmn.mcc = 1;
orig.cells[0].plmn.mnc = 1;
orig.cells[0].plmn.mnc_digit_length = 2;
orig.cells[0].nr_cellid = 987654;
test_f1ap_paging_rt(&orig);
free_f1ap_paging(&orig);
}
printf("%s() successful\n", __func__);
}
int main()
{
test_initial_ul_rrc_message_transfer();
@@ -2427,5 +2501,6 @@ int main()
test_f1ap_positioning_measurement_abort();
test_f1ap_positioning_measurement_failure_indication();
test_f1ap_positioning_measurement_update();
test_f1ap_paging();
return 0;
}