把一个温湿度传感器接进平台,订阅一个Topic、解析一段JSON就够了。可当接进来的是一台会开泵、会注肥的水肥一体机,问题就变了:指令发出去没回音,要不要重发?重发了会不会注两遍肥?设备“成功”,是真的开始施肥了吗?这篇文章复盘大晓智能在无人农技服务平台上接入各类物联网设备的做法,重点讲水肥机这类“会动手”的设备。

大晓智能的无人农技服务平台接入传感器、集中器、智能插座和水肥一体机,汇集田间环境数据与设备作业记录。这些数据为人工智能辅助分析长势、灌溉和施肥需求提供现场依据。设备有三种接入方式。
• 第三方IoT平台:厂家已经有自己的云平台,我们按HTTP接口定时拉取实时数据、告警和历史数据。
• 自建MQTTBroker:设备直接连我们的Broker推送数据,比如智能插座、4G集中器,以及本文的主角水肥一体机。
• 厂家自有Broker:厂家不让设备直连第三方,只开放自己Broker上的一个Topic,平台作为客户端去订阅。

图1·三条接入链路:MQTT设备共用一套画像与分发
前两年接的大多是传感器:上报数值,入库,超过阈值就告警,指令最多是开关一下插座。水肥机不一样,它有完整的作业生命周期:平台下发配方、启动施肥、跟踪进度、回收作业结果。指令一旦重复执行,泵和电磁阀就会反复动作,母液可能多注一遍。
接入层先识别设备,再分发上行消息、维护在线状态,随后处理报警和下行指令。水肥机的作业结果最终回到平台,与启动任务关联。
每家设备都有自己的脾气:Topic怎么拼、设备编码放在哪、字段叫什么、报警怎么表示、指令长什么样。如果这些差异散落在代码的if-else里,接第五家设备时就没人敢改了。
大晓智能在无人农技服务平台中为每种设备定义一份设备画像,集中描述接入所需的字段和规则。画像包含以下内容。

画像里的Topic模板,一方面要变成MQTT订阅过滤表达式(把{deviceCode}换成+),另一方面收到消息时要反过来提取变量。我们把模板编译成带命名捕获组的正则,并缓存起来:

字面部分一律Pattern.quote,Topic里出现.、+之类的字符也不会被当成正则。
实际接下来,设备编码的位置有三种情况:
• Topic里带编码:最常见,直接从捕获组取。
• 厂家共用一个Topic:厂家自有Broker只开放一个Topic,所有设备都往里发,这时按画像里的"设备标识字段"从报文取,必要时加前缀,避免和其他厂家的编码撞车。
• 一条报文带多台设备:4G集中器一次上报下挂的所有从机,平台拆开后组合成{集中器编码}_s{从机地址},每台从机按独立设备处理。
找不到的设备按画像自动注册。这里踩过一个并发的坑:有的传感器一次上传多条报文,入站通道又是多线程的,几个线程同时判定“设备不存在”,结果同一台设备注册了好几遍,因子也建重了。我们按设备编码分64段加锁。同一台设备的报文串行处理,不同设备之间基本互不阻塞,内存占用也是固定的。
• 按需注册因子:有的传感器型号很多,一台只报其中几个字段。打开按需注册后,字段第一次出现时才建因子,列表里不会堆满永远为空的因子。
• 画像级离线阈值:全局离线阈值是5分钟,可电池供电的传感器一小时才报一次。画像可以单独把阈值放宽到180分钟,但只能比全局更宽松。
现在每种内置设备是一个画像类,启动时幂等写入数据库。新增一种设备,就是新增一个类,接入主流程不用改。
传感器主要上报遥测数据。水肥机还需要上报告警、作业结果和指令回执,各类业务消息分别使用对应的Topic。

订阅配置里增加一个messageKind,声明这条Topic承载什么语义,分发器据此调用不同的处理器。没声明的一律按遥测处理,所以已经在跑的插座、集中器配置一行都不用改。
后来协议增加了平台校时。设备上线后请求当前时间,平台必须在5秒内应答。校时请求不需要查设备、不需要入库,我们把它放在主流程最前面:Topic匹配上就直接回时间,连设备锁都不进,避免被前面排队的报文拖慢。
设备连接Broker时会登记一条遗嘱消息,掉线时由Broker代发。平台收到遗嘱就立即把设备置为离线,比等心跳超时快得多。
遗嘱也可能丢,设备也可能连着却不报数据,所以平台每60秒再扫描一次:超过离线阈值没有上报的设备,同样置为离线。阈值默认5分钟,画像可以按设备的上报频率放宽。
水肥机不会逐条上报“某某报警发生了”,它只维护一个32位的报警字,每一位代表一种报警,置1表示正在报警。把它展开成一条条有开始、有结束的告警事件,是平台的责任。

