Thingsboard Widgets 开源项目教程

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.json 至 weekly_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.json、gauge_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: 步长。

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