SNMP (Simple Network Management Protocol) is suitable for primary system information exchange using short packets.
Individual variables are organized and described in so-called MIB (Management Information Base) table, which can be used for any device. The MIB table is distributed as a separate .mib file that can be downloaded to Damocles from our main web pages or found on the supplied CD which is part of start set.
SNMP is an asynchronous protocol based on the client/server model (here SNMP Client/SNMP Agent). This means that the supervisor (SNMP Client) queries for the state of the individual values and SNMP Agent, implemented in the device, responds.
SNMP protocol support is provided in many languages intended for creating dynamic WWW pages (e.g. PHP, ASP, Java, Perl, Python and others). Thanks to existing modules it is possible to allow access to reading or writing the data, provided by peripheral device to the system (e.g. a Poseidon), over the SNMP protocol quite quickly.
In classic communication mode, the communication proceeds in terms of questions and answers. The variables are defined by a numeric string that is described in the MIB table that also defines the meanings of the individual variables, format and names. If you know the hierarchy (numeric string – e. g. „.1.3.6.1.4.1.21796.3.3.1.1.2.3“ – state of binary input 3) for a specific value, you don’t need the MIB table.
Basic terms:
Some programs do not support MIB files for working with SNMP. With these programs, you must enter the OID strings manually. The strings can be found in the MIB table, but to save you looking there, we provide a summary of several variables, their OID in Damocles models manual.
The following table lists the variables, their OID addresses and values. The values apply to the specified Poseidon configuration shown in the HTML page screenshot on the right.
Variable
OID
Value
Description
sysDescr
.1.3.6.1.2.1.1.1 .iso.org.dod.internet.mgmt.mib-2.system.sysDescr
Poseidon SNMP Supervisor v1.9.6
Textual description of the entity
sysUpTime
.1.3.6.1.2.1.1.3.0 .iso.org.dod.internet.mgmt.mib-2.system.sysUpTime
0:17:12:32.18
Time (in tens of milliseconds) since the last init of the network management portion of the system
Input 1 state
.1.3.6.1.4.1.21796.3.3.1.1.2.1 *).inpTable.inpEntry.inpState
On (2)
Binary input states (integer)
Input 3 state
.1.3.6.1.4.1.21796.3.3.1.1.2.3 *).inpTable.inpEntry.inpState
Off (1)
Input 2 Name
.1.3.6.1.4.1.21796.3.3.1.1.3.2 *).inpTable.inpEntry.inpName
Binary 2
Binary input name (string)
Input 3 Alarm
.1.3.6.1.4.1.21796.3.3.1.1.4.3 *).inpTable.inpEntry.inpSetupAlarm
No (0)
Alarm for the binary input, generated by the device under defined conditions
RTS Output (Port 2)
.1.3.6.1.4.1.21796.3.3.2.1.2.2 *).outTable.outEntry.outState
Binary input state (integer)
*) Text version of the OID begins with “.iso.org.dod.internet.private.enterprises.hwgroup.charonII.poseidon” which corresponds to the numerical OID “.1.3.6.1.4.1.21796.3.3”.
Whenever a value gets outside of the safe range for a sensor, the sensor enters the ALARM state. To notify about the alarm state, a SNMP trap is send to the specified IP address.
SNMP traps consist of two UDP packets sent by the SNMP Agent to the monitoring center (SNMP Client). The packet format is detailed in the MIB table. The first packet contains information about raising the ALARM, the second packet contains additional info about the sensor causing the alarm. When the alarm state ends (e.g. the temperature returns to the safe range), two more UDP packets are sent to inform about the termination of the alarm state.
This method was developed for faster notification of alarms because – in the normal request / response SNMP mode – the polling period may range from hundreds of milliseconds to minutes or even days.
For dry contacts, alarm can be sent upon opening/closing, or turned off completely.
The MIB table contains a list as well as detailed descriptions of SNMP traps. An overview follows.
Getif is a utility for working with SNMP variables. It allows browsing the variables in the SNMP tree, reading the values, setting the values, and displaying details according to the supplied MIB.
Before using the utilities, we recommend to watch the demonstration Flash animation that is available at our website.
Two freeware utilities for working with SNMP variables. They allow browsing the variables in the SNMP tree, reading the values, setting the values, and displaying details according to the MIB that can be loaded to the utility.