Management Plane

gRPC is the operator and local-service transport. It is used for diagnostics, operator actions, web UI integration, HLR/SMSC/packet service boundaries, the integrated HRPD AN service, and the MSC-controlled voice gateway streams. Standards interfaces such as Abis, A1, A2p, A8/A9, A10/A11, and A21 do not ride on management gRPC.

Management plane diagram

Service Layout

The management facade at 127.0.0.1:17016 gives 1xbts-web and operator tooling one stable endpoint. The MSC runtime also exposes its own management listener at 127.0.0.1:17017; HLR, SMSC, packet, and HRPD AN services run behind local service APIs that the facade/runtime reaches as clients.

Service	Endpoint	Role
`management.v1.ManagementFacadeService`	`:17016`	system overview and aggregated event stream
`bts_management.v1.BtsManagementService`	`:17016`	radio metrics, IQ capture, local radio resources, reverse power-control diagnostics
`bsc_management.v1.BscManagementService`	`:17016`	mobiles, channels, access/paging/traffic event streams, BSC status
`msc_management.v1.MscManagementService`	MSC `:17017` with facade compatibility on `:17016`	initiate/list calls and SMS submission; MSC owns SMS coordination via A1 ADDS to BSC
`pcf_management.v1.PcfManagementService`	`:17016`	packet-data radio-edge sessions and data-call actions
`pdsn_management.v1.PdsnManagementService`	`:17016`	packet-core sessions and packet trace capture
`bsc.v1.BscService`	`:17016`	compatibility API for existing web routes
`hlr.v1.HlrService`	HLR `:17019` with facade compatibility on `:17016`	subscriber and registration persistence API
`smsc.v1.SmscService`	SMSC `:17020` with facade compatibility on `:17016`	SMS submission and delivery persistence API
`packet.v1.PacketService`	packet `:17021` with facade compatibility on `:17016`	packet session service
`events.v1.EventService`	event bus `:17023`	aggregated network event stream across all components
`an.v1.AnService`	AN `:17030` when EV-DO is enabled	HRPD UATI/session/traffic service used by the integrated runtime

Aggregated Event Bus

events.v1.EventService exposes a single subscribable stream of network events from across the stack — BTS, BSC, MSC, PCF, PDSN, HLR, and SMSC. Connect once with ListenEvents and you receive everything the network is doing.

Each event carries a timestamp, the originating component (EventSource), a monotonically increasing sequence number, and a typed body specific to that component. You can filter the stream by source to receive only the components you care about.

See gRPC API → EventService for the full message schema.

The facade aggregates node-owned management and service APIs for 1xbts-web.

Management Ownership

Feature	Owning API
IQ capture and radio metrics	`BtsManagementService`
mobile list, channel list, access/paging/traffic streams	`BscManagementService`
MT call initiation, call listing, SMS submission, and MSC-owned voice gateway policy	`MscManagementService`
1x packet-data call initiation and PCF sessions	`PcfManagementService`
EV-DO / HRPD sessions	HRPD AN service and event bus, surfaced in the web UI’s HRPD session views
packet-core sessions and packet trace capture	`PdsnManagementService`
subscriber CRUD and identity resolution	`HlrService` on `:17019`, proxied by compatibility routes
SMS history and submissions	`SmscService` on `:17020` for storage; `MscManagementService` on `:17017` for new submissions

Dashboard Integration

1xbts-web talks to the management endpoint from Next.js API routes. Browser clients receive SSE streams from the web server; they do not open raw gRPC connections.

Browser -> 1xbts-web (:3000) -> management facade (:17016)
                         \-> MSC management (:17017) for MSC-owned actions
                         \-> HLR/SMSC/packet services (:17019/:17020/:17021) through facade/runtime clients
                         \-> HRPD AN (:17030) when EV-DO is enabled
      <- SSE metrics/events  <- aggregated node events

Set MANAGEMENT_GRPC_ADDRESS for the facade endpoint. BSC_GRPC_ADDRESS is accepted as a compatibility alias for the same :17016 endpoint, while MSC_GRPC_ADDRESS points 1xbts-web at MSC management on :17017.

Common grpcurl Calls

grpcurl -plaintext localhost:17016 management.v1.ManagementFacadeService/GetSystemOverview
grpcurl -plaintext localhost:17016 bts_management.v1.BtsManagementService/GetRadioMetrics
grpcurl -plaintext localhost:17016 bsc_management.v1.BscManagementService/ListMobiles
grpcurl -plaintext localhost:17017 msc_management.v1.MscManagementService/ListCalls
grpcurl -plaintext localhost:17019 hlr.v1.HlrService/ListSubscribers
grpcurl -plaintext localhost:17020 smsc.v1.SmscService/ListSmsSubmissions