No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

S7700 and S9700 V200R011C10

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
WLAN Location Configuration Commands

WLAN Location Configuration Commands

Command Support

  • Only the X series interface cards of S7700 and S9700 support WLAN-AC commands.

  • The AP9330DN does not support the WLAN tag location function.
  • The AP3010DN-AGN, AP6310SN-GN, and AP9330DN do not support the WLAN terminal location function.
  • Only the R250D-E, AP2050DN-E, AP4050DN-E, AP4051TN, AP6052DN, AP7052DN, AP7152DN, AP7052DE, AP8050TN-HD, AP8082DN, AP8182DN, AP8050DN, AP8050DN-S, AP8150DN, and AP7050DE support Bluetooth location, Bluetooth tag location and Bluetooth data transparent transmission. Only the AP4050DN-E supports the Bluetooth broadcast function.

aeroscout compound-time

Function

The aeroscout compound-time command configures the aggregation time of AeroScout tag and mobile unit (MU) packets on the AC.

The undo aeroscout compound-time command restores the default aggregation time of AeroScout tag and MU packets.

The default aggregation time of AeroScout tag and MU packets is 6553.5s on the AC.

Format

aeroscout compound-time time-value

undo aeroscout compound-time

Parameters

Parameter Description Value
time-value

Specifies the packet aggregation time.

The value is an integer that ranges from 0 to 65535. The unit is in 0.1s. If time-value is set to 0, the AP does not aggregate packets but reports the packets in real time.

Views

Location profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

During AeroScout location, the AP does not report the received tag packets immediately to the upstream device but aggregates the packets. After a specified time, the AP reports the aggregated packets.

The AeroScout location server delivers an aggregation time of 6553.5s to the APs. The AC delivers the aggregation time to the APs using the aeroscout compound-time command. The AP selects a smaller aggregation time. By default, the aggregation time on the APs is 6553.5s.

If the packet aggregation time is set to a large value on the AeroScout location system, it takes a long time for the AP to report the aggregated packets, resulting in poor real-time performance and a large delay in the transmission of location packets. You can run the aeroscout compound-time command to set a small aggregation time to reduce the delay in location packet transmission.

Precautions

When the size of aggregated packets on an AP reaches 1k bytes, the AP immediately reports the aggregated packets.

Example

# Set the aggregation time to 10s.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei] aeroscout compound-time 100

aeroscout mu-enable

Function

The aeroscout mu-enable command enables WLAN location of AeroScout mobile units (MUs).

The undo aeroscout mu-enable command disables WLAN location of AeroScout MUs.

By default, WLAN location of AeroScout MUs is disabled.

Format

aeroscout mu-enable

undo aeroscout mu-enable

Parameters

None

Views

Location profile view

Default Level

2: Configuration level

Usage Guidelines

You can run the aeroscout mu-enable command to enable WLAN location of AeroScout MUs.

Example

# Enable WLAN location of AeroScout MUs.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei] aeroscout mu-enable

aeroscout server

Function

The aeroscout server command sets the destination IP address and port number on the AeroScout server for APs to report location packets of AeroScout tags and Mobile Units (MUs).

The undo aeroscout server command deletes the configured destination IP address and port number on the AeroScout server for APs to report location packets of AeroScout tags and MUs.

By default, destination IP address or port number is configured for APs to report location packets of AeroScout tags and MUs.

Format

aeroscout server port port-num [ via-ac ac-port ac-port-num ]

undo aeroscout server

Parameters

Parameter Description Value
port port-num

Specifies the destination port number on the AeroScout location server to which APs directly report location packets of AeroScout tags and MUs.

Specifies the destination port number on the AeroScout location server to which the AC reports location packets of AeroScout tags and MUs through an AC.

The value is an integer that ranges from 1025 to 65535.
via-ac Specifies that the tag packets received by APs are reported to the AeroScout location server through an AC.
NOTE:
If the APs directly report the received tag and MU packets to the AeroScout location server, the display wlan location statistics aeroscout command cannot display location statistics about the AeroScout tags and MUs.
-
ac-port ac-port-num Indicates the destination port number on the AC to which APs report location packets of AeroScout tags and MUs. The value is an integer that ranges from 1025 to 65535.

Views

Location profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Location packets of AeroScout tags and MUs received by APs can be reported to the AeroScout location server directly or through an AC.

Precautions

You cannot configure a port number that has been occupied by other services; otherwise, the port configuration fails.

For the same location method, via-ac can be configured only in one profile. If via-ac has been configured in the current location profile for a specific location method, it cannot be configured in other profiles for the same location method.

NOTE:

The AeroScout location server actively sets up connections with APs. You need to manually add APs and specify the APs' MAC addresses, port numbers, and IP addresses on the AeroScout location server. If APs report location packets through the AC, you also need to specify the AC's IP address.

Example

# Set the port number for APs to report location packets of AeroScout tags and MUs to 1144.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei] aeroscout server port 1144

aeroscout tag-enable

Function

The aeroscout tag-enable command enables WLAN location of AeroScout tags.

The undo aeroscout tag-enable command disables WLAN location of AeroScout tags.

By default, WLAN location of AeroScout tags is disabled.

Format

aeroscout tag-enable

undo aeroscout tag-enable

Parameters

None

Views

Location profile view

Default Level

2: Configuration level

Usage Guidelines

You can run the aeroscout tag-enable command to enable WLAN location of AeroScout tags.

Example

# Enable WLAN location of AeroScout tags.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei] aeroscout tag-enable

ble low-power-threshold

Function

The ble low-power-threshold command sets a low power alarm threshold for BLE devices or Bluetooth tags.

The undo ble low-power-threshold command restores the low power alarm threshold of BLE devices or Bluetooth tags to the default value.

By default, the low power alarm threshold of BLE devices or Bluetooth tags is 20%.

Format

ble low-power-threshold low-power-threshold

undo ble low-power-threshold

Parameters

Parameter Description Value
low-power-threshold Specifies the low power alarm threshold of BLE devices or Bluetooth tags. The value is an enumerated type. The options are as follows:
  • 0: 0%
  • 20: 20%
  • 40: 40%
  • 60: 60%
  • 80: 80%

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

After the sniffer enable command is executed to enable the Bluetooth monitoring or Bluetooth tag location function of an AP's built-in Bluetooth module, the built-in Bluetooth module will scan and obtain information about surrounding BLE devices or Bluetooth tags. The information includes battery power of BLE devices or Bluetooth tags. When the obtained battery power of a BLE device or Bluetooth tag is lower than the low power alarm threshold, the AC generates an alarm indicating that the BLE device or Bluetooth tag has low battery power.

Example

# Set the low power alarm threshold for BLE devices or Bluetooth tags to 40%.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ble low-power-threshold 40
Related Topics

ble monitoring-list

Function

The ble monitoring-list command adds specified Bluetooth devices to the Bluetooth device monitoring list.

The undo ble monitoring-list command deletes specified Bluetooth devices from the Bluetooth device monitoring list.

By default, no Bluetooth devices are added to the monitoring list.

Format

ble monitoring-list mac mac-address1 [ to mac-address2 ]

undo ble monitoring-list [ mac mac-address1 [ to mac-address2 ] ]

Parameters

Parameter Description Value
mac mac-address1 Specifies the MAC address of a Bluetooth device to be monitored.

The value is in H-H-H format. An H is a hexadecimal number of 4 digits.

to mac-address2 Specifies the end MAC address of a Bluetooth device when Bluetooth devices are added to or deleted from the monitoring list in batches. The mac-address2 value must be equal to or larger than the mac-address1 value. mac-address1 and mac-address2 jointly specify a range of MAC addresses.

