开发者中心

Netcomm

概述

以下部分演示如何使用NetComm路由器与QuarkIoE。

以下部分假设路由器已安装NetComm agent包。 agent与NTC-6200NTC-140W兼容。 有关路由器特定功能的详细信息,请参阅路由器主页"Downloads"部分中的相应手册。

配置路由器

可以通过路由器的Web用户界面配置对QuarkIoE的支持。 为此,请按照路由器手册中所述登录用户界面。 导航到"System"选项卡,然后单击"Internet of Things"菜单项。

QuarkIoE配置

验证切换开关"QuarkIoE agent"设置为"ON",并且"Server"中显示的URL指向您要连接的QuarkIoE实例。 例如,使用:

或者,您可以激活以下功能的数据收集:

  • GPIO模拟测量值:发送模拟输入的电压[秒]。
  • GPS位置间隔:更新当前GPS位置[秒]。
  • GPS位置事件:发送GPS位置的位置跟踪[秒]。
  • 系统资源测量值:获取有关CPU使用情况,内存使用情况和网络流量[秒]的信息。

默认情况下禁用所有这些选项(间隔设置为0)。

Web界面还显示与QuarkIoE的连接的状态:

(适用于2.x版本)

  • Off:软件被禁用。
  • Initializing:软件正在初始化。
  • Registering:设备等待注册到QuarkIoE(见下一部分)。
  • Starting:软件启动其所有组件。
  • No credentials:设备未获取访问QuarkIoE的凭据,凭证已取消激活或凭证错误。
  • Started:软件启动。
  • Connecting:该软件正在连接到QuarkIoE。
  • Connected:软件已连接到QuarkIoE。
  • Disconnected:软件未连接到QuarkIoE。
  • Reconnecting:软件正在重试连接。
  • Stopping:软件终止。

(适用于3.x版本)

  • Checking network connection:在启动时等待移动网络连接。
  • Bootstrapping:从QuarkIoE加载凭证或请求凭证。
  • Integrating:连接到QuarkIoE。
  • Loading plugins:加载Lua插件。
  • Connected:agent已成功连接到QuarkIoE。
  • No server URL:无服务器URL或无效的服务器URL。
  • Bootstrap失败:无法从QuarkIoE获取凭证。
  • Bootstrap failed:无法连接到QuarkIoE。
  • Integration failed:无法启动上报或设备推送。

连接到路由器

要将NetComm路由器注册到QuarkIoE,您需要路由器的序列号做为Device ID。 注册过程在用户指南中的"连接设备"一节中有介绍。 序列号打印在路由器的背面,如下所示。 或者,它也可在路由器的Web用户界面中。 导航到"System", "Internet of Things"并查看"Device ID"字段。

2.x版本或从2.x升级到3.x版本的用户应该使用路由器的MAC地址。 输入MAC地址时,请务必使用小写字母和数字。 不要使用冒号分隔MAC地址。 例如,来自图片的MAC地址将被输入为

                         
      006064dda4ae
                         
                     
MAC地址

点击"接受"按钮后,导航到"所有设备",路由器应该在注册后出现在这里。 路由器的默认名称是"<model> (S/N <serial number>)",其中<model>是设备型号名称。 例如,上述路由器将显示为"NTC-6200-02 (S/N 165711141901036)"。 单击路由器以查看详细信息并访问本文档其余部分中描述的功能。 为了区分注册的路由器与列表中的其他设备,您可以在"信息"选项卡上更改路由器的名称,它还显示基本信息,如路由器的序列号和SIM卡数据。 更改名称后,请记住点击"信息"页面底部的"保存更改"按钮。

设备详情

配置网络参数

您可以在"Network"选项卡中查看和配置基本移动网络("WAN")和局域网("LAN")参数,如下面的屏幕截图所示。

用户界面中显示的移动网络("WAN")参数对应于存储在路由器中的第一个配置文件。这些参数可以直接远程配置或通过SMS。

对于SMS配置,路由器需要配置为接受SMS命令。有关SMS配置的相关参数,请参阅路由器手册,或使用路由器的Web用户界面。您还需要使用您的帐户配置短信网关。联系支持设置短信网关。有关设备外壳的更多信息,请参阅用户指南

注意通过IP和SMS模式配置WAN参数需要QuarkIoE 7.26或以上版本。当您配置错误的APN设置时,设备将丢失移动网络连接,并且只能通过有限的SMS功能进行管理。

WAN参数

LAN和DHCP参数也可以直接从QuarkIoE配置。

LAN参数

管理软件和固件

