目  录

1 物联网网关

1.1 物联网网关简介

1.1.1 物联网网关应用场景

1.2 物联网网关与硬件适配关系

1.3 物联网网关配置任务简介

1.4 配置物联网模块基础功能

1.4.1 配置物联网模块自动上线及固化功能

1.4.2 配置物联网模块的序列号

1.4.3 配置物联网模块类型

1.4.4 启动物联网模块

1.4.5 配置物联网服务器的IPv4地址和端口号

1.4.6 配置物联网模块的发送功率级别

1.4.7 配置物联网模块的描述信息

1.5 配置物联网定位功能

1.6 配置物联网定位的报文RSSI过滤门限值

1.7 配置定位保活功能

1.8 配置物联网模块上报定位报文采样功能

1.9 配置物联网模块的报文长度字段值

1.10 配置进出校检测功能

1.11 配置BLE通告发送功能

1.12 配置通过物联网网关管理iBeacon设备

1.13 配置物联网模块上送报文的模式

1.14 配置物联网模块LED灯闪烁

1.14.1 功能简介

1.14.2 配置物联网模块上LED灯的闪烁模式

1.14.3 配置物联网模块外壳上LED灯进行闪烁示意

1.15 升级物联网模块版本

1.15.1 功能简介

1.15.2 配置限制和指导

1.15.3 配置物联网模块版本自动升级功能

1.15.4 手动升级物联网模块版本

1.16 重启物联网模块

1.17 配置物联网模块恢复出厂配置

1.18 物联网网关显示和维护

1 物联网网关

1.1  物联网网关简介

物联网网关通过对物联网模块配置和管理，完成与物联网服务器的交互。

物联网模块作为信息传感设备，把物品和互联网相连接，进行信息交换和通信，以实现智能化识别、定位、跟踪、监控和管理。

绿洲平台作为物联网服务器将物联网模块上送的报文进行数据分析和计算，从而实现物联网应用，并将物联网应用信息呈现给用户。

1.1.1  物联网网关应用场景

不同类型的物联网模块可用于不同物联网领域。

1. RFID模块应用场景

连接了RFID（Radio Frequency Identification，射频识别）模块的物联网网关可以应用于医疗物联网，通过识别母亲标签、婴儿脚环、体温电子标签等医疗RFID设备，实现婴儿防盗、患者体温监测等医疗业务。

2. BLE模块应用场景

连接了BLE（Bluetooth Low Energy，蓝牙低功耗）模块的物联网网关可以用于管理iBeacon设备，也可以直接作为iBeacon设备使用。iBeacon是苹果公司推出的BLE技术，其工作方式是，iBeacon设备使用BLE技术向周围发送自己特有的ID，接收到该ID的应用软件会根据该ID采取特定的行动以实现相应的软件功能。

3. ZigBee模块应用场景

连接了ZigBee模块的物联网网关可以应用于智能家居、环境检测等领域。ZigBee网络一般包含以下成员：

·     协调器：装有ZigBee插卡的物联网模块，用于发起创建ZigBee网络并负责网络其他设备的正常通信。

·     路由器：用于转发其他节点的信息。

·     标准ZigBee设备（终端节点）：负责数据采集、上传。

1.2  物联网网关与硬件适配关系

本特性的支持情况与设备型号有关，请以设备的实际情况为准。

1.3  物联网网关配置任务简介

物联网网关配置任务如下：

(1)     配置物联网模块基础功能

a.     配置物联网模块自动上线及固化功能

b.     配置物联网模块的序列号

c.     配置物联网模块类型

d.     启动物联网模块

e.     配置物联网服务器的IPv4地址和端口号

f.     （可选）配置物联网模块的发送功率级别

g.     （可选）配置物联网模块的描述信息

(2)     （可选）管理和维护物联网模块

¡     配置物联网定位功能

¡     配置物联网定位的报文RSSI过滤门限值

¡     配置定位保活功能

¡     配置物联网模块上报定位报文采样功能

¡     配置物联网模块的报文长度字段值

¡     配置进出校检测功能

