Vila Management Commands

Coolhouse On Command

Overview:

The coolhouse on command turns on the coolhouse of your Vila. The system confirms the command execution and reports back the status.

Command Structure:

coolhouse on

Details:

  • The command sends an ON signal to the device that controls your coolhouse.
  • The system responds with the IP address of the device and confirms the successful execution of the command.

Example:

Vila58 command initiated by @Frank.
Please wait for command results ...

Vila58 command executed. Results: Sending on command to device with friendly name containing 'coolhousecontroller' at IP 192.168.1.93
{"POWER":"ON"} Command on sent successfully to device with friendly name containing 'coolhousecontroller'.
Coolhouse Off Command

Overview:

The coolhouse off command turns off the coolhouse of your Vila. The system confirms the command execution and reports back the status.

Command Structure:

coolhouse off

Details:

  • The command sends an OFF signal to the device that controls your coolhouse.
  • The system responds with the IP address of the device and confirms the successful execution of the command.

Example:

Vila58 command initiated by @Frank.
Please wait for command results ...

Vila58 command executed. Results: Sending off command to device with friendly name containing 'coolhousecontroller' at IP 192.168.1.93
{"POWER":"OFF"} Command off sent successfully to device with friendly name containing 'coolhousecontroller'.
Immersion Heater Command Overview
Important Reminder: Before using the immersion heater, ensure that the gas boiler is turned off to avoid conflicts between the two systems.

Immersion Heater Command Overview

The immersionheater command displays the current schedule for heating water in your villa using the immersion heater. The schedule is presented in Tasmota format, which is the open-source firmware used to manage your immersion heater setup. This command allows you to review the heater's timers and settings without making any changes to the configuration.

Command Structure:

immersionheater

Details:

  • When you enter this command, you’ll receive a detailed response that outlines the current immersion heater schedule. This includes the times the heater will turn on or off and the designated days when the heating is scheduled to run. The schedule is controlled using Tasmota timers, and each timer manages different heating periods.

Timers:

  • Enable: Indicates whether the timer is active (1 means enabled).
  • Mode: Defines the timer mode (commonly 0 for time-based operation).
  • Time: Specifies the time the heater will turn on or off (in HH:MM format).
  • Days: Specifies the days the heater operates (e.g., "1111111" means it operates every day of the week).
  • Repeat: If set to 1, the timer will repeat the action as scheduled.
  • Output: Determines the device output that the timer controls (this typically represents the immersion heater).
  • Action: Specifies the action to take at the scheduled time (1 for turning on the heater, 0 for turning it off).

Example Breakdown:

Timer1:
Time: 11:30
Action: 1 (Turn on)
Output: 1 (Controls the immersion heater)
Days: 1111111 (Runs every day at 11:30)

Timer2:
Time: 13:30
Action: 0 (Turn off)
Output: 1 (Turns off the immersion heater at 13:30)

Schedule Variations:

  • For villas with photovoltaic systems, the immersion heater runs from 11:30 to 13:30 daily, maximizing solar energy usage.
  • For villas without photovoltaic systems, the immersion heater operates from 5:00 AM to 7:00 AM, taking advantage of off-peak electricity rates.

Summary of Schedule:

  • The immersion heater turns on at the designated times based on the villa’s setup (with or without photovoltaic).
  • It turns off after the heating period, ensuring efficient and scheduled heating.
Immersion Heater Command Overview
Important Reminder: Before using the immersion heater, ensure that the gas boiler is turned off to avoid conflicts between the two systems.

Immersion Heater Command Overview

The immersionheater on command activates the immersion heater immediately, overriding any existing schedule. This command is useful when you need to heat water outside of the regular schedule.

Command Structure:

immersionheater on

Details:

  • When you enter this command, the immersion heater will turn on immediately and remain on until manually turned off or until the next scheduled off time.

Usage Tips:

  • Use this command when you need hot water outside of the regular schedule.
  • Remember to turn off the immersion heater manually if you do not want it to run until the next scheduled off time.
