ubidots particleダウンロード - ubidots particleソースコードダウンロード

ubidots particle

その他のカテゴリー

v3.1.4

ダウンロード

粒子

ここでは、Particle Photon または Electron デバイスを使用して Ubidots にデータを送信する方法を学びます。必要なのは、Ubidots の有効な TOKEN とともに送信する変数ラベルと値だけです。さらに、Ubidots アカウントから変数の最後の値を取得できます。

要件

粒子デバイス
マイクロUSBケーブル
インターネット接続
注: ライブラリの最後のバージョンでは、パーティクルデバイスのファームウェアバージョン 0.7.0 以降が必要です。

設定

Photon への WiFi 接続をセットアップします。これを行うには 2 つの方法があります。
- スマートフォンを使用する。
- USB 経由でコンピュータに接続します。
Photon を取得し、Ubidots アカウントを設定したら、Particle の Web IDE に移動しましょう。
- Particle の Web IDE で新しいアプリを作成し、名前を設定します。
- 「ライブラリ」タブに移動します。
- 提供されたライブラリに Ubidots と書き込み、Ubidots ライブラリを選択します。
- [アプリに含める]をクリックします。そして「MYAPP.ino」に戻ります

このライブラリは、デフォルトで新しいデータソースを作成します。このデータソースの名前はデフォルトで「Particle」となり、そのラベルはパーティクル ID になります。

デフォルトの方式は TCP です。変更する場合は、機能セクションに移動して例に従ってください。

警告: パーティクルメッシュについて

Particle Mesh IoT プロトコルの非推奨の発表後、Particle はメッシュユニットを生成しなくなったため、Ubidots はこのライブラリでのデフォルトのサポートを停止することを決定しました。プロジェクトでメッシュ IoT プロトコルをライブラリと組み合わせて使用する必要がある場合は、このライブラリのバージョン v3.1.4 を使用して Particle CLI を介してプロジェクトをコンパイルしてください。

ドキュメント

コンストラクタ

ユビドット

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

@トークン、[必須]。あなたの Ubidots 固有のアカウントトークン。
@server、[オプション]、[オプション] = [ UBI_INDUSTRIAL ]、[デフォルト] = UBI_INDUSTRIAL 。
@iot_protocol、[オプション]、[オプション] = [ UBI_HTTP 、 UBI_TCP 、 UBI_UDP 、 UBI_PARTICLE ]、[デフォルト] = UBI_TCP 。データの送信または取得に使用する IoT プロトコル。

Ubidots インスタンスを作成します。

注意事項

UBI_PARTICLE Webhook を使用してデータを送信するため、ここで Webhook を適切に設定する手順に従ってください。

メソッド

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

@variable_label、[必須]。ドットが格納される変数のラベル。
@値、[必須]。ドットの値。
@context、[オプション]。ドットのコンテキスト。
@dot_timestamp_秒、[オプション]。ドットのタイムスタンプ (秒単位)。
@dot_timestamp_millis、[オプション]。ドットのタイムスタンプのミリ秒数。タイムスタンプのミリ秒値が設定されていない場合、秒は 1000 倍になります。

add() を使用すると、特定のデータソースに送信される関連する値、コンテキスト、およびタイムスタンプを含むドットを追加します。

重要:ペイロードの最大長は 700 バイトです。ペイロードがそれより大きい場合、正しく送信されません。 setDebug(bool debug)メソッドを呼び出して true 値を渡すと、送信するペイロードをシリアルコンソールで確認できます。

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

@device_label、[必須]。値を取得する変数を含むデバイスラベル。
@variable_label、[必須]。値を取得する変数ラベル。

変数からのドットの最後の値を float として返します。 IoTプロトコル getCloudProtocol()

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

@deviceLabel [必須] 値を取得するデバイスのラベルを格納するポインター。
@variableLabels [必須] 値を取得するカンマ区切りの変数ラベル

指定された変数ラベルに対して取得された値を含む順序付きマップリストを返します。値には、位置 0 から始まるインデックスによってアクセスでき、カンマ区切りの配列内のすべての変数ラベルセットにマップされます。

 void addContext(char *key_label, char *key_value)

@key_label、[必須]。値を保存するキーコンテキストラベル。
@key_value、[必須]。キーペアの値。

新しいキーと値のコンテキストキーをローカルメモリに追加します。メソッドの入力は char ポインターである必要があります。このメソッドでは、最大 10 個のキーと値のペアを保存できます。

 void getContext(char *context)

@context、[必須]。コンテキストが保存される char ポインタ。

選択したプロトコルに従ってコンテキストを構築し、それをコンテキスト文字ポインタに格納します。

 void setDebug(bool debug);;

@debug、[必須]。デバッグメッセージをオフ/オンにするブール型。

シリアルポート経由でデバッグメッセージを利用できるようにします。

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

@device_label、[オプション]、[デフォルト] = パーティクルデバイス ID。データを送信するデバイスラベル。設定されていない場合は、PARTICLE DEVICE ID が使用されます。
@device_name、[オプション]、[デフォルト] = @device_label。デバイスが Ubidots アカウントに存在しない場合に割り当てられるデバイス名。設定されていない場合は、デバイスラベルパラメータが使用されます。注: デバイス名は TCP/UDP 経由でのみサポートされます。別のプロトコルを使用する場合、デバイス名はデバイスラベルと同じになります。
@flags、[オプション]、[オプション] = [ PUBLIC 、 PRIVATE 、 WITH_ACK 、 NO_ACK ]。パーティクル Webhook フラグ。

add() メソッドを使用して追加されたすべてのデータを送信します。データが送信された場合は true を返します。