IoT设备上线故障处理

如图1-3所示，尾端STA模块集成在智能终端中，负责采集末端设备（如电表、信号灯、充电桩等）的数据信息，采集到的数据通过电力线传输给头端CCO模块；头端CCO模块集成在边缘计算网关中，负责在PLC-IoT网络中完成尾端STA模块的入网认证、数据信息交互等。

图1-3 尾端STA上线边缘计算网关简易流程图

由上图，可看出智能终端与边缘计算网关之间正常通信的关键在于尾端STA与头端CCO的正常数据交互。尾端STA上线流程如图1-4所示。

图1-4 上线流程

边缘计算网关通过南向Netconf协议接入Agile Controller-IoT，上线流程如图1-5所示。

图1-5 边缘计算网关上线Agile Controller-IoT流程

1. 租户管理员在Agile Controller-IoT上添加设备档案信息。设备侧配置注册Agile Controller-IoT的参数信息，如Agile Controller-IoT的南向浮动IP地址、端口号等。
2. 核心板上电，检测与Agile Controller-IoT网络连通性。网络正常，设备则主动向Agile Controller-IoT发起TCP建链请求，并向Agile Controller-IoT发送链路探测报文，经过一系列认证及证书交换等操作，认证成功后，双方建立Netconf通道。
3. Agile Controller-IoT向设备发动Hello报文，设备应答Hello报文后，建立Netconf会话。
4. 建立Netconf会话后，Agile Controller-IoT向设备发送获取设备信息报文，设备接收后返回设备的基本信息。
5. Agile Controller-IoT接收到设备信息后，经过一系列校验认证（如License是否过期、设备是否在设备档案中）等处理，认证完成后，则通知设备上线成功。

1. 执行plciot node link-probe -t MACADDR [ -s SIZE ]或plcctl diagnose link-probe MACADDR [ -s SIZE ]命令测试指定发包长度的STA扣卡的链路层连通性。以plcctl diagnose link-probe命令为例：

   [admin@huawei ~]$ plciot nodelink-probe -t 00:00:c0:a8:01:65 -s 20
     
   PING 00:00:c0:a8:01:65: 20 data bytes..                            
      
   --- 00:00:c0:a8:01:65 ping statistics ---                                           
   4 packets transmitted, 4 packets received, 0.00% packet loss                        
   round-trip min/avg/max = 3.405/4.831/7.639 ms

   根据命令执行结果可以查看数据包是否收发成功，包括收发包数量、丢包率、数据包往返时间等。若数据包不能正常收发，表明PLC-IoT链路存在问题，无法与尾端STA连通。请联系技术人员排查电力链路问题。

2. 执行plciot network status或plcctl diagnose link-status命令查询PLC-IoT网络状态。以plciot network status为例：

   [admin@huawei ~]$ plciot network status 
   link layer network status:                                       
   snid                       :  11184974                                       
   silence status             :  disabled 
   network status             :  evaluate end  
   neighbor network           :  null 
   network formed time        :  29s                                        
   topo change times          :  1

   查看回显中“network status”字段状态：

   • forming：组网中。

   • evaluating：优化中。

   • evaluate end：组网优化完成。

     当CCO首次组网时会优化链路信息，如果已完成组网优化，再重新使能网络，网络状态以之前优化的结果为准，始终为evaluate end。

   • locked：网络已锁定。仅无扰台区识别的入网模式存在该状态。

   若网络状态为“forming”或“evaluating”，请等待网络组网或优化完成。

若尾端STA不在拒绝入网列表内，则需要检查PLC-IoT网络参数信息，包括链路状态、链路配置参数等。具体步骤如下：

