H20 Windows software with interface

  1. Home
  2. Docs
  3. H20 Windows software with interface
  4. Statlink User Manual

Statlink User Manual

About Husdata
Husdata is developing solutions for heating system owners looking for advanced functionality in data collection, presentation and monitoring .

This makes it possible to connect your heating system to PC and further on to the Internet. The solutions from Husdata demands more from the the users but in return it will give advanced possibilities for individual customisation. If you do notneed the PC connection and instead are looking for asimple alarm and remote control solution with guaranteed uptime then we recommend that you contact your reseller and aquire the heating system manufacturer’s online-system instead.

About the software StatLink

The main functions of StatLink are…

  • that with different interfaces and protocols communicate with heating systems .
  • that with powerful functionality satisfy advanced users who will make their own homepages,
    reports, realtime views or external progr ams to work with the collected information.
  • that with integrated monitoring views give the user better understanding of how their heating
    system and their control logic works.
  • to link between your heating system and the Husdata-portal. This makes it very easy to bring your heating system online on the Internet or mobile phone.

Today StatLink has support for the most popular ground source and air water heatpumps in the nordics
StatLink is a Windows software written to use consume very little system resources . It workswith the operating systems Windows XP and later.

About the Husdata Online portal
The Husdata portal gives you the possibility to reach the collected data from the Internet. You can view the status of the current situation, view historical reports in charts and tables. It has alarm function via SMS and email, etc. You can choose to make your information private or shareit w ith other users. Please visit the portal www.husdata.se to find out more about the service.

Installation

StatLink software
Login to Husdata.se with your account and download the latest StatLink setup file. Run the Setup file on your computer.
The standard installation directory is C: \StatLink but you can choose another if you want.

H10 interface for the IVT Rego 6xx controller
You have to connect the supplied interface between the heat pump and your PC to enable the software to communicate with the Rego controller.

  1. Turn off your heatpump.
  2. Open the front of your heat pump.
  3. Locate a small green circuit board with a 9 -pin connector with the label ”Service”
  4. Connect the interface to this connector (the circuit board side).
  5. Connect the other side to the computers serial port and USB port.
  6. Start up your heat pump again.

Note!
When communicating with a Rego controller it is best toposition the display in the Main menu
position (the date and time shows). If you leave the display in the “Info” menu position the Rego is
constantly updating the display and this will slow down the link to the PC.


Connect an Electrical meter with S0-pulse interface
Warning! Husdata is not guaranteeing the functionality for your type of meter. Also pay attention that the line between the PC and electrical meter is not isolated. Husdata will not take any responsibility of any damage or problems caused by this type of connections. All connections to the S0 port is done at your own risk.
If you have an Electrical meter with a S0 connector you have the possibility to connect it to your PC and enable StatLink to show and store information about the electrical consumtion.
You will not need any interface. The cables are connected directly to the pins of the serial port. Up to 2 electrical meters can be connected simultaneously. To be able to connect the meters you must have the skills to handle a solder iron. Otherwise contact Husdata for asistance of making a special cable for you.

Description of how to connect to the 9 -pole D-sub connector.
Pin Meter
8 S0 –Meter for Heatpump
4 S0 + Meter for Heatpump
4 S0 + Meter for total house measurement
6 S0 –Meter for total house measurement

Settings that needs to be performed to enable the meter.

  1. Enable the S0 interface by enter the Setup and choose Interfaces.
    Select the interface type S0. You can connect the S0 meter to the same comport as the Rego interface.
  2. Enable the meters in the Sys_ID table. (Se Appendix A)
    You must also select the correct numer of pulses per kWh. This information is usually found on the label on your electrical meter.

With the S0-meter connected you will be able to extract the following information.

  • Realtime display showed in the EL-Meter andSensor table views.
    (The intraday kWh and momentarly Power load in Watt)
  • Logging to file in selectable intervals. (See Actions and Rapporttempate chapters)
  • Logging to Flatfile DB format for graphical presentation.
  • Logging to the husdata portal is not supported in this version of Statlink.

