设备上报数据


设备上报数据

对于普通的物联网场景,使用设备的这两个标识,就可以完成设备数据向云端的上报,也就是我们通常说的数据采集。

ThingsCloud 支持多种设备接入协议,这里我们分别以常用的 HTTPMQTT 协议为例,快速实现数据上报,完成我们进入互联网开发世界的第一个 Hello World。

假设我们的物理设备是一个通过 UART 串口连接温度传感器的 ARM 单片机,通过 WiFi 模组接入互联网。我们希望将温度数据上报到云平台。

通过 HTTP 上报数据

通过使用 HTTP 接入协议,我们只需要在设备固件中访问云平台的 HTTP 接入点,将温度数据提交到云端。

不同区域有不同的 HTTP 接入点,我们可以设备详情页的 连接 页面找到,包括 HTTP 和基于 SSLHTTPs 两种类型。使用 HTTPs 可以获得传输层加密的特性,但对单片机资源要求较高,您需要有支持 SSLHTTP 客户端代码。

当我们找到设备 HTTP 接入点后,就可以使用如下 URL 来提交数据。

http://<endpoint>/device/v1/<AccessToken>/attributes

或使用 HTTPs

https://<endpoint>/device/v1/<AccessToken>/attributes

以上 URL 是云平台提供的 API 规范,在这里是代表 属性上报

使用 POST 方法提交如下 JSON 格式的数据:

{
    "temperature": 34.2
}

为了看到效果,我们直接在系统命令行中使用 cURL 来模拟 HTTP 请求。

curl -v -X POST -d "{\"temperature\": 34.2}" https://<endpoint>/device/v1/<AccessToken>/attributes -H "Content-Type:application/json" -H "Project-Key:<ProjectKey>"

提示

记得将这里的 <AccessToken><ProjectKey> 替换为您的设备证书。

如果没有什么意外,您会看到 cURL 命令返回的一大串请求结果,最底部会有类似如下的响应正文。

{"result":1,"ts":1608911646584}

这就代表着云平台已经成功收到了设备的数据上报。

如果您不喜欢使用命令行的 cURL,也可以使用一些第三方 API 客户端工具,支持 macOS 和 Windows,比如:

通过 MQTT 上报数据

MQTT 全称是 Message Queuing Telemetry Transport,它是一种基于消息队列的轻量级应用层通信协议,实现了消息发布和订阅。设备可以作为客户端的形式通过它来发布和接收消息,实现数据上报和实时控制。

ThingsCloud 公有云支持全球多个区域,并随着设备接入量不断扩张。每个接入的设备有专用的 MQTT 接入点,您可以在设备详情页的【连接】中找到 MQTT 接入点,例如:

mqtt://<endpoint>:1883

以上表示 MQTT 接入点服务器主机为 <endpoint>, 端口为 1883。其中 <endpoint> 会以域名形式出现,不支持 IP。

为了方便演示,我们使用 MQTT.fx 官网open in new window 来模拟设备端与 ThingsCloud 建立 MQTT 连接以及上报数据。

这里我们采用 MQTT 普通认证方式,通过 username/password 完成连接身份验证。同样要用到之前拿到的设备证书,身份信息对应关系如下:

参数
usernameAccessToken
passwordProjectKey
clientId空或任意

在 MQTT.fx 中设置连接参数,如下图:

MQTT.fx 设置连接到 ThingsCloud

连接成功后,在 Publish 中填写发布到的主题 attributes,这个主题是 ThingsCloud 标准协议的属性上报主题。

然后在内容区中填写以下 JSON 消息:

{
    "temperature": 34.2
}

点击 Publish 发布按钮,即可完成一次设备数据上报。

MQTT.fx 发布数据到 ThingsCloud

提示

更多 MQTT 接入 ThingsCloud 的实战教程,请进入 教程

提示

在实际的设备开发中,不同的硬件平台有不同的开发方式,我们将会对一些主流硬件提供 SDK 和代码示例,包括基于 ARM/RISC-V 的单片机、基于 RTOS/Linux 操作系统的嵌入式硬件、基于 OpenCPU 模式的通信模组等。

查看设备数据

接下来,就可以在控制台的设备详情页中实时看到上报数据。

查看设备数据

提示

控制台设备详情页的属性数据,会随着设备的上报实时变化,这得益于 ThingsCloud 提供了 MQTT 应用端订阅 服务,并支持面向 Web 应用的 Websocket 协议。对于基于 ThingsCloud API 的应用系统,也可以利用云平台提供的该服务,订阅设备的实时数据变化,带给用户良好的应用体验。

属性支持多种数据类型,对于数值型,可以通过点击属性右上角的图标,查看历史数据图表,如下图:

查看设备数据

这里我们还可以自由选择数据时间范围,以及聚合时间段和聚合函数,并且支持多种图表形式,如下图:

查看设备数据