1. 检查PLC-IoT网络的链路性能。
   用户可在设备上执行plciot node link-quality { -t MACADDR | -l }或plcctl diagnose link-quality [ MACADDR ]命令查询STA和CCO的PLC-IoT网络链路质量，以plciot node link-quality命令为例。

   [admin@huawei ~]$ plciot node link-quality -l 
    plciot: It will take some time to get link quality information, please wait a moment. 
    total  :  4 
    index     neighbor            up-success-rate     down-success-rate        attenuation     signal-noise-ratio    
   ---------------------------------------------------------------------------------------------------------------                       
    1         00:a4:00:78:40:31   99                  99                       5               33    
    2         00:a4:00:80:86:31   98                  96                       5               33  
    3         00:a4:00:79:94:31   97                  97                       38              23  
    4         00:a4:00:73:77:31   90                  95                       39              25    

   检查命令回显中链路衰减attenuation和信噪比signal-noise-ratio的参数值：

   • 若网络质量正常，信噪比signal-noise-ratio数值应该大于0。
   • 链路衰减attenuation数值越小表示当前链路衰减越小，通信效果越好，数值越大则衰减越大，通信效果可能受到影响，理想情况下PLC链路可容忍115dB衰减量。

   若链路质量不佳，如衰减比过大或信噪比都不符合网络正常情况，此时应排查电力链路，检查是否连接有问题、是否有干扰源等。

2. 检查PLC-IoT网络的配置参数。
   1. 检查PLC-IoT网络是否使能。
      在设备上执行fanctl network configuration命令用来查询FAN网络配置参数。若“plciot network state”回显为“disabled”，表明PLC-IoT网络未使能，需要执行plciot network enable命令用来使能PLC-IoT网络功能。

      [admin@huawei ~]$ fanctl network configuration 
      access policy           : self-identify 
      plciot network state    : enabled 
      ipv6 prefix             : fc00:0:0:0

   2. 检查ipv6-prefix参数是否为“fc00:0:0:0”。

      查看fanctl network configuration命令回显中“ipv6 prefix”字段是否为“fc00:0:0:0”，若不是，需先执行plcctl network disable命令，再执行plcctl network ipv6-prefix fc00:0:0:0命令设置ipv6-prefix为fc00:0:0:0，配置完成后执行plciot network enable命令。

   3. 检查FAN网络设备接入策略。

      查看fanctl network configuration命令回显中“access policy”字段，查看当前PLC-IoT网络的设备接入策略是否正确。若接入策略非规划的策略，可执行fanctl network access-policy命令配置。

      FAN网络接入策略包括：

      • whitelist：配置FAN网络接入策略为白名单验证。

      • self-identify：默认配置FAN网络接入策略为台区识别验证。

      • unlimited：配置FAN网络接入策略为不限制节点接入。

   4. 检查PLC-IoT网络工作频段。

      执行plciot network configuration或plciot configuration命令查看回显中当前PLC-IoT网络的工作频段模式，即“work mode”字段。以plciot configuration命令为例：

      [admin@huawei ~]$ plciot configuration 
      network state           :  enabled  
      whitelist state         :  enabled 
      ipv6 prefix             :  fc00:0:0:0 
      topo type               :  tree 
      domain type             :  electricity 
      work mode               :  2 
      analog power            :  10  
      digital power           :  2   
      mac profile             :  default  
      phy profile             :  default

      建议用户尝试将工作频段模式设置为2，即工作在0.7MHz～3MHz频段。可执行plcctl network frequency-band 2或plciot network work-mode 2命令配置，配置完成后80s后生效，期间配置发射功率不生效。

   5. 检查PLC-IoT网络拓扑类型。

      执行plciot network configuration或plciot configuration命令查看回显中当前PLC-IoT网络的拓扑类型，即“topo type”字段。当前设备的拓扑类型为树型或星型：

      • 星型拓扑情况下，尾端PLC扣卡只能与头端PLC扣卡连接；

      • 树型拓扑情况下，尾端PLC扣卡可通过尾端PLC扣卡中继与头端PLC扣卡连接。

      建议用户尝试将拓扑类型修改为tree，即树型。可执行plciot networktopo-type tree或plcctl networktopo-type tree命令配置。

   6. 检查PLC-IoT网络链路层参数模板。

      执行plciot network configuration或plciot configuration命令查看回显中当前PLC-IoT网络的链路层和物理层参数模板，即“mac profile”和“phy profile”字段。

      建议用户尝试将“mac profile”和“phy profile”修改为default，可执行plciot network mac-profile default或plciot network phy-profile default命令配置。

      配置物理层参数为默认模板default时，PLC-IoT网络工作在三相模式，适用于所有场景。若物理层参数为low-latency，该模板下PLC网络工作在单相模式，CCO仅在A相组网，连接在B相和C相的STA无法加入网络。仅限于交通灯场景使用。

