• Readme in English

• Introdução:

Este repositório tem como intuito fomentar o desenvolvimento de uma plataforma de gerência multi-vendor para IoTs. Todo dispositivo que seguir o protocolo TR-369 poderá ser gerenciado. O objetivo principal é facilitar e unificar a gerência de dispositivos, o que gera inúmeros benefícios para o usuário final e prestadores de serviços, suprimindo as demandas que as tecnologias de hoje exigem: interconexão de dispositivos, coleta de dados, rápidez, disponibilidade e muito mais.

• TR-069 ---> TR-369 :

O advento da Internet das Coisas traz inúmeras oportunidades e desafios pra os prestadores de serviços, com mais de um bilhão de dispositivos espalhados pelo globo hoje, fazendo uso do TR-069, qual é o futuro do protocolo e o que podemos esperar pela frente?

O CWMP(CPE Wan Management Protocol), mais conhecido como TR-069, abriu muitas portas para o ecossistema de provedores, por meio dele é possível entregar serviços com agilidade, que servem ou ultrapassam as expectativas do cliente, fazendo uma gestão pró-ativa e segura da rede, tendo em vista também o menor custo e a maior eficiência para os prestadores de serviços.

Com a ascensão do que hoje chamamos de casa inteligente, a Internet das Coisas e a demanda por ambientes cada vez mais interconectadas e baseados em nuvem, novas demandas e obstáculos surgiram, abrindo a porta para a criação de uma nova forma de comunicação que supra as necessidades do mercado atual.

Existe uma corrida acirrada para monetizar os dispostivos IoT que hoje fazem parte da casa conectada e de outros ambientes. Como resultado disso, muitas empresas estão criando suas próprias soluções proprietárias; isso é compreensível dada tamanha pressão gerada pela promessa da monetização da Casa Inteligente. Infelizmente, essas aplicações contribuem para um ecossistema pobre, onde um provedor acaba dependente e limitado a uma solução vertical, de um único Vendor. Isso gera um ambiente de pouca competição (o que leva a maiores riscos), menos inovação, e o potencial de soluções com custos muito elevados.

As tecnologias por trás do Wi-Fi, a conectividade entre dispositivos, a Casa Inteligente e os IoTs estão em constante evolução e aprimoramento. É importante que quando os prestadores de serviços forem buscar uma solução, busquem por algo que seja a "prova de futuro", pensando sempre adiante.

Buscando resolver os desafios citados anteriormente, provedores e fabricantes juntos, desenvolveram o USP (User Services Platform), definido pela norma TR-369 da Broadband Forum, sendo este, a evolução natural do TR-069. Este novo padrão foi desenhado para ser flexível, seguro, escalonável e padronizado, para atender as demandas de um mundo conectado hoje, e no futuro.

• Empresas/Instituições envolvidas na criação do TR-369:

  • Google
  • Nokia
  • Huawei
  • Axiros
  • Orange
  • Commscope
  • Assia
  • AT&AT
  • NEC
  • Arris
  • QA Cafe

• Topologia:

• Protocolos:

  

• Notificações/Coleta de dados:

  É possível criar notificações que são disparadas em uma mudaça de valor, criação e remoção de objeto, operação completa, ou um evento. 

• OB-USP-A (Open Broadband User Services Platfrom Agent):

  • Desenhado para software embarcado (~400kb em ARM)
  • Codificado em C
  • Licença 3-Clause BSD
  • Feito para ambientes linux

• Análise de Dados

  O protocolo possui um mecanismo chamado "Bulk Data", onde é possível recolher grandes volumes de dados do dispositivo, os dados podem ser recolhidos por HTTP, ou outro MTP de telemetria definido na norma do TR, esses dados podem estar em formato JSON, CSV ou XML. Isso gera a oportunidade de utilizar IA em cima desses dados, obtendo informações relevantes que podem ser usadas tendo diversas intenções, desde a predição de eventos, KPIs, informações para a área comercial, mas também para a melhor configuração de um dispositivo.

• Wi-Fi:

  Possui mais de 130 métricas de configuração e diagnóstico de Wi-Fi, muitas dessa configurações e parâmetros são uma troca entre área de cobertura do sinal, latência e throughput. Ao implantar sistemas Wi-Fi, tende-se a manter a mesma configuração em todos os clientes, fazendo com que a tecnologia tenha uma performance abaixo do esperado. A Machine Learning aliada à análise de dados citada no tópico anterior, torna possível automatizar o gerenciamento e a optimização de redes Wireless, onde uma abordagem de big data é capax de encontrar a configuração ideal para cada dispositivo. 

• Comandos:

  É possível realizar comandos remotamente no produto, como por exemplo: atualização de firmware, reboot, reset, busca de redes vizinhas, backup, ping, diagnósticos de rede e muitos outros.

• IoT:

  
  
  

• Módulos de Software:

  Atualmente, gigantes das telecomunicações e startups, publicam software novo diariamente, ciclos de entrega lentos e processos de garantia de qualidade manuais e demorados, torna difícil a competição para integradores e prestadores de serviços. USP "Software Module Management" permite uma abordagem containerizada ao desenvolvimento de software de dispositivos embarcados, tornando possível diminuir drasticamente a chance de erro em atualições de software, também facilita a integração de terceiros em um dispositvo, manténdo ainda assim, isolada a parte de firmware do Vendor.
  

• Infraestrutura:

• API:

  • Documentação
  • Workspace de testes e desenvolvimento

• Desenvolvedor:

  Execute o aplicativo usando o Docker:

  leandro@leandro-laptop:~$ cd oktopus/devops
  leandro@leandro-laptop:~/oktopus/devops$ docker run
  

