Configuration Reference

The srsRAN Project gNB application uses a YAML (.yml) configuration file.

The gNB comes with a number of example configuration files, these can be found in srsRAN_Project/configs/ in the source code:

These configuration file examples provide a basic set-up to get users up and running, users can easily modify these to suit their use-case.

More example configuration files for various use cases can be found here.


Format

All configuration parameters are presented here below in the following format:

parameter
  • Optional/Required TYPE (default). Description. Format: format description. Supported: supported values.


Configuration Parameters

gnb_id
  • Optional UINT (411). Sets the numerical ID associated with the gNB.

gnb_id_bit_length
  • Optional UNIT. Sets the bit length of the gnb_id above. Format: integer between [22 - 32]

ran_node_name
  • Optional TEXT (srsgnb01). Sets the text ID associated with the gNB. Format: string without spaces.

cells
  • Optional TEXT. Sets the cell configuration on a per cell basis, overwriting the default configuration defined by cell_cfg. Contains a list of cells, each with parameters that overwrite the default config. This can only be set via the configuration file. For more information see the relevant example configuration file gnb_custom_cell_properties.yml.

Note

Currently only single cell configuration is support, multi-cell support is expected to be added in the coming months.

qos
  • Optional TEXT. Configures RLC and PDCP radio bearers on a per 5QI basis. This can only be set via the configuration file.

slicing
  • Optional TEXT. Configure network slicing options. This can only be set via the configuration file. May contain the following parameters:

    • sst: Optional UINT (1). Sets the Slice Service Type. Supported: [0 - 255].

    • sd: Optional UINT (0). Sets the Service Differentiator. Supported: [0-16777215].

amf

addr
  • Required TEXT. Sets the IP address or hostname of the AMF. Format: IPV4 or IPV6 IP address.

port
  • Optional UINT (38412). Sets the AMF port. Format: integer between [20000 - 40000].

bind_addr
  • Required TEXT. Sets the local IP address that the gNB binds to for receiving traffic from the AMF. Format: IPV4 or IPV6 IP address.

sctp_rto_initial
  • Optional INT. Sets the initial retransmission timeout when creating the SCTP connection.

sctp_rto_min
  • Optional INT. Sets the minimum retransmission timeout for the SCTP connection.

sctp_rto_max
  • Optional INT. Sets the maximum retransmission timeout for the SCTP connection.

sctp_initial_max_attempts
  • Optional INT. Sets the maximum retransmission attempts for the initial SCTP connection.

sctp_max_init_timeo
  • Optional INT. Sets the maximum retransmission timeout for the initial SCTP connection.

no_core
  • Optional BOOLEAN (0). Setting to true allows the gNB to run without a core. Supported: [0, 1].

e2

enable_du_e2
  • Optional BOOLEAN (0). Enables the DU E2 agent. Supported: [0, 1].

addr
  • Optional TEXT. Sets the RIC IP address.

port
  • Optional UINT (36421). Sets the RIC Port. Supported: [20000 - 40000].

bind_addr
  • Optional TEXT. Sets the local IP address to bind for RIC connection. Supported: IPv4 address.

sctp_rto_initial
  • Optional INT. Sets the initial retransmission timeout when creating the SCTP connection.

sctp_rto_min
  • Optional INT. Sets the minimum retransmission timeout for the SCTP connection.

sctp_rto_max
  • Optional INT. Sets the maximum retransmission timeout for the SCTP connection.

sctp_initial_max_attempts
  • Optional INT. Sets the maximum retransmission attempts for the initial SCTP connection.

sctp_max_init_timeo
  • Optional INT. Sets the maximum retransmission timeout for the initial SCTP connection.

e2sm_kpm_enabled
  • Optional BOOLEAN (0). Enabled the E2SM KPM service module. Supported: [0, 1].

cu_cp

inactivity_timer
  • Optional INT (7200). Sets the UE/PDU Session/DRB inactivity timer in seconds. Supported: [1 - 7200].

