Executar a CLI Particle em qualquer sistema operacional para gerenciar bibliotecas localmente

María Hernández -

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

Particle Ambiente de Desenvolvimento Integrado (IDE) fácil de usar, chamado Particle Build , que permite o desenvolvimento de software em um ambiente amigável e baseado em nuvem, com a vantagem adicional de poder ser executado em seu navegador da web de qualquer lugar do mundo.

Como opção adicional ao IDE web, eles também fornecem a Interface de Linha de Comando (CLI) Particle , uma ferramenta poderosa que permite a comunicação com Particle por meio de uma linha de comando ou aplicativo de terminal. Ela permite que você tenha controle total sobre seu ambiente de desenvolvimento, gerenciando todos os projetos localmente. Funcionalidades como a capacidade de registrar e gravar 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 a Particle em qualquer sistema operacional , além de aprender como gerenciar bibliotecas externas incluídas em seu projeto e, em seguida, como gravá-las em qualquer Particle .

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

Requisitos

  • Qualquer placa Particle .
  • 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 a CLI Particle
  2. Acesse sua conta Particle
  3. Configuração do projeto
    - Criação da pasta do projeto
    - Configuração da biblioteca
    - Criação de código de exemplo
    - Compilação do projeto
    - Gravação do projeto na memória flash

Instalando a CLI Particle

  • 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 programar dispositivos via USB . Caso o instalador não consiga instalar o software utilitário automaticamente, consulte as instruções para instalar o DFU-util aqui .

  • Windows

Baixe e execute o instalador da CLI Particle para instalar a CLI.

NOTA IMPORTANTE: Para uma instalação avançada da Particle em seu computador, recomendamos que você consulte as instruções Particle para garantir o funcionamento correto.

Acesse sua conta Particle

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

login particle

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

Caso você não tenha uma particle , execute o comando ` particle setup` e siga as instruções fornecidas.

DICA PROFISSIONAL : O comando particle help` 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 gravado na sua placa Particle e, adicionalmente, as bibliotecas necessárias.

Como exemplo geral, vamos demonstrar como compilar e gravar a imagem em uma Particle Photon para enviar dados ao Ubidots via HTTP usando a biblioteca Ubidots .

1. Crie uma pasta para o projeto com o nome de sua escolha, dentro de qualquer pasta principal. No nosso caso, criamos uma nova pasta chamada " particle -photon " dentro de " Desktop ".

2. Acesse o repositório do GitHub , baixe a biblioteca como um arquivo ZIP para a sua pasta de Downloads e descompacte-a na pasta “ particle -photon ” que você criou 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ê precisa adicionar o seguinte código C++ (.cpp) à pasta do seu projeto para começar a enviar dados para Ubidots via HTTP.

Antes de salvar o código de exemplo na pasta do projeto, certifique-se de atribuir um token Ubidots da sua conta, conforme indicado no código.

// Este exemplo envia dados para múltiplas variáveis ​​para // Ubidots através do protocolo HTTP. /**************************************** * Incluir Bibliotecas ****************************************/ #include "Ubidots" /**************************************** * Definir Instâncias e Constantes ****************************************/ #ifndef UBIDOTS#define UBIDOTS"Seu_Token" // Insira aqui seu TOKEN Ubidots #endif Ubidots ubidots(UBIDOTS, UBI_HTTP); /**************************************** * Funções Auxiliares ****************************************/ // Insira aqui suas funções auxiliares /**************************************** * Funções Principais ****************************************/ void setup() { Serial.begin(115200); //ubidots(true); // Descomente esta linha para imprimir mensagens de depuração } void loop() { float value1 = analogRead(A0); float value2 = analogRead(A1); float value3 = analogRead(A2); ubidots("Variable_Name_One", value1); // Altere para o nome da sua variável ubidots("Variable_Name_Two", value2); ubidots("Variable_Name_Three", value3); bool bufferSent = false; 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"); } delay(5000); }

Após a criação e o salvamento correto do código na pasta do seu projeto, você deverá ter algo semelhante à imagem abaixo:

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

particle compile photon --target 1.0.1 SendValuesHTTP.cpp ubidots-particle-master/src/* --saveTo SendValuesHTTP.bin

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

NOTA: O comando de compilação pode ser aplicado a qualquer Particle ; basta alterar o tipo de dispositivo para o qual o comando será direcionado. Para mais informações, consulte a documentação oficial Particle .

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

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

particle flash --usb SendValuesHTTP.bin

Se tudo correr como esperado e os dispositivos forem atualizados com sucesso, você deverá receber a mensagem " Flash concluído com sucesso! " na linha de comando.

Nesse momento, você deve aguardar alguns segundos até que o Particle Photon se conecte à internet; o dispositivo deve piscar em ciano para confirmar 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 particle serial monitor`.

Resumo

Você consegue! - Em apenas alguns minutos, você poderá gerenciar bibliotecas privadas em seus projetos, compilar e gravar o firmware em suas placas Particle localmente usando a CLI Particle .

Saiba mais: Acelere o desenvolvimento da sua IoT usando Particle Mesh + Ubidots

Outros usuários também acharam útil: