BLDG-HVAC-MIB

File: BLDG-HVAC-MIB.mib (22712 bytes)

Imported modules

SNMPv2-SMI SNMPv2-CONF SNMPv2-TC
SNMP-FRAMEWORK-MIB

Imported symbols

MODULE-IDENTITY Counter32 Gauge32
OBJECT-TYPE Unsigned32 experimental
MODULE-COMPLIANCE OBJECT-GROUP TEXTUAL-CONVENTION
TimeStamp RowStatus StorageType
SnmpAdminString

Defined Types

BldgHvacOperation  
Operations supported by a heating and cooling system. A reference to underlying general systems would go here.
TEXTUAL-CONVENTION    
  INTEGER heat(1), cool(2)  

BldgHVACEntry  
SEQUENCE    
  bldgHVACFloor Unsigned32
  bldgHVACOffice Unsigned32
  bldgHVACCfgTemplate Unsigned32
  bldgHVACFanSpeed Gauge32
  bldgHVACCurrentTemp Gauge32
  bldgHVACCoolOrHeatMins Counter32
  bldgHVACDiscontinuityTime TimeStamp
  bldgHVACOwner SnmpAdminString
  bldgHVACStorageType StorageType
  bldgHVACStatus RowStatus

BldgHVACCfgTemplateInfoEntry  
SEQUENCE    
  bldgHVACCfgTemplateInfoIndex Unsigned32
  bldgHVACCfgTemplateInfoID SnmpAdminString
  bldgHVACCfgTemplateInfoDescr SnmpAdminString
  bldgHVACCfgTemplateInfoOwner SnmpAdminString
  bldgHVACCfgTemplateInfoStatus RowStatus
  bldgHVACCfgTemplateInfoStorType StorageType

BldgHVACCfgTemplateEntry  
SEQUENCE    
  bldgHVACCfgTemplateIndex Unsigned32
  bldgHVACCfgTemplateDesiredTemp Gauge32
  bldgHVACCfgTemplateCoolOrHeat BldgHvacOperation
  bldgHVACCfgTemplateInfo Unsigned32
  bldgHVACCfgTemplateOwner SnmpAdminString
  bldgHVACCfgTemplateStorage StorageType
  bldgHVACCfgTemplateStatus RowStatus

Defined Values

bldgHVACMIB 1.3.6.1.3.122
This example MIB module defines a set of management objects for heating ventilation and air conditioning systems. It also includes objects that can be used to create policies that are applied to rooms. This eliminates the need to send per-instance configuration commands to the system. Copyright (C) The Internet Society (2003). This version of this MIB module is part of RFC 3512; see the RFC itself for full legal notices.
MODULE-IDENTITY    

bldgHVACObjects 1.3.6.1.3.122.1
OBJECT IDENTIFIER    

bldgConformance 1.3.6.1.3.122.2
OBJECT IDENTIFIER    

bldgHVACTable 1.3.6.1.3.122.1.1
This table is the representation and data control for building HVAC by each individual office. The table has rows for, and is indexed by a specific floor and office number. Each such row includes HVAC statistical and current status information for the associated office. The row also contains a bldgHVACCfgTemplate columnar object that relates the bldgHVACTable row to a row in the bldgHVACCfgTemplateTable. If this value is nonzero, then the instance in the row that has a value for how the HVAC has been configured in the associated template (bldgHVACCfgTeplateTable row). Hence, the bldgHVACCfgTeplateTable row contains the specific configuration values for the offices as described in this table.
Status: current Access: not-accessible
OBJECT-TYPE    
  SEQUENCE OF  
    BldgHVACEntry

bldgHVACEntry 1.3.6.1.3.122.1.1.1
A row in the bldgHVACTable. Each row represents a particular office in the building, qualified by its floor and office number. A given row instance can be created or deleted by set operations upon its bldgHVACStatus columnar object instance.
Status: current Access: not-accessible
OBJECT-TYPE    
  BldgHVACEntry  

