[DKSF 70.3] Manage device with SNMPv1

A device supports configuring parameters and management via an SNMP v1 protocol.

You can find more information about an SNMP protocol on the links:

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

A device supports:

  • Reading OID using Get, Get-Next queries via an SNMP v1 protocol;
  • Setting OID values using a command Set via an SNMP v1 protocol;
  • Sending TRAP messages about events from IO lines and temperature sensors.

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

 

SNMP Protocol Configuration

It is necessary to configure the following parameters using a web interface of a device to access a device via an SNMP v1 protocol:

    • Community  reads – a password which is necessary to specify in any request for reading parameters via an SNMP protocol. It is indicated on the page«Settings».
    • Community writes – a password which is necessary to specify in any request for writing parameters via an SNMP protocol. It is indicated on the page«Settings».

It is necessary to configure the following parameters using a web interface for a device to send TRAP messages via an SNMP v1 protocol:

  • IP 1  for sending TRAP messages – is an IP address, where TRAP messages will be sent. It is indicated on the page «Settings».
  • IP 2 for sending TRAP messages – is the second (additional) IP address, where TRAP messages will be sent. It is indicated on the page «Settings».
  • Rising (0 » 1) – is a checkbox that allows to send SNMP TRAP messages when a logic level on an input line is changed from low to high (rising signal). It is situated on the page «Input-Output Lines».
  • Falling (1 » 0) –  is a checkbox that allows to send SNMP TRAP messages when a logic level on an input line is changed from high to low (falling signal). It is situated on the page «Input-Output Lines».
  • t° raised above a norm – is a checkbox that allows to send SNMP TRAP messages when an upper limit of a norm, specified for the sensor, is exceeded. It is on the page «Temperature Sensors»
  • t° returned to normal – is a checkbox that allows to send SNMP TRAP messages if a temperature on the temperature sensor is back to normal range. It is on the page «Temperature Sensors»
  • t° fell below a norm – is a checkbox that allows to send SNMP TRAP messages when a temperature falls below a threshold indicated for the sensor. It is on the page «Temperature Sensors»

Supported OID

A description of OID, which are 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 device parameters 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 administrator's email

.1.3.6.1.2.1.1.5.0

sysName.0

OctetString

READ/ WRITE

A domain name of a device

.1.3.6.1.2.1.1.6.0

sysLocation.0

OctetString

READ/ WRITE

A location of a device

.1.3.6.1.2.1.1.7.0

sysServices.0

Integer

READ

A binary representation of this OID is a set of supported services. Always 72, a device is a destination 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

A device network interface type

.1.3.6.1.2.1.2.2.1.4.1

ifMtu.1

Integer

READ

A size of a package over a network interface. Always 1514

.1.3.6.1.2.1.2.2.1.5.1

ifSpeed.1

Integer

READ

A network interface speed. 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 as a part of traps. An email, where messages are forwarded using a NetPing service of messages forwarding.

.1.3.6.1.4.1.25728.911.1.0

npSoftReboot

Integer

READ/WRITE

Software reset of a device when writing a value 1

.1.3.6.1.4.1.25728.911.2.0

npResetStack

Integer

READ/WRITE

Software reset of a network interface when writing a value 1

.1.3.6.1.4.1.25728.911.3.0

npForceReboot

Integer

READ/WRITE

Immediate forced software reboot of a device when writing a value 1(a processor reset like turning on a power supply).

.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 locked)

.1.3.6.1.4.1.25728.3800.1.2.0

npGsmRegistration

Integer

READ

A status of a connection to a 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.0

npGsmStrength

Integer

READ

 A GSM signal level

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 – Manually off;
1 – Manually on;
4 – A channel is managed by logic.

.1.3.6.1.4.1.25728.5500.5.1.3.1

npRelayStartReset

Integer

READ-
WRITE

OID for a forced reset of a channel. Write a value 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

A current relay status.

0 – A relay off

1 – A relay on

.1.3.6.1.4.1.25728.7900.1.1.0

npIrPlayCmd.0

Integer

READ/
WRITE

There is a need to write a number of an IR command to send an IR command.

.1.3.6.1.4.1.25728.7900.1.2.0

npIrReset.0

Integer

READ/
WRITE

To reset an IR transceiver there is a need to write 1.