Immersion Heater Command Overview
Important Reminder: Before using the immersion heater, ensure that the gas boiler is turned off to avoid conflicts between the two systems.

Immersion Heater Command Overview

The immersionheater off command deactivates the immersion heater immediately, overriding any existing schedule. This command is useful when you need to stop heating water outside of the regular schedule.

Command Structure:

immersionheater off

Details:

  • When you enter this command, the immersion heater will turn off immediately and remain off until manually turned on or until the next scheduled on time.

Usage Tips:

  • Use this command when you need to stop heating water outside of the regular schedule.
  • Remember to turn the immersion heater back on manually if you need it to run before the next scheduled on time.
Immersion Heater Command Overview
Important Reminder: Before using the immersion heater, ensure that the gas boiler is turned off to avoid conflicts between the two systems.

Immersion Heater Command Overview

The immersionheater enable command activates the immersion heater schedule, allowing it to follow the predefined heating times. This command is useful when you want to resume the regular heating schedule after it has been disabled.

Command Structure:

immersionheater enable

Details:

  • When you enter this command, the immersion heater will follow the predefined schedule, turning on and off at the specified times.

Usage Tips:

  • Use this command to resume the regular heating schedule after it has been manually disabled.
  • Ensure that the schedule is correctly set up to match your heating needs.
Immersion Heater Command Overview
Important Reminder: Before using the immersion heater, ensure that the gas boiler is turned off to avoid conflicts between the two systems.

Immersion Heater Command Overview

The immersionheater disable command deactivates the immersion heater schedule, preventing it from following the predefined heating times. This command is useful when you want to stop the regular heating schedule temporarily.

Command Structure:

immersionheater disable

Details:

  • When you enter this command, the immersion heater will not follow the predefined schedule until it is enabled again.

Usage Tips:

  • Use this command to temporarily stop the regular heating schedule.
  • Ensure to enable the schedule again when you need the immersion heater to follow the predefined times.

Pool Commands

Poolpump Command
Note: This command only works on your system if your pump has been "smartified" with an EcoTouchController.

Overview:

The poolpump command is designed to show the monthly schedule for how long the pool pump will run. This schedule is automatically adjusted by the system to optimize energy usage while maintaining the pool's condition.

Command Structure:

poolpump

Details:

  • The command displays the pool pump's schedule for the current month, which varies depending on the time of year.
  • It does not change the schedule but simply displays the pre-programmed running times.
  • The Raspberry Pi automatically adjusts the pump's runtime each month based on the schedule.

Monthly Schedule Breakdown:

  • Winter Months (January, February, December): The pool pump runs for 2 hours to reduce energy consumption while maintaining minimal circulation.
  • Early Spring and Late Autumn (March, November): The pump operates for 4 hours as temperatures increase slightly.
  • Spring (April): The pump runs for 5 hours to prepare the pool for increased use as the weather warms.
  • Late Spring and Early Autumn (May, October): The pump runs for 7 hours to maintain regular water circulation.
  • Summer Peak (June, September): The pump operates for 9 hours to handle the increased heat and pool use.
  • Hottest Months (July, August): The pump runs for 10 hours due to the high temperatures and pool activity.

Example:

Vila58: The poolpump controlled by Iobroker (Dynamic Monthly Schedule)
Jan, Feb, Dec - 2 hours
March, Nov - 4 hours
Apr - 5 hours
May, Oct - 7 hours
Jun, Sep - 9 hours
Jul, Aug - 10 hours
Poolpump On Command
Note: This command only works on your system if your pump has been "smartified" with an EcoTouchController.

Overview:

The poolpump on command turns the pool pump on immediately, overriding any inactive state.

Command Structure:

poolpump on

Details:

  • This command will start the pool pump immediately, even if it was previously off.
  • If a schedule is active, the pump will follow the schedule once turned on.
  • If the schedule is disabled, the pump will operate manually and will not adhere to a schedule until it is re-enabled.
  • This is particularly useful when manually initiating the pump for cleaning, maintenance purposes, or if you need to heat up your pool as fast as possible.

