- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
01-IoT gateway configuration | 128.18 KB |
IoT gateway application scenarios
Restrictions: Hardware compatibility with IoT gateway
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
Setting the transmit power level for a module
Configuring a module description
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 iBeacon advertisement for a BLE module
Configuring BLE neighbor reporting
Specifying the report mode for packets sent to an IoT gateway
Setting a LED lighting mode for a module
Triggering regular LED flashing for a module
Upgrading the firmware of a module
Configuring automatic firmware upgrade for a module
Manually upgrading the firmware of a module
Restoring the factory settings for a module
Display and maintenance commands for IoT gateways
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
¡ (Optional.) Setting the transmit power level for a module
¡ (Optional.) Configuring a module description
2. (Optional.) Managing and maintaining IoT modules:
¡ 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
¡ Upgrading the firmware of 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
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 } |