• [技术干货] 智慧园区统一服务之——什么是统一设备服务
    在IoT业务中,有许多需要业务应用和物联网设备产生交互的场景,包括获取设备信息、设获取设备数据、操控设备行为等。这些场景中涉及的物联网设备品牌纷杂,种类繁多,协议多样,给业务应用的开发带来了诸多不便。为了能让业务开发人员更方便高效地实现与物联网设备交互的功能,我们对物联网设备进行业务抽象,提供统一设备服务。统一设备服务提供了对物联网设备的建模、管理、交互等能力。定义了物联网设备的模型和服务上的规范。不同的业务应用,所看到的设备的模型和服务都是相同结构的,这样有助于业务应用之间的信息交互。提供了对不同物联网设备的统一抽象机制。对于同一类型的物联网设备,即使是来自不同厂家的产品,也可以抽象成相同的设备规格。因此业务应用使用设备能力时,无需针对不同设备产品做分别的适配。提供了标准的IoT网关集成接口。与不同的网关集成时,只需要准备相应的适配器,而上层业务应用可以保持不变。统一设备服务的组成框图如下:图1 统一设备服务提供全网共用的设备库,对各个开发者提供常用的设备规格。针对于新的IoT设备,在现有的设备规格不满足的情况下,用户可以通过设备库应用提交新的规格,经过设备库管理人员审批后入库。设备规格管理,用于管理本租户使用的设备规格。用户可以通过设备BO配置页面录入规格,也可以从设备库拉取项目所需的设备规格。设备实例管理,用于管理接入到统一设备服务的所有设备。设备主数据应用,提供了设备实例的查看和管理界面。
  • [技术干货] 智慧园区统一接入之设备IO开发规划
    开发流程设备IO的开发流程如表1,开发规范请参考《集成平台开发规范》。表1 设备IO开发流程流程说明注册应用在ROMA平台注册设备IO的应用名称和应用ID。创建Topic并设置订阅/发布创建接收设备原始消息的Topic、接收设备原始告警消息的Topic。环境配置/密码配置通过环境配置/密码配置,将参数或者密码设为全局变量,后续代码中通过全局变量获取对应参数、参数值、密钥和密码等。开发消息上报接口设备IO的消息上报接口,共包含3个LiveData接口。开发指令下发接口设备IO的指令下发接口,1个LiveData接口。设备IO数据规划规划应用ID、Topic和接口URL,如表2所示。表2 设备IO的数据规划参数样例说明租户GTM001下面样例中的“GTM001”为租户名称。本章节在开发过程中,要在设计内容的基础上增加后缀“__GTM001”或者前缀“GTM001__”,即携带租户信息。deviceTypeTurnstile_BPIoT系统对应的IO通过消息体中的“deviceType”参数,确定要路由的设备IO。其中“BP”指新基点IoT(BasePoint),在多IoT场景中以“deviceType”中的后缀(例如“_BP”)区分不同的IoT。在实际开发过程中,根据设备实际接入的IoT系统来增加后缀。应用IDGTM001__io.device.basepoint.Turnstile_BP人行闸机IO在ROMA平台的应用ID。其中GTM001为租户名称,实际开发时请替换为自己实际的租户名或者用户名。应用名称GTM001__人行闸机设备IO人行闸机IO在ROMA平台的应用名称。Topic接收新基点IoT发来的设备原始消息的Topic:T_IO_DATACHANGED_Turnstile_BP__GTM001人行闸机IO需要2个Topic接收新基点IoT发来的消息:一个接收设备原始消息,一个接收设备告警消息。其中GTM001为租户名称,实际开发时请替换为自己实际的租户名或者用户名。接收新基点IoT发来的设备原始告警消息的Topic:T_IO_ALARM_Turnstile_BP__GTM001接收设备信息变化的标准Topic:T_IO_DEVICE_DATACHANGED__GTM001消息格式标准化之后:转换后的设备原始消息,推送给设备信息变化标准Topic。转换后的设备告警消息,推送给设备告警的标准Topic。这2个Topic只需要创建一次即可,所有设备IO转换后的标准消息都推送给它们,不需要重复创建。接收设备告警的标准Topic:T_IO_DEVICE_ALARM__GTM001API设备数据变化消息回调(人行闸机)URL:/io/GTM001__io.device.basepoint.Turnstile_BP/device/data-changed人行闸机IO的2个LiveData接口,分别订阅如下2个Topic进行数据格式标准化。T_IO_DATACHANGED_Turnstile_BP__GTM001T_IO_ALARM_Turnstile_BP__GTM001其中GTM001为租户名称,实际开发时请替换为自己实际的租户名或者用户名。设备告警消息回调(人行闸机)URL:/io/GTM001__io.device.basepoint.Turnstile_BP/device/alarm开放订阅关系的配置接口URL:/io/GTM001__io.device.basepoint.Turnstile_BP/device/mqsSet消息订阅接口,开放订阅关系的配置接口,用于订阅设备变化、告警消息。人行闸机设备IO指令下发URL:/io/GTM001__io.device.basepoint.Turnstile_BP/south/send-command/0.1.0人行闸机设备IO指令下发包含一个LiveData接口,名称为“指令下发(人行闸机)”。
  • [技术干货] 智慧园区统一接入之开发设备IO场景介绍
    设备IO的需求园区一般集成了多种设备,不同设备上报的消息体、格式各不相同,业务平台(AppCube平台)对消息格式有统一化的要求,因此需要在集成平台(ROMA平台)对上报的消息进行拆分、格式化处理,从而屏蔽设备原始消息与标准消息之间的差异问题。基线通过设备IO来实现设备原始消息转化为标准消息的功能。设备IO的功能介绍设备通过IoT(例如新基点IoT)系统接入到ROMA平台。设备IO用于处理设备上报给ROMA平台的消息,以及ROMA平台下发给设备的指令数据,而消息上报和指令下发都要通过IoT(如新基点IoT)来实现。图1 设备IO功能下面以新基点IoT系统、人行闸机设备IO为例,介绍设备IO的消息处理流程,如表1所示。表1 设备IO的消息流程功能流程消息上报人行闸机设备数据变化/告警消息,由新基点IoT IO拆分成设备数据变化或者设备告警消息,并转发给人行闸机设备IO。人行闸机设备IO对数据格式进行转换标准化,并发送到标准Topic完成消息上报。指令下发设备管理标准接口应用路由业务侧的指令到IO Adapter应用。IO Adapter依据“channel”参数确定指令要路由到哪个IoT(南向物联网系统)。“channel”参数用于多IoT平台的场景。例如要将指令路由到新基点IoT,那么业务侧指令应该携带的“channel”值为“basepoint.connectionmax.iot”。南向物联网系统对应的IO通过消息体中的“deviceType”参数,确定要路由的设备IO,并携带accessToken。设备IO将业务侧下发的指令转换为实际物理设备可以执行的指令,并调用南向物联网系统的指令下发接口。
  • [技术干货] 智慧园区统一接入之通过IoT网关接入基线已集成设备(下)
    连接实验室认证扩展IO这部分设备IO扩展包随基线版本发布,但默认不安装,项目可根据需要选装。表2 连接实验室认证扩展IO条数分类设备IO“统一设备服务”端对应的设备规格1电气火灾监测系统设备故障电弧探测器设备ArcFaultDetectionDevice2电气火灾检测系统探测器设备ElectrFireMonitorSysDetector3消防电源监控系统设备FirePowerMonitorSys4照明系统路灯设备StreetLight5室外景观照明设备OutdoorLandscapeLighting6室内多回路照明控制器设备IndoorMultLoopLightingController7环境空间监测系统震动传感器设备Vibrating8GPS定位器设备GPSLocator9智能手环设备SmartBand10垃圾桶设备Trashcans11擦手纸余量检测设备TissuePaper12厕纸余量检测设备ToiletPaper13客流统计设备PassengerFlow14多媒体点评器设备Evaluator15洗手液余量检测设备SoapDispenser16井盖检测器设备ManholeCoverDetector17路灯显示屏设备StreetLightDisplayScreen18激光探测器设备LaserDetector19应急指示灯设备EmergencyLamp20水文监测系统水位水质监测设备WaterQualityMonitoring21水文监测设备HydrologicalTelemetery22能耗管理系统能耗管理系统设备EnergyConsumption23智能水表设备SmartWaterMeter24热量表设备HeatMeter25冷量表设备CoolCapacityMeter26火灾自动报警系统报警主机设备AlarmHost27入侵报警系统电子围栏设备ElectronicFence28门磁探测器设备ElecLockDetector29报警主机防区设备AlarmHostDefenceArea30环境空间告警系统管线甲烷气体探测器设备PipelineCH4Detector31管线硫化氢气体探测器设备PipelineH2SDetector32管线温湿度探测器设备PipelineTempAndHumidityDetector33管线压力探测器设备PipelinePressureDetector34管线氧气气体探测器设备PipelineO2Detector35紧急按钮设备EmergencyButton36温湿度监测设备TemperatureHumidity37管道流量监测设备PipelineTrafficMonitoring38液压检测设备HydraulicPressureDetector39水浸检测设备WaterImmersion40液位检测设备LiquidLevelDetector41CH探测器设备CH4Detector42红外探测器设备InfraredDetector43一氧化碳探测器设备CODetector44氨气探测器设备AmmoniaDetector45空气质量探测器设备AirAualityDetector46地埋侧循环泵设备BuriedSideCirculatingPump47定压水泵设备ConstantPressurePump48水处理仪设备WaterTreatmentInstrument49地源热泵机组设备GroundSourceHeatPumpUnit50锅炉补水箱设备BoilerSupplyTank51二次水循环泵设备SecondaryCirculationPump52消防监测系统消防栓监测设备HydrantDetector53消防管道监测设备FireControlPipeDetector54BA400V进线设备InLine400V5510kV进线设备InLine10kV56400V出线设备OutLine400V57电力变压器温控器设备TransformerTempController58交流电通断检测器设备ACDetector59空气断路器设备AirCircuitBreaker60电箱温度传感器设备TempDetector61母联设备BusTieSwitch62电容器设备Capacitance6335kV出线设备Capacitance64主变压器设备MainTransformer6510kV出线设备OutLine10kV66站变设备StationTransformer67110kV分段设备Subsection110kV68直流屏设备DirectCurrentPanel69110kV进线间隔设备IncomingLineInterval110kV70双电源转换开关DualPowerSwitch71TV监控设备TVMonitoringDevice72母线保护设备BusbarProtection73光伏发电设备PhotovoltaicGenerator74柴油发电设备DieselGenerator75电动天窗电动天窗设备PowerSunroof76电梯及扶梯扶梯设备Escalator
  • [技术干货] 智慧园区统一接入之通过IoT网关接入基线已集成设备(上)
    园区基线预集成的设备IO包含:基线设备IO、连接实验室认证扩展IO。当对应设备接入园区时无需开发任何代码,可直接接入使用。基线设备IO:随基线版本一起安装,订购园区基线后默认安装好,如表1所示。连接实验室认证扩展IO:IO扩展包随基线版本发布,但默认不安装,项目可根据需要选装,如表2所示。扩展IO详情见连接实验室认证扩展IO。基线设备IO这部分设备IO随基线版本一起安装,订购园区基线后默认安装好。表1 基线设备IO条数分类设备IO“统一设备服务”端对应的设备规格1保安系统设备门禁设备IOAccessControl2泄露电缆设备IOLeakyCable3人行闸机设备IOTurnstile4消防系统设备消防烟感设备IOSmokeDetector5消防温感设备IOTemperatureSensor6消防手报设备IOManualFireAlarmActivation7声光报警设备IOAcoustoOpticAlarm8消防栓按钮设备IOFireHydrantButton9可燃气体探测器设备IOCombustibleGasDetector10能耗系统设备水表设备IOWaterMeter11电表设备IOElectricMeter12燃气表设备IOGasMeter13资产管理设备新基点IoT射频识别标签设备IORFID14新基点IoT射频识别读卡器设备IORFIDReader15环境监测设备户外环境监测设备IOOutdoorEnvSensor16室内环境监测设备IOIndoorEnvSensor17建筑BA设备空调机组设备IOAirHandleUnit18新风机组设备IOPreCoolingAirHandlingUnit19送风机设备IOSupplyAirFan20排风机设备IOExhaustAirFan21冷机设备IOChiller22冷冻水泵设备IOChillerWaterPump23冷却水泵设备IOCoolDownWaterPump24冷却塔设备IOCoolingTower25冷源补水箱设备IOColdSourceSupplyTank26冷源补水泵设备IOColdSourceSupplyPump27冷冻水总管设备IOChilledWaterMainPipe28冷却水总管设备IOCoolDownWaterMainPipe29管道设备IOMainPipe30膨胀水箱设备IOExpansionTank31蓄冷罐设备IOColdStorageTank32电热锅炉设备IOElectricBoiler33锅炉热水泵设备IOBoilerHotWaterPump34供热水泵设备IOHeatingWaterPump35排水泵设备IODrainagePump36生活水泵设备IODomesticWaterPump37集水井设备IOSumpPit38生活水箱设备IODomesticWaterTank39减压阀设备IOPressureReliefValve40室内照明控制器设备室内照明控制器设备IOIndoorLightingController41厕位检测设备厕位检测设备IOToiletPositionDetector42工位检测设备工位检测设备IOWorkStationDetector43升降电梯设备升降电梯设备IOElevator44电梯群控器设备电梯群控器设备IOElevatorClusterController
  • [技术干货] 智慧园区统一接入之通过IoT网关接入集成架构
    设备通过IoT网关和平台接入园区时,集成架构如图1所示。图1 设备通过IoT接入南向设备接入的整个业务流程可以分为2部分:数据上报和指令下发,各模块的处理流程如下。数据上报IoT平台能力:南向设备通过IoT网关和IoT平台,将原始数据上报到ROMA MQS的原始topic中。基线预置能力:IoT Adapter IO依据消息类型将消息拆分,并根据设备类型和消息类型转发给对应设备IO的中间层topic。例如人行闸机上报的消息,会转发给“人行闸机设备IO”;门禁上报的消息会转发给“门禁设备IO”。设备IO能力:设备IO将消息转换成标准格式,并发送到“设备标准消息MQS Topic”。基线预置能力:统一设备服务消费标准topic中的消息,转换成事件供业务应用做逻辑判断。指令下发基线预置能力:统一设备服务提供标准化的设备模型和控制命令,无论是对哪种设备下发指令,业务应用都只需调用标准化的指令接口即可。基线预置能力:统一设备服务根据业务侧下发的指令,在设备的标准模型中查询到该设备的指令服务后回调ROMA侧的“设备标准IoT接口”。基线预置能力:ROMA侧的“设备标准IoT接口”依据指令中的“channel”和“deviceType”参数,将指令路由到设备IO。“channel”参数用于多IoT平台的场景,确定指令要下发给哪个IoT平台,例如新基点IoT平台的channel值为“basepoint.connectionmax.iot”。“deviceType”参数确定指令路由到哪个设备IO,deviceType的值来自统一设备服务中定义的标准模型。例如人行闸机的指令会路由到“人行闸机设备IO”,门禁的指令会路由到“门禁设备IO”。设备IO能力:设备IO将业务侧下发的指令转换为实际物理设备可以执行的指令,并回调南向IoT平台的指令下发接口。IoT平台能力:南向IoT平台向实际物理设备下发指令,控制设备的运行。在整个业务流程中,每种类型的设备,都需要有一个对应的设备IO,用于标准化实际设备上报的消息,以及转换业务下发给设备的指令,消息上报和指令下发通过IoT平台来实现。针对园区常见的一部分设备,基线已经预集成了对应的设备IO,无需开发任何代码,可直接接入使用,详细清单参见基线已集成设备。对于不在基线预置内的设备,只需开发对应的设备IO即可,其它部分不需要开发,整个上行/下行流程和业务侧都无需变动,开发流程详见基线未集成设备接入指导。
  • [问题求助] 【商飞智慧园区】【龙田】appcube,IOC页面左边侧边栏如何设置隐藏
    【功能模块】appcube【操作步骤&问题现象】1、如何隐藏侧边栏【截图信息】【日志信息】(可选,上传日志内容或者附件)
  • [问题求助] 701所智慧园区项目HiCampus开发子账户问题
    添加子账户,  所有信息填写完成以后,点击提交无反应。
  • [技术干货] 智慧园区业务资产说明之——多语言字段翻译(translate)
    多语言字段翻译函数。注意事项无。基本信息接口名称translate接口路径/service/Common/0.1.0/Common/translate接口协议HTTPS接口方法POST请求参数请求参数如表1所示。表1 请求参数说明参数名称类型必选(M)/可选(O)参数位置参数含义access-tokenStringMCookie | Header授权TOKEN。localeStringOHeader当前界面语言。如zh_CN。objectNameStringMBody对象名称。referenceStringMBody翻译源语言类型。referenceValueStringMBody待翻译源参数值。targetStringMBody翻译目标语言类型。请求样例 { "objectName": "SmartCampus__paramConfig__CST", "reference": "SmartCampus__paramNameCn__CST", "referenceValue": "最高供水温度", "target": "en_US" }响应参数响应参数如表2所示。表2 响应参数说明参数名称类型必选(M)/可选(O)位置参数含义resCodeStringMBody接口的返回码。resMsgStringOBody接口的返回消息。resultOutputs[]OBody接口的响应参数。表3 Outputs参数说明参数名称类型必选(M)/可选(O)位置参数含义valueStringMBody翻译目标值。响应样例{ "resCode": "0", "resMsg": "成功", "result": [ { "value": "" } ] }
  • [技术干货] 智慧园区业务资产说明之——基于页面多语言内容获取多语言ID(Common_queryResourceIdByLocalName)
    基于页面多语言内容获取多语言ID。注意事项无。基本信息接口名称Common_queryResourceIdByLocalName接口路径/service/Common/0.1.0/queryResouceId接口协议HTTPS接口方法POST请求参数请求参数如表1所示。表1 请求参数说明参数名称类型必选(M)/可选(O)参数位置参数含义access-tokenStringMCookie | Header授权TOKEN。localeStringOHeader当前界面语言。如zh_CN。nameStringMBody页面多语言的内容。请求样例{ "name": "test" }响应参数响应参数如表2所示。表2 响应参数说明参数名称类型必选(M)/可选(O)位置参数含义resCodeStringMBody接口的返回码。resMsgStringOBody接口的返回消息。resultOutputs[]OBody接口的响应参数。表3 Outputs参数说明参数名称类型必选(M)/可选(O)位置参数含义resourceIdsString[]MBody/result/outputs包含该多语言内容的所有符合条件的多语言ID,最多返回 5000条数据。响应样例{ "resourceIds": [ "003J000000ZEhn5NPEX2", "003J000000ZLO4uOMJiy", "003J000000ZLOAC8FEJc", "003J000000ZLRfJl4tvc", "003J000000ZLRh8gagIy", "003J000000ZLScfGiUIi", "003J000000ZLSfKEmf0y", "003J000000ZLSpG4xMAK", "003J000000ZLSrrF8qSO", "003J000000ZxVC0H7Dxg", "003J000000a0UU8crER6", "003J000000a0UWVJV5yC", ... ] }
  • [问题求助] 【北明】【AppCube】【智慧园区】怎样把智慧园区引入到线下生产环境
  • [技术干货] 智慧园区业务资产说明之——基于对象名称查询选项列表(queryPicklistByObjName)
    主要用于通过对象名称查询选项列表。注意事项无。基本信息接口名称queryPicklistByObjName接口路径/service/Common/0.1.0/queryPicklistByObjName接口协议HTTPS接口方法POST请求参数请求参数如表1所示。表1 请求参数说明参数名称类型必选(M)/可选(O)参数位置参数含义access-tokenStringMCookie | Header授权TOKEN。localeStringOHeader当前界面语言。如zh_CN。modelNameStringMBody对象名称,长度范围最大60字符。请求样例{ "modelName": "AL_AlarmDef" }响应参数响应参数如表2所示。表2 响应参数说明参数名称类型必选(M)/可选(O)位置参数含义resCodeStringMBody接口的返回码。resMsgStringOBody接口的返回消息。resultOutputs[]OBody接口的响应参数。表3 Outputs参数说明参数名称类型必选(M)/可选(O)位置参数含义picklistDatapicklistData[]OBody返回picklistData的数组,数组的内容可以为空。表4 picklistData参数说明参数名称类型必选(M)/可选(O)位置参数含义itemNameStringMBody选项列表的标签。labelStringMBody选项列表某一条目的名称。valueStringMBody选项列表条某一目的对应的值。响应样例 { "resCode": "0", "resMsg": "成功", "result": [ { "picklistData": { "DefaultLevel": [ { "label": "INFO", "value": "INFO" }, { "label": "NORMAL", "value": "NORMAL" }, { "label": "MAJOR", "value": "MAJOR" }, { "label": "CRITICAL", "value": "CRITICAL" } ], "SourceType": [ { "label": "Manual", "value": "Manual" }, { "label": "ThirdSystem", "value": "ThirdSystem" } ] } } ] }
  • [技术干货] 智慧园区业务资产说明之——基于页面多语言内容获取多语言ID(Common_queryResourceIdByLocalName)
    基于页面多语言内容获取多语言ID。注意事项无。基本信息接口名称Common_queryResourceIdByLocalName接口路径/service/Common/0.1.0/queryResouceId接口协议HTTPS接口方法POST请求参数请求参数如表1所示。表1 请求参数说明参数名称类型必选(M)/可选(O)参数位置参数含义access-tokenStringMCookie | Header授权TOKEN。localeStringOHeader当前界面语言。如zh_CN。nameStringMBody页面多语言的内容。请求样例{ "name": "test" }响应参数响应参数如表2所示。表2 响应参数说明参数名称类型必选(M)/可选(O)位置参数含义resCodeStringMBody接口的返回码。resMsgStringOBody接口的返回消息。resultOutputs[]OBody接口的响应参数。表3 Outputs参数说明参数名称类型必选(M)/可选(O)位置参数含义resourceIdsString[]MBody/result/outputs包含该多语言内容的所有符合条件的多语言ID,最多返回 5000条数据。响应样例{ "resourceIds": [ "003J000000ZEhn5NPEX2", "003J000000ZLO4uOMJiy", "003J000000ZLOAC8FEJc", "003J000000ZLRfJl4tvc", "003J000000ZLRh8gagIy", "003J000000ZLScfGiUIi", "003J000000ZLSfKEmf0y", "003J000000ZLSpG4xMAK", "003J000000ZLSrrF8qSO", "003J000000ZxVC0H7Dxg", "003J000000a0UU8crER6", "003J000000a0UWVJV5yC", ... ] }
  • [问题求助] 【北明】【AppCube】【智慧园区】如何将园区中配置的菜单发布至正式环境,并可通过链接直接访问园区登录页
  • [问题求助] 【北明】【Appcube】【生产环境】生产环境中引用智慧园区
    【功能模块】【操作步骤&问题现象】1、智慧园区中通过使用用户角色权限功能,已配置好不同角色显示不同菜单2、将智慧园区内配置发布至生产环境,使用户可以直接登录进入系统,如何实现?【截图信息】图1图2图3
总条数:419 到第
上滑加载中