《餐饮用户燃气报警控制系统远程监控装置通讯协议及平台接口标准》.docx

《《餐饮用户燃气报警控制系统远程监控装置通讯协议及平台接口标准》.docx》由会员分享，可在线阅读，更多相关《《餐饮用户燃气报警控制系统远程监控装置通讯协议及平台接口标准》.docx（24页珍藏版）》请在课桌文档上搜索。

1、餐饮用户燃气报警控制系统远程监控装置通讯协议及平台接口标准目次2餐饮用户燃气报警控制系统远程监控装置4通讯协议及平台接口标准41范困42Me范性引用文件43术语和定义431IoT通讯平台43.2 物账网报警器43.3 3NBiSrfr43.4 4G设备S4数据要求54.1 数据类型54.2 数据传蛤约定S5编码规则55.1 帧格式55.2 控制码65.3 设备端码65.4 校验75.5 帧序号85.6 数据区86命令详情86.1 M络参数86.2 上报冏期96.3 报警门限定96.4 主动上传106.5 tcp注册116.6 tcp心跳126.7 状态类型表137数据交换内容137.1 基本数

2、据137.1.1 点位信息137.1.2 设备信里137.1.3 预警信息137.1.4 实时采集记录137.2 信息实体137.3 .1点位信息137.4 .2设备信息147.5 .3预警信兑167.6 .4实时采集记录167.7 2.5数据字典168平台接口格式要求197.8 1接口分类198.2 接口格式198.3 HTTP状态码209平台接口信息219.1 监测点位新增219.2 监测点位编辑219.3 监测点位蒯除219.4 设备新增229.5 设备端t229.6 设备删除229.7 设备实时采集239.8 设备预警采集239.9 便警处置23餐饮用户燃气报警控制系统远程监控装置通讯

3、协议及平台接口标准1葩围本标准规定了燃气温漏报瞥器的相关术语、符号和缩珞语定义：也规定了NB-IoT、5G,4G、3G、2G等终端设备的通信协议和通信加密要求：还规定了终端设备的编码规则及设备的接入要求.本标准适用于独立式燃气泄漏报警潜和可燃气体报警控制器的4（；、W-IoT等智能通信功能实现.以及报警器平台的终端设法系统接入，.本通讯协议支持、B-1.oT、5G、4G等物联网通讯协议。2规葩性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注口期的引用文件，仅该日期对应的版本适用干本文件：不注H期的引用文件.其最新版本（包括所有的蜷改单）适用于本标准.GB.T1

4、7964-20）估息技术安全技术n位块密码算法的操作方式GB/T222392OO8信息安全技术信息系统安全等级保护狼本要求GB15322.1-2019可燃气体探测器第1部分：工业及商业用途点型可燃气体探测器基于窄帚物联网（NB-IoT）技术的燃气智能效衣系统（中国城市燃气协会发布,GB15322.2-2019可燃气体探测器第2部分：家用可燃气体探测器GB16808-2008可燃气体报警控制器3术语和定义下列术语和定义适用于本文件，3.1 IoT通讯平台IOT通讯平台称主站，是采用蜂窝移动通信（含2G、3G、4G、NB-IoT）方式完成对报警器的数据采集、传输、控制.3.2 物联网报警需以传尊潺

5、为基础,加装电子控制电路.具有数据采集、存储等功能,并采用物联网通信技术进行数据传输的报警器.3.3 NB设备NB1.oT终端设备的简林,特指果用NBToT技术,可直接与主站系统互联的终端设备.NB设备指采用BTuT接口通讯的居气泄漏报答器.3.4 4G设备4G终战设茶的筒称，特指采用4G通讯技术，可直接与主站系统互联的终战设备，.4G设备包含独立式燃气泄漏报警器和可燃气体报警控制器，4数据要求4.1 数据类型悔议描述中纯数字均为IO进制，以OdF头均为16进制，选靖数据必须占位，占位符OXO0短整型：2字节小箍对齐,低字节在前整型：1字节，小然对齐，低字节在前浮点数：4字节，IEEE754标

