21-Internet of Things Command Reference

HomeSupportReference GuidesCommand ReferencesH3C Access Controllers Command References(R5447P04)-6W10021-Internet of Things Command Reference
01-IoT AP commands
Title Size Download
01-IoT AP commands 230.68 KB

IoT AP commands

Support for IoT capability depends on the AP model.

can speed

Use can speed to set the CAN link rate for an IoT module.

Use undo can speed to restore the default.

Syntax

can speed { 500 | 1000 }

undo can speed

Default

The CAN link rate is 500 kbps.

Views

Module view

Predefined user roles

network-admin

Parameters

500: Sets the CAN link rate to 500 kbps.

1000: Sets the CAN link rate to 1000 kbps.

Usage guidelines

In a network where an AP is connected to IoT modules through wired links, the IoT module directly connected to the AP is the primary node, and all the IoT modules connected to the primary node (both directly and indirectly) are secondary nodes. The primary node communicates with the secondary nodes through a Controller Area Network (CAN) link. You can execute this command to set the data transmission rate for the CAN link.

As a best practice, use the default CAN link rate, and do not improve the CAN link rate unless necessary.

The length of the CAN link cannot exceed 40 meters when the CAN link operates at 1000 kbps.

Only the primary node supports this command. The secondary nodes can automatically adapt to the CAN link rate configured on the primary node.

Examples

# Set the CAN link rate to 1000 kbps for module 1 connected to AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model uap300

[Sysname-ap-ap1] module 1

[Sysname-ap-ap1-module-1] can speed 1000

Related commands

display wlan module-information

description

Use description to configure a description for a module.

Use undo description to restore the default.

Syntax

description text

undo description

Default

A module does not have a description.

Views

Module view

Predefined user roles

network-admin

Parameters

text: Specifies a description, a case-sensitive string of 1 to 64 characters.

Usage guidelines

To manage modules installed on or connected to an IoT AP efficiently, configure descriptions for them based on their models, locations, and functions.

Examples

# Configure a description for module 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-X-R

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] description L3-office

display iot module

Use display iot module to display information about IoT APs that have IoT interfaces and the connected modules.

Syntax

display iot module { all | name ap-name }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all IoT APs that have IoT interfaces.

name ap-name: Specifies the name of an IoT AP that has IoT interfaces. The ap-name argument is a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Examples

# Display information about all IoT APs that have IoT interfaces and the connected modules.

<System> display iot module all

AP name          : ap1

AP model         : UAP300

Serial ID        : 219801A0TA9154G01020

MAC address      : 00f0-e212-00f1

Modules          : 6

 Port ID: 3

  ------------------------------------------------------------------------------

  ModuleID   Model     SerialNumber          H/W Ver  S/W Ver  LastRebootReason

  ------------------------------------------------------------------------------

  2          T300M-X   T3001234567898765431  Ver.A    E1102    Other

  3          T300-X    T3001234567898765432  Ver.A    E1102    Power on

  4          T300-X    T3001234567898765433  Ver.A    E1102    Other

 Port ID: 4

  ------------------------------------------------------------------------------

  ModuleID   Model     SerialNumber          H/W Ver  S/W Ver  LastRebootReason

  ------------------------------------------------------------------------------

  5          T300M-X   T3001234567898766541  Ver.A    E1102    Other

  6          T300-X    T3001234567898762584  Ver.A    E1102    Other

  7          T300-X    T3001234567898769654  Ver.A    E1102    Power on

 

AP name          : ap2

AP model         : UAP300

Serial ID        : 219801A0TA9154G01131

MAC address      : 00f1-e242-00f1

Modules          : 3

 Port ID: 3

  ------------------------------------------------------------------------------

  ModuleID   Model     SerialNumber          H/W Ver   S/W Ver  LastRebootReason

  ------------------------------------------------------------------------------

  2          T300M-X   T3001234567898765435  Ver.A     E1102    Power on

  3          T300-X    T3001234567898765432  Ver.A     E1102    Power on

  6          T300-X    T3001234567898765434  Ver.A     E1102    Power on

Table 1 Command output

Field

Description

Serial ID

Serial ID of the AP.

MAC address

MAC address of the AP.

Modules

Number of modules that are connected to the AP.

Port ID

ID of the port that connects the module to the AP.

ModuleID

ID of the module.

Model

Module model.

SerialNumber

Serial number of the module.

H/W Ver

Hardware version of the module.

S/W Ver

Software version of the module.

LastRebootReason

Last reboot reason for the module:

·     Power on—Power cycle.

·     Soft reset—Soft reboot.

·     WDG—Watchdog reboot.

·     CAN_TASK_FAIL—Failed to create a CAN task.

·     UART_TASK_FAIL—Failed to create a UART task.

·     DEV_TASK_FAIL—Failed to create a DEV task.

·     EMAC_TASK_FAIL—Failed to create an EMAC task.

·     RIPC—RIPC connection timer timed out.

·     Rate—Self adjustment of CAN rate failed.

·     Scheduler—Task scheduling failed.

·     Reserved—Reserved.

·     Hard fault—CPU hardware fault.

·     MPU fault—CPU storage management fault.

·     Bus fault—CPU bus fault.

·     Usage fault—CPU use fault.

·     Other—Reserved.

display wlan module firmware-upgrade history

Use display wlan module firmware-upgrade history to display firmware upgrade information for modules.

Syntax

display wlan module firmware-upgrade history { all | ap ap-name module module-id }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all modules.

ap ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

module-id: Specifies a module by its ID. The value range varies by AP model.

Usage guidelines

This command displays history records about manual firmware upgrade for a module on an AP from the time that the AP starts. To display the module firmware version after manual or automatic upgrade, use the display wlan module-information command.

Examples

# Display firmware upgrade information for all modules.

<Sysname> display wlan module firmware-upgrade history all

Total number of APs: 3

--------------------------------------------------------------------------------

AP name  Module ID  Last upgrade time         Upgrade status  SW Version

--------------------------------------------------------------------------------

ap1      1          Mon Nov  2 13:54:23 2015  Success         12-09-02-22

ap1      2          Mon Nov  2 13:54:23 2015  Upgrading       12-09-02-22

ap2      1          N/A                        N/A             12-09-02-22

ap3      1          Mon Nov  2 13:54:23 2015  Failed              12-09-02-22

Table 2 Command output

Field

Description

Upgrade status

Upgrade status:

·     Succeeded.

·     Failed.

·     Upgrading.

This field displays N/A if the module has not been updated.

SW version

Module software version.

Related commands

display wlan module-information

display wlan module-information

Use display wlan module-information to display module information for an AP.

Syntax

