hippox-drivers 0.3.5

//! GPU fan speed driver
//!
//! This driver provides functionality to get GPU fan speed percentage.
use crate::{
    DriverCallback, DriverCategory, DriverContext, DriverError, DriverResult,
    types::{Driver, DriverParameter},
};
use serde_json::{Value, json};
use std::collections::HashMap;
use tracing::{debug, info};
/// Driver for getting GPU fan speed
#[derive(Debug)]
pub struct GpuFanSpeedDriver;
#[async_trait::async_trait]
impl Driver for GpuFanSpeedDriver {
    /// Returns the unique name of this driver
    fn name(&self) -> &str {
        "gpu_fan_speed"
    }
    /// Returns a brief description of the driver's functionality
    fn description(&self) -> &str {
        "Get GPU fan speed percentage"
    }
    /// Returns detailed usage guidance for LLMs
    fn usage_hint(&self) -> &str {
        "Use this skill to monitor GPU cooling performance"
    }
    /// Returns the parameter definitions for this driver
    fn parameters(&self) -> Vec<DriverParameter> {
        return vec![];
    }
    /// Returns an example call for this driver
    fn example_call(&self) -> DriverResult<Value> {
        return Ok(json!({
            "action": "gpu_fan_speed",
            "parameters": {}
        }));
    }
    /// Returns an example output from this driver
    fn example_output(&self) -> String {
        return "GPU Fan Speed: 45.0%".to_string();
    }
    /// Returns the category of this driver
    fn category(&self) -> DriverCategory {
        return DriverCategory::OperatingSystemGpu;
    }
    /// Executes the driver with the given parameters
    async fn execute(
        &self,
        _parameters: &HashMap<String, Value>,
        _callback: Option<&dyn DriverCallback>,
        _context: Option<&DriverContext>,
    ) -> DriverResult<String> {
        debug!("Executing gpu_fan_speed driver");
        let speed = get_gpu_fan_speed()?;
        info!("GPU fan speed: {:.1}%", speed);
        return Ok(format!("GPU Fan Speed: {:.1}%", speed));
    }
}
/// Gets GPU fan speed from the system
fn get_gpu_fan_speed() -> DriverResult<f32> {
    #[cfg(target_os = "linux")]
    {
        debug!("Getting GPU fan speed on Linux");
        // Try NVIDIA
        debug!("Trying NVIDIA nvidia-smi for fan speed");
        if let Ok(output) = crate::common::hidden_cmd("nvidia-smi").args(&["--query-gpu", "fan.speed"]).args(&["--format", "csv,noheader"]).output()
        {
            if output.status.success() {
                if let Ok(output_str) = String::from_utf8(output.stdout) {
                    if let Some(line) = output_str.lines().next() {
                        if let Ok(speed) = line.trim().trim_end_matches('%').parse::<f32>() {
                            info!("NVIDIA fan speed: {:.1}%", speed);
                            return Ok(speed);
                        }
                    }
                }
            }
        }
        // Try AMD via hwmon
        debug!("Trying AMD hwmon for fan speed");
        let hwmon_path = "/sys/class/hwmon";
        if let Ok(entries) = std::fs::read_dir(hwmon_path) {
            for entry in entries {
                if let Ok(entry) = entry {
                    let path = entry.path();
                    if let Ok(name) = std::fs::read_to_string(path.join("name")) {
                        if name.trim().contains("amdgpu") || name.trim().contains("radeon") {
                            let fan_file = path.join("pwm1");
                            if let Ok(fan_str) = std::fs::read_to_string(&fan_file) {
                                if let Ok(fan) = fan_str.trim().parse::<f32>() {
                                    // pwm values are typically 0-255
                                    let speed = (fan / 255.0) * 100.0;
                                    info!("AMD hwmon fan speed (pwm1): {:.1}%", speed);
                                    return Ok(speed);
                                }
                            }
                            let fan_file2 = path.join("fan1_input");
                            if let Ok(fan_str) = std::fs::read_to_string(&fan_file2) {
                                if let Ok(fan) = fan_str.trim().parse::<f32>() {
                                    // Some AMD GPUs report RPM directly
                                    info!("AMD hwmon fan speed (fan1_input): {:.1} RPM", fan);
                                    return Ok(fan);
                                }
                            }
                            let fan_file3 = path.join("pwm2");
                            if let Ok(fan_str) = std::fs::read_to_string(&fan_file3) {
                                if let Ok(fan) = fan_str.trim().parse::<f32>() {
                                    let speed = (fan / 255.0) * 100.0;
                                    info!("AMD hwmon fan speed (pwm2): {:.1}%", speed);
                                    return Ok(speed);
                                }
                            }
                        }
                    }
                }
            }
        }
        info!("GPU fan speed not found on Linux, returning 0.0");
        return Ok(0.0);
    }
    #[cfg(target_os = "windows")]
    {
        debug!("Getting GPU fan speed on Windows");
        return get_windows_gpu_fan_speed();
    }
    #[cfg(target_os = "macos")]
    {
        debug!("Getting GPU fan speed on macOS");
        // macOS: Try SMC via istats
        if let Ok(output) = crate::common::hidden_cmd("istats").args(&["fan", "speed"]).output() {
            if output.status.success() {
                if let Ok(output_str) = String::from_utf8(output.stdout) {
                    for line in output_str.lines() {
                        if line.contains("Fan") && line.contains("RPM") {
                            if let Some(speed_str) = line.split(':').nth(1) {
                                if let Ok(rpm) = speed_str.trim().parse::<f32>() {
                                    // Assume max 5000 RPM
                                    let speed = (rpm / 5000.0) * 100.0;
                                    info!("macOS istats fan speed: {:.1}%", speed);
                                    return Ok(speed);
                                }
                            }
                        }
                    }
                }
            }
        }
        // Try via smc command
        if let Ok(output) = crate::common::hidden_cmd("smc").args(&["-f"]).output() {
            if output.status.success() {
                if let Ok(output_str) = String::from_utf8(output.stdout) {
                    for line in output_str.lines() {
                        if line.contains("Fan") && line.contains("RPM") {
                            if let Some(rpm_str) = line.split_whitespace().last() {
                                if let Ok(rpm) = rpm_str.parse::<f32>() {
                                    let speed = (rpm / 5000.0) * 100.0;
                                    info!("macOS smc fan speed: {:.1}%", speed);
                                    return Ok(speed);
                                }
                            }
                        }
                    }
                }
            }
        }
        info!("GPU fan speed not found on macOS, returning 0.0");
        return Ok(0.0);
    }
    #[cfg(not(any(target_os = "linux", target_os = "windows", target_os = "macos")))]
    {
        debug!("GPU fan speed not supported on this platform");
        return Ok(0.0);
    }
}
/// Gets GPU fan speed on Windows
#[cfg(target_os = "windows")]
fn get_windows_gpu_fan_speed() -> DriverResult<f32> {
    use std::process::Command;
    debug!("Getting GPU fan speed on Windows via nvidia-smi");
    // Try NVIDIA via nvidia-smi
    if let Ok(output) = crate::common::hidden_cmd("nvidia-smi").args(&["--query-gpu", "fan.speed"]).args(&["--format", "csv,noheader"]).output() {
        if output.status.success() {
            if let Ok(output_str) = String::from_utf8(output.stdout) {
                if let Some(line) = output_str.lines().next() {
                    if let Ok(speed) = line.trim().trim_end_matches('%').parse::<f32>() {
                        info!("Windows NVIDIA fan speed: {:.1}%", speed);
                        return Ok(speed);
                    }
                }
            }
        }
    }
    // Try NVML
    #[cfg(feature = "nvml")]
    {
        debug!("Trying NVML for fan speed on Windows");
        use nvml_wrapper::Nvml;
        if let Ok(nvml) = Nvml::init() {
            if let Ok(device) = nvml.device_by_index(0) {
                if let Ok(speed) = device.fan_speed(0) {
                    info!("Windows NVML fan speed: {:.1}%", speed as f32);
                    return Ok(speed as f32);
                }
            }
        }
    }
    // Try WMI via PowerShell
    debug!("Trying PowerShell WMI for fan speed on Windows");
    let output = crate::common::hidden_cmd("powershell")
        .args(&[
            "-Command",
            "Get-CimInstance -Namespace root/wmi -ClassName MSAcpi_ThermalZoneTemperature | Select-Object -ExpandProperty CurrentTemperature",
        ])
        .output();
    // Also try OpenHardwareMonitor WMI
    let output_ohm = crate::common::hidden_cmd("powershell")
        .args(&[
            "-Command",
            "Get-WmiObject -Namespace root/OpenHardwareMonitor -Class Sensor | Where-Object {$_.SensorType -eq 'Fan'} | Select-Object -ExpandProperty Value"
        ])
        .output();
    // Try LibreHardwareMonitor WMI
    let output_lhm = crate::common::hidden_cmd("powershell")
        .args(&[
            "-Command",
            "Get-WmiObject -Namespace root/LibreHardwareMonitor -Class Sensor | Where-Object {$_.SensorType -eq 'Fan'} | Select-Object -ExpandProperty Value"
        ])
        .output();
    // Parse OpenHardwareMonitor results
    if let Ok(output) = output_ohm {
        if output.status.success() {
            if let Ok(output_str) = String::from_utf8(output.stdout) {
                for line in output_str.lines() {
                    let trimmed = line.trim();
                    if !trimmed.is_empty() {
                        if let Ok(speed) = trimmed.parse::<f32>() {
                            if speed > 0.0 && speed <= 100.0 {
                                info!("Windows OpenHardwareMonitor fan speed: {:.1}%", speed);
                                return Ok(speed);
                            }
                        }
                    }
                }
            }
        }
    }
    // Parse LibreHardwareMonitor results
    if let Ok(output) = output_lhm {
        if output.status.success() {
            if let Ok(output_str) = String::from_utf8(output.stdout) {
                for line in output_str.lines() {
                    let trimmed = line.trim();
                    if !trimmed.is_empty() {
                        if let Ok(speed) = trimmed.parse::<f32>() {
                            if speed > 0.0 && speed <= 100.0 {
                                info!("Windows LibreHardwareMonitor fan speed: {:.1}%", speed);
                                return Ok(speed);
                            }
                        }
                    }
                }
            }
        }
    }
    // Try via HWiNFO WMI if available
    let output_hwinfo = crate::common::hidden_cmd("powershell")
        .args(&[
            "-Command",
            "Get-WmiObject -Namespace root/HWiNFO -Class Sensor | Where-Object {$_.SensorType -eq 'Fan'} | Select-Object -ExpandProperty Value",
        ])
        .output();
    if let Ok(output) = output_hwinfo {
        if output.status.success() {
            if let Ok(output_str) = String::from_utf8(output.stdout) {
                for line in output_str.lines() {
                    let trimmed = line.trim();
                    if !trimmed.is_empty() {
                        if let Ok(speed) = trimmed.parse::<f32>() {
                            if speed > 0.0 && speed <= 100.0 {
                                info!("Windows HWiNFO fan speed: {:.1}%", speed);
                                return Ok(speed);
                            }
                        }
                    }
                }
            }
        }
    }
    info!("GPU fan speed not found on Windows, returning 0.0");
    return Ok(0.0);
}
#[cfg(test)]
mod tests {
    use super::*;
    #[test]
    fn test_gpu_fan_speed_metadata() {
        let driver = GpuFanSpeedDriver;
        assert_eq!(driver.name(), "gpu_fan_speed");
        assert_eq!(driver.category(), DriverCategory::OperatingSystemGpu);
    }
}