Use client-proximity-sensor filter-list to configure the MAC address filtering list. The AC does not report information about devices with MAC addresses in the list.

Use undo client-proximity-sensor filter-list to remove the configuration.

Syntax

client-proximity-sensor filter-list list

undo client-proximity-sensor filter-list { list | all }

Default

No MAC address filtering list is configured.

Views

System view

Predefined user roles

network-admin

Parameters

list: Specifies a MAC address or a class of MAC addresses in H-H-H format. For example, if you specify 0400-0000-0000, you specify MAC addresses whose third bit in the first byte is 1.

all: Specifies all MAC addresses.

Examples

# Add MAC addresses whose third bit in the first byte is 1 to the MAC address filtering list.

<Sysname> system-view

[Sysname] client-proximity-sensor filter-list 0400-0000-0000

client-proximity-sensor random-mac-report enable

Use client-proximity-sensor random-mac-report enable to enable reporting of information about Apple terminals that use a random MAC address.

Use undo client-proximity-sensor random-mac-report enable to disable reporting of information about Apple terminals that use a random MAC address

Syntax

client-proximity-sensor random-mac-report enable

undo client-proximity-sensor random-mac-report enable

Default

Information about Apple terminals that use a random MAC address is not reported.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Apple terminals send probe requests by using a random MAC address whose second bit in the first byte is 1 and cause sensors to detect non-existent wireless devices. Enable or disable this command as appropriate.

Examples

# Enable reporting of information about Apple terminals that use a random MAC address.

<Sysname> system-view

[Sysname] client-proximity-sensor random-mac-report enable

client-proximity-sensor report-ap enable

Use client-proximity-sensor report-ap enable to enable reporting of AP information to the UDP server.

Use undo client-proximity-sensor report-ap enable to disable reporting of AP information to the UDP server.

Syntax

client-proximity-sensor report-ap enable

undo client-proximity-sensor report-ap enable

Default

AP information is not reported to the UDP server.

Views

System view

Predefined user roles

network-admin

Examples

# Enable reporting of AP information to the UDP server.

<Sysname> system-view

[Sysname] client-proximity-sensor report-ap enable

client-proximity-sensor report-oasis cache

Use client-proximity-sensor report-oasis cache enable to enable the device to cache client information upon disconnection from the Oasis platform.

Use undo client-proximity-sensor report-oasis cache enable to disable the device from caching client information upon disconnection from the Oasis platform.

Syntax

client-proximity-sensor report-oasis cache enable

undo client-proximity-sensor report-oasis cache enable

Default

The device does not cache client information upon disconnection from the Oasis platform.

Views

System view

Predefined user roles

network-admin

Usage guidelines

After you configure this command, the device caches client information received from sensors when the connection between the device and the Oasis platform goes down. After the device reconnects to the Oasis platform, the device sends the cached information to the Oasis platform.

Examples

# Enable the device to cache client information upon disconnection from the Oasis platform.

<Sysname> system-view

[Sysname] client-proximity-sensor report-oasis cache enable

client-proximity-sensor report-oasis client

Use client-proximity-sensor report-oasis client to set the report interval and the number of client entries that the AC sends to the Oasis platform in each report.

Use undo client-proximity-sensor report-oasis to restore the default.

Syntax

client-proximity-sensor report-oasis client interval interval number number

undo client-proximity-sensor report-oasis client

Default

The AC reports 10 client entries to the Oasis platform every 1000 milliseconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval interval: Specifies the interval at which the AC reports client information to the Oasis platform, in the range of 100 to 60000 milliseconds.

number number: Specifies the number of client entries that the AC sends to the Oasis platform in each report, in the range of 1 to 100.

Examples

# Configure the AC to report 50 client entries to the Oasis platform every 500 milliseconds.

<Sysname> system-view

[Sysname] client-proximity-sensor report-oasis client interval 500 number 50

client-proximity-sensor report-oasis disable

Use client-proximity-sensor report-oasis disable to disable the AC from reporting wireless device information to the Oasis platform.

Use undo client-proximity-sensor report-oasis disable to restore the default.

Syntax

client-proximity-sensor report-oasis disable

undo client-proximity-sensor report-oasis disable

Default

The AC reports wireless device information to the Oasis platform.

Views

System view

Predefined user roles

network-admin

Examples

# Disable the AC from reporting wireless device information to the Oasis platform.