mobility
  • Further optional parameters to configure Mobility.

  • trigger_handover_from_measurements: Optional BOOLEAN (0). Sets whether or not to start HO if neighbor cells become stronger. Supported: [0, 1].

  • cells: Optional TEXT. Sets the list of cells known to the CU-CP, their configs (if not provided over F1) and their respective neighbor cells.

    • nr_cell_id: Required UINT. The ID of this serving cell.

    • periodic_report_cfg_id: Optional UINT. The periodical report configuration to use for this serving cell.

    • ncells: Required TEXT. List of neighbor cells.

      • nr_cell_id: Required UINT. The ID of this neighbor cell.

      • report_configs: Required TEXT. List of report configurations to use for measurements of this neighbor cell.

    • gnb_id: Optional UINT. The ID of this gNB.

    • ssb_arfcn: Optional UINT. The SSB ARFCN of this serving cell. Must be present if not provided over F1.

    • band: Optional UINT. The NR band of this serving cell cell. Must be present if not provided over F1.

    • ssb_scs: Optional UINT. The SSB subcarrier spacing of this serving cell in KHz. Must be present if not provided over F1.

    • ssb_period: Optional UINT. The SSB period of this serving cell in ms. Must be present if not provided over F1.

    • ssb_offset: Optional UINT. The SSB offset of this serving cell. Must be present if not provided over F1.

    • ssb_duration: Optional UINT. The SSB duration of this serving cell in subframes. Must be present if not provided over F1.

  • report_configs: Optional TEXT. Sets the list of report congfigurations to dynamically build a measurement configuration sent to the UEs using the below values.

    • report_cfg_id: Required UINT. The ID of this report configuration.

    • report_type: Required TEXT. The type of the report. Supported: [event_triggered, periodical]. Note that periodical reports are only supported for serving cells.

    • report_interval_ms: Optional UINT (1024). The report interval in ms.

    • a3_report_type: Optional TEXT. A3 report type. Supported: [rsrp, rsrq, sinr].

    • a3_offset_db: Optional UINT. A3 offset in dB used for measurement report trigger.

    • a3_hysteresis_db: Optional UINT. A3 hysteresis in dB used for measurement report trigger.

    • a3_time_to_trigger_ms: Optional UINT. Time in ms during which A3 condition must be met before measurement report trigger.

rrc
  • Further optional parameters to configure the RRC.

  • force_reestablishment_fallback: Optional BOOLEAN (0). Force RRC re-establishment fallback to RRC setup. Supported: [0, 1].

ru_sdr

This section of the configuration file should be used when connecting the srsRAN Project gNB to a USRP using split 8 interface.

srate
  • Required FLOAT (61.44). Sets the sampling rate of the RF-frontend in MHz.

device_driver
  • Required TEXT (uhd). RF device driver name. Supported: [uhd, zmq].

device_args
  • Optional TEXT. An argument that gets passed to the selected RF driver.

tx_gain
  • Required FLOAT (50). Sets the transmit gain in dB. Supported: [0 - max value supported by radio].

rx_gain
  • Required FLOAT (60). Sets the receive gain in dB. Supported: [0 - max value supported by radio].

freq_offset
  • Optional FLOAT (0). Sets the frequency offset in Hertz.

clock_ppm
  • Optional FLOAT (0). Sets the clock calibration in Parts Per Million (PPM).

lo_offset
  • Optional FLOAT (0). Shifts the local oscillator frequency in MHz away from the center frequency to move LO leakage out of the channel.

clock
  • Optional TEXT (default). Specify the RF device source for timestamping. Supported: [default, internal, external, gpsdo].

sync
  • Optional TEXT (default). Specify the RF device oscillator reference synchronization source. Supported: [default, internal, external, gpsdo].

otw_format
  • Optional TEXT (default). Specific the over-the-wire format. Supported: [default, sc8, sc12, sc16].

time_alignment_calibration
  • Optional TEXT (auto). Compensates for any reception and transmission time misalignment inherent to the RF device. Positive values reduce the RF transmission delay with respect to the RF reception. Negative values have the opposite effect.

cells
  • Optional TEXT. Sets the hardware specific cell configuration on a per cell basis. May contain the following parameters:

    • amplitude_control

      • tx_gain_backoff: Optional FLOAT (12.0). Sets baseband gain back-off in dB. This accounts for the signal PAPR and is applied regardless of clipping settings. Format: positive float.

      • enable_clipping: Optional BOOL (false). Sets clipping of the baseband samples on or off. If enabled, samples that exceed the power ceiling are clipped.

      • power_ceiling_dBFs: Optional FLOAT (-0.1). Sets the power ceiling in dB, relative to the full scale amplitude of the radio. Format: negative float or 0.

