Guia de Operações do OmniSCEF
OmniSCEF é a Função de Exposição de Capacidade de Serviço (SCEF) da Omnitouch para Cellular-IoT / NB-IoT. Ela expõe capacidades de rede para servidores de aplicação de terceiros (o SCS/AS) através da API RESTful T8, e termina a interface T6a Diameter em direção ao MME. Seu papel principal é Entrega de Dados Não-IP (NIDD) — permitindo que um dispositivo IoT restrito troque pequenas mensagens Não-IP com uma aplicação sem nunca ser atribuído um endereço IP — juntamente com Eventos de Monitoramento (acessibilidade, perda de conectividade, localização e relatórios de eventos relacionados).
Documentação
- Referência de Configuração — Cada parâmetro de configuração para o serviço Diameter, o endpoint da API T8 e configurações de identidade/monitoramento.
- Entrega de Dados Não-IP (NIDD) — O serviço NIDD: ciclo de vida da conexão, dados originados em dispositivos móveis e dados terminados em dispositivos móveis, entrega em grupo e Serviço de Dados Confiável.
- Eventos de Monitoramento — Inscrição e recebimento de eventos de monitoramento de UE através do T8 e T6a.
- Solução de Problemas — Problemas operacionais comuns e suas resoluções.
Visão Geral da Arquitetura
OmniSCEF é um ponto de tradução e correlação:
- Para o Norte (T8), o Servidor de Aplicação endereça um dispositivo por um Identificador Externo
(
user@domain) ou MSISDN, via HTTPS/JSON, conforme 3GPP TS 29.122. - Para o Sul (T6a), o MME endereça o assinante por IMSI e Identidade do Portador EPS (EBI), via Diameter, conforme 3GPP TS 29.128.
- OmniSCEF mantém a ligação entre os dois espaços de identidade e o estado da sessão associado.
Interfaces
| Interface | Par | Transporte | Protocolo | Especificação |
|---|---|---|---|---|
| T8 | SCS/AS | HTTPS (porta padrão 8443, sob /api) | REST / JSON | TS 29.122 |
| T6a | MME / SGSN | TCP e SCTP (porta padrão 3868) | Diameter | TS 29.128 |
| T6a (monitoramento) | HSS / nó de serviço | TCP / SCTP | Diameter (CIR/RIR) | TS 29.128, TS 29.336 |
O lado Diameter reutiliza a aplicação padrão T6a (Application-Id 16777346). As famílias de comandos NIDD e Eventos de Monitoramento operam nesta aplicação. Veja Tabelas de Referência para os códigos de comando e resultado.
Visão Geral dos Recursos
Entrega de Dados Não-IP (NIDD)
- Ciclo de vida da configuração — o AS provisiona um dispositivo (ou grupo) para NIDD; OmniSCEF resolve a identidade externa para um IMSI e autoriza a conexão T6a.
- Gerenciamento de conexão — o MME estabelece e libera a conexão T6a à medida que o UE se conecta e desconecta; o AS também pode acionar uma liberação ao excluir a configuração.
- Dados Originados em Móveis (MO) — dados Não-IP uplink do UE são entregues ao callback do AS.
- Dados Terminados em Móveis (MT) — dados Não-IP downlink do AS são entregues ao UE, com cada entrega rastreada como um recurso individual carregando seu status de entrega.
- NIDD em Grupo — um único downlink para um grupo se espalha para cada dispositivo membro.
- Serviço de Dados Confiável (RDS) — emolduramento multiplexado por porta opcional do payload Não-IP.
- Dados de exceção MO — indicações de relatório de exceção NB-IoT são apresentadas ao AS.
Eventos de Monitoramento
- Gerenciamento de inscrição — o AS se inscreve em um evento de monitoramento para um dispositivo ou grupo.
- Relatório de eventos — a rede de serviço relata eventos (acessibilidade, perda de conectividade, localização, roaming e mais); OmniSCEF entrega cada um ao AS inscrito.
Veja NIDD e Eventos de Monitoramento para os fluxos de mensagens detalhados.
Resolução de Identidade
O Servidor de Aplicação nunca vê um IMSI. OmniSCEF mapeia a identidade voltada para o AS para a identidade voltada para a rede:
A resolução é impulsionada por mapas provisionados pelo operador (veja Configurações de Identidade e Grupo). A ligação a uma conexão T6a ativa é completada quando o MME estabelece a conexão para aquele IMSI.
Início Rápido
- Provisione a identidade Diameter do OmniSCEF e os pares MME/HSS — veja Serviço Diameter.
- Provisione o mapa de identidade externa → IMSI (e quaisquer mapas de grupo) — veja Configurações de Identidade e Grupo.
- Certifique-se de que o certificado TLS do endpoint T8 esteja em vigor — veja Endpoint da API T8.
- O Servidor de Aplicação então:
- cria uma configuração NIDD ou uma inscrição de monitoramento via T8;
- recebe dados uplink / relatórios de eventos em seu callback de notificação;
- envia dados downlink via T8.
Tabelas de Referência
Comandos Diameter T6a
| Comando | Abrev. | Código | Direção | Propósito | Referência |
|---|---|---|---|---|---|
| Solicitação/Resposta de Gerenciamento de Conexão | CMR/CMA | 8388732 | MME ↔ SCEF | Estabelecer / liberar uma conexão NIDD | TS 29.128 §5.3 |
| Solicitação/Resposta de Dados MO | ODR/ODA | 8388733 | MME → SCEF | Dados Não-IP uplink (originados em móveis) | TS 29.128 §5.4 |
| Solicitação/Resposta de Dados MT | TDR/TDA | 8388734 | SCEF → MME | Dados Não-IP downlink (terminados em móveis) | TS 29.128 §5.5 |
| Solicitação/Resposta de Informação de Configuração | CIR/CIA | 8388718 | SCEF → HSS/MME | Armar um evento de monitoramento | TS 29.128 §5.6 |
| Solicitação/Resposta de Informação de Relatório | RIR/RIA | 8388719 | HSS/MME → SCEF | Relatar um evento de monitoramento | TS 29.128 §5.7 |
Códigos de Resultado Diameter
| Código | Nome | Significado | Referência |
|---|---|---|---|
| 2001 | DIAMETER_SUCCESS | Solicitação aceita / dados entregues ou armazenados em buffer | RFC 6733 §7.1.1 |
| 3001 | DIAMETER_COMMAND_UNSUPPORTED | Comando não suportado nesta aplicação | RFC 6733 §7.1.3 |
| 3002 | DIAMETER_UNABLE_TO_DELIVER | Nenhum manipulador / aplicação correspondente | RFC 6733 §7.1.3 |
| 5001 | DIAMETER_ERROR_USER_UNKNOWN | Nenhuma configuração NIDD existe para o assinante | TS 29.128 §6.5 |
| 5012 | DIAMETER_UNABLE_TO_COMPLY | Solicitação não pôde ser processada (por exemplo, UE/AS inatingível) | RFC 6733 §7.1.5 |
ID da Aplicação
| ID | Interface | Descrição | Referência |
|---|---|---|---|
| 16777346 | T6a/T6b | SCEF ↔ MME/SGSN NIDD e Eventos de Monitoramento | 3GPP TS 29.128 |