wandelbots_api_client 26.7.0.dev53__tar.gz → 26.7.0.dev55__tar.gz

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wandelbots_api_client
-Version: 26.7.0.dev53
+Version: 26.7.0.dev55
 Summary: Wandelbots Python Client: Interact with robots in an easy and intuitive way. 
 Author: Copyright (c) 2025 Wandelbots GmbH
 Author-email: Copyright (c) 2025 Wandelbots GmbH <contact@wandelbots.com>
@@ -31,7 +31,7 @@ Description-Content-Type: text/markdown
 Interact with robots in an easy and intuitive way.
 
 - Compatible API version: 2.7.0 dev (can be found at the home screen of your instance -> API)
-- Package version: 26.7.0.dev53
+- Package version: 26.7.0.dev55
 
 ## Requirements.
 Python >=3.9, Python < 4.0

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/README.md

@@ -2,7 +2,7 @@
 Interact with robots in an easy and intuitive way.
 
 - Compatible API version: 2.7.0 dev (can be found at the home screen of your instance -> API)
-- Package version: 26.7.0.dev53
+- Package version: 26.7.0.dev55
 
 ## Requirements.
 Python >=3.9, Python < 4.0

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "wandelbots_api_client"
-version = "26.7.0.dev53"
+version = "26.7.0.dev55"
 description = "Wandelbots Python Client: Interact with robots in an easy and intuitive way. "
 authors = [{ name="Copyright (c) 2025 Wandelbots GmbH", email="contact@wandelbots.com" }]
 license = "Apache-2.0"

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2/__init__.py