¡     配置BLE通告发送功能

¡     配置通过物联网网关管理iBeacon设备

¡     配置物联网模块上送报文的模式

¡     配置物联网模块LED灯闪烁

¡     升级物联网模块版本

¡     重启物联网模块

¡     配置物联网模块恢复出厂配置

1.4  配置物联网模块基础功能

1.4.1  配置物联网模块自动上线及固化功能

1. 功能简介

当物联网网关连接的物联网模块数量较多时，开启物联网模块自动上线功能可以简化配置，无需逐一将物联网模块手工配置上线。

模块自动上线后，管理员可对自动上线的模块进行集中配置。若需要进入Module视图对物联网模块进行参数修改，管理员必须先通过配置将自动上线模块固化为手工上线模块。

开启自动上线物联网模块固化功能后，后续接入的自动上线物联网模块将自动固化为手工上线模块，且自动配置模块序列号。而此前已上线的自动上线物联网模块不会被固化为手工上线模块。

2. 配置限制和指导

本功能仅在物联网模块与物联网网关连接时生效。

在配置物联网模块自动上线及固化功能时，为避免遗漏固化自动上线物联网模块或增加固化工作量，建议的配置顺序为：开启物联网模块自动上线功能、开启自动上线物联网模块固化功能、将所有已上线的自动上线物联网模块固化为手工上线模块。

3. 配置步骤

(1)     进入系统视图。

system-view

(2)     开启物联网模块自动上线功能。

iot auto-module enable

缺省情况下，物联网模块自动上线功能处于关闭状态。

(3)     （可选）开启自动上线物联网模块固化功能。

iot auto-module persistent enable

缺省情况下，自动上线物联网模块固化功能处于关闭状态。

(4)     （可选）将所有已上线的自动上线物联网模块固化为手工上线模块。

iot auto-module persistent all

1.4.2  配置物联网模块的序列号

1. 功能简介

当物联网模块是通过网络与AP连接，且配置的序列号和模块的序列号相匹配时，物联网模块才能在AP上完成手工上线；当物联网模块安装在AP上时，配置的序列号不生效，模块将直接在AP上上线。

2. 配置限制和指导

对于通过网络与AP连接并上线的模块，改变和删除序列号将导致模块下线。

3. 配置步骤

(1)     进入系统视图。

system-view

(2)     进入Module视图。

iot module module-id

(3)     配置物联网模块的序列号。

serial-number serial-number

缺省情况下，未配置物联网模块的序列号。

1.4.3  配置物联网模块类型

1. 功能简介

只有配置了物联网模块的类型，并且配置的模块类型与物联网网关上的物联网模块类型一致，物联网模块才能正常工作。

2. 配置步骤

(1)     进入系统视图。

system-view

(2)     进入Module视图。

iot module module-id

(3)     配置联网模块类型。

type { ble | rfid | uwb }

缺省情况下，未配置物联网模块类型。

1.4.4  启动物联网模块

(1)     进入系统视图。

system-view

(2)     进入Module视图。

iot module module-id

(3)     启动物联网模块。

module enable

缺省情况下，物联网模块处于禁用状态。

1.4.5  配置物联网服务器的IPv4地址和端口号

1. 功能简介

配置物联网服务器的IP地址、端口号和域名后，物联网网关才能完成物联网模块与服务器间的信息交互。

2. 配置限制和指导

物联网服务器域名配置方式的优先级高于IP地址配置方式，配置物联网服务器的域名后，会清除已配置的物联网服务器IP地址。

3. 配置步骤

(1)     进入系统视图。

system-view

(2)     配置物联网服务器的IP地址、端口号或域名。

iot module-type { t300-b | t300-r } { server-address { ip | ipv6 } server-address | server-domain domain-name { ip | ipv6 } } port port

iot module-type { ew100-r | t100-a | t100-tp | t300bp0r | t300pb0u | t300rt0r } server-address ip server-address port port

缺省情况下，未配置物联网服务器的IP地址、端口号或域名。

1.4.6  配置物联网模块的发送功率级别

1. 功能简介

