home-assistant-blueprints/inovelli/dimming-and-ramp.md

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.

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

# 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

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

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