Thingsboard 简单教程:使用 ThingsBoard 查看物联网数据

ThingsKit物联网平台:基于ThingsBoard开发,面向中小型企业开箱即用的低代码物联网平台 :ThingsKit物联网平台
ThingsKit物联网平台演示环境 :https://docs.thingskit.com/thingskit-link/getting-started

ThingsKit物联网平台
ThingsKit物联网平台

欢迎加入ThingsBoard技术交流群

ThingsKit物联网平台

这里可复制Q群号:69998183

关注“云腾五洲”:获取二开ThingsBoard物联网平台演示

ThingsKit物联网平台

TK物联网平台:ThingsKit物联网平台


==========================================================


### 什么是ThingsBoard?

ThingsBoard是一个开源平台,用于收集和可视化物联网设备的数据。可以将来自任意数量设备的数据发送到云服务器,在云服务器中可以通过可自定义的仪表板查看或共享。

本指南将介绍如何在Linode上安装ThingsBoard并使用Raspberry Pi将简单的遥测数据发送到云仪表板。

注意: 本指南将使用带有Sense HAT的Raspberry Pi 3 。您可以替换任何能够发送遥测数据的设备,或者curl在不使用任何外部设备的情况下用于试验ThingsBoard。

### 安装ThingsBoard
ThingsBoard在Java 8上运行,建议使用Oracle JDK。

- 安装software-properties-common:

sudo apt install software-properties-common

- 添加Oracle PPA存储库:

sudo apt-add-repository ppa:webupd8team/java

- 更新您的系统:

sudo apt update

- 安装Oracle JDK。要安装Java 9 JDK,java8请java9在命令中更改为:

sudo apt install oracle-java8-installer

- 检查您的Java版本:

### java -version
设置PostgreSQL

- 安装PostgreSQL:

sudo apt install postgresql postgresql-contrib

- 为ThingsBoard创建数据库和数据库用户:

sudo -u postgres createdb thingsboard sudo -u postgres createuser thingsboard

- 为thingsboard用户设置密码并授予对数据库的访问权限:

sudo -u postgres psql thingsboard ALTER USER thingsboard WITH PASSWORD 'thingsboard'; GRANT ALL PRIVILEGES ON DATABASE thingsboard TO thingsboard; \q

- 安装ThingsBoard

下载安装包。检查版本页面,并将以下命令中的版本号替换为标记为最新版本的版本:

wget https://github.com/thingsboard/thingsboard/releases/download/v1.3.1/thingsboard-1.3.1.deb

安装ThingsBoard:

sudo dpkg -i thingsboard-1.3.1.deb

/etc/thingsboard/conf/thingsboard.yml在文本编辑器中打开并注释掉该HSQLDB DAO Configuration部分:

/etc/thingsboard/conf/thingsboard.yml 

