Ejecutar Particle CLI en cualquier sistema operativo para administrar bibliotecas localmente

María Hernández -

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

entorno de desarrollo integrado (IDE) fácil de usar llamado Particle Build , que le permite desarrollar 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 proporcionan la interfaz de línea de comandos (CLI) de Particle , una poderosa herramienta que le permite comunicarse con dispositivos Particle a través de una línea de comando o una aplicación de terminal. Le permite obtener un control total sobre su entorno de desarrollo al administrar todos los proyectos localmente. Se incluyen funcionalidades como la capacidad de reclamar y flashear dispositivos, administrar sus propias bibliotecas y configuraciones de dispositivos, y mucho más.

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

Sin más preámbulos… ¡Empecemos! ;)

Requisitos

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

Tabla de contenido

  1. Instalación de CLI de partículas
  2. Accede a tu cuenta de partículas
  3. Configure su proyecto
    - Creación de carpeta de proyecto
    - Configuración de biblioteca
    - Creación de código de muestra
    - Compilación del proyecto
    - Actualización del proyecto

Instalación de CLI de partículas

  • 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 . Este es un software de utilidad para programar dispositivos a través de USB . En caso de que el instalador no pueda instalar el software de 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 CLI de Particle.

NOTA IMPORTANTE: Para una instalación avanzada de Particle CLI en su computadora, le recomendamos consultar las instrucciones oficiales de Particle para garantizar la correcta funcionalidad del mismo.

Accede a tu cuenta de partículas

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

inicio de sesión de partículas

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

En caso de que no tenga una cuenta de partículas, ejecute el comando configuración de partículas y siga las instrucciones proporcionadas.

CONSEJO PROFESIONAL : La ayuda de la partícula enumera todos los comandos disponibles en la partícula.

Configura tu proyecto

Para configurar su proyecto correctamente, ya debe tener el código que se instalará en su tablero de partículas y, además, las bibliotecas que requiere.

Como ejemplo general, vamos a demostrar cómo compilar y actualizar un fotón de partículas para enviar datos a Ubidots a través de HTTP usando la biblioteca Ubidots .

1. Cree una carpeta de proyecto con el nombre de su elección y dentro de cualquier carpeta principal. En nuestro caso, creamos una nueva carpeta llamada " particle-photon " dentro de " Escritorio "

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

3. Abra una terminal y navegue hasta 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, debe agregar el siguiente código C++ (.cpp) a la carpeta de su 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 de 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 "Tu_Token" // Pon aquí tu TOKEN Ubidots #endif Ubidots ubidots ( UBIDOTS , UBI_HTTP); /**************************************** * Funciones auxiliares ****** ********************************/ //Pon aquí tus funciones auxiliares /******* ******************************** * Funciones principales ************** **************************/ void setup() { Serial.begin(115200); // ubidots .setDebug(verdadero); // Descomentar esta línea para imprimir mensajes de depuración } void loop() { float value1 = analogRead(A0); valor flotante2 = analogRead(A1); valor flotante3 = analogRead(A2); ubidots .add("Variable_Name_One", valor1); // Cambia el nombre de tu variable ubidots .add("Variable_Name_Two", value2); ubidots .add("Variable_Name_Three", valor3); bool bufferEnviado = falso; bufferEnviado = ubidots .send(); // Enviará datos a una etiqueta de dispositivo que coincida con el ID del dispositivo if(bufferSent){ // Hará algo si los valores se enviaron correctamente Serial.println("Valores enviados por el dispositivo"); } retraso(5000); }

Una vez que los códigos estén creados 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 Photon:

fotón de compilación de partículas --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 de " sendValuesHTTP.bin ".

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

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

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

flash de partículas --usb SendValuesHTTP.bin

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

En este punto, debes esperar unos segundos hasta que el 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

¡Tienes esto! - En solo un par de minutos, podrá administrar bibliotecas privadas en sus proyectos, compilar y actualizar sus tableros de partículas localmente usando Particle CLI.

Obtenga más información: Acelere sus IoT utilizando Particle Mesh + Ubidots

Otros usuarios también encontraron útil: