Add Inovelli Blue Dimmer switch hardware documentation

2025-12-21 15:51:08 -08:00
parent 40e03d0300
commit 63dec6c5ee
9 changed files with 2540 additions and 0 deletions
--- a/inovelli/dimming-and-ramp.md
+++ b/inovelli/dimming-and-ramp.md
@@ -0,0 +1,219 @@
+# Dimming & Ramp Control Properties
+
+Properties controlling how the switch dims lights and transitions between brightness levels. Each property has separate settings for "Remote" (commands from Home Assistant hub/automations) and "Local" (physical paddle presses).
+
+## dimmingSpeedUpRemote
+
+- **Type**: Number
+- **Range**: 0-127
+- **Default**: 25
+- **Unit**: 100ms increments (e.g., 25 = 2.5 seconds)
+- **Description**: Changes the speed that the light dims up when controlled from the hub. A setting of 0 turns the light immediately to the target level. Increasing the value slows down the transition speed.
+- **Home Assistant Entity**: `number.[device_name]_dimming_speed_up_remote`
+- **Special values**:
+  - `0` = Instant dimming (no transition)
+  - `1-127` = Duration in 100ms increments
+- **Use cases**: Smooth transitions for automations, gradual wake-up lighting
+
+## dimmingSpeedUpLocal
+
+- **Type**: Number
+- **Range**: 0-127
+- **Default**: 127 (sync with dimmingSpeedUpRemote)
+- **Unit**: 100ms increments
+- **Description**: Changes the speed that the light dims up when controlled at the switch. A setting of 0 turns the light immediately to the target level. Setting to 127 keeps it in sync with dimmingSpeedUpRemote.
+- **Home Assistant Entity**: `number.[device_name]_dimming_speed_up_local`
+- **Special values**:
+  - `0` = Instant dimming
+  - `1-126` = Duration in 100ms increments
+  - `127` = Sync with dimmingSpeedUpRemote
+- **Use cases**: Customize local dimming to be faster or slower than remote control
+
+## rampRateOffToOnRemote
+
+- **Type**: Number
+- **Range**: 0-127
+- **Default**: 127 (sync with dimmingSpeedUpRemote)
+- **Unit**: 100ms increments
+- **Description**: Changes the speed that the light turns on when controlled from the hub. A setting of 0 turns the light immediately on.
+- **Home Assistant Entity**: `number.[device_name]_ramp_rate_off_to_on_remote`
+- **Special values**:
+  - `0` = Instant on
+  - `1-126` = Duration in 100ms increments
+  - `127` = Sync with dimmingSpeedUpRemote
+- **Use cases**: Gentle wake-up lighting, dramatic scene transitions
+
+## rampRateOffToOnLocal
+
+- **Type**: Number
+- **Range**: 0-127
+- **Default**: 127 (sync with dimmingSpeedUpRemote)
+- **Unit**: 100ms increments
+- **Description**: Changes the speed that the light turns on when controlled at the switch. A setting of 0 turns the light immediately on.
+- **Home Assistant Entity**: `number.[device_name]_ramp_rate_off_to_on_local`
+- **Special values**:
+  - `0` = Instant on
+  - `1-126` = Duration in 100ms increments
+  - `127` = Sync with dimmingSpeedUpRemote
+- **Use cases**: Different on-ramp behavior for manual vs automated control
+
+## dimmingSpeedDownRemote
+
+- **Type**: Number
+- **Range**: 0-127
+- **Default**: 127 (sync with dimmingSpeedUpRemote)
+- **Unit**: 100ms increments
+- **Description**: Changes the speed that the light dims down when controlled from the hub. A setting of 0 turns the light immediately to the target level.
+- **Home Assistant Entity**: `number.[device_name]_dimming_speed_down_remote`
+- **Special values**:
+  - `0` = Instant dimming
+  - `1-126` = Duration in 100ms increments
+  - `127` = Sync with dimmingSpeedUpRemote
+- **Use cases**: Asymmetric dimming (e.g., fast up, slow down for sunset effect)
+
+## dimmingSpeedDownLocal
+
+- **Type**: Number
+- **Range**: 0-127
+- **Default**: 127 (sync with dimmingSpeedUpLocal)
+- **Unit**: 100ms increments
+- **Description**: Changes the speed that the light dims down when controlled at the switch. A setting of 0 turns the light immediately to the target level.
+- **Home Assistant Entity**: `number.[device_name]_dimming_speed_down_local`
+- **Special values**:
+  - `0` = Instant dimming
+  - `1-126` = Duration in 100ms increments
+  - `127` = Sync with dimmingSpeedUpLocal
+- **Use cases**: Match or differentiate from remote down-dimming behavior
+
+## rampRateOnToOffRemote
+
+- **Type**: Number
+- **Range**: 0-127
+- **Default**: 127 (sync with rampRateOffToOnRemote)
+- **Unit**: 100ms increments
+- **Description**: Changes the speed that the light turns off when controlled from the hub. A setting of 0 (instant) turns the light immediately off.
+- **Home Assistant Entity**: `number.[device_name]_ramp_rate_on_to_off_remote`
+- **Special values**:
+  - `0` = Instant off
+  - `1-126` = Duration in 100ms increments
+  - `127` = Sync with rampRateOffToOnRemote
+- **Use cases**: Gradual fade to black, bedtime dimming routines
+
+## rampRateOnToOffLocal
+
+- **Type**: Number
+- **Range**: 0-127
+- **Default**: 127 (sync with rampRateOffToOnLocal)
+- **Unit**: 100ms increments
+- **Description**: Changes the speed that the light turns off when controlled at the switch. A setting of 0 (instant) turns the light immediately off.
+- **Home Assistant Entity**: `number.[device_name]_ramp_rate_on_to_off_local`
+- **Special values**:
+  - `0` = Instant off
+  - `1-126` = Duration in 100ms increments
+  - `127` = Sync with rampRateOffToOnLocal
+- **Use cases**: Theater-style fade out, energy-saving gradual shutoff
+
+## Configuration Patterns
+
+### Synchronized Dimming
+Set all local parameters to `127` to use the remote parameters as the master speed control for all dimming operations.
+
+```yaml
+# All in sync with dimmingSpeedUpRemote
+service: number.set_value
+target:
+  entity_id: number.bedroom_switch_dimming_speed_up_remote
+data:
+  value: 25  # 2.5 seconds
+
+# Set all local to sync
+service: number.set_value
+target:
+  entity_id:
+    - number.bedroom_switch_dimming_speed_up_local
+    - number.bedroom_switch_ramp_rate_off_to_on_local
+    - number.bedroom_switch_dimming_speed_down_local
+    - number.bedroom_switch_ramp_rate_on_to_off_local
+data:
+  value: 127  # Sync with remote
+```
+
+### Instant Local, Smooth Remote
+- Local: `0` (instant control)
+- Remote: `50` (5-second smooth transitions)
+
+```yaml
+# Set remote for smooth transitions
+service: number.set_value
+target:
+  entity_id:
+    - number.bedroom_switch_dimming_speed_up_remote
+    - number.bedroom_switch_ramp_rate_off_to_on_remote
+    - number.bedroom_switch_dimming_speed_down_remote
+    - number.bedroom_switch_ramp_rate_on_to_off_remote
+data:
+  value: 50
+
+# Set local for instant response
+service: number.set_value
+target:
+  entity_id:
+    - number.bedroom_switch_dimming_speed_up_local
+    - number.bedroom_switch_ramp_rate_off_to_on_local
+    - number.bedroom_switch_dimming_speed_down_local
+    - number.bedroom_switch_ramp_rate_on_to_off_local
+data:
+  value: 0
+```
+
+### Asymmetric Dimming
+- Dim up quickly: `10` (1 second)
+- Dim down slowly: `100` (10 seconds)
+- Creates dynamic lighting feel
+
+```yaml
+# Quick dim up
+service: number.set_value
+target:
+  entity_id:
+    - number.bedroom_switch_dimming_speed_up_remote
+    - number.bedroom_switch_dimming_speed_up_local
+data:
+  value: 10
+
+# Slow dim down
+service: number.set_value
+target:
+  entity_id:
+    - number.bedroom_switch_dimming_speed_down_remote
+    - number.bedroom_switch_dimming_speed_down_local
+data:
+  value: 100
+```
+
+### Scene-Based Transitions
+- Off→On ramp: `30` (3 seconds - gentle fade in)
+- On→Off ramp: `100` (10 seconds - slow fade out)
+- Dimming speed: `20` (2 seconds - responsive)
+
+```yaml
+service: number.set_value
+target:
+  entity_id: number.bedroom_switch_ramp_rate_off_to_on_remote
+data:
+  value: 30
+
+service: number.set_value
+target:
+  entity_id: number.bedroom_switch_ramp_rate_on_to_off_remote
+data:
+  value: 100
+
+service: number.set_value
+target:
+  entity_id:
+    - number.bedroom_switch_dimming_speed_up_remote
+    - number.bedroom_switch_dimming_speed_down_remote
+data:
+  value: 20
+```