------------------------------------------------------------------------------ -- -- ROMAP-MIB -- Oct. 17, 2001 -- v0.4 -- Add controls for setting the WEP keys and Key ID. -- Add control to generate keys via a passphrase. -- Aug. 13, 2001 -- v0.3 -- Add Reset, softboot and Save to NV actions. -- Change all Stats OIDS to be read only. -- Aug. 10, 2001 -- v0.2 -- Fixed some errors not caught by ATI xmib compiler. -- 1. Introduction -- The document relies upon the Structure of Management Information (SMI), -- RFC1155. It is presented in a format described in RFC1212, -- the Concise MIB document. -- 2. Object Definitions -- ROMAP-MIB {iso(1) org(3) dod(6) internet(1) private(4) -- enterprises(1) 10227 } -- 1.3.6.1.4.1.10227 ROMAP-MIB DEFINITIONS ::= BEGIN IMPORTS enterprises, IpAddress, Counter, TimeTicks FROM RFC1155-SMI OBJECT-TYPE FROM RFC-1212 DisplayString FROM SNMPv2-TC; -- -- Textual Conventions -- -- MacAddress ::= OCTET STRING (SIZE (6)) -- a 6 octet address romap OBJECT IDENTIFIER ::= {enterprises 10227} -- Groups in ROMAP apControl OBJECT IDENTIFIER ::= {romap 1} apStats OBJECT IDENTIFIER ::= {romap 2} apInfo OBJECT IDENTIFIER ::= {romap 3} -- Groups in apInfo apInfoQueues OBJECT IDENTIFIER ::= {apInfo 1} apInfoResources OBJECT IDENTIFIER ::= {apInfo 2} apInfoGen OBJECT IDENTIFIER ::= {apInfo 3} -- -- -- The objects in the apControl Group -- -- apControlRtsThreshold OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This is the threshold at which the radio will first send an RTS - CTS exchange before transmitting the actual frame. This is typically used when the BSS covers a large area and most client wireless nodes cannot hear other clients. The RTS-CTS exchange when successful assures that the data frame that will follow will not be collided by another transmission within the BSS." ::= { apControl 1 } apControlFragThreshold OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This is the threshold at which the radio will fragment a frame. All fragements except the last will be of the same size." ::= { apControl 2 } apControlBeaconPeriod OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "This is the period, measured in Kusec (1024 microseconds) at which the AP will transmit its beacon frames. NOTE:!! for Bridge modes this value, when represented in hexadecimal notation, should end in a '5'. e.g. 0x85 = 133 - valid 0x75 = 117 - valid 0x5f = 95 - INVALID." ::= { apControl 3 } apControlDSChannel OBJECT-TYPE SYNTAX INTEGER (0..255) ACCESS read-write STATUS mandatory DESCRIPTION "The channel on which this device is operating." ::= { apControl 4 } apControlStationBasicRate OBJECT-TYPE SYNTAX INTEGER (0..255) ACCESS read-write STATUS mandatory DESCRIPTION "The maximum minimum rate which must be supported." ::= { apControl 5 } apControlSSID OBJECT-TYPE SYNTAX DisplayString (SIZE(1..32)) ACCESS read-write STATUS mandatory DESCRIPTION "The ID of this wireless network. All devices must have the same SSID in order to communicate. Technically the characters of this string can be any value, however in most implementations the SSID is a user readable string." ::= { apControl 6 } apControlEncapMode OBJECT-TYPE SYNTAX INTEGER { ethernetEncapsulation(1), rfc1042Conversion(2), ieee802dot1hConversion(3) } ACCESS read-write STATUS mandatory DESCRIPTION "Defines the conversion the unit will use when it receives a DIX frame from the Ethernet network, before transmitting it to the wireless media. Also defines how to covert frames received from the wireless medium before forwarding them to the wired network. - In RFC1042 mode the translation table is empty except for 2 entries; types 0x8137 and 0x80F3. - In 802.1h mode the translation table is full. NOTE:!! Implementers: Internal storage of this parameter ranges from 0-2." ::= { apControl 7 } apControlAssociationStaleTime OBJECT-TYPE SYNTAX INTEGER (0..100000) ACCESS read-write STATUS mandatory DESCRIPTION "Defines the timeout in units of minutes, when an entry will be marked in the address table as not associated due to inactivity." ::= { apControl 8 } apControlAuthenticationStaleTime OBJECT-TYPE SYNTAX INTEGER (0..100000) ACCESS read-write STATUS mandatory DESCRIPTION "Defines the timeout in units of minutes, when an entry will be removed from the address table due to inactivity." ::= { apControl 9 } apControlDisassocRetryThreshold OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "Defines the number of successive transmission failures that will result in the destination address being removed from the address table." ::= { apControl 10 } apControlWepRequired OBJECT-TYPE SYNTAX INTEGER { wepDisabled(1), wep64bit(3), wep128bit(7) } ACCESS read-write STATUS mandatory DESCRIPTION "Defines the mode of RC4 Encryption being used." ::= { apControl 11 } apControlNetworkMode OBJECT-TYPE SYNTAX INTEGER { clientCPE(1), accessPoint(2), bridgeSlave(5), bridgeMaster(6) } ACCESS read-write STATUS mandatory DESCRIPTION "Sets the mode in which this unit will operate. NOTE:!! - Some modes may not be supported by all units." ::= { apControl 12 } apControlResetAP OBJECT-TYPE SYNTAX INTEGER { hdwresetAP(1), hdwresetAndSaveToNonvolatile(2) } ACCESS read-write STATUS mandatory DESCRIPTION "Performs a hardware reset on the AP. Doing a set on this OID with a value of 1 will initiate the reset of the hardware after the response to the set has completed. Any parameters that have been changed with a Set will be lost unless a Save has been done or the set had a value of 2. In this case the unit will save its Control MIB values to nonvolatile and then initiate the reset." ::= { apControl 13 } apControlSoftBootAP OBJECT-TYPE SYNTAX INTEGER { softBootAP(1), softBootAndSaveToNonvolatile(2) } ACCESS read-write STATUS mandatory DESCRIPTION "Performs a soft reset on the APs core code. This will allow any parameters that have been changed with a previous SNMP set to take effect. The soft boot will not save any new settings unless the set is done with a value of 2 indicating that the unit should save the Control MIB to nonvolatile before initiating a soft boot." ::= { apControl 14 } apControlSaveToNonvolatile OBJECT-TYPE SYNTAX INTEGER { saveControlMIB(1), saveAll(2) } ACCESS read-write STATUS mandatory DESCRIPTION "A set to this object will initiate a save of the Control MIB parameters to non-volatile. A set with a value of 1 will save only the Control MIB, while a set with a value of 2 will save all information." ::= { apControl 15 } apControlDefaultKeyId OBJECT-TYPE SYNTAX INTEGER (1..4) ACCESS read-write STATUS mandatory DESCRIPTION "Defines the default WEP key that the device will use to encrypt frames before transmitting to the BSS. Note: When apControlWepRequired is set to wep128bit only key ID 1 is valid and any other value will be ignored by the device." ::= { apControl 16 } apControl64BitKey1 OBJECT-TYPE SYNTAX OCTET STRING (SIZE(5)) ACCESS read-write STATUS mandatory DESCRIPTION "This sets 64(40) bit default WEP key 1 to a new value. Note: Reads to this parameter will return all zeros. Byte order is expected to be lsbyte to msbyte in bytes 1 to 5." ::= { apControl 17 } apControl64BitKey2 OBJECT-TYPE SYNTAX OCTET STRING (SIZE(5)) ACCESS read-write STATUS mandatory DESCRIPTION "This sets 64(40) bit default WEP key 2 to a new value. Note: Reads to this parameter will return all zeros. Byte order is expected to be lsbyte to msbyte in bytes 1 to 5." ::= { apControl 18 } apControl64BitKey3 OBJECT-TYPE SYNTAX OCTET STRING (SIZE(5)) ACCESS read-write STATUS mandatory DESCRIPTION "This sets 64(40) bit default WEP key 3 to a new value. Note: Reads to this parameter will return all zeros. Byte order is expected to be lsbyte to msbyte in bytes 1 to 5." ::= { apControl 19 } apControl64BitKey4 OBJECT-TYPE SYNTAX OCTET STRING (SIZE(5)) ACCESS read-write STATUS mandatory DESCRIPTION "This sets 64(40) bit default WEP key 4 to a new value. Note: Reads to this parameter will return all zeros. Byte order is expected to be lsbyte to msbyte in bytes 1 to 5." ::= { apControl 20 } apControl128BitKey OBJECT-TYPE SYNTAX OCTET STRING (SIZE(13)) ACCESS read-write STATUS mandatory DESCRIPTION "This sets the 128(104) bit WEP key to a new value. Note: Reads to this parameter will return all zeros. Byte order is expected to be lsbyte to msbyte in bytes 1 to 13." ::= { apControl 21 } apControlPassphrase OBJECT-TYPE SYNTAX DisplayString (SIZE(1..32)) ACCESS read-write STATUS mandatory DESCRIPTION "This string is used by the device to generate the 4 default WEP keys plus the single 128 bit key. Note: Reads to this parameter will return a NULL string." ::= { apControl 22 } -- -- -- -- The objects in the Stats Group -- -- apStatsTxGood OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number good transmissions to the radio." ::= { apStats 1 } apStatsRxGood OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number good receptions from the radio." ::= { apStats 2 } apStatsTxBad OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number bad transmissions to the radio." ::= { apStats 3 } apStatsRxBad OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number bad receptions from the radio." ::= { apStats 4 } apStatsRxNoBuf OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number reception failures because of no receive buffers." ::= { apStats 5 } apStatsTxDirectedBytes OBJECT-TYPE SYNTAX OCTET STRING (SIZE(8)) ACCESS read-only STATUS mandatory DESCRIPTION "A quad word counter of number of non-multicast bytes transmitted." ::= { apStats 6 } apStatsTxDirectedFrames OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number good non-multicast transmissions to the radio." ::= { apStats 7 } apStatsTxMulticastBytes OBJECT-TYPE SYNTAX OCTET STRING (SIZE(8)) ACCESS read-only STATUS mandatory DESCRIPTION "A quad word counter of number of multicast bytes transmitted." ::= { apStats 8 } apStatsTxMulticastFrames OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number good multicast transmissions to the radio." ::= { apStats 9 } apStatsTxBroadcastBytes OBJECT-TYPE SYNTAX OCTET STRING (SIZE(8)) ACCESS read-only STATUS mandatory DESCRIPTION "A quad word counter of number of Broadcast bytes transmitted." ::= { apStats 10 } apStatsTxBroadcastFrames OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number good Broadcast transmissions to the radio." ::= { apStats 11 } apStatsRxDirectedBytes OBJECT-TYPE SYNTAX OCTET STRING (SIZE(8)) ACCESS read-only STATUS mandatory DESCRIPTION "A quad word counter of number of non-multicast bytes received." ::= { apStats 12 } apStatsRxDirectedFrames OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number good non-multicast receptions to the radio." ::= { apStats 13 } apStatsRxMulticastBytes OBJECT-TYPE SYNTAX OCTET STRING (SIZE(8)) ACCESS read-only STATUS mandatory DESCRIPTION "A quad word counter of number of multicast bytes received." ::= { apStats 14 } apStatsRxMulticastFrames OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number good multicast receptions to the radio." ::= { apStats 15 } apStatsRxBroadcastBytes OBJECT-TYPE SYNTAX OCTET STRING (SIZE(8)) ACCESS read-only STATUS mandatory DESCRIPTION "A quad word counter of number of Broadcast bytes received." ::= { apStats 16 } apStatsRxBroadcastFrames OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number good Broadcast receptions to the radio." ::= { apStats 17 } apStatsRxCrcError OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of frames received with CRC error." ::= { apStats 18 } apStatsRxMgmt OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of received 802.11 frames of type MGMT." ::= { apStats 19 } apStatsRxData OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of received 802.11 frames of type DATA." ::= { apStats 20 } apStatsRxCntl OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of received 802.11 frames of type CNTL." ::= { apStats 21 } apStatsTxMgmt OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of transmitted 802.11 frames of type MGMT sent from the Management queue." ::= { apStats 22 } apStatsTxData OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of transmitted 802.11 frames of type DATA sent from the Data queue." ::= { apStats 23 } apStatsTxBcast OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of transmitted 802.11 frames of type DATA sent from the Broadcast queue." ::= { apStats 24 } apStatsTxDs OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of frames sent to the distribution system. (This is the Ethernet interface on a typical AP)." ::= { apStats 25 } apStatsRxDs OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of frames received from the distribution system. (This is the Ethernet interface on a typical AP)." ::= { apStats 26 } apStatsTxLocal OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of frames sent to the local TCP/IP stack from the AP." ::= { apStats 27 } apStatsRxLocal OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of frames received from the local TCP/IP stack by the AP. " ::= { apStats 28 } apStatsRxDuplicate OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of duplicate 802.11 frames received from the radio." ::= { apStats 29 } apStatsRxNotAssociated OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of frames received from wireless nodes who are not in this units address table." ::= { apStats 30 } apStatsOutOfPackets OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of times could not receive a frame due to lack of free packet buffers in the AP. This applies to frames received from any interface (DS, Radio, Local)." ::= { apStats 31 } apStatsDecryptFailures OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of frames for which the decryption process failed. Failure typically means that the key used to decrypt the frame does not match that used to encrypt it." ::= { apStats 32 } apStatsExcludeUnencrypted OBJECT-TYPE SYNTAX Counter ACCESS read-only STATUS mandatory DESCRIPTION "Count of number of frames that were rejected because they were received unencrypted while the unit was set to only accept encrypted frames." ::= { apStats 33 } -- -- -- The objects in the General Info Group -- -- apInfoGenAPVersion OBJECT-TYPE SYNTAX OCTET STRING (SIZE(4)) ACCESS read-only STATUS mandatory DESCRIPTION "The version of the code running in this unit. Format is: CoreMajor:CoreMinor:Variant:Build " ::= { apInfoGen 1 } apInfoGenAPAddress OBJECT-TYPE SYNTAX MacAddress ACCESS read-only STATUS mandatory DESCRIPTION "The MAC Address used by this unit and to which it is known on all interfaces." ::= { apInfoGen 2 } apInfoGenNumAssociations OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The number of Assoications currently active in this unit." ::= { apInfoGen 3 } apInfoGenNumAuthentications OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The number of Authentications currently active in this unit." ::= { apInfoGen 4 } apInfoGenNumPsNodes OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The number of associated nodes that are using a power save mode." ::= { apInfoGen 5 } apInfoGenState OBJECT-TYPE SYNTAX INTEGER { notLinked(1), linked(2) } ACCESS read-only STATUS mandatory DESCRIPTION "The status of the radio link in this unit. For AP or Bridge Masters a state of 'linked' implies at least one wireless client has associated. Implementer's NOTE:!! - Actual values in unit are a value of 1 less than this enumeration." ::= { apInfoGen 6 } apInfoGenMgmtState OBJECT-TYPE SYNTAX INTEGER { scanning(1), -- used in Bridge Slave and CPE modes synced(2), -- intermediate state in Bridge Slave mode bgScan(3), -- obsolete authenticated(4), -- obsolete - done in firmware associationPending(5), -- obsolete - done in firmware associated(6), -- used in Bridge Slave and CPE modes apOperational(7), -- default state of AP or Bridge Master authenticationPending(8), -- obsolete - done in firmware sharedKeyAuthentPending(9) -- obsolete - done in firmware } ACCESS read-only STATUS mandatory DESCRIPTION "The status of the unit's 802.11 management module." ::= { apInfoGen 7 } -- -- -- The objects in the Resources Info Group -- -- apInfoResourcesPacketPoolUsed OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current number of Packet Descriptors that are used." ::= { apInfoResources 1 } apInfoResourcessBufferPoolUsed OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current number of Buffers that are used." ::= { apInfoResources 2 } apInfoResourcessPacketPoolFree OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current number of free Packet Descriptors in the pool." ::= { apInfoResources 3 } apInfoResourcessBufferPoolFree OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current number of free Buffers in the pool." ::= { apInfoResources 4 } -- -- -- The objects in the Queue Info Group -- -- apInfoQueuesPwrSave OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The total number of frames buffered and waiting on the Power Save Queue. (for all power save nodes)." ::= { apInfoQueues 1 } apInfoQueuesBcast OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current depth of the Broadcast Tx Queue." ::= { apInfoQueues 2 } apInfoQueuesCFP OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current depth of the CFP Tx Queue." ::= { apInfoQueues 3 } apInfoQueuesData OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current depth of the Data Tx Queue." ::= { apInfoQueues 4 } apInfoQueuesMgmt OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current depth of the Mgmt Tx Queue." ::= { apInfoQueues 5 } apInfoQueuesRxDs OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current depth of the Distribution System Receive Queue." ::= { apInfoQueues 6 } apInfoQueuesTxDs OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current depth of the Distribution System Transmit Queue." ::= { apInfoQueues 7 } apInfoQueuesRxLocal OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current depth of the Local Interface Rx Queue." ::= { apInfoQueues 8 } apInfoQueuesTxLocal OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current depth of the Local Interface Tx Queue." ::= { apInfoQueues 9 } apInfoQueuesRxRadio OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The current depth of the Radio Receive Queue." ::= { apInfoQueues 10 } END