ICS 35.110 L 79 DB34 安 徽 省 地 方 标 准 DB 34/T 2383—2015 农业物联网 信息服务 终端数据交换规范 Agricultural IOT- Information Service -Terminal Data Exchange Specification 文稿版次选择 2015 - 06 - 03 发布 安徽省质量技术监督局 2015 - 07 - 03 实施 发 布 DB34/T 2383—2015 前 言 本标准按照 GB/T 1.1-2009 给出的规则起草。 本标准由安徽省信息技术标准化技术委员会提出并归口。 本标准起草单位：中科院合肥技术创新工程院、安徽朗坤物联网有限公司、安徽斯玛特物联网科技 有限公司、安徽农业大学、安徽省农村综合经济信息中心、安徽省标准化研究院、安徽大学。 本标准主要起草人：吴仲城、李云飞、洪勇勇、王东旭、宋红军、徐建鹏、胡甜甜、汪曼晖、张文 秋、叶显峰。 I DB34/T 2383—2015 农业物联网 信息服务 终端数据交换规范 1 范围 本标准规定了农业物联网用终端的交互模式和数据报文格式。 本标准适用于农业物联网用终端的生产、测试、以及系统集成与应用。 本标准不对承载数据交换的实际通信接口、总线或网络进行规范。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB 3100-1993 国际单位制及其应用 GB/T 17966-2000 微处理器系统的二进制浮点运算 GB/T 30269.701-2014 信息技术 传感器网络 第701部分:传感器接口:信号接口 3 术语和定义 下列术语和定义适用于本文件。 3.1 终端 terminal 在农业物联网中，能够进行数据采集，并具有数据处理、远程通信以及控制管理的功能单元。 3.2 交互对象 interactive object 在农业物联网中，与终端进行通信并实现数据交换的实体，包括终端或其他设备和系统。 3.3 交互模式 interactive model 在农业物联网中，终端与交互对象之间的数据交互方式和状态。 3.4 数据报文格式 data package format 在农业物联网中，终端与交互对象之间进行交换的数据报文内容组织格式。 3.5 1 DB34/T 2383—2015 主站 master station 在农业物联网中，具有选择从站并与从站进行信息交换功能的实体，包括终端或其他设备和系统。 3.6 从站 slave station 在农业物联网中，预期从主站接收信息并与主站进行信息交换的实体，包括终端或其他设备和系统。 4 缩略语 下列缩略语适用于本文件。 CC：命令代码 (Command Code) CRC：循环冗余校验 (Cyclic Redundancy Check) CSMA：载波侦听多点接入(Carrier Sense Multiple Access) DID：数据标识 (Data IDentifier) EC：错误代码 (Error Code) WIFI：无线高保真 (WIreless FIdelity) 5 数据类型定义 Bool8 —— 8 位布尔型 Byte —— 8 位位组 Uint8 —— 8 位无符号整型 Int8 —— 8 位有符号整型 Uint16 —— 16 位无符号整型 Int16 —— 16 位有符号整型 Uint32 —— 32 位无符号整型 Int32 —— 32 位有符号整型 Float32 —— 32 位IEEE 754 浮点型 Double64 —— 64 位IEEE 754 浮点型 字节 —— 八位位组 数组 —— 相同数据类型的元素按一定顺序连续排列的集合 结构体 —— 具有相同或不同类型的数据构成的集合 6 总则 本标准包括交互模式和数据报文格式两个方面内容，其中交互模式规定了终端与交互对象之间的交 互方式，以及在不同交互方式下所对应的交互场景、内容和流程；数据报文格式则针对不同交互模式中 的各种类型交互信息的数据报文内容组织格式进行了详细规范。 7 交互模式 7.1 交互方式 2 DB34/T 2383—2015 7.1.1 交互方式类型 终端应同时支持主动推送和被动应答两种交互方式。 7.1.2 主动推送方式 在主动推送交互方式下，终端自发地向交互对象发送信息，并接收交互对象的确认信息。终端在以 下情况应采取主动推送方式与交互对象进行信息交互： ——终端自身出现异常状况，如供电电压过低； ——设置的事件触发条件已满足，如采集的数据超过报警值； ——定时发送信息。 7.1.3 被动应答方式 在被动应答交互方式下，终端是从站，交互对象相当于主站，终端等待接收交互对象发送信息查询 或配置命令并进行应答。 7.2 交互状态 在交互过程中，终端具有 5 种状态：待注册、等待命令、被动应答、主动推送和推送确认，其中 等待命令状态是常态，其他状态均为暂态。 7.3 交互流程 图1 给出终端交互状态及流程。终端上电后即发送注册包，此时终端进入待注册状态。终端收到注 册确认包后完成注册，终端进入等待命令状态。若终端接收到命令，则转为被动应答状态；完成应答后 返回到等待命令状态。终端在等待命令过程中，若有 7.1.2 小节中所规定的任何触发事件发生，则进 入主动推送状态，完成信息主动推送并得到确认之后返回到等待命令状态。 上电发送注册包 被动应答 待注册 确认超时 重发注册包 完成注册 获取命令 完成应答 等待命令 事件触发 主动推送 确认超时 获得确认 推送确认 完成推送 图1 终端交互流程状态图 8 数据报文格式 8.1 报文组成 3 DB34/T 2383—2015 终端与交互对象之间通信的数据报文组成如表1 所示。 表1 数据报文组成格式 前导符 目的地址 源地址 命令字 数据区长度 数据 检验码 关于表1 中各个字段的解释如表2 所示。 表2 报文格式说明 字段项 字节数 描述 前导符 1 目的地址 NAD 源地址 NAS 应与‘目的地址’结构一致。 命令字 1 命令字格式应符合 8.3 数据区长度 1 数据区的长度。 数据 ND 数据最大长度为 248 个字节，相关内容应符合 8.4 检验码 NC 用来指明地址长度和检验方式，具体格式应符合 8.2 小节规定。 长度 NAD 由前导符决定，高位字节在前，低位字节在后，所有字节为 0x00 为通 配地址，所有字节为 0xFF 为广播地址。 小节内容的规定。 章节的规定。 除去本字段之外所有数据的校验码，高位字节在前，低位字节在后。校验方法 和校验码长度由前导符决定，校验算法的实现应符合附录C 的规定。 8.2 前导符格式 数据报文中前导符的组成格式如表3 所示。 表3 前导符组成格式 B7 B6 B5 保留 B4 B3 校验指示码 表3 中各个组成部分的说明如下： ——B7～B5 保留，须填充 0； ——B4～B3 为校验指示码，取值如下：  00：CRC16，算法由附录 C 规定；  01：CRC32，算法由附录 C 规定；  10：保留；  11：自定义。 ——B2～B0 为地址长度码，取值与地址长度计算如下：  000：地址长度为 0； 1 4  001～100：地址长度为 2 ～2 ，即 2～16 个字节；  101～111：保留。 8.3 命令字格式 数据报文中命令字的格式如表4 所示。 4 B2 B1 地址长度码 B0 DB34/T 2383—2015 表4 命令字格式 B7 B6 B5 传送方向 后续帧标志 B4 B3 B2 保留 B1 B0 控制码 表4 中各个组成部分的说明如下： ——B7（传送方向）：0- 交互对象发送、终端接收，1- 终端发送、交互对象接收； ——B6（后续帧标志）：0- 无后续数据帧，1- 有后续数据帧； ——B5～B4 保留，须填充 0； ——B3～B0 为控制码，其编码格式表 5 所示。 表5 控制码编码表 控制码 描述 0000 终端注册 0001 读取数据 0010 读取后续数据 0011 读取通道传感数据 0100 读取后续通道传感数据 0101～0111 保留 1000 定时推送通道传感数据 1001 配置数据 1010 配置后续数据 1011～1100 保留 1101 数据超限报警 1110 异常信息推送 1111 被动应答出错 8.4 数据报文详解 8.4.1 终端注册 终端上电后应主动发送注册数据包，并接收发自于具有网络管理功能的交互对象的注册确认数据 包。 终端发送注册数据报文格式如表6 所示。 表6 终端注册数据报文格式 PQ A’1 … A’p A1 … Ap 0x80 0x00 C1 … Cq 表6 中各个组成部分的说明如下： ——PQ 为前导符； ——A’1…A’p 为广播地址 0xFF…0xFF； ——A1…Ap 为终端地址； ——C1…Cq 为校验码。 5 DB34/T 2383—2015 终端接收注册确认数据报文格式如表7 所示。 表7 终端接收注册确认数据报文格式 PQ A1 … Ap A’1 … A’p 0x00 0x00 C1 … Cq 表7 中各个组成部分的说明如下： ——PQ 为前导符； ——A1…Ap 为终端地址； ——A’1…A’p 为具有网络管理功能的交互对象地址； ——C1…Cq 为校验码。 8.4.2 读取数据 此命令根据数据标识（DID）来读取数据，既可用于读取传感数据，也可用于获取终端的设备参数 和业务参数等信息。 交互对象发送读取数据命令的数据报文格式如表8 所示。 表8 读取数据命令报文格式 PQ A1 … Ap A’1 … DID1 … DIDm C1 … Cq A’p 0x01 m 表8 中各个组成部分的说明如下： ——PQ 为前导符； ——A1…Ap 为终端地址； ——A’1…A’p 为交互对象地址； ——数据区长度为 m，其值为读取数据的 DID 数目； ——DID1～DIDm 为数据标识，取值应符合附录 A 规定； ——C1…Cq 为校验码。 终端响应读取数据命令的数据报文格式如表9 所示。 表9 终端响应读取数据命令报文格式 PQ A’1 … A’p A1