9.266 Generex-CS121-UPS-Adapter

This page describes the device driver and the device window for the Generex CS121 UPS SNMP/Web Adapter.

Device window pages

The following table shows which device window pages are available with this individual device type. Tool-bar functions not mentioned here are described at the general description of device windows .

Configuration parameters

At the maintenance page the only parameter to be set is the IP address of the CS121 adapter. Please also notice the section "Prepare the CS121 for the use with the sat-nms software" below.

Fault monitoring

The device driver monitors a couple of fault conditions at the device. These are:

Please note, that the "Low battery" / "Depleted battery" faults appear exclusively, i.e. "Low battery" disappears if the battery becomes completely empty. The faults also may appear while the input is OK, indicating the possible consequence of an input power loss.

Prepare the CS121 for the use with the sat-nms software

The sat-nms software controls the CS121 using SNMP. For this, SNMP control must be enabled at the CS121. Please refer to the CS121 user manual for details, a summary of this procedure is listed below.

  1. Set the network parameters (IP address / subnet mask / gateway) at the CS121 to make it accessible from the VLC.
  2. With the CS121 web user interface, at the Configuration / Network&Security page, set the Enable SNMP Agent check mark to switch on SNMP in general. Press Apply to accept the change.
  3. At the Configuration / SNMP page in the table SNMP Communities , add the IP address of the VLC controlling the CS121. Set the community for this address to public and the permission to Read/Write . Again press Apply to accept the change.
  4. At the Configuration / Save Configuration page select Save, Exit & Reboot to make the changes effective. Be sure, that the UPS has mains power available during the reboot, it might hang otherwise.

Without having the VLC's IP address in the SNMP Communities table, the CS121 will silently ignore all communication requests from the VLC, the sat-nms user interface will show a communication fault (Read timeout) for the device.

Variables defined by this device driver

name type flags range
info.driver TEXT R/O StringRange R/O
lowLevel.cmd TEXT StringRange
lowLevel.reply TEXT R/O StringRange R/O
faults.99 ALARM R/O AlarmFlagRange R/O (Communication)
faults.commstat TEXT R/O StringRange R/O
info.type TEXT R/O StringRange R/O
info.port TEXT R/O StringRange R/O
info.frame TEXT R/O StringRange R/O
info.name TEXT R/O StringRange R/O
info.model TEXT R/O StringRange R/O
info.revision TEXT R/O StringRange R/O
battery.state TEXT R/O StringRange R/O
battery.voltage FLOAT R/O DoubleRange R/O (0.0 .. 0.0)
battery.current FLOAT R/O DoubleRange R/O (0.0 .. 0.0)
battery.temperature INTEGER R/O IntegerRange R/O (0 .. 0)
battery.capacity INTEGER R/O IntegerRange R/O (0 .. 100)
battery.since INTEGER R/O IntegerRange R/O (0 .. 0)
battery.remaining INTEGER R/O IntegerRange R/O (0 .. 0)
input.frequency FLOAT R/O DoubleRange R/O (0.0 .. 0.0)
input.voltage FLOAT R/O DoubleRange R/O (0 .. 0)
input.current FLOAT R/O DoubleRange R/O (0.0 .. 0.0)
input.power FLOAT R/O DoubleRange R/O (0 .. 0)
input.lineBads INTEGER R/O IntegerRange R/O (0 .. 0)
output.source TEXT R/O StringRange R/O
output.frequency FLOAT R/O DoubleRange R/O (0.0 .. 0.0)
output.voltage FLOAT R/O DoubleRange R/O (0 .. 0)
output.current FLOAT R/O DoubleRange R/O (0.0 .. 0.0)
output.power FLOAT R/O DoubleRange R/O (0 .. 0)
output.load INTEGER R/O IntegerRange R/O (0 .. 100)
faults.01 ALARM R/O AlarmFlagRange R/O (UPS Summary)
faults.02 ALARM R/O AlarmFlagRange R/O (Mains input)
faults.03 ALARM R/O AlarmFlagRange R/O (Low battery)
faults.04 ALARM R/O AlarmFlagRange R/O (Depleted battery)