display wlan module-information { all | ap ap-name module { all | module-id } } [ online ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all APs.

ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

module all: Specifies all modules.

module module-id: Specifies a module by its ID. The value range for the module-id argument varies by AP model.

online: Displays information about online modules.

Examples

# Display information about module 1 on AP ap1.

<Sysname> display wlan module-information ap ap1 module 1

Module administrative type     : RFID

Module physical type           : IOT

Model                          : EW100-R

HW version                     : Ver.A

SW version                     : A1101

Serial ID                      : 219801A19C816CE00020

Module MAC                     : d461-fefc-ff70

Module physical status         : Normal

Module administrative status   : Enabled

Description                    : Not configured

CAN speed                      : 500 kbps

UART baudrate                  : Auto

Table 3 Command output

Field

Description

Module administrative type

Configured module type:

·     NotConfig.

·     BLE.

·     RFID.

·     ZIGBEE.

Module physical type

Physical type of the module:

·     H3C.

·     IOT.

This field displays N/A if no physical type information is available.

Model

Module model.

This field displays N/A if no module model information is available.

HW version

Module hardware version.

SW version

Module software version.

Serial ID

Module serial ID.

Module MAC

MAC address of the module.

Module physical status

Physical status of the module:

·     Unavailable.

·     Normal.

·     Absent.

Module administrative status

Configured module status:

·     Enabled.

·     Disabled.

Description

Description about the IoT module.

CAN speed

CAN link rate of the IoT module, in kbps. Options include the following:

·     500 kbps.

·     1000 kbps.

This field is displayed only for primary nodes.

UART baudrate

UART baud rate of the IoT module, in B (baud). Options include the following:

·     Auto—Auto-adaptive baud rate.

·     115200 B(auto)—Automatically adapted as 115200 B.

·     921600 B(auto)—Automatically adapted as 921600 B.

·     115200 B—Fixed at 115200 B.

·     921600 B—Fixed at 921600 B.

This field is displayed only for IoT modules connected to IoT APs.

iot auto-module

Use iot auto-module enable to enable the auto module feature.

Use iot auto-module disable to disable the auto module feature.

Use undo iot auto-module enable to restore the default.

Syntax

iot auto-module { disable | enable }

undo iot auto-module

Default

In AP view, an AP uses the configuration in AP group view.

In AP group view, the auto module feature is disabled.

Views

AP view

AP group view

Predefined user roles

network-admin

Usage guidelines

This command enables a module to associate with an AP without manual module configuration.

This command takes effect only when IoT modules connect to the IoT AP through network cables.

The configuration in AP view takes precedence over the configuration in AP group view.

Examples

# Enable the auto module feature for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model uap300

[Sysname-wlan-ap-ap1] iot auto-module enable

# Enable the auto module feature for all APs in AP group 10.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-wlan-ap-group-10] iot auto-module enable

Related commands

display wlan module-information

iot auto-module persistent

Use iot auto-module persistent enable to enable auto module conversion.

Use iot auto-module persistent disable to disable auto module conversion.

Use undo iot auto-module persistent enable to restore the default.

Syntax

iot auto-module persistent { disable | enable }

undo iot auto-module persistent

Default

In AP view, an AP uses the configuration in AP group view.

In AP group view, auto module conversion is disabled.

Views

AP view

AP group view

Predefined user roles

network-admin

Usage guidelines

The auto module conversion feature converts auto modules to manual modules automatically after auto modules come online. It takes effect only on auto modules that come online after you enable this feature. After the conversion, the system will also automatically assign a serial number to each converted module.

To configure an auto module, you must convert the auto module to a manual module. To convert online auto modules, use the iot auto-module persistent all command.

This command takes effect only when IoT modules connect to the IoT AP through network cables.

The configuration in AP view takes precedence over the configuration in AP group view.

Examples

# Enable auto module conversion for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model uap300

[Sysname-wlan-ap-ap1] iot auto-module persistent enable

# Enable auto module conversion for all APs in AP group 10.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-wlan-ap-group-10] iot auto-module persistent enable

iot auto-module persistent all

Use iot auto-module persistent all to convert all online auto modules to manual modules.

Syntax

iot auto-module persistent all

Views

AP view

AP group view

Predefined user roles

network-admin

Usage guidelines

This command converts all online auto modules to manual modules and automatically assigns a serial number to each converted module.

This command takes effect only when IoT modules connect to the IoT AP through network cables.

The configuration in AP view takes precedence over the configuration in AP group view.

Examples

# Convert all online auto modules to manual modules for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model uap300

[Sysname-wlan-ap-ap1] iot auto-module persistent all

# Convert all online auto modules to manual modules for all APs in AP group 10.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-wlan-ap-group-10] iot auto-module persistent all

Related commands

display wlan module-information

serial-number

iot connect-aliyun

Use iot connect-aliyun to connect an AP to Alibaba Cloud IoT Platform.

Use undo iot connect-aliyun to restore the default.

Syntax

iot connect-aliyun productkey key productsecret secret

undo iot connect-aliyun

Default

In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

In AP group view, an AP uses the configuration in global configuration view.

In global configuration view, an AP is not connected to Alibaba Cloud IoT Platform.

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

Parameters

productkey key: Specifies the product identifier issued by Alibaba Cloud IoT Platform. The identifier is a case-sensitive string of 1 to 20 characters.

productsecret secret: Specifies the product key issued by Alibaba Cloud IoT Platform. The key is a case-sensitive string of 1 to 64 characters.

Usage guidelines

After you execute this command on an AP, the AP sends a connection request to Alibaba Cloud IoT Platform. Alibaba Cloud IoT Platform authenticates the AP by using the product identifier and product key. If the AP passes the authentication, it connects to Alibaba Cloud IoT Platform successfully.

When an AP connects to Alibaba Cloud IoT Platform for the first time, Alibaba Cloud IoT Platform issues a device key to the AP.

Examples

# In AP view, connect UAP300 to Alibaba Cloud IoT Platform.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-ap-ap1] iot connect-aliyun productkey a1LybAwXSUL productsecret HG4I1BHKS0Rd4eR

# In AP group view, connect UAP300 to Alibaba Cloud IoT Platform.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-ap-group10] iot connect-aliyun productkey a1LybAwXSUL productsecret HG4I1BHKS0Rd4eR

# In global configuration view, connect UAP300 to Alibaba Cloud IoT Platform.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration] iot connect-aliyun productkey a1LybAwXSUL productsecret HG4I1BHKS0Rd4eR

iot engine port-redistribute

Use iot engine port-redistribute enable to enable port reassignment.

Use iot engine port-redistribute disable to disable port reassignment.

Use undo iot engine port-redistribute to restore the default.

Syntax

iot engine port-redistribute { disable | enable }

undo iot engine port-redistribute

Default

In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

In AP group view, an AP uses the configuration in global configuration view.

In global configuration view, port reassignment is disabled.

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

Usage guidelines

This command enables an IoT AP to periodically send port reassignment requests to the IoT server to obtain a new port until a response is received.

This command is required when the IoT server requires its connected IoT APs to use new ports for packet exchange.

If a new port becomes invalid for a specific reason, such as powerdown or reboot of the IoT server or IoT AP, disable this feature first and then enable this feature to obtain another port.

For an AP, the settings made in AP view, AP group view, and global configuration view take effect in descending order.

Examples

# Enable port reassignment for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] iot engine port-redistribute enable

# Enable port reassignment for APs in AP group 10.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-wlan-ap-group-10] iot engine port-redistribute enable

# Enable port reassignment globally.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration] iot engine port-redistribute enable

Related commands

iot engine-address

iot engine-address

Use iot engine-address to specify an IoT server.

Use undo iot engine-address to restore the default.

Syntax

iot engine-address engine-address engine-port engine-port

undo iot engine-address

Default

In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

In AP group view, an AP uses the configuration in global configuration view.

In global configuration view, no IoT server is specified.

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

Parameters

engine-address: Specifies the IPv4 address of an IoT server.

engine-port: Specifies the port number of an IoT server. The value range is 1 to 65535.

Usage guidelines

Configure this command for the modules on an IoT AP to communicate with an IoT server.

This command is required only for IoT modules. To specify an IoT server for BLE modules, use the rfid-tracking ble engine-address engine-port command. For more information, see wireless locating commands in WLAN Advanced Features Command Reference.

For an AP, the settings made in AP view, AP group view, and global configuration view take effect in descending order.

Examples

# Specify the IoT server with IPv4 address 192.168.10.10 and port number 3000 for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-X-R

[Sysname-ap-ap1] iot engine-address 192.168.10.10 engine-port 3000

# Specify the IoT server with IPv4 address 192.168.10.10 and port number 3000 for all APs in AP group 10.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-ap-group10] iot engine-address 192.168.10.10 engine-port 3000

# Specify the IoT server with IPv4 address 192.168.10.10 and port number 3000 globally.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration] iot engine-address 192.168.10.10 engine-port 3000

iot location module

Use iot location module to specify inside-campus IoT modules and outside-campus IoT modules.

Use undo iot location module to restore the default.

Syntax

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

undo iot location module

Default

No inside-campus or outside-campus IoT modules are specified.

Views

AP view

Predefined user roles

network-admin

Parameters

module-id-list1&<1-2>: Specifies a maximum of two modules by module ID. The value range for a module ID varies by device model.

inside: Configures modules specified by the module-id-list1&<1-2> argument as inside-campus IoT modules.

module-id-list2&<1-2>: Specifies a maximum of two modules by module ID. The value range for a module ID varies by device model.

outside: Configures modules specified by the module-id-list2&<1-2> argument as outside-campus IoT modules.

Usage guidelines

To enable an IoT AP to detect whether a bracelet is inside or outside the campus, perform the following tasks:

·     Enable IoT location on the IoT AP.

·     Specify inside-campus IoT modules and outside-campus IoT modules for the IoT AP.

Examples

# Configure IoT modules 1 and 2 as inside-campus modules and IoT modules 4 and 5 as outside-campus modules.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] iot location module 1 2 inside 4 5 outside

Related commands

iot location rssi

rfid-tracking iot

iot location rssi

Use iot location rssi to set RSSI parameters for location packet filtering.

Use undo iot location rssi to restore the default.

Syntax

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

undo iot location rssi

Default

The average RSSI calculation period is 6 seconds, the valid average RSSI threshold is 70, and the difference threshold is 5.

Views

AP view

Predefined user roles

network-admin

Parameters

period period: Specifies the average RSSI calculation period in the range of 2 to 30 seconds. The average RSSI calculation period must be a multiple of 2.

valid-rssi value: Specifies the valid average RSSI threshold in the range of 1 to 100. A smaller value indicates a higher signal strength.

diff-rssi value: Specifies the difference threshold in the range of 1 to 100. The difference threshold refers to the threshold for the difference between the inside and outside average RSSIs.

Examples

# Set the average RSSI calculation period to 8 seconds, the valid average RSSI threshold to 75, and the difference threshold to 3.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] iot location rssi period 8 valid-rssi 75 diff-rssi 3

Related commands

iot location module

rfid-tracking iot

iot module led-mode

Use iot module led-mode to specify a LED lighting mode for a module.

Use undo iot module led-mode to restore the default.

Syntax

iot module led-mode { normal | quiet }

undo iot module led-mode

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, all LEDs of a module are in normal lighting mode.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Parameters

normal: Specifies the normal mode. In this mode, the LEDs flash regularly.

quiet: Specifies the quiet mode. In this mode, all LEDs are off.

Usage guidelines

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

Examples

# Specify the normal LED lighting mode for module 1 on AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] iot module led-mode normal

# Specify the quiet LED lighting mode for module 1 on APs with model UAP300 in AP group g1.

<Sysname> system-view

[Sysname] wlan ap-group g1

[Sysname-wlan-ap-group-g1] ap-model UAP300

[Sysname-wlan-ap-group-g1-ap-model-UAP300] module 1

[Sysname-wlan-ap-group-g1-ap-model-UAP300] iot module led-mode quiet

iot module report-mode

Use iot module report-mode to specify the report mode for packets sent to IoT APs.

Use undo iot module report-mode to restore the default.

Syntax

iot module report-mode { parse | transparent }

undo iot module report-mode

Default

A module uses parse mode to send packets to the connected IoT AP.

Views

Module view

Predefined user roles

network-admin

Parameters

parse: Specifies parse mode.

transparent: Specifies transparent mode.

Usage guidelines

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

·     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.

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

This command takes effect only on IoT APs without module slots.

Examples

# Configure module 1 to send packets to IoT AP ap1 by using parse mode.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] iot module report-mode parse

iot module-model engine-address

Use iot module-model engine-address to specify an IoT server by its IP address and port number for the specified type of IoT modules.

Use undo iot module-model engine-address to remove the IoT server IP address and port number configuration for the specified type of IoT modules.

Syntax

iot module-model { ew100-r | t100-a | t300bp0r | t300er0r | t300pb0u | t300rt0r | tp100-r} engine-address ip ipv4-address engine-port engine-port

iot module-model { t300-r| t300-z} engine-address { ip ipv4-address | ipv6 ipv6-address } engine-port engine-port

undo iot module-model { ew100-r | t100-a | t300-r| t300-z | t300bp0r | t300er0r | t300pb0u | t300rt0r | tp100-r} engine-address

Default

No IoT server is specified for IoT modules.

Views

AP view

AP group view.

Predefined user roles

network-admin

Parameters

ew100-r: Specifies the EW100-R IoT module.

t100-a: Specifies the T100-A IoT module.

t300bp0r: Specifies the T300BP0R IoT module.

t300er0r: Specifies the T300ER0R IoT module.

t300pb0u: Specifies the T300PB0U IoT module.

t300rt0r: Specifies the T300RT0R IoT module.

tp100-r: Specifies the T100-TP IoT module.

t300-r: Specifies the T300-R IoT module.

t300-z: Specifies the T300-Z IoT module.

ip ipv4-address: Specifies an IoT server by its IPv4 address.

ipv6 ipv6-address: Specifies an IoT server by its IPv6 address.

engine-port: Specifies the port number of the IoT server, in the range of 1 to 65535.

Usage guidelines

When an AP is installed with multiple types of IoT modules, execute this command to specify an IoT server for each type of IoT modules.

Examples

# In AP view, specify the IoT server with IP address 192.168.1.1 and port number 3155 for T300-R IoT modules.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-ap-ap1] iot module-model t300-r engine-address ip 192.168.1.1 engine-port 3155

# In AP group view, specify the IoT server with IP address 192.168.1.1 and port number 3155 for T300-R IoT modules.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-ap-group10]  iot module-model t300-r engine-address ip 192.168.1.1 engine-port 3155

iot module-model engine-domain

Use iot module-model engine-domain to specify an IoT server by its domain name and port number for the specified type of IoT modules.

Use undo iot module-model engine-domain to remove the IoT server domain name and port number configuration for the specified type of IoT modules.

Syntax

iot module-model { T300-R | T300-Z } engine-domain { ip | ipv6 } domain-name engine-port engine-port

undo iot module-model { T300-R | T300-Z } engine-domain

Default

No IoT server is specified for IoT modules.

Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

T300-R: Specifies the T300-R IoT module.

T300-Z: Specifies the T300-Z IoT module.

ip: Specifies an IoT server by its IPv4 domain name.

ipv6: Specifies an IoT server by its IPv6 domain name.

domain-name: Specifies an IoT server by its domain name, which is a string of 1 to 253 characters. Each two parts of the domain name are separated by a dot (.). Each part is a case-insensitive string of 1 to 63 characters, containing only letters, digits, hyphens (-), and underscores (_).

engine-port: Specifies the port number of the IoT server, in the range of 1 to 65535.

Examples

# In AP view, specify the IoT server with domain name 111 and port number 3155 for T300-R IoT modules.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-ap-ap1] iot module-model T300-R ip engine-domain 111 engine-port 3155

# In AP group view, specify the IoT server with domain name 111 and port number 3155 for T300-R IoT modules.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-ap-group10] iot module-model T300-R ip engine-domain 111 engine-port 3155

iot packet length-field

Use iot packet length-field to set the value for the length field of IoT packets.

Use undo iot packet length-field to restore the default.

Syntax

iot packet length-field { 8 | 6 }

undo iot packet length-field

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, the value for the length field of IoT packets is 8 bits.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Parameters

8: Sets the value for the length field of IoT packets to 8 bits.

6: Sets the value for the length field of IoT packets to 6 bits.

Usage guidelines

Set the value for the length field of IoT packets based on the endpoint type. The value for the length field of IoT packets is 6 bits for HIK endpoints and 8 bits for bracelets.

Only RFID modules support this command.

Examples

# Set the value for the length field of IoT packets to 6 bits for module 1 of AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] iot packet length-field 6

# Set the value for the length field of IoT packets to 6 bits for module 1 of APs with model UAP300 in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model UAP300

[Sysname-wlan-ap-group-1-ap-model-UAP300] module 1

[Sysname-wlan-ap-ap1-module-1] iot packet length-field 6

iot packet format

Use iot packet format to specify the packet format supported by an IoT module.

Use undo iot packet format to restore the default.

Syntax

iot packet format { h3c | hik | marktrace }

undo iot packet format

Default

An IoT module supports the H3C packet format.

Views

Module view

Predefined user roles

network-admin

Parameters

h3c: Specifies the H3C packet format.

hik: Specifies the Hikvision packet format.

marktrace : Specifies the Marktrace packet format.

Usage guidelines

Only RFID IoT modules support this command.

Examples

# Specify the packet format supported by IoT module 1 on AP 1 as Hikvision.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] iot packet format hik

iot report-format

Use iot report-format to specify the format for IoT packets reported to the server.

Use undo iot report-format to restore the default.

Syntax

iot report-format { general | transparent }

undo iot report-format

Default

In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

In AP group view, an AP uses the configuration in global configuration view.

In global configuration view, IoT packets are reported in transparent format.

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

Parameters

general: Specifies the general format, which indicates that the IoT packets contain IoT data, AP MAC address, and module ID.

transparent: Specifies the transparent format, which indicates that the IoT packets contain IoT data only.

Usage guidelines

Select a format based on the module type. For example, an AP uses general format to report ANT packets and transparent format to report Ewell packets.

For an AP, the settings made in AP view, AP group view, and global configuration view take effect in descending order.

Examples

# Configure AP ap1 to report IoT packets in general format.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-X-R

[Sysname-ap-ap1] iot report-format general

# Configure APs in AP group 10 to report IoT packets in general format.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-ap-group10] iot report-format general

# Configure all APs to report IoT packets in general format.

<Sysname> system-view

[Sysname]wlan global-configuration

[Sysname-wlan-global-configuration] iot report-format general

iot report-mode

Use iot report-mode to specify the report mode for packets sent to the IoT server or the cloud server.

Use undo iot report-mode to restore the default.

Syntax

iot report-mode { central | local }

undo iot report-mode

Default

In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

In AP group view, an AP uses the configuration in global configuration view.

In global configuration view, an IoT AP uses local mode to send IoT packets to the IoT server.

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

Parameters

central: Specifies centralized mode.

local: Specifies local mode.

Usage guidelines

In centralized mode, an IoT AP sends IoT packets to the AC first, and the AC forwards the IoT packets to the IoT server or the cloud server.

In local mode, an IoT AP directly sends IoT packets to the IoT server.

For an AP, the settings made in AP view, AP group view, and global configuration view take effect in descending order.

Examples

# Configure IoT AP ap1 to send IoT packets by using centralized mode.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-X-R

[Sysname-wlan-ap-ap1] iot report-mode central

# Configure IoT APs in AP group 10 to send IoT packets by using centralized mode.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-wlan-ap-group10] iot report-mode central

# Globally configure IoT APs to send IoT packets by using centralized mode.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration] iot report-mode central

iot report-version

Use iot report-version to report endpoint version information to the cloud platform.

Syntax

iot report-version rx-module rx-module-id tx-module tx-module-id endpoint-type { smart-card | tag | watch | wristband }

Views

AP view

Predefined user roles

network-admin

Parameters

rx-module rx-module-id: Specifies the IoT module that receives keepalive packets sent by endpoints. The rx-module-id argument specifies the module by its ID, and its value range varies by AP model.

tx-module tx-module-id: Specifies the IoT module that issues the endpoint version reporting instruction to endpoints. The tx-module-ID argument specifies the module by its ID, and its value range varies by AP model.

endpoint-type: Specifies an endpoint type.

smart-card: Specifies the endpoint type as smart card.

tag: Specifies the endpoint type as tag.

watch: Specifies the endpoint type as watch.

wristband: Specifies the endpoint type as bracelet.

Usage guidelines

Because IoT modules operate in simplex mode, you must specify an RFID module for packet receiving and another RFID module for packet transmission. The signal coverage areas of the two RFID modules must overlap. When the packet receiving module receives a keepalive packet from an endpoint, the packet transmission module broadcasts the endpoint version reporting instruction. Then, the endpoint reports its version information to the cloud platform.

Examples

# Report endpoint version information to the cloud platform.

<Sysname> system-view

[Sysname] wlan ap ap1

[Sysname-wlan-ap-ap1] iot report-version ap ap1 tx-module 1 rx-module 2 endpoint-type tag

iot zigbee keepalive interval

Use iot zigbee keepalive interval to specify the interval at which an AP sends a keepalive packet to the ZigBee server.

Use undo iot zigbee keepalive interval to restore the default.

Syntax

iot zigbee keepalive interval interval

undo iot zigbee keepalive interval

Default

In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

In AP group view, an AP uses the configuration in global configuration view.

In global configuration view, an AP sends a keepalive packet to the ZigBee server every 15 seconds.

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

Parameters

interval: Specifies the interval at which the AP sends a keepalive packet to the ZigBee server, in the range of 1 to 3600 seconds.

Usage guidelines

An AP sends keepalive packets to the ZigBee server to refresh the NAT mapping between the private network where the AP resides and the public network where the ZigBee server resides. If the NAT mapping is not refreshed before it expires, the AP cannot communicate with the ZigBee server.

Examples

# In AP view, configure the AP to send a keepalive packet to the ZigBee server every 60 seconds.

<Sysname> system-view

[Sysname] wlan ap ap1

[Sysname-wlan-ap-ap1]iot zigbee keepalive interval 60

# In AP group view, configure an AP to send a keepalive packet to the ZigBee server every 60 seconds.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-ap-group10]iot zigbee keepalive interval 60

# In global configuration view, configure an AP to send a keepalive packet to the ZigBee server every 60 seconds.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration]iot zigbee keepalive interval 60

module

Use module to enter module view.

Syntax

module module-id

Views

AP view

AP group's AP model view

Predefined user roles

network-admin

Parameters

module-id: Specifies a module by its ID. The value range varies by AP model.

Usage guidelines

To configure and manage a module on an AP, you must first enter module view of the AP.

Examples

# Enter the view of module 1 on AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-X-R

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1]