物联网模块的发送功率分为4个级别，按发送功率从高到低依次为：

·     1级：4dBm

·     2级：-1dBm

·     3级：-5dBm

·     4级：-9dBm

2. 配置步骤

(1)     进入系统视图。

system-view

(2)     进入Module视图。

iot module module-id

(3)     配置物联网模块的发送功率级别。

tx-power power

缺省情况下，发送功率的级别为1，即模块的发送功率为4dBm。

1.4.7  配置物联网模块的描述信息

1. 功能简介

可以根据物联网模块所处地理位置以及用途来配置描述信息。

2. 配置步骤

(1)     进入系统视图。

system-view

(2)     进入Module视图。

iot module module-id

(3)     配置物联网模块的描述信息。

description text

缺省情况下，未配置物联网模块的描述信息。

1.5  配置物联网定位功能

1. 功能简介

当需要配置RFID定位和蓝牙定位时，必须开启物联网定位功能。

开启物联网定位功能后，物联网网关通过物联网模块识别物联网终端发来的所有报文，并转发至物联网服务器，物联网服务器将对上报的报文进行处理。

2. 配置步骤

(1)     进入系统视图。

system-view

(2)     开启物联网定位功能。

rfid-tracking iot enable

缺省情况下，物联网定位功能处于关闭状态。

1.6  配置物联网定位的报文RSSI过滤门限值

1. 功能简介

在RFID定位和蓝牙定位中，如果终端数量过多会影响报文的处理速度，用户可以通过本特性过滤掉信号强度弱的终端的定位报文，减少系统资源的占用。

2. 配置步骤

(1)     进入系统视图。

system-view

(2)     进入Module视图。

iot module module-id

(3)     配置物联网定位的报文RSSI过滤门限值。

rfid-tracking iot rssi threshold rssi-threshold

缺省情况下，未配置物联网定位的报文RSSI过滤门限值。

1.7  配置定位保活功能

1. 功能简介

开启定位保活功能后，物联网网关会每隔15秒发送Hello报文给物联网服务器，用于物联网服务器确认物联网网关是否在线。如果物联网服务器超过30秒没有收到来自物联网网关的Hello消息或其它任何消息，则认为物联网网关已失去连接，并采取相应的处理。

2. 配置限制和指导

如果物联网服务器不支持处理Hello报文，避免无效报文占用带宽资源，则建议关闭本功能；如果物联网服务器支持处理Hello报文，则根据物联网服务器的要求开启本功能。

3. 配置步骤

(1)     进入系统视图。

system-view

(2)     开启定位保活功能。

rfid-tracking keepalive enable

缺省情况下，定位保活功能处于关闭状态。

1.8  配置物联网模块上报定位报文采样功能

1. 功能简介

物联网终端缺省每秒上报一个定位报文到物联网模块，物联网模块将收到的定位报文上报至物联网网关，在某些场景下物联网终端处于长期静止或者活动频率很低的状态，此时上报的定位报文过多会影响网关处理报文的整体性能，通过开启物联网模块上报定位报文采样功能，使物联网网关按照一定的频率对指定的物联网模块上报的定位报文进行采样，减少上报的报文数量。

2. 配置限制和指导

仅在物联网模块类型为RFID时支持配置本功能。

3. 配置步骤

(1)     进入系统视图。

system-view

(2)     配置物联网模块上报定位报文的采样周期。

rfid-tracking iot sampling interval interval

缺省情况下，物联网模块上报定位报文的采样周期为10秒。

(3)     进入Module视图。

iot module module-id

(4)     开启物联网模块上报定位报文采样功能。

rfid-tracking iot sampling enable

缺省情况下，物联网模块上报定位报文采样功能处于关闭状态。

1.9  配置物联网模块的报文长度字段值

1. 功能简介

不同RFID物联网终端支持的报文长度可能不同，需要根据实际使用的终端的类型进行设置。

2. 配置限制和指导

仅在物联网模块类型为RFID时支持配置本功能。

3. 配置步骤

(1)     进入系统视图。

system-view

(2)     进入Module视图。

