Selenium — Integração MQTT
Este documento descreve a configuração da comunicação MQTT dos gateways de elevador SELENIUM com o sistema de controle de acesso. O conteúdo é de uso interno/restrito e não deve ser publicado no portal público.
Os gateways de elevador SELENIUM comunicam-se com o sistema Accelero através de um broker MQTT, que pode ser o Accelero Cloud ou um broker customizado. Este documento descreve os campos da tela de configuração MQTT disponível no modo de configuração do gateway.
A tela de configuração MQTT é idêntica nas três variantes do Selenium, por isso a documentação é consolidada:
| Variante | Aplicação |
|---|---|
| SELENIUM_AS | Gateway de elevador Atlas Schindler (chamada antecipada) |
| SELENIUM_TK | Gateway de elevador ThyssenKrupp (chamada antecipada) |
| SELENIUM_KB | Gateway de elevador — controle de uso de botões |
Fonte: SELENIUM — Manuais de Hardware (AS v1.4, TK v1.7 e KB; firmware 2023), seção Comunicação → MQTT. Os campos da tela são os mesmos nas três variantes.
Acesso à configuração
O gateway é configurado através de um navegador (browser). Para acessar a configuração coloque o gateway no modo Configuração (ligue o equipamento, aguarde a entrada em operação normal e pressione o botão BOOT por 6 segundos), conecte-se à rede WiFi do gateway (SSID no padrão selenium<código>, ex.: selenium7512208F) e direcione o navegador para o endereço 192.168.4.1. Os valores padrão de login são usuário admin e senha seleniumpwd.
A tela inicial de configuração apresenta o menu Comunic, que dá acesso às telas de configuração de comunicação de rede, entre elas a tela MQTT:
| Item da tela Comunicação | Função |
|---|---|
| Conexão | Tipo de mídia usado para conexão à rede (WiFi ou Ethernet) no modo operação |
| WiFi | Parâmetros da rede WiFi a ser usada no modo operação |
| Ethernet | Parâmetros da rede cabeada (RJ45) a ser usada no modo operação |
| MQTT | Parâmetros para acessar o servidor de comunicação MQTT (Broker) |
Tela de configuração MQTT
Nesta tela são informados os parâmetros de comunicação para estabelecer a conexão com o servidor de comunicação MQTT. Também são fornecidas informações sobre a instalação física do gateway.
| Campo | Descrição |
|---|---|
| Conexão | Define se a placa deve conectar-se ao broker MQTT Accelero Cloud, a um broker MQTT customizado ou a nenhum broker MQTT. Quando selecionada a opção "Automático", apenas o campo Facility Id deve ser preenchido. |
| Facility Id | Identificação única da instalação. Todos os gateways de uma instalação devem ter o mesmo Facility Id. Ex.: empresax, edificioz. |
| TLS | Marque esta opção caso o gateway deva estabelecer a comunicação com o broker MQTT no modo seguro (Transport Layer Security). É necessário que o servidor permita este modo de comunicação. |
| Broker | Endereço URL do servidor de comunicação utilizado na instalação. |
| Port | Número da porta de comunicação para comunicação com o broker MQTT. |
| User name | Nome do usuário para acesso ao broker MQTT. |
| Password | Senha de acesso ao broker MQTT. |
| Device Id | Identificação única e exclusiva de cada gateway na instalação. Ex.: catraca1, porta2. |
Faça as alterações necessárias e clique em Salvar para confirmar.
Quando a conexão é feita através do Accelero Cloud, apenas o parâmetro Facility Id deve ser configurado, exatamente como definido no sistema de controle que administrará os gateways.
Protocolo MQTT (tópicos e mensagens)
Os Manuais de Hardware do Selenium descrevem apenas a tela de configuração da conexão MQTT, não a estrutura de tópicos nem o formato das mensagens JSON trocadas entre o gateway e o sistema de controle de acesso. Documentar o protocolo (tópicos facility/alias/to e facility/alias/from, mensagens e tabelas tópico→descrição) a partir do manual de integração específico do Selenium, quando disponível. O protocolo é provavelmente compatível com o das demais famílias de hardware Iongrade (placa Titanium), como a Indium e a Titanium, o que deve ser confirmado com o firmware antes de adotar como referência.