OmniLCS Web 界面指南

OmniLCS 控制面板是一个通过 HTTPS 在 443 端口提供的实时 Web 界面。它基于 Phoenix LiveView 构建，提供无需页面重新加载的实时更新视图。所有页面每 2-3 秒自动刷新。

页面概述

导航栏按以下顺序呈现页面：

页面	路径	描述
仪表板	/dashboard	系统概述及关键指标
位置	/location	位置服务测试界面
SLs 接口	/sls	SLs (LCS-AP) 接口监控
小区数据库	/cells	小区数据库管理和导入
小区地图	/map	交互式小区地图，支持广播区域选择
Diameter	/diameter	Diameter 对等监控
GMLC / Le	/gmlc	GMLC Le 接口监控，延迟会话管理
发送广播	/send_broadcast	跨 2G/3G/4G 的统一广播编排
活动广播	/broadcasts	监控和停止活动广播
CBC 2G	/cbc	2G CBSP 监控
CBC 3G	/cbc3g	3G SABP 监控
CBC 4G	/cbc4g	4G SBC-AP 广播编排和监控
CAP 警报	/cap	CAP 警��摄取、批准和广播监控
应用程序	/application	OTP 应用程序资源查看器（内置）
配置	/configuration	运行时配置查看器（内置）
日志	/log	实时日志查看器（内置）

仪表板

路径: /dashboard
刷新: 每 2 秒

仪表板提供整个 OmniLCS 系统的高层次操作概述。

统计卡片

顶部有四个摘要卡片：

卡片	描述
活动会话	正在进行的位置会话数量
总请求	自启动以来处理的位置请求总数
成功率	完成请求与总请求的百分比
平均响应时间	平均定位持续时间（毫秒）

最近位置请求

显示 20 个最近位置会话的表格，列包括：

列	描述
IMSI	UE 标识符
方法	定位方法（小区、E-CID、GNSS、OTDOA、混合）
MME	发起请求的 MME 主机
时间	请求时间戳（HH:MM:SS）
状态	颜色编码的徽章（活动、完成、错误、超时）

连接的对等体

显示处于“连接”状态的 SLs (LCS-AP) 和 Diameter 对等体列表，包括：

• 对等体主机名
• 接口类型（SLs 或 Diameter）

系统状态

子系统健康指示灯：

指示器	绿色	黄色	红色
SLs 接口 (LCS-AP)	至少建立 1 个 MME SCTP 关联	--	无 MME 连接
Diameter 服务	至少 1 个对等体连接	--	无对等体连接
小区数据库	小区已加载	0 个小区	--

位置

路径: /location
刷新: 每 2 秒

交互式位置服务测试界面，用于手动请求 UE 位置。

方法选择器

切换按钮选择定位方法：

方法	描述
小区	基于小区 ID，速度最快，精度最低
E-CID	使用 LPPa 通过 eNB 测量的增强小区 ID
GNSS	通过 LPP 的 GPS/GNSS，精度最高
OTDOA	从 PRS 测量进行多边定位
混合	结合方法并提供后备

每种方法显示一个描述面板，解释其工作原理。

请求表单

• IMSI 输入: 输入要定位的 UE 的 IMSI（例如，999990000000001）
• 请求位置按钮: 异步发送位置请求

请求作为后台任务运行。请求进行时，旋转指示器显示。

会话计数

摘要徽章显示：

• 总会话
• 活动会话
• 完成会话
• 错误计数
• 收到的结果

会话历史表

按创建时间（最新优先）排序的所有会话：

列	描述
IMSI	UE 标识符
方法	定位方法
MME	目标 MME 主机
时间	会话创建时间
持续时间	完成时间（毫秒或秒）
状态	活动、完成、错误、超时

完成的会话展开显示：

• 坐标: 纬度和经度
• 不确定性: 位置不确定性（米）
• 置信度: 置信度百分比
• 来源: 实际使用的定位来源
• 地图: 嵌入的 OpenStreetMap 显示位置

错误会话展开显示错误原因。

通知

通知弹出框显示：

• 请求已发起（信息）
• 位置已获取（成功，带坐标）
• 位置获取失败（错误，带原因）

通知在 5 秒后自动消失。

