@NTUST
# Use RIC Test to simulate multi cells
:::success
- Goal:
- [x] [Simulate suburban area and urban area](#41-Cell)
- [x] [Simulate multi cells Scenario (cell: 90, Macro: 18, Micro: 72)](#41-Cell)
- [x] [Simulate multi UE (UE: 50)](#42-UE)
- [x] [Simulate UE moving form urban area to suburban area](#42-UE)
- Reference:
- TeraVM RIC Test User Guide
- [Macrocell v.s. Microcell](https://lup.lub.lu.se/luur/download?func=downloadFile&recordOId=8929515&fileOId=8937348)
:::
[TOC]
## 1. General Information
### 1.1 Introduction
The purpose for this note is use RIC Test to generate multi cells scenario. Use the data from scenario to reach energy efficiency
### 1.2 Why do I need to do this?
The traffic load varies in the mobile network over the daytime, or even on different days of the week. It is related to the users’ mobility and behavior, e.g., on weekdays people work in the city, thus BSs are highly loaded starting from the morning until the afternoon. On the other hand, a lot of people have their homes in the suburbs, thus BSs deployed therein remain almost empty until the late afternoon. This creates an opportunity to switch off either entire cells to provide energy savings.
I want to use the RIC Test to simulate multi-cells and separate the area into urban area and suburban area

### 1.3 What will you find in this note
1. Scenario
2. How to use RIC Test to create the scenario
3. RIC Test result and data
## 2. Scenario
### 2.1 Cell
| Cell type | Amount |
| ---------------- | ------ |
| Urban macro-cell | 9 |
| Urban micro-cell | 36 |
| Suburban macro-cell | 9 |
| Suburban micro-cell | 36 |
#### Macrocell v.s. Microcell
- Macrocell
A macrocell is a large cell in a cellular network that covers a wide geographical area, typically several kilometers.
- Microcell
A microcell is a small cell in a cellular network that covers a limited geographical area, typically less than a few hundred meters.

### 2.2 UE
Simulate 50 UEs can moving from urban to suburban in the evening and moving from suburban to urban in the morning
## 3. How to use RIC Test to create the scenario
### 3.1 Scenario
Scenario is used to config number of gNBs, sites and some detail for area and building.
- Number of gNBs => number of CU
- Number of sites => number of DU

### 3.2 Cells Configuration
- Different kind of cell
RIC Test can create many cell. For the figure, I create four cells for Urban macro cell, urban micro cell, suburban mucro cell and suburban micro cell.

- Config the detail for cell
We can config the area for the cell and the TX power, Height etc.

### 3.3 UE Groups
We can config three type (indoor, pedestrian, car) for UE. We can adjust the service like slice and QoS. We also can adjust the position and mobility for UE

## 4. Simulation result for multi cells
### 4.1 Cell
Cells in north site are urban cell, macro for gray, micro for orange
Cells in sourth site are suburban cells macro for blue, micro for green

### 4.2 UE
:::info
UE: 
Urban micro-cell: 
Urban macro-cell: 
Suburban micro-cell: 
Suburban macro-cell: 
:::
For first figure below, we can see UEs are in an urban area initially. Second figure shows that for a while, UE started to move to suburban area


## 5. Simulation data results
### 5.1 Data can be sent from RIC Test to SMO via O1
- Cell Metric
| Parameter | description | Unit |
| -------------------------- | ---------------------------------------------------------------------------------------------------- | -------------------- |
| DRB.UEThpDl | Average downlink throughput | Gbps |
| DRB.UEThpUl | Average uplink throughput | Gbps |
| RRU.PrbUsedDl | Mean downlink Physical Resource Blocks (PRBs) used for data traffic | N/A |
| RRU.PrbUsedUl | Mean uplink Physical Resource Blocks (PRBs) used for data traffic | N/A |
| RRU.PrbAvailDl | Maximum number of Physical Resource Blocks (PRBs) available for downlink | N/A |
| RRU.PrbAvailUl | Maximum number of Physical Resource Blocks (PRBs) available for uplink | N/A |
| RRU.PrbTotUl | Total usage (in percentage) of Physical Resource Blocks (PRBs) on the uplink for any purpose | % |
| RRU.PrbTotDl | Total usage (in percentage) of Physical Resource Blocks (PRBs) on the downlink for any purpose | % |
| RRC.ConnMean | Mean number of UEs in RRC connected mode | N/A |
| RRC.ConnMax | Maximum number of UEs in RRC connected mode | N/A |
| QosFlow.TotPdcpPduVolumeUl | Uplink data volume (PDCP PDU) delivered from gNB-DU to gNB-CU | Mbits |
| QosFlow.TotPdcpPduVolumeDl | Downlink data volume (PDCP PDU) delivered from gNB-CU to gNB-DU | Mbits |
| PEE.AvgPower | Average power consumed over the measurement period | watts (W) |
| PEE.Energy | Energy consumed | kilowatt-hours (khW) |
| Viavi.PEE.EnergyEfficiency | Energy efficiency | bit per joule |
| Viavi.Radio.power | Cell's configured Tx power | dBm |
| Viavi.Radio.antennaType | Antenna type | N/A |
| Viavi.Radio.azimuth | Antenna azimuth | degrees |
| Viavi.Geo.x | Cartesian position of the cell site / UE | meters |
| Viavi.Geo.y | Cartesian position of the cell site / UE | meters |
| Viavi.Geo.z | Cartesian position of the cell site / UE | meters |
| Viavi.QoS.Score | | |
| Viavi.NrPci | NR PCI | N/A |
| Viavi.NrCgi | NR CGI (Cell Global Identity) 60 bits concatenating PLMN ID (24 bits) and NR Cell ID (lower 36 bits) | N/A |
| RRU.MaxLayerDlMimo | Average maximum scheduled layer number under MIMO scenario in DL | N/A |
| CARR.AverageLayersDl |Average value of scheduled MIMO layers per PRB on the DL|N/A |
| Viavi.Cell.AverageBeamsDl |Average number of active beams on the DL in a simulation interval. Maximum value is the total number of beams in the mMIMO cell.|N/A |
| Viavi.GnbDuId |DU ID of the E2 Node managing a cell|N/A |
| RRC.ConnEstabAtt.mo-Data |Number of attempted UE RRC connections to the cell by "mobile oriented data" cause.|N/A |
| RRC.ConnEstabAtt.mo-VoiceCall |Number of attempted UE RRC connections to the cell by "mobile oriented voice call" cause.|N/A |
| RRC.ConnEstabAtt.mo-VideoCall |Number of attempted UE RRC connections to the cell by "mobile oriented video call" cause.|N/A |
| RRC.ConnEstabSucc.mo-Data |Number of successful UE RRC connections to the cell by "mobile oriented data" cause.|N/A |
| RRC.ConnEstabSucc.mo-VoiceCall |Number of successful UE RRC connections to the cell by "mobile oriented voice call" cause.|N/A |
| RRC.ConnEstabSucc.mo-VideoCall | Number of successful UE RRC connections to the cell by "mobile oriented video call" cause. |N/A |
| RRC.ConnEstabFailCause.NetworkReject |Number of failed UE RRC connections to the cell refused by the network.|N/A |
| Viavi.isEnergySaving | |
- UE Metric
| Parameter | description | Unit |
| --------------- | ------------------------------------------------------------------- | ---- |
| Viavi.UE.Rsrp | UE's RSRP from the serving cell | dBm |
| Viavi.UE.Rsrq | UE's RSRQ from the serving cell | dB |
| Viavi.UE.RsSinr | UE's RS-SINR from the serving cell | dB |
| RRU.PrbUsedUl | Mean uplink Physical Resource Blocks (PRBs) used for data traffic | N/A |
| RRU.PrbUsedDl | Mean downlink Physical Resource Blocks (PRBs) used for data traffic | N/A |
| DRB.UEThpUl | Average uplink throughput | Gbps |
| DRB.UEThpDl | Average downlink throughput | Gbps |
| TB.TotNbrUl | Total number of uplink Transport Blocks (TBs) | N/A |
| TB.TotNbrDl | Total number of downlink Transport Blocks (TBs) | N/A |
| DRB.UECqiUl | UE's uplink CQI | N/A |
| DRB.UECqiDl | UE's downlink CQI | N/A |
### 5.2 Energy efficiency parameter
| O-RAN Spec (O-RAN.WG1.NESUC-R003-v02.00) | RIC TEST |
| -------------------------------------------------------- | -------------------------------------------------------------------- |
| Cell characteristics | Antenna type, Antenna azimuth |
| Energy efficiency/Energy Consumption measurement reports | PEE.Energy, PEE.AvgPower |
| Load statistics per cell | DRB.UEThpDl/Ul, RRU.PrbUsedDl/Ul, RRU.PrbAvailDl/Ul, RRU.PrbToDl/Ul |
| RSRP | Viavi.UE.Rsrp |
| RSRQ | Viavi.UE.Rsrq |
| SINR | Viavi.UE.RsSinr |
## 6. Problem we want to solve
RIC Test Energy Efficiency license(TVM6215) provide energy usage information. We can use it to monitor the enrgy usage for each cell. For the figure below, we can see some of cell have high power usage, some of cell have low usage.
We can design mechanism to shut down the cell have low power to reach energy efficiency.

## 7. Configuration file and run the test
**Import a configuration:**
Go to ``RAN Scenario Generator`` -> ``Global Settings``.
Press ``Import config...``

**Configuration Content:**
```bash=
Anomalies:
PCI_Conflict:
candidate_cells: Only neighbors
frequencies:
- 700
- 1900
- 3600
max_conflict_size: 2
max_distance: 0
max_reused_pcis: 0
min_distance: 0
Radio_Anomalies: []
Cells:
Advanced_RF_Models:
- antennaModel:
type: Isotropic
name: Isotropic-Rural
scenario: RMa
ueHeight: 1.5
- antennaModel:
beamWidth: 45
gain: 0
type: Cosine
name: Cosine-Rural
scenario: RMa
ueHeight: 1.5
- antennaModel:
beamWidth: 45
gain: 0
type: Cosine
name: Cosine-Urban
scenario: UMa-Buildings
ueHeight: 1.5
- antennaModel:
beamConf:
nBeams: 3
type: Auto
gain: 0
type: 3GPP
name: mMIMO-Urban
scenario: UMa-Buildings
ueHeight: 1.5
- antennaModel:
beamConf:
digitalAzimuth: -60,0,60
digitalTilt: 0,15,30
horizontalBeamWidth: 30,30,30
type: Manual
verticalBeamWidth: 15,15,15
beamType: SSB
gain: 0
groupId: 1
type: CustomBeamGroup
name: SSB Beam Group 1
scenario: UMa-Buildings
ueHeight: 1.5
Advanced_Traffic_Models:
- amcModel: Shannon
frame: UL|DL|DL|DL|DL|DL|DL|DL|DL|DL|
multiplexing:
dlBandwidth: 90
dlOffset: -5
type: TDD
ulBandwidth: 5
ulOffset: 45
name: TDD
numHarqProcs: 10
schedAlgorithm: Proportional Fairness
- amcModel: Shannon
frame: UL|DL|DL|DL|DL|DL|DL|DL|DL|DL|
multiplexing:
dlBandwidth: 10
dlCentralFrequency: 0
dlOffset: -5
type: FDD
ulBandwidth: 5
ulCentralFrequency: 0
ulOffset: 7
name: FDD-DL-10
numHarqProcs: 10
schedAlgorithm: Proportional Fairness
- amcModel: Shannon
frame: UL|DL|DL|DL|DL|DL|DL|DL|DL|DL|
multiplexing:
dlBandwidth: 5
dlCentralFrequency: 0
dlOffset: -5
type: FDD
ulBandwidth: 5
ulCentralFrequency: 0
ulOffset: 0.5
name: FDD-DL-5
numHarqProcs: 10
schedAlgorithm: Proportional Fairness
- amcModel: Shannon
frame: UL|DL|DL|DL|DL|DL|DL|DL|DL|DL|
multiplexing:
dlBandwidth: 90
dlCentralFrequency: 0
dlOffset: -5
type: FDD
ulBandwidth: 5
ulCentralFrequency: 0
ulOffset: 45
name: FDD-DL-90
numHarqProcs: 10
schedAlgorithm: Proportional Fairness
Cell_Profiles:
- areas: N/20
band: NR-3600
cellsConfig:
- arf: Cosine-Urban
atm: TDD
azimuth: 0
cell_number: C1
height: 76.2
power: 45
tilt: 5
- arf: Cosine-Urban
atm: TDD
azimuth: 120
cell_number: C2
height: 76.2
power: 45
tilt: 5
- arf: Cosine-Urban
atm: TDD
azimuth: 240
cell_number: C3
height: 76.2
power: 45
tilt: 5
name: N77UMA
- areas: N/80
band: NR-3600
cellsConfig:
- arf: Cosine-Urban
atm: TDD
azimuth: 0
cell_number: C1
height: 10
power: 30
tilt: 5
- arf: Cosine-Urban
atm: TDD
azimuth: 120
cell_number: C2
height: 10
power: 30
tilt: 5
- arf: Cosine-Urban
atm: TDD
azimuth: 240
cell_number: C3
height: 10
power: 30
tilt: 5
name: N77UMI
- areas: S/20
band: NR-3600
cellsConfig:
- arf: Cosine-Rural
atm: TDD
azimuth: 0
cell_number: C1
height: 76.2
power: 45
tilt: 5
- arf: Cosine-Rural
atm: TDD
azimuth: 120
cell_number: C2
height: 76.2
power: 45
tilt: 5
- arf: Cosine-Rural
atm: TDD
azimuth: 240
cell_number: C3
height: 76.2
power: 45
tilt: 5
name: N77RMA
- areas: S/80
band: NR-3600
cellsConfig:
- arf: Cosine-Rural
atm: TDD
azimuth: 0
cell_number: C1
height: 10
power: 30
tilt: 5
- arf: Cosine-Rural
atm: TDD
azimuth: 120
cell_number: C2
height: 10
power: 30
tilt: 5
- arf: Cosine-Rural
atm: TDD
azimuth: 240
cell_number: C3
height: 10
power: 30
tilt: 5
name: N77RMI
Frequency_Bands:
- Energy parameters:
idle-watts: 200
max-txpower: 40
max-watts: 800
shutdown-timer: 30
shutdown-tx-drop-rate: 1
standby-watts: 10
frequency: 1900
name: LTE-1900
rat:
bandwidth: 20
type: LTE
thresholds:
carrier_aggregation:
- event: A2
hysteresis: 1
rsrp: -110
rsrq: -10
- event: A4
hysteresis: 1
rsrp: -100
rsrq: -10
handover:
inter-freq_ho:
allowed_target_layers: ''
hysteresis: 1
rsrp_offset: '3'
rsrq_offset: N/A
sinr_offset: N/A
intra-freq_ho:
hysteresis: 1
rsrp_offset: '3'
rsrq_offset: N/A
sinr_offset: N/A
reselection:
Qqualmin: -15
Qrxlevmin: -110
default_priority: 0
- Energy parameters:
idle-watts: 150
max-txpower: 40
max-watts: 500
shutdown-timer: 30
shutdown-tx-drop-rate: 1
standby-watts: 10
frequency: 700
name: LTE-700
rat:
bandwidth: 15
type: LTE
thresholds:
carrier_aggregation:
- event: A2
hysteresis: 1
rsrp: -110
rsrq: -10
- event: A4
hysteresis: 1
rsrp: -100
rsrq: -10
handover:
inter-freq_ho:
allowed_target_layers: ''
hysteresis: 1
rsrp_offset: '3'
rsrq_offset: N/A
sinr_offset: N/A
intra-freq_ho:
hysteresis: 1
rsrp_offset: '3'
rsrq_offset: N/A
sinr_offset: N/A
reselection:
Qqualmin: -15
Qrxlevmin: -110
default_priority: 0
- Energy parameters:
idle-watts: 500
max-txpower: 40
max-watts: 5000
shutdown-timer: 30
shutdown-tx-drop-rate: 1
standby-watts: 5
frequency: 3600
name: NR-3600
rat:
bandwidth: 100
numerology: 1
type: NR
thresholds:
carrier_aggregation:
- event: A2
hysteresis: 1
rsrp: -110
rsrq: -10
- event: A4
hysteresis: 1
rsrp: -100
rsrq: -10
handover:
inter-freq_ho:
allowed_target_layers: ''
hysteresis: 1
rsrp_offset: '3'
rsrq_offset: N/A
sinr_offset: N/A
intra-freq_ho:
hysteresis: 1
rsrp_offset: '3'
rsrq_offset: N/A
sinr_offset: N/A
reselection:
Qqualmin: -15
Qrxlevmin: -110
default_priority: 0
E2 Test:
E2MessageFlows:
capture_messages: 99
capture_nodes: 1
capture_syntax: XER
e2_loglevel: Warnings
strict: false
duration: 0
procedures:
E2 Setup:
ncu_in_setup: true
timeout_ms: 9999
tps: 10
KPM Indication:
enabled: true
period: 1000
NodeConfigUpdate:
enabled: false
timeout_ms: 9999
RIC Control:
enabled: true
RIC Subscription:
enabled: true
timeout_ms: 9999
SCTP Connection:
timeout_ms: 3000
Versions:
e2ap: v2.00
kpm: v2.00
topology:
AMF_id: A00001
Cells_per_DU: 1
DUs_per_CU: 1
PLMN_id: 001f01
RIC_address: 192.168.8.220:32222
UEs_per_Cell: 1
deployment: Combined
gNB_id: '123456'
total_CUs: 1
Reports:
api_issues: fix
counts_max_seconds: 3
full_reporting: true
include_internal: true
logging: info
Scenario_Generation:
Summary: Sample scenario with 3 anomalies
advancedRfEnabled: true
advancedTrafficEnabled: true
buildings:
rf_degradation:
rsrp_rsqr_loss: 20
rssinr_loss: 10
types:
- advancedRfPara:
buildingType: Residential
extWallsType: Wood
nRoomsX: 2
nRoomsY: 2
floors: 4
height: 20
- advancedRfPara:
buildingType: Office
extWallsType: ConcreteWithWindows
nRoomsX: 8
nRoomsY: 8
floors: 10
height: 50
interferences: Off
map:
distribution:
Cell site margin: 100
Max area size: 1400
Max aspect ratio: 4
Max building size: 200
Min area size: 350
Min building size: 20
Street width: 20
area: 100
areas: 3
areas_overlaps: false
buildings: 15
density: 50
distance: 500
type: random
neighbours: 7
number: 30
number_of_gNBs: 1
seed: b780
Security:
IPSec:
ipsec_active: false
left_tunnel_ip: 192.168.0.1
pre_shared_key: tunnel_password
right_tunnel_ip: 192.168.0.2
SSH (NETCONF):
Ciphers:
- aes128-ctr
- aes192-ctr
- aes256-ctr
- aes128-cbc
- aes192-cbc
- aes256-cbc
- 3des-cbc
Host Key: ''
Password: viavi
Port: 830
Username: root
TLS Settings:
cert-authorities: ''
cert-verify: NONE
client-cert: ''
server-cert: ''
tls-version:
version: any
Slices:
Services:
- MaxGbr: 0
description: GBR, Conversational Voice
priority: 20
qos_identifier: 1
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR,Conversational Video (Live Streaming)
priority: 40
qos_identifier: 2
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, Non-Conversational Video (Buffered Streaming)
priority: 30
qos_identifier: 3
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, Non-Conversational Video (Buffered Streaming)
priority: 50
qos_identifier: 4
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, Mission Critical user plane Push To Talk voice
priority: 7
qos_identifier: 65
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, Non-Mission-Critical user plane Push To Talk voice
priority: 20
qos_identifier: 66
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, Mission Critical Video user plane
priority: 15
qos_identifier: 67
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR
priority: 25
qos_identifier: 75
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, 'Live' Uplink Streaming (Delay 150ms, PER 1e-6)
priority: 56
qos_identifier: 71
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, 'Live' Uplink Streaming (Delay 300ms, PER 1e-4)
priority: 56
qos_identifier: 72
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, 'Live' Uplink Streaming (Delay 300ms, PER 1e-8)
priority: 56
qos_identifier: 73
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, 'Live' Uplink Streaming (Delay 500ms, PER 1e-8)
priority: 56
qos_identifier: 74
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, 'Live' Uplink Streaming (Delay 500ms, PER 1e-4)
priority: 56
qos_identifier: 76
resourceType: GBR
window: 2000
- MaxGbr: 0
description: Non-GBR, IMS Signalling
priority: 10
qos_identifier: 5
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Video (Buffered Streaming) TCP-based
priority: 60
qos_identifier: 6
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Voice, Video (Live Streaming),Interactive Gaming
priority: 70
qos_identifier: 7
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Video (Buffered Streaming) TCP-based
priority: 80
qos_identifier: 8
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Video (Buffered Streaming) TCP-based
priority: 90
qos_identifier: 9
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Mission Critical delay sensitive signalling
priority: 5
qos_identifier: 69
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Mission Critical Data
priority: 55
qos_identifier: 70
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, V2X messages
priority: 65
qos_identifier: 79
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Low Latency eMBB applications Augmented Reality
priority: 68
qos_identifier: 80
resourceType: Delay-GBR
window: 0
- MaxGbr: 255
description: Delay-GBR, Discrete Automation
priority: 19
qos_identifier: 82
resourceType: Delay-GBR
window: 2000
- MaxGbr: 1358
description: Delay-GBR, Discrete Automation,V2X Messages
priority: 22
qos_identifier: 83
resourceType: Delay-GBR
window: 2000
- MaxGbr: 1354
description: Delay-GBR, Intelligent transport systems
priority: 24
qos_identifier: 84
resourceType: Delay-GBR
window: 2000
- MaxGbr: 255
description: Delay-GBR, Electricity Distribution- high voltage
priority: 21
qos_identifier: 85
resourceType: Delay-GBR
window: 2000
- MaxGbr: 255
description: Delay-GBR, V2X messages (Advanced Driving)
priority: 21
qos_identifier: 86
resourceType: Delay-GBR
window: 2000
Slices:
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Slice suitable for the handling of 5G enhanced Mobile Broadband.
name: eMBB
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Slice suitable for the handling of ultra- reliable low latency communications.
name: URLLC
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Slice suitable for the handling of massive IoT.
name: MIoT
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Slice suitable for the handling of V2X services.
name: V2X
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Slice suitable for the handling of High-Performance Machine-Type
Communications.
name: HMTC
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Custom slice (for user to edit)
name: user
System:
batch_length: 300
batch_mode: false
cell_score_formula: average UE score
influx_retention: 8h
report_ms: 1000
simulation_over_e2: true
ves_collector:
frequency: 1
perf_metric_Cell_fields:
- DRB.UEThpDl
- DRB.UEThpUl
- RRU.PrbUsedDl
- RRU.PrbUsedUl
- RRU.PrbAvailDl
- RRU.PrbAvailUl
- RRU.PrbTotUl
- RRU.PrbTotDl
- PEE.AvgPower
- PEE.Energy
- Viavi.PEE.EnergyEfficiency
- Viavi.Radio.power
perf_metric_UE_fields: []
ves_address: https://192.168.8.229:30417/eventListener/v7
UE_Groups:
- Description: Indoor Users Randomly allocated in buildings 1-4
ca_enabled: false
distribution:
- locations: '*/N77RMI'
ues: 5
- locations: '*/N77UMI'
ues: 5
global-id: Indoor-{ue}
mobility:
type: building
seed: '0x7e5'
serviceConfig:
- Average call duration: 1
Average time between calls: 0
gbrTput: 0
qosId: 1
slice: eMBB
targetTput: 0.5
- Description: cars driving in the city Urban scenario
ca_enabled: false
distribution:
- locations: '*/N77UMI'
ues: 35
- locations: '*/N77UMA'
ues: 5
global-id: Car-{n}
mobility:
path: SSSSSWEEWENNNNN
roundtrip: return
speed: 20
type: Manhattan
seed: '0x7e5'
serviceConfig:
- Average call duration: 1
Average time between calls: 0
gbrTput: 0
qosId: 1
slice: V2X
targetTput: 0.75
_posted on:
date_time: 2023-09-24 13:59:13.593074
version: 1.6.1.20505-eff5051b
apiRoot: http://0.0.0.0
global:
connection_points: []
dusim_gui: ''
workers: 3
hNRF: http://127.0.0.1
mgmt: http://0.0.0.0
```
**Execution:**
Go to ``Runtime`` -> ``Test Control``.
Press ``Run test``.

## 8. Simple scenario
```bash=
AVE Configuration:
KPIs:
- Importance: Goal
KPI: Average Power Usage
Threshold: 3
- Importance: Goal
KPI: Average Energy Efficiency
Threshold: 10
- Importance: Control
KPI: Average Cell QoS Score
Threshold: 1
- Importance: Control
KPI: DL Throughput
Threshold: 5
Scoring Formula: VIAVI Score
Timeseries:
- Average Power Usage
- Average Cell QoS Score
- Average UE PRB usage
- Average Energy Efficiency
- 10th percentile Serving RSRP
- Median Serving RSRP
- 90th percentile Serving RSRP
- Average Cells PRB usage in %
Use Case: Energy Saving
Anomalies:
PCI_Conflict:
candidate_cells: Only neighbors
frequencies:
- 700
- 1900
- 3600
max_conflict_size: 2
max_distance: 0
max_reused_pcis: 0
min_distance: 0
Radio_Anomalies:
- affected_areas: b1,b2
affected_cells: '*/B2'
affected_ues: Indoor*
degradation:
rsrp: 20
rsrq: 20
rssinr: 0
type: radio
delay: 0
duration: 99
name: Constant RF degradation of 20 DB in buildings 1 & 2 on Band B2 in LTE
- affected_areas: A1
affected_cells: '*/N77'
affected_ues: Car*
degradation:
type: throughput
value: 50
delay: 3
duration: 3
name: Intermittent Throughput issues in Cars on NR(5G) band in A1
- affected_areas: A2
affected_cells: '*/B13'
affected_ues: ''
degradation:
rsrp: 15
rsrq: 15
rssinr: 15
type: radio
delay: 1
duration: 2
name: Intermittent RF Degradation for all Users in A2 in LTE Band 13
App Emulation:
RICActions: []
TS:
enabled: false
high_watermark: 75
ho_backoff: 60
Cells:
Advanced_RF_Models:
- antennaModel:
type: Isotropic
name: Isotropic-Rural
scenario: RMa
- antennaModel:
beamWidth: 45
gain: 0
type: Cosine
name: Cosine-Rural
scenario: RMa
- antennaModel:
beamWidth: 45
gain: 0
type: Cosine
name: Cosine-Urban
scenario: UMa
- antennaModel:
models:
- beamType: CSI-RS
gain: 0
groupId: 1
method:
beamConf:
hSpacing: 1
nCols: 4
nHorBeams: 3
nRows: 4
nVerBeams: 3
type: Auto
vSpacing: 1
type: 3GPP-Analog
type: mMIMO Beam Group
name: mMIMO-Urban
scenario: UMa-Buildings
- antennaModel:
models:
- beamType: SSB
gain: 0
groupId: 1
method:
beamConf:
beams:
- digitalAzimuth: -60
digitalTilt: 5
horizontalBeamWidth: 30
id: 1
txPercent: 100
verticalBeamWidth: 15
- digitalAzimuth: 0
digitalTilt: 5
horizontalBeamWidth: 30
id: 2
txPercent: 100
verticalBeamWidth: 15
- digitalAzimuth: 60
digitalTilt: 5
horizontalBeamWidth: 30
id: 3
txPercent: 100
verticalBeamWidth: 15
type: Manual
type: mMIMOSector
type: mMIMO Beam Group
name: SSB Beam Group 1
scenario: UMa-Buildings
Advanced_Traffic_Models:
- amcModel: Shannon
frame: UL|DL|DL|DL|DL|DL|DL|DL|DL|DL|
multiplexing:
dlBandwidth: 90
dlOffset: -5
type: TDD
ulBandwidth: 5
ulOffset: 45
name: TDD
numHarqProcs: 10
schedAlgorithm: Proportional Fairness
- amcModel: Shannon
frame: UL|DL|DL|DL|DL|DL|DL|DL|DL|DL|
multiplexing:
dlBandwidth: 10
dlCentralFrequency: 0
dlOffset: -5
type: FDD
ulBandwidth: 5
ulCentralFrequency: 0
ulOffset: 7
name: FDD-DL-10
numHarqProcs: 10
schedAlgorithm: Proportional Fairness
- amcModel: Shannon
frame: UL|DL|DL|DL|DL|DL|DL|DL|DL|DL|
multiplexing:
dlBandwidth: 5
dlCentralFrequency: 0
dlOffset: -5
type: FDD
ulBandwidth: 5
ulCentralFrequency: 0
ulOffset: 0.5
name: FDD-DL-5
numHarqProcs: 10
schedAlgorithm: Proportional Fairness
- amcModel: Shannon
frame: UL|DL|DL|DL|DL|DL|DL|DL|DL|DL|
multiplexing:
dlBandwidth: 90
dlCentralFrequency: 0
dlOffset: -5
type: FDD
ulBandwidth: 5
ulCentralFrequency: 0
ulOffset: 45
name: FDD-DL-90
numHarqProcs: 10
schedAlgorithm: Proportional Fairness
Cell_Profiles:
- areas: s1,s2
band: NR-3600
cellsConfig:
- arf: Cosine-Urban
atm: TDD
azimuth: 240
cell_number: C3
height: 25
power: 46
tilt: 5
name: N77
- areas: s3
band: NR
cellsConfig:
- arf: Cosine-Urban
atm: TDD
azimuth: 240
cell_number: C3
height: 15
power: 37
tilt: 5
name: NMI77
Frequency_Bands:
- frequency: 1900
name: LTE-1900
rat:
Energy parameters:
fixed-consumption: 20
idle-ratio: 25
pa-efficiency: 1.47
pc-perchain: 1
shutdown-timer: 30
shutdown-tx-drop-rate: 1
signaling-power-ratio: 25
standby-watts: 10
bandwidth: 20
type: LTE
thresholds:
carrier_aggregation:
- event: A2
hysteresis: 1
rsrp: -110
rsrq: -10
- event: A4
hysteresis: 1
rsrp: -100
rsrq: -10
handover:
inter-freq_ho:
allowed_target_layers: ''
hysteresis: 1
rsrp_offset: '3'
rsrq_offset: N/A
sinr_offset: N/A
intra-freq_ho:
hysteresis: 1
rsrp_offset: '3'
rsrq_offset: N/A
sinr_offset: N/A
reselection:
Qqualmin: -15
Qrxlevmin: -110
default_priority: 0
rsrp_thresholds:
rsrp_threshold: -140
- frequency: 700
name: LTE-700
rat:
Energy parameters:
fixed-consumption: 20
idle-ratio: 30
pa-efficiency: 1.43
pc-perchain: 1
shutdown-timer: 30
shutdown-tx-drop-rate: 1
signaling-power-ratio: 25
standby-watts: 10
bandwidth: 15
type: LTE
thresholds:
carrier_aggregation:
- event: A2
hysteresis: 1
rsrp: -110
rsrq: -10
- event: A4
hysteresis: 1
rsrp: -100
rsrq: -10
handover:
inter-freq_ho:
allowed_target_layers: ''
hysteresis: 1
rsrp_offset: N/A
rsrq_offset: N/A
sinr_offset: N/A
intra-freq_ho:
hysteresis: 1
rsrp_offset: '22'
rsrq_offset: N/A
sinr_offset: N/A
reselection:
Qqualmin: -15
Qrxlevmin: -110
default_priority: 0
rsrp_thresholds:
rsrp_threshold: -140
- frequency: 3600
name: NR-3600
rat:
Energy parameters:
fixed-consumption: 200
idle-ratio: 5
pa-efficiency: 30
pc-perchain: 1
shutdown-timer: 30
shutdown-tx-drop-rate: 1
signaling-power-ratio: 25
standby-watts: 5
bandwidth: 100
numerology: 1
type: NR
thresholds:
carrier_aggregation:
- event: A2
hysteresis: 1
rsrp: -110
rsrq: -10
- event: A4
hysteresis: 1
rsrp: -100
rsrq: -10
handover:
inter-freq_ho:
allowed_target_layers: ''
hysteresis: 1
rsrp_offset: '18'
rsrq_offset: N/A
sinr_offset: N/A
intra-freq_ho:
hysteresis: 1
rsrp_offset: '18'
rsrq_offset: N/A
sinr_offset: N/A
reselection:
Qqualmin: -15
Qrxlevmin: -110
default_priority: 0
rsrp_thresholds:
rsrp_threshold: -140
- frequency: 3500
name: NR
rat:
Energy parameters:
fixed-consumption: 100
idle-ratio: 5
pa-efficiency: 23
pc-perchain: 1
shutdown-timer: 30
shutdown-tx-drop-rate: 1
signaling-power-ratio: 25
standby-watts: 5
bandwidth: 100
numerology: 1
type: NR
thresholds:
carrier_aggregation:
- event: A2
hysteresis: 1
rsrp: -110
rsrq: -10
- event: A4
hysteresis: 1
rsrp: -100
rsrq: -10
handover:
inter-freq_ho:
allowed_target_layers: ''
hysteresis: 1
rsrp_offset: '18'
rsrq_offset: N/A
sinr_offset: N/A
intra-freq_ho:
hysteresis: 1
rsrp_offset: '18'
rsrq_offset: N/A
sinr_offset: N/A
reselection:
Qqualmin: -15
Qrxlevmin: -110
default_priority: 0
rsrp_thresholds:
rsrp_threshold: -140
Import:
CSV Import: ''
use_o1_topology: Disabled
E2 Test:
E2MessageFlows:
capture_messages: 99
capture_nodes: 1
capture_syntax: XER
e2_loglevel: Warnings
strict: false
duration: 0
procedures:
Cell Configuration and Control:
enabled: false
E2 Setup:
ncu_in_setup: yes
timeout_ms: 9999
tps: 10
KPM Indication:
enabled: true
period: 1000
NodeConfigUpdate:
enabled: false
ncu_time_ms: 0
timeout_ms: 9999
RIC Control:
enabled: true
failed_percentage: 0
RIC Subscription:
enabled: true
timeout_ms: 9999
SCTP Connection:
timeout_ms: 3000
Versions:
e2ap: v2.00
kpm: v2.00
rc: v1.03
topology:
AMF_id: A00001
Cells_per_DU: 1
DUs_per_CU: 1
PLMN_id: 00f110
RIC_address: 192.168.8.111:32222
UEs_per_Cell: 1
deployment: Combined
gNB_id: '123456'
total_CUs: 1
O1:
o1_completion: disabled
ves_collector:
frequency: 1
granularity: 10
perf_metric_Cell_fields:
- DRB.UEThpDl
- DRB.UEThpUl
- RRU.PrbUsedDl
- RRU.PrbUsedUl
- RRC.ConnMean
- PEE.AvgPower
- Viavi.PEE.EnergyEfficiency
perf_metric_UE_fields:
- Viavi.UE.BeamId
- Viavi.UE.Rsrp
- Viavi.UE.Rsrq
- Viavi.UE.RsSinr
- RRU.PrbUsedUl
- RRU.PrbUsedDl
- DRB.UEThpUl
- DRB.UEThpDl
- TB.TotNbrUl
- TB.TotNbrDl
- DRB.UECqiUl
- DRB.UECqiDl
ves_address: http://192.168.8.6:30417/eventListener/v7
Reports:
api_issues: fix
counts_max_seconds: 3
full_reporting: true
include_internal: true
logging: info
Scenario_Generation:
Summary: Sample scenario with 3 anomalies and 2 RIC actions
advancedRfEnabled: false
advancedTrafficEnabled: false
buildings:
rf_degradation:
rsrp_rsqr_loss: 20
rssinr_loss: 10
types:
- advancedRfPara:
buildingType: Residential
extWallsType: Wood
nRoomsX: 2
nRoomsY: 2
floors: 4
height: 20
- advancedRfPara:
buildingType: Office
extWallsType: ConcreteWithWindows
nRoomsX: 8
nRoomsY: 8
floors: 10
height: 50
interferences: Off
map:
distribution:
Street width: 20
diagram: " \n\n b1‾| b3‾|
\ \n |__b1 |__b3
\n a1‾‾| \n s1 |__a1 s2
\ \n s3\n\n b2‾| b4‾|
\ \n |__b2 |__b4\n"
distance: 500
type: diagram
gNBs_max_DUs: 100
gNBs_min_DUs: 1
neighbours: 3
number: 3
number_of_gNBs: 1
pduRejectChance: 0
rrcRejectChance: 0
seed: b780
Security:
IPSec:
ipsec_active: false
left_tunnel_ip: 192.168.0.1
pre_shared_key: tunnel_password
right_tunnel_ip: 192.168.0.2
SSH (NETCONF):
Ciphers:
- aes128-ctr
- aes192-ctr
- aes256-ctr
- aes128-cbc
- aes192-cbc
- aes256-cbc
- 3des-cbc
Host Key: ''
Password: viavi
Port: 830
Username: root
TLS Settings:
cert-authorities: ''
cert-verify: NONE
client-cert: ''
server-cert: ''
tls-version:
version: any
Slices:
Services:
- MaxGbr: 0
description: GBR, Conversational Voice
priority: 20
qos_identifier: 1
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR,Conversational Video (Live Streaming)
priority: 40
qos_identifier: 2
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, Non-Conversational Video (Buffered Streaming)
priority: 30
qos_identifier: 3
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, Non-Conversational Video (Buffered Streaming)
priority: 50
qos_identifier: 4
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, Mission Critical user plane Push To Talk voice
priority: 7
qos_identifier: 65
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, Non-Mission-Critical user plane Push To Talk voice
priority: 20
qos_identifier: 66
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, Mission Critical Video user plane
priority: 15
qos_identifier: 67
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR
priority: 25
qos_identifier: 75
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, 'Live' Uplink Streaming (Delay 150ms, PER 1e-6)
priority: 56
qos_identifier: 71
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, 'Live' Uplink Streaming (Delay 300ms, PER 1e-4)
priority: 56
qos_identifier: 72
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, 'Live' Uplink Streaming (Delay 300ms, PER 1e-8)
priority: 56
qos_identifier: 73
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, 'Live' Uplink Streaming (Delay 500ms, PER 1e-8)
priority: 56
qos_identifier: 74
resourceType: GBR
window: 2000
- MaxGbr: 0
description: GBR, 'Live' Uplink Streaming (Delay 500ms, PER 1e-4)
priority: 56
qos_identifier: 76
resourceType: GBR
window: 2000
- MaxGbr: 0
description: Non-GBR, IMS Signalling
priority: 10
qos_identifier: 5
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Video (Buffered Streaming) TCP-based
priority: 60
qos_identifier: 6
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Voice, Video (Live Streaming),Interactive Gaming
priority: 70
qos_identifier: 7
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Video (Buffered Streaming) TCP-based
priority: 80
qos_identifier: 8
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Video (Buffered Streaming) TCP-based
priority: 90
qos_identifier: 9
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Mission Critical delay sensitive signalling
priority: 5
qos_identifier: 69
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Mission Critical Data
priority: 55
qos_identifier: 70
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, V2X messages
priority: 65
qos_identifier: 79
resourceType: Non-GBR
window: 0
- MaxGbr: 0
description: Non-GBR, Low Latency eMBB applications Augmented Reality
priority: 68
qos_identifier: 80
resourceType: Delay-GBR
window: 0
- MaxGbr: 255
description: Delay-GBR, Discrete Automation
priority: 19
qos_identifier: 82
resourceType: Delay-GBR
window: 2000
- MaxGbr: 1358
description: Delay-GBR, Discrete Automation,V2X Messages
priority: 22
qos_identifier: 83
resourceType: Delay-GBR
window: 2000
- MaxGbr: 1354
description: Delay-GBR, Intelligent transport systems
priority: 24
qos_identifier: 84
resourceType: Delay-GBR
window: 2000
- MaxGbr: 255
description: Delay-GBR, Electricity Distribution- high voltage
priority: 21
qos_identifier: 85
resourceType: Delay-GBR
window: 2000
- MaxGbr: 255
description: Delay-GBR, V2X messages (Advanced Driving)
priority: 21
qos_identifier: 86
resourceType: Delay-GBR
window: 2000
Slices:
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Slice suitable for the handling of 5G enhanced Mobile Broadband.
name: eMBB
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Slice suitable for the handling of ultra- reliable low latency communications.
name: URLLC
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Slice suitable for the handling of massive IoT.
name: MIoT
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Slice suitable for the handling of V2X services.
name: V2X
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Slice suitable for the handling of High-Performance Machine-Type
Communications.
name: HMTC
- Dedicated-PRB-Policy-Ratio: 0
Max-PRB-Policy-Ratio: 100
Min-PRB-Policy-Ratio: 0
description: Custom slice (for user to edit)
name: user
System:
batch_length: 60
batch_mode: false
cell_score_formula: average UE score
data_set_format: None
influxdb_output: true
report_ms: 1000
simulation_over_e2: true
UE_Groups:
- Description: Slow moving pedestrian streaming mobile video
ca_enabled: false
distribution:
- locations: s1
ues: 3
- locations: s3
ues: 1
global-id: Pedestrian-{ue}
mobility:
type: building
seed: '0x7e5'
serviceConfig:
- Average call duration: 1
Average time between calls: 0
gbrTput: 0
qosDropChance: 0
qosId: 1
slice: eMBB
targetTput: 0.01
ueHeight: 1.5
- Description: Slow moving pedestrian streaming mobile video
ca_enabled: false
distribution:
- locations: a1
ues: 1
global-id: Pedestrian2-{ue}
mobility:
path: EEEEEE
roundtrip: return
speed: 2
type: Manhattan
seed: '0x7e5'
serviceConfig:
- Average call duration: 1
Average time between calls: 0
gbrTput: 0
qosDropChance: 0
qosId: 1
slice: eMBB
targetTput: 0.01
ueHeight: 1.5
- Description: Slow moving pedestrian streaming mobile video
ca_enabled: false
distribution:
- locations: b3,b4
ues: 3
global-id: Pedestrian-{ue}
mobility:
type: building
seed: '0x7e5'
serviceConfig:
- Average call duration: 1
Average time between calls: 0
gbrTput: 0
qosDropChance: 0
qosId: 1
slice: eMBB
targetTput: 0.01
ueHeight: 1.5
_posted on:
date_time: '2024-07-18 03:39:16.624836'
version: 1.9.28915-e3c9af5c
apiRoot: http://0.0.0.0
global:
connection_points: []
dusim_gui: ''
workers: 3
hNRF: http://127.0.0.1
mgmt: http://0.0.0.0
```
## 9. Appendix
- Numerology
