Guia Rápido do SenseCAP Console com Node-RED
SenseCAP K1100 - The Sensor Prototype Kit representa a Seeed Studio concentrando a essência da comunicação LoRa® em tecnologia e produtos de inteligência de borda, para a implantação e o domínio mais fáceis de aplicações LoRa® e IoT.
Atualizável para Sensores Industriais
Com o controlador S2110 e o registrador de dados S2100 da SenseCAP, você pode facilmente transformar o Grove em um sensor LoRaWAN®. A Seeed não apenas ajuda você com a prototipagem, mas também oferece a possibilidade de expandir seu projeto com a série SenseCAP de robustos sensores industriais.
O invólucro IP66, a configuração via Bluetooth, a compatibilidade com a rede global LoRaWAN®, a bateria interna de 19 Ah e o forte suporte do APP tornam o SenseCAP S210x a melhor escolha para aplicações industriais. A série inclui sensores para umidade do solo, temperatura e umidade do ar, intensidade de luz, CO2, EC e uma estação meteorológica 8 em 1. Experimente o mais recente SenseCAP S210x para o seu próximo projeto industrial de sucesso.
Node-RED é uma ferramenta de programação para conectar dispositivos de hardware, APIs e serviços online de maneiras novas e interessantes.
Ela fornece um editor baseado em navegador que facilita a conexão de fluxos usando a ampla variedade de nós na paleta, que podem ser implantados em seu runtime com um único clique.
Para facilitar que nossos usuários conectem dados da plataforma SenseCAP a várias outras plataformas PaaS para um processamento de dados mais aprofundado, faremos uma série de tutoriais sobre SenseCAP & Node-RED.
Este tutorial, o primeiro de uma série, mostrará como instalar e usar o Node-RED e chamar a API de backend do SenseCAP para se conectar ao Node-RED.
Instalar Node.js®
Para instalar o Node-RED localmente, você precisará de uma versão suportada do Node.js.
Baixe a versão 14.x LTS mais recente do Node.js na página oficial do Node.js. Ela oferecerá a melhor versão para o seu sistema.
Execute o arquivo MSI baixado. A instalação do Node.js requer direitos de administrador local; se você não for um administrador local, será solicitado a inserir uma senha de administrador na instalação. Aceite os valores padrão durante a instalação. Após a conclusão da instalação, feche quaisquer prompts de comando abertos e reabra-os para garantir que as novas variáveis de ambiente sejam carregadas.
Ao instalar o Node.js, se você estiver usando um computador que não tenha nenhum ambiente de programação instalado, recomendamos que marque a caixa para instalar as ferramentas necessárias durante a instalação do Node.js, o que lhe poupará muitos problemas desnecessários.
A maneira mais fácil de instalar o Node-RED é usando a ferramenta de gerenciamento de pacotes do Node, o npm. No entanto, não recomendamos instalar o Node-RED com o npm 1.x, mas sim atualizá-lo para a versão mais recente do npm 2.x.
No Windows (requer Windows 10 ou superior), use o atalho Win+R e digite cmd na janela pop-up para abrir o terminal e execute o seguinte comando.
Se você estiver usando MacOS ou Linux, execute o seguinte comando no terminal e adicione sudo na frente do comando para usuários sem privilégios de root.
npm install -g [email protected]
Depois de instalado, abra um prompt de comando e execute o seguinte comando para garantir que o Node.js e o npm estejam instalados corretamente.
node --version && npm --version
Você deverá receber uma saída semelhante a:
> v16.17.0
> 2.15.12
Instalar Node-RED
Instalar o Node-RED como um módulo global adiciona o comando node-red ao caminho do seu sistema. Execute o seguinte no prompt de comando:
npm install -g --unsafe-perm node-red
Se o Node-RED estiver instalado como um pacote npm global, então execute diretamente o comando node-red:
node-red
Isso enviará o log do Node-RED para o terminal. Você deve manter o terminal aberto para manter o Node-RED em execução.
Isso permitirá que você veja o editor do Node-RED em http://localhost:1880.
Obter a API do SenseCAP
Antes de prosseguir para esta seção, certifique-se de ter vinculado seu dispositivo K1100 no console SenseCAP.
Faça login no console SenseCAP. Na barra suspensa à direita do nome de usuário na parte superior do painel, podemos encontrar as Informações da Organização, selecione-as.
Na página de Informações da Organização, você pode ver o ID da Organização, que você pode anotar primeiro e o usaremos nas etapas posteriores.
Em seguida, também precisamos obter a chave de API para SenseCAP. Clique em Security -> Access API keys no lado esquerdo do painel. Em seguida, crie uma Access Key.
Clique no API ID que você criou e você obterá suas Access API keys, anote-as por enquanto, pois as usaremos nas etapas posteriores.
Criar um Nó HTTP
A janela do editor é composta por quatro componentes:
- O cabeçalho na parte superior, contendo o botão de implantação, o menu principal e, se a autenticação de usuário estiver habilitada, o menu do usuário.
- A paleta à esquerda, contendo os nós disponíveis para uso.
- O espaço de trabalho principal no meio, onde os fluxos são criados.
- A barra lateral à direita.
Siga os links acima para saber mais sobre cada componente.
Neste exemplo, mostraremos como usar nós MQTT para exibir os valores dos sensores recebidos pelo SenseCAP. Antes disso, vamos aprender a entender os nós que usaremos mais no futuro.
nó http
nó http in
O nó http in pode ser usado para criar serviços web.
Arraste o nó para o espaço de trabalho e clique duas vezes no nó para acessar a página de configuração do nó.
Aqui, precisamos definir uma URL para o serviço web que você criou, para que possa acessar a página web que você criou através do endereço http://localhost:1880/<URL>.
nó http response
O nó http response envia a resposta de volta para a requisição recebida do nó de entrada HTTP.
Normalmente, não precisamos configurá-lo separadamente, basta arrastá-lo diretamente para a bancada para uso.
nó template
O nó template pode definir propriedades com base no modelo fornecido.
Usaremos este nó e utilizaremos uma linguagem HTML simples para concluir a configuração do conteúdo de exibição da nossa página web.
Por exemplo, queremos mostrar "Hello World!".
<h1>Hello World!</h1>
Por fim, conectamos o http in ao template, e conectamos o template ao http response. Em seguida, clique no botão deploy no canto superior direito, assim uma página web simples é criada, que é a etapa básica de operação do Node-RED.
Neste exemplo, criamos uma URL de dados do sensor, então após a implantação, podemos inserir http://localhost:1880/sensor_data na barra de endereços do navegador para acessar a página que acabamos de criar.
Criar um nó MQTT
Nesta seção, descreveremos como obter as informações de dados do SenseCAP através do nó MQTT.
nó debug
Exibe propriedades de mensagens selecionadas na aba de barra lateral de depuração e, opcionalmente, no log de tempo de execução. Por padrão, exibe msg.payload, mas pode ser configurado para exibir qualquer propriedade, a mensagem completa ou o resultado de uma expressão JSONata.
nó mqtt
Conecta-se a um broker MQTT e assina mensagens do tópico especificado.
Passo 1. Adicionar um novo nó mqtt-broker.
Arraste um nó mqtt in, clique duas vezes nele para entrar na página de configuração e, em seguida, clique no botão de edição após Add new mqtt-broker.
A configuração do mqtt-broker deve ser preenchida da seguinte forma.
- Server: openstream.api.sensecap.seeed.cc
- Port: 1883
- Protocol: MQTT V3.1.1
- Client ID: O formato é
org-<Organization ID>-<Random ID><Orgnization ID>Seu ID de organização. Já o obtivemos em Get the SenseCAP API.<Random ID>use seus próprios números ou letras minúsculas gerados aleatoriamente.
Em seguida, preenchemos o campo de opções de Security com o Username e Password.
- Username: O formato é
org-<Organization ID><Orgnization ID>Seu ID de organização. Já o obtivemos em Get the SenseCAP API.
- Password: Preencha com as Access API keys que obtivemos em Get the SenseCAP API.
Por fim, clique no botão Add no canto superior direito para retornar à página de configuração do nó mqtt in.
- Topic: Configurar um tópico em um formato específico determina o tipo de dispositivo e o tipo de dado a serem recebidos.
Formato do Topic: /device_sensor_data/<OrgID>/<DeviceEUI>/<Channel>/<Reserved>/<MeasurementID>
| OrgID | Seu ID de organização. Já o obtivemos em Get the SenseCAP API. |
| DevEUI | Identificação exclusiva dos dispositivos sensores. Essas informações podem ser encontradas no adesivo na parte de trás do Grove - Wio E5, bem como no dispositivo do console SenseCAP. |
| Channel | Uma interface física no dispositivo à qual o sensor está conectado. Para o kit K1100, o valor padrão aqui é 1. |
| Reserved | Campos Reservados. |
| MeasurementID | ID do valor medido. Este ID pode ser encontrado na seção Measurement IDs da documentação SenseCAP |
O conteúdo deste tutorial se aplica apenas ao kit K1100, portanto, consulte o conteúdo dentro de LoraWAN Dev Kit para o ID do valor medido e não use outros IDs.
Por exemplo, se eu quiser conseguir obter dados do sensor para os valores de luz enviados pelo Wio Terminal, então as informações do Topic que eu preencher devem ser:
/device_sensor_data/424324324324324/2CF7F1C043200002/1/+/4193
O campo <OrgID> é obrigatório, "+" significa que este campo não tem filtro e pode corresponder a todos. Portanto, "/ + / + / + / +" significa escutar todos <DeviceEUI>, <Channel>, <Reserved>, <MeasurementID>.
Se você quiser escutar todas as mensagens, então o Topic deve ser:
/device_sensor_data/424324324324324/+/+/+/+
Passo 2. Adicionar nó debug
Então podemos adicionar nós debug a ele para facilitar a verificação se tudo está funcionando.
Passo 3. Ligue o Wio Terminal e comece a enviar dados para o SenseCAP.
Clicamos no botão Deploy e, se tudo estiver configurado corretamente, você poderá ver o nó mqtt in mostrando conectado. Assim que o Wio Terminal começar a ligar e funcionar e começar a enviar dados para o SenseCAP, você verá os dados já exibidos na janela de depuração.
Suporte Técnico & Discussão de Produtos
Obrigado por escolher nossos produtos! Estamos aqui para oferecer diferentes formas de suporte para garantir que sua experiência com nossos produtos seja o mais tranquila possível. Oferecemos vários canais de comunicação para atender a diferentes preferências e necessidades.