expert_cfg
  • Further optional parameters to configure RF-frontend.

    • low_phy_thread_profile: Optional TEXT. Lower physical layer executor profile. Supported: [single, dual, quad].

    • low_phy_dl_throttling: Optional FLOAT (0). Throttles the lower PHY DL baseband generation. Setting to 0 disables throttling. Supported: any value in the range [0 - 1].

ru_ofh

This section of the configuration file should be used when connecting the srsRAN Project gNB to an O-RAN RU using split 7.2 interface.

Note

Many of the following values are optional as they have default values. In practice, all of the following parameters should be defined by the user, as they will need to be configured specifically for the RU being used. Failing to configure this parameters correctly may result in the RU failing to connect correctly to the DU.

gps_alpha
  • Optional FLOAT (0). Sets the GPS alpha. Supported: [0 - 1.2288e+07].

gps_beta
  • Optional INT (0). Sets the GPS beta. Supported: [-32768 - +32767].

enable_dl_parallelization
  • Optional BOOLEAN (1). Sets the Open Fronthaul downlink parallelization flag. Supported: [0 - 1].

ru_bandwidth_MHz
  • Required UINT (0). Sets the channel bandwidth in MHz. Supported: [5,10,15,20,25,30,40,50,60,70,80,90,100].

t1a_max_cp_dl
  • Optional INT (500). Sets T1a maximum value for downlink control-plane. Supported: [0 - 1960].

t1a_min_cp_dl
  • Optional INT (258). Sets T1a minimum value for downlink control-plane. Supported: [0 - 1960].

t1a_max_cp_ul
  • Optional INT (500). Sets T1a maximum value for uplink control-plane. Supported: [0 - 1960].

t1a_min_cp_ul
  • Optional INT (258). Sets T1a minimum value for uplink control-plane. Supported: [0 - 1960].

t1a_max_up
  • Optional INT (300).Sets T1a maximum value for uer-plane. Supported: [0 - 1960].

t1a_min_up
  • Optional INT (85). Sets T1a minimum value for user-plane. Supported: [0 - 1960].

is_prach_cp_enabled
  • Optional BOOLEAN (0). Sets PRACH control-plane enabled flag. Supported: [0, 1].

is_dl_broadcast_enabled
  • Optional BOOLEAN (0). Sets downlink broadcast enabled flag. Supported: [0, 1].

ignore_ecpri_payload_size
  • Optional BOOLEAN (0). Sets whether or not to ignore eCPRI payload size field value. Supported [0. 1].

compr_method_ul
  • Optional TEXT (bfp). Sets the uplink compression method. Supported: [none, bfp, bfp selective, block scaling, mu law, modulation, modulation selective].

compr_bitwidth_ul
  • Optional UINT (9). Sets the uplink compression bit width. Supported: [1 - 16].

compr_method_dl
  • Optional TEXT (bfp). Sets the downlink compression method. Supported: [none, bfp, bfp selective, block scaling, mu law, modulation, modulation selective].

compr_bitwidth_dl
  • Optional UINT (9). Sets the downlink compression bit width. Supported: [1 - 16].

compr_method_prach
  • Optional TEXT (none). Sets the PRACH compression method. Supported: [none, bfp, bfp selective, block scaling, mu law, modulation, modulation selective].

compr_bitwidth_prach
  • Optional UINT (16). Sets the PRACH compression bit width. Supported [1 - 16].

enable_ul_static_compr_hdr
  • Optional BOOLEAN (1). Uplink static compression header enabled flag. Supported: [0 . 1].

enable_dl_static_compr_hdr
  • Optional BOOLEAN (1). Downlink static compression header enabled flag. Supported: [0 . 1].

iq_scaling
  • Optional FLOAT (0.35). Sets the IQ scaling factor. Supported: [0 - 1].

cells
  • Optional TEXT. Sets the hardware specific cell configuration on a per cell basis. May contain the following parameters:

    • network_interface: Optional TEXT (“enp1s0f0”). Sets the ethernet network interface name for the RU. Format: a string, e.g. [“interface_name”].

    • ru_mac_address: Optional TEXT (“70:b3:d5:e1:5b:06”). Sets the RU MAC address. Format: a string, e.g. [“AA:BB:CC:DD:11:22:33”].

    • du_mac_address: Optional TEXT (“00:11:22:33:00:77”). Sets the DU MAC address. Format: a string, e.g. [“AA:BB:CC:DD:11:22:33”].

    • vlan_tag: Optional UINT (1). Sets the V-LAN tag control information field. Supported: [1 - 4094].

    • ru_prach_port_id: Optional UINT (4). Sets the RU PRACH eAxC port ID. Supported: [0 - 65535].

    • ru_dl_port_id: Optional UINT (0, 1). Sets the RU downlink eAxC port ID. Format: vector containing all DL eXaC ports, e.g. [0, …, N].

    • ru_ul_port_id: Optional UINT (0). Sets the RU uplink eAxC port ID. Supported: [0 - 65535].

cell_cfg

This is the default configuration that will be inherited by all cells, overwritten in the cells list.

pci
  • Required UINT (1). Sets the Physical Cell ID. Supported: [0-1007].

dl_arfcn
  • Required UINT (536020). Sets the Downlink ARFCN.

band
  • Optional TEXT (auto). Sets the NR band being used for the cell. If not specified, will be set automatically based on ARFCN. Supported: all release 17 bands.

common_scs
  • Required UINT (15). Sets the subcarrier spacing in KHz to be used by the cell. Supported: [15, 30].

channel_bandwidth_MHz
  • Required UINT (20). Sets the channel Bandwidth in MHz, the number of PRBs will be derived from this. Supported: [5, 10, 15, 20, 25, 30, 40, 50, 60, 70, 80, 90, 100].

nof_antennas_ul
  • Optional UINT (1). Sets the number of antennas for downlink transmission. Supported: [4].

nof_antennas_dl
  • Optional UINT (1). Sets the number of antennas for uplink transmission. Supported: [4].

plmn
  • Required TEXT (00101). Sets the Public Land Mobile Network code. Format: 7-digit PLMN code containing MCC & MNC.

tac
  • Required UINT (7). Sets the Tracking Area Code.

q_rx_lev_min
  • Optional INT (-70). Sets the required minimum received RSRP level for cell selection/re-selection, in dBm. Supported: [-70 - -22].

q_qual_min
  • Optional INT (-20). Sets the required minimum received RSRQ level for cell selection/re-selection, in dB. Supported: [-43 - -12].

pcg_p_nr_fr1
  • Optional INT (10). Sets the maximum total TX power to be used by the UE in this NR cell group across in FR1. Supported: [-30 - +23].

ssb
  • Further optional parameters to configure the Synchronization Signal Block of the cell.

    • ssb_period: Optional UINT (10). Sets the period of SSB scheduling in milliseconds. Supported: [5, 10, 20].

    • ssb_block_power_dbm: Optional INT (-16). Sets the SS PBCH block power in dBm. Supported: [-60 - +50].

    • pss_to_sss_epre_db: Optional UINT (0). Sets the Synchronization Signal Block Primary Synchronization Signal to Secondary Synchronization Signal Energy Per Resource Element ratio in dB. Supported: [0, 3].

ul_common
  • Further optional parameters to configure the common uplink parameters of the cell.

    • p_max: Optional TEXT. Sets maximum transmit power allowed in this serving cell. Supported: [-30 - +23].

pdcch
  • Further optional parameters to configure the Physical Downlink Control Channel of the cell.

    • common

      • coreset0_index: Optional INT. Sets the CORESET 0 index. Supported: [0 - 15].

      • ss1_n_candidates: Optional UINT ({0, 0, 1, 0, 0}). Sets the number of PDCCH candidates per aggregation level for SearchSpace#1. Supported: any 5 value array containing the following UINT values [0, 1, 2, 3, 4, 5, 6, 7, 8].

      • ss0_index: Optional UINT (0). Sets the SearchSpace#0 index. Supported: [0 - 15].

    • dedicated

      • coreset1_rb_start: Optional INT (0). Sets the starting common resource block (CRB) number for CORESET 1, relative to CRB0. Supported: [0 - 275].

      • coreset1_l_crb: Optional INT (Across entire BW of cell). Sets the length of CORESET 1 in number of CRBs. Supported: [0 - 275].

      • coreset1_duration: Optional INT (2). Sets the duration of CORESET 1 in number of OFDM symbols. Supported: [1 - 2].

      • ss2_n_candidates: Optional UINT ({0, 0, 0, 0, 0}). Sets the number of PDCCH candidates per aggregation level for SearchSpace#2. Supported: any 5 value array containing the following UINT values [0, 1, 2, 3, 4, 5, 6, 7, 8].

      • dci_format_0_1_and_1_1: Optional BOOLEAN (1). Sets whether to use non-fallback or fallback DCI format in UE SearchSpace#2. Supported: [0, 1].

      • ss2_type: Optional TEXT (ue_dedicated). Sets the SearchSpace type for UE dedicated SearchSpace#2. Supported: [common, ue_dedicated].

