Upload
dangliem
View
249
Download
0
Embed Size (px)
Citation preview
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