home-assistant.io/source/_integrations/rainbird.markdown

title	description	ha_category	ha_release	ha_iot_class	ha_codeowners	ha_domain	ha_platforms	ha_integration_type
Rain Bird	Instructions on how to integrate your Rain Bird LNK WiFi Module within Home Assistant.	Irrigation Sensor Switch	0.61	Local Polling	@konikvranik	rainbird	binary_sensor sensor switch	integration

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:

• Sensor
• Switch

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 %} host: description: IP Address of the Module required: true type: string password: description: The password for accessing the module. required: true type: string trigger_time: description: Irrigation time. The time will be rounded down to whole minutes. required: true type: time zones: description: Dictionary of zone configurations required: false type: map keys: ZONE_NUMBER: description: Zone ID type: map keys: friendly_name: description: Friendly name to see in GUI required: false type: string trigger_time: description: Irrigation time. Seconds are ignored. required: false type: time {% endconfiguration %}

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:
      minutes: 6
    zones:
      1:
        friendly_name: My zone 1
        trigger_time:
          minutes: 6
      2:
        friendly_name: My zone 2
        trigger_time:
          minutes: 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.
rainbird.set_rain_delay	Set how long automatic irrigation is turned off.

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
        data:
          entity_id: switch.sprinkler_1
          duration: 5