@@ -13,7 +13,7 @@ Generated by OpenAPI Generator (https://openapi-generator.tech)
 Do not edit the class manually.
 """  # noqa: E501
 
-__version__ = "26.7.0.dev53"
+__version__ = "26.7.0.dev55"
 
 from . import api
 from . import api_client

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2/api_client.py

@@ -106,7 +106,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = "Wandelbots-Nova-API-Python-Client/26.7.0.dev53"
+        self.user_agent = "Wandelbots-Nova-API-Python-Client/26.7.0.dev55"
         self.client_side_validation = configuration.client_side_validation
 
     async def __aenter__(self):

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2/configuration.py

@@ -557,7 +557,7 @@ class Configuration:
             "OS: {env}\n"
             "Python Version: {pyversion}\n"
             "Version of the API: 2.7.0 dev\n"
-            "SDK Package Version: 26.7.0.dev53".format(env=sys.platform, pyversion=sys.version)
+            "SDK Package Version: 26.7.0.dev55".format(env=sys.platform, pyversion=sys.version)
         )
 
     def get_host_settings(self) -> List[HostSetting]:

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2/models/__init__.py

@@ -53,6 +53,8 @@ from wandelbots_api_client.v2.models.bus_io_profinet_slot import BusIOProfinetSl
 from wandelbots_api_client.v2.models.bus_io_profinet_virtual import BusIOProfinetVirtual
 from wandelbots_api_client.v2.models.bus_io_snap7 import BusIOSnap7
 from wandelbots_api_client.v2.models.bus_io_type import BusIOType
+from wandelbots_api_client.v2.models.bus_ios_network_interface import BusIOsNetworkInterface
+from wandelbots_api_client.v2.models.bus_ios_network_interface_with_addresses import BusIOsNetworkInterfaceWithAddresses
 from wandelbots_api_client.v2.models.bus_ios_state import BusIOsState
 from wandelbots_api_client.v2.models.bus_ios_state_enum import BusIOsStateEnum
 from wandelbots_api_client.v2.models.capability_entry import CapabilityEntry

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2/models/bus_io_modbus_client.py

@@ -16,9 +16,10 @@ import pprint
 import re  # noqa: F401
 import json
 
-from pydantic import BaseModel, ConfigDict, StrictStr, field_validator
-from typing import Any, ClassVar, Dict, List
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
 from wandelbots_api_client.v2.models.bus_io_modbus_tcp_client import BusIOModbusTCPClient
+from wandelbots_api_client.v2.models.bus_ios_network_interface_with_addresses import BusIOsNetworkInterfaceWithAddresses
 from typing import Optional, Set
 from typing_extensions import Self
 from pydantic_core import to_jsonable_python
@@ -31,7 +32,11 @@ class BusIOModbusClient(BaseModel):
 
     bus_type: StrictStr
     network: BusIOModbusTCPClient
-    __properties: ClassVar[List[str]] = ["bus_type", "network"]
+    network_interface: Optional[BusIOsNetworkInterfaceWithAddresses] = Field(
+        default=None,
+        description="Direct network access to a physical port for this bus I/O service. When set, the service is assigned a dedicated DRA-managed network interface instead of using the node's shared network. The addresses are assigned to the interface so it can route to the target device's segment. ",
+    )
+    __properties: ClassVar[List[str]] = ["bus_type", "network", "network_interface"]
 
     @field_validator("bus_type")
     def bus_type_validate_enum(cls, value):
@@ -80,6 +85,9 @@ class BusIOModbusClient(BaseModel):
         # override the default output from pydantic by calling `to_dict()` of network
         if self.network:
             _dict["network"] = self.network.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of network_interface
+        if self.network_interface:
+            _dict["network_interface"] = self.network_interface.to_dict()
         return _dict
 
     @classmethod
@@ -95,6 +103,9 @@ class BusIOModbusClient(BaseModel):
             {
                 "bus_type": obj.get("bus_type"),
                 "network": BusIOModbusTCPClient.from_dict(obj["network"]) if obj.get("network") is not None else None,
+                "network_interface": BusIOsNetworkInterfaceWithAddresses.from_dict(obj["network_interface"])
+                if obj.get("network_interface") is not None
+                else None,
             }
         )
         return _obj

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2/models/bus_io_modbus_server.py

@@ -17,9 +17,10 @@ import re  # noqa: F401
 import json
 
 from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
-from typing import Any, ClassVar, Dict, List
+from typing import Any, ClassVar, Dict, List, Optional
 from typing_extensions import Annotated
 from wandelbots_api_client.v2.models.bus_io_modbus_tcp_server import BusIOModbusTCPServer
+from wandelbots_api_client.v2.models.bus_ios_network_interface_with_addresses import BusIOsNetworkInterfaceWithAddresses
 from typing import Optional, Set
 from typing_extensions import Self
 from pydantic_core import to_jsonable_python
@@ -47,6 +48,10 @@ class BusIOModbusServer(BaseModel):
     input_registers_size: Annotated[int, Field(le=65535, strict=True, ge=0)] = Field(
         description="Size of the Input Registers memory area. ", json_schema_extra={"examples": [10]}
     )
+    network_interface: Optional[BusIOsNetworkInterfaceWithAddresses] = Field(
+        default=None,
+        description="Direct network access to a physical port for this bus I/O service. When set, the service is assigned a dedicated DRA-managed network interface instead of using the node's shared network. The server binds to the given addresses, which are therefore required here. ",
+    )
     __properties: ClassVar[List[str]] = [
         "bus_type",
         "network",
@@ -55,6 +60,7 @@ class BusIOModbusServer(BaseModel):
         "discrete_inputs_size",
         "holding_registers_size",
         "input_registers_size",
+        "network_interface",
     ]
 
     @field_validator("bus_type")
@@ -104,6 +110,9 @@ class BusIOModbusServer(BaseModel):
         # override the default output from pydantic by calling `to_dict()` of network
         if self.network:
             _dict["network"] = self.network.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of network_interface
+        if self.network_interface:
+            _dict["network_interface"] = self.network_interface.to_dict()
         return _dict
 
     @classmethod
@@ -124,6 +133,9 @@ class BusIOModbusServer(BaseModel):
                 "discrete_inputs_size": obj.get("discrete_inputs_size"),
                 "holding_registers_size": obj.get("holding_registers_size"),
                 "input_registers_size": obj.get("input_registers_size"),
+                "network_interface": BusIOsNetworkInterfaceWithAddresses.from_dict(obj["network_interface"])
+                if obj.get("network_interface") is not None
+                else None,
             }
         )
         return _obj

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2/models/bus_io_profinet.py

@@ -22,6 +22,7 @@ from typing_extensions import Annotated
 from wandelbots_api_client.v2.models.bus_io_profinet_default_route import BusIOProfinetDefaultRoute
 from wandelbots_api_client.v2.models.bus_io_profinet_network import BusIOProfinetNetwork
 from wandelbots_api_client.v2.models.bus_io_profinet_slot import BusIOProfinetSlot
+from wandelbots_api_client.v2.models.bus_ios_network_interface import BusIOsNetworkInterface
 from typing import Optional, Set
 from typing_extensions import Self
 from pydantic_core import to_jsonable_python
@@ -50,7 +51,11 @@ class BusIOProfinet(BaseModel):
         description="Optional PROFINET slot configuration.  If not provided, the default configuration is used for backward compatibility: one slot with a size of 64 bytes. ",
     )
     default_route: Optional[BusIOProfinetDefaultRoute] = None
-    __properties: ClassVar[List[str]] = ["bus_type", "network_config", "plc_ip", "mac", "slots", "default_route"]
+    network_interface: Optional[BusIOsNetworkInterface] = Field(
+        default=None,
+        description="Direct network access to a physical port for this bus I/O service. When set, the service is assigned a dedicated DRA-managed network interface instead of using the node's shared network. Profinet configures its own IP via `network_config`, so addresses are not required here. ",
+    )
+    __properties: ClassVar[List[str]] = ["bus_type", "network_config", "plc_ip", "mac", "slots", "default_route", "network_interface"]
 
     @field_validator("bus_type")
     def bus_type_validate_enum(cls, value):
@@ -109,6 +114,9 @@ class BusIOProfinet(BaseModel):
         # override the default output from pydantic by calling `to_dict()` of default_route
         if self.default_route:
             _dict["default_route"] = self.default_route.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of network_interface
+        if self.network_interface:
+            _dict["network_interface"] = self.network_interface.to_dict()
         return _dict
 
     @classmethod
@@ -130,6 +138,9 @@ class BusIOProfinet(BaseModel):
                 "default_route": BusIOProfinetDefaultRoute.from_dict(obj["default_route"])
                 if obj.get("default_route") is not None
                 else None,
+                "network_interface": BusIOsNetworkInterface.from_dict(obj["network_interface"])
+                if obj.get("network_interface") is not None
+                else None,
             }
         )
         return _obj

wandelbots_api_client-26.7.0.dev55/wandelbots_api_client/v2/models/bus_ios_network_interface.py

@@ -0,0 +1,99 @@
+# coding: utf-8
+
+"""
+Wandelbots NOVA API
+
+Interact with robots in an easy and intuitive way.
+
+The version of the OpenAPI document: 2.7.0 dev
+Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+Do not edit the class manually.
+"""  # noqa: E501
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic_core import to_jsonable_python
+
+
+class BusIOsNetworkInterface(BaseModel):
+    """
+    Direct network interface for the bus I/O service. When set, the service gets its own interface on the specified port to reach the bus device's network.
+    """  # noqa: E501
+
+    interface: Annotated[str, Field(strict=True)] = Field(
+        description="Network port identifier. Either a bare port name, e.g., `enp3s0` or a node-qualified identifier, e.g., `wandelbox-abc123-enp3s0`. Use the node-qualified form on multi-node clusters to pin the interface to a specific node.  Cannot be changed in-place. Delete and add the Bus I/O service again to another port. ",
+        json_schema_extra={"examples": ["wandelbox-abc123-enp3s0"]},
+    )
+    addresses: Optional[Annotated[List[Annotated[str, Field(strict=True)]], Field(min_length=1)]] = Field(
+        default=None,
+        description="IPv4 addresses to assign to the interface, in address/prefix format, e.g., `192.168.1.10/24`. ",
+        json_schema_extra={"examples": [["192.168.1.10/24"]]},
+    )
+    __properties: ClassVar[List[str]] = ["interface", "addresses"]
+
+    @field_validator("interface")
+    def interface_validate_regular_expression(cls, value):
+        """Validates the regular expression"""
+        if not re.match(r"^[A-Za-z0-9]([A-Za-z0-9._-]*[A-Za-z0-9])?$", value):
+            raise ValueError(r"must validate the regular expression /^[A-Za-z0-9]([A-Za-z0-9._-]*[A-Za-z0-9])?$/")
+        return value
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return json.dumps(to_jsonable_python(self.to_dict()))
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of BusIOsNetworkInterface from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of BusIOsNetworkInterface from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({"interface": obj.get("interface"), "addresses": obj.get("addresses")})
+        return _obj

wandelbots_api_client-26.7.0.dev55/wandelbots_api_client/v2/models/bus_ios_network_interface_with_addresses.py

@@ -0,0 +1,99 @@
+# coding: utf-8
+
+"""
+Wandelbots NOVA API
+
+Interact with robots in an easy and intuitive way.
+
+The version of the OpenAPI document: 2.7.0 dev
+Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+Do not edit the class manually.
+"""  # noqa: E501
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from typing import Optional, Set
+from typing_extensions import Self
+from pydantic_core import to_jsonable_python
+
+
+class BusIOsNetworkInterfaceWithAddresses(BaseModel):
+    """
+    BusIOsNetworkInterface, but with addresses required. Used by bus I/O kinds that don't self-configure their IP and need it assigned via the network interface instead (e.g. Modbus TCP server, which must bind to a known IP).
+    """  # noqa: E501
+
+    interface: Annotated[str, Field(strict=True)] = Field(
+        description="Network port identifier. Either a bare port name, e.g., `enp3s0` or a node-qualified identifier, e.g., `wandelbox-abc123-enp3s0`. Use the node-qualified form on multi-node clusters to pin the interface to a specific node.  Cannot be changed in-place. Delete and add the Bus I/O service again to another port. ",
+        json_schema_extra={"examples": ["wandelbox-abc123-enp3s0"]},
+    )
+    addresses: Optional[Annotated[List[Annotated[str, Field(strict=True)]], Field(min_length=1)]] = Field(
+        default=None,
+        description="IPv4 addresses to assign to the interface, in address/prefix format, e.g., `192.168.1.10/24`. ",
+        json_schema_extra={"examples": [["192.168.1.10/24"]]},
+    )
+    __properties: ClassVar[List[str]] = ["interface", "addresses"]
+
+    @field_validator("interface")
+    def interface_validate_regular_expression(cls, value):
+        """Validates the regular expression"""
+        if not re.match(r"^[A-Za-z0-9]([A-Za-z0-9._-]*[A-Za-z0-9])?$", value):
+            raise ValueError(r"must validate the regular expression /^[A-Za-z0-9]([A-Za-z0-9._-]*[A-Za-z0-9])?$/")
+        return value
+
+    model_config = ConfigDict(
+        validate_by_name=True,
+        validate_by_alias=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return json.dumps(to_jsonable_python(self.to_dict()))
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of BusIOsNetworkInterfaceWithAddresses from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of BusIOsNetworkInterfaceWithAddresses from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({"interface": obj.get("interface"), "addresses": obj.get("addresses")})
+        return _obj

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2_pydantic/__init__.py

@@ -13,7 +13,7 @@ Generated by OpenAPI Generator (https://openapi-generator.tech)
 Do not edit the class manually.
 """  # noqa: E501
 
-__version__ = "26.7.0.dev53"
+__version__ = "26.7.0.dev55"
 
 from . import api
 from . import api_client

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2_pydantic/api_client.py

@@ -106,7 +106,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = "Wandelbots-Nova-API-Python-Client/26.7.0.dev53"
+        self.user_agent = "Wandelbots-Nova-API-Python-Client/26.7.0.dev55"
         self.client_side_validation = configuration.client_side_validation
 
     async def __aenter__(self):

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2_pydantic/configuration.py

@@ -557,7 +557,7 @@ class Configuration:
             "OS: {env}\n"
             "Python Version: {pyversion}\n"
             "Version of the API: 2.7.0 dev\n"
-            "SDK Package Version: 26.7.0.dev53".format(env=sys.platform, pyversion=sys.version)
+            "SDK Package Version: 26.7.0.dev55".format(env=sys.platform, pyversion=sys.version)
         )
 
     def get_host_settings(self) -> List[HostSetting]:

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2_pydantic/models/__init__.py

