This is an automated email from the ASF dual-hosted git repository.
chrisdutz pushed a commit to branch develop
in repository https://gitbox.apache.org/repos/asf/plc4x.git
The following commit(s) were added to refs/heads/develop by this push:
new 44f3c0da36 feat: Added more return codes that can be used in new types
of scenarios we didn't encounter till now.
44f3c0da36 is described below
commit 44f3c0da36d260cd08479fd15b434587e63c2784
Author: Christofer Dutz <[email protected]>
AuthorDate: Sat May 2 08:36:33 2026 +0200
feat: Added more return codes that can be used in new types of scenarios we
didn't encounter till now.
---
.../plc4x/java/api/types/PlcResponseCode.java | 25 +++++++++++++++++++++-
1 file changed, 24 insertions(+), 1 deletion(-)
diff --git
a/plc4j/api/src/main/java/org/apache/plc4x/java/api/types/PlcResponseCode.java
b/plc4j/api/src/main/java/org/apache/plc4x/java/api/types/PlcResponseCode.java
index 37d1413ebf..469a61c01b 100644
---
a/plc4j/api/src/main/java/org/apache/plc4x/java/api/types/PlcResponseCode.java
+++
b/plc4j/api/src/main/java/org/apache/plc4x/java/api/types/PlcResponseCode.java
@@ -66,7 +66,30 @@ public enum PlcResponseCode {
/**
* Indicates a response is pending.
*/
- RESPONSE_PENDING((short) 0x0C);
+ RESPONSE_PENDING((short) 0x0C),
+ /**
+ * The request and the connection are both healthy, but the data this
+ * tag points at is not yet available — typically because an asynchronous
+ * source (cyclic IO, subscription stream, lazy cache) has not yet
+ * delivered its first value. The caller should retry shortly; this is
+ * not a permanent failure.
+ *
+ * <p>Distinct from {@link #RESPONSE_PENDING}, which signals a
+ * request/response is in flight to a remote endpoint. {@code NOT_READY}
+ * is for push-model and cache-backed reads where there is no in-flight
+ * request to wait on — only the next periodic delivery.</p>
+ */
+ NOT_READY((short) 0x0D),
+ /**
+ * The request shape is valid, but a value carried by it falls outside
+ * the range the target accepts — e.g. a numeric value too large for
+ * the destination datatype, an address beyond the device's declared
+ * extent, or a polling interval below the protocol's wire-cycle floor.
+ * Distinct from {@link #INVALID_DATA} (which means "malformed") and
+ * {@link #INVALID_ADDRESS} (which means "no such address exists").
+ */
+ OUT_OF_RANGE((short) 0x0E);
+
private static final Map<Short, PlcResponseCode> map;
static {
