Skip to content

simons-plugins/netro-indigo

Repository files navigation

Netro Smart Sprinklers Plugin for Indigo

A plugin for integrating Netro smart irrigation controllers with the Indigo Home Automation platform.

Summary

This plugin provides complete control and monitoring of your Netro smart sprinkler system through Indigo home automation. It supports all Netro controllers (Sprite, Pixie, Spark) and Whisperer soil moisture sensors, allowing you to manage your irrigation system alongside your other smart home devices.

With this plugin, you can start and stop zones, set rain delays, monitor soil moisture, view upcoming schedules, and integrate your sprinkler system into Indigo automations and triggers.

Supported Devices

  • Netro Sprite
  • Netro Pixie
  • Netro Spark
  • Whisperer soil moisture sensors

Features

Zone Control

Control your sprinkler zones directly from Indigo. Start or stop individual zones remotely, set watering durations, and integrate zone control into your home automation routines.

Real-time Status Monitoring

Monitor your controller's online/offline status in real-time. The plugin polls your Netro controller at configurable intervals to keep device states current.

Soil Moisture Tracking

View soil moisture levels for each zone. The plugin retrieves moisture data from your Netro controller and displays it as device states, allowing you to create automations based on soil conditions.

Schedule Visibility

See your current and upcoming watering schedules directly in Indigo. The plugin displays:

  • Next scheduled watering time
  • Which zone will be watered next
  • Schedule type (Smart, Automatic, Fix, or Manual)
  • Watering duration

Rain Delays

Set rain delays from 1 to 100 days to pause automatic watering during wet weather. This can be triggered manually or through Indigo automations.

Standby Mode

Enable or disable automatic watering on your controller. When in standby mode, scheduled watering is paused but manual control remains available.

Delayed Watering

Start zones with a delay of 0 to 60 minutes, or schedule watering for a specific time. This allows for more flexible automation scenarios.

Weather Reporting

Send local weather data (temperature, humidity, precipitation) to Netro to improve its AI-based scheduling decisions. This is useful if you have local weather sensors integrated with Indigo.

API Usage Monitoring

Track your daily API call usage directly from Indigo device states. The Netro API allows 2000 calls per day, and the plugin displays your remaining quota.

Whisperer Sensor Support

Integrate Whisperer soil sensors to monitor temperature, humidity, and moisture levels independently of your sprinkler zones.

Pairing a Whisperer to a Zone

Each zone device has a Paired Whisperer dropdown in its config UI. When paired and the Whisperer has reported within the last 12 hours, the zone's moisture state mirrors the Whisperer's soilMoisture reading (the actual measured value). Otherwise the zone falls back to Netro's daily forecast.

The /moistures.json forecast is always visible separately on the moistureForecast state — useful for comparing model predictions to the sensor's ground truth, and for tuning schedules. See docs/API_NOTES.md §6 for details.

Indigo Triggers

Create automations based on sprinkler events:

  • Zone start failed
  • Stop failed
  • Rate limit exceeded
  • Set rain delay failed
  • Set standby failed

Setup

  1. Download the latest release from GitHub Releases
  2. Double-click the .indigoPlugin file to install
  3. Create a new device: Devices > New > Type: Netro Smart Sprinkler
  4. Enter your controller serial number (12 hex characters, found on the physical device or in the Netro mobile app under Settings > Device Info)
  5. The plugin will automatically discover zones and configuration

For multiple controllers, create a separate device for each one with its own serial number.

Usage

Indigo Actions

Start a Zone:

# Start zone 1 for 10 minutes
indigo.sprinkler.setZone(dev, zoneIndex=1, duration=10)

Set Rain Delay: Use the plugin action "Set Rain Delay" and specify the number of days (1-100).

Report Weather: Use the plugin action "Report Weather to Netro" to send current temperature, humidity, and precipitation data.

Start Zone with Delay: Use the plugin action "Start Zone with Delay" to start a zone after a specified delay (0-60 minutes).

Device States

Each controller device exposes these states:

State Description Example
status Controller status ONLINE, OFFLINE
activeZone Currently watering zone 1, 0 (none)
activeSchedule Current schedule type Smart, Manual, No active schedule
nextScheduleTime When next watering starts 2026-01-28 14:30:00
nextScheduleZone Next zone to water Front Lawn
nextScheduleSource Next schedule type Smart, Automatic
nextScheduleDuration Next watering duration (min) 15
token_remaining API calls remaining today 1847
moisture_1 through moisture_12 Zone moisture % 45

API Rate Limits

The Netro API allows 2000 calls per day. The plugin manages this automatically:

  • Default polling every 3 minutes uses approximately 480 calls per day
  • Rate limit warnings appear when fewer than 200 calls remain
  • Automatic 61-minute backoff occurs if the rate limit is exceeded
  • Current usage is visible in the token_remaining device state

If you approach the daily limit, increase the polling interval in the plugin configuration.

Support

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages