OmniLCS Web Interface Guide

The OmniLCS Control Panel is a real-time web interface served over HTTPS on port 443. It is built with Phoenix LiveView, providing live-updating views without page reloads. All pages auto-refresh every 2-3 seconds.

Overview of Pages

The navigation bar presents pages in this order:

Page	Path	Description
Dashboard	/dashboard	System overview with key metrics
Location	/location	Location services testing interface
SLs Interface	/sls	SLs (LCS-AP) interface monitoring
Cell Databases	/cells	Cell database management and import
Cell Map	/map	Interactive cell map with area selection for broadcasts
Diameter	/diameter	Diameter peer monitoring
GMLC / Le	/gmlc	GMLC Le interface monitoring, deferred session management
Send Broadcast	/send_broadcast	Unified broadcast composition across 2G/3G/4G
Active Broadcasts	/broadcasts	Monitor and stop active broadcasts
CBC 2G	/cbc	2G CBSP monitoring
CBC 3G	/cbc3g	3G SABP monitoring
CBC 4G	/cbc4g	4G SBC-AP broadcast composer and monitoring
CAP Alerts	/cap	CAP alert ingestion, approval, and broadcast monitoring
Application	/application	OTP application resource viewer (built-in)
Configuration	/configuration	Runtime configuration viewer (built-in)
Log	/log	Real-time log viewer (built-in)

Dashboard

Path: /dashboard Refresh: Every 2 seconds

The dashboard provides a high-level operational overview of the entire OmniLCS system.

Statistics Cards

Four summary cards across the top:

Card	Description
Active Sessions	Number of in-progress location sessions
Total Requests	Total location requests processed since startup
Success Rate	Percentage of completed vs total requests
Avg Response Time	Average positioning duration in milliseconds

Recent Location Requests

A table showing the 20 most recent location sessions with columns:

Column	Description
IMSI	UE identifier
Method	Positioning method (Cell, E-CID, GNSS, OTDOA, Hybrid)
MME	MME host that originated the request
Time	Request timestamp (HH:MM:SS)
Status	Color-coded badge (Active, Completed, Error, Timeout)

Connected Peers

List of SLs (LCS-AP) and Diameter peers in "Connected" state, showing:

• Peer hostname
• Interface type (SLs or Diameter)

System Status

Indicator lights for subsystem health:

Indicator	Green	Yellow	Red
SLs Interface (LCS-AP)	At least 1 MME SCTP association established	--	No MME connections
Diameter Service	At least 1 peer connected	--	No peers connected
Cell Database	Cells loaded	0 cells	--

Location

Path: /location Refresh: Every 2 seconds

Interactive location services testing interface for manually requesting UE positions.

Method Selector

Toggle buttons to select the positioning method:

Method	Description
Cell	Cell ID based, fastest, coarsest accuracy
E-CID	Enhanced Cell ID using eNB measurements via LPPa
GNSS	GPS/GNSS via LPP, highest accuracy
OTDOA	Multilateration from PRS measurements
Hybrid	Combined methods with fallback

Each method shows a description panel explaining how it works.

Request Form

• IMSI Input: Enter the IMSI of the UE to locate (e.g., 999990000000001)
• Request Location Button: Sends the location request asynchronously

Requests run as background tasks. A spinning indicator shows while the request is in progress.

Session Counts

Summary badges showing:

• Total sessions
• Active sessions
• Completed sessions
• Error count
• Results received

Session History Table

All sessions sorted by creation time (newest first):

Column	Description
IMSI	UE identifier
Method	Positioning method
MME	Target MME host
Time	Session creation time
Duration	Time to complete (ms or seconds)
Status	Active, Completed, Error, Timeout

Completed sessions expand to show:

• Coordinates: Latitude and longitude
• Uncertainty: Position uncertainty in meters
• Confidence: Confidence percentage
• Source: Actual positioning source used
• Map: Embedded OpenStreetMap showing the position

Error sessions expand to show the error reason.

Notifications

Toast notifications appear for:

• Request initiated (info)
• Location retrieved (success, with coordinates)
• Location failed (error, with reason)

