ubidots particle Télécharger - ubidots particle Téléchargement du code source

ubidots particle

Autres catégories

v3.1.4

Télécharger

Particule

Ici, vous apprendrez comment envoyer des données à Ubidots à l'aide d'appareils Particle Photon ou Electron. Vous avez juste besoin de l'étiquette de la variable et de la valeur que vous souhaitez envoyer avec un TOKEN valide Ubidots. De plus, vous pouvez obtenir la dernière valeur d'une variable depuis votre compte Ubidots.

Exigences

Dispositif à particules
Câble micro-USB
Connexion Internet
Remarque : Pour la dernière version de la bibliothèque, il est nécessaire que votre périphérique Particule soit équipé de la version 0.7.0 ou supérieure du micrologiciel.

Installation

Configurez la connexion WiFi au photon. Il existe deux manières de procéder :
- Utiliser votre téléphone intelligent.
- Connectez-le à votre ordinateur via USB.
Après avoir réclamé votre Photon et configuré votre compte Ubidots, passons à l'IDE Web de Particle.
- Dans l'IDE Web de Particle, créez une nouvelle application et définissez son nom.
- Allez dans l'onglet bibliothèque.
- Dans la bibliothèque contribuée, écrivez Ubidots et sélectionnez la bibliothèque Ubidots.
- Cliquez sur INCLURE DANS L'APPLICATION . Et revenez à "MYAPP.ino"

Cette bibliothèque crée par défaut une nouvelle source de données. Le nom de cette source de données sera « Particle » par défaut, et son étiquette sera votre ID de particule.

La méthode par défaut est TCP, si vous souhaitez la modifier, rendez-vous dans les sections fonctionnalités et suivez l'exemple.

Avertissement : À propos du maillage de particules

Après l'annonce de la dépréciation du protocole Particle Mesh IoT, Particle ne produisant plus d'unités Mesh, Ubidots a décidé d'arrêter de le supporter de manière standard dans cette bibliothèque. Si vous devez toujours utiliser le protocole Mesh IoT dans votre projet en conjonction avec notre bibliothèque, veuillez compiler votre projet via la CLI Particle avec la version v3.1.4 de cette bibliothèque.

Documentation

Constructeur

Ubidots

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

@token, [Obligatoire]. Votre TOKEN de compte unique Ubidots.
@server, [Facultatif], [Options] = [ UBI_INDUSTRIAL ], [Par défaut] = UBI_INDUSTRIAL .
@iot_protocol, [Facultatif], [Options] = [ UBI_HTTP , UBI_TCP , UBI_UDP , UBI_PARTICLE ], [Par défaut] = UBI_TCP . Le protocole IoT que vous utiliserez pour envoyer ou récupérer des données.

Crée une instance Ubidots.

REMARQUES

UBI_PARTICLE envoie des données à l'aide de webhooks, alors assurez-vous de suivre les instructions pour configurer correctement votre webhook ici.

Méthodes

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

@variable_label, [Obligatoire]. L'étiquette de la variable où le point sera stocké.
@value, [Obligatoire]. La valeur du point.
@context, [Facultatif]. Le contexte du point.
@dot_timestamp_seconds, [Facultatif]. L'horodatage du point en secondes.
@dot_timestamp_millis, [Facultatif]. Nombre d'horodatage du point en millisecondes. Si les valeurs en millisecondes de l'horodatage ne sont pas définies, les secondes seront multipliées par 1 000.

Ajoute un point avec sa valeur, son contexte et son horodatage associés à envoyer à une certaine source de données, une fois que vous utilisez add().

Important : La longueur maximale de la charge utile est de 700 octets. Si votre charge utile est supérieure, elle ne sera pas correctement envoyée. Vous pouvez voir sur votre console série la charge utile à envoyer si vous appelez la méthode setDebug(bool debug) et lui transmettez une valeur vraie.

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

@device_label, [Obligatoire]. Étiquette de périphérique qui contient la variable à partir de laquelle récupérer les valeurs.
@variable_label, [Obligatoire]. Étiquette de variable à partir de laquelle récupérer les valeurs.

Renvoie sous forme flottante la dernière valeur du point de la variable. IotProtocolgetCloudProtocol()

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

@deviceLabel [Obligatoire] pointeur qui stocke l'étiquette du périphérique à partir duquel récupérer les valeurs.
@variableLabels [Obligatoire] étiquettes de variables séparées par des virgules pour récupérer les valeurs de

Renvoie une liste de cartes ordonnées avec les valeurs récupérées pour les étiquettes de variables fournies. Les valeurs sont accessibles par index, à partir de la position 0, et sont mappées à chaque étiquette de variable définie dans le tableau séparé par des virgules.

 void addContext(char *key_label, char *key_value)

@key_label, [Obligatoire]. Étiquette de contexte clé pour stocker les valeurs.
@key_value, [Obligatoire]. La valeur de la paire de clés.

Ajoute à la mémoire locale une nouvelle clé de contexte clé-valeur. Les entrées de la méthode doivent être des pointeurs char. La méthode permet de stocker jusqu'à 10 paires clé-valeur.

 void getContext(char *context)

@context, [Obligatoire]. Un pointeur char où le contexte sera stocké.

Construit le contexte selon le protocole choisi et le stocke dans le pointeur de caractère de contexte.

 void setDebug(bool debug);;

@debug, [Obligatoire]. Type booléen pour activer/désactiver les messages de débogage.

Rendre les messages de débogage disponibles via le port série.

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

@device_label, [Facultatif], [Par défaut] = ID DE L'APPAREIL DE PARTICULE. Étiquette de périphérique pour envoyer des données. S’il n’est pas défini, l’ID DE L’APPAREIL DE PARTICULE sera utilisé.
@device_name, [Facultatif], [Par défaut] = @device_label. Le nom de l'appareil autrement attribué si l'appareil n'existe pas déjà dans votre compte Ubidots. S’il n’est pas défini, le paramètre d’étiquette de périphérique sera utilisé. REMARQUE : Le nom de l'appareil n'est pris en charge que via TCP/UDP. Si vous utilisez un autre protocole, le nom de l'appareil sera le même que l'étiquette de l'appareil.
@flags, [Facultatif], [Options] = [ PUBLIC , PRIVATE , WITH_ACK , NO_ACK ]. Indicateurs de webhook de particules.

Envoie toutes les données ajoutées à l'aide de la méthode add(). Renvoie vrai si les données ont été envoyées.