T/31SIOT001.2—2017附录A（规范性附录）二进制通信协议A.1传输协议A.1.1消息结构传输协议是建立在TCP/IP上的应用层传输与控制协议。协议的消息结构如图A.1所示，包含三个部分：消息头、消息体长度和消息体。bytevarintvarint消息头消息体长度消息体图A.1消息结构A.1.22消息A.1.2.1消息头结构消息头由1个字节构成，具体含义通过不同bit位的组合表示，其结构如图A.2所示。bit76543210消息类型重复标识服务质量保留字段图A.2消息头结构A.1.2.2消息类型A.1.2.2.1组件到组件的通信协议组件到组件的通信协议包括：a)GET获取协议，包括：1)查询指定时间区间的数据；2）查询快照记录数据。b）TRAP订阅协议，包括：注册TRAP事件；2)通知TRAP事件。c)PUT发送数据协议。向组件发送POINT的数据A.1.2.2.2组件与注册器之间的协议组件与注册器之间的协议包括：a)REG注册协议，包括：1)注册组件；5

T/31SIOT001.2—20172)注册POINT；3)注册组件关联的POINT。b)FIND查询协议，包括：1)查询组件代号；2)查询POINT代号；3)查询与组件关联的POINT；4)查询组件属性。A.1.2.3重复标记当发送方发送消息时，用于标识该消息是否是第一次发送。如果值为0，表示此消息为首次发送；如果值为1，则表示此消息之前已经发送过。重复标识只在服务质量值为1或2时才有作用。就接收方而言，重复标识为1时不能用于判断该消息曾经已经接收过，但如果该值为0则可以断言该消息为首次收到。A.1.2.4服务质量服务质量的取值及含义如表A.1所示。表A.1服务质量的取值QoS值bit2bit1描述0无应答。发送方只发送一次，不保证数据一定被接收方处理101次应答。发送方如果没有收到反馈，继续发送210两次应答。保证接收方有且仅有一次执行311保留A.1.2.5保留字段协议中某些byte或bit字段因暂时不用，留作为保留字段。协议中所有保留字段均设为0，仅用于做消息合法性检验。A.1.2.6数据质量数据质量代表了数据获取时的状态，也就是与设备真实值的关系，本部分中数据质量取值遵从OPCFoundation的标准，只采用OPCFoundation中的低8位，共一个字节。其格式如图A.3所示。bit31QQSSSSLL图A.3数据质量的数据格式其中，QQ代表主质量，SSSS代表子状态，LL代表受限状态，不依赖于主质量和子状态。主质量取值及含义如表A.2所示6

/31SIOT 001.22017

景观标准规范范本表A2主质量取值及含义

当主质量为Good时，子状态取值及含义如表A.

当主质量为Good时，子状态取值及含义如表A.3所示

表A.3子状态取值及含义（Good）

主质量为Uncertain时，子状态取值及含义如表A

表A.4子状态取值及含义（Uncertain）

主质量为Bad时乳制品标准，子状态取值及含义如表A.5所示

子状态取值及含义（Ba

状态取值及含义如表A

T/31SIOT001.2—2017表A.6受限状态取值及含义值含义0Not Limited1Low Limited2High Limited3ConstantA.2功能描述A.2.1组件到组件的通讯协议A.2.1.1GET获取协议A.2.1.1.1查询时间区间的数据查询POINT指定时间区间的数据的消息格式如图A.4和图A.5所示。类型varintvarintvarintuint8重复命令游标POINT代号查询条件个数逻辑关系时间值游标非空时，此几列为空图A.4区间数据查询消息格式：发送空游标表示首次查询；否则，表示再一次查询，此时游标非空，无需后面几列查询条件。类型varintvarintvarintvarintvarint重复命令返回码游标返回记录数POINT类型时间戳数据质量值图A.5区间数据查询消息格式：应答返回结果的游标如果为空，表示查询完毕，否则利用返回的游标进行剩余数据的查询。A.2.1.1.2查询快照记录数据查询POINT快照记录数据的消息格式如图A.6和图A.7所示。类型varintvarint重复命令类型POINT个数POINT代号图A.6快照记录消息格式：发送类型varintvarint重复命令类型总返回码POINT代号返回码时间戳数据质量POINT类型值图A.7快照记录消息格式：应答如果查询成功，总返回码为0表示后面会有数据，每一个记录的查询情况由分项返回码表示；否则，8

