AlphaOmega.SystemFirmware 1.1.8

SystemFirmware

Managed .NET wrapper for the Win32 API functions:

• GetSystemFirmwareTable
• EnumSystemFirmwareTables

Provides strongly typed access to SMBIOS firmware structures.

Features

• Enumerate and parse SMBIOS tables via native Win32 APIs
• Strongly typed model for supported SMBIOS structures
• Save and load serialized firmware snapshots (.sfw)
• Multi-targeted library (.NET Framework 3.5, .NET Standard 2.0, .NET 8)
• Simple discovery helpers (generic retrieval per type)

Installation

NuGet:

Install-Package AlphaOmega.SystemFirmware

Or with .NET CLI:

 dotnet add package AlphaOmega.SystemFirmware

Quick Start

Read baseboard (Type 2) and optionally locate USB 3.0 port connectors (Type 8):

using System;
using System.Linq;
using AlphaOmega.Debug;
using AlphaOmega.Debug.Native;
using AlphaOmega.Debug.Smb;

class Program
{
    static void Main()
    {
        FirmwareT<FirmwareSmBios> fw = new FirmwareT<FirmwareSmBios>();
        FirmwareSmBios smbios = fw.GetData().Single();

        // Motherboard vendor and name
        Baseboard baseboard = smbios.GetType<Baseboard>();
        Console.WriteLine($"Motherboard Manufacturer: {baseboard.Manufacturer} Name: {baseboard.Product}");

        // Find USB 3.0 ports (example logic)
        foreach (TypeBase type in smbios.Types)
            switch (type.Header.Type)
            {
                case SmBios.Type.PortConnector:
                    PortConnector port = (PortConnector)type;
                    if (port.Type.Port == SmBios.Type8.PortType.USB && port.InternalReferenceDesignator.StartsWith("USB_3", StringComparison.OrdinalIgnoreCase))
                        Console.WriteLine("USB 3.0 port found");
                    break;
            }
    }
}

Enumerating All SMBIOS Structures

FirmwareT<FirmwareSmBios> fw = new FirmwareT<FirmwareSmBios>();
FirmwareSmBios smbios = fw.GetData().Single();

foreach (TypeBase type in smbios.Types)
{
    Console.WriteLine($"Type {type.Header.Type} Length: {type.Header.Length}");
    // Cast based on type.Header.Type if further detail is needed
}

Saving & Loading Snapshot

Persist a firmware snapshot to reuse later or for offline analysis.

// Save
FirmwareT<FirmwareSmBios> fw = new FirmwareT<FirmwareSmBios>();
byte[] data = fw.Save();
System.IO.File.WriteAllBytes(@"C:\Temp\Firmware\smbios.sfw", data);

// Load
try
{
    FirmwareT<FirmwareSmBios> loaded = new FirmwareT<FirmwareSmBios>(System.IO.File.ReadAllBytes(@"C:\Temp\Firmware\smbios.sfw"));
}
catch (ArgumentNullException)
{
    // Empty file
}
catch (ArgumentException)
{
    // Invalid signature or wrong firmware type (e.g. ACPI data passed)
}

Supported SMBIOS Types

Notes & Limitations

• Not supported types are skipped but header metadata remains accessible.
• Some obsolete types are retained for backward compatibility; content may be limited.
• Requires Windows for native firmware table enumeration.
• Snapshot (.sfw) is a custom binary format (signature validated on load).