获取环境温湿度数据插件
1. 简介
1.1 插件简介
获取环境温湿度数据插件能够定时抓取、记录多个温湿度计的温湿度信息,支持在简道云中自动同步温湿度数据,帮助用户实现环境温湿度的远程监控与管理。
1.2 使用场景
适用于多种需要监控环境温湿度的场景中,如:
- 农业种植企业:以大棚种植户、规模化农场为主,需求集中在低成本数据采集、远程监控功能,通过温湿度数据优化灌溉、通风策略,提升作物产量。
- 电子制造工厂:需对生产车间、仓库的温湿度进行精准控制,避免电子元件受潮、高温损坏。需求集中在高精度测量、与 MES 系统集成,通过数据联动实现车间环境自动化调节,提升生产良率。
- 中小型办公场景:如办公楼宇、实验室、小型仓库等,需求是轻量化数据采集与管理,通过简道云表单实现数据记录、统计分析,无需复杂部署,注重性价比和易操作性。
1.3 预期效果
以每分钟记录一次 4 个不同的温湿度计的数据为例,效果如下所示:
1.4 使用说明
获取环境温湿度数据插件采用年费订阅模式,每年收费 99 个云币。一旦用户成功订阅,在订阅有效期内可无限次调用该插件,无需每次调用时单独支付费用。订阅到期后,若用户希望继续使用获取环境温湿度数据插件的功能,则需续订下一年的服务。若未续订,插件功能将无法使用。
2. MQTT服务器配置
1)MQTT 服务器是一种基于消息传递协议的服务器,其主要功能是为物联网设备提供消息的发布和订阅服务。MQTT(Message Queuing Telemetry Transport)是一种轻量级的通信协议,被广泛应用于物联网领域。
2)因当前各类 MQTT 服务器细节配置方法不一,您可以通过【6. 联系方式】联系我们,我们将为您免费远程提供指导或配置开源 MQTT 服务器软件(需用户自备 Linux 服务器及公网 IP),以便您能够便捷获取 MQTT 服务API。
3. 插件安装及配置
3.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:获取环境温湿度数据插件。
- 安装成功后,可参考本文【3.2 配置插件】和【3.3 启用插件】,前往「开放平台 >> 插件管理」处启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「获取环境温湿度数据」插件。插件市场处安装方法可参见文档:插件市场中【2.3插件安装】。
3.2 配置插件
3.2.1 获取apikey
在「密钥管理 >> API Key」处,创建并获取 API Key。
3.2.2 获取appld和entryld
在「开发文档 >> 参数说明」中,将应用切换至「硬件集成-温湿度计」处,选择表单为「温湿度数据记录」表单,查看并复制对应的应用 ID 和表单 ID。
3.2.3 配置插件
安装后,在插件管理处,点击插件右侧的设置按钮,进行插件配置:
- MQTT 服务器 API:将【2. MQTT服务器配置】中获取到的「MQTT服务器API」配置进去;
- apiKey:将【3.2.1 获取 apikey】中获取的简道云「Apikey」 配置进去;
- appId:将【3.2.2 获取 appld 和 entryld】中获取到的「应用 ID」配置进去;
- entryId:将【3.2.2 获取 appld 和 entryld】中获取到的「定时获取温湿度数据」的表单 ID 配置进去。
3.3 启用插件
在插件管理中,打开获取环境温湿度数据插件右侧开关,启用插件。
4. 表单搭建
4.1 创建表单
插件使用体验可点击右侧链接:硬件集成-温湿度计插件应用模板,按照示例表单进行讲解。
插件配置需要使用 2 张表单,分别是:
- 温湿度数据记录:自动同步并记录对应设备中的温湿度数据,如温度、相对湿度、露点温度等;
- 温湿度数据同步触发器:首次使用时,通过该表单触发智能助手,并通过智能助手触发插件。
4.2 设置字段别名
进入「温湿度数据记录」表单中,在「扩展功能 >> 数据推送」处点击「设置字段别名」:
- 设备名称:填写为「name」;
- 温度:填写为「temperature」;
- 相对湿度:填写为「humidity」;
- 露点温度:填写为「dewpoint」;
- 记录时间:填写为「time」。
5. 智能助手配置
5.1 添加智能助手
进入表单「温湿度数据同步触发器」,在「扩展功能 >> 智能助手」处点击「新建智能助手」,设定便于识别和管理的名称,如「定时获取温湿度数据」,并选择触发方式为定时触发:
5.2 设置触发动作
智能助手触发条件设置如下:
- 触发时间类型:选择「根据表单日期字段 >> 温湿度数据同步触发器」;
- 表单日期时间字段:设置为「下次记录时间 >> 当时」;
- 重复触发:选择「不重复触发」。
5.3 配置插件节点
点击节点连接线上的加号按钮,添加插件节点,进行如下设置:
- 执行插件:「选择获取环境温湿度数据」插件;
- 设备名称:设置为自定义,并填写为「name」;
- 温度:设置为自定义,并填写为「temperature」;
- 相对湿度:设置为自定义,并填写为「humidity」;
- 露点温度:设置为自定义,并填写为「dewpoint」;
- 记录时间:设置为自定义,并填写为「time」。
5.4 配置计算节点
点击节点连接线上的加号按钮,添加计算节点,进行如下设置:
- 计算方式:选择「公式计算」。
- 计算规则:点击「设置公式」后输入公式DATE(YEAR(SYSTIME()),MONTH(SYSTIME()),DAY(SYSTIME()),HOUR(SYSTIME()),MINUTE(SYSTIME())+30,0)
- 计算结果类型:选择「日期时间类型」。
注:公式中设置「+30」的作用为每 30 分钟触发一次插件,如需 60 分钟触发一次,可设置为 60,以此类推。最小设置为 1,建议只设置整数。
5.5 配置新增数据节点
点击节点连接线上的加号按钮,添加新增数据节点,进行如下设置:
- 目标表单:选择「温湿度数据同步触发器」。
- 设置字段值:「下次记录时间」字段,设置为节点字段值,选择「计算下次触发时间-计算下次触发时间」。
5.6 效果演示
效果参见本文【1.3 预期效果】。
6. 注意事项
1)获取环境温湿度数据插件获取到的数据数据精度由温湿度计硬件决定,按照以下规则进行展示:
数据名称 | 单位 | 显示规则 |
温度 | ℃ | 精确到小数点后1位。 |
相对湿度 | % | 精确到小数点后1位。 |
露点温度 | ℃ | 精确到小数点后1位。 由插件根据简易近似计算法得到。 |
2)全部配置完成后,在表单「温湿度数据同步触发器」中手动新增一条数据后即可持续自动触发。填写「下次记录时间 」字段时需要是未来的时间。
7. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问、意见或建议,欢迎您通过以下方式咨询,我们将提供免费的技术指导和技术落地方案:
- 公司:摇火软件科技(无锡)有限公司
- 联系人:吕金窈
- 联系电话:13376219931
您也可以选择在此点击 反馈链接 填写您的意见或建议,您的每一个反馈都是我们前进的动力。