Control4 Janus Universal KNX Thermostatjanustechnology.co.uk/wp-content/uploads/Control4... · 3 Control4 Janus Universal KNX Thermostat KNX Configuration The KNX system must first

1 Control4JanusUniversalKNXThermostat

Control4 Driver

for

KNX Universal Thermostat

2 Control4JanusUniversalKNXThermostat

Introduction

ThisdocumentprovidesdetailsforinstallingtheJanusKNXUniversalThermostatdriverintoaControl4installation.Additionally,itprovidesadescriptionoftheenduserexperienceonControl4GUIs.ThedriverhasbeendevelopedandtestedonControl4OSversion2.8.2anditisrecommendedusingthisversion(orlater).

ThisdriverutilisestheControl4networkdrivertocommunicatewiththeKNXsystem.Version19(orlater)ofthisnetworkdrivershouldbeutilised.

KNXhasstandardisedbuscommunication,allowingdevicesfromover300manufacturersacross37countriestointer-operate.However,thereislittlestandardisationastowhatfeaturesthedevicesprovideandhowtheyarecontrolled.ThisisparticularlyaproblemwithThermostats,wheretherearemultipledifferentwaysofcontrollingthem,differingbetweenmanufacturers,andevenbetweenproductrangesofamanufacturer.Thishasmadewritingagenericthermostatdriververydifficultinthepast.

TheapproachJanushastakenistodevelopadriverthathasembeddedwithinittheknowledgeofthevariousmanufacturersandmodels,andthedifferentwaysofcontrollingthem.Theinstallerselectsthemanufacturer/modelandthevisiblepropertieswithinthedriverarethenadjustedtodisplayonlythosepropertiesthatarerelevantforconfigurationofthatspecificdevice.Further,whereadevicehasstaticconfigurationthatdeterminesitsoperation(e.g.Heating,Cooling,Heat/CoolwithAutoswitchover,Heat/Coolwithmanualswitchover),thenthisconfigurationisalsoexposedinthedriverpropertiesanditsvaluedrivesthepropertiesvisibilitye.g.selectHeatonly,andthepropertyforconfiguringtheCoolDemandgroupaddressdisappears.

Inthismanner,theinstallerisguidedtoconfigurethosegroupaddressesthatarerelevantforthethermostattheyhaveselectedandtheirparticularusageofthatstat.

Additionally,theControl4GUIcanbeconfiguredsothatextracapabilitiesrelatedtothethermosatand/orzoneinwhichitislocatedcanbeaccessedfromtheEXTRAstab.Thiscouldinclude

• ManualHeating/Coolingswitchover• Towelrails,oranyswitchable(On/Off)item

NOTE–thedriverwillbereleasedinphasesaseachnewthermostatmanufacturerisdeveloped/tested.Ifyouhaveanurgentneedforathermostat(orconfiguration)thatisn’tcurrentlysupported,pleaseletusknow([email protected])sothatwecanprioritisethedevelopments.Anewthermostatcantypicallybesupportedinafewdays.

3 Control4JanusUniversalKNXThermostat

KNXConfiguration

TheKNXsystemmustfirstbefullycommissionedandtestedbyasuitablyexperiencedengineer.GroupAddressesmustbedefinedforallitemsthataredesiredtobecontrolledbyControl4.Pleasecheckthatthethermostat/configurationthatyouwishtouseiscurrentlysupportedbythedriver–ifnotthenletusknow(asabove)sowecanprioritisedevelopment.

DuringintegrationwithControl4itishighlyrecommendthattheKNXprogrammerisavailabletoprovideGroupAddressdetailsandassistwithtestingtheintegrationbymonitoringtheKNXbusandgeneratingtestdata(fromwithinETS)asnecessary.

Control4Configuration

FirstinstalltheControl4KNXnetworkdriverandconfigurethistotalktotheKNXrouter.

Theninstallthethermostatdriver(hvac_knx_janus_universal_tstatV2.c4i)foreachthermostatthatiswantedinControl4.EnsurethattheKNXControlconnectionisboundtotheKNXNetworkdriver

Therearesomecommonpropertiesforalltypesofthemostats,asshownbelow:

4 Control4JanusUniversalKNXThermostat

IfweneedsupportlogstoinvestigateaproblemthenwewillaskyoutoenableDebuginthedriverasfollows:-

DebugMode SetthistoPrint

DebugSubsystems Setthisto‘*’todisplayalldebug

Debuglevel Setthistodefault0(settingto5additionallylogsallproxycomms,buttypicallythisisnotrequired)

