【功能模块】华为智慧园区开发工程师认证进阶课 实战课（https://qa6-dev.besclouds.com/） 统一事件集成第三方系统【操作步骤&问题现象】1、根据操作指导书完成“事件处置服务IO”应用开发，并配置统一事件转发规则2、Live Data > API测试 返回结果为null【截图信息】1、API设计2、API开发3、API测试【日志信息】（可选，上传日志内容或者附件）

【功能模块】   华为智慧园区开发工程师认证进阶课 实战课（https://qa6-dev.besclouds.com/） 统一事件集成第三方系统 新增设备后不能正常触发事件   租户帐号和密码私聊发【操作步骤&问题现象】1、IOC新增设备 或者 脚本直接调试2.物流是从页面新增设备还是 直接调试都是通过roma调用  io.unified.event.apiservice 的 /service/EventBridge/0.1.0/event/addEvent 返回都是 SYSTEM_ERROR【截图信息】下图为直接调试日志【日志信息】（可选，上传日志内容或者附件）附件日志 2022-08-05 20:08:18.538  和  2022-08-05 20:08:18.681 为IOC直接新增设备的日志

【功能模块】  用户登录【操作步骤&问题现象】1、注册业务用户账号2、调用/service/CM_Identity/0.1.0/login，按照说明文档，应有响应信息，但实际上却报"您没有足够权限执行执行脚本"   麻烦问下是什么原因？【截图信息】【日志信息】（可选，上传日志内容或者附件）

智慧园区统一接入之通过IoT网关接入集成架构https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=195894智慧园区统一接入之通过IoT网关接入基线已集成设备（上）https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=195895智慧园区统一接入之通过IoT网关接入基线已集成设备（下）https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=195896智慧园区统一接入之开发设备IO场景介绍https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=195983智慧园区统一接入之设备IO开发规划https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=195984智慧园区统一服务之——什么是统一设备服务https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196118智慧园区统一服务之——统一设备服务的优势和应用场景https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196119智慧园区集成资产说明——如何获取IO资产包健康状态https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196153智慧园区集成资产说明——如何获取南向子系统连接状态https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196154智慧园区集成资产说明——增加人脸库接口说明https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196430智慧园区集成资产说明——删除人脸库接口说明https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=196431智慧园区集成资产说明——查询人脸库接口说明cid:link_14智慧园区集成资产说明——添加人脸图片接口说明cid:link_13智慧园区集成资产说明——对接南向子系统新基点IoT指令下发接口说明cid:link_15智慧园区集成资产说明——对接南向子系统新基点IoT注册设备接口说明cid:link_16智慧园区统一运维概述https://bbs.huaweicloud.com/forum/thread-0223960005232380004-1-1.html智慧园区统一运维规范和要求https://bbs.huaweicloud.com/forum/thread-0221960005871960006-1-1.html历史精选技术贴汇总：智慧园区BBS论坛七月技术贴汇总一览（七月持续更新）https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=193937智慧园区BBS论坛六月技术贴汇总一览（六月持续更新）https://bbs.huaweicloud.com/forum/forum.php?mod=viewthread&tid=190895

功能描述该接口用于删除EI系统的人脸库。注意事项无。基本信息接口名称删除人脸库v1.1接口路径/io-adapter/south/face-recognition/v1.1/face-repository/deleteHTTP方法POST请求参数请求参数如表1所示。表1 请求消息参数说明参数名称类型必选(M)/可选(O)位置参数含义X-HW-IDStringMHeaderROMA授权的应用ID。X-HW-APPKEYStringOHeaderROMA授权的应用的密钥。说明：如果调用侧在ROMA平台设置了白名单，该参数可不填，如果没有，该参数必填。channelStringMHeader选择的子系统渠道。由上层应用携带，供ROMA平台做路由选择。厂家无需实现。repositoryCodeStringMBody“增加人脸库”接口返回的人脸库标识。请求样例{ "repositoryCode": "test03" }响应参数响应参数如表2所示。表2 响应消息参数说明参数名称类型参数含义resCodeString返回码。具体请参考“人员匹配错误码”。resMsgString返回消息。originalResInfooriginalResInfo原始响应消息。表3 originalResInfo参数说明参数名称类型参数含义originalResCodeString原始返回码。originalResMsgString原始返回消息。响应样例{ "resCode": "0", "resMsg": "Success.", "originalResInfo": { "originalResCode": "0", "originalResMsg": "Success." } }

