HLinkGateway开发联调说明

HlinkGateway开发，联调说明HlinkGateWay联调主要是在本地的开关模组与本地的502网关之间建立信道，模组可以向网关发送设备上线信息以及反馈信息，并接收网关指令进行执行。网关可以接收模组的数据上报并为模组下发指令。在本地的网关与模组之间的信息交互配置好后，将本地的网关与云平台间建立联系。在云平台上针对我们本地的502创建专属的设备。在云平台上可以看到本地网关所上传的本地模组信息，也可以下发指令到网关，经由网关中转下发到模组，实现云端控制。下面主要从本地AR502H、ROMA平台以及IOC平台操作三个方面来记录所需配置与操作。AR502H网关【登录】使用SSH远程登录AR502H，可以使用XShell，MobaXterm，putty（不推荐）登录SSH。登录ip：50登录端口：22登录用户名：admin登录密码：Huawei@123【使用ftp传输文件】解压FileZillaServer.zip与FileZilla_3.48.1_win64.zip两个压缩包。运行FileZillaServerInterface.exe出现下图所示界面。按照默认的填写内容点击connect即可。之后，点击下图的人头图标：随后，在出现的界面点击add新建ftp的用户名与密码，并选择ftp要分享的文件夹名字：成功建立ftp服务之后运行filezilla.exe并点击文件->站点管理器在新建站点内配置连接ftp服务的本机ip。用户名密码填写在另一个软件中所输入的用户名密码。其余设置按默认设置即可。配置完成之后点击确定保存。验证配置：在浏览器内输入29（根据自己设置的ip来更改）若配置FTP成功，会提示输入用户名与密码，登录后看到本地电脑上共享文件夹内的文件。这样便是配置成功，可以在AR502H内使用了。在AR502H输入HYPERLINKftp29以及用户名，密码，建立连接。使用getFILE_NAME与putFILE_NAME来上传或下载文件。注意：使用时需关闭防火墙。输入ftp指令的路径即为文件下载路径。df-h指令查看可用空间，注意文件不要超出存储容量。【网关升级】后续的联调工作极有可能继续升级AR502H版本。升级版本的安装包与补丁为.cc与.pat文件。拿到安装包与补丁后，使用ftp指令把文件下载到AR502H内的/mnt/internal_storage路劲下(升级包与补丁必须下到此路径下)，随后执行：softwarectlload-software/mnt/internal_storage/TR6b508ar502h-cn-release.ccsoftwarectlinstall-patch/mnt/internal_storage/TR6b508patch_root_ar502h-cn.patreboot–t1version–d重启AR502H使配置生效，然后查看版本是否为升级后版本。【容器升级】后续一定会升级容器版本。拿到新版本容器的压缩包hlinkarm64.ova后，使用ftp指令把压缩包下载到/mnt/internal_storage/test路径下。随后运行指令./install.sh来自动停止，卸载旧版本hlink容器，解压，安装新版本容器。执行成功之后使用containerstatushlink来查看新安装的容器的状态。【容器配置】正常情况下，/mnt/internal_storage/test/hlink.conf文件不需要修改，如果华为提出需要更新容器配置时，可以按照他们的指示进行修改。配置中的大部分内容不需要修改，最有可能修改的是[iotagent_conf]中的内容。下面截取部分重要的配置进行说明。[ssh_conf]sshd_ip=sshd_port=8022ssh_pub_key=id_rsa.pub//ssh登录端口设置。想要登录容器内部，需要在ssh软件中使用公钥生成向导建立公钥。配置文件中的本地ip均不进行指定，外部访问通过网络nft转换来将网关的GE1口映射到容器的ip上，实现外部的访问。[mqtt_conf]broker_ip=broker_tcp_port=1884broker_ssl_port=8883//进行本地数据收发测试时使用的mqtt端口[mqtt_client_begin]hlinktestTest@123[mqtt_client_end]//本地通过mqtt.fx连接到网关时所使用的用户名与密码[mqtt_acl_begin]userhlinktesttopicreadwrite#[mqtt_acl_end]//注册username指定权限[iotagent_conf]cloud_ip=9cloud_port=1883gateway_sn=SN-40-201-cc9990gateway_passwd=)hqe*%v/RMZjswmH}}Qz:zyb//后续最有可能修改的配置Cloud_ip与cloud_port为连接云平台所使用的ip以及端口，平台的ip以及开放端口一般来讲不会变化。Gateway_sn与gateway_password为在云平台注册的设备标识以及密码。如果后续云平台的设备发生变化，需要修改本地网关内的配置，才能将云平台的某个产品与本地网关一一映射上。[coap_conf]coap_ip=coap_udp_port=5683coap_dtls_port=5684//网关与模组之间的数据上报，下发端口[cert_conf]default_private_key=server-key.pemdefault_server_cert=server-cert.pemdefault_ca_cert=ca-cert.pem//证书地址配置，后续有可能提供新的证书，替换/mnt/internal_storage/test路径下的证书并重新安装hlink容器即可生效。【查看容器状态】停止容器containerstophlink开启容器containerstarthlink查看容器全部日志journalctlCONTAINER_NAME=hlink查看容器实时日志journalctlCONTAINER_NAME=hlink–f更多指令介绍可参考【HLink(G)部署及AR502H部署指导（20.3版本10-14）.pdf】【网络转换NAT配置】当前版本的NAT转换配置：其作用是将外部访问进来的端口映射到容器的端口上，建立外界与容器间的通信连接。查看NAT配置：nftlisttablednat1增加一条NAT配置nftaddrulednat1chain1ipdaddrtcpdport8883iifGE3dnat:8883目前的NAT地址转换的配置已经比较完善，暂时无更新的需要。【mqtt.fx】配置mqtt来查看网关向云端上报的数据是否正确。安装运行mqtt.fx点击设置按钮：按下图进行配置：Brokerip以及port均与hlink.conf中的配置有关。连接时需要在192.168.1网段才能连接成功。连接成功后在订阅界面点击扫描按钮，搜索可订阅主题：搜索到cmd/internal/dataSend/iotagt主题之后进行订阅，查看收到的消息内容。如下图所收到的信息，即为网关向云端所发送的数据。若在云端发现设备没有上线或是信息没有上传成功，查看发送的消息内容来查找问题根源。【登录容器】Ifconfig查询容器内部网络端口的ip，登录ssh的ip在88网段，容器在1网段。因此，想要登录进入容器，首先需要连接到192.168.1网段。（可以使用wifi：IoT-Connect密码smartCampus）容器的ip:33容器端口8022登录方法为：PublicKey登录方式使用此登录方式，需首先创建一个公钥：按照图中建立密钥向导流程完成创建。然后把私钥保存在本地，把公钥上传到/mnt/internal_storage/test路径替换已有的公钥文件并重新安装容器。在容器内部，使用iotdevshowinfo指令查看模组在线状态。云平台共有两个，ROMA平台负责建立产品，查看设备在线信息等。IoC平台主要查看产品信息以及设备属性。Roma更像是一个数据库以及中转平台，ioc是最后产品效果的平台。关于平台的介绍入如下：ROMA平台地址：登录需要联系华为it开通ROMA平台的ip白名单，提供固定ip。若无法提供固定ip，即使联系华为负责人员进行白名单更新。同时需要开启端口白名单。需要开通1883端口。/roma/login/#/?redirect=https%3A%2F%2F%2Froma%2F%23%2F用户名：linkuser密码：Huawei@123在ROMA平台中左上角选择HLINK，然后进入到设备信息中。搜索所属类型为502的设备，找到对接本地AR502H的ATV灯控设备。点击设备详情查看设备基本信息。本地网关正常运行情况下，就会根据hlink.conf中所配置的云端ip以及端口去平台申请连接，所以正常情况下网关的在线状态为在线。如果出现离线状况，检查ip是否改变（/）如果ip变动需联系华为修改白名单的ip地址以及开放端口。修改成功后可看到设备上线。【子设备上线】连接模组，烧录固件，连接串口运行程序后，查看串口日志输出数据上报相关的打印，登录容器查看子设备在线情况。在容器内部如能查看到设备上线信息，登录云平台查看主设备的子设备管理。子设备状态栏会显示子设备在线状态。【数据上报与下发】在子设备的历史数据里，可以查看到本地模组经由网关上报的数据。可以比对固件上报的数据与云端接收的数据是否有差异。在子设备的详情按钮右侧有命令下发指令，点击命令下发，选择物模型中的SetService->LoopControl->Switch-LoopCode，填写1或0来控制本地开关的开与关。端侧日志可以查看接收到的数据内容：IoC平台/magno/rende