pdsch
  • Further optional parameters to configure the Physical Downlink Shared Channel of the cell.

    • min_ue_mcs: Optional UINT. Sets a minimum PDSCH MCS value to be used for all UEs. Supported: [0 - 28].

    • max_ue_mcs: Optional UINT. Sets a maximum PDSCH MCS value to be used for all UEs. Supported: [0 - 28].

    • fixed_rar_mcs: Optional UINT (0). Sets a fixed RAR MCS value for all UEs. Supported: [0 - 28].

    • fixed_sib1_mcs: Optional UINT (5). Sets a fixed SIB1 MCS for all UEs. Supported: [0 - 28].

    • nof_harqs: Optional UNIT (16). Sets the number of Downlink HARQ processes. Supported [2, 4, 6, 8, 10, 12, 16]

    • max_consecutive_kos: Optional UINT (100). Sets the maximum number of consecutive HARQ-ACK KOs before an RLF is reported. Supported: [0 - inf]

    • rv_sequence: Optional UINT (0,2,3,1). Sets the redundancy version sequence to use for PDSCH. Supported: any combination of [0, 1, 2, 3].

    • mcs_table: Optional TEXT (qam64). Sets the MCS table to use for PDSCH. Supported: [qam64, qam256].

    • nof_ports: Optional TEXT (auto). Sets the number of ports for PDSCH. By default it is set to be equal to number of DL antennas Supported: [1, 2, 4].

pusch
  • Further optional parameters to configure the Physical Uplink Shared Channel of the cell.

    • min_ue_mcs: Optional UINT. Sets a minimum PUSCH MCS value to be used for all UEs. Supported: [0 - 28].

    • max_ue_mcs: Optional UINT. Sets a maximum PUSCH MCS value to be used for all UEs. Supported: [0 - 28].

    • max_consecutive_kos: Optional UINT (100). Sets the maximum number of consecutive CRC KOs before an RLF is reported. Supported: [0 - inf]

    • rv_sequence: Optional UINT (0). Sets the redundancy version sequence to use for PUSCH. Supported: any combination of [0, 1, 2, 3].

    • mcs_table: Optional TEXT (qam64). Sets the MCS table to use for PDSCH. Supported: [qam64, qam256].

    • msg3_delta_preamble: Optional INT (6). Sets the MSG3 DeltaPreamble power offset between MS3 and RACH preamble transmission. Supported: [-1 - 6].

    • p0_nominal_with_grant: Optional INT (-76). Sets the P0 value for PUSCH grant (except MSG3), in dBm. Supported: multiples of 2 within the range [-202, 24].

    • msg3_delta_power: Optional INT (8). Sets the target power level at the network receiver side, in dBm. Supported: multiples of 2 within the range [-6, 8].

    • b_offset_ack_idx_1: Optional UINT (9). Sets the betaOffsetACK-Index1 part of UCI-OnPUSCH. Supported: [0 - 31].

    • b_offset_ack_idx_2: Optional UINT (9). Sets the betaOffsetACK-Index2 part of UCI-OnPUSCH. Supported: [0 - 31].

    • b_offset_ack_idx_3: Optional UINT (9). Sets the betaOffsetACK-Index3 part of UCI-OnPUSCH. Supported: [0 - 31].

    • beta_offset_csi_p1_idx_1: Optional UINT (9). Sets the b_offset_csi_p1_idx_1 part of UCI-OnPUSCH. Supported: [0 - 31].

    • beta_offset_csi_p1_idx_2: Optional UINT (9). Sets the b_offset_csi_p1_idx_2 part of UCI-OnPUSCH. Supported: [0 - 31].

    • beta_offset_csi_p2_idx_1: Optional UINT (9). Sets the b_offset_csi_p2_idx_1 part of UCI-OnPUSCH. Supported: [0 - 31].

    • beta_offset_csi_p2_idx_2: Optional UINT (9). Sets the b_offset_csi_p2_idx_2 part of UCI-OnPUSCH. Supported: [0 - 31].

