Configuration
Initial setup parameters
| Parameter | Description | Default |
|---|---|---|
| Host | IP address or hostname of the SunRiser device | — |
| Port | HTTP port the device listens on | 80 |
Options
After setup, go to Settings → Devices & Services → SunRiser → Configure to adjust:
| Option | Description | Range / Format | Default |
|---|---|---|---|
| Poll interval | How often HA fetches the device state | 5–3600 s | 30 s |
| Scheduled daily reboot | Automatically reboot the controller once a day to prevent firmware instability | on / off | on |
| Scheduled reboot time | Time of day to reboot (24-hour format) | HH:MM | 04:00 |
Changing any option reloads the integration automatically — no restart required.
How polling works
Polling is staggered: one HTTP request per tick. The sequence is state × 4 → weather, then repeats. /state is fetched every tick; /weather is fetched once every 5 ticks (~2.5 min at the default interval). This is required because the SunRiser's WizFi360 Wi-Fi module can only handle one connection at a time, and /weather involves an SD card write on the device. PWM config is re-read every ~30 minutes (every 60 ticks); new temperature sensors are picked up automatically on the next poll with no reload required.
Entity types
| Platform | Created when | Notes |
|---|---|---|
light |
PWM channel with pwm#X#onoff = false (dimmable) |
|
switch |
PWM channel with pwm#X#onoff = true (on/off only) |
Also creates Maintenance Mode, Time-lapse, and DST Auto-track switches |
select |
Every active channel — controls the manager (none / dayplanner / weekplanner / fixed) |
Disabled by default; enable in entity settings |
number |
Every active channel — sets the fixed brightness (0–1000) | Disabled by default; enable in entity settings |
sensor |
Always — Uptime (disabled by default), Firmware Version, Hostname, DS1820 temperature probes, weather state per channel (clear / cloudy / rain / thunder / moon) |
|
binary_sensor |
Always — device connectivity (derived from last state poll) | |
button |
Always — Reboot |
Channels where pwm#X#color is empty are unused and produce no entities. To activate a channel, log into the SunRiser web UI and assign a colour to it — the integration will pick it up automatically on the next poll.