bldgHVACFloor 1.3.6.1.3.122.1.1.1.1
This portion of the index indicates the floor of the building. The ground floor is considered the first floor. For the purposes of this example, floors under the ground floor cannot be controlled using this MIB module.
Status: current Access: not-accessible
OBJECT-TYPE    
  Unsigned32 1..1000  

bldgHVACOffice 1.3.6.1.3.122.1.1.1.2
This second component of the index specifies the office number.
Status: current Access: not-accessible
OBJECT-TYPE    
  Unsigned32 1..2147483647  

bldgHVACCfgTemplate 1.3.6.1.3.122.1.1.1.3
The index (bldgHVACCfgTemplateIndex instance) of an entry in the 'bldgHVACCfgTemplateTable'. The bldgHVACCfgTable row instance referenced is a pre-made configuration 'template' that represents the configuration described by the bldgHVACCfgTemplateInfoDescr object. Note that not all configurations will be under a defined template. As a result, a row in this bldgHVACTable may point to an entry in the bldgHVACCfgTemplateTable that does not in turn have a reference (bldgHVACCfgTemplateInfo) to an entry in the bldgHVACCfgTemplateInfoTable. The benefit of this approach is that all configuration information is available in one table whether all elements in the system are derived from configured templates or not. Where the instance value for this colunmar object is zero, this row represents data for an office whose HVAC status can be monitored using the read-only columnar object instances of this row, but is not under the configuration control of the agent.
Status: current Access: read-create
OBJECT-TYPE    
  Unsigned32  

bldgHVACFanSpeed 1.3.6.1.3.122.1.1.1.4
Shows the revolutions per minute of the fan. Fan speed will vary based on the difference between bldgHVACCfgTemplateDesiredTemp and bldgHVACCurrentTemp. The speed is measured in revolutions of the fan blade per minute.
Status: current Access: read-only
OBJECT-TYPE    
  Gauge32  

bldgHVACCurrentTemp 1.3.6.1.3.122.1.1.1.5
The current measured temperature in the office. Should the current temperature be measured at a value of less than zero degrees celsius, a read of the instance for this object will return a value of zero.
Status: current Access: read-only
OBJECT-TYPE    
  Gauge32  

bldgHVACCoolOrHeatMins 1.3.6.1.3.122.1.1.1.6
The total number of heating or cooling minutes that have been consumed since the row was activated. Notice that whether the minutes represent heating or cooling is a function of the configuration of this row. If the system is re-initialized from a cooling to heating function or vice versa, then the counter would start over again. This effect is similar to a reconfiguration of some network interface cards. When parameters that impact configuration are changed, the subsystem must be re-initialized. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of bldgHVACDiscontinuityTime.
Status: current Access: read-only
OBJECT-TYPE    
  Counter32  

bldgHVACDiscontinuityTime 1.3.6.1.3.122.1.1.1.7
The value of sysUpTime on the most recent occasion at which any heating or cooling operation for the office designated by this row instance experienced a discontinuity. If no such discontinuities have occurred since the last re- initialization of the this row, then this object contains a zero value.
Status: current Access: read-only
OBJECT-TYPE    
  TimeStamp  

bldgHVACOwner 1.3.6.1.3.122.1.1.1.8
The identity of the operator/system that last modified this entry. When a new entry is created, a valid SnmpAdminString must be supplied. If, on the other hand, this entry is populated by the agent 'discovering' unconfigured rooms, the empty string is a valid value for this object.
Status: current Access: read-create
OBJECT-TYPE    
  SnmpAdminString  

bldgHVACStorageType 1.3.6.1.3.122.1.1.1.9
The persistence of this row of the table in system storage, as it pertains to permanence across system resets. A columnar instance of this object with value 'permanent' need not allow write-access to any of the columnar object instances in the containing row.
Status: current Access: read-create
OBJECT-TYPE    
  StorageType  