网关与尾端STA上的时间一致，才能保证尾端STA在网关上正常注册。

用户可执行以下步骤将网关的设备时间同步至所有STA，步骤如下：

1. 登录网关设备，执行date命令查看当前设备时间。

   [admin@huawei ~]$ date                                                                                                    
   Mon Jul 29  15:58:36  CST 2019

   若网关设备当前时间在2000年，需要执行date -s time命令更改当前时间。

   [admin@huawei ~]$ date -s "2018-03-26 15:36:00"

   若网关上没有电池，设备每次重启后时间都会恢复到2000年，需要重新设置时间。

2. 设备时间配置完成后，执行terminalctl -t命令将网关设备的时间同步至所有STA。

   [admin@huawei ~]$ terminalctl -t

3. 配置完成后，可先尝试下电尾端STA，然后再重启网关，待网关可登录后，在上电尾端STA，等待一段时间查看尾端是否入网。若问题仍未解决，在网关上执行journalctl -a -r | grep -E "fanm|tman|plcmgr|auth" > /mnt/internal_storage/now.log命令获取PLC-IoT相关日志提供给技术支持人员处理。

EC Core核心板支持通过以太网线或3G/LTE链路接入Internet，并在Agile Controller-IoT上注册。若出现核心板无法在Agile Controller-IoT注册，需要先排查网络链路是否连通。

1. 查看设备版本信息。

   确认软件版本号及补丁版本正确。用户可执行softwarectl show-software命令查看软件版本信息。

   [admin@huawei ~]$ softwarectl show-software                                                                                        
   Current system software                 :/mnt/internal_storage/ec_core_l_spc300b823.cc                                              
   Current system software version         :V200R019C10SPC300                                                                          
   Current system software build time      :Fri Apr 17 05:41:48 UTC 2020                                                               
   Next startup system software            :/mnt/internal_storage/ec_core_l_spc300b823.cc                                              
   Next startup system software version    :V200R019C10SPC300 

   然后，执行softwarectl show-patch命令查看补丁版本信息。若未加载补丁，可忽略此步。

2. 执行wwan modem -s -i dev命令查看LTE模块的呼叫连接信息，其中dev为LTE接口名称，本文以LTE0为例。

   [admin@huawei ~]$ wwan modem -s -i LTE0
   
   Hardware Information.
   =====================
   Model = ME909s-821
   Modem Type = LTE module
   Manufacturer = Huawei Technologies Co., Ltd.
   Modem Firmware Version =  11.617.00.00.00
   Hardware Version = "RM2ME909ASM"
   Integrate circuit card identity (ICCID) = 898600B5101750581938
   International Mobile Subscriber Identity (IMSI) = 460078511617813
   Mobile Station International ISDN Number (MSISDN) = None
   International Mobile Equipment Identity (IMEI) = 867223029960861
   Factory Serial Number (FSN) = DQVDU17828000598
   Profile Information.
   ====================
   Profile 1 = ACTIVE
   --------
   PDP Type = "IPv4"
   Header Compression = OFFx
   Data Compression = OFF
   Access Point Name (APN) = 11
   Packet Session Status = Active
   Network Information.
   ====================
   Current Service Status = Service available
   Service Domain = Combined
   Current Roaming Status = Home
   Current Network Connection = LTE(LTE)
   Mobile Country Code (MCC) = 460
   Mobile Network Code (MNC) = 00
   Mobile Operator Information = CHINA MOBILE
   Cell ID = 230358283
   Radio Information.
   ==================
   Current RSSI = -79 dBm
   Current RSRP = -101 dBm
   Current RSRQ >= -3 dB
   Current SINR = 5 dB
   Bands supported: 
   GSM: GSM900 GSM1800 
   WCDMA: WCDMA850 WCDMA900 WCDMA1700 WCDMA2100 
   FDD LTE: B1 B3 B8 
   TDD LTE: B38 B39 B40 B41 
   Modem Security Information.
   ===========================
   PIN Status = Ready
   Number of Retries remaining = 3
   SIM Status = OK
   SIM ID = 1

   • 若回显中没有显示模块信息，即回显提示“The lte is not present.”，表明模块不在位。用户可优先确认LTE模块是否已插紧，插紧后重启设备查看问题是否解决。若仍显示模块不在位，在设备上执行journalctl -u eciot-nm -b 0 -a命令收集设备日志，并联系技术工程师处理。
   • 若回显显示模块信息，但“Current Service Status”字段不是“Service available”、“Current Network Connection”字段不是“LTE”，表明运营商网络存在问题。执行以下步骤处理：
     1. 查看回显中信号强度信息，若RSSI值低于-85，SINR值小于10，RSRP低于100，表示信号强度差。优先确认LTE天线是否安装正确。若无问题，请联系运营商解决。
     2. 检查SIM卡是否欠费、是否开通数据业务、是否被锁定等信息。
     3. 执行wwan apn -s -i dev命令查看LTE接口的APN信息是否正确。若不正确，执行wwan apn -a命令重新配置APN信息。
   • 若模块信息中“Packet Session Status = Inactive”，其他信息正常，表明LTE拨号存在问题。尝试执行wwan dialer -s -i dev命令开启LTE接口拨号功能恢复。若仍存在问题，执行3。