<Sysname> system-view

[Sysname] client-proximity-sensor report-oasis disable

client-proximity-sensor report-oasis rssi-change-threshold

Use client-proximity-sensor report-oasis rssi-change-threshold to set the RSSI difference threshold for reporting client information to the Oasis platform.

Use undo client-proximity-sensor report-oasis rssi-change-threshold to restore the default.

Syntax

client-proximity-sensor report-oasis rssi-change-threshold threshold-value

undo client-proximity-sensor report-oasis rssi-change-threshold

Default

The RSSI difference threshold is 50.

Views

System view

Predefined user roles

network-admin

Parameters

rssi-change-threshold threshold-value: Specifies the RSSI difference threshold for reporting client information to the Oasis platform, in the range of 1 to 100.

Usage guidelines

The AC does not report the client information received from a sensor to the Oasis platform when the following conditions are met:

· The client has already been detected before.

· The RSSI difference of the client between the most recent two reports does not reach the specified threshold.

Examples

# Set the RSSI difference threshold to 50 for reporting client information to the Oasis platform.

<Sysname> system-view

[Sysname] client-proximity-sensor report-oasis rssi-change-threshold 50

client-proximity-sensor rssi-change-threshold

Use client-proximity-sensor rssi-change-threshold to set the RSSI difference threshold for wireless device detection.

Use undo client-proximity-sensor rssi-change-threshold to restore the default.

Syntax

client-proximity-sensor rssi-change-threshold threshold-value

undo client-proximity-sensor rssi-change-threshold

Default

The RSSI difference threshold for wireless device detection is 50.

Views

System view

Predefined user roles

network-admin

Parameters

threshold-value: Specifies the RSSI difference threshold for wireless device detection, in the range of 1 to 100.

Usage guidelines

A sensor does not update the information about a wireless device when the following conditions are met:

· The wireless device has been detected before.

· The RSSI difference of the wireless device between the most recent two detections does not reach the specified threshold.

Examples

# Set the RSSI difference threshold for wireless device detection to 50.

<Sysname> system-view

[Sysname] client-proximity-sensor rssi-change-threshold 50

client-proximity-sensor rssi-threshold

Use client-proximity-sensor rssi-threshold to set the RSSI threshold for clients or APs.

Use undo client-proximity-sensor rssi-threshold to restore the default.

Syntax

client-proximity-sensor rssi-threshold { ap ap-rssi-value | client client-rssi-value }

undo client-proximity-sensor rssi-threshold { ap | client }

Default

The RSSI thresholds for clients and APs are not set.

Views

System view

Predefined user roles

network-admin

Parameters

ap ap-rssi-value: Specifies the RSSI threshold for APs, in the range of 1 to 100.

client client-rssi-value: Specifies the RSSI threshold for clients, in the range of 1 to 100.

Usage guidelines

Sensors do not ignore any wireless devices by default. After you configure this command, sensors will ignore wireless devices with an RSSI lower than the specified RSSI threshold.

Examples

# Configure sensors to ignore APs with an RSSI lower than 30.

<Sysname> system-view

[Sysname] client-proximity-sensor rssi-threshold ap 30

client-proximity-sensor rt-report enable

Use client-proximity-sensor rt-report enable to enable real-time reporting of wireless device information to the UDP server.

Use undo client-proximity-sensor rt-report enable to disable real-time reporting of wireless device information to the UDP server.

Syntax

client-proximity-sensor rt-report enable

undo client-proximity-sensor rt-report enable

Default

Information about wireless devices is reported to the UDP server at the specified interval.

Views

System view

Predefined user roles

network-admin

Examples

# Enable real-time reporting of wireless device information to the UDP server.

<Sysname> system-view

[Sysname] client-proximity-sensor rt-report enable

client-proximity-sensor server

Use client-proximity-sensor server to specify an HTTPS server to receive wireless device information.

Use undo client-proximity-sensor server to restore the default.

Syntax

client-proximity-sensor server string [ window-time window-time-value | partner partner-value ] *

undo client-proximity-sensor server

Default

No HTTPS server is specified.

Views

System view

Predefined user roles

network-admin

Parameters

string: Specifies an HTTPS server by its address, a case-sensitive string of 8 to 127 characters. The address must start with https://.

window-time window-time-value: Specifies the window time in the range of 10 to 60 seconds. The default window time is 30 seconds.

