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

title, description, ha_category, ha_release, ha_iot_class, ha_config_flow, ha_codeowners, ha_domain, ha_platforms, ha_zeroconf, ha_homekit

title	description	ha_category	ha_release	ha_iot_class	ha_config_flow	ha_codeowners	ha_domain	ha_platforms	ha_zeroconf	ha_homekit
RainMachine	Instructions on how to integrate RainMachine units within Home Assistant.	Irrigation Binary Sensor Sensor Switch	0.69	Local Polling	true	@bachya	rainmachine	binary_sensor sensor switch	true	true

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:

• Binary Sensor
• Sensor
• Switch

Note that some entities are disabled by default. If you are missing a sensor or binary sensor, check the configured integration!

{% include integrations/config_flow.md %}

Services

Services accept either device IDs or entity IDs, depending on the nature of the service:

• Services that require a device ID as a target:
  • rainmachine.pause_watering
  • rainmachine.push_weather_data
  • rainmachine.stop_all
  • rainmachine.unpause_watering
• Services that require an entity ID as a target (note that the correct entity ID type must be provided, such as a program for a program-related service)
  • rainmachine.disable_program
  • rainmachine.disable_zone
  • rainmachine.enable_program
  • rainmachine.enable_zone
  • rainmachine.start_program
  • rainmachine.start_zone
  • rainmachine.stop_program
  • rainmachine.stop_zone

rainmachine.disable_program

Disable a RainMachine program. This will mark the program switch as Unavailable in the UI.

rainmachine.disable_zone

Disable a RainMachine zone. This will mark the zone switch as Unavailable in the UI.

rainmachine.enable_program

Enable a RainMachine program.

rainmachine.enable_zone

Enable a RainMachine zone.

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

Push Weather Data from Home Assistant to the RainMachine device.

Local Weather Push service should be enabled from Settings > Weather > Developer tab for RainMachine to consider the values being sent. Units must be sent in metric; no conversions are performed by the integration. Note: RAIN and QPF values shouldn't be sent as cumulative values but the measured/forecasted values for each hour or day. The RainMachine Mixer will sum all RAIN or QPF values in the current day to have the day total RAIN or QPF.

See details of RainMachine API here: https://rainmachine.docs.apiary.io/#reference/weather-services/parserdata/post

Service Data Attribute	Optional	Description
timestamp	no	UNIX Timestamp for the Weather Data. If omitted, the RainMachine device's local time at the time of the call is used.
mintemp	no	Minimum Temperature (°C)
maxtemp	no	Maximum Temperature (°C)
temperature	no	Current Temperature (°C)
wind	no	Wind Speed (m/s)
solarrad	no	Solar Radiation (MJ/m²/h)
et	no	Evapotranspiration (mm)
qpf	no	Quantitative Precipitation Forecast (mm), or QPF
rain	no	Measured Rainfail (mm)
minrh	no	Min Relative Humidity (%RH)
maxrh	no	Max Relative Humidity (%RH)
condition	no	Current weather condition code (WNUM). See here for options.
pressure	no	Barametric Pressure (kPa)
dewpoint	no	Dew Point (°C)

rainmachine.start_program

Start a RainnMachine program.

rainmachine.start_zone

Start a RainMachine zone for a set number of seconds.

Service Data Attribute	Optional	Description
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.

rainmachine.stop_zone

Stop a RainMachine zone.

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