RainMachine


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

Base Configuration

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

rainmachine:
  ip_address: 192.168.1.100
  password: YOUR_PASSWORD

To configure additional functionality, add configuration options beneath a binary_sensor, sensor, and/or switches key within the rainmachine sections of configuration.yaml as below:

rainmachine:
  ip_address: 192.168.1.100
  password: YOUR_PASSWORD
  binary_sensors:
    # binary sensor configuration options...
  sensors:
    # sensor configuration options...
  switches:
    # switch configuration options...

Configuration Variables

ip_address

(string)(Optional)the IP address or hostname of your RainMachine unit

password

(string)(Required)your RainMachine password.

port

(int)(Optional)the TCP port used by your unit for the REST API

Default value: 8080

ssl

(boolean)(Optional)whether communication with the local device should occur over HTTPS

Default value: true

scan_interval

(int)(Optional)the frequency (in seconds) between data updates

Default value: 60

binary_sensors

(map)(Optional)binary sensor-related configuration options

monitored_conditions

(list)(Optional)the conditions to create sensors from

Default value: all (extra_water_on_hot_days, freeze, freeze_protection, hourly, month, raindelay, rainsensor, weekday)

sensors

(map)(Optional)sensor-related configuration options

monitored_conditions

(list)(Optional)the conditions to create sensors from

Default value: all (freeze_protect_temp)

switches

(map)(Optional)switch-related configuration options

zone_run_time

(int)(Optional)the default number of seconds that a zone should run when turned on

Default value: 600

Services

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