knx_parser 1.3.0

A Dart library to parse KNX project files (.knxproj) from ETS5 and ETS6, including encrypted projects. Extracts data to JSON format.

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.

1.3.0 - 2026-01-27

Added

• ETS6 encryption support: Implements PBKDF2-HMAC-SHA256 password derivation for ETS6 encrypted projects.
• Auto-detection of ETS version based on schema version (ETS6 = schema >= 21).
• Support for both ETS5 (raw password) and ETS6 (derived password) encrypted projects.

Dependencies

• Added pointycastle: ^3.9.1 for PBKDF2 key derivation.
• Added crypto: ^3.0.3 for cryptographic operations.

1.2.0 - 2026-01-26

Added

• Support for parsing secure KNX projects (AES encrypted P-*.zip files) with password.
• Parsing of DeviceInstance elements in Topology.
• Parsing of Security keys (ToolKey) for devices.
• Parsing of Key for Group Addresses.
• Updated JSON export to include new device and security data.

1.0.0 - 2026-01-26

• Initial release
• Parse .knxproj files (ZIP-based XML format from ETS6)
• Extract project information (name, GUID, dates, style)
• Extract topology (Areas, Lines, Segments)
• Extract group addresses with formatted address support (e.g., 0/0/1)
• Extract group ranges with hierarchical structure
• Extract locations (Buildings, Spaces)
• Parse datapoint types (DPT) from knx_master.xml
• Export to structured JSON format
• Comprehensive unit tests
• Example usage script

Dependencies

• archive: ^3.6.1 - ZIP file handling
• xml: ^6.5.0 - XML parsing