Extending the cable
Probably you will need to extend the cable length. Extensions up to 30- 40 meters are normally not
causing any problems. The easiest way to do this is to cut the cable in the middle and reconnect the
wires with the extended cable with some kind of simple connector.
Use a standard 2-pair telephone wire to extend the cable.
Please do not mix up the colours of the wires because it could destroy the interface or serial port.

Users manual

General about settings in StatLink
General setup
All general settings is made trough the settings dialogue found under the menu File.
All general settings arestoredin the Settings.xml file residing in the StatLink program directory.
Please makebackup of this file if you are uppgrading or re-installing the software. Please see the File menu chapter for more information.

Advanced Setup
Advanced settings such as modifing Sys_ID’s and configuring automated Actions is found in the
StatLink.ini file. The editor for thi s file can be reached from the General setup menu.

Storing historical data
There are numerous ways to store information about how your heating system is performing.
This chapter is describing how this can be achived in different ways.

Flat file DB, Stor e detail data to local disc
The logging format called Flatfile DB is a simple file based database that is used by StatLink to present its line chart diagrams.
The Flatfile DB is enabled by default when Statlink is installed.
Here are some options described.

Modify DB settings
Enter the setup menu and select the “DB / Logging” section.
Here you can change how often you want to write data. Default is every 2 minutes. Notice that a higher resolution will take more disk space.
If you logg all temperatures every 2 minutes the DB size will increase aprox. 100kB per day or 36Mb per year

Enable / Disable sensors and objects
You can choosewitch object’s informationto stor ein this log.
For that you will have to open and modify the statlink.ini file.
Select witch sensors you want to log under the section [Sensors].
This is also where you can change the names of the objects if you want.
Please see Appendix A for more information.


Storing daily summary to local disc
In different views of StatLink you can view information collected since midnight. (See the “sensor table” chapter)
StatLink has a flexible way to log this information and both the intervals, contents and formats are customisable using the Actions and Templatesfeatures .
StatLink is preconfigured with an “Action” that is storing Intraday information at 00: 00every night for longterm reporting/calculation of historical informatino . A new row of data is added in the tab separated file “DayRpt.csv” witch can be opened and worked with in MS Excel.

In the StatLink directory there is a template file called “tDayRpt.txt”. The output file is generated from this template. Edit this file to change the contents and layout of the report. Please note that all stored information is in Integers and has to be devided by ten to get the correct information. For eample, the temperature 22.7 degrees is stored as the number 227.
Runtime is stored in seconds and electri cal consumption i watt hours.


Connetion to the Husdata online portal
An easy way to get your information available from the internet is to use the Husdata -online service. This also makes it possible to compare your information with other users. You will get your “own” info -page witch easily can be linked to from a mail foot or your own homepage. To get your information in the Husdata-online pages do the following…

  1. See to that you have avalid online account at Husdata.se.
  2. You must also have a fixed connection to the In ternet. (br oadband)
  3. Enter the setup, section Husdata -Onlineand type in your provided Username and Password
  4. Log in to Husdata.se and select to show your info in public (if you want)
  5. Now data should start to show in about ten minutes.

Reporting

Mail reports
StatLink has the possibility to schedule sending of emails containing reports. With use of a template-file you configure the layout and conten ts of the report. To make this work you must configure your email account settings in StatLink and also configure “Actions” for an email sending event

Report templates
To setup the layout and conten ts of the reports you have to configure report templates. The waythis is working is that you enter ”Taggs”in the report template in positions where you want to present the information. When the template I processed by StatLink the tag is replaced by the actual
data for output in the report. Reports are generated when StatLink I running an ”Action” of type”Make Report”.
Please see the chapter about Actionsfor more information.

In theStatLink program directory there are someexamples of report templates that youcan view and customize for your own needs .

tWebRpt.html
A HTML template suitable to use for email reports or presentation on
your homepage .

tCSV.txt
A TAB separated template suitable to store data that is importable into
MS Excel.