Thedriverislicenced.Itrunsinfullfunctionaldemomodefor30minutesfollowingeachprocessorrestart.Toenablepermanentoperationyouwillneedtoenteralicencekey.Licencesareavailabletopurchasefromourwebsitewww.janustechnology.co.ukYouwillneedtoentertheMACAddress(thiscanbeviewedasadriverproperty)ofyourControl4processortocompletethepurchaseandobtainalicencekey.Onceyouhavethekey,enteritintotheLicenceKeyfieldofthedriverproperties.

Thenextstepistoselectthethermostatmanufacturer/modelandspecifyhowithasbeenconfiguredinETS

5 Control4JanusUniversalKNXThermostat

Manufacturer manufacturerofthethermostat

Model genericmodelnumberofthethermostatfamily

SetpointAdjustment methodviawhichsetpointsareadjustedfortheselectedthermostat.Notethatonlysupportedmodesaredisplayedforselection.Currentlysupportedadjustmentmodesare:-

AbsoluteBase basesetpointisadjusted,withactualsetpointdependantoncurrentmode(Comfort,Standbyetc)andoperationmode(Heating/Cooling)

AbsoluteforcurrentlyactiveMode onegroupaddressforadjustingsetpoint.Valuewrittenmodifiesthesetpointforthemodethestatiscurrentlyin.Thischangemayoptionallypersistonamodechange–dependantonhowthestatisconfiguredinETS

AbsoluteforeachMode onegroupaddressforeachsupportedmodeforadjustingthesetpoint

OperationMode specifieswhetherstatsupportHeating,Coolingorboth.Ifboth,thenwhetherswitchoverisautomatic,ormanual(controlledfromaseparategroupaddress)

OperatingMode specifiesthemethodforchangingoperatingmodeofthestatandfeedback.CurrentlyonlyKonnexDPT20.102/105isrequiredforthesupportedstats

Havingdefinedtheconfigurationofthestatthenextstepistoconfigurethegroupaddressforcontrolling/readingtherelevantparameters.Thedriverhasknowledgeofwhichparametersarerelevantforthevariousconfigurationsandsoonlydisplaysrelevantfields.SettingGroupaddressesisbestexplainedbyseveralexamplesforsupportedstats–seefollowingsections.

