COSEMpdu 0.3.4__tar.gz → 0.4.2__tar.gz

{cosempdu-0.3.4 → cosempdu-0.4.2}/.vscode/launch.json

@@ -51,6 +51,23 @@
             "PYTHONPATH": "${workspaceFolder}/src"
       }
 
+    },
+    {
+      "name": "test_ACSE",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "unittest",
+      "args": [
+        "-v",
+        "test.test_acse_pdu"
+      ],
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "justMyCode": true,
+      "env": {
+            "PYTHONPATH": "${workspaceFolder}/src"
+      }
+
     },
     {
       "name": "Python: test_constraint",
@@ -114,7 +131,7 @@
       ],
       "cwd": "${workspaceFolder}",
       "console": "integratedTerminal",
-      "justMyCode": true,
+      "justMyCode": false,
       "env": {
             "PYTHONPATH": "${workspaceFolder}/src"
       }
@@ -163,7 +180,7 @@
       ],
       "cwd": "${workspaceFolder}",
       "console": "integratedTerminal",
-      "justMyCode": true,
+      "justMyCode": false,
       "env": {
             "PYTHONPATH": "${workspaceFolder}/src"
       }

cosempdu-0.4.2/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: COSEMpdu
+Version: 0.4.2
+Summary: DLMS/COSEM PDU encoder/decoder with ASN.1 types, A-XDR and BER encoding rules (IEC 61334-6, X.680, X.690)
+Author-email: Serj Kotilevski <youserj@outlook.com>
+Project-URL: Source, https://github.com/youserj/COSEMpdu_project
+Keywords: dlms,asn.1,a-xdr,ber,pdu,coder
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: StructResult>=0.9.9
+Provides-Extra: dev
+Requires-Dist: mypy>=1.5.0; extra == "dev"
+Requires-Dist: ruff>=0.11; extra == "dev"
+Requires-Dist: types-requests; extra == "dev"
+Requires-Dist: build>=1.3; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+
+# COSEMpdu
+
+DLMS/COSEM PDU encoder/decoder for smart metering protocols. Implements ASN.1 types (X.680), A-XDR encoding rules (IEC 61334-6), and BER encoding rules (X.690).
+
+## Overview
+
+COSEMpdu provides a Python library for working with DLMS/COSEM Protocol Data Units (PDUs) used in smart metering and energy management systems. It implements the full COSEM PDU specification from the Green Book (IEC 62056 / EN 13757-1), including:
+
+- **ASN.1 Type System (X.680)** — BOOLEAN, INTEGER, ENUMERATED, OCTET STRING, BIT STRING, SEQUENCE, SEQUENCE OF, CHOICE, NULL, OBJECT IDENTIFIER, GeneralizedTime, constrained types, and tagging
+- **A-XDR Encoding (IEC 61334-6:2000)** — Size-optimized encoding for COSEM APDU (Application Protocol Data Unit)
+- **BER Encoding (X.690)** — Basic Encoding Rules for COSEM ACSE (Association Control Service Element)
+- **COSEM APDU Types** — All PDU types defined in the Green Book: xDLMS services, COSEM services, and all response types
+- **COSEM ACSE Types** — Application association, authentication, and release PDUs
+
+## Installation
+
+```bash
+pip install COSEMpdu
+```
+
+Requires Python ≥ 3.12.
+
+## Quick Start
+
+```python
+from COSEMpdu.apdu import (
+    GetRequest, InvokeIdAndPriority,
+    CosemAttributeDescriptor,
+    CosemClassId, CosemObjectInstanceId, CosemObjectAttributeId,
+)
+from COSEMpdu.byte_buffer import ByteBuffer
+from StructResult.result import Error
+
+# Create a GET-Request PDU
+get = GetRequest(
+    invoke_id_and_priority=InvokeIdAndPriority(0x13),  # invoke_id=1, confirmed, priority high
+    cosem_attribute_descriptor=CosemAttributeDescriptor(
+        class_id=CosemClassId(8),                        # Clock object
+        instance_id=CosemObjectInstanceId(b"\x00\x00\x01\x00\x00\xff"),  # logical name
+        attribute_id=CosemObjectAttributeId(2)           # attribute #2 (time)
+    )
+)
+
+# Encode to A-XDR bytes
+buf = ByteBuffer(bytearray(100))
+get.put(buf)
+print(bytes(buf.extract()).hex())  # => encoded PDU bytes
+
+# Decode from bytes
+result = GetRequest.get(buf.extract())
+match result:
+    case Error():
+        print("Decode failed:", result.err)
+    case _:
+        decoded: GetRequest = result
+        print(decoded.cosem_attribute_descriptor.class_id)
+```
+
+### ACSE (BER) Example
+
+```python
+from COSEMpdu.acse import (
+    AARQapdu, ProtocolVersion, ApplicationContextName,
+    CalledAPInvocationId, CalledAEInvocationId,
+    CallingAPInvocationId, CallingAEInvocationId,
+    RequestMechanismName,
+)
+from COSEMpdu.byte_buffer import ByteBuffer
+from StructResult.result import Error
+
+# Create an AARQ (Application Association Request) — BER encoding
+aarq = AARQapdu(
+    protocol_version=ProtocolVersion((1, 1)),
+    application_context_name=ApplicationContextName(
+        (2, 16, 756, 5, 8, 1, 1)  # LN referencing
+    ),
+    called_ap_invocation_id=CalledAPInvocationId(1),
+    called_ae_invocation_id=CalledAEInvocationId(2),
+    calling_ap_invocation_id=CallingAPInvocationId(3),
+    calling_ae_invocation_id=CallingAEInvocationId(4),
+    mechanism_name=RequestMechanismName(
+        (2, 16, 756, 5, 8, 2, 2)  # LLS authentication
+    ),
+)
+
+# Encode using BER rules
+buf = ByteBuffer(bytearray(512))
+aarq.put(buf)
+print(bytes(buf.extract()).hex())
+
+# Decode back
+result = AARQapdu.get(buf.extract())
+match result:
+    case Error():
+        print("Decode failed:", result.err)
+    case _:
+        decoded = result
+        print(decoded.application_context_name)  # (2, 16, 756, 5, 8, 1, 1)
+```
+
+## Supported Standards
+
+| Standard | Description |
+|----------|-------------|
+| **IEC 61334-6:2000** | DLMS/COSEM A-XDR encoding rules |
+| **X.680** | ASN.1 notation and type definitions |
+| **X.690** | BER (Basic Encoding Rules) |
+| **IEC 62056 / EN 13757-1** | DLMS/COSEM application layer |
+
+## Modules
+
+| Module | Purpose |
+|--------|---------|
+| `COSEMpdu.x680` | ASN.1 type system: base types, tags, constraints |
+| `COSEMpdu.axdr` | A-XDR encoding/decoding for DLMS/COSEM |
+| `COSEMpdu.x690` | BER Tag and Length encoding primitives |
+| `COSEMpdu.ber` | BER encoding/decoding for ASN.1 types |
+| `COSEMpdu.data` | COSEM data types (Integer8..Unsigned64, Data, COSEM specific types) |
+| `COSEMpdu.apdu` | All COSEM APDU types and services (GET, SET, ACTION, etc.) |
+| `COSEMpdu.acse` | ACSE APDU types (AARQ, AARE, RLRQ, RLRE) |
+| `COSEMpdu.byte_buffer` | Byte-level read/write buffer |
+
+## Project Links
+
+- **Source code:** [GitHub](https://github.com/youserj/COSEMpdu_project)
+- **Issues:** [GitHub Issues](https://github.com/youserj/COSEMpdu_project/issues)
+
+## License
+
+MIT License — see the source repository for details.

cosempdu-0.4.2/README.md

@@ -0,0 +1,130 @@
+# COSEMpdu
+
+DLMS/COSEM PDU encoder/decoder for smart metering protocols. Implements ASN.1 types (X.680), A-XDR encoding rules (IEC 61334-6), and BER encoding rules (X.690).
+
+## Overview
+
+COSEMpdu provides a Python library for working with DLMS/COSEM Protocol Data Units (PDUs) used in smart metering and energy management systems. It implements the full COSEM PDU specification from the Green Book (IEC 62056 / EN 13757-1), including:
+
+- **ASN.1 Type System (X.680)** — BOOLEAN, INTEGER, ENUMERATED, OCTET STRING, BIT STRING, SEQUENCE, SEQUENCE OF, CHOICE, NULL, OBJECT IDENTIFIER, GeneralizedTime, constrained types, and tagging
+- **A-XDR Encoding (IEC 61334-6:2000)** — Size-optimized encoding for COSEM APDU (Application Protocol Data Unit)
+- **BER Encoding (X.690)** — Basic Encoding Rules for COSEM ACSE (Association Control Service Element)
+- **COSEM APDU Types** — All PDU types defined in the Green Book: xDLMS services, COSEM services, and all response types
+- **COSEM ACSE Types** — Application association, authentication, and release PDUs
+
+## Installation
+
+```bash
+pip install COSEMpdu
+```
+
+Requires Python ≥ 3.12.
+
+## Quick Start
+
+```python
+from COSEMpdu.apdu import (
+    GetRequest, InvokeIdAndPriority,
+    CosemAttributeDescriptor,
+    CosemClassId, CosemObjectInstanceId, CosemObjectAttributeId,
+)
+from COSEMpdu.byte_buffer import ByteBuffer
+from StructResult.result import Error
+
+# Create a GET-Request PDU
+get = GetRequest(
+    invoke_id_and_priority=InvokeIdAndPriority(0x13),  # invoke_id=1, confirmed, priority high
+    cosem_attribute_descriptor=CosemAttributeDescriptor(
+        class_id=CosemClassId(8),                        # Clock object
+        instance_id=CosemObjectInstanceId(b"\x00\x00\x01\x00\x00\xff"),  # logical name
+        attribute_id=CosemObjectAttributeId(2)           # attribute #2 (time)
+    )
+)
+
+# Encode to A-XDR bytes
+buf = ByteBuffer(bytearray(100))
+get.put(buf)
+print(bytes(buf.extract()).hex())  # => encoded PDU bytes
+
+# Decode from bytes
+result = GetRequest.get(buf.extract())
+match result:
+    case Error():
+        print("Decode failed:", result.err)
+    case _:
+        decoded: GetRequest = result
+        print(decoded.cosem_attribute_descriptor.class_id)
+```
+
+### ACSE (BER) Example
+
+```python
+from COSEMpdu.acse import (
+    AARQapdu, ProtocolVersion, ApplicationContextName,
+    CalledAPInvocationId, CalledAEInvocationId,
+    CallingAPInvocationId, CallingAEInvocationId,
+    RequestMechanismName,
+)
+from COSEMpdu.byte_buffer import ByteBuffer
+from StructResult.result import Error
+
+# Create an AARQ (Application Association Request) — BER encoding
+aarq = AARQapdu(
+    protocol_version=ProtocolVersion((1, 1)),
+    application_context_name=ApplicationContextName(
+        (2, 16, 756, 5, 8, 1, 1)  # LN referencing
+    ),
+    called_ap_invocation_id=CalledAPInvocationId(1),
+    called_ae_invocation_id=CalledAEInvocationId(2),
+    calling_ap_invocation_id=CallingAPInvocationId(3),
+    calling_ae_invocation_id=CallingAEInvocationId(4),
+    mechanism_name=RequestMechanismName(
+        (2, 16, 756, 5, 8, 2, 2)  # LLS authentication
+    ),
+)
+
+# Encode using BER rules
+buf = ByteBuffer(bytearray(512))
+aarq.put(buf)
+print(bytes(buf.extract()).hex())
+
+# Decode back
+result = AARQapdu.get(buf.extract())
+match result:
+    case Error():
+        print("Decode failed:", result.err)
+    case _:
+        decoded = result
+        print(decoded.application_context_name)  # (2, 16, 756, 5, 8, 1, 1)
+```
+
+## Supported Standards
+
+| Standard | Description |
+|----------|-------------|
+| **IEC 61334-6:2000** | DLMS/COSEM A-XDR encoding rules |
+| **X.680** | ASN.1 notation and type definitions |
+| **X.690** | BER (Basic Encoding Rules) |
+| **IEC 62056 / EN 13757-1** | DLMS/COSEM application layer |
+
+## Modules
+
+| Module | Purpose |
+|--------|---------|
+| `COSEMpdu.x680` | ASN.1 type system: base types, tags, constraints |
+| `COSEMpdu.axdr` | A-XDR encoding/decoding for DLMS/COSEM |
+| `COSEMpdu.x690` | BER Tag and Length encoding primitives |
+| `COSEMpdu.ber` | BER encoding/decoding for ASN.1 types |
+| `COSEMpdu.data` | COSEM data types (Integer8..Unsigned64, Data, COSEM specific types) |
+| `COSEMpdu.apdu` | All COSEM APDU types and services (GET, SET, ACTION, etc.) |
+| `COSEMpdu.acse` | ACSE APDU types (AARQ, AARE, RLRQ, RLRE) |
+| `COSEMpdu.byte_buffer` | Byte-level read/write buffer |
+
+## Project Links
+
+- **Source code:** [GitHub](https://github.com/youserj/COSEMpdu_project)
+- **Issues:** [GitHub Issues](https://github.com/youserj/COSEMpdu_project/issues)
+
+## License
+
+MIT License — see the source repository for details.

{cosempdu-0.3.4 → cosempdu-0.4.2}/pyproject.toml

@@ -9,14 +9,14 @@ package-dir = {"" = "src"}
 
 [project]
 name = "COSEMpdu"
-version = "0.3.4"
+version = "0.4.2"
 authors = [
     {name="Serj Kotilevski", email="youserj@outlook.com"}
 ]
 dependencies = [
     "StructResult>=0.9.9",
 ]
-description="cosem-pdu"
+description = "DLMS/COSEM PDU encoder/decoder with ASN.1 types, A-XDR and BER encoding rules (IEC 61334-6, X.680, X.690)"
 readme = "README.md"
 requires-python = ">=3.12"
 keywords=['dlms', 'asn.1', 'a-xdr', 'ber', 'pdu', 'coder']
@@ -74,3 +74,4 @@ include = [
         # "TRY",
     ]
     #extend-select = ["D"]
+

cosempdu-0.4.2/src/COSEMpdu/acse.py

@@ -0,0 +1,347 @@
+"""
+COSEM PDU Types Implementation
+Based on COSEMpdu_GB83.txt (Green Book 8.3)
+Implements A-XDR encoding/decoding according to IEC 61334-6 ACSE APDU Types (COSEMpdu_GB83
+"""
+from dataclasses import dataclass
+from typing import ClassVar, Optional, Final
+from . import x690
+from .x680 import Class
+from .ber import GraphicString, BitStringType, IntegerType, SequenceType, ExplicitTaggedType, OctetStringType, ChoiceType, ObjectIdentifierType
+
+
+class ApplicationContextName(ExplicitTaggedType, ObjectIdentifierType):
+    """application-context-name [1] Application-context-name"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(1, Class.CONTEXT_SPECIFIC, True)
+
+
+class APTitle(OctetStringType):
+    """AP-title"""
+
+
+class AEQualifier(OctetStringType):
+    """AE-qualifier"""
+
+
+class APInvocationIdentifier(IntegerType):
+    """AP-invocation-identifier"""
+
+
+class AEInvocationIdentifier(IntegerType):
+    """AE-invocation-identifier"""
+
+
+class ACSERequirements(BitStringType):
+    """ACSE-requirements"""
+    AUTHENTICATION: Final[int] = 0
+
+
+class MechanismName(ObjectIdentifierType):
+    """Mechanism-name"""
+
+
+class Charstring(GraphicString):
+    """charstring [0] IMPLICIT GraphicString"""
+    tag: ClassVar[x690.Tag] = x690.Tag(0, Class.CONTEXT_SPECIFIC)
+
+
+class BitString(BitStringType):
+    """bitstring [1] IMPLICIT BIT STRING"""
+    tag: ClassVar[x690.Tag] = x690.Tag(1, Class.CONTEXT_SPECIFIC)
+
+
+class AuthenticationValue(ChoiceType):
+    """Authentication-value"""
+    value: Charstring | BitString
+
+
+class ImplementationInformation(GraphicString):
+    """implementation-information [29] IMPLICIT Implementation-data"""
+    tag: ClassVar[x690.Tag] = x690.Tag(29, Class.CONTEXT_SPECIFIC)
+
+
+class UserInformation(ExplicitTaggedType, OctetStringType):
+    """user-information [30] EXPLICIT Association-information"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(30, Class.CONTEXT_SPECIFIC, True)
+
+
+class Result(ExplicitTaggedType, IntegerType):
+    """result [2] Association-result"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(2, Class.CONTEXT_SPECIFIC, True)
+    ACCEPTED: int = 0
+    REJECTED_PERMANENT: int = 1
+    REJECTED_TRANSIENT: int = 2
+
+
+class ACSEServiceUser(ExplicitTaggedType, IntegerType):
+    """acse-service-user [1] INTEGER"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(1, Class.CONTEXT_SPECIFIC, True)
+    NULL: int = 0
+    NO_REASON_GIVEN: int = 1
+    APPLICATION_CONTEXT_NAME_NOT_SUPPORTED: int = 2
+    CALLING_AP_TITLE_NOT_RECOGNIZED: int = 3
+    CALLING_AP_INVOCATION_IDENTIFIER_NOT_RECOGNIZED: int = 4
+    CALLING_AE_QUALIFIER_NOT_RECOGNIZED: int = 5
+    CALLING_AE_INVOCATION_IDENTIFIER_NOT_RECOGNIZED: int = 6
+    CALLED_AP_TITLE_NOT_RECOGNIZED: int = 7
+    CALLED_AP_INVOCATION_IDENTIFIER_NOT_RECOGNIZED: int = 8
+    CALLED_AE_QUALIFIER_NOT_RECOGNIZED: int = 9
+    CALLED_AE_INVOCATION_IDENTIFIER_NOT_RECOGNIZED: int = 10
+    AUTHENTICATION_MECHANISM_NAME_NOT_RECOGNISED: int = 11
+    AUTHENTICATION_MECHANISM_NAME_REQUIRED: int = 12
+    AUTHENTICATION_FAILURE: int = 13
+    AUTHENTICATION_REQUIRED: int = 14
+
+
+class ACSEServiceProvider(ExplicitTaggedType, IntegerType):
+    """acse-service-provider [2] INTEGER"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(2, Class.CONTEXT_SPECIFIC, True)
+    NULL: int = 0
+    NO_REASON_GIVEN: int = 1
+    NO_COMMON_ACSE_VERSION: int = 2
+
+
+class ResultSourceDiagnostic(ExplicitTaggedType, ChoiceType):
+    """result-source-diagnostic [3] Associate-source-diagnostic"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(3, Class.CONTEXT_SPECIFIC, True)
+    value: ACSEServiceUser | ACSEServiceProvider
+
+
+class RequestReason(IntegerType):
+    """reason [0] IMPLICIT Release-request-reason"""
+    tag: ClassVar[x690.Tag] = x690.Tag(0, Class.CONTEXT_SPECIFIC)
+    NORMAL: int = 0
+    URGENT: int = 1
+    USER_DEFINED: int = 30
+
+
+class ResponseReason(IntegerType):
+    """reason [0] IMPLICIT Release-response-reason"""
+    tag: ClassVar[x690.Tag] = x690.Tag(0, Class.CONTEXT_SPECIFIC)
+    NORMAL: int = 0
+    NOT_FINISHED: int = 1
+    USER_DEFINED: int = 30
+
+
+class ProtocolVersion(BitStringType):
+    """protocol-version [0] IMPLICIT BIT STRING {version1 (0)}"""
+    tag: ClassVar[x690.Tag] = x690.Tag(0, Class.CONTEXT_SPECIFIC)
+    VERSION1: Final[int] = 0
+
+
+DEFAULT_PROTOCOL_VERSION = ProtocolVersion((0,))
+
+
+class CalledAPTitle(ExplicitTaggedType, APTitle):
+    """called-AP-title [2] AP-title"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(2, Class.CONTEXT_SPECIFIC, True)
+
+
+class CallingAPTitle(ExplicitTaggedType, APTitle):
+    """calling-AP-title [6] AP-title"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(6, Class.CONTEXT_SPECIFIC, True)
+
+
+class CalledAEQualifier(ExplicitTaggedType, AEQualifier):
+    """called-AE-qualifier [3] AE-qualifier"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(3, Class.CONTEXT_SPECIFIC, True)
+
+
+class CallingAEQualifier(ExplicitTaggedType, AEQualifier):
+    """calling-AE-qualifier [7] AE-qualifier"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(7, Class.CONTEXT_SPECIFIC, True)
+
+
+class CalledAPInvocationId(APInvocationIdentifier, ExplicitTaggedType):
+    """called-AP-invocation-id [4] AP-invocation-identifier"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(4, Class.CONTEXT_SPECIFIC, True)
+
+
+class CallingAPInvocationId(APInvocationIdentifier, ExplicitTaggedType):
+    """calling-AP-invocation-id [8] AP-invocation-identifier"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(8, Class.CONTEXT_SPECIFIC, True)
+
+
+class CalledAEInvocationId(ExplicitTaggedType, AEInvocationIdentifier):
+    """called-AE-invocation-id [5] AE-invocation-identifier"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(5, Class.CONTEXT_SPECIFIC, True)
+
+
+class CallingAEInvocationId(ExplicitTaggedType, AEInvocationIdentifier):
+    """calling-AE-invocation-id [9] AE-invocation-identifier"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(9, Class.CONTEXT_SPECIFIC, True)
+
+
+class SenderACSERequirements(ACSERequirements):
+    """sender-acse-requirements [10] IMPLICIT ACSE-requirements"""
+    tag: ClassVar[x690.Tag] = x690.Tag(10, Class.CONTEXT_SPECIFIC)
+
+
+class RequestMechanismName(MechanismName):
+    """mechanism-name [11] IMPLICIT Mechanism-name"""
+    tag: ClassVar[x690.Tag] = x690.Tag(11, Class.CONTEXT_SPECIFIC)
+
+
+class CallingAuthenticationValue(ExplicitTaggedType, AuthenticationValue):
+    """calling-authentication-value [12] EXPLICIT Authentication-value"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(12, Class.CONTEXT_SPECIFIC, constructed=True)
+
+
+class AARQapdu(SequenceType):
+    """AARQ-apdu ::= [APPLICATION 0] IMPLICIT SEQUENCE"""
+    tag: ClassVar[x690.Tag] = x690.Tag(0, Class.APPLICATION, constructed=True)
+    protocol_version: ProtocolVersion = DEFAULT_PROTOCOL_VERSION
+    application_context_name: ApplicationContextName
+    called_ap_title: Optional[CalledAPTitle]
+    called_ae_qualifier: Optional[CalledAEQualifier]
+    called_ap_invocation_id: Optional[CalledAPInvocationId]
+    called_ae_invocation_id: Optional[CalledAEInvocationId]
+    calling_ap_title: Optional[CallingAPTitle]
+    calling_ae_qualifier: Optional[CallingAEQualifier]
+    calling_ap_invocation_id: Optional[CallingAPInvocationId]
+    calling_ae_invocation_id: Optional[CallingAEInvocationId]
+    sender_acse_requirements: Optional[SenderACSERequirements]
+    mechanism_name: Optional[RequestMechanismName]
+    calling_authentication_value: Optional[CallingAuthenticationValue]
+    implementation_information: Optional[ImplementationInformation]
+    user_information: Optional[UserInformation]
+
+    def __init__(
+        self,
+        *,
+        protocol_version: ProtocolVersion = DEFAULT_PROTOCOL_VERSION,
+        application_context_name: ApplicationContextName,
+        called_ap_title: Optional[CalledAPTitle] = None,
+        called_ae_qualifier: Optional[CalledAEQualifier] = None,
+        called_ap_invocation_id: Optional[CalledAPInvocationId] = None,
+        called_ae_invocation_id: Optional[CalledAEInvocationId] = None,
+        calling_ap_title: Optional[CallingAPTitle] = None,
+        calling_ae_qualifier: Optional[CallingAEQualifier] = None,
+        calling_ap_invocation_id: Optional[CallingAPInvocationId] = None,
+        calling_ae_invocation_id: Optional[CallingAEInvocationId] = None,
+        sender_acse_requirements: Optional[SenderACSERequirements] = None,
+        mechanism_name: Optional[RequestMechanismName] = None,
+        calling_authentication_value: Optional[CallingAuthenticationValue] = None,
+        implementation_information: Optional[ImplementationInformation] = None,
+        user_information: Optional[UserInformation] = None,
+    ) -> None:
+        self.protocol_version = protocol_version
+        self.application_context_name = application_context_name
+        self.called_ap_title = called_ap_title
+        self.called_ae_qualifier = called_ae_qualifier
+        self.called_ap_invocation_id = called_ap_invocation_id
+        self.called_ae_invocation_id = called_ae_invocation_id
+        self.calling_ap_title = calling_ap_title
+        self.calling_ae_qualifier = calling_ae_qualifier
+        self.calling_ap_invocation_id = calling_ap_invocation_id
+        self.calling_ae_invocation_id = calling_ae_invocation_id
+        self.sender_acse_requirements = sender_acse_requirements
+        self.mechanism_name = mechanism_name
+        self.calling_authentication_value = calling_authentication_value
+        self.implementation_information = implementation_information
+        self.user_information = user_information
+
+
+class RespondingAPTitle(ExplicitTaggedType, APTitle):
+    """responding-AP-title [4] AP-title"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(4, Class.CONTEXT_SPECIFIC, True)
+
+
+class RespondingAEQualifier(ExplicitTaggedType, AEQualifier):
+    """responding-AE-qualifier [5] AE-qualifier"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(5, Class.CONTEXT_SPECIFIC, True)
+
+
+class RespondingAPInvocationId(ExplicitTaggedType, APInvocationIdentifier):
+    """responding-AP-invocation-id [6] AP-invocation-identifier tagged"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(6, Class.CONTEXT_SPECIFIC, True)
+
+
+class RespondingAEInvocationId(ExplicitTaggedType, AEInvocationIdentifier):
+    """responding-AE-invocation-id [7] AE-invocation-identifier"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(7, Class.CONTEXT_SPECIFIC, True)
+
+
+class ResponderACSERequirements(ACSERequirements):
+    """responder-acse-requirements [8] IMPLICIT ACSE-requirements tagged"""
+    tag: ClassVar[x690.Tag] = x690.Tag(8, Class.CONTEXT_SPECIFIC)
+
+
+class ResponseMechanismName(MechanismName):
+    """mechanism-name [9] IMPLICIT Mechanism-name"""
+    tag: ClassVar[x690.Tag] = x690.Tag(9, Class.CONTEXT_SPECIFIC)
+
+
+class RespondingAuthenticationValue(ExplicitTaggedType, AuthenticationValue):
+    """responding-authentication-value [10] EXPLICIT Authentication-value"""
+    tag2: ClassVar[x690.Tag] = x690.Tag(10, Class.CONTEXT_SPECIFIC, True)
+
+
+class AAREapdu(SequenceType):
+    """AARE-apdu ::= [APPLICATION 1] IMPLICIT SEQUENCE"""
+    tag: ClassVar[x690.Tag] = x690.Tag(1, Class.APPLICATION, True)
+    protocol_version: ProtocolVersion = DEFAULT_PROTOCOL_VERSION
+    application_context_name: ApplicationContextName
+    result: Result
+    result_source_diagnostic: ResultSourceDiagnostic
+    responding_ap_title: Optional[RespondingAPTitle]
+    responding_ae_qualifier: Optional[RespondingAEQualifier]
+    responding_ap_invocation_id: Optional[RespondingAPInvocationId]
+    responding_ae_invocation_id: Optional[RespondingAEInvocationId]
+    responder_acse_requirements: Optional[ResponderACSERequirements]
+    mechanism_name: Optional[ResponseMechanismName]
+    responding_authentication_value: Optional[RespondingAuthenticationValue]
+    implementation_information: Optional[ImplementationInformation]
+    user_information: Optional[UserInformation]
+
+    def __init__(
+        self,
+        *,
+        protocol_version: ProtocolVersion = DEFAULT_PROTOCOL_VERSION,
+        application_context_name: ApplicationContextName,
+        result: Result,
+        result_source_diagnostic: ResultSourceDiagnostic,
+        responding_ap_title: Optional[RespondingAPTitle] = None,
+        responding_ae_qualifier: Optional[RespondingAEQualifier] = None,
+        responding_ap_invocation_id: Optional[RespondingAPInvocationId] = None,
+        responding_ae_invocation_id: Optional[RespondingAEInvocationId] = None,
+        responder_acse_requirements: Optional[ResponderACSERequirements] = None,
+        mechanism_name: Optional[ResponseMechanismName] = None,
+        responding_authentication_value: Optional[RespondingAuthenticationValue] = None,
+        implementation_information: Optional[ImplementationInformation] = None,
+        user_information: Optional[UserInformation] = None,
+    ) -> None:
+        self.protocol_version = protocol_version
+        self.application_context_name = application_context_name
+        self.result = result
+        self.result_source_diagnostic = result_source_diagnostic
+        self.responding_ap_title = responding_ap_title
+        self.responding_ae_qualifier = responding_ae_qualifier
+        self.responding_ap_invocation_id = responding_ap_invocation_id
+        self.responding_ae_invocation_id = responding_ae_invocation_id
+        self.responder_acse_requirements = responder_acse_requirements
+        self.mechanism_name = mechanism_name
+        self.responding_authentication_value = responding_authentication_value
+        self.implementation_information = implementation_information
+        self.user_information = user_information
+
+
+@dataclass
+class RLRQapdu(SequenceType):
+    """RLRQ-apdu ::= [APPLICATION 2] IMPLICIT SEQUENCE"""
+    tag: ClassVar[x690.Tag] = x690.Tag(2, Class.APPLICATION, True)
+    reason: Optional[RequestReason] = None
+    user_information: Optional[UserInformation] = None
+
+
+@dataclass
+class RLREapdu(SequenceType):
+    """RLRE-apdu ::= [APPLICATION 3] IMPLICIT SEQUENCE"""
+    tag: ClassVar[x690.Tag] = x690.Tag(3, Class.APPLICATION, True)
+    reason: Optional[ResponseReason] = None
+    user_information: Optional[UserInformation] = None
+
+
+class ACSEApdu(ChoiceType):
+    """ACSE-APDU"""
+    value: AARQapdu | AAREapdu | RLRQapdu | RLREapdu