Class SharedData

shared.py:193–2021

Shared data between the different modules.

    # joystick). Square panel: use a square reference so the layout isn't
    # stretched; the on-screen frame/stat pages scale to fit 128x128.
    "st7735s":     {"ref_width": 128, "ref_height": 128, "default_flip": False},
    # Whisplay HAT 1.69" ST7789 240x280 colour TFT LCD (ref height keeps the
    # 240:280 aspect so the layout isn't stretched: 122 * 280/240 = 142)
    "whisplay":    {"ref_width": DESIGN_REF_WIDTH, "ref_height": 142, "default_flip": False},
    # SSD1306 0.96" 128x64 monochrome OLED
    "ssd1306":     {"ref_width": 128, "ref_height": 64,  "default_flip": False},
    # LCD1602 16x2 character LCD (I2C via PCF8574 backpack)
    "lcd1602":     {"ref_width": 16,  "ref_height": 2,   "default_flip": False},
    # MAX7219 LED matrix displays
    "max7219_4panel": {"ref_width": 32,  "ref_height": 8, "default_flip": False},
    "max7219_8panel": {"ref_width": 64,  "ref_height": 8, "default_flip": False},
}


logger = Logger(name="shared.py", level=logging.DEBUG) # Create a logger object 

class SharedData:
    """Shared data between the different modules."""
    def __init__(self):
        # Detect Pager mode (set by pager_payload.sh before Python launch)
        self._pager_mode = os.environ.get('RAGNAR_PAGER_MODE') == '1'

        self.initialize_paths() # Initialize the paths used by the application

        # --- Network storage & context (not available on Pager) ---
        if not self._pager_mode and NetworkStorageManager is not None:
            self.storage_manager = NetworkStorageManager(self.datadir)
        else:
            self.storage_manager = None
        self.active_network_ssid = None
        self.active_network_slug = None
        self.current_network_dir = None
        self.current_network_db_path = None
        self.network_intelligence_dir = None
        self.network_threat_dir = None
        if self.storage_manager is not None:
            self._apply_network_context(
                self.storage_manager.get_active_context(),
                configure_db=False
            )
        if not self._pager_mode and NetworkContextRegistry is not None:
            self.context_registry = NetworkContextRegistry(self)
        else:
            self.context_registry = None

        self.status_list = []
        self.last_comment_time = time.time() # Last time a comment was displayed
        self._stats_lock = threading.Lock()  # Thread-safe lock for update_stats()
        self._config_lock = threading.RLock()  # Serializes save_config() vs mutations
        self.default_config = self.get_default_config() # Default configuration of the application
        self.config = self.default_config.copy() # Configuration of the application
        # Load existing configuration first
        self.load_config()

        if not self._pager_mode and MultiInterfaceState is not None:
            self.multi_interface_state = MultiInterfaceState(self)
        else:
            self.multi_interface_state = None