Release v0.9.7

What's New in This Release

Improvements

• Updated README.md with improved documentation and sample code
• Added Edge Node and Device online status tracking functionality
• Optimized message ordering mechanism for better performance
• Improved dependency management with updated packages
• Enhanced sample application with configuration profiles support
• Updated documentation structure with improved organization
• Added dependency injection architecture for better service management

Bug Fixes

• Fixed sample code to use correct API for SparkplugHostApplication instantiation
• Resolved documentation inconsistencies
• Fixed message ordering edge cases

Compatibility

Breaking API Changes

• SparkplugHostApplication Constructor: Changed from 3 parameters to 5 parameters

  • Old: SparkplugHostApplication(mqttOptions, sparkplugOptions, logger)
  • New: SparkplugHostApplication(mqttOptions, sparkplugOptions, orderingService, trackingService, loggerFactory)
  • Requires explicit injection of IMessageOrderingService, IStatusTrackingService, and ILoggerFactory

• Added Required Dependencies:

  • Added Microsoft.Extensions.Caching.Hybrid package dependency
  • Added IMessageOrderingService and IStatusTrackingService interfaces

• Sample Code Changes:

  • Sample code now requires dependency injection setup
  • Changed from direct instantiation to service collection registration

Technical Details

• Target Framework: .NET 9.0
• Dependency Updates:
  • Google.Protobuf 3.33.0
  • Microsoft.Extensions.Caching.Hybrid 9.10.0
  • Microsoft.Extensions.Caching.Memory 9.0.10
  • Microsoft.Extensions.Logging 9.0.10
  • MQTTnet 5.0.1.1416
• Protocol Support: Sparkplug B
• MQTT Support: MQTT 3.1.1 and 5.0

For issues and feature requests, please submit them to the GitHub issue tracker.

License

This project is licensed under the MIT License.

SparklerNet v0.9.6

What's New in This Release

Bug Fixes

• Fixed NuGet package publishing issue that resulted in incorrect v0.9.5 package deployment
• Updated version numbering to v0.9.6 to ensure proper package deployment sequence
• Resolved package versioning conflicts in the deployment pipeline

Compatibility

• Fully backward compatible with previous versions
• No breaking API changes introduced
• All existing tests continue to pass

Technical Details

• Target Framework: .NET 9.0
• Dependency Updates: Google.Protobuf 3.33.0
• Protocol Support: Sparkplug B
• MQTT Support: MQTT 3.1.1 and 5.0

For issues and feature requests, please submit them to the GitHub issue tracker.

License

This project is licensed under the MIT License.f SparklerNet

SparklerNet v0.9.3

What's New in This Release

Documentation Updates

• Updated version information and release notes in README
• Removed Sparkplug Array Types documentation
• Fixed typo in README.md
• Updated validation checklist in README

Feature Enhancements

• Added namespace element validation and related tests
• Updated validation comments in publish methods
• Improved logging functionality

Code Quality

• Suppressed ReSharper warnings
• Maintained API compatibility with previous versions

Technical Details

• Target Framework: .NET 9.0
• Dependency Updates: Google.Protobuf 3.33.0
• Protocol Support: Sparkplug B
• MQTT Support: MQTT 3.1.1 and 5.0

For issues and feature requests, please submit them to the GitHub issue tracker.

License

This project is licensed under the MIT License.

SparklerNet v0.9.2

What's New in This Release

Core Improvements

• Refactored HostApplicationId validation logic into reusable SparkplugNamespace.ValidateNamespaceElement method
• Improved error handling and validation for namespace elements
• Enhanced code consistency across validation components
• Fixed potential null reference issues in validation flow

Technical Enhancements

• Better separation of concerns with centralized validation logic
• More descriptive exception messages for validation errors
• Removed duplicate code patterns in validation routines
• Added comprehensive input parameter checking

Compatibility

• Fully backward compatible with previous versions
• No breaking API changes introduced
• All existing tests continue to pass

Bug Fixes

• Fixed edge case handling in namespace element validation
• Improved null parameter validation

For issues and feature requests, please submit them to the GitHub issue tracker.

License

This project is licensed under the MIT License.

SparklerNet v0.9.0

Overview

SparklerNet v0.9.0 is the initial release of our comprehensive Sparkplug B protocol implementation for .NET applications. This library provides robust support for industrial IoT messaging using the Sparkplug B specification, enabling seamless communication between industrial devices and SCADA/HMI systems.

Key Features

Host Application Implementation

• Complete Sparkplug B Host Application functionality
• Session management and device lifecycle tracking
• Birth and death certificate handling
• Support for multiple device and edge node management

Message Processing

• Full support for all Sparkplug B message types (NBIRTH, NDEATH, DBIRTH, DDEATH, DDATA, etc.)
• Protocol buffer serialization with Google.Protobuf integration
• Efficient payload parsing and validation
• Topic namespace management

Data Types Support

• Complete implementation of Sparkplug B data types
• Flexible metric value handling
• Time-series data support
• Complex data structure representation

For issues and feature requests, please submit them to the GitHub issue tracker.

License

This project is licensed under the MIT License.