Configuring the UPS software

This chapter describes how to configure the Beckhoff UPS CU81x0-0xx0 for communication via the USB interface. The required UPS software or the package TcUpsSoftware is already included in the current TwinCAT/BSD version. For older versions, the package can be installed later using doas pkg install TcUpsSoftware.

Note that the UPS software is pre-installed, but the UPS service is not started automatically at system startup. The behavior of the UPS in the event of a power failure is defined in the configuration file TcUpsSoftware.conf under /usr/local/etc/TcUpsSoftware.conf

UPS software: Settings in the configuration file.

Option

Value

Description

ShutdownOnBatteryEnable

[0 or 1]

The option is enabled by default [=1]. In the event of a power failure, the industrial PC is shut down properly.

ShutdownOnBatteryWait

[0 ... 43200 seconds]

If ShutdownOnBatteryEnable is enabled, the industrial PC is shut down after the set time in seconds.

TurnUpsOffEnable

[0 or 1]

If this option is enabled [=1], the UPS is shut down after the industrial PC has been shut down.

TurnUpsOffWait

[0 ... 600 seconds]

If TurnUpsOffEnable is enabled, the UPS is shutdown after the industrial PC has been shut down and the time set in this option has elapsed.

Proceed as follows:

1. Open the configuration file rc.conf with the command doas ee /etc/rc.conf
2. Add line TcUpsSoftware_enable="YES" to the configuration file so that the service is started automatically each time the system is started.
3. Open the configuration file TcUpsSoftware.conf with the command doas ee /usr/local/etc/TcUpsSoftware.conf and enter the required values for the UPS hold time.
4. Start the UPS service with the command doas service TcUpsSofware start
The UPS software controls the Beckhoff UPS CU81x0-0xx0 in the event of a power failure according to the settings in the configuration file TcUpsSoftware.conf and can be disabled again for the current session with the command doas service TcUpsSoftware stop.

If the UPS service is to be disabled permanently, the entry TcUpsSoftware_enable="YES" must be removed from rc.conf.