partner partner-value: Specifies the partner flag value. The default partner flag value is 11.

Examples

# Specify the HTTPS server with address https://10.152.3.209/xxx/yy to receive wireless device information.

[Sysname] client-proximity-sensor server https://10.152.3.209:443/xxx/yy

client-proximity-sensor udp-server

Use client-proximity-sensor udp-server to specify a UDP server to receive wireless device information.

Use undo client-proximity-sensor udp-server to restore the default.

Syntax

client-proximity-sensor udp-server ip-address port port-number [ interval interval | preshared-key [ cipher | simple ] key-string ] *

undo client-proximity-sensor udp-server

Default

No UDP server is specified.

Views

System view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the IPv4 address of the UDP server.

port port-number: Specifies the port number of the UDP server, in the range of 1 to 65534.

interval interval: Specifies the interval at which the AC sends device information to the UDP server, in the range of 1 to 600 seconds. The default interval is 30 seconds.

preshared-key: Specifies a preshared key.

cipher: Specifies a key in encrypted form.

simple: Specifies a key in plaintext form.

key-string: Specifies the key. Its plaintext form is a case-sensitive string of 8 to 63 characters. Its encrypted form is a case-sensitive string of 41 to 117 characters.

Examples

# Specify the UDP server with IP address 10.152.3.209 and port number 443 to receive wireless device information.

<Sysname> system-view

[Sysname] client-proximity-sensor udp-server 10.152.3.209 port 443

display client-proximity-sensor device

Use display client-proximity-sensor device to display information about wireless devices detected by sensors.

Syntax