• Compilação manual básica e execução:
  • Dependências: Versão node: v14.20.0 | Versão Go: v1.18.1
  • Broker MQTT:

    leandro@leandro-laptop:~$ vá executar oktopus/backend/services/mochi/cmd/main.go -redis "127.0.0.1:6379"

  • Controlador TR-369:

    leandro@leandro-laptop:~$ execute oktopus/backend/services/controller/cmd/oktopus/main.go -u root -P root -mongo "mongodb://127.0.0.1:27017"

  • Servidor socketio:

    leandro@leandro-laptop:~$ cd oktopus/backend/services/socketio && npm i && npm start

  • Front-end:

    leandro@leandro-laptop:~$ cd oktopus/frontend && npm i && npm run dev

OBS: Não use essas instruções em produção. Para implementar o projeto em produção você pode usar mais recursos que já estão disponíveis no Oktopus, mas levaria mais tempo para explicar neste README. Em breve, haverá mais ajuda e explicações sobre essas configurações extras necessárias.
• Configurações dispositivo de teste:
• Device.LocalAgent.

  "CertificateNumberOfEntries": "0",
  "Controller.1.Alias": "",
  "Controller.1.AssignedRole": "",
  "Controller.1.BootParameterNumberOfEntries": "0",
  "Controller.1.ControllerCode": "",
  "Controller.1.Enable": "true",
  "Controller.1.EndpointID": "oktopusController",
  "Controller.1.InheritedRole": "Device.LocalAgent.ControllerTrust.Role.1",
  "Controller.1.MTP.1.Alias": "",
  "Controller.1.MTP.1.Enable": "true",
  "Controller.1.MTP.1.MQTT.Reference": "Device.MQTT.Client.1",
  "Controller.1.MTP.1.MQTT.Topic": "oktopus/v1/controller",
  "Controller.1.MTP.1.Protocol": "MQTT",
  "Controller.1.MTPNumberOfEntries": "1",
  "Controller.1.PeriodicNotifInterval": "15",
  "Controller.1.PeriodicNotifTime": "0001-01-01T00:00:00Z",
  "Controller.1.ProvisioningCode": "",
  "Controller.1.USPNotifRetryIntervalMultiplier": "2000",
  "Controller.1.USPNotifRetryMinimumWaitInterval": "5",
  "ControllerNumberOfEntries": "1",
  "ControllerTrust.ChallengeNumberOfEntries": "0",
  "ControllerTrust.CredentialNumberOfEntries": "0",
  "ControllerTrust.Role.1.Alias": "cpe-1",
  "ControllerTrust.Role.1.Enable": "true",
  "ControllerTrust.Role.1.Name": "Full Access",
  "ControllerTrust.Role.1.Permission.1.Alias": "cpe-1",
  "ControllerTrust.Role.1.Permission.1.CommandEvent": "r-xn",
  "ControllerTrust.Role.1.Permission.1.Enable": "true",
  "ControllerTrust.Role.1.Permission.1.InstantiatedObj": "rw-n",
  "ControllerTrust.Role.1.Permission.1.Obj": "rw-n",
  "ControllerTrust.Role.1.Permission.1.Order": "0",
  "ControllerTrust.Role.1.Permission.1.Param": "rw-n",
  "ControllerTrust.Role.1.Permission.1.Targets": "Device.",
  "ControllerTrust.Role.1.PermissionNumberOfEntries": "1",
  "ControllerTrust.RoleNumberOfEntries": "2",
  "EndpointID": "os::4851CF-000000000002",
  "MTP.1.Alias": "",
  "MTP.1.Enable": "false",
  "MTP.1.MQTT.PublishQoS": "0",
  "MTP.1.MQTT.Reference": "Device.MQTT.Client.1",
  "MTP.1.MQTT.ResponseTopicConfigured": "oktopus/v1/controller",
  "MTP.1.MQTT.ResponseTopicDiscovered": "oktopus/v1/agent/os::4851CF-000000000002",
  "MTP.1.Protocol": "MQTT",
  "MTP.1.Status": "Down",
  "MTPNumberOfEntries": "1",
  "RequestNumberOfEntries": "0",
  "SoftwareVersion": "5.0.0",
  "SubscriptionNumberOfEntries": "0",
  "SupportedFingerprintAlgorithms": "SHA-1, SHA-224, SHA-256, SHA-384, SHA-512",
  "SupportedProtocols": "STOMP, CoAP, MQTT, WebSocket",
  "UpTime": "42"
  

• Device.MQTT.Client.1

"Alias": "cpe-1",
"BrokerAddress": "10.100.250.4",
"BrokerPort": "1883",
"CleanSession": "false",
"CleanStart": "false",
"ClientID": "",
"ConnectRetryIntervalMultiplier": "2000",
"ConnectRetryMaxInterval": "30720",
"ConnectRetryTime": "5",
"Enable": "true",
"KeepAliveTime": "30",
"Name": "",
"Password": "",
"ProtocolVersion": "5.0",
"RequestProblemInfo": "false",
"RequestResponseInfo": "false",
"ResponseInformation": "oktopus/v1/agent/os::4851CF-000000000002",
"Status": "Connected",
"Subscription.1.Alias": "cpe-1",
"Subscription.1.Enable": "false",
"Subscription.1.QoS": "1",
"Subscription.1.Topic": "oktopus/v1/agent",
"SubscriptionNumberOfEntries": "1",
"TransportProtocol": "TCP/IP",
"Username": "test"

Vai usar nosso projeto na sua empresa? gostaria de conversar sobre o TR-369 e gerenciamento de IoTs, estamos online no Slack.

Caso você tenha interesse em informações internas sobre o time e nossas pretensões acesse nossa Wiki.

Fontes bibliográficas: MU-461.pdf, TR-369.html, USP Training Session Slides