Brightness Levels Properties

Properties controlling brightness limits, default levels when turning on, power restore behavior, and multi-tap brightness shortcuts.

minimumLevel

Type: Number
Range: 1-254
Default: 1 (lowest possible)
Description: The minimum brightness level the switch can dim to. Prevents dimming below a threshold where lights flicker or turn off.
Home Assistant Entity: number.[device_name]_minimum_level
Use cases:
- Prevent LED bulb flickering at low levels
- Set nightlight minimum brightness
- Ensure lights never go completely dark when dimming
Common values:
- LED bulbs: 10-20 (prevents flickering)
- Incandescent: 1-5 (can dim lower)
- Smart bulbs: 1 (handle dimming internally)

maximumLevel

Type: Number
Range: 2-255
Default: 255 (full brightness)
Description: The maximum brightness level the switch can reach. Limits top-end brightness.
Home Assistant Entity: number.[device_name]_maximum_level
Use cases:
- Limit max brightness to extend bulb life
- Reduce energy consumption
- Create softer ambient lighting maximum
- Protect sensitive loads
Common values:
- Full brightness: 255
- Energy saving: 200-230
- Ambient lighting: 150-180

invertSwitch

Type: Select
Values: "Yes", "No"
Default: "No" (normal orientation)
Description: Inverts paddle operation (up becomes down, down becomes up).
Home Assistant Entity: select.[device_name]_invert_switch
Use cases:
- Match 3-way switch orientation
- Accommodate non-standard wiring
- User preference for reversed operation

defaultLevelLocal

Type: Number
Range: 0-255
Default: 255 (last level or max)
Description: Brightness level when turned on via physical paddle.
Home Assistant Entity: number.[device_name]_default_level_local
Special values:
- 0-254 = Specific brightness level
- 255 = Return to the level that it was on before it was turned off (smart resume)
Use cases:
- Always turn on to comfortable level (e.g., 128 for 50%)
- Predictable brightness for specific room uses
- Override smart resume for consistent behavior

defaultLevelRemote

Type: Number
Range: 0-255
Default: 255 (last level or max)
Description: Brightness level when turned on via hub commands (automations/app).
Home Assistant Entity: number.[device_name]_default_level_remote
Special values:
- 0-254 = Specific brightness level
- 255 = Return to the level that it was on before it was turned off (smart resume)
Use cases:
- Automations that need predictable brightness
- Different default for voice/app control vs physical
- Scene activation with specific levels

stateAfterPowerRestored

Type: Number
Range: 0-255
Default: 255 (previous state)
Description: The state the switch should return to when power is restored after power failure.
Home Assistant Entity: number.[device_name]_state_after_power_restored
Special values:
- 0 = off
- 1-254 = Specific brightness level (and turn on)
- 255 = Return to previous state before power loss
Use cases:
- Always off after power restore (set to 0)
- Emergency lighting (set to specific brightness)
- Smart restore to previous state (set to 255)

brightnessLevelForDoubleTapUp

Type: Number
Range: 2-255
Default: 254 (near maximum)
Description: Set this level on double-tap UP (if enabled by doubleTapUpToParam55).
Home Assistant Entity: number.[device_name]_brightness_level_for_double_tap_up
Special values:
- 2-254 = Specific brightness level
- 255 = Send ON command
Use cases:
- Quick full-bright shortcut
- Task lighting preset
- Scene activation brightness
Prerequisites: Requires doubleTapUpToParam55 = "Enabled"

brightnessLevelForDoubleTapDown

Type: Number
Range: 0-255
Default: 0
Description: Set this level on double-tap DOWN (if enabled by doubleTapDownToParam56).
Home Assistant Entity: number.[device_name]_brightness_level_for_double_tap_down
Special values:
- 0 = Send OFF command
- 1-254 = Specific brightness level
- 255 = Send OFF command
Use cases:
- Quick nightlight mode
- Turn off shortcut
- Low-light scene activation
Prerequisites: Requires doubleTapDownToParam56 = "Enabled"

Configuration Patterns

Smart Resume (Memory)

All settings return to previous state/level:

service: number.set_value
target:
  entity_id:
    - number.bedroom_switch_default_level_local
    - number.bedroom_switch_default_level_remote
    - number.bedroom_switch_state_after_power_restored
data:
  value: 255  # Remember previous level

Predictable Lighting

Always turn on to 50% brightness:

service: number.set_value
target:
  entity_id:
    - number.bedroom_switch_default_level_local
    - number.bedroom_switch_default_level_remote
    - number.bedroom_switch_state_after_power_restored
data:
  value: 128  # 50% brightness

LED Bulb Optimization

Prevent low-level flicker with memory:

# Prevent flicker
service: number.set_value
target:
  entity_id: number.bedroom_switch_minimum_level
data:
  value: 15

# Full range at top
service: number.set_value
target:
  entity_id: number.bedroom_switch_maximum_level
data:
  value: 255

# Smart resume
service: number.set_value
target:
  entity_id:
    - number.bedroom_switch_default_level_local
    - number.bedroom_switch_default_level_remote
data:
  value: 255

Task + Ambient Presets

Three brightness presets via paddle control:

# Comfortable ambient for single press
service: number.set_value
target:
  entity_id: number.bedroom_switch_default_level_local
data:
  value: 180

# Full bright for tasks (double-tap up)
service: number.set_value
target:
  entity_id: number.bedroom_switch_brightness_level_for_double_tap_up
data:
  value: 254

# Enable double-tap up
service: select.select_option
target:
  entity_id: select.bedroom_switch_double_tap_up_to_param55
data:
  option: "Enabled"

# Nightlight mode (double-tap down)
service: number.set_value
target:
  entity_id: number.bedroom_switch_brightness_level_for_double_tap_down
data:
  value: 30

# Enable double-tap down
service: select.select_option
target:
  entity_id: select.bedroom_switch_double_tap_down_to_param56
data:
  option: "Enabled"

Inverted Switch

For upside-down installation:

service: select.select_option
target:
  entity_id: select.bedroom_switch_invert_switch
data:
  option: "Yes"

6.5 KiB Raw Blame History