13-Internet of Things Configuration Guide

HomeSupportResource CenterH3C FAT AP Configuration Guide(R5436)-6W10113-Internet of Things Configuration Guide
01-IoT gateway configuration
Title Size Download
01-IoT gateway configuration 128.18 KB

Configuring IoT gateways

About IoT gateways

An Internet of Things (IoT) gateway manages IoT modules and communicates with an IoT server on behalf of the modules. The modules connect things to the Internet for intelligent identification, locating, tracking, monitoring, and management of the things. The Oasis platform acts as the IoT server to perform data analysis and computation based on the packets from the IoT modules and provide IoT application information to users.

IoT gateway application scenarios

You can deploy IoT gateways in different fields of the IoT by connecting them to different IoT modules.

RFID modules

IoT gateways can be used together with Radio Frequency Identification (RFID) modules in medical scenarios. For example, an IoT gateway can provide the following medical services through identifying RFID devices:

·     Infant protection through identifying mother and infant tags.

·     Patients' body temperature monitoring through identifying temperature tags.

BLE modules

IoT gateways connecting to Bluetooth Low Energy (BLE) devices can manage iBeacon devices or act as iBeacon devices. The iBeacon technology developed by Apple enables an iBeacon device to broadcast a unique identifier to nearby application software. After receiving the identifier, the application software takes actions according to the identifier to fulfill software functions.

Zigbee modules

IoT gateways connecting to Zigbee devices can be deployed in smart home or environment monitoring scenarios. A Zigbee network includes the following components:

·     Coordinator—IoT modules installed with Zigbee cards, responsible for PAN formation and communication in the network.

·     Zigbee router—Forwards information between devices.

·     Standard Zigbee device—Collects and uploads data.

 

 

Restrictions: Hardware compatibility with IoT gateway

Hardware series

Model

IoT gateway compatibility

WA6600 series

WA6628E-T

No

WA5600 series

WA5630X

WA5620E-T

Yes: WA5630X

No: WA5620E-T

WA5500 series

WA5530

WA5530i

WA5530X

WA5530S

WA5530-SI

WA5530-LI

WX2540H-F

WA5510E-T

Yes:

·     WA5530i

·     WA5530X

·     WA5530-SI

·     WA5530-LI

No:

·     WA5530

·     WA5530S

·     WA5510E-T

WA5300 series

WA5320i

WA5320i-LI

WA5320X

WA5320X-LI

WA5320X-E

WA5320X-SI

WA5340

Yes:

·     WA5320i

·     WA5320i-LI

·     WA5320X

·     WA5320X-LI

·     WA5320X-SI

·     WA5340

No: WA5320X-E

UAP300 series

UAP300

Yes

WAP723 series

WAP723-W2

Yes

WAP722 series

WAP722X-W2

WAP722XS-W2

Yes

Hardware series

Model

IoT gateway compatibility

WA530 series

WA538

WA536

WA5330

WA530X

No:

·     WA538

·     WA536

·     WA530X

Yes: WA5330

 

 

 

IoT gateway tasks at a glance

To configure an IoT gateway, perform the following tasks:

1.     Configuring basic features for IoT modules

¡     Configuring auto module and auto module conversion

¡     Specifying a serial number for a module

¡     Specifying the supported module type

¡     Enabling a module

¡     Specifying an IoT server

¡     (Optional.) Setting the transmit power level for a module

¡     (Optional.) Configuring a module description

2.     (Optional.) Managing and maintaining IoT modules:

¡     Configuring IoT location

¡     Setting an RSSI threshold to filter IoT location packets

¡     Enabling the keepalive feature

¡     Configuring location packet sampling

¡     Setting the value for the length field of IoT packets

¡     Configuring bracelet location

¡     Configuring iBeacon advertisement for a BLE module

¡     Configuring BLE neighbor reporting

¡     Specifying the report mode for packets sent to an IoT gateway

¡     Configuring LED lighting

¡     Upgrading the firmware of a module

¡     Restarting a module