This is a list of available Tags to use in the report templates.
%Time% Time now (eg. 10:35:55)
%Date% Date now (eg. 2005 -01- 01)
%YesterDate% Yesterdays date (2005-05-04)
%TotalkWh% Summaryof theintraday electrical consumption.
%NewRow% Inserts LF andCR to generate row change .
%SysID_X _Name% Shows the name of an Monitored Object
X=SysID. The table of all SysID’s is found in appendix B.
%SysID_X _Value% Current value in text. (eg. 10.2c, On/Off)
%SysID_X _Stat1% Intrad aystatisti cs, see chapter about the Objects table .
%SysID_X _Stat2% Intraday statistics, see chapter about the Objects table .
%SysID_X _Stat3% Intraday statistics, see chapter about the Objects table .
%SysID_X _tValue% Sam e as above but is presenting numeric values. (102, 1/0)
%SysID_X _tStat1%
%SysID_X _tStat2%
%SysID_X _tStat3%

Example of how you can build an templete…
Report generated %Date% %Time%
The Radiator temperature is: %SysID_1 _Value%.
The outdoor temperature is: %SysID_2_Value% and the Max temp today is:
%SysID_2_Stat3%.

The generated report will then look likt this …
Reportgenerated2005-12-20 13:55
The Radiator temperature is: 33.4c.
The outdoor temperature is: -2.3c and theMax temptoday are:1.2c.

Automated Actions
There is a functionality in StatLink to schedule events called Actions.
StatLink users manual

Things that can be automated is Sending emails, Take pictures and producing reports. You set up the Actions under the section [Actions] in the statlink.ini file.

Up to 9 Actions can be configured (1 -9).


Example of how to use Actions
Action to send an email containing an report of the yesterday data.
This event will generate a report based on the template ”tWebRpt.html” and send it by email at the
time 00:00 every day.
Act1-Name=Send Email report every day
Act1-Type=MakeReport
Act1-Input=C:\StatLink\tWebRpt.html
Act1-Interval=00:00
Act1-SendEmail=True


If you have a Web server and want to publish a page with info.
This event will generate a report based on the template ”tWebRpt.html” and wrie the result in the file
”WebInfo.html” every minute.
”Mode=Replace” means that the result fle is overwritten every time.
Act2-Name=Generate a web-page every minute
Act2-Type=MakeReport
Act2-Input=C:\StatLink\tWebRpt.html
Act2-Output=C:\StatLink\WebInfo.html
Act2-Mode=Replace
Act2-Interval=1
Act2-SendEmail=False

If you have a Web server and want to publish a picture of StatLink.
This event will generate a screenshot of StatLink and write it into the file ScreenShot.jpg every minute. Note that the screen shot function has some limitations. For the screen shot to work, the StatLink software cannot be minimized and no other windows should block the StatLink windows
Act3-Name=Make screenshot every minute
Act3-Type=MakePicture
Act3-Output=C:\StatLink\ScreenShot.jpg
Act3-Mode=Screenshot
Act3-Interval=1
Act3-JpgQuality=90


Action to log historical data in Excel importable format.
This event wil generate a report based on the file ”tCsv.txt” and write the result into the file ”Minutelogg.csv” every minute.
”Mode=Append” means that the result file will not overwritten. Instead it will be appended with new
data.
Act4-Type=MakeReport
Act4-Name=Save data to CSV file every minute
Act4-Input=C:\StatLink\tCsv.txt
Act4-Output=C:\StatLink\Minutelogg.csv
Act4-Mode=Append
Act4-Interval=1
StatLink users manual

Menues

Menu File

