Add exception for legacy v6

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.6.6] - 2026-04-28
+
+### Added
+
+- Introduce TLS adjustment for legacy v6 devices
+
 ## [0.6.5] - 2026-04-28
 
 ### Added

airos/base.py

@@ -8,6 +8,7 @@
 from http.cookies import SimpleCookie
 import json
 import logging
+from ssl import SSLError
 from typing import Any, Generic, TypeVar
 from urllib.parse import urlparse
 
@@ -27,6 +28,7 @@
     AirOSDeviceConnectionError,
     AirOSKeyDataMissingError,
     AirOSMultipleMatchesFoundException,
+    AirOSTLSCompatibilityError,
     AirOSUrlNotFoundError,
 )
 from .model_map import UispAirOSProductMapper
@@ -256,7 +258,7 @@
                 self._auth_cookie = f"{morsel.key}={morsel.value}"
                 break
 
     async def _request_json(
         self,
         method: str,
         url: str,
@@ -308,6 +310,11 @@
             if err.status == 404:
                 raise AirOSUrlNotFoundError from err
             raise AirOSConnectionSetupError from err
+        except aiohttp.ClientConnectorSSLError as err:
+            if _is_tls_compatibility_error(err):
+                _LOGGER.exception("TLS compatibility error during API call to %s", url)
+                raise AirOSTLSCompatibilityError from err
+            raise AirOSDeviceConnectionError from err
         except (TimeoutError, aiohttp.ClientError) as err:
             _LOGGER.exception("Error during API call to %s", url)
             raise AirOSDeviceConnectionError from err
@@ -512,3 +519,18 @@
             ct_json=True,
             authenticated=True,
         )
+
+
+def _is_tls_compatibility_error(err: aiohttp.ClientConnectorSSLError) -> bool:
+    """Return True for known legacy airOS TLS handshake failures."""
+    if "SSLV3_ALERT_HANDSHAKE_FAILURE" in str(err):
+        return True
+
+    cause = err.__cause__
+    if isinstance(cause, SSLError):
+        message = str(cause).lower()
+        return (
+            "handshake failure" in message or "sslv3 alert handshake failure" in message
+        )
+
+    return False

airos/exceptions.py

@@ -47,3 +47,7 @@ class AirOSUrlNotFoundError(AirOSException):
 
 class AirOSMultipleMatchesFoundException(AirOSException):
     """Raised when multiple devices found for lookup."""
+
+
+class AirOSTLSCompatibilityError(AirOSDeviceConnectionError):
+    """The device requires legacy TLS/cipher compaitibility."""

airos/helpers.py

@@ -12,6 +12,7 @@
     AirOSDataMissingError,
     AirOSDeviceConnectionError,
     AirOSKeyDataMissingError,
+    AirOSTLSCompatibilityError,
 )
 
 _LOGGER = logging.getLogger(__name__)
@@ -38,6 +39,9 @@ async def async_get_firmware_data(
     try:
         await detect_device.login()
         device_data = await detect_device.raw_status()
+    except AirOSTLSCompatibilityError:
+        _LOGGER.exception("TLS compatibility error during API call to %s", host)
+        raise
     except (
         AirOSConnectionSetupError,
         AirOSDeviceConnectionError,

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name            = "airos"
-version         = "0.6.5"
+version         = "0.6.6ab"
 license         = "MIT"
 description     = "Ubiquiti airOS module(s) for Python 3."
 readme          = "README.md"