OmniSCEF 操作指南
OmniSCEF 是 Omnitouch 的 服务能力暴露功能 (SCEF),用于蜂窝物联网 / NB-IoT。 它通过 T8 RESTful API 向第三方应用服务器 (SCS/AS) 暴露网络能力,并终止与 MME 的 T6a Diameter 接口。它的主要角色是 非 IP 数据传输 (NIDD) — 让受限的物联网设备在不分配 IP 地址的情况下与应用程序交换小型非 IP 消息 — 以及 监控事件(可达性、连接丢失、位置和相关事件报告)。
文档
- 配置参考 — Diameter 服务、T8 API 端点和身份/监控设置的每个配置参数。
- 非 IP 数据传输 (NIDD) — NIDD 服务:连接生命周期、移动发起和移动终止数据、组传输和可靠数据服务。
- 监控事件 — 通过 T8 和 T6a 订阅和接收 UE 监控事件。
- 故障排除 — 常见操作问题及其解决方案。
架构概述
OmniSCEF 是一个 翻译和关联点:
- 北向 (T8),应用服务器通过 外部标识符 (
user@domain) 或 MSISDN 通过 HTTPS/JSON 地址设备,符合 3GPP TS 29.122。 - 南向 (T6a),MME 通过 IMSI 和 EPS 承载标识 (EBI) 通过 Diameter 地址用户,符合 3GPP TS 29.128。
- OmniSCEF ���有两个身份空间及其关联会话状态之间的绑定。
接口
| 接口 | 对端 | 传输 | 协议 | 规范 |
|---|---|---|---|---|
| T8 | SCS/AS | HTTPS (默认端口 8443,位于 /api) | REST / JSON | TS 29.122 |
| T6a | MME / SGSN | TCP 和 SCTP (默认端口 3868) | Diameter | TS 29.128 |
| T6a (监控) | HSS / 服务节点 | TCP / SCTP | Diameter (CIR/RIR) | TS 29.128, TS 29.336 |
Diameter 端重用标准 T6a 应用 (应用 ID 16777346)。NIDD 和监控事件命令族都在此应用上运行。请参见 参考表 以获取命令和结果代码。
功能概述
非 IP 数据传输 (NIDD)
- 配置生命周期 — AS 为设备(或组)配置 NIDD;OmniSCEF 将外部身份解析为 IMSI 并授权 T6a 连接。
- 连接管理 — MME 在 UE 附着和分离时建立和释放 T6a 连接;AS 还可以通过删除配置触发释放。
- 移动发起 (MO) 数据 — 从 UE 发出的上行非 IP 数据被传递到 AS 回调。
- 移动终止 (MT) 数据 — 从 AS 发出的下行非 IP 数据被传递到 UE,每次传递都作为一个单独的资源进行跟踪,携带其传递状态。
- 组 NIDD — 单个下行到一个组分发到每个成员设备。
- 可靠数据服务 (RDS) — 可选的端口复用非 IP 负载的帧。
- MO 异常数据 — NB-IoT 异常报告指示被传递到 AS。
监控事件
- 订阅管理 — AS 为设备或组订阅监控事件。
- 事件报告 — 服务网络报告事件(可达性、连接丢失、位置、漫游等);OmniSCEF 将每个事件传递给订阅的 AS。
身份解析
应用服务器从未看到 IMSI。OmniSCEF 将 AS 面向的身份映射到网络面向的身份:
解析由运营商提供的映射驱动(请参见 身份和组设置)。当 MME 为该 IMSI 建立连接时,绑定到活动 T6a 连接的过程完成。
快速开始
- 配置 OmniSCEF Diameter 身份和 MME/HSS 对端 — 请参见 Diameter 服务。
- 配置外部身份 → IMSI 映射(和任何组映射) — 请参见 身份和组设置。
- 确保 T8 端点的 TLS 证书已到位 — 请参见 T8 API 端点。
- 应用服务器然后:
- 通过 T8 创建 NIDD 配置或监控订阅;
- 在其通知回调上接收上行数据/事件报告;
- 通过 T8 发送下行数据。
参考表
T6a Diameter 命令
| 命令 | 缩写 | 代码 | 方向 | 目的 | 参考 |
|---|---|---|---|---|---|
| 连接管理请求/应答 | CMR/CMA | 8388732 | MME ↔ SCEF | 建立/释放 NIDD 连接 | TS 29.128 §5.3 |
| MO 数据请求/应答 | ODR/ODA | 8388733 | MME → SCEF | 上行(移动发起)非 IP 数据 | TS 29.128 §5.4 |
| MT 数据请求/应答 | TDR/TDA | 8388734 | SCEF → MME | 下行(移动终止)非 IP 数据 | TS 29.128 §5.5 |
| 配置信息请求/应答 | CIR/CIA | 8388718 | SCEF → HSS/MME | 触发监控事件 | TS 29.128 §5.6 |
| 报告信息请求/应答 | RIR/RIA | 8388719 | HSS/MME → SCEF | 报告监控事件 | TS 29.128 §5.7 |
Diameter 结果代码
| 代码 | 名称 | 意义 | 参考 |
|---|---|---|---|
| 2001 | DIAMETER_SUCCESS | 请求被接受 / 数据已交付或缓冲 | RFC 6733 §7.1.1 |
| 3001 | DIAMETER_COMMAND_UNSUPPORTED | 此应用程序不支持命令 | RFC 6733 §7.1.3 |
| 3002 | DIAMETER_UNABLE_TO_DELIVER | 没有匹配的处理程序 / 应用程序 | RFC 6733 §7.1.3 |
| 5001 | DIAMETER_ERROR_USER_UNKNOWN | 订阅者没有 NIDD 配置 | TS 29.128 §6.5 |
| 5012 | DIAMETER_UNABLE_TO_COMPLY | 请求无法处理(例如,UE/AS 无法到达) | RFC 6733 §7.1.5 |
应用 ID
| ID | 接口 | 描述 | 参考 |
|---|---|---|---|
| 16777346 | T6a/T6b | SCEF ↔ MME/SGSN NIDD 和监控事件 | 3GPP TS 29.128 |