The value is in H-H-H format. An H is a hexadecimal number of 4 digits.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the Bluetooth monitoring, Bluetooth tag location, or Bluetooth data transparent transmission function is enabled using the sniffer enable command, all Bluetooth devices are monitored when no Bluetooth device (BLE device, Bluetooth tag, or Bluetooth client) is added to the monitoring list. When any Bluetooth device is offline or has insufficient battery power, an alarm is triggered on the AC accordingly. When Bluetooth devices are added to the monitoring list, only the Bluetooth devices in the list are monitored. When a Bluetooth device in the monitoring list is offline or has insufficient battery power, an alarm is triggered on the AC accordingly. Bluetooth clients do not support low power alarms.

Precautions

After the BLE monitoring, Bluetooth tag location, or Bluetooth data transparent transmission function is disabled using the undo sniffer enable command, an alarm is triggered on the AC indicating that Bluetooth devices are offline.

Bluetooth devices with all-0 or all-F MAC addresses cannot be added to the monitoring list.

Example

# Add the Bluetooth device with MAC address 1234-1234-1000 to the monitoring list.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ble monitoring-list mac 1234-1234-1000

# Add Bluetooth devices with MAC addresses 1234-1234-1000 to 1234-1234-1006 to the monitoring list.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ble monitoring-list mac 1234-1234-1000 to 1234-1234-1006

ble report

Function

The ble report interval command sets an interval at which an AP reports Bluetooth device information.

The undo ble report interval command restores the default interval at which an AP reports Bluetooth device information.

By default, an AP reports Bluetooth device information at an interval of 10 minutes.

Format

ble report interval interval-value

undo ble report interval

Parameters

Parameter

Description

Value

interval interval-value

Specifies the interval at which an AP reports Bluetooth device information.

The value is an integer that ranges from 1 to 60, in minutes.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When an AP collects information about 255 Bluetooth devices, the AP stops collecting information about more Bluetooth devices. When the aging time of Bluetooth device information collected by an AP expires, the Bluetooth device information is deleted and the AP collects information about new Bluetooth devices. When the interval at which an AP reports Bluetooth device information times out, the AP reports Bluetooth device information to an AC. Bluetooth device information includes types, RSSIs, and whether Bluetooth tags are disconnected.

Example

# Set the interval at which an AP reports Bluetooth device information to 20 minutes.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ble report interval 20

ble source

Function

The ble source command configures a global source IP address in packets sent by an AC to a location server.

The undo ble source command deletes a global source IP address from packets sent by an AC to a location server.

By default, the source IP address is not configured in packets sent by an AC to a location server, and the IP address of the route outbound interface is used as the source IP address.

Format

ble source ip-address ip-address

undo ble source

Parameters

Parameter

Description

Value

ip-address ip-address

Specifies a source IPv4 address in packets sent by an AC to a location server.

The value is in dotted decimal notation.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In Bluetooth location scenarios, you can run the ble source command to configure a source IP address in packets sent by an AC to a location server.

Run the ble source command to configure different source IP addresses for the active and standby ACs.

When source IP addresses are configured on an AC using the ble source and source commands at the same time, the source IP address configured using the source command takes effect.

Precautions

  • Ensure that the AC IP address manually configured on the location server is the same as that configured using the ble source command.
  • The source IP address must exist on the AC; otherwise, the configuration does not take effect.

Example

# Configure 10.102.25.23 as the source IP address of the packets sent from the AC to the location server.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ble source ip-address 10.102.25.23

ble-profile (AP group view and AP view)

Function

The ble-profile command binds a BLE profile to an AP group or AP.

The undo ble-profile command unbinds a BLE profile from an AP group or AP.

By default, no BLE profile is bound to an AP group or AP.

Format

ble-profile profile-name

undo ble-profile

Parameters

Parameter

Description

Value

profile-name

Specifies the name of a BLE profile.

The BLE profile name must exist.

Views

AP group view, AP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After creating a BLE profile using the ble-profile (WLAN view) command, you need to bind the profile in the AP view or AP group view to make the settings in the profile take effect.

Precautions

After you bind a BLE profile in the AP view or AP group view, parameter settings in the BLE profile take effect for all APs using this profile.

Example

# Create BLE profile huawei and bind the profile to AP group group1.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ble-profile name huawei
[HUAWEI-wlan-ble-prof-huawei] quit
[HUAWEI-wlan-view] ap-group name group1
[HUAWEI-wlan-ap-group-group1] ble-profile huawei

ble-profile (WLAN view)

Function

The ble-profile command creates a BLE profile or displays the BLE profile view.

The undo ble-profile command deletes a BLE profile.

By default, no BLE profile is created.

Format

ble-profile name profile-name

undo ble-profile { name profile-name | all }

Parameters

Parameter

Description

Value

name profile-name

Specifies the name of a BLE profile, which must be unique and identifies a profile.

The value is a string of 1 to 35 case-insensitive characters. It does not contain question marks (?) or spaces, and cannot start or end with double quotation marks (" ").

all

Deletes all BLE profiles.

-

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run this command to create or delete a BLE profile or enter the BLE profile view to configure the profile. If the specified profile name does not exist, this command creates a new BLE profile and displays the configuration view of this profile. All parameters in this profile use default values. You can also change values of these parameters.

Follow-up Procedure

After creating a BLE profile, you need to run the ble-profile (AP group view and AP view) command in the AP view or AP group view to bind the profile to make the settings in the profile take effect.

Precautions

A BLE profile bound to an AP or AP group cannot be deleted. To delete a BLE profile, unbind it in the AP view or AP group view.

Example

# Create BLE profile huawei and enter its view.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ble-profile name huawei
[HUAWEI-wlan-ble-prof-huawei]

broadcaster enable

Function

The broadcaster enable command enables the Bluetooth broadcast function of an AP's built-in Bluetooth module.

The undo broadcaster enable command disables the Bluetooth broadcast function of an AP's built-in Bluetooth module.

By default, the Bluetooth broadcast function of an AP's built-in Bluetooth module is disabled.

NOTE:
Only the AP4050DN-E supports the Bluetooth broadcast function.

Format

broadcaster enable

undo broadcaster enable

Parameters

None

Views

BLE profile view

Default Level

2: Configuration level

Usage Guidelines

When an AP's built-in Bluetooth module is used as a BLE device, you can run this command to enable the Bluetooth broadcast function. After this function is enabled, the built-in Bluetooth module sends BLE broadcast frames to surrounding devices. The frame content complies with the iBeacon protocol.

Enabling both the Bluetooth scanning and broadcast functions of an AP affects the efficiency for the AP's Bluetooth module to scan surrounding BLE devices. When an AP does not serve as a Bluetooth base station, it is recommended that the broadcast function of the AP be disabled.

Example

# Enable the Bluetooth broadcast function.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ble-profile name huawei
[HUAWEI-wlan-ble-prof-huawei] broadcaster enable
Related Topics

broadcasting-content

Function

The broadcasting-content command configures the content of a BLE broadcast frame sent by an AP's built-in Bluetooth module.

The undo broadcasting-content command restores the default content of a BLE broadcast frame sent by an AP's built-in Bluetooth module.

By default, the UUID, Major, and Minor fields in a BLE broadcast frame sent by an AP's built-in Bluetooth module are null, and the RSSI calibration value is -65 dBm.

NOTE:
Only the AP4050DN-E supports the Bluetooth broadcast function.

Format

broadcasting-content { uuid { uuid-character-string uuid-value | uuid-hex uuid-value } | major { major-character-string major-value | major-hex major-value | major-decimal major-value } | minor { minor-character-string minor-value | minor-hex minor-value | minor-decimal minor-value } | reference-rssi reference-rssi-value }*

undo broadcasting-content

Parameters

