Hitachi Yutaki – Robust Modbus Reconnection Handling (v1.9.4)
A new release of the Hitachi Yutaki integration focused on improving reliability and stability when dealing with network interruptions and Modbus gateway connectivity issues.
✨ What's New?
- Robust Modbus Reconnection Handling: The integration now gracefully handles network disconnects and automatically recovers connectivity with intelligent retry logic:
- Automatic connection recovery with exponential backoff (up to 3 retry attempts)
- Proper cleanup and reset of stale connections before reconnecting
- Enhanced error handling and logging for connection attempts
- Ensures all entities properly recover once the connection is restored after network interruptions
- Prevents integration crashes or unexpected behavior during network outages
- Improved Connection State Management: The Modbus client connection handling has been completely refactored using asyncio, providing more reliable connection state tracking and recovery mechanisms.
- Better Error Recovery: Connection errors now trigger automatic connection cleanup and reset, preventing stuck states and ensuring fresh connection attempts.
🔧 Maintenance Updates
- Development Tools:
📝 Important Notes
- No breaking changes; existing setups continue to work seamlessly.
- This release addresses connectivity issues that could occur after network interruptions or Modbus gateway disconnections.
- The integration will now automatically retry failed connections with exponential backoff, improving resilience in unstable network environments.
- Users experiencing reconnection problems should see significant improvements in stability.
🧪 Testing Needed
We would appreciate feedback on:
- Connection Recovery: Verify that the integration properly recovers after temporary network interruptions (router restart, network cable unplugged/replugged, WiFi disconnection).
- Gateway Reconnection: Test behavior when the Modbus gateway is temporarily unavailable or powered off/on.
- Entity State Management: Confirm that all entities correctly transition to
unavailableduring connection failures and back to normal state once connectivity is restored. - Retry Behavior: Observe the retry mechanism during prolonged network outages (should retry up to 3 times with exponential backoff).
🐛 Bug Reports
If you encounter any issues, please open a GitHub issue and include:
- Your Home Assistant version.
- Your configuration (heat pump model, gateway type, network setup).
- Debug-level logs showing connection attempts and retry behavior.
- A clear description of the problem, including:
- When the issue occurs (startup, during operation, after network interruption).
- Duration of network interruptions before issues appear.
- Whether entities recover correctly after connectivity is restored.
- Network environment details (WiFi, wired, router model if relevant).
Thanks for helping improve the reliability and resilience of the Hitachi Yutaki integration!