# Enter the view of module 1 on all APs with AP model WA4320i-X-R in AP group apgroup1.

<Sysname> system-view

[Sysname] wlan ap-group apgroup1

[Sysname-wlan-ap-apgroup1] ap-model WA4320i-X-R

[Sysname-wlan-ap-apgroup1-ap-model-WA4320i-X-R] module 1

[Sysname-wlan-ap-group-1-ap-model-WA4320i-X-R-module-1]

module enable

Use module enable to enable a module.

Use module disable to disable a module.

Use undo module to restore the default.

Syntax

module { disable | enable }

undo module

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, a module is disabled.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Usage guidelines

The configuration in module view takes precedence over the configuration in an AP group's module view.

Examples

# Enable module 1 for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-X-R

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] module enable

# Enable module 1 for APs with model WA4320i-X-R in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model WA4320i-X-R

[Sysname-wlan-ap-group-1-ap-model-WA4320i-X-R] module 1

[Sysname-wlan-ap-group-1-ap-model-WA4320i-X-R-module-1] module enable

module firmware-upgrade

Use module firmware-upgrade enable to enable automatic firmware upgrade for a module.

Use module firmware-upgrade disable to disable automatic firmware upgrade for a module.

Use undo firmware-upgrade to restore the default.

Syntax

module firmware-upgrade { disable | enable }

