Skip to main content

Versioning

The underlying Rust library follows the semantic versioning specification. Refer to the specification for the meaning of the <major>.<minor>.<patch> fields of the version number when using the library in Rust.

Version numbers​

The following sections describe the meaning of the fields in the version number.

Major​

Major releases are for substantial breaking changes and should occur infrequently. They provide an opportunity to consolidate functionality that may have been added in an adhoc manner in support of backwards compatibility in minor releases. Major releases may also add functionality that requires refactoring of the API.

Minor​

Minor releases are for introducing new functionality in a (mostly) backwards compatible manner:

  • Rust - API compatible per semver
  • C & C++ - API compatible
  • Java - API compatible
  • C# - API compatible with the exception that we may add new methods to interfaces that need to be stubbed out
Why is C# different?

C++, Java, Rust, and even C (via NULL) support a way of defining default methods on interfaces. This allows us to extend interfaces in minor releases without breaking source compatibility in these languages. Default interfaces were added to C# 8.0, however to target .NET standard 2.0 (which is both .NET Core and .NET Framework compatible) we can only use C# 7.

Patch​

Patch releases are only for fixing bugs that cannot wait for a minor release to be resolved. Patch releases, e.g. 1.0.0 -> 1.0.1, are API compatible in all languages. The C library (libdnp3_ffi.so) will also be ABI compatible between patch versions.

The latest release (version 1.5.2) is available here.

Changelog​

1.5.2​

  • 🐛 Fix bug where the outstation would sleep before all unsolicited data was transmitted. See #341.

1.5.1​

  • 🔧 Update to oo-bindgen 0.8.6 to improve Java native library loading. See oo-bindgen #124.
  • 🔔 This release only affects the Java distribution. It is equivalent to 1.5.0 for other distributions.

1.5.0​

  • ⭐ Add configuration option that allows outstation to respond to any master. See #316.
  • ⭐ Add optional serde support for public config types in Rust. See #303.
  • 🔧 Fix cmake download when building C/C++ examples. See #307.
  • 📖 Fix FFI docs for g12v1 and remove g12v0 and g41v0. See #308
  • 🐛 Fix master task scheduling CPU thrashing under certain conditions. See #312.
  • 🐛 Fix bug where AssociationInformation::task_fail was not properly being called for some tasks. See #313.
  • 🐛 Update rx509 to 0.2.1 to fix ASN.1 GeneralizedTime parsing. See RASN #2.

1.4.1​

  • 🐛 Bump rustls to 0.21.1 to resolve #300.

1.4.0​

  • 🔧 Update to rustls 0.21.0 which allows peer names with IP addresses in the SAN extension.
  • 🔧 Move common TLS configuration to its own crate shared with our Modbus library.
  • ⭐ PEM parser now supports extracting PKCS#1 private keys, i.e. PEM files with BEGIN RSA PRIVATE KEY.
  • ⭐ X.509 name verification may now be disabled in the TLS client and server configurations.
  • 📖 Documentation improvements in the bindings via oo-bindgen 0.8.3.

1.3.0​

  • ⭐ Add master and outstation support for device attributes (group 0).
  • ⭐ Add master support for reading files and directories. See #281.
  • ⭐ Add ability to specify TCP/TLS client local adapter and connect timeout. See #254.
  • ⭐ Add master support for receiving frozen analog inputs (groups 31 and 33). See #256.
  • ⭐ Add master and outstation support for analog inputs dead-bands (group 34). See #257.
  • ⭐ Add master API for sending freeze requests. Add freeze-at-time to outstation. See #263.
  • ⭐ Add a mechanism to the bindings to shut down the Runtime with a timeout. See #271.
  • ⭐ Add outstation APIs for tracking the lifetime of events. See #273.
  • ⭐ Add enable/disable methods to outstation instances. See #278.
  • ⭐ Add TCP/TLS client modes to the outstation API. See #279.
  • 🐛 Fix incorrect encoding of octet-string events when adjacent events have different lengths. See #269.
  • 🐛 Fix bug where the outstation would respond to a master other than the one configured. See #284.
  • 📖 Various FFI documentation improvements. See #250.

1.2.0​

  • ⭐ Enable TCP_NODELAY by default. See #218.
  • ⭐ Enable full link-time optimization (LTO) in release builds. See #223.
  • ⭐ Add support for 3 MUSL Linux targets to C/C++ and .NET. See #228.
  • ⭐ Use only dependencies from crates.io allowing first release there. See #227.
  • ⭐ Internal refactoring to promote code reuse with Rodbus. See: #220, #221, #222.

1.1.0​

  • ⭐ TCP/TLS server can now filter IPv4 addresses with wildcards. See #208.
  • ⭐ Rust crate and FFI/JNI libraries can now be compiled without TLS and/or serial support. See #212.
  • ⭐ Add a way to spawn a serial outstation that is tolerant to the port being removed from the OS. See #215.
  • ⭐ Produce enhanced third-party license reports for FFI and JNI bindings.

1.0.1​

  • 🐛 Fix panic when creating serial outstation #203.
  • ⭐ Log when OVERFLOW or EVENT classes available IIN bits causes a poll to be scheduled. #25.
  • ⭐ Build all Linux FFI/JNI artifacts using rust-cross #197.
  • ⭐ Newer rust-cross version produces more portable Linux libraries (older GLIBC).

1.0.0​

  • First release with stable API