Ejecución Particle CLI en cualquier sistema operativo para administrar bibliotecas localmente

María Hernández -

¿Estás trabajando con dispositivos Particle para desarrollar tu próximo IoT ? Si la respuesta es sí, estás en el lugar correcto.

Particle entorno de desarrollo integrado (IDE) fácil de usar llamado Particle Build , que le permite realizar desarrollo de software en un entorno amigable y basado en la nube, con la ventaja de que puede ejecutarse en su navegador web desde cualquier parte del mundo.

Como opción adicional al IDE web, también ofrecen la Interfaz de Línea de Comandos (CLI) Particle , una potente herramienta que permite comunicarse con Particle mediante una línea de comandos o una aplicación de terminal. Esta herramienta permite obtener control total sobre el entorno de desarrollo mediante la gestión local de todos los proyectos. Incluye funcionalidades como la posibilidad de reclamar y flashear dispositivos, gestionar las bibliotecas y la configuración de los dispositivos, y mucho más.

Siguiendo esta guía, aprenderá cómo instalar la Particle en cualquier sistema operativo , además de aprender a administrar bibliotecas externas incluidas en su proyecto y luego actualizarlo a cualquier Particle .

Sin más preámbulos... ¡Comencemos! ;)

Requisitos

  • Cualquier tablero Particle .
  • Una computadora MacOS/Linux o Windows.
  • Cable de comunicación USB.
  • Línea de comandos o aplicación de terminal (esto depende de su sistema operativo).

Tabla de contenido

  1. Instalación Particle CLI
  2. Acceda a su cuenta Particle
  3. Configurar su proyecto
    - Creación de la carpeta del proyecto
    - Configuración de la biblioteca
    - Creación de código de muestra
    - Compilar el proyecto
    - Flashear el proyecto

Instalación Particle CLI

  • MacOS/Linux

Abra una terminal y ejecute el siguiente comando:

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

Como puede ver a continuación, el comando intentará instalar DFU-util . Se trata de una utilidad para programar dispositivos mediante USB . Si el instalador no puede instalar la utilidad automáticamente, consulte las instrucciones para instalar DFU-util aquí .

  • Ventanas

Descargue y ejecute el instalador de la CLI de Windows para instalar la Particle .

NOTA IMPORTANTE: Para una instalación avanzada de la Particle en su computadora, le recomendamos consultar las instrucciones Particle para garantizar su correcto funcionamiento.

Acceda a su cuenta Particle

En la línea de comandos o en la aplicación de terminal, ejecute el siguiente comando:

inicio de sesión particle

Este comando le pedirá su dirección de correo electrónico, además de la contraseña asociada a su cuenta Particle .

En caso de que no tenga una particle , ejecute el comando particle setup y siga las instrucciones proporcionadas.

CONSEJO PROFESIONAL : La ayuda particle enumera todos los comandos disponibles en la Particle

Configura tu proyecto

Para configurar tu proyecto correctamente, ya debes tener el código que se va a flashear en tu Particle Board, y además, las librerías requeridas por éste.

Como ejemplo general, vamos a demostrar cómo compilar y flashear un Particle Photon para enviar datos a Ubidots a través de HTTP usando la biblioteca Ubidots .

1. Crea una carpeta de proyecto con el nombre que prefieras dentro de cualquier carpeta principal. En nuestro caso, creamos una carpeta llamada " particle -photon " dentro de " Escritorio ".

2. Vaya al Repositorio de GitHub , descargue la biblioteca como ZIP a su carpeta de Descargas y descomprímala en su carpeta “ particle -photon ” previamente creada.

3. Abra una terminal y navegue a la carpeta de su proyecto usando los cd y ls . En este punto, ya debería tener la biblioteca descomprimida en esta carpeta.

4. Ahora, debes agregar el siguiente código C++ (.cpp) en tu carpeta de proyecto para comenzar a enviar datos a Ubidots a través de HTTP.

Antes de guardar el código de muestra en la carpeta del proyecto, asegúrese de asignar un token Ubidots desde su cuenta donde se indica en el código.

// Este ejemplo envía datos a múltiples variables a // Ubidots a través del protocolo HTTP. /****************************************** * Incluir bibliotecas ****************************************/ #include "Ubidots.h" /*************************************** * Definir instancias y constantes ****************************************/ #ifndef UBIDOTS_TOKEN #define UBIDOTS_TOKEN "Your_Token" // Coloque aquí su TOKEN Ubidots #endif Ubidots ubidots(UBIDOTS_TOKEN, UBI_HTTP); /**************************************** * Funciones auxiliares ****************************************/ //Coloque aquí sus funciones auxiliares /*************************************** * Funciones principales ****************************************/ void setup() { Serial.begin(115200); //ubidots.setDebug(true); // Descomente esta línea para imprimir mensajes de depuración } void loop() { float value1 = analogRead(A0); float value2 = analogRead(A1); float value3 = analogRead(A2); ubidots.add("Variable_Name_One", value1); // Cambie el nombre de su variable ubidots.add("Variable_Name_Two", value2); ubidots.add("Variable_Name_Three", value3); bool bufferSent = false; bufferSent = ubidots.send(); // Enviará datos a una etiqueta de dispositivo que coincida con el Id. del dispositivo if(bufferSent){ // Hacer algo si los valores se enviaron correctamente Serial.println("Valores enviados por el dispositivo"); } delay(5000); }

Una vez creados los códigos y guardados correctamente en la carpeta de su proyecto, debería tener algo similar a la imagen a continuación:

5. Ejecute el siguiente comando para compilar el cpp ( SendValuesHTTP.cpp ) destinado a su dispositivo Particle 

particle compilar fotón --target 1.0.1 SendValuesHTTP.cpp ubidots-particle-master/src/* --saveTo SendValuesHTTP.bin

Después de ejecutar este comando, se creará un archivo bin con el nombre “ sendValuesHTTP.bin ”.

NOTA: El comando de compilación se puede aplicar a cualquier Particle ; solo necesita cambiar el tipo de dispositivo al que se dirigirá. Para más información, visite la documentación oficial Particle .

6. Conecte su Particle Photon a través de USB y póngalo en modo DFU de acuerdo con la documentación Particle .

7. Ejecute el siguiente comando mientras el dispositivo esté conectado a través de USB:

flash particle --usb SendValuesHTTP.bin

Si todo salió como se esperaba y los dispositivos se actualizaron correctamente, debería recibir un mensaje " Flash success! " en la línea de comando.

En este punto, debes esperar unos segundos hasta que Particle Photon se conecte a Internet; el dispositivo debe parpadear en cian para garantizar la conexión.

  1. [OPCIONAL] Para verificar si sus datos se están actualizando correctamente en Ubidots , simplemente puede verificar la Ubidots ejecutando el comando particle serial monitor

Resumen

¡Lo puedes hacer! - En solo un par de minutos, podrás administrar bibliotecas privadas en tus proyectos, compilar y flashear tus placas Particle localmente usando Particle CLI.

Más información: Acelere sus IoT con Particle Mesh + Ubidots

A otros usuarios también les resultó útil: