4. 1 Introduction
Workswell Thermo Safety 2013 is a complex solution for situations where
the temperature safety is essential. You can connect up to 501 cameras simul-
taneously and then check your temperature requirements in real-time. Both
connected cameras and temperature requirements, called Alarms are saved in
so called Sessions and the program can save your customized layout as well. The
application oers a plenty of options to customize appearance, notications and
other parameters, yet it doesn't take more than ve minutes to set everything
up. Workswell Thermo Safety 2013 is more than thousand times faster
than a regular re safety system, much more easier to congure, and is able
not only to recognize a security breach but also to warn you when a potentially
dangerous event appears.
1.1 Terminology
Main window of the application with the names of panels
1Depends on your network and hardware conguration
4
5. 2 Preparations
2.1 General system requirements
2.1.1 Minimal requirements
Processor: Intel Core 2 Duo or equivalent
Memory(RAM): 1 GB
HDD: At least 100 MB available hard disk space.
NIC: At least Fast Ethernet network adapter.
OS: Windows 7
Resolution: 1024x768 px
2.1.2 Recommended conguration
Processor: Intel Core i3
Memory(RAM): 4 GB
HDD: 1 GB available hard disk space
NIC: Gigabit Ethernet adapter and also a Gigabit Ethernet switch could be
used for connecting more devices
OS: Windows 7
Resolution: Full HD (1920x1080)
Monitor(s): 2 x Full HD monitor
2.2 Hardware setup
In order to acquire images from a GigE Vision camera, an use them in our
software you need to rst make sure that you have all the correct hardware.
Below is a list of requirements.
2.2.1 Special hardware requirements
GigE Vision camera The camera must be GigE Vision standard compliant.
If you have a camera that has a Gigabit Ethernet port but is not GigE Vision
compliant, you cannot acquire images using our software. You should nd the
GigE Vision logo in the camera's user manual or marketing literature.
5
6. Gigabit Ethernet port While it is possible to acquire images with Ethernet
and Fast Ethernet ports, which support 10 MB/s and 100 MB/s respectively,
this will only work at very slow frame rates and small resolutions. It is highly
recommended that you use a Gigabit Ethernet Network Interface Controller
(NIC).
2.2.2 Network conguration
Once you have the hardware and software installed correctly, you must congure
the network as well. GigE Vision cameras can obtain an IP address from a
DHCP server or select one for itself using Link Local Addressing (LLA). If you
connect the camera to a Gigabit Ethernet network with a DHCP server, the
camera is automatically detected. If the camera is connected directly to the
computer (using either a regular or cross-over cable), maybe you will need to
wait about a minute for the camera to timeout on the DHCP request and use
LLA. The Windows operating system may display a warning that the network
card has only limited operation. You can ignore this warning.
Windows displays a warning when camera is directly connected
2.2.3 Jumbo packets
Typically, network drivers will split any data larger than 1500 bytes into multiple
packets. However, the GigE Vision standard allows packet sizes of up to 9014
bytes. These large packets, also known as Jumbo packets, allow the camera to
more eciently transfer data across the network. You can enable Jumbo packets
in many network cards from the Device Manager by right-clicking the network
card and selecting Properties.
6
7. Setting Jumbo packets on the Intel PRO/1000 Adapter
2.2.4 Network Firewalls
When a camera acquires an image, it immediately streams those data packets
to the host. However, network rewalls will not allow the packets to reach
their destination because rewalls typically block uninitiated incoming trac.
Therefore you will need to disable you rewall in order to acquire images from
a GigE Vision camera. You can disable the Windows Firewall from the Control
Panel (StartControl Panel). However if you have a network card with an
Intel PRO/1000 chipset and you are using the Filter driver that comes with JAI
SDK (which is included in this package), it is most likely that you will not need
disable the rewall.
2.2.5 Caveats and pitfalls
Jumbo Packets If your NIC device, or any intermediate network hardware
(switch, router, etc.), does not support Jumbo packets, you will be limited to
a packet size of less than 1500 Bytes. The GigE Vision packet size cannot be
greater than the maximum packet size allowed by the NIC.
Firewalls Many corporate networks employ rewalls for network security.
However, you cannot acquire from GigE Vision cameras with the rewall en-
abled, unless you use the High Performace driver. If your company's network
policy does not allow you to disable the rewall or use a dierent network driver,
7
8. you will need to use a system dedicated to image acquisition, that is not part
of the corporate network.
Corrupt XML les As with any new standard, camera manufacturing com-
panies routinely release new revision of their rmware. If you get an error stating
that the XML le is corrupt, please contact the camera manufacturer for the
latest revision of their rmware.
Interoperability While GenICam gives camera manufacturers the exibility
of creating a custom attribute set, it makes it dicult to easily switch be-
tween cameras without modifying your code. While the GenICam Standard
Features Naming Convention alleviates this problem to a certain extent, most
of the conventions are only recommendations and not requirements. So a camera
manufacturer may deviate from the convention, in which case, the application
software will need to be modied to be interoperable with other cameras.
8
9. 3 Installing Thermo Safety 2013
3.1 Setup
To get your copy of Workswell Thermo Safety 2013, go to page
http://www.workswell.cz/ThermoApps/ThermoSafety/install.htm
and click Install. Then proceed to the folder where you've downloaded the setup
program and open it. If you see a prompt asking whether to install JAI SDK
or not, click Install, otherwise the setup program would quit.
Installation of JAI SDK
Follow the instructions of the JAI SDK Setup program and in the end, if asked,
reboot your computer.
WARNING:
If you don't re-
boot the com-
puter after the
installation it
is likely that
you won't be
able to work
with cameras.
Rebooting the computer after JAI SDK Installation
The installation will then continue. If not, please run the setup program again.
Thermo Safety's setup program itself doesn't need any further user interaction
and the program will run immediately as soon as the installation is completed.
3.2 Activation
When you run the program for the very rst time, the Authentication window is
the rst thing to deal with. The Authentication window provides you with two
9
10. options: If you don't have a serial number and want to evaluate the software for
a limited period of 15 days, choose Request trial version, otherwise, if you have
valid, not yet activated serial number, click the Proceed, I have a serial number
option.
Authentication window
3.2.1 Trial version
When requesting a trial version of Workswell Thermo Safety 2013, all you
have to do is enter your (valid) email address.
Entering email address
In a matter of seconds, you will recieve an email with activation link leading to
our CRM server, where we would be glad if you took a moment to ll in a brief
info about yourself and helped us to improve the software to better suit the
needs of our customers. After you'll express consent with the Licensing terms
and conditions by checking the I agree to the above terms, click Activate and
you will be given a unique trial serial number, valid for 15 days.
Activated trial serial number
10
11. Copy the number to clipboard by selecting it and pressing [Ctrl+C]. Then return NOTE:
The serial
number is also
contained in
email, you will
recieve after
activation, as
well as your
administrator
credentials.
to the program and click Insert serial number.
Successfull trial serial number request
Further steps are the same as if you had a licensed copy of Workswell Thermo
Safety, and are described in next section (3.2.2 Full version).
3.2.2 Full version
If you have a full version of the program (or you already have activated trial
serial number), start the activation process by clicking on Proceed, I have a
serial number button. On the next screen, enter your serial number provided
by your system integrator or by Workswell s. r. o. and ll in a valid email
address of yours.2 Click the Authenticate button. NOTE:
Next steps
doesn't ap-
ply for trial
users, who
will recieve
conrmation
after clicking
Authenticate
right away.
Inserting serial number
Next steps apply for full versions only The Authentication window is now
indicating that your serial number is not yet activated. Never mind, everything
has been taken care of.
2If the number you are about to enter is a trial serial number, you don't have to enter your
email address again.
11
12. Before completing the web activation
By clicking Authenticate on the previous screen, you've send an activation re-
quest to our CRM server and as a response, you will receive email with activation
link. Click it and ll in a brief info about yourself. Pay special attention to the
eld Administrator password, as you can't change it afterwards. After you'll
express consent with the Licensing terms and conditions by checking the I agree
to the above terms, click Activate and return to the program. Click Authenticate
as seen on the image above.
Successful activation
Click Run! and you are free to use Workswell Thermo Safety 2013. We hope
you will enjoy it.
12
13. 4 Cameras
Cameras are the cornerstone of whole application. If there's no active camera
found in your network, everything you can do with the program shrinks to man-
aging users and program settings. But after you connect just a single thermal
imaging camera, the application comes to life with much more functions and
options. Let's have a closer look on how to work with a camera.
4.1 Connecting a camera
Cameras panel:
Starting acquisition
Blinking play icon
For connecting a camera, focus on the Cameras panel
(in default layout you can nd it on the right side of
the application's main window). Select desired cam-
era from the Available cameras list and click Connect. NOTE:
If there are no
cameras in the
list, verify if
they are con-
nected to the
same network
as you are and
then click the
Refresh but-
ton.
A progress indicator may appear for a while and af-
ter it disappears, a word 'Connected', surrounded by
brackets will appear next to the camera's name, in
the Available cameras list.3 The camera will also ap-
pear as a connected camera in the Session Explorer
4 panel and the Log panel will contain information
about camera connection along with a time stamp.
Yet, there's still not much stu to do with a camera,
that is just connected and not acquiring. In fact, the
only thing you can do with such a camera is changing
its name5 by selecting the camera from the Available
cameras list and clicking Edit in the lower part of the
Cameras panel.
To start an image acquisition from a camera, select a
connected camera and click the Play button located
in the center of Cameras panel, as shown on a pic-
ture on the left of this page. A window called the
Display, entitled with the camera's name, opens and
you now see live camera view in it. If everything went
well, you should see a blinking play icon in the upper
left corner of the video view. The icon indicates that
there are new frames coming to the memory. If you
can't see the icon blinking, it means that the video is
frozen or that the acquisition starting process did not
completed successfully. Look in the Log for details
3When the camera fails to connect, check if there's not someone already connected.
4What a session is and how to use it is a subject of Section 6 - Sessions.
5If you'd like to rename the camera, you should do it when the acquisition is stopped on
it. Changing the name of camera while the acquisition is running causes freezing the video
stream for a few seconds as the camera is busy with rewriting the Name register.
13
14. and if everything seems OK try to click Stop and then Play again to restart the
acquisition.
Display of camera 'Flir A5 80x64' (With Flir Iron palette)
4.2 Disconnecting a camera
The process of disconnecting a camera is very similar to connecting it and is very
straightforward. Just choose the camera, you want to be disconnected and click
Disconnect. If there is an acquisition running, it will be stopped automatically.
After disconnection, the camera's Display closes, the camera is removed from
the list of Connected cameras in the Session Explorer and the Log panel will
contain information about camera disconnection along with a time stamp.
14
15. 5 Alarms
Alarms are the basic measurement tool of Thermo Safety 2013. They are used to
alert you, when temperature in an area raises above or lowers under a specied
value. Each alarm has two levels:
Warning Occurs when temperature rises above/lowers under the temperature
specied as Warning temperature and is supposed to alert you when the
temperature is close to the Alarm temperature The aected area turns
orange, there can be a sound playing6 and the event is logged into the
Log.
Alarm Occurs when temperature rises above/lowers under the temperature
specied as Alarm temperature and is supposed to mean that the situation
in the area is critical. The aected area turns red, there can be a sound
playing7 and the event is logged into the Log.
Now, let's see how to set up an alarm on one of the cameras.
5.1 Setting up an alarm
If you have at least one thermal imaging camera connected and acquiring, you
can set up an alarm on that camera. To do that, go to the Session Explorer and
click the Plus button in the lower left corner. A panel called Set up new alarm
appears. In the Session Explorer, select a camera from the Connected cameras
list.
6The indication of W arning can vary depending on your program settings.
7The indication of Alarm can vary depending on your program settings.
15
16. Creating an alarm on camera 'Flir A5 80x64'
The Display of the chosen camera now became selectable and whole live view
area of the camera is divided into several squares (their count depends on the
resolution of the camera and the grid might not be visible, that depends on
Settings of the program). Use the mouse to select area for your new alarm like
this:
ˆ Left mouse button is for selecting squares you want to be checked by
new alarm.
ˆ Right mouse button cancels the selection.
Selecting alarm area
Go back to Session Explorer and adjust Alarm name, Alarm and Warning
temperature. Then choose a Type for your alarm
Upper bound alarm Use this type if you want to be informed when the tem-
perature exceeds the values in Alarm and Warning temperature.
Lower bound alarm Use this type if you want to be informed when the tem-
perature is lower than the values in Alarm and Warning temperature.
Having done that, click Add alarm. When the alarm is created you notice that
the alarm area has darkened the image underneath it. This is to inform you,
which areas are already covered by an alarm and which are not. Now, you can
add another alarm, or, if you have nished, click the Down arrow in the lower
left corner of Session Explorer to close the Set up new alarm panel. Previously
darkened areas will go back to normal.
16
17. 5.2 Raised alarms
When the alarm is raised in any of the squares of your area of interest, the areas
which exceeded(got under) the specied Alarm temperature turn red and areas
that exceeded(got under) the specied Warning temperature turn orange like
so8
Highlighted areas with alarms and warnings
Active alarms are also highlighted in the Session Explorer, under the corre-
sponding camera and the alarm/warning event is documented in Log along with
a time stamp of the event.
5.3 Deleting alarms
Deleting alarms can be done it two ways. Either you
ˆ Select an alarm and click the Recycle bin icon in the lower left corner of
the Session Explorer.
or you
ˆ select an alarm in the Session Explorer and press the [Delete] key.
8The behavior depicted in the image can dier on your computer, depending on the pro-
gram Settings. If you would like your display to look like the depicted one here, be sure to
check Display grid, Highlight alarms and warnings in display and Show temperatures in alarm
cells in the Settings View View options. More about program settings can be found in
Section 7 - Program options.
17
18. 6 Sessions
Connected cameras and their alarms are both grouped in Sessions as well as
the layout conguration you use with the session. That way, you don't have
to connect cameras and set up all the alarms again and even the panels and NOTE:
Although con-
nected cameras
are listed in
Connected
cameras
list found in
the Session
Explorer ,
sessions save
just those
cameras that
are in a state
of running
acquisition.
windows stay in position where you've put them before.
6.1 The Default session
Session explorer
There is always at least one Session, called Default.
The Default session is the rst one you will see, when
you open the program.. It is created automatically
and every time you Log Out or Exit the program from
an Administrator account, the session is saved for you
to continue, where you've left o. When you start the
program, the Default session is loaded and everything
you were working with before is there again. The
Default session can't be deleted and if the program
can't nd it, it automatically creates a new, blank
one with standard layout and no cameras connected.
6.2 User-created sessions
You have also the possibility to create and save/load
your own sessions. This is useful when you have more
congurations of alarms, or if the users have dierent preferences concerning
layout of panels. If you want to create such a session, just go to main menu like
Sessions Save Session As ... and write desired name for your new session. 9
9Be careful when choosing a session name. If you choose a name, that already exists, the
older session will be overwritten. If you name your session 'Default' it will be overwritten and
lost when the program exists because of saving the standard Default session.
18
19. 7 Program settings
Using Settings you can manage accounts, cameras and control the program
behavior and appearance. You can reach Settings by going throught Settings
item in the application main menu and then clicking on the appropriate category.
Three buttons are present in the window
OK Applies the changes made in Settings and then closes the window.
Cancel Closes the window without saving changes.
Apply Applies the changes immediately.
7.1 Accounts
7.1.1 Account types
There are two account types in Thermo Safety 2013.
Administrator A user with administrator account can connect and disconnect
cameras, set up or delete alarms, save and load sessions and change pro-
gram settings. Administrator can also deactivate license for the computer.
Operator An operator account has limited rights and cannot choose a session
as the Default session is the one which opens every time an operator logs
in. If an administrator wants the operator to use another session, it is
necessary to log as an administrator, load the session and then log out,
causing the actual session to be saved as Default. Furthermore, operator
can't change anything in the session and can see only Log, Displays and
Session Explorer without the possibility of changing anything.
7.1.2 Managing accounts
If you want to change installed accounts, go to Settings Accounts, select an
account from the Installed accounts list and select and click on one of the buttons
in the right to perform desired action.
19
20. Accounts management in Settings
Next steps are pretty straightforward and do not need any further explanation.
Please mind that you can't change password of the main Administrator account.
It must be ensured that there is at least one administrator account and so this
account can't be neither deleted as you could lose access to the program and.
The main Administrator account is also the only one which allows you to retrieve
lost password in case that you would have forgotten it.
7.2 Cameras
The only thing you can see in Settings Cameras is setting a distance between
cameras and monitored surface. This is used to precisely localize the coordinates
of alarms in metrics units.
7.3 Sounds
If you would like to be notied by sound about ongoing alarm or warning event,
have a look at Settings Sounds. Here you can set whether you want to be
notied by sound just when an alarm is triggered or if you want the sound to
be played also when a warning is risen.
20
21. Sound settings
You can choose whether you want the sound to be played continuously when an
alarm or warning is present or if you just want to hear it once (the Play sound
repeatedly check box). You can also choose a dierent sound from the library
by clicking the Change sound button.
7.4 View
The view settings are in sequence described bellow the image:
View settings
21
22. Display grid Displays grid in the display of the camera, dividing the display
into square segments.
Display rulers Displays distances from the upper left corner of the display in
real-world coordinates.
Highlight alarms and warnings in display When an alarm(warning) is raised
the aected area turns red(orange).
Show temperatures in alarm cells When an alarm(warning) is raised the
highest/lowest10 temperature in the area is shown in the square if.
Highlight display on alarm or warning When an alarm(warning) is raised,
the border of the live view from camera turns red(orange).
Palette If you are not satised with the standard gray palette, here you can
change to a palette which will suit you more.
7.5 Log
The Log Settings contain one item only and that is the count of the lines visible in
the panel. We recommend something about 40-60 lines and the maximum is set
to 100. While testing, it turned out, that more than 100 lines in the Log signif-
icantly delay the responses of the system. Furthermore, you have to possibility
to view all logs in the Documents folderThermoSafetyLogs.
10According to the type of the alarm.
22
23. 8 Feedback
As Workswell Thermo Safety 2013 is just in its rst version, we are well
aware that there is still a lot to improve. Please, feel free to send us your
suggestions, subjects to change and your issues with the program. You can do
so by clicking Help Send Feedback or clicking the Send Feedback button in
the Login Screen.
Thank you in advance for your interest in improving the software.
23
