Skip to content

v3.0.0 Beta

Choose a tag to compare

View all tags
@J-Delsinne J-Delsinne released this 11 Jan 22:05
old
cf8ae97
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Release v3.0.0 Beta - IPCom Home Anywhere Blue Integration

Highlights

This release focuses on connection stability, credential security, and improved troubleshooting for the IPCom integration.

New Features

Connection Stability Improvements

  • Unlimited automatic reconnection - Integration now retries indefinitely with exponential backoff (5s → 10s → 20s → ... → max 60s)
  • Health monitoring loop - Detects stale connections and triggers automatic recovery
  • Session statistics tracking - Tracks uptime, reconnect counts, and error types for diagnostics

Enhanced Logging System

  • Structured log prefixes for easy filtering:
    • CLI_START, CLI_EXIT, CLI_EOF - Subprocess lifecycle
    • AUTH_TIMEOUT, AUTH_RESET, AUTH_BROKEN_PIPE - Authentication issues
    • CONN_LOST, RECONNECT_OK - Connection state changes
    • HEALTH_OK, HEALTH_TIMEOUT - Health check status
  • Error categorization with possible causes for faster troubleshooting
  • Connection statistics logged on reconnection (total restarts, error history, session uptime)

Config Flow Error Handling

  • Fixed empty error messages during first-time setup
  • CLI errors are now properly captured and displayed to users
  • Specific error messages for:
    • Authentication failures
    • Connection timeouts
    • Invalid host/port
    • CLI script issues

Bug Fixes

  • Fixed Python executable detection - Now uses sys.executable for reliable cross-platform support (Docker, Windows, macOS)
  • Fixed CLI output capture - Changed from check=True to check=False to capture error output from stdout
  • Fixed shutter race condition - Shadow state pattern prevents conflicting relay commands
  • Fixed device grouping - Added device_info to entities for proper grouping in Home Assistant

Security Improvements

  • Removed hardcoded credentials - All credentials now configured via UI
  • Sanitized log output - Credentials hidden in debug logs (... (credentials hidden))
  • File sanitization - Cleaned sensitive data from configuration files

Technical Changes

  • Command delay implementation for reliable device control
  • Improved subprocess management with proper cleanup on exit
  • Better error propagation from CLI to Home Assistant UI
  • Updated manifest version to 3.0.0

Breaking Changes

None - This is a drop-in upgrade from v2.x.

Known Issues (Beta)

  • This is a beta release - please report any issues on GitHub
  • Enable debug logging for detailed troubleshooting: add custom_components.ipcom: debug to your logger configuration

Upgrade Instructions

  1. Backup your current configuration
  2. Replace the custom_components/ipcom folder with the new version
  3. Replace the ipcom CLI folder with the new version
  4. Restart Home Assistant
  5. Re-add the integration if prompted (credentials are now stored securely)
Assets 2
Loading