bldgHVACStatus 1.3.6.1.3.122.1.1.1.10
Controls and reflects the creation and activation status of a row in this table. No attempt to modify a row columnar object instance value in the bldgHVACTable should be issued while the value of bldgHVACStatus is active(1). Should an agent receive a SET PDU attempting such a modification in this state, an inconsistentValue error should be returned as a result of the SET attempt.
Status: current Access: read-create
OBJECT-TYPE    
  RowStatus  

bldgHVACCfgTemplateInfoTable 1.3.6.1.3.122.1.2
This table provides unique string identification for HVAC templates in a network. If it were necessary to configure rooms to deliver a particular quality of climate control with regard to cooling or heating, the index string of a row in this table could be the template name. The bldgHVACCfgCfgTemplateInfoDescription contains a brief description of the template service objective such as: provides summer cooling settings for executive offices. The bldgHVACCfgTemplateInfo in the bldgHVACCfgTemplateTable will contain the pointer to the relevant row in this table if it is intended that items that point to a row in the bldgHVACCfgTemplateInfoTable be identifiable as being under template control though this mechanism.
Status: current Access: not-accessible
OBJECT-TYPE    
  SEQUENCE OF  
    BldgHVACCfgTemplateInfoEntry

bldgHVACCfgTemplateInfoEntry 1.3.6.1.3.122.1.2.1
Each row represents a particular template and description. A given row instance can be created or deleted by set operations upon its bldgHVACCfgTemplateInfoStatus columnar object instance.
Status: current Access: not-accessible
OBJECT-TYPE    
  BldgHVACCfgTemplateInfoEntry  

bldgHVACCfgTemplateInfoIndex 1.3.6.1.3.122.1.2.1.1
The unique index to a row in this table.
Status: current Access: not-accessible
OBJECT-TYPE    
  Unsigned32 1..2147483647  

bldgHVACCfgTemplateInfoID 1.3.6.1.3.122.1.2.1.2
Textual identifier for this table row, and, consequently the template. This should be a unique name within an administrative domain for a particular template so that all systems in a network that are under the same template can have the same 'handle' (e.g., 'Executive Offices', 'Lobby Areas').
Status: current Access: read-create
OBJECT-TYPE    
  SnmpAdminString  

bldgHVACCfgTemplateInfoDescr 1.3.6.1.3.122.1.2.1.3
A general description of the template. One example might be - Controls the cooling for offices on higher floors during the summer.
Status: current Access: read-create
OBJECT-TYPE    
  SnmpAdminString  

bldgHVACCfgTemplateInfoOwner 1.3.6.1.3.122.1.2.1.4
The identity of the operator/system that last modified this entry.
Status: current Access: read-create
OBJECT-TYPE    
  SnmpAdminString  

bldgHVACCfgTemplateInfoStatus 1.3.6.1.3.122.1.2.1.5
The activation status of this row. No attempt to modify a row columnar object instance value in the bldgHVACCfgTemplateInfo Table should be issued while the value of bldgHVACCfgTemplateInfoStatus is active(1). Should an agent receive a SET PDU attempting such a modification in this state, an inconsistentValue error should be returned as a result of the SET attempt.
Status: current Access: read-create
OBJECT-TYPE    
  RowStatus  

bldgHVACCfgTemplateInfoStorType 1.3.6.1.3.122.1.2.1.6
The persistence of this row of the table in system storage, as it pertains to permanence across system resets. A columnar instance of this object with value 'permanent' need not allow write-access to any of the columnar object instances in the containing row.
Status: current Access: read-create
OBJECT-TYPE    
  StorageType  

