Zum Inhalt springen
Diese Übersetzung kann hinter der englischen Fassung zurückliegen.
.NET-Referenz (SegLcd)

.NET-Referenz (SegLcd)

Das Repository enthält eine .NET-11-Library (src/SegLcd.Core, Namespace SegLcd), die dem Leitfaden folgt. Sie ist Native-AOT-kompatibel (IsAotCompatible, AOT-Publish ohne Warnungen) und hängt nur von HidApi.Net 1.2.0 (MIT) ab – einem AOT-fähigen Binding der nativen C-Bibliothek hidapi.

Native Abhängigkeit: hidapi ≥ 0.14 muss vorhanden sein. Linux: Paket hidapi (Arch/CachyOS) bzw. libhidapi-hidraw0 (Debian/Ubuntu) → libhidapi-hidraw.so.0. Windows: hidapi.dll aus dem hidapi-Release neben die Anwendung legen.

Projekte

ProjektInhaltAbhängigkeiten
SegLcd.Core (Namespace SegLcd)Protokoll, Gerät, Session (plattformneutral)HidApi.Net
SegLcd.LinuxLinux-Sensoren (LinuxSensors, LinuxFrameSource, SensorSettings, NVML, DRM, RAPL)–
SegLcd.Localizationgettext-Lokalisierung (Details)Karambolo.PO.Compact, M.E.Localization.Abstractions, M.E.Logging.Console
SegLcd.ToolCLI seglcdDotMake.CommandLine
SegLcd.DaemonDienst seglcdd mit D-BusMicrosoft.Extensions.Hosting(.Systemd), Tmds.DBus.Protocol/Generator, Tomlyn

Bausteine

TypSchichtAufgabe
SegmentLcdFrameCodecRecord mit allen Werten (double?), Time, Unit
SegmentLcdProtocolCodecEncodeUpdate, EncodeOff, ToHidReport, Offsets-Konstanten, Feldnamen
KnownDevicesGerätbekannte VID/PID-Paare mit Verifikationsstatus
SegmentLcdDeviceGerätEnumerate(), TryOpenFirst(), SendPacket(), Send(frame), SendOff(), ReadInputReport()
SegmentLcdSessionSessionKeep-Alive-Timer, Reconnect (max. 1×/s), Update(frame), UpdateRaw(bytes), Interval zur Laufzeit änderbar, DevicePath/Model/LastPacket, Aus-Paket bei DisposeAsync

Beispiel

using SegLcd;

await using var session = new SegmentLcdSession();      // sucht das erste bekannte Gerät
session.ConnectionChanged += path => Console.WriteLine(path ?? "getrennt");
session.Update(new SegmentLcdFrame { CpuTemperature = 42.5, GpuTemperature = 51 });
session.Start();

using var timer = new PeriodicTimer(TimeSpan.FromSeconds(1));
while (await timer.WaitForNextTickAsync())
{
    session.Update(new SegmentLcdFrame
    {
        CpuTemperature = ReadCpuTemp(),
        GpuTemperature = ReadGpuTemp(),
    });
}
// DisposeAsync: Timer stoppen, 0F senden, Gerät schließen

Nur den Codec verwenden (z. B. mit einem eigenen HID-Backend):

byte[] packet = SegmentLcdProtocol.EncodeUpdate(frame);       // 64 Byte (Leitung)
byte[] report = SegmentLcdProtocol.ToHidReport(packet);       // 65 Byte für hidraw/hidapi/WriteFile

hidapi-Eigenheiten

EigenschaftLinux (hidraw-Backend)Windows
DeviceInfo.Path/dev/hidraw5Interface-Pfad \\?\hid#vid_5131&pid_200e…
Hid.Enumerate(vid, pid)liest sysfs, öffnet nicht → funktioniert ohne ZugriffsrechteSetupAPI
ManufacturerString/ProductString/SerialNumberleer (Gerät hat keine Strings)leer
UsagePage/Usage0xFF00 / 0x0001 (aus dem Report-Deskriptor)ebenso
Device.Write65 Byte inkl. Report-ID 0065 Byte
Device.ReadTimeout64 Byte, Report-ID 0 entfernt64 Byte
Device.GetReportDescriptor34 Byte (hidapi ≥ 0.14)rekonstruiert
Öffnen ohne RechteHidException → TryOpen liefert null–

Hid.Exit() gibt die hidapi-Ressourcen frei; das CLI ruft es am Programmende auf.

Native AOT

  • Library und CLI sind mit IsAotCompatible/PublishAot gebaut; dotnet publish -r linux-x64 erzeugt ein ~5 MB großes, eigenständiges Binary (zur Laufzeit wird nur libhidapi-hidraw.so.0 nachgeladen).
  • Build-Ausgaben liegen dank UseArtifactsOutput (Directory.Build.props) gesammelt unter artifacts/: artifacts/bin/<Projekt>/<konfiguration>, artifacts/obj/…, artifacts/publish/<Projekt>/release_linux-x64/.
  • Der AOT-Publish ist warnungsfrei. Ursprünglich wurde HidSharp 2.6.4 verwendet; dessen netstandard2.0-Build erzeugt eine Trim-Warnung (IL2104/IL2075, Reflection auf Mono.Unix in NativeMethods.uname). Der Codepfad ist unter .NET zwar tot, die Warnung aber nicht sauber unterdrückbar – deshalb der Wechsel zu HidApi.Net. Getestet im AOT-Binary: Enumeration, Öffnen, Deskriptor lesen, Senden.
  • Die Unit-Tests (TUnit) vermeiden reflection-basierte Assertions (IsEquivalentTo) und sind damit ebenfalls AOT-tauglich.

Bauen & Testen

dotnet build
dotnet test                                   # TUnit über Microsoft.Testing.Platform (global.json)
dotnet publish src/SegLcd.Tool -c Release -r linux-x64
# -> artifacts/publish/SegLcd.Tool/release_linux-x64/seglcd