Telemetry Insights
DocumentationInstallation

Water Buddi: Commercial Vineyard Installation Manual

Commercial Vineyard Field Installation Manual

intermediate1–2 days (5-row install)

Complete field installation guide for a 5-row commercial vineyard using a Water Buddi Hub + Node LoRa mesh. The same procedure scales to any number of rows by adding Node devices.

Safety: This system uses 12VAC landscape power and controls water valves across commercial vineyard acreage. Always install the transformer on a GFCI-protected outdoor outlet. Each solenoid valve has a blue manual override tab, rotate it to manually close the valve in an emergency. Commission and test all devices before enabling automated schedules. Do not leave valves in manual-open state unattended.


System Overview

A Water Buddi vineyard install has three layers working together:

  • Water layer, 1″ Schedule-40 PVC trunk runs from the pump house along one side of the field, branching via tee fittings into each vine row. ½″ drip laterals run left and right from each device along the row.
  • Power layer, 12VAC transformer in the pump house; 14AWG direct-burial landscape wire runs alongside the PVC trunk and branches to each device.
  • Data layer, one Hub device (WiFi + LoRa) bridges all data to the TI cloud; remaining rows use Node devices that communicate back to the Hub over LoRa 915MHz.

Hub + Node Architecture

Every Water Buddi unit is identical hardware. The role each device takes is determined automatically based on what connectivity it finds at startup:

RoleHow assignedConnection
WiFiAutomatic, WiFi network foundDirect WiFi → TI Cloud Manager
HubManual, customer enables Hub ModeWiFi to cloud + LoRa to Nodes
NodeAutomatic, no WiFi found, Hub in LoRa rangeLoRa → Hub → TI Cloud Manager

WB-HUB connects to the tasting room WiFi AP and serves as the LoRa gateway, it bridges all Node data to the TI Cloud Manager via WiFi. WB-N01 through WB-N04 communicate only via LoRa 915MHz to the Hub. No WiFi credentials are needed on Node units.

LoRa 915MHz provides reliable range of up to 1 mile (1.6 km) in open vineyard terrain. Range is reduced by dense canopy, terrain, and obstacles. One Hub supports up to 32 Nodes.

Firmware updates: LoRa Node devices cannot receive firmware updates over LoRa. To update a Node device, temporarily move it within WiFi range, apply the update, then return it to the row.


Typical Layout

DeviceRoleLocation
WB-HUBHub (manually enabled)Row closest to tasting room WiFi AP
WB-N01 through WB-N04Node (automatic)Remaining rows

Step 1 - Gather Components & Verify Kit

Before heading to the field, confirm all hardware is present and functional.

Kit contents

  • 1 × Water Buddi Hub unit, WiFi + LoRa, OLED display, olive green enclosure
  • 4 × Water Buddi Node units, LoRa only, OLED display, olive green enclosure
  • 5 × Latching solenoid valves, ¾″ NPT male ports, blue manual override tab
  • 5 × Soil sensors, 3000-WS, 3-tine RS485, one per row
  • 1″ Schedule-40 PVC trunk + ½″ drip laterals, fittings, primer and cement
  • 14AWG 2-conductor direct-burial wire for 12VAC power run
  • Drill, shovel, level, pipe wrench, wire stripper, multimeter

Procedure

  1. Unbox all 5 Water Buddi units. The Hub has 'WB-HUB' on the OLED splash; nodes show 'WB-N01' through 'WB-N04'.
  2. Power-cycle each unit on the bench, verify OLED illuminates and shows 'Telemetry Insights LLC' within 10 seconds.
  3. Confirm you have 5 latching solenoid valves. Check the blue manual override tab rotates freely on each.
  4. Inspect all 5 soil sensor cables, no nicks, cuts, or pinched connectors.
  5. Verify your 12VAC landscape transformer is rated for the total load (minimum 1A per device, so 5A+ for a full 5-device install).
  6. Confirm sufficient 1″ PVC trunk pipe to reach from the pump house across the full field perimeter.

Step 2 - Survey the Field & Plan Layout

Map vine rows, pump house, and tasting room positions before digging.

Warning: Call 811 (USA) before any digging, locate underground utilities across the entire field.

Warning: The Hub must be placed in the row with the strongest WiFi signal from the tasting room. Walk the field with a phone before committing to row assignments.

Reference notes

  • Hub placement: the row closest to the tasting room WiFi AP, verify signal ≥ −65 dBm at that location
  • LoRa range: up to 1 mile line-of-sight at 915MHz, nodes can be anywhere in the vineyard
  • PVC route: plan the 1″ trunk from pump house to each row connection point

Procedure

  1. Walk the vineyard with a WiFi analyzer app. Identify which row has the strongest signal from the tasting room, this is where WB-HUB goes.
  2. Assign WB-N01 through WB-N04 to the remaining 4 rows, numbered from hub row outward.
  3. Locate the pump house: confirm it has a GFCI outlet for the 12VAC transformer, and a water supply connection point.
  4. Sketch the PVC trunk route: pump house → right-side field edge → vertical trunk → branch into each row at the device position.
  5. Mark each device position with a stake. The device sits centered inline in the row, connected to drip laterals on both sides.
  6. Verify line-of-sight between hub and all node positions, obstructions reduce LoRa range. Adjust placements if needed.