undo module firmware-upgrade

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, automatic firmware upgrade is enabled for a module.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Usage guidelines

This feature enables a module to immediately upgrade its firmware if its firmware version is different from the version stored in the AP's image file.

After you enable this feature for a module, this feature takes effect every time the IoT AP where the module is installed restarts.

During the module firmware upgrade process, do not use the shutdown command to shut down the interface that connects the module to the IoT AP.

The configuration in module view takes precedence over the configuration in an AP group's module view.

Examples

# Enable automatic firmware upgrade for module 1 on AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-X-R

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] module firmware-upgrade enable

# Enable automatic firmware upgrade for module 1 on APs with model WA4320i-X-R in AP group 10.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-wlan-ap-group-10] ap-model WA4320i-X-R

[Sysname-wlan-ap-group-10-ap-model-WA4320i-X-R] module 1

[Sysname-wlan-ap-group-10-ap-model-WA4320i-X-R-module-1] module firmware-upgrade enable

Related commands

display wlan module firmware-upgrade history

display wlan module-information

port-type switch

 

NOTE:

Support for this command depends on the AP model.

Use port-type switch to change the interface type of an IoT interface.

Use undo port-type switch to restore the default interface type setting of the specified IoT interface.

Syntax

port-type switch number port-number { auto | gigabitethernet | iot }

