Guia de início rápido

Este guia ajudará você a configurar rapidamente seu primeiro fluxo de dados no IoT Logic e começar a processar seus dados telemáticos.

Pré-requisitos

Antes de prosseguir com a criação do seu primeiro fluxo, verifique se você possui:

• Um proprietário cargo em sua conta Navixy

• Dispositivos ativados em sua conta

• Compreensão de quais fontes de dados você deseja processar

O workspace do IoT Logic está disponível apenas para contas Proprietários e não é exibido para Usuários. Para detalhes sobre os papéis de usuário, consulte Usuários e Papéis.

Configuração do fluxo

Assista a um breve vídeo que demonstra o processo de criação de um novo fluxo com cálculos de atributos de dados e a adição de atributos personalizados aos dispositivos na plataforma:

Processo de criação de um novo fluxo com cálculos de atributos de dados e adição de atributos personalizados aos dispositivos na plataforma

Agora, vamos detalhar o processo de configuração do fluxo passo a passo.

1

Passo 1: Acesse o workspace do IoT Logic

1. Faça login em sua conta Navixy

2. Clique no ícone do seu perfil no canto superior esquerdo da tela para acessar Configurações da conta

3. Selecione IoT Logic na barra lateral de configurações

O workspace do IoT Logic aparece com três seções principais:

• Barra de configurações do fluxo - Contém controles para gerenciar fluxos

• Painel de nós - Lista os nós disponíveis para construir seu fluxo

• Canvas - O espaço principal de trabalho onde você desenha seu fluxo

Para detalhes sobre o workspace, consulte Área de trabalho e fluxo padrão.

2

Passo 2: Crie um novo fluxo

1. Clique no Novo fluxo botão na barra de configurações do fluxo

2. No Novo fluxo diálogo:

• Digite um nome descritivo para seu fluxo (por exemplo, "Fleet Telemetry Processing")

• Adicione uma breve descrição explicando o propósito do fluxo

• Certifique-se de que o Fluxo habilitado o alternador está LIGADO

1. Clique em Save para criar o fluxo

Para informações adicionais sobre configuração de fluxos, consulte Gerenciamento de fluxos -> Criar um novo fluxo.

Fluxos desativados não processam nenhum dado. Quando um fluxo está desativado, os dispositivos nesse fluxo não transmitirão dados para nenhum destino, incluindo a plataforma Navixy.

3

Passo 3: Configure um nó de Fonte de Dados

1. Do painel Nós painel, arraste um Data Source nó para o canvas

2. Passe o mouse sobre o nó para exibir ações rápidas ou clique duas vezes no nó para abrir seu painel de configuração

3. Configure as seguintes opções:

• Nome do nó - Digite um nome descritivo, especificando a origem dos dados enviados (por exemplo, Veículos da equipe)

• Fontes - Selecione os dispositivos cujas leituras você deseja enviar para este fluxo. Você pode filtrar seus dispositivos disponíveis por dados Fabricante e Modelo do dispositivo.

1. Clique em Save para aplicar a configuração

Para detalhes sobre a configuração do nó, consulte nó Data Source.

4

Passo 4: Adicionar enriquecimento de dados (Opcional)

1. Arraste um Initiate Attribute nó para o canvas

2. Passe o mouse sobre o nó para exibir ações rápidas ou clique duas vezes no nó para abrir seu painel de configuração

3. Adicione um Nome do nó descritivo para especificar seu propósito e os cálculos que realiza (por exemplo, Temperatura °F para °C)

4. Defina seu atributo:

   1. Nome do atributo - Um nome claro e descritivo (por exemplo, "speed_mph")

   2. Fórmula - A expressão de cálculo (por exemplo, value('speed')/1.609 para converter km/h em mph) 💡Observação: Nomes de atributos podem ser preenchidos automaticamente para garantir a nomeação correta. O preenchimento automático usa sintaxe curta por padrão, que se refere ao último valor do atributo.

   3. Hora de geração - Quando a entrada de dados foi criada no dispositivo (padrão para now())

   4. Hora do servidor - Quando os dados foram recebidos pelo servidor (padrão para now())

5. Adicione atributos adicionais, se necessário, clicando em Add attribute 💡Observação: O Botão Redefinir formulário descarta todos os atributos criados dentro de um nó. Se desejar remover um atributo específico, clique nos três pontos à direita da linha do atributo e selecione Clique no menu exibido e selecione.

6. Clique em Save para aplicar a configuração

7. Criar uma conexão:

   1. Clique no conector de saída do Data Source nó

   2. Arraste a transição até o conector de entrada do Initiate Attribute nó

Para detalhes sobre a configuração de nós, consulte nó Initiate Attribute.

Para detalhes sobre ações com atributos, consulte Gerenciando atributos.

Para fórmulas de cálculo de exemplo, consulte Calculation examples.

5

Passo 5: Configure a saída de dados

1. Arraste um Ponto de Saída (Output Endpoint) nó para o canvas

2. Passe o mouse sobre o nó para exibir ações rápidas ou clique duas vezes no nó para abrir seu painel de configuração

3. Selecione Tipo de endpoint:

• Endpoint Navixy - endpoint padrão para enviar dados processados para a plataforma Navixy. Está pré-configurado e não permite alterações

• Endpoint MQTT - endpoint para enviar dados a destinos de terceiros, usando MQTT como protocolo de transporte. Requer configuração manual descrita nos passos seguintes

Endpoints criados dentro da conta estão disponíveis como Predefinições. Você pode selecionar uma configuração já existente em vez de configurá-la do zero. Endpoint de Saída Navixy está sempre disponível como uma predefinição.

