[ctrl] added GSI Online DNA shutdown and startup

Author: MrClock8163

docs/commands/control/index.rst

@@ -10,4 +10,6 @@ certain components of an instrument.
     :maxdepth: 1
 
     shutdown_geocom
+    shutdown_gsidna
     startup_geocom
+    startup_gsidna

docs/commands/control/shutdown_gsidna.rst

@@ -0,0 +1,21 @@
+Shutdown - GSI Online DNA
+=================
+
+Requirements
+------------
+
+- GSI Online capable digital level
+
+Examples
+--------
+
+.. code-block:: shell
+    :caption: Shutting down the instrument
+
+    iman shutdown gsidna COM1
+
+Usage
+-----
+
+.. click:: instrumentman.control:cli_shutdown_gsidna
+    :prog: iman shutdown gsidna

docs/commands/control/startup_gsidna.rst

@@ -0,0 +1,21 @@
+Startup - GSI Online DNA
+=================
+
+Requirements
+------------
+
+- GSI Online capable digital level
+
+Examples
+--------
+
+.. code-block:: shell
+    :caption: Waking up instrument
+
+    iman startup gsidna COM1
+
+Usage
+-----
+
+.. click:: instrumentman.control:cli_startup_gsidna
+    :prog: iman startup gsidna

src/instrumentman/__init__.py

@@ -196,4 +196,6 @@ def cli_startup() -> None:
 cli_convert.add_command(setup.cli_convert_targets_to_gsi)
 cli_convert.add_command(setmeasurement.cli_convert_set_to_gsi)
 cli_shutdown.add_command(control.cli_shutdown_geocom)
+cli_shutdown.add_command(control.cli_shutdown_gsidna)
 cli_startup.add_command(control.cli_startup_geocom)
+cli_startup.add_command(control.cli_startup_gsidna)

src/instrumentman/control/__init__.py

@@ -12,6 +12,22 @@
 )
 
 
+@extra_command(
+    "gsidna",
+    params=None,
+    context_settings={"auto_envvar_prefix": None}
+)  # type: ignore[misc]
+@com_port_argument()
+@com_option_group()
+def cli_shutdown_gsidna(**kwargs: Any) -> None:
+    """
+    Deactivate a GSI Online capable digital level.
+    """
+    from .app import main_shutdown_gsidna
+
+    main_shutdown_gsidna(**kwargs)
+
+
 @extra_command(
     "geocom",
     params=None,
@@ -55,6 +71,22 @@ def cli_shutdown_geocom(**kwargs: Any) -> None:
     main_shutdown_geocom(**kwargs)
 
 
+@extra_command(
+    "gsidna",
+    params=None,
+    context_settings={"auto_envvar_prefix": None}
+)  # type: ignore[misc]
+@com_port_argument()
+@com_option_group()
+def cli_startup_gsidna(**kwargs: Any) -> None:
+    """
+    Activate/reactivate a GSI Online capable digital level.
+    """
+    from .app import main_startup_gsidna
+
+    main_startup_gsidna(**kwargs)
+
+
 @extra_command(
     "geocom",
     params=None,

src/instrumentman/control/app.py

@@ -3,10 +3,37 @@
 from geocompy.communication import open_serial
 from geocompy.geo import GeoCom
 from geocompy.geo.gctypes import GeoComCode
+from geocompy.gsi.dna import GsiOnlineDNA
 
 from ..utils import print_error
 
 
+def main_shutdown_gsidna(
+    port: str,
+    timeout: int = 15,
+    retry: int = 1,
+    baud: int = 9600,
+    sync_after_timeout: bool = False
+) -> None:
+    logger = getLogger("iman.control.shutdown-gsidna")
+    with open_serial(
+        port,
+        speed=baud,
+        timeout=timeout,
+        retry=retry,
+        sync_after_timeout=sync_after_timeout,
+        logger=logger.getChild("com")
+    ) as com:
+        instrument = GsiOnlineDNA(com, logger.getChild("instrument"))
+        resp = instrument.shutdown()
+
+        if resp.value:
+            print_error(
+                f"Could not shut down instrument ({resp.response})"
+            )
+            exit(1)
+
+
 def main_shutdown_geocom(
     component: str,
     port: str,
@@ -15,7 +42,7 @@ def main_shutdown_geocom(
     baud: int = 9600,
     sync_after_timeout: bool = False
 ) -> None:
-    logger = getLogger("iman.control.shutdown_geocom")
+    logger = getLogger("iman.control.shutdown-geocom")
     with open_serial(
         port,
         speed=baud,
@@ -51,6 +78,32 @@ def main_shutdown_geocom(
             exit(1)
 
 
+def main_startup_gsidna(
+    port: str,
+    timeout: int = 15,
+    retry: int = 1,
+    baud: int = 9600,
+    sync_after_timeout: bool = False
+) -> None:
+    logger = getLogger("iman.control.startup-gsidna")
+    with open_serial(
+        port,
+        speed=baud,
+        timeout=timeout,
+        retry=retry,
+        sync_after_timeout=sync_after_timeout,
+        logger=logger.getChild("com")
+    ) as com:
+        instrument = GsiOnlineDNA(com, logger.getChild("instrument"))
+        resp = instrument.wakeup()
+
+        if resp.value:
+            print_error(
+                f"Could not shut down instrument ({resp.response})"
+            )
+            exit(1)
+
+
 def main_startup_geocom(
     component: str,
     port: str,
@@ -59,7 +112,7 @@ def main_startup_geocom(
     baud: int = 9600,
     sync_after_timeout: bool = False
 ) -> None:
-    logger = getLogger("iman.control.startup_geocom")
+    logger = getLogger("iman.control.startup-geocom")
     with open_serial(
         port,
         speed=baud,