undo port-type switch number port-number

Default

In AP view, an AP uses the configuration in an AP group's AP model view.

In an AP group's AP model view, the interface type of an IoT interface is auto.

Views

AP view

AP group's AP model view

Predefined user roles

network-admin

Parameters

number port-number: Specifies an IoT interface or a list of space-separated IoT interfaces by interface number. The value range for the port-number argument varies by AP model.

auto: Specifies the auto interface type. An IoT interface of this type can automatically identify the downlink network and switch the interface type accordingly.

gigabitethernet: : Specifies the GigabitEthernet interface type.

iot: Specifies the IoT interface type.

Usage guidelines

You can change the interface type of an IoT interface among auto, IoT, and GigabitEthernet for connecting the AP to a module or to an Ethernet as required.

The configuration in AP view takes precedence over the configuration in an AP group's AP model view.

Examples

# Set the interface type of IoT interface 3 to GigabitEthernet for AP ap1 with AP model UAP300.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] port-type switch number 3 gigabitethernet

# Set the interface type of IoT interface 3 to GigabitEthernet for APs with AP model UAP300 in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model UAP300

[Sysname-wlan-ap-group-1-ap-model-UAP300] port-type switch number 3 gigabitethernet

rfid-tracking ble active-scan

Use rfid-tracking ble active-scan enable to enable BLE active scanning.

Use rfid-tracking ble active-scan disable to disable BLE active scanning.

Use undo rfid-tracking ble active-scan to restore the default.

Syntax

rfid-tracking ble active-scan { disable | enable }

undo rfid-tracking ble active-scan

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, BLE active scanning is disabled.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Examples

# Enable BLE active scanning. (Module view)

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module-1

[Sysname-wlan-ap-ap1-module-1] rfid-tracking ble active-scan enable

# Enable BLE active scanning. (AP group's module view)

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model UAP300

[Sysname-wlan-ap-group-1-ap-model-UAP300] module 1

[Sysname-wlan-ap-group-1-ap-model-UAP300-module-1] rfid-tracking ble active-scan enable

Related commands

rfid-tracking ble active-scan time-range

rfid-tracking ble active-scan time-range

Use rfid-tracking ble active-scan time-range to specify the BLE active scanning period.

Use undo rfid-tracking ble active-scan time-range to restore the default.

Syntax

rfid-tracking ble active-scan time-range start-time to end-time

undo rfid-tracking ble active-scan time-range

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, the BLE active scanning works from 00:00 to 24:00.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Parameters

start-time to end-time: Specifies a time period by its start time and end time. The start time and end time are in hh:mm format, and the start time must be earlier than the end time. The value range for the start-time argument is 00:00 to 23:59, and the value range for the end-time argument is 00:01 to 24:00.

Examples

# Configure BLE active scanning to work from 06:00 to 08:00. (Module view)

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module-1

[Sysname-wlan-ap-ap1-module-1] rfid-tracking ble active-scan time-range 06:00 to 08:00

# Configure BLE active scanning to work from 06:00 to 08:00. (AP group's module view)

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model UAP300

[Sysname-wlan-ap-group-1-ap-model-UAP300] module 1

[Sysname-wlan-ap-group-1-ap-model-UAP300-module-1] rfid-tracking ble active-scan time-range 06:00 to 08:00

Related commands

rfid-tracking ble active-scan

rfid-tracking ble advertisement

Use rfid-tracking ble advertisement to configure the advertisement information for a BLE module.

Use undo rfid-tracking ble advertisement to restore the default.

Syntax

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

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

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, the Major ID is 1, Minor ID is 1, measured power is –58 dBm, and UUID is E1CC5B618C06428E8720FE619DB80193 in the advertisement information for a BLE module.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Parameters

major-id major-id: Specifies the Major ID in the advertisement information for a BLE module. The value range for the major-id argument is 0 to 65535.

measured-power measured-power: Specifies the measured power in the advertisement information for a BLE module. The value range for the measured-power argument is 0 to 127, which represents signal strength of –127 to 0 dBm. A larger value represents weaker signal strength. The measured power is the signal strength detected by the advertisement receiving device when the device is 1 m (3.28 ft) from the iBeacon device. The measured power can be used to calculate the distance between the advertisement receiving device and the iBeacon device.

minor-id minor-id: Specifies the Minor ID in the advertisement information for a BLE module. The value range for the minor-id argument is 0 to 65535.

uuid uuid: Specifies the UUID in the advertisement information for a BLE module. The value range for the uuid argument is a case-insensitive string of 32 hexadecimal digits from 0 to f.

Usage guidelines

A BLE module broadcasts iBeacon advertisements containing Major ID, Minor ID, measured power, and UUID to nearby application software. Application software that receives the advertisement information will take specific actions according to the advertisement information to fulfill their software functions.

The configuration in module view takes precedence over the configuration in an AP group's module view.

Examples

# Configure the advertisement information for BLE module 1 on AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320-ACN-B

[Sysname-ap-ap1] module 1

[Sysname-ap-ap1-module-1] rfid-tracking ble advertisement major-id 4

