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 Calendar Versioning
use_rlrq_rlre
added to DlmsConnectionSettings. IfFalse
no ReleaseRequest is sent to server/device and lower layer can be disconnected right away.
- Support for HDLC over TCP via composition of IO-implementation separate from transport implementation.
- Support for LLS (Low Level Security)
- Support for HLS (method 2) using common method of AES128-ECB.
- Structlog logging.
- Implemented VisibleStringData.
- DlmsConnectionSettings to handle manufacturer specific quirks in communication.
- Changed License from MIT to BSL v1.1
- Refactor of authentication to make it simpler support more authentication types. And make it possible to supply manufacturer specific implementations.
- Shorthand class methods to create DlmsClients. Now composition has to be used.
- Error in DataArray dlms data type
Updated dependencies and made it a bit more lenient so installing in other environments will allow for more versions.
- To handle the more complicated parsing problem of GET.WITH_LIST with compound data elements a new parser, DlmsDataParser, was added that focuses on only A-XDR DLMS data. Hopefully this can be be used instead of the A-XDR Parser when the parsing of ACSE services APDUs is built away
- Added HDLC UnnumberedInformationFrame.
- Ability to set timeout of transport layer at client level.
- A simpler way to change client address and invocation counter of a
DlmsClient
to that reuseing a connection goes smoother - Added
from_string
onObis
that can parse any viable string as OBIS. - Added GET.WITH_LIST service.
- Renamed classes to exclude
Apdu
in class names. To have it consistent over the project. - Simplified DataNotification
- Improved handling of pre-established associations
- Using the wrong data to decrypt now raises
DecryptionError
instead of InvalidTag - The
to_string
method onObis
now returns in the format1-8:1.8.0.255
with a possible override of the separator.
- Removed the
from_dotted
,dotted_repr
andverbose_repr
fromObis
- Some DLMS over TCP implementations will return partial data. The
BlockingTcpTransport
now keeps on trying to read the data until all data is received. Fixes #35. - Fixed a bug in the HDLC layer that prevented correct sending of segmented information frames.
- Fixed missing state management for general ACTION usage
-
Fixed #23. Typo in A-XDR Parser. Just referenced the function and did not call it. Now DLMS data is interpreted correctly.
-
Fixed #20. It was possible that not calling the .shutdown() on socket before disconnecting made remote modems on meters, that have an embedded TCP/IP stack, keep the socket open and blocking subsequent calls.
- Support for basic SET service. No support for WITH_LIST or service specific block transfer
-
The standard DLMS way of dealing with timezones in datetime are via UTC offset. But the offset is the deviation from normal time to UTC not deviation from UTC. This results in -60 min deviation for UTC+01:00 for example. Previous solution assumed 60 min for UTC+01:00. Solved by negating all values for offset. Note that some DLMS companion standards handles the offset the previous way and in the future there will be need to handle both ways correctly.
-
Included typing-extensions in required packages.
- Better handling of TCP errors in
BlockingTcpTransport
-
It is now explicitly possible to connect and disconnect a transport in the
DlmsClient
instead of it being done automatically in.associate()
and.release_association()
. Context manager.session()
works the same. -
Client to server challenge of DlmsConnection is always created independent of auth method. But only used if needed.
- Removed conformance validation in DlmsConnection. It seems like meters don't always follow it so better to leave it up to the client.
- HDLC transport implementation
- TCP transport implementation
- DlMS client implementation
- Support for Get service including service specific block transfer
- Support for selective access via range descriptor
- Support for HLS authentication using HLS-GMAC.
- Support for GlobalCiphering
- Parsing of ProfileGeneric buffer
- Changed project versioning scheme to Calendar versioning
- UDP messages are now based WrapperProtocolDataUnit to be able to reuse WrapperHeader for TCP messages.
- Parsing of DLMS APDUs
Initial implementation.