可以使用QuarkIoE的标准软件和固件管理功能远程管理路由器上安装的软件和固件,如设备管理用户指南中所述。

软件包需要采用ipkg格式,并遵循命名约定"<package>_<version>_<arch>.ipk"。不支持包括字母的版本号。通过路由器的软件包管理器支持所有软件包管理方法(安装,升级,降级,删除)。如果软件包有依赖关系,请务必先安装这些软件包。

包"smartrest-agent_<version>_arm.ipk"表示NetComm agent。禁止QuarkIoE中删除此软件包。

从低于2.1.1的版本升级时,需要重新注册设备。

固件也可以上传并安装在路由器上。要成功升级固件,请确保目标固件包含agent软件包。如果agent软件包未包含在目标固件中,则安装后agent将无法启动。固件文件需要遵循Netcomm的命名约定("<name>_<version>.cdi")。

软件/固件

监控系统资源

您可以记录路由器的系统资源使用情况的统计数据,以便进行故障排除。 提供以下统计信息:

  • CPU负载百分比。
  • 已用内存和总内存(MB)。
  • 所有接口上的上行链路和下行链路流量,单位KB/秒。

默认情况下,禁用资源统计信息收集。 可以通过在路由器用户界面的"System resources measurements"条目中或使用设备Shell设置非零收集时间间隔来启用它们:

                          
  set service.cumulocity.plugin.system_resources.interval = <interval>
                          
                      

可以在"测量值"选项卡或仪表盘中访问收集的数据。

使用GPS

要定位或跟踪路由器,请将GPS天线连接到路由器,并启用其GPS功能。 然后通过将"GPS position interval"和/或"GPS position event"设置为非零值来配置数据收集的频率。 "GPS position interval"定义路由器的当前位置被更新的频率。 "GPS position event"定义当前位置作为用于跟踪的位置更新事件存储的频率。 类似地,您可以从设备Shell设置这些参数:

                          
set service.cumulocity.plugin.ntc6200.gps.update_interval=<update interval>
set service.cumulocity.plugin.ntc6200.gps.interval=<event interval>
                          
                      

应用配置更改后,请等待第一个GPS数据到达,然后刷新页面。 现在应该会显示"位置"和"跟踪"标签。 有关详情,请参阅用户指南中的"位置""和"追踪

使用GPIO

支持以下GPIO功能:

  • 将模拟输入的电压作为测量值发送到QuarkIoE。
  • 当数字输入分别转为1或0时,引发或清除报警。
  • 从QuarkIoE远程写入数字输出。

有关其特定IO设置的详细信息,请参阅路由器文档。不同的设备模型可用功能可能不同。例如,NTC 6200型号支持GPIO引脚1-3,而NTC 140W型号仅支持GPIO引脚1。

模拟输入

要定期轮询GPIO引脚的输入电压并将其发送到QuarkIoE,将"GPIO模拟测量值"设置为非零值。或者,使用设备Shell:

                         
set service.cumulocity.plugin.ntc6200.gpio.interval=<interval>
set service.cumulocity.gpio.<port>.notify=measurement
                         
                     

<port>是GPIO引脚的编号。对于NTC-6200,<port> 可以是1,2或3,而对于NTC-140W,<port> 只能为1。可视化结果随后在"测量值"中可见。

数字输入

您可以从数字输入引发报警。 可以使用路由器用户界面或通过设备Shell配置。 格式为

                         
set service.cumulocity.gpio.<port>.notify=alarm
set service.cumulocity.gpio.<port>.debounce.interval=<SECONDS>
set service.cumulocity.gpio.<port>.alarm.text=<ALARM_TEXT>
set service.cumulocity.gpio.<port>.alarm.severity=<severity>
                         
                     

notify参数的可能值为:

  • off:针对任何通知禁用该引脚。
  • alarm:当引脚读数为"高"时,报警。
  • measurement:电压的模拟读数将作为测量值发送。

去抖动间隔减少了来自GPIO输入的电噪声:间隔越短,值越大,但信号变化的反应越快。 默认去抖间隔为10分钟。

您可以通过设置"text"属性覆盖默认报警文本。 默认情况下,该值为空并且"gpio<N> is active"用作文本,其中<N>是GPIO引脚的编号。

有效的报警严重性是:

  • WARNING
  • MINOR
  • MAJOR [缺省]
  • CRITICAL

每秒检查输入的变化。

数字输出

数字输出可以使用"继电器阵列"插件进行控制,请参见下面的屏幕截图。 GPIO引脚的编号与路由器上列出的相同。 对于NTC-6200型号,可以设置三个GPIO引脚,而对于NTC-140W型号,只有第一个引脚有效。

