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:
  controllers:
    - 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:
  controllers:
    - 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

(integer)(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

(integer)(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

(integer)(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