Thermo Safety 2013

Getting started

Contents

1 Introduction 4

1.1 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Preparations 5

2.1 General system requirements . . . . . . . . . . . . . . . . . . . . 5

2.1.1 Minimal requirements . . . . . . . . . . . . . . . . . . . . 5

2.1.2 Recommended con�guration . . . . . . . . . . . . . . . . . 5

2.2 Hardware setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2.2.1 Special hardware requirements . . . . . . . . . . . . . . . 5

2.2.2 Network con�guration . . . . . . . . . . . . . . . . . . . . 6

2.2.3 Jumbo packets . . . . . . . . . . . . . . . . . . . . . . . . 6

2.2.4 Network Firewalls . . . . . . . . . . . . . . . . . . . . . . 7

2.2.5 Caveats and pitfalls . . . . . . . . . . . . . . . . . . . . . 7

3 Installing Thermo Safety 2013 9

3.1 Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.2 Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.2.1 Trial version . . . . . . . . . . . . . . . . . . . . . . . . . 10

3.2.2 Full version . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4 Cameras 13

4.1 Connecting a camera . . . . . . . . . . . . . . . . . . . . . . . . . 13

4.2 Disconnecting a camera . . . . . . . . . . . . . . . . . . . . . . . 14

5 Alarms 15

5.1 Setting up an alarm . . . . . . . . . . . . . . . . . . . . . . . . . 15

5.2 Raised alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

5.3 Deleting alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

6 Sessions 18

6.1 The Default session . . . . . . . . . . . . . . . . . . . . . . . . . . 18

6.2 User-created sessions . . . . . . . . . . . . . . . . . . . . . . . . . 18

7 Program settings 19

7.1 Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

7.1.1 Account types . . . . . . . . . . . . . . . . . . . . . . . . 19

7.1.2 Managing accounts . . . . . . . . . . . . . . . . . . . . . . 19

7.2 Cameras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

7.3 Sounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

7.4 View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

7.5 Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

8 Feedback 23

1 Introduction

Workswell Thermo Safety 2013 is a complex solution for situations wherethe temperature safety is essential. You can connect up to 501 cameras simul-taneously and then check your temperature requirements in real-time. Bothconnected cameras and temperature requirements, called Alarms are saved inso called Sessions and the program can save your customized layout as well. Theapplication o�ers a plenty of options to customize appearance, noti�cations andother parameters, yet it doesn't take more than �ve minutes to set everythingup. Workswell Thermo Safety 2013 is more than thousand times fasterthan a regular �re safety system, much more easier to con�gure, and is ablenot only to recognize a security breach but also to warn you when a potentiallydangerous event appears.

1.1 Terminology

Main window of the application with the names of panels

1Depends on your network and hardware con�guration

4

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 con�guration

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 beused 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 oursoftware 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 Visioncompliant, you cannot acquire images using our software. You should �nd theGigE Vision logo in the camera's user manual or marketing literature.

5

Gigabit Ethernet port While it is possible to acquire images with Ethernetand 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 highlyrecommended that you use a Gigabit Ethernet Network Interface Controller(NIC).

2.2.2 Network con�guration

Once you have the hardware and software installed correctly, you must con�gurethe network as well. GigE Vision cameras can obtain an IP address from aDHCP server or select one for itself using Link Local Addressing (LLA). If youconnect the camera to a Gigabit Ethernet network with a DHCP server, thecamera is automatically detected. If the camera is connected directly to thecomputer (using either a regular or cross-over cable), maybe you will need towait about a minute for the camera to timeout on the DHCP request and useLLA. The Windows operating system may display a warning that the networkcard 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 multiplepackets. However, the GigE Vision standard allows packet sizes of up to 9014bytes. These large packets, also known as Jumbo packets, allow the camera tomore e�ciently transfer data across the network. You can enable Jumbo packetsin many network cards from the Device Manager by right-clicking the networkcard and selecting Properties.

6

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 packetsto the host. However, network �rewalls will not allow the packets to reachtheir destination because �rewalls typically block uninitiated incoming tra�c.Therefore you will need to disable you �rewall in order to acquire images froma GigE Vision camera. You can disable the Windows Firewall from the ControlPanel (Start>�>Control Panel). However if you have a network card with anIntel PRO/1000 chipset and you are using the Filter driver that comes with JAISDK (which is included in this package), it is most likely that you will not needdisable 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 toa packet size of less than 1500 Bytes. The GigE Vision packet size cannot begreater 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 networkpolicy does not allow you to disable the �rewall or use a di�erent network driver,

7

you will need to use a system dedicated to image acquisition, that is not partof 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 statingthat the XML �le is corrupt, please contact the camera manufacturer for thelatest revision of their �rmware.