3. 检查LTE拨号功能是否已开启。
   用户可使用以下两种方式查看：

   • 执行wwan apn -s -i dev命令查看LTE接口的APN信息是否正确，然后执行configurectl -r | grep dialer_enable命令查看“dialer_enable”的值是否为1。如果没有查询到该参数信息或该参数值不为1，则表示没有开启拨号功能，需要执行wwan dialer -s -i LTE0命令配置，其他相关拨号信息也可以参考产品手册中的“配置LTE接口拨号接入Internet”章节。
   • 执行以下命令进入数据库视图，并连接数据库，查看数据库中配置信息。

     [admin@huawei ~]$ gmsysview                                                                                                         
     gmdb>>conn osc                                                                                                                      
     gmdb>>record wwan_config
     {
         "apns": [
             {
                 "apn_viewname": null,
                 "apn_name": "lte",
                 "user_name": "",
                 "user_passwd": null,
                 "priority": 1,
                 "authentication_mode": 0,
                 "sim_id": 0
              }
         ],
         "dialer_enable": 1,
         "dialer_number": null,
         "band": "0",
         "lte_band": "0",
         "cellular_name": "LTE"
     } 

     查看回显中APN信息是否正确，并确认"dialer_enable"的值是否为1，（1代表使能自动拨号）。

   若拨号功能未开启，请执行以下步骤：

   1. 配置正确的APN信息。

      执行wwan apn add命令配置APN信息。

      [admin@huawei ~]$ wwan apn add
      Enter apn name(1-99):LTEapn
      Enter user name(1-64):
      Enter password(1-32):
      Enter authentication(pap or chap):
      Enter apn priority(1-16):
      Enter dev name(1-64):LTE

      其中，“dev name”必须配置为“LTE”。

   2. 使能自动拨号功能。在设备上执行wwan dialer start dev LTE命令开启LTE拨号功能。执行完成后，重新查询拨号功能是否开启。

4. 若执行以上步骤后均解决，需要获取设备相关日志提供给技术支持人员定位。

1. 使用租户管理员帐号登录Agile Controller-IoT。
2. 在主菜单中选择“系统 > 维护 > 日志”，选择“设备上下线日志”，进入“设备上下线日志”界面。

3. 单击“过滤条件”，按设备ESN搜索过滤，并查看“失败原因”列的日志详情。

   如果日志详情中提示“获取设备基本信息报文超时或设备返回失败”，说明Agile Controller-IoT不支持设备当前版本。

4. 参见对应款型的升级指导书，将设备升级到Agile Controller-IoT支持的版本后重试。

1. 使用租户管理员帐号登录Agile Controller-IoT。
2. 在主菜单中选择“规划 > 维护 > 设备”，进入“设备列表”界面。

