[RELEASE] Oelo Lights Zone Driver - Control Oelo Permanent Outdoor Lighting

⚙️ Custom Apps and Drivers Custom Drivers
1

Custom Hubitat driver for controlling Oelo Lights outdoor lighting controllers via HTTP REST API.

Features:

  • Multi-zone control: up to 6 zones (separate virtual device per zone)
  • Pattern capture: capture patterns from the Oelo Evolution app and save up to 200 patterns per zone
  • Pattern types: spotlight plans and standard patterns (march, stationary, river, chase, twinkle, split, fade, sprinkle, takeover, streak, bolt, custom)
  • Spotlight customization: customize which LEDs are active in spotlight patterns
  • Auto-discovery: automatic controller discovery with IP auto-configuration via scanForController() command
  • Pattern management: rename and delete patterns with stable pattern IDs
  • Auto-polling: configurable status polling (default: 5 minutes)
  • Command verification: optional verification to ensure commands are applied
  • No authentication: simple HTTP API, no credentials required

Installation:
Method 1: Hubitat Package Manager (HPM) - Recommended

  1. Ensure Hubitat Package Manager is installed
  2. Open HPM → Install → Search for "Oelo Lights"
  3. Follow the installation prompts

Method 2: Manual Installation

  1. Hubitat web interface → Drivers Code → + New Driver
  2. Click Import and paste:
    https://raw.githubusercontent.com/curtiside/oelo-lights-hubitat/main/drivers/oelo-lights-zone.groovy
  3. Click Import → Save

Configuration:

  1. Create a virtual device using the "Oelo Lights Zone" driver
  2. Use the scanForController() command to discover and set the controller IP, or enter it manually
  3. Set Zone Number (1-6)
  4. Optional: configure polling interval, pattern management, spotlight plan LEDs, etc.

Usage:

  • Capture patterns: create/edit in Oelo Evolution app, then use getPattern() to save in Hubitat
  • Apply patterns: select from Pattern Selection dropdown and use applyPattern() command
  • Automations: use on(), off(), and applyPattern() commands in Rule Machine or Simple Automation Rules
  • Multiple zones: create separate virtual devices for each zone (1-6)

Requirements:

  • Hubitat Elevation hub (firmware 2.1.9+)
  • Oelo Lights controller on local network
  • Controller IP address (discoverable via scan command)

GitHub Repository:

Documentation:
Full documentation, configuration details, troubleshooting, and examples available in the README.

Version: 1.0.1 (Released: 2024-12-20)
License: MIT

Support:

1 Like