Interoperability While GenICam gives camera manufacturers the �exibilityof creating a custom attribute set, it makes it di�cult to easily switch be-tween cameras without modifying your code. While the GenICam StandardFeatures Naming Convention alleviates this problem to a certain extent, mostof the conventions are only recommendations and not requirements. So a cameramanufacturer may deviate from the convention, in which case, the applicationsoftware will need to be modi�ed to be interoperable with other cameras.

8

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 setupprogram and open it. If you see a prompt asking whether to install JAI SDKor 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 theinstallation itis likely thatyou won't beable to workwith 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 interactionand 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 isthe �rst thing to deal with. The Authentication window provides you with two

9

options: If you don't have a serial number and want to evaluate the software fora limited period of 15 days, choose Request trial version, otherwise, if you havevalid, not yet activated serial number, click the Proceed, I have a serial numberoption.

Authentication window

3.2.1 Trial version

When requesting a trial version of Workswell Thermo Safety 2013, all youhave 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 toour CRM server, where we would be glad if you took a moment to �ll in a briefinfo about yourself and helped us to improve the software to better suit theneeds of our customers. After you'll express consent with the Licensing termsand conditions by checking the I agree to the above terms, click Activate andyou will be given a unique trial serial number, valid for 15 days.

Activated trial serial number

10

Copy the number to clipboard by selecting it and pressing [Ctrl+C]. Then return NOTE:

The serialnumber is alsocontained inemail, you willrecieve afteractivation, aswell as youradministratorcredentials.

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 ThermoSafety, 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 trialserial number), start the activation process by clicking on Proceed, I have aserial number button. On the next screen, enter your serial number providedby your system integrator or by Workswell s. r. o. and �ll in a valid emailaddress of yours.2 Click the Authenticate button. NOTE:

Next stepsdoesn't ap-ply for trialusers, whowill recievecon�rmationafter clickingAuthenticateright away.

Inserting serial number

Next steps apply for full versions only The Authentication window is nowindicating that your serial number is not yet activated. Never mind, everythinghas 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

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 activationlink. 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'llexpress consent with the Licensing terms and conditions by checking the I agreeto the above terms, click Activate and return to the program. Click Authenticateas seen on the image above.

Successful activation

Click Run! and you are free to use Workswell Thermo Safety 2013. We hopeyou will enjoy it.

12

4 Cameras

Cameras are the cornerstone of whole application. If there's no active camerafound 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 thermalimaging camera, the application comes to life with much more functions andoptions. 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 ofthe application's main window). Select desired cam-era from the Available cameras list and click Connect. NOTE:

If there are nocameras in thelist, verify ifthey are con-nected to thesame networkas you are andthen click theRefresh but-ton.

A progress indicator may appear for a while and af-ter it disappears, a word 'Connected', surrounded bybrackets will appear next to the camera's name, inthe Available cameras list.3 The camera will also ap-pear as a connected camera in the Session Explorer4 panel and the Log panel will contain informationabout 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, theonly thing you can do with such a camera is changingits name5 by selecting the camera from the Availablecameras list and clicking Edit in the lower part of theCameras panel.

To start an image acquisition from a camera, select aconnected camera and click the Play button locatedin the center of Cameras panel, as shown on a pic-ture on the left of this page. A window called theDisplay, entitled with the camera's name, opens andyou now see live camera view in it. If everything wentwell, you should see a blinking play icon in the upperleft corner of the video view. The icon indicates thatthere are new frames coming to the memory. If youcan't see the icon blinking, it means that the video isfrozen or that the acquisition starting process did notcompleted 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

and if everything seems OK try to click Stop and then Play again to restart theacquisition.

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 verystraightforward. Just choose the camera, you want to be disconnected and clickDisconnect. If there is an acquisition running, it will be stopped automatically.After disconnection, the camera's Display closes, the camera is removed fromthe list of Connected cameras in the Session Explorer and the Log panel willcontain information about camera disconnection along with a time stamp.

14

5 Alarms

Alarms are the basic measurement tool of Thermo Safety 2013. They are used toalert you, when temperature in an area raises above or lowers under a speci�edvalue. Each alarm has two levels:

Warning Occurs when temperature rises above/lowers under the temperaturespeci�ed as Warning temperature and is supposed to alert you when thetemperature is close to the Alarm temperature The a�ected area turnsorange, there can be a sound playing6 and the event is logged into theLog.

Alarm Occurs when temperature rises above/lowers under the temperaturespeci�ed as Alarm temperature and is supposed to mean that the situationin the area is critical. The a�ected area turns red, there can be a soundplaying7 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, youcan set up an alarm on that camera. To do that, go to the Session Explorer andclick the Plus button in the lower left corner. A panel called Set up new alarmappears. In the Session Explorer, select a camera from the Connected cameraslist.

