Add Verdi-G / HOPS monitor examples

Two read-only status monitors under examples/verdig/ (stream once per second,
Ctrl-C to stop; neither takes remote control, so the front panel stays usable):
- temperature_monitor_native.py: main temperature over native pyftdi I2C (no DLL).
- status_monitor_dll.py: full status (four servo temperatures, power, shutter,
  emission, interlock/faults) over Coherent's CohrHOPS.dll.
Plus a short README.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01841beMNdCw3zYf6fdBUoy7

Author: dccote

examples/verdig/README.md

@@ -0,0 +1,16 @@
+# Verdi-G / HOPS examples
+
+Read-only monitors for a Coherent HOPS-supply laser (Genesis / Verdi-G). Both
+stream once per second and stop on Ctrl-C. Neither takes remote control, so the
+front-panel wheel keeps working while they run.
+
+- `temperature_monitor_native.py` — main temperature over **native pyftdi I2C**
+  (no DLL). macOS/Linux; needs pyftdi + libusb and the laser on this host.
+- `status_monitor_dll.py` — full status (all four servo temperatures, power,
+  shutter, emission, interlock/faults) over **Coherent's `CohrHOPS.dll`**.
+  Windows/Linux; needs the DLLs (see `../../hardwarelibrary/manuals/`
+  `Coherent-HOPS-2-USB-and-DLL-Protocol.md`).
+
+For the full driver and the two transports, see
+`hardwarelibrary/sources/verdig.py` (`VerdiGDevice`) and the `Coherent-HOPS-*`
+docs under `hardwarelibrary/manuals/`.

examples/verdig/status_monitor_dll.py

@@ -0,0 +1,53 @@
+"""Stream full Verdi-G / HOPS status over Coherent's CohrHOPS.dll (Windows/Linux).
+
+Read-only: it does not change the laser state or take remote control (the front
+panel stays usable). Unlike the native transport, the DLL path also reads all
+four thermal-servo temperatures and the interlock/fault state.
+
+Setup: place CohrHOPS.dll and CohrFTCI2C.dll (matching your Python's bitness)
+next to hardwarelibrary/sources/hopsdll.py, or pass dllDirectory=... below.
+
+Run:  python examples/verdig/status_monitor_dll.py [count]
+"""
+import datetime
+import sys
+import time
+
+from hardwarelibrary.sources.hopsdll import HOPSDLLInterface
+
+
+def main():
+    count = int(sys.argv[1]) if len(sys.argv) > 1 else None
+    interface = HOPSDLLInterface()             # or HOPSDLLInterface(dllDirectory=r"C:\dlls")
+    interface.open()
+
+    identity = interface.identity()
+    print("Connected via CohrHOPS.dll: {0} (head {1}, s/n {2}, max {3:.3f} W)".format(
+        identity["model"], identity["headType"], identity["serialNumber"],
+        identity["maxPower"]))
+
+    read = 0
+    try:
+        while count is None or read < count:
+            diag = interface.diagnostics()     # includes the four servo temperatures
+            temps = ("main={mainTemperature:.1f} SHG={shgTemperature:.1f} "
+                     "BRF={brfTemperature:.1f} etalon={etalonTemperature:.1f}").format(**diag)
+            faults = interface.faults()
+            interlock = "ok" if interface.interlockOk() else "FAULT"
+            stamp = datetime.datetime.now().strftime("%H:%M:%S")
+            print("{0}  {1} C  |  P={2:.3f} W  shutter={3}  emission={4}  interlock={5}{6}".format(
+                stamp, temps, interface.getPower(),
+                "open" if interface.shutterOpen() else "closed",
+                "ON" if interface.emissionOn() else "off", interlock,
+                ("  faults=" + ",".join(faults)) if faults else ""))
+            read += 1
+            if count is None or read < count:
+                time.sleep(1.0)
+    except KeyboardInterrupt:
+        print()
+    finally:
+        interface.close()
+
+
+if __name__ == "__main__":
+    main()

examples/verdig/temperature_monitor_native.py

@@ -0,0 +1,40 @@
+"""Stream the Verdi-G / HOPS main temperature over native pyftdi I2C (no DLL).
+
+Read-only: it does not change the laser state or take remote control (so the
+front panel stays usable). Works on macOS/Linux with the laser attached and
+pyftdi + libusb available.
+
+Run:  python examples/verdig/temperature_monitor_native.py [count]
+On macOS, put the directory that holds libusb-1.0 on the loader path, e.g.:
+  DYLD_LIBRARY_PATH=/opt/homebrew/lib python examples/verdig/temperature_monitor_native.py
+"""
+import datetime
+import sys
+import time
+
+from hardwarelibrary.sources.hopsnative import HOPSNativeInterface
+
+
+def main():
+    count = int(sys.argv[1]) if len(sys.argv) > 1 else None
+    interface = HOPSNativeInterface()          # or HOPSNativeInterface(url="ftdi://...")
+    interface.open()
+    print("Verdi-G / HOPS main-temperature monitor (Ctrl-C to stop). "
+          "Native calibration valid ~32-40 C.")
+    read = 0
+    try:
+        while count is None or read < count:
+            celsius = interface.mainTemperature()
+            stamp = datetime.datetime.now().strftime("%H:%M:%S")
+            print("{0}   TMAIN = {1:6.2f} C".format(stamp, celsius))
+            read += 1
+            if count is None or read < count:
+                time.sleep(1.0)
+    except KeyboardInterrupt:
+        print()
+    finally:
+        interface.close()
+
+
+if __name__ == "__main__":
+    main()