继电器阵列

配置管理

您可以检索,修改和保存用户配置数据。 为此,请导航到路由器的"配置"选项卡,单击"配置"小部件中的"刷新"按钮以请求配置数据 。 它将需要几秒钟下载。 在配置数据到达后,您将看到参数列表及其相应的值。 然后,您可以更改配置并将其保存回设备。

您还可以从设备请求配置快照,并稍后将配置快照应用到其他设备。

从agent版本3.1.1和QuarkIoE版本7.26开始,还有RDB快照支持,这是一个超集的配置。 主要是为了故障排除目的。

RDB设置

在QuarkIoE 6.9之前,此小部件位于"控制"选项卡中。 从QuarkIoE 6.9开始,您还可以获取整个配置快照,包括设备的非文本部分,并将参考配置快照发送回设备。

配置设备使用SMS模式

要为设备使用SMS命令,请打开路由器的Web界面,然后导航到"Services", "SMS messaging", 然后选择"Diagnostics"。 按如下所示配置设备:

  • 禁用"Only accept authenticated SMS messages",或将已允许的发件人添加到白名单。 不支持使用密码。
  • 打开其他设置。
启用SMS模式

更多信息请参考 "通过SMS控制设备"。

设备Shell

使用设备Shell,您可以从设备读取和写入各个配置参数,以及执行诊断命令。 有关详细信息,请参阅用户指南。 有关有效的参数和诊断命令,请参阅Netcomm文档。 一般格式为:

  • "get <parameter>" 从设备读取参数。
  • "set <parameter>=<value>" 向设备写入参数。
  • "execute <command>" 在设备上执行诊断命令。

可以使用分号作为分隔符发送多个get,set和execute命令。 单击"获取预定义"链接可访问常用的参数和命令。

设备Shell

事件通知

路由器将某些系统事件作为通知报告,可作为报警转发到QuarkIoE。 系统事件有助于解决移动网络问题。 有关不同类型的事件以及如何转发它们的更多信息,请参阅Netcomm文档(例如,用户指南中的"Event notification"一节)。 要将事件转发为报警,请设置UDP目标发送到localhost上的端口1331("Destination configuration"部分)。

事件通知

云现场总线

您可以分别通过LAN和串行端口将Modbus-TCP和Modbus-RTU从站连接到路由器,并在QuarkIoE中远程管理它们。要这样做,你需要对于Modbus-TCP设置:

  • 建立LAN连接。使用如上所述的"网络"选项卡和Modbus设备上的相应配置机制启用路由器和您的Modbus-TCP从站之间的IP通信。
  • 如果使用不同于默认502的端口,请在NetComm设备的Web UI上的QuarkIoE菜单中配置Modbus-TCP端口,请参阅"配置路由器"。

对于Modbus-RTU设置:

  • 通过串行电缆连接路由器和Modbus-RTU从站。
  • 通过设备shell配置串口模式:

                                      
        set serial.iomode.default=<mode>
                                    
                                

其中<mode>可以是rs232,rs422或rs485。您可能需要在更改模式后重新启动设备。

默认串行端口/dev/ttyAPP4应该无需进一步配置。如果它是空的或者您需要配置不同的端口,可以在设备的Web UI中的QuarkIoE菜单中配置,请参阅"配置路由器"。

一些USB到串行适配器默认启用echo模式,这会使Modbus通信停止工作。如果您有这些适配器之一,请咨询适配器制造商如何禁用它。

型号NTC-140W不支持modbus RTU,因此您不会在UI中看到相应的功能。

型号NTC-140W不支持modbus RTU,因此您不会在UI中看到相应的功能。

然后:

  • 通过联系支持用您的帐户订阅云现场总线应用程序。
  • 按照云现场总线用户指南中所述配置Modbus通信。
  • 通过在设备Web界面的QuarkIoE菜单中设置"Modbus read only"属性来启用或禁用写入权限,请参阅"配置路由器"。设置为0表示允许写入权限,而1表示不允许Modbus写入权限。

日志查看

您可以从设备下载和查看日志。 日志文件可以相当大,你可以设置过滤标准,只得到关心的数据。

从右边可以设置日期范围(起始日期和结束日期),可以选择日志文件。 接下来,您可以搜索文本,并且只从设备检索匹配的行。 您还可以限制匹配的行。

接收的日志在下面的列表中可见。 您可以单击它以在页面底部显示日志文件内容。 上次请求的日志会自动打开。

日志查看