Parameter Description Value
uuid uuid-character-string uuid-value Specifies the UUID field in a BLE broadcast frame. UUID is the universally unique identifier of a BLE device. The value is a string of 1 to 16 characters. The default value is null.
uuid uuid-hex uuid-value Specifies the UUID field in a BLE broadcast frame. UUID is the universally unique identifier of a BLE device. The value is in hexadecimal notation. The value length ranges from 1 to 32 bytes. The default value is null.
major major-character-string major-value Specifies the Major field in a BLE broadcast frame. This field specifies a major group and is combined with the Minor field to define information about a BEL device, for example, location of a BLE device. The value is a string of 1 or 2 characters. The default value is null.
major major-hex major-value Specifies the Major field in a BLE broadcast frame. This field specifies a major group and is combined with the Minor field to define information about a BEL device, for example, location of a BLE device. The value is in hexadecimal notation. The value length ranges from 1 to 4 bytes. The default value is null.
major major-decimal major-value Specifies the Major field in a BLE broadcast frame. This field specifies a major group and is combined with the Minor field to define information about a BEL device, for example, location of a BLE device. The value is an integer that ranges from 0 to 65535. The default value is null.
minor minor-character-string minor-value Specifies the Minor field in a BLE broadcast frame. This field specifies a minor group and is combined with the Major field to define information about a BEL device, for example, location of a BLE device. The value is a string of 1 or 2 characters. The default value is null.
minor minor-hex minor-value Specifies the Minor field in a BLE broadcast frame. This field specifies a minor group and is combined with the Major field to define information about a BEL device, for example, location of a BLE device. The value is in hexadecimal notation. The value length ranges from 1 to 4 bytes. The default value is null.
minor minor-decimal minor-value Specifies the Minor field in a BLE broadcast frame. This field specifies a minor group and is combined with the Major field to define information about a BEL device, for example, location of a BLE device. The value is an integer that ranges from 0 to 65535. The default value is null.
reference-rssi reference-rssi-value Specifies the RSSI calibration value of a BLE device. RSSI calibration value indicates the RSSI value of a BLE device measured at a distance of 1 m. It is used to estimate the distance between the BLE device and Bluetooth terminals. The value is an integer that ranges from -97 to -50, in dBm. The default value is -65 that is measured when the transmit power of an APs' built-in Bluetooth module is 0 dBm.

Views

BLE profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After enabling the broadcast function of an AP's built-in Bluetooth module using the broadcaster enable command, you can run the broadcasting-content command to configure the content of BLE broadcast frames sent by the module.

Precautions

The RSSI calibration value in a BLE broadcast frame is set based on the actual measurement result.

After changing the transmit power of a built-in Bluetooth module using the tx-power (BLE profile view) command, you need to remeasure and reconfigure the RSSI calibration value. Therefore, you are advised to run the tx-power (BLE profile view) command to configure the transmit power of a built-in Bluetooth module before configuring the RSSI calibration value.

Example

# Configure the content of a BLE broadcast frame sent by an AP's built-in Bluetooth module. Set UUID uuid-hex to 12345678123456789, Major major-hex to A22, Minor minor-hex to 011, and reference-rssi to -70.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ble-profile name huawei
[HUAWEI-wlan-ble-prof-huawei] broadcasting-content uuid uuid-hex 12345678123456789 major major-hex A22 minor minor-hex 011 reference-rssi -70 

broadcasting-content (AP group view and AP view)

Function

The broadcasting-content uuid command sets a universally unique identifier (UUID) of the Bluetooth Low Energy (BLE) broadcast frames sent by an AP's built-in Bluetooth module.

The undo broadcasting-content uuid command restores the UUID of the BLE broadcast frames sent by an AP's built-in Bluetooth module to the default value.

By default, the UUID of the BLE broadcast frames sent by an AP's built-in Bluetooth module is null.

NOTE:
Only the AP4050DN-E supports the Bluetooth broadcast function.

Format

broadcasting-content uuid { uuid-character-string uuid-value | uuid-hex uuid-value }

undo broadcasting-content uuid

Parameters

Parameter Description Value
uuid uuid-character-string uuid-value Specifies the UUID field of BLE broadcast frames, which is a string of characters and used to identity devices. The value is a string of 1 to 16 characters.
uuid uuid-hex uuid-value Specifies the UUID field of BLE broadcast frames, which is in hexadecimal notation and used to identity devices. The value is a string of 1 to 32 hexadecimal digits.

Views

AP group view and AP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After enabling the broadcast function of an AP's built-in Bluetooth module using the broadcaster enable command, you can run the broadcasting-content uuid command to set a UUID of the BLE broadcast frames. If you do not want to set a UUID of BLE broadcast frames in a BLE profile, set it in the AP group view or AP view.

Precautions

The UUIDs set in the AP view, BLE profile bound to the AP view, AP group view, and BLE profile bound to the AP group take effect in the following order:
  1. UUID set in the AP view
  2. UUID set in the BLE profile bound to the AP view
  3. UUID set in the AP group view
  4. UUID set in the BLE profile bound to the AP group view

Example

# Set the UUID of the BLE broadcast frames sent by an AP's Bluetooth module in the AP view to 12345678123456789 in hexadecimal notation.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-id 0
[HUAWEI-wlan-ap-0] broadcasting-content uuid uuid-hex 12345678123456789

broadcasting-interval

Function

The broadcasting-interval command configures the interval for an AP's built-in Bluetooth module to send BLE broadcast frames.

The undo broadcasting-interval command restores the default interval for an AP's built-in Bluetooth module to send BLE broadcast frames.

By default, the built-in Bluetooth module of an AP sends BLE broadcast frames at an interval of 500 ms.

NOTE:
Only the AP4050DN-E supports the Bluetooth broadcast function.

Format

broadcasting-interval broadcasting-interval-value

undo broadcasting-interval

Parameters

Parameter Description Value
broadcasting-interval-value Specifies the interval for an AP's built-in Bluetooth module to send BLE broadcast frames. The value is an integer that ranges from 100 to 10240, in milliseconds.

Views

BLE profile view

Default Level

2: Configuration level

Usage Guidelines

After enabling the broadcast function of an AP's built-in Bluetooth module using the broadcaster enable command, you can run the broadcasting-interval command to set the interval for the module to send BLE broadcast frames.

Example

# Set the interval for an AP's built-in Bluetooth module to send BLE broadcast frames to 1000 ms.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ble-profile name huawei
[HUAWEI-wlan-ble-prof-huawei] broadcasting-interval 1000

display ble-profile

Function

The display ble-profile command displays configuration and reference information about a BLE profile.

Format

display ble-profile { all | name profile-name }

Parameters

Parameter Description Value
all Displays information about all BLE profiles. -
name profile-name Displays information about the BLE profile with a specified name. The BLE profile name must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view configuration and reference information about a BLE profile.

Example

# Display information about all BLE profiles.

<HUAWEI> display ble-profile all
---------------------------------------------------------------------------
Profile name                        Reference
---------------------------------------------------------------------------
huawei                              1
---------------------------------------------------------------------------
Total: 1
Table 11-142  Description of the display ble-profile all command output

Item

Description

Profile name

BLE profile name.

Reference

Number of times a BLE profile is referenced.

# Display information about BLE profile huawei.

<HUAWEI> display ble-profile name huawei
------------------------------------------------------------------------------
Broadcaster switch            : disable
Broadcaster interval(ms)      : 500
Broadcaster content
  UUID                        : 00000000000000012345678123456789(hex)
  major                       : 0A22(hex)
  minor                       : 0011(hex)
  Reference RSSI              : -70
Transmit power                : 0
Sniffer switch                : disable
Sniffer mode                  : -
Source IP address             : 0.0.0.0
Report switch                 : enable
Report mode                   : immediate
Report interval(s)            : 10
Report server                 : 0.0.0.0
Report server port            : -
Report via-AC                 : disable                                        
Report via-AC port            : -   
------------------------------------------------------------------------------
Table 11-143  Description of the display ble-profile name profile-name command output

Item

Description

Broadcaster switch

Whether the Bluetooth broadcast function is enabled. The options are as follows:
  • enable: The Bluetooth broadcast function is enabled.
  • disable: The Bluetooth broadcast function is disabled.

To configure this parameter, run the broadcaster enable command.

Broadcaster interval(ms)

Interval at which BLE broadcast frames are sent.

To configure this parameter, run the broadcasting-interval command.

Broadcaster content

Content of a BLE broadcast frame.

