#####################################################################
# settings.py
#
# (c) Copyright 2024, Benjamin Parzella. All rights reserved.
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This software is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Lesser General Public License for more details.
#####################################################################
"""Secs I over TCP settings class."""
from __future__ import annotations
import enum
import secsgem.common
[docs]
class SecsITcpConnectMode(enum.Enum):
"""Secs I over TCP connect mode (client or server)."""
CLIENT = 1
SERVER = 2
def __repr__(self) -> str:
"""String representation of object."""
return "Client" if self == self.CLIENT else "Server"
def __str__(self) -> str:
"""String representation of object."""
return "Client" if self == self.CLIENT else "Server"
[docs]
class SecsITcpSettings(secsgem.common.Settings):
"""Settings for Secs I over TCP connection.
These attributes can be initialized in the constructor and accessed as property.
Example:
>>> import secsgem.secsitcp
>>>
>>> settings = secsgem.secsitcp.SecsITcpSettings(device_type=secsgem.common.DeviceType.EQUIPMENT)
>>> settings.device_type
Equipment
>>> settings.address
'127.0.0.1'
"""
def __init__(self, **kwargs) -> None:
"""Initialize settings."""
super().__init__(**kwargs)
self._connect_mode = kwargs.get("connect_mode", SecsITcpConnectMode.CLIENT)
self._address = kwargs.get("address", "127.0.0.1")
self._port = kwargs.get("port", 5000)
self._validate_args(kwargs)
@classmethod
def _args(cls) -> list[str]:
return [*super()._args(), "connect_mode", "address", "port"]
@property
def connect_mode(self) -> SecsITcpConnectMode:
"""Secs I over TCP connect mode.
Default: SecsITcpConnectMode.CLIENT
"""
return self._connect_mode
@property
def address(self) -> str:
"""Remote (client) or local (server) IP address.
Default: "127.0.0.1"
"""
return self._address
@property
def port(self) -> int: # type: ignore[override]
"""TCP port of remote host.
Default: 5000
"""
return self._port
[docs]
def create_protocol(self) -> secsgem.common.Protocol:
"""Protocol class for this configuration."""
from secsgem.secsi.protocol import SecsIProtocol # pylint: disable=import-outside-toplevel
return SecsIProtocol(self)
[docs]
def create_connection(self) -> secsgem.common.Connection:
"""Connection class for this configuration."""
if self.connect_mode == SecsITcpConnectMode.CLIENT:
return secsgem.common.TcpClientConnection(self)
return secsgem.common.TcpServerConnection(self)
@property
def name(self) -> str:
"""Name of this configuration."""
return f"SECSITCP-{self.connect_mode}_{self.address}:{self.port}"
[docs]
def generate_thread_name(self, functionality: str) -> str:
"""Generate a unique thread name for this configuration and a provided functionality.
Args:
functionality: name of the functionality to generate thread name for
Returns:
generated thread name
"""
return f"secsgem_SECSITCP_{functionality}_{self.connect_mode}_{self.address}:{self.port}"