Início rápido: concluir a primeira malha de estratégia do EMS Builder

Este guia usa um ambiente de testes para concluir a malha mínima “Ler pontos adquiridos → Simular uma expressão de agregação → Criar um ponto agregado → Validar os resultados”. Não execute gravações não revisadas diretamente em dispositivos de produção.

I. Pré-requisitos

• Edge-EMS Builder instalado e funcionando normalmente;
• CommBridge conectado a pelo menos um dispositivo de teste ou simulador;
• Conta de administrador de teste do Edge-EMS Builder disponível;
• Endereço do Edge-EMS Builder confirmado:
  • Conexão direta na rede local: http://<IP_do_dispositivo>:8988
  • Proxy do JelinaCloud: https://<UUID_do_dispositivo>.proxy.jelina.wise-iot-cloud.com/api

Use endereço, porta e conta do seu próprio ambiente de testes. Não envie senhas reais, Tokens ou UUIDs de dispositivos para o repositório de código.

II. Confirmar os dados do EMS Builder e do CommBridge

1. Faça login na página de gerenciamento do Edge-EMS Builder.
2. Abra a lista “Dados de aquisição”.
3. Confirme que existem pelo menos dois pontos numéricos de aquisição, por exemplo:
   • voltage_a
   • voltage_b
4. Verifique se os pontos têm valores recentes e se a comunicação está normal.

Se não houver pontos de aquisição, verifique primeiro:

• Se o projeto, os nós e as tarefas de aquisição do CommBridge estão habilitados;
• Se o endereço WebSocket do CommBridge configurado no Edge-EMS Builder está correto;
• Se o dispositivo ou simulador está online;
• Se há erros de conexão ou configuração nos logs do Edge-EMS Builder e do CommBridge.

III. Simular a expressão de agregação

Na página “Dados agregados”, selecione “Simular cálculo” e insira:

if ${voltage_a} == "__Null__" or ${voltage_b} == "__Null__" then
    return 0
end

local a = tonumber(${voltage_a}) or 0
local b = tonumber(${voltage_b}) or 0
return (a + b) / 2

Substitua voltage_a e voltage_b do exemplo por dataKey que existam no ambiente de testes.

Resultado esperado:

• A sintaxe da expressão é validada com sucesso;
• Um valor numérico é retornado;
• O valor retornado corresponde à média dos dois pontos de aquisição.

IV. Criar o primeiro ponto agregado

Após a simulação bem-sucedida, crie o ponto agregado:

Campo	Exemplo
dataKey	voltage_avg
Nome	Tensão média
Tipo de dado	float
Expressão	Use o Lua validado na simulação da etapa anterior
Período de aquisição/cálculo	Defina conforme os requisitos do ambiente de testes

Após salvar:

1. Retorne à lista de dados agregados;
2. Confirme que voltage_avg foi gerado;
3. Altere voltage_a ou voltage_b no simulador;
4. Confirme que voltage_avg é atualizado em resposta.

V. Executar as mesmas operações pela API

As interfaces correspondentes do Edge-EMS Builder incluem:

• POST /account/login
• GET /collection-data-config/list
• POST /aggregation-data-config/calculate
• POST /aggregation-data-config/add
• GET /aggregation-data-config/list

Exemplo de solicitação de login:

{
  "mail": "<conta_de_teste>",
  "password": "<senha_de_teste>"
}

As solicitações seguintes usam o Token retornado pela interface de login. Para cabeçalhos, campos e estruturas de retorno específicos, consulte a documentação HTTP do Edge-EMS Builder. Não mantenha credenciais reais em documentos, scripts ou capturas de tela.

VI. Próximo passo: criar um perfil de acionamento

Após concluir o ponto agregado, prossiga com:

• Perfis de acionamento
• Mecanismo de expressões Lua
• Colaboração entre nuvem e borda por MQTT
• Envio em tempo real ao frontend e controle direto

Recomenda-se criar primeiro, no ambiente de testes, perfis sem risco de controle de dispositivos, como “alarme de alta temperatura” ou “registro de alterações de um ponto de teste”, antes de passar à gravação em dispositivos reais.

VII. Critérios de conclusão

• Os pontos de aquisição enviados pelo CommBridge estão visíveis;
• A simulação da expressão de agregação é bem-sucedida;
• O ponto agregado foi criado e é atualizado;
• O script não apresenta erro quando a entrada é __Null__;
• Todas as operações foram realizadas no ambiente de testes;
• Documentos, scripts e capturas de tela não contêm credenciais reais.