@@ -48,6 +48,8 @@ from .models import (
     BusIOProfinetVirtual,
     BusIOSnap7,
     BusIOType,
+    BusIOsNetworkInterface,
+    BusIOsNetworkInterfaceWithAddresses,
     BusIOsState,
     BusIOsStateEnum,
     CapabilityEntry,
@@ -565,6 +567,8 @@ __all__ = [
     "BusIOProfinetVirtual",
     "BusIOSnap7",
     "BusIOType",
+    "BusIOsNetworkInterface",
+    "BusIOsNetworkInterfaceWithAddresses",
     "BusIOsState",
     "BusIOsStateEnum",
     "CapabilityEntry",

{wandelbots_api_client-26.7.0.dev53 → wandelbots_api_client-26.7.0.dev55}/wandelbots_api_client/v2_pydantic/models/models.py

@@ -838,6 +838,32 @@ class BusIOProfinetDefaultRoute(BaseModel):
     """
 
 
+class BusIOsNetworkInterface(BaseModel):
+    """
+    Direct network interface for the bus I/O service. When set, the service
+    gets its own interface on the specified port to reach the bus device's
+    network.
+
+    """
+
+    interface: str = Field(..., examples=["wandelbox-abc123-enp3s0"], pattern="^[A-Za-z0-9]([A-Za-z0-9._-]*[A-Za-z0-9])?$")
+    """
+    Network port identifier. Either a bare port name, e.g., `enp3s0` or a
+    node-qualified identifier, e.g., `wandelbox-abc123-enp3s0`. Use the
+    node-qualified form on multi-node clusters to pin the interface to a
+    specific node.
+
+    Cannot be changed in-place. Delete and add the Bus I/O service again to another port.
+
+    """
+    addresses: list[Address] | None = Field(None, examples=[["192.168.1.10/24"]], min_length=1)
+    """
+    IPv4 addresses to assign to the interface, in address/prefix format,
+    e.g., `192.168.1.10/24`.
+
+    """
+
+
 class BusIOProfinet(BaseModel):
     """
     PROFINET BUS inputs/outputs service configuration.
@@ -877,6 +903,15 @@ class BusIOProfinet(BaseModel):
 
     """
     default_route: BusIOProfinetDefaultRoute | None = Field(None, deprecated=True)
+    network_interface: BusIOsNetworkInterface | None = None
+    """
+    Direct network access to a physical port for this bus I/O service.
+    When set, the service is assigned a dedicated DRA-managed network
+    interface instead of using the node's shared network. Profinet
+    configures its own IP via `network_config`, so addresses are not
+    required here.
+
+    """
 
 
 class BusIOProfinetVirtual(BaseModel):
@@ -897,6 +932,22 @@ class BusIOModbusTCPServer(BaseModel):
     """
 
 
+class BusIOsNetworkInterfaceWithAddresses(BusIOsNetworkInterface):
+    """
+    BusIOsNetworkInterface, but with addresses required. Used by bus I/O kinds
+    that don't self-configure their IP and need it assigned via the network
+    interface instead (e.g. Modbus TCP server, which must bind to a known IP).
+
+    """
+
+    addresses: list[Address] = Field(..., examples=[["192.168.1.10/24"]], min_length=1)
+    """
+    IPv4 addresses to assign to the interface, in address/prefix format,
+    e.g., `192.168.1.10/24`.
+
+    """
+
+
 class BusIOModbusServer(BaseModel):
     """
     MODBUS server inputs/outputs service configuration.
@@ -930,6 +981,14 @@ class BusIOModbusServer(BaseModel):
     Size of the Input Registers memory area.
 
     """
+    network_interface: BusIOsNetworkInterfaceWithAddresses | None = None
+    """
+    Direct network access to a physical port for this bus I/O service.
+    When set, the service is assigned a dedicated DRA-managed network
+    interface instead of using the node's shared network. The server
+    binds to the given addresses, which are therefore required here.
+
+    """
 
 
 class BusIOModbusTCPClient(BaseModel):
@@ -954,6 +1013,15 @@ class BusIOModbusClient(BaseModel):
 
     bus_type: Literal["modbus_client"] = "modbus_client"
     network: BusIOModbusTCPClient
+    network_interface: BusIOsNetworkInterfaceWithAddresses | None = None
+    """
+    Direct network access to a physical port for this bus I/O service.
+    When set, the service is assigned a dedicated DRA-managed network
+    interface instead of using the node's shared network. The addresses
+    are assigned to the interface so it can route to the target device's
+    segment.
+
+    """
 
 
 class BusIOModbusVirtual(BaseModel):