```go
# HSQLDB DAO Configuration
#spring:
#  data:
#    jpa:
#      repositories:
#        enabled: "true"
#  jpa:
#    hibernate:
#      ddl-auto: "validate"
#    database-platform: "org.hibernate.dialect.HSQLDialect"
#  datasource:
#    driverClassName: "${SPRING_DRIVER_CLASS_NAME:org.hsqldb.jdbc.JDBCDriver}"
#    url: "${SPRING_DATASOURCE_URL:jdbc:hsqldb:file:${SQL_DATA_FOLDER:/tmp}/thingsboardDb;sql.enforce_size=false}"
#    username: "${SPRING_DATASOURCE_USERNAME:sa}"
#    password: "${SPRING_DATASOURCE_PASSWORD:}"

在同一节中,取消注释PostgreSQL配置块。用thingsboard用户名和密码替换用户名和密码字段thingsboard:

/etc/thingsboard/conf/thingsboard.yml

# PostgreSQL DAO Configuration
spring:
  data:
    jpa:
      repositories:
        enabled: "true"
  jpa:
    hibernate:
      ddl-auto: "validate"
    database-platform: "org.hibernate.dialect.PostgreSQLDialect"
  datasource:
    driverClassName: "${SPRING_DRIVER_CLASS_NAME:org.postgresql.Driver}"
    url: "${SPRING_DATASOURCE_URL:jdbc:postgresql://localhost:5432/thingsboard}"
    username: "${SPRING_DATASOURCE_USERNAME:thingsboard}"
    password: "${SPRING_DATASOURCE_PASSWORD:thingsboard}"
  • 运行此安装脚本:

sudo /usr/share/thingsboard/bin/install/install.sh --loadDemo

  • 启动ThingsBoard服务:

sudo systemctl enable thingsboard sudo systemctl start thingsboard

NGINX反向代理

localhost:8080默认情况下,ThingsBoard会监听。出于安全考虑,最好通过反向代理服务仪表板。本指南将使用NGINX,但可以使用任何网络服务器。

  • 安装NGINX:

sudo apt install nginx

/etc/nginx/conf.d/thingsboard.conf使用文本编辑器创建并编辑它以匹配下面的示例。替换example.com为您的Linode的公共IP地址或FQDN。

/etc/nginx/conf.d/thingsboard.conf

server {
    listen 80;
    listen [::]:80;

    server_name example.com;

    location / {
        # try_files $uri $uri/ =404;
        proxy_pass http://localhost:8080/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}
  • 重启NGINX:

sudo systemctl restart nginx

设置ThingsBoard设备

使用Web浏览器导航到您的Linode的IP地址。你应该看到ThingsBoard登录页面:

模拟账户登录tenant@thingsboard.org和密码是tenant。登录后,您应该将其更改为更安全的密码。

  • 在主菜单中,单击“ 设备”图标,然后单击右下角的+图标以添加新设备。

  • 选择设备名称。将设备类型设置为PI。

  • 添加设备后,单击“ 设备”菜单中的图标。单击COPY ACCESS TOKEN复制此设备的API密钥(在下面使用)。
    配置Raspberry Pi

注意以下步骤假定您具有对Raspberry Pi的终端访问权限,并且已配置Sense HAT及其库。有关Sense HAT入门的更多信息,请参阅Raspberry Pi 官方文档。如果您更愿意使用curl将模拟数据发送到ThingsBoard,则可以跳过本节。

  • 基本Python脚本

使用文本编辑器,thingsboard.py在您选择的目录中创建。使用上一节中复制到剪贴板的API密钥添加以下内容:

thingsboard.py

#!/usr/bin/env python

import json
import requests
from sense_hat import SenseHat
from time import sleep

# Constants

API_KEY          = "<ThingsBoard API Key>"
THINGSBOARD_HOST = "<Linode Public IP Address>"

thingsboard_url  = "http://{0}/api/v1/{1}/telemetry".format(THINGSBOARD_HOST, API_KEY)

sense = SenseHat()


data = {}

while True:
    data['temperature'] = sense.get_temperature()
    data['pressure']    = sense.get_pressure()
    data['humidity']    = sense.get_humidity()

    #r = requests.post(thingsboard_url, data=json.dumps(data))
    print(str(data))
    sleep(5)

通过从命令行运行脚本来测试脚本:

python thingsboard.py

基本遥测应每五秒打印到控制台:

{'pressure': 1020.10400390625, 'temperature': 31.81730842590332, 'humidity': 19.72637939453125}
{'pressure': 1020.166259765625, 'temperature': 31.871795654296875, 'humidity': 20.247455596923828}
{'pressure': 1020.119140625, 'temperature': 31.908119201660156, 'humidity': 19.18065643310547}
{'pressure': 1020.11669921875, 'temperature': 31.908119201660156, 'humidity': 20.279142379760742}
{'pressure': 1020.045166015625, 'temperature': 31.92628288269043, 'humidity': 20.177040100097656}

如果脚本正常工作,请删除该print语句并取消注释该r = requests.post()行。还要增加sleep()时间间隔:

thingsboard.py

while True:
    data['temperature'] = sense.get_temperature()
    data['pressure']    = sense.get_pressure()
    data['humidity']    = sense.get_humidity()

    r = requests.post(thingsboard_url, data=json.dumps(data))
    sleep(60)

创建系统服务

您现在应该能够从命令行运行脚本,每分钟传输一次温度,压力和湿度数据。但是,为了确保持续发送数据,最好启用一个新服务,该服务将在服务器重新启动时自动运行脚本。

  • 将脚本复制到/usr/bin/并使其可执行:

sudo cp thingsboard.py /usr/bin/thingsboard.py sudo chmod +x /usr/bin/thingsboard.py

  • 创建服务文件以将Python脚本作为服务运行:

/lib/systemd/system/thingsdata.service

[Unit]
Description=Push telemetry data from Sense HAT to ThingsBoard.

[Service]
Type=simple
ExecStart=/usr/bin/thingsboard.py

[Install]
WantedBy=multi-user.target
  • 启用并启动服务:

sudo systemctl enable thingsdata.service sudo systemctl start thingsdata.service

  • 检查新服务的状态:

sudo systemctl status thingsdata.service

使用cURL发送数据

注意: 如果您使用的是Raspberry Pi,请跳过此部分。

  • 使用虚拟数据创建示例JSON文件:
dummy_data.json
{
  "temperature": 38,
  "humidity": 50,
  "pressure": 1100
}

用于curl向ThingsBoard服务器发送POST请求:

curl -v -X POST -d @dummy_data.json http://$THINGSBOARD_HOST:$THINGSBOARD_PORT/api/v1/$ACCESS_TOKEN/telemetry --header "Content-Type:application/json"

查看ThingsBoard中的数据

如果服务成功运行,则应每隔60秒将数据传输到ThingsBoard服务器。

  • 重新登录浏览器中的ThingsBoard仪表板,然后在“ 设备”菜单中单击设备的卡。从结果详细信息页面中选择最新的遥测选项卡。您应该看到设备的温度,湿度和压力数据:

  • 单击其中一种数据类型旁边的复选框,然后单击“在小组件上显示”。

  • 使用下拉菜单和轮播菜单选择一个预设小组件,以在仪表板上显示此数据类型。选择窗口小部件后,单击“ 添加到仪表板”。

下一步

ThingsBoard提供的小部件可以轻松编辑,也可以创建新的小部件。可以组合表示来自多个设备的多个数据流的多个小部件,以生成定制的仪表板。然后,这些仪表板可以公开或与客户共享。

有关如何自定义和设置控件和仪表盘的更多信息,请参阅ThingsBoard 部件库和仪表板页面的ThingsBoard Github上回购也有例如仪表板的图像。

更多信息

有关此主题的其他信息,您可能需要参考以下资源。虽然提供这些是希望它们有用,但请注意,我们无法保证外部托管材料的准确性或及时性。

入门 - ThingsBoard

ThingsBoard Github Repo

来源:https://cloud.tencent.com/developer/article/1343322

posted @ 2020-07-15 20:41  ThingsKit物联网平台  阅读(9123)  评论(0编辑  收藏  举报
物联网平台 智能物联网平台