iot module module-id

(3)     配置物联网模块的报文长度字段值。

iot packet length-field { 8 | 6 }

缺省情况下，物联网模块的报文长度字段值为8比特。

1.10  配置进出校检测功能

1. 功能简介

在进出校检测场景下，在同一物联网网关下同时指定了校内和校外的物联网模块之后，物联网网关会自动开启进出校检测功能，根据手环的RSSI变化来判断手环的进出校，并生成进校或者出校信息，将消息报文发送到绿洲平台。

2. 配置步骤

(1)     进入系统视图。

system-view

(2)     配置物联网模块的位置。

iot location module module-id-list1&<1-6> inside module-id-list2&<1-6> outside

缺省情况下，未配置物联网模块的位置。

(3)     配置进出校检测功能的计算参数。

iot location rssi period period valid-rssi value diff-rssi value

1.11  配置BLE通告发送功能

1. 功能简介

若物联网网关上开启了BLE通告发送功能，则蓝牙类型的物联网模块工作时，将会定期广播iBeacon通告。iBeacon通告中携带的信息有UUID、Major ID、Minor ID和Measured power，接收到iBeacon通告的应用软件会根据通告信息采取特定的行动以实现相应的软件功能。

2. 配置步骤

(1)     进入系统视图。

system-view

(2)     进入Module视图。

iot module module-id

(3)     配置物联网网关支持BLE类型的物联网模块。

type ble

缺省情况下，未配置物联网模块类型。

(4)     开启BLE通告发送功能。

rfid-tracking ble advertisement enable

缺省情况下，BLE通告发送功能处于关闭状态。

(5)     配置BLE通告信息。

rfid-tracking ble advertisement { major-id major-id | measured-power measured-power | minor-id minor-id | uuid uuid }

缺省情况下，BLE通告的Major ID为1，Minor ID为1，UUID为E1CC5B618C06428E8720FE619DB80193，Measured power为-58dBm。

(6)     配置物联网模块发送BLE通告的时间间隔。

rfid-tracking ble advertisement interval interval

缺省情况下，物联网模块发送BLE通告的时间间隔为100厘秒。

1.12  配置通过物联网网关管理iBeacon设备

1. 功能简介

物联网网关收到iBeacon设备发送的报文后，会将iBeacon设备添加到BLE邻居列表，邻居列表记录着BLE邻居的UUID、Major ID、Minor ID、最近一次通告的Tx Power以及RSSI。物联网网关将邻居列表上报给物联网服务器后，物联网服务器才能对iBeacon设备进行管理。

如果物联网网关在老化时间内没有收到某个iBeacon设备发送的报文，则将该设备从邻居列表中删除，并向物联网服务器发送该设备的老化通知，物联网服务器收到通知后，会删除对该设备的记录，让用户及时发现电源耗尽或被移动的iBeacon设备。

2. 配置步骤

(1)     进入系统视图。

system-view

(2)     开启上报BLE邻居列表功能。

rfid-tracking ble report enable

缺省情况下，上报BLE邻居列表功能处于关闭状态。

(3)     （可选）开启上报支持非标准通告报文的BLE邻居信息功能。

rfid-tracking ble vendor-ibeacon report enable

缺省情况下，上报支持非标准通告报文的BLE邻居信息功能处于关闭状态。

(4)     （可选）配置上报邻居列表的时间间隔。

rfid-tracking ble report interval interval

缺省情况下，上报BLE邻居列表的时间间隔为900秒。

建议配置时间间隔不低于15秒，以免为物联网服务器增加负担。

(5)     （可选）配置BLE邻居的老化时间。

rfid-tracking ble aging-time aging-time

缺省情况下，BLE邻居的老化时间为180秒。

1.13  配置物联网模块上送报文的模式

1. 功能简介

物联网模块上送报文的模式分为解析模式和透传模式：

·     解析模式：物联网模块先对收到的报文进行解析、检查，再将报文上送给物联网AP。

·     透传模式：物联网模块不对收到的报文进行任何操作，直接上送给物联网AP。

