Variables
API - variables This page serves as a reference manual for all CTS700 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) 0 Off, 1 On sys_ac_power_rw — Ventilation power, displayed as switch (RW) 0 Off, 1 On ac_opmode_rw — Operation mode (RW) 0 Auto, 1 Heating, 2 Cooling sys_ac_opmode_rw — Operation mode (Service level) (RW) 0 Auto, 1 Heating, 2 Cooling ac_work_state_ro — Ventilation selected mode (RO) 0 Auto, 1 Cooling, 2 Heating Alarms ac_alarm_ro — Ventilation active alarm(s) (RO) 0 Active, 1 Not active sys_fire_alarm_ro — Fire alarm (RO) 0 Activated, 1 Not activated sys_fire_alarm_auto_reset_rw — Fire alarm auto reset (RW) 0 Off, 1 On ac_heat_pump_high_pressure_alarm_ro — Heat pump high pressure alarm (RO) 0 Off, 1 On 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] 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) 101 Level 1, 102 Level 2, 103 Level 3, 104 Level 4 ac_fan_pause_rw — Fans pausing state (RW) 0 Resume, 1 Pause ac_supply_fan_speed_rw_inf — Supply fan speed (RO) [%] ac_extract_fan_speed_rw_inf — Extract fan speed (RO) [%] 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_after_heater_min_temp_rw — Minimum supply air temperature (RW) [ºC, range: 5–30] ac_after_heater_max_temp_rw — Maximum supply air temperature (RW) [ºC, range: 5–30] 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–10] ac_temp_regulation_deadband_external_rw — Regulation deadband for external room heating (RW) [ºC, range: 0–10] sys_sumwin_target_rw — Summer/Winter season changeover target temperature (RW) [ºC, range: 5–30] sys_sumwin_offset_rw — Summer/Winter season changeover offset (RW) [ºC, range: 0–10] 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) 101 Level 1, 102 Level 2, 103 Level 3 ac_high_humidity_fan_speed_rw — Fan speed for high humidity (RW) 102 Level 2, 103 Level 3, 104 Level 4 ac_high_humidity_timeout_rw — Timeout for high humidity (RW) [min, range: 0–180] Active Cooling ac_active_cooling_on_rw — Active cooling enabled (RW) 0 Off, 1 On ac_active_cooling_fan_on_rw — Active cooling fan enabled (RW) 0 Off, 1 On ac_active_cooling_fan_speed_rw — Active cooling fan speed (RW) 103 Level 3, 104 Level 4 ac_active_cooling_min_temp_rw — Minimum cooling supply temperature (RW) [ºC, range: 5–30] ac_free_energy_night_cooling_rw_inf — Free energy night cooling (RO) 0 No, 1 Yes Low Outdoor Temperature ac_lowtemp_on_rw — Low fan speed at low outdoor temperature (RW) 0 Off, 1 On ac_lowtemp_fan_speed_rw — Fan speed at low outdoor temperature (RW) 101 Level 1, 102 Level 2 ac_lowtemp_limit_rw — Activate when outdoor temperature drops below (RW) [ºC, range: -20–10] Filters ac_inlet_filter_left_ro — Inlet filter replacement in (RO) [days] ac_outlet_filter_left_ro — Outlet filter replacement in (RO) [days] ac_inlet_filter_reset_wo — Reset inlet filter replace period (WO) ac_outlet_filter_reset_wo — Reset outlet filter replace period (WO) ac_inlet_filter_days_rw — Inlet filter change period (RW) [days, range: 30–180] ac_outlet_filter_days_rw — Outlet filter change period (RW) [days, range: 30–180] User Programs ac_user_prog1_ro — User program 1 (RO) 0 Off, 1 On ac_user_prog2_ro — User program 2 (RO) 0 Off, 1 On Status & Monitoring ac_heating_allowed_ro — Heating allowed (RO) 0 No, 1 Yes ac_cooling_allowed_ro — Cooling allowed (RO) 0 No, 1 Yes ac_bypass_damper_open_ro — Bypass damper state (RO) 0 Closed, 1 Open ac_after_heater_rw_inf — After heating element (RO) [%] ac_compressor_state_rw_inf — Compressor state (RO) 0 Off, 100 On ac_defrost_heat_exchanger_ro — Defrost heat exchanger (RO) 0 Off, 100 On ac_defrost_heat_pump_rw_inf — Defrost heat pump (RO) 0 Off, 100 On ac_supplement_heater_on_ro — Supplement heater (RO) 0 Off, 1 On CO₂ Control ac_co2_fan2_ro — Activate fan speed 2 at CO₂ level (RO) [ppm] ac_co2_fan3_ro — Activate fan speed 3 at CO₂ level (RO) [ppm] ac_co2_fan4_ro — Activate fan speed 4 at CO₂ level (RO) [ppm] Frost Protection & De-icing (Service) ac_after_heater_element_type_rw_inf — After heating element type (RW) 0 None, 1 Water, 2 Electrical ac_frost_protection_ro — Frost protection type (RO) 0 None, 1 External/Polar, 2 EHD, 3 BAH ac_frost_protection_temp_t8_rw_inf — T8 temperature sensor (RW) 0 Off, 1 On ac_frost_protection_start_below_rw_inf — Frost protection starts below (RW) [ºC] ac_preheater_setpoint_rw_inf — Setpoint for pre-heater [T4] (RW) [ºC] ac_ehd_offset_rw_inf — EHD offset (RW) [ºC] ac_ehd_hold_time_rw_inf — EHD hold time (RW) [min] ac_ehd_stabilisation_rw_inf — EHD stabilisation (RW) [min] ac_bah_below_rw_inf — BAH below temperature (RW) [ºC] ac_bah_above_rw_inf — BAH above temperature (RW) [ºC] ac_bah_deadband_rw_inf — BAH regulation deadband (RW) [ºC] ac_deicing_outdoor_temp_rw_inf — Outdoor temperature for de-icing (RW) [ºC] ac_deicing_max_time_rw_inf — Maximum time de-icing (RW) [min] ac_deicing_min_gap_rw_inf — Minimum time between de-icings (RW) [min] ac_deicing_infan_speed_rw_inf — Supply fan speed during de-icing (RW) 0 Normal, 1 Extract ac_deicing_outfan_speed_ro — Extract fan speed during de-icing (RO) ac_deicing_hp_evaporator_defrost_rw_inf — Evaporator defrost [T6] (RW) 0 Off, 1 On ac_deicing_hp_max_time_rw_inf — Maximum HP de-icing time (RW) [min] ac_deicing_hp_min_gap_rw_inf — Minimum time between HP de-icings (RW) [min] ac_deicing_hp_start_rw_inf — Start de-icing temperature (RW) [ºC] ac_deicing_hp_stop_rw_inf — Stop de-icing temperature (RW) [ºC] Compressor Settings (Service) ac_comp_time_between_start_rw_inf — Minimum time between start-ups (RW) ac_comp_time_between_start_stop_rw_inf — Time between stop and start-up (RW) [min] Device Data & Status (Service) ac_heating_or_cooling_blocked_ro — Heating or cooling blocked (RO) ac_bah_brine_pressostat_ro — BAH brine pressostat (RO) ac_sys_heat_valve_ro — Heat valve (RO) ac_hot_water_valve_rw — Hot water valve (RO) 0 Heating, 1 Hot water production ac_fourway_valve_ro — Four-way valve (RO) 0 Open, 1 Closed hw_warm_water_anode_2_ro — Warm water anode status (RO) Other Service Settings sys_user_func2_on_rw_inf — User Function 2 (RO) 0 Off, 1 On sys_lock_user_settings_rw — Lock user settings (RW) 0 Off, 1 On Heat Pump System (HPS) Power & Operating Mode hps_power_rw — HPS power (RW) 0 Off, 1 On hps_opmode_rw — Selected mode (RW) 0 Auto, 1 Cooling, 2 Heating Alarms hps_active_alarms_ro — Currently active alarm (RO) 0 None, 1 One 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_before_condeser_temp_t16_ro — Before condenser temperature [T15] (RO) [ºC] hps_after_condenser_temp_t17_ro — After condenser temperature [T17] (RO) [ºC] hps_temp_t18_ro — GEO: central heat supply / AIR: buffer tank (RO) [ºC] Status & Monitoring hps_heating_demand_ro — Heating demand (RO) 0 None, 1 Yes hps_cooling_demand_ro — Cooling demand (RO) 0 None, 1 Yes hps_compressor_capacity_ro — Compressor capacity (RO) [%] hps_sonda_pump_capacity_ro — Sonda circulation pump capacity (RO) hps_secondary_pump_capacity_rw_inf — Central heat circulation pump capacity (RO) [%] hps_cooling_pressure_ro — Cooling pressure (RO) [bar] hps_high_pressure_ro — High pressure status (RO) 0 Failure, 1 Ok hps_low_pressure_ro — Low pressure status (RO) 0 Failure, 1 Ok hps_brine_pressure_ro — Sonda pressure (RO) [bar] hps_flow_ro — Flow sensor (AIR) (RO) 0 None, 1 Ok Heating Settings hps_heating_pause_rw — Heating pause (RW) 0 Off, 1 On hps_heating_pause_days_rw — Pause heating for (RW) [days, range: 1–180] hps_forward_target_temp_rw — Forward target temperature (RW) [ºC, range: 5–50] hps_temp_regulation_deadband_rw — Temperature regulation deadband (RW) [ºC, range: 0–5] hps_max_supply_temp_rw — Maximum supply temperature (RW) [ºC, range: 20–55] Cooling Settings hps_both_heating_cooling_rw — Cooling and heating at the same time (RW) 0 Off, 1 On hps_passive_cooling_rw — Passive cooling (RW) 0 Off, 1 On hps_cooling_target_temp_rw — Cooling target temperature (RW) [ºC, range: 5–25] Buffer Tank (Service) hps_es_heating_rw — Electrical supplement heating (RW) 0 Off, 1 On hps_es_heating_delay_rw — Electrical supplement heater delay (RW) [min, range: 0–60] hps_buffer_min_temp_rw — Minimum buffer temperature (RW) [ºC, range: 10–50] hps_buffer_max_temp_rw — Maximum buffer temperature (RW) [ºC, range: 20–50] Domestic Hot Water (DHW) 3-Way Valve dhw_3way_mode_rw_inf — 3-way valve mode (RO) 0 Heating, 1 Hot 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–60] dhw_production_for_rw — Hot water for (RW) 0 None, 1 SHW, 2 DHW dhw_pause_rw — DHW production pause (RW) 0 Resume, 1 Pause dhw_pause_duration_rw — DHW production pause duration (RW) [days, range: 1–180] dhw_cool_priority_rw — Cooling priority over hot water (RW) 0 Off, 1 On Status dhw_anode_ro — Anode status (RO) 1 Ok, 3 Failure dhw_compressor_level_rw_inf — Compressor capacity (RW) [%] hw_hotwater_source_rw_inf — Hot water source (RO) 0 Heating, 1 Hot water production Electrical Supplement Heater dhw_es_heater_on_rw — Electrical supplement heater state (RW) 0 Off, 1 On dhw_es_heater_below_temp_rw — Activate electrical supplement heater below (RW) [ºC, range: 30–65] Protection dhw_tank_frost_protection_rw — Frost protection of HW tank (RW) 0 Off, 1 On dhw_scalding_protection_rw — Scalding protection temperature (RW) [ºC, range: 40–80] Anti-Legionella dhw_al_on_ro — Anti-legionella status (RO) 0 Off, 1 On dhw_al_day_rw — Schedule in each month for the day (RW) [range: 1–28] dhw_al_time_rw — Schedule for hour (RW) [o’clock, range: 0–23] dhw_al_man_on_rw — Start anti-legionella manually (RW) 0 Off, 1 On dhw_al_auto_rw — Anti-legionella schedule (RW) 0 Off, 1 Weekly, 2 Monthly Other ac_bypass_damper_offset_temp_rw — Bypass damper offset (RW) [ºC, range: 0–10] 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) 1 Ok, 3 Failure Smart Grid sys_smart_grid_on_rw — Smart grid state (RW) 0 Off, 1 On sys_smart_grid_es_heater_rw — Smart grid hot water (RW) 0 Off, 1 On 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) 0 Off, 1 On 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) 0 Setpoint, 1 Curve sys_ac_owc_mode_rw — OWC mode for ventilation (Service level) (RW) 0 Setpoint, 1 Curve 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_curve_offset_rw_inf — Curve offset (RW) [ºC] Language sys_language_rw_inf — HMI language (RW) 0 EN, 32 DA, 33 DE, 44 FI, 47 FR, 72 IT, 117 NO, 128 PL
