Firmware & Software Setup

The Intellidwell Sprinkler Controller runs a custom MicroPython firmware base. This guide walk you through initial configuration, Home Assistant setup, and OTA updates.

Initial Wi-Fi Configuration

On initial power-up (or after a factory reset), the controller sets up a temporary local Wi-Fi Access Point to receive your network credentials.

1

Connect to the Setup AP

On your phone or computer, open your Wi-Fi settings and scan for networks. Connect to the Access Point named intelidwellSC using password Sprinkler12345.

2

Open the Setup Page

Once connected, open a web browser and navigate to http://192.168.4.1. A setup page will load listing all available 2.4GHz Wi-Fi networks.

3

Enter Wi-Fi Credentials

Select your home Wi-Fi network, enter your network password, and click Connect. The controller's LED will blink rapidly as it authenticates. Once successfully connected, the controller will close its Access Point and obtain a local IP address from your router.

Web Console Interface

Once connected to your home network, you can access the controller's main dashboard interface from any local web browser. Simply enter the IP address assigned to the controller by your router (e.g. `http://192.168.1.45`).

Key Features of the Dashboard:

Manual Zone Controls: Start and stop individual zones manually with customizable timers.
Integrated Scheduling: Configure start times, run durations, and day-of-week parameters directly on the controller memory.
Network & Device Statistics: Check Wi-Fi signal strength (RSSI), firmware version, system uptime, and memory statistics.

Home Assistant Integration

Intellidwell communicates seamlessly with Home Assistant via MQTT or local REST API. The most robust integration is via mqtt auto-discovery.

Option 1: MQTT Auto-Discovery (Recommended)

If you have an active MQTT broker in Home Assistant, the controller will automatically register itself under the MQTT Integration. Go to Settings -> Devices & Services in Home Assistant to find and configure the controller.

Option 2: YAML Configuration

Alternatively, you can manually configure the controller using standard REST switches in your `configuration.yaml` file:

yaml

# Example configuration.yaml REST Switch entry
switch:
  - platform: rest
    name: "Intellidwell Zone 1"
    resource: http:///api/zone/1
    body_on: '{"state": "ON", "duration": 600}'
    body_off: '{"state": "OFF"}'
    is_on_template: "{{ value_json.is_active }}"
    headers:
      Content-Type: application/json

OTA & Firmware Updates

We actively release firmware improvements and bug fixes. You can upgrade your controller directly from your browser.

1

Access the Firmware Updater

Open your browser and go to `http:///sprinkler_updater` (or navigate through the settings panel on the main web portal dashboard).

2

Check for Updates

Click Check for Updates. The controller will query the server to check if a new firmware version is available.

3

Apply Update

If a new version (e.g. `v2.0.11`) is available, click Download & Apply. The controller will download the compiled `.mpy` files, store them on its flash system, and automatically reboot to load the new firmware. Keep the power connected during this process.