Notifications auto-dismiss after 5 seconds.

SLs Interface

Path: /sls Refresh: Every 2 seconds

Monitors the SLs (LCS-AP) interface between the E-SMLC and connected MMEs. Shows SCTP association status and connected MME peers.

Interface Status

Displays the LCS Application Protocol (LCS-AP) interface status:

• Protocol reference (3GPP TS 29.171)
• Listening configuration (PPID 29, port 9082)
• Number of connected MME peers
• Green/red indicator

Statistics

Card	Description
Connected MMEs	Number of active SCTP associations to MMEs
Total Associations	Total SCTP association count

MME Peers Panel

List of connected MME SCTP associations showing peer hostname and connection state.

Cell Database

Path: /cells Refresh: Every 2 seconds

Manages the cell position database used for Cell ID positioning and OTDOA calculations. All cell data is persisted to Mnesia and survives application restarts.

Header Controls

Control	Description
Cell count	Total number of cells in the database
Last sync	Timestamp and result of the last InfluxDB sync
Sync from InfluxDB	Trigger immediate InfluxDB cell sync
Map View / Table View	Toggle between table and map display
Import Cells	Open vendor-specific import modal
Add Cell	Open manual cell entry form

Search

Search cells by Cell ID, PCI, EARFCN, cell name, or source.

Table View

Columns displayed:

Column	Description
Cell ID	Unique cell identifier
PCI	Physical Cell Identity (LTE/NR) or Primary Scrambling Code (UMTS)
EARFCN	Radio frequency channel number
Latitude	Cell latitude in decimal degrees
Longitude	Cell longitude in decimal degrees
RAT	Radio Access Technology: GSM, UMTS, LTE, or NR
Source	Data source badge: Huawei (amber, XLSX import), InfluxDB (green, sync), or Manual (blue). Import timestamp shown below the badge.
Actions	Edit and Delete buttons

Import Cells

Clicking Import Cells opens a modal with a two-step workflow:

Step 1: Vendor Selection

Select the NMS vendor for the cell data being imported:

Vendor	Import Format
Huawei	U2020 XLSX export or CSV
Nokia	NetAct RAN Export CSV
Ericsson	ENM WCDMA Export CSV
ZTE	UMS Cell Export CSV
Other / JSON	JSON array paste

Step 2: Upload

Each vendor presents the appropriate upload interface.

Huawei XLSX (recommended): Drag and drop or select one or more Huawei U2020 Cell Report .xlsx files. Supports multi-file upload — for example, upload both UMTS and LTE reports together. Files import automatically once the upload completes.

The RAT type (GSM, UMTS, LTE, or NR) is detected automatically from each file based on:

• Sheet names in the workbook (e.g., a sheet named "UMTS", "LTE", "GSM", "NR")
• Column headers in the planning data sheet (e.g., PScrambCode for UMTS, DlEarfcn for LTE, NRPCI for NR, BCCH for GSM)

The parser reads the Sheet1 tab (planning data with coordinates) and extracts:

RAT	Key Fields Imported
GSM	Cell ID, Cell Name, LAC, BCCH, BSIC, Longitude, Latitude, Antenna Height, Azimuth
UMTS	Cell ID, Cell Name, LAC, SAC, RAC, UARFCN Downlink, Scrambling Code, Longitude, Latitude, Antenna Height, Azimuth
LTE	Cell ID, Cell Name, PCI, TAC, DL EARFCN, Longitude, Latitude, Antenna Height, Cell Radius, Bandwidth
NR	Cell ID, Cell Name, NR PCI, TAC, NR DL EARFCN, Longitude, Latitude, Antenna Height, Cell Radius, Bandwidth

CSV (all vendors): Upload a CSV export from the selected NMS. The first row must be column headers. Column mapping is automatic based on the selected vendor format.

JSON: Paste a JSON array of cell objects. Required field: cell_id. Optional: pci, earfcn, latitude, longitude, lac, tac, rat.

Duplicate Handling

Importing cells with the same Cell ID as existing entries overwrites the existing data. This means re-importing the same file is safe and will update any changed values.

