Method update_scan_mode

multi_interface.py:450–488

(self, mode: Optional[str] = None, focus_interface: Optional[str] = None)

            )

    def update_scan_mode(self, mode: Optional[str] = None, focus_interface: Optional[str] = None) -> Dict:
        requested_mode = self.get_scan_mode()
        if mode is not None:
            normalized = str(mode).strip().lower()
            if normalized not in (self.MODE_SINGLE, self.MODE_MULTI):
                raise ValueError("mode must be 'single' or 'multi'")
            requested_mode = normalized

        focus_provided = focus_interface is not None
        sanitized_focus = None
        if focus_provided:
            sanitized_focus = self._sanitize_interface_name(focus_interface)

        changed = False
        if self.shared_data.config.get('wifi_multi_scan_mode') != requested_mode:
            self.shared_data.config['wifi_multi_scan_mode'] = requested_mode
            changed = True

        desired_multi_flag = (requested_mode == self.MODE_MULTI)
        if bool(self.shared_data.config.get('wifi_multi_network_scans_enabled', False)) != desired_multi_flag:
            self.shared_data.config['wifi_multi_network_scans_enabled'] = desired_multi_flag
            changed = True

        if focus_provided:
            self.shared_data.config['wifi_multi_scan_focus_interface'] = sanitized_focus or ''
            changed = True
        elif requested_mode == self.MODE_SINGLE and not self.get_focus_interface():
            auto_focus = self._auto_focus_interface() or ''
            self.shared_data.config['wifi_multi_scan_focus_interface'] = auto_focus
            changed = True

        if changed:
            try:
                self.shared_data.save_config()
            except Exception as exc:
                logger.warning(f"Unable to persist multi-interface scan mode: {exc}")

        self._refresh_focus_flags()
        return self.get_state_payload()

    # ------------------------------------------------------------------
    # Helpers