T/31SIOT001.2—2017后面没有数据。A.2.1.2TRAP订阅协议A.2.1.2.1注册TRAP事件向组件注册TRAP事件的消息格式如图A.8和图A.9所示。类型varintvarintvarintvarintvarintuint8varint重复命令TrapPOINTPOINT生命Notify事与POINT类类型代号代号条件数逻辑关系类型周期件QoS型对应的值图A.8注册TRAP事件消息格式：发送生命周期：该TRAP事件在发送组件的存在时间，单位是秒，超时后发送组件会删除该TRAP事件。类型varintvarint命令类型返回码图A.9注册TRAP事件消息格式：应答A.2.1.2.2通知TRAP事件向组件通知TRAP事件的消息格式如图A.10所示。类型varintvarintvarintvarint记录命令类型Trap代号POINT代号POINT类型时间截数据质量图A.10通知TRAP事件消息格式A.2.1.3PUT发送数据协议向组件发送POINT的数据的消息格式如图A.11和图A.12所示。类型varintvarint重复命令类型记录个数POINT代号时间戳数据质量POINT类型直图A.11发送POINT数据消息格式：发送类型varintvarint重复命令类型总返回码POINT代号返回码图A.12发送POINT数据消息格式：应答A.2.2组件与注册器之间的协议A.2.2.1REG注册协议A.2.2.1.1注册组件注册组件的消息格式如图A.13和图A.14所示。9

T/31SIOT001.2—2017Bytesvarintvarint重复命令类型组件属性个数属性名值类型属性值图A.13注册组件消息格式：发送属性名和属性值必须成对出现，参见组件属性；值类型指定了属性值的数据类型。Bytesvarintvarint命令类型返回码图A.14注册组件消息格式：应答A.2.2.1.2注册POINT注册POINT的消息格式如图A.15和图A.16所示。Bytesvarintvarint重复命令类型POINT属性个数属性名值类型属性值图A.15注册POINT消息格式：发送属性名和属性值必须成对出现，参见POINT属性。Bytesvarintvarint命令类型返回码图A.166注册POINT消息格式：应答A.2.2.1.3注册组件关联的POINT注册组件关联的POINT的消息格式如图A.17和图A.18所示。Bytesvarintuint8varintvarint命令类型组件关联组件代号POINT代号图A.17注册组件关联POINT消息格式：发送Bytesvarintvarint命令类型返回码图A.18注册组件关联POINT消息格式：应答A.2.2.2FIND查询协议A.2.2.2.1查询组件代号查询组件代号的消息格式如图A.19和图A.20所示。10

T/31SIOT001.2—2017类型varintuint8varint重复命令类型游标查询条件个数组件属性逻辑关系值类型属性值游标非空时，此几列为空图A.19查询组件代号消息格式：发送第一次查询时传入具体的查询条件，后续查询时直接使用上一次返回的游标作为查询条件。类型varintvarintvarintvarint重复的varint命令类型返回码游标返回的组件数组件代号图A.20查询组件代号消息格式：应答游标为空时，表示此次查询已经返回了所有数据；否则，表示后续还有数据，需要再次提交查询请求，并将该游标返回。A.2.2.2.22查询POINT代号查询POINT代号的消息格式如图A.21和图A.22所示。类型varintvarintvarint重复命令类型游标查询条件个数POINT属性逻辑关系值类型属性值游标非空时，此几列为空图A.21查询POINT代号消息格式：发送第一次查询时传入具体的查询条件，后续查询时直接使用上一次返回的游标作为查询条件。类型varintvarintvarintvarint重复的varint命令类型返回码游标POINT数POINT代号图A.22查询POINT代号消息格式：应答游标为空时，表示此次查询已经返回了所有数据；否则，表示后续还有数据，需要再次提交查询请求，并将该游标返回。A.2.2.2.3查询与组件关联的POINT查询与组件关联的POINT信息的消息格式如图A.23和图A.24所示。类型varintuint8varintuint8命令类型游标组件代号组件关联关系游标非空时，此几列为空图A.23查询与组件关联POINT消息格式：发送第一次查询时传入具体的查询条件，后续查询时直接使用上一次返回的游标作为查询条件。11

/31SIOT 001.22017

建筑CAD图纸T/31SIOT001.2—2017