After a reset, specify an IR command and check an IP status

.1.3.6.1.4.1.25728.7900.1.3.0

npIrStatus.0

Integer

READ

An IR transceiver status

.1.3.6.1.4.1.25728.8300.1.1.2.1

npCurLoopStatus.1

Integer

READ

A loop status
0 – norm,
1 –  alarm,
2 – break,
3 – short circuit,
 4 – cutoff

.1.3.6.1.4.1.25728.8300.1.1.3.1

npCurLoopI.1

Integer

READ

Current, mA in a circuit with a current sensor

.1.3.6.1.4.1.25728.8300.1.1.4.1

npCurLoopV.1

Integer

READ

A voltage drop mV in a circuit with a current sensor

.1.3.6.1.4.1.25728.8300.1.1.5.1

npCurLoopR.1

Integer

READ

Resistance,Ohm in a circuit with a current sensor

.1.3.6.1.4.1.25728.8300.1.1.7.1

npCurLoopPower.1

Integer

READ/WRITE

Managing a voltage of current sensor power supply: 0 – turned off;
 1 – turned on;
 2 – reloading a current sensor power supply

.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

A humidity sensor status:
0 – norm;
 1 – error or a sensor is not connected

.1.3.6.1.4.1.25728.8400.2.4.0

npRelHumSensorValueT.0

Integer

READ

A temperature sensor,°C

.1.3.6.1.4.1.25728.8400.2.5.0

npRelHumSensorStatusH.0

Integer

READ

A 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 normal values range for a humidity sensor

.1.3.6.1.4.1.25728.8400.2.8.0

npRelHumSafeRangeLow.0

Integer

READ

Lower limit of a normal values range for a humidity sensor

.1.3.6.1.4.1.25728.8400.2.9.0

npRelHumSensorValueT100.0

Integer

READ

Temperature sensor readings, multiplied by 100. Is used to read the results of the sensor with tenth and hundredth of a degree of Celsius. Devide this value on 100 to get a current temperature.

.1.3.6.1.4.1.25728.8800.1.1.2.n

npThermoValue.n

Integer

READ

A current temperature on a temperature sensor, degrees C, where n – is a sensor number, from 1 to 8 inclusive.

.1.3.6.1.4.1.25728.8800.1.1.3.n

npThermoStatus.n

Integer

READ

A status of a temperature sensor 1

0 – refusal or not connected, 1 – below a norm, 2 – normal, 3 – above a norm.

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

.1.3.6.1.4.1.25728.8800.1.1.4.n

npThermoLow.n

Integer

READ/WRITE

A lower threshold of a sensor temperature range. Where n - is a sensor number, from 1 to 8 inclusive.

.1.3.6.1.4.1.25728.8800.1.1.5.n

npThermoHigh.n

Integer

READ/WRITE

An upper threshold of a sensor temperature range. Where n - is a sensor number, 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, from 1 to 8 inclusive.

.1.3.6.1.4.1.25728.8900.1.1.2.n

npIoLevelIn.n

Integer

READ

A current status of a line. Where n - is a line number, from 1 to 8 inclusive.

.1.3.6.1.4.1.25728.8900.1.1.3.n

npIoLevelOut.n

Integer

READ/WRITE

A status of a line in an output mode/ Where n - is a line number, from 1 to 8 inclusive.

.1.3.6.1.4.1.25728.8900.1.1.6.n

npIoMemo.n

OctetString

READ

A memo (a brief description of an IO line) . Where n - is a line number, from 1 to 8 inclusive.

.1.3.6.1.4.1.25728.8900.1.1.9.n

npIoPulseCounter.n

Counter32

READ/
WRITE

An impulse counter on an IO line. It is counted by a positive rising of an impulse, after filtering out short impulses.
Write 0 for forced nulling. Also it is nulled while turning a power supply off. Where n - is a line number, from 1 to 8 inclusive.

.1.3.6.1.4.1.25728.8900.1.1.12.n

npIoSinglePulseDuration.n

Integer

READ/
WRITE

A duration of one impulse on an output of an input-output line,
(possible values from 100 ms to 25500ms, with a 100 ms step). Where n - is a line number, from 1 to 8 inclusive.

.1.3.6.1.4.1.25728.8900.1.1.13.n

npIoSinglePulseStart.n