6、准ASCI1.码：高字节在前BCDH：高字节在前4.2 数据传输约定一次完整的通讯过程有以下三种情况触发：第一种情况，达到设定上报周期时间时触发，报警器自动上报数据：第二种情况，发现实时报警时触发，报警器上报报警信息：第三种情况，现场人城长按键5杪触发，报警器临时性上报数据。发送指令30杪后未收到回复指令，判定为通讯超时，需重新发送，重发次数不超过3次,连续3次发送超时，判定为失败.5编码规则5.1帧格式帧格式见表I.表1帧格式说明域名称长度说明帕夫I(HEX)0x68像长度2(HEX)从协议版本号到i据域数据的字节长协仪版本号I(HEX)(1x20:表示2.0版本，此出议版本为2。密的版本号

7、I(HEX)OX1.O:表示1.Ote的版本.我队地址8(BCD)小琳模式,拉制戕地址,独立式报警格为报警热地址.控制码I(HEX)命令码2(HEX)帕序号2(HEX)从OXoooI开始计算.Kinf1.OXFFFF后从OX(XKn*新开始iftk,序号用F多赖兹搦传输校验.其它帧固定壤1.数据域N(HEX)数据域加密时.如我原始数据K改为0.嫄霜川充16字节,长度为C1.XIe1,CRC1.62(HEX)CRC16,从超始符至数据域的结束(需要加密处理的需先进行加密处理,再计尊校的码)络央符1(HEX)0x165.2控制码控制码见表2。表2控制码说明位定义位01备注传箱方向BO下行上行是否加

8、密B1.不加密加密是否结束帔B2未结束结束是否需要应答H3无需应答洸要应答发起标志B1.命令发起端命令应答瑞读写标志B5读命令”命令配置命令有效B6-7保田下行：指主站向终端设备发送数据：上行：指终端设备向主站发送数据：对要求加谢的命令数据，如果按明文发送，应判定该数据无效，对数据域需要加密的命令帧，在发送命令时需先时数据域加密,再计算校验码。报警器接收到命令帧后，需先判断校5金码是否正确.如果校腕不合格,为无效命令顿.如果校验码正确后再解定.解密数据后需要首先根据数据地充规则（数据末端必须至少彳i0x80,如果0x80后面还有数据必须为OXoO）判断数据加密的有效性，通过后再根据协议解析数据

9、格式是否符合要求.5.3设备编码设品编码规则定义见农3。通信数据流与实际设备编码顺序对应，当实际设备编码不足8字节时,在高端补零。表3设备编码规则定义数据内容说明厂宓代码1字节各设备厂商根据“厂家代码妁定”填写设备类里】字初）I一工商业报警器2一交用报警器生产年月（2字节生产序列号（4字节）厂家代码约定说明，*代后分M由对撞人处狡一分配管理厂*代码厂家10H12131.1.5.4校验校验的算法为：从起始符开始,到数据区结束,所有字节的CRCI6校胎.CRCI6:多式采用CCIT:X1.t+X+X/CRCtypeddf1.CRC-TYP三CCIT*d11nesc二TYP1.cXBM/Po1.yn

10、omia1.*1612a51#”Wpo1.yx*iiA1._ccx?/Po1.ynomia1.-X*1.Xa15X219dcfi11cPo1.yxcmia1._iEM/5*3adefineCRC-IEM-SDVdQfinoCRCCCXTTSEED*CRCa1.goritNnuip1.omentaticn*arawIX1.crcPreviousCRCva1.w?par!IN1.ataNewdatatoZaddedtotheCRCPO1.yncm1.A1.CRCpo1.yrmiA1.aa1.ection(CRC-TTPK-CCIT,CRC_TYPKBMcetva1.crcNewccnputedCR

11、C/U16Coeputecrc1.1.JU1/Cor(1；1J1.t(a!)4crc1;ehift1.eft88crc*po1.yoxa1.;XORwithPO1.ynQCn1.oI11crcIJshiftIoCtoncedata*.:/Nextdatabitreturncrc;+1,种子；Ox1.DOF.OX1.O21OXBOo3OxFFFFOx1.DOFCRC16算法如卜.： CRCa1.90r1.thnrp1.cvenatcn* parm(INItjfrrArraycontainingthedate Xparam1.INIHfSrkngthBuffer1.ength From(INICr

12、CTyPeSe1.ecttheCCpo1.yr41.1.CCJC.TTPBOCITT,CC_TTPE_IBM)* Xrecva1.ctrcSufferccvutodCHC/U16RdiopacktcopQt4CrcubufCor.buffet1.enqth.CXCTyxY1.TWOMTA1.-,CCIT7；crcTCRC.IBH,SEID；EJX1.rT一8EBDCk(1;1(crcccputCrcCcrc.tjffor.po1.yncA1.a1.1Iif(crcypcnc_rrpr_ii*人中sturncrc;70r(rtun(U16)(-crc);CRCI6算法示例说明5.5帧序号帧序号从

13、CIXo1.开始,当只有1帧时，帧序号固定为OxO1,当有多帧时，帧序号从0*01开始依次递增.每次会话的上下行帧序号须保持一致.5.6故据区根据规范,数据区数据参见命令定义.6命令详情命令列表说明见表4。表4命令列表说明命令码命令说明在注0x0102网络参数（下行）网络参数设置.0x0103上报周IWCF行）上报周期多数设置.0x0104WffniR(下行)报警门限雷数及I1.0x0301上行0x0001t卬注册（上行）tcp时需要0x02tcp心跳（上行）tcpBt336.1 网络叁数网络参数的要求见表5.表5网络参数名移字节长度说明网址长度1HEX表示,H火值80网址NASCI1.我东端

14、口长r51HEX表示,Aift0,没有为。11NNSCII表示用户名长度1HEX茨示用户名长度（最大不要超过30个）没有为0用户名NASCn衣示.如:-adin*多码（接入点）长度IHEX表示，青码长收妙大不要抬过3。个）.没在为0定码（接入点）NRsCu表示如.”】23456”(C1.WTM)Ar长度1HEX覆示,大值30,没在为0APNN应答的要求见我6.表6应答名称字忖长度说明返回和1DXoo-成功DX（H一影攻锚）x02一存储失败）x03-校准夫欺DX（M一校准0超出IeiBi以05其它错误预田4预招6.2 上报周期上报周期金数设定的要求见表7.表7上报周期名称字节长度说明上报周期咨数

15、长度IHEX表示上报同期11上报周期：1HEX冷位O天，/月+1HEX次数,一时间BCDPJ（f1.t数据起蛤时何）3HEXSm.应答的要求见表6.6.3 报警门限定报警门限设定的要求见表8.表8报警门限名称St据长度说明报警给数长度IHEX我示，必须限制用户权限IHEX表示.JftitiI-OxfeO-我示广摘地址1传感SS类型见我174HEX表示，f1.oat.报警门Rutt-1预尔应答的要求见表6。6.4 主动上传主动上传的要求见去9,表9主动上传要求名称敖姐长度说明设番类型IHEX1一工商业报警2一家川报警等原件版本号210狂字节在IihWiOx1.O,OxOO表示,0.OxFfTF表

16、示无效软件版本号210任字节在被，例:Ox1.O,QxO。表示】.0,OXFFFF发示无效信号强22HEXYIkmRSS1.有符号Jft:例；IIOdBf1.(h(F9Z2G/3G/4G/1.7E:坨信号强度(f1.信噪比2HEXNB.SNR.有符号救。OXFFFF表示无效。信号接收功率2HXNB：埴XSRP,)#卜评表示无效数据条数IHKX我系数第StIi1.探头数榭1N探头数处详情见我10探头数累2NN表10探头数据名稔故M长度ttw类型说明探头地RIIEX从】开始,Et类餐依次递增.东统代报警有效,独立式出警战J*OxFF.当前采集时IBJ7BCD低位在前环位在后,无效金OXFF探头硬件

17、版本号2BCD低字节在前，轲:0x】0,0x表示1.0.无效OXFFFF探头发件版本号2BCD低字节在前,W：0x1.0,0x001.0,无效OXFFn;探头状态1IEXOKMh-正常：Hito一存砧器故状态0正常1.-iW蓝牙故Kt状态0正常1-故Bit2-与切断阀通讯状态0正常I-AtWBit3-切断阀电池状态O-jEI一欠压Bi14-时钟状态0一正常I一故田Bit5探头与控制器连接状态0正常I关联其它一预倒.阀门电池电IE111x例位V,1位小数，无效OXFF传感器数据数质IHEX传感器收据1见表11(怙辑得数据N见表11表11传感器数据性劣：检测类311IEX传然睛类型见表17传感器状

18、志1IEXo*-iE:OXO1.一传感斜故KhOxOZ-IttS1家用OXg-抵黑报警:工商业(Wn-海际报警：工商业OXO5寿命报警IQxOft*H)Xf1.预用，检测位1Htaf1.oat；无效全OXFF报警门限叁数4HEKf1.oat：无效至OXFF构测单位IIEX检跳侑对应单位见表J8传感器温度4IEXf1.oat：无效金OXFFiftrt4IEXfIoa1.I无效全OXFF符用7IEX无效全DxFFO主动上报应答的要求见去12.表12应答帧的要求名称字节长度说明返回科11.三)以1一成功MO1.一龄故错0x02一存储失败OXD3一校法失败OXM一校;fttfi融出而园Iw)S其它Ie

19、iR预愤4ftiiICP注册的要求见表13.表13注册包名称字节长度说明Ktifr类型no】一工Ift业报警器2家用报警JS硬件版本号2BCD低字节在的,例:Ox10,DxdO&示】.0.OXFFFF裳示无效软件版本号2BCD低字节在航，例;OXI0,0x00表示1.0.OxFFFF表示无效CCID20ASCII设备端通讯模凯的CC1.D信,若无此伶息由芹填充ffiIHEXtcp注册应答的要求地表14,表14应答帧的要求名称字节长度说明返回日I(HEX)OxOO一成功OXOI-参牧错(W)2一存储失败0x03一校准失败OXg一校猥班超出莅困005-K它精谀预田4预田6.6tcp心跳Icp心跳的

20、要求见表15.表15心跳包名称字节K度说明信号强僮2I三XNB:堰RSS1.有符号数;例r-I1.OdBn0xFF92,2G/3G/4G/1.TE:川信号强度侑.信唾比2IEXNB:JASNR,仃符号t.OXFm:衣示无效。信号接收功率2WEXNB：填HS腓，。仆HT表示无效预留IHHX预留tcp心跳应答的要求见表16.表16心跳应答帧的要求名称字节长度说明返回玛I(HEX)OXiw一成功DxO1.-JfftffiOXo2一存储失败OXO3一校很失败OKg一校猥班超出莅困005-K它精谟预田4H泡6.7状态类型表表17传感器类型名杉说明传想类型。：甲烷，1:氧气，2:人工作气，3:液化气,4:

21、油IHr,5:内烷，6:己烷,7:环汉乙燎,8:硅烷.9:弧甲烷.10:乙快.U:乙饰.12:丙解，13:不乙编.14:甲醉.15:乙国，16:异丙即，17:不.18:甲末.19:二甲茉.20:丙嗣，21:iW.22:甲利23:乙队21:二甲候，25:行油做，26:乙版乙麻27:乙酸界戊格.28:汽油，29:柴油,30:可燃气体，31:航空烟油，32:四氢味喃.33:内烯祐.M:DMF.35:辄气.36:乳气.37:M气.38:一轨化碳.39:二乳化K.0：一批化氨，41:二氧化虬12:二氧化验.43:硫化氢.M:SU匕氮.45：M化1.46:Bi化S1.47;软化S1.48:配合气,45温度

22、.501压力表18单位含义名称说明浓位1：UE1.2：VO1.3；PPM,4；uno1.n,5；ngm3,6：%RH.7ns.9：km/h.10：1.X.IhPa.12DB.131m3：ro8；7数据交换内容7.1 基本数据7.1.1点位信息映射到地图上到具体的位置，同一个监测点位下可以绑定多个燃气泄漏报警器设备,不同的监测点位以监测点位编码区分.7.1.2设备信息燃气泄漏报警器设备信息.7.1.3预警信息燃气泄漏报警器设备上报的预警信息.7.1.4实时采集记录燃气泄涮报警器设法上报的实时枭集记录.7.2 信息实体7.2.1点位信息字段字段名称字段类型字段说明dc?俎织名卷文本固定分配govc

23、rCodeIfftfJSR文本行市区街道4线地址，俄码参号国*行政区划编码，保尔12位长度gover11e行政名称攵本省市区街道nonitrC1.c点位.编玛文本点位唯一标识11onitrypcKi测类别敷字固定位：oo（用气期同(Itjni1.orSubType点位英里数字数处字典：IO1.nuniIorXaite点位名称文本根据居民和非居情况非居点位输入店招名称例如：建华饭店叫了只炸马（i1.K11A.居尺点位怆入用户联系人,例如：黄永曲address定位地址文本移干SS地图的定位地址detoi!Address详细地址文本n体位置信息,包括街道门牌号等，例如i厦门市湖里区金山西里12730

24、hSa浮点火星坐标系GCJ4）2Iat纬度浮点火星坐标系GCJ-O2IinkVkm联系人文本该监测点位的联系人姓g,Wft1.李冰心iIinkPhone联治电话文本透联系人的手机号（11位手机号），发生告警时公发送短信通MI到读手机号.例b13688011734,gasTye燃气种类数字妆如字典：U8gesSuPP1.igr供气企业数字数据字典：119srType用户种类数字数据字典：120industry所行业数字数据字典i12】property所S1.物业文本具体的物业公司rorr1.y1.xhonc物业电话文本物业公司电话note*注文本7.2.2设备信息字段字段名妆字段类型字段说明do

25、win1.d域ID数字因定分配orgCod姐妲编码文本固定分配OrgNwne期织名林文本囿定分配goverCode行政编码文本省市区街道4媛地址,於码参号国亲行政区划编码，保8112ne行改名林文本省市区街道devCode设备螭耳文本厂家设各上的唯一识别号，东统会以该号进行Ji据采卷对应t果存在多个探头的情况下.设备编9后搔标注-K-2M1.:81108222206-k8108222206-2dcvNac设缶名梆文本我认填写京位名称,如果存在多个探头的情况下，点位名称后假标注-1.2WJ建华饭店T、建华饭店-2devType整备类型数字冏定ft1.h1Q22(过气JttiK报警戡)11nniI

26、OrCOdt*总位输和文本所碱点位唯一标做ndcirrss;定位地址文本堪于GIS地图的定位堆比Factory设备厂*数字数据字典：116nodeI设备皇号数字数据字典：11?ranufacture1.ate出厂日期文本如：2022-11-11Va1.idPeriod有效冏期数字传灯!8有效期年限.比h3年1.ocation安装位贸文本ffiF国用吊顶.瞄阴.储笳室，储植间.浴条，阳台.过道.户外、热水;a旁、厂房内、操作间,车间.H:(IaIrHenanre2)Iat纬度浮点火里坐标系GCJY2)SvitchVa1.ve否有切故字设的是否苗有切厮阀.是I1.否I0断用note占注文本7.2.

27、3预警信息字段字段名称字段类型字段说明Ckgin1.d域ID数字01定分配VamingId预警H）文本预警唯一标识devCoder!ta文本电符信息中的设翁编号VamineType预警类至数字数据字典r1。3vamin1girtr预警时间时何设备产生预警的时阿upIoadTis?上报时何时何系统接收到收警的时何datnCode预警监测切玛文本Jf1.警指标晶码,如：CHhCSH8,OMfdataJaftt?饯警监测名杉文本KI警指标名称,如：甲烷.丙烧.一瓶化碳等dataVa1.ue预警监测值文本Ki警的值dataUnit预警催测地位文本预警指标对应的的位7.2.4实时采集记录字段字段名称字段

28、类型字段说明donin1.dWID数字ISI定分配devCode设各城号文本设备信息中的设备独号devStatus设备状态数字设备采集时的状态,数据字典I112Up1.oadTime上报时间时间系统收到呆集数据的时间up1.oadInfo上报惮情文本设各采蜒的折标数据，J。SN时象致01格式，摊一个时较需包括dataC5商业点位类型101006工业点位类型101007酒店点位类蟹101008孝国其他设缶类型102002生气泄*i报警器预警类X!103008燃气泄然预警类51103023i51tSBW类5!103024燃气超低很浓度刑警类型103025耨气招AiBJ浓度预警类型103026寿命告

29、警预警类型103027一巩化碳泄漏Jft警类型103028传侬丽预警类中103029存储拈故障预警类叁103030切新阀通讯故碎预警类空103031切断阀电池植外预警类51103032报警据故障BW类5!103033IS牙故4用气性质107001居民用气性JeKKo盟拿居设备状态1120()!正常设备状态112002使警设备状态112003故障设品状K1120(M离纹点位状态U3001正常点位枢态113002预瞥点位状态113003故障点位状态113004阳线tt*1160()1厂*Att*1160(以B设备型号117100MOOEi.-1燃气种类118001天然气燃气种类18002液化石油气

30、供气企业119001题门HR燃气有跟公司供气企业119002度门中油IR航油气有Hi公司供气企业119003患门奥顺公油液化气有双公司供气企业U9(M4坦门华达石化工程有架公司供气企业119O(5展门市同安金裕盛液化气有限公司供气企业UgO(Xi厦门市杏泰液化气右阳公司供气企业U9007及门巾同气耨气有限公司用户种类120001-JWSR用户种类120002超高尾居民用户肺类120003商业用户用户种类120001工业用户所Bt行业121001玲通居民所限行业121002机关单位所6行业121003医院所M行业1210(M学校所触行业1210()5标合体断SI行业121006公共福利所K行业1

31、21007文族酒店所限行业121008商务餐饮所限行业121009特种暇务所属行业121010厂矿金业所Bt行业12J011其它处置反馈124001仔收告警处置反馈124O(2i5t备决投处置反馈124003用户测试处置反馈124O(M钢瓶换气处置反愦1240098平台接口格式要求8.1 接口分类本文件接口遵循RESTfU1.AP1.规范，数据接口包括外部档案数据同步、预警数据推送、预警处过三类。8.2 接口格式接口描述茶干如下菸本格式：WebService:=各字段的含义如下表所示.HTTP请求的返回结果包含两部分：一部分为HrrP消息的状态码（StatusCode）,我示响应的状态：另一部

32、分为HTTP请求的消忠体,消总体默认采用JSoN格式进行封装，字段含义HnP请求的方法.本接口中使用到的值有GET.POST.PUT和DE1.EIE,名取值的含义参与HrTP协议.N由Oi务接口的入。地址.可选参数，用以传迤少Ift的布ik信息，HnP请求的消恩头部.可选的附加源信息,用以传龙大祭的餐致信息，所有接口定义格式说明如下：a）接口名：接口的名称:b）说明:对接口内容的描述：c倜用格式:调用web服务时的语法格式:nitorv1.openapipointak1.语义：创建监测点位.附加渔指定该点位所涉及的相关信息.包括但不限于：点位名称、点位编码、点位类型、点位地址、点位联系人等，支

33、持JSoN格式.调用结果：成功状态：返回IrnP状态码为200.失败状态：返回失败对应的HTTP状态码及采用JSON时装的响应结果。响应结果包含失败原因，具体状态码参见目录8.3.9.2 监测点位编辑接口名:pointcdit说明：端辑监测点位档案调用格式：POSTqjantmonitor/v1./openapi/point/edit语义：更新指定点位编码的点位档案信息。附加流为更新后的数据对象，支持JSON格式.调用结果,成功状态：返回HTTP状态码为200.失败状态：返回失败对应的HTTP状态码及采用JSON封装的响应结果。响应结果包含失败原因，具体状态码参见目录8.3.9.3 监测点位删

34、除接口名：point/dc1.说明：删除监测点位,同时会级联删除该点位梆定的所有设得.网用格式：DE1.ETEqj-ant-tnitor/v1./openapi/poinc/(1.c?Jomain1.(1.=(1.nsain1.niIorCode=11nito,Coie)语义r删除指定点位编码的点位档案信息.倜用结果:成功状态：返回IrrTP状态码为200.失败状态：返回失败对应的HTTP状态码及采用JSON时装的响应结果，响应结果包含失败原因，具体状态码参见目录8.3。9.4 设备新增接口名:device/add说明：新增监测设符档案周川格式：POSTqjantmonitor/v1openapidevice/add语义：创建监测设法.附加流STRENI指定该设法所涉及的相关信息，包括但不限于；设备名称、设备编码、设备类型、安装地址等,同时通过STREAM）中指定的点位编码BonitorCodc）将设备绑定到该监测点位上.支持JSO格式.圜用结果:成功状态；返回IrnP状态玛为200失败状态：返网失败对应的HTTP状态码及采用JS（N封装的响应结果，响应结果包含失败原因，具体状态码卷见目录8.3。