Example:

Vila58 command initiated by @Frank.
Please wait for command results ...

Vila58 command executed. Results: Sending on command to device with friendly name containing 'poolpump' at IP 192.168.1.244
{"POWER":"ON"} Command on sent successfully to device with friendly name containing 'poolpump'.

Vila58 command executed. Results: Sending on command to device with friendly name containing 'baduecotouch' at IP 192.168.1.238
{"POWER1":"ON"} Command on sent successfully to device with friendly name containing 'baduecotouch'.

Vila58 PoolPump_DynamicMonthlyRuntime: Priming Mode activated (POWER1) - 25 minutes check configured

Starting/Stopping Salt Cell now ... sonoff.0.POOLSALTCELL-SO-BS-1234.POWER Powerstate true

Vila58: Pump power state changed to ON
Poolpump Off Command
Note: This command only works on your system if your pump has been "smartified" with an EcoTouchController.

Overview:

The poolpump off command turns the pool pump off immediately. It stops the pump from operating, even if there's an active schedule.

Command Structure:

poolpump off

Details:

  • This command will stop the pool pump immediately.
  • If the pool pump is running based on a schedule, this command will override the schedule and turn the pump off.
  • If the schedule is disabled, the pump will halt its operation and remain off until the schedule is re-enabled.
  • The pump will remain off until the schedule is re-enabled or a new command is issued to turn it on.

Example:

Vila58 command initiated by @Frank.
Please wait for command results ...

Vila58 command executed. Results: Sending off command to device with friendly name containing 'baduecotouch' at IP 192.168.1.238
{"POWER1":"OFF"} Command off sent successfully to device with friendly name containing 'baduecotouch'.

Starting/Stopping Salt Cell now ... sonoff.0.POOLSALTCELL-SO-BS-1234.POWER Powerstate false

Vila58: Pump power state changed to OFF
Poolpump Enable Command
Note: This command only works on your system if your pump has been "smartified" with an EcoTouchController.

Overview:

The poolpump enable command activates the pool pump schedule, making the pump operate according to the pre-set timings.

Command Structure:

poolpump enable

Details:

  • This command activates the pool pump schedule, ensuring the pump operates as per the set timings.

Example:

Vila58 Pool pump dynamic monthly runtime enabled by @Frank.

Vila58 PoolPump_DynamicMonthlyRuntime (Version 1.13) initialized!

Vila58 Speck Badu Eco Touch with wired connection installed.

Vila58 Salt Cell installed. sonoff.0.POOLSALTCELL-SO-BS-1234.POWER
Poolpump Disable Command
Note: This command only works on your system if your pump has been "smartified" with an EcoTouchController.

Overview:

The poolpump disable command deactivates the pool pump schedule, ensuring the pump remains off until re-enabled.

Command Structure:

poolpump disable

Details:

  • This command deactivates the pool pump schedule, preventing the pump from operating according to the set timings.
  • If the schedule is disabled, the pump will halt its operation and remain off until the schedule is re-enabled.

Example:

Vila58 command initiated by @Frank.

Vila58 command executed. Results: Pool pump schedule disabled successfully.
Poolpump Low Energy Command
Note: This command is only available if you are using a "Speck BaduEcoTouch" pump at your Vila. Running the pump in low-energy mode during normal filtration hours significantly reduces energy costs. The flow rate is calibrated to your pool size and installed heater.

Important: This command only works on your system if your pump has been "smartified" with an EcoTouchController.

Overview:

The poolpump lowenergy command configures the pool pump to run in low energy mode, reducing operational costs while maintaining adequate water circulation and filtration.

Command Structure:

poolpump lowenergy

Details:

  • This command sets the pool pump to operate in an energy-saving mode after running for 10 minutes in normal mode.
  • It ensures lower energy consumption, ideal for maintaining the pool in low-occupancy periods.
  • The pump will continue in low-energy mode unless manually adjusted or if high-occupancy conditions demand more power.
  • It significantly reduces operational costs during normal filter hours, making it more efficient for long-term usage.

Example:

Vila58 command initiated by @Frank.
Please wait for command results ...

Vila58 command executed. Results: Sending lowenergy command to device with friendly name containing 'baduecotouch' at IP 192.168.1.238.
{"Mem1":"1"} Command lowenergy sent successfully to device with friendly name containing 'baduecotouch'.

Vila58: New pump mode (mem1): 1 (Low Energy).
Vila58 PoolPump_DynamicMonthlyRuntime: Low Energy Mode activated (POWER3).
Poolpump High Occupancy Command
Note: This command is only available if you are using a "Speck BaduEcoTouch" pump at your Vila. The pump should operate in high occupancy mode when there is a need for a higher flow rate, such as during pool treatments. This mode helps maintain optimal performance while still reducing running costs compared to traditional pumps.

Important: This command only works on your system if your pump has been "smartified" with an EcoTouchController.

Overview:

The poolpump highoccupancy command switches the pool pump to a higher speed to accommodate increased usage during peak times.

Command Structure:

poolpump highoccupancy

Details:

  • This command increases the pump’s speed for high usage periods, ensuring adequate water circulation during busy times, such as summer days.
  • After running at higher speed for 10 minutes, the pump will not revert to low energy mode unless manually adjusted.
  • This mode is essential for special situations requiring a higher flow rate, such as during pool treatments.
  • The flow rate is increased while still offering a significant reduction in operating costs compared to traditional pumps.

Example:

Vila58 command initiated by @Frank.
Please wait for command results ...

Vila58 command executed. Results: Sending highoccupancy command to device with friendly name containing 'baduecotouch' at IP 192.168.1.238.
{"Mem1":"2"} Command highoccupancy sent successfully to device with friendly name containing 'baduecotouch'.

Vila58: New pump mode (mem1): 2 (High Occupancy).
Poolheater On Command
Note: This command is only available if your heater has been "smartified." Please ensure the heater is compatible with your system.

Overview:

The poolheater on command turns on the pool heater, allowing it to maintain the desired water temperature in the pool.

Command Structure:

poolheater on

Details:

  • This command activates the pool heater, which will start heating the pool as long as the pool pump is running.
  • The heater ensures that the water temperature is maintained according to your set preferences.
  • Heating will pause automatically once the target temperature is reached or if the heater is turned off.

Example:

Vila58 command initiated by @Frank.
Please wait for command results ...

Vila58 command executed. Results: Sending on command to device with friendly name containing 'poolheater' at IP 192.168.1.97.
{"POWER1":"ON"} Command on sent successfully to device with friendly name containing 'poolheater'.

Vila58: Pool heater turned on successfully.
Poolheater Off Command
Note: This command is only available if your heater has been "smartified." Please ensure the heater is compatible with your system.

Overview:

The poolheater off command turns off the pool heater, stopping any heating processes.

Command Structure:

poolheater off

Details:

  • This command stops the pool heater immediately.
  • The heater will remain off until you manually turn it back on.
  • This command is useful for stopping the heating process when it's not needed.

Example:

Vila58 command initiated by @Frank.
Please wait for command results ...

Vila58: Pool heater turned off.
Vila58 command executed. Results: Sending off command to device with friendly name containing 'poolheater' at IP 192.168.1.97.
{"POWER1":"OFF"} Command off sent successfully to device with friendly name containing 'poolheater'.

Irrigation Commands

Irrigation Schedule Command

Overview:

The irrigationschedule command displays the current watering schedule configured in your water management system. The schedule is presented in Tasmota format, an open-source firmware for ESP devices used to control your smart irrigation setup. It allows you to review the irrigation timers and settings without making any changes.

Command Structure:

irrigationschedule

Details:

  • Upon entering this command, you’ll receive a detailed response outlining the current irrigation schedule, including specific times, durations for each watering session, and the designated days for irrigation.
  • The irrigation schedule is controlled using Tasmota timers. Each timer manages different irrigation zones.

Timers:

Here’s how to interpret the timer information:

  • Enable: Indicates if the timer is active (1 means enabled).
  • Mode: Defines the timer mode (commonly 0 for time-based operation).
  • Time: Specifies when the timer action will execute (in HH:MM format).
  • Days: Indicates the days the timer runs ("1111111" means every day of the week).
  • Repeat: If set to 1, the timer will repeat as scheduled.
  • Output: Determines the device output that the timer controls (could represent different irrigation zones).
  • Action: Indicates the action to take (1 for turning on, 0 for turning off).

Example Breakdown:

Timer1:
Time: 08:00
Action: 1 (Turn on)
Output: 1 (First irrigation zone)
Runs every day at 08:00.

Timer2:
Time: 08:05
Action: 0 (Turn off)
Output: 1 (Turns off the first irrigation zone).

Timer3:
Time: 08:05
Action: 1 (Turn on)
Output: 2 (Second irrigation zone)
Starts the second irrigation zone at 08:05.

Timer4:
Time: 08:10
Action: 0 (Turn off)
Output: 2 (Turns off the second irrigation zone).

Note: Timers 7 through 16 are set to 00:00, indicating that they may be unused or scheduled for future changes.

Summary of Schedule:

  • Irrigation starts at 08:00 for zone 1 and turns off at 08:05.
  • Zone 2 turns on at 08:05 and off at 08:10.
  • Zone 3 turns on at 08:10 and off at 08:12.
Irrigation Enable Command

Overview:

The irrigation enable command activates the Tasmota-based irrigation schedule, ensuring your system follows the defined watering plan. This command is essential for starting the automated schedule after configuration.

Command Structure:

irrigation enable

Details:

  • If the irrigation schedule has been defined but not yet activated, this command will turn it on.
  • Using this command will initiate the irrigation system to follow the predefined schedule, watering the zones as specified.
  • This is useful if the system was previously turned off or not in operation.
Irrigation Disable Command

Overview:

The irrigation disable command temporarily disables the active Tasmota-based irrigation schedule without deleting it from the system. This provides flexibility to pause watering when necessary.

Command Structure:

irrigation disable

Details:

  • When this command is issued, the irrigation system will stop following the preset watering schedule.
  • If a watering cycle is currently in progress, it will be halted immediately.
  • This is useful for temporarily pausing irrigation due to weather changes, maintenance, watering restrictions, or other needs.
  • The stored schedule remains intact and can be reactivated at any time without the need to reconfigure the system.
Irrigation Schedule Command

Overview:

The setirrigationschedule command allows you to create a custom irrigation schedule using the remote control interface. This enables you to define the start time, watering duration for each zone, and the days on which the irrigation system should operate.

Command Structure:

setirrigationschedule <time>;[<duration1>,<duration2>,...]; <days>

Details:

  • <time>: The start time for irrigation (in 24-hour format). For example, 22:00 sets irrigation to begin at 10:00 PM.
  • [<duration1>,<duration2>,...]: A list of durations (8 , 16 or 24 depending on your irrigation system) in minutes for each zone. Example: [1,1,1,1,1,1,1,1] means each zone will receive 1 minute of water.
  • <days>: Specifies the days of the week for irrigation. Use letters to represent the days:
    • S (Sunday)
    • M (Monday)
    • T (Tuesday)
    • W (Wednesday)
    • T (Thursday)
    • F (Friday)
    • S (Saturday)
    Example: SMTWTFS runs the schedule every day of the week.

General Commands

Help Command

Overview:

The help command displays a help message with information on all available commands.

Command Structure:

help

Details:

Typing help will provide a list of all commands you can use. It will include each command’s name and a brief description of its function. This is useful for a quick reference or if you need to know what commands are available and what they do.

Example Output:

Vila58: Command and information instructions

