Home Assistant Home Assistant

RainMachine

The RainMachine integration is the main integration to integrate all platforms related to RainMachine smart Wi-Fi sprinkler controllers.

There is currently support for the following device types within Home Assistant:

Configuration

Adding RainMachine to your Home Assistant instance can be done via the user interface, by taking the following steps:

  • Browse to your Home Assistant instance.

  • In the sidebar click on Configuration.

  • From the configuration menu select: Integrations.

  • In the bottom right, click on the Add Integration button.

  • From the list, search and select “RainMachine”.

  • Follow the instruction on screen to complete the set up.

After completing, the RainMachine integration will be immediately available for use.

Services

rainmachine.disable_program

Disable a RainMachine program. This will mark the program switch as Unavailable in the UI.

Service Data Attribute Optional Description
program_id no The program to disable
entity_id yes An entity belonging to the RainMachine controller to adjust

rainmachine.disable_zone

Disable a RainMachine zone. This will mark the zone switch as Unavailable in the UI.

Service Data Attribute Optional Description
zone_id no The program to disable
entity_id yes An entity belonging to the RainMachine controller to adjust

rainmachine.enable_program

Enable a RainMachine program.

Service Data Attribute Optional Description
program_id no The program to enable
entity_id yes An entity belonging to the RainMachine controller to adjust

rainmachine.enable_zone

Enable a RainMachine zone.

Service Data Attribute Optional Description
zone_id no The zone to enable
entity_id yes An entity belonging to the RainMachine controller to adjust

rainmachine.pause_watering

Pause all watering activities for a number of seconds.

Service Data Attribute Optional Description
seconds no The number of seconds to pause
entity_id yes An entity belonging to the RainMachine controller to adjust

rainmachine.start_program

Start a RainMachine program.

Service Data Attribute Optional Description
program_id no The program to start
entity_id yes An entity belonging to the RainMachine controller to adjust

rainmachine.start_zone

Start a RainMachine zone for a set number of seconds.

Service Data Attribute Optional Description
zone_id no The zone to start
zone_run_time yes The number of seconds to run; defaults to 60 seconds
entity_id yes An entity belonging to the RainMachine controller to adjust

rainmachine.stop_all

Stop all watering activities.

Service Data Attribute Optional Description
entity_id yes An entity belonging to the RainMachine controller to adjust

rainmachine.stop_program

Stop a RainMachine program.

Service Data Attribute Optional Description
program_id no The program to stop
entity_id yes An entity belonging to the RainMachine controller to adjust

rainmachine.stop_zone

Stop a RainMachine zone.

Service Data Attribute Optional Description
zone_id no The zone to stop
entity_id yes An entity belonging to the RainMachine controller to adjust

rainmachine.unpause_watering

Unpause all watering activities.

Service Data Attribute Optional Description
entity_id yes An entity belonging to the RainMachine controller to adjust

Switch

The rainmachine switch platform allows you to control programs and zones within a RainMachine smart Wi-Fi sprinkler controller.

Controlling Your Device

After Home Assistant loads, new switches will be added for every enabled program and zone. These work as expected:

  • Program On/Off: starts/stops a program
  • Zone On/Off: starts/stops a zone (using the zone_run_time parameter to determine how long to run for)

Programs and zones are linked. While a program is running, you will see both the program and zone switches turned on; turning either one off will turn the other one off (just like in the web app).