greenhousino/irrigation/homeassistant

Greenhousino Irrigation — Home Assistant Integration

Custom Home Assistant integration for the Greenhousino ESP8266/ESP32 irrigation controller.

Features

• Pump switch — Turn the irrigation pump on/off from Home Assistant
• State tracking — Real-time pump state via MQTT
• Availability — Shows online/offline status
• water_for service — Water for a specific duration (1–3600 seconds)
• Config flow — Set up via Home Assistant UI (Settings → Devices & Services → Add Integration)
• Device registry — Appears as a proper device with manufacturer/model info

Installation

Option 1: HACS (recommended)

1. Install HACS in Home Assistant
2. Add this repository as a custom repository
3. Search for "Greenhousino Irrigation" and install
4. Restart Home Assistant

Option 2: Manual installation

1. Copy the greenhousino folder to your Home Assistant config directory:

cp -r greenhousino /config/custom_components/

2. Restart Home Assistant

3. Go to Settings → Devices & Services → Add Integration and search for "Greenhousino Irrigation"

Configuration

The config flow will guide you through two steps:

Step 1: Host

• Host IP address — The IP of your ESP device (e.g., 192.168.178.50). This is used for the web UI link in device info.

Step 2: MQTT Topics

• Command topic — MQTT topic to send commands (default: greenhousino/pump)
• State topic — MQTT topic for state updates (default: greenhousino/pumpstate)

Usage

Switch entity

The integration creates a switch entity (switch.greenhousino_irrigation_pump) that you can:

• Toggle on/off from the Home Assistant UI
• Use in automations
• Add to dashboards

water_for service

Water for a specific duration:

service: greenhousino.water_for
data:
  duration: 60  # seconds

Or from an automation:

automation:
  - alias: "Water garden every morning"
    trigger:
      - platform: time
        at: "06:00:00"
    action:
      - service: greenhousino.water_for
        data:
          duration: 300  # 5 minutes

MQTT Topics

Direction	Topic	Payload	Description
HA → ESP	greenhousino/pump	on	Turn pump on (default 30s)
HA → ESP	greenhousino/pump	off	Turn pump off
HA → ESP	greenhousino/pump	5000	Turn pump on for 5000ms
ESP → HA	greenhousino/pumpstate	on	Pump is active
ESP → HA	greenhousino/pumpstate	off	Pump is off
ESP → HA	greenhousino/pump/status	offline	Device disconnected

Requirements

• Home Assistant 2024.x or later
• MQTT integration configured and connected to the same broker as your ESP device

Troubleshooting

Switch shows "unavailable"

• Make sure the MQTT integration is connected
• Verify the ESP device is publishing to the state topic
• Check that topics match between the ESP firmware and HA config

Service call doesn't work

• Ensure MQTT integration is set up
• Check HA logs: Logger → greenhousino
• Verify the ESP is subscribed to the command topic

YAML-only alternative (no custom component)

If you don't want a custom integration, you can use the built-in MQTT platform:

switch:
  - platform: mqtt
    name: "Irrigation Pump"
    command_topic: "greenhousino/pump"
    state_topic: "greenhousino/pumpstate"
    payload_on: "on"
    payload_off: "off"
    state_on: "on"
    state_off: "off"
    availability_topic: "greenhousino/pump/status"
    payload_available: "online"
    payload_not_available: "offline"
    qos: 1