Changelog

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

[Unreleased]

Asynchronous API: New AsyncSlmpClient for high-concurrency non-blocking I/O via asyncio.
UDP Support: Full support for UDP transport in both synchronous and asynchronous clients.
3E Frame Support: Formally enabled and documented support for SLMP 3E frames (binary).
Module I/O Keywords: Added ModuleIONo enum and keyword support (e.g. OWN_STATION, MULTIPLE_CPU_1) in SLMPTarget.
Comprehensive Device Coverage: Ported all device-related APIs (random, block, monitor, memory, label, remote) to the async client.

Sans-I/O Refactoring: Moved protocol logic, validation, and data structures from client.py to core.py to achieve implementation consistency.
Documentation: Added GX Simulator 3 connection guide and updated User Guide for new features.

Bit Data Packing: Swapped nibble order in pack_bit_values and unpack_bit_values to correctly map the first device to the high nibble and the second device to the low nibble, matching the SLMP binary specification and live PLC behavior.
ZR Device Base: Changed ZR device radix from hexadecimal to decimal in constants.py to align with live-verified iQ-R behavior.
Node Search: Improved robustness of decode_node_search_response against truncated or malformed network data.
File Validation: Added password length validation (6-32 characters) for iQ-R file subcommands (e.g. 0x0040).
Fixed several type hinting issues in core.py and redundant constant definitions.

S Device Support: Added S (Step Relay) device code to DEVICE_CODES.
Live Verification: Exhaustively verified the library against GX Simulator 3, confirming bit order consistency across all device families and dynamic system-value updates.

Documentation-only patch release.

added a README link to the related minimal C++ implementation package slmp-connect-cpp-minimal

Patch release to align the repository release tag with the CI-passing commit.

formatted scripts/slmp_mixed_block_compare.py so ruff check . passes in GitHub Actions
release line now points to the same commit that passed unit tests, ruff, mypy, and package build

Mixed block write compatibility update for the validated iQ-R target.

retry_mixed_on_error=True fallback for write_block(...) so one mixed 1406/0002 write can recover by retrying as separate word-only and bit-only block writes on known rejection end codes
scripts/slmp_mixed_block_compare.py for focused live comparison of mixed block read/write behavior
focused unit tests for the mixed-write retry path
validated-target comparison notes under internal_docsrc/iqr_r08cpu/

documentation now records that one-request mixed writeBlock on the validated R08CPU target reproduces 0xC05B
practical guidance now recommends split_mixed_blocks=True or retry_mixed_on_error=True when a PLC rejects one mixed word+bit block write
project status and open-items tracking were updated with the latest live verification result

one-request mixed writeBlock(D300 x2 + M200 x1 packed) reproduced 0xC05B
equivalent word-only and bit-only block writes remained OK
retry_mixed_on_error=True was live-verified as a working fallback on the validated target

Initial packaged release for the current repository scope.

documentation split into user-facing guides and internal implementation-facing records
generated live reports moved under internal_docsrc/<series>_<model>/
current live reports now keep a tracked *_latest.md plus a timestamped archive/ copy