[ENG] 14.4. [DKSF 48.5 IU] The Support of SNMP trap

A formal description of SNMP TRAP messages can be found in the DKSF 48.5.X MB MIB file attached to the firmware. It can be downloaded on the device description page in the "Documentation and Files" section:

The SNMP TRAP message is sent in SNMP v1 format, while the description in the MIB file has SNMP v2c format.

The unique mutual correspondence between the identification of SNMP TRAP messages for v1 and v2c is described in RFC3584 “Coexistence between Version 1, Version 2, and Version 3 of the Internet-standard Network Management Framework”.

As a rule, programs for processing SNMP notifications carry out the conversion  between two formats easily.

In order to send  SNMP TRAP messages you have to:

  • specify the IP address for sending SNMP TRAP on the "SETUP" page of the device`s web-interface;
  • enable sending SNMP TRAP messages by switching on the corresponding checkboxes in the sensors and relays configuration dialogs.

SNMP TRAP when changing the level on the IO line in the "IO" mode

Identification npIoTrap

SNMP v1 enterprise

.1.3.6.1.4.1.25728.8900.2

SNMP v1 generic-trap

enterpriseSpecific(6)

SNMP v1 specific-trap

1

SNMP v2 snmpTrapOID

.1.3.6.1.4.1.25728.8900.2.0.1


Valiable values in the set npIoTrap (varbind list)

OID

The type of the data

The description

.1.3.6.1.4.1.25728.8900.2.1.0

Integer

The IO line number (starting with "1"), the change of which caused the sending of a TRAP message 

.1.3.6.1.4.1.25728.8900.2.2.0

Integer

The value of the logic level on the IO line ("0" or "1")

.1.3.6.1.4.1.25728.8900.2.6.0

DisplayString

The memo (textual description of the line, encoding win1251)

SNMP TRAP when changing the status of a temperature sensor

Identification npThermoTrap

SNMP v1 enterprise

.1.3.6.1.4.1.25728.8800.2

SNMP v1 generic-trap

enterpriseSpecific(6)

SNMP v1 specific-trap

1

SNMP v2 snmpTrapOID

.1.3.6.1.4.1.25728.8800.2.0.1


Variable values in the set npThermoTrap (varbind list)

OID

The type of the data

The description

.1.3.6.1.4.1.25728.8800.2.1.0

Integer

The number of a sensor (1...8), the change of which caused the sending of a TRAP message  

.1.3.6.1.4.1.25728.8800.2.2.0

Integer

Current temperature value, °C

.1.3.6.1.4.1.25728.8800.2.3.0

Integer

Sensor status: 

  • 0 — failed or not connected sensor
  • 1 — temperature is below safe range
  • 2 — temperature is in safe range
  • 3 — temperature is above safe range

.1.3.6.1.4.1.25728.8800.2.4.0

Integer

The lower limit of the safe range, °C

.1.3.6.1.4.1.25728.8800.2.5.0

Integer

The upper level of the safe range, °C

.1.3.6.1.4.1.25728.8800.2.6.0

DisplayString

The memo (textual description of the installation location of the temperature sensor, encoding win1251)

SNMP TRAP when changing the status of a smoke sensor

Identification npSmokeTrap 

SNMP v1 enterprise

.1.3.6.1.4.1.25728.8200.2

SNMP v1 generic-trap

enterpriseSpecific(6)

SNMP v1 specific-trap

1

SNMP v2 snmpTrapOID

.1.3.6.1.4.1.25728.8200.2.0.1


Variable values in the set npSmokeTrap (varbind list)

OID

The type of the data

The description

.1.3.6.1.4.1.25728.8200.2.1.0

Integer

The number of a smoke sensor (1...8), the change of which caused the sending of a TRAP message  

.1.3.6.1.4.1.25728.8200.2.2.0

Integer

Status of the loop: 

  • 0 — Norm
  • 1 — Alert
  • 4 — StopOut
  • 5 — Failure

.1.3.6.1.4.1.25728.8200.2.6.0

DisplayString

The memo ( textual description of the installation location of the 1-wire smoke sensor sensor, encoding win1251)

SNMP TRAP when changing the status of the humidity sensor

Identification npRelHumTrap

SNMP v2 snmpTrapOID

.1.3.6.1.4.1.25728.8400.6.0.1

snmpTrapOID npRelHumTrap (SNMP TRAP-messages when the status of humidity changes)

OIDThe description
.1.3.6.1.4.1.25728.8400.6.100.nThe fault of the humidity sensor, where n - number of the sensor 1...4
.1.3.6.1.4.1.25728.8400.6.101.nthe readings of the relative humidity below safe sange, where n - number of the sensor 1...4
.1.3.6.1.4.1.25728.8400.6.102.nThe readings of the relative humidity is in safe sange, where n - number of the sensor 1...4
.1.3.6.1.4.1.25728.8400.6.103.nThe readings of the relative humidity is above Safe Range, where n - number of the sensor 1...4
.1.3.6.1.4.1.25728.8400.6.127.nCommon snmpTrapOID for all the eventswhere n - number of the sensor
.1.3.6.1.4.1.25728.8400.6.m.99Common snmpTrapOID for all the channels, where m —  a code of the event (100, 101, 102, 103)
.1.3.6.1.4.1.25728.8400.6.127.99Common snmpTrapOID for all the events and channels

Identification npRelHumTrap

SNMP v2 snmpTrapOID.1.3.6.1.4.1.25728.8400.7.0.1

snmpTrapOID npRelHumTrapTemp (SNMP TRAP-messages when the status of temperature changes)

OIDThe Description
.1.3.6.1.4.1.25728.8400.7.100.nThe fault of the sensor, where n - number of the sensor 1...4
.1.3.6.1.4.1.25728.8400.7.101.nThe readings of the temperature sensor below Safe Range, where n - number of the sensor 1...4
.1.3.6.1.4.1.25728.8400.7.102.nThe readings of the temperature sensor in Safe Range, where n - number of the sensor 1...4
.1.3.6.1.4.1.25728.8400.7.103.nThe readings of the temperature sensor above Safe Range, where n - number of the sensor 1...4
.1.3.6.1.4.1.25728.8400.7.127.nCommon snmpTrapOID for all the events, where n — number of the sensor
.1.3.6.1.4.1.25728.8400.7.m.99Common snmpTrapOID for all the channels, where m —  the code of the event (100, 101, 102, 103)
.1.3.6.1.4.1.25728.8400.7.127.99Common snmpTrapOID  for all the events and channels

Variable values in the set npRelHumTrap (varbind list)

OID

The type of the data

The description

.1.3.6.1.4.1.25728.8400.3.1.0

Integer

The index of the sensor that initiated the sending of the TRAP message.

.1.3.6.1.4.1.25728.8400.3.2.0

Integer

The value of the relative humidity,  %, or temperature °C 

.1.3.6.1.4.1.25728.8400.3.4.0

Integer

The status of the relative humidity and temperature 

Possible values:

  • 0 — sensor failed or not connected
  • 1 — the reading are below the safe range
  • 2 — the reading are in the safe range
  • 3 — the reading are above the safe range

.1.3.6.1.4.1.25728.8400.3.6.0

DisplayString

The memo (textual description of the sensor, encoding win1251)

.1.3.6.1.4.1.25728.8400.3.7.0IntegerThe upper limit of the range of safe values for relative humidity or temperature,% or C
.1.3.6.1.4.1.25728.8400.3.8.0IntegerThe lower limit of the range of safe values for relative humidity or temperature,% or C

The combination of event type and channel number can be enabled by the corresponding checkboxes in the notification settings dialog:

SNMP TRAP from «Watchdog»

Identification  npPwrWdogTrap

SNMP v1 enterprise.1.3.6.1.4.1.25728.5800.6
SNMP v1 generic-trapenterpriseSpecific(6)
SNMP v1 specific-trap1
SNMP v2 snmpTrapOID.1.3.6.1.4.1.25728.5800.6.0.1

snmpTrapOID npPwrWdogTrap (SNMP TRAP messages from «Watchdog»)

OIDThe description
.1.3.6.1.4.1.25728.5800.6.100.nRelay reset initiated by the "Watchdog" has begun, where n is the relay number, 1 ... 8
.1.3.6.1.4.1.25728.5800.6.101.nThe "Watchdog" operation is suspended (after the number of discharges that didn’t have an effect specified in the watchdog settings), where n is the relay number, 1 ... 8
.1.3.6.1.4.1.25728.5800.6.102.nThe operation of the "Watchdog" is restored. The monitored host responded to ping after the "Watchdod" suspended, where n is the relay number, 1 ... 8

Variable values in the set npPwrWdogTrap (varbind list)

OIDThe type of the dataThe description
.1.3.6.1.4.1.25728.5800.2.1.0IntegerИндекс канала «Сторожа» / реле The index of "Watchdog"/relay
.1.3.6.1.4.1.25728.5800.2.6.0DisplayStringThe relay memo
.1.3.6.1.4.1.25728.5800.2.13.0Integer

Unavailability bitmap of monitored hosts. 0 bit - address A, 1 bit - B, 2 bit - C

For example, 5 (101 in binary) means that address A and C did not respond (the first and the third)

The variable value is included only in the TRAP message .1.3.6.1.4.1.25728.5800.6.100 about the initiation of the relay reset

SNMP TRAP when changing the status of a relay (outlet)

Identification  npRelayTrap

SNMP v2 SNMPTrapOID.1.3.6.1.4.1.25728.5500.6.0.1

snmpTrapOID npRelayTrap (SNMP TRAP-messages from the relay)

OIDОписание
.1.3.6.1.4.1.25728.5500.6.100.n Relay is Switched Off, where n - number of the relay 1...8
.1.3.6.1.4.1.25728.5500.6.101.nRelay is Switched On, where n - number of the relays 1...8
.1.3.6.1.4.1.25728.5500.6.102.nA command was received to change the state of the relay, where n is the relay number 1 ... 8
.1.3.6.1.4.1.25728.5500.6.103.nThe relay reset had been initiated, where n is the relay number 1...8
.1.3.6.1.4.1.25728.5500.6.127.nCommon snmpTrapOID for all events, where n is the relay number
.1.3.6.1.4.1.25728.5500.6.m.99Общий snmpTrapOID для всех реле, где m — код события (100, 101, 102, 103)

Common snmpTrapOID for all events and for all channels

Variable values in the set npRelayTrap (varbind list)

OIDThe type of the dataThe description
.1.3.6.1.4.1.25728.5500.3.1.0IntegerThe index of the relay that initiated the sending of the message
.1.3.6.1.4.1.25728.5500.3.2.0Integer

Relay status without reset.

Possible values:

  • 0 — off
  • 1 — on
.1.3.6.1.4.1.25728.5500.3.6.0DisplayStringThe relay memo
.1.3.6.1.4.1.25728.5500.3.15.0Integer

Actual instantaneous state of the relay, taking into account the reset.

Possible values:

  • 0 — off
  • 1 — on
.1.3.6.1.4.1.25728.5500.3.18.0Integer

The source of the commands.

Possible values:

  • -1 — unknown
  • 1 — web-interface
  • 2 — SNMP
  • 3 — SMS
  • 4 — HTTP API
  • 5 — watchdog
  • 6 — schedule
  • 7 — logic
.1.3.6.1.4.1.25728.5500.3.19.0DisplayStringTimestamp events

The combination of event type and channel number can be enabled by the corresponding checkboxes in the notification settings dialog:

SNMP TRAP on status of power inputs

Identification npAcInTraps

SNMP v1 enterprise.1.3.6.1.4.1.25728.5100.46
SNMP v1 generic-trapenterpriseSpecific(6)
SNMP v1 specific-trap1
SNMP v2 SNMPTrapOID.1.3.6.1.4.1.25728.5100.46.0.1

Variable values in the set npAcInTraps (varbind list)

OIDThe type of the dataThe description
.1.3.6.1.4.1.25728.5100.45.1IntegerThe index of power input. 1 or 2
.1.3.6.1.4.1.25728.5100.45.6DisplayStringThe input memo
.1.3.6.1.4.1.25728.5100.45.16Integer

the availability of voltage at the input

possible values:

  • 0 — no
  • 1 — yes

SNMP TRAP from the groups of outletsa about the backup state 

Identification npOutGrpTraps

SNMP v1 enterprise.1.3.6.1.4.1.25728.5100.57
SNMP v1 generic-trapenterpriseSpecific(6)
SNMP v1 specific-trap1
SNMP v2 SNMPTrapOID.1.3.6.1.4.1.25728.5100.57.0.1

 Variable values in the set npOutGrpTraps (varbind list)

OIDТип данныхОписание
.1.3.6.1.4.1.25728.5100.56.1.0IntegerThe number of the groups of outlets. 1 (1...4 outlets) ot 2 (5...8 outlets)
.1.3.6.1.4.1.25728.5100.56.2.0Integer

Power source for a group of outlets.

Possible values:

  • 0 — primary input
  • 1 — backup input
.1.3.6.1.4.1.25728.5100.56.6.0DisplayStringThe memo of an outlets group . Fixed for 1 - “1 ... 4”, for 2 - “5 ... 8”

SNMP TRAP about GSM state

Identification npGsmTraps 

SNMP v1 enterprise

.1.3.6.1.4.1.25728.3800.2

SNMP v1 generic-trap

enterpriseSpecific(6)

SNMP v1 specific-trap

1

SNMP v2 SNMPTrapOID

.1.3.6.1.4.1.25728.3800.2.0.1

 variable values in the set npGsmTraps (varbind list)

OID

The type of the data

The description

.1.3.6.1.4.1.25728.3800.1.1.0

Integer

The state of a built-in GSM modem

  • 0 — OК
  • 1 — Failed (no connection)
  • 2 — FatalError (fatal error, modem locked)

.1.3.6.1.4.1.25728.3800.1.2.0

Integer

Connection status to the GSM network:

  • 0 — Impossible
  • 1 — HomeNetwork
  • 2 — Searching
  • 3 — Denied
  • 4 — Unknown
  • 5 — Roaming
  • 255 — InfoUpdate
.1.3.6.1.4.1.25728.3800.1.3.0IntegerGSM signal strength:
  • 0…31 = 0% … 100%
  • 99 — Unknown
  • 255 — Updating info