3. 在界面右侧的搜索框中使用设备ESN搜索，查看是否已经添加到Agile Controller-IoT中。

   如果没有，请依次选择“规划 > 维护 > 设备”，在“设备列表”页签，可采用“手动创建”或“批量导入”的方式添加设备档案。

   添加后重试。添加完成后，等待一段时间查看网关设备是否上线。

1. 使用租户管理员帐号登录Agile Controller-IoT。
2. 在主菜单中选择“系统 > 维护 > 日志”，选择“设备上下线日志”进入“设备上下线日志”界面。

3. 单击“过滤条件”，按设备ESN搜索过滤，并查看“失败原因”列的日志详情。

   如果日志详情中提示“license未授权或过期”，说明Agile Controller-IoT的License不能满足设备上线的要求。

4. 查看License使用情况，并执行相应的处理。

   使用系统管理员登录系统并在主菜单中选“系统 > 配置 > License”，在“License”页面中查看License信息。

   • 如果未加载License、License已过期或License资源已耗尽，请购买并加载新的License同时将授权包绑定到设备。

   • 如果已加载License，且License未过期、仍有剩余资源，检查License授权对象是否包含目标设备。

1. 使用租户管理员帐号登录Agile Controller-IoT。
2. 在主菜单中选择“系统 > 维护 > 日志”，进入“设备上下线日志”界面。

3. 单击“过滤条件”，按设备ESN搜索过滤，并查看日志详情。

   如果未找到上下线日志，说明Agile Controller-IoT的注册服务未启动。或者登录设备，在设备上执行ping AC南向IP地址，查看是否能够ping通。

4. 使用root用户分别登录到Agile Controller-IoT的各节点，执行netstat -apn|grep 10020|grep -i "listen"命令，查看TCP端口10020的使用情况。

   1. 如果无回显信息，说明设备注册服务启动失败。请联系技术支持人员。

   2. 如果回显信息显示10020端口被占用，请检查占用该端口的进程是否为控制器进程。如果不是，说明资源冲突，需要执行kill -9 <PID>命令杀死可疑进程后重新启动控制器进程。否则请联系技术支持人员。

      以如下回显为例，占用10020端口的进程是22127。

      # netstat -apn|grep 10020|grep -i "listen"
      tcp        0      0 192.168.2.101:10020         :::*                    LISTEN      22127/java

      根据PID找到进程，查看是否为控制器进程。

      # ps -ef|grep 22127

      如果回显信息显示这个进程与Agile Controller-IoT无关（回显信息如下图所示），杀死该进程并重新启动Agile Controller-IoT进程。

      # kill -9 22127

登录设备，执行pkictl show-cacert realm-name命令查看回显中“Validity”字段时间信息，查看设备证书的是否在有效期内。

[admin@huawei ~]$ pkictl show-cacert default-ecc 
Certificate:                                                                     
    Data:                                                                            
       Version: 3 (0x2)                                                               
       Serial Number:    
           76:5b:28:57:67:bf:eb:16:be:29:f3:6b:92:28:4e:14:9f                       
    Signature Algorithm: ecdsa-with-SHA256                                              
        Issuer: C=CN, O=Huawei, CN=Huawei Equipment CA_ECC256r1                         
        Validity                                                                   
            Not Before: Jul  4 03:08:01 2018 GMT                                        
            Not After : Jun 26 03:08:01 2048 GMT                                   
        Subject: C=CN, O=Huawei, CN=Huawei Equipment CA_ECC256r1                    
        Subject Public Key Info:                                                       
            Public Key Algorithm: id-ecPublicKey                                      
                Public-Key: (256 bit)             

若证书不在有效期内，请重新申请并更换设备证书。

证书更换，对业务的影响较大，建议联系技术支持人员处理。

1. 使用系统管理员账户登录Agile Controller-IoT，依次选择“系统 > 维护 > 概览”，查看“设备统计”区域，是否存在大量设备处于离线状态。若存在，表明大量设备连接超时。
2. 如果大量设备连接超时，再次重启该ACM节点（安装ACM组件的服务器）。
3. 判断故障是否解决。如果已经解决，结束故障处理；如果没有解决，请联系技术支持人员。