Variables
API - variables
This page serves as a reference manual for all CTS602 QuickApp variables available through the nilan_var() function described on the scene page.
Each variable can be read by calling nilan_var("variable_name"), or by reading the NilanVars["variable_name"] associative array after calling nilan_var() without parameters.
Writable variables can be set by calling nilan_var("variable_name", new_value).
Naming convention
The variable name suffix indicates the access level:
_ro— Read-only. The value can be queried but not changed._rw— Read-write. The value can be queried and changed from a scene._wo— Write-only. An action variable (e.g. reset button) that can only be written._rw_inf— Read-write (info). Displayed as a label in the UI, but the underlying register may be writable.
Ventilation
Power & Operating Mode
- ac_power_rw_inf — Ventilation power, displayed as label (RW)
0Off,1On
- sys_ac_power_rw — Ventilation power, displayed as switch (RW)
0Off,1On
- ac_opmode_rw — Operation mode (RW)
0Off,1Heating,2Cooling,3Auto
- sys_ac_opmode_rw — Operation mode (Service level) (RW)
0Off,1Heating,2Cooling,3Auto,4Service
- ac_work_state_ro — Ventilation selected mode (RO)
0Off,1Heat,2Cool,3Auto,4Service
- ac_current_operation_ro — Ventilation current operation (RO)
0Off,1Shift,2Stop,3Start,4Standby,5Ventilation stop,6Ventilation,7Heating,8Cooling,9Hot water,10Legionella,11Cooling + hot water,12Central heating,13Defrost,14Frost secure,15Service,16Alarm,17Heating + hot water
- ac_hp_current_operation_ro — AC HeatPump current operation (RO)
0Off,1Ready,2Hot water start up,3Hot water,4Heating start up,5Heating,6Heat pump stop,7El heating,8El hot water,9Forced cold pump,10Heat Pump Stop,11Defrost,12Air defrost,13Hotgas defrost,14Drip delay,15Hot water - Heat pump stop,16Heating - Heat pump stop,17Stop,18Heating - Heat pump stop,19Hot water - Heat pump stop,20Pump exercise,21Forced start up,22Forced running,23Forced running,24Forced running - heat pump stop,25Manual,26Cooling start,27Cooling,28Ext.Stop,29Forced low speed
Alarms
- ac_alarm_ro — Ventilation active alarm(s) (RO)
0None,1One or more
- ac_alarm_wo — Clear AC alarms (WO)
- sys_fire_alarm_ro — Fire alarm (RO)
0Not activated,1Activated
- sys_fire_alarm_auto_reset_rw — Fire alarm auto reset (RW)
0Off,1HPLP,2Continue,3Self-clear
- ac_heat_pump_high_pressure_alarm_ro — Heat pump high pressure alarm (RO)
0None,1Active
Temperature Sensors
- ac_inner_temp_ro — Room temperature (RO) [ºC]
- ac_target_temp_rw — Room target temperature (RW) [ºC, range: 5–40, step: 0.1]
- ac_incoming_outer_temp_t1_ro — Incoming outer (fresh air) temperature [T1] (RO) [ºC]
- ac_incoming_inner_temp_t2_ro — Incoming inner (supply air) temperature [T2] (RO) [ºC]
- ac_outgoing_inner_temp_t3_ro — Outgoing inner (extract air) temperature [T3] (RO) [ºC]
- ac_outgoing_outer_temp_t4_ro — Outgoing outer (exhaust air) temperature [T4] (RO) [ºC]
- ac_condenser_temp_t5_ro — Condenser temperature [T5] (RO) [ºC]
- ac_evaporator_temp_t6_ro — Evaporator temperature [T6] (RO) [ºC]
- ac_external_room_temp_t10_ro — External room temperature sensor [T10] (RO) [ºC]
- ac_preheater_temp_t17_ro — Preheater temperature [T17] (RO) [ºC]
- ac_prespibe_temp_t18_ro — Pressure pipe temperature [T18] (RO) [ºC]
- ac_ambient_temp_t20_ro — Ambient (outdoor) temperature [T20] (RO)
Air Quality Sensors
- ac_inner_humidity_ro — Relative inner humidity (RO) [%]
- ac_co2_level_ro — CO₂ level (RO) [ppm]
Fan Speed
- ac_fan_speed_rw — Fan speed (RW)
0Off,1Level 1,2Level 2,3Level 3,4Level 4
- ac_supply_fan_speed_rw_inf — Supply fan speed (RW) [%]
- ac_extract_fan_speed_rw_inf — Extract fan speed (RW) [%]
Fan Speed per Level (Service)
- ac_fan_speed_in_1_rw — Inlet fan speed at level 1 (RW) [%, range: 20–100]
- ac_fan_speed_out_1_rw — Outlet fan speed at level 1 (RW) [%, range: 20–100]
- ac_fan_speed_in_2_rw — Inlet fan speed at level 2 (RW) [%, range: 20–100]
- ac_fan_speed_out_2_rw — Outlet fan speed at level 2 (RW) [%, range: 20–100]
- ac_fan_speed_in_3_rw — Inlet fan speed at level 3 (RW) [%, range: 20–100]
- ac_fan_speed_out_3_rw — Outlet fan speed at level 3 (RW) [%, range: 20–100]
- ac_fan_speed_in_4_rw — Inlet fan speed at level 4 (RW) [%, range: 20–100]
- ac_fan_speed_out_4_rw — Outlet fan speed at level 4 (RW) [%, range: 20–100]
Temperature Regulation
- ac_intemp_min_summer_rw — Minimum inlet temperature in summer (RW) [ºC, range: 5–15]
- ac_intemp_min_winter_rw — Minimum inlet temperature in winter (RW) [ºC, range: 5–15]
- ac_temp_regulation_deadband_rw — Temperature regulation deadband (RW) [ºC, range: 0.2–10]
- ac_temp_regulation_deadband_external_rw — Regulation deadband for external room heating (RW) [ºC, range: -5–5]
- sys_sumwin_target_rw — Summer/Winter season changeover target temperature (RW) [ºC, range: 5–30]
Humidity Regulation
- ac_low_humidity_limit_rw — Low humidity limit (RW) [%, range: 15–45]
- ac_low_humidity_fan_speed_rw — Fan speed for low humidity (RW)
0Off,1Level 1,2Level 2,3Level 3
- ac_high_humidity_fan_speed_rw — Fan speed for high humidity (RW)
0Off,2Level 2,3Level 3,4Level 4
- ac_high_humidity_timeout_rw — Timeout for high humidity (RW) [min, range: 0–180]
Active Cooling
- ac_active_cooling_fan_speed_rw — Active cooling fan speed (RW)
0Off,2Level 2,3Level 3,4Level 4
- ac_active_cooling_setpoint_rw — Active cooling setpoint offset (RW)
0Off (No cooling allowed),1Set + 0,2Set + 1,3Set + 2,4Set + 3,5Set + 4,6Set + 5,7Set + 7,8Set + 10
- ac_free_energy_night_cooling_rw_inf — Free energy night cooling room setpoint (RW) [ºC, range: 10–30]
Low Outdoor Temperature
- ac_lowtemp_on_rw — Low fan speed at low outdoor temperature (RW)
0Off,1Level 1,2Level 2,3Level 3
- ac_lowtemp_limit_rw — Activate when outdoor temperature drops below (RW) [ºC, range: -20–10]
Filters
- ac_filter_left_ro — Filter replacement in (RO) [days]
- ac_filter_days_rw — Filter change period (RW)
130 days,290 days,3180 days,4360 days
- sys_ac_filter_days_rw — Filter change period (Service level) (RW)
0Pressure guard (input),130 days,290 days,3180 days,4360 days,570 days and pressure guard
User Programs
- ac_user_prog1_ro — User program 1 (RO)
0Off,1On
- ac_user_prog2_ro — User program 2 (RO)
0Off,1On
Status & Monitoring
- ac_heating_allowed_ro — Heating allowed (RO)
0No,1Yes
- ac_cooling_allowed_ro — Cooling allowed (RO)
0No,1Yes
- ac_bypass_damper_open_ro — Bypass damper state (RO)
0Closed,1Open
- ac_after_heater_rw_inf — After heating element (RW) [%, range: 0–100]
- ac_compressor_state_rw_inf — Compressor state (RW) [range: 0–100]
- ac_defrost_heat_exchanger_ro — Defrost heat exchanger (RO)
0Off,1On
- ac_defrost_heat_pump_rw_inf — Defrost heat pump (RW)
0Off,1On
CO₂ Control
- ac_co2_ventnormal_rw_inf — CO₂ limit for normal ventilation (RW) [ppm]
- ac_co2_venthigh_rw_inf — CO₂ limit for high ventilation (RW) [ppm]
- ac_co2_ventstep_rw — Fan speed level at high CO₂ level (RW)
2Level 2,3Level 3,4Level 4
Air Quality Control (Service)
- ac_air_quality_opmode_rw — Indoor Air Quality (IAQ) control function (RW)
0Off,1Humidity,2Humidity + CO₂
- ac_air_exchange_mode_rw — Air exchange mode (RW)
0Energy,1Comfort,2Water
- ac_low_temp_curve_rw — Low temperature curve (RW) [ºC, range: 15–46, step: 0.1]
- ac_high_temp_curve_rw — High temperature curve (RW) [ºC, range: 39–60, step: 0.1]
- ac_low_temp_comp_start_rw_inf — Low temperature compressor start (RW) [ºC, range: 0–15,
0Off]
Frost Protection & De-icing (Service)
- ac_after_heater_element_type_rw_inf — After heating element type (RW)
0No additional heat,1Electrical,2Electric on binary relays,3Water
- ac_preheater_setpoint_rw_inf — Setpoint for pre-heater [T4] (RW) [ºC, range: 2–12]
- ac_deicing_outdoor_temp_rw_inf — Outdoor temperature for de-icing (RW) [ºC, range: -10–0]
- ac_deicing_max_time_rw_inf — Maximum time de-icing (RW) [min, range: 5–60]
- ac_deicing_min_gap_rw_inf — Minimum time between de-icings (RW) [min, range: 15–720]
- ac_deicing_fan_speed_rw_inf — Fan speed during de-icing (RW)
0Off,1User,2Low
- ac_deicing_hp_evaporator_defrost_time_rw_inf — Evaporator defrost time (RW) [sec, range: 10–30]
- ac_deicing_hp_max_time_rw_inf — Maximum HP de-icing time (RW) [min, range: 2–60]
- ac_deicing_hp_min_gap_rw_inf — Minimum time between HP de-icings (RW) [min, range: 15–720]
Temperature Control (Service)
- ac_heat_souce_select_rw_inf — Heat source select (RW)
0Off,1On
- ac_room_low_tem_rw_inf — Room low temperature (RW) [ºC, range: 1–20,
0Off] - ac_offset_external_heating_rw_inf — Offset external heating (RW) [ºC, range: -5–5]
- ac_preheater_temp_set_rw_inf — Preheater temperature set (RW) [ºC, range: 0–5,
0Off] - ac_controll_temp_sensor_rw — Control temperature sensor (RW)
0User panel,1External sensor,2Inlet channel,3Exhaust channel
Compressor Settings (Service)
- ac_comp_time_between_start_stop_rw_inf — Time between stop and start-up (RW) [min, range: 0–10]
Device Data & Status (Service)
- ac_inlet_temperature_request_ro — Inlet temperature request [T7] setpoint (RO) [ºC]
- ac_act_controlled_temp_ro — Actual value for controlled temperature (RO) [ºC]
- controller_board_temp_ro — Controller board temperature [T0] (RO) [ºC]
- ac_enviroment_pressure_sitch_ro — Environmental pressure switch (RO)
0None,1Yes
- ac_summer_state_ro — Summer state (RO)
0Off,1On
- ac_hot_water_valve_rw — Hot water valve (RW)
0Heating,1Hot water production
- ac_fourway_valve_ro — Four-way valve (RO)
0Open,1Closed
- ac_hp_type_ro — AC Compressor type (RO)
0None,1On/Off,2Modulated hotgas valve
- ac_passive_heat_exchnger_efficiency_ro — Passive heat exchanger efficiency calculation (RO) [%]
Other Service Settings
- ac_heat_select_rw — Air heat source select (RW)
0No heating active,1Heatpump only,2HP + afterheat,3Afterheat only,4Afterheat + HP
- sys_power_saving_rw — Power saving state (RW)
0Off,1On
- sys_user_func1_on_rw_inf — User Function 1 (RW)
0Off,1On
- sys_user_func2_on_rw_inf — User Function 2 (RW)
0Off,1On
- sys_lock_user_settings_rw — Lock user settings (RW)
0Closed,1Open,2No off key
- comp_heater_ro — Compressor heater (RO)
0None,1Yes
- drain_heater_ro — Drain heater (RO)
0None,1Yes
- aux_pump_p2_ro — Aux pump (P2) (RO)
0None,1Yes
Heat Pump System (HPS)
Power & Operating Mode
- hps_power_rw — HPS power (RW)
0Off,1On,2Manual
- hps_opmode_rw — Selected mode (RW)
0Cooling,1Heating,2Auto
Alarms
- hps_active_alarms_ro — Currently active alarm (RO)
0None,1One or more
- hps_reset_alarms_wo — Reset all alarms (WO)
Temperature Sensors
- hps_ground_return_temp_t13_ro — Ground return temperature [T13] (RO) [ºC]
- hps_ground_forward_temp_t14_ro — Ground forward temperature [T14] (RO) [ºC]
- hps_return_temp_t16_ro — Return temperature [T16] (RO) [ºC]
- hps_supply_temp_t17_ro — Supply temperature [T17] (RO) [ºC]
- hps_before_condeser_temp_t16_ro — Before condenser temperature [T15] (RO) [ºC]
- hps_after_condenser_temp_t17_ro — After condenser temperature [T17] (RO) [ºC]
- hps_supply_temp_t14_ro — EK supply temperature [T14] (RO) [ºC]
- hps_return_temp_t13_ro — EK return temperature [T13] (RO) [ºC]
- hps_room_temp_t15_ro — Room temperature [T15] (RO) [ºC]
- hps_temp_t16_ro — AUX temperature (Hotwater anode) [T15] (RO) [ºC]
- hps_temp_t35_ro — Pressure pipe temperature [T35] (RO) [ºC]
- hps_temp_t18_ro — GEO: central heat supply / AIR: buffer tank (RO) [ºC]
- hps_evaporator_temp_ro — Evaporator surface temperature (AIR) (RO) [ºC]
Pressure Sensors
- hps_suction_pressure_ro — Suction pressure (RO) [bar]
- hps_discharge_pressure_ro — Discharge pressure (RO) [bar]
Status & Monitoring
- hps_heating_demand_ro — Heating demand (RO)
0None,1Yes
- hps_cooling_demand_ro — Cooling demand (RO)
0None,1Yes
- hps_compressor_capacity_ro — Compressor capacity (RO) [%]
- hps_sonda_pump_capacity_ro — Sonda circulation pump capacity (RO)
0Off,1Low,2High
- hps_secondary_pump_capacity_rw_inf — Central heat circulation pump capacity (RW) [%]
- hps_heatsource_rw_inf — Source for heating (RW)
0None,1HeatPump,2Electrical,3HeatPump+Electrical,4HeatPump+Electrical
- hps_high_pressure_ro — High pressure status (RO)
0Ok,1Failure
- hps_low_pressure_ro — Low pressure status (RO)
0Ok,1Failure
- hps_allow_heating_ro — Set to allow heating (RO)
0No,1Yes
- hps_allow_cooling_ro — Set to allow cooling (RO)
0No,1Yes
- hps_flow_ro — Flow sensor (AIR) (RO)
0None,1Ok
Heating Settings
- hps_neutral_zone_rw — Heating neutral zone (RW) [ºC, range: 0–15]
- hps_min_supply_temp_rw — Minimum supply temperature (RW) [ºC, range: 0–70]
- hps_max_supply_temp_rw — Maximum supply temperature (RW) [ºC, range: 0–70]
Cooling Settings
- hps_both_heating_cooling_rw — Cooling and heating at the same time (RW)
0Off,1On
- hps_cooling_mode_rw — Cooling mode (RW)
0Off,1Active,2Passive
- hps_cooling_target_temp_rw — Cooling target temperature (RW) [ºC, range: 5–50]
DHW from HPS
- hps_dhw_target_temp_rw — Hotwater target temperature (RW) [ºC, range: 5–70]
Buffer Tank (Service)
- hps_heatsource_rw — Source for heating (RW)
0None,1HeatPump,2Electrical,4HeatPump+Electrical
- hps_es_heating_delay_rw — Electrical supplement heater delay (RW) [min, range: 0–60]
- hps_buffer_max_temp_rw — Maximum buffer temperature (RW) [ºC, range: 30–70]
Heat Pump Settings (Service)
- hps_heating_control_mode_rw_inf — Heat control mode (RW)
0On/Off - return temp,1Modulating - supply temp,2On/Off - water tank,3Modulating - water tank
- hps_comp_stop_time_ro — Minimum compressor stop time (RO) [min, range: 4–45]
- hps_min_on_time_rw_inf — Compressor minimum on time (RW) [sec, range: 0–600]
- hps_comp_pause_when_switching_rw_inf — Compressor pause when switching between hot water and heating (RW)
0No,1Yes
- hps_test_cirk_pump_rw — Test of circulation pump (RW) [days, range: 1–60]
- hps_hp_stop_sensor_rw_inf — Heat pump stop sensor (RW)
0None,1Return,2Supply
- hps_hp_stop_temp_rw_inf — Heat pump stop temperature (RW) [ºC]
- hps_hp_total_stop_sensor_rw_inf — Heat pump total stop sensor (RW)
0None,1Return,2Supply
- hps_hp_total_stop_temp_rw_inf — Heat pump total stop temperature (RW) [ºC, range: 30–90]
- hps_hp_stop_delay_rw_inf — Heat pump stop delay (RW) [sec, range: 0–60]
- hps_hp_start_delay_rw_inf — Heat pump start delay (RW) [sec, range: 15–120]
Heating Regulation (Service)
- hps_max_room_comp_rw_inf — Outdoor temperature compensation (RW) [ºC, range: -45–100]
- hps_heating_stop_cap_rw_inf — Heating stop capacity (RW) [%, range: 0–100]
- hps_heating_start_dif_cap_rw_inf — Heating start differential capacity (RW) [%, range: 0–100]
- hps_reinforcement_rw_inf — Reinforcement (RW) [range: 1–20]
- hps_integration_time_rw_inf — Integration time (RW) [sec, range: 30–600]
- hps_evap_min_temp_rw_inf — Evaporator minimum temperature (RW) [ºC, range: -45–5]
Data & Outputs (Service)
- hps_high_presure_switch_rw_inf — High pressure switch (RW)
- hps_low_presure_switch_rw_inf — Low pressure switch (RW)
- hps_inverter_alarm_rw_inf — Inverter alarm status (RW)
0No alarm,1Alarm still present
- hps_inverter_alarm_switch_ro — Inverter alarm (RO)
- hps_out_comp1_rw_inf — Compressor output (RW)
0Off,1On
- hps_out_heater_rw_inf — Heater output (RW)
0Off,1On
- hps_out_hotwater_rw_inf — Hot tap water output (RW)
0Off,1On
- hps_out_cold_pump_rw_inf — Cold pump (sonda pump) output (RW)
0Off,1On
- hps_out_hotside_pump_rw_inf — Hot side pump output (RW)
0Off,1On
- inf_central_heat_circ_pump_opmode_rw_inf — Central heat circulation pump mode (RW)
0Only when heating is active,1Continuous operation
- sys_central_heat_circ_pump_opmode_rw — Central heat circulation pump mode (Service level) (RW)
0Only when heating is active,1Continuous operation
Domestic Hot Water (DHW)
3-Way Valve
- dhw_3way_mode_rw_inf — 3-way valve mode (RW)
0Heating,1Hot water production
Temperature Sensors
- dhw_tank_top_temp_t11_ro — Tank top temperature [T11] (RO) [ºC]
- dhw_tank_bottom_temp_t12_ro — Tank bottom temperature [T12] (RO) [ºC]
Production
- dhw_target_temp_rw — DHW target temperature (RW) [ºC, range: 10–65]
- dhw_production_for_rw — Hot water for (RW)
0None,1SHW,2DHW
- dhw_neutral_zone_rw — DHW neutral zone (RW) [ºC, range: 0–15]
- dhw_cool_priority_rw — Cooling priority over hot water (RW)
0Off,1On
Status
- dhw_anode_ro — Anode status (RO)
0Off,1Ok,2Service,3Error
- dhw_compressor_level_rw_inf — Compressor capacity (RW) [%, range: 10–100]
- hw_hotwater_source_rw_inf — Hot water source (RW)
0None,1HeatPump,2Electrical,3SolarPanel,4HeatPump+Electrical,5HeatPump+SolarPanel,6Electrical+SolarPanel,7HeatPump+Electrical+SolarPanel,8HeatPump Dual Condenser,9HeatPump+SolarPanel Dual Condenser
Electrical Supplement Heater
- dhw_es_heater_on_rw — Electrical supplement heater state (RW)
0Off,1On
- dhw_es_heater_below_temp_rw — Activate electrical supplement heater below (RW) [ºC, range: 30–65]
Protection
- dhw_scalding_protection_rw — Scalding protection temperature (RW) [ºC, range: 40–80]
Anti-Legionella
- dhw_al_treat_temp_rw — Treatment temperature (RW) [ºC, range: 50–80]
- dhw_al_treat_time_rw — Treatment time (RW) [hours, range: 0–18]
- dhw_al_auto_rw — Anti-legionella schedule (RW)
0Off,1Monday,2Tuesday,3Wednesday,4Thursday,5Friday,6Saturday,7Sunday
Other
- ac_bypass_damper_offset_temp_rw — Bypass damper offset (RW)
0Off, range: 1–30
Solar Hot Water (SHW)
- shw_temp_t21_ro — SHW top temperature [T21] (RO) [ºC]
- shw_temp_t22_ro — SHW bottom temperature [T22] (RO) [ºC]
- shw_anode_ro — SHW anode status (RO)
0Off,1Ok,2Service,3Error
- shw_heater_ro — SHW heater status (RO)
0None,1Yes
Smart Grid
- sys_smart_grid_on_rw — Smart grid state (RW)
0Off,1On
- sys_smart_grid_es_heater_rw — Smart grid hot water (RW)
0Off,1On
- sys_smart_grid_raise_hw_temp_rw — Raise hot water temperature (RW) [ºC, range: 0–10]
- sys_lowprice_es_heater_rw — Smart grid central heating (RW)
0Off,1On
- sys_lowprice_raise_ch_temp_rw — Raise central heating temperature (at low prices) (RW) [ºC, range: 0–10]
- sys_overcapacity_raise_ch_temp_rw — Raise central heating temperature (overcapacity) (RW) [ºC, range: 0–10]
Outdoor Weather Compensation (OWC)
- ac_owc_mode_rw_inf — OWC mode for ventilation (RW)
0Setpoint,1–10Curve 1–10
- sys_ac_owc_mode_rw — OWC mode for ventilation (Service level) (RW)
0Setpoint,1–10Curve 1–10
- hps_owc_mode_rw_inf — OWC mode for HPS (RW)
0Setpoint,1–10Curve 1–10
- owc_temp_m20_rw_inf — Supply temp at -20 ºC outdoor temp (RW) [ºC]
- owc_temp_m10_rw_inf — Supply temp at -10 ºC outdoor temp (RW) [ºC]
- owc_temp_0_rw_inf — Supply temp at 0 ºC outdoor temp (RW) [ºC]
- owc_temp_10_rw_inf — Supply temp at 10 ºC outdoor temp (RW) [ºC]
- owc_temp_20_rw_inf — Supply temp at 20 ºC outdoor temp (RW) [ºC]
- owc_temp_30_rw_inf — Supply temp at 30 ºC outdoor temp (RW) [ºC]
- owc_temp_40_rw_inf — Supply temp at 40 ºC outdoor temp (RW) [ºC]
- owc_curve_offset_rw_inf — Curve offset (RW) [ºC, range: -10–10]
Language
- sys_language_rw_inf — HMI language (RW)
0English,1German,2French,3Swedish,4Danish,5Norwegian,6Suomi,7Cesky,8Polish,9Italiano,10Slovenský,11Lietuviu,12Nederlands,13Espanol,14Romana