237 lines
6.5 KiB
Markdown
237 lines
6.5 KiB
Markdown
# 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:
|
|
|
|
```yaml
|
|
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:
|
|
|
|
```yaml
|
|
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:
|
|
|
|
```yaml
|
|
# 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:
|
|
|
|
```yaml
|
|
# 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:
|
|
|
|
```yaml
|
|
service: select.select_option
|
|
target:
|
|
entity_id: select.bedroom_switch_invert_switch
|
|
data:
|
|
option: "Yes"
|
|
```
|