Cisco Hyperlocation

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.

Restrictions on Cisco Hyperlocation

  • FlexConnect mode is not supported in Cisco IOS XE Everest Release 16.2.1.

  • Only IPv4 addresses are supported for the NTP server.

  • It is not possible to disable Cisco Hyperlocation on individual APs.

  • It is not possible to configure Hyperlocation for an AP group in Cisco IOS XE Everest Release 16.2.1.

Information About Cisco Hyperlocation

Cisco Hyperlocation is an ultraprecise location solution that allows to track the location of wireless clients with the accuracy of one meter. This is possible thanks to the HALO module, an external third radio that attaches to the back of your Cisco Aironet 3600 and 3700 access points.

Cisco Hyperlocation works in conjunction with Cisco Connected Mobile eXperience (CMX). Combining the Cisco Hyperlocation feature on the Cisco wireless controller with a CMX device allows to achieve better location accuracy, which can result in delivering more targeted content to users. When you use CMX with Cisco CleanAir frequency scanning, it is simple to locate failed, lost, and even rogue beacons.

The Cisco Hyperlocation radio module provides the following:
  • WSM Radio Module functions that are extended to:
    • 802.11ac

    • Wi-Fi Transmit

    • WSM and RRM channel scanning that is extended to 20-MHz, 40-MHz, and 80-MHz channel bandwidth.

  • Expanded location functionality:
    • Low latency location optimized channel scanning

    • 32-antenna angle of arrival (AoA)

Additional References

For more information about Cisco Hyperlocation, refer to the following documents:

Configuring Cisco Hyperlocation (CLI)

Procedure

  • configure terminal

    Example:

    
    Device# configure terminal
    
    

    Enters the global configuration mode.

  • [no] ap hyperlocation

    Example:

    Device(config)# [no] ap hyperlocation

    Enables or disables Hyperlocation.

  • [no] ap hyperlocation threshold detection value-in-dBm

    Example:

    Device(config)# [no] ap hyperlocation threshold detection -100

    Sets threshold to filter out packets with low RSSI

  • [no] ap hyperlocation threshold reset value-btwn-0-99

    Example:

    Device(config)# [no] ap hyperlocation threshold reset 8

    Resets value in scan cycles after trigger.

  • [no] ap hyperlocation threshold trigger value-btwn-1-100

    Example:

    Device(config)# [no] ap hyperlocation threshold trigger 10

    Sets the number of scan cycles before sending a BAR to clients.

  • [no] ap ntp ip ipv4-address-of-ntp-server

    Example:

    Device(config)# [no] ap ntp ip 209.165.200.224

    Sets the IPv4 address of the NTP server, directly reachable by the access points.

  • show ap hyperlocation summary

    Example:

    Device# show ap hyperlocation summary
    
    Hyperlocation operational status: Up
    Hyperlocation NTP server currently used: 209.165.200.224
    Hyperlocation admin status: Enabled
    Hyperlocation detection threshold: -100 dBm
    Hyperlocation trigger threshold: 10
    Hyperlocation reset threshold: 8
    
    

    Shows the overall configuration values and operational status.

  • show ap hyperlocation detail

    Example:

    Device# show ap hyperlocation detail
    
    Hyperlocation operational status: Up
    Hyperlocation NTP server currently used: 209.165.200.224
    Hyperlocation admin status: Enabled
    Hyperlocation detection threshold: -100 dBm
    Hyperlocation trigger threshold: 10
    Hyperlocation reset threshold: 8
    
    AP Name                 Radio MAC        Method    Hyperlocation
    ----------------------------------------------------------------
    AP84b8.0252.b930        84b8.0216.c721   HALO      Enabled
    AP84b8.0265.5540        84b8.0243.8796   WSM       Enabled
    APf07f.0635.2d40        f07f.0676.3b89   WSM       Enabled
    APf4cf.e272.4ed0        f4cf.e223.ba31   HALO      Enabled
    
    

    Shows both overall and per-AP configuration values and operational status.


    Note

    The show ap hyperlocation detail command output shows only APs that have Hyperlocation-capable hardware installed.
  • set platform software trace wireless switch active R0 hyperlocation {debug | emergency | error | info | noise | notice | verbose | warning}

    Tracing commands that are specific to Cisco Hyperlocation:
    • debug —Debug messages

    • emergency —Emergency possible message

    • error —Error messages

    • info —Informational messages

    • noise —Maximum possible message

    • notice —Notice messages

    • verbose —Verbose debug messages

    • warning —Warning messages