5G monitoring - full neighbor scan

General

This feature expands the existing set of statistics which are gathered and reported via MQTT messages by OpenSync as part of the CELLM manager. The newly added statistics contain neighbor cell information of all service providers from a full scan (AT+QSCAN). There are 14 new elements, described in the Northbound API section below.

Northbound API

MQTT reports

A new message has been added to CELLM MQTT reports:

// radio access technology enum RadioAccessTechnology { RADIO_ACCESS_TECHNOLOGY_LTE = 0; RADIO_ACCESS_TECHNOLOGY_NR5G = 1; } message CellFullScanNeighborCell { RadioAccessTechnology rat = 1; uint32 mcc = 2; uint32 mnc = 3; uint32 freq = 4; uint32 pcid = 5; int32 rsrp = 6; int32 rsrq = 7; uint32 srxlev = 8; NrScs scs = 9; int32 squal = 10; uint32 cellid = 11; uint32 tac = 12; Bandwidth bandwidth = 13; uint32 band = 14; }

Full scan neighbor cell messages are reported as part of the existing CellularInfoReport message:

/* Cellular info */ message CellularInfoReport { ... + /* Full scan neighbor cell info */ + repeated CellFullScanNeighborCell full_scan_neigh_cell_info = 12; }

The meaning of all newly added fields is described in the following table:

Name

Type

Description

Name

Type

Description

Name

Type

Description

Name

Type

Description

rat

enum

Radio access technology { “LTE”, “NR5G” }

mcc

uint32

Mobile country code (the first part of PLMN code)

mnc

uint32

Mobile network code (the second part of PLMN code)

freq

uint32

The (EUTRAN) Absolute Radio Frequency Channel Number. EARFCN for LTE or ARFCN for NR5G. Valid range:

  • LTE EARFCN: from 0 to 262,143

  • NR5G ARFCN: from 0 to 3,279,165

pcid

uint32

Physical Cell ID

rsrp

int32

Reference Signal Received Power. Valid range is from -44 dBm to -140 dBm.

rsrq

int32

Reference Signal Received Quality. Valid range is from -3 dB to -20 dB.

srxlev

uint32

Received signal (RX) Level value, in dB, for cell selection.

scs

enum

Sub-carrier spacing value. Only applicable for NR5G.

squal

int32

Received signal Quality value, in dB, for cell selection. Only applicable for LTE.

cellid

uint32

Cell ID. Optional.

tac

uint32

Tracking area code. Optional.

bandwidth

enum

Bandwidth. Optional.

band

uint32

Frequency band. Optional.

Southbound API

5G cellular network scan info is gathered using the existing function osn_cell_read_modem(), so no new Target API functions were added for this feature.