HLinkGateway開發(fā)聯(lián)調(diào)說明

HlinkGateway開發(fā)，聯(lián)調(diào)說明HlinkGateWay聯(lián)調(diào)主要是在本地的開關(guān)模組與本地的502網(wǎng)關(guān)之間建立信道，模組可以向網(wǎng)關(guān)發(fā)送設(shè)備上線信息以及反饋信息，并接收網(wǎng)關(guān)指令進(jìn)行執(zhí)行。網(wǎng)關(guān)可以接收模組的數(shù)據(jù)上報(bào)并為模組下發(fā)指令。在本地的網(wǎng)關(guān)與模組之間的信息交互配置好后，將本地的網(wǎng)關(guān)與云平臺(tái)間建立聯(lián)系。在云平臺(tái)上針對(duì)我們本地的502創(chuàng)建專屬的設(shè)備。在云平臺(tái)上可以看到本地網(wǎng)關(guān)所上傳的本地模組信息，也可以下發(fā)指令到網(wǎng)關(guān)，經(jīng)由網(wǎng)關(guān)中轉(zhuǎn)下發(fā)到模組，實(shí)現(xiàn)云端控制。下面主要從本地AR502H、ROMA平臺(tái)以及IOC平臺(tái)操作三個(gè)方面來記錄所需配置與操作。AR502H網(wǎng)關(guān)【登錄】使用SSH遠(yuǎn)程登錄AR502H，可以使用XShell，MobaXterm，putty（不推薦）登錄SSH。登錄ip：50登錄端口：22登錄用戶名：admin登錄密碼：Huawei@123【使用ftp傳輸文件】解壓FileZillaServer.zip與FileZilla_3.48.1_win64.zip兩個(gè)壓縮包。運(yùn)行FileZillaServerInterface.exe出現(xiàn)下圖所示界面。按照默認(rèn)的填寫內(nèi)容點(diǎn)擊connect即可。之后，點(diǎn)擊下圖的人頭圖標(biāo)：隨后，在出現(xiàn)的界面點(diǎn)擊add新建ftp的用戶名與密碼，并選擇ftp要分享的文件夾名字：成功建立ftp服務(wù)之后運(yùn)行filezilla.exe并點(diǎn)擊文件->站點(diǎn)管理器在新建站點(diǎn)內(nèi)配置連接ftp服務(wù)的本機(jī)ip。用戶名密碼填寫在另一個(gè)軟件中所輸入的用戶名密碼。其余設(shè)置按默認(rèn)設(shè)置即可。配置完成之后點(diǎn)擊確定保存。驗(yàn)證配置：在瀏覽器內(nèi)輸入29（根據(jù)自己設(shè)置的ip來更改）若配置FTP成功，會(huì)提示輸入用戶名與密碼，登錄后看到本地電腦上共享文件夾內(nèi)的文件。這樣便是配置成功，可以在AR502H內(nèi)使用了。在AR502H輸入HYPERLINKftp29以及用戶名，密碼，建立連接。使用getFILE_NAME與putFILE_NAME來上傳或下載文件。注意：使用時(shí)需關(guān)閉防火墻。輸入ftp指令的路徑即為文件下載路徑。df-h指令查看可用空間，注意文件不要超出存儲(chǔ)容量。【網(wǎng)關(guān)升級(jí)】后續(xù)的聯(lián)調(diào)工作極有可能繼續(xù)升級(jí)AR502H版本。升級(jí)版本的安裝包與補(bǔ)丁為.cc與.pat文件。拿到安裝包與補(bǔ)丁后，使用ftp指令把文件下載到AR502H內(nèi)的/mnt/internal_storage路勁下(升級(jí)包與補(bǔ)丁必須下到此路徑下)，隨后執(zhí)行：softwarectlload-software/mnt/internal_storage/TR6b508ar502h-cn-release.ccsoftwarectlinstall-patch/mnt/internal_storage/TR6b508patch_root_ar502h-cn.patreboot–t1version–d重啟AR502H使配置生效，然后查看版本是否為升級(jí)后版本?！救萜魃?jí)】后續(xù)一定會(huì)升級(jí)容器版本。拿到新版本容器的壓縮包hlinkarm64.ova后，使用ftp指令把壓縮包下載到/mnt/internal_storage/test路徑下。隨后運(yùn)行指令./install.sh來自動(dòng)停止，卸載舊版本hlink容器，解壓，安裝新版本容器。執(zhí)行成功之后使用containerstatushlink來查看新安裝的容器的狀態(tài)。【容器配置】正常情況下，/mnt/internal_storage/test/hlink.conf文件不需要修改，如果華為提出需要更新容器配置時(shí)，可以按照他們的指示進(jìn)行修改。配置中的大部分內(nèi)容不需要修改，最有可能修改的是[iotagent_conf]中的內(nèi)容。下面截取部分重要的配置進(jìn)行說明。[ssh_conf]sshd_ip=sshd_port=8022ssh_pub_key=id_rsa.pub//ssh登錄端口設(shè)置。想要登錄容器內(nèi)部，需要在ssh軟件中使用公鑰生成向?qū)Ы⒐€。配置文件中的本地ip均不進(jìn)行指定，外部訪問通過網(wǎng)絡(luò)nft轉(zhuǎn)換來將網(wǎng)關(guān)的GE1口映射到容器的ip上，實(shí)現(xiàn)外部的訪問。[mqtt_conf]broker_ip=broker_tcp_port=1884broker_ssl_port=8883//進(jìn)行本地?cái)?shù)據(jù)收發(fā)測試時(shí)使用的mqtt端口[mqtt_client_begin]hlinktestTest@123[mqtt_client_end]//本地通過mqtt.fx連接到網(wǎng)關(guān)時(shí)所使用的用戶名與密碼[mqtt_acl_begin]userhlinktesttopicreadwrite#[mqtt_acl_end]//注冊(cè)u(píng)sername指定權(quán)限[iotagent_conf]cloud_ip=9cloud_port=1883gateway_sn=SN-40-201-cc9990gateway_passwd=)hqe*%v/RMZjswmH}}Qz:zyb//后續(xù)最有可能修改的配置Cloud_ip與cloud_port為連接云平臺(tái)所使用的ip以及端口，平臺(tái)的ip以及開放端口一般來講不會(huì)變化。Gateway_sn與gateway_password為在云平臺(tái)注冊(cè)的設(shè)備標(biāo)識(shí)以及密碼。如果后續(xù)云平臺(tái)的設(shè)備發(fā)生變化，需要修改本地網(wǎng)關(guān)內(nèi)的配置，才能將云平臺(tái)的某個(gè)產(chǎn)品與本地網(wǎng)關(guān)一一映射上。[coap_conf]coap_ip=coap_udp_port=5683coap_dtls_port=5684//網(wǎng)關(guān)與模組之間的數(shù)據(jù)上報(bào)，下發(fā)端口[cert_conf]default_private_key=server-key.pemdefault_server_cert=server-cert.pemdefault_ca_cert=ca-cert.pem//證書地址配置，后續(xù)有可能提供新的證書，替換/mnt/internal_storage/test路徑下的證書并重新安裝hlink容器即可生效。【查看容器狀態(tài)】停止容器containerstophlink開啟容器containerstarthlink查看容器全部日志journalctlCONTAINER_NAME=hlink查看容器實(shí)時(shí)日志journalctlCONTAINER_NAME=hlink–f更多指令介紹可參考【HLink(G)部署及AR502H部署指導(dǎo)（20.3版本10-14）.pdf】【網(wǎng)絡(luò)轉(zhuǎn)換NAT配置】當(dāng)前版本的NAT轉(zhuǎn)換配置：其作用是將外部訪問進(jìn)來的端口映射到容器的端口上，建立外界與容器間的通信連接。查看NAT配置：nftlisttablednat1增加一條NAT配置nftaddrulednat1chain1ipdaddrtcpdport8883iifGE3dnat:8883目前的NAT地址轉(zhuǎn)換的配置已經(jīng)比較完善，暫時(shí)無更新的需要?！緈qtt.fx】配置mqtt來查看網(wǎng)關(guān)向云端上報(bào)的數(shù)據(jù)是否正確。安裝運(yùn)行mqtt.fx點(diǎn)擊設(shè)置按鈕：按下圖進(jìn)行配置：Brokerip以及port均與hlink.conf中的配置有關(guān)。連接時(shí)需要在192.168.1網(wǎng)段才能連接成功。連接成功后在訂閱界面點(diǎn)擊掃描按鈕，搜索可訂閱主題：搜索到cmd/internal/dataSend/iotagt主題之后進(jìn)行訂閱，查看收到的消息內(nèi)容。如下圖所收到的信息，即為網(wǎng)關(guān)向云端所發(fā)送的數(shù)據(jù)。若在云端發(fā)現(xiàn)設(shè)備沒有上線或是信息沒有上傳成功，查看發(fā)送的消息內(nèi)容來查找問題根源。【登錄容器】Ifconfig查詢?nèi)萜鲀?nèi)部網(wǎng)絡(luò)端口的ip，登錄ssh的ip在88網(wǎng)段，容器在1網(wǎng)段。因此，想要登錄進(jìn)入容器，首先需要連接到192.168.1網(wǎng)段。（可以使用wifi：IoT-Connect密碼smartCampus）容器的ip:33容器端口8022登錄方法為：PublicKey登錄方式使用此登錄方式，需首先創(chuàng)建一個(gè)公鑰：按照?qǐng)D中建立密鑰向?qū)Я鞒掏瓿蓜?chuàng)建。然后把私鑰保存在本地，把公鑰上傳到/mnt/internal_storage/test路徑替換已有的公鑰文件并重新安裝容器。在容器內(nèi)部，使用iotdevshowinfo指令查看模組在線狀態(tài)。云平臺(tái)共有兩個(gè)，ROMA平臺(tái)負(fù)責(zé)建立產(chǎn)品，查看設(shè)備在線信息等。IoC平臺(tái)主要查看產(chǎn)品信息以及設(shè)備屬性。Roma更像是一個(gè)數(shù)據(jù)庫以及中轉(zhuǎn)平臺(tái)，ioc是最后產(chǎn)品效果的平臺(tái)。關(guān)于平臺(tái)的介紹入如下：ROMA平臺(tái)地址：登錄需要聯(lián)系華為it開通ROMA平臺(tái)的ip白名單，提供固定ip。若無法提供固定ip，即使聯(lián)系華為負(fù)責(zé)人員進(jìn)行白名單更新。同時(shí)需要開啟端口白名單。需要開通1883端口。/roma/login/#/?redirect=https%3A%2F%2F%2Froma%2F%23%2F用戶名：linkuser密碼：Huawei@123在ROMA平臺(tái)中左上角選擇HLINK，然后進(jìn)入到設(shè)備信息中。搜索所屬類型為502的設(shè)備，找到對(duì)接本地AR502H的ATV燈控設(shè)備。點(diǎn)擊設(shè)備詳情查看設(shè)備基本信息。本地網(wǎng)關(guān)正常運(yùn)行情況下，就會(huì)根據(jù)hlink.conf中所配置的云端ip以及端口去平臺(tái)申請(qǐng)連接，所以正常情況下網(wǎng)關(guān)的在線狀態(tài)為在線。如果出現(xiàn)離線狀況，檢查ip是否改變（/）如果ip變動(dòng)需聯(lián)系華為修改白名單的ip地址以及開放端口。修改成功后可看到設(shè)備上線?！咀釉O(shè)備上線】連接模組，燒錄固件，連接串口運(yùn)行程序后，查看串口日志輸出數(shù)據(jù)上報(bào)相關(guān)的打印，登錄容器查看子設(shè)備在線情況。在容器內(nèi)部如能查看到設(shè)備上線信息，登錄云平臺(tái)查看主設(shè)備的子設(shè)備管理。子設(shè)備狀態(tài)欄會(huì)顯示子設(shè)備在線狀態(tài)?！緮?shù)據(jù)上報(bào)與下發(fā)】在子設(shè)備的歷史數(shù)據(jù)里，可以查看到本地模組經(jīng)由網(wǎng)關(guān)上報(bào)的數(shù)據(jù)?？梢员葘?duì)固件上報(bào)的數(shù)據(jù)與云端接收的數(shù)據(jù)是否有差異。在子設(shè)備的詳情按鈕右側(cè)有命令下發(fā)指令，點(diǎn)擊命令下發(fā)，選擇物模型中的SetService->LoopControl->Switch-LoopCode，填寫1或0來控制本地開關(guān)的開與關(guān)。端側(cè)日志可以查看接收到的數(shù)據(jù)內(nèi)容：IoC平臺(tái)/magno/rende