硬件集成 - 温湿度数据同步API版插件
1. 简介
1.1 插件简介
硬件集成 - 温湿度数据同步API版插件能够定时抓取、记录多个温湿度计的温湿度信息,支持在简道云中自动同步温湿度数据,帮助用户实现环境温湿度的远程监控与管理。
1.2 使用场景
适用于多种需要监控环境温湿度的场景中,如:
- 农业种植企业:以大棚种植户、规模化农场为主,需求集中在低成本数据采集、远程监控功能,通过温湿度数据优化灌溉、通风策略,提升作物产量。
- 电子制造工厂:需对生产车间、仓库的温湿度进行精准控制,避免电子元件受潮、高温损坏。需求集中在高精度测量、与 MES 系统集成,通过数据联动实现车间环境自动化调节,提升生产良率。
- 中小型办公场景:如办公楼宇、实验室、小型仓库等,需求是轻量化数据采集与管理,通过简道云表单实现数据记录、统计分析,无需复杂部署,注重性价比和易操作性。
1.3 预期效果
以设备温湿度状态监测为例,效果如下所示:

1.4 使用说明
1)「硬件集成 - 温湿度数据同步API版」插件采用年费订阅模式,您可以通过【7. 联系方式】联系我们,免费获取试用激活码或购买长期激活码。
2)在激活码有效期内可无限次调用该插件,无需每次调用时单独支付费用。激活码到期后,若用户希望继续使用「硬件集成 - 温湿度数据同步API版」插件的功能,则需续订下一年的服务。若未续订,插件功能将无法使用。
2. 硬件安装与配置
「硬件集成 - 温湿度数据同步API版」插件须适配指定型号的智能温湿度计,支持 WiFi、移动数据等方式数据传输,您可以通过【7. 联系方式】联系我们,获取适配产品清单或由我们代为采购和集成配置,您将得到智能温湿度计硬件、配件和第三方。
3. 插件安装及配置
3.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:硬件集成 - 温湿度数据同步API版插件。
- 安装成功后,可参考本文【3.2 配置插件】和【3.3 启用插件】,前往「开放平台 >> 插件管理」处启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「硬件集成 - 温湿度数据同步API版」插件。插件市场处安装方法可参见文档:插件市场中【2.3插件安装】。

3.2 配置插件
3.2.1 获取apikey
在「密钥管理 >> API Key」处,创建并获取 API Key。

3.2.2 配置插件
安装后,在插件管理处,点击插件右侧的设置按钮,进行插件配置:
- ApiKey:将【3.2.1 获取 apikey】中获取的简道云「Apikey」 配置进去;
- 用户名:根据【2. 硬件安装与配置】获取;
- 密码:根据【2. 硬件安装与配置】获取;
- 激活码:根据【1.4 试用说明】获取。

3.3 启用插件
在插件管理中,打开「硬件集成 - 温湿度数据同步API版」插件右侧开关,启用插件。

4. 表单搭建
4.1 创建表单
插件使用体验可点击右侧链接:硬件集成-温湿度计插件应用模板,按照示例表单进行讲解。
插件配置需要使用 2 张表单,分别是:
- 温湿度同步记录:自动同步并记录对应设备中的温湿度数据,如温度、相对湿度、露点温度等;
- 温湿度同步触发器:首次使用时,通过该表单触发智能助手,并通过智能助手触发插件。

4.2 设置字段别名
进入「温湿度同步记录」表单中,在「扩展功能 >> 数据推送」处点击「设置字段别名」:
- 设备地址:填写为「device_address」;
- 设备名称:填写为「device_name」;
- 设备状态:填写为「device_status」;
- 时间:填写为「time」;
- 温度:填写为「temperature」;
- 湿度:填写为「humidity」;
- 露点温度:填写为「dew_point」。

4.3 获取appld和entryld
在「开发文档 >> 参数说明」中,将应用切换至「硬件集成 - 温湿度计(API版)」处,选择表单为「温湿度同步记录」表单,查看并复制对应的应用 ID 和表单 ID。

5. 智能助手配置
5.1 添加智能助手
进入表单「温湿度同步触发器」,在「扩展功能 >> 智能助手」处点击「新建智能助手」,设定便于识别和管理的名称,如「定时获取温湿度数据」,并选择触发方式为定时触发:

5.2 设置触发动作
智能助手触发条件设置如下:
- 触发时间类型:选择「根据表单日期字段 >> 温湿度同步触发器」;
- 表单日期时间字段:设置为「下次记录时间 >> 当时」;
- 重复触发:选择「不重复触发」。

5.3 配置计算节点
点击节点连接线上的加号按钮,添加计算节点,重命名为「计算下次触发时间」,并进行如下设置:
- 计算方式:选择「公式计算」。
- 计算规则:点击「设置公式」后输入公式为:DATE(YEAR(SYSTIME()),MONTH(SYSTIME()),DAY(SYSTIME()),HOUR(SYSTIME()),MINUTE(SYSTIME())+5,0)
- 计算结果类型:选择「日期时间」。

注:公式中设置「+5」的作用为每 5 分钟触发一次插件,如需 30 分钟触发一次,可设置为 30,以此类推。最小设置为 1,只能设置整数。
5.4 配置新增数据节点
点击节点连接线上的加号按钮,添加新增数据节点,进行如下设置:
- 目标表单:选择「温湿度同步触发器」。
- 设置字段值:「下次记录时间」字段,设置为节点字段值,选择「计算下次触发时间-计算下次触发时间」。

5.5 配置插件节点
点击节点连接线上的加号按钮,添加插件节点,进行如下设置:
- 应用Id:填写【 4.3 获取到的appId和entryId】中获取到的 appId;
- 表单Id:填写【 4.3 获取到的appId和entryId】中获取到的 entryId;

5.6 效果演示
效果参见本文【1.3 预期效果】。
6. 注意事项
1)「硬件集成 - 温湿度数据同步API版」插件获取到的数据数据精度由温湿度计硬件决定,按照以下规则进行展示:
数据名称 | 单位 | 显示规则 |
温度 | ℃ | 精确到小数点后1位。 |
相对湿度 | % | 精确到小数点后1位。 |
露点温度 | ℃ | 精确到小数点后1位。 由插件根据简易近似计算法得到。 |
2)全部配置完成后,在表单「温湿度同步触发器」中手动新增一条数据后即可持续自动触发。填写「下次记录时间 」字段时需要是未来的时间。
7. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问、意见或建议,欢迎您通过以下方式咨询,我们将提供免费的技术指导和技术落地方案:
- 公司:摇火软件科技(无锡)有限公司
- 联系人:吕金窈
- 联系电话:13338761631
- 插件服务群:二维码如下
您也可以选择在此点击 链接 ,填写您的意见或建议,您的每一个反馈都是我们前进的动力。

400-111-0890
在线咨询