2. 配置限制和指导

若用户需要部署第三方物联网服务器，且不允许物联网模块解析报文时，请配置为透传模式。

3. 配置步骤

(1)     进入系统视图。

system-view

(2)     进入Module视图。

iot module module-id

(3)     配置物联网模块上送报文的模式。

iot module report-mode { parse | transparent }

缺省情况下，物联网模块解析后上送报文。

1.14  配置物联网模块LED灯闪烁

1.14.1  功能简介

有线连接式的物联网模块在部署或使用过程中，可以通过配置来控制模块上LED灯的闪烁频率或开关状态，实现定位物联网模块位置等需求。

1.14.2  配置物联网模块上LED灯的闪烁模式

1. 功能简介

指定型号物联网网关下连的物联网模块上通常会有LED指示灯，normal模式下，不同阶段有不同的闪烁方式。如果LED的正常闪烁对用户产生了不必要的干扰，可通过本命令将其置为quiet模式。

2. 配置步骤

(1)     进入系统视图。

system-view

(2)     进入Module视图。

iot module module-id

(3)     配置物联网模块上LED灯的闪烁模式。

iot module led-mode { normal | quiet }

缺省情况下，物联网模块上所有LED灯处于正常闪烁模式。

1.14.3  配置物联网模块外壳上LED灯进行闪烁示意

1. 功能简介

若需要查看指定物联网AP的指定Module对应的实际物联网模块所在位置，可通过配置本命令使该物联网模块外壳上的所有LED灯进行持续20秒的闪烁，闪烁频率为每秒钟闪一次。

2. 配置步骤

(1)     进入系统视图。

system-view

(2)     配置物联网模块外壳上LED灯进行闪烁示意。

iot execute module led-flash module module-id

1.15  升级物联网模块版本

1.15.1  功能简介

物联网模块的版本升级分为手动方式和自动方式两种：

·     手动方式：手动执行物联网模块的版本升级操作，并指定物联网网关上存放模块版本文件的路径，用于模块升级。

·     自动方式：通过开启物联网模块版本自动升级功能，物联网网关会立即检查模块的软件版本与物联网网关版本文件中的模块软件版本是否一致，如果不一致，则将模块的软件版本升级为物联网网关版本文件中的软件版本。物联网模块版本自动升级功能处于开启状态下，物联网网关每次重启后都会执行上述模块版本升级操作。

1.15.2  配置限制和指导

如果希望物联网模块使用的软件版本与物联网网关版本文件中的模块版本一致，可以使用自动方式对模块进行升级。否则，请通过手动方式升级模块版本。

通过手动方式升级物联网模块版本时，请将模块升级要使用的版本文件放至物联网网关的本地文件夹下，并确认物联网模块版本自动升级功能处于关闭状态，否则当物联网网关重启后，会将模块的版本升级为物联网网关版本文件中的物联网模块版本。

1.15.3  配置物联网模块版本自动升级功能

(1)     进入系统视图。

system-view

(2)     进入Module视图。

iot module module-id

(3)     关闭物联网模块版本自动升级功能。

module firmware-upgrade disable

缺省情况下，物联网模块版本自动升级功能处于开启状态。

1.15.4  手动升级物联网模块版本

(1)     进入系统视图。

system-view

(2)     手动升级物联网模块版本。

iot execute module firmware-upgr module module-id firmware-path filepath

1.16  重启物联网模块

(1)     进入系统视图。

system-view

(2)     重启物联网模块。

iot execute module reset module module-id

1.17  配置物联网模块恢复出厂配置

1. 功能简介

如需清除物联网模块上所有已有的配置，可配置本命令，恢复该物联网模块各参数的出厂配置。

此操作执行后，模块会立即重启，并恢复到出厂配置。

2. 配置步骤

(1)     进入系统视图。

system-view

(2)     配置物联网模块恢复出厂配置。

iot execute module restore-factory module module-id

1.18  物联网网关显示和维护

在完成上述配置后，在任意视图下执行display命令可以显示配置后的运行情况，通过查看显示信息验证配置的效果。