Jump to content

Eng-01.02. TCU-NG2 Operational Manual Rev(A)

From PLC Group Wiki

Glossary

[edit | edit source]
Term Description
SMI (Structure of Management Information) Defines the rules for objects in MIB.
MIB (Management Information Base) A database that contains information about managed devices.
OID (Object Identifier) A unique numerical identifier given to each object.
NMS (Network Management System) Used to receive and send information from the SNMP agents.
GET (gettable)/Walk (walkable) The objects that can be queried using SNMP GET and WALK commands. These objects have read-only access.
SET (Settable) The objects that can be set from NMS. These objects have read-write access.
Trap A message sent by the SNMP agent (AQue) to the NMS.
Alarm Status messages sent from the SNMP agent (AQue) to the NMS.
Varbinds (Variable Bindings) Include additional information in the alert sent from the SNMP agent (AQue) to the NMS.


Note: Not all objects in the MIB tree are SET-enabled due to risk of system reboot or instability. This functionality can be enabled on customer request. Objects in the *modules* branch are SET-enabled as threshold adjustments help in troubleshooting.


1. Summary

[edit | edit source]

This document explains the purpose and layout of the PLC MIB, including:

  • HVAC and Battery MIB structures
  • Trap OIDs and Varbinds
  • Event status and severity information
  • Floating multiplier usage
  • SNMP integration from the AQue frontend

2. Scope

[edit | edit source]

This document is intended for engineers, technicians, IT professionals, and NOC teams monitoring systems through SNMP.

It is assumed that users understand:

  • SNMP Protocol
  • SNMP monitoring software (NMS)
  • MIB loading / walkthrough
  • SNMP configuration from AQue

3. Structure of PLC MIB

[edit | edit source]

PLC MIB begins with:

iso.org.dod.internet.private.enterprises.sitelogic OID: 1.3.6.1.4.1.45391

Explanation:

  • 1 = ISO
  • 3 = ORG
  • 6 = DOD
  • 1 = Internet
  • 4 = Private
  • 1 = Enterprises
  • 45391 = PLC Enterprise

After the PLC Enterprise ID, the MIB splits into four branches:

  • info
  • settings
  • modules
  • systemNotifications

3.1. Info Branch

[edit | edit source]

The info branch contains:

  • systeminfo
  • hardwareInfo

3.1.1. systeminfo Branch

[edit | edit source]

The systeminfo branch contains:

  • site
  • system
  • version
  • network

site (SET-enabled): Gives site name, ID, address, operator, latitude, longitude.

system (GET/WALK): Shows uptime, memory, and storage.

version (GET/WALK): Shows OS version, hardware model, software/hardware versions.

network (GET/WALK): Displays IP address, subnet mask, and gateway.

3.1.2. hardwareInfo Branch

[edit | edit source]

Contains:

  • totalNoOfDevices
  • hardwareInstanceTable (GET/WALK)

hardwareInstanceTable includes:

  • hardwareName
  • hardwareStatus
  • hardwareType

Example: HVAC-1, HVAC-2, HVAC-3.


3.2. settings Branch

[edit | edit source]

Contains:

  • clientSettings
  • dateTimeSettings
  • snmpSettings

clientSettings (SET): Name, username, contact.

dateTimeSettings (SET): Device date/time, timezone, NTP server.

snmpSettings (SET): Primary/secondary IPs & ports, server counts, agent ports, etc.


3.3. modules Branch

[edit | edit source]

Contains two subbranches:

  • cooling
  • energy

3.3.1. cooling Branch

[edit | edit source]

Contains:

  • sitelogicModuleHvacMIB → hvac

3.3.1.1. hvac Branch

[edit | edit source]

Contains three tables:

  • hvacHardwareInfoTable (GET/WALK)
  • hvacConfigurationsTable (SET + GET/WALK)
  • hvacAlarmTable (SET + GET/WALK)

hvacHardwareInfoTable Includes: name, description, manufacturer, serial, etc.

hvacConfigurationsTable Includes SET objects:

  • hvacConfigName
  • hvacConfigDescription
  • hvacConfigValue
  • hvacConfigHighThreshold
  • hvacConfigLowThreshold

hvacAlarmTable Includes SET objects:

  • hvacAlarmName
  • hvacAlarmDescription
  • hvacAlarmPolarity
  • hvacAlarmHighThreshold
  • hvacAlarmLowThreshold

3.3.1.2. HVAC Trap OID & Varbinds

[edit | edit source]
hvacDynaNotification
OID: .1.3.6.1.4.1.45391.50.70.1.1.6.0.1
Receives HVAC traps

Varbind list:

  • eventSeverity
  • eventDescription
  • eventTime
  • eventStatus
  • siteName
  • siteId
  • deviceIpAddress
  • eventHardware
  • hvacIndex

3.3.2. energy Branch

[edit | edit source]

Contains:

  • sitelogicModuleBatteryMIB → battery

3.3.2.1. battery Branch

[edit | edit source]

Contains three tables:

  • batteryHardwareInfoTable (GET/WALK)
  • batteryConfigurationsTable (SET + GET/WALK)
  • batteryAlarmTable (SET + GET/WALK)

3.3.2.2. Battery Trap OID & Varbinds

[edit | edit source]
batteryDynaNotification
OID: .1.3.6.1.4.1.45391.50.75.5.1.4.0.1
Receives Battery traps

Varbind list:

  • eventSeverity
  • eventDescription
  • eventTime
  • eventStatus
  • siteName
  • siteId
  • deviceIpAddress
  • eventHardware
  • batteryIndex

3.4. systemNotifications Branch

[edit | edit source]

Contains:

systemNotification
OID: .1.3.6.1.4.1.45391.110.0.1
Receives system alerts such as memory full.

Varbinds:

  • eventDescription
  • eventStatus
  • eventSeverity
  • eventTime
  • eventHardware

Event Status Table

Value Status
0 alarmClose
1 alarmOpen

Event Severity Levels

Level Value
urgent 0
critical 1
major 2
minor 3
warning 4
clear 5
notification 6

4. Floating Multiplier Settings

[edit | edit source]

SNMP cannot directly handle decimal values.

To handle this, PLC MIB uses two float multipliers:

Multiplier Description
Float1 = Value × 10 For one-decimal values

Objects:

  • hvacConfigValue
  • hvacAlarmValue
  • batteryConfigValue
  • batteryAlarmValue
Float100 = Value × 100 For two-decimal values

5. AQue SNMP Configuration

[edit | edit source]

Steps:

  1. Load the MIB file in your NMS.
  2. Log in to AQue (Default: admin / password).
  3. Go to **Settings → General → SNMP**.
  4. Configure:
  * SNMP Agent  
  * SNMP Trap  

Supported versions:

  • SNMP v2c
  • SNMP v3
  • Both

After configuration, perform Walk/Get from NMS to verify.


6. PLC Support

[edit | edit source]

If issues remain, contact PLC Support:

  • 24/7 Support Phone: +1 855 752 4787
  • Support Email: support@plcgroup.com