Descarga ubidots particle - Descarga del código fuente ubidots particle

ubidots particle

Otras categorias

v3.1.4

Descargar

Partícula

Aquí aprenderá cómo enviar datos a Ubidots utilizando dispositivos Particle Photon o Electron. Sólo necesitas la etiqueta de la variable y el valor que deseas enviar junto con un TOKEN válido de Ubidots. Además, puedes obtener el último valor de una variable de tu cuenta de Ubidots.

Requisitos

Dispositivo de partículas
Cable micro USB
conexión a internet
Nota: Para la última versión de la biblioteca es necesario tener su dispositivo de partículas con la versión de firmware 0.7.0 o superior.

Configuración

Configure la conexión WiFi al fotón. Hay dos maneras de hacer esto:
- Usando su teléfono inteligente.
- Conectándolo a su computadora a través de USB.
Después de reclamar su Photon y configurar su cuenta de Ubidots, vayamos al IDE web de Particle.
- En el IDE web de Particle, cree una nueva aplicación y establezca el nombre.
- Vaya a la pestaña de la biblioteca.
- En la biblioteca aportada escriba Ubidots y seleccione la biblioteca Ubidots.
- Haga clic en INCLUIR EN LA APLICACIÓN . Y regrese a "MYAPP.ino"

Esta biblioteca crea por defecto una nueva fuente de datos. El nombre de esta fuente de datos será "Partícula" de forma predeterminada y su etiqueta será su ID de partícula.

El método predeterminado es TCP, si quieres cambiarlo ve a las secciones de características y sigue el ejemplo.

Advertencia: acerca de la malla de partículas

Después del anuncio de la obsolescencia del protocolo Particle Mesh IoT, dado que Particle ya no produce unidades Mesh, Ubidots ha decidido dejar de admitirlo de fábrica en esta biblioteca. Si aún necesita utilizar el protocolo Mesh IoT en su proyecto junto con nuestra biblioteca, compile su proyecto a través de Particle CLI con la versión v3.1.4 de esta biblioteca.

Documentación

Constructor

Ubidots

 Ubidots(char* token, UbiServer server, IotProtocol iot_protocol)

@token, [Obligatorio]. Tu TOKEN de cuenta única de Ubidots.
@servidor, [Opcional], [Opciones] = [ UBI_INDUSTRIAL ], [Predeterminado] = UBI_INDUSTRIAL .
@iot_protocol, [Opcional], [Opciones] = [ UBI_HTTP , UBI_TCP , UBI_UDP , UBI_PARTICLE ], [Predeterminado] = UBI_TCP . El protocolo de IoT que utilizará para enviar o recuperar datos.

Crea una instancia de Ubidots.

NOTAS

UBI_PARTICLE envía datos mediante webhooks, así que asegúrese de seguir las instrucciones para configurar su webhook correctamente aquí.

Métodos

 void add(char *variable_label, float value, char *context, unsigned long dot_timestamp_seconds, unsigned int dot_timestamp_millis)

@variable_label, [Obligatorio]. La etiqueta de la variable donde se almacenará el punto.
@valor, [Obligatorio]. El valor del punto.
@context, [Opcional]. El contexto del punto.
@dot_timestamp_segundos, [Opcional]. La marca de tiempo del punto en segundos.
@dot_timestamp_millis, [Opcional]. El número de milisegundos de la marca de tiempo del punto. Si no se establecen los valores de milisegundos de la marca de tiempo, los segundos se multiplicarán por 1000.

Agrega un punto con su valor relacionado, contexto y marca de tiempo para enviarlo a una determinada fuente de datos, una vez que use add().

Importante: La longitud máxima de la carga útil es de 700 bytes; si su carga útil es mayor, no se enviará correctamente. Puede ver en su consola serie la carga útil que se enviará si llama al método setDebug(bool debug) y le pasa un valor verdadero.

 float get(const char* device_label, const char* variable_label)

@device_label, [Obligatorio]. La etiqueta del dispositivo que contiene la variable de la que recuperar valores.
@variable_label, [Obligatorio]. La etiqueta de variable de la que recuperar valores.

Devuelve como flotante el último valor del punto de la variable. IoTProtocol getCloudProtocol()

 std::map<int, float> tcpMap getMultipleValues(const char* deviceLabel, const char* variableLabels)

@deviceLabel Puntero [obligatorio] que almacena la etiqueta del dispositivo del que recuperar valores.
@variableLabels [Obligatorio] etiquetas de variables separadas por comas para recuperar valores

Devuelve una lista de mapas ordenada con los valores recuperados para las etiquetas de variables proporcionadas. Se puede acceder a los valores por índice, comenzando en la posición 0, y se asignan a cada etiqueta de variable establecida en la matriz separada por comas.

 void addContext(char *key_label, char *key_value)

@key_label, [Obligatorio]. La etiqueta de contexto clave para almacenar valores.
@key_value, [Obligatorio]. El valor del par de claves.

Agrega a la memoria local una nueva clave de contexto clave-valor. Las entradas del método deben ser punteros de caracteres. El método permite almacenar hasta 10 pares clave-valor.

 void getContext(char *context)

@context, [Obligatorio]. Un puntero de carácter donde se almacenará el contexto.

Construye el contexto según el protocolo elegido y lo almacena en el puntero char de contexto.

 void setDebug(bool debug);;

@debug, [Obligatorio]. Tipo booleano para activar/desactivar mensajes de depuración.

Ponga a disposición mensajes de depuración a través del puerto serie.

 bool send(const char* device_label, const char* device_name, PublishFlags flags);

@device_label, [Opcional], [Predeterminado] = ID DE DISPOSITIVO DE PARTÍCULAS. La etiqueta del dispositivo para enviar datos. Si no se establece, se utilizará el ID DEL DISPOSITIVO DE PARTÍCULAS.
@nombre_dispositivo, [Opcional], [Predeterminado] = @etiqueta_dispositivo. El nombre del dispositivo asignado de otro modo si el dispositivo aún no existe en su cuenta de Ubidots. Si no se establece, se utilizará el parámetro de etiqueta del dispositivo. NOTA : El nombre del dispositivo solo se admite a través de TCP/UDP; si utiliza otro protocolo, el nombre del dispositivo será el mismo que la etiqueta del dispositivo.
@flags, [Opcional], [Opciones] = [ PUBLIC , PRIVATE , WITH_ACK , NO_ACK ]. Banderas de webhook de partículas.

Envía todos los datos agregados usando el método add(). Devuelve verdadero si se enviaron los datos.