21.2. UPS diagnostics and statistics

21.2. UPS diagnostics and statistics
	Chapter 21. UPS

21.2.1. UPS diagnostics

This command reports the current situation of the device:

[13:42:55] ABILIS_CPX:d d ups

RES:Ups -----------------------------------------------------------------------
       Uninterruptable_Power_Supply_device                                     
       USB-STATE:CONNECTED    UPTIME:41 days 21:09:37 (13/07/2017 14:49:33)
       POWER-SOURCE:MAIN                              BATTERY:NOT-PRESENT
       V-OUT-ALARM:NO         V-MAIN-ALARM:NO         BATTERY-LOW:N/A
       V-OUT:+12.1 V          V-MAIN:+12.0 V          V-BATT:+0.0 V           
       - Battery Charger ------------------------------------------------------
       CHARGER:ENABLED        CHARGING:NO             
       V-CHARGE:+13.9 V       I-CHARGE:+0.0 A         DUTY-CYCLE:50%
       - Manual battery test result -------------------------------------------
       TEST-ALLOWED:NO        TEST-DELAY:N/A
       LAST-RESULT:NOT-TESTED
       LAST-EXECUTION:N/A
       V-NO-LOAD:N/A          V-START:N/A             V-END:N/A

The meaning:

USB-STATE

State of the UPS:

DISCONNECTED - The device is not connected.
CONNECTED - The device is connected.

UPTIME

Uptime of the UPS. N/A - USB-STATE is DISCONNECTED.

POWER-SOURCE

Power source:

MAIN - The main power voltage is present.
BATTERY - The main power voltage is not present.
N/A - USB-STATE is DISCONNECTED.

BATTERY

Battery condition:

NOT-PRESENT - The battery isn't present.
PRESENT - The battery is present.
PRESENT-TESTING - The battery is present and under testing.
N/A - USB-STATE is DISCONNECTED.

V-OUT-ALARM

The output regulated voltage is out of range:

NO - The output regulated voltage is in the proper range.
YES - The output regulated voltage is outside the proper range.
N/A - USB-STATE is DISCONNECTED.

V-MAIN-ALARM

The main voltage is out of range

NO - The main voltage is in the proper range.
YES - The main voltage is outside the proper range.
N/A - USB-STATE is DISCONNECTED.

BATTERY-LOW

The battery voltage is below the threshold:

NO - The battery voltage is over the battery low threshold.
YES - The battery voltage is below the threshold.
N/A - USB-STATE is DISCONNECTED or BATTERY is NOT-PRESENT .

V-OUT

Output regulated voltage value. N/A - USB-STATE is DISCONNECTED.

V-MAIN

Main power source voltage. N/A - USB-STATE is DISCONNECTED.

V-BATT

Battery voltage value measured when the battery charger is disconnected. N/A - USB-STATE is DISCONNECTED.

CHARGER

Charger state:

ENABLED - The battery charger is enabled.
DISABLED - The battery charger is disabled or the external voltage is too low to charge the battery.
N/A - USB-STATE is DISCONNECTED.

CHARGING

Battery charging state:

NO - The battery is not charging: the battery charger is disconnected (CHARGER is DISABLED) or the charging current (I-CHARGE) is less than ~200mA.
YES - The battery is charging.
N/A - USB-STATE is DISCONNECTED.

V-CHARGE

Battery voltage value measured when the battery charger is connected. N/A - USB-STATE is DISCONNECTED.

I-CHARGE

Battery charge current. N/A - USB-STATE is DISCONNECTED.

DUTY-CYCLE

Battery charging duty cycle:

0 - The battery charger is always disconnected.
50 - The battery charger is connected half of the time with a period of 4 seconds.

100 - The battery charger is disconnected for 0.5 seconds every 60 seconds.
N/A - USB-STATE is DISCONNECTED.

TEST-ALLOWED

Inform if the test can be executed:

NO - It isn't possible to execute the test.
YES - It is possible to execute the test.

TESTING - Test is already ongoing.
N/A - USB-STATE is DISCONNECTED.

TEST-DELAY

Seconds before the DENIED barrier is removed. N/A - USB-STATE is DISCONNECTED.

LAST-RESULT

Result of the battery test:

NOT-TESTED - Test results not available: the test has not been executed yet.
SUCCESSFUL - The battery passed the test.

FAILED - The battery fail the test.
DENIED - It is not possible to start the battery test because there has been a switch to battery in the last 24 hours (caused by a power failure or by a battery test).

BATTERY-LOW - It is not possible to start the battery test because the battery voltage is too low.
BATTERY-NOT-PRESENT - It is not possible to start the battery test because there isn't any battery.
TESTING - Test is running right now.
N/A - USB-STATE is DISCONNECTED.

LAST-EXECUTION

Date and Time of last test execution. N/A - USB-STATE is DISCONNECTED.

V-NO-LOAD

Voltage of the battery before starting the test. N/A - USB-STATE is DISCONNECTED or LAST-RESULT is one of the following: NOT-TESTED, DENIED, BATTERY-LOW, BATTERY-NOT-PRESENT or TESTING.

V-START

Voltage of the battery after starting the test. N/A - USB-STATE is DISCONNECTED or LAST-RESULT is one of the following: NOT-TESTED, DENIED, BATTERY-LOW, BATTERY-NOT-PRESENT or TESTING.

V-END

Voltage of the battery when the test finish. N/A - USB-STATE is DISCONNECTED or LAST-RESULT is one of the following: NOT-TESTED, DENIED, BATTERY-LOW, BATTERY-NOT-PRESENT or TESTING.

21.2.2. UPS statistics

This command can help to understand what is happening, in case of troubles:

[13:48:36] ABILIS_CPX:d s ups 

RES:Ups -----------------------------------------------------------------------
       Uninterruptable_Power_Supply_device                                     
       --- Cleared 41 days 21:08:34 ago, on 13/07/2017 at 14:50:51 ------------
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       SW-SHUTDOWN|           |          0|V-MAIN-ALM |          0|           |
       HW-SHUTDOWN|          0|           |V-OUT-ALM  |          0|           |
       BATT-LOW   |          0|           |           |           |           |
       V-MAIN-FAIL|          0|           |LIVE       |           |    3618517|
       CHARGE-DIS |          0|           |LIVE-EXP   |          0|           |
       ------------------------------------------------------------------------

With reference to the shown interval of time («Cleared 41 days 21:08:34 ago») these counters show the number of:

`SW-SHUTDOWN`	V_OUT_HOST_SHUTDOWN received from the UPS.
`HW-SHUTDOWN`	V_OUT_UPS_SHUTDOWN received from the UPS.
`BATT-LOW`	BATTERY LOW received from the UPS.
`V-MAIN-FAIL`	Failures of the MAIN power.
`CHARGE-DIS`	BATTERY CHARGER disconnection received from the UPS.
`V-MAIN-ALM`	V_MAIN_ALARM detected by the UPS.
`V-OUT-ALM`	V_OUT_ALARM detected by the UPS.
`LIVE`	LIVE received by the UPS.
`LIVE-EXP`	Times the LIVE has expired in the UPS.


21.1. UPS activation		Part III. Software resources