[Sysname-ap-ap1-module-1] rfid-tracking ble advertisement minor-id 4

[Sysname-ap-ap1-module-1] rfid-tracking ble advertisement uuid 34ae56115098ca67321a11256bca3007

[Sysname-ap-ap1-module-1] rfid-tracking ble advertisement measured-power 30

# Configure the advertisement information for BLE module 1 on APs with model WA4320-ACN-B in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model WA4320-ACN-B

[Sysname-wlan-ap-group-1-ap-model-WA4320-ACN-B] module 1

[Sysname-wlan-ap-group-1-ap-model-WA4320-ACN-B-module-1] rfid-tracking ble advertisement major-id 4

[Sysname-wlan-ap-group-1-ap-model-WA4320-ACN-B-module-1] rfid-tracking ble advertisement minor-id 4

[Sysname-wlan-ap-group-1-ap-model-WA4320-ACN-B-module-1] rfid-tracking ble advertisement uuid 34ae56115098ca67321a11256bca3007

[Sysname-wlan-ap-group-1-ap-model-WA4320-ACN-B-module-1] rfid-tracking ble advertisement measured-power 30

Related commands

rfid-tracking ble advertisement enable

rfid-tracking ble advertisement interval

rfid-tracking ble advertisement { disable | enable }

Use rfid-tracking ble advertisement enable to enable the iBeacon transmission feature for a BLE module.

Use rfid-tracking ble advertisement disable to disable the iBeacon transmission feature for a BLE module.

Use undo rfid-tracking ble advertisement to restore the default.

Syntax

rfid-tracking ble advertisement { disable | enable }

undo rfid-tracking ble advertisement

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, the iBeacon transmission feature is disabled for a BLE module.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Usage guidelines

This command enables a BLE module to periodically broadcast iBeacon advertisements. An iBeacon advertisement contains a UUID, a Major ID, the measured power, and a Minor ID.

This command takes effect only for BLE modules when BLE location is enabled. For information about BLE location, see wireless location in WLAN Advanced Features Configuration Guide.

The configuration in module view takes precedence over the configuration in an AP group's module view.

Examples

# Enable the iBeacon transmission feature for BLE module 1 on AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320-ACN-B

[Sysname-ap-ap1] module 1

[Sysname-ap-ap1-module-1] rfid-tracking ble advertisement enable

# Enable the iBeacon transmission feature for BLE module 1 on APs with model WA4320-ACN-B in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model WA4320-ACN-B

[Sysname-wlan-ap-group-1-ap-model-WA4320-ACN-B] module 1

[Sysname-wlan-ap-group-1-ap-model-WA4320-ACN-B-module-1] rfid-tracking ble advertisement enable

Related commands

rfid-tracking ble(WLAN Advanced Features Command Reference)

rfid-tracking ble advertisement

rfid-tracking ble advertisement interval

rfid-tracking ble advertisement interval

Use rfid-tracking ble advertisement interval to set the interval for a BLE module to broadcast iBeacon advertisements.

Use undo rfid-tracking ble advertisement interval to restore the default.

Syntax

rfid-tracking ble advertisement interval interval

undo rfid-tracking ble advertisement interval

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, a BLE module broadcasts iBeacon advertisements every 100 centiseconds (1 second).

Views

Module view

AP group's module view

Predefined user roles

network-admin

Parameters

interval: Specifies the interval for a BLE module to broadcast iBeacon advertisements with a step size of 10. The value range is 50 to 1000 centiseconds.

Usage guidelines

The configuration in module view takes precedence over the configuration in an AP group's module view.

Examples

# Configure BLE module 1 to broadcast iBeacon advertisements every 200 centiseconds for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320-ACN-B

[Sysname-ap-ap1] module 1

[Sysname-ap-ap1-module-1] rfid-tracking ble advertisement interval 200

# Configure BLE module 1 to broadcast iBeacon advertisements every 200 centiseconds for APs with model WA4320-ACN-B in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model WA4320-ACN-B

[Sysname-wlan-ap-group-1-ap-model-WA4320-ACN-B] module 1

[Sysname-wlan-ap-group-1-ap-model-WA4320-ACN-B-module-1] rfid-tracking ble advertisement interval 200

Related commands

rfid-tracking ble advertisement

rfid-tracking ble advertisement enable

rfid-tracking iot

Use rfid-tracking iot enable to enable Internet of Things (IoT) location.

Use rfid-tracking iot disable to disable Internet of Things (IoT) location

Use undo rfid-tracking iot to restore the default.

Syntax

rfid-tracking iot { disable | enable }

undo rfid-tracking iot

Default

In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

In AP group view, an AP uses the configuration in global configuration view.

In global configuration view, IoT location is disabled.

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

Usage guidelines

For an IoT AP to scan channels and receive packets, you must enable IoT location.

This command enables an IoT AP to perform the following operations:

·     Identifies all packets from bracelets through the RFID modules installed on or connected to the IoT AP and forwards the packets to the cloud server.

The cloud server calculates the rough locations of the bracelets based on the reported packets.

·     Identifies all packets from standard Zigbee devices through the Zigbee modules connected to the IoT AP and forwards the packets to the cloud server.

The cloud server parses and saves the reported packets.

Examples

# Enable IoT location for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] rfid-tracking iot enable

# Enable IoT location for APs in AP group 10.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-wlan-ap-group-10] rfid-tracking iot enable

# Enable IoT location globally.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration] rfid-tracking iot enable

rfid-tracking iot rssi threshold

Use rfid-tracking iot rssi threshold to set an RSSI threshold to filter location packets in IoT location.

Use undo rfid-tracking iot rssi threshold to restore the default.

Syntax

rfid-tracking iot rssi threshold rssi-threshold

undo rfid-tracking iot rssi threshold

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, no RSSI threshold is set to filter location packets in IoT location.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Parameters

rssi-threshold: Specifies an RSSI threshold in the range of –127 to +125.

Usage guidelines

This command is applicable only to RFID or BLE modules. The actual value range for the RSSI threshold varies by access unit model, as shown in Table 4. If the specified RSSI threshold is not within the allowable value range, the IoT access unit does not filter location packets.

Table 4 RSSI threshold range of IoT access units

IoT access unit

RSSI threshold range in RFID mode

RSSI threshold range in BLE mode

T300-R

5 to 100

–127 to +20

T300-B

5 to 100

–127 to +20

T301-R

5 to 100

–127 to +20

Examples

# Configure IoT module 1 to ignore location packets with an RSSI lower than 30 for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] rfid-tracking iot rssi threshold 30

# Configure IoT module 1 to ignore location packets with an RSSI lower than 30 for APs with model UAP300 in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model UAP300

[Sysname-wlan-ap-group-1-ap-model-UAP300] module 1

[Sysname-wlan-ap-group-1-ap-model-UAP300-module-1] rfid-tracking iot rssi threshold 30

Related commands

rfid-tracking iot

rfid-tracking iot sampling interval

Use rfid-tracking iot sampling interval to set a location packet sampling interval.

Use undo rfid-tracking iot sampling interval to restore the default.

Syntax

rfid-tracking iot sampling interval interval

undo rfid-tracking iot sampling interval

Default

The location packet sampling interval is 10 seconds.

Views

AP view

Predefined user roles

network-admin

Parameters

interval: Specifies the location packet sampling interval in the range of 2 to 60 seconds.

Examples

# Set the location packet sampling interval to 5 seconds.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] rfid-tracking iot sampling interval 5

Related commands

rfid-tracking iot sampling module

