# The KNutClient Handbook

## Introduction

The &knutclient; is a GUI application that watches the state of UPS for system NUT.

## Using KNutClient

### Main window &knutclient;

Main window applications &knutclient;

The &knutclient; is the graphic client application for system NUT "Network Ups Tools" for TDE. It watches the states of the UPS and displays the values of the variables for which the UPS device can support.

From version 0.6.0 &knutclient; supports the running of instant command and enables the change of RW variables.

From version 0.9.0 &knutclient; doesn't support protocol UDP.

Main window &knutclient;

Main window is divided in two parts.

The bottom of the Main panel displays the day dates. The left part of that panel shows the state of the UPS (On line, On battery, Overload, Battery low, etc). Some parameters can't be changed in this panel, such as the name of the UPS and its serial number. Those parameters are read only once (when you choose the UPS).

The right part includes analog panels. These panels show values of variables like input voltage, load UPS, battery charge, UPS temperature, battery voltage.

&knutclient; includes toolbar, with standard buttons and button for the UPS choice.

### &knutclient; and TDE panel

&knutclient; and TDE panel

From 0.8.0 version &knutclient; docks in TDE panel. His icon is variable and shows information about UPS load, runtime and the charge of battery, depending on type of icons is selected. After moving the pointer of the mouse on the icon, information window "ToolTip" is showes up, which includes more information about UPS, Name, UPS name ,Address, State, Runtime ..

### More KNutClient features

For connecting with server side of NUT (upsd), &knutclient; uses protocol TCP. When UPS is selected in toolbar, &knutclient; tries to read the data. When reading fails, reading is repeated. The maximum count of repetitions is five. Afterwards &knutclient; reads data in periodical sequences. The first reading reads all variables, next reading reads variables that analog panels, RUNTIME a state of UPS show only. Variables show UPS name, manufacturer, serial number ... are read only once, because their changes aren't probable.

Errors which arise like answer from user actions are show in their own window.

## Command Reference

### The main KNutClient window

#### The File Menu

File Showing Ups variables and commands

- Shows Ups variables for selected Ups

File Running instant command

- Runs selected instant command for selected UPS

File Setting RW variables

- Changes selected UPS RW variable

Ctrl q File Quit

- Quits program

#### Menu Connection

F1 Connection Reconnect

- Restore connection (reconnect) to UPS server(upsd).

#### Menu Settings

Settings Show Toolbar

- Shows/Hides toolbar.

Settings Show Statusbar

- Shows/Hides statusbar.

Settings Configure Shortcuts...

- Opens dialog panels for configuration key/action associations.

Settings Configure &knutclient;

- Opens main configuration dialog panels.

Settings Using description

- Shows/Hides tooltip for showing UPS variables and commands.

### Icon in TDE panel

Menu of TDE panel's icon

#### Menu

UPS

- Using for select Ups.

Showing Ups variables and commands

- Shows Ups variables for selected Ups.

Running instant command

- Runs selected instant command for selected UPS.

Setting RW variables

- Changes selected UPS RW variable.

Reconnect

- Restore connection (reconnect) to UPS server(upsd).

Setting &knutclient;

- Opens configuration dialog panels.

About &knutclient;

- Shows information about aplication &knutclient;.

Minimalize

- Closes main window.

Quit

- Quits program.

### Showing variables

This window shows list of all variables and instant commands, when exist for selected UPS. Window of variables and instant commands

### Instant commands

Instant commands run in UPS, the NUT server puts the command selected driver and driver will run the command in UPS. The control window offers commands, which the driver supports.

OK

- The button OK runs the selected commands.

Cancel

- The Button Cancel closes the window.

Command

- The command for running is selected here.

### User changed (RW) variables

User changed variables are group of variables which can be changed by the user. Majority of them are equal to setting of UPS. There are two types of user changed variables, char or enumerated variables. Char variables are a string of chars with maximal length. Enumerated variables are a list of right values for setting these variables.

User changed variable is not changed on server NUT (upsd) but the server puts command for change to driver, it changes the setting immediately. This activity is not instant and it can wait a few seconds.

OK

- ButtonOK changes variable.

Cancel

- Button Cancel close window.

Default

- Button Default sets default values this variable.

Variable

- Variable for changed is selected here.

Value

- Values for selected variable are selected here. Array for changed of value is changes on base type of variable.

### Setting &knutclient;

The window for setting has got five parts Setting, UPS, Panel, Fonts and Analog.

#### Setting

Part Setting is used for setting number of rows, analog panels, background color of the main window, input voltage (120/230)V, frequency of input voltage (50/60)Hz and allowing of Xfer's values (LowXfer and HighXfer)

&knutclient;

Number of columns

- This sets the maximum number of columns for analog panels

Use custom background color

- This allows to use the custom background color of the main window.

Color of Background

- This selects the background color.

Use dialog "Are you sure"

- This switches on dialog "Are you sure" when you want to end the program. When you don't acknowledge dialog "Are you sure", program doesn't stop.

Use Main window when program started

- Sets showing main window, when program started.

Show message window, when program reports error

- Permits showing message window, what shows description of error. It's useful when docking of program isn't forbided.

Nominal Input Voltage

- This selects nominal input voltage from 230V or 120V. The selection isn't useless of "Use High-Low XFER" is switched on.

Nominal Input Frequency

- This selects nominal input frequency from 50Hz or 60Hz. The selection isn't useless of"Use High-Low XFER" is switched on.

Use High-Low XFER