Settings
This selecion will launch the setup dialogue. Select setup-section by clicking an entry int the list at the right. If you placethe mouse pointer over an option text you get additional information of how to use the
option.
Here is an overview of available setup options.

  • General
    o Common
    Select the Volt and Fuse to get correct calculation och power consumption.
    o Email
    Select options for outgoing email used in actions for report sendings.
    Normally you don´t have to fill i n the username and password
  • Interfaces
    o Interface 1
    Select thetype of interface and assign it to a Com-port.
    H10 Rego6xx, H14 Thermia.
    o Interface 2
    Select the type of interface and assign it to a Com-port.
    S0 can be assigned to the same Com-port as H10 or H14 interfaces.
  • Log / DB
    o Flat file DB
    See Flat file DB chapter . DB Used for line diagrams.
  • Husdata Online
    o If you have an active account on the Husdata Online system you can enable it here.
    Enter the username and password you got from Husdata.
  • Automated Actions
    o See chapter ”Automated Actions” for more info
  • Sensor Settings
    o See chapter ”Automated Actions” for more info
  • Pulse Views
    o Pulse view 1
    A Pulse view is a realtime view of your heating system or other environment.
    You can design your own Pulse view or modify the current.
    See the the “Pulse view designer” chapter formore info
    o Pulse view 2
    Up to two views can be configured

Reset Stat
Every midnight the Intraday statistics is automatically reset.
Here you can manually reset the statistics for the day.

Exit
Exit from StatLink

Menu Actions
In this menu you can manualy run your configured actions.
This is useful to verify that your emails are sent or reports are generated as expected.

Menu Show
Rego Dashboard
The Rego Dashboard is only available when a Rego6xx interface is enabled. This view is presenting
specific information and functions of this controller.
The view has 2 tabs.

-The tab “Control Curve”

This is a graphical presentation of how the controlcurve is set up in your Rego. Together with historical logging and line diagrams you are equiped with a powerful tool to optimise your heat pump.

Depending on if you you have a Room sensor or not you must enable or disable it to get the correct presentation of the curve. Please see the Appendix C of how to do this.

“Read REGO settings” button
If you have m ake changes in the Rego settings when StatLink is running you should press this button to re-read the settings from the controller for correct presentation of the curve.

“Refresh view” button
This is redrawing the graph. This is also performed automatical ly every 30 sec.

”Track movement” checkbox
If you want to track how the control point an dcurve aremoving during time, select this box.

”Show with Room sensor influence” checkbox
If this is selected,the curve position will be influenced by the room temp, as it is actually done in the controller.

-The tab Remote display
In this tab you can perform remote control of the Rego-display from StatLink and also get an overview of the indicator lamps. The remote conrol can sometimes feel slow. This is a norma l condition and caused by limitations in the Rego controller.

An alternative to click on the buttons to navigate is to use your numeric key pad instead.

Below is a list of the keys to use.
4 = Menu button left
5 = Menu button center
6 = Menu button right
1 = Turn the knob left
2 = Refresh
3 = Turn the knob right

Notice!
When you enter the remote display tab, all other readings from the Rego is halted. As long as you are working in this tab no logging will be done. To avoid the scenario where you forget the tab in that position, the Rego Dashboard view will return to the Control curve tab after 2 minutes of inactivity.

On the Rego control – panel at your heatpump you can hold down the left button for some seconds to enter the Service menues. This is notpossible to do from the remote display. You must enter these menues by pressing the button at your physical heatpump.

Monitored ObjectsTable

This is a view showing all the enabled objects. The view is showing both current status and accumulated intraday information.

Descrition of the columns.
ID The SysID of the sensor or object.
Source The source of the data
Name The n ame of the object (Changeble under the [Sensors] section of statlink.ini)
Type Type of object / data
Value Current value / status of the object
Changed The time the object has changed value orstate
Stat1-3 Accumulated intraday statistics. See table below


Type of object Stat1 Stat2 Stat3
Temp Average temp Max temp Min temp
Status El consumpt. in kWh Run time Status changes
EL- Meter Acc. kWh – –

Electrical Meter
This view is only visible and usable if you have electrical meters connected via the S0 pulse interface and the interface enabled . The view will show intraday electrical cunsumption in kWh and current power outtage i Watt. Up to 2 meters can be used at the same time.

Events
This view is showing the time and info of the last 30 status changes of all objects.

