Add Inovelli Blue Dimmer switch hardware documentation

2025-12-21 15:51:08 -08:00
parent 40e03d0300
commit 63dec6c5ee
9 changed files with 2540 additions and 0 deletions
--- a/inovelli/brightness-levels.md
+++ b/inovelli/brightness-levels.md
@@ -0,0 +1,236 @@
+# 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"
+```