Executando o Particle CLI em qualquer sistema operacional para gerenciar bibliotecas localmente

Maria Hernández -

Você está trabalhando com dispositivos Particle para construir seu próximo projeto IoT Se sua resposta for sim, você está no lugar certo.

ambiente de desenvolvimento integrado (IDE) fácil de usar chamado Particle Build , que permite desenvolver software em um ambiente amigável e baseado em nuvem, com a vantagem de poder ser executado em seu navegador de qualquer parte do mundo .

Como uma opção adicional ao IDE da web, eles também fornecem a Particle Command Line Interface (CLI) , uma ferramenta poderosa que permite a comunicação com Particle Devices por meio de uma linha de comando ou aplicativo de terminal. Permite que você obtenha controle total sobre seu ambiente de desenvolvimento , gerenciando todos os projetos localmente. Funcionalidades como a capacidade de reivindicar e atualizar dispositivos, gerenciar suas próprias bibliotecas e configurações de dispositivos e muito mais estão incluídas.

Seguindo este guia, você aprenderá como instalar o Particle CLI em qualquer sistema operacional , além de aprender sobre o gerenciamento de bibliotecas externas incluídas em seu projeto e, em seguida, atualizá-lo para qualquer painel de partículas.

Sem mais delongas... Vamos começar! ;)

Requisitos

  • Qualquer painel de partículas.
  • Um computador MacOS/Linux ou Windows.
  • Cabo de comunicação USB.
  • Linha de comando ou aplicativo de terminal (isso depende do seu sistema operacional).

Índice

  1. Instalando o Particle CLI
  2. Acesse sua conta do Partícula
  3. Configure seu projeto
    - Criação da pasta do projeto
    - Configuração da biblioteca
    - Criação de código de exemplo
    - Compilando o projeto
    - Atualizando o projeto

Instalando o Particle CLI

  • MacOS/Linux

Abra um terminal e execute o seguinte comando:

bash <(curl -sL https://particle.io/install-cli)

Como você pode ver abaixo, o comando tentará instalar o DFU-util . Este é um software utilitário para programação de dispositivos via USB . Caso o instalador não consiga instalar o software utilitário automaticamente, consulte as instruções para instalação do DFU-util aqui .

  • Windows

Baixe e execute o instalador da CLI do Windows para instalar o Particle CLI.

NOTA IMPORTANTE: Para uma instalação avançada do Particle CLI em seu computador, recomendamos que você verifique as instruções oficiais do Particle para garantir a funcionalidade correta do mesmo.

Acesse sua conta do Partícula

Na linha de comando ou aplicativo de terminal execute o comando abaixo:

login de partícula

Este comando solicitará seu endereço de e-mail, além da senha associada à sua conta Particle.

Caso você não tenha uma conta de partículas execute o comando partícula setup e siga as instruções fornecidas.

DICA PRO : O comando partícula ajuda lista todos os comandos disponíveis no Particle

Configure seu projeto

Para configurar seu projeto corretamente, você já deve ter o código a ser atualizado em seu Particle Board e, adicionalmente, as bibliotecas exigidas por ele.

Como exemplo geral, vamos demonstrar como compilar e atualizar um Particle Photon para enviar dados para Ubidots via HTTP usando a Biblioteca Ubidots .

1. Crie uma pasta de projeto com o nome de sua preferência e dentro de qualquer pasta pai. No nosso caso, criamos uma nova pasta chamada " particle-photon " dentro de " Desktop "

2. Acesse o Repositório GitHub , baixe a biblioteca como ZIP para sua pasta Downloads e descompacte-a em sua pasta “ particle-photon ” criada anteriormente.

3. Abra um terminal e navegue até a pasta do seu projeto usando os cd e ls . Neste ponto, você já deve ter a biblioteca descompactada nesta pasta.

4. Agora, você deve adicionar o seguinte código C++ (.cpp) à pasta do projeto para começar a enviar dados para Ubidots via HTTP.

Antes de salvar o código de amostra na pasta do projeto, certifique-se de atribuir um Token Ubidots da sua conta onde está indicado no código.

// Este exemplo envia dados para múltiplas variáveis ​​para // Ubidots através do protocolo HTTP. /**************************************** * Incluir bibliotecas ****** **********************************/ #include " Ubidots .h" /******* ********************************* * Definir instâncias e constantes ************ ****************************/ #ifndef UBIDOTS _TOKEN #define UBIDOTS _TOKEN "Seu_Token" // Coloque aqui seu Ubidots TOKEN #endif Ubidots ubidots ( UBIDOTS _TOKEN, UBI_HTTP); /************************************** *Funções Auxiliares****** **********************************/ //Coloque aqui suas funções auxiliares /******* ********************************* * Funções principais ************** **************************/ void setup() { Serial.begin(115200); ubidots ); // Remova o comentário desta linha para imprimir mensagens de depuração } void loop() { float value1 = analogRead(A0); valor flutuante2 = analogRead(A1); valor flutuante3 = analogRead(A2); ubidots .add("Variable_Name_One", valor1); // Altere o nome da sua variável ubidots .add("Variable_Name_Two", value2); ubidots .add("Nome_Variável_Três", valor3); bool bufferSent = falso; bufferSent = ubidots (); // Enviará dados para um rótulo de dispositivo que corresponda ao ID do dispositivo if(bufferSent){ // Faça algo se os valores foram enviados corretamente Serial.println("Valores enviados pelo dispositivo"); } atraso(5000); }

Depois que os códigos forem criados e salvos corretamente na pasta do seu projeto, você deverá ter algo semelhante à imagem abaixo:

5. Execute o seguinte comando para compilar o cpp ( SendValuesHTTP.cpp ) direcionado ao seu dispositivo Particle Photon:

compilação de partículas photon --target 1.0.1 SendValuesHTTP.cpp ubidots -particle-master/src/* --saveTo SendValuesHTTP.bin

Após executar este comando, um arquivo bin será criado com o nome “ sendValuesHTTP.bin ”.

NOTA: O comando de compilação pode ser aplicado a qualquer dispositivo Particle, bastando alterar o tipo de dispositivo ao qual o comando será direcionado. Para mais informações, visite a documentação oficial do Particle .

6. Conecte seu Particle Photon , via USB e coloque-o no modo DFU de acordo com a documentação do Particle .

7. Execute o seguinte comando enquanto o dispositivo estiver conectado via USB:

partícula flash --usb SendValuesHTTP.bin

Se tudo correu conforme o esperado e os dispositivos foram atualizados com sucesso, você deverá receber um " Flash bem-sucedido! " na linha de comando.

Neste ponto, você deve esperar alguns segundos até que o Particle Photon se conecte à internet; o dispositivo deve piscar em ciano para garantir a conexão.

  1. [OPCIONAL] Para verificar se seus dados estão sendo atualizados corretamente no Ubidots , você pode simplesmente verificar a Ubidots executando o comando partícula serial monitor

Resumo

Você conseguiu isso! - Em apenas alguns minutos, você pode gerenciar bibliotecas privadas em seus projetos, compilar e atualizar seus painéis de partículas localmente usando o Particle CLI.

Saiba mais: Acelere seus IoT usando Particle Mesh + Ubidots

Outros usuários também acharam útil: