Platform Notes
The default configuration runs every node on 127.0.0.1 with unprivileged ports, so a single host needs no root, capabilities or extra addresses on Linux or macOS. Nodes on separate hosts, or talking to other vendors’ equipment, must use the standard (spec) ports.
Interfaces
| Interface | Between | Transport | Single-host default | Spec port between hosts |
|---|---|---|---|---|
| Abis signaling | BTS ↔ BSC | TCP | 5604 | 5604 |
| Abis traffic | BTS ↔ BSC | UDP | BSC 17022, one BTS port per call | operator-chosen |
| A1p | MSC → BSC | SCTP | 14001 | 14001 |
| A1p over UDP | MSC → BSC | UDP | BSC 9899, MSC 9900 | 9899 |
| A2p voice | BSC ↔ MSC | RTP/UDP | one port pair per call | operator-chosen |
| A9 | EV-DO cell or BSC → PCF | UDP or TCP | 5603 | 5603 |
| A8 | EV-DO cell or BSC ↔ PCF | GRE-in-UDP | AN 17040, BSC 17048, PCF 17041 | native GRE (IP protocol 47) |
| A10 | PCF ↔ PDSN | GRE-in-UDP | PCF 17042, PDSN 17043 | native GRE (IP protocol 47) |
| A11 | PCF ↔ PDSN | UDP | PCF 17044, PDSN 17045 | 699 on both ends |
| A21 | EV-DO cell ↔ BSC | UDP | AN 17049, BSC 4597 | 4597 on both ends |
A11 and A21 use one port on both ends, so on a shared address the single-host default moves one end to a different port. Native GRE delivers every GRE packet for an address to every node on it, so GRE-in-UDP is the single-host default.
SCTP
A1p uses kernel SCTP when the host provides it. When it does not, A1p falls back to the bundled userspace SCTP stack over UDP, and logs a warning on Linux. macOS always uses SCTP over UDP. To use kernel SCTP on Linux:
sudo modprobe sctpecho sctp | sudo tee /etc/modules-load.d/1xbts-sctp.confBoth ends of an association must use the same transport. An MSC on kernel SCTP cannot reach a BSC that fell back to UDP. Set a1p.sctp.backend to kernel or usrsctp to disable the fallback.
Between hosts
| Linux | macOS | |
|---|---|---|
| A1p on native SCTP | sctp kernel module | "backend": "usrsctp" and root |
| A11 on UDP 699 | CAP_NET_BIND_SERVICE | no privilege needed |
| Native GRE for A8/A10 | CAP_NET_RAW | root |
Grant the capabilities on Linux, and repeat after each rebuild:
sudo setcap cap_net_bind_service,cap_net_raw+ep target/release/cdma-nibThen set the spec ports and native GRE on the nodes that face another host. For a PCF and PDSN on separate machines:
config/pcf.local.json:
{ "a8_bearer": { "mode": "raw_gre" }, "a10_bearer": { "mode": "raw_gre" }, "a11": { "bind_addr": "192.0.2.10:699", "peer_addr": "192.0.2.20:699" }}config/pdsn.local.json:
{ "a10_bearer": { "mode": "raw_gre" }, "a11": { "bind_addr": "192.0.2.20:699", "peer_addr": "192.0.2.10:699" }}config/bts.local.json, for an EV-DO cell:
{ "evdo": { "a9": { "a8_transport": "raw_gre" }, "a21": { "bind_addr": "192.0.2.30:4597", "iws_addr": "192.0.2.40:4597" } } }To run several nodes on spec ports on one host, give each its own address, for example 127.0.0.2, 127.0.0.3 and 127.0.0.4. Linux answers on all of 127.0.0.0/8. macOS needs sudo ifconfig lo0 alias 127.0.0.N up for each one, after every reboot.
Docker services
| Linux | macOS |
|---|---|
docker compose up -d | docker compose -f docker-compose.yml -f docker-compose.macos.yml up -d |
The fou-nat packet gateway uses the kernel’s fou and ipip modules. On Linux, load them before starting the container with sudo modprobe fou ipip. On macOS the container runs inside Docker Desktop’s virtual machine.