To configure this parameter, run the broadcasting-content command.

UUID

UUID field in a BLE broadcast frame. UUID refers to the universally unique identifier of a Bluetooth device.

major

Major field in a BLE broadcast frame. This field specifies a major group and is combined with the Minor field to define information about a Bluetooth device, for example, location of a Bluetooth device.

minor

Minor field in a BLE broadcast frame. This field specifies a minor group and is combined with the Major field to define information about a Bluetooth device, for example, location of a Bluetooth device.

Reference RSSI

RSSI calibration value. RSSI calibration value refers to the RSSI of a Bluetooth device measured at a distance of 1 m. It is used to calculate the distance between a Bluetooth device and a Bluetooth terminal or tag.

Transmit power

Transmit power of an AP's built-in Bluetooth module.

To configure this parameter, run the tx-power (BLE profile view) command.

Sniffer switch

Whether the Bluetooth function is enabled. The options are as follows:
  • enable: The Bluetooth function is enabled.
  • disable: The Bluetooth function is disabled.

To configure this parameter, run the sniffer enable command.

Source IP address

Source IP address used by an AC to report BLE packets.

To configure the parameter, run the source (BLE profile view) command.

Sniffer mode

Working mode of an AP's built-in Bluetooth module.

To configure this parameter, run the sniffer enable command.

Report switch

Whether an AP is enabled to send Bluetooth packets. The options are as follows:
  • enable: An AP is enabled to send Bluetooth packets.
  • disable: An AP is disabled from sending Bluetooth packets.

To configure this parameter, run the report enable command.

Report mode

Mode in which an AP sends Bluetooth packets.

To configure this parameter, run the report-mode command.

Report interval(s)

Interval at which an AP sends Bluetooth packets.

To configure this parameter, run the report-mode command.

Report server

IP address of a Bluetooth server.

To configure this parameter, run the report-to-server command.

Report server port

Destination port number on a server to which Bluetooth packets are sent.

To configure this parameter, run the report-to-server command.

Report via-AC

Whether Bluetooth packets are sent to a server through an AC. The options are as follows:
  • enable: Bluetooth packets are sent to a server through an AC.
  • disable: Bluetooth packets are sent directly to a server.

To configure this parameter, run the report-to-server command.

Report via-AC port

Number of the port on an AC through which an AP sends Bluetooth packets.

To configure this parameter, run the report-to-server command.

display location-profile

Function

The display location-profile command displays configuration information about a location profile.

The display references location-profile command displays reference information about a location profile.

Format

display location-profile { all | name profile-name }

display references location-profile name profile-name

Parameters

Parameter

Description

Value

all

Specifies all location profiles.

-

name profile-name

Specifies a location profile.

The location profile name must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view configuration information about a location profile to verify the configuration.

Example

# Display all location profiles.

<HUAWEI> display location-profile all
----------------------------------------------------------
Profile name                   Reference
----------------------------------------------------------
default                             1
location-profile-1                  0
location-profile-2                  10
----------------------------------------------------------
Total: 3
Table 11-144  Description of the display location-profile all command output

Item

Description

Profile name

Name of a location profile.

Reference

Number of times a location profile is referenced.

# Display the default configuration of the location profile default.

<HUAWEI> display location-profile name default
------------------------------------------------------------
Aeroscout-tag                  : disable
Aeroscout-mu                   : disable
Aeroscout ae-port              : -
Aeroscout compound-time(100ms) : 65535
Aeroscout via-AC               : disable
Aeroscout via-AC port          : -
Ekahau-tag                     : disable
Ekahau erc IP-address          : 0.0.0.0
Ekahau erc port                : -
Ekahau via-AC                  : disable
Ekahau via-AC port             : -
Source IP-address              : 0.0.0.0
private mu                     : disable
private server                 : 0.0.0.0
private server port            : -
private via-AC                 : disable
private via-AC port            : -
private report-frequency(ms)   : 20000
private mu protocol-version    : v3
------------------------------------------------------------
Table 11-145  Description of the display location-profile name default command output

Item

Description

Aeroscout-tag

Whether WLAN location of AeroScout tags is enabled.
  • enable: The function is enabled.
  • disable: The function is disabled.

To configure the function, run the aeroscout tag-enable command.

Aeroscout-mu

Whether WLAN location of AeroScout MUs is enabled.
  • enable: The function is enabled.
  • disable: The function is disabled.

To configure the function, run the aeroscout mu-enable command.

Aeroscout ae-port

Port number used by APs to report location packets.

To configure the parameter, run the aeroscout server command.

Aeroscout compound-time

Aggregation time of AeroScout location packets.

To configure the parameter, run the aeroscout compound-time command.

Aeroscout via-AC

Whether AeroScout location packets are reported to the location server through an AC.
  • enable: The AeroScout location packets are reported to the location server through an AC.
  • disable: The AeroScout location packets are not reported to the location server through an AC.

To configure the parameter, run the aeroscout server command.

Aeroscout via-AC port

Port number used by an AC to report AeroScout location packets.

To configure the parameter, run the aeroscout server command.

Ekahau-tag

Whether WLAN location of Ekahau tags is enabled.
  • enable: The function is enabled.
  • disable: The function is disabled.

To configure the function, run the ekahau tag-enable command.

Ekahau erc IP-address

IP address of the Ekahau location server.

To configure the parameter, run the ekahau server command.

Ekahau erc port

Port number of the Ekahau location server.

To configure the parameter, run the ekahau server command.

Ekahau via-AC

Whether Ekahau location packets are reported to the location server through an AC.
  • enable: The Ekahau location packets are reported to the location server through an AC.
  • disable: The Ekahau location packets are not reported to the location server through an AC.

To configure the parameter, run the ekahau server command.

Ekahau via-AC port

Port number used by an AC to report Ekahau location packets.

To configure the parameter, run the ekahau server command.

Source IP-address

Source IP address used by an AC to report location packets.

To configure the parameter, run the source (location profile view) command.

private mu

Whether terminal location is enabled.
  • enable: The function is enabled.
  • disable: The function is disabled.

To configure the function, run the private mu-enable command.

private server

IP address of the terminal location server.

To configure the parameter, run the private server command.

private server port

Port number of the terminal location server.

To configure the parameter, run the private server command.

private via-AC

Whether terminal location packets are reported to the location server through an AC.
  • enable: The terminal location packets are reported to the location server through an AC.
  • disable: The terminal location packets are not reported to the location server through an AC.

To configure the parameter, run the private server command.

private via-AC port

Port number used by an AC to report terminal location packets.

To configure the parameter, run the private server command.

private report-frequency(ms)

Interval at which an AP reports terminal location packets.

To configure the parameter, run the private report-frequency command.

private mu protocol-version Terminal location protocol version.

To configure the parameter, run the private mu protocol-version command.

# Display reference information about the location profile default.

<HUAWEI> display references location-profile name default
------------------------------------------------------------
Reference type  Reference name                       Reference radio
------------------------------------------------------------
AP group       ap-group1                             Radio-0

AP ID          0                                     Radio-1

------------------------------------------------------------
Total: 2
Table 11-146  Description of the display references location-profile command output

Item

Description

Reference type

Type of the profile that references the location profile.

Reference name

Name of the profile that references the location profile.

Reference radio

AP radio by which a location profile is referenced

display references ble-profile

Function

The display references ble-profile command displays reference information about a BLE profile.

Format

display references ble-profile name profile-name

Parameters

Parameter Description Value
name profile-name Displays reference information about a specified BLE profile. The BLE profile name must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view reference information about a BLE profile.

Example

# Display reference information about BLE profile huawei.

<HUAWEI> display references ble-profile name huawei
--------------------------------------------------------------------------
Reference type               Reference name
--------------------------------------------------------------------------
AP group                     ap-group1
--------------------------------------------------------------------------
Total: 1
Table 11-147  Description of the display references ble-profile command output

Item

Description

Reference type

Type of the profile that references a BLE profile.

Reference name

