Skip to content

A toolkit for accessing RAMs SPD. Primarily used for reading temperature and data from SPD.

License

Notifications You must be signed in to change notification settings

Blacktempel/RAMSPDToolkit

Repository files navigation

RAMSPDToolkit

GitHub license Build master Nuget Nuget Nuget

A toolkit for accessing RAMs SPD. Primarily used for reading temperature and data from SPD.
Reading from SPD is standardized by JEDEC, for the most part.

Warning - writing via SMBus and to SPD is dangerous

It is possible and supported to write data via SMBus, but NOT recommended and dangerous for your hardware.
You can also write data to the SPD via SMBus, when write protection is disabled, which is also NOT recommended.
Doing so COULD brick whatever hardware you're writing to, rendering that hardware part useless.
Writing to something you should not write to means: this piece of hardware WILL be a rock, once again.
Do this at your own risk and only if you know what you are doing.

Project overview

Project .NET Version[s]
RAMSPDToolkit
RAM SPD functionality for your software / application.
Also includes various SMBus implementations for Windows and Linux.
.NET Framework 4.7.2 & 4.8.1
.NET 8 & .NET 9
ConsoleOutputTest
Example Application to show how some library functionality can be used.
.NET 8
GZipSingleFile
Small ("internal") console application used to zip driver files.
.NET 8
Tools
Tools for the project.
---

What platforms are supported ?

We currently support Windows and Linux.
There is currently no plan to support Mac / Apple Computers.

Which RAM is supported ?

We support DDR4 & DDR5 RAM on Intel & AMD systems.

Where can I download it ?

You can download the latest release from here.

How can I help improve the project ?

Feel free to give feedback and contribute to our project !
Pull requests are welcome. Please include as much information as possible.

Developer information

Integrate the library in your own application

Sample code

static class Program
{
    static void Main(string[] args)
    {
        //You can enable logging and set level, if you need logging output
        Logger.Instance.IsEnabled = true;
        Logger.Instance.LogLevel = LogLevel.Trace;

        //Check for Windows before loading driver
        if (OperatingSystem.IsWindows())
        {
            //Init OLS driver
            DriverManager.InitDriver(InternalDriver.OLS);

            //Check if OLS driver was initalized and could be loaded
            if (DriverManager.DriverImplementation == InternalDriver.OLS
             && DriverManager.Driver.Load())
            {
                Console.WriteLine("***** Driver is open. *****");
            }
            else
            {
                Console.WriteLine($"***** DRIVER ERROR *****");
                throw new Exception("Driver is not open.");
            }
        }

        //Detect SMBuses
        SMBusManager.DetectSMBuses();

        //Go through available SMBuses
        foreach (var bus in SMBusManager.RegisteredSMBuses)
        {
            //Go through possible RAM slots
            for (byte i = SPDConstants.SPD_BEGIN; i <= SPDConstants.SPD_END; i++)
            {
                //Detect what kind of RAM we have
                var detector = new SPDDetector(bus, i);

                //We have a RAM stick here
                if (detector.IsValid)
                {
                    if (detector.Accessor is IThermalSensor ts)
                    {
                        //Get temperature, if possible
                        if (ts.HasThermalSensor && ts.UpdateTemperature())
                        {
                            //Output temperature for detected RAM sticks
                            Console.WriteLine($"DIMM #{i - SPDConstants.SPD_BEGIN}: {ts.Temperature}°C / {TemperatureConverter.CelsiusToFahrenheit(ts.Temperature)}°F.");
                        }
                    }
                }
            }
        }

        //Check for Windows before unloading driver
        if (OperatingSystem.IsWindows())
        {
            //Unload the driver - this removes extracted driver files and unloads them
            DriverManager.Driver.Unload();
            Console.WriteLine("***** Closed driver *****");
        }

        //Save log file to current directory, if you enabled logging output
        Logger.Instance.SaveToFile("Log.txt", false);

        //All done
        Console.WriteLine("Press enter to exit...");
        Console.ReadLine();
    }
}

Administrator rights

Some functionality requires administrator privileges to access the data.
Consider adding a manifest file to your application and set requestedExecutionLevel to requireAdministrator.

Can I use my own driver ?

Yes, you can implement your own driver via our IDriver interface.
You just have to assign an instance to RAMSPDToolkit and it will use your implementation instead.
Please be sure to use a well tested driver.

NDD Build / Package (No Default Driver[s])

We also provide a version without any internal driver implementation or binaries. You can change compilation configuration for that or use the NDD package.

License

RAMSPDToolkit is free and open source software licensed under MPL 2.0.
You can use it in private and commercial projects.
Keep in mind that you must include a copy of the license in your project.

Sponsor this project

 

Packages

No packages published