This page describes the device driver and the device window for APC Automatic Transfer Switches via SNMP.
The driver was tested with the following models:
AP4421 SW: 4.34
AP7723 SW: 3.05
NOTE: Please enable SNMP access (v1) and set read/write community via WebUI
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 .
--- The device control parameters
--- The faults page.
--- The device info page.
--- The maintenance page. The configuration parameters described below are set at this page.Configuration parameters
At the maintenance page of the device window there are a couple of configuration parameters which must be set to make the software talk to the unit.
parameter --- description
address --- The SNMP address specification for the device. The full address specification consists of the following fields:aaa.bbb.ccc.ddd:pppp read-community write-community
readBackDelay --- Defines the delay the driver uses when it reads back parameters recently commanded. The delay is initialized at a proved preset value which should not be changed under normal circumstances.
frontPanel --- Defines number of available channels
voltageSensitivity --- Defines units voltage sensitivity HIGH/LOW
voltageRange --- Defines units voltage range WIDE/MEDIUM/NARROW
currentLimit --- Defines units current limit (0..20A)
lineVrms --- Defines line VRMS in V
wideVrms --- Defines wide VRMS in V
mediumVrms --- Defines medium VRMS in V
narrowVrms --- Defines narrow VRMS in V
freqDeviation --- Defines frequency deviation in Hz
deviceComment --- An optional text entered here appears as an addition to the tooltip which is shown while the mouse is placed over a device icon in the GUI. The "\n" character sequence is translated into a newline character, splitting the text into multiple lines.
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.model | TEXT | R/O | StringRange R/O |
| info.serial | TEXT | R/O | StringRange R/O |
| info.swVersion | TEXT | R/O | StringRange R/O |
| info.hwVersion | TEXT | R/O | StringRange R/O |
| info.nomVoltage | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| info.nomFrequency | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| info.inputs | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| info.inPhases | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| info.outputs | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| info.outPhases | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| info.phaseSync | CHOICE | R/O | EnumRange R/O (SYNC OUT OF SYNC) |
| config.readBackDelay | INTEGER | SAVE SETUP | IntegerRange (100 .. 10000) |
| config.frontPanel | CHOICE | SETUP | EnumRange (ENABLE DISABLE) |
| config.voltageSensivity | CHOICE | SETUP | EnumRange (HIGH LOW) |
| config.voltageRange | CHOICE | SETUP | EnumRange (WIDE MEDIUM NARROW) |
| config.currentLimit | INTEGER | SETUP | IntegerRange (0 .. 20) |
| config.lineVrms | INTEGER | SETUP | IntegerRange (207 .. 253) |
| config.wideVrms | INTEGER | SETUP | IntegerRange (3 .. 35) |
| config.mediumVrms | INTEGER | SETUP | IntegerRange (3 .. 35) |
| config.narrowVrms | INTEGER | SETUP | IntegerRange (3 .. 35) |
| config.freqDeviation | CHOICE | SETUP | EnumRange (1Hz 2Hz 3Hz 5Hz 10Hz) |
| config.deviceComment | TEXT | SAVE SETUP | StringRange |
| priority | CHOICE | EnumRange (A B) | |
| position | CHOICE | R/O | EnumRange R/O (A B) |
| load.highThreshold | INTEGER | IntegerRange (0 .. 0) | |
| load.highWarning | INTEGER | IntegerRange (0 .. 0) | |
| load.lowWarning | INTEGER | IntegerRange (0 .. 0) | |
| input.01.name | TEXT | StringRange | |
| input.02.name | TEXT | StringRange | |
| input.01.frequency | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| input.02.frequency | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| input.01.voltage | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| input.02.voltage | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| output.voltage | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| output.current | FLOAT | R/O | DoubleRange R/O (0.0 .. 0.0) |
| output.frequency | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| output.load | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| output.loadPercent | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| output.loadState | CHOICE | R/O | EnumRange R/O (NORMAL LOW-LOAD NEAR-OVERLOAD OVERLOAD) |
| reset | TEXT | NOPRESET | StringRange |
| clearFaults | TEXT | NOPRESET | StringRange |
| internal.model | TEXT | R/O | StringRange R/O |
| internal.model2 | TEXT | R/O | StringRange R/O |
| faults.01 | ALARM | R/O | AlarmFlagRange R/O (Internal Comms) |
| faults.02 | ALARM | R/O | AlarmFlagRange R/O (Redundancy) |
| faults.03 | ALARM | R/O | AlarmFlagRange R/O (Over current) |
| faults.04 | ALARM | R/O | AlarmFlagRange R/O (5V PSU) |
| faults.05 | ALARM | R/O | AlarmFlagRange R/O (24V PSU A) |
| faults.06 | ALARM | R/O | AlarmFlagRange R/O (24V PSU B) |
| faults.07 | ALARM | R/O | AlarmFlagRange R/O (+12V PSU) |
| faults.08 | ALARM | R/O | AlarmFlagRange R/O (-12V PSU) |
| faults.09 | ALARM | R/O | AlarmFlagRange R/O (Switch) |
| faults.10 | ALARM | R/O | AlarmFlagRange R/O (Source A) |
| faults.11 | ALARM | R/O | AlarmFlagRange R/O (Source B) |
| faults.13 | ALARM | R/O | AlarmFlagRange R/O (Voltage Out) |
| faults.14 | ALARM | R/O | AlarmFlagRange R/O (Hardware) |
| faults.15 | ALARM | R/O | AlarmFlagRange R/O (3.3V PSU) |
| faults.16 | ALARM | R/O | AlarmFlagRange R/O (1.0V PSU) |
| faults.17 | ALARM | R/O | AlarmFlagRange R/O (Boost Voltage Source A) |
| faults.18 | ALARM | R/O | AlarmFlagRange R/O (Boost Voltage Source B) |