NTN Blueprints with the OAI RF Simulator

Experimental

NTN support is experimental. These blueprints are intended for Non-Terrestrial Network (NTN) evaluation in an emulated environment.

These blueprints run the OAI NTN gNB (oai-ran/monolithic-gnb-ntn) and the OAI NTN soft UE (terminal/oai-ue-ntn) over the RF simulator, which emulates the satellite link.

These blueprints include their Terminal, so brc install network also deploys the soft UE. The Terminal is ready once each UE pings the UPF gateway of its slice from its own tunnel. Then test the UE, for example with brc test rtt ue1 gateway -- -c 5 or brc test throughput ue1 dl gateway -- --time 10.

Deploy a blueprint from the control-plane node with brc install network <file>.yaml. It should finish without errors and print the Kubernetes resources it created. Follow the deployment with brc observe and wait until every Element other than the UE is in the 1/1 Y state.

GEO satellite, band n254

A geostationary satellite scenario in band n254, 5 MHz.

Source: networks/oai/rfsim/09-ntn-geo.yaml

09-ntn-geo.yaml

09-ntn-geo.yaml

# OAI NTN gNB and an OAI NTN soft UE over the RF simulator: GEO satellite, band n254.
# Experimental: NTN support is intended for evaluation in an emulated environment.
apiVersion: athena.trirematics.io/v1
kind: Network
metadata:
    name: oai-rfsim
    namespace: trirematics
spec:
    slices:
        -   plmn: "00101"
            dnn: internet
            network-mode: IPv4
            service-type: 1
            differentiator: 0x000000
            ipv4-range: 12.1.1.0/24
            ipv6-range: 2001:db8:1::/64
    access:
        -   name: gnb
            stack: 5g-sa
            model: oai-ran/monolithic-gnb-ntn
            identity:
                an-id: 30
                tracking-area: 1
            radio:
                device: rf-sim
            annotations:
                extras.t9s.io/ntn-scenario: "geo"
                extras.t9s.io/min-rxtxtime: "4"
            cells:
                -   band: n254
                    arfcn: 497680
                    bandwidth: 5MHz
                    subcarrier-spacing: 15kHz
            core-networks:
                - core.oai-rfsim
    core:
        -   name: core
            stack: 5g-sa
            model: oai-cn/minimal
            identity:
                region: 0
                cn-group: 4
                cn-id: 5
    dns:
        ipv4:
            default: 8.8.8.8
            secondary: 8.8.4.4
---
apiVersion: athena.trirematics.io/v1
kind: Terminal
metadata:
    name: ue1
    namespace: trirematics
    annotations:
        extras.t9s.io/ntn-scenario: "geo"
        # SSB start subcarrier (kSSB) the OAI NTN UE expects
        extras.t9s.io/ssb: "60"
spec:
    vendor: oai
    stack: 5g-sa
    model: terminal/oai-ue-ntn
    preferred-access: gnb.oai-rfsim
    target-cores:
        - core.oai-rfsim
    identity:
        imsi: "001010000000001"
        pin: "1234"
        opc: "0xc42449363bbad02b66d16bc975d77cc1"
        key: "0xfec86ba6eb707ed08905757b1bb44b8f"
        sqn: "0xff9bb4000001"
    slice:
        dnn: internet
        network-mode: IPv4
        service-type: 1
        differentiator: 0x000000
    radio:
        device: rf-sim
        formation: "1x1"
        bands:
            - n254
    # the Terminal is ready once every UE pings the target from its own tunnel (oaitun_ue<N>)
    readiness-check:
        method: ping
        target: gateway # UPF of the slice of each UE

#--- Add a UE the cluster does not run with terminals/external.yaml: preferred-access gnb.oai-rfsim, target-cores core.oai-rfsim ---#

LEO satellite, band n254

A Low Earth Orbit satellite scenario in band n254, 5 MHz.

Source: networks/oai/rfsim/10-ntn-leo.yaml

10-ntn-leo.yaml

10-ntn-leo.yaml

# OAI NTN gNB and an OAI NTN soft UE over the RF simulator: LEO satellite, band n254.
# Experimental: NTN support is intended for evaluation in an emulated environment.
apiVersion: athena.trirematics.io/v1
kind: Network
metadata:
    name: oai-rfsim
    namespace: trirematics