¡     Restoring the factory settings for a module

Configuring basic features for IoT modules

Configuring auto module and auto module conversion

About this task

The auto module feature enables modules to connect to an IoT gateway without manual module configuration. This feature simplifies configuration when you deploy a large number of modules.

To configure an auto module, you must convert the auto module to a manual module.

When auto module conversion is enabled, subsequent auto modules will automatically convert to manual modules upon coming online and each converted module will be assigned a serial number. The existing online auto modules will not be affected.

Restrictions and guidelines

Auto module and auto module conversion take effect only when IoT modules connect to an IoT gateway through network cables.

Procedure

1.     Enter system view.

system-view

2.     Enable the auto module feature.

iot auto-module enable

By default, the auto module feature is disabled.

3.     (Optional.) Enable auto module conversion.

iot auto-module persistent enable

By default, the auto module conversion feature is disabled.

4.     (Optional.) Convert all online auto modules to manual modules.

iot auto-module persistent all

Specifying a serial number for a module

About this task

You must specify a serial number for a module on an IoT AP when the module connects to the IoT AP through a network cable. The module can come online on the AP only when the specified serial number is the same as the actual serial number of the module. A module installed on an IoT AP can come online directly no matter whether the configured serial number is the same as the module's serial number or not.

Restrictions and guidelines

Deleting the serial number or specifying a different serial number than the actual serial number of an online module logs off the module if the module connects to an IoT AP through network cables.

Procedure

1.     Enter system view.

system-view

2.     Enter module view.

iot module module-id

3.     Specify a serial number for the module.

serial-number serial-number

By default, no serial number is specified for a module.

Specifying the supported module type

About this task

For a module to operate correctly, make sure the supported module type is the same as the physical module type of the module.

Procedure

1.     Enter system view.

system-view

2.     Enter module view.

iot module module-id

3.     Specify the supported module type.

type { ble | rfid | uwb }

By default, no supported module type is specified.

Enabling a module

1.     Enter system view.

system-view

2.     Enter module view.

iot module module-id

3.     Enable the module.

module enable

By default, a module is disabled.

Specifying an IoT server

About this task

Perform this task to specify an IoT server by its IP address or domain name.

Restrictions and guidelines

The IoT server specified by domain name takes precedence over the IoT server specified by IP address. After you specify an IoT server by its domain name, the specified IoT server's IP address settings will be cleared.

Procedure

1.     Enter system view.

system-view

2.     Specify an IoT server.

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

By default, no IoT server is specified.

Setting the transmit power level for a module

About this task

You can set the transmit power for a module to the following levels:

·     Level 1 (4 dBm).

·     Level 2 (–1 dBm).

·     Level 3 (–5 dBm).

·     Level 4 (–9 dBm).

Procedure

1.     Enter system view.

system-view

2.     Enter module view.

iot module module-id

3.     Set the transmit power level for the module.

tx-power power

By default, the transmit power level is 1, which indicates a transmit power of 4 dBm.

Configuring a module description

About this task

Perform this task configure a description for a module based on its location and function.

Procedure

1.     Enter system view.

system-view

2.     Enter module view.

iot module module-id

3.     Configure a description for the module.

description text

By default, a module does not have a description.

Configuring IoT location

About this task

To configure RFID or BLE location, you must enable IoT location.

After IoT location is enabled, the IoT gateway identifies all packets from IoT terminals through the IoT modules and forwards the packets to the IoT server for processing.

Procedure

1.     Enter system view.

system-view

2.     Enable IoT location.

rfid-tracking iot enable

By default, IoT location is disabled.

Setting an RSSI threshold to filter IoT location packets

About this task

After you configure this feature, IoT location packets with an RSSI lower than the specified RSSI threshold are ignored to improve processing efficiency.

Procedure

1.     Enter system view.

system-view

2.     Enter module view.

iot module module-id

3.     Set an RSSI threshold to filter IoT location packets.

rfid-tracking iot rssi threshold rssi-threshold

By default, no RSSI threshold is set to filter IoT location packets.

