[DKSF 54.1 IU] Manage device with SNMP v1

A NetPing device supports adjusting parameters and managing via an SNMP v1 protocol.

You can read more detailed information about SNMP on the following links:

OID that are supported by a device, are in a MIB file DKSF_54.x.x_ MB.mib, which can be downloaded from the web site www.netping.ru

A device supports:

  • Reading OID using Get, Get-Next requests via an SNMP v1 protocol;
  • Setting up OID values using a command Set via an SNMP v1 protocol;
  • Sending TRAP notifications on events.

The article on receiving data from a device via an SNMP protocol can be downloaded from the link: http://www.netping.ru/view.aspx?id=34

SNMP Protocol Settings

There is a need to configure the following parameters using a web interface of a device to access it via an SNMP v1 protocol:

  • Community  reads – is a secret word that is necessary to indicate in any request for reading parameters via an SNMP protocol. It is specified on the page «Settings»;
  • Community writes – is a secret word that is necessary to indicate in any request for writing parameters via an SNMP protocol. It is specified on the page «Settings».

There is a need to configure the following parameters of a device for it to send TRAP notifications via an SNMP v1 protocol:

  • IP 1 for sending TRAP notifications – is an IP address, where TRAP notifications will be sent. It is specified on the page «Settings»;
  • IP 2 for sending TRAP notifications is the second (additional) IP address, where TRAP notifications will be sent. It is specified on the page «Settings»;
  • Rising Edge (0 » 1) – is a checkbox that enables sending an SNMP TRAP notification when changing a logic level on an input line from low to high one (rising edge). It is found on the page «Input-Output Lines»;
  • Falling Edge (1 » 0)is a checkbox that enables sending an SNMP TRAP notification when changing a logic level on an input line from high to low one (falling edge). It is found on the page «Input-Output Lines»;
  • t° have risen above a safe range – is a checkbox that enables sending an SNMP TRAP notification when an upper limit of a safe range, specified for a particular sensor, is exceeded. It is found on the page «Temperature Sensors»;
  • t° is back to a safe range – is a checkbox that enables sending an SNMP TRAP notification if a temperature on a particular temperature sensor is back to a specified range. It is found on the page «Temperature Sensors»;
  • t° have fallen below a safe range – is a checkbox that enables sending an SNMP TRAP notification when a temperature falls below a threshold, specified for a particular sensor. It is found on the page «Temperature Sensors»

Supported OIDs

A description of OIDs, supported by a device, is represented in the table below:

OID

Name

Type

Access

Description

RFC1213

.1.3.6.1.2.1.1.1.0

sysDescr.0

OctetString

READ

A textual description of a device

.1.3.6.1.2.1.1.2.0

sysObjectID.0

OID

READ

A number of a branch with parameters of a device is always .1.3.6.1.4.1.25728

.1.3.6.1.2.1.1.3.0

sysUpTime.0

TimeTicks

READ

Time from the moment of the last turning on a device

.1.3.6.1.2.1.1.4.0

sysContact.0

OctetString

READ/ WRITE

Contact data, usually an administartor's email

.1.3.6.1.2.1.1.5.0

sysName.0

OctetString

READ/ WRITE

Domain name of a device

.1.3.6.1.2.1.1.6.0

sysLocation.0

OctetString

READ/ WRITE

Location of a device

.1.3.6.1.2.1.1.7.0

sysServices.0

Integer

READ

Binary representation of this OID is a set of supported services. Always 72, a device is an end-host.

.1.3.6.1.2.1.2.1.0

ifNumber.0

Integer

READ

Amount of network interfaces of a device

.1.3.6.1.2.1.2.2.1.1.1

ifIndex.1

Integer

 

 

.1.3.6.1.2.1.2.2.1.3.1

ifType.1

Integer

READ

Type of a network interface of a device

.1.3.6.1.2.1.2.2.1.4.1

ifMtu.1

Integer

READ

A package size of a network interface. Always 1514

.1.3.6.1.2.1.2.2.1.5.1

ifSpeed.1