Step 3 - Set Up Pump House

Mount transformer, install shutoff valve, verify power and water supply.

Warning: Transformer must be plugged into a GFCI-protected outdoor outlet rated for continuous outdoor use.

Warning: Install the manual shutoff valve BEFORE running any PVC into the field, this is your emergency water off.

Reference notes

  • 12VAC transformer: mount on exterior wall, sheltered from direct rain. Use weatherproof outlet cover.
  • Ball shutoff valve: install on main supply line inside or at pump house exit point.
  • Wire labeling: label all wire ends at the pump house for each row using colored tape or cable tags.

Procedure

  1. Mount the 12VAC landscape transformer on the pump house exterior wall near the GFCI outlet. Do NOT plug it in yet.
  2. On the main water supply line at the pump house, install a manual ball shutoff valve. This gives you full field water control.
  3. Route the 12VAC output leads from the transformer to the point where the 14AWG field wire will begin.
  4. Test water pressure at the shutoff valve, target 40–60 PSI for proper solenoid valve operation.
  5. Install a pressure regulator if supply pressure exceeds 70 PSI, solenoid valves are rated to 80 PSI maximum.
  6. Label the transformer output leads and tape them safely away from the water lines until wiring is complete.

Step 4 - Install PVC Water Main

1″ trunk from pump house + ½″ drip laterals per row.

Warning: Use Teflon tape + pipe dope on ALL NPT threaded connections, the solenoid valve ports are ¾″ NPT.

Warning: Allow PVC cement to fully cure (minimum 30 minutes) before applying any water pressure.

Warning: Keep 1″ trunk and ½″ laterals buried minimum 6 inches to protect from frost and foot traffic.

Reference notes

  • Trunk: 1″ Schedule-40 PVC from pump house runs along field edge to each row branch point
  • Row connection: tee off trunk → solenoid valve inline → ½″ drip laterals run left and right from device
  • Drip laterals: install emitters every 18–24 inches along both sides of each vine row

Procedure

  1. Run 1″ PVC from the pump house shutoff valve along the field edge (right side of field looking from pump house).
  2. At each row position, install a 1″ tee fitting on the trunk. Run a branch toward the device location in that row.
  3. At each device location, cut the branch and install the latching solenoid valve inline. Arrow on valve body must point toward the drip side.
  4. From the solenoid valve outlet, run ½″ PVC (or polyethylene drip tube) in both directions along the vine row.
  5. Install drip emitters along the laterals. Space them 18–24 inches apart, one per vine base is typical.
  6. Cap all drip lateral ends. Pressure-test the full system at 40 PSI for 10 minutes, check every joint and emitter before backfilling.

Step 5 - Run 14AWG Power Wire

12VAC power from pump house transformer to all devices.

Warning: Use direct-burial rated 14AWG landscape wire only, not indoor or in-conduit wire.

Warning: Keep wire at least 2 inches away from PVC in the trench, use cable staples or separate runs.

Warning: Do NOT connect transformer until ALL devices are fully wired.

Terminal block wiring (device rear panel)

  • Left terminal block: 12VAC power pair + solenoid valve leads
  • Right terminal block: Yellow = RS485 A, Blue = RS485 B, Black = GND (soil sensor)

Procedure

  1. Starting at the 12VAC transformer leads, run 14AWG 2-conductor direct-burial wire along the field edge trunk route.
  2. At each row branch point, leave a 30-inch service loop of wire before branching into the row, allows future service.
  3. Run the branch wire alongside the PVC into each device location. Leave another 24-inch loop at the device.
  4. Strip ½ inch of insulation. Connect to the LEFT terminal block on the Water Buddi rear panel: one conductor to 12VAC, one to GND.
  5. Connect the solenoid valve leads to the remaining terminals on the left block (polarity does not matter for AC latching coil).
  6. After ALL devices are wired, connect transformer leads and plug transformer into the GFCI outlet. Verify all 5 OLEDs illuminate.

Step 6 - Install Soil Moisture Sensors

One RS485 3-tine sensor per row, close to device.

Warning: Sensor tines must be fully inserted, partial insertion produces readings of 0% or 9999.

Warning: Do not install within 12 inches of a drip emitter, wet-zone bias will skew readings.

Reference notes

  • 3000-WS sensor: measures soil moisture (%) and temperature (°C/°F) via RS485 Modbus RTU
  • Cable wiring: Brown = 12VDC out, Blue = RS485 B, Yellow = RS485 A, Black = GND
  • Modbus address: each sensor has a factory default address (0x01), set unique addresses if daisy-chaining multiple sensors

Procedure

  1. For each row, identify the sensor placement point: 18–24 inches from the device, midway between two vine plants.
  2. Dig or press a pilot hole so all three tines will fully insert. Avoid rocks or hard clods that bend the tines.
  3. Insert sensor vertically, all three tines must be fully buried flush with the sensor body bottom face.
  4. Route the sensor cable along the row to the device location, securing with cable clips every 24 inches.
  5. Connect to the RIGHT terminal block on the device rear: Black → Ground (Pin 4, top), Yellow → RS485 A (Pin 3), Blue → RS485 B (Pin 2), Brown → 12VDC out (Pin 1, bottom).
  6. In TI Cloud Manager, verify the sensor telemetry is updating, expected moisture readings: 0–100%, temperature: ambient.