Enabling the keepalive feature

About this task

After you enable this feature, an IoT gateway sends a hello packet to the IoT server every 15 seconds. If the IoT server does not receive any packets from an IoT gateway within 30 seconds, the IoT server determines that the IoT gateway has gone offline.

Restrictions and guidelines

As a best practice to save the bandwidth, disable this feature if the IoT server cannot process hello packets.

Procedure

1.     Enter system view.

system-view

2.     Enable the keepalive feature.

rfid-tracking keepalive enable

By default, the keepalive feature is disabled.

Configuring location packet sampling

About this task

This feature prevents location packets sent by IoT terminals whose location does not change or changes very little within a long period from affecting the overall performance of the IoT gateway. With this feature enabled, an IoT module sends only the sampled packets to the IoT gateway within each sampling interval.

Restrictions and guidelines

Only RFID modules support this feature.

Procedure

1.     Enter system view.

system-view

2.     Set the location packet sampling interval.

rfid-tracking iot sampling interval interval

By default, the location packet sampling interval is 10 seconds.

3.     Enter module view.

iot module module-id

4.     Enable location packet sampling.

rfid-tracking iot sampling enable

By default, location packet sampling is disabled.

Setting the value for the length field of IoT packets

About this task

The supported IoT packet length varies by IoT terminal models. Set the value of the length field as required by your IoT terminal model.

Restrictions and guidelines

Only RFID modules support this feature.

Procedure

1.     Enter system view.

system-view

2.     Enter module view.

iot module module-id

3.     Set the value for the length field of IoT packets.

iot packet length-field { 8 | 6 }

By default, the value for the length field of IoT packets is 8 bits.

Configuring bracelet location

1.     Enter system view.

system-view

2.     Specify inside-campus IoT modules and outside-campus IoT modules.

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

By default, no inside-campus or outside-campus IoT modules are specified.

3.     Set RSSI parameters for bracelet location.

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

Configuring iBeacon advertisement for a BLE module

About this task

This feature enables a BLE module to periodically broadcast iBeacon advertisements. An iBeacon advertisement contains a UUID, a Major ID, a Minor ID, and measured power. Application software that receives the iBeacon advertisement will take specific actions according to the advertisement information to fulfill software functions.

Procedure

1.     Enter system view.

system-view

2.     Enter module view.

iot module module-id

3.     Specify BLE as the supported module type.

type ble

By default, no supported module type is specified.

4.     Enable iBeacon advertisement for the BLE module.

rfid-tracking ble advertisement enable

By default, iBeacon advertisement is disabled for a BLE module.

5.     Configure the advertisement information.

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

By default, the UUID is E1CC5B618C06428E8720FE619DB80193, Major ID is 1, Minor ID is 1, and measured power is –58 dBm in an iBeacon advertisement.

6.     Set the interval for the BLE module to broadcast iBeacon advertisements.

rfid-tracking ble advertisement interval interval

By default, a BLE module broadcasts iBeacon advertisements every 100 centiseconds.

Configuring BLE neighbor reporting

About this task

After the IoT gateway receives packets from a BLE device, it adds the BLE device to the BLE neighbor list, which records the UUID, major ID, minor ID, most recent Tx power, and most recent RSSI of each BLE neighbor. The IoT gateway reports the BLE neighbor information to the IoT server for management at the specified interval.

If the IoT gateway does not receive any packets from a BLE neighbor within the aging time, it removes the BLE device from the BLE neighbor list and reports the removal event to the IoT server. After receiving the removal event, the IoT server deletes the BLE device entry.

Procedure

1.     Enter system view.

system-view

2.     Enabling BLE neighbor information reporting.

rfid-tracking ble report enable

By default, BLE neighbor information reporting is disabled.

3.     (Optional.) Enable the reporting of BLE neighbors sending non-standard advertisements to the server.

rfid-tracking ble vendor-ibeacon report enable

By default, the reporting of BLE neighbors sending non-standard advertisements to the server is disabled.