1. Configure as seguintes opções:

   1. Nome do endpoint - Digite um nome descritivo para especificar o destino para onde os dados serão enviados

   2. Protocolo - Selecione o protocolo de dados (apenas “Navixy Generic Protocol (JSON)” está disponível no momento)

   3. IP/Domínio - Insira o endereço de destino

   4. Porta - Especifique o número da porta (padrão: 1883 para MQTT padrão, 8883 para SSL)

   5. (opcional) Habilitar SSL - Ative para conexões seguras

   6. Versão MQTT - Selecione a versão apropriada (3.1.1 ou 5.0)

   7. ID do Cliente - Insira o identificador do seu cliente para garantir que os dados sejam aceitos pela parte receptora

   8. (opcional) Tópicos - Especifique os tópicos MQTT para transmissão de dados

   9. QoS - Selecione o nível de Qualidade de Serviço para determinar a lógica de transmissão de dados (0, 1, ou 2)

2. Se a autenticação for necessária no lado receptor, ative Autenticação MQTT LIGADO Os campos exibidos são preenchidos automaticamente com as credenciais da sua conta na plataforma

O Botão Redefinir formulário descarta todos os atributos criados dentro de um nó. Se desejar remover um atributo específico, clique nos três pontos à direita da linha do atributo e selecione Clique no menu exibido e selecione.

1. Clique em Crie para aplicar a configuração

2. Conecte seus outros nós a este nó de saída na ordem necessária para finalizar a estrutura do fluxo

Cada fluxo deve incluir um Endpoint Padrão nó para garantir que os dados sejam enviados para a plataforma. Sem essa conexão, os dados do dispositivo não serão visíveis na interface Navixy.

Para detalhes sobre a configuração de nós, consulte nó Output Endpoint.

6

Passo 6: Salve e ative seu fluxo

1. Verifique se todos os nós estão corretamente conectados em seu fluxo

2. Clique no Salvar fluxo botão no painel Nós painel

Seu fluxo agora está ativo e processando dados em tempo real!

Validação do fluxo

Para confirmar que seu fluxo está funcionando corretamente, use a ferramenta Data Stream Analyzer :

1. Clique no Analisador de Dados botão na barra de configurações do fluxo

2. Selecione os dispositivos que deseja monitorar na lista suspensa

3. Observe os atributos de dados recebidos e seus valores

4. Use as opções de filtragem para focar em parâmetros específicos

5. Verifique se quaisquer atributos calculados apresentam os valores corretos

Para detalhes sobre o uso da ferramenta, consulte Data Stream Analyzer.

Parabéns! Seu primeiro fluxo de dados do IoT Logic está ativo e funcionando.

Próximos passos

Agora que você criou seu primeiro fluxo no IoT Logic, você pode:

• Adapte este exemplo de início rápido às necessidades do seu negócio

• Crie transformações de dados mais complexas com múltiplos Iniciar nós de Atributo

• Configure destinos de saída adicionais para seus dados que podem se tornar perfis reutilizáveis para configurações consistentes

• Gerencie fluxos já criados para ajustar o processamento de dados a quaisquer mudanças que você enfrente

• Projete fluxos avançados para cenários de negócios específicos usando diferentes combinações e configurações de nós

Adaptando este exemplo

Este exemplo pode ser adaptado a vários casos de uso da indústria modificando:

• Seleção de dispositivo: Escolha dispositivos relevantes para seus ativos específicos

• Conversões de unidade: Ajuste fórmulas com base em suas unidades de medida padrão

• Métricas calculadas: Crie indicadores específicos por setor com base nas necessidades do seu negócio

• Configuração de saída: Conecte-se à sua plataforma de análise ou banco de dados específico

O padrão fundamental de coletar, transformar e encaminhar permanece consistente entre as indústrias, tornando este um modelo versátil para o processamento de dados IoT.

Acesso à API

A funcionalidade do IoT Logic também pode ser acessada programaticamente por meio da API Navixy. Isso permite que desenvolvedores automatizem a criação, o gerenciamento e o monitoramento de fluxos.

Por motivos de segurança, o acesso à API requer permissões apropriadas. Contate o administrador da sua conta para garantir que possua os direitos de acesso necessários.

Para documentação completa da API, parâmetros, formatos de requisição/resposta e exemplos de código, consulte a Documentação da API Navixy IoT Logic.

Perguntas frequentes

O que acontece com dispositivos não atribuídos a um fluxo personalizado?

Dispositivos não atribuídos explicitamente a nenhum fluxo personalizado são automaticamente tratados pelo fluxo padrão, que envia seus dados diretamente para a plataforma Navixy.

Posso usar o mesmo dispositivo em vários fluxos?

Não, cada dispositivo só pode ser atribuído a um fluxo por vez. Ao ser adicionado a um fluxo personalizado, um dispositivo é removido automaticamente do fluxo padrão para evitar processamento duplicado de dados.

Meu fluxo continuará funcionando se eu fizer logout?

Sim, uma vez ativados, os fluxos operam independentemente da sua sessão de usuário. Enquanto o fluxo estiver habilitado, ele processará dados mesmo quando você não estiver conectado.

Como saber se meu fluxo está funcionando corretamente?

Use o Analisador de Fluxo de Dados para monitorar a transmissão de dados em tempo real. Esta ferramenta mostra tanto os dados brutos do dispositivo quanto os atributos calculados, permitindo verificar se suas transformações estão funcionando conforme o esperado.

O que acontece se eu desativar um fluxo?

Quando você desativa um fluxo, os dispositivos atribuídos a esse fluxo não transmitirãodados para nenhum destino, incluindo a plataforma Navixy. Os dispositivos aparecerão offline na interface Navixy até que você reative o fluxo.