图2·报警字按位差分
做法是按位异或:缓存上一次的报警字,新报文来了,上一次^这一次就是变化的位,0→1记一条报警,1→0把对应的报警置为已恢复。

差分处理还需要覆盖首次接入、写库失败和报警表变更。
• 首次收到报警字时补发。缓存为空时,设备可能已经在报警,因此第一帧把所有已定义的置位位都当作新报警。
• 先落库,再推进缓存。只要有一位写库失败,缓存就停在旧值,下一帧会重新算出同样的变化。宁可重复,不能丢;重复的那条由"同设备同一位已有未恢复记录"拦下。
• 位的含义不写死。位到含义的映射放在画像里,厂家改报警表,只需要改画像;没有映射的位落成“未知报警bitn”,不丢弃。
无人农技平台将报警按协议分为紧急、故障、预警三级。紧急和故障同时发邮件、短信和语音电话,预警只发邮件。告警只通知设备所属租户的联系人,还没分配给客户的设备只落库,不对外通知。
这是水肥机接入里最花时间的部分。MQTT只保证消息到了Broker,至于设备收没收到、执行没执行,要靠我们自己闭环。

图3·一条指令的生命周期
平台每发一条指令都生成一个seq,写进报文并落库:
M-{设备ID补齐8位}-{yyMMddHHmmss}-{4位随机}
seq有三个用途:设备按它去重,同一个seq只执行一次;回执带着它回来,平台据此找到原指令;启动施肥的那条指令,seq同时就是这次施肥任务的Id。
指令的状态有四个:已发送、成功、失败、超时。需要回执的指令,发布成功后停在“已发送”,等设备回执才判成败。平台每10秒扫描一次,超过15秒没收到回执的指令按原seq重发,重发3次仍无回音就置为超时。回执可能因为重发而到达多次,所以判定是终态幂等的:已经判过成败的指令,再来回执只记日志,不覆盖。
重发绝不能换seq。换了新seq,设备会把它当成一条新指令再执行一遍,泵会再启动一次,施肥任务的Id也会漂移。
可原样重发也不行。设备会拒收时间戳滞后超过60秒、或者早于本次连接建立时间的指令。设备断线重连之后,平台原样重发的旧报文全部被拒,看上去就像设备一直不回话。所以重发时seq和参数不动,只把timestamp换成当前时间:

联调时还碰到过新指令也被判过期的情况,原因是现场设备的时钟比平台慢。我们先把下发的时间戳临时回拨10秒救急。随后的协议版本加上了平台校时:设备上线时向平台要当前时间,用来校准自己的时钟,对应前文的校时快速应答路径。回拨做成了配置项,等设备都完成校时后可以去掉。
回执里的success只表示设备受理了请求。按联调说明逐字段核对后,我们修正了两种判断:
• success=true但started=false:配方已经保存,任务却没有启动。原来记成了成功,现在改为失败,并保留设备给出的原因。
• processing=true:结果还没定。这时不判成败,保持“已发送”,交给超时扫描按原seq重发,再问一次结果。
提前结束施肥的指令,协议要求带上当前任务的编号。直觉上用平台下发启动指令时的seq就行,但任务也可能是现场工人在设备触摸屏上启动的,平台根本不知道它的编号。
所以我们以设备遥测为准:遥测里带着运行阶段和当前任务号,平台缓存每台设备的最新状态,有效期5分钟。下发提前结束时,先确认设备确实处在预冲、施肥或清洗阶段,再取遥测里的任务号;设备空闲、状态过期或任务号不合法,就直接拒绝,不下发。
施肥结束后,设备会主动推送作业结果,但这条消息可能丢。平台也可以下发查询指令补查,查询回执里自带结果列表。两条路的结果按“设备+任务Id”合并入库,主动推送缺失时,可以通过查询回执补齐已返回的结果。
在大晓智能无人农技服务平台里,一次设备作业贯穿设备识别、消息分发、指令执行和结果回收。画像描述设备差异,遥测维护当前状态,报警字生成告警记录,seq把下发指令、执行回执和施肥任务关联起来。
这些记录让平台能够追踪一次作业从启动到结束的过程。现场断网、回执延迟或任务由触摸屏启动时,平台也有对应的重发、补查和状态校验路径。
对大晓智能而言,物联网设备接入也是人工智能参与农技服务的数据基础。田间读数、异常告警和作业结果形成连续记录,有助于人工智能结合实际执行情况辅助农艺师分析,并持续完善无人农技服务。
