Skip to main content

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.

The groups below run roughly from least to most infrastructure. Pick the group that matches what you want to do.

New to OCUDU? Follow this path
  1. Load testing: validate your build, no radio hardware needed.
  2. Using srsUE: add a software UE over ZeroMQ.
  3. Connecting a COTS UE: move to a real device with a USRP.
Coming from srsRAN Project?

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

How the tutorials fit together​

Start with a first network, then branch into whichever direction fits your goal.

First network​

No RF hardware required. Validate your build, then bring up a complete software network over ZeroMQ.

UEs and radios​

Connect a real device, a UE simulator, or an O-RAN radio unit. Requires a USRP RF front-end (or an O-RAN RU for the radio-unit tutorial).

O-RAN​

Split the stack across O-RAN interfaces and integrate a Near-RT RIC. The CU/DU split runs on any supported RF or test setup; the RIC tutorial requires a Near-RT RIC.

Features​

Enable and test specific gNB features. Handover needs a COTS UE and a USRP; NTN needs an Amarisoft UE.

Performance​

Tune throughput and latency with kernel-bypass I/O, hardware offload, and host tuning. Some tutorials need specific hardware: a DPDK-capable NIC, a USRP, or an Intel accelerator.

Deployment and tools​

Containerised deployment and supporting tooling. The Kubernetes tutorial needs a cluster.