pucch
  • Further optional parameters to configure the Physical Uplink Control Channel of the cell.

    • p0_nomial: Optional UINT (-90). Sets the power control parameter P0 for PUCCH transmissions in dBm. Supported: multiples of 2 and within the [-202, 24] interval.

    • sr_period_ms: Optional UINT (40). Sets the SR period in milliseconds. Supported: [1,2,4,8,10,16,20,40,80,160,320].

    • f1_nof_ue_res_harq: Optional UINT (3). Sets the number of PUCCH F1 resources available per UE for HARQ. Supported: [1 - 8].

    • f1_nof_cells_res_sr: Optional UINT (2). Sets the number of PUCCH F1 resources available per cell for SR. Supported: [1 - 10].

    • f1_nof_symbols: Optional UINT (14). Sets the number of symbols for PUCCH F1 resources. Supported: [4 - 14].

    • f1_enable_occ: Optional BOOLEAN (0). Enables OCC for PUCCH F1. Supported: [0, 1].

    • f1_nof_cyclic_shifts: Optional UINT (1). Sets the number of possible cyclic shifts available for PUCCH F1 resources. Supported: [1,2,3,4,6,12].

    • f1_intraslot_freq_hop: Optional BOOLEAN (0). Enables intra-slot frequency hopping for PUCCH F1. Supported: [0, 1].

    • nof_cell_harq_pucch_res_sets: Optional UINT (1). Sets the number of separate PUCCH resource sets for HARQ-ACK that are available in the cell. The higher the number of sets, the lower the chances UEs have to share the same PUCCH resources. Supported: [1 - 10].

    • f2_nof_ue_res_harq: Optional UINT (6). Sets the number of PUCCH F2 resources available per UE for HARQ. Supported: [1 - 8].

    • f2_nof_cells_res_csi: Optional UINT (1). Sets the number of PUCCH F2 resources available per cell for CSI. Supported: [1 - 10].

    • f2_nof_symbols: Optional UINT (2). Sets the number of symbols for PUCCH F2 resources. Supported: [1 - 2].

    • f2_max_nof_rbs: Optional UINT (1). Sets the max number of RBs for PUCCH F2 resources. Supported: [1 - 16].

    • f2_max_payload: Optional INT. Sets the max number of payload bits for PUCCH F2 resources. Supported [1 - 11].

    • f2_max_code_rate: Optional TEXT (dot35). Sets the PUCCH F2 max code rate. Supported: [dot08, dot15, dot25, dot35, dot45, dot60, dot80].

    • f2_intraslot_freq_hop: Optional BOOLEAN (0). Enables intra-slot frequency hopping for PUCCH F2. Supported: [0, 1].

prach
  • Further optional parameters to configure the Physical Random Access Channel of the cell.

    • prach_config_index: Optional UINT (1). Sets the PRACH configuration index. Supported: [0 - 255].

    • prach_root_sequence_index: Optional UINT (1). Sets the PRACH Roost Sequence Index (RSI), which determines the Zadoff-Chu (ZC) sequence used. Supported: [0 - 837]. If the PRACH configuration index is larger than 86, you cannot set a PRACH RSI of more than 137.

    • zero_correlation_zone: Optional UINT (0). Sets the Zero Correlation Zone, which determines the size of the cyclic shift and the number of preamble sequences which can be generated from each Root Sequence Index. Supported: [0 - 15].

    • fixed_msg3_mcs: Optional UINT (0). Sets a fixed Msg3 MCS. Supported: [0 - 28].

    • max_msg3_harq_retx: Optional UINT (4). Sets the maximum number of Msg3 HARQ retransmissions. Supported: [0 - 4].

    • total_nof_ra_preambles: Optional TEXT. Sets the number of different PRACH preambles. Supported: [1 - 64].

    • prach_frequency_start: Optional INT. Set Offset of lowest PRACH transmission occasion in frequency domain respective to PRB 0, in PRBs. Supported: [0 - (MAX_NOF_PRB - 1)].

    • preamble_rx_target_pw: Optional INT (-100). Sets the Target power level at the network receiver side, in dBm. Supported: multiples of 2 within range [-202, -60].

