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