Name of the profile that references a BLE profile.

display wlan ble global configuration

Function

The display wlan ble global configuration command displays global configurations of Bluetooth devices.

Format

display wlan ble global configuration

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view global configurations of Bluetooth devices and know the configuration about the Bluetooth device information report function.

Example

# Display global configurations of Bluetooth devices.

<HUAWEI> display wlan ble global configuration
--------------------------------------------------------------------------------   
BLE report interval(min)        :10                                                
BLE low power threshold(%)     :20                                                 
--------------------------------------------------------------------------------   
Table 11-148  Description of the display wlan ble global configuration command output

Item

Description

BLE report interval(min)

Interval at which an AP reports Bluetooth device information.

BLE low power threshold(%)

Low power alarm threshold of Bluetooth devices.

Related Topics

display wlan ble monitoring-list

Function

The display wlan ble monitoring-list command displays BLE devices that have been added to the monitoring list.

Format

display wlan ble monitoring-list

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After running the ble monitoring-list command to add BLE devices to the monitoring list, you can run the display wlan ble monitoring-list command to check BLE devices that have been added to the monitoring list.

Example

# Check all BLE devices that have been added to the monitoring list.

<HUAWEI> display wlan ble monitoring-list
--------------------------------------------------------------------------------
Index        MAC                                                                
--------------------------------------------------------------------------------
0            1234-1234-0000                                                     
1            1234-1234-7777                                                     
--------------------------------------------------------------------------------
Total: 2
Table 11-149  Description of the display wlan ble monitoring-list command output

Item

Description

Index

Index.

MAC

MAC address of a BLE device that has been added to the monitoring list.

Related Topics

display wlan ble site-info

Function

The display wlan ble site-info command displays information about Bluetooth devices that are scanned by an AP's built-in Bluetooth module.

Format

display wlan ble site-info { all | mac-address mac-address | host-ap { valid | host-ap-id ap-id | host-ap-name ap-name } }

Parameters

Parameter Description Value
all Displays information about all Bluetooth devices. -
mac-address mac-address Displays information about a specified Bluetooth device.

The value is in H-H-H format. An H is a hexadecimal number of 4 digits.

host-ap valid Displays information about APs' built-in Bluetooth modules among all Bluetooth device information. -
host-ap host-ap-id ap-id Displays information about the Bluetooth module built in an AP with the specified ID.

The AP ID must exist.

host-ap host-ap-name ap-name Displays information about the Bluetooth module built in an AP with the specified name.

The AP name must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After you enable the Bluetooth monitoring function using the sniffer enable command, an AP's built-in Bluetooth module scans surrounding Bluetooth devices and obtains their information. You can then run this command to view obtained information about Bluetooth devices scanned by the built-in Bluetooth module.

After the Bluetooth broadcast function is enabled for an AP with the built-in Bluetooth module, the Bluetooth module works as a Bluetooth station, whose information can be found in Bluetooth device information. If the Bluetooth MAC address label of an AP is lost, it is time-consuming to locate the mapping between the AP and built-in Bluetooth module. In this case, configure the host-ap parameter to filter out information about the AP's built-in Bluetooth module among all Bluetooth device information.

Example

# Display information about all Bluetooth devices.

<HUAWEI> display wlan ble site-info all
---------------------------------------------------------------------------------------------------------------------
Index  MAC             Host AP ID  Host AP name RSSI  Power  Type        DetachedFlag Aging-Timeout(m)  Advertisement data
---------------------------------------------------------------------------------------------------------------------
0      0000-0101-0202  4           AP4          -30   50%    asset-tag   N            57                02-02-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-fa
1      0000-0101-0303  --          --           -31   51%    asset-tag   N            57                01-02-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-fa
2      0000-0101-0505  12          AP12         -33   55%    asset-tag   N            57                03-02-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-fa
---------------------------------------------------------------------------------------------------------------------
Total: 3
Table 11-150  Description of the display wlan ble site-info command output

Item

Description

Index

Index.

MAC

MAC address of a Bluetooth device.

Host AP ID

ID of the AP to which a Bluetooth device belongs. The display of -- indicates that Bluetooth device information does not belong to the built-in Bluetooth module of the AP.

Host AP name

Name of the AP to which a Bluetooth device belongs. The display of -- indicates that Bluetooth device information does not belong to the built-in Bluetooth module of the AP.

RSSI

Signal strength of a Bluetooth device received by an AP's built-in Bluetooth module.

Power

Battery power of a Bluetooth device. If no information about battery power is obtained, this item is displayed as --.

Type

Bluetooth device type. The options are as follows:
  • ibeacon: Bluetooth terminal
  • asset-tag: Bluetooth tag
  • sensor-tag: Bluetooth client

DetachedFlag

Whether a Bluetooth device is disconnected. The options are as follows:
  • Y: The Bluetooth device is disconnected.
  • N: The Bluetooth device is connected.
NOTE:
Bluetooth device disconnection check is not supported in Bluetooth monitoring or transparent transmission mode. This parameter is valid only when the Bluetooth device type is asset-tag.

Aging-Timeout(m)

Remaining aging time of a Bluetooth device. The maximum value is 60 minutes.

Advertisement data

Content of data carried in a broadcast frame sent by a Bluetooth device. The maximum length of a displayed broadcast frame is 21 bytes.

Related Topics

display wlan location config-info aeroscout

Function

The display wlan location config-info aeroscout command displays configurations delivered to APs from the AeroScout location server.

Format

display wlan location config-info aeroscout { ap-id ap-id | ap-name ap-name }

Parameters

Parameter Description Value
ap-id ap-id

Displays LBS configuration of the AP with a specified AP ID.

The AP ID must exist.

ap-name ap-name

Displays LBS configuration of the AP with a specified AP name.

The AP name must already exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

You can run the display wlan location config-info aeroscout command to check configurations delivered to APs from the AeroScout location server.

Prerequisites

AeroScout location has been enabled using the aeroscout tag-enable or aeroscout mu-enable command, and the AeroScout location server has delivered the configuration information to the AP.

Example

# Display AeroScout location configuration on the AP ap_4.

<HUAWEI> display wlan location config-info aeroscout ap-name ap_4
----------------------------------------------------------------
AP ID                            : 4
AP name                          : ap_4
AP MAC address                   : 1051-7254-5a80
Response IP address              : 10.3.3.3
Response port                    : 1144
AP tag mode                      : start
AP MU mode                       : start
Dilution factor                  : 100
Dilution timeout(s)              : 5
Tags multicast address           : 010c-cc00-0000
Compounded message timeout(0.1s) : 12
Table 11-151  Description of the display wlan location config-info aeroscout command output

Item

Description

AP ID

AP ID.

AP name

Name of the AP.

AP MAC address

MAC address of the AP.

Response IP address

IP address of the location server that receives the Response packets from the AP.

Response port

Listening port of the location server from which the location server receives the Response packets from the AP.

AP tag mode

Tag detection status on the AP:
  • start: The AP starts tag detection.
  • stop: The AP stops tag detection.

AP MU mode

MU detection status on the AP:
  • start: The AP starts tag detection.
  • stop: The AP stops tag detection.

Dilution factor

Count-based packet dilution. For example, the value 100 indicates that one out of 100 packets is reported.

Dilution timeout(s)

Time-based packet dilution. For example, the value 1 indicates that one packet is reported every second.

Tags multicast address

Multicast MAC address of the tag.

Compounded message timeout(0.1s)

Maximum time during which the AP caches tag, in 100 milliseconds.

display wlan location device-info tag

Function

The display wlan location device-info tag command displays tag location information about APs.

Format

display wlan location device-info tag { all | ap-id ap-id | ap-name ap-name }

Parameters

Parameter

Description

Value

all

Displays tag location information about all APs.

-

ap-id ap-id

Displays tag location information about a specified AP ID.

The AP ID must exist.

ap-name ap-name

Displays tag location information about a specified AP name.

The AP name must already exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view tag location information about APs, facilitating tag location statistics collection.

Example

# Display tag location information about all APs.

<HUAWEI> display wlan location device-info tag all
AP ID   AP name     Tag type        Tag MAC           Channel     RSSI
------------------------------------------------------------------------------
0       huawei      AeroScout       1040-8002-6f80    11          -50
1       ap3         Ekahau          1040-8002-6420    11          -50
------------------------------------------------------------------------------
Total: 2
Table 11-152  Description of the display wlan location device-info tag command output

Item

Description

AP ID

AP ID.

AP name

AP name.

Tag type

Type of the tag. The value is of the enumerated type.
  • Ekahau: Ekahau tag
  • AeroScout: AeroScout tag

Tag MAC

MAC address of the located tag.

Channel

Working channel of the located tag.

RSSI

RSSI of the located tag, in dBm.

display wlan location statistics aeroscout

Function

The display wlan location statistics aeroscout command displays LBS statistics about AeroScout tags and MUs.

Format

display wlan location statistics aeroscout

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

  • If APs are configured to report AeroScout tag packets to the AeroScout location server through an AC, the display wlan location statistics aeroscout command can display location statistics.

  • If APs are configured to report AeroScout tag packets to the AeroScout location server directly but not through an AC, the display wlan location statistics aeroscout command cannot display location statistics, and all fields are displayed as "0".

Example

# Displays LBS statistics about AeroScout tags and MUs.

<HUAWEI> display wlan location statistics aeroscout
----------------------------------------------------------------
Request protocol version      : 0
Request AP status             : 0
Set configuration             : 0
Set tags mode                 : 0
Set MU mode                   : 0
Request debug information     : 0
ACK                           : 0
NACK                          : 0
Protocol version report       : 0
AP status report              : 0
Tag report                    : 0
MU report                     : 0
AP debug report               : 0
Compounded reports message    : 0
Generic AP notification       : 0
----------------------------------------------------------------
Table 11-153  Description of the display wlan location statistics aeroscout command output

Item

Description

Request protocol version

Number of Request packets that the location server sends to the AP to check the LBS protocol version number supported by the AP.

Request AP status

Number of Request packets that the location server sends to the AP to check support of the AP for the LBS protocol.

Set configuration

Configuration information sent by the location server, which includes multicast MAC address of the tag that the AP needs to detect and the maximum time during which the AP caches tag information.

Set tags mode

Number of packets that the location server sends to the AP to inform the AP to start or stop sending tag information.

Set MU mode

Number of packets that the location server sends to the AP to inform the AP to start or stop sending MU information.

Request debug information

Number of packets that the location server sends to the AP to check AP statistics.

ACK

Number of ACK packets that the AC sends to the location server.

NACK

Number of NACK packets that the AC sends to the location server.

Protocol version report

Number of Response packets sent by the AP to the location server that carry the LBS protocol version number supported by the AP.

AP status report

Number of Response packets sent by the AP to the location server to notify the location server of the radio status and support for the LBS protocol.

Tag report

Number of tag messages sent by the AP.

MU report

Number of MU messages sent by the AP.

AP debug report

Number of packets carrying AP statistics sent by the AP.

Compounded reports message

Number of tag messages that the AP sends to the location server after the cache time set in the Set configuration packets expires.

Generic AP notification

Number of packets that the AC sends to the location server to notify the location server of AP errors.

ekahau server

Function

The ekahau server command sets the destination IP address and port number for APs to report Ekahau tag location packets.

The undo ekahau server command deletes the configured destination IP address and port number for APs to report Ekahau tag location packets.

By default, no destination IP address or port number is configured for APs to report Ekahau tag location packets.

Format

ekahau server ip-address ip-address port port-num [ via-ac ac-port ac-port-num ]

undo ekahau server

Parameters

Parameter Description Value
ip-address ip-address Specifies the IPv4 address of the Ekahau location server.

The value is in dotted decimal notation.

port port-num

Specifies the destination port number on the Ekahau location server to which APs directly report Ekahau tag location packets.

Specifies the destination port number on the Ekahau location server to which APs report Ekahau tag location packets through an AC.

The value is an integer that ranges from 1025 to 65535.
via-ac Specifies that the Ekahau tag location packets received by APs are reported to the Ekahau location server through an AC. -
ac-port ac-port-num Specifies the destination port number on the AC to which APs report Ekahau tag location packets. The value is an integer that ranges from 1025 to 65535.

Views

Location profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Ekahau tag location packets received by APs can be reported to the Ekahau location server directly or through an AC.

Precautions

You cannot configure a port number that has been occupied by other services; otherwise, the port configuration fails.

For the same location method, via-ac can be configured only in one profile. If via-ac has been configured in the current location profile for a specific location method, it cannot be configured in other profiles for the same location method.

Example

# Set the destination IP address and port number on the location server to which APs report Ekahau tag location packets to 192.168.1.2 and 8569, respectively.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei] ekahau server ip-address 192.168.1.2 port 8569

ekahau tag-enable

Function

The ekahau tag-enable command enables WLAN location of Ekahau tags.

The undo ekahau tag-enable command disables WLAN location of Ekahau tags.

By default, WLAN location of Ekahau tags is disabled.

Format

ekahau tag-enable

undo ekahau tag-enable

Parameters

None

Views

Location profile view

Default Level

2: Configuration level

Usage Guidelines

You can run the ekahau tag-enable command to enable WLAN location of Ekahau tags.

Example

# Enable WLAN location of Ekahau tags.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei] ekahau tag-enable

location source

Function

The location source command configures a global source IP address in packets sent by an AC to a location server.

The undo location source command deletes a global source IP address from packets sent by an AC to a location server.

By default, the source IP address is not configured in packets sent by an AC to a location server.

Format

location source ip-address ip-address

undo location source

Parameters

Parameter

Description

Value

ip-address ip-address

Specifies a source IPv4 address in packets sent by an AC to a location server.

The value is in dotted decimal notation.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the location source command to configure a source IP address in UDP packets sent by an AC to a location server.

Run the location source command to configure different source IP addresses for the active and standby ACs.

When source IP addresses are configured on an AC using the location source and source commands at the same time, the source IP address configured using the source command takes effect.

Precautions

  • Ensure that the AC IP address manually configured on the location server is the same as that configured using the location source command.
  • The source IP address must exist on the AC; otherwise, the configuration does not take effect.
  • In scenarios where Huawei proprietary terminal location protocols are used, an AC uses the source IP address of the CAPWAP tunnel to send packets to a location server. The source IP address specified by the location source command does not take effect.

Example

# Configure 10.102.25.23 as the source IP address of the UDP packets sent from the AC to the location server.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location source ip-address 10.102.25.23

location-profile

Function

The location-profile command binds a location profile to an AP radio.

The undo location-profile command unbinds a location profile from an AP radio.

By default, no location profile is bound to a radio.

Format

location-profile profile-name radio { radio-id | all }

undo location-profile radio { radio-id | all }

Parameters

Parameter

Description

Value

profile-name

Specifies the name of a location profile.

The location profile name must already exist.
radio radio-id

Specifies the ID of the radio to which the location profile is bound.

The value is an integer that ranges from 0 to 2.

Only the AP4030TN, AP4051TN, and AP8050TN-HD supports three radios.

all

Binds the location profile to all radios.

-

Views

AP group view, AP view

Default Level

2: Configuration level

Usage Guidelines

You can run this command to bind a location profile to an AP group radio or AP radio. After the binding, the parameters of the location profile will be applied to the AP group radio or AP radio.

Example

# Bind the location profile default to radio 0 of the AP group ap-group1.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap-group name ap-group1
[HUAWEI-wlan-ap-group-ap-group1] location-profile default radio 0

location-profile (WLAN view)

Function

The location-profile command creates a location profile or displays the location profile view.

The undo location-profile command deletes a location profile.

By default, no location profile is created.

Format

location-profile name profile-name

undo location-profile { name profile-name | all }

Parameters

Parameter

Description

Value

name profile-name

Specifies the name of a location profile, which uniquely identifies a location profile.

The value is a string of 1 to 35 case-insensitive characters. It does not contain question marks (?) or spaces, and cannot start or end with double quotation marks (" ").

all

Deletes all location profiles.

-

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

The location-profile command creates or deletes a location profile or displays the location profile view in which you can configure the profile. If the specified profile name does not exist, the command creates a new location profile and displays the view of this location profile, and all parameters in the location profile use default values. You can also change values of these parameters.

Example

# Create the location profile huawei.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei]

private mu protocol-version

Function

The private mu protocol-version command sets the terminal location protocol version.

The undo private mu protocol-version command restores the default terminal location protocol version.

The default terminal location protocol version is v3.

Format

private mu protocol-version { v3 | v5 }

undo private mu protocol-version

Parameters

Parameter

Description

Value

v3 Sets the protocol version to v3. -
v5 Sets the protocol version to v5. -

Views

Location profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the terminal location protocol version is v5, APs report more information to the location server, such as the timestamp (the time when APs scan STAs). The location server obtains the information to improve location accuracy.

Precautions

The terminal location protocol version must be the supported by the location server.

Example

# Set the terminal location protocol version to v5.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei] private mu protocol-version v5

private mu-enable

Function

The private mu-enable command enables terminal location of APs.

The undo private mu-enable command disables terminal location of APs.

By default, terminal location of APs is disabled.

Format

private mu-enable

undo private mu-enable

Parameters

None

Views

Location profile view

Default Level

2: Configuration level

Usage Guidelines

You can run the private mu-enable command to enable terminal location of APs.

Example

# Enable terminal location of APs.
<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei] private mu-enable

private report-frequency

Function

The private report-frequency command sets the interval at which an AP reports channel scan information.

The undo private report-frequency command restores the default interval at which an AP reports channel scan information.

By default, an AP reports channel scan information every 20000 ms.

Format

private report-frequency time

undo private report-frequency

Parameters

Parameter Description Value
time Specifies the interval at which an AP reports channel scan information. The value is an integer that ranges from 500 ms to 60000 ms.

Views

Location profile view

Default Level

2: Configuration level

Usage Guidelines

During terminal location, an AP periodically scans channels to collect data. The collected data is buffered and updated on the AP, then reported to the location server at specified intervals.

Example

# Set the interval at which an AP reports channel scan information to 30000 ms.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei] private report-frequency 30000
Related Topics

private server

Function

The private server command configures the destination IP address and port number for APs to report terminal location data.

The undo private server command restores the default destination IP address and port number for APs to report terminal location data.

By default, no destination IP address or port number is configured for APs to report terminal location data.

Format

private server ip-address ip-address port port-num [ via-ac ac-port ac-port-num ]

undo private server

Parameters

Parameter Description Value
ip-address ip-address

Specifies the server's IPv4 address to which the AP reports terminal location data.

The value is in dotted decimal notation.

port port-num

Specifies the destination port number on the location server to which APs directly report terminal location data.

Specifies the destination port number on the location server to which APs report terminal location data through an AC.

The value is an integer that ranges from 5000 to 65535.
via-ac

Specifies that terminal location data is sent to a server through an AC

-
ac-port ac-port-num

Specifies the destination port number on the AC to which APs report terminal location data.

The value is an integer that ranges from 5000 to 65535.

Views

Location profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After an AP completes channel scan, the AP can report the collected data to the location server in the following two methods.
  • The AP directly reports the data to the location server.
  • The AP reports the collected data to the location server through an AC.

When the AP and the location server are located on different LANs, the AP must report the data to the AC first. The AC must identify information about authorized and unauthorized terminals based on the location data and report the information to the location server.

If the route between the AP and location server is reachable, and the AC is not required to identify information about authorized and unauthorized terminals, configure the AP to send data to the location server directly, preventing adverse impact of the location function on AC performance and WLAN services.

Precautions

You cannot configure a port number that has been occupied by other services; otherwise, the port configuration fails.

For the same location method, via-ac can be configured only in one profile. If via-ac has been configured in the current location profile for a specific location method, it cannot be configured in other profiles for the same location method.

Example

# Configure APs to report terminal location data directly to the location server, and set the server's IP address and port number to 192.168.1.2 and 32180, respectively.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei] private server ip-address 192.168.1.2 port 32180

report enable

Function

The report enable command enables APs to send Bluetooth packets.

The undo report enable command disables APs from sending Bluetooth packets.

By default, an AP is disabled from sending Bluetooth packets.

Format

report enable

undo report enable

Parameters

None

Views

BLE profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the Bluetooth tag location or Bluetooth data transparent transmission function is configured on an AP, run the report enable command to enable the AP to send the Bluetooth packets to a location server or an AC.

Example

# Enable APs to send Bluetooth packets.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ble-profile name huawei
[HUAWEI-wlan-ble-prof-huawei] report enable

report-mode

Function

The report-mode command sets the mode and interval for APs to send Bluetooth packets.

The undo report-mode command cancels the configured mode and interval for APs to send Bluetooth packets.

By default, an AP sends Bluetooth packets at an interval of 10 seconds.

Format

report-mode { immediate | periodic [ interval interval ] }

undo report-mode

Parameters

Parameter

Description

Value

immediate

Enables APs to send Bluetooth packets immediately.

-

periodic

Enables APs to send Bluetooth packets periodically.

-

interval interval

Specifies an interval at which Bluetooth packets are sent.

The value is an integer that ranges from 1 to 600, in seconds.

Views

BLE profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When APs are enabled to send Bluetooth packets immediately, the location accuracy is high but AP performance may be affected. When APs are enabled to send Bluetooth packets periodically, the location accuracy is low but AP performance is not affected.

Precautions

When APs are enabled to send Bluetooth packets periodically, set a proper interval at which Bluetooth packets are sent. Otherwise, location results may be inaccurate.

Example

# Enable APs to send Bluetooth packets immediately.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ble-profile name huawei
[HUAWEI-wlan-ble-prof-huawei] report-mode immediate

report-to-server

Function

The report-to-server command configures the destination IP address and port number for APs to send Bluetooth packets.

The undo report-to-server command restores the default destination IP address and port number for APs to send Bluetooth packets.

By default, no destination IP address or port number is configured for APs to send Bluetooth packets.

Format

report-to-server { ip-address ip-address | ipv6-address ipv6-address } port port-num [ via-ac ac-port ac-port-num ]

undo report-to-server

Parameters

Parameter Description Value
ip-address ip-address

Specifies the IPv4 address of the location server to which APs send Bluetooth packets.

The value is in dotted decimal notation.

ipv6-address ipv6-address

Specifies the IPv6 address of the location server to which APs send Bluetooth packets.

The value is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.

port port-num

Specifies the destination port number on the location server to which APs directly report Bluetooth packets.

Specifies the destination port number on the location server to which APs report Bluetooth packets through an AC.

The value is an integer that ranges from 5000 to 65535.
via-ac

Specifies that Bluetooth packets are sent to a server through an AC.

-
ac-port ac-port-num

Specifies the destination port number on the AC to which APs report Bluetooth packets.

The value is an integer that ranges from 5000 to 65535.

Views

BLE profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the Bluetooth function is enabled, APs need to report collected Bluetooth data to a server. APs report the data using either of the following two methods:
  • Report the data directly to a server.
  • Report the data to a server through an AC.
Precautions

When configuring a port number, ensure that the port is not occupied by other services. If the port is occupied by other services, the port fails to be created.

For the same Bluetooth location function, Bluetooth data forwarding through an AC can be configured only in one BLE profile. If Bluetooth data forwarding through an AC has been configured in the current BLE profile for a Bluetooth location mode, the forwarding mode cannot be configured in other BLE profiles for the same Bluetooth location function.

Example

# Enable APs to send Bluetooth packets to the server with destination IP address 192.168.1.2 and port number 8569.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ble-profile name huawei
[HUAWEI-wlan-ble-prof-huawei] report-to-server ip-address 192.168.1.2 port 8569

reset wlan ble site-info

Function

The reset wlan ble site-info command deletes information about BLE devices stored on an AC.

Format

reset wlan ble site-info { all | mac-address mac-address }

Parameters

Parameter Description Value
all Deletes information about all BLE devices. -
mac-address mac-address Deletes information about the BLE device with the specified MAC address from the device list on the AC.

The value is in H-H-H format. An H is a hexadecimal number of 4 digits.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

When the remaining aging time of BLE devices is long and some BLE devices are not in the current WLAN coverage area, but entries on the AC still exist, you can run this command to delete information about these BLE devices.

Precautions

Deleted information about BLE devices cannot be recovered. If the aging time of a BLE device is zero, information about the BLE device is automatically deleted from the device list on the AC.

Example

# Delete information about all BEL devices from the AC.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] reset wlan ble site-info all

reset wlan location device-info tag

Function

The reset wlan location device-info tag command clears tag information received by APs on the AC.

Format

reset wlan location device-info tag { all | ap-id ap-id | ap-name ap-name }

Parameters

Parameter

Description

Value

all

Clears tag information received by all APs.

-

ap-id ap-id

Clears tag information received by a specified AP ID.

The AP ID must exist.

ap-name ap-name

Clears tag information received by a specified AP name.

The AP name must already exist.

Views

All views

Default Level

3: Management level

Usage Guidelines

When tag information is too much, you can run this command to clear tag information received by APs on the AC. Cleared information cannot be recovered.

Example

# Clear tag information received by all APs.

<HUAWEI> reset wlan location device-info tag all

sniffer enable

Function

The sniffer enable command enables and configures the working mode of an AP's built-in Bluetooth module.

The undo sniffer enable command disables the configured working mode of an AP's built-in Bluetooth module.

By default, the Bluetooth function of an AP's built-in Bluetooth module is disabled.

Format

sniffer enable { ibeacon-mode | tag-mode | transparent-mode }

undo sniffer enable

Parameters

Parameter

Description

Value

ibeacon-mode

Enables the Bluetooth monitoring function of an AP's built-in Bluetooth module.

-

tag-mode

Enables the Bluetooth tag location function of an AP's built-in Bluetooth module.

-

transparent-mode

Enables the Bluetooth data transparent transmission function of an AP's built-in Bluetooth module.

-

Views

BLE profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After enabling the Bluetooth monitoring or Bluetooth tag location function, the built-in Bluetooth module of an AP will scan and obtain information about surrounding BLE devices or Bluetooth tags, and reports the obtained information such as MAC addresses, RSSIs, BLE broadcast frame contents, and battery power.

After the Bluetooth monitoring function is enabled, an AP obtains battery power of surrounding Bluetooth devices at WLAN service off-peak time, for example, 2:00 am of the system time. Precisely configure the system time of an AC to ensure that WLAN services are not affected when the AC obtains battery power of Bluetooth devices.

After the Bluetooth data transparent transmission function is enabled, the built-in Bluetooth module of an AP scans surrounding Bluetooth clients, and reports information about the scanned Bluetooth clients, such as packet data, MAC addresses, and RSSIs.

The Bluetooth broadcast and Bluetooth monitoring functions can be enabled simultaneously for an AP's built-in Bluetooth module. When the two functions are enabled simultaneously, the AP's built-in Bluetooth module is also monitored.

After you run the undo sniffer enable command to disable the BLE monitoring or Bluetooth tag location function, the AC will trigger an alarm indicating that BLE devices or Bluetooth tags are offline.

Precautions

Enabling both the Bluetooth scanning and broadcast functions of an AP affects the efficiency for the AP's Bluetooth module to scan surrounding BLE devices. When an AP does not serve as a Bluetooth base station, it is recommended that the broadcast function of the AP be disabled.

Example

# Enable the Bluetooth monitoring function.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ble-profile name huawei
[HUAWEI-wlan-ble-prof-huawei] sniffer enable ibeacon-mode
Warning: Modifying the monitoring mode may cause BLE devices in the original monitoring mode to go offline and age.

source (location profile view)

Function

The source command sets the source IP address used by the AC to send packets to a location server.

The undo source command deletes the configured source IP address.

By default, the source IP address used by the AC to send packets to a location server is not configured.

Format

source ip-address ip-address

undo source

Parameters

Parameter

Description

Value

ip-address ip-address

Specifies the source IPv4 address used by the AC to send packets to a location server.

The value is in dotted decimal notation.

Views

Location profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the source IP address used by the AC to send packets to a location server is configured using the source command, the UDP packet sent from the AC to a location server carries this IP address as its source IP address.

Precautions

  • Ensure that the AC IP address manually configured on a location server is the same as that configured using the source command.
  • The source IP address must be a valid IP address existing on the device; otherwise, the configuration does not take effect.
  • In scenarios where Huawei proprietary terminal location protocols are used, the AC uses the source IP address of the CAPWAP tunnel to send packets to a location server. The source IP address specified by the source command does not take effect.

Example

# Configure the source IP address of the UDP packets sent from the AC to a location server as 10.102.25.23.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] location-profile name huawei
[HUAWEI-wlan-location-prof-huawei] source ip-address 10.102.25.23

source (BLE profile view)

Function

The source command sets the source IP address used by the AC to send packets to a location server.

The undo source command deletes the configured source IP address.

By default, the source IP address used by the AC to send packets to a location server is not configured, and the IP address of the route outbound interface is used as the source IP address.

Format

source ip-address ip-address

undo source

Parameters

Parameter

Description

Value

ip-address ip-address

Specifies the source IPv4 address used by the AC to send packets to a location server.

The value is in dotted decimal notation.

Views

BLE profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In Bluetooth location scenarios, after the source IP address used by the AC to send packets to a location server is configured using the source command, the packet sent from the AC to a location server carries this IP address as its source IP address.

Precautions

  • Ensure that the AC IP address manually configured on a location server is the same as that configured using the source command.
  • The source IP address must be a valid IP address existing on the device; otherwise, the configuration does not take effect.
  • When the source (BLE profile view) and ble source commands are both executed, the function configured using the source (BLE profile view) command takes effect.

Example

# Configure the source IP address of the packets sent from the AC to a location server as 10.102.25.23.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ble-profile name huawei
[HUAWEI-wlan-ble-prof-huawei] source ip-address 10.102.25.23
Related Topics

tx-power (BLE profile view)

Function

The tx-power command configures the transmit power of an AP's built-in Bluetooth module.

The undo tx-power command restores the default transmit power of an AP's built-in Bluetooth module.

By default, the transmit power of an AP's built-in Bluetooth module is 0 dBm.

Format

tx-power tx-power-value

undo tx-power

Parameters

Parameter Description Value
tx-power-value Transmit power of an AP's built-in Bluetooth module. The value is an enumerated type. The options are -21, -18, -15, -12, -9, -6, -3, 0, 1, 2, 3, 4, and 5, in dBm.

Views

BLE profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run this command to change the transmit power of an AP's built-in Bluetooth module. Increasing transmit power can improve Bluetooth signal transmission quality but causes more severe interference to other wireless devices. Reducing transmit power can reduce interference to other wireless devices but affects Bluetooth signal transmission quality. Configure proper transmit power of an AP's built-in Bluetooth module according to actual situations.

Precautions

After changing the transmit power of an AP's built-in Bluetooth module, you need to run the broadcasting-content command to reconfigure the RSSI calibration value in BLE broadcast frames.

Example

# Configure the transmit power of an AP's built-in Bluetooth module to 2 dBm.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ble-profile name huawei
[HUAWEI-wlan-ble-prof-huawei] tx-power 2
Translation
Download
Updated: 2019-10-18

Document ID: EDOC1000178288

Views: 28242

Downloads: 109

Average rating:
This Document Applies to these Products
Related Version
Related Documents
Share
Previous Next