Blackymas/NSPanel_HA_Blueprint v4.3.45

v4.3.45 - Dynamic QR Codes & Enhanced Control

on GitHub

Summary

This release introduces dynamic QR code functionality with entity integration and configurable display wake-up behavior. Additionally, alarm state transition handling has been improved for better security enforcement.

Key Enhancements

Dynamic QR Code Support

Rebuilt QR code engine enabling dynamic QR code functionality - users can now assign entities to QR codes
that automatically update when the entity value changes.

New capabilities:

• Entity-based QR codes: Assign input text or sensor entities to QR codes
• Automatic updates: QR code refreshes automatically when entity value changes
• Real-time display: Panel shows updated QR codes immediately
• Dynamic content support: Ideal for changing content like Wi-Fi passwords, authentication codes, etc.

Configuration options:

For boot-time static QR codes:

substitutions:
  qrcode_initial_value: ''         # Set initial QR code content
  qrcode_title_initial_value: ''   # Set initial QR code title
  qrcode_restore_value: false      # Set to true to remember last QR code across reboots

Use cases:

• Dynamic Wi-Fi passwords that change periodically
• Time-based authentication codes
• Rotating access credentials
• Any content that updates over time

Issues Reference: #452, #2283

Result: Flexible QR code system supporting both static and dynamic content with entity integration.

Hardware Button Wake-Up Control

Added configurable option to control display wake-up behavior with hardware buttons - users can now choose whether physical button presses should wake the display from sleep/screensaver mode.

Configuration:

substitutions:
  wakeup_with_button_press: false  # Set to true to enable wake-up with hardware button press (default: false)

Behavior:

• When set to false (default): Physical button presses do NOT wake the display from screensaver/sleep mode
• When set to true: Physical button presses WILL wake the display from screensaver/sleep mode

Use cases:

• Prevent accidental wake-ups from unintended button presses
• Customized wake behavior based on installation location
• Coordinated wake-up with other automation triggers

Issues Reference: #2638

Result: Users gain granular control over display wake-up behavior, allowing customization based on specific use cases and preferences.

Alarm Improvements

Enhanced Alarm State Transition Handling

Improved alarm state transition handling - strengthened ESPHome-level enforcement to ensure proper alarm behavior when switching between armed states or when triggered.

Previous behavior:

• Switching to another armed state while alarm was triggered would cancel the trigger at the ESPHome level
• State transitions were not restricted when alarm was armed or triggered

Improved behavior:

• When alarm is triggered: Only disarm action is available (always enforced)
• When alarm is armed (optional): Set require_disarm_before_rearm: true to require disarm before switching armed states
• Configurable behavior: Users can choose whether to require disarm when switching between armed states

Configuration:

substitutions:
  require_disarm_before_rearm: false  # Set to true to require disarm before switching armed states (default: false)

Default behavior:

• Disarm always required when triggered (security enforced at ESPHome level)
• Switching between armed states allowed by default (require_disarm_before_rearm: false)
• Can be made more restrictive by setting substitution to true

Note: While Home Assistant typically handles alarm state logic, this improvement provides additional enforcement at the ESPHome level for defense-in-depth.

Result: More robust alarm state handling with proper transition enforcement at the ESPHome level.

Community Contribution

Special thanks to @ecov773 for identifying this improvement opportunity and providing the implementation.

Pull Request: #2981

Technical Details

This improvement strengthens alarm security at the ESPHome level by restricting state transitions when the alarm is armed, arming, or triggered. The only permitted action from triggered state is disarm, providing defense-in-depth alongside Home Assistant's alarm control logic.

Result: Enhanced alarm security with proper state transition enforcement at the ESPHome level.

New dynamic QR codes, wake-up control, and alarm improvements. Thanks @ecov773!