Reports

Line diagram
To view the stored data in line chartsselect the menu Reports and option Line diagram. Now a selector dialog i shown. Please select all objects to include and the period of time.

Click on “Generate” and then chart will be displayed.
For zoom, hold the Right mouse button while moving the mouse right or left. For movein time , hold the Left mouse button while moving the mouse right or left.

Pulse views
The Pulse view g ives you a realtime picture with information from different objects. It is fully editable with thepossibility to Add, Remove, Rename and change propertiesof all the displayed objects. You can even replace the background picture and create your complete persona lized
view from scratch.

-Viewer
If you put the mouse pointer over an object it will show additional information with intraday statistics.
To show a line diagram with the last 24 hours of historical data, click on an object. If nothing happens while clicking an object it is because the object is not enabled for logging to the Flat file DB. See the Appendix A for more information.

-Editor
To enter the editor you just double click anywhere on the Pulse picture.
Now a blow dot is shown at every editabl e object.
To change properties of an object, click on the blue dot.
To add a new object youright-click anywhere in the picture.

Properties box
Button –Move Click on this and place the object with the left mosue-button.
When you are done you exit the move mode with the right bouse button
Button -Delete this Will delete the selected object
Button -Delete all Will delete all objects from the view
Button -Ok Confirm changes
Button -Cancel Cancel changes
Field 1 Enter the name / display text for the object
Field 2 Select type of object (se table below)
Field 3 Option 1 for the object (se table below)
Field 4 Option 2 for the object (se table below)
Field 5 Option 3 for the object (se table below)
Bind to SysID Enter SysID number to bind this object to (see Monitored Objects table vies)


Table of object types and properties
Name Descript Option1 Option2 Option3
Temperature Small box showing temp. Show text Trend arrow
Pump Animated pump symbol Show text Flow dir.
Compressor Animated compressor symbol Show text
Heater Animated additional heater symbol Show text Step 1, 2
Switch valve Animated switch valve symbol Show text
Label Text label Font size Style Text colour
Info display Special inform display for Rego
Power display Intraday kWh, Watt and Amp disp
Led LED Status indicator Text colour

To exit the Edit mode, just double click on the picture again.

Notice
Remember to enable the Object you want to show in the Pulse view in the statlink.ini. The Power display is showing the intraday accumulated electrical consumption and also the power (watt) and load (amp). These values are based on how much power each object consumes. To give the
correct information, this must be altered to suite your heat pump model in the [Sensors] section of statlink.in i. See appendix A.

Trouble shooting

Tracelogs
In your StatLink software directory it resides a directory called TraceLogs.
In case of some error, StatLink stores information in trace filer.
If you encounter problems with your StatLink softare, pleas check the trace files for any explanation of the reason to the problem.
If you want to change the trace log level, please see Appendix A.

Support
If you need any help, please send a mail to info@husdata.se or enter the www.husdata.se portal and leave a message via the contact form. We will do our best to help you get started. You can also try getting help from other Husdata users trough the support forum found at www.husdata.se/forum.asp

Appendix A – Options Statlink.ini

[Tracing]
TraceLogLevel=Error
Description: When set it stores trace information for troubleshooting
in \Tracelogs\directory. Review the log files for errors whenever you experience any problem.
Valid settings: Error, <nothing>

[Actions]

Replace X with the number of your configured Action (1-9)

ActX-Name=
Description: Your description of this action. This text will show up in
the “actions” menu in the application and also in trace-logs.
Valid settings:

ActX-Type=
Description: The type of action. Select if you want to generate a
report file based on a template or if you want to generate a picture.
Valid settings: MakeReport and MakePicture

ActX-Input=
Description: Here you enter the full path and filename to the template
file used in MakeReport Type. This is not used in MakePicture Type.
Valid settings: , Ex. C:\StatLink\Template.txt

ActX-Output=
Description: Here you enter the full path and filename to the generated
report or picture file. This is used in both MakePicture and MakeReport
Type.
Valid settings: , Ex. C:\StatLink\Report.html

