VoIP Server¶

The GVA VoIP Server (gva-voip-server) is a SIP registrar and proxy server designed for military vehicle communications. It manages user registration, call routing, and provides centralised logging of call activity.

Overview¶

Features¶

SIP Registration¶

• User registration with configurable expiry
• Multiple registrations per user (forking)
• Registration state published to DDS

Call Routing¶

• Direct call routing between registered users
• Call forwarding support
• Busy/unavailable handling

Call Detail Records (CDR)¶

The server maintains detailed logs of all calls:

2026-04-13 16:30:45 | operator1 -> operator2 | CONNECTED | 00:05:23 | G.729
2026-04-13 16:36:08 | operator2 -> agent.ai  | COMPLETED | 00:02:15 | MELPe

Quality of Service¶

• DSCP EF (46) marking for voice packets
• RTP packet prioritisation
• Jitter buffer recommendations

Command Line Options¶

gva-voip-server [options]

Options:
  -h, --help               Show help message
  -v, --version            Show version
  -a, --address=<addr>     Bind address (default: 0.0.0.0)
  -p, --port=<port>        SIP listen port (default: 5060)
  -f, --groups-file=<path> Load conference groups from JSON file
  -g, --group=<name>       Add a conference group (repeatable)
  -w, --wideband           Use wideband codec profile (RFC 8817)
  --vivoe                  Use VIVOE audio codec profile (DEF STAN 00-082 Part 2)

Examples¶

# Start server with groups file
gva-voip-server -f /etc/gva-voip-server/groups.json

# Custom address and individual groups
gva-voip-server --address=192.168.1.1 -g command -g alpha -g bravo

Configuration¶

Default Ports¶

Supported Codecs¶

The server supports codec negotiation via SDP offer/answer. Four codec profiles are available, selectable via CLI (--vivoe, --wideband) or the "codecProfile" field in voip-settings.json.

Profile: Tactical (default)¶

STANAG 4591 MELPe with NATO fallbacks. Suitable for classified narrowband links.

Profile: Tactical Wideband (--wideband)¶

TSVCIS wideband + narrowband fallback per RFC 8817.

Profile: VIVOE (--vivoe) — DEF STAN 00-082 Part 2¶

Uncompressed PCM and G.711 encodings mandated by the VIVOE audio standard. Designed for high-fidelity in-vehicle audio distribution (intercoms, acoustic sensors, gunshot detection).

SDP offers include a=ptime:5 and a=maxptime:10 per the DEF STAN examples.

Profile: Standard¶

Opus + G.711 for non-classified / commercial networks.

DEF STAN 00-082 Part 2 Compliance¶

DEF STAN 00-082 Part 2 Issue 1 specifies the distribution and control of digital audio and acoustic data over VIVOE Ethernet networks. The table below summarises compliance status for each requirement area.

Audio Encoding — Compliance Matrix¶

Infrastructure — Gap Analysis¶

The following DEF STAN 00-082 Part 2 infrastructure requirements are not yet implemented. These are transport and control-plane features that sit outside the SIP/RTP codec layer.

Example Usage¶

Starting the Server¶

# Basic startup
./build/bin/gva-voip-server --domain=0

# Production mode with CDR logging
./build/bin/gva-voip-server \
    --domain=0 \
    --dscp-ef \
    --cdr-file=/var/log/gva/voip-cdr.log \
    --headless

# VIVOE audio profile (DEF STAN 00-082 Part 2)
./build/bin/gva-voip-server --domain=0 --vivoe

Testing Registration¶

# Start server
./build/bin/gva-voip-server --domain=0 &

# Register clients
./build/bin/gva-voip-client --user=alice --server=127.0.0.1 &
./build/bin/gva-voip-client --user=bob --server=127.0.0.1 &

# Alice can now call [email protected]

Troubleshooting¶

Common Issues¶

Port already in use:

Error: Failed to bind to port 5060

Another SIP server or instance is running. Either stop it or use a different port:

./build/bin/gva-voip-server --port=5061

Registration timeout: Ensure firewall allows UDP traffic on ports 5060 and 10000-10100.

No audio: Check that RTP ports are not blocked and clients can reach each other directly.

See Also¶

• Gateways — Plugin architecture for external network routing
• Twilio Setup — Elastic SIP Trunk configuration guide
• VoIP Client (Standalone)
• VoIP Client (GVA)
• VoIP Agent
• HERMES Overview