Integer

READ

Speed of a network interface. Always 100000000

.1.3.6.1.2.1.2.2.1.6.1

ifPhysAddress.1

OctetString

READ

МАС address of a device

NetPing MIB

.1.3.6.1.4.1.25728.90.1.0

npTrapEmailTo.0

OctetString

READ

A variable that is included into traps. Email, to which messages are forwarded using a NetPing message forwarding service.

.1.3.6.1.4.1.25728.911.1.0

npSoftReboot

Integer

READ/WRITE

Software reboot of a device by writing a value 1

.1.3.6.1.4.1.25728.911.2.0

npResetStack

Integer

READ/WRITE

Software reboot of a network interface by writing a value 1

.1.3.6.1.4.1.25728.911.3.0

npForceReboot

Integer

READ/WRITE

Immediate forced reboot of a device by writing a value 1 (resetting a processor as when powering it on).

.1.3.6.1.4.1.25728.3800.1.1.0

npGsmFailed

Integer

READ

A status of a built-in GSM modem.

0 – Ok

1 – Failed (no connection)

2 – FatalError (unrecoverable error, a modem is blocked)

.1.3.6.1.4.1.25728.3800.1.2.0

npGsmRegistration

Integer

READ

A status of GSM network connection

0 – impossible

1 – homeNetwork

2 – searching

3 – denied

4 – unknown

5 – roaming

255 – infoUpdate

 

.1.3.6.1.4.1.25728.3800.1.3.0

npGsmStrength

Integer

READ

A level of a GSM signal

0…31 = 0% … 100%

99 – unknown

255 – updating info

 

.1.3.6.1.4.1.25728.5500.5.1.1.1

nRelayN

Integer

READ

A relay index

.1.3.6.1.4.1.25728.5500.5.1.2.1

npRelayMode

Integer

READ-
WRIRE

A relay operation mode

The following modes are available:

0 – Turned off manually;
1 – Turned on manually;
4 – A channel is controlled by a logic.

.1.3.6.1.4.1.25728.5500.5.1.3.1

npRelayStartReset

Integer

READ-
WRITE

OID for a forced short-term relay turning off. Write a number 1 to turn off a channel for 15 seconds.

.1.3.6.1.4.1.25728.5500.5.1.6.1

npRelayMemo

DisplayString

READ

A relay memo.

.1.3.6.1.4.1.25728.5500.5.1.15.1

npRelayState

Integer

READ

Current relay status.

0 – A relay is turned off

1 – A relay is turned on

.1.3.6.1.4.1.25728.8400.2.2.0

npRelHumSensorValueH.0

Integer

READ

Relative humidity value,%

.1.3.6.1.4.1.25728.8400.2.3.0

npRelHumSensorStatus.0

Integer

READ

Humidity sensor status:
0 – normal;
 1 – fault or a sensor is not connected

.1.3.6.1.4.1.25728.8400.2.4.0

npRelHumSensorValueT.0

Integer

READ

Temperature sensor,°C

.1.3.6.1.4.1.25728.8400.2.5.0

npRelHumSensorStatusH.0

Integer

READ

Humidity sensor status.

0 – A sensor failed

1 – Readings of a sensor are below a normal level

2 – Readings of a sensor are normal

3 – Readings of a sensor are above a normal level

.1.3.6.1.4.1.25728.8400.2.7.0

npRelHumSafeRangeHigh.0

Integer

READ

Upper limit of a safe range for a humidity sensor

.1.3.6.1.4.1.25728.8400.2.8.0

npRelHumSafeRangeLow.0

Integer

READ

Lower limit of a safe range for a humidity sensor

.1.3.6.1.4.1.25728.8400.2.9.0

npRelHumSensorValueT100.0

Integer

READ

Readings of a temperature sensor, multiplied by 100. They are used to read sensor readings with tenth and hundredth of a degree of Celcius. Divide this value by 100 to get a current temperature.

.1.3.6.1.4.1.25728.8800.1.1.2.n

npThermoValue.n

Integer

