ubidots particle Download - ubidots particle -Quellcode herunterladen

ubidots particle

Andere Kategorien

v3.1.4

Herunterladen

Teilchen

Hier erfahren Sie, wie Sie mit Particle Photon- oder Electron-Geräten Daten an Ubidots senden. Sie benötigen lediglich die Variablenbezeichnung und den Wert, die Sie zusammen mit einem gültigen Ubidots-TOKEN senden möchten. Darüber hinaus können Sie den letzten Wert einer Variablen aus Ihrem Ubidots-Konto abrufen.

Anforderungen

Partikelgerät
Micro-USB-Kabel
Internetverbindung
Hinweis: Für die letzte Version der Bibliothek ist es erforderlich, dass Ihr Partikelgerät über die Firmware-Version 0.7.0 oder höher verfügt.

Aufstellen

Richten Sie eine WLAN-Verbindung zum Photon ein. Hierzu gibt es zwei Möglichkeiten:
- Mit Ihrem Smartphone.
- Schließen Sie es über USB an Ihren Computer an.
Nachdem Sie Ihr Photon beansprucht und Ihr Ubidots-Konto eingerichtet haben, gehen wir zur Web-IDE von Particle.
- Erstellen Sie in der Web-IDE des Partikels eine neue App und legen Sie den Namen fest.
- Gehen Sie zur Registerkarte „Bibliothek“.
- Schreiben Sie in die bereitgestellte Bibliothek „Ubidots“ und wählen Sie die Ubidots-Bibliothek aus.
- Klicken Sie auf IN APP EINBINDEN . Und zurück zu „MYAPP.ino“

Diese Bibliothek erstellt standardmäßig eine neue Datenquelle. Der Name dieser Datenquelle lautet standardmäßig „Partikel“ und die Bezeichnung lautet „Partikel-ID“.

Die Standardmethode ist TCP. Wenn Sie sie ändern möchten, gehen Sie zu den Funktionsabschnitten und folgen Sie dem Beispiel.

Warnung: Über Partikelnetz

Nach der Ankündigung der Abschaffung des Particle Mesh IoT-Protokolls, da Particle keine Mesh-Einheiten mehr produziert, hat Ubidots beschlossen, es nicht mehr standardmäßig in dieser Bibliothek zu unterstützen. Wenn Sie in Ihrem Projekt weiterhin das Mesh IoT-Protokoll in Verbindung mit unserer Bibliothek verwenden müssen, kompilieren Sie Ihr Projekt bitte über die Particle CLI mit der Version v3.1.4 dieser Bibliothek.

Dokumentation

Konstrukteur

Ubidots

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

@token, [Erforderlich]. Ihr einzigartiger Ubidots-Konto-TOKEN.
@server, [Optional], [Optionen] = [ UBI_INDUSTRIAL ], [Standard] = UBI_INDUSTRIAL .
@iot_protocol, [Optional], [Optionen] = [ UBI_HTTP , UBI_TCP , UBI_UDP , UBI_PARTICLE ], [Standard] = UBI_TCP . Das IoT-Protokoll, das Sie zum Senden oder Abrufen von Daten verwenden.

Erstellt eine Ubidots-Instanz.

HINWEISE

UBI_PARTICLE sendet Daten mithilfe von Webhooks. Befolgen Sie daher unbedingt die Anweisungen, um Ihren Webhook hier ordnungsgemäß einzurichten.

Methoden

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

@variable_label, [Erforderlich]. Die Bezeichnung der Variablen, in der der Punkt gespeichert wird.
@value, [Erforderlich]. Der Wert des Punktes.
@context, [Optional]. Der Kontext des Punktes.
@dot_timestamp_seconds, [Optional]. Der Zeitstempel des Punkts in Sekunden.
@dot_timestamp_millis, [Optional]. Die Zeitstempelanzahl des Punkts in Millisekunden. Wenn die Millisekundenwerte des Zeitstempels nicht festgelegt sind, werden die Sekunden mit 1000 multipliziert.

Fügt einen Punkt mit dem zugehörigen Wert, Kontext und Zeitstempel hinzu, der an eine bestimmte Datenquelle gesendet wird, sobald Sie add() verwenden.

Wichtig: Die maximale Nutzlastlänge beträgt 700 Byte. Wenn Ihre Nutzlast größer ist, wird sie nicht ordnungsgemäß gesendet. Sie können auf Ihrer seriellen Konsole die zu sendende Nutzlast sehen, wenn Sie die Methode setDebug(bool debug) aufrufen und ihr einen wahren Wert übergeben.

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

@device_label, [Erforderlich]. Die Gerätebezeichnung, die die Variable enthält, aus der Werte abgerufen werden sollen.
@variable_label, [Erforderlich]. Die Variablenbezeichnung, aus der Werte abgerufen werden sollen.

Gibt als Float den letzten Wert des Punktes aus der Variablen zurück. IotProtocol getCloudProtocol()

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

@deviceLabel [Obligatorisch] Zeiger, der die Bezeichnung des Geräts speichert, von dem Werte abgerufen werden sollen.
@variableLabels [Obligatorisch] durch Kommas getrennte Variablenbeschriftungen, aus denen Werte abgerufen werden sollen

Gibt eine geordnete Kartenliste mit den für die bereitgestellten Variablenbeschriftungen abgerufenen Werten zurück. Auf die Werte kann über einen Index zugegriffen werden, beginnend bei Position 0, und sie werden jedem Variablenlabel zugeordnet, das im durch Kommas getrennten Array festgelegt ist.

 void addContext(char *key_label, char *key_value)

@key_label, [Erforderlich]. Die Schlüsselkontextbezeichnung zum Speichern von Werten.
@key_value, [Erforderlich]. Der Schlüsselpaarwert.

Fügt dem lokalen Speicher einen neuen Schlüsselwert-Kontextschlüssel hinzu. Die Methodeneingaben müssen Zeichenzeiger sein. Die Methode ermöglicht die Speicherung von bis zu 10 Schlüssel-Wert-Paaren.

 void getContext(char *context)

@context, [Erforderlich]. Ein Zeichenzeiger, auf den der Kontext gespeichert wird.

Erstellt den Kontext gemäß dem ausgewählten Protokoll und speichert ihn im Kontext-Char-Zeiger.

 void setDebug(bool debug);;

@debug, [Erforderlich]. Boolescher Typ zum Ein-/Ausschalten von Debug-Meldungen.

Stellen Sie Debug-Meldungen über die serielle Schnittstelle zur Verfügung.

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

@device_label, [Optional], [Standard] = PARTIKELGERÄTE-ID. Die Gerätebezeichnung zum Senden von Daten. Wenn nicht festgelegt, wird die PARTIKELGERÄTE-ID verwendet.
@device_name, [Optional], [Default] = @device_label. Der ansonsten zugewiesene Gerätename, wenn das Gerät noch nicht in Ihrem Ubidots-Konto vorhanden ist. Wenn dieser Parameter nicht festgelegt ist, wird der Parameter „Gerätebezeichnung“ verwendet. HINWEIS : Der Gerätename wird nur über TCP/UDP unterstützt. Wenn Sie ein anderes Protokoll verwenden, ist der Gerätename mit der Gerätebezeichnung identisch.
@flags, [Optional], [Optionen] = [ PUBLIC , PRIVATE , WITH_ACK , NO_ACK ]. Partikel-Webhook-Flags.

Sendet alle mit der Methode add() hinzugefügten Daten. Gibt true zurück, wenn die Daten gesendet wurden.