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。