TeraBee IND-Thermal-90 User manual

User Manual for
Terabee IND-Thermal-90 graphical
user interface (GUI)
Technical support: [email protected]
Sales and commercial support: [email protected]

Table of contents
Introduction 3
Connection to PC 3
Hardware setup 3
GUI installation and execution 5
Windows 5
Linux 5
GUI structure 6
Top level static menu 7
Connection Tab 8
Settings tab 10
Application 1 page 12
Application 2 page 15
Application 3 page 18
Copyright © Terabee 2021
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)
2/19

1. Introduction
The purpose of this document is to explain the usage of the IND-Thermal-90 thermal
camera Graphical User Interface (GUI) for PC connection. Such a GUI is designed to help
the customer get experience with the camera.
2. Connection to PC
This section provides guidelines on connection and sensor evaluation on a PC, using
Microsoft®Windows®OS and Ubuntu. This includes instructions on hardware
arrangement, software setup using the Terabee IND-Thermal-90 GUI and examples on
executing commands for modifying some of the basic sensor parameters.
2.1. Hardware setup
Figure 1 illustrates the connection logic between the IND-Thermal-90 sensor and a PC, and
the following components are required for a complete setup:
●1×Terabee IND-Thermal-90 sensor
●1×Straight M12 5-pin A-coded cable of your preference (example here,not provided
by Terabee)
●1×RS485-to-USB adapter (example here,not provided by Terabee)
○(Not mandatory) 1 ×USB extension cable (already available in suggested
RS485-to-USB package) to connect to PC Control Unit (PC)
●1×Power Supply capable of supplying 12-24V DC @ >50mA
Figure 1. IND-Thermal-90 connection to PC: hardware setup diagram
Copyright © Terabee 2021
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)
3/19

The following summarizes the steps to be taken for connecting the IND-Thermal-90 camera
to a PC.
Step 1
Connect the M12 cable to the sensors M12, 5-pin connector.
Step 2
Connect the data lines of the M12 cable to the RS485-to-USB adapter. See wiring
instructions in Table 1.
Table 1 - Wiring connection between IND Thermal and RS485-to-USB adapter
M12 cable
Specific for RS485-to-USB adapter here
Tx/Rx+ (pin 4)
A+
Tx/Rx- (pin 5)
B-
Ground (pin 2)
GND
Step 3
Connect the power lines of the M12 cable to a power supply source. See wiring instructions
in Table 20. Wire +24V (pin) and GND (pin) to the selected power supply (capable to provide
24V supply).
Table 2 - Wiring connection between IND-Thermal-90 and Power supply
M12 cable
Power supply
12V ... 24V DC power supply (pin 1)
Positive pin
GND (pin 2)
Negative pin
Step 4
Connect the RS485-to-USB adapter to the USB port of your PC. An extension USB cable
(provided with the recommended adapter) from the adapter to the PC might be useful.
Step 5
Power the sensor by turning on the power source.
Step 6
The camera LED indicator PWR will now constantly stay ON (GREEN) to confirm proper
voltage supply. STATUS LED will also turn green confirming normal operation .
1
1At camera startup, if there is already an alarm condition active and the NO/NC output is enabled,
STATUS led might turn ON in GREEN color and quickly (after 1-2 seconds) switch to RED.
Copyright © Terabee 2021
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)
4/19

Step 7
The hardware setup is completed and the user can now proceed to configuring basic
software parameters.
During power up the sensor will apply the last operating parameters used or default ones if
it’s the first boot-up
Note: The NO/NC line is not used in this setup, it can be left floating
3. GUI installation and execution
Windows
Download the file IND-Thermal-90-GUI installer from the Terabee product webpage.
Execute the .exe file and follow the installation instructions. The installer will create a Start
Menu shortcut for easy access by accessing Start -> type IND-Thermal-90 -> Click on GUI
icon. Alternatively, the executable can be found under the default installation path (see
Figure 2), usually C:\Program Files (x86)\Terabee\IND-Thermal-90\Application\. The
folder is shown below, and the executable highlighted. Double click on
Terabee_IND-Thermal-90.exe to start the software.
Figure 2. Terabee_IND-Thermal-90.exe GUI executable inside the installation directory on
Microsoft®Windows®.
Ubuntu (18.04 LTS and above)
Download the IND-Thermal-90 installer from the Terabee product webpage. Allow
executing the file as a program by typing in the console chmod +x %filename% where
%filename% is the name of the downloaded file. Double click the .run file and follow the
Copyright © Terabee 2021
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)
5/19

installation instructions. The default install path is
/home/%user%/Terabee/IND-Thermal-90, where %user% is the name of the current
logged in user. To start the application, open a new terminal in the IND-Thermal-90 folder
and type ./Terabee_IND-Thermal-90.sh. This will start the software. Alternatively, type
$HOME/Terabee/IND-Thermal-90/Terabee_IND-Thermal-90.sh in a terminal window
from any other location.
4. GUI structure
This section describes the different sections of the GUI. To start, it is needed to
differentiate between the static and dynamic parts of the interface. Figure 3 illustrates the
parts. From top to bottom: the static menu, above the first red line. The dynamic section,
between the two red lines. The bottom static part (logo), under the second red line. The
dynamic section will change when switching between the different tabs. The static ones will
not.
All fields marked with “(i)” will reveal more information about the specific
parameters when the mouse is hovered over them.
Figure 3. Landing (Connection) page of the Terabee IND-Thermal-90 GUI
Copyright © Terabee 2021
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)
6/19

4.1. Top level static menu
Figure 4. Screenshot of the top level (static) menu
This (static) section (see Figure 4) is the main navigation interface between the different
dynamic sections. A breakdown of the different buttons and their functionalities is listed as
follows (starting from the top left corner):
●About
○License - this opens up a small pop up window describing the version of the
GUI and its license. It contains information about third party libraries as well.
○Product page - pressing this will open the default web browser to the
product page of the Terabee IND-Thermal-90
●Tools
○Factory reset - pressing this will reset the currently selected sensor to the
factory default settings. A warning pop up with some text explaining what is
about to happen will be displayed and a Yes/No confirmation will be
expected from the user.
A sensor restart (power off-on cycle) is highly recommended after this action.
●Connection - pressing this button will switch the dynamic section of the window to
the Connection tab.
●Settings - pressing this button will switch the dynamic section of the window to the
Settings tab.
●Application 1 - pressing this button will switch the dynamic section of the window
to the Application 1 tab.
●Application 2 - pressing this button will switch the dynamic section of the window
to the Application 2 tab.
●Application 3 - pressing this button will switch the dynamic section of the window
to the Application 3 tab.
Copyright © Terabee 2021
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)
7/19

4.2. Connection Tab
At start, the GUI will open the Connection tab and the window will look like in Figure 3.
On the left side of the window, there is the connection to the network section. This
contains 3 fields and 2 buttons, as follows:
●Port - this entry field allows the user to select the physical port to which the RS485
to USB adapter is connected. Information on how to obtain the port number can be
seen if the mouse cursor is hovered over the field for about 1 second.
●Baudrate - this scroll down menu allows selecting the baudrate of the connection.
This selection needs to match the baudrate of the IND-Thermal-90 sensor. By
default, this value is 19200.
●Parity - this scroll down menu selects the parity of the connection. This selection
needs to match the parity of the IND-Thermal-90 sensor. By default, this value is
Even.
●Connect - once the settings are correctly selected, pressing the button Connect will
open the communication port to the RS485 network.
●Disconnect - disconnects the port.
The slave device selection is placed to the right of the network connection, separated by a
vertical line. Once the network connection is established, select the slave device to address.
The slave IDs can be in the range of 1-247, default value being 1. Once the correct slave ID
is selected, press Select slave. This will start a routine that will verify the connection to that
specific device and, if the connection is validated, it will enable the rest of the buttons of
the interface.
Finally, on the far right side of the window, contained within a box, there is a section which
can update the selected device network configuration. This can be done by selecting the
new desired parameters, such as baudrate, parity, and slave address, then clicking on
Update. A small pop up window with more details and a confirmation button will appear.
The change of these parameters corresponds to the holding registers at address 0 (Device
address) and 1 (RS485 parameters).
A sensor restart (power off-on cycle) is highly recommended after this action.
Copyright © Terabee 2021
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)
8/19

4.3. Settings tab
This section (shown in Fig. 5) handles the device’s global settings, meaning it defines how
the electrical NO/NC pin behaves and which applications are allowed to trigger an action
on the pin.
Figure 5. Screenshot of the Settings tab
The list of options is reported below (starting from the top):
●Electrical NO/NC output - this button acts as a master switch and defines whether
the NO/NC pin can be actuated. If this is disabled (not checked), even if there is an
alarm condition in an enabled application, the electrical output will not react.
Toggling (checking) this corresponds to writing TRUE or FALSE to the Input Coil at
address 0 (NO/NC enabled/disabled).
●NO/NC select - this scroll down menu defines whether the electrical pin will act as a
normally open or normally closed contact. Changing this corresponds to writing
TRUE or FALSE to the Input Coil at address 2 (NO/NC selected).
●NPN/PNP select - this scroll down menu defines the type of circuit used to actuate
the pin. In an NPN circuit (also known as a sinking output) the pin will short to
Copyright © Terabee 2021
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)
9/19

ground when activated. On the other hand, a PNP circuit (also known as sourcing
output) will provide 24V @ 450mA when activated. Changing this setting
corresponds to writing TRUE or FALSE to the Input Coil at address 3 (NPN/PNP
selected).
●Temperature choice - this scroll down menu defines which thresholds are being
used for the applications. There are 3 options: Hot, Cold, and Hot & Cold. Changing
this parameter corresponds to writing to the Holding Register at address 13
(Temperature choice).
●NO/NC timer based - this scroll down menu defines how the electrical pin gets
reset. There are two choices: Timer based and Action based. Timer based means
the pin will reset after the delay seen in the field below this (NO/NC duration),
whereas Action based means the pin will remain active until the Reset NO/NC pin
button gets pressed on one of the applications screen. Changing this setting
corresponds to writing TRUE or FALSE to the Input Coil at address 1 (NO/NC timer
based).
●NO/NC duration - this input field defines how long the electrical output will remain
active when NO/NC timer based is set to TRUE (Timer based). This field can be
manually edited in the range 50-2000. Changing this value corresponds to writing to
the Holding Register at address 8 (NO/NC ON time). Press ENTER to save the value.
●Emissivity - This input field allows selecting the emissivity of the target. The values
are defined from 1 to 100, corresponding to a real emissivity range between 0.01 (1
in this box) and 1 (100 in this box). For best results, this value should match the
emissivity of the material being measured. Changing this value corresponds to
writing to the Holding Register at address 9 (IND-Thermal-90 emissivity). Press
ENTER to save the value.
●Application 1, 2, and 3 - Switching buttons to enable or disable the respective
applications alarm. Toggling these buttons corresponds to writing TRUE or FALSE in
the Input Coils at addresses 5 (Application 1 (alarm) enabled/disabled), 6
(Application 2 (alarm) enabled/disabled), and 7 (Application 3 (alarm)
enabled/disabled).
Copyright © Terabee 2021
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)
10/19