# 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
```