Tutorials

Step-by-step guides from your first gNB to advanced multi-component deployments. Each tutorial has a single goal: follow it in order and you will have a working system by the end.

Choose a starting point based on your available hardware and experience with OCUDU.

Start here if you are new to OCUDU

The Testmode tutorial requires only an OCUDU build, with no radio hardware or physical UE. Once you have a working system, the srsUE tutorial adds a software UE over ZeroMQ.

Coming from srsRAN Project?

See the Migration Guide for instructions on porting your existing srsRAN Project modifications to OCUDU.

Beginner

No specialist hardware required.

OCUDU with srsUE

Build a complete open-source split 8 5G network using srsUE as the UE and Open5GS as the core.

Intermediate

Requires a USRP RF front-end or a commercial UE.

COTS UE

Connect a commercial 5G device to OCUDU using a test SIM and a USRP RF front-end.

Amarisoft UE

Connect an Amarisoft UE simulator to OCUDU for multi-UE testing scenarios.

Handover

Configure and test intra-gNB handover between two OCUDU cells with a COTS UE.

Advanced

Requires specialist infrastructure: an O-RAN RU or a Near-RT RIC.

O-RAN RU

Connect an O-RAN-compliant radio unit to OCUDU over the split 7.2 fronthaul interface.

Near-RT RIC

Use the E2 interface to integrate OCUDU with a Near-RT RIC and deploy an xApp.

NTN

Enable NTN mode in OCUDU for satellite and high-altitude platform deployments, with GEO orbit timing support.

Deployment Optimisation

Performance optimisation for OCUDU deployments.

Testmode

Verify your OCUDU installation and explore the configuration without radio hardware or a physical UE.

DPDK

Configure DPDK kernel-bypass packet I/O for high-throughput Open Fronthaul connectivity with OCUDU.

DPDK with USRP

Configure DPDK kernel-bypass packet I/O for use with a USRP RF front-end and OCUDU.

BBDEV Hardware Acceleration

Offload LDPC encoding and decoding to an Intel ACC100 or vRAN Boost (ACC200/VRB1) accelerator via DPDK BBDEV.

MATLAB

Integrate MATLAB with OCUDU for signal processing, analysis, and algorithm prototyping.

Performance Tuning

Tune CPU isolation, IRQ affinity, and kernel settings on a Linux host for real-time OCUDU performance.

Orchestration

Distributed and containerised OCUDU deployments.

Kubernetes

Deploy OCUDU as Kubernetes pods in a split 7.2 configuration, with containerised CU, DU, and fronthaul components.

CU/DU Split

Deploy OCUDU with the CU and DU running as separate processes, connected over the F1 interface.