Step 7 - Commission Hub & Node Mesh

Pair all devices, verify LoRa links, connect to TI Cloud Manager.

Warning: Commission WB-HUB first, nodes cannot register until the hub is online and broadcasting.

Warning: LoRa pairing requires all devices to share the same network ID and frequency plan (pre-configured at factory).

Reference notes

  • Hub provisioning: connects to tasting room WiFi AP via Bluetooth mobile app on first boot
  • Node discovery: Hub auto-discovers nodes via LoRa, nodes appear in TI Cloud Manager within 2 minutes of boot
  • Gateway: TI Cloud Manager handles all 5 devices through the hub's single WiFi connection

Procedure

  1. Power on WB-HUB first. Within 30 seconds the OLED shows the splash screen, then switches to 'Scanning WiFi…'
  2. Open the Telemetry Insights mobile app, tap 'Provision Device', select WB-HUB via Bluetooth. Enter your WiFi SSID and password.
  3. Hub OLED transitions to show IP address, signal strength (dBm), and UTC timestamp, Hub is now online.
  4. Power on all 4 nodes. Each node broadcasts LoRa join requests, the hub collects them automatically.
  5. In TI Cloud Manager, navigate to Devices, you should see WB-HUB plus WB-N01 through WB-N04 appear as Online within 2–3 minutes.
  6. Verify telemetry: each device should show soil moisture, soil temperature, and 12VAC supply voltage updating every 60 seconds.
  7. From TI Cloud Manager, trigger a manual open/close on each solenoid valve, confirm water flows at each row's drip laterals.

Step 8 - Configure Irrigation

Set up automated AI-driven irrigation for each row.

Warning: Always set a maximum valve-open time limit, prevents runaway irrigation if a sensor fails.

Warning: Test each device in manual mode first before enabling automated AI watering.

Reference notes

  • AI mode: monitors soil moisture → triggers valve open below threshold → closes at target level
  • Recommended thresholds: open valve at <35%, close at >65% (adjust per vine varietal and soil type)
  • Weather integration: 3rd party ET₀ adjustment automatically reduces irrigation after rainfall

Procedure

  1. In TI Cloud Manager, assign each device a location and configure soil type and application type.
  2. For each device, set the dry threshold (open valve) and wet threshold (close valve) appropriate to your vine varietals.
  3. Configure the maximum run time per cycle (recommended: 60 minutes) to prevent over-irrigation if a sensor fails.
  4. Enable the weather ET₀ integration, this automatically skips irrigation cycles after sufficient rainfall.
  5. Set your irrigation window (e.g., 4 AM, 7 AM) to avoid daytime evaporation loss.
  6. Run the system in manual-observe mode for one full week. Check OLED readings after each cycle and adjust thresholds.
  7. Enable AI watering mode once you have confirmed consistent readings and proper valve operation across all rows.

See Water Buddi AI Setup for full AI configuration details.


Step 9 - Troubleshooting Reference

Diagnostic checklist

SymptomAction
No OLED on bootMeasure 12VAC at left terminal block. If 0V, trace wire back to transformer. If voltage present, hold MODE 5 sec to restart.
Hub WiFi not connectingPress MODE twice to see WiFi status screen. Re-provision via mobile app Bluetooth setup flow.
Node not appearing in appConfirm hub is online first. Check node OLED for LoRa status, 'Joining…' means hub not found.
LoRa range poorVerify antenna is fully seated and pointing vertically. Move node closer to hub as a test. Check for metal obstructions.
Solenoid not actuatingUse the blue manual override tab to confirm mechanical operation. Check left terminal wiring is tight.
Soil sensor reading 0 or 9999Verify RS485 A/B wires not swapped. Confirm all 3 tines are fully inserted in moist soil.
Erratic sensor dataRe-seat sensor, all tines must be fully buried with no air gaps.

Hold MODE for 10 seconds to enter diagnostics mode, OLED shows raw RS485 bus status, LoRa RSSI, and 12VAC measurement.

Use a multimeter set to VAC, probe the LEFT terminal block, expect 11–13V AC. Most field issues are wiring, not device failure.


Signal Flow Summary

Soil sensor → RS485 → Water Buddi device → [LoRa or WiFi] → TI Cloud Manager TI Cloud Manager AI → MQTT → Water Buddi device → solenoid → drip laterals

Node relay path:

Node → LoRa 915MHz → Hub → WiFi → TI Cloud Manager

Scaling the Install

To add rows beyond the initial install:

  • Add a Node device and drip lateral connection for each new row
  • Run 14AWG power wire from the existing trunk junction
  • Provision the new Node in the app, it automatically joins the LoRa mesh

No changes to the Hub or existing Nodes are required when adding new rows.


Need Help?

Water Buddi: Commercial Vineyard Installation Manual | Telemetry Insights