tdd_ul_dl_cfg
  • Further optional parameters to configure the TDD Uplink and Downlink configuration parameters.

    • dl_ul_tx_period: Optional INT (10). Sets the TDD pattern periodicity in slots. The combination of this value and the chosen numerology must lead to a TDD periodicity of 0.5, 0.625, 1, 1.25, 2, 2.5, 3, 4, 5 or 10 milliseconds. Supported: [2 - 80].

    • nof_dl_slots: Optional INT (6). Number of consecutive full Downlink slots. Supported: [0-80].

    • nof_dl_symbols: Optional INT (0). Number of Downlink symbols at the beginning of the slot following full Downlink slots. Supported: [0-13].

    • nof_ul_slots: Optional INT (3). Number of consecutive full Uplink slots. Supported: [0 - 80].

    • nof_ul_symbols: Optional INT (0). Number of Uplink symbols at the end of the slot preceding the first full Uplink slot. Supported: [0-13].

    • pattern2

      • dl_ul_tx_period: Optional INT (10). Sets the TDD pattern periodicity in slots. The combination of this value and the chosen numerology must lead to a TDD periodicity of 0.5, 0.625, 1, 1.25, 2, 2.5, 3, 4, 5 or 10 milliseconds. Supported: [2 - 80].

      • nof_dl_slots: Optional INT (6). Number of consecutive full Downlink slots. Supported: [0-80].

      • nof_dl_symbols: Optional INT (0). Number of Downlink symbols at the beginning of the slot following full Downlink slots. Supported: [0-13].

      • nof_ul_slots: Optional INT (3). Number of consecutive full Uplink slots. Supported: [0 - 80].

      • nof_ul_symbols: Optional INT (0). Number of Uplink symbols at the end of the slot preceding the first full Uplink slot. Supported: [0-13].

paging
  • Further optional parameters to configure the paging configuration parameters.

    • pg_search_space_id: Optional UINT (1). Sets the SearchSpace to use for Paging. Supported: [0, 1].

    • default_pg_cycle_in_rf: Optional UINT (128). Sets the default Paging cycle in nof. Radio Frames. Supported: [32,64,128,256].

    • nof_pf_per_paging_cycle: Optional TEXT (oneT). Sets the number of paging frames per DRX cycle. Supported: [oneT, halfT, quarterT, oneEighthT, oneSixteethT].

    • pf_offset: Optional UINT (0). Sets the paging frame offset. Supported: [0 - (nof_pf_per_paging_cycle - 1)].

    • nof_po_per_pf: Optional UINT (1). Sets the number of paging occasions per paging frame. Supported: [1, 2, 4].

csi
  • Further optional parameters to configure the CSI configuration parameters.

    • csi_rs_period: Optional UINT (80). Sets the CSI-RS period in milliseconds. Supported: [10, 20, 40, 80].

    • meas_csi_rs_slot_offset: Optional UINT (2). Sets the slot offset of first CSI-RS resource used for measurement.

    • tracking_csi_rs_slot_offset: Optional UINT (12). Sets the slot offset of the first CSI-RS slot used for tracking.

    • pwr_ctrl_offset: Optional INT (0). Sets the power offset of PDSCH RE to NZP CSI-RS RE in dB. Supported: [-8 - 15].

log

All gNB layers and components can be configured independently to output at various levels of detail. Logs can be configured to the following levels (from lowest to highest levels of detail):

  • none

  • error

  • warning

  • info

  • debug

filename
  • Optional TEXT (/tmp/gnb.log). File path for logs.

all_level
  • Optional TEXT (warning). Sets a common log level across PHY, MAC, RLC, PDCP, RRC, SDAP, NGAP and GTPU layers.

phy_level
  • Optional TEXT (warning). Sets PHY log level.

mac_level
  • Optional TEXT (warning). Sets MAC log level.

rlc_level
  • Optional TEXT (warning). Sets RLC log level.

pdcp_level
  • Optional TEXT (warning). Sets PDCP log level.

rrc_level
  • Optional TEXT (warning). Sets RRC log level.

sdap_level
  • Optional TEXT (warning). Sets SDAP log level.

ngap_level
  • Optional TEXT (warning). Sets NGAP log level.

gtpu_level
  • Optional TEXT (warning). Sets GTPU log level.

radio_level
  • Optional TEXT (info). Sets radio log level.

fapi_level
  • Optional TEXT (warning). Sets FAPI log level.

ofh_level
  • Optional TEXT (warning). Sets Open Fronthaul log level.

f1ap_level
  • Optional TEXT (warning). Sets F1AP log level.

f1u_level
  • Optional TEXT (warning). Sets F1u log level.

du_level
  • Optional TEXT (warning). Sets DU log level.

cu_level
  • Optional TEXT (warning). Sets CU log level.

sec_level
  • Optional TEXT (warning). Sets security functions level.

lib_level
  • Optional TEXT (warning). Sets generic log level.

