ruvnet/RuView · error · RuntimeError

Real CSI data collection from router '{self.router_id}' requ

Error message

Real CSI data collection from router '{self.router_id}' requires hardware setup that is not configured. You must: (1) install CSI-capable firmware (e.g., Atheros CSI Tool, Nexmon CSI) on the router, (2) configure the SSH connection to the router, and (3) implement the CSI extraction command for your specific firmware. For development/testing, use mock_mode=True. See docs/hardware-setup.md for complete setup instructions.

What it means

Error "Real CSI data collection from router '{self.router_id}' requires hardware setup that is not configured. You must: (1) install CSI-capable firmware (e.g., Atheros CSI Tool, Nexmon CSI) on the router, (2) configure the SSH connection to the router, and (3) implement the CSI extraction command for your specific firmware. For development/testing, use mock_mode=True. See docs/hardware-setup.md for complete setup instructions." thrown in ruvnet/RuView.

Source

Thrown at archive/v1/src/core/router_interface.py:161

        """Generate mock CSI data for testing.

        Delegates to the MockCSIGenerator in the testing module.
        This method is only callable when mock_mode is True.
        """
        if self._mock_csi_generator is None:
            self._initialize_mock_generator()
        return self._mock_csi_generator.generate()
    
    async def _collect_real_csi_data(self) -> Optional[np.ndarray]:
        """Collect real CSI data from the router.

        Raises:
            RuntimeError: Always in the current state, because real CSI
                data collection requires hardware setup that has not been
                configured. This method must never silently return random
                or placeholder data.
        """
        raise RuntimeError(
            f"Real CSI data collection from router '{self.router_id}' requires "
            "hardware setup that is not configured. You must: "
            "(1) install CSI-capable firmware (e.g., Atheros CSI Tool, Nexmon CSI) on the router, "
            "(2) configure the SSH connection to the router, and "
            "(3) implement the CSI extraction command for your specific firmware. "
            "For development/testing, use mock_mode=True. "
            "See docs/hardware-setup.md for complete setup instructions."
        )
    
    async def check_health(self) -> bool:
        """Check if the router connection is healthy.
        
        Returns:
            True if healthy, False otherwise
        """
        if not self.is_connected:
            return False
        

View on GitHub (pinned to 4685618388)

When it happens

Trigger: Thrown at archive/v1/src/core/router_interface.py:161 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/RuView@4685618388 (2026-08-16). Data as JSON: /api/errors/1c581750459848a9. Report an issue: GitHub.