ubidots particle下載 - ubidots particle源碼下載

ubidots particle

其他類別

v3.1.4

下載

粒子

在這裡您將學習如何使用粒子光子或電子設備將資料傳送到 Ubidots。您只需要想要與 Ubidots 有效令牌一起傳送的變數標籤和值。此外，您還可以從 Ubidots 帳戶取得變數的最後一個值。

要求

粒子裝置
微型 USB 電纜
網路連線
注意：對於最新版本的庫，您的粒子設備的韌體版本必須為 0.7.0 或更高版本。

設定

設定與 photon 的 WiFi 連線。有兩種方法可以做到這一點：
- 使用您的智慧型手機。
- 透過 USB 將其連接到您的電腦。
領取您的 Photon 並設定您的 Ubidots 帳戶後，讓我們前往 Particle 的 Web IDE。
- 在 Particle 的 Web IDE 中建立一個新應用程式並設定名稱。
- 轉到庫選項卡。
- 在貢獻庫中寫入 Ubidots 並選擇 Ubidots 庫。
- 按一下「包含在應用程式中」 。並返回“MYAPP.ino”

該庫預設創建新的資料來源。這個資料來源的名字預設是“Particle”，他的標籤就是你的Particle ID。

預設方法是 TCP，如果您想更改它，請轉到功能部分並按照範例進行操作。

警告：關於粒子網格

在宣布棄用 Particle Mesh IoT 協議後，由於 Particle 不再生產 Mesh 單元，Ubidots 決定停止在該庫中對其進行開箱即用的支援。如果您仍需要在專案中結合 Mesh IoT 協定和我們的函式庫，請使用該函式庫的 v3.1.4 版本透過 Particle CLI 編譯您的專案。

文件

建構函數

烏比多斯

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

@token，[必需]。您的 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_seconds，[可選]。該點的時間戳（以秒為單位）。
@dot_timestamp_millis，[可選]。點的時間戳毫秒數。如果未設定時間戳記的毫秒值，則秒數將乘以 1000。

使用 add() 後，新增一個點及其相關值、上下文和時間戳，並將其傳送到某個資料來源。

重要提示：最大有效負載長度為 700 字節，如果您的有效負載較大，則將無法正確傳送。如果您呼叫setDebug(bool debug)方法並將 true 值傳遞給它，您可以在序列控制台上看到要傳送的有效負載。

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

@device_label，[必需]。包含要從中檢索值的變數的設備標籤。
@variable_label，[必需]。要從中檢索值的變數標籤。

以浮點形式傳回變數中點的最後一個值。 IotProtocol 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，[必需]。將儲存上下文的字元指標。

根據所選協議建立上下文並將其儲存在上下文字元指標中。

 void setDebug(bool debug);;

@調試，[必需]。用於關閉/開啟偵錯訊息的布林類型。

透過串行埠提供可用的偵錯訊息。

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

@device_label，[可選]，[預設] = 粒子裝置 ID。發送資料的設備標籤。如果未設置，將使用粒子設備 ID。
@device_name、[可選]、[預設] = @device_label。如果您的 Ubidots 帳戶中尚不存在該設備，則會指派設備名稱。如果未設置，將使用設備標籤參數。注意：設備名稱僅支援通過 TCP/UDP，如果您使用其他協議，設備名稱將與設備標籤相同。
@flags，[可選]，[選項] = [ PUBLIC ， PRIVATE ， WITH_ACK ， NO_ACK ]。粒子 webhook 標誌。

傳送使用 add() 方法新增的所有資料。如果資料已傳送，則傳回 true。