N2 handover
This MR introduces full support for N2 handover, covering handover
decision, preparation, execution, and notification between source and
target NG-RAN nodes.
Key features:
1. Handover Decision & Preparation:
- Implement N2 handover decision based on UE measurement reports.
- Generate the Handover Preparation Information message, including
RRCReconfiguration.
- Send Handover Required message from the source NG-RAN to the AMF.
2. Handover Execution:
- Decode and handle the Handover Request on the target NG-RAN.
- Process the Handover Command on the source gNB, triggering
RRCReconfiguration.
- Initiate Handover Notify after successful completion.
3 NGAP & RRC Enhancements:
- Implement NGAP encoding/decoding functions for Handover Required,
Handover Request, Handover Command, Handover Failure, and Handover
Notify (3GPP TS 38.413).
- Adds NG-RAN Status Transfer support (UL/DL) for PDCP COUNT
preservation during mobility:
- support for NGAP Uplink and Downlink RAN Status Transfer messages
(TS 38.413 §9.2.3.13-14) to enable proper PDCP COUNT value
transfer during handover or recovery: NGAP encoding/decoding for
RAN Status Transfer, PDCP helpers to extract and apply COUNT (HFN
+ SN) per DRB. This aligns with TS 38.300 §9.2.3.2.1 and TS 23.502
§4.9.1.3.3, ensuring PDCP status preservation in AM.
4. Testing:
- Introduce a Telnet command to manually trigger N2 handover using UE
ID and neighbor PCI.
- Add configuration file for testing N2 handover with a target gNB.
240 lines
8.7 KiB
YAML
240 lines
8.7 KiB
YAML
services:
|
|
mysql:
|
|
container_name: "rfsim5g-mysql"
|
|
image: mysql:8.0
|
|
init: true
|
|
volumes:
|
|
- ../5g_rfsimulator/oai_db.sql:/docker-entrypoint-initdb.d/oai_db.sql
|
|
- ../5g_rfsimulator/mysql-healthcheck.sh:/tmp/mysql-healthcheck.sh
|
|
environment:
|
|
- TZ=Europe/Paris
|
|
- MYSQL_DATABASE=oai_db
|
|
- MYSQL_USER=test
|
|
- MYSQL_PASSWORD=test
|
|
- MYSQL_ROOT_PASSWORD=linux
|
|
healthcheck:
|
|
test: /bin/bash -c "/tmp/mysql-healthcheck.sh"
|
|
start_period: 10s
|
|
start_interval: 500ms
|
|
interval: 10s
|
|
timeout: 5s
|
|
retries: 30
|
|
networks:
|
|
public_net:
|
|
ipv4_address: 192.168.71.131
|
|
oai-amf:
|
|
container_name: "rfsim5g-oai-amf"
|
|
image: oaisoftwarealliance/oai-amf:v2.1.10
|
|
environment:
|
|
- TZ=Europe/paris
|
|
volumes:
|
|
- ../5g_rfsimulator_e1/mini_nonrf_config_3slices.yaml:/openair-amf/etc/config.yaml
|
|
depends_on:
|
|
- mysql
|
|
networks:
|
|
public_net:
|
|
ipv4_address: 192.168.71.132
|
|
oai-smf:
|
|
container_name: "rfsim5g-oai-smf"
|
|
image: oaisoftwarealliance/oai-smf:v2.1.10
|
|
environment:
|
|
- TZ=Europe/Paris
|
|
volumes:
|
|
- ../5g_rfsimulator_e1/mini_nonrf_config_3slices.yaml:/openair-smf/etc/config.yaml
|
|
depends_on:
|
|
- oai-amf
|
|
networks:
|
|
public_net:
|
|
ipv4_address: 192.168.71.133
|
|
oai-upf:
|
|
container_name: "rfsim5g-oai-upf"
|
|
image: oaisoftwarealliance/oai-upf:v2.1.10
|
|
init: true
|
|
environment:
|
|
- TZ=Europe/Paris
|
|
volumes:
|
|
- ../5g_rfsimulator_e1/mini_nonrf_config_3slices.yaml:/openair-upf/etc/config.yaml
|
|
depends_on:
|
|
- oai-smf
|
|
cap_add:
|
|
- NET_ADMIN
|
|
- SYS_ADMIN
|
|
cap_drop:
|
|
- ALL
|
|
privileged: true
|
|
networks:
|
|
public_net:
|
|
ipv4_address: 192.168.71.134
|
|
interface_name: eth0
|
|
traffic_net:
|
|
ipv4_address: 192.168.72.134
|
|
interface_name: eth1
|
|
|
|
oai-ext-dn:
|
|
privileged: true
|
|
container_name: rfsim5g-oai-ext-dn
|
|
image: oaisoftwarealliance/trf-gen-cn5g:focal
|
|
init: true
|
|
entrypoint: /bin/bash -c \
|
|
"iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE;"\
|
|
"ip route add 12.1.1.0/24 via 192.168.72.134 dev eth0; sleep infinity"
|
|
depends_on:
|
|
- oai-upf
|
|
networks:
|
|
traffic_net:
|
|
ipv4_address: 192.168.72.135
|
|
healthcheck:
|
|
test: /bin/bash -c "ping -c 2 192.168.72.134"
|
|
start_period: 10s
|
|
start_interval: 500ms
|
|
interval: 10s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
oai-cu:
|
|
image: ${REGISTRY:-oaisoftwarealliance}/${GNB_IMG:-oai-gnb}:${TAG:-develop}
|
|
container_name: rfsim5g-oai-cu
|
|
cap_drop:
|
|
- ALL
|
|
cap_add:
|
|
- SYS_NICE
|
|
environment:
|
|
USE_ADDITIONAL_OPTIONS: --log_config.global_log_options level,nocolor,time
|
|
--gNBs.[0].remote_s_address 0.0.0.0
|
|
--telnetsrv --telnetsrv.listenaddr 192.168.71.150
|
|
--telnetsrv.shrmod ci
|
|
ASAN_OPTIONS: detect_leaks=0:detect_odr_violation=0
|
|
depends_on:
|
|
- oai-ext-dn
|
|
networks:
|
|
public_net:
|
|
ipv4_address: 192.168.71.150
|
|
volumes:
|
|
- ../../conf_files/neighbour-config.conf:/opt/oai-gnb/etc/neighbour-config.conf
|
|
- ../../conf_files/gnb-cu.sa.band78.106prb.conf:/opt/oai-gnb/etc/gnb.conf
|
|
healthcheck:
|
|
test: /bin/bash -c "pgrep nr-softmodem"
|
|
start_period: 10s
|
|
start_interval: 500ms
|
|
interval: 10s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
oai-du-pci0:
|
|
image: ${REGISTRY:-oaisoftwarealliance}/${GNB_IMG:-oai-gnb}:${TAG:-develop}
|
|
container_name: rfsim5g-oai-du-pci0
|
|
cap_drop:
|
|
- ALL
|
|
cap_add:
|
|
- SYS_NICE
|
|
environment:
|
|
USE_ADDITIONAL_OPTIONS: --rfsim
|
|
--log_config.global_log_options level,nocolor,time
|
|
--rfsimulator.options chanmod
|
|
--telnetsrv --telnetsrv.listenaddr 192.168.71.171
|
|
--telnetsrv.shrmod ci
|
|
--rfsimulator.serveraddr 192.168.71.181
|
|
ASAN_OPTIONS: detect_leaks=0:detect_odr_violation=0
|
|
depends_on:
|
|
- oai-cu
|
|
- oai-nr-ue
|
|
networks:
|
|
public_net:
|
|
ipv4_address: 192.168.71.171
|
|
volumes:
|
|
- ../../conf_files/gnb-du.sa.band78.106prb.rfsim.conf:/opt/oai-gnb/etc/gnb.conf
|
|
healthcheck:
|
|
test: /bin/bash -c "pgrep nr-softmodem"
|
|
start_period: 10s
|
|
start_interval: 500ms
|
|
interval: 10s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
oai-du-pci1:
|
|
image: ${REGISTRY:-oaisoftwarealliance}/${GNB_IMG:-oai-gnb}:${TAG:-develop}
|
|
container_name: rfsim5g-oai-du-pci1
|
|
cap_drop:
|
|
- ALL
|
|
cap_add:
|
|
- SYS_NICE
|
|
environment:
|
|
USE_ADDITIONAL_OPTIONS: --rfsim
|
|
--log_config.global_log_options level,nocolor,time
|
|
--gNBs.[0].gNB_DU_ID 3585
|
|
--gNBs.[0].nr_cellid 11111111
|
|
--gNBs.[0].servingCellConfigCommon.[0].physCellId 1
|
|
--gNBs.[0].servingCellConfigCommon.[0].absoluteFrequencySSB 643296
|
|
--gNBs.[0].servingCellConfigCommon.[0].dl_absoluteFrequencyPointA 642024
|
|
--gNBs.[0].servingCellConfigCommon.[0].ssb_PositionsInBurst_Bitmap 3
|
|
--MACRLCs.[0].local_n_address 192.168.71.172
|
|
--rfsimulator.serveraddr 192.168.71.181
|
|
ASAN_OPTIONS: detect_leaks=0:detect_odr_violation=0
|
|
depends_on:
|
|
- oai-cu
|
|
- oai-nr-ue
|
|
networks:
|
|
public_net:
|
|
ipv4_address: 192.168.71.172
|
|
volumes:
|
|
- ../../conf_files/gnb-du.sa.band78.106prb.rfsim.conf:/opt/oai-gnb/etc/gnb.conf
|
|
healthcheck:
|
|
test: /bin/bash -c "pgrep nr-softmodem"
|
|
start_period: 10s
|
|
start_interval: 500ms
|
|
interval: 10s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
oai-nr-ue:
|
|
image: ${REGISTRY:-oaisoftwarealliance}/${NRUE_IMG:-oai-nr-ue}:${TAG:-develop}
|
|
container_name: rfsim5g-oai-nr-ue
|
|
cap_drop:
|
|
- ALL
|
|
cap_add:
|
|
- NET_ADMIN # for interface bringup
|
|
- NET_RAW # for ping
|
|
- SYS_NICE
|
|
environment:
|
|
USE_ADDITIONAL_OPTIONS: --rfsim --log_config.global_log_options level,nocolor,time
|
|
-r 106 --numerology 1 -C 3619200000
|
|
--uicc0.imsi 208990100001100
|
|
--rfsimulator.options chanmod
|
|
--rfsimulator.serveraddr server
|
|
--telnetsrv --telnetsrv.shrmod ciUE --telnetsrv.listenaddr 192.168.71.181 --telnetsrv.listenport 8091
|
|
--channelmod.modellist_rfsimu_1.[0].model_name rfsimu_channel_ue0
|
|
--channelmod.modellist_rfsimu_1.[1].model_name rfsimu_channel_ue1
|
|
ASAN_OPTIONS: detect_odr_violation=0
|
|
networks:
|
|
public_net:
|
|
ipv4_address: 192.168.71.181
|
|
devices:
|
|
- /dev/net/tun:/dev/net/tun
|
|
volumes:
|
|
- ../../conf_files/nrue.uicc.conf:/opt/oai-nr-ue/etc/nr-ue.conf
|
|
healthcheck:
|
|
test: /bin/bash -c "pgrep nr-uesoftmodem"
|
|
start_period: 10s
|
|
start_interval: 500ms
|
|
interval: 10s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
networks:
|
|
public_net:
|
|
driver: bridge
|
|
name: rfsim5g-oai-public-net
|
|
ipam:
|
|
config:
|
|
- subnet: 192.168.71.128/26
|
|
driver_opts:
|
|
com.docker.network.bridge.name: "rfsim5g-public"
|
|
traffic_net:
|
|
driver: bridge
|
|
name: rfsim5g-oai-traffic-net
|
|
ipam:
|
|
config:
|
|
- subnet: 192.168.72.128/26
|
|
driver_opts:
|
|
com.docker.network.bridge.name: "rfsim5g-traffic"
|