Rain Bird


This rainbird integration allows interacting with LNK WiFi module of the Rain Bird Irrigation system in Home Assistant.

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

Configuration

To enable it, add the following to your configuration.yaml file:

# Example configuration.yaml entry
rainbird:
  host: IP_ADDRESS_OF_MODULE
  password: YOUR_PASSWORD
  trigger_time: 360

Configuration Variables

host

(string)(Required)

IP Address of the Module

password

(string)(Required)

The password for accessing the module.

trigger_time

(time)(Required)

Irrigation time. The time will be rounded down to whole minutes.

zones

(map)(Optional)

Dictionary of zone configurations

ZONE_NUMBER

(map)

Zone ID

friendly_name

(string)(Optional)

Friendly name to see in GUI

trigger_time

(time)(Optional)

Irrigation time. Seconds are ignored.

More complex configuration using all possible features could look like this example:

# Example configuration.yaml entry
rainbird:
  - host: IP_ADDRESS_OF_MODULE
    password: YOUR_PASSWORD
    trigger_time: 6
    zones:
      1:
        friendly_name: My zone 1
        trigger_time:
          minutes: 6
      2:
        friendly_name: My zone 2
        trigger_time: 2
  - host: IP_ADDRESS_OF_ANOTHER_MODULE
    password: YOUR_ANOTHER_PASSWORD
    trigger_time: 0:06
    zones:
      1:
        friendly_name: My zone 1
        trigger_time: 0:06
      3:
        friendly_name: My zone 3
        trigger_time: 0:05
Please note that due to the implementation of the API within the LNK Module, there is a concurrency issue. For example, the Rain Bird app will give connection issues (like already a connection active).

Sensor

This rainbird sensor allows interacting with LNK WiFi module of the Rain Bird Irrigation system in Home Assistant.

The integration adds rainsensor and raindelay sensors and their binary_sensor alternatives.

Switch

This rainbird switch platform allows interacting with LNK WiFi module of the Rain Bird Irrigation system in Home Assistant.

Switches are automatically added for all available zones of configured controllers.

Services

The Rain Bird switch platform exposes a service to start a single irrigation for a given duration.

Service Description
rainbird.start_irrigation Set a duration state attribute for a switch and turn the irrigation on.

The service can be used as part of an automation script. For example:

# Example configuration.yaml automation entry
automation:
  - alias: Turn irrigation on
    trigger:
      platform: time
      at: '5:30:00'
    action:
      service: rainbird.start_irrigation
      entity_id: switch.sprinkler_1
      data:
        duration: 5