Vila Remote Control Interface via Telegram

This user manual provides instructions on how to interact with your vila's management system via Telegram. By entering specific commands, you can easily manage various systems, such as irrigation, pool pump, and pool heater.

How It Works:      

  1. Type a Command: Enter a command (e.g., status, irrigation enable, poolpump on) in the Telegram chat with your Villa.
    2.        
  2. Vila's Response: The vila's management system will recognize the command and execute the corresponding function.
    3.        
  3. Receive Information or Action: The mangement system will either provide information (e.g., the current irrigation schedule) or perform an action (e.g., turning on the pool pump) and gives the appropriate feedback

Usage Options and Commands

 help

  • What It Does: Displays a help message with information on all available commands.
  • 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.    

status

         
  • What It Does: Performs a system-wide check and shows the status of all connected systems.
  • Details: The status command runs a diagnostic check (often referred to as ping_monitor) 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.
 

Irrigation

Irrigation Commands

   

irrigation

  • What It Does: This command shows you the current irrigation schedule that has been set up using Tasmota. Tasmota is a firmware used to manage smart irrigation systems.
  • Details: When you enter this command, the bot will respond with the details of the irrigation schedule, including the times and durations for each watering session and the days of the week when irrigation is set to occur. This helps you check or review the existing setup without making any changes.             

irrigation enable

  • What It Does: This command activates the Tasmota-based irrigation schedule.
  • Details: If the irrigation schedule has been defined but not yet activated, using this command will turn it on. This means the irrigation system will start following the defined schedule, watering the zones as specified. If the irrigation system was previously turned off or not in operation, this command will initiate it according to the set schedule.                  

irrigation disable

  • What It Does: This command deactivates the Tasmota-based irrigation schedule.
  • Details: When you use this command, the irrigation system will stop following the defined schedule. If an irrigation cycle is currently running when you issue this command, the system will immediately stop watering. This is useful if you need to halt irrigation for any reason, such as weather changes or system maintenance.                                                                                                                                                                                                                     

Setting an Irrigation Schedule    

                                                                                                                                                                                            To set up an irrigation schedule using the Telegram bot, use the setirrigationschedule command. Here’s how to structure your command:

Command Format:

setirrigationschedule <time>;[<duration1>,<duration2>,...]; <days>
  • <time>: The start time for irrigation (in 24-hour format). For example, 22:00 means 10:00 PM.
  • [<duration1>,<duration2>,...]: A list of durations for each irrigation zone (in minutes). Each number represents how long each zone will be watered. For example, [1,1,1,1,1,1,1,1] means each zone gets 1 minute.
  • <days>: The days of the week when irrigation should occur. Use letters for each day: S (Sunday), M (Monday), T (Tuesday), W (Wednesday), T (Thursday), F (Friday), S (Saturday). For example, SMTWTFS means every day.
  • Example:

setirrigationschedule 22:00;[1,1,1,1,1,1,1,1]; SMTWTFS

This sets the irrigation to start at 10:00 PM, water each zone for 1 minute, and run every day of the week.                                                                                                                        




Pool Management

Pool Pump Commands

poolpump

  • What It Does: Shows the current pool pump schedule.
  • Details: This command displays the schedule for the pool pump, including the times and durations for its operation. It provides information on how and when the pool pump is set to run based on the current configuration.                                     

poolpump on

  • What It Does: Turns the pool pump on immediately.                
  • Details: This command starts the pool pump without delay. If a schedule is active, the pump will adhere to the schedule once turned on. This is useful for manually initiating the pump when needed.                                                                                                                                                                                   

poolpump off

  • What It Does: Turns the pool pump off immediately.
  • Details: This command stops the pool pump right away. If there is an active schedule, the pump will halt its operation and will remain off until the schedule is re-enabled.                                                      

poolpump enable

  • What It Does: Activates the pool pump schedule.
  • Details: This command turns on the pool pump schedule. If the pump is already running, it will continue to follow the schedule. If it was off, enabling the schedule will start the pump according to the set timings.                                                       

poolpump disable

  • What It Does: Deactivates the pool pump schedule.
  • Details: This command stops the pool pump from following the scheduled timings. If the pump is currently running, it will be turned off. If it's off, it will stay off until you enable the schedule again.               

poolpump lowenergy

  • What It Does: Sets the pool pump to low energy mode.
  • Details: This command configures the pool pump to operate in an energy-saving mode. After running for 10 minutes in normal mode, the pump will switch to low energy mode, unless it’s actively being used in high occupancy situations.                                                                                                             

poolpump highoccupancy

  • What It Does: Switches the pump to a higher speed for high occupancy situations.
  • Details: This command increases the pump’s speed for high usage periods, such as during busy summer days. After running at higher speed for 10 minutes, it will not return to low energy mode                                                              

Pool Heater Commands

poolheater on

  • What It Does: Turns the pool heater on.
  • Details: This command activates the pool heater. It will start heating the pool as long as the pool pump is running. The heater ensures the water temperature is maintained according to the set preferences.

poolheater off

  • What It Does: Turns the pool heater off.        
  • Details: This command stops the pool heater. It will remain off until you turn it back on. This is useful for stopping the heating process when it's not needed