Demo QoD Adapter Tutorial

┌───────────────────────────────────────────────────────────────────────────┐
│                          Demo QoD Adapter (.70.143)                      │
│                                                                          │
│   config.yaml                                                            │
│   ┌─────────────────────────────────────────────────────────────────┐    │
│   │  video_stream     QOS_L   port 8554   "HD camera feed"           │    │
│   │  webrtc_control   QOS_E   port 8443   "Teleoperation commands"   │    │
│   └─────────────────────────────────────────────────────────────────┘    │
│                          │                                               │
│               SessionManager                                             │
│          create → monitor → cleanup                                      │
│                          │                                               │
│                     QodClient                                            │
│                          │ gRPC (InternalMessage)                        │
└──────────────────────────┼───────────────────────────────────────────────┘
                           ▼
                    ┌──────────────┐     gRPC      ┌──────────────┐
                    │   AF Core    │──────────────▶│ PCF Handler  │
                    │   .70.141    │               │   .70.140    │
                    └──────────────┘               └──────┬───────┘
                                                          │ HTTP
                                                          ▼
                                                   ┌──────────────┐
                                                   │   PCF        │
                                                   │   .70.139    │
                                                   └──────┬───────┘
                                                          │ N7
                                                          ▼
                                                   ┌──────────────┐
                                                   │   SMF        │
                                                   │   .70.133    │
                                                   └──────┬───────┘
                                                          │ N4 (PFCP)
                                                          ▼
                   ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
                   │    UE    │────▶│   gNB    │────▶│   UPF    │────▶│  Ext DN  │
                   │ 10.60.0.1│     │ UERANSIM │     │ (OAI)    │     │          │
                   └──────────┘     └──────────┘     └──────────┘     └──────────┘

export CORE_PROFILE="${CORE_PROFILE:-free5gc}"
export COMPOSE_FILE="${COMPOSE_FILE:-docker-compose/compose.yaml}"
export COMPOSE_PROFILES="${COMPOSE_PROFILES:---profile $CORE_PROFILE --profile afs --profile standalone-qod}"
export RAN_SERVICES="${RAN_SERVICES:-ueransim-gnb ueransim-ue}"

export LOGS_DIR="${LOGS_DIR:-/tmp/phine.af/adapter-qod-tutorial/logs}"
mkdir -p "$LOGS_DIR"
sudo mkdir -p "$LOGS_DIR"
sudo chmod 777 "$LOGS_DIR"

echo "Configuration set:"
echo "  CORE_PROFILE: $CORE_PROFILE"
echo "  COMPOSE_FILE: $COMPOSE_FILE"
echo "  COMPOSE_PROFILES: $COMPOSE_PROFILES"
echo "  RAN_SERVICES: $RAN_SERVICES"
echo "  CAPTURE_DIR: $LOGS_DIR"

./build/scripts/ci_helper.sh install_dependencies
./build/scripts/ci_helper.sh install_gtp5g

./build/scripts/ci_helper.sh check_submodules

docker compose -f $COMPOSE_FILE $COMPOSE_PROFILES build af_core pcf_handler phine.af-demo-qod-adapter

docker compose -f $COMPOSE_FILE $COMPOSE_PROFILES up -d \
  db free5gc-nrf free5gc-amf free5gc-ausf free5gc-nssf \
  free5gc-pcf free5gc-smf free5gc-udm free5gc-udr \
  free5gc-upf free5gc-webui oai-ext-dn

# Wait for NRF to be ready
sleep 30

docker compose -f $COMPOSE_FILE $COMPOSE_PROFILES up -d $RAN_SERVICES
echo "Waiting for UE to establish connection (20s)..."
sleep 20

docker exec ue ip addr show uesimtun0 | grep "10.60.0.1"

docker compose -f $COMPOSE_FILE $COMPOSE_PROFILES up -d af_core pcf_handler

# Wait for phine.af-core to be ready
sleep 15

