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:

Base Configuration

To connect to your RainMachine device, add the following to your configuration.yaml file:

rainmachine:
  controllers:
    - ip_address: 192.168.1.100
      password: YOUR_PASSWORD

Configuration Variables

ip_address string(Optional)

The IP address or hostname of your RainMachine unit.

password stringRequired

Your RainMachine password.

port integer(Optional, default: 8080)

The TCP port used by your unit for the REST API.

ssl boolean(Optional, default: true)

Whether communication with the local device should occur over HTTPS.

scan_interval integer(Optional, default: 60)

The frequency (in seconds) between data updates.

zone_run_time integer(Optional, default: 600)

The default number of seconds that a zone should run when turned on.

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

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 zone to disable

rainmachine.enable_program

Enable a RainMachine program.

Service Data Attribute Optional Description
program_id no The program to enable

rainmachine.enable_zone

Enable a RainMachine zone.

Service Data Attribute Optional Description
zone_id no The zone to enable

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

rainmachine.start_program

Start a RainMachine program.

Service Data Attribute Optional Description
program_id no The program to start

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

rainmachine.stop_all

Stop all watering activities.

rainmachine.stop_program

Stop a RainMachine program.

Service Data Attribute Optional Description
program_id no The program to stop

rainmachine.stop_zone

Stop a RainMachine zone.

Service Data Attribute Optional Description
zone_id no The zone to stop

rainmachine.unpause_watering

Unpause all watering activities.

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).