MTPPy2.0 0.1.5__tar.gz → 0.2.0__tar.gz

{mtppy2_0-0.1.5/src/MTPPy2.0.egg-info → mtppy2_0-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MTPPy2.0
-Version: 0.1.5
+Version: 0.2.0
 Summary: Open-source modular automation with MTP 2.0
 Author: Dresden University of Technology, Process-to-Order Group
 Author-email: Julius Lorenz <julius.lorenz@tu-dresden.de>, Leon Urbas <leon.urbas@tu-dresden.de>
@@ -21,6 +21,8 @@ License-File: LICENSE
 Requires-Dist: opcua~=0.98.13
 Requires-Dist: jsonschema>=4.26.0
 Requires-Dist: chardet>=7.6.0
+Requires-Dist: aiohttp>=3.12.0
+Requires-Dist: pymodbus>=3.15.0
 Requires-Dist: simple-pid>=2.0.1
 Requires-Dist: pymodbus>=3.15.0
 Dynamic: license-file
@@ -56,19 +58,19 @@ uv add MTPPy2.0
 
 ### Developers
 - Check out ``main`` from the [gitlab repository](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0)
-- Run `uv sync --all-groups` to setup the virtual environment `mtppy2-0` and install
+- Run `uv sync --all-groups` to set up the virtual environment `mtppy2-0` and install
   all the required packages for running and development
 - You might want to inspect the examples in ``./examples`` and perhaps the jupyter-notebook snippets in 
   ``./snippets``
 
 ### Contributors
-- Check out ``next_release`` from the [gitlab repository](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0)
-- Run `uv sync --all-groups` to to setup the virtual environment `mtppy2-0` and install
+- Check out ``develop`` from the [gitlab repository](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0)
+- Run `uv sync --all-groups` to set up the virtual environment `mtppy2-0` and install
   all the required packages for running and development
 - Study the [developer handbook](https://aas-demo.p2o-lab.ifa.et.tu-dresden.de/mtppy2.0/developer/developer/) 
 - Feel invited to contribute by 
     - joining the development on a certain [branch](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/branches), or by
-    - selecting an [open issue](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/boards?milestone_title=Started&types=ISSUE) an creating a branch 
+    - selecting an [open issue](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/boards?milestone_title=Started&types=ISSUE), create your branch and provide a solution
 
 
 

{mtppy2_0-0.1.5 → mtppy2_0-0.2.0}/README.md

@@ -29,19 +29,19 @@ uv add MTPPy2.0
 
 ### Developers
 - Check out ``main`` from the [gitlab repository](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0)
-- Run `uv sync --all-groups` to setup the virtual environment `mtppy2-0` and install
+- Run `uv sync --all-groups` to set up the virtual environment `mtppy2-0` and install
   all the required packages for running and development
 - You might want to inspect the examples in ``./examples`` and perhaps the jupyter-notebook snippets in 
   ``./snippets``
 
 ### Contributors
-- Check out ``next_release`` from the [gitlab repository](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0)
-- Run `uv sync --all-groups` to to setup the virtual environment `mtppy2-0` and install
+- Check out ``develop`` from the [gitlab repository](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0)
+- Run `uv sync --all-groups` to set up the virtual environment `mtppy2-0` and install
   all the required packages for running and development
 - Study the [developer handbook](https://aas-demo.p2o-lab.ifa.et.tu-dresden.de/mtppy2.0/developer/developer/) 
 - Feel invited to contribute by 
     - joining the development on a certain [branch](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/branches), or by
-    - selecting an [open issue](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/boards?milestone_title=Started&types=ISSUE) an creating a branch 
+    - selecting an [open issue](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/boards?milestone_title=Started&types=ISSUE), create your branch and provide a solution
 
 
 

{mtppy2_0-0.1.5 → mtppy2_0-0.2.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "MTPPy2.0"
-version = "0.1.5"
+version = "0.2.0"
 description = "Open-source modular automation with MTP 2.0"
 readme="README.md"
 license = "MIT"
-license-files = ["LICENSE" ]
+license-files = ["LICENSE"]
 requires-python = ">=3.13" 
 authors = [
     { name = "Dresden University of Technology, Process-to-Order Group" },
@@ -25,6 +25,8 @@ dependencies = [
     "opcua~=0.98.13",
     "jsonschema>=4.26.0",
     "chardet>=7.6.0",
+    "aiohttp>=3.12.0",
+    "pymodbus>=3.15.0",
     "simple-pid>=2.0.1",
     "pymodbus>=3.15.0",
 ]
@@ -40,9 +42,10 @@ build-backend = "setuptools.build_meta"
 
 [project.scripts]
 inspect_mtp = "tools.inspect_mtp:main"
+minimal_recipe = "tools.minimal_recipe:main"
+scan_pea = "tools.scan_pea:main"
 rmtp_pea = "mtppy.pea.rmtp_pea:main"
 
-
 [dependency-groups]
 dev = [
     "black>=26.5.1",
@@ -100,7 +103,12 @@ filterwarnings = [
 ]
 
 [tool.ruff]
+line-length = 88
+target-version = "py310"
+inline-quotes = "double"
+
 lint.select = ["ALL"]
+
 # ANN001 - Missing type annotation for function argument
 # `incorrect-blank-line-before-class` (D203) and `no-blank-line-before-class` (D211) are incompatible. Ignoring `incorrect-blank-line-before-class`.
 # `multi-line-summary-first-line` (D212) and `multi-line-summary-second-line` (D213) are incompatible. Ignoring `multi-line-summary-second-line`.
@@ -110,3 +118,6 @@ lint.select = ["ALL"]
 # `Missing blank line after last section` (D413)
 # `Too many arguments in function definition` (PLR0913)
 lint.ignore = ["ANN002","ANN003","D203","D213","D205","D413","PLR0913"]
+
+[tool.ruff.pydocstyle]
+convention = "google"  # Enforce Google-style docstrings

{mtppy2_0-0.1.5 → mtppy2_0-0.2.0/src/MTPPy2.0.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MTPPy2.0
-Version: 0.1.5
+Version: 0.2.0
 Summary: Open-source modular automation with MTP 2.0
 Author: Dresden University of Technology, Process-to-Order Group
 Author-email: Julius Lorenz <julius.lorenz@tu-dresden.de>, Leon Urbas <leon.urbas@tu-dresden.de>
@@ -21,6 +21,8 @@ License-File: LICENSE
 Requires-Dist: opcua~=0.98.13
 Requires-Dist: jsonschema>=4.26.0
 Requires-Dist: chardet>=7.6.0
+Requires-Dist: aiohttp>=3.12.0
+Requires-Dist: pymodbus>=3.15.0
 Requires-Dist: simple-pid>=2.0.1
 Requires-Dist: pymodbus>=3.15.0
 Dynamic: license-file
@@ -56,19 +58,19 @@ uv add MTPPy2.0
 
 ### Developers
 - Check out ``main`` from the [gitlab repository](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0)
-- Run `uv sync --all-groups` to setup the virtual environment `mtppy2-0` and install
+- Run `uv sync --all-groups` to set up the virtual environment `mtppy2-0` and install
   all the required packages for running and development
 - You might want to inspect the examples in ``./examples`` and perhaps the jupyter-notebook snippets in 
   ``./snippets``
 
 ### Contributors
-- Check out ``next_release`` from the [gitlab repository](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0)
-- Run `uv sync --all-groups` to to setup the virtual environment `mtppy2-0` and install
+- Check out ``develop`` from the [gitlab repository](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0)
+- Run `uv sync --all-groups` to set up the virtual environment `mtppy2-0` and install
   all the required packages for running and development
 - Study the [developer handbook](https://aas-demo.p2o-lab.ifa.et.tu-dresden.de/mtppy2.0/developer/developer/) 
 - Feel invited to contribute by 
     - joining the development on a certain [branch](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/branches), or by
-    - selecting an [open issue](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/boards?milestone_title=Started&types=ISSUE) an creating a branch 
+    - selecting an [open issue](https://gitlab.hrz.tu-chemnitz.de/process-to-order-group/mtppy2.0/-/boards?milestone_title=Started&types=ISSUE), create your branch and provide a solution
 
 
 

{mtppy2_0-0.1.5 → mtppy2_0-0.2.0}/src/MTPPy2.0.egg-info/SOURCES.txt

@@ -8,12 +8,30 @@ src/MTPPy2.0.egg-info/entry_points.txt
 src/MTPPy2.0.egg-info/requires.txt
 src/MTPPy2.0.egg-info/top_level.txt
 src/examples/__init__.py
-src/examples/minimal+pid.py
-src/examples/minimal.py
-src/examples/minimal_recipe.py
 src/examples/pea_alarm_base.py
-src/examples/pea_minimal.py
+src/examples/modbus/__init__.py
+src/examples/modbus/m15_logic.py
+src/examples/modbus/m15_pea.py
+src/examples/modbus/m15_pea_test.py
+src/examples/modbus/m15_simulator.py
+src/examples/rmtp/__init__.py
+src/examples/rmtp/minimal+pid.py
+src/examples/rmtp/minimal.py
+src/examples/scratch/__init__.py
+src/examples/scratch/pea_minimal.py
 src/mtppy/__init__.py
+src/mtppy/feas/__init__.py
+src/mtppy/feas/modbus/__init__.py
+src/mtppy/feas/modbus/config_loader.py
+src/mtppy/feas/modbus/config_loader_test.py
+src/mtppy/feas/modbus/io_action.py
+src/mtppy/feas/modbus/io_action_test.py
+src/mtppy/feas/modbus/io_logic.py
+src/mtppy/feas/modbus/io_logic_test.py
+src/mtppy/feas/modbus/io_procedure.py
+src/mtppy/feas/modbus/io_procedure_test.py
+src/mtppy/feas/modbus/io_service.py
+src/mtppy/feas/modbus/io_service_test.py
 src/mtppy/part1/__init__.py
 src/mtppy/part1/empty_folder_test.py
 src/mtppy/part3/__init__.py
@@ -158,6 +176,7 @@ src/mtppy/pea/user_logic/user_logic_pea.py
 src/mtppy/pea/user_logic/user_logic_registry.py
 src/mtppy/pea/user_logic/user_logic_registry_test.py
 src/mtppy/pea/user_logic/user_logic_service.py
+src/mtppy/pea/user_logic/user_logic_service_scenario_test.py
 src/mtppy/pea/user_logic/user_logic_service_test.py
 src/mtppy/utils/__init__.py
 src/mtppy/utils/data_assembly_dict.py
@@ -193,6 +212,8 @@ src/mtppy/utils/mtp_file_handling/mtp_writer/ressources/get_rels.py
 src/tools/__init__.py
 src/tools/create_bugreport.py
 src/tools/inspect_mtp.py
+src/tools/minimal_recipe.py
+src/tools/scan_pea.py
 src/utils/__init__.py
 src/utils/get_uuid.py
 src/utils/get_uuid_test.py

{mtppy2_0-0.1.5 → mtppy2_0-0.2.0}/src/MTPPy2.0.egg-info/entry_points.txt

@@ -1,3 +1,5 @@
 [console_scripts]
 inspect_mtp = tools.inspect_mtp:main
+minimal_recipe = tools.minimal_recipe:main
 rmtp_pea = mtppy.pea.rmtp_pea:main
+scan_pea = tools.scan_pea:main

{mtppy2_0-0.1.5 → mtppy2_0-0.2.0}/src/MTPPy2.0.egg-info/requires.txt

@@ -1,5 +1,7 @@
 opcua~=0.98.13
 jsonschema>=4.26.0
 chardet>=7.6.0
+aiohttp>=3.12.0
+pymodbus>=3.15.0
 simple-pid>=2.0.1
 pymodbus>=3.15.0

mtppy2_0-0.2.0/src/examples/modbus/m15_logic.py

@@ -0,0 +1,108 @@
+"""Application logic for the M15 PEM electrolysis module service ``produce``."""
+
+__copyright__ = (
+    "Copyright (c) 2026 Dresden University of Technology, Process-to-Order Group"
+)
+__license__ = "MIT"
+
+from mtppy.part3.data_assembly_set.active_elements.pid.pid_ctrl import PIDCtrl
+from mtppy.utils.logging import logger
+from mtppy.part4.automation_services.service import Service
+from mtppy.pea.user_logic.user_logic_registry import register
+
+__requirements_mtp__ = "M15.mtp"
+
+DA_PRESSURE_UNITS = "p_eng_units"
+DA_TEMP_UNITS = "t_eng_units"
+DA_VOLUME_UNITS = "v_eng_units"
+DA_START_STOP = "start_stop"
+DA_VALVE = "V010"
+
+
+"""
+Spezifikation für produce.auto.starting.entry:
+    Setze die Anzeigeeinheiten des Generators (Druck, Temperatur,
+    Volumen) auf den Standardwert 0.
+"""
+
+
+@register("produce.auto.starting.entry")
+def reset_units(context: Service) -> bool:
+    context.get_param(DA_PRESSURE_UNITS).V = 0
+    context.get_param(DA_TEMP_UNITS).V = 0
+    context.get_param(DA_VOLUME_UNITS).V = 0
+
+    pctl: PIDCtrl = context.get_param("PIC009")
+
+    pctl.op_mode.set_state_channel(True)
+    pctl.op_mode.set_state_aut_aut(True)
+    pctl.src_mode.set_src_channel(True)
+    pctl.src_mode.set_src_man_aut(True)
+    pctl.SPManMin = pctl.SPSclMin = 0
+    pctl.SPManMax = pctl.SPSclMax = 100
+
+    return True
+
+
+"""
+Spezifikation für produce.auto.starting.do:
+    Starte den Generator und öffne das Auslassventil.
+"""
+
+
+@register("produce.auto.starting.do")
+def start_generator(context: Service) -> bool:
+    start_stop = context.get_param(DA_START_STOP)
+    valve = context.get_param(DA_VALVE)
+    p_out_sp = context.get_param("p_out_sp")
+    pctl: PIDCtrl = context.get_param("PIC009")
+
+    start_stop.V = 0
+    valve.OpenAut = 1
+    pctl.SPMan = p_out_sp.VOut
+
+    return True
+
+
+"""
+Spezifikation für produce.auto.holding.do:
+    Schließe das Auslassventil.
+"""
+
+
+@register("produce.auto.holding.do")
+def hold_generator(context: Service) -> bool:
+    context.get_param(DA_VALVE).CloseAut = 1
+    return True
+
+
+"""
+Spezifikation für produce.auto.unholding.do:
+    Öffne das Auslassventil.
+"""
+
+
+@register("produce.auto.unholding.do")
+def unhold_generator(context: Service) -> bool:
+    context.get_param(DA_VALVE).OpenAut = 1
+    return True
+
+
+"""
+Spezifikation für produce.auto.completing.do sowie stopping und aborting:
+    Stoppe den Generator (DA_START_STOP.V = 1) und schließe das 
+    Auslassventil (DA_VALVE.V = 0).
+"""
+
+
+@register(
+    "produce.auto.completing.do", "produce.auto.stopping.do", "produce.auto.aborting.do"
+)
+def stop_generator(context: Service) -> bool:
+    start_stop = context.get_param(DA_START_STOP)
+    valve = context.get_param(DA_VALVE)
+
+    start_stop.V = 1
+    valve.CloseAut = 1
+
+    return True

mtppy2_0-0.2.0/src/examples/modbus/m15_pea.py

@@ -0,0 +1,225 @@
+"""Access the M15 Modbus server through an MTPPy PEA background service."""
+
+__copyright__ = (
+    "Copyright (c) 2026 Dresden University of Technology, Process-to-Order Group"
+)
+__license__ = "MIT"
+import argparse
+import asyncio
+from pathlib import Path
+
+from pymodbus.client import ModbusTcpClient
+
+from mtppy.feas.modbus import (
+    IOLogic,
+    IOProcedure,
+    IOService,
+    load_register_mappings,
+)
+from mtppy.part3.data_assembly_set.data_assembly import DataAssembly
+from mtppy.pea.user_logic.user_logic_pea import UserLogicPEA
+from mtppy.utils.logging import CHOICES, logger, setLogLevel
+
+DEFAULT_HOST = "localhost"
+DEFAULT_MODBUS_PORT = 5020
+DEFAULT_OPCUA_ENDPOINT = "opc.tcp://localhost:4044"
+DEFAULT_CYCLE_TIME = 0.5
+CONFIG_PATH = Path(__file__).with_name("m15_modbus.json")
+
+
+class M15Pea(UserLogicPEA):
+    """PEA that exposes M15 registers as internal DataAssemblies."""
+
+    def __init__(
+        self,
+        endpoint: str = DEFAULT_OPCUA_ENDPOINT,
+        host: str = DEFAULT_HOST,
+        modbus_port: int = DEFAULT_MODBUS_PORT,
+        config_path: str | Path = CONFIG_PATH,
+        cycle_time: float = DEFAULT_CYCLE_TIME,
+        mtp: str = "",
+        ssd: str = "",
+        code: str = "",
+    ) -> None:
+        super().__init__(endpoint=endpoint, mtp=mtp, ssd=ssd, code=code)
+        self.modbus_client = ModbusTcpClient(host, port=modbus_port)
+
+        internal_data_assemblies, mappings, assignments = load_register_mappings(
+            config_path, dict(self.data_assemblies)
+        )
+        if mtp:
+            matching_data_assemblies = self._matching_requirement_data_assemblies(
+                internal_data_assemblies
+            )
+            for mapping in mappings:
+                matching_data_assembly = matching_data_assemblies.get(
+                    mapping.data_assembly.tag_name
+                )
+                if matching_data_assembly is not None:
+                    mapping.data_assembly = matching_data_assembly
+        else:
+            self.add_data_assembly(internal_data_assemblies)
+
+        self.io_logic = IOLogic(self.modbus_client, mappings)
+        self.io_procedure = IOProcedure(
+            self.io_logic,
+            required_equipment=list(internal_data_assemblies.values()),
+        )
+        self.io_service = IOService(self.io_procedure, cycle_time=cycle_time)
+        self.add_service(self.io_service)
+
+        self._assign_data_assemblies(assignments, internal_data_assemblies)
+
+    def _matching_requirement_data_assemblies(
+        self, modbus_data_assemblies: dict[str, DataAssembly]
+    ) -> dict[str, DataAssembly]:
+        """Validate and return rMTP assemblies matching Modbus configuration.
+
+        Args:
+            modbus_data_assemblies: Assemblies declared by the Modbus
+                ``internal_equipment`` configuration.
+
+        Returns:
+            rMTP-loaded assemblies keyed by the configured Modbus tag name.
+            Tags missing from the requirements MTP or with a mismatching
+            DataAssembly class are skipped (and logged) rather than raised.
+        """
+        matching_data_assemblies: dict[str, DataAssembly] = {}
+        for tag_name, modbus_data_assembly in modbus_data_assemblies.items():
+            requirement_data_assembly = self.data_assemblies.get(tag_name)
+            if requirement_data_assembly is None:
+                logger.warning(
+                    f"Modbus DataAssembly {tag_name!r} is missing from requirements MTP"
+                )
+                continue
+            if type(requirement_data_assembly) is not type(modbus_data_assembly):
+                logger.warning(
+                    f"Modbus DataAssembly {tag_name!r} has class "
+                    f"{type(modbus_data_assembly).__name__}, but requirements MTP "
+                    f"defines {type(requirement_data_assembly).__name__}"
+                )
+                continue
+            matching_data_assemblies[tag_name] = requirement_data_assembly
+        return matching_data_assemblies
+
+    def _assign_data_assemblies(
+        self,
+        assignments: dict[str, list[str]],
+        data_assemblies: dict[str, DataAssembly],
+    ) -> None:
+        """Add DataAssemblies as required equipment to named procedures.
+
+        Args:
+            assignments: Mapping of procedure name to list of tag names.
+            data_assemblies: Pool of DataAssembly instances to look up by tag name.
+        """
+        for procedure_name, tag_names in assignments.items():
+            procedure = self._find_procedure(procedure_name)
+            if procedure is None:
+                logger.critical(
+                    f"procedure {procedure_name!r} not found for assignment"
+                )
+                continue
+            for tag_name in tag_names:
+                if tag_name not in data_assemblies:
+                    logger.critical(
+                        f"DataAssembly {tag_name!r} not found for assignment "
+                        f"to procedure {procedure_name!r}"
+                    )
+                    continue
+                procedure.add_required_equipment(data_assemblies[tag_name])
+
+    def _find_procedure(self, name: str):
+        """Find a procedure by name among all registered services.
+
+        Args:
+            name: Procedure name to search for.
+
+        Returns:
+            The matching procedure, or None if not found.
+        """
+        for service in self.service_set.values():
+            for procedure in service.procedures.values():
+                if procedure.name == name:
+                    return procedure
+        return None
+
+    def start(self) -> None:
+        """Start the OPC UA server and the cyclic Modbus I/O service."""
+        if not self.modbus_client.connect():
+            raise ConnectionError("unable to connect to the M15 Modbus server")
+        super().start()
+        self.io_service.activate_and_run()
+
+    def stop(self) -> None:
+        """Stop the cyclic I/O service, OPC UA server, and Modbus client."""
+        self.io_service.stop()
+        super().stop()
+        self.modbus_client.close()
+
+
+def parse_args(args: list[str] | None = None) -> argparse.Namespace:
+    """Parse command-line options for the M15 PEA."""
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--host", default=DEFAULT_HOST)
+    parser.add_argument("-p", "--modbus-port", type=int, default=DEFAULT_MODBUS_PORT)
+    parser.add_argument("--endpoint", default=DEFAULT_OPCUA_ENDPOINT)
+    parser.add_argument(
+        "-r",
+        "--rmtp",
+        default="",
+        help="basename of the requirements MTP files (without .mtp or .json)",
+    )
+    parser.add_argument(
+        "-u",
+        "--user-logic",
+        dest="user_logic",
+        default="",
+        help="Python module containing the user logic",
+    )
+    parser.add_argument(
+        "-m",
+        "--modbus-config",
+        type=Path,
+        default=CONFIG_PATH,
+        help="path to the Modbus register-mapping JSON configuration file",
+    )
+    parser.add_argument("-t", "--duration", type=float, default=10.0)
+    parser.add_argument("-c", "--cycle-time", type=float, default=DEFAULT_CYCLE_TIME)
+    parser.add_argument("-d", "--daemon", action="store_true")
+    parser.add_argument(
+        "-l",
+        "--log-level",
+        default="MTP",
+        choices=["DEBUG", "INFO", *CHOICES, "WARNING", "ERROR", "CRITICAL"],
+        help="logging level (default: MTP)",
+    )
+    return parser.parse_args(args)
+
+
+async def main(args: list[str] | None = None) -> None:
+    """Start the M15 PEA and keep it alive for the requested duration."""
+    parsed_args = parse_args(args)
+    setLogLevel(parsed_args.log_level)
+    pea = M15Pea(
+        endpoint=parsed_args.endpoint,
+        host=parsed_args.host,
+        modbus_port=parsed_args.modbus_port,
+        config_path=parsed_args.modbus_config,
+        cycle_time=parsed_args.cycle_time,
+        mtp=f"{parsed_args.rmtp}.mtp" if parsed_args.rmtp else "",
+        ssd=f"{parsed_args.rmtp}.json" if parsed_args.rmtp else "",
+        code=parsed_args.user_logic,
+    )
+    try:
+        pea.start()
+        if parsed_args.daemon:
+            await asyncio.Event().wait()
+        else:
+            await asyncio.sleep(parsed_args.duration)
+    finally:
+        pea.stop()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

mtppy2_0-0.2.0/src/examples/modbus/m15_pea_test.py

@@ -0,0 +1,117 @@
+"""Tests for M15 PEA."""
+
+__copyright__ = (
+    "Copyright (c) 2026 Dresden University of Technology, Process-to-Order Group"
+)
+__license__ = "MIT"
+
+import json
+from pathlib import Path
+from unittest.mock import patch, MagicMock
+
+from examples.modbus.m15_pea import M15Pea
+from mtppy.part3.data_assembly_set.indicator_elements.views.dint_view import DIntView
+
+
+def test_loads_internal_data_assemblies_from_config(tmp_path):
+    config = {
+        "internal_equipment": {
+            "start_stop": {
+                "class": "mtppy.part3.data_assembly_set.indicator_elements.views.dint_view.DIntView",
+                "V": {"register": 401, "access": "write"},
+            },
+            "p_out": {
+                "class": "mtppy.part3.data_assembly_set.indicator_elements.views.dint_view.DIntView",
+                "V": {"register": 400, "access": "write"},
+            },
+        }
+    }
+    config_path = tmp_path / "config.json"
+    config_path.write_text(json.dumps(config))
+
+    with patch("pymodbus.client.ModbusTcpClient") as mock_client_cls:
+        mock_client_cls.return_value.connect.return_value = True
+        pea = M15Pea(config_path=config_path)
+
+    assert "start_stop" in pea.data_assemblies
+    assert "p_out" in pea.data_assemblies
+    assert isinstance(pea.data_assemblies["start_stop"], DIntView)
+
+
+def test_write_access_configures_communication_object(tmp_path):
+    config = {
+        "internal_equipment": {
+            "start_stop": {
+                "class": "mtppy.part3.data_assembly_set.indicator_elements.views.dint_view.DIntView",
+                "V": {"register": 401, "access": "write"},
+            },
+        }
+    }
+    config_path = tmp_path / "config.json"
+    config_path.write_text(json.dumps(config))
+
+    with patch("pymodbus.client.ModbusTcpClient") as mock_client_cls:
+        mock_client_cls.return_value.connect.return_value = True
+        pea = M15Pea(config_path=config_path)
+
+    mapping = pea.io_logic.mappings[0]
+    assert mapping.access == "write"
+    assert mapping.register == 401
+
+
+def test_assign_adds_data_assembly_to_named_procedure(tmp_path):
+    config = {
+        "internal_equipment": {
+            "start_stop": {
+                "class": "mtppy.part3.data_assembly_set.indicator_elements.views.dint_view.DIntView",
+                "assign": ["auto"],
+                "V": {"register": 401, "access": "write"},
+            },
+        }
+    }
+    config_path = tmp_path / "config.json"
+    config_path.write_text(json.dumps(config))
+
+    mock_procedure = MagicMock()
+    mock_procedure.name = "auto"
+    mock_service = MagicMock()
+    mock_service.procedures = {"auto": mock_procedure}
+
+    with patch("pymodbus.client.ModbusTcpClient") as mock_client_cls:
+        mock_client_cls.return_value.connect.return_value = True
+        pea = M15Pea(config_path=config_path)
+        pea.service_set["produce"] = mock_service
+
+    pea._assign_data_assemblies(
+        {"auto": ["start_stop"]},
+        {"start_stop": pea.data_assemblies["start_stop"]},
+    )
+
+    mock_procedure.add_required_equipment.assert_called_once_with(
+        pea.data_assemblies["start_stop"]
+    )
+
+
+def test_assign_logs_warning_for_missing_procedure(tmp_path, caplog):
+    config = {
+        "internal_equipment": {
+            "start_stop": {
+                "class": "mtppy.part3.data_assembly_set.indicator_elements.views.dint_view.DIntView",
+                "assign": ["nonexistent"],
+                "V": {"register": 401, "access": "write"},
+            },
+        }
+    }
+    config_path = tmp_path / "config.json"
+    config_path.write_text(json.dumps(config))
+
+    with patch("pymodbus.client.ModbusTcpClient") as mock_client_cls:
+        mock_client_cls.return_value.connect.return_value = True
+        pea = M15Pea(config_path=config_path)
+
+    pea._assign_data_assemblies(
+        {"nonexistent": ["start_stop"]},
+        {"start_stop": pea.data_assemblies["start_stop"]},
+    )
+
+    assert "procedure 'nonexistent' not found for assignment" in caplog.text