Data Persistence

All cell data is stored in Mnesia with disc_copies storage. Cells persist across application restarts without needing to re-import or re-sync.

Add / Edit Cell Form

Form fields organized in a grid:

Field	Description
Cell ID	Unique identifier (disabled when editing)
PCI	Physical Cell Identity (0-503)
EARFCN	Radio frequency channel number
Latitude	Decimal degrees
Longitude	Decimal degrees
Antenna Ports	1, 2, or 4
PRS Bandwidth (RBs)	6, 15, 25, 50, 75, or 100
PRS Config Index	0-4095
CP Length	Normal or Extended

Delete Confirmation

Clicking "Del" on a cell row shows a confirmation modal before deletion.

Cell Map

Path: /map

Interactive map showing all cells from the cell database on a dark-themed CartoDB base map using Leaflet. Cells are plotted as colored markers based on their RAT type.

Marker Colors

RAT	Color
GSM (2G)	Orange
UMTS (3G)	Blue
LTE (4G)	Green
NR (5G)	Purple
Unknown	Grey
Selected	Amber

Markers are clustered at lower zoom levels using Leaflet MarkerCluster. Clicking a marker shows a popup with the cell's details: Cell ID, name, technology, LAC/SAC/TAC, PCI, EARFCN, and coordinates.

Area Selection for Broadcasts

Use the polygon or rectangle drawing tools in the top-right corner to select cells within a geographic area. When cells are selected:

• The selection bar at the bottom shows the number of selected cells and unique LAC(s), SAC(s), and TAC(s)
• A Send Broadcast to Selected button appears, linking to the Send Broadcast page with the LACs, SACs, and TACs pre-filled

The Send Broadcast form auto-selects the appropriate target networks based on the selected area codes:

• LACs present → 2G (CBSP) enabled
• SACs present → 3G (SABP) enabled
• TACs present → 4G (SBc-AP) enabled

Diameter

Path: /diameter Refresh: Every 2 seconds

Monitors Diameter peer connections for the remaining Diameter interfaces (SLg and others). The E-SMLC-to-MME SLs interface uses native LCS-AP over SCTP and is monitored separately on the Dashboard page.

Interface Status

Two panels showing interface health:

Interface	Description
SLg Interface (TS 29.172)	GMLC to MME via DRA, Application ID 16777264
Other Diameter Interfaces	Additional Diameter applications as configured

Each shows a green/red indicator dot and description.

Peer Summary

Connected and disconnected peer counts displayed at the top.

Peer Table

Column	Description
Peer	Diameter host identity
Realm	Diameter realm
IP Address	Transport address (protocol://ip:port)
Status	Connected or Disconnected badge

Clicking a peer row expands to show detailed information:

Detail	Description
Connection Initiation	Whether OmniLCS initiates the connection
Transport	SCTP or TCP
Product Name	Remote peer's Diameter Product-Name
Advertised Applications	Application IDs supported by the peer

CBC 2G

Path: /cbc Refresh: Every 2 seconds

Monitors the CBSP interface for 2G cell broadcast.

Interface Info

Shows the CBSP interface status:

• Protocol reference (3GPP TS 48.049)
• Listening port number
• Number of connected peers
• Green/red indicator

Statistics Cards

Card	Description
Connected BSCs	Number of peers with status :connected
Total Connections	Total peer count (including any non-connected)
Recent Messages	Count of CBSP messages in the recent message buffer

Connected BSCs Panel

List of connected CBSP peers showing:

• Peer IP address and port
• Connection ID
• Connected timestamp
• Connection status badge

Recent CBSP Messages Panel

Table of the 20 most recent CBSP messages:

Column	Description
Time	Message timestamp (HH:MM:SS)
Peer	Connection ID of the source peer
Message	Human-readable message type (e.g., "WRITE REPLACE COMPLETE")
Type	Color-coded badge (OK for complete, FAIL for failure, ERR for error, INFO for others)

Messages are received via PubSub subscriptions to cbsp:connections and cbsp:messages topics.

CBC 3G

Path: /cbc3g Refresh: Every 2 seconds

Monitors the SABP interface for 3G cell broadcast over the Iu-BC interface (3GPP TS 25.419).

Interface Info

Shows the SABP interface status:

• Protocol reference (3GPP TS 25.419)
• Listening port number
• Number of connected RNCs
• Green/red indicator

Statistics Cards

Card	Description
Connected RNCs	Number of RNC peers with status :connected
Total Connections	Total peer count (including any non-connected)
Recent Messages	Count of SABP messages in the recent message buffer

Connected RNCs Panel

List of connected SABP peers showing:

• Peer IP address and port
• Connection ID
• Connected timestamp
• Connection status badge

Recent SABP Messages Panel

Table of the 20 most recent SABP messages:

Column	Description
Time	Message timestamp (HH:MM:SS)
Peer	Connection ID of the source RNC
Message	Human-readable message type (e.g., "WRITE REPLACE COMPLETE", "RESTART INDICATION")
Type	Color-coded badge (OK for complete, FAIL for failure, ERR for error, INFO for others)

Messages are received via PubSub subscriptions to sabp:connections and sabp:messages topics.

Send Broadcast

Path: /send_broadcast Refresh: Live

Unified broadcast composition interface for sending emergency warnings or test messages simultaneously across 2G (CBSP), 3G (SABP), and 4G (SBc-AP) networks. Select one or more target networks and the broadcast is dispatched to all connected peers on each selected network.

The default Message ID is set to 4355 (ETWS Test) for safety.

Pre-fill from Cell Map

When navigating from the Cell Map's area selection, the form is automatically populated:

• Target Networks are enabled based on the area parameters (LACs → 2G, SACs → 3G, TACs → 4G)
• LAC, SAC, and TAC fields are pre-filled with the values from the selected cells
• Cell Scope is set to "By LAC"

This allows a complete workflow: select cells geographically on the map, click "Send Broadcast to Selected", compose your message, and send.

Active Broadcasts

Path: /broadcasts Refresh: Every 3 seconds + real-time PubSub

Unified view of all active cell broadcasts across 2G (CBSP), 3G (SABP), and 4G (SBc-AP) networks in a single page. Broadcasts are tracked from the time they are sent until they are stopped or expire. The view auto-refreshes every 3 seconds and updates in real time when broadcast state changes.

Summary Cards

Card	Description
Total Active	Combined active broadcast count across all networks
2G (CBSP)	Active 2G broadcasts
3G (SABP)	Active 3G broadcasts
4G (SBC-AP)	Active 4G broadcasts

Use the Stop button on any broadcast row to cancel it on its respective network.

CBC 4G

Path: /cbc4g Refresh: Every 3 seconds

Full-featured 4G cell broadcast management interface for composing, sending, monitoring, and stopping SBC-AP broadcasts.

Statistics Cards

Card	Description
Connected MMEs	Number of established SBC-AP SCTP associations
Active Broadcasts	Number of currently active 4G broadcasts
Total Sent	Total broadcasts in history

Compose Broadcast Form

Field	Description
Message Text	Broadcast message content
Message ID	16-bit CB message identifier (e.g., 4370 for CMAS)
Serial Number	16-bit serial number
MCC	Mobile Country Code (e.g., "313")
MNC	Mobile Network Code (e.g., "380")
TACs	Comma-separated Tracking Area Codes
Warning Type	None, Earthquake, Tsunami, Earthquake + Tsunami, Test, Other
Repetition (sec)	Seconds between broadcast repetitions
Num Broadcasts	Total number of times to broadcast the message

Clicking "Send Broadcast" encodes the message (GSM 7-bit), constructs a Write-Replace-Warning-Request PDU, and sends it to all connected MMEs.

Connected MMEs Panel

List of SBC-AP SCTP associations:

• MME hostname
• IP address, port, and SCTP association ID
• Connection status badge (Connected / state name)

Active Broadcasts Panel

Table of currently active broadcasts:

Column	Description
MSG ID	Message identifier in hex (e.g., 0x1112)
SERIAL	Serial number in hex
MESSAGE	Broadcast text (truncated)
STATUS	Sent, Stopping, Stopped, Acknowledged
ACTION	Stop button (for sent/acknowledged broadcasts)

Clicking "Stop" sends a Stop-Warning-Request for the broadcast.

Broadcast History

Table of all broadcasts (last 100):

Column	Description
MSG ID	Message identifier in hex
SERIAL	Serial number in hex
MESSAGE	Broadcast text (truncated)
TIME	Sent timestamp (HH:MM:SS)
STATUS	Final status badge

State updates are received via PubSub subscriptions to cbc:state and cbc:connections topics.

CAP Alerts

Path: /cap Refresh: Every 3 seconds + real-time PubSub

Operator approval workflow for CAP (Common Alerting Protocol) alerts received from external alerting authorities. See the CAP Alert Operations Guide for full details on configuration, feed polling, and polygon resolution.

Statistics Cards

Card	Description
Pending Approval	Number of alerts awaiting operator action (amber highlight when > 0)
Active Broadcasts	Number of currently broadcasting alerts
Total Processed	Total alerts in history
Approval Mode	Current setting: "Manual" (require_approval: true) or "Auto"

Pending Alerts Panel

Only visible when require_approval is true in the CAP configuration.

Column	Description
TIME	When the alert was received
EVENT	Alert event type (e.g., "Tornado Warning")
SEVERITY	Alert severity (Extreme, Severe, Moderate, Minor)
CELLS	Number of cells matched by polygon resolution
STATUS	Pending badge (amber)
ACTIONS	Preview, Approve, Reject buttons

Preview expands to show the full alert description, source, matched TACs/LACs, message ID, and PLMN.

Approve triggers immediate broadcast via SBC-AP (4G), SABP (3G), and CBSP (2G).

Reject moves the alert to history as rejected.

Active Broadcasts Panel

Column	Description
EVENT	Alert event type
MSG ID	CB message identifier
TACs	Targeted Tracking Area Codes
STARTED	Broadcast start time
STATUS	Broadcasting (blue) or Sent (green)

Alert History Panel

Column	Description
TIME	Sent or received timestamp
EVENT	Alert event type
SEVERITY	Alert severity
CELLS	Matched cell count
TACs/LACs	Targeted area codes
STATUS	Sent (green), Rejected (red), or Failed (red)

A toast notification appears when a new pending alert is received.

GMLC / Le Interface

Path: /gmlc Refresh: Every 3 seconds + real-time PubSub

Monitoring and management for the GMLC Le interface and deferred location sessions. See the GMLC & Le Interface Operations Guide for full configuration and Diameter protocol details.

Statistics Cards

Card	Description
Active Sessions	Total active deferred location sessions
Periodic	Number of active periodic location sessions
Geo-fence	Number of active triggered/geo-fence sessions

Authorized LCS Clients Panel

Column	Description
NAME	Client identity (matched against Diameter AVPs)
TYPE	LCS client type (emergency_services, value_added_services, etc.)
ALLOWED METHODS	Positioning methods this client may request
RATE LIMIT	Requests per minute (or "Unlimited")

Active Deferred Sessions Panel

Column	Description
SESSION ID	Truncated session UUID
TYPE	Session type badge: periodic (green) or triggered (purple)
IMSI	Subscriber IMSI
METHOD	Positioning method
CLIENT	Name of the requesting LCS client
PROGRESS	Periodic: completed/total reports. Triggered: remaining reports or "Active (unlimited)"
LAST FIX	Time of the most recent position fix
ACTIONS	Cancel button to terminate the session

Session History Panel

Shows the 50 most recent completed or cancelled sessions with session ID, type, IMSI, status (completed/cancelled), and start time.

Built-in Pages

These pages are provided by the Control Panel framework.

Application (/application)

OTP application resource viewer showing:

• Running applications and their process trees
• Memory usage per process
• Message queue lengths

Configuration (/configuration)

Runtime configuration viewer displaying:

• All Application environment variables
• Grouped by application

Log (/log)

Real-time log viewer showing:

• Log messages from the ControlPanel.Logger backend
• Filterable by log level
• Auto-scrolling with pause capability