Integer

READ/
WRITE

Write 1 to issue a single impulse for an output of an IO. An impulse duration is taken from a variable npIoSinglePulseDuration.n. Where n - is a line number, from 1 to 8 inclusive.

 

SNMP Trap Support

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

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

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

Programs for processing SNMP notifications usually do a conversion between two formats easily.

To send TRAPs there is a need:

    • To specify an address for sending TRAPs on the page of a web interface «Settings»
    • To allow sending TRAPs by enabling corresponding checkboxes on web pages «Input-Output» and «Temperature sensors»

 

SNMP TRAP when an Input IO Line Level Is Changed

NpIoTrap identification:

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

 

Variables in npIoTrap (varbind list)

OID

Data Type

Description

.1.3.6.1.4.1.25728.8900.2.1.0

Integer

An IO line number (starting from 1), changing of which caused sending a TRAP

.1.3.6.1.4.1.25728.8900.2.2.0

Integer

A value of a logic level on IO line (0 or 1)

.1.3.6.1.4.1.25728.8900.2.6.0

Octet String

A memo (a textual description of a line, encoding win1251)

.1.3.6.1.4.1.25728.90.1.0

OctetString

Email where a message needs to be forwarded (for a Netping service of messages forwarding).

SNMP TRAP when a Temperature Sensor 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 in npThermoTrap (varbind list)

OID

Data Type

Description

.1.3.6.1.4.1.25728.8800.2.1.0

Integer

A sensor number (1..8), changing status of which causes sending a TRAP

.1.3.6.1.4.1.25728.8800.2.2.0

Integer

A current temperature value, °C

.1.3.6.1.4.1.25728.8800.2.3.0

Integer

A sensor status: 
0 - failure or a sensor disconnection, 
1 - a temperature is below normal,
 2 - a temperature is normal 
3 - a temperature is above normal

.1.3.6.1.4.1.25728.8800.2.4.0

Integer

Lower limit of a norm, °C

.1.3.6.1.4.1.25728.8800.2.5.0

Integer

Upper limit of a norm, °C

.1.3.6.1.4.1.25728.8800.2.6.0

Octet String

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

.1.3.6.1.4.1.25728.90.1.0

OctetString

Email where messages are forwarded using a Netping's messages forwarding service.

 

SNMP TRAP when a Current Loop Status is Changed

NpCurLoopTrap identification

SNMP v1 enterprise

.1.3.6.1.4.1.25728.8300.2

SNMP v1 generic-trap

enterpriseSpecific(6)

SNMP v1 specific-trap

1

SNMP v2 snmpTrapOID

.1.3.6.1.4.1.25728.8300.2.0.1

 

Variables in npCurLoopTrap (varbind list)

OID

Data Type

Description

.1.3.6.1.4.1.25728.8300.2.1.0

Integer

A number of a current loop, changing a status of which caused sedning TRAP (a value is always 1 for current devices)

.1.3.6.1.4.1.25728.8300.2.2.0

Integer

A loop status:
0 - normal,
1 - alarm, 2 - break,
 3 - short circuit,
4 - a loop power supply is turned off

.1.3.6.1.4.1.25728.8300.2.3.0

Integer

Current in a loop, mA

.1.3.6.1.4.1.25728.8300.2.4.0

Integer

A voltage drop in a loop, mV

.1.3.6.1.4.1.25728.8300.2.5.0

Integer

A loop resistance, Ohm

.1.3.6.1.4.1.25728.8300.2.6.0

Integer

A loop power supply status:
0 - off,
1 - on

.1.3.6.1.4.1.25728.90.1.0

OctetString

Email where messages are forwarded using a Netping's messages forwarding service.

 

SNMP TRAP when a 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 in npRelHumTrap (varbind list)

OID

Data Type

Description

.1.3.6.1.4.1.25728.8400.2.5.0

Integer

A 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.2.0

Integer

Relative humidity value,%

.1.3.6.1.4.1.25728.8400.2.7.0

Integer

Upper limit of a normal values range for a humidity sensor

.1.3.6.1.4.1.25728.8400.2.8.0

Integer

Lower limit of a normal values range for a humidity sensor

.1.3.6.1.4.1.25728.90.1.0

OctetString

Email where messages are forwarded using a Netping's messages forwarding service.