2026/10/4 11:48:20

ThingsBoard Smart Irrigation 方案 Edge 计算扩展指南:从云端到田间地头的边缘部署实战

ThingsBoard Smart Irrigation 方案 Edge 计算扩展指南:从云端到田间地头的边缘部署实战 物联网后端数据可视化消息队列【免费下载链接】thingsboardAll-in-one IoT Platform - Device management, data collection, processing and visualization.项目地址https://gitcode.com/GitHub_Trending/th/thingsboard点击查看免费下载导读本篇技术指南聚焦 ThingsBoard Smart Irrigation智能灌溉解决方案中的Edge Computing边缘计算扩展能力。当农场分散在各地甚至全球时仅靠中心云服务器处理土壤湿度数据会面临网络延迟与断连风险。本文将以仓库中 Smart Irrigation 方案自带文档为骨架结合该方案预置的 Edge 实体、实体组与遥测模拟命令讲解如何在每个农场部署 ThingsBoard Edge、如何将设备自动下发到边缘、以及如何在无网环境下由边缘就地决策并在网络恢复后向云端同步的完整闭环。读完本文你将掌握Smart Irrigation 边缘实体的预配置内容、Edge 安装与连接云端的操作入口、向边缘设备推送遥测的具体命令与验证方法以及从源码与方案 JSON 中理解边缘同步机制和灌溉告警逻辑的原理依据。一、为什么智能灌溉需要边缘计算仓库文档 edge_instructions.md 明确指出Edge 扩展是 Smart Irrigation 方案的**可选Optionally**增强能力。其核心动机非常贴合农业场景如果农场分布在同一个国家甚至全球的不同地理位置每个农场都可以独立部署一台 ThingsBoard Edge。ThingsBoard Edge 的价值在于数据就地处理在数据产生的地方田间完成分析与管理从土壤湿度传感器实时采集数据并进行实时分析与决策断网自治当农场与中心 ThingsBoard 服务器之间的网络连接中断时Edge 继续处理数据——数据不会丢失必要的决策例如湿度阈值被违反时开启灌溉在本地即时做出云边协同一旦网络连接恢复所需数据会被推送到云端实现无缝同步集中配置边缘计算的全部业务逻辑配置集中在唯一位置——ThingsBoard 服务器端运维人员无需逐台登录 Edge 修改逻辑。二、Smart Irrigation 方案预置的边缘实体与资源分配为了降低边缘部署的门槛Smart Irrigation 方案在创建时已经预置了一个名为Remote Farm R1的 Edge 实体并把以下实体和实体组直接分配assign到了该 Edge使边缘部署开箱即用分配类型名称说明AssetSI Field 1农田资产承载湿度阈值、灌溉状态等计算逻辑DeviceSI Water Meter 1水表设备用于统计灌溉用水量DeviceSI Smart Valve 1智能阀门设备控制灌溉通断DeviceSI Soil Moisture 1土壤湿度传感器 1 号DeviceSI Soil Moisture 2土壤湿度传感器 2 号DASHBOARD 组Smart Irrigation方案配套仪表盘随 Edge 下发到本地其中SI *** 前缀表示 Smart Irrigation 方案专属命名空间。这些预分配动作在方案 JSON 中被固化例如在 alarm_rules/si_soil_moisture_sensor_low_moisture_level.json 中可以看到告警通过propagateRelationTypes: [FieldToMoistureSensor]沿农田→湿度传感器关系链传播这正是边缘本地决策所依赖的关系型数据模型而 calculated_fields/si_field_propagate_thresholds.json 则通过FieldToMoistureSensor关系将minMoistureThreshold/maxMoistureThreshold从农田资产传播到各湿度传感器保证 Edge 上的传感器持有与云端一致的判断阈值。三、安装 ThingsBoard Edge 并连接云端Edge 的安装与连接入口集中在云端 UI 中登录 ThingsBoard 服务器进入 Edge 详情页即预置实体 Remote Farm R1 的详情页点击Install Connect instructions按钮获取针对当前环境的安装脚本与连接参数按指引在农场本地的服务器/网关/边缘设备上完成 ThingsBoard Edge 安装并使其与云端建立安全连接。安装并成功连接云端后即可使用租户tenant凭据登录 Edge UI。需要说明的是Remote Farm R1 是一个独立 Edge 实体虽然由方案预置但其具体的安装脚本、下载地址与凭据由云端在运行时动态生成即文档中的${Remote Farm R1EDGE_DETAILS_URL}占位符安装完成后 Edge 会自动从云端拉取已分配的资源。从实现层面看云端与 Edge 之间的数据同步基于 gRPC 会话与事件队列机制。在仓库源码 application/src/main/java/org/thingsboard/server/service/edge/rpc/session/EdgeGrpcSession.java 中可以找到 Edge 会话的建立与消息交换实现而 application/src/main/java/org/thingsboard/server/service/edge/rpc/fetch/QueuesEdgeEventFetcher.java 表明云端通过专门的队列事件抓取器把设备遥测、属性更新、告警等事件按序推送给 Edge。这解释了配置集中、同步自动的底层支撑。四、设备自动下发在 Edge 上看到 SI 系列设备由于SI Field 1、 SI Water Meter 1、 SI Smart Valve 1、 SI Soil Moisture 1、 SI Soil Moisture 2这些设备/资产已经被分配给了 Edge 实体 Remote Farm R1因此它们会在 Edge 上自动完成 provisioning自动配置下发无需在 Edge 端手工创建设备。验证方式登录 Edge UI 后进入Entities - Devices页面即可看到上述 SI 系列设备。注意本方案中设备被逐一分配而非按设备组分批分配因此只要云端到 Edge 的首次同步完成这些设备就会立即出现在 Edge 的设备列表中。五、向 Edge 上的设备推送遥测模拟土壤湿度上报为验证边缘数据链路文档给出了以设备SI Soil Moisture 1身份向 Edge 上报遥测的完整命令curl -v -X POST -d {\moisture\: 77} http://localhost:8080/api/v1/${SI Soil Moisture 1ACCESS_TOKEN}/telemetry --header Content-Type:application/json如果在 Edge 安装过程中将 HTTP 绑定端口从默认的8080修改为18080则使用curl -v -X POST -d {\moisture\: 77} http://localhost:18080/api/v1/${SI Soil Moisture 1ACCESS_TOKEN}/telemetry --header Content-Type:application/json5.1 命令参数拆解-vverbose 模式输出完整的 HTTP 请求与响应过程便于排查连接问题-X POST使用 HTTP POST 方法向 Edge 的 HTTP 传输服务提交数据-d {\moisture\: 77}JSON 格式的遥测载荷本次模拟上报土壤湿度值为77该值高于高湿度阈值时不会触发低湿度告警属于正常状态的模拟数据/api/v1/${ACCESS_TOKEN}/telemetryThingsBoard 标准的设备遥测上传路径${SI Soil Moisture 1ACCESS_TOKEN}是设备 SI Soil Moisture 1 的访问令牌在实际执行前需将其替换为该设备在 Edge 上的真实 Access Token可在 Edge 的设备详情页查看--header Content-Type:application/json声明请求体为 JSON 格式。5.2 数据验证边云数据同步命令执行成功后遥测数据首先写入 Edge 本地。此时可以在Edge 设备详情页的 Latest Telemetry最新遥测中看到moisture: 77。随后 Edge 会将该遥测通过云边同步通道推送到云端因此在 ThingsBoard 云端的该设备页面同样能看到这条遥测更新——这就是断网期间本地保存、联网后补传工作机制的直接体现。六、边缘决策背后的业务逻辑源码佐证遥测数据上报到 Edge 后并不是简单地入库而是会触发 Smart Irrigation 方案预置的本地业务逻辑。从方案 JSON 可以还原这条决策链路阈值传播si_field_propagate_thresholds.json 中的 PROPAGATION 型计算字段把农田资产的minMoistureThreshold、maxMoistureThreshold服务器属性沿FieldToMoistureSensor关系下发到每个湿度传感器湿度判断si_soil_moisture_sensor_low_moisture_level.json 中的 ALARM 告警规则比较最新湿度moistureTS_LATEST与阈值minMoistureThresholdSERVER_SCOPE属性当moisture minMoistureThreshold时在 Edge 本地创建 CRITICAL 级Low Moisture Level告警当moisture minMoistureThreshold时清除告警告警沿FieldToMoistureSensor关系传播灌溉状态机si_field_update_irrigation_state.json 中的 SCRIPT 计算字段依据durationThreshold时间阈值与consumptionThreshold用水量阈值决定何时将irrigationState置为DONE用水统计si_field_calculate_irrigation_water_consumption.json 仅在灌溉状态为ON时累加水表读数生成currentIrrigationWaterConsumption。这四条链路的执行逻辑完全由云端集中配置、随实体分配自动下发到 Edge因此在断网时 Edge 可以独立完成判断低湿度→触发告警→控制阀门→统计用水的完整决策闭环这正是文档所述在本地做出必要决策的工程实现。七、操作要点与常见注意事项端口差异Edge 默认 HTTP 端口为 8080若安装时改绑为 18080所有 curl 命令中的端口必须同步修改否则请求会被拒绝令牌替换命令中的${SI Soil Moisture 1ACCESS_TOKEN}是占位符必须在 Edge 设备详情页复制真实 Access Token 后替换切勿原样执行登录凭据Edge 安装并连接云端后使用租户凭据即可登录 Edge 管理界面如果方案将 Edge 分配给客户则客户用户凭据同样有效详见其他方案文档的同类描述同步时延Edge 与云端之间的数据同步遵循队列事件机制遥测从 Edge 到达云端存在少量延迟这是正常现象无需担心数据丢失业务逻辑修改所有阈值、告警规则、计算字段均在云端修改并保存Edge 会自动同步最新配置不要直接在 Edge UI 中修改业务逻辑以免下次同步被云端覆盖。八、总结Smart Irrigation 的边缘计算扩展本质上是把数据产生地处理与云端集中管控两种诉求统一在一个云边协同架构中预置的 Remote Farm R1 Edge 实体 已分配的 SI 系列设备/仪表盘让每个农场可以快速获得离线自治的灌溉决策能力通过/api/v1/{token}/telemetry的遥测模拟命令开发者可以立即验证边缘数据链路与云边同步效果。结合仓库中 alarm_rules 与 calculated_fields 的 JSON 配置可以清晰地看到阈值传播→湿度告警→灌溉状态机→用水统计这条完整业务链如何在边缘本地闭环执行并在网络恢复后与云端无缝同步。赞分享物联网后端数据可视化消息队列【免费下载链接】thingsboardAll-in-one IoT Platform - Device management, data collection, processing and visualization.项目地址https://gitcode.com/GitHub_Trending/th/thingsboard点击查看免费下载相关推荐ThingsBoard 空气质量指数AQI解决方案的 Edge 计算扩展部署边缘节点与数据上云实战指南ThingsBoard 空气质量指数AQI解决方案的 Edge 计算扩展部署边缘节点与数据上云实战指南 导读 本文围绕 ThingsBoard 开源仓库中物联网后端数据可视化消息队列ThingsBoard Smart Office 解决方案边缘计算扩展部署 Edge 实例、自动配置设备组与遥测数据上传实战ThingsBoard Smart Office 解决方案边缘计算扩展部署 Edge 实例、自动配置设备组与遥测数据上传实战 导读 本文基于 ThingsBo物联网后端数据可视化消息队列ThingsBoard 水表计量解决方案边缘计算扩展实战指南远程设施本地处理与边缘-云数据同步ThingsBoard 水表计量解决方案边缘计算扩展实战指南远程设施本地处理与边缘 云数据同步 这篇技术指南以 ThingsBoard 官方 Water Me物联网后端数据可视化消息队列创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考