This set of nodes enables communication with the Rainbird LNK2 sprinkler controller via a local LNK2 connection. To use these nodes, you need both the Rainbird controller and the LNK2 add-on properly plugged in and configured.

Prerequisites

To connect, you need the LNK2 IP address and PIN:

• LNK2 PIN: This is the code you set up in the Rainbird mobile app when configuring the LNK2.
• LNK2 IP: This is the local IP address assigned by your router.

This package wraps the functionality of node-rainbird and exposes Rainbird LNK2 functions to Node-RED.

Available Nodes:

rainbird-info

Fetches basic information about the Rainbird sprinkler controller via the local LNK2 connection. The payload returned contains the following:

1{
2  "serialNumber": "xxxxxxxxxx",
3  "modelID": "xxxxx",
4  "protocolRevisionMajor": "xx",
5  "protocolRevisionMinor": "xx",
6  "hour": 13,
7  "minute": 21,
8  "second": 19,
9  "day": 25,
10  "month": 5,
11  "year": 2025,
12  "pageNumber": "00",
13  "stationsAvail": 10
14}

rainbird-state

Retrieves the current IrrigationState from the Rainbird sprinkler controller. The payload will contain:

1{
2  "irrigationState": "_state_"
3}

The irrigationState indicates whether the Rainbird controller is running a program. This does not provide information on active zones.

rainbird-active

Fetches information on active zones (sprinklers) from the Rainbird sprinkler controller. The returned payload will include:

1{
2  "pageNumber": "00",
3  "activeStations": "00000000",
4  "activeZones": [0, 0, 0, 0]
5}

rainbird-config

Configuration node for managing the controller's setup.

rainbird-startZone

Manually activates a specific zone for a set duration (in minutes). If another zone is already active, it will be deactivated.

• msg.zone: Specifies which zone to activate.
• msg.time: Defines how long the zone should run (in minutes).

rainbird-stopZone

Stops all sprinkler zones, halting irrigation.

rainbird-delayStart

Delays the start of an irrigation program by a specified number of days. The delay duration is provided in msg.payload.

rainbird-startProgram

Manually starts a program by specifying the program number in msg.payload (e.g., Program "A" = 1, Program "B" = 2). This feature is not supported on ESP-RZXe but works on ESP-me3 and may work on other models.

rainbird-getDelay

Retrieves information on whether a program's start has been delayed. The payload will return:

1{
2  "delaySetting": number_of_days
3}

Example Flow

An example flow is provided in the examples folder of the repository. This flow demonstrates how to integrate and use the available Rainbird nodes within a Node-RED environment.

---

Maciej Szulc, 2025