首页
/ Thingsboard Widgets 开源项目教程

Thingsboard Widgets 开源项目教程

2025-04-18 22:27:19作者:贡沫苏Truman

1. 项目目录结构及介绍

Thingsboard Widgets 项目是一个为 Thingsboard 平台提供自定义小部件的库。项目的目录结构如下所示:

Collibellex-Thingsboard-Widgets/
├── .DS_Store
├── .gitignore
├── 3d_chart.json
├── chart_2.json
├── cheatsheet.md
├── double_1.json
├── fluid_level_1.json
├── fluid_level_2.json
├── funnel.json
├── gauge_1.json
├── gauge_2.json
├── gauge_3.json
├── gauge_4.json
├── hoversidenavbuttonsmenu.json
├── hoversidenavbuttonsmenu.pdf
├── light_bulb_1.json
├── LICENSE
├── README.md
├── _config.yml
├── change_dashboard_state.json
├── multi_slider.json
├── pv_system_1.json
├── round_slider_1.json
├── slider 2.json
├── slider.json
├── switch1.json
├── switch2.json
├── switch3.json
├── switch6.json
├── thermostat_1.json
├── thermostat_2.json
├── toggle_button_1.json
├── weekly_heatmap.json
  • .DS_Store: Mac OS X 系统生成的目录清单文件。
  • .gitignore: 指定 Git 忽略的文件和目录。
  • 3d_chart.jsonweekly_heatmap.json: 这些是自定义小部件的配置文件。
  • cheatsheet.md: 项目速查表。
  • LICENSE: 项目使用的 MIT 许可证。
  • README.md: 项目说明文件。
  • _config.yml: Jekyll 项目的配置文件。

2. 项目的启动文件介绍

此项目不需要特定的启动文件,因为它是作为 Thingsboard 平台的一部分运行的。你需要将项目中的小部件配置文件导入到 Thingsboard 平台中。

导入步骤如下:

  1. 登录到你的 Thingsboard 安装或 Thingsboard.cloud 账户。
  2. 打开小部件库。
  3. 选择 "添加小部件包",然后选择 "导入小部件包"。
  4. 将文件 collibellex.json 拖放到浏览器窗口中。

3. 项目的配置文件介绍

配置文件主要是各个小部件的 JSON 文件,例如 thermostat_1.jsongauge_1.json 等。以下是 thermostat_1.json 的配置示例:

{
  "type": "control",
  " Thermostat Widget": {
    "changeRequestMethod": "setValue",
    "rpcRequestTimeout": 500,
    "statusRequestMethod": "getValue",
    "minimumValue": 0,
    "maximumValue": 100,
    "stepWidth": 1
  }
}

每个小部件的配置文件都包含了相应的小部件类型和参数,例如:

  • changeRequestMethod: 修改请求方法。
  • rpcRequestTimeout: RPC 请求超时时间。
  • statusRequestMethod: 状态请求方法。
  • minimumValue: 最小值。
  • maximumValue: 最大值。
  • stepWidth: 步长。

这些配置参数可以根据需要在小部件的配置界面中进行调整。

登录后查看全文
热门项目推荐