v3.1.3 Beta

🚀 v3.1.3 Beta - HACS Ready Release

This release makes the integration fully HACS compliant. Users can now install everything directly from HACS without any manual file copying.

---

✨ What's New

• One-Click HACS Installation - The CLI is now bundled inside the integration. No more manual copying of files!
• Simplified Setup - Configuration only requires host, port, username, and password. CLI path is auto-detected.
• Cleaner Architecture - All integration files are now self-contained in custom_components/ipcom/

---

📦 Installation

Via HACS (Recommended)

1. Open HACS → Integrations → ⋮ menu → Custom repositories
2. Add: https://github.com/J-Delsinne/AnB_Rimex-HomeAnyWhere-HA-Integration
3. Category: Integration
4. Install and restart Home Assistant
5. Create /config/ipcom/devices.yaml with your device configuration
6. Add the integration via Settings → Devices & Services

---

⚠️ Breaking Changes

• CLI Path Removed - The CLI path configuration option has been removed. Existing configurations will continue to work, but the bundled CLI is now used automatically.
• Folder Structure Changed - The standalone /config/ipcom/ CLI folder is no longer required. The CLI is now at custom_components/ipcom/cli/

---

🔧 Migration from v3.0.0

If upgrading from v3.0.0:

1. Update via HACS or replace custom_components/ipcom/
2. Keep your /config/ipcom/devices.yaml - it will still be used
3. The old /config/ipcom/ CLI files can be removed (keep only devices.yaml)
4. Restart Home Assistant

---

📁 New File Structure

custom_components/ipcom/
├── cli/                    # Bundled CLI (NEW - auto-installed)
│   ├── ipcom_cli.py
│   ├── ipcom_tcp_client.py
│   ├── frame_builder.py
│   ├── models.py
│   └── devices.example.yaml
├── __init__.py
├── config_flow.py
├── coordinator.py
├── const.py
├── cover.py
├── light.py
├── manifest.json
└── translations/
    └── en.json

---

📋 Full Changelog

• Bundled CLI inside custom_components/ipcom/cli/
• Added get_cli_path() for automatic CLI detection
• Added get_devices_yaml_path() for flexible device config location
• Removed CLI path from config flow UI
• Updated translations to remove CLI path references
• Added hacs.json for HACS compatibility
• Updated manifest.json with documentation and issue tracker URLs
• Simplified README with new installation instructions

---

This is a pre-release. Please report any issues on GitHub Issues.

v3.1.2 Beta

🚀 v3.1.2 Beta - HACS Ready Release

This release makes the integration fully HACS compliant. Users can now install everything directly from HACS without any manual file copying.

---

✨ What's New

• One-Click HACS Installation - The CLI is now bundled inside the integration. No more manual copying of files!
• Simplified Setup - Configuration only requires host, port, username, and password. CLI path is auto-detected.
• Cleaner Architecture - All integration files are now self-contained in custom_components/ipcom/

---

📦 Installation

Via HACS (Recommended)

1. Open HACS → Integrations → ⋮ menu → Custom repositories
2. Add: https://github.com/J-Delsinne/AnB_Rimex-HomeAnyWhere-HA-Integration
3. Category: Integration
4. Install and restart Home Assistant
5. Create /config/ipcom/devices.yaml with your device configuration
6. Add the integration via Settings → Devices & Services

---

⚠️ Breaking Changes

• CLI Path Removed - The CLI path configuration option has been removed. Existing configurations will continue to work, but the bundled CLI is now used automatically.
• Folder Structure Changed - The standalone /config/ipcom/ CLI folder is no longer required. The CLI is now at custom_components/ipcom/cli/

---

🔧 Migration from v3.0.0

If upgrading from v3.0.0:

1. Update via HACS or replace custom_components/ipcom/
2. Keep your /config/ipcom/devices.yaml - it will still be used
3. The old /config/ipcom/ CLI files can be removed (keep only devices.yaml)
4. Restart Home Assistant

---

📁 New File Structure

custom_components/ipcom/
├── cli/                    # Bundled CLI (NEW - auto-installed)
│   ├── ipcom_cli.py
│   ├── ipcom_tcp_client.py
│   ├── frame_builder.py
│   ├── models.py
│   └── devices.example.yaml
├── __init__.py
├── config_flow.py
├── coordinator.py
├── const.py
├── cover.py
├── light.py
├── manifest.json
└── translations/
    └── en.json

---

📋 Full Changelog

• Bundled CLI inside custom_components/ipcom/cli/
• Added get_cli_path() for automatic CLI detection
• Added get_devices_yaml_path() for flexible device config location
• Removed CLI path from config flow UI
• Updated translations to remove CLI path references
• Added hacs.json for HACS compatibility
• Updated manifest.json with documentation and issue tracker URLs
• Simplified README with new installation instructions

---

This is a pre-release. Please report any issues on GitHub Issues.

v3.1.1 Beta

🚀 v3.1.1 Beta - HACS Ready Release

This release makes the integration fully HACS compliant. Users can now install everything directly from HACS without any manual file copying.

---

✨ What's New

• One-Click HACS Installation - The CLI is now bundled inside the integration. No more manual copying of files!
• Simplified Setup - Configuration only requires host, port, username, and password. CLI path is auto-detected.
• Cleaner Architecture - All integration files are now self-contained in custom_components/ipcom/

---

📦 Installation

Via HACS (Recommended)

1. Open HACS → Integrations → ⋮ menu → Custom repositories
2. Add: https://github.com/J-Delsinne/AnB_Rimex-HomeAnyWhere-HA-Integration
3. Category: Integration
4. Install and restart Home Assistant
5. Create /config/ipcom/devices.yaml with your device configuration
6. Add the integration via Settings → Devices & Services

---

⚠️ Breaking Changes

• CLI Path Removed - The CLI path configuration option has been removed. Existing configurations will continue to work, but the bundled CLI is now used automatically.
• Folder Structure Changed - The standalone /config/ipcom/ CLI folder is no longer required. The CLI is now at custom_components/ipcom/cli/

---

🔧 Migration from v3.0.0

If upgrading from v3.0.0:

1. Update via HACS or replace custom_components/ipcom/
2. Keep your /config/ipcom/devices.yaml - it will still be used
3. The old /config/ipcom/ CLI files can be removed (keep only devices.yaml)
4. Restart Home Assistant

---

📁 New File Structure

custom_components/ipcom/
├── cli/                    # Bundled CLI (NEW - auto-installed)
│   ├── ipcom_cli.py
│   ├── ipcom_tcp_client.py
│   ├── frame_builder.py
│   ├── models.py
│   └── devices.example.yaml
├── __init__.py
├── config_flow.py
├── coordinator.py
├── const.py
├── cover.py
├── light.py
├── manifest.json
└── translations/
    └── en.json

---

📋 Full Changelog

• Bundled CLI inside custom_components/ipcom/cli/
• Added get_cli_path() for automatic CLI detection
• Added get_devices_yaml_path() for flexible device config location
• Removed CLI path from config flow UI
• Updated translations to remove CLI path references
• Added hacs.json for HACS compatibility
• Updated manifest.json with documentation and issue tracker URLs
• Simplified README with new installation instructions

---

This is a pre-release. Please report any issues on GitHub Issues.

v3.1.0 Beta

🚀 v3.1.0 Beta - HACS Ready Release

This release makes the integration fully HACS compliant. Users can now install everything directly from HACS without any manual file copying.

---

✨ What's New

• One-Click HACS Installation - The CLI is now bundled inside the integration. No more manual copying of files!
• Simplified Setup - Configuration only requires host, port, username, and password. CLI path is auto-detected.
• Cleaner Architecture - All integration files are now self-contained in custom_components/ipcom/

---

📦 Installation

Via HACS (Recommended)

1. Open HACS → Integrations → ⋮ menu → Custom repositories
2. Add: https://github.com/J-Delsinne/AnB_Rimex-HomeAnyWhere-HA-Integration
3. Category: Integration
4. Install and restart Home Assistant
5. Create /config/ipcom/devices.yaml with your device configuration
6. Add the integration via Settings → Devices & Services

---

⚠️ Breaking Changes

• CLI Path Removed - The CLI path configuration option has been removed. Existing configurations will continue to work, but the bundled CLI is now used automatically.
• Folder Structure Changed - The standalone /config/ipcom/ CLI folder is no longer required. The CLI is now at custom_components/ipcom/cli/

---

🔧 Migration from v3.0.0

If upgrading from v3.0.0:

1. Update via HACS or replace custom_components/ipcom/
2. Keep your /config/ipcom/devices.yaml - it will still be used
3. The old /config/ipcom/ CLI files can be removed (keep only devices.yaml)
4. Restart Home Assistant

---

📁 New File Structure

custom_components/ipcom/
├── cli/                    # Bundled CLI (NEW - auto-installed)
│   ├── ipcom_cli.py
│   ├── ipcom_tcp_client.py
│   ├── frame_builder.py
│   ├── models.py
│   └── devices.example.yaml
├── __init__.py
├── config_flow.py
├── coordinator.py
├── const.py
├── cover.py
├── light.py
├── manifest.json
└── translations/
    └── en.json

---

📋 Full Changelog

• Bundled CLI inside custom_components/ipcom/cli/
• Added get_cli_path() for automatic CLI detection
• Added get_devices_yaml_path() for flexible device config location
• Removed CLI path from config flow UI
• Updated translations to remove CLI path references
• Added hacs.json for HACS compatibility
• Updated manifest.json with documentation and issue tracker URLs
• Simplified README with new installation instructions

---

This is a pre-release. Please report any issues on GitHub Issues.

v3.0.0 Beta

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)