display client-proximity-sensor device [ ap | client | mac-address mac-address ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

ap: Displays information about detected APs.

client: Displays information about detected clients.

mac-address mac-address: Displays information about the wireless device with the specified MAC address. The mac-address argument is in H-H-H format.

verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.

Examples

# Display brief information about wireless devices detected by sensors.

<Sysname> display client-proximity-sensor device

Total 3 detected devices

MAC address Type Duration Sensors Channel Status

0AFB-423B-893C AP 00h 10m 46s 1 11 Active

0AFB-423B-893D AP 00h 10m 46s 1 6 Active

0AFB-423B-893E AP 00h 10m 46s 1 1 Active

Table 1 Command output

Field	Description
MAC address	MAC address of the wireless device.
Type	Wireless device type: · AP. · Client.
Duration	Time elapsed since the wireless device entered the current status.
Sensors	Number of sensors that detected the wireless device.
Channel	Channel on which the wireless device was most recently detected.
Status	Wireless device status: · Active. · Inactive.

# Display detailed information about wireless devices detected by sensors.

<Sysname> display client-proximity-sensor device verbose

Total 2 detected devices

AP: 0AFB-423B-893C

Status: Active

Status duration: 00h 27m 57s

Vendor: Not found

SSID: service

Radio type: 802.11ac

Security: None

Encryption method: None

Authentication method: None

Broadcast SSID: Yes

QoS supported: No

Beacon interval: 100 TU

Up duration: 00h 27m 57s

Channel bandwidth supported: 20/40/80MHz

Total number of reported APs: 1

AP 1:

AP ID: 3

AP name: 1

Radio ID: 1

RSSI: 15

Channel: 419

First detected time: 2016-04-03/09:05:51

Last detected time: 2016-04-03/09:05:51

Total number of associated clients: 1

01: 80EA-9656-AAAB

Client: 80EA-9656-AAAB

Last detected associated AP: 0AFB-423B-893C

Status: Active

Status duration: 00h 00m 02s

Vendor: Not found

Radio type: 802.11a

Total number of reported APs: 1

AP 1:

AP ID: 2

AP name: 1

Radio ID: 1

RSSI: 50

Channel: 116

First detected time: 2016-04-03/14:52:56

Last detected time: 2016-04-03/14:52:56

Detected associated AP: 0AFB-423B-893C

Table 2 Command output

Field	Description
Total number detected devices	Number of detected wireless devices.
AP	MAC address of the detected AP.
Client	MAC address of the detected client.
Last detected associated AP	MAC address of the AP with which the client most recently associated. The MAC address is the BSSID of the AP.
Status	Wireless device status: · Active. · Inactive.
Status duration	Time elapsed since the wireless device entered the current status.
Vendor	OUI of the wireless device. This field displays Not found if no OUIs are imported or the OUI of the device does not match any of the imported OUIs.
Security	Security method: · WEP. · WPA. · WPA2. · None.
Encryption method	Encryption method: · TKIP. · CCMP. · WEP. · None.
Authentication method	Authentication method: · PSK. · 802.1X. · Others—Authentication methods except for PSK authentication and 802.1X authentication. · None.
Broadcast SSID	Whether the AP broadcasts SSIDs. If the AP does not broadcast SSIDs, the SSID field in the output is null.
Beacon interval	Beacon interval in TU. One TU is equal to 1024 microseconds.
Up duration	Time elapsed since the AP started.
Total number of reported APs	Number of sensors that detected the client.
AP n	Sensor that detected the wireless device. n represents the number of the sensor and is automatically assigned by the system.
AP ID	AP ID of the sensor.
AP name	Name of the sensor that detected the wireless device.
Radio ID	ID of the radio that detected the wireless device.
RSSI	RSSI of the sensor.
Channel	Channel on which the sensor most recently detected the wireless device.
First detected time	Time when the sensor detected the wireless device for the first time.
Last detected time	Time when the sensor most recently detected the wireless device.
Total number of associated clients	Number of clients that are associated with the AP.
n:H-H-H	MAC address of the wireless client associated with the AP. n is the number of the wireless client and is automatically assigned by the system.
Detected associated AP	AP with which the wireless client is associated.

display client-proximity-sensor sensor

Use display client-proximity-sensor sensor to display information about sensors.

Syntax

display client-proximity-sensor sensor

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display information about sensors.

<Sysname> display client-proximity-sensor sensor

Total number of sensors: 1

Sensor ID Sensor name Radio ID Status

3 ap1 1 Active

Table 3 Command output

Field	Description
Status	Sensor status: · Active. · Inactive

Field

Description

Status

Sensor status:

· Active.

· Inactive

‌

display client-proximity-sensor statistics receive

Use display client-proximity-sensor statistics receive to display statistics received from sensors.

Syntax

display client-proximity-sensor statistics receive

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display statistics received from sensors

<Sysname> display client-proximity-sensor statistics receive

Information from sensor 1

Statistics information for received messages:

Detected AP updated messages: 7

Detected client updated messages: 5

Detected AP deleted messages: 3

Detected client deleted messages: 0

Detected all device deleted messages: 0

Information from sensor 2

Statistics information for received messages:

Detected AP updated messages: 6

Detected client updated messages: 5

Detected AP deleted messages: 3

Detected client deleted messages: 2

Detected all device deleted messages: 0

Table 4 Command output

Field	Description
Information from sensor n	Information collected from sensor n, where n represents the ID of the sensor.
Detected AP updated messages	Number of AP update messages.
Detected client updated messages	Number of client update messages.
Detected AP deleted messages	Number of AP delete messages.
Detected client deleted messages	Number of client delete messages.
Detected all device deleted messages	Number of device delete messages

Related commands

reset client-proximity-sensor statistics receive

reset client-proximity-sensor device

Use reset client-proximity-sensor device to clear wireless device information.

Syntax

reset client-proximity-sensor device { ap | client | mac-address mac-address | all }

Views

User view

Predefined user roles

network-admin

Parameters

ap: Specifies detected APs.

client: Specifies detected clients.

mac-address mac-address: Specifies a wireless device by its MAC address, in H-H-H format.

all: Specifies all detected devices.

Examples

# Clear information about detected clients.

<Sysname> reset client-proximity-sensor device client

# Clear information about the wireless device with MAC address 0023-1212-2323.

<Sysname> reset client-proximity-sensor device mac-address 0023-1212-2323

Related commands

display client-proximity-sensor device

reset client-proximity-sensor statistics receive

Use reset client-proximity-sensor statistics receive to clear statistics received from sensors.

Syntax

reset client-proximity-sensor statistics receive

Views

User view

Predefined user roles

network-admin

Examples

# Clear statistics received from sensors.

<Sysname> reset client-proximity-sensor statistics receive

Related commands

display client-proximity-sensor statistics receive

11-WLAN Advanced Features Command Reference

WLAN probe commands

client-proximity-sensor report-oasis client

client-proximity-sensor rt-report enable

reset client-proximity-sensor statistics receive

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us