Querx TH

Web thermometer / hygrometer

User's manual
Querx TH is a networking enabled measuring device for
reliably monitoring temperature and humidity !onfiguration
is carried out via web interface "athered values are internally
logged and graphically depicted over time #n exceeding
configurable thresholds$ Querx TH triggers alarms and sends
notifications via email$ %&'( trap and syslog !loud interfaces
provide world wide access to the collected data and easy
integration of Querx TH into own pro)ects
egnite cannot be held responsible for any technical or typographical errors and reserves the
right to make changes to the product and manual without prior notice
egnite is not liable or responsible for any damage incurred in connection with the
furnishing$ performance or use of this product
*evision +,
- ./+0 egnite "mbH$ "ermany 1ll rights reserved
1ll trademarks are properties of their respective owners
2atest information on our products is available on our websites wwwegnitede and
sensorsegnitede
Table of contents
+ 3ntroduction +
++ 1bout Querx TH +
+. Querx TH features +
+4 Querx TH at a glance .
+0 5ields of application .
. 3ncluded in delivery 6article 7"&8//++09 4
4 (utting into operation 0
4+ !onnect Querx TH 0
4. 3nstallation of ':evice :iscoverer' ;
44 1utomatic network configuration <
40 &etwork configuration with ':evice :iscoverer'<
4; 1 first look at the web interface+/
0 *e=uired basic configuration ++
0+ %ystem settings ++
0. Time settings +.
'anually setting time and date +.
%ynchroni>ing via &T(+4
04 %et temperature unit +4
00 *eset recorded sensor data +0
; 1dvanced basic configuration +;
;+ &etwork settings +;
1utomatic configuration via :H!( +;
'anual configuration +;
:&% server +8
5urther settings +8
;. User management +,
1dd or edit user +,
:elete user +?
:isable anonymous access+?
;4 !onfigure session timeout +<
8 !onfiguration of alarm functions ./
8+ !onfiguration of the sensors ./
Thresholds and hysteresis./
!onfiguration of the temperature sensor./
!onfiguration of the humidity sensor.+
8. !onfiguration of alarm emails ..
7mail accounts .4
7mail recipients .;
"lobal email settings .8
Templates for alarm emails.,
84 %&'( traps .?
!onfiguration .?
*eceive traps with %&'( management software4/
80 !onfiguration of syslog 4+
8; !onfiguration of the status 27:4.
, 1ccess on the measured data 44
,+ Web interface 44
!urrently measured values44
!hronological se=uence of values44
,. :ata export to cloud services 40
Thing%peak integration40
@ively integration 4;
? 5irmware updates 48
?+ 1vailability of firmware updates48
3nstallation of firmware images48
1ctivation of firmware images4,
< Troubleshooting 4?
<+ (ossible errors 4?
&o network connection4?
Querx TH is slow 4?
Querx TH has gaps in its chronology4?
1fter a firmware update$ Querx TH doesn't work anymore4?
2ost logAin data 4?
&etwork configuration unknown4?
<. 1ctions to perform 4<
*ebooting the device 4<
!onfiguration reset 4<
1ctivation of the alternative firmware buffer0/
+/ 1ppendix +B %ensor specifications 0+
+/+ Temperature sensor 0+
+/. Humidity sensor 0.
++ 1ppendix .B %pecifications 04
+. 1ppendix 4B 'anufacturer 0;
+ 3ntroduction
++ 1bout Querx TH
Querx TH is powered with ; C :! over a 'icroAU%D )ack The device can be connected to a
network over a +// 'Dit 7thernet interface
Querx TH monitors temperature and humidity in its surrounding and sends out alarms via
email$ %&'( trap and syslog messages when configurable thresholds are exceeded
5urthermore$ the collected data can be exported to the cloud providers @ively and
Thing%peak
The advanced temperature range allows measurements between A0/ E! and ?; E! 6A0/E5 to
+?; E59
Querx sensors are waterA and oilArepellent (rotected by a membrane$ they are also dustA
proof from a particle si>e of 4; micro meters on and withstand a water pressure of ., bars
The sensors are calibrated by factory and specified by low deviations of F. G typical for the
humidity and F/4 H for the temperature sensor 6see appendix +$ sensor data9
+. Querx TH features
*eliable monitoring of temperature and humidity
3ntegrated highA=uality sensorsB oilArepellent$ waterA and dustproof
1larms via email$ %&'( trap and syslog
%tartT2% I supports "mail$ "'@ etc
7asy configuration via web interface
!lear graphical depiction of temperature and humidity gradiation
(rogramming interfaces over cloud
:ata access via 1ndroid app
(ower supply over 'icroAU%D
Dattery backed realAtime clock
1dvanced temperature rangeB A0/ E! to ?; E! 6A0/ E5 to +?; E59
!ompact si>eB ;8$4 mm x 0/ mm x .+ mm 6.. in x +8 in x /? in9 plus 40/ mm 6+4? in9
sensor cable
+
+4 Querx TH at a glance
6+9 (ush button for configuration reset
6.9 %tatus 27:
649 'icroAU%D )ack for voltage supply
609 %ensor cable with sensors for temperature and humidity
6;9 *JA0; )ack for network integration
689 2ink 27:
+0 5ields of application
%erver room monitoring
7state monitoring
1utomated climate profiling for buildings
(reventive conservation
!auseAdetermination for mouldAremediation
2
5ig ++B #verview
. 3ncluded in delivery 6article 7"&8//++09
Querx TH with sensors for temperature and humidity
7thernet cable
'icroAU%D cable
U%D wall plug adapter witch clippings for UH$ 7U$ U% and 1U
!: with software and documentation
4
4 (utting into operation
4+ !onnect Querx TH
Querx TH is shipped with a 'icroAU%D plugAin power supply which includes clippings for
usage in several countries !hoose the right clipping and push it into the guide rails from
above until it locks in place
&ow connect the power supply to Querx TH$ using the 'icroAU%D cable 3f no free wall
outlet is available$ you can instead connect Querx TH to a free U%D port 6+9 The status 27:
lights yellow Querx TH needs ; C voltage supply$ consuming less than + W
&ow connect Querx TH to your network$ using the provided 7thernet cable 6.9
4
5ig 4.B !onnect Querx TH
5ig 4+B (repare adapter 67xampleB 7U clipping9
Querx TH should be placed with some distance to heat sources and be protected from direct
sunlight 1lthough measurements in still air are possible$ a certain amount of air circulation
will support better reaction times and reduce susceptibility to condensation
3f you change from analogue thermoA / hygrometers$ you should consider a transition period
in which you use both solutions Thus$ you ensure that everything works as expected and
the data is recorded properly
4. 3nstallation of ':evice :iscoverer'
Querx TH automatically receives a network configuration via :H!( as soon$ as you connect
the device to your network :uring this process$ the status 27: lights yellow
3f a valid configuration has been received$ the status 27: blinks green 3f a network problem
has occurred$ the status 27: lights red (lease ask your network administrator in this case
To access Querx' web interface$ you need to find out its 3( address This can be done using
the application ':evice :iscoverer'
1n installation image for ':evice :iscoverer' can be found on the product !: &ew versions
can free of charge be downloaded from wwwsensorsegnitede 1fter a double click on this
file$ the installation process starts
1t first$ choose the language you want to use and click #H to continue
;
5ig 44B 7xecute installation image
5ig 40B !hoose language
The installer asks you to close other applications before proceeding 1fterward click on
&ext
Kou are being asked to choose the components you want to install Heep the suggested
selection and click on &ext
6
5ig 48B !hoose components to install
5ig 4;B !lose other applications
(lease choose the folder into which you want to install ':evice :iscoverer' and click on &ext
&ow choose a start menu folder for ':evice :iscoverer' Then$ click on 3nstall to install
':evice :iscoverer' onto your system
,
5ig 4,B !hoose folder
5ig 4?B !hoose start menu folder
1fter the installation has finished$ click on &ext
5inally click on 5inish to exit the installer
&ow you can start ':evice :iscoverer' from the windows start menu
8
5ig 4++B %tart ':evice :iscoverer'
5ig 4<B !lick next
5ig 4+/B 5inish installation
44 1utomatic network configuration
':evice :iscoverer' recogni>es all Querx devices within your local network and lists them in
a table The first column shows the system name This name can be changed from the web
interface The second column shows the 3( address$ over which Querx TH can be accessed
3f you doubleAclick on the row with the device you want to configure$ a browser window
opens and loads the web interface
40 &etwork configuration with ':evice :iscoverer'
3f you don't have a :H!( server running in your network$ you have to manually set an 3(
address and a network mask Kou can do this with ':evice :iscoverer' or the 1ndroid app
'Querx :iscoverer'$ which can be found in the "oogle (lay%tore
3n :evice :iscoverer rightAclick on the device that you want do configure and choose :evice
configuration 3n the dialogue window$ provide an 3( address that is used to connect to
Querx TH and an 3( mask for the definition of the subnet Querx is located in
5inally$ click on #H to apply your changes Querx TH reboots with the new settings
To configure Querx TH to work with :H!( at this point$ simply set 3( address and 3( mask to
////
5urther configuration is carried out via web interface
<
5ig 4+.B ':evice :iscoverer'
5ig 4+4B 'anual network configuration
4; 1 first look at the web interface
1fter you have entered Querx TH's 3( address into your brower's address field or after you
have doubleAclicked on the entry in ':evice :iscoverer'$ you see the front page Here you
find currently measured values$ as well as the depiction of their development over time
The charts on the left side show the temperature and humidity gradations within the last
seven days The upper chart shows temperature development$ the lower one the
development of humidity The red lines show the configured alarm thresholds
The bars on the right side show currently measured values for temperature and humidity 3f
they are green$ the sensor is in the defined safe state *ed bars show an active alarm$ one of
the thresholds is exceeded 1 yellow color shows that the sensor measures values within
the hysteresis range 6see 8+$ configuration of the sensors9
1t the upper right part of the front page you can log in with a user name and a password
This is needed if you have set up users and assigned them access right 6see ;.$ user
management9
10
5ig 4+0B Web interface
0 *e=uired basic configuration
5or proper operation$ some basic configuration need to be carried out !lick at
!onfiguration in the upper right corner of the front page to access the configuration
backend
#n the left side of the screen$ you find the configuration menu$ from where you can navigate
through the different configuration areas The center part of the page shows the
configuration options that you can set #n the right side$ you find some explanatory
information on the different configuration options
0+ %ystem settings
#n the start page of the backend$ which can also be accessed over the menu entry %ystem /
"eneral$ you should provide a %ystem name for your device 3t is the name shown in ':evice
:iscoverer'
5urthermore it is used to identify the source of an alarm This name can consist of up to +;
alphanumerical characters
!lick on %ave to apply or on !ancel to discard your changes
++
5ig 0+B !onfiguration backend
0. Time settings
!lick on %ystem / Time to open the configuration page for date and time settings These
settings allow Querx TH to put a time stamp to every measuring point$ so the development
of data can be followed
5irst set the UT! offset for the time >one that applies to your location Kou can find an
overview at httpB//enwikipediaorg/wiki/2istLofLtimeL>onesLbyLUT!Loffset
1fterward click on %ave to make your settings apply
0.+ 'anually setting time and date
7nter the current date into the corresponding field (lease use the littleAendian date format
with dots as separators That is /+/+./+0 for the 5irst of January$ ./+0 &ow$ enter the
current time with hours$ minutes and seconds separated by colons %o for half past twelve
you would enter +.B4/B//
Kou can also pick up the current time from the computer you are working on To do so$ )ust
click on the button %yncA(!
5inally click on %ave to apply the changes
12
5ig 0.B !hoose system name
5ig 04B %et UT! offset
0.. %ynchroni>ing via &T(
:ate and time can also be received via the &et Time (rotocol 3nsert a valid &T( server
address into to the corresponding field
1fter you have clicked on %ync &T($ time and date are =ueried via network and saved in the
background :o not click on %ave afterward$ as you would overwrite the received settings
with the values given in the input fields
(lease noticeB
3f Querx TH is able to connect to the provided &T( server$ its time settings are
automatically updated once an hour
3f no &T( server is given$ Querx TH can save the provided values and keep track of the time
with the battery backed internal clock
04 %et temperature unit
#pen the page %ensors / Temperature to set the temperature unit you want to use Kou can
choose between E!elsius$ E5ahrenheit and Helvin
!lick on %ave to apply your changes
+4
5ig 00B %et time
5ig 0;B %ynchroni>ation via &T(
00 *eset recorded sensor data
To restart the recording of sensor data with the new configuration$ you have to delete the
sensor data collected so far
#pen the page 'aintenance / *eset and click the button reset right of %ensor data
#n the following page$ confirm that you want to delete the data by ticking the checkbox
right of 1re you sureM 5inally click on the buttonKes
14
5ig 0,B *eset sensor data
5ig 0?B !onfirm data deletion
5ig 08B %et temperature unit
; 1dvanced basic configuration
1fter the configuration steps in the last chapter$ Querx TH is readyAforAoperation and records
the measured sensor data To configure Querx TH for your specific use case$ following
configuration options can be set
;+ &etwork settings
Querx TH automatically receives a network configuration via :H!( Kou can also do the
network setup manually on the page %ystem / &etwork$ for example if you want to assign a
static 3(
;++ 1utomatic configuration via :H!(
3f you tick the :H!( checkbox$ Querx TH gets an 3( address$ a network mask and a gateway
from the :H!( server
;+. 'anual configuration
3f you want to manually set up the networking options$ you have to untick the :H!(
checkbox 3n this case you have to provide the following parametersB
2ocal 3( address
7nter the 3( address$ over which Querx TH should be accessed though the network
&etwork mask
7nter a definition for the subnet$ in which Querx TH is located
"ateway 3( address
7nter the 3( address of the gateway$ which serves as default route to external networks
+;
5ig ;+B :H!( activation
(lease ask your network administrator if you don't have the needed values available
;+4 :&% server
3t is re=uired to configure a :&% server$ for example in order to send emails 3f you have the
:H!( enabled$ this value is automatically provided in most cases !heck if the field holds a
valid value and change it$ if needed
;+0 5urther settings
5ollowing advanced options can be configuredB
%yslog server
3f you provide a syslog server$ Querx TH sends alarms$ general information and error
messages via syslog protocol
HTT( port
Here you can configure on which port the web interface of Querx TH can be accessed The
16
5ig ;.B 'anual network configuration
5ig ;4B :&% server
standard value is ?/
:iscovery port
This port is needed to enable the discovery service of Querx TH With this service
enabled$ the device can be found and configured by ':evice :iscoverer' The value should
be <?/8
:iscovery 3( mask
This value specifies the network segment$ in which Querx TH accepts configuration
changes from ':evice :iscoverer' Typically this is .;;.;;.;;.;;
!lick on %ave to apply your changes 3f you click on !ancel$ your changes are discarded
;. User management
3n its basic configuration$ Querx TH can be accessed and configured via web interface
without providing any login data To increase security$ you can add users and assign them
different access privileges
To change the user settings$ open the page %ystem / User Here you can add or edit users by
clicking 7dit 6+9 3f users exist$ you can delete them by clicking :el 6.9
;.+ 1dd or edit user
To add or to edit a user$ click on 7dit in one of the unused user slots
#n the following page you can set a user name and a password 6+9 and assign privileges for
accessing Querx TH 6.9
To apply the changes$ click on %ave 649 To discard your changes$ click on !ancel
+,
5ig ;0B %ystem users
(lease noticeB
3t is only possible to withdraw configuration privileges from a user if at least one user
exists$ who has write access to the configuration
;.. :elete user
To delete a user click on :el in the user list
To finally remove that user$ you need to confirm deleting the user with a click on Kes on the
following page
(lease noticeB
Users can only be removed$ if at least one user exists$ who has write access to the
configuration
;.4 :isable anonymous access
1fter you have set up a user with write access to the configuration$ you can disable
anonymous access 5or that$ simply edit the user named 1nonymous and set its right group
to :isabled
1fterward$ click on %ave to apply or on !ancel to discard your changes
18
5ig ;;B 7dit user
;4 !onfigure session timeout
#n the page %ystem / User you can configure the time$ after which a user is automatically
logged out if no action is performed
3n the section 2ogin enter the time in seconds into the field %ession timeout
1fterward click on %ave to apply or on !ancel to discard your changes
+<
5ig ;8B :isable anonymous access
5ig ;,B %ession Timeout
8 !onfiguration of alarm functions
%etting up alarms is divided into two stepsB
3n the first step$ you have to configure the sensors to trigger alarms if certain thresholds are
exceeded
3n the second step you have to configure how Querx TH will react on those alarms
(ossible actions are sending emails and %&'( traps 5urthermore$ syslog messages are
sent$ if a syslog server is provided
8+ !onfiguration of the sensors
Querx TH comes with integrated sensors for temperature and humidity$ which can
independently be configured
8++ Thresholds and hysteresis
7ach sensor can be assigned an upper and a lower limit$ between which Querx TH is in the
normal state 3f these limits are exceeded$ Querx TH triggers an alarm
:o avoid multiple alarms$ you can set a value for hysteresis This is the amount of units$
which the measured values have to move back in the direction of the normal state$ before
another alarm is triggered
(lease look at the following imageB
3n this example$ the temperature sensor is set to a lower limit of +; E! and an upper limit of
;; E! Hysteresis is set to +/
3f an alarm is triggered at ;; E! the sensor has to measure 0; E! or less in order to trigger
another alarm on exceeding ;; E!
8+. !onfiguration of the temperature sensor
#n the page %ensors / Temperature you set up the alarm function for the temperature
sensor
20
5ig 8+B Hysteresis
The field &ame takes an identifier for the sensor$ in example 'Temperature' Kou have
already chosen the temperature unit Querx TH operates with 6+9
&ow configure the safe range by setting an upper and a lower limit$ as well as a sensible
value for hysteresis$ in example . 6.9
Under #n alarm you can choose$ what actions are performed if an alarm goes on
%end email will send information emails to all recipients configured under 1larm / 7mail
%end %&'( trap will send a %&'( trap to the %&'( manager configured under 1larms /
%&'(
5urthermore$ Querx TH sends syslog messages to a syslog server if configured under
%ystem / &etwork
1fter you have finished$ click on %ave to apply or on !ancel to discard your changes
8+4 !onfiguration of the humidity sensor
5or the configuration of the humidity sensor$ you don't need to provide a physical unit
Querx TH measures relative humidity 6*H9 in percent
7nter values for the upper and the lower limit$ as well as a sensible value for hysteresis$ in
example ;
3n the section #n alarm configure the actions$ which Querx TH will take if a humidity alarm
is triggered
.+
5ig 8.B !onfigure temperature sensor
%end email will send alarm emails to all recipients configured on the page 1larm / 7mail
%end %'T( Trap will send %'T( traps to the %'T( manager specified under 1larm / %'T(
3f you have configured a %yslog server on the page %ystem / &etwork$ Querx TH will send
also syslog messages
When you have finished$ click on %ave to apply or on !ancel to discard you changes
8. !onfiguration of alarm emails
#pen the page 1larm / 7mail to configure up to 0 recipients$ that will be notified through up
to two email accounts
3n the first section$ you see a list of the email accounts$ which are used to send alarm emails
6+9 The central section lists the email addresses$ to which the alarm emails are sent 6.9
3n the bottom section you can enter the messages that are sent with an alarm$ and configure
some basic email settings 649
22
5ig 84B !onfigure humidity sensor
8.+ 7mail accounts
To enable alarm emails you have to configure an account$ which is used for sending 3n case
that the server$ to which the account belongs$ is not available$ you can provide a second
account as backup
3f none of the configured mail servers is responding$ for example in case of network failure$
Querx TH records the last +8 events that have occurred and sends the emails as soon as the
connection could be established again
To configure a mail server$ open the page 1larm / 7mail 3n the section 7mail accounts you
see two slots$ where email accounts can be added !lick on edit to create an account
.4
5ig 8;B !reate email account
5ig 80B 7A'ail configuration
#n the next page enter the host name of the %'T( server and a port number
Host name
(lease enter the host name of your %'T( server
(ort
(lease enter the port number for your %'T( server 3n most cases this is ;?,
&owadays you will hardly find a mail server that allows you to send emails without
authentication (lease tick the 1uthentification checkbox and enter a user name and a
password 6.9
!lick on %ave to apply or on !ancel to discard you changes
3f you click on Test$ Querx TH tries to connect to the mail server 3f you didn't provide valid
data$ the corresponding fields turn red f the attempt was successful$ the Test button turns
green
(lease notice that not all mail servers are configured to return error messages %o please
ensure correct operation by sending a test email 6see 8..$ email recipients9
(lease noticeB
The login data is stored on QuerxTH without encryption 3t is thus a good idea not to use an
existing email account but set up a dedicated account for the device Kour system
administrator can support you
7dit email account
To edit an email account$ open the page 1larm / 7mail and click on 7dit left of the account
that you want to change
24
5ig 88B !onfiguration of email accounts
:elete email account
To delete an email account$ open the page 1larm / 7mail and click on :el left of the account
that you want to remove
#n the following page you have to confirm that you want to delete the account 3f you click
on &o$ the account will remain unchanged 3f you click on Kes$ the account will be deleted
8.. 7mail recipients
Querx TH is now able to send alarms via email &ow you have to provide recipients to be
informed on occurring alarms
To create recipients open the page 1larm / 7mail 3n the section *ecipients$ you find four
slots into which recipients can be entered To do so$ click on 7dit in one of the lines
#n the next page$ enter a valid email address in the field 7mail 6+9 1fterward$ choose the
mail account where emails should be send from per default 6.9
With a click on the button Test$ an email is sent 3f everything works well$ click on %ave to
apply your changes 3f you click on !ancel your changes will be discarded
.;
5ig 8,B :elete email account
5ig 8?B !onfirm deleting of the mail account
5ig 8<B !reate email recipient
7dit email recipient
To edit an existing email recipient$ open the page 1larm / 7mail and click on 7dit
:elete email recipient
#pen the page 1larm / 7mail and click on :el in the line with the email recipient that you
want to remove
#n the next page$ confirm deleting the recipient by clicking Kes 3f you click &o$ the recipient
remains unchanged
8.4 "lobal email settings
#pen the page 1larm / 7mail 3n the section 7mail settings click on 7dit left of "lobal
%ettings
26
5ig 8+/B 7nter recipient
5ig 8++B :elete recipient
5ig 8+.B !onfirm deleting the recipient
#n the next page you can set the address$ where emails are sent from and a text$ that is
added to all system emails
%ender address
(lease enter a valid email adress
7mail text
(lease enter a text template that is going to be added to all system mails Within this text
you can use some functional charactersB Nt creates a tabulator and Nn creates a line break
8.0 Templates for alarm emails
#pen the page 1larm / 7mail 3n the section 7mail settings you can edit the email templates
for temperatureA and humidity alarms !lick on 7dit left of the alarm which you want to
configure
.,
5ig 8+4B "lobal email settings
5ig 8+;B 7dit alarm email templates
5ig 8+0B "lobal email settings
Within the 1larm section$ you can enter the email templates that are processed if an alarm
occurs
The section Dack to normal holds the email templates to be processed when an alarm stops
Kou can add some variables and functional characters to your templates Those are
dynamically replaced when an email is sentB
Cariable Calue
O% &ame of the sensor that has triggered the alarm
OC 'easured value of the sensor
OU (hysical unit of the measured value
Nt 2ine break
Nn Tabulator
1fter you have ad)usted your email templates$ click on %ave to apply or on !ancel to discard
your changes
84 %&'( traps
With the %imple &etwork 'anagement (rotocol you can easily set up a monitoring system
for your networking infrastructure Querx TH can send %&'( traps to notify an %&'(
manager on triggered and stopped alarms
84+ !onfiguration
#pen the page 1larm / %&'( Here you can provide the details for the traps that are sent if a
temperature or humidity alarm occurs or the sensor returns back to normal
28
5ig 8+8B 7dit alarm email templates
1t first$ enter your %&'( manager and the specific trap codes for the different status
changes
%&'( manager
7nter the 3( address of the %&'( manager that should monitor Querx TH
1larm trap
7nter the specific trap code for offAgoing alarms
&ormal trap
7nter the specific trap code for stopped alarms
&ow configure the %&'( parameters for the temperature 6+9 and the humidity 6.9 sensors
#b)ect identifier
7nter an #3: for the sensor
1larm value
7nter a value that is sent with the trap for offAgoing alarms
&ormal value
7nter a value that is sent with the trap for stopped alarms
.<
5ig 8+,B Dasic %&'( settings
When entering values to be sent with a trap$ you can make use of some variables$ which are
automatically replaced on transmission
Cariable Calue
O% &ame of the sensor
OC 'easured value
OU (hysical unit of the measured value
!lick on %ave to apply or on !ancel to discard your changes
84. *eceive traps with %&'( management software
%&'( traps sent by Querx TH can be received with any %&'( enabled software like &agios$
Tivoli or #penCiew
The '3DADrowser by i*71%#& contains a tool called Trap *eceiver$ with which you can test
the %&'( trap function
3n the upper area of the application window you see a list with received %&'( traps$ the
lower area shows detailed information on the selected trap 1mong other information you
can seeB
6+9 the specific trap code for the alarm
6.9 the #3: of the sensor that has triggered the alarm
649 the alarm value that was sent with the trap
'3D browser and trapAreceiver can be downloaded from httpB//ireasoningcom/
30
5ig 8+?B !onfigure %&'( traps
80 !onfiguration of syslog
To sent alarms and information through syslog$ you have to provide a syslog server on the
page %ystem / &etwork 6see 0+$ &etwork configuration9
Through syslog$ Querx TH sends out a multitude of information and warnings Kou can
configure your syslog server on how to deal with this information$ in example what should
be logged or used in other ways
The following image shows some of the syslog output produced by Querx TH in the free
syslog server from 3(%W3T!H The software can be downloaded from wwwipswitchcom
4+
5ig 8+<B %&'( traps in Trap *eceiver
5ig 8./B %yslog messages from Quern TH
8; !onfiguration of the status 27:
#pen the page 1larm / %tatus 27: to configure the optical output for the normal state 6+9$ as
well as for temperature or humidity alarms 6.9
Dlink rate
Here you configure the rate in which the 27: blinks green in normal state
Temperature
Here you configure the 27: color for temperature alarms
Humidity
Here you configure the 27: color for humidity alarms
!lick on %ave to apply or on !ancel to discard your changes
32
5ig 8.+B !onfigure the status 27:
, 1ccess on the measured data
Querx TH offers several interfaces to receive currently measured and recorded dataB
Cisual depiction via web interfaces
:ata export to @ively
:ata export to Thing%peak
1ndroid 1pp 'Querx :iscoverer' with direct data access through 21& or remote access
through clouds
,+ Web interface
,++ !urrently measured values
#n the right side of the screen$ you see the currently measured values of both sensors 3f the
bars are green$ Querx TH is in the normal status 3f one of the bars is red$ the particular
sensor is in alarm mode 1 yellow bar shows that the sensor is measuring values that are
within the hysteresis range
,+. !hronological se=uence of values
#n the left side of the web interface you see the development of temperature and humidity
within the last seven days The upper diagram shows the temperature chart$ the lower one
shows the humidity chart The red lines depict the configured the alarm thresholds
44
5ig ,+B Web interface
,. :ata export to cloud services
The data collected by Querx TH can be exported to cloud services This allows you to merge
data collected from several devices to set up a central monitoring site for different facilities
1lso it is possible to set up world wide data access for different users or for own monitoring
applications using the provided 1(3s
,.+ Thing%peak integration
To use Querx TH with Thing%peak$ open the page %ystem / !loud Here you have to fill in
the following fieldsB
1(3 key
7nter the 1(3 key that allows you to write on a Thing%peak channel
Temperature field 3:
7nter the number of the field which is used for temperature values
Humidity field 3:
7nter the number of the field which is used for humidity values
!lick on %ave to apply or on !ancel to discard your changes
(lease notice$ that Quer@ TH does not encrypt your 1(3 key on the device
34
5ig ,.B 'easured data at Thing%peak
5ig ,4B !onfigure Thing%peak
'ore information on how to set up a Thing%peak channel or how to integrate channel data
into your website or intranet can be found on wwwthingspeakcom
,.. @ively integration
Querx TH can also update @ively feeds The channels to be updated correspond to the
names$ that you have assigned to the sensors 6see 8+$ configuration of the sensors9
To configure Querx TH for @ively$ open the page %ystem / !loud and fill in the following
fieldsB
1(3 key
7nter the 1(3 key with which you can write on your @ively feed
5eed 3:
7nter the 3: of the feed that you want to write on
!lick on %ave to apply or on !ancel to discard your changes
(lease note that Querx TH does not encrypt the 1(3 key
'ore information on how to set up and access a @ively feed can be found on
wwwxivelycom
4;
5ig ,0B !onfigure @ively
? 5irmware updates
To extend Querx TH's scope of operation$ egnite fre=uently provides new firmware versions
These can easily be uploaded onto and activated on the device
?+ 1vailability of firmware updates
To figure out what firmware version you are currently using$ open the page %ystem /
"eneral 3n the section Cersion you can find the firmware version )ust beside of the label
5irmware
The most recent firmware image can be downloaded from wwwsensorsegnitede 3f the
version of the provided download is higher than the version you are running on Querx TH$ a
firmware update might be sensible
*ightAclick on the download link and choose %ave link as from the popAup menu and choose
a location where to save the file
?++ 3nstallation of firmware images
To install a new firmware version$ open the page 'aintenance / 5irmware
&ow choose a buffer into which you want to install the image 6+9 This should be either the
slot with the lowest firmware number or an empty slot
&ow select the file that you have )ust downloaded 6.9 Then$ click on Upload to save the
firmware on the device 649 The upload may need some time 1fter it is finished$ the new
firmware version is shown next to the buffer that you chose earlier
36
5ig ?.B %ave firmware image
5ig ?+B 5ind out firmware version
?+. 1ctivation of firmware images
1fter uploading a new firmware image$ you have to activate it #pen the page 'aintenance /
5irmware 3n the section 1ctivation you see the two firmware buffers
%elect the one with the version that you want to run 6+9 and click on 1ctivate 6.9 The
software is now written into the internal memory
#nce the writing has finished$ Querx TH reboots :uring this process$ the 27: turns yellow
1fter successfully booting$ the 27: turns back to normal
(lease noteB
The activation process can take a couple of seconds :o not cut Querx TH off from the
power supply during this time$ as the device can be damaged
3f$ for some reason$ the firmware update failed and the device refuses to take up normal
operation$ you can manually reactivate the other firmware buffer 6see <.$ actions to
perform9
4,
5ig ?4B Upload firmware to Querx TH
5ig ?0B 1ctivate firmware image
< Troubleshooting
<+ (ossible errors
<++ &o network connection
3f you are not able to connect to Querx TH$ you probably need to manually configure
network settings %tart the application ':evice :iscoverer' 3f the device is not listed here$
check if it is properly connected to the network 3f that is the case$ a network problem may
have occurred (lease ask you network administrator
3f Querx TH is shown in the list$ please continue as described in sections 44 and 40
<+. Querx TH is slow
3n the web interface$ open the page %ystem / "eneral and check the value for 'emory
Usage 3f this value is greater than ,/ G$ it is likely that you have to many network
connections opened !heck if you can close browser windows connected to the web
interface
<+4 Querx TH has gaps in its chronology
3n the web interface$ open the page %ystem / "eneral and check the value for Uptime Here
you can see the time that Querx TH was running from the last boot on (lease ensure that
the power supply was not accidentally interrupted
<+0 1fter a firmware update$ Querx TH doesn't work anymore
3f after a firmware update Querx TH refuses operation$ you can reactivate the other firmware
buffer on the device 6see <.$ actions to perform9
<+; 2ost logAin data
3f you don't remember the logAin data for Querx TH$ you can reset the device configuration
6see <.$ actions to perform9
<+8 &etwork configuration unknown
3f you don't remember the network configuration for Querx TH$ you can use the utility
':evice :iscoverer' to locate Querx TH in your network
3f Querx TH was configured for a network$ which you have no access to$ you can manually
reset the configuration 6see <.$ actions to perform9
38
<. 1ctions to perform
<.+ *ebooting the device
There are two ways to restart Querx THB
Warm start via web interface
3n the web interface open the page 'aintenance / *eset !lick on *eset next to %ystem
restart !onfirm rebooting the device by clicking Kes on the next page
!old start through power disconnect
*emove the 'icroAU%D cable from Querx TH to interrupt power supply Wait for a couple of
seconds before you reconnect the device
<.. !onfiguration reset
There are two ways to reset the deviceB
!onfiguration reset via web interface
#pen the page 'aintenance / *eset in the web interface !lick on P*esetQ next to
P!onfigurationQ !onfirm the configuration reset by clicking Kes on the following page
Hardware reset
3f you can't configure Querx TH anymore$ for example if you have lost your logAin data$ you
can perform a hardware reset
2eft of the status 27: you find a little opening Underneath is the button for resetting the
configuration (ush it with a ballApen :o not use a pencil$ as the pencil lead could break and
damage the device
The status 27: starts blinking red Hold the button pushed until the blinking stops to reset
the configuration 3f you release the button while Querx TH is blinking$ the old configuration
is kept
4<
<.4 1ctivation of the alternative firmware buffer
3f after a firmware update problems occurred$ you can change the firmware image to be
executed$ given that there is an alternative firmware version on the device 6see ?$ 5irmware
updates9
*emove Querx TH from the power supply &ow take a ballApen and push the button
underneath the opening left of the status 27: :on't use a pencil$ as the pencil lead could
break and damage the device Heeping the button pushed$ reconnect the power supply
The status 27: starts to blink red Kou can interrupt the activation process here if you
release the button 3f you keep it pressed$ after a few seconds the 27: will light red without
blinking 3f you now release the button$ the other firmware image is written into Querx TH's
internal memory and the device will be restarted
40
5ig <+B Hardware reset of the configuration
5ig <.B !hange active 5irmware image
+/ 1ppendix +B %ensor specifications
+/+ Temperature sensor
'easurement
range
Typical 'aximal Unit
:eviation A+/ E! I ?; E! F /4 F /0 E!
A0/ E! I +// E! %ee image E!
2ong term stability R //+ E! E! / year
0+
+/. Humidity sensor
'easurement range Typical 'aximal Unit
:eviation / G I ?/ G F . F 4 G
?/ G I +// G %ee image G
2ong term stability R /.; G / year
7rror of measurement after exposure to extreme circumstances
3f the sensors are exposed to extreme environmental circumstances like very high
temperature$ drought or moistness$ the sensing film can get to dry or to wet This leads to a
temporary decrease of accuracy for the humidity senor
*ecalibration of sensors
The sensors are calibrated by factory and do not need to be manually recalibrated
*ecalibration can be carried out by egnite
42
++ 1ppendix .B %pecifications
'easuring range temperature 0/ E! to ?; E!
A0/ E5 to +?; E5
1ccuracy temperature F/4 E! from A+/ E! to ?; E! / F+/ E! from A0/ E! to A+/ E!
F/; E5 from +0 E5 to +?; E5 / F+? E5 from A0/ E5 to +0 E5
*esolution temperature /+ E!
/. E5
'easuring range humidity / G bis <; G *H
1ccuracy humidity F. G *H from / G to ?/ G *H at 4/ E! 6?8 E59
F0$/ G *H from ?/ G to <; G *H at 4/ E! 6?8 E59
*esolution humidity + G *H
Humidity sensor !'#% 3! with polymide film
!allibration Dy factory
%ensor heating 3ntegrated
7thernet +//+// 'bit *J0;$ H( 1utoA':3@
%tatic or dynamic 6:H!( client9 3(
%ystem &ut/#% ;
5irmware updates #ver web interface$ rescue function
:ata capacity 1t least ;+ days internal
(rotocols
HTT($ %'T($ :H!($ %&T($ %yslog$ %&'( 6Traps only9 $
&ut/:iscovery
Webinterface
(assword protection$ :iagram$ 2ive Update$ HT'2;$
!%%4$ J%#& and %C"$
User 'anagement 64 Users / 4 "roups9
7A'ail Up to 0 *ecipients over . %'T( servers
%&'( Traps
%tatus 27: *ed$ green$ yellow
:ate / Time Dattery backed realAtime clock with %&T( update
(ower supply ; C :! ;; C :!
!onsumption Typical +./ m1 /8 W / maximal .// m1 + W
#perating conditions A0/ E! bis ?; E!$ max <; G *H
A0/ E5 bis +?; E5$ max <; G *H
%torage conditions A0/ E! bis ?; E!$ max <; G *H
A0/ E5 bis +?; E5$ max <; G *H
04
Housing material 1D% thermoplastic
Housing color Dlack *12 </++
Housing dimensions ;84 mm x 0/ mm x .+ mm plus sensing cable
.. in x +8 in x /? in plus sensing cable
2ength sensing cable 40/ mm
+4? in
Weight 4; g
//, lb
!onnector *J0; 67thernet9$ 'icroAU%D
'ounting Wall mounting
!onformity !7 compliant
U2$ U%1 / Hanada U2<0
(rotection marking 3(./
*oH% compliance 7U :irective .//./<;/7!
44
+. 1ppendix 4B 'anufacturer
egnite "mbH
7rinstrasse <
00;,; !astropA*auxel
"ermany
7mailB infoSegnitede
TelB T0< 6/9.4/; 00+.;8
5axB T0< 6/9.4/; 00+0?,
wwwegnitede
sensorsegnitede
0;