OneDriver.Framework 1.4.0

OneDriver.Framework

Version: v1.040
Release Date: April 2025

Overview

OneDriver.Framework is a modular and extensible C# library designed to abstract and unify the implementation of hardware drivers for measurement instruments and automation systems. It establishes a standardized approach for devices, parameters, validation, channels, and process data, making it easier to extend support for various protocols and device types.

This release lays the foundation for cross-domain drivers such as power supplies, IO-Link masters, Modbus interfaces, and other sensor/actuator controllers.

🧱 Project Structure

• Module Layer
  The core abstractions for devices, parameters, channels, and process data.

• Validator Layer
  Pluggable validation logic for device connection strings or other input formats.

• PowerSupply.Abstract
  An example of a concrete domain-specific implementation extending the base framework.

✨ Core Concepts

Devices

BaseDevice<TParams> is the base class for any hardware abstraction. It includes lifecycle methods like Connect() and Disconnect(), with parameter validation support via the IValidator interface.

Derived examples:

• BaseDeviceWithChannels<TDeviceParams, TChannelParams>
• BaseDeviceWithProcessData<TParams, TProcessData>

Parameters

All device and channel parameters derive from BaseDeviceParam and BaseChannelParam, using PropertyHandlers to support reactive property handling and dynamic access.

Validation

The IValidator interface defines the validation logic for device-specific initialization strings.
Example: ComportValidator uses regex to validate serial port strings like COM3;9600.

Channels

Channels are managed via collections (ObservableCollection<BaseChannel<T>>) and extended to handle both static and dynamic process data.

Process Data

BaseProcessData provides timestamped and extendable structures for runtime measurement values, logs, or state snapshots. Works with data tunnel to fire events for continuously updating process data.

📦 Namespaces

• OneDriver.Framework.Base – Base property management
• OneDriver.Framework.Module – Core device abstractions
• OneDriver.Framework.Module.Parameter – Parameter models
• OneDriver.Framework.Libs.Validator – Validators
• OneDriver.Framework.ModuleBuilder – Process data interfaces
• OneDriver.PowerSupply.Abstract – Example device domain

🔌 Example: Power Supply Abstraction

public abstract class CommonDevice<TDeviceParams, TChannelParams, TChannelProcessData> :
    BaseDeviceWithChannelsPd<TDeviceParams, TChannelParams, TChannelProcessData>, IPowerSupply

Implements:

• SetVolts(), SetAmps()
• AllChannelsOn(), AllChannelsOff()

Parameters like MaxVolts, DesiredVolts, ControlMode are managed through CommonDeviceParams and CommonChannelParams.

✅ Getting Started

1. Create your device-specific Params classes by extending BaseDeviceParam and BaseChannelParam.
2. Implement a validator using IValidator.
3. Extend BaseDevice or its variants.
4. Plug your device class into your app or service layer.
5. Write unit tests to validate behavior.

🛠️ Build and Compatibility

• Framework: .NET 8.0
• IDE: Visual Studio 2022+
• OS Support: Windows, Linux (cross-platform)

📜 License

MIT License – See LICENSE file.

🧪 Tests

This framework is designed with testability in mind. Use xUnit or your preferred testing framework to mock and test device behavior.

📈 Future Plans

• IO-Link master device abstraction
• CANopen and Modbus master implementation
• gRPC-based remote access to IDevice-derived objects
• Graphical interface for parameter management

🙌 Contributions

We welcome contributions. Please open issues or pull requests with proposed improvements or additional protocol support.

👨‍💻 Author

Rahul Bajaj
© 2025 OneDriver Project