PCAP_FILE="$LOGS_DIR/adapter_capture.pcapng"
PID_FILE="$LOGS_DIR/adapter_capture.pid"
LOG_FILE="$LOGS_DIR/adapter_capture.tshark.log"

sudo nohup tshark -i demo-oai \
  -f "host 192.168.70.143 or host 192.168.70.141 or host 192.168.70.140 or host 192.168.70.139 or host 192.168.70.133" \
  -w "$PCAP_FILE" \
  >"$LOG_FILE" 2>&1 &
echo $! > "$PID_FILE"

echo "Traffic capture started in background (PID: $(cat "$PID_FILE" 2>/dev/null || echo unknown))"
sleep 2

cat docker-compose/conf/adapter_config.yaml

vi docker-compose/conf/adapter_config.yaml

monitor:
  interval_seconds: 10
  iterations: -1  # Run until SIGINT/SIGTERM

docker compose -f $COMPOSE_FILE $COMPOSE_PROFILES up --exit-code-from phine.af-demo-qod-adapter phine.af-demo-qod-adapter

PCAP_FILE="$LOGS_DIR/adapter_capture.pcapng"
PID_FILE="$LOGS_DIR/adapter_capture.pid"

if [ -f "$PID_FILE" ]; then
  PID="$(cat "$PID_FILE" 2>/dev/null || true)"
  if [ -n "$PID" ]; then
    sudo kill -TERM "$PID" 2>/dev/null || true
    sleep 1
    sudo kill -KILL "$PID" 2>/dev/null || true
  fi
  rm -f "$PID_FILE"
fi
sudo chmod a+r "$PCAP_FILE" 2>/dev/null || true
echo "Capture stopped"

PCAP_FILE="$LOGS_DIR/adapter_capture.pcapng"
# Open file with wireshark
wireshark $PCAP_FILE

# Each `runme run <name>` invocation starts a fresh shell, so setup-variables'
# exports aren't inherited here — re-apply the same default.
export LOGS_DIR="${LOGS_DIR:-/tmp/phine.af/adapter-qod-tutorial/logs}"

./build/scripts/ci_helper.sh collect_logs $LOGS_DIR
echo "Logs collected to $LOGS_DIR"
ls -la $LOGS_DIR

cat $LOGS_DIR/demo_qod_adapter.log

cat $LOGS_DIR/af_core.log | tail -50

PCAP_FILE="$LOGS_DIR/adapter_capture.pcapng"
PID_FILE="$LOGS_DIR/adapter_capture.pid"

if [ -f "$PID_FILE" ]; then
  PID="$(cat "$PID_FILE" 2>/dev/null || true)"
  if [ -n "$PID" ]; then
    sudo kill -TERM "$PID" 2>/dev/null || true
    sleep 1
    sudo kill -KILL "$PID" 2>/dev/null || true
  fi
  rm -f "$PID_FILE"
fi
sudo chmod a+r "$PCAP_FILE" 2>/dev/null || true
echo "All tshark processes stopped"

# Each `runme run <name>` invocation starts a fresh shell, so setup-variables'
# exports aren't inherited here — re-apply the same defaults.
export CORE_PROFILE="${CORE_PROFILE:-free5gc}"
export COMPOSE_FILE="${COMPOSE_FILE:-docker-compose/compose.yaml}"
export COMPOSE_PROFILES="${COMPOSE_PROFILES:---profile $CORE_PROFILE --profile afs --profile standalone-qod}"

docker compose -f $COMPOSE_FILE $COMPOSE_PROFILES down

export CORE_PROFILE="${CORE_PROFILE:-free5gc}"
export COMPOSE_FILE="${COMPOSE_FILE:-docker-compose/compose.yaml}"
export COMPOSE_PROFILES="${COMPOSE_PROFILES:---profile $CORE_PROFILE --profile afs --profile standalone-qod}"

docker compose -f $COMPOSE_FILE $COMPOSE_PROFILES down --rmi all

CORE_PROFILE=free5gc runme run --all --skip-prompts \
  --filename docs/getting-started/08-demo-adapter-tutorial.md