- This sets nominal input voltage and nominal input frequency on based values in variables of NUT LOWXFER and HIGHXFER. These variables determine the range of value input voltage, which UPS can work with. On the basis of thise values &knutclient; sets input voltage and input frequency for analog panels which use them. These panels are input voltage, input frequency and etc.

#### UPS

The part UPS is used for setting the list of UPS and their parameters The left part includes list of UPS. The right part includes buttons for adding, changed parameters and deleting the record of UPS.

&knutclient;

Add

- This adds into the list another UPS and sets its parameters.

Change

- This changes parametric selected UPS.

Delete

- This deletes UPS from list.

##### Setting of parameters

This windows is used for setting parameters of UPS.

Name

- This sets the name of UPS for the &knutclient; program.

UPS address

- This sets name of PC. UPS is connected with this PC. This name is UPS address on net. Examples: ns.alo.cz, localhost, 192.168.1.12.

UPS name

- This sets name of UPS as it is defined in NUT. When name is not defined program uses the first name of NUT system list on this PC. This is true when minimal version of upsd is 1.3. Look into NUT documentacion. Examples: victron, myups, apc700.

Delay (ms)

- This sets the interval between two transmitions of data (reading data) from the NUT system.

Password

- This sets the password for the authorization of the user.

Store NUT password in configuration file

- When you select this selection, the password will be saved into the configuration file. Password saved in configuration file not crypt. When you don't select this selection, the password will be forgotten, when the program is ended.

UPS Variables

- This selects variables which will show in analog panels in the right part main window.

Parameters User Name and Password are used for instant command or change of RW variables only. For watching the state of UPS the User name and the Password aren't needed. The Password and The User name have got their equivalents in file upsd.users of the NUT system.

#### Panel

The part Panel is used for selecting which information's parts of the main panel will show.

&knutclient;

Overloading

- Shows/Hides showing overloading

UPS Battery low

- Shows/Hides showing battery low.

Replace battery

- Shows/Hides showing that battery needs to be replaced

Ups calibration

- Shows/Hides showing UPS calibration.

Manufac. + Model

- Shows/Hides showing Manufacturer and Model of UPS

Manufacturer

- Shows/Hides showing Manufacturer of UPS.

Model

- Shows/Hides showing Model of UPS.

Serial

- Shows/Hides showing serial number.

Firm. rev.

- Shows/Hides showing firmware's revision.

Runtime

- Shows/Hides show the time of the runtime on battery without power.

Use custom background color

- This allows to use the custom background color of the main panel.

Color of background

- This selects the background color.

#### Fonts

The part Fonts is used for selecting used fonts.

&knutclient;

Use custom font

- Shows/Hides allows to select custom fonts for the main panel and the analog panels.

Main panel / Analog panels

- This selects the panel for which the font is selected.

Font

- This selects the font for the selection panel. This is used when select Use custom font is selected.

#### Analog

The part Analog is used for setting color for the analog panels.

&knutclient;

Use custom background color

- This allows to use custom background color for the analog panel.

Color of background

- This selects the background color of analog panel.

Use custom other colors

- This allows to select custom color of the analog panel's other parts.

Color of pointer

- This is used for selecting the color of analog panel's pointer (finger). Default color is black.

Color of OK range

- This is used for selecting color of range OK for analog panel. Default color is green.

Color of warning range

- This is used for selecting color of range warning for analog panel. Default color is yellow.

Color of error range

- This is used for selecting color of range error for analog panel. Default color is red.

Color of scale

- This is used for selecting color of scale for analog panel. Default color is black.

Color of font

- This is used for selecting color of font for analog panel. Default color is black.

Digital processing of pointers

- This is used for selecting type of graphics proccessing of pointers.

#### Docking

The part DOCK is used for setting parameters of docking program.

&knutclient;

Type of dock's showing (Dock is TDE panel).

Picture

- Sets picture type of icon.

General

- Sets general type of icon, for specialist only.

Items of ToolTip. (ToolTip is bubble help.)

Manufacturer

- Shows/Hides showing Manufacturer of UPS.

Model

- Shows/Hides showing Model of UPS.

Serial

- Shows/Hides showing serial number.

Firm. rev.

- Shows/Hides showing firmware's revision.

Runtime

- Shows/Hides showing the time of the runtime on battery without power.

Battery Charge

- Shows/Hides showing the Battery Charge.

Load UPS

- Shows/Hides showing the Load of UPS.

Use custom background color

- This allows to use the custom background color of TDE panel's icon, when type of icon in TDE panel is picture.

Color of background

- This selects the background color.

## Questions and Answers

&reporting.bugs; &updating.documentation;

The &knutclient; isn't working, but the upsc is. What shall I do ?

See the setting number of port. From version 0.5 (NUT) the number of port is changed.

## Credits and License

&knutclient;

Program copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008 Daniel Prynych Daniel@prynych.cz

Documentation copyright 2003, 2004, 2005, 2006, 2007, 2008 Daniel Prynych Daniel@prynych.cz

Translations done by:

- Daniel Prynych Daniel@prynych.cz Eng

&underFDL; &underGPL;

## Installation

### How to obtain KNutClient

The source code is available at https://mirror.git.trinitydesktop.org/gitea/TDE/knutclient .

### Requirements

In order to successfully use &knutclient;, you will need the TDE libraries (tdelibs)

### Compilation and installation

In order to compile and install &knutclient; on your system, you will need cmake.

    % mkdir -p build
    % cd build
    % cmake ..
    % make install

For further instructions, please, read the INSTALL file.

Since KApp uses autoconf and automake you should have not trouble compiling it. Should you run into problems please report them to the TDE mailing lists.

&documentation.index;