rfid-tracking iot sampling module

Use rfid-tracking iot sampling module to enable an IoT AP to sample location packets from all or a specified IoT module.

Use undo rfid-tracking iot sampling module to disable an IoT AP from sampling location packets from all or a specified IoT module.

Syntax

rfid-tracking iot sampling module { all | module-id1 [ to module-id2 ] }

undo rfid-tracking iot sampling module { all | module-id1 [ to module-id2 ] }

Default

Location packet sampling is disabled.

Views

AP view

Predefined user roles

network-admin

Parameters

all: Specifies all modules.

module-id1: Specifies the start module ID for the module ID range. The value range for this argument varies by device model.

module-id2: Specifies the end module ID for the module ID range. The value range for this argument varies by device model. The end module ID cannot be smaller than the start module ID.

Usage guidelines

This feature prevents location packets sent by bracelets whose location does not change or changes very little within a long period from affecting the overall performance of the AC. With this feature enabled, an IoT AP sends only the packet with the highest RSSI from a bracelet within each sampling interval to the AC.

The location packet sampling feature is unavailable if the value for the length field of IoT packets is 6 bits.

Examples

# Enable IoT AP ap1 to sample location packets from IoT module 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] rfid-tracking iot sampling module 1

Related commands

rfid-tracking iot sampling interval

serial-number

Use serial-number to specify a serial number for a module.

Use undo serial-number to restore the default.

Syntax

serial-number serial-number

undo serial-number

Default

No serial number is specified for a module.

Views

Module view

Predefined user roles

network-admin

Parameters

serial-number : Specifies a serial number to uniquely identify a module, a case-insensitive string of 1 to 31 characters.

Usage guidelines

CAUTION

CAUTION:

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.

This command is required for a module if the module connects to an 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.

For a module that is installed on an IoT AP, this setting does not take effect. The module can come online directly no matter whether the configured serial number is the same as the module's serial number or not.

Examples

# Specify the serial number of module 1 as 210235A1BSC123000050.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] serial-number 210235A1BSC123000050

tx-power

Use tx-power to set the transmit power level for a module.

Use undo tx-power to restore the default.

Syntax

tx-power power

undo tx-power

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, the transmit power level is 1, which indicates a transmit power of 4 dBm.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Parameters

power: Specifies the transmit power level. The value can be 1, 2, 3, or 4, which indicates a transmit power of 4 dBm, –1 dBm, –5 dBm, and –9 dBm, respectively.

Usage guidelines

The configuration in module view takes precedence over the configuration in an AP group's module view.

Examples

# Set the transmit power level to 4 for module 1 on AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320-ACN-B

[Sysname-ap-ap1] module 1

[Sysname-ap-ap1-module-1] tx-power 4

# Set the transmit power level to 4 for module 1 on APs with model WA4320-ACN-B in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model WA4320-ACN-B

[Sysname-wlan-ap-group-1-ap-model-WA4320-ACN-B] module 1

[Sysname-wlan-ap-group-1-ap-model-WA4320-ACN-B-module-1] tx-power 4

Related commands

rfid-tracking ble advertisement

type

Use type to specify the supported module type.

Use undo type to restore the default.

Syntax

type { ble | rfid | uwb | zigbee }

undo type

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, no supported module type is specified.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Parameters

ble: Specifies the Bluetooth low energy type.

rfid: Specifies the RFID type.

zigbee: Specifies the Zigbee type.

uwb: Specifies the UWB type.

Usage guidelines

For a module on an AP to operate correctly, the supported module type you specify must be consistent with its physical module type.

After you specify a module type for a module, the settings that are not supported by the module type will be deleted, and these settings are not configurable.

The configuration in module view takes precedence over the configuration in an AP group's module view.

Examples

# Specify Zigbee as the supported module type for module 1 on AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] type zigbee

# Specify Zigbee as the supported module for module 1 on APs with model UAP300 in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model UAP300

[Sysname-wlan-ap-group-1-ap-model-UAP300] module 1

[Sysname-wlan-ap-group-1-ap-model-UAP300-module-1] type zigbee

uart baudrate

Use uart baudrate to set the UART baud rate for an IoT module.

Use undo uart baudrate to restore the default.

Syntax

uart baudrate { auto | 115200 | 921600 }

undo uart baudrate

Default

An IoT module automatically adapts to the baud rate of the card installed on the module.

Views

Module view

Predefined user roles

network-admin

Parameters

auto: Uses the auto-adaptive UART baud rate.

115200: Sets the UART baud rate to 115200 B.

921600: Sets the UART baud rate to 921600 B.

Usage guidelines

The Universal Asynchronous Receiver/Transmitter (UART) baud rate of an IoT module represents the serial port communication rate of the IoT module. As a best practice, use the auto-adaptive UART baud rate. If the baud rate of the card installed on the IoT module is known, set the UART baud rate of the IoT module to the baud rate of the card.

Examples

# Configure module 1 connected to AP ap1 to use the auto-adaptive UART baud rate.

<Sysname> system-view

[Sysname] wlan ap ap1 model uap300

[Sysname-ap-ap1] module 1

[Sysname-ap-ap1-module-1] uart baudrate auto

Related commands

display wlan module-information

wlan execute module firmware-upgrade

Use wlan execute module firmware-upgrade to manually upgrade the firmware of a module.

Syntax

wlan execute module firmware-upgrade ap ap-name module module-id firmware-path filepath

Views

System view

Predefined user roles

network-admin

Parameters

ap ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

module module-id: Specifies a module by its ID. The value range varies by AP model.

firmware-path filepath: Specifies the path of the image file for module upgrade.

Usage guidelines

When you use this command to manually upgrade the firmware of an IoT module, make sure the automatic firmware upgrade feature is disabled for the module. Automatic firmware upgrade performs version consistency check every time the connected IoT AP restarts and upgrades the module's firmware to the version stored in the AP' image file as necessary.

During the module firmware upgrade process, do not use the shutdown command to shut down the interface that connects the module to the IoT AP.

Examples

# Obtain an upgrade file to manually upgrade module 1 on AP ap1.

<Sysname> system-view

[Sysname] wlan execute module firmware-upgrade ap ap1 module 1 firmware-path flash:/a.ipe

Related commands

display wlan module firmware-upgrade history

wlan execute module led-flash

Use wlan execute module led-flash to trigger the LEDs on a module to flash regularly.

Syntax

wlan execute module led-flash ap ap-name module module-id

Views

System view

Predefined user roles

network-admin

Parameters

ap ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

module-id: Specifies a module ID. The value range varies by AP model.

Usage guidelines

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

Examples

# Trigger the LEDs of module 1 on AP ap1 to flash regularly.

<Sysname> system-view

[Sysname] wlan execute module led-flash ap ap1 module 1

wlan execute module reset

Use wlan execute module reset to restart a module on an AP.

Syntax

wlan execute module reset ap ap-name module module-id

Views

System view

Predefined user roles

network-admin

Parameters

ap ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

module-id: Specifies a module by its ID. The value range varies by AP model.

Examples

# Restart module 1 on AP ap1.

<Sysname> system-view

[Sysname] wlan execute module reset ap ap1 module 1

wlan execute module restore-factory

 

NOTE:

Support for this command depends on the module model.

Use wlan execute module restore-factory to restore the factory settings for a module on an AP.

Syntax

wlan execute module restore-factory ap ap-name module module-id

Views

System view

Predefined user roles

network-admin

Parameters

ap ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

module-id: Specifies a module by its ID. The value range varies by AP model.

Usage guidelines

