aim_tti_awg 0.19.0__tar.gz

aim_tti_awg-0.19.0/.gitignore

@@ -0,0 +1,51 @@
+# Python versions and environment
+
+__pycache__
+.python-version
+.envrc
+
+# Build systems
+
+build
+dist
+**/*.egg-info
+
+# Apple specific
+
+.DS_Store
+
+# Unit testing
+
+.pytest_cache
+.coverage
+.coverage.*
+.nox
+htmlcov
+
+# dotenv, ignore all but the example file
+
+.env
+.env.*
+!.env.example
+
+# Virtual environments
+
+.venv
+venv
+
+# PyCharm IDE
+
+.idea
+
+# VSCode IDE
+
+.vscode
+*.code-workspace
+
+# MKDOCS documentation site
+
+/site
+
+# Packaging
+
+uv.lock

aim_tti_awg-0.19.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: aim_tti_awg
+Version: 0.19.0
+Summary: Aim-TTi TGF4000 Arbitrary Wave Generator
+Author: IvS KU Leuven
+Maintainer-email: Rik Huygen <rik.huygen@kuleuven.be>, Sara Regibo <sara.regibo@kuleuven.be>
+License-Expression: MIT
+Keywords: CGSE,Common-EGSE,hardware testing,software framework
+Requires-Python: >=3.10
+Requires-Dist: cgse-common
+Requires-Dist: cgse-core
+Provides-Extra: test
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-cov; extra == 'test'
+Requires-Dist: pytest-mock; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Aim-TTi TGF4000 Arbitrary Wave Generator
+
+## Reference Documents
+
+- [Aim-TTi TGF4000 Series Instruction Manual, v3.0](https://resources.aimtti.com/manuals/TGF4000_Series_Instruction_Manual-Iss3.pdf)

aim_tti_awg-0.19.0/README.md

@@ -0,0 +1,5 @@
+# Aim-TTi TGF4000 Arbitrary Wave Generator
+
+## Reference Documents
+
+- [Aim-TTi TGF4000 Series Instruction Manual, v3.0](https://resources.aimtti.com/manuals/TGF4000_Series_Instruction_Manual-Iss3.pdf)

aim_tti_awg-0.19.0/pyproject.toml

@@ -0,0 +1,82 @@
+[project]
+name = "aim_tti_awg"
+version = "0.19.0"
+description = "Aim-TTi TGF4000 Arbitrary Wave Generator"
+authors = [
+    {name = "IvS KU Leuven"}
+]
+maintainers = [
+    {name = "Rik Huygen", email = "rik.huygen@kuleuven.be"},
+    {name = "Sara Regibo", email = "sara.regibo@kuleuven.be"}
+]
+readme = {"file" = "README.md", "content-type" = "text/markdown"}
+requires-python = ">=3.10"
+license = "MIT"
+keywords = [
+    "CGSE",
+    "Common-EGSE",
+    "hardware testing",
+    "software framework",
+]
+dependencies = [
+    "cgse-common",
+    "cgse-core",
+]
+
+[project.optional-dependencies]
+test = ["pytest", "pytest-mock", "pytest-cov"]
+
+[project.scripts]
+tgf4000_cs = 'egse.arbitrary_wave_generator.aim_tti.tgf4000_cs:app'
+#tgf4000_sim = 'egse.arbitrary_wave_generator.aim_tti.tgf4000_sim:app'
+
+#[project.gui-scripts]
+#tgf4000_ui = "egse.arbitrary_wave_generator.aim_tti.tgf4000_ui:main"
+
+[project.entry-points."cgse.version"]
+aim-tti-awg = 'egse.version:get_version_installed'
+
+[project.entry-points."cgse.settings"]
+aim-tti-awg = "aim_tti_awg:settings.yaml"
+
+[project.entry-points."cgse.service.device_command"]
+tgf4000 = 'aim_tti_awg.cgse_services:tgf4000'
+
+[project.entry-points."cgse.explore"]
+explore = "aim_tti_awg.cgse_explore"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+    "/tests",
+    "/pytest.ini",
+    "/.gitignore",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/egse", "src/aim_tti_awg"]
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+extend-select = ["E501"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "setuptools", # needed by PyCharm
+    "pytest>=8.3.4",
+    "pytest-cov>=6.0.0",
+    "pytest-mock>=3.14.0",
+    "ruff>=0.9.0",
+    "nox>=2025.2.9",
+    "setuptools>=75.8.2", # needed by PyCharm
+    "pytest-asyncio>=0.26.0",
+    "ipython",
+]

aim_tti_awg-0.19.0/src/aim_tti_awg/cgse_explore.py

@@ -0,0 +1,19 @@
+__all__ = [
+    "show_processes",
+]
+
+import re
+
+from egse.process import ProcessInfo
+from egse.process import get_processes
+
+
+def show_processes():
+    """Returns of list of ProcessInfo data classes for matching processes from this package."""
+
+    def filter_procs(pi: ProcessInfo):
+        pattern = r"tgf4000"
+
+        return re.search(pattern, pi.command)
+
+    return get_processes(filter_procs)

aim_tti_awg-0.19.0/src/aim_tti_awg/cgse_services.py

@@ -0,0 +1,133 @@
+import subprocess
+from typing import Annotated
+
+import rich
+import sys
+import typer
+
+from egse.system import redirect_output_to_log
+
+tgf4000 = typer.Typer(name="tgf4000", help="Aim -TTi, Dual-channel arbitrary function generator", no_args_is_help=True)
+
+
+@tgf4000.command(name="start")
+def start_tgf40000(
+    device_id: Annotated[str, typer.Argument(help="the device identifier, identifies the hardware controller")],
+    simulator: Annotated[
+        bool, typer.Option("--simulator", "--sim", help="use a device simulator as the backend")
+    ] = False,
+):
+    """Starts the TGF4000 service.
+
+    Args:
+        device_id: TGF4000-A identifier.
+    """
+
+    rich.print("Starting service tgf4000")
+    out = redirect_output_to_log("tgf4000.start.log")
+
+    cmd = [sys.executable, "-m", "egse.arbitrary_wave_generator.aim_tti.tgf4000_cs", "start", device_id]
+    if simulator:
+        cmd.append("--simulator")
+    subprocess.Popen(
+        cmd,
+        stdout=out,
+        stderr=out,
+        stdin=subprocess.DEVNULL,
+        close_fds=True,
+    )
+
+
+@tgf4000.command(name="stop")
+def stop_tgf4000(
+    device_id: Annotated[str, typer.Argument(help="the device identifier, identifies the hardware controller")],
+):
+    """Stops the TGF4000 service.
+
+    Args:
+        device_id: TGF4000 identifier.
+    """
+
+    rich.print("Terminating service TGF4000")
+
+    out = redirect_output_to_log("tgf4000_cs.stop.log")
+
+    subprocess.Popen(
+        [sys.executable, "-m", "egse.arbitrary_wave_generator.aim_tti.tgf4000_cs", "stop", device_id],
+        stdout=out,
+        stderr=out,
+        stdin=subprocess.DEVNULL,
+        close_fds=True,
+    )
+
+
+@tgf4000.command(name="status")
+def status_tgf4000(
+    device_id: Annotated[str, typer.Argument(help="the device identifier, identifies the hardware controller")],
+):
+    """Prints status information on the TGF4000 service.
+
+    Args:
+        device_id: TGF4000 identifier.
+    """
+
+    proc = subprocess.Popen(
+        [sys.executable, "-m", "egse.arbitrary_wave_generator.aim_tti.tgf4000_cs", "status", device_id],
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        stdin=subprocess.DEVNULL,
+    )
+
+    stdout, stderr = proc.communicate()
+
+    rich.print(stdout.decode(), end="")
+
+
+@tgf4000.command(name="start-sim")
+def start_tgf4000_sim(
+    device_id: Annotated[str, typer.Argument(help="the device identifier, identifies the hardware controller")],
+):
+    """Start the TGF4000 Simulator.
+
+    Args:
+        device_id: TGF4000 identifier.
+    """
+
+    rich.print("Starting service TGF4000 Simulator")
+
+    out = redirect_output_to_log("tgf4000_sim.start.log")
+
+    subprocess.Popen(
+        [sys.executable, "-m", "egse.arbitrary_wave_generator.aim_tti.tgf4000_sim", "start", device_id],
+        stdout=out,
+        stderr=out,
+        stdin=subprocess.DEVNULL,
+        close_fds=True,
+    )
+
+
+@tgf4000.command(name="stop-sim")
+def stop_tgf4000_sim(
+    device_id: Annotated[str, typer.Argument(help="the device identifier, identifies the hardware controller")],
+):
+    """Stops the TGF4000 Simulator.
+
+    Args:
+        device_id: TGF4000 identifier.
+    """
+
+    rich.print("Terminating the TGF4000 simulator.")
+
+    out = redirect_output_to_log("tgf4000_sim.stop.log")
+
+    subprocess.Popen(
+        [sys.executable, "-m", "egse.arbitrary_wave_generator.aim_tti.tgf4000_sim", "stop", device_id],
+        stdout=out,
+        stderr=out,
+        stdin=subprocess.DEVNULL,
+        close_fds=True,
+    )
+
+
+if __name__ == "__main__":
+    tgf4000()

aim_tti_awg-0.19.0/src/aim_tti_awg/settings.yaml

@@ -0,0 +1,20 @@
+PACKAGES:
+    AIM_TTI_AWG
+
+Aim-TTi TGF4000:
+    CMD_DELAY:  0.5   # Time between subsequent commands [s]
+
+
+Aim-TTi TGF4000 Control Server:
+    PROTOCOL:     tcp
+    AWG1:
+        SERVICE_TYPE:   AWG1
+        PROCESS_NAME:   AWG1
+        PROTOCOL:       tcp
+        HOST:           localhost
+        COMMANDING_PORT: 0          # The port on which the controller listens to commands - REQ-REP
+        MONITORING_PORT: 0          # The port on which the controller sends periodic status information of the device - PUB-SUB
+        SERVICE_PORT: 0          # The port on which the controller listens for configuration and administration - REQ-REP
+        METRICS_PORT: 0          # The HTTP port where Prometheus will connect to for retrieving metrics
+        DELAY: 10          # The delay time between publishing status information [seconds]
+        STORAGE_MNEMONIC: AWG1          # The mnemonic to be used in the filename storing the housekeeping data