26 releases

0.8.1 May 7, 2024
0.7.0 Aug 18, 2022
0.6.3 Apr 14, 2022
0.6.0 Nov 7, 2021
0.1.1 Nov 24, 2019

#68 in Hardware support

Download history 466/week @ 2024-02-23 321/week @ 2024-03-01 129/week @ 2024-03-08 245/week @ 2024-03-15 173/week @ 2024-03-22 235/week @ 2024-03-29 89/week @ 2024-04-05 150/week @ 2024-04-12 322/week @ 2024-04-19 345/week @ 2024-04-26 239/week @ 2024-05-03 368/week @ 2024-05-10 52/week @ 2024-05-17 453/week @ 2024-05-24 82/week @ 2024-05-31 186/week @ 2024-06-07

838 downloads per month
Used in 3 crates

MIT license

265KB
5.5K SLoC

unsafe forbidden License

libmedium

A safe rust library to communicate with the sysfs interface of lm-sensors.

Usage

Just add this to your Cargo.toml file:

[dependencies]
libmedium = "0.8"

Cargo-Features

Standard features

  • writeable: Standard feature that enables all functions that write to sysfs. This includes setting pwm values and disabling sensors.
  • sync: Build synchronous versions of all sensors.
  • virtual_sensors: Feature that lets you create virtual sensors. Virtual sensors don't belong to sysfs but can be any file provided by a driver or the user.

Non standard features

  • uom_units: Sensor values are returned as types from the uom crate.
  • unrestricted_parsing: This feature allows parsing of paths other than '/sys/class/hwmon'. This should only be useful for testing and debugging.
  • async: Build asynchronous versions of all sensors.

Examples

  • Print the temperature of all the temp sensors in your system:
use libmedium::{
    parse_hwmons,
    sensors::sync_sensors::{temp::TempSensor, Sensor},
};

let hwmons = parse_hwmons().unwrap();
for hwmon in &hwmons {
    println!("hwmon{} with name {}:", hwmon.index(), hwmon.name());
    for (_, temp_sensor) in hwmon.temps() {
        let temperature = temp_sensor.read_input().unwrap();
        println!("\t{}: {}", temp_sensor.name(), temperature);
    }
}
  • Set the pwm value of all your pwm capable fans to full speed (this requires the writeable feature to not be disabled):
use libmedium::{
    parse_hwmons,
    sensors::sync_sensors::pwm::WriteablePwmSensor,
    units::{Pwm, PwmEnable},
};

let hwmons = parse_hwmons().unwrap();
for hwmon in &hwmons {
    for (_, pwm) in hwmon.writeable_pwms() {
        pwm.write_enable(PwmEnable::ManualControl).unwrap();
        pwm.write_pwm(Pwm::FULLSPEED).unwrap();
    }
}

License

This project is licensed under the MIT License - see the LICENSE file for details

Dependencies

~0–1.5MB
~27K SLoC