Integração Lithium (Estacionamento Inteligente)
A integração Lithium transforma estacionamentos em ambientes inteligentes: monitora as entradas e saídas de veículos em tempo real e atualiza automaticamente a quantidade de vagas disponíveis. A ocupação calculada pelo ACCELERO é publicada para os dispositivos Lithium (por exemplo, painéis de vagas), oferecendo uma experiência moderna e conectada ao controle de acesso.
Esta integração é disponibilizada como plugin (lithium) e precisa ser instalada e habilitada pela equipe técnica da IONGRADE. Consulte o suporte para verificar compatibilidade com a sua versão do ACCELERO.
Versão atual do plugin: 0.0.1 — compatível com ACCELERO 2.16.5, 2.16.6, 2.16.7 ou 2.16.8.
O que a integração faz
Com o plugin ativo, o ACCELERO passa a publicar a ocupação das áreas de estacionamento monitoradas para os dispositivos Lithium. A comunicação acontece por MQTT: o ACCELERO calcula a lotação a partir dos próprios eventos de acesso de veículos e envia o status para os dispositivos, que também podem solicitar a ocupação atual sob demanda.
| Funcionalidade | O que acontece no ACCELERO |
|---|---|
| Monitoramento de ocupação | A cada movimentação de veículo em uma área de estacionamento monitorada, a ocupação é recalculada e publicada para os dispositivos Lithium |
| Publicação sob demanda | Quando um dispositivo solicita a ocupação atual, o ACCELERO responde com o status de vagas usadas e totais de cada área configurada |
| Cadastro de dispositivos | Tela própria para gerenciar os dispositivos Lithium (descrição, serial, status) |
| Keep-alive dos dispositivos | Mensagens periódicas enviadas pelos dispositivos atualizam os metadados de cada equipamento (último contato/estado) |
A contagem de vagas é mantida automaticamente pelo controle de acesso do ACCELERO — sem operação manual e sem sensores adicionais de contagem.
Configuração
Caminho de acesso: Configurações > Integrações - Lithium
A tela possui uma aba: Geral.
Tela de configuração Configurações > Integrações - Lithium, aba Geral, mostrando a seção Dados da integração com o campo Áreas de estacionamento.
Aba Geral — Dados da integração
| Campo | Descrição |
|---|---|
| Áreas de estacionamento | Multi-seleção de áreas do ACCELERO. Apenas as áreas selecionadas têm a ocupação monitorada e publicada para os dispositivos Lithium |
Movimentações em áreas que não estão em Áreas de estacionamento não geram publicação de ocupação. Selecione todas as áreas cujas vagas devem ser exibidas pelos dispositivos.
Botões da tela
| Botão | Função |
|---|---|
| Salvar | Persiste a configuração |
| Voltar | Retorna sem salvar |
Dispositivos Lithium
Caminho de acesso: Configurações > Lithium
Lista os dispositivos Lithium cadastrados e permite criá-los, editá-los e excluí-los.
Listagem de dispositivos em Configurações > Lithium, mostrando as colunas Descrição, Serial, Metadata, Status e Ações, além do botão Novo dispositivo.
Colunas da listagem
| Coluna | Conteúdo |
|---|---|
| Descrição | Nome do dispositivo |
| Serial | Número de série do dispositivo |
| Metadata | Dados técnicos do dispositivo, atualizados automaticamente (ex.: keep-alive) |
| Status | Indica se o dispositivo está ativo |
| Ações | Editar o dispositivo |
Cadastro / edição de dispositivo
O cadastro pode ser feito pela adição inline na própria listagem (botão Novo dispositivo) ou pela tela de edição.
Formulário de cadastro/edição de dispositivo Lithium com os campos Descrição, Serial e o seletor de Status.
| Campo | Descrição |
|---|---|
| Descrição | Nome do dispositivo (3 a 50 caracteres, obrigatório) |
| Serial | Número de série do dispositivo (3 a 50 caracteres, obrigatório). Usado para identificar o equipamento nas mensagens MQTT |
| Status | Ativa ou desativa o dispositivo |
O Serial é a chave que liga as mensagens enviadas pelo dispositivo ao seu cadastro no ACCELERO. Se o serial não corresponder a nenhum dispositivo cadastrado, as mensagens recebidas são ignoradas.
Exclusão em massa
A listagem permite selecionar vários dispositivos e excluí-los de uma vez pela ação Excluir no menu Mais ações.
Como a ocupação é publicada
A integração trabalha sobre o canal MQTT. O ACCELERO calcula a ocupação de cada área de estacionamento monitorada e publica um status no formato:
| Dado | Conteúdo |
|---|---|
| area | Identificador da área |
| used | Quantidade de veículos atualmente na área (lotação atual) |
| total | Capacidade total de veículos da área |
A publicação acontece em dois momentos:
- Atualização por movimentação — quando um veículo entra ou sai de uma área monitorada (ou de uma área de origem monitorada), o ACCELERO recalcula e publica a ocupação automaticamente.
- Resposta a solicitação — quando um dispositivo Lithium solicita a ocupação atual, o ACCELERO publica o status de todas as áreas configuradas.
A ocupação considera a movimentação de veículos. A capacidade total de cada área vem da configuração da própria área no ACCELERO.
Diagrama do fluxo MQTT entre os dispositivos Lithium e o ACCELERO: movimentação de veículo → recálculo de ocupação → publicação de status; e solicitação de ocupação → resposta de status.
Casos de uso
Habilitar o estacionamento inteligente
- Solicitar à IONGRADE a instalação do plugin
lithium. - Em
Configurações > Integrações - Lithium, selecionar as Áreas de estacionamento que devem ser monitoradas. - Em
Configurações > Lithium, cadastrar os dispositivos com Descrição e Serial corretos e deixá-los ativos. - Garantir que as áreas selecionadas tenham a capacidade de veículos configurada.
- Movimentar um veículo de teste e confirmar que a ocupação publicada reflete a entrada/saída.
Trocar ou repor um dispositivo
- Cadastrar o novo dispositivo em
Configurações > Lithiumcom o Serial do equipamento. - Desativar (Status) ou excluir o dispositivo antigo.
- Confirmar que as mensagens de keep-alive do novo equipamento estão atualizando a coluna Metadata.
Boas práticas
- Áreas dedicadas ao estacionamento: selecione apenas áreas que representam estacionamentos reais para evitar publicações de ocupação irrelevantes.
- Capacidade correta: mantenha a capacidade total de veículos das áreas atualizada — ela é a base do cálculo de vagas disponíveis.
- Serial confiável: cadastre o serial exatamente como gravado no equipamento; divergências fazem o ACCELERO ignorar as mensagens do dispositivo.
- Status como controle de manutenção: desative dispositivos em manutenção em vez de excluí-los, preservando o histórico de metadados.
Troubleshooting
Os dispositivos não atualizam as vagas
Possíveis causas:
- A área não está marcada em Áreas de estacionamento.
- A capacidade de veículos da área não está configurada.
- O dispositivo está inativo (Status desligado).
Solução:
- Em
Configurações > Integrações - Lithium, confirme que a área está selecionada. - Verifique a capacidade de veículos da área.
- Em
Configurações > Lithium, confirme que o dispositivo está ativo.
As mensagens do dispositivo são ignoradas
Possíveis causas:
- O Serial informado no cadastro não corresponde ao serial do equipamento.
- O dispositivo não está cadastrado.
Solução:
- Confira o serial gravado no equipamento e compare com o cadastro em
Configurações > Lithium. - Cadastre o dispositivo caso ainda não exista.
A comunicação MQTT (publicação de ocupação, keep-alive e solicitações) depende da infraestrutura de mensageria do ACCELERO. Em caso de falha persistente, contate o suporte IONGRADE para validação do ambiente.
Integração com outros módulos
Áreas
A ocupação é calculada por Área: apenas áreas marcadas em Áreas de estacionamento são monitoradas, e a capacidade de veículos da área define o total de vagas.
Veículos e vagas veiculares
A contagem de ocupação reflete a movimentação de Veículos. Consulte também Vagas Veiculares para entender o controle de vagas no ACCELERO.
Controladores e canais
A movimentação que dispara o recálculo de ocupação vem dos eventos de acesso registrados pelos Controladores nas áreas configuradas.
Próximos Passos
- Áreas — Configure as áreas de estacionamento e suas capacidades
- Veículos — Entenda o cadastro de veículos usado na contagem
- Vagas Veiculares — Saiba como o ACCELERO controla vagas de veículos
- Controladores — Veja como as movimentações de acesso são registradas
- Plugins — Saiba mais sobre o sistema de plugins do ACCELERO