6The indication of W arning can vary depending on your program settings.7The indication of Alarm can vary depending on your program settings.

15

Creating an alarm on camera 'Flir A5 80x64'

The Display of the chosen camera now became selectable and whole live viewarea of the camera is divided into several squares (their count depends on theresolution of the camera and the grid might not be visible, that depends onSettings of the program). Use the mouse to select area for your new alarm likethis:

� Left mouse button is for selecting squares you want to be checked bynew alarm.

� Right mouse button cancels the selection.

Selecting alarm area

Go back to Session Explorer and adjust Alarm name, Alarm and Warningtemperature. 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 andWarning temperature.

Having done that, click Add alarm. When the alarm is created you notice thatthe 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 canadd another alarm, or, if you have �nished, click the Down arrow in the lowerleft corner of Session Explorer to close the Set up new alarm panel. Previouslydarkened areas will go back to normal.

16

5.2 Raised alarms

When the alarm is raised in any of the squares of your area of interest, the areaswhich exceeded(got under) the speci�ed Alarm temperature turn red and areasthat exceeded(got under) the speci�ed Warning temperature turn orange likeso8

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 witha 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 ofthe Session Explorer.

or you

� select an alarm in the Session Explorer and press the [Delete] key.

8The behavior depicted in the image can di�er 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

6 Sessions

Connected cameras and their alarms are both grouped in Sessions as well asthe layout con�guration you use with the session. That way, you don't haveto connect cameras and set up all the alarms again and even the panels and NOTE:

Although con-nected camerasare listed inConnected

cameras

list found inthe Session

Explorer ,sessions savejust thosecameras thatare in a stateof runningacquisition.

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, whenyou open the program.. It is created automaticallyand every time you Log Out or Exit the program froman Administrator account, the session is saved for youto continue, where you've left o�. When you start theprogram, the Default session is loaded and everythingyou were working with before is there again. TheDefault session can't be deleted and if the programcan't �nd it, it automatically creates a new, blankone with standard layout and no cameras connected.

6.2 User-created sessions

You have also the possibility to create and save/loadyour own sessions. This is useful when you have more

con�gurations of alarms, or if the users have di�erent preferences concerninglayout of panels. If you want to create such a session, just go to main menu likeSessions > 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

7 Program settings

Using Settings you can manage accounts, cameras and control the programbehavior and appearance. You can reach Settings by going throught Settingsitem 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 disconnectcameras, 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 sessionas the Default session is the one which opens every time an operator logsin. If an administrator wants the operator to use another session, it isnecessary to log as an administrator, load the session and then log out,causing the actual session to be saved as Default. Furthermore, operatorcan't change anything in the session and can see only Log, Displays andSession Explorer without the possibility of changing anything.

7.1.2 Managing accounts

If you want to change installed accounts, go to Settings > Accounts, select anaccount from the Installed accounts list and select and click on one of the buttonsin the right to perform desired action.

19

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 thisaccount 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 retrievelost 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 betweencameras and monitored surface. This is used to precisely localize the coordinatesof alarms in metrics units.

7.3 Sounds

If you would like to be noti�ed by sound about ongoing alarm or warning event,have a look at Settings > Sounds. Here you can set whether you want to benoti�ed by sound just when an alarm is triggered or if you want the sound tobe played also when a warning is risen.

20

Sound settings

You can choose whether you want the sound to be played continuously when analarm or warning is present or if you just want to hear it once (the Play soundrepeatedly check box). You can also choose a di�erent sound from the libraryby clicking the Change sound button.

7.4 View

The view settings are in sequence described bellow the image:

View settings

21

Display grid Displays grid in the display of the camera, dividing the displayinto square segments.

Display rulers Displays distances from the upper left corner of the display inreal-world coordinates.

Highlight alarms and warnings in display When an alarm(warning) is raisedthe a�ected area turns red(orange).

Show temperatures in alarm cells When an alarm(warning) is raised thehighest/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 satis�ed with the standard gray palette, here you canchange 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 inthe panel. We recommend something about 40-60 lines and the maximum is setto 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 possibilityto view all logs in the <�<Documents folder>�>\ThermoSafety\Logs.

10According to the type of the alarm.

22

8 Feedback

As Workswell Thermo Safety 2013 is just in its �rst version, we are wellaware that there is still a lot to improve. Please, feel free to send us yoursuggestions, subjects to change and your issues with the program. You can doso by clicking Help > Send Feedback or clicking the Send Feedback button inthe Login Screen.

Thank you in advance for your interest in improving the software.

23

Copyright© Workswell s. r. o., Prague 2013All rights reserved