Oakrey.Applications.Dashboards.LIN 1.0.2

Oakrey.Applications.Dashboards.LIN

A .NET 10 Windows library for building persistent WPF dashboards from LIN signals decoded with LDF definitions. It connects Oakrey.Applications.DecodingServices.LIN with the shared Oakrey dashboard infrastructure.

Main features

• Represents a dashboard entry as a validated LDF LdfSignalValue binding.
• Assigns decoded signals by source device, LIN channel, frame identifier, and signal name.
• Automatically binds an unassigned dashboard item to the first matching LIN source.
• Prevents duplicate dashboard entries.
• Loads, appends, saves, and clears JSON dashboard configurations.
• Publishes configuration-load and collection-change notifications.
• Provides WPF commands and connection-state notifications through DashboardViewModel.
• Supports gauge, digital value, bulb, graph, and histogram views.

Architecture

flowchart LR
    Decoder[ILINDecodingService] -->|ReceivedFrame| Dashboard[DashboardItemCollection]
    Dashboard --> Items[DashboardItem]
    JSON[IJsonService] <--> Dashboard
    LIN[ILinDeviceService] --> ViewModel[DashboardViewModel]
    Dashboard --> ViewModel

Key types

Requirements

• .NET 10 for Windows 10, version 1809 or later
• WPF
• A configured ILINDecodingService from Oakrey.Applications.DecodingServices.LIN
• A configured ILinDeviceService from Oakrey.Applications.Ohm.LIN
• Configured IJsonService and IAppConfigPath implementations

Installation

.NET CLI

dotnet add package Oakrey.Applications.Dashboards.LIN

Package Manager Console

Install-Package Oakrey.Applications.Dashboards.LIN

NuGet Package Manager

Search for Oakrey.Applications.Dashboards.LIN in Tools > NuGet Package Manager > Manage NuGet Packages for Solution.

Registration

Register one collection instance for both the concrete and interface service types:

services.AddSingleton<DashboardItemCollection>();
services.AddSingleton<IDashboardService>(provider =>
    provider.GetRequiredService<DashboardItemCollection>());
services.AddTransient<DashboardViewModel>();

Example usage

Create an unassigned item and feed decoded LIN updates into the dashboard:

dashboardService.Add(signal);

IDisposable updateSubscription = decodingService.FrameUpdated.Subscribe(
    dashboardService.AssignMessageSignalsToItems);

The first matching frame binds an unassigned item to its device and channel. Later frames update only the item with the same device, channel, LDF frame ID, and signal name. To pin an item immediately, provide the device serial number and channel when adding it:

dashboardService.Add(signal, relatedDevice: "device-serial", relatedChannel: 0);

Load the default configuration or observe items loaded during preload:

IDisposable loadedSubscription = dashboardService.ItemsLoaded.Subscribe(items =>
{
    Console.WriteLine($"Loaded {items.Count} LIN dashboard items.");
});

await dashboardService.LoadDashboardConfig(cancellationToken);

The default configuration remains compatible with existing installations and is stored as userDashboard.json below the configured application-data path. Dispose subscriptions when no longer needed and dispose the dashboard collection during application shutdown.

Project information

License

This project is licensed under the MIT License. See the repository's LICENSE file for details.