Oakrey.ASRockMotherboard 2.0.4

Oakrey.ASRockMotherboard

Managed .NET wrapper for the ASRock IMB-1222 industrial motherboard native SDK (AsrCore.dll). Targets Windows only. Provides a clean, interface-driven API for GPIO control and hardware telemetry without exposing P/Invoke details to consumers.

Main features

• GPIO pin control for pins 71-77 and 80: read state, set input mode, set output high/low
• Read CPU core temperature and package temperature
• Read DC-in voltage
• Read board serial number
• Query native SDK version (AsrCore.dll)
• Motherboard compatibility check at construction time (manufacturer: ASRock, model: IMB-1222)
• Structured error model via AsrException and the Error enum covering all SDK error codes

Architecture

classDiagram
    class IAsrMotherboard {
        +GetCoreCount() int
        +GetCoreTemp() short
        +GetPackageTemp() short
        +GetDcInVoltage() double
        +GetSerialNo() string
        +GetDllVersion() Version
        +GetGpioState(pin) bool
        +IsGpioInput(pin) bool
        +SetGpioInput(pin)
        +SetGpioOutState(pin, value)
        +Dispose()
    }
    class AsrMotherboard {
        +Create() IAsrMotherboard
    }
    class ASRockNativeMethods {
        <<static>>
        P/Invoke to AsrCore.dll
    }
    class AsrException {
        +Error Error
        +ThrowIfError(bool)
        +ThrowIfError(Error)
    }
    IAsrMotherboard <|.. AsrMotherboard
    AsrMotherboard --> ASRockNativeMethods
    AsrMotherboard --> AsrException

Key types:

Requirements

• Windows (x64)
• .NET 10
• ASRock IMB-1222 motherboard
• AsrCore.dll present in the application output directory (included in the NuGet package)

Installation

.NET CLI

dotnet add package Oakrey.ASRockMotherboard

Package Manager Console

Install-Package Oakrey.ASRockMotherboard

AsrCore.dll is copied to the output directory automatically via the package's content files.

Usage

using Oakrey.ASRockMotherboard;

using IAsrMotherboard board = AsrMotherboard.Create();

// Telemetry
Console.WriteLine($"Core temp    : {board.GetCoreTemp()} C");
Console.WriteLine($"Package temp : {board.GetPackageTemp()} C");
Console.WriteLine($"DC-in voltage: {board.GetDcInVoltage():F2} V");
Console.WriteLine($"Core count   : {board.GetCoreCount()}");
Console.WriteLine($"Serial no.   : {board.GetSerialNo()}");
Console.WriteLine($"SDK version  : {board.GetDllVersionString()}");

// GPIO - read
bool state = board.GetGpioState(AvailableGPIO.GPIO71);
bool isInput = board.IsGpioInput(AvailableGPIO.GPIO71);

// GPIO - configure as output and drive high
board.SetGpioOutState(AvailableGPIO.GPIO72, true);

// GPIO - configure as input
board.SetGpioInput(AvailableGPIO.GPIO72);

AsrMotherboard.Create() throws AsrException if:

• the motherboard is not an ASRock IMB-1222
• AsrCore.dll fails to initialize

All GPIO and telemetry methods also throw AsrException on SDK failure. Check AsrException.Error for the specific Error code.

Development notes

• AsrMotherboard constructor sets all GPIO pins to input mode as a safe default.
• P/Invoke uses LibraryImport (source-generated marshalling) wherever possible, falling back to DllImport only for GetSerialNumber due to array marshalling.
• The library uses System.Management (WMI) to verify motherboard compatibility at startup.
• unsafe blocks are enabled in the project but are not required by the public API.

Project information

License

MIT. See the LICENSE file for details.