1-- ******************************************************************* 2-- CISCO-DOT11-RADIO-DIAGNOSTIC-MIB.my 3-- May 2003, Daryl Kaiser, Raju Datla, 4-- Parthasarathy Venkatavaradhan, Prasanna Viswakumar 5-- 6-- Copyright (c) 2003 by Cisco Systems, Inc. 7-- All rights reserved. 8-- ******************************************************************* 9-- 10CISCO-DOT11-RADIO-DIAGNOSTIC-MIB DEFINITIONS ::= BEGIN 11 12IMPORTS 13 MODULE-IDENTITY, 14 OBJECT-TYPE, 15 Unsigned32 16 FROM SNMPv2-SMI 17 MODULE-COMPLIANCE, 18 OBJECT-GROUP 19 FROM SNMPv2-CONF 20 TruthValue 21 FROM SNMPv2-TC 22 ifIndex 23 FROM IF-MIB 24 ciscoExperiment 25 FROM CISCO-SMI; 26 27 28--******************************************************************** 29--* MODULE IDENTITY 30--******************************************************************** 31 32ciscoDot11RadioDiagMIB MODULE-IDENTITY 33 LAST-UPDATED "200312230000Z" 34 ORGANIZATION "Cisco System Inc." 35 CONTACT-INFO 36 " Cisco Systems, 37 Customer Service 38 Postal: 170 West Tasman Drive 39 San Jose, CA 95134 40 USA 41 Tel: +1 800 553-NETS 42 43 E-mail: cs-dot11@cisco.com" 44 45 DESCRIPTION 46 "This MIB is intended to be implemented on all 47 802.11 based Access Points and Wireless Bridges 48 that need to participate in radio environment 49 diagnosis. The devices mentioned above may house 50 any one of the 802.11a/802.11b/802.11g standard- 51 based radio interfaces in them for data 52 communication in the form of radio waves. The 53 administrator, through the NMS, temporarily alters 54 the power and channel configurations of an 802.11 55 radio interface and the transmits power levels of 56 the associated clients, if any, by setting 57 appropriate values to the objects of this MIB to 58 perform activities like discovering neighboring APs, 59 measuring strength of the signals as received from 60 other APs, studying RF interference levels at 61 various APs, characterizing APs' coverage etc. 62 These changes to the radio interface and the clients' 63 configuration through this MIB are temporary and 64 won't be retained across reloads. 65 66 GLOSSARY 67 68 Access Point ( AP ) 69 70 An entity that contains an 802.11 medium access 71 control ( MAC ) and physical layer ( PHY ) interface 72 and provides access to the distribution services via 73 the wireless medium for associated clients. 74 75 Wireless Bridge 76 77 An 802.11 entity that provides wireless connectivity 78 between two wired LAN segments and is used in point- 79 to-point or point-multipoint configurations. 80 81 Mobile Node ( MN ) 82 83 A roaming 802.11 wireless device in a wireless 84 network associated with an access point. 85 86 Repeater-AP 87 88 A repeater is a 'wireless AP' that is attached to a 89 parent AP on an 802.11 primary port. The Ethernet 90 port is disabled in a Repeater-AP. 91 92 Radio Diagnosis 93 94 This process includes continuously monitoring the 95 radio environment to discover new 802.11 stations, 96 measure signal strengths, adapt robustly to 97 interferers and provide a visualization of the radio 98 topology to the administrator. 99 100 Association 101 102 The process by which an 802.11 client identifies and 103 gets connected to its parent AP through which it 104 gets the uplink to the wired network. Note that 105 the association happens at the MAC level and the AP 106 holds the MAC addresses of all the clients for 107 whom the AP provides uplink to the wired network. 108 A client, at any point of time, can remain 109 associated only with one AP. 110 111 Channel 112 113 An instance of medium use for the purpose of passing 114 protocol data units (PDUs) that may be used 115 simultaneously, in the same volume of space, with 116 other instances of medium use (on other channels) by 117 other instances of the same physical layer (PHY), with 118 an acceptably low frame error ratio due to mutual 119 interference. Some PHYs provide only one channel, 120 whereas others provide multiple channels. 121 122 Beacons 123 124 Beacons are short frames that are sent from Access 125 Point to stations or station-to-station in order to 126 organize and synchronize the wireless communication 127 on the Wireless LAN. Beacons serve to achieve 128 time synchronization among clients, exchange SSID 129 information, exchange information about data rates 130 supported by the 802.11 devices etc., 131 132 133 Site Survey 134 135 Site survey is done to discover the RF behavior, 136 coverage and interference to decide the placement of 137 WLAN infrastructure devices like Access Points and 138 Wireless bridges to ensure that all the clients 139 experience continually strong RF signal strength as 140 they roam. 141 142 802.11a 143 144 This is a high speed physical layer extension to 145 the 802.11 standard on the 5 GHz band. Interfaces 146 compliant to 802.11a support data rates upto 54Mbps 147 and operate at 5.15-5.25, 5.25-5.35 and 5.725-5.825 148 GHz Unlicensed National Information Infrastructure 149 (U-NII) bands as regulated in the United States by 150 the code of Federal Regulations, Title 47, Section 151 15.407. The radio uses the Orthogonal Frequency 152 Division Multiplexing (OFDM) as the modulation 153 scheme that enables higher speeds at 54Mbps. 154 155 802.11b 156 157 The 802.11b standard operates at 2.4GHz and is 158 backward compatible with 802.11. An 802.11b 159 system operates at 5.5 and 11 Mbps in addition to 160 the 1 and 2 Mbps datarates specified by the 802.11 161 standard. 802.11b uses a modulation technique known 162 as Complementary Code Keying (CCK) which allows the 163 higher data speeds. 164 165 802.11g 166 167 This is the most recently approved standard. This 168 standard specifies an operational frequency of 169 2.4GHz and datarates upto 54Mbps. 802.11g systems 170 are backward compatible with 802.11b systems because 171 of the same operational frequencies. Like 802.11a, 172 802.11g uses the OFDM modulation scheme to achieve 173 higher speeds. " 174 175-- REFERENCE 176 177-- [1] Wireless LAN Medium Access Control ( MAC ) and 178-- Physical Layer ( PHY ) Specifications, ANSI/ 179-- IEEE Std 802.11, 1999 Edition. 180 181-- [2] Wireless LAN Medium Access Control ( MAC ) and 182-- Physical Layer ( PHY ) Specifications: Higher 183-- Speed Physical Layer Extension in the 2.4 GHz 184-- Band, IEEE Std 802.11b-1999 (Supplement to 185-- ANSI/IEEE Std 802.11, 1999 Edition). 186 187-- [3] Wireless LAN Medium Access Control ( MAC ) and 188-- Physical Layer ( PHY ) Specifications: Higher 189-- Speed Physical Layer in the 5 GHz Band, IEEE 190-- Std 802.11a-1999 (Supplement to IEEE Std 191-- 802.11-1999). 192 193-- [4] Wireless LAN Medium Access Control ( MAC ) and 194-- Physical Layer ( PHY ) Specifications: Further 195-- Higher Data Rate Extension in the 2.4 GHz 196-- Band, IEEE Std 802.11g-2003. 197 198-- [5] IEEE 802.11 Management Information Base 199-- ( IEEE802dot11-MIB.my ). 200 201-- [6] Interface MIB ( IF-MIB.my ). 202 203 REVISION "200312230000Z" 204 DESCRIPTION 205 "The changes made are as follows. 206 207 1) The MIB has been modified to add support for 208 802.11a and 802.11g based interfaces. 209 210 2) The definition for the object 211 cDot11RadioDiagTempChannel has been modified to 212 specify the possible channel values for 802.11a 213 based interfaces. 214 215 3) Two new objects, cDot11RadioDiagTempClientTxPower 216 and cDot11RadioDiagTempDataRateSet have been added 217 to the MIB. " 218 219 REVISION "200305080000Z" 220 DESCRIPTION 221 "Initial version of this MIB module. " 222 ::= { ciscoExperiment 105 } 223 224cDot11RadioDiagMIBNotifs OBJECT IDENTIFIER 225 ::= { ciscoDot11RadioDiagMIB 0 } 226 227cDot11RadioDiagMIBObjects OBJECT IDENTIFIER 228 ::= { ciscoDot11RadioDiagMIB 1 } 229 230cDot11RadioDiagConfigGlobal OBJECT IDENTIFIER 231 ::= { cDot11RadioDiagMIBObjects 1 } 232 233--******************************************************************** 234--* Radio Management Configuration global parameters 235--******************************************************************** 236 237cDot11RadioDiagTable OBJECT-TYPE 238 SYNTAX SEQUENCE OF CDot11RadioDiagEntry 239 MAX-ACCESS not-accessible 240 STATUS current 241 DESCRIPTION 242 "This table allows a network management system to 243 control the behavior of the radio interface on an 244 802.11 station and the 802.11 clients associated with 245 that station through that particular interface for 246 the purpose of radio environment diagnosis. The 247 administrator can modify the MIB objects in this 248 table to temporarily alter the behavior of that 249 particular dot11 radio interface and the respective 250 associated clients. 251 252 This table has a sparse dependent relationship 253 with ifTable defined in IF-MIB. There exists a 254 row in this table corresponding to the row for each 255 dot11 interface found in ifTable. However, this 256 table is not applicable for virtual dot11 257 interfaces. " 258 ::= { cDot11RadioDiagConfigGlobal 1 } 259 260cDot11RadioDiagEntry OBJECT-TYPE 261 SYNTAX CDot11RadioDiagEntry 262 MAX-ACCESS not-accessible 263 STATUS current 264 DESCRIPTION 265 "An entry holds the set of temporary values for 266 the parameters to be applied to one particular dot11 267 interface and the respective clients to temporarily 268 alter their behavior. " 269 INDEX { ifIndex } 270 ::= { cDot11RadioDiagTable 1 } 271 272 273CDot11RadioDiagEntry ::= 274 SEQUENCE { 275 cDot11RadioDiagTempChannel Unsigned32, 276 cDot11RadioDiagTempTxPowerLevel Unsigned32, 277 cDot11RadioDiagMode INTEGER, 278 cDot11RadioDiagSettingsEnabled TruthValue, 279 cDot11RadioDiagTempClientTxPower Unsigned32, 280 cDot11RadioDiagTempDataRateSet OCTET STRING 281 } 282 283cDot11RadioDiagTempChannel OBJECT-TYPE 284 SYNTAX Unsigned32(0..14 | 285 34|36|38|40|42|44|46|48|52|56|60|64 | 286 100|104|108|112|116|120|124|128|132 | 287 136|140|149|153|157|161) 288 MAX-ACCESS read-write 289 STATUS current 290 DESCRIPTION 291 "Temporary channel number for the 802.11 interface 292 identified by ifIndex. 293 294 The value this object takes depends on the value of 295 the object dot11PHYType defined in 296 IEEE802dot11-MIB. 297 298 The semantics are as follows. 299 300 If dot11PHYType equals 'ofdm', the acceptable values 301 for this object are 34, 36, 38, 40, 42, 44, 46, 48, 302 52, 56, 60, 64, 100, 104, 108, 112, 116, 120, 124, 303 128, 132, 136, 140, 149, 153, 157 and 161. 304 305 If dot11PHYType equals 'dsss' or 'erp', the 306 acceptable values for this object are from 1 to 14. 307 308 The channel numbers that can be assigned to this 309 object from the set of acceptable values mentioned 310 above vary depending on the value of the MIB object 311 cd11IfCurrentCarrierSet defined in CISCO-DOT11-IF 312 MIB. 313 314 The object cDot11RadioDiagSettingsEnabled must be set 315 to 'true' to apply the temporary value specified 316 through this object to the 802.11 interface. 317 Setting cDot11RadioDiagSettingsEnabled to 'false' 318 temporary value to that interface restores 319 the channel setting of this interface to the original 320 value that was there before applying the temporary 321 value to that interface. A value of 0 indicates that 322 this object hasn't been configured with a valid 323 channel number. " 324 REFERENCE 325 "IEEE Standard 802.11-1999, 15.4.6.2, 326 IEEE Standard 802.11a-1999, 17.3.8.3.3, 327 IEEE Standard 802.11g-2003, Annex D, ASN.1 coding 328 of MAC and PHY MIB. " 329 DEFVAL { 0 } 330 ::= { cDot11RadioDiagEntry 1 } 331 332cDot11RadioDiagTempTxPowerLevel OBJECT-TYPE 333 SYNTAX Unsigned32(0..8) 334 MAX-ACCESS read-write 335 STATUS current 336 DESCRIPTION 337 "Temporary transmit power level for the 802.11 338 interface identified by ifIndex. 339 340 A value in the range of 1 to 8 refers to one of the 341 power levels from the MIB table 'dot11PhyTxPowerTable' 342 in IEEE802dot11-MIB. The power levels that can be 343 assigned to this object from the set of acceptable 344 values mentioned above vary depending on the value of 345 the MIB object cd11IfCurrentCarrierSet defined in 346 CISCO-DOT11-IF-MIB. 347 348 The object cDot11RadioDiagSettingsEnabled must be set 349 to 'true' to apply the temporary value specified 350 through this object to the 802.11 interface. Setting 351 cDot11RadioDiagSettingsEnabled to 'false' restores 352 the power setting of this interface to the original 353 value that was there before applying the temporary 354 value to that interface. A value of 0 indicates that 355 this object hasn't been configured with a valid 356 power level. " 357 DEFVAL { 0 } 358 ::= { cDot11RadioDiagEntry 2 } 359 360cDot11RadioDiagMode OBJECT-TYPE 361 SYNTAX INTEGER { 362 normal(1), 363 apRadioDiscovery(2), 364 siteSurveyTempSettings(3), 365 siteSurveyNonTempSettings(4) 366 } 367 MAX-ACCESS read-write 368 STATUS current 369 DESCRIPTION 370 "Test mode as carried by the Cisco Radio Management 371 Extensions in the 802.11 beacon frame. 372 373 The semantics are described as follows. 374 375 normal - Indicates that the station is operating in 376 non-test mode. 377 378 apRadioDiscovery - Indicates that this station is 379 operating in AP Discovery mode. In this mode, APs 380 transmit and measure each other's beacons. APs 381 measure signal strength as received from other APs, 382 levels of RF interference experienced during 383 transmission / reception and report back the same to 384 the NM. 385 386 siteSurveyTempSettings - Indicates that 387 the station is operating in AP assisted site survey 388 mode with temporary channel and transmit power 389 settings applied to the dot11 interface identified 390 by ifIndex. 391 392 siteSurveyNonTempSettings - Indicates 393 that station is operating in AP assisted site survey 394 mode with it's original channel and transmit power 395 with the temporary settings not applied to the dot11 396 interface identified by ifIndex. " 397 DEFVAL { normal } 398 ::= { cDot11RadioDiagEntry 3 } 399 400cDot11RadioDiagSettingsEnabled OBJECT-TYPE 401 SYNTAX TruthValue 402 MAX-ACCESS read-write 403 STATUS current 404 DESCRIPTION 405 "A flag to indicate whether the station will apply 406 the temporary channel, transmit power settings and 407 the data rate sets configured in this entry to the 408 particular dot11 interface and the client transmit 409 power setting to the clients associated with this 410 station through that dot11 interface. 411 412 A value of 'true' indicates that the station will 413 apply the temporary channel, transmit power settings 414 and the data rate sets configured in this entry to 415 the dot11 interface and the client transmit power 416 to the respective associated clients. 417 418 A value of 'false' indicates that station will use 419 it's original channel, transmit power and data rate 420 sets for data communication over the respective dot11 421 interface. Also, the station will revert back the 422 transmit power of the clients associated through the 423 particular dot11 interface to their original transmit 424 power levels. " 425 DEFVAL { false } 426 ::= { cDot11RadioDiagEntry 4 } 427 428cDot11RadioDiagTempClientTxPower OBJECT-TYPE 429 SYNTAX Unsigned32(0..8) 430 MAX-ACCESS read-write 431 STATUS current 432 DESCRIPTION 433 "Temporary transmit power level for the 802.11 434 clients associated with this station through the 435 802.11 interface identified by ifIndex. 436 437 The value configured through this object is carried 438 by the beacon frames transmitted by this 802.11 439 station and picked up by the associated clients, if 440 any, from these beacon frames to set their respective 441 transmit power levels. 442 443 A value in the range of 1 to 8 refers to one of the 444 recommended power levels from the table 445 cd11IfClientTxPowerTable defined in 446 CISCO-DOT11-IF-MIB. The power levels that can be 447 assigned to this object from the set of acceptable 448 values mentioned above vary depending on the value of 449 the MIB object cd11IfCurrentCarrierSet defined in 450 CISCO-DOT11-IF-MIB. 451 452 The object cDot11RadioDiagSettingsEnabled must be set 453 to 'true' to apply the temporary value specified 454 through this object to the respective clients. 455 Setting cDot11RadioDiagSettingsEnabled to 'false' 456 restores the transmit power setting of the associated 457 clients to the original value that was there before 458 applying this temporary value to those clients. A 459 value of 0 indicates that this object hasn't been 460 configured with a valid power level. " 461 DEFVAL { 0 } 462 ::= { cDot11RadioDiagEntry 5 } 463 464cDot11RadioDiagTempDataRateSet OBJECT-TYPE 465 SYNTAX OCTET STRING (SIZE(1..126)) 466 MAX-ACCESS read-write 467 STATUS current 468 DESCRIPTION 469 "This object specifies the set of data rates at which 470 the station may transmit data through the dot11 471 interface identified by ifIndex. The semantics of 472 this object are similar to that of the object 473 dot11OperationalRateSet of IEEE802dot11-MIB. 474 475 Each octet contains a value representing a rate. 476 Each rate shall be within the range from 2 to 127, 477 corresponding to data rates in increments of 478 500 kb/s from 1 Mb/s to 63.5 Mb/s, and shall be 479 supported as indicated in the object 480 dot11SupportedDataRatesTxTable of IEEE802dot11-MIB 481 for receiving data. 482 483 The object cDot11RadioDiagSettingsEnabled must be set 484 to 'true' to apply the temporary value specified 485 through this object to the 802.11 interface. 486 Setting cDot11RadioDiagSettingsEnabled to 'false' 487 restores the data rate setting of this interface to 488 the original value that was there before applying 489 the temporary value to that interface. A query to 490 this object returns a value of zero for each octet 491 of the octet string representing this object, if 492 this object hasn't been configured with a 493 valid data rate set. " 494 ::= { cDot11RadioDiagEntry 6 } 495 496--******************************************************************** 497--* End of 802.11 station Global Configuration parameters 498--******************************************************************** 499 500 501--******************************************************************** 502-- Conformance information 503--******************************************************************** 504 505cDot11RadioDiagMIBConform OBJECT IDENTIFIER 506 ::= { ciscoDot11RadioDiagMIB 2 } 507cDot11RadioDiagMIBCompliances OBJECT IDENTIFIER 508 ::= { cDot11RadioDiagMIBConform 1 } 509cDot11RadioDiagMIBGroups OBJECT IDENTIFIER 510 ::= { cDot11RadioDiagMIBConform 2 } 511 512 513--******************************************************************** 514--* Compliance statements 515--******************************************************************** 516 517cDot11RadioDiagMIBCompliance MODULE-COMPLIANCE 518 STATUS deprecated -- by cDot11RadioDiagMIBComplianceRev1 519 DESCRIPTION 520 "The compliance statement for the SNMP entities that 521 implement the ciscoDot11RadioDiagMIB module." 522 MODULE MANDATORY-GROUPS { 523 cDot11RadioDiagConfigGlobalGroup 524 } 525 ::= { cDot11RadioDiagMIBCompliances 1 } 526 527 528cDot11RadioDiagMIBComplianceRev1 MODULE-COMPLIANCE 529 STATUS current 530 DESCRIPTION 531 "The compliance statement for the SNMP entities that 532 implement the ciscoDot11RadioDiagMIB module." 533 MODULE MANDATORY-GROUPS { 534 cDot11RadioDiagConfigGroupRev1 535 } 536 ::= { cDot11RadioDiagMIBCompliances 2 } 537 538 539--******************************************************************** 540--* Units of conformance 541--******************************************************************** 542 543cDot11RadioDiagConfigGlobalGroup OBJECT-GROUP 544 OBJECTS { 545 cDot11RadioDiagTempChannel, 546 cDot11RadioDiagTempTxPowerLevel, 547 cDot11RadioDiagMode, 548 cDot11RadioDiagSettingsEnabled 549 } 550 STATUS deprecated -- by cDot11RadioDiagConfigGroupRev1 551 DESCRIPTION 552 "This collection of objects provide information about 553 the temporary radio configuration to be applied to 554 the station's 802.11 interfaces. " 555 ::= { cDot11RadioDiagMIBGroups 1 } 556 557 558cDot11RadioDiagConfigGroupRev1 OBJECT-GROUP 559 OBJECTS { 560 cDot11RadioDiagTempChannel, 561 cDot11RadioDiagTempTxPowerLevel, 562 cDot11RadioDiagMode, 563 cDot11RadioDiagSettingsEnabled, 564 cDot11RadioDiagTempClientTxPower, 565 cDot11RadioDiagTempDataRateSet 566 } 567 STATUS current 568 DESCRIPTION 569 "This collection of objects provide information about 570 the temporary radio configuration to be applied to 571 the station's 802.11 interfaces and the associated 572 clients. " 573 ::= { cDot11RadioDiagMIBGroups 2 } 574 575--******************************************************************** 576--* End of units of conformance 577--******************************************************************** 578 579END 580