ActX-Mode=
Description: This is the mode selection for the selected Type.
Valid settings:
If MakeReport Type…
Replace (Will replace the current rpt file)
Append (Will append data to the current rpt file)
New (Will create a new file name every time)
If MakePicture Type…
Screenshot (Will take picture of StatLink main window)

ActX-Interval=
Description: This is the run interval for the action.
Valid settings:
in Minutes. Ex. 5= Will run action every 5 minutes.
in HH:MM. ex. 09:55=Will run action at 09:55 every day.

ActX-JpgQuality=
This setting is valid if using the MakePicture Type.
Select file size and quality of the saved Picture, Jpg file.
Valid settings: 1 –100. (100 produce the best quality)

ActX-SendEmail=
This setting is valid if using the MakeReport Type. If set toTrue, it
will send the generated report as an email.
Valid settings: True or False

[Sensors]
TEMPERATURES--------SysID_1=Radiator Retur GT1,True,True,0
SysID_2=Ute GT2,True,True,0
SysID_3=Varmvatten GT3,True,True,0
SysID_4=Framledning Rad GT4,False,False,0
SysID_5=Rum GT5,True,True,0
SysID_6=Hetgas GT6,True,True,0
SysID_7=Värmebärare Ut GT8,True,True,0
SysID_8=Värmebärare In GT9,True,True,0
SysID_9=Köldbärare In GT10,True,True,0
SysID_10=Köldbärare Ut GT11,True,True,0
SysID_11=Varmvatten GT3x,False,False,0
Description: Here you setup the temperature sensors.
Pos1: The name witch can be changed.
Pos2: Select if the sensor is Enabled (visible)
Pos3: Select of you want to log this sensor to “LocalLog”
Pos4: Integer number to calibrate temperature input.
Ex. 0=No adjustment, 55=Add 5.5 degrees,
-102=subtract 10.2 degrees.
STATUS----------SysID_12=Köldbärarpump P3,True,False,106
SysID_13=Kompressor,True,False,2200
SysID_14=Tillskott steg 1,True,False,3000
SysID_15=Tillskott steg 2,True,False,6000
SysID_16=Radiatorpump P1,True,False,55
SysID_17=Värmebärarpump P2,True,False,46
SysID_18=Växelventil VXV1,True,False,0
SysID_19=Summa larm,True,False,0
Description: Here you setup the status sensors.
Pos1: The name witch can be changed.
Pos2: Select if the object is Enabled (visible)
Pos3: Select of you want to log this sensor to “LocalLog”
Pos4: The power effect in watt for the object
EL-METERS---------SysID_510=EL-Värmepump,True,True,16,1000
SysID_520=EL-Total,True,True,16,1000
Description: Here you setup the electrical meters (S0 interface)
Pos1: The name of the meter.
Pos2: Select if the meter is Enabled
Pos3: Select of you want to log this meter to “LocalLog”
Pos4: Ampere of your fuses in series with the Meter
Pos5: Number of pulses per kWh on the meter

Appendix C Coniderations

IVT Greenline C-Series versus E-series

The C-Series has an internal warm water tank andthe E-Series has an
external. Therfore the sensors haveto be configured correct for the
software to work properly.
Also to show correct info in the Pulse view you must change the SysID for
the Hot water temp display. Please see then Pulse view chapterhow to edit
the view.

C-Series E-Series
SysID_3=Hot water GT3, True ,True,0 SysID_3=Hot water GT3, False ,False,0
SysID_11=Hot water GT3x,False ,False,0 SysID_11=Hot water GT3x,True ,True,0
Pulse view editor: Bind to SysID = 3 Pulse view editor: Bind to SysID = 11

Room sensor
If you have a roomsensor installed you should enable it in StatLink.
SysID_5=Room GT5,True,True,0

If you don’t have a room sensor it should be disabled.
SysID_5=Room GT5,False,False,0

Also remember to add or remove then temperatureobject in your Pulse view.

How can we help?