UPS information in Windows registry
The UPS service communicates with the Beckhoff UPS driver through the Windows registry. It's allowed to read the UPS registry information. Please use the "Beckhoff UPS Configuration" dialog to change (write) the UPS konfiguration. Be very carefull if you try to change (write) the UPS configuration in the Windows registry directly.
Status information
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\UPS\Status
The keys under here are continuously updated by the UPS driver whenever the status of the UPS changes.
Not all UPS devices are able to deliver all status infomation. Overview about the supported status information. |
Value name | Value type | Description | Default value |
---|---|---|---|
BatteryCapacity | REG_DWORD | The percent of battery capacity remaining in the UPS. This element is represented as a value in the range of 0 through 100 percent. (The displayed value is rounded to the nearest integer.) | 0 |
BatteryStatus | REG_DWORD | The current status of the UPS batteries. This member can be of the following value:
| 0 |
CommStatus | REG_DWORD | The status of the communication path to the UPS. This member can be of the following value:
| 0 |
FirmwareRev | REG_SZ | Reports the UPS firmware revision as a displayable string. | "" |
SerialNumber | REG_SZ | Reports the UPS serial number as a displayable string. | "" |
TotalUPSRuntime | REG_DWORD | The amount of remaining UPS run time, in minutes. | 0 |
TotalUPSRuntimeSec | REG_DWORD | The amount of remaining UPS run time, in seconds. Implemented in UPS software v3.0.0.13 and higher. | 0 |
UtilityPowerStatus | REG_DWORD | Reports the status of utility-supplied power into the UPS. This member can be of the following value:
| 0 |
TcPowerFailCnt | REG_DWORD | Power fail counter. Increments every time the UPS service detects power fail. | 0 |
BatteryReplaceDate | REG_SZ | Set battery replace date. The latest battery replace date can be set using the Beckhoff UPS Configuration->Configure device.. dialog command. Implemented in UPS software v3.0.0.8 and higher. | "" |
TcChargeFlags | REG_DWORD | Battery charge status flags. This member can be one or more of the following values (bits): Bits0..7 := General battery status flags (if all bits are set to 0 => unknown status).
| 0 |
Status information about intelligent battery unit (e.g.: CX2100-0914 UPS model):
Value name | Value type | Description | Default value |
---|---|---|---|
BatteryHardwareVersion | REG_SZ | Hardware version of battery unit. Implemented in UPS software v3.0.0.13 and higher. | "" |
BatteryProductionDate | REG_SZ | Manufacturing date of the battery unit. Implemented in UPS software v3.0.0.13 and higher. | "" |
BatteryRatedCapacity | REG_DWORD | Rated battery capacity (mAh). Implemented in UPS software v3.0.0.13 and higher. | 0 |
BatterySerialNumber | REG_SZ | Serial number of battery unit. Implemented in UPS software v3.0.0.13 and higher. | "" |
Configuration settings
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\UPS\Config
The keys under here are used by the UPS service to configure the UPS.
Value name | Value type | Description | Default value |
---|---|---|---|
Vendor | REG_SZ | UPS vendor name | "(None)" |
Model | REG_SZ | UPS model name | "" |
RunTaskEnable | REG_DWORD | Enable/disable the configuration of the Task Scheduler shutdown task:
| 0 |
TaskName | REG_SZ | Name of the Task Scheduler shutdown task. The Beckhoff UPS configuration dialog is creating shutdown task with the name: "UPS System Shutdown Program". | "" |
TaskFolder | REG_SZ | Folder name of the Task Scheduler shutdown task. Empty string is representing the root folder. Implemented only in UPS software v3.0.0.10 and higher. | "" |
TaskCompatibility | REG_DWORD | Task Scheduler v1.0 compatibility settings. Implemented only in UPS software v3.0.0.10 and higher.
| 0 |
RunTaskWait | REG_DWORD | The max. run time (execution time) of the shutdown task in seconds. After this time the UPS service continues the windows shutdown process.
Implemented/available only in UPS software v3.0.0.8 and higher and available only under Windows Vista, W7, WES 7 (32 and 64 bit) Older operating systems have fixed max. run time value of 30 seconds. | 30 |
ShutdownOnBatteryEnable | REG_DWORD | Enable/disable the shutdown of operating system after critical alarm:
| 1 |
ShutdownOnBatteryWait | REG_DWORD | Max. run time on batteries before critical alarm. This element is represented as value in range from 0 through 720 minutes. Other values are not allowed. | 2 |
ShutdownOnBatteryWaitUnit | REG_DWORD | Unit of max. run time on batteries before critical alarm. Implemented only in UPS software v3.0.0.13 and higher.
| 1 |
NotifyEnable | REG_DWORD | Enable/disable sending of "power fail" messages:
| 0 |
TurnUPSOffEnable | REG_DWORD | Activate/deactivate switching off the UPS outputs after shutdown:
| 1 |
TurnUPSOffWait | REG_DWORD | Max. delay time in seconds to switch off the UPS output to save battery charge. The allowed values may vary and depends on the used UPS model. | 180 |
BatteryReplaceNotifyEnable | REG_DWORD | Enable/disable logging of battery replace warnings in Window Eventlog:
Implemented in UPS software v3.0.0.8 and higher. | 0 |
BatteryReplaceNotifyWait | REG_DWORD | Months between the latest battery replace date (if known) and the first battery replace warning in the Windows Eventlog. This element is represented as value in range from 0 through 480 months. Other values are not allowed. Implemented in UPS software v3.0.0.8 and higher. | 60 |
TcTurnUPSProtOffWait | REG_DWORD | Max. delay time for switching off UPS protection after session end (user shutdown or restart) in seconds. With shorter times, the PC (and the UPS) can be switched off more quickly after a shutdown. However, during a restart the PC may not be fully protected against voltage failure. With longer times and shutdown, it takes longer for the PC (and the UPS) to switch off. On the other hand, during a restart the PC is protected during the complete start-up phase. During a restart, UPS protection is activated before the delay time has elapsed once the UPS service has resumed communication with the UPS. | 360 |
Further settings
KEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\UPS
Value name | Value type | Description | Default value |
---|---|---|---|
FirstMessageDelay | REG_DWORD | Seconds between the power failure and first message send to the user. | 5 |
MessageInterval | REG_DWORD | Seconds between subsequent power fail messages send to the user. | 20 |