融合终端上行测试软件使用说明-20200416

融合终端上行测试软件使用说明V1.1目录TOC\o"1-3"\h\u284101测试软件介绍 3228662使用说明 3288992.1测试软件启动 336682.2生成ClientId 345492.3查询连接信息 470632.4查询主题信息 529102.5查询客户端订阅信息 5305342.6业务测试 664092.6.1子设备添加 6321872.6.2子设备状态更新 7169932.6.3子设备删除 8271832.6.4参数获取 9265502.6.5参数设置 9199032.6.6参数激活 1019122.6.7遥测量读取 11163182.6.8遥信量读取 11112142.6.9累加量读取 1265052.6.10对时服务 13107242.6.11时间读取 13247022.6.12复位操作 14268142.6.13循环测试 14243882.6.14数据上报 15修改记录版本日期修改内容负责人V1.02020-02-25新建刘广开V1.12020-04-16修改使用说明刘广开1测试软件介绍融合终端上行测试软件，主要是用来模拟物联管理平台和终端进行配电物联网协议的相关流程测试，以确保融合终端上行APP的流程功能满足协议要求。该测试软件仅用于模拟华为物联管理平台的测试，对于其他厂商的物联管理平台不适用。2使用说明在启动测试软件之前，需要把所需之设备的物模型文件放到测试软件下的model文件下。注意在测试过程中如果有新的模型文件需要添加，需要重启测试软件才能生效。注意由于该测试软件使用EMQXBroker，如果电脑中运行有mosquittobroker，使用该软件前需要把mosquittobroker进程结束。该软件需要使用端口1883，18083，8088端口，如果其他软件占用这些端口，需要先把相应软件关闭。2.1测试软件启动该测试软件为免安装软件，解压压缩包之后，直接双击可执行文件即可启动测试软件。注意存放路径不要带有空格或者中文。每次启动该软件需要的时间大概15秒左右，因为第一次需要启动emqx服务。当测试软件连接选项显示出客户端Id为1002的连接信息后，表示启动成功，可以连接融合终端进行相关测试。2.2生成ClientId在配置选项中，点击生成按钮就可以生成融合终端所需要的信息，包括GatewayId、ClientId、UserName和Password。请勿频繁点击生成按钮。点击查询按钮可以查询目前已存在的ClientId等信息，如下图所示。注意在对多个终端同时测试时，每个终端使用的ClientId必须是唯一的。在查询框下，右键可以删除不需要的GatewayId等信息。2.3查询连接信息点击连接选项可以当前连接到Broker上所有的客户端信息，如下图所示。2.4查询主题信息点击主题选项，可以查看当前Broker节点上所有订阅的主题信息，如下图所示。2.5查询客户端订阅信息选择订阅选项可以查看Broker上所有client的主题订阅信息，如下图所示。2.6业务测试与融合终端之间的业务功能测试主要包括子设备添加、状态更新及删除，参数读取、设置及激活，遥测、遥信及累加量读取，命令下发等流程。业务功能的测试主要集中在业务选项里，如下图所示。服务类型选项里包括具体业务功能；发布的最新主题是指测试软件向Broker发布的最近的一次消息，包括主题和消息体；收到的最新主题是指测试软件从Broker上收到最新一次消息，包括主题和消息体；消息日志记录了测试软件收发的消息内容。目前所有测消息都是采用明码Json格式表示。2.6.1子设备添加子设备添加是由终端发起的，当测试平台收到子设备的添加消息后，会为当前子设备分配一个设备Id，并将子设备添加的返回信息发布到Broker上。如果添加的子设备已存在，会把原有的DeviceId返回，不会重新生成新的DeviceId，并且会在返回状态中提示。如下图所示是子设备添加的一次交互流程。消息日志中蓝色字体表示收到的消息，黑色字体表示发布的主题，绿色字体表消息已成功发布到Broker上。每个终端下子设备的状态信息可以通过设备消息查看，如下图所示。2.6.2子设备状态更新子设备的状态更新是由融合终端发起的，测试软件收到状态更新的消息，会更新相应的子设备状态。子设备状态更新的消息交互如下图。可以冲设备选项中查看相应子设备的状态，如下图所示。2.6.3子设备删除子设备删除是从融合终端发起，测试软件收到子设备删除的消息后，会将相应子设备删除，并将删除的结果返回给终端。子设备删除的消息交互如下图。2.6.4参数获取参数获取操作是由物联管理平台发起，在测试软件业务选项中，服务类型选择参数，点击参数获取按钮。如下图所示，GatewayId选择对应的融合终端，DeviceInfo选择相应子设备，然后勾选需要读取的参数，点击Publish按钮即可发布相应主题。2.6.5参数设置参数设置是由物联管理平台发起的，在测试软件业务选项中，服务类型选择参数，点击参数设置按钮。如下图所示，GatewayId选择对应的融合终端，DeviceInfo选择相应子设备，然后勾选需要设置的参数，双击具体参数行，填写需要设置的具体值，然后点击Publish按钮即可发布相应主题。注意鼠标停留在具体参数上，可显示参数属性提示。2.6.6参数激活参数激活操作是由物联管理平台发起，在测试软件业务选项中，服务类型选择参数，点击参数获取按钮。如下图所示，GatewayId选择对应的融合终端，DeviceInfo选择相应子设备，然后勾选需要激活的参数，点击Publish按钮即可发布相应主题。参数设置完成后，需要激活才能生效，否则不生效。激活之后可以通过读取查看是否设置激活成功。2.6.7遥测量读取遥测量读取是由物联管理平台发起的，在测试软件业务选项中，服务类型选择遥测，点击遥测量获取按钮。如下图所示，GatewayId选择对应的融合终端，DeviceInfo选择相应子设备，勾选需要读取遥测量，然后点击Publish按钮即可发布相应的消息。融合终端收到消息会将相应的遥测量发布到Broker上，测试软件收到后会在收到的最新主题显示，并在消息日志里记录。2.6.8遥信量读取遥信量读取是由物联管理平台发起的，在测试软件业务选项中，服务类型选择遥信，点击遥信量获取按钮。如下图所示，GatewayId选择对应的融合终端，DeviceInfo选择相应子设备，勾选需要读取遥信量，然后点击Publish按钮即可发布相应的消息。融合终端收到消息会将相应的遥信量发布到Broker上，测试软件收到后会在收到的最新主题显示，并在消息日志里记录。2.6.9累加量读取累加量读取是由物联管理平台发起的，在测试软件业务选项中，服务类型选择累加，点击累加量获取按钮。如下图所示，GatewayId选择对应的融合终端，DeviceInfo选择相应子设备，勾选需要读取累加量，然后点击Publish按钮即可发布相应的消息。融合终端收到消息会将相应的遥信量发布到Broker上，测试软件收到后会在收到的最新主题显示，并在消息日志里记录。2.6.10对时服务对时服务是由物联管理平台向融合终端发起的，如下图所示在命令选项中点击对时服务，选择相应终端对应的GatewayId，然后点击发布按钮。2.6.11时间读取时间读取是由物联管理平台向融合终端发起的，如下图所示在命令选项中点击时间读取，选择相应终端对应的GatewayId，然后点击发布按钮。终端收到时间读取的请求后，会将终端的系统时间返回给物联管理平台。2.6.12复位操作复