02-WLAN

HomeSupportResource CenterH3C Access Controllers Command References(E5208P03 E5215P01 R5215P01)-6W10202-WLAN
19-IoT AP commands
Title Size Download
19-IoT AP commands 71.63 KB

IoT AP commands

Support for IoT capability depends on the AP model.

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-insensitive 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 firmware upgrade information for a module on an AP from the time that the AP starts.

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 1 Command output

Field

Description

Upgrade status

Upgrade status:

·     Succeeded..

·     Failed.

·     Upgrading.

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

SW version

Module software version.

 

display wlan module-information

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

Syntax

display wlan module-information ap ap-name module module-id

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ap ap-name: Specifies an AP by its name, a case-insensitive 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.

Examples

# Display information about module 1 on AP ap1.

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

Module administrate type       : IOT

Module physical type           : IOT

Model                          : EW100-R

HW version                     : 12090031

SW version                     : 12090202

Sequence ID                    : 0000051700000002

Node physical status           : Normal

Module physical status         : Normal

Module administrate status     : Enabled

RF1                            : Enabled

RF2                            : Enabled

RF3                            : Enabled

ZIGBEE                         : Enabled

Table 2 Command output

Field

Description

Module administrate type

Configured module type:

·     NotConfig.

·     BLE.

·     IOT.

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

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

HW version

Module hardware version.

SW version

Module software version.

Sequence ID

Module sequence ID.

Node physical status

Physical status of the node where the module is installed:

·     Unavailable.

·     Normal.

·     Absent.

Module physical status

Physical status of the module:

·     Unavailable.

·     Normal.

·     Absent.

Module administrate status

Configured module status:

·     Enabled.

·     Disabled.

RF1

RF1 status:

·     Enabled.

·     Disabled.

RF2

RF2 status:

·     Enabled.

·     Disabled.

RF3

RF3 status:

·     Enabled.

·     Disabled.

ZIGBEE

Zigbee status:

·     Enabled.

·     Disabled.

 

module

Use module to enter module view.

Syntax

module module-id

Views

AP view

AP group 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, an AP uses the configuration in AP group's module view.

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

Views

Module view

AP group's module view

Predefined user roles

network-admin

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 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 AP group's module view.

In AP group's module view, automatic firmware upgrade is disabled 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 connected IoT AP reboots.

Examples

# Enable automatic firmware upgrade in module view.

<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 in AP group's module view.

<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

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 AP group's module view.

In AP group's module view, the Major ID is 1, Minor ID is 1, measured power is -58 dBm, and UUID is 0 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, representing that the value range for the signal intensity is -127 to 0 dBm. A larger value represents weaker signal intensity. The measured power is the signal intensity detected by the advertisement receiving device when the device is at a 1-meter distance 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.

Examples

# Configure the advertisement information for BLE module 1 in module view.

<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 in AP group's module view.

<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 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 AP group's module view.

In 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, Major ID, measured power, and Minor ID.

This command takes effect only for BLE modules.

Examples

# Enable the iBeacon transmission feature for BLE module 1 in module view.

<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 in AP group's module view.

<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 advertisement

·     rfid-tracking ble advertisement interval

rfid-tracking ble advertisement interval

Use rfid-tracking ble advertisement interval to set the interval at which a BLE module broadcasts 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 AP group's module view.

In 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 at which a BLE module broadcasts iBeacon advertisements with a step size of 10. The value range is 50 to 1000 centiseconds.

Examples

# Configure BLE module 1 to broadcast iBeacon advertisements every 200 centiseconds in module view.

<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 in AP group's module view.

<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

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 that can 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 when the module connects to an AP through network cables. 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 AP, this command does not take effect. The module can come online directly no matter whether the specified serial number is the same as the module's serial number or not.

Examples

# Set the serial number of module 1 to 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 AP group's module view.

In AP group's module view, the transmit power level for a module 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.

Examples

# Set the transmit power level to 4 for module 1 in module view.

<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 in AP group's module view.

<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 enable

type

Use type to specify the supported module type.

Use undo type to restore the default.

Syntax

type { ble | iot }

undo type

Default

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

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

iot: Specifies the IoT type.

Usage guidelines

For a module to operate correctly, make sure the specified module type is the same as the actual module type.

Examples

# Specify the supported module type IoT 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] type iot

# Specify the supported module type IoT for 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] type iot

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 | ap-group group-name ap-model ap-model } 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-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

ap-group group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 31 characters.

ap-model ap-model: Specifies an AP model.

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.

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

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

Examples

# Restart module 1 on AP ap1.

<Sysname> system-view

[Sysname] wlan execute module reset ap ap1 module 1

wlan execute module restore-factory

Use restore factory-default wlan ap 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-insensitive 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.

Usage guidelines

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

Examples

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

<Sysname> system-view

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