Ejecución de Particle CLI en cualquier SO para gestionar bibliotecas localmente

María Hernández -

¿Estás trabajando con dispositivosParticle para construir tu próximo proyecto IoT? Si tu respuesta es sí, estás en el lugar adecuado.

Particle proporciona un Entorno de Desarrollo Integrado (IDE) fácil de usar llamado Particle Build, que te permite hacer desarrollo de software en un entorno basado en la nube y amigable, con el plus de que se puede ejecutar en tu navegador web desde cualquier parte del mundo.

Como opción adicional al IDE web, también proporcionan el Particle Command Line Interface (CLI), una potente herramienta que te permite comunicarte con los dispositivos Particle a través de una línea de comandos o una aplicación de terminal. Le permite obtener un control completo sobre su entorno de desarrollo mediante la gestión local de todos los proyectos. Se incluyen funcionalidades como la posibilidad de reclamar y flashear dispositivos, gestionar las bibliotecas propias y la configuración de los dispositivos, y mucho más.

Siguiendo esta guía aprenderás a instalar el CLI de Particle en cualquier sistema operativo, además de aprender a gestionar las librerías externas incluidas en tu proyecto y luego flashearlo en cualquier placa Particle.

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

Requisitos

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

Índice

  1. Instalación de Particle CLI
  2. Acceda a su cuenta Particle
  3. Configure su proyecto
    - Creación de la carpeta del proyecto
    - Configuración de la biblioteca
    - Creación del código de ejemplo
    - Compilación del proyecto
    - Flasheo del proyecto

Instalación de Particle CLI

  • MacOS/ Linux

Abra un 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 la programación de dispositivos a través de USB. En caso de que el instalador no pueda instalar el software de utilidad automáticamente vea las instrucciones para instalar DFU-util aquí.

  • Windows

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

NOTA IMPORTANTE: Para una instalación avanzada del CLI de Particle en tu ordenador, te recomendamos que consultes las instrucciones oficiales de Particle para asegurar la correcta funcionalidad del mismo.

Acceda a su cuenta Particle

En la línea de comandos, o 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 y la contraseña asociada a su cuenta de Particle.

En caso de que no tengas una cuenta de partículas ejecuta el comando configuración de partículasy siga las instrucciones.

CONSEJO PROFESIONAL: El comando Ayuda para partículas enumera todos los comandos disponibles en la ventana Partículas

Configure su proyecto

Para configurar tu proyecto correctamente, ya debes tener el código que se va a flashear en tu Tablero de Partículas, y además, las librerías requeridas por el mismo.

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 Ubidots Library localmente.

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

2. Vaya al repositorio de GitHub, descargue la biblioteca en formato ZIP en su carpeta de descargas y descomprímala en la carpeta "particle-photon" creada anteriormente.

3. Abre un terminal y navega hasta la carpeta de tu proyecto utilizando los comandos cd y ls. En este punto, ya deberías tener la librería descomprimida en esta carpeta.

4. Ahora, tienes que añadir el siguiente código C++ (.cpp) en la carpeta de tu proyecto para empezar a enviar datos a Ubidots a través de HTTP.

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

// This example sends data to multiple variables to 
// Ubidots through HTTP protocol.

/****************************************
 * Include Libraries
 ****************************************/

#include "Ubidots.h"

/****************************************
 * Define Instances and Constants
 ****************************************/

#ifndef UBIDOTS_TOKEN
#define UBIDOTS_TOKEN "Your_Token"  // Put here your Ubidots TOKEN
#endif

Ubidots ubidots(UBIDOTS_TOKEN, UBI_HTTP);


/****************************************
 * Auxiliar Functions
 ****************************************/

//Put here your auxiliar functions


/****************************************
 * Main Functions
 ****************************************/

void setup() {
  Serial.begin(115200);
  //ubidots.setDebug(true);  // Uncomment this line for printing debug messages
}

void loop() {
  float value1 = analogRead(A0);
  float value2 = analogRead(A1);
  float value3 = analogRead(A2);
  ubidots.add("Variable_Name_One", value1);  // Change for your variable name
  ubidots.add("Variable_Name_Two", value2);
  ubidots.add("Variable_Name_Three", value3);

  bool bufferSent = false;
  bufferSent = ubidots.send();  // Will send data to a device label that matches the device Id

  if(bufferSent){
    // Do something if values were sent properly
    Serial.println("Values sent by the device");
  }

  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 de abajo:

5. Ejecute el siguiente comando para compilar el archivo cpp(SendValuesHTTP.cpp) dirigido a su dispositivo Particle Photon:

particle compile photon --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 dispositivo Particle, sólo tiene que cambiar el tipo de dispositivo al que se dirigirá el comando. Para más información, visite la documentación oficial de Particle.

6. Conecta tu Particle Photon, a través de USB y ponlo en modo DFU según la documentación de Particle.

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

particle flash --usb SendValuesHTTP.bin

Si todo ha ido como esperaba y los dispositivos se han flasheado correctamente, debería recibir un mensaje "¡Flasheo exitoso!"en la línea de comandos.

En este punto, debe 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 están siendo actualizados correctamente en Ubidots, puede simplemente verificar la respuesta del servidor de Ubidots ejecutando el comando monitor en serie de partículas

Resumen

¡Ya lo tienes! - En un par de minutos, podrás gestionar librerías privadas en tus proyectos, compilar y flashear tus placas Particle localmente usando Particle CLI.

Más información: Acelera tus desarrollos IoT utilizando Particle Mesh + Ubidots

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