SLs 接口

路径: /sls
刷新: 每 2 秒

监控 E-SMLC 和连接的 MMEs 之间的 SLs (LCS-AP) 接口。显示 SCTP 关联状态和连接的 MME 对等体。

接口状态

显示 LCS 应用协议 (LCS-AP) 接口状态：

• 协议参考 (3GPP TS 29.171)
• 监听配置 (PPID 29，端口 9082)
• 连接的 MME 对等体数量
• 绿色/红色指示器

统计

卡片	描述
连接的 MMEs	活动 SCTP 关联到 MMEs 的数量
总关联	SCTP 关联总数

MME 对等体面板

��示连接的 MME SCTP 关联列表，显示对等体主机名和连接状态。

小区数据库

路径: /cells
刷新: 每 2 秒

管理用于小区 ID 定位和 OTDOA 计算的小区位置数据库。所有小区数据持久化到 Mnesia，并在应用程序重启后仍然存在。

头部控制

控件	描述
小区数量	数据库中小区的总数
最后同步	上次 InfluxDB 同步的时间戳和结果
从 InfluxDB 同步	触发立即的 InfluxDB 小区同步
地图视图 / 表格视图	在表格和地图显示之间切换
导入小区	打开特定于供应商的导入模态
添加小区	打开手动小区输入表单

搜索

按小区 ID、PCI、EARFCN、小区名称或来源搜索小区。

表格视图

显示的列：

列	描述
小区 ID	唯一的小区标识符
PCI	物理小区身份 (LTE/NR) 或主扰码 (UMTS)
EARFCN	无线频率信道编号
纬度	小区纬度（十进制度）
经度	小区经度（十进制度）
RAT	无线接入技术：GSM、UMTS、LTE 或 NR
来源	数据来源徽章：华为（琥珀色，XLSX 导入）、InfluxDB（绿色，同步）或 手动（蓝色）。徽章下方显示导入时间戳。
操作	编辑和删除按钮

导入小区

点击 导入小区 打开一个具有两步工作流程的模态：

第一步：供应商选择

选择要导入的小区数据的 NMS 供应商：

供应商	导入格式
华为	U2020 XLSX 导出或 CSV
诺基亚	NetAct RAN 导出 CSV
爱立信	ENM WCDMA 导出 CSV
中兴	UMS 小区导出 CSV
其他 / JSON	JSON 数组粘贴

第二步：上传

每个供应商提供适当的上传界面。

华为 XLSX（推荐）：拖放或选择一个或多个华为 U2020 小区报告 .xlsx 文件。支持多文件上传——例如，同时上传 UMTS 和 LTE 报告。文件在上传完成后自动导入。

RAT 类型（GSM、UMTS、LTE 或 NR）根据以下内容自动检测：

• 工作簿中的表名（例如，名为 "UMTS"、"LTE"、"GSM"、"NR" 的表）
• 规划数据表中的列标题（例如，PScrambCode 对于 UMTS，DlEarfcn 对于 LTE，NRPCI 对于 NR，BCCH 对于 GSM）

解析器读取 Sheet1 标签（带坐标的规划数据）并提取：

RAT	导入的关键字段
GSM	小区 ID、小区名称、LAC、BCCH、BSIC、经度、纬度、天线高度、方位角
UMTS	小区 ID、小区名称、LAC、SAC、RAC、UARFCN 下行、扰码、经度、纬度、天线高度、方位角
LTE	小区 ID、小区名称、PCI、TAC、DL EARFCN、经度、纬度、天线高度、小区半径、带宽
NR	小区 ID、小区名称、NR PCI、TAC、NR DL EARFCN、经度、纬度、天线高度、小区半径、带宽

CSV（所有供应商）：上传从所选 NMS 导出的 CSV。第一行必须是列标题。根据所选供应商格式，列映射是自动的。

JSON：粘贴小区对象的 JSON 数组。必填字段：cell_id。可选字段：pci、earfcn、latitude、longitude、lac、tac、rat。

重复处理

导入与现有条目具有相同小区 ID 的小区将覆盖现有数据。这意味着重新导入相同文件是安全的，并将更新任何更改的值。

数据持久性

所有小区数据存储在 Mnesia 中，使用 disc_copies 存储。小区在应用程序重启后持久存在，无需重新导入或重新同步。

添加 / 编辑小区表单

表单字段以网格形式组织：

字段	描述
小区 ID	唯一标识符（编辑时禁用）
PCI	物理小区身份 (0-503)
EARFCN	无线频率信道编号
纬度	十进制度
经度	十进制度
天��端口	1、2 或 4
PRS 带宽 (RBs)	6、15、25、50、75 或 100
PRS 配置索引	0-4095
CP 长度	正常或扩展

删除确认

点击小区行上的“Del”会在删除之前显示确认模态。

小区地图

路径: /map

交互式地图显示来自小区数据库的所有小区，使用 Leaflet 在深色主题的 CartoDB 基础地图上。小区根据其 RAT 类型绘制为彩色标记。

标记颜色

RAT	颜色
GSM (2G)	橙色
UMTS (3G)	蓝色
LTE (4G)	绿色
NR (5G)	紫色
未知	灰色
选中	琥珀色

标记在较低缩放级别下使用 Leaflet MarkerCluster 进行聚类。点击标记会显示一个弹出窗口，显示小区的详细信息：小区 ID、名称、技术、LAC/SAC/TAC、PCI、EARFCN 和坐标。

广播区域选择

使用右上角的多边形或矩形绘图工具选择地理区域内的小区。当小区被选择时：

• 底部的选择栏显示所选小区的数量和唯一的 LAC(s)、SAC(s) 和 TAC(s)
• 出现一个 发送广播到选定小区 按钮，链接到发送广播页面，LACs、SACs 和 TACs 会预填充

发送广播表单会根据所选区域代码自动选择适当的目标网络：

• 存在 LACs → 启用 2G (CBSP)
• 存在 SACs → 启用 3G (SABP)
• 存在 TACs → 启用 4G (SBc-AP)

Diameter

路径: /diameter
刷新: 每 2 秒

监控剩余 Diameter 接口（SLg 和其他）的 Diameter 对等体连接。E-SMLC 到 MME 的 SLs 接口使用原生 LCS-AP 通过 SCTP，并在仪表板页面单独监控。

接口状态

两个面板显示接口健康状况：

接口	描述
SLg 接口 (TS 29.172)	GMLC 到 MME 通过 DRA，应用 ID 16777264
其他 Diameter 接口	根据配置的其他 Diameter 应用

每个面板显示一个绿色/红色指示器和描述。

对等体摘要

顶部显示连接和断开连接的对等体计数。

对等体表

列	描述
对等体	Diameter 主机身份
领域	Diameter 领域
IP 地址	传输地址 (protocol://ip:port)
状态	连接或断开连接徽章

点击对等体行展开以显示详细信息：

详细信息	描述
连接发起	OmniLCS 是否发起连接
传输	SCTP 或 TCP
产品名称	远程对等体的 Diameter 产品名称
广告应用	对等体支持的应用 ID

CBC 2G

路径: /cbc
刷新: 每 2 秒

监控 2G 小区广播的 CBSP 接口。

接口��息

显示 CBSP 接口状态：

• 协议参考 (3GPP TS 48.049)
• 监听端口号
• 连接的对等体数量
• 绿色/红色指示器

统计卡片

卡片	描述
连接的 BSCs	状态为 :connected 的对等体数量
总连接	总对等体计数（包括任何未连接的）
最近消息	最近消息缓冲区中的 CBSP 消息计数

连接的 BSCs 面板

显示连接的 CBSP 对等体列表，包括：

• 对等体 IP 地址和端口
• 连接 ID
• 连接时间戳
• 连接状态徽章

最近 CBSP 消息面板

显示 20 条最近的 CBSP 消息的表格：

列	描述
时间	消息时间戳（HH:MM:SS）
对等体	源对等体的连接 ID
消息	可读的消息类型（例如，“WRITE REPLACE COMPLETE”）
类型	颜色编码的徽章（完成为 OK，失败为 FAIL，错误为 ERR，其他为 INFO）

消息通过对 cbsp:connections 和 cbsp:messages 主题的 PubSub 订阅接收。

CBC 3G

路径: /cbc3g
刷新: 每 2 秒

监控通过 Iu-BC 接口的 3G 小区广播的 SABP 接口（3GPP TS 25.419）。

接口信息

显示 SABP 接口状态：

• 协议参考 (3GPP TS 25.419)
• 监听端口号
• 连接的 RNC 数量
• 绿色/红色指示器

���计卡片

卡片	描述
连接的 RNCs	状态为 :connected 的 RNC 对等体数量
总连接	总对等体计数（包括任何未连接的）
最近消息	最近消息缓冲区中的 SABP 消息计数

连接的 RNCs 面板

显示连接的 SABP 对等体列表，包括：

• 对等体 IP 地址和端口
• 连接 ID
• 连接时间戳
• 连接状态徽章

最近 SABP 消息面板

显示 20 条最近的 SABP 消息的表格：

列	描述
时间	消息时间戳（HH:MM:SS）
对等体	源 RNC 的连接 ID
消息	可读的消息类型（例如，“WRITE REPLACE COMPLETE”、“RESTART INDICATION”）
类型	颜色编码的徽章（完成为 OK，失败为 FAIL，错误为 ERR，其他为 INFO）

消息通过对 sabp:connections 和 sabp:messages 主题的 PubSub 订阅接收。

发送广播

路径: /send_broadcast
刷新: 实时

统一的广播编排界面，用于同时在 2G (CBSP)、3G (SABP) 和 4G (SBc-AP) 网络上发送紧急警告或测试消息。选择一个或多个目标网络，广播将发送到每个选定网络上的所有连接对等体。

默认消息 ID 设置为 4355 (ETWS 测试) 以确保安全。

从小区地图预填充

从小区地图���区域选择导航时，表单会自动填充：

• 目标网络 根据区域参数启用（LACs → 2G，SACs → 3G，TACs → 4G）
• LAC、SAC 和 TAC 字段 预填充所选小区的值
• 小区范围 设置为“按 LAC”

这允许一个完整的工作流程：在地图上按地理位置选择小区，点击“发送广播到选定小区”，编写消息并发送。

活动广播

路径: /broadcasts
刷新: 每 3 秒 + 实时 PubSub

统一视图显示所有 2G (CBSP)、3G (SABP) 和 4G (SBc-AP) 网络的活动小区广播。广播从发送时开始跟踪，直到停止或过期。视图每 3 秒自动刷新，并在广播状态变化时实时更新。

摘要卡片

卡片	描述
总活动	所有网络的活动广播总数
2G (CBSP)	活动的 2G 广播
3G (SABP)	活动的 3G 广播
4G (SBC-AP)	活动的 4G 广播

使用任何广播行上的停止按钮在其各自网络上取消广播。

CBC 4G

路径: /cbc4g
刷新: 每 3 秒

功能齐全的 4G 小区广播管理界面，用于编排、发送、监控和停止 SBC-AP 广播。

统计卡片

卡片	描述
连接的 MMEs	已建立的 SBC-AP SCTP 关联数量
活动广播	当前活动的 4G 广播数量
总发送	历史中的广播总数

编排广播表单

字段	描述
消息文本	广播消息内容
消息 ID	16 位 CB 消息标识符（例如，4370 表示 CMAS）
序列号	16 位序列号
MCC	移动国家代码（例如，“313”）
MNC	移动网络代码（例如，“380”）
TACs	逗号分隔的跟踪区域代码
警告类型	无、地震、海啸、地震 + 海啸、测试、其他
重复（秒）	广播重复之间的秒数
广播次数	广播消息的总次数

点击“发送广播”会对消息进行编码（GSM 7 位），构建一个写替换警告请求 PDU，并将其发送给所有连接的 MMEs。

连接的 MMEs 面板

显示 SBC-AP SCTP 关联列表：

• MME 主机名
• IP 地址、端口和 SCTP 关联 ID
• 连接状态徽章（已连接 / 状态名称）

活动广播面板

当前活动广播的表格：

列	描述
MSG ID	以十六进制表示的消息标识符（例如，0x1112）
SERIAL	以十六进制表示的序列号
MESSAGE	广播文本（截断）
STATUS	已发送、停止中、已停止、已确认
ACTION	停止按钮（对于已发���/已确认的广播）

点击“停止”会发送一个停止警告请求以停止广播。

广播历史

所有广播的表格（最后 100 条）：

列	描述
MSG ID	以十六进制表示的消息标识符
SERIAL	以十六进制表示的序列号
MESSAGE	广播文本（截断）
TIME	发送时间戳（HH:MM:SS）
STATUS	最终状态徽章

状态更新通过对 cbc:state 和 cbc:connections 主题的 PubSub 订阅接收。

CAP 警报

路径: /cap
刷新: 每 3 秒 + 实时 PubSub

来自外部警报机构的 CAP（通用警报协议）警报的操作员批准工作流程。有关配置、馈送轮询和多边形解析的完整详细信息，请参见 CAP 警报操作指南。

统计卡片

卡片	描述
待批准	等待操作员操作的警报数量（当 > 0 时高亮琥珀色）
活动广播	当前正在广播的警报数量
总处理	历史中的总警报数量
批准模式	当前设置：“手动”（require_approval: true）或“自动”

待处理警报面板

仅在 CAP 配置中 require_approval 为 true 时可见。

列	描述
TIME	��报接收时间
EVENT	警报事件类型（例如，“龙卷风警告”）
SEVERITY	警报严重性（极端、严重、中等、轻微）
CELLS	多边形解析匹配的小区数量
STATUS	待处理徽章（琥珀色）
ACTIONS	预览、批准、拒绝按钮

预览 展开以显示完整的警报描述、来源、匹配的 TACs/LACs、消息 ID 和 PLMN。

批准 触发通过 SBC-AP (4G)、SABP (3G) 和 CBSP (2G) 的立即广播。

拒绝 将警报移至历史记录并标记为拒绝。

活动广播面板

列	描述
EVENT	警报事件类型
MSG ID	CB 消息标识符
TACs	目标跟踪区域代码
STARTED	广播开始时间
STATUS	正在广播（蓝色）或已发送（绿色）

警报历史面板

列	描述
TIME	发送或接收时间戳
EVENT	警报事件类型
SEVERITY	警报严重性
CELLS	匹配的小区数量
TACs/LACs	目标区域代码
STATUS	已发送（绿色）、已拒绝（红色）或失败（红色）

当收到新的待处理警报时，会出现一个通知弹出框。

GMLC / Le 接口

路径: /gmlc
刷新: 每 3 秒 + 实时 PubSub

监控和管理 GMLC Le 接口和延迟位置会话。有关完整配置和 Diameter 协议的详细信息，请参见 GMLC & Le 接口操作指南。

统计卡片

卡片	描述
活动会话	总活动的延迟位置会话
定期	活动的定期位置会话数量
地理围栏	活动的触发/地理围栏会话数量

授权 LCS 客户端面板

列	描述
NAME	客户端身份（与 Diameter AVPs 匹配）
TYPE	LCS 客户端类型（紧急服务、增值服务等）
ALLOWED METHODS	此客户端可以请求的定位方法
RATE LIMIT	每分钟请求数（或“无限制”）

活动延迟会话面板

列	描述
SESSION ID	截断的会话 UUID
TYPE	会话类型徽章：定期（绿色）或触发（紫色）
IMSI	订阅者 IMSI
METHOD	定位方法
CLIENT	请求 LCS 客户端的名称
PROGRESS	定期：完成/总报告。触发：剩余报告或“活动（无限制）”
LAST FIX	最近位置修正的时间
ACTIONS	取消按钮以终止会话

会话历史面板

显示最近 50 个完成或取消的会话，包括会话 ID、类型、IMSI、状态（完成/取消）和开始时间。

内置页面

这些页面由控制面板框架提供。

应用程序 (/application)

OTP 应用程序资源查看器，显示：

• 正在运行的应用程序及其进程树
• 每个进程的内存使用情况
• 消息队列长度

配置 (/configuration)

运行时配置查看器，显示：

• 所有应用程序环境变量
• 按应用程序分组

日志 (/log)

实时日志查看器，显示：

• 来自 ControlPanel.Logger 后端的日志消息
• 可按日志级别过滤
• 自动滚动并具备暂停功能