-- ***************************************************************** -- CISCO-DOT11-LBS-MIB.my: -- CISCO IEEE 802.11 Wireless LAN Location Based Services MIB -- -- September 2004, Francis Pang -- -- Copyright (c) 2004 by Cisco Systems, Inc. -- All rights reserved. -- ***************************************************************** -- CISCO-DOT11-LBS-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE FROM SNMPv2-SMI MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF TEXTUAL-CONVENTION, MacAddress, RowStatus, TruthValue FROM SNMPv2-TC ifIndex FROM IF-MIB InetPortNumber, InetAddressType, InetAddress FROM INET-ADDRESS-MIB SnmpAdminString FROM SNMP-FRAMEWORK-MIB ciscoMgmt FROM CISCO-SMI; ciscoDot11LbsMIB MODULE-IDENTITY LAST-UPDATED "200411170000Z" ORGANIZATION "Cisco System Inc." CONTACT-INFO " Cisco Systems Customer Service Postal: 170 West Tasman Drive, San Jose CA 95134-1706. USA Tel: +1 800 553-NETS E-mail: cs-dot11@cisco.com" DESCRIPTION "This MIB module supports network management for Location Based Services on IEEE 802.11 wireless LAN devices. Location Based Services allows third party applications and positioning servers to work with Access Points to track positions of wireless clients in the network. GLOSSARY and ACRONYMS AP Access point, a transmitter/receiver device that commonly connects and transports data between a wireless network and a wired network. LBS Location Based Services MAC Medium Access Control. Layer 2 in the network model. PS Positioning Server. An application server provides IEEE 802.11 wireless client location information and services. RSSI Received Signal Strength Indication." REVISION "200411170000Z" DESCRIPTION "Initial version of this MIB module." ::= { ciscoMgmt 454 } ciscoDot11LbsMIBNotifs OBJECT IDENTIFIER ::= { ciscoDot11LbsMIB 0 } ciscoDot11LbsMIBObjects OBJECT IDENTIFIER ::= { ciscoDot11LbsMIB 1 } ciscoDot11LbsMIBConformance OBJECT IDENTIFIER ::= { ciscoDot11LbsMIB 2 } ciscoDot11LbsConfigInfo OBJECT IDENTIFIER ::= { ciscoDot11LbsMIBObjects 1 } ciscoDot11LbsStatistics OBJECT IDENTIFIER ::= { ciscoDot11LbsMIBObjects 2 } -- Textual Conventions Cdot11LbsTrackMethodType ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "These are the supported methods for wireless client location tracking: rssi(0) - RSSI detection." SYNTAX BITS { rssi(0) } Cdot11LbsPsPacketType ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "These are the types of packets sending to the positioning server. There are two packet types: extended(1) - all data field from LBS message Tag and header are included, short(2) - only the LBS message header will be included in the PS packets." SYNTAX INTEGER { extended(1), short(2) } -- Configuration Information Objects cdot11LbsProfileTable OBJECT-TYPE SYNTAX SEQUENCE OF Cdot11LbsProfileEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains the set of attributes for configuration of connection to remote LBS positioning servers and tracking methods supported on the servers. A positioning server may support LBS application at multiple UDP ports. This wireless station serves as a LBS agent to track the wireless client device. It receives multicast wireless packet sending by the client devices on specific multicast addresses and forward the information to the positioning server." ::= { ciscoDot11LbsConfigInfo 1 } cdot11LbsProfileEntry OBJECT-TYPE SYNTAX Cdot11LbsProfileEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each entry contains parameters to configure a LBS positioning server profile for this wireless station." INDEX { cdot11LbsProfileName } ::= { cdot11LbsProfileTable 1 } Cdot11LbsProfileEntry ::= SEQUENCE { cdot11LbsProfileName SnmpAdminString, cdot11LbsServerAddressType InetAddressType, cdot11LbsServerAddress InetAddress, cdot11LbsServerUdpPort InetPortNumber, cdot11LbsTrackMethod Cdot11LbsTrackMethodType, cdot11LbsPsPacketType Cdot11LbsPsPacketType, cdot11LbsTrackMulticast MacAddress, cdot11LbsMatchChannel TruthValue, cdot11LbsProfileRowStatus RowStatus } cdot11LbsProfileName OBJECT-TYPE SYNTAX SnmpAdminString (SIZE (1..16)) MAX-ACCESS not-accessible STATUS current DESCRIPTION "This is the name of LBS profile for configuration of a connection to a LBS positioning server at a specific address and UDP port." ::= { cdot11LbsProfileEntry 1 } cdot11LbsServerAddressType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-create STATUS current DESCRIPTION "This is the address type of the cdot11LbsServerAddress." DEFVAL { ipv4 } ::= { cdot11LbsProfileEntry 2 } cdot11LbsServerAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-create STATUS current DESCRIPTION "This is the address of the LBS positioning server. The cdot11LbsServerAddressType specifies the type of this address." ::= { cdot11LbsProfileEntry 3 } cdot11LbsServerUdpPort OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-create STATUS current DESCRIPTION "This is the UDP port of the LBS positioning server used to receive LBS packets from this wireless station." ::= { cdot11LbsProfileEntry 4 } cdot11LbsTrackMethod OBJECT-TYPE SYNTAX Cdot11LbsTrackMethodType MAX-ACCESS read-create STATUS current DESCRIPTION "This specifies the method used to detect the location of the wireless client relative to the position of this wireless station. RSSI method uses the strength of the received signals from the wireless client devices to determine their positions." DEFVAL { { rssi } } ::= { cdot11LbsProfileEntry 5 } cdot11LbsPsPacketType OBJECT-TYPE SYNTAX Cdot11LbsPsPacketType MAX-ACCESS read-create STATUS current DESCRIPTION "This specifies the type of LBS packets sent to the LBS position server from this wireless station." DEFVAL { extended } ::= { cdot11LbsProfileEntry 6 } cdot11LbsTrackMulticast OBJECT-TYPE SYNTAX MacAddress MAX-ACCESS read-create STATUS current DESCRIPTION "This is the multicast MAC destination address of the LBS frames sending from the wireless clients to this wireless station." DEFVAL { '014096000010'H } ::= { cdot11LbsProfileEntry 7 } cdot11LbsMatchChannel OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "This object determines if this wireless station will include LBS frames received in channels other than the sender's channel in the RSSI measurement. If the value is 'true', this station will include only LBS frames matching the sender's channel in the RSSI measurement. If the value is 'false', all received LBS frames will be included in the measurement." DEFVAL { true } ::= { cdot11LbsProfileEntry 8 } cdot11LbsProfileRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This configures a new LBS positioning server for this wireless station and modifies or deletes an existing positioning server configuration. Creation of rows must be done via 'createAndGo' and with the cdot11LbsServerAddress and cdot11LbsServerUdpPort set to the address and UDP of the LBS positioning server. This object will become 'notInService' if the NMS successfully performs a multivarbind set for all required objects including this object while this profile is not attached to any wireless interface or a connection cannot be established to the LBS positioning server. This object will become 'active' when this profile is attached to at least one wireless interface via cdot11LbsProfInterfaceTable and a connection to the LBS positioning server is successfully established. Modification and deletion (via 'destroy') of rows can be done when this object is 'active', or 'notInService'. Deletion of a row will remove the corresponding entries for the same profile from the cdot11LbsProfInterfaceTable." ::= { cdot11LbsProfileEntry 9 } cdot11LbsProfInterfaceTable OBJECT-TYPE SYNTAX SEQUENCE OF Cdot11LbsProfileInterfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table configures the Location Based Services settings on the IEEE 802.11 radio interfaces of this device. This table has an expansion dependent relationship on the cdot11LbsProfileTable. This table uses the ifIndex of interfaces of ifType ieee80211(71) as the expansion index." ::= { ciscoDot11LbsConfigInfo 2 } cdot11LbsProfInterfaceEntry OBJECT-TYPE SYNTAX Cdot11LbsProfileInterfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each entry indicates if the LBS client location tracking by a particular location positioning server profile is enabled on an IEEE 802.11 interface." INDEX { cdot11LbsProfileName, ifIndex } ::= { cdot11LbsProfInterfaceTable 1 } Cdot11LbsProfileInterfEntry ::= SEQUENCE { cdot11LbsProfInterfaceRowStatus RowStatus } cdot11LbsProfInterfaceRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This configures and attaches a LBS profile to an IEEE 802.11 wireless LAN network interface or remove a configured interface from the profile. Creation of rows must be done via 'createAndGo' and specifying the cdot11LbsProfileName of an existing profile and the ifIndex of an IEEE 802.11 interface. This object will become 'active' when the profile is attached to a network interface and a connection to the LBS positioning server is successfully established. Otherwise, if this object will become 'notInService'. Modification and deletion (via 'destroy') of rows can be done when this object is 'active' or 'notInService'. If all interfaces are removed from an 'active' profile, the profile cdot11LbsProfileRowStatus will become 'notInService'." ::= { cdot11LbsProfInterfaceEntry 1 } -- ***************************************************************** -- Conformance information -- ***************************************************************** ciscoDot11LbsMIBCompliances OBJECT IDENTIFIER ::= { ciscoDot11LbsMIBConformance 1 } ciscoDot11LbsMIBGroups OBJECT IDENTIFIER ::= { ciscoDot11LbsMIBConformance 2 } -- ***************************************************************** -- Compliance statements -- ***************************************************************** ciscoDot11LbsMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for the ciscoDot11LbsMIB module." MODULE MANDATORY-GROUPS { ciscoDot11LbsConfigGroup } ::= { ciscoDot11LbsMIBCompliances 1 } -- ***************************************************************** -- Units of conformance -- ***************************************************************** ciscoDot11LbsConfigGroup OBJECT-GROUP OBJECTS { cdot11LbsServerAddressType, cdot11LbsServerAddress, cdot11LbsServerUdpPort, cdot11LbsTrackMethod, cdot11LbsPsPacketType, cdot11LbsTrackMulticast, cdot11LbsMatchChannel, cdot11LbsProfileRowStatus, cdot11LbsProfInterfaceRowStatus } STATUS current DESCRIPTION "Configurations for IEEE 802.11 Location Based Services." ::= { ciscoDot11LbsMIBGroups 1 } END