NOTE:TheControl4KNXnetworkdriveronlyrequeststhe'currentvalue'ofalladdressesfoundinControl4KNXdevicesinthesystematstartup(oncethedriverisabletosuccessfullyconnecttotheKNXgateway).This'ReadRequest'fordatavalueswillonlyworkifindividualGroupAddresseshavetheir'ReadFlag'(R)attributesetinETS.Consequently,havingconfiguredthethermostatproperties,itisrecommendedgoingtotheNetworkDriver,andontheActionstabyoucanDisconnectandthenConnecttotheKNXbus.Thishastheeffectofforcinganupdateofallvalues(otherwisethedriverwouldbeinanindeterminatestateuntileithertheusereffectsachangefromControl4,ortheKNXstatechanges(whichsendsanotificationtoControl4).Whentheprocessorisrebooted(orDirectorrestarts),allvaluesareread,sotheaboveonlyappliesduringinitialconfiguration.

6 Control4JanusUniversalKNXThermostat

GroupAddressConfiguration–ABB6124setpointadjustment AbsoluteBase

operationmode Heat,Cool,Heat/CoolAutoSwitchover,Heat/CoolManualswitchover

Operatingmode KonnexDPT20.102/105

ThefollowingGroupAddressesaretobeconfigured

(R)ActualTemperaturecurrentzonetemperature

(R)Setpointtemperature currentsetpointtemperature

(W)BasicSetpoint basicsetpointtemperature.Actualsetpointdependsoncurrentmode,andwhetherstatisinHeatingorCoolingmode

()Operationswitchoverswitchoverbetweenheating(1)andcooling(0)operationmodes.Ifstatisconfiguredforautomaticmode,thenthisgroupaddressisreadonly.Ifstat

7 Control4JanusUniversalKNXThermostat

supportsmanualmodethentheGUIprovidesatogglebuttonontheEXTRAstabforswitchingbetweenheatingandcooling

(W)ControlOn/Off (optional)providesameansofswitchingstatOn/off.Ifagroupaddressisdefinedhere,thenan‘Off’modeismadeavailableinModeselectionontheGUI

(W)KonnexMode controlsoperatingmode.ThefollowingparameterdefinestheavailablemodesontheGUIandthevaluesthatarewrittentothisgroupaddress

KonnexMode definesavailablemodesandvalues.Initialisestoadefaultforthestat,definedasasetofcomma-delimitedname=valuepairseg

Comfort=1,Standby=2,Economy=3,Protection=4

ThenamedvaluesappearontheControl4GUI.Itisallowedtoeditthistoreducethenumberofentriesegifyoudidn’twishtoprovideControl4selectionofProtectionmode

Temperatureranges definestherangesoftemperatureadjustmentforeachmode.Notethatthisisnotcurrentlyusedtoenforcesetpointadjustmentbands,buttospecifythesetbacksbetweenmodes(thedriverneedsthistocalculatethebasicsetpointgivenoperationmodeandKonnexmode).NotethattheModenamesmustexactlythosedefinedaboveeg

Comfort=18-24,Standby=16-22,Economy=14-20,Protection=7-7

(RW)FanSpeed setsspeedofthefan.Availablesspeeds(andvalues)aredefinedbytheFanModesproperty

(RWFanAuto/manual) (optional)switchesfanbetweenautomaticandmanualspeedselection

FanModes definestheavailablefanspeedsandvaluestobewritteneg

Low=1,Medium=2,High=3

Ifnofanisrequired,thensetthistoanemptystring.InthatcasethefieldsforFanSpeedandFanAuto/Manualwillbehidden

(R)HeatIndication feedbackwhenKNXsystemisdemandingheating.ThisisusedtodirectlyfeedbacktotheControl4GUI.IfOperationmodeisCoolingonly,thenthisfieldishidden

(R)CoolIndication feedbackwhenKNXsystemisdemandingcooling.ThisisusedtodirectlyfeedbacktotheControl4GUI.IfOperationmodeisHeatingonly,thenthisfieldishidden

8 Control4JanusUniversalKNXThermostat

GroupAddressConfiguration–EXTRAs

Inadditiontocontrolofthethermostat,thedriverprovidessupportforadditionalelementsthatcanbegroupedintheEXTRAstabontheControl4GUI.Currentlytwotypesaresupported

DiscreteOn/Off write1toswitchOn,0toswitchOff

ToggleOn/Off write1totogglestate(andthenimmediatelywrites0sothatnexttoggleseeawrite1asachange)

Specifythenumberofextrabuttonsthatyouwishtoappear.

Thenforeachbuttonspecifythefollowing:-

ExtranName VisiblenameontheGUI

(W)Extran groupaddressforcontrol

(R)ExtranStatus (optional)groupaddressforstatusfeedback,ifthisisseparatefromcontrol

9 Control4JanusUniversalKNXThermostat

Control4Comfortproxy

ComfortisaccessiblefromthemainHomescreenontheControl4interface

SelectingthisthendisplaystheComfortpage,inwhichallconfiguredthermostatsinthesystemaredisplay,togetherwithcurrenttemperatureandoperationalmode

10 Control4JanusUniversalKNXThermostat

Selectingaspecificzonethenallowsyoutomonitorandcontrolthatzone

Thekeyelementsofthescreenareasfollows:-

ModeSelectstheoperationalmodeofthezone.Theavailablechoicesaredependentonthetypeofthermostatconfiguredforthatzoneanditsconfiguration.TypicallythiswouldbethestandardKNXmodes(Comfort,Standby,Night,Protection)withasuffixindicationtheoperationconfigurationofthestat(Heat,CoolorAuto).IfthestatsupportsbeingswitchedOff,thenOffwillbeavailableasanadditionalModeegtypicalavailablemodesforaheatingonlyzone)

Off,Comfort(Heat),Standby(Heat),Night(Heat),Protection(Heat)

Whenzoneisactive(ienotOff),thentheModeicon(andcentralring)indicatesthedemandiewhetherthezoneiscurrentlybeingheatedorcooled(yellowforheat,blueforcool).

11 Control4JanusUniversalKNXThermostat

Fan(onlypresentforzonesthatsupportFancontrol)–determinesFanSpeedofthesystem.ChoicesaredependentonStatconfigurationeg

Auto,Low,Medium,High

SetPointAdjuststhetargettemperature(SetPoint)forthezone.

12 Control4JanusUniversalKNXThermostat

PresetsInOS2.7Control4introducedtheconceptofPresets.ThisallowstheusertocreatetheirownPresets(basedonanumberofcontrollableelements)andthenschedulethese.SupportedPresetelementsareSetPoint,HVACMode,OperationalSwitchover(ifmanual)andFanMode

AndhavingcreatedthePresets,youcanthenscheduletheseevents

13 Control4JanusUniversalKNXThermostat

Extras

InOS2.7Control4introducedtheconceptofExtrafunctionalitythatcanbeincorporatedintotheThermostatproxy,groupedundertheExtrastab.ThisdriverusesExtrasfor

• ManualSwitchoverofOperationmode(ifavailable)• AdditionalswitcheditemsconfiguredbytheinstalleregTowelRails