READ

Сurrent temperature of a temperature sensor, degrees of Celcius, Where n – is a number of a sensor, ranging from 1 to 8 inclusive.

.1.3.6.1.4.1.25728.8800.1.1.3.n

npThermoStatus.n

Integer

READ

Status of a temperature sensor 1

0 – failed or not connected, 1 – below normal, 2 – is normal, 3 – above normal.

Where n – is a sensor number, ranging from 1 to 8 inclusive

.1.3.6.1.4.1.25728.8800.1.1.4.n

npThermoLow.n

Integer

READ/WRITE

Lower limit of a temperature range of a sensor. Where n – is a sensor number, ranging from 1 to 8 inclusive

.1.3.6.1.4.1.25728.8800.1.1.5.n

npThermoHigh.n

Integer

READ/WRITE

Upper limit of a temperature range of a sensor. Where n – is a sensor number, ranging from 1 to 8 inclusive

.1.3.6.1.4.1.25728.8800.1.1.6.n

npThermoMemo.n

DisplayString

READ

A memo for a temperature sensor/ Where n – is a sensor number, ranging from 1 to 8 inclusive

 

SNMP Trap Support

A formal description of TRAPs can be found in a MIB file, which is attached to firmware.

TRAP is sent in a SNMP v1 format, at the same time a description in a MIB file has a format SNMP v2c.

An unambiguous identification of trap mutual consistency for v1 and v2c is described in RFC3584 “Coexistence between Version 1, Version 2, and Version 3 of the Internet-standard Network Management Framework”.

Software for processing SNMP notifications usually converts between two formats easily.

To send TRAPs, there is a need to:

  • Specify an IP address for sending TRAPs on the page "Settings" of a web interface;
  • Enable sending TRAPs by turning on corresponding checkboxes on the web pages «Input-Output» and «Temperature Sensors»

 

 

SNMP TRAP when Temperature Status Is Changed

npThermoTrap identification

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

 

Variables included into npThermoTrap (varbind list)

OID

Data Type

Description

.1.3.6.1.4.1.25728.8800.2.1.0

Integer

A sensor number (1..8), which status change caused sending a TRAP

.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

A sensor status:
0 - a sensor failed or not connected,
1 - a temperature below a safe range,
 2 - a temperature is within a safe range,
3 - a temperature is above a safe range

.1.3.6.1.4.1.25728.8800.2.4.0

Integer

Lower limit of a safe range, °C

.1.3.6.1.4.1.25728.8800.2.5.0

Integer

Upper limit of a safe range, °C

.1.3.6.1.4.1.25728.8800.2.6.0

Octet String

Memo (textual description of a temperature sensor installation place, encoding win1251)

.1.3.6.1.4.1.25728.90.1.0

OctetString

Email, to which messages are forwarded using a NetPing messages forwarding service.

 

SNMP TRAP when Humidity Sensor Status is Changed

npRelHumTrap identification

SNMP v1 enterprise

.1.3.6.1.4.1.25728.8400.9

SNMP v1 generic-trap

enterpriseSpecific(6)

SNMP v1 specific-trap

1

SNMP v2 snmpTrapOID

.1.3.6.1.4.1.25728.8400.9.0.1

 

Variables included into npRelHumTrap (varbind list)

OID

Data Type

Description

.1.3.6.1.4.1.25728.8400.2.5.0

Integer

Humidity sensor status.

0 – a sensor failed

1 – Readings of a sensor are below a safe range

2 – Readings of a sensor are withing a safe range

3 – Readings of a sensor are above a safe range

.1.3.6.1.4.1.25728.8400.2.2.0

Integer

Relative humidity value,%

.1.3.6.1.4.1.25728.8400.2.7.0

Integer

Upper limit of a safe range for a humidity sensor

.1.3.6.1.4.1.25728.8400.2.8.0

Integer

Lower limit of a safe range for a humidity sensor

.1.3.6.1.4.1.25728.90.1.0

OctetString

Email, to which messages are forwarded using a NetPing messages forwarding service.