Usage options:

  help  
  -> print this message.
  
  status  
  -> executes a ping_monitor to list the 
     status of your entire vila.

  irrigation
  -> prints the currently defined 
     Tasmota-based irrigation schedule
     
  irrigation enable
  -> enables the currently defined 
     Tasmota-based irrigation schedule.

  irrigation disable
  -> disables the currently defined 
     Tasmota-based irrigation schedule.
     An active irrigation cycle will 
     be stopped immediately.

  poolpump
  -> prints the currently defined 
     Pi/Iobroker poolpump schedule
 
  poolpump on
  -> turns on the pool pump.
     If the currently defined 
     Pi/Iobroker poolpump schedule
     is enabled, the pump will be turned 
     off according to the schedule.

  poolpump off
  -> turns off the pool pump.
     If the currently defined 
     Pi/Iobroker poolpump schedule
     is enabled, the pump will be turned 
     on according to the schedule.

  poolpump enable
  -> enables the currently defined 
     Pi/Iobroker poolpump schedule
     If the pump is running, it will 
     continue to do so.

  poolpump disable
  -> disables the currently defined 
     Pi/Iobroker poolpump schedule
     If the pump is OFF, it will stay 
     off until the schedule is enabled 
     again.

  poolpump lowenergy
  -> puts the pump into the low energy
     mode to maximize the energy 
     savings. This is the default
     operational mode after 10 minutes
     priming and another 10 minutes 
     in higher occupancy mode
     
  poolpump highoccupancy
  -> puts the pump into a higher speed
     to support high occupancy situations
     of the pool during summer. This is the 
     exception in rare situations. After 
     priming for 10 minutes, the pump will
     not switch into low energy mode 

  poolheater on
  -> turns on the pool heater.
     The pool heater will be switched on
     and will start heating up the
     pool if the pool pump is running

  poolheater off
  -> turns off the pool heater.
     The pool heater will be permanently
     switched off
Status Command

Overview:

The status command performs a system-wide check and shows the status of all connected systems.

Command Structure:

status

Details:

The status command runs a diagnostic check (also referred to as Hourly Report) to assess the health and connectivity of all systems integrated into your villa. It provides a summary of whether each system is online and functioning correctly, helping you quickly determine if everything is working as expected or if there are issues that need attention.

Speedtest Command

Overview:

The speedtest command performs a network speed test using the Ookla Speedtest API. The command measures download and upload speeds, along with latency and packet loss. The results include details about the ISP, server location, and a URL to view the test results online.

Command Structure:

speedtest

Details:

  • ISP: Displays the Internet Service Provider (ISP) used during the test.
  • Latency: The time it takes for data to travel between the user and the server, measured in milliseconds (ms). Includes jitter and latency range (low to high).
  • Download Speed: The speed at which data is received from the internet, measured in megabits per second (Mbps).
  • Upload Speed: The speed at which data is sent to the internet, measured in Mbps.
  • Packet Loss: The percentage of data packets lost during transmission.
  • Result URL: A link to view the full test results on the Speedtest website.

Example:

Vila58 speedtest executed. Results:
Speedtest by Ookla

Server: MEO - Lisboa (id: 31309)
ISP: MEO
Idle Latency: 5.96 ms (jitter: 0.08ms, low: 5.85ms, high: 6.02ms)
Download: 929.44 Mbps (data used: 637.9 MB)
      15.47 ms (jitter: 4.71ms, low: 6.96ms, high: 216.72ms)
Upload: 429.41 Mbps (data used: 463.1 MB)
      7.97 ms (jitter: 3.38ms, low: 5.20ms, high: 229.83ms)
Packet Loss: 0.0%
Result URL: View Results
Send Owner's Report Command

Overview:

The sendownersreport command allows the user to forward the detailed morning report to the designated email address. This report includes system updates, operational data, and other relevant information for the system owner.

Command Structure:

sendownersreport <email>

Details:

  • <email>: The recipient's email address. This should be the owner's or another designated contact's email.
  • The command forwards the detailed morning report to the provided email address.
  • Important: When using the command via Telegram, replace the @ symbol in the email address with a # symbol, as Telegram does not accept the @ symbol in commands.

Example:

Vila58 Sending owner's report to: frank@schreiber.co.nz