HomeAssistant_Integrations/modbus_rtu_monitor
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fixing reconnect issues after outage by simplifying

Browse Source
This commit is contained in:
Constantin Pascal
2025-12-30 13:49:34 +02:00
parent 790aae2ac7
commit 7cfc1c56ec
2 changed files with 30 additions and 82 deletions
Download Patch File Download Diff File Expand all files Collapse all files
const.py
+1 -1
View File
@@ -55,7 +55,7 @@ REGISTER_START_ADDRESS_3 = 0x8C # Register 140 (decimal)
REGISTER_MONITOR_COUNT_3 = 23 # Number of registers to monitor (140-162) REGISTER_MONITOR_COUNT_3 = 23 # Number of registers to monitor (140-162)
# Availability timeout (if no data for 5 minutes, mark unavailable) # Availability timeout (if no data for 5 minutes, mark unavailable)
AVAILABILITY_TIMEOUT = timedelta(minutes=5) AVAILABILITY_TIMEOUT = timedelta(minutes=1)
# Update throttling (prevent overwhelming HA with high-frequency Modbus traffic) # Update throttling (prevent overwhelming HA with high-frequency Modbus traffic)
COORDINATOR_UPDATE_INTERVAL = timedelta(seconds=5) # Minimum time between coordinator updates COORDINATOR_UPDATE_INTERVAL = timedelta(seconds=5) # Minimum time between coordinator updates
hub.py
+29 -81
View File
@@ -212,96 +212,58 @@ class ModbusRTUMonitorHub:
return True return True
async def _connect(self) -> None: async def _connect(self) -> None:
"""Establish TCP connection.""" """Connect or reconnect to Modbus gateway."""
self._reader, self._writer = await asyncio.wait_for( # Close existing connection if present
asyncio.open_connection(self.host, self.port),
timeout=10.0,
)
_LOGGER.info(
"Connected to Modbus RTU gateway at %s:%s", self.host, self.port
)
async def _reconnect(self) -> None:
"""Reconnect to Modbus gateway after connection loss."""
# Close existing connection and null out references
if self._writer: if self._writer:
try: try:
self._writer.close() self._writer.close()
await self._writer.wait_closed() await self._writer.wait_closed()
except Exception as ex: except Exception as ex:
_LOGGER.debug("Error closing writer during reconnect: %s", ex) _LOGGER.debug("Error closing writer: %s", ex)
# Always null out reader/writer to ensure clean state # Null out reader/writer
self._reader = None self._reader = None
self._writer = None self._writer = None
# Wait before reconnecting (30 seconds to prevent DDOS during server outages) # Attempt connection
await asyncio.sleep(30)
# Attempt reconnection
try: try:
await self._connect() self._reader, self._writer = await asyncio.wait_for(
_LOGGER.info("Reconnected to Modbus gateway at %s:%s", self.host, self.port) asyncio.open_connection(self.host, self.port),
timeout=30.0,
)
_LOGGER.info("Connected to Modbus gateway at %s:%s", self.host, self.port)
except Exception as ex: except Exception as ex:
_LOGGER.error( _LOGGER.warning(
"Reconnection failed for %s:%s - %s (will retry in 30 seconds)", "Connection failed for %s:%s - %s (will retry)",
self.host, self.host,
self.port, self.port,
ex, ex,
) )
# Reader/writer are already None, loop will detect this and retry # Reader/writer are already None, will retry on next iteration
async def _monitor_loop(self) -> None: async def _monitor_loop(self) -> None:
"""Main monitoring loop for passive frame reception.""" """Main monitoring loop for passive frame reception."""
buffer = bytearray() buffer = bytearray()
first_connection_attempt = True
consecutive_timeouts = 0
TIMEOUT_THRESHOLD = 30 # 30 timeouts = 30 seconds of no data
while True: while True:
try: try:
# Check if reader is valid before attempting to read # Check if reader is valid before attempting to read
if self._reader is None: if self._reader is None:
consecutive_timeouts = 0 # Reset counter after reconnect attempt _LOGGER.info("Attempting connection to %s:%s", self.host, self.port)
if first_connection_attempt: await self._connect()
# First connection attempt - try immediately without delay
_LOGGER.info("Attempting initial connection to %s:%s", self.host, self.port)
first_connection_attempt = False
try:
await self._connect()
_LOGGER.info("Connected to Modbus gateway at %s:%s", self.host, self.port)
except Exception as ex:
_LOGGER.warning(
"Initial connection failed to %s:%s - %s (will retry)",
self.host,
self.port,
ex,
)
# Fall through to reconnect logic with delay
await asyncio.sleep(30)
else:
# Subsequent reconnection attempts - use delay to prevent DDOS
_LOGGER.info("No active connection to %s:%s, attempting reconnect", self.host, self.port)
await self._reconnect()
# Clear buffer for fresh start after connection attempt
buffer.clear() buffer.clear()
continue continue
# Read with timeout to allow graceful shutdown # Read with 30-second timeout (includes reconnection delay)
data = await asyncio.wait_for(self._reader.read(1024), timeout=1.0) data = await asyncio.wait_for(self._reader.read(1024), timeout=30.0)
if not data: if not data:
# Connection closed gracefully # Connection closed gracefully
_LOGGER.warning("Connection closed to %s:%s, attempting reconnect", self.host, self.port) _LOGGER.warning("Connection closed to %s:%s, reconnecting", self.host, self.port)
consecutive_timeouts = 0 # Reset counter await self._connect()
await self._reconnect()
# Clear buffer for fresh start after reconnection
buffer.clear() buffer.clear()
continue continue
# Successfully received data - reset timeout counter
consecutive_timeouts = 0
buffer.extend(data) buffer.extend(data)
# Process frames from buffer (limit iterations to prevent blocking) # Process frames from buffer (limit iterations to prevent blocking)
@@ -336,26 +298,14 @@ class ModbusRTUMonitorHub:
await asyncio.sleep(FRAME_PROCESSING_DELAY) await asyncio.sleep(FRAME_PROCESSING_DELAY)
except asyncio.TimeoutError: except asyncio.TimeoutError:
# Track consecutive timeouts to detect dead connections # No data for 30 seconds - connection dead, reconnect directly
consecutive_timeouts += 1 _LOGGER.warning(
"Read timeout after 30 seconds on %s:%s - connection dead, reconnecting",
if consecutive_timeouts >= TIMEOUT_THRESHOLD: self.host,
# Connection appears dead (30+ seconds of no data) self.port,
_LOGGER.warning( )
"Connection timeout to %s:%s (%d consecutive timeouts, %ds with no data) - assuming connection dead, will reconnect", await self._connect()
self.host, buffer.clear()
self.port,
consecutive_timeouts,
consecutive_timeouts,
)
# Null reader/writer to trigger reconnection on next iteration
self._reader = None
self._writer = None
consecutive_timeouts = 0
# Clear buffer for fresh start
buffer.clear()
# Continue to next iteration (either to reconnect or wait for next timeout)
continue continue
except asyncio.CancelledError: except asyncio.CancelledError:
break break
@@ -370,14 +320,12 @@ class ModbusRTUMonitorHub:
# Null out connection and trigger reconnect # Null out connection and trigger reconnect
self._reader = None self._reader = None
self._writer = None self._writer = None
consecutive_timeouts = 0 # Reset counter await self._connect()
await self._reconnect()
buffer.clear() buffer.clear()
continue continue
except Exception as ex: except Exception as ex:
# Other unexpected errors # Other unexpected errors
_LOGGER.error("Unexpected error in monitor loop for %s:%s - %s", self.host, self.port, ex) _LOGGER.error("Unexpected error in monitor loop for %s:%s - %s", self.host, self.port, ex)
consecutive_timeouts = 0 # Reset counter on unexpected errors
await asyncio.sleep(5) await asyncio.sleep(5)
async def _handle_frame(self, frame: ModbusRTUFrame) -> None: async def _handle_frame(self, frame: ModbusRTUFrame) -> None:
@@ -691,7 +639,7 @@ class ModbusRTUMonitorHub:
"""Periodically check slave availability.""" """Periodically check slave availability."""
while True: while True:
try: try:
await asyncio.sleep(60) # Check every minute await asyncio.sleep(15) # Check every 15 s
self._check_slave_availability() self._check_slave_availability()
except asyncio.CancelledError: except asyncio.CancelledError:
break break