Use this command to clear the settings of a module and restore the factory settings for the module.

This command restarts a module and restores the factory settings of the module immediately.

This command clears only settings that are already used by a module, and it does not clear settings configured for the module in module view on the AC. When the module restarts, all the settings in the module view will be assigned to the module again.

Examples

# Restore the factory settings for module 1 on AP ap1.

<Sysname> system-view

[Sysname] wlan execute module restore-factory ap ap1 module 1

zigbee channel

Use zigbee channel to specify the working channel for a Zigbee module.

Use undo zigbee channel to restore the default.

Syntax

zigbee channel channel-number

undo zigbee channel

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, a zigbee module uses channel 11 as the working channel.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Parameters

channel-number: Specifies a channel number in the range of 11 to 26.

Usage guidelines

For a Zigbee module to connect to a standard Zigbee device, make sure they use the same working channel.

Examples

# Specify working channel 20 for Zigbee module 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] zigbee channel 20

# Specify working channel 20 for Zigbee module 1 on APs with AP model UAP300 in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model UAP300

[Sysname-wlan-ap-group-1-ap-model-UAP300] module 1

[Sysname-wlan-ap-group-1-ap-model-UAP300-module-1] zigbee channel 20

zigbee encryption

Use zigbee encryption enable to enable the packet encryption feature.

Use zigbee encryption disable to disable the packet encryption feature.

Use undo zigbee encryption to restore the default.

Syntax

zigbee encryption { disable | enable }

undo zigbee encryption

Default

The packet encryption feature is disabled.

Views

Module view

Predefined user roles

network-admin

Usage guidelines

Perform this task to enable or disable packet encryption for a Zigbee module. After you enable packet encryption, the Zigbee module and standard Zigbee devices use the AES-128 algorithm to encrypt packets exchanged.

A Zigbee module can connect only to standard Zigbee devices that have the same packet encryption state as the Zigbee module.

Examples

# Enable the packet encryption feature for Zigbee module 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-X-R

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] zigbee encryption enable

zigbee endpoint profile-id

Use zigbee endpoint profile-id to specify an endpoint identifier and profile ID for a Zigbee module.

Use undo zigbee endpoint profile-id to restore the default.

Syntax

zigbee endpoint identifier profile-id profile-id

undo zigbee endpoint identifier profile-id profile-id

Default

In module view, a module uses the configuration in an AP group's module view.

In an AP group's module view, the Zigbee endpoint identifier and profile ID are both 1.

Views

Module view

AP group's module view

Predefined user roles

network-admin

Parameters

identifier: Specifies the endpoint identifier in the range of 1 to 240.

profile-id: Specifies the profile ID in the range of 0 to 65535.

Usage guidelines

For a Zigbee module to communicate with a standard Zigbee device, make sure they are configured with the same endpoint identifier and profile ID.

Examples

# Specify an endpoint identifier and profile ID for Zigbee module 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] zigbee endpoint 30 profile-id 200

# Specify an endpoint identifier and profile ID for Zigbee module 1 on APs with AP model UAP300 in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model UAP300

[Sysname-wlan-ap-group-1-ap-model-UAP300] module 1

[Sysname-wlan-ap-group-1-ap-model-UAP300-module-1] zigbee endpoint 30 profile-id 200

zigbee link- key

Use zigbee link-key to specify a ZigBee connection key.

Use undo zigbee link-key to restore the default.

Syntax

zigbee link-key { cipher | simple } string

undo zigbee link-key

Default

The ZigBee connection key is ZigBeeAlliance0' in plain text.

Views

Module view

Predefined user roles

network-admin

Parameters

cipher: Specifies a cipher-text ZigBee connection key.

simple: Specifies a plain-text ZigBee connection key. The plain text key will be saved in cipher text.

string: Specifies a ZigBee connection key. A cipher-text ZigBee connection key is a case-sensitive string of 1 to 53 characters. A plain-text ZigBee connection key is a case-sensitive string of 1 to 16 characters, and each character contains two hexadecimal numbers, representing the ASCII value of the character. A plain-text ZigBee connection key is in the XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX format and cannot contain ASCII value 0.

Usage guidelines

When a ZigBee endpoint requests to access an IoT module, the IoT module authenticates the endpoint by using the ZigBee connection key. The endpoint can access the IoT module only when its connection key is the same as the ZigBee connection key configured on the IoT module.

Examples

# Specify the ZigBee connection key as 1234-1234-1234-1234-1234-1234-1234-1234 in plain text.

<Sysname> system-view

[Sysname] wlan ap ap1

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] zigbee link-key simple 1234-1234-1234-1234-1234-1234-1234-1234

zigbee network-key

Use zigbee network-key to specify a ZigBee network layer key.

Use undo zigbee network-key to restore the default.

Syntax

zigbee network-key { cipher | simple } string

undo zigbee network-key

Default

The ZigBee network layer key is 0x01-0x03-0x05-0x07-0x09-0x0B-0x0D-0x0F-0x00-0x02-0x04-0x06-0x08-0x0A-0x0C-0x0D in plain text.

Views

Module view

Predefined user roles

network-admin

Parameters

cipher: Specifies a cipher-text ZigBee network layer key.

simple: Specifies a plain-text ZigBee network layer key. The plain text key will be saved in cipher text.

string: Specifies a ZigBee network layer key. A cipher-text ZigBee network layer key is a case-sensitive string of 53 characters. A plain-text ZigBee connection key is a case-sensitive string of 16 characters, and each character contains two hexadecimal numbers, representing the ASCII value of the character. A plain-text ZigBee connection key is in the XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX format and cannot contain ASCII value 0.

Usage guidelines

The ZigBee network layer key is used to encrypt the ZigBee network layer. The specific implementation depends on the ZigBee protocol stack. This command only issues the key.

Examples

# Specify the ZigBee network layer key as 1234-1234-1234-1234-1234-1234-1234-1234 in plain text.

<Sysname> system-view

[Sysname] wlan ap ap1

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] zigbee network-key simple 1234-1234-1234-1234-1234-1234-1234-1234

zigbee pan-id

Use zigbee pan-id to specify a PAN ID for a Zigbee module.

Use undo zigbee pan-id to restore the default.

Syntax

zigbee pan-id pan-id

undo zigbee pan-id

Default

The Zigbee PAN ID is a random number in the range of 0 to 65534, which is different from any detected PAN IDs.

Views

Module view

Predefined user roles

network-admin

Parameters

pan-id pan-id: Specifies the PAN ID in the range of 0 to 65534.

Usage guidelines

Before connecting a Zigbee module to a standard Zigbee device, specify the PAN ID of the Zigbee device for the Zigbee module.

To avoid conflicts, the PAN IDs for signal overlapped Zigbee networks must be different.

Examples

# Set the PAN ID to 300 for Zigbee module 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] zigbee pan-id 300

zigbee permit-join duration

Use zigbee permit-join duration to specify a period during which a Zigbee device can access the specified Zigbee module.

Syntax

zigbee permit-join duration time

Default

A Zigbee device cannot access a Zigbee module.

Views

Module view

Predefined user roles

network-admin

Parameters

time: Specifies a period during which a Zigbee device can access the specified Zigbee module. The duration is in the range of 1 to 254 seconds.

Examples

# Allow Zigbee devices to access module 1 within 10 seconds.

<Sysname> system-view

[Sysname] wlan ap ap1

[Sysname-wlan-ap-ap1] module 1

[Sysname-wlan-ap-ap1-module-1] zigbee permit-join duration 10

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网