220 lines
7.3 KiB
Markdown
220 lines
7.3 KiB
Markdown
# 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
|
|
```
|