bldgHVACCfgTemplateTable 1.3.6.1.3.122.1.3
This table contains the templates, which can be used to set defaults that will be applied to specific offices. The application of those values is accomplished by having a row instance of the bldgHVACTable reference a row of this table (by the value of the former's bldgHVACCfgTemplate columnar instance). Identifying information concerning a row instance of this table can be found in the columnar data of the row instance of the bldgHVACCfgTemplateInfoTable entry referenced by the bldgHVACCfgTemplateInfo columnar object of this table.
Status: current Access: not-accessible
OBJECT-TYPE    
  SEQUENCE OF  
    BldgHVACCfgTemplateEntry

bldgHVACCfgTemplateEntry 1.3.6.1.3.122.1.3.1
Each row represents a single set of template parameters that can be applied to selected instances - in this case offices. These policies will be turned on and off by the policy module through its scheduling facilities. A given row instance can be created or deleted by set operations upon its bldgHVACCfgTemplateStatus columnar object instance.
Status: current Access: not-accessible
OBJECT-TYPE    
  BldgHVACCfgTemplateEntry  

bldgHVACCfgTemplateIndex 1.3.6.1.3.122.1.3.1.1
A unique value for each defined template in this table. This value can be referenced as a row index by any MIB module that needs access to this information. The bldgHVACCfgTemplate will point to entries in this table.
Status: current Access: not-accessible
OBJECT-TYPE    
  Unsigned32 1..2147483647  

bldgHVACCfgTemplateDesiredTemp 1.3.6.1.3.122.1.3.1.2
This is the desired temperature setting. It might be changed at different times of the day or based on seasonal conditions. It is permitted to change this value by first moving the row to an inactive state, making the change and then reactivating the row.
Status: current Access: read-create
OBJECT-TYPE    
  Gauge32  

bldgHVACCfgTemplateCoolOrHeat 1.3.6.1.3.122.1.3.1.3
This controls the heating and cooling mechanism and is set-able by building maintenance. It is permitted to change this value by first moving the row to an inactive state, making the change and then reactivating the row.
Status: current Access: read-create
OBJECT-TYPE    
  BldgHvacOperation  

bldgHVACCfgTemplateInfo 1.3.6.1.3.122.1.3.1.4
This object points to a row in the bldgHVACCfgTemplateInfoTable. This controls the heating and cooling mechanism and is set-able by building maintenance. It is permissible to change this value by first moving the row to an inactive state, making the change and then reactivating the row. A value of zero means that this entry is not associated with a named template found in the bldgHVACCfgTemplateInfoTable.
Status: current Access: read-create
OBJECT-TYPE    
  Unsigned32  

bldgHVACCfgTemplateOwner 1.3.6.1.3.122.1.3.1.5
The identity of the administrative entity that created this row of the table.
Status: current Access: read-create
OBJECT-TYPE    
  SnmpAdminString  

bldgHVACCfgTemplateStorage 1.3.6.1.3.122.1.3.1.6
The persistence of this row of the table across system resets. A columnar instance of this object with value 'permanent' need not allow write-access to any of the columnar object instances in the containing row.
Status: current Access: read-create
OBJECT-TYPE    
  StorageType  

bldgHVACCfgTemplateStatus 1.3.6.1.3.122.1.3.1.7
The activation status of this row of the table. No attempt to modify a row columnar object instance value in the bldgHVACCfgTemplateTable should be issued while the value of bldgHVACCfgTemplateStatus is active(1). Should an agent receive a SET PDU attempting such a modification in this state, an inconsistentValue error should be returned as a result of the SET attempt.
Status: current Access: read-create
OBJECT-TYPE    
  RowStatus  

bldgCompliances 1.3.6.1.3.122.2.1
OBJECT IDENTIFIER    

bldgGroups 1.3.6.1.3.122.2.2
OBJECT IDENTIFIER    

bldgCompliance 1.3.6.1.3.122.2.1.1
The requirements for conformance to the BLDG-HVAC-MIB. The bldgHVACObjects group must be implemented to conform to the BLDG-HVAC-MIB.
Status: current Access: read-create
MODULE-COMPLIANCE    

bldgHVACObjectsGroup 1.3.6.1.3.122.2.2.1
The bldgHVACObjects Group.
Status: current Access: read-create
OBJECT-GROUP