4.     (Optional.) Set the interval for sending BLE neighbor list reports.

rfid-tracking ble report interval interval

By default, the interval for sending BLE neighbor list reports is 900 seconds.

As a best practice, set an interval equivalent to or greater than 15 seconds.

5.     (Optional.) Set the BLE neighbor aging time.

rfid-tracking ble aging-time aging-time

By default, the BLE neighbor aging time is 180 seconds.

Specifying the report mode for packets sent to an IoT gateway

About this task

A module can use the following modes to send packets to the connected IoT gateway:

·     Parse mode—Parses and examines received packets before sending them to the IoT AP.

·     Transparent mode—Directly sends received packets to the IoT AP without any extra operations.

Restrictions and guidelines

Configure modules to use transparent mode if a third-party IoT server is deployed and modules are not allowed to parse received packets.

Procedure

1.     Enter system view.

system-view

2.     Enter module view.

iot module module-id

3.     Specify the report mode for packets sent to the connected IoT gateway.

iot module report-mode { parse | transparent }

By default, a module uses parse mode to send packets to the connected IoT gateway.

Configuring LED lighting

About LED lighting

This feature helps locate a module connected to an IoT gateway through a cable by controlling the flash rate or lighting mode of the LEDs on the module.

Setting a LED lighting mode for a module

About this task

If you do not want the LEDs to flash, set the LED lighting mode of the module to quiet.

Procedure

1.     Enter system view.

system-view

2.     Enter module view.

iot module module-id

3.     Set a LED lighting mode.

iot module led-mode { normal | quiet }

By default, the LED lighting mode of a module is normal.

Triggering regular LED flashing for a module

About this task

To locate a module connected to an IoT gateway, perform this task to trigger all LEDs on the module to flash 20 seconds at a rate of one flash per second.

Procedure

1.     Enter system view.

system-view

2.     Trigger regular LED flashing for a module.

iot execute module led-flash module module-id

Upgrading the firmware of a module

About module firmware upgrade

You can use the following methods to upgrade the firmware of a module:

·     Manual upgrade—Use the specified image file to manually upgrade the module's firmware.

·     Automatic upgrade—Configure the automatic firmware upgrade feature to enable the module to immediately upgrade its firmware if its firmware version is different from the version stored in the IoT gateway's image file. After you enable this feature for a module, this feature takes effect every time the IoT gateway where the module is installed restarts.

Restrictions and guidelines

If you want the module's firmware version to be consistent with the version stored in the IoT gateway's image file, use automatic upgrade. In other cases, use manual upgrade.

When you perform a manual upgrade, follow these restrictions and guidelines:

·     Save the module's image file to the IoT gateway's local folder.

·     Make sure the automatic firmware upgrade feature is disabled for the module. The automatic firmware upgrade feature upgrades the module's firmware to the version stored in IoT gateway' image file every time the IoT gateway where the module is installed restarts.

Configuring automatic firmware upgrade for a module

1.     Enter system view.

system-view

2.     Enter module view.

iot module module-id

3.     Disable automatic firmware upgrade for the module.

module firmware-upgrade disable

By default, automatic module firmware upgrade is enabled for a module.

Manually upgrading the firmware of a module

1.     Enter system view.

system-view

2.     Manually upgrade the firmware of a module.

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

Restarting a module

1.     Enter system view.

system-view

2.     Restart a module.

iot execute module reset module module-id

Restoring the factory settings for a module

About this task

This feature clears the settings of a module and restarts the module with factory settings.

Procedure

1.     Enter system view.

system-view

2.     Restore the factory settings for a module.

iot execute module restore-factory module module-id

Display and maintenance commands for IoT gateways

Execute display commands in any view.

 

Task

Command

Display the running configuration of the IoT module manager.

display iot mmgr running-configuration

Display information about all IoT modules.

display iot module all

Display IoT module information.

display iot module information { all | module module-id }

Display the firmware upgrade history information about an IoT module.

display iot module firmware-upgrade history { all | module module-id }