hex_max_size
  • Optional UINT (0). Sets maximum number of bytes to print for hex messages. Supported: [0 - 1024].

broadcast_enabled
  • Optional BOOL (false). Enables logging in the PHY and MAC layer of broadcast messages and all PRACH opportunities.

phy_rx_symbols_filename
  • Optional TEXT. Print received symbols to file. Symbols will be printed if a valid path is set. Format: file path.

tracing_filename
  • Optional TEXT. Set to a valid file name to enable tracing log.

pcap

ngap_enable
  • Optional BOOL (false). Enable/disable NGAP packet capture.

ngap_filename
  • Optional TEXT (/tmp/gnb_ngap.pcap). Path for NGAP PCAPs.

mac_enable
  • Optional BOOL (false). Enable/disable MAC packet capture.

mac_filename
  • Optional TEXT (/tmp/gnb_mac.pcap). Path for MAC PCAPs.

e1ap_enable
  • Optional BOOL (false). Enable/disable E1AP packet capture.

e1ap_filename
  • Optional TEXT (/tmp/gnb_e1ap.pcap). Path for E1AP PCAPs.

f1ap_enable
  • Optional BOOL (false). Enable/disable F1AP packet capture.

f1ap_filename
  • Optional TEXT (/tmp/gnb_f1ap.pcap). Path for F1AP PCAPs.

e2ap_enable
  • Optional BOOL (false). Enable/disable E2AP packet capture.

e2ap_filename
  • Optional TEXT (/tmp/gnb_e2ap.pcap). Path for E1AP PCAPs.

expert_phy

max_proc_delay
  • Optional INT (2). Sets the maximum allowed DL processing delay in slots. Supported: [1 - 30].

nof_pdsch_threads
  • Optional UINT (1). Sets the number of threads for encoding PDSCH. Default value of one for no concurrency acceleration in the PDSCH encoding. Format: Positive integer greater than 0.

nof_ul_threads
  • Optional UINT (4). Sets number of upper PHY threads to process uplink. It is set to 4 by default unless the available hardware concurrency is limited in which case will use a minimum of one thread.

nof_dl_threads
  • Optional UINT (1). Sets number of upper PHY threads to process downlinklink.

pusch_dec_max_iterations
  • Optional UINT (6). Sets the number of PUSCH LDPC decoder iterations. Format: Positive integer greater than 0.

pusch_dec_enable_early_stop
  • Optional BOOL (true). Enables the PUSCH decoder early stopping mechanism.

buffer_pool

nof_segments
  • Optional UINT (524288). Sets the number of segments allocated by the buffer pool.

segment_size
  • Optional UINT (1024). Sets the size of each buffer pool segment in bytes.

test_mode

test_ue
  • Optional command to generate automatically created UE for testing purposes

    • rnti: Optional ENUM (0). Sets the C-RNTI of the UE. Supported: [0 - 65519].

    • pdsch_active: Optional BOOLEAN (1). Enables the PDSCH of the UE.

    • pusch_active: Optional BOOLEAN (1). Enables the PUSCH of the UE.

    • cqi: Optional UINT (15). Sets the Channel Quality Information to be forwarded to the test UE. Supported: [1 - 15].

    • pmi: Optional UINT (0). Sets the Precoder Matrix Indicator to be forwarded to test UE. Supported: [0 - 3].

    • ri: Optional UINT (1). Sets the Rank Indicator to be forwarded to the test UE. Supported: [1 - 4].

    • i_1_1: Optional INT (0). Sets the Precoder Matrix codebook index “i_1_1” to be forwarded to test UE, in the case of more than 2 antennas. Supported: [0 - 7].

    • i_1_3: Optional INT (0). Sets the Precoder Matrix codebook index “i_1_3” to be forwarded to test UE, in the case of more than 2 antennas. Supported: [0 - 1].

    • i_2: Optional INT (0). Sets the Precoder Matrix codebook index “i_2” to be forwarded to test UE, in the case of more than 2 antennas. Supported: [0 - 3].

expert

enable_tuned_affinity_profile
  • Optional BOOLEAN (0). Enables usage of tuned affinity profile. Supported: [0, 1].

number_of_threads_per_cpu
  • Optional UINT (2). Sets the number of threads per physcial CPU. Supported [1 - 2].

number_of_reserved_cored
  • Optional UINT (4). Sets the number of CPU cores reserved for non-priority tasks. Supported: [1 - 1024].