Skip to content

CHANGELOG.md

Latest commit

 

History

History
111 lines (89 loc) · 6.15 KB

CHANGELOG.md

File metadata and controls

111 lines (89 loc) · 6.15 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[Unreleased]

Added

  • Initial MQTT implementation. Added the astarte::device::mqtt namespace containing all MQTT-specific functionality.
  • New astarte::device::mqtt::DeviceMqtt class implementing an Astarte device using the MQTT transport layer.
  • New astarte::device::mqtt::Config class for configuring an Astarte device using the MQTT transport layer.
  • New astarte::device::mqtt::PairingApi class for interacting with the Astarte pairing API.
  • Comprehensive set of error classes encapsulated in std::expected objects.
  • Helper scripts to build samples on Windows platforms.

Changed

  • Reorganized the SDK namespace structure. The AstarteDeviceSdk namespace has been replaced by astarte::device.
  • Removed the Astarte prefix from all classes and enums.
  • Renamed AstarteDeviceGRPC into DeviceGrpc and moved it to the astarte::device::grpc namespace.
  • Renamed AstarteStoredProperty into StoredProperty
  • Renamed AstartePropertyIndividual into PropertyIndividual
  • Renamed AstarteDatastreamObject into DatastreamObject
  • Renamed AstarteMessage into Message
  • Renamed AstarteDatastreamIndividual into DatastreamIndividual
  • Renamed AstarteDeviceGRPC into DeviceGRPC
  • Renamed AstarteDevice into Device
  • Renamed AstarteData into Data
  • Renamed AstarteType into Type
  • Renamed AstarteOwnership into Ownership
  • Replaced the exception system with std::expected return types. This uses the native C++ implementation where supported, falling back to a third-party dependency on older C++ versions.
  • Updated Astarte message hub protos to v0.10.1. As of version v0.10.0, protos no longer define their own CMake package. Instead, they provide CMake functions to add compiled protos to the Astarte device target. Consequently, pkg-config now yields a single package for the Astarte device instead of two distinct packages for the device and proto sources.

Removed

  • All library-specific exception classes. Users should migrate to the new error reporting system.

[0.8.1] - 2025-10-29

[0.7.1] - 2025-10-28

[0.6.2] - 2025-10-28

Fixed

  • An integer overflow in the exponential backoff module. The bug caused the calculated reconnection delay to wrap around to a negative value, leading to zero delay connection attempts during a network outage.

[0.8.0] - 2025-10-10

Added

  • Support for the Conan package manager. Users can build the library as a conan package and import it in their Conan projects.
  • Implement Astarte pairing mechanism to register a device, retrieve MQTT broker URL and retrieve and check a device certificate.
  • Implement device id generation.

Fixed

  • Bug preventing build with the Microsoft compiler #113.

Fixed

  • Bug preventing build with the Microsoft compiler #113.

[0.7.0] - 2025-08-13

Added

  • API calls to fetch stored device properties in the gRPC Astarte device.

Changed

  • Introduced an AstarteDeviceMQTT class that uses the MQTT protocol as a transport layer.
  • The simple sample has been renamed to grpc_native.
  • The qt sample has been renamed to grpc_qt.
  • Use C++20 as the minimum required library version.
  • The gRPC Astarte device introspection can now be modified dynamically while the device is connected.

Removed

  • Avoid using timeout to check the device connection status.

[0.6.1] - 2025-08-11

Added

  • Astarte classes can now be formatted, using the standard library's formatter by default. If it's not available, the feature uses the fmtlib library from spdlog as a fallback. To use this fallback, you must enable the ASTARTE_PUBLIC_SPDLOG_DEP option in CMake.

Fixed

  • Qt sample compilation errors on windows machines.

[0.6.0] - 2025-07-21

Added

  • Added is_connected method to the Astarte device. Users can evaluate through that method if the device is connected to the Astarte message hub.
  • All gRPC messages can be logged usign spdlog with trace level logging enabled.
  • Method to add a json interface as a string directly, without reading it from a file
  • Method to convert an AstarteMessage and AstarteData that returns an std::option instead of an exception
  • A new Qt sample showing how to use the Astarte device library in a Qt project.
  • ASTARTE_PUBLIC_PROTO_DEP CMake option.
  • AstarteDatastreamIndividual, AstartePropertyIndividual and AstarteDatastreamObject (renaming of AstarteObject) classes, representing the different Astarte data types.
  • get_starded.md, a step by step guide useful to try the SDK functionalities guide.

Changed

  • The AstarteDevice is now an abstract class transport independent. Users should instantiate the AstarteDeviceGRPC class which is the gRPC specific Astarte device class.
  • Astarte device poll requires a timeout parameter.
  • Reference version of the Astarte message hub is v0.8.0
  • Bump the Astarte message hub proto definitions to v0.8.4.
  • The USE_SYSTEM_GRPC option has been moved to the Astarte message hub proto and prefixed with ASTARTE_.
  • The grpc sample has been renamed to simple.
  • The value contained in an Astarte message can now be directly converted to one of: AstarteDatastreamIndividual, AstartePropertyIndividual and AstarteDatastreamObject using the into method.
  • The connection procedure is now asynchrnonous. When connect is called the device will attempt to connect untill the disconnect function is called or the object is destroyed. The device will use an exponential backoff to avoid network congestion.
  • Enums elements are now named using a k prefix and camel case format.

Removed

  • base64 has been fully removed as a dependency.

[0.5.0-beta] - 2025-03-20

Added

  • Initial SDK release, supports connecting to a message hub instance and publish/receive of basic Astarte types.