spec:
    slices:
        -   plmn: "00101"
            dnn: internet
            network-mode: IPv4
            service-type: 1
            differentiator: 0x000000
            ipv4-range: 12.1.1.0/24
            ipv6-range: 2001:db8:1::/64
    access:
        -   name: gnb
            stack: 5g-sa
            model: oai-ran/monolithic-gnb-ntn
            identity:
                an-id: 30
                tracking-area: 1
            radio:
                device: rf-sim
            annotations:
                extras.t9s.io/ntn-scenario: "leo"
                extras.t9s.io/min-rxtxtime: "4"
            cells:
                -   band: n254
                    arfcn: 497680
                    bandwidth: 5MHz
                    subcarrier-spacing: 15kHz
            core-networks:
                - core.oai-rfsim
    core:
        -   name: core
            stack: 5g-sa
            model: oai-cn/minimal
            identity:
                region: 0
                cn-group: 4
                cn-id: 5
    dns:
        ipv4:
            default: 8.8.8.8
            secondary: 8.8.4.4
---
apiVersion: athena.trirematics.io/v1
kind: Terminal
metadata:
    name: ue1
    namespace: trirematics
    annotations:
        extras.t9s.io/ntn-scenario: "leo"
        # SSB start subcarrier (kSSB) the OAI NTN UE expects
        extras.t9s.io/ssb: "60"
spec:
    vendor: oai
    stack: 5g-sa
    model: terminal/oai-ue-ntn
    preferred-access: gnb.oai-rfsim
    target-cores:
        - core.oai-rfsim
    identity:
        imsi: "001010000000001"
        pin: "1234"
        opc: "0xc42449363bbad02b66d16bc975d77cc1"
        key: "0xfec86ba6eb707ed08905757b1bb44b8f"
        sqn: "0xff9bb4000001"
    slice:
        dnn: internet
        network-mode: IPv4
        service-type: 1
        differentiator: 0x000000
    radio:
        device: rf-sim
        formation: "1x1"
        bands:
            - n254
    # the Terminal is ready once every UE pings the target from its own tunnel (oaitun_ue<N>)
    readiness-check:
        method: ping
        target: gateway # UPF of the slice of each UE

#--- Add a UE the cluster does not run with terminals/external.yaml: preferred-access gnb.oai-rfsim, target-cores core.oai-rfsim ---#

GEO satellite, band n256

The geostationary scenario in band n256, 5 MHz.

Source: networks/oai/rfsim/11-ntn-geo-n256.yaml

11-ntn-geo-n256.yaml

11-ntn-geo-n256.yaml

# OAI NTN gNB and an OAI NTN soft UE over the RF simulator: GEO satellite, band n256.
# Experimental: NTN support is intended for evaluation in an emulated environment.
apiVersion: athena.trirematics.io/v1
kind: Network
metadata:
    name: oai-rfsim
    namespace: trirematics
spec:
    slices:
        -   plmn: "00101"
            dnn: internet
            network-mode: IPv4
            service-type: 1
            differentiator: 0x000000
            ipv4-range: 12.1.1.0/24
            ipv6-range: 2001:db8:1::/64
    access:
        -   name: gnb
            stack: 5g-sa
            model: oai-ran/monolithic-gnb-ntn
            identity:
                an-id: 30
                tracking-area: 1
            radio:
                device: rf-sim
            annotations:
                extras.t9s.io/ntn-scenario: "geo"
                extras.t9s.io/min-rxtxtime: "4"
            cells:
                -   band: n256
                    arfcn: 437000
                    bandwidth: 5MHz
                    subcarrier-spacing: 15kHz
            core-networks:
                - core.oai-rfsim
    core:
        -   name: core
            stack: 5g-sa
            model: oai-cn/minimal
            identity:
                region: 0
                cn-group: 4
                cn-id: 5
    dns:
        ipv4:
            default: 8.8.8.8
            secondary: 8.8.4.4
---
apiVersion: athena.trirematics.io/v1
kind: Terminal
metadata:
    name: ue1
    namespace: trirematics
    annotations:
        extras.t9s.io/ntn-scenario: "geo"
        # SSB start subcarrier (kSSB) the OAI NTN UE expects
        extras.t9s.io/ssb: "60"
spec:
    vendor: oai
    stack: 5g-sa
    model: terminal/oai-ue-ntn
    preferred-access: gnb.oai-rfsim
    target-cores:
        - core.oai-rfsim
    identity:
        imsi: "001010000000001"
        pin: "1234"
        opc: "0xc42449363bbad02b66d16bc975d77cc1"
        key: "0xfec86ba6eb707ed08905757b1bb44b8f"
        sqn: "0xff9bb4000001"
    slice:
        dnn: internet
        network-mode: IPv4
        service-type: 1
        differentiator: 0x000000
    radio:
        device: rf-sim
        formation: "1x1"
        bands:
            - n256
    # the Terminal is ready once every UE pings the target from its own tunnel (oaitun_ue<N>)
    readiness-check:
        method: ping
        target: gateway # UPF of the slice of each UE

#--- Add a UE the cluster does not run with terminals/external.yaml: preferred-access gnb.oai-rfsim, target-cores core.oai-rfsim ---#