功能描述该接口用于向EI子系统添加人脸库，用于人员匹配场景。注意事项无。基本信息接口名称增加人脸库v1.1接口路径/io-adapter/south/face-recognition/v1.1/face-repository/addHTTP方法POST请求参数请求参数如表1所示。表1 请求消息参数说明参数名称类型必选(M)/可选(O)位置参数含义X-HW-IDStringMHeaderROMA授权的应用ID。X-HW-APPKEYStringOHeaderROMA授权的应用的密钥。说明：如果调用侧在ROMA平台设置了白名单，该参数可不填，如果没有，该参数必填。channelStringMHeader选择的子系统渠道。由上层应用携带，供ROMA平台做路由选择。厂家无需实现。repositoryNameStringMBody库名称。必须唯一。后续不可更改，只能删除。不支持中文，只支持数字、字母和下划线。长度范围：1~32个字符。建议人脸库的名称不要以下划线（_）开头，否则会无法采集人脸数量。descriptionStringOBody库描述。不支持。capacityIntOBody库容量，人脸库最大的容量。默认容量由各个厂家自行定义。填写1万整数倍的数字，例如：30000。默认为100000，最大值为100000。extensionObjectOBody扩展对象。用于携带厂家定义的特有字段。自定义字段不能以系统保留字段vector、bounding_box、external_image_id、face_id、create_time、_id、_all、_source等字段命名。Json字符串不校验重复性，自定义字段的key值长度范围为[1,36]，String类型的value长度范围为[1,256]，具体参见自定义字段。请求样例{ "repositoryName": "test03" }响应参数响应参数如表2所示。表2 响应消息参数说明参数名称类型参数含义resultresult接口响应参数。成功时返回下方结果，失败或者数据为空时，不返回result内部的内容结构，仅返回null。resCodeString返回码。具体请参考“人员匹配错误码”。resMsgString返回消息。originalResInfooriginalResInfo原始响应消息。表3 result参数说明参数名称类型参数含义repositoryCodeString人脸库标识。长度范围：支持1~32字符。表4 originalResInfo参数说明参数名称类型参数含义originalResCodeString原始返回码。originalResMsgString原始返回消息。响应样例{ "resCode": "0", "resMsg": "Success.", "originalResInfo": { "originalResCode": "0", "originalResMsg": "Success." }, "result": { "repositoryCode": "test03" } }

【功能模块】查询实时天气信息（getWeather）查询实时天气信息。该接口主要用于查询实时天气信息，获取实时气温。注意事项无。基本信息接口名称getWeather接口路径/service/SmartCampus__EnvironmentMonitoring/0.1.0/weather/query接口协议HTTPS接口方法POST【操作步骤&问题现象】1、请问该模块是否只能在APP中使用，WEB端能否调用；2、请问该天气数据来自哪里，是否准确，是否收费；3、该天气数据比较简单，只有城市、三种气温、天气（阴晴雨雪），有没有数据更丰富的接口；【截图信息】【日志信息】（可选，上传日志内容或者附件）

功能描述该接口用于获取南向子系统的连接状态。注意事项无。基本信息接口名称获取南向子系统连接状态外部接口路径/io-adapter/south-connection?appid={appid}HTTP方法GET请求参数请求参数如表1所示。表1 请求消息参数说明参数名称必选(M)/可选(O)类型位置参数含义X-HW-IDMStringHeaderROMA授权的应用ID。X-HW-APPKEYOStringHeaderROMA授权的应用的密钥。说明：如果调用侧在ROMA平台设置了白名单，该参数可不填，如果没有，该参数必填。appidMStringQueryString应用ID。请求样例无响应参数响应参数如表2所示。表2 响应消息参数说明参数名称类型参数含义resCodeString返回码。resMsgString返回消息。resultList<SouthConnectionStatus>查询返回的IO资产健康状态。表3 SouthConnectionStatus参数说明参数名称类型参数含义appIdStringIO资产包的应用ID。appNameStringIO资产包的应用名称。numberInt南向子系统环境的编号。statusInt南向环境的连接状态。0：正常1：异常响应样例{ "resCode": "0", "resMsg": "success.", "result": [{ "status": 0, "number": 1, "appName": "华为云IoT边缘节点", "appId": "io.huawei.oc.edge.iot" }] }

功能描述该接口用于IO资产包的健康状态。注意事项无。基本信息接口名称获取IO资产包健康状态外部接口路径/io-adapter/liveness?appid={appid}HTTP方法GET请求参数请求参数如表1所示。表1 请求消息参数说明参数名称必选(M)/可选(O)类型位置参数含义X-HW-IDMStringHeaderROMA授权的应用ID。X-HW-APPKEYOStringHeaderROMA授权的应用的密钥。说明：如果调用侧在ROMA平台设置了白名单，该参数可不填，如果没有，该参数必填。appidMStringQueryString应用ID。请求样例无响应参数响应参数如表2所示。表2 响应消息参数说明参数名称类型参数含义resCodeString返回码。resMsgString返回消息。resultIOStatus查询返回的IO资产健康状态。表3 IOStatus参数说明参数名称类型参数含义appIdStringIO资产包的应用ID。appNameStringIO资产包的应用名称。statusIntIO资产包的状态。0：正常1：异常响应样例{ "resCode": "0", "resMsg": "success.", "result": { "status": 0, "appName": "华为云EI人员匹配服务IO", "appId": "io.huawei.ei.faceRecognition" } }

优势可扩展的物模型数据库内嵌标准物模型设备库，能支持市面上大部分的设备类型。用户也可以根据业务需要提交新的物模型到物模型数据库，从而在业务中使用。屏蔽设备多样性园区设备集中管理，对不同品牌的同类设备提供标准化的点位数据和标准化的控制命令。底层设备品牌发生变化时，上层应用不需要重新适配。统一管理提供标准化的API用于设备信息维护，包括增加、删除、修改、查询等。应用场景需要和物联网设备进行交互的场景，都会用到统一设备服务。例如：考勤系统中，需要根据视频监控捕捉到的人脸信息来判断员工是否按时到场。考勤系统通过统一设备服务提供摄像机的操作API获取数据，并提供给人脸分析模块做员工到场分析。访客系统中，客人可以使用手机二维码图片来打开门禁道闸。统一设备服务管理门禁道闸，访客系统通过统一设备服务下发指令给目标道闸，控制道闸开闭。安防系统中，需要获取烟感、温感设备的读数来判断是否有火险告警。IoT系统定时获取烟感温感设备的信息，上报给统一设备服务。统一设备服务通过触发器的形式通知安防系统对可能发生的火险做应对。

在IoT业务中，有许多需要业务应用和物联网设备产生交互的场景，包括获取设备信息、设获取设备数据、操控设备行为等。这些场景中涉及的物联网设备品牌纷杂，种类繁多，协议多样，给业务应用的开发带来了诸多不便。为了能让业务开发人员更方便高效地实现与物联网设备交互的功能，我们对物联网设备进行业务抽象，提供统一设备服务。统一设备服务提供了对物联网设备的建模、管理、交互等能力。定义了物联网设备的模型和服务上的规范。不同的业务应用，所看到的设备的模型和服务都是相同结构的，这样有助于业务应用之间的信息交互。提供了对不同物联网设备的统一抽象机制。对于同一类型的物联网设备，即使是来自不同厂家的产品，也可以抽象成相同的设备规格。因此业务应用使用设备能力时，无需针对不同设备产品做分别的适配。提供了标准的IoT网关集成接口。与不同的网关集成时，只需要准备相应的适配器，而上层业务应用可以保持不变。统一设备服务的组成框图如下：图1 统一设备服务提供全网共用的设备库，对各个开发者提供常用的设备规格。针对于新的IoT设备，在现有的设备规格不满足的情况下，用户可以通过设备库应用提交新的规格，经过设备库管理人员审批后入库。设备规格管理，用于管理本租户使用的设备规格。用户可以通过设备BO配置页面录入规格，也可以从设备库拉取项目所需的设备规格。设备实例管理，用于管理接入到统一设备服务的所有设备。设备主数据应用，提供了设备实例的查看和管理界面。

开发流程设备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的需求园区一般集成了多种设备，不同设备上报的消息体、格式各不相同，业务平台（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将业务侧下发的指令转换为实际物理设备可以执行的指令，并调用南向物联网系统的指令下发接口。

连接实验室认证扩展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

园区基线预集成的设备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