Home Information - Your home, your data, organized.
Python
import logging
import hi.apps.common.datetimeproxy as datetimeproxy
from hi.apps.alert.enums import AlarmLevel
from hi.apps.console.console_helper import ConsoleSettingsHelper
from hi.apps.config.settings_mixins import SettingsMixin
from hi.apps.monitor.periodic_monitor import PeriodicMonitor
from hi.apps.system.provider_info import ProviderInfo
from .enums import SecurityState
from .security_mixins import SecurityMixin
from .settings import SecuritySetting
logger = logging.getLogger(__name__)
class SecurityMonitor( PeriodicMonitor, SettingsMixin, SecurityMixin ):
MONITOR_ID = 'hi.apps.security.monitor'
SECURITY_POLLING_INTERVAL_SECS = 5
def __init__( self ):
super().__init__( id = self.MONITOR_ID )
self._last_security_state_check_datetime = datetimeproxy.now()
return
def get_polling_interval_secs(self) -> int:
return self.SECURITY_POLLING_INTERVAL_SECS
@classmethod
def get_provider_info(cls) -> ProviderInfo:
return ProviderInfo(
provider_id = cls.MONITOR_ID,
provider_name = 'Security Monitor',
description = 'Security state monitoring',
)
def alarm_ceiling(self):
# The security monitor drives automatic DAY/NIGHT transitions.
# If it fails, the home can be left in the wrong security mode,
# which mis-gates alarm and notification delivery for ALL other
# subsystems — treat health failures here as serious.
return AlarmLevel.CRITICAL
async def do_work(self):
try:
message = await self._check_security_state()
self.record_healthy(message)
except Exception as e:
error_msg = f"Security state check failed: {str(e)[:50]}"
logger.exception(error_msg)
self.record_error(error_msg)
return
async def _check_security_state( self ) -> str:
"""Check security state and return status message."""
logger.debug( 'Security monitor: Checking security state.' )
settings_manager = await self.settings_manager_async()
if not settings_manager:
return "Settings manager not available"
security_manager = await self.security_manager_async()
if not security_manager:
return "Security manager not available"
current_datetime = datetimeproxy.now()
tz_name = ConsoleSettingsHelper().get_tz_name()
current_state = security_manager.security_state
try:
# Some states do not allow automated changes
if not current_state.auto_change_allowed:
logger.debug( f'Security state "{current_state}". Auto-change not allowed.' )
return f"Auto-change blocked ({current_state.label} mode)"
# A missing value is a legitimate state (unconfigured, blanked
# by the user, fresh install before initial population); skip
# the transition check rather than crashing the poll cycle.
day_start_time_of_day = settings_manager.get_setting_value(
SecuritySetting.SECURITY_DAY_START,
)
if day_start_time_of_day and datetimeproxy.is_time_of_day_in_interval(
time_of_day_str = day_start_time_of_day,
tz_name = tz_name,
start_datetime = self._last_security_state_check_datetime,
end_datetime = current_datetime ):
logger.debug( 'Security state check: Setting as DAY.' )
security_manager.update_security_state_auto(
new_security_state = SecurityState.DAY,
)
return f"Transitioned {current_state.label} → Day"
night_start_time_of_day = settings_manager.get_setting_value(
SecuritySetting.SECURITY_NIGHT_START,
)
if night_start_time_of_day and datetimeproxy.is_time_of_day_in_interval(
time_of_day_str = night_start_time_of_day,
tz_name = tz_name,
start_datetime = self._last_security_state_check_datetime,
end_datetime = current_datetime ):
logger.debug( 'Security state check: Setting as NIGHT.' )
security_manager.update_security_state_auto(
new_security_state = SecurityState.NIGHT,
)
return f"Transitioned {current_state.label} → Night"
logger.debug( 'Security monitor: No change needed.' )
return f"No change needed ({current_state.label} mode)"
finally:
self._last_security_state_check_datetime = current_datetime