benchlab-pytools 3.0.0__py3-none-any.whl

benchlab/vu/VU-Server/www/views/key_settings.html

@@ -0,0 +1,132 @@
+        <!-- Page header -->
+        <div class="page-header d-print-none">
+          <div class="container-xl">
+            <div class="row g-2 align-items-center">
+              <div class="col">
+                <!-- Page pre-title -->
+                <div class="page-pretitle">
+                  API Key Settings
+                </div>
+                <h2 class="page-title">
+                  <span class="text-uppercase vu1-key-name"></span>
+                </h2>
+              </div>
+            </div>
+          </div>
+        </div>
+
+
+        <!-- Page body -->
+        <div class="page-body">
+          <div class="container-xl">
+            <div class="row row-deck row-cards">
+
+              <div class="col-12">
+                <div class="card">
+                  <div class="card-header">
+                    <h3 class="card-title">Update API key `<span class="vu1-key-name"></span>`</h3>
+                  </div>
+
+<div class="card-body" id="key-settings" >
+      <div class="modal-dialog modal-lg modal-dialog-centered" role="document">
+        <div class="modal-content">
+          <div class="modal-body">
+
+            <div class="mb-3">
+              <label class="form-label">Key Name</label>
+              <input type="text" class="form-control vu1-key-name" id="input-key-name" name="modal-new-key-name" placeholder="Name the key to recognize it easier">
+            </div>
+
+            <div id="mb-3">
+
+                <div class="mb-3">
+                  <div class="mb-3" id="modal-select-header">Select one or more dials that this API key will be able to control</div>
+                  <div class="form-selectgroup" id="modal-dials-list">
+
+                  </div>
+                </div>
+
+                <div class="mb-3">
+            <a href="#" class="btn btn-primary ms-auto" id="modal-select-all">
+                <svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-select-all" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round">
+                   <path stroke="none" d="M0 0h24v24H0z" fill="none"></path><path d="M8 8m0 1a1 1 0 0 1 1 -1h6a1 1 0 0 1 1 1v6a1 1 0 0 1 -1 1h-6a1 1 0 0 1 -1 -1z"></path><path d="M12 20v.01"></path><path d="M16 20v.01"></path><path d="M8 20v.01"></path><path d="M4 20v.01"></path><path d="M4 16v.01"></path><path d="M4 12v.01"></path><path d="M4 8v.01"></path><path d="M4 4v.01"></path><path d="M8 4v.01"></path><path d="M12 4v.01"></path><path d="M16 4v.01"></path><path d="M20 4v.01"></path><path d="M20 8v.01"></path><path d="M20 12v.01"></path><path d="M20 16v.01"></path><path d="M20 20v.01"></path>
+                </svg>
+              Select all dials
+            </a>
+
+            <a href="#" class="btn btn-primary ms-auto" id="modal-deselect-all">
+                <svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-deselect" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round">
+                   <path stroke="none" d="M0 0h24v24H0z" fill="none"></path>
+                   <path d="M12 8h3a1 1 0 0 1 1 1v3"></path>
+                   <path d="M16 16h-7a1 1 0 0 1 -1 -1v-7"></path>
+                   <path d="M12 20v.01"></path>
+                   <path d="M16 20v.01"></path>
+                   <path d="M8 20v.01"></path>
+                   <path d="M4 20v.01"></path>
+                   <path d="M4 16v.01"></path>
+                   <path d="M4 12v.01"></path>
+                   <path d="M4 8v.01"></path>
+                   <path d="M8 4v.01"></path>
+                   <path d="M12 4v.01"></path>
+                   <path d="M16 4v.01"></path>
+                   <path d="M20 4v.01"></path>
+                   <path d="M20 8v.01"></path>
+                   <path d="M20 12v.01"></path>
+                   <path d="M20 16v.01"></path>
+                   <path d="M3 3l18 18"></path>
+                </svg>
+              Select none
+            </a>
+                </div>
+
+            </div>
+
+          </div>
+          <div class="mb-4"> </div>
+          <div class="mb-3">
+
+<div class="btn-list justify-content-end">
+            <a href="#" class="btn btn-danger" id="btn-delete-key">
+<svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-trash" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round">
+   <path stroke="none" d="M0 0h24v24H0z" fill="none"></path>
+   <path d="M4 7l16 0"></path>
+   <path d="M10 11l0 6"></path>
+   <path d="M14 11l0 6"></path>
+   <path d="M5 7l1 12a2 2 0 0 0 2 2h8a2 2 0 0 0 2 -2l1 -12"></path>
+   <path d="M9 7v-3a1 1 0 0 1 1 -1h4a1 1 0 0 1 1 1v3"></path>
+</svg>
+              Delete
+            </a>
+
+            <a href="index.html?page=api_keys" class="btn ms-auto" id="submit-cancel-key">
+              <!-- Download SVG icon from http://tabler-icons.io/i/plus -->
+              <svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-circle-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round">
+   <path stroke="none" d="M0 0h24v24H0z" fill="none"></path>
+   <path d="M12 12m-9 0a9 9 0 1 0 18 0a9 9 0 1 0 -18 0"></path>
+   <path d="M10 10l4 4m0 -4l-4 4"></path>
+</svg>
+              Cancel
+            </a>
+
+            <a href="#" class="btn btn-success justify-content-end" id="submit-update-key">
+              <!-- Download SVG icon from http://tabler-icons.io/i/plus -->
+              <svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-circle-check-filled" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round">
+   <path stroke="none" d="M0 0h24v24H0z" fill="none"></path>
+   <path d="M17 3.34a10 10 0 1 1 -14.995 8.984l-.005 -.324l.005 -.324a10 10 0 0 1 14.995 -8.336zm-1.293 5.953a1 1 0 0 0 -1.32 -.083l-.094 .083l-3.293 3.292l-1.293 -1.292l-.094 -.083a1 1 0 0 0 -1.403 1.403l.083 .094l2 2l.094 .083a1 1 0 0 0 1.226 0l.094 -.083l4 -4l.083 -.094a1 1 0 0 0 -.083 -1.32z" stroke-width="0" fill="currentColor"></path>
+</svg>
+              Update key
+            </a>
+</div>
+
+          </div>
+        </div>
+      </div>
+    </div> <!-- end Add new profile modal -->
+
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+
+<script src="assets/js/vu1_gui_api_key_settings.js" defer></script>

benchlab/vu/VU-Server/www/views/start.html

@@ -0,0 +1,124 @@
+
+        <!-- Page header -->
+        <div class="page-header d-print-none">
+          <div class="container-xl">
+            <div class="row g-2 align-items-center">
+              <div class="col">
+                <!-- Page pre-title -->
+                <div class="page-pretitle">
+                  Overview
+                </div>
+                <h2 class="page-title">
+                  VU1 Dials
+                </h2>
+              </div>
+              <!-- Page title actions -->
+            </div>
+          </div>
+        </div>
+
+
+        <!-- Page body -->
+        <div class="page-body">
+          <div class="container-xl">
+            <div class="row row-deck row-cards">
+              <div class="col-12">
+                <div class="row row-cards">
+                  <div class="col-sm-6 col-lg-3">
+                    <div class="card card-sm">
+                      <div class="card-body">
+                        <div class="row align-items-center">
+                          <div class="col-auto">
+                            <span class="bg-primary text-white avatar"><!-- Download SVG icon from http://tabler-icons.io/i/currency-dollar -->
+                              <svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-needle" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round">
+   <path stroke="none" d="M0 0h24v24H0z" fill="none"></path>
+   <path d="M3 21c-.667 -.667 3.262 -6.236 11.785 -16.709a3.5 3.5 0 1 1 5.078 4.791c-10.575 8.612 -16.196 12.585 -16.863 11.918z"></path>
+   <path d="M17.5 6.5l-1 1"></path>
+</svg>
+                            </span>
+                          </div>
+                          <div class="col">
+                            <div class="font-weight-medium">
+                              VU1 Dials
+                            </div>
+                            <div class="text-secondary" id="card-dial-count">
+                            ?? Online
+                            </div>
+                          </div>
+                        </div>
+                      </div>
+                    </div>
+                  </div>
+                  <div class="col-sm-6 col-lg-3">
+                    <div class="card card-sm">
+                      <div class="card-body">
+                        <div class="row align-items-center">
+                          <div class="col-auto">
+                            <span class="bg-green text-white avatar"><!-- Download SVG icon from http://tabler-icons.io/i/shopping-cart -->
+                              <svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-key" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round">
+   <path stroke="none" d="M0 0h24v24H0z" fill="none"></path>
+   <path d="M16.555 3.843l3.602 3.602a2.877 2.877 0 0 1 0 4.069l-2.643 2.643a2.877 2.877 0 0 1 -4.069 0l-.301 -.301l-6.558 6.558a2 2 0 0 1 -1.239 .578l-.175 .008h-1.172a1 1 0 0 1 -.993 -.883l-.007 -.117v-1.172a2 2 0 0 1 .467 -1.284l.119 -.13l.414 -.414h2v-2h2v-2l2.144 -2.144l-.301 -.301a2.877 2.877 0 0 1 0 -4.069l2.643 -2.643a2.877 2.877 0 0 1 4.069 0z"></path>
+   <path d="M15 9h.01"></path>
+</svg>
+                            </span>
+                          </div>
+                          <div class="col">
+                            <div class="font-weight-medium">
+                              API keys
+                            </div>
+                            <div class="text-secondary" id="card-api-count">
+                              ?? API keys
+                            </div>
+                          </div>
+                        </div>
+                      </div>
+                    </div>
+                  </div>
+
+              <div class="col-auto ms-auto d-print-none">
+                <div class="btn-list">
+                  <a href="#" id="btn-search-for-dials" class="btn btn-primary d-none d-sm-inline-block">
+                    <!-- Download SVG icon from http://tabler-icons.io/i/plus -->
+                    <svg xmlns="http://www.w3.org/2000/svg" class="icon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 5l0 14" /><path d="M5 12l14 0" /></svg>
+                    Search for new dials
+                  </a>
+                </div>
+              </div>
+
+
+                </div>
+              </div>
+
+
+              <div class="col-12">
+                <div class="card">
+                  <div class="card-header">
+                    <h3 class="card-title">VU1 Dials</h3>
+                  </div>
+                  <div class="table-responsive">
+                    <table class="table card-table table-vcenter text-nowrap datatable" id="table_dials">
+                      <thead>
+                        <tr>
+                          <th class="w-1">Unique ID
+                          </th>
+                          <th>Name</th>
+                          <th></th>
+                        </tr>
+                      </thead>
+                      <tbody></tbody>
+                    </table>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+
+<script src="assets/js/vu1_gui_home.js" defer></script>
+
+
+    <!-- Tabler Core -->
+    <script src="assets/js/tabler.js" defer></script>
+    <script src="assets/js/demo.min.js" defer></script>
+    <!-- <script src="assets/js/jquery.min.js" defer></script> -->
+    <script src="assets/js/vu1_api.js" defer></script>

benchlab/vu/__init__.py

@@ -0,0 +1,5 @@
+"""
+BENCHLAB Telemetry Package
+"""
+
+__version__ = "0.8.2"

benchlab/vu/devices.py

@@ -0,0 +1,166 @@
+# benchlab/vu/devices.py
+
+import json
+import logging
+import os
+import time
+
+import requests
+
+logger = logging.getLogger(__name__)
+
+DUMMY_UID = "0000000000000000"
+DUMMY_DIAL = (DUMMY_UID, "No Dial")
+
+CONFIG_PATH = os.path.join(os.path.dirname(__file__), "vu_server.config")
+TEMPLATE_PATH = os.path.join(
+    os.path.dirname(__file__),
+    "vu_server.config_template")
+
+_DEFAULT_VU_CONFIG = {
+    "vu_server_url": "http://localhost:5340",
+    "api_key": "",
+    "logo_file": ""}
+
+
+def load_vu_server_config(
+        config_path=CONFIG_PATH,
+        template_path=TEMPLATE_PATH):
+    """Load vu_server.config, creating it from the template (or a hardcoded
+    default) if missing. Never raises — any failure at any step falls back
+    to _DEFAULT_VU_CONFIG so a malformed config or template can't crash
+    import of this module.
+    """
+    try:
+        with open(config_path, "r") as f:
+            return json.load(f)
+    except FileNotFoundError:
+        try:
+            if os.path.exists(template_path):
+                with open(template_path, "r") as f:
+                    cfg = json.load(f)
+                logger.info("Created VU server config from template")
+            else:
+                cfg = dict(_DEFAULT_VU_CONFIG)
+                logger.info("Created default VU server config")
+            with open(config_path, "w") as f:
+                json.dump(cfg, f, indent=2)
+            return cfg
+        except Exception as e:
+            logger.error(f"Failed to load VU server config template: {e}")
+            return dict(_DEFAULT_VU_CONFIG)
+    except Exception as e:
+        logger.error(f"Failed to load VU server config: {e}")
+        return dict(_DEFAULT_VU_CONFIG)
+
+
+# --- Load VU server config ---
+VU_CONFIG = load_vu_server_config()
+
+VU_SERVER_URL = VU_CONFIG.get("vu_server_url", "http://localhost:5340")
+API_KEY = VU_CONFIG.get("api_key", "")
+
+
+def get_benchlab_devices(datasource=None) -> list:
+    """Return list of {port, uid, name} dicts via datasource (no serial
+    access)."""
+    if datasource is None:
+        logger.warning("get_benchlab_devices called without a datasource")
+        return []
+    try:
+        raw = datasource.list_devices()
+        if isinstance(raw, dict):
+            return [{"port": info.get("port", "?"), "uid": uid,
+                     "name": f"Benchlab {info.get('port', uid)}"}
+                    for uid, info in raw.items()]
+        return [{"port": d.get("port", "?"), "uid": d.get("uid", "?"),
+                 "name": f"Benchlab {d.get('port', d.get('uid', '?'))}"}
+                for d in raw]
+    except Exception as e:
+        logger.warning(f"list_devices failed: {e}")
+        return []
+
+
+def get_vu_dials(vu_server_url=VU_SERVER_URL, api_key=API_KEY):
+    """Fetch VU dials from the server. Returns [(uid, dial_name), ...]."""
+    try:
+        response = requests.get(
+            f"{vu_server_url}/api/v0/dial/list",
+            params={"key": api_key},
+            timeout=2.0,
+        )
+        response.raise_for_status()
+        data = response.json().get("data", [])
+        if not data:
+            return [DUMMY_DIAL]
+        return [(d.get("uid", DUMMY_UID), d.get("dial_name", "No Dial"))
+                for d in data]
+    except requests.RequestException as e:
+        logger.error(f"VU server request failed: {e}")
+        return [DUMMY_DIAL]
+
+
+def provision_vu_dials(vu_server_url=VU_SERVER_URL, api_key=API_KEY):
+    """Ask the VU hub to scan and provision new dials."""
+    try:
+        response = requests.get(
+            f"{vu_server_url}/api/v0/dial/provision",
+            params={"admin_key": api_key},
+            timeout=5.0,
+        )
+        response.raise_for_status()
+        data = response.json()
+        if data.get("status") == "ok":
+            logger.info("VU dial provisioning completed successfully.")
+            return True
+        logger.error(f"Provisioning failed: {data.get('message', 'Unknown')}")
+        return False
+    except requests.RequestException as e:
+        logger.error(f"Provisioning request failed: {e}")
+        return False
+
+
+def provision_missing_vu_dials(datasource, vu_server_url=VU_SERVER_URL,
+                               api_key=API_KEY, dry_run=False, max_wait=1.0):
+    """Provision dials that are physically connected but not yet on the hub."""
+    physical_devices = get_benchlab_devices(datasource)
+    vu_dials = get_vu_dials(vu_server_url, api_key)
+    vu_uids = {uid for uid, _ in vu_dials}
+    unprovisioned = [d for d in physical_devices if d["uid"] not in vu_uids]
+
+    if not unprovisioned:
+        logger.info("All physical dials are already provisioned.")
+        return []
+
+    logger.info(f"Found {len(unprovisioned)} unprovisioned dials: "
+                f"{[d['uid'] for d in unprovisioned]}")
+
+    if dry_run:
+        return [d["uid"] for d in unprovisioned]
+
+    if not provision_vu_dials(vu_server_url, api_key):
+        logger.error("Provisioning failed, new dials may not appear.")
+        return []
+
+    start = time.time()
+    newly_provisioned = []
+    while time.time() - start < max_wait:
+        updated_uids = {uid for uid, _ in get_vu_dials(vu_server_url, api_key)}
+        newly_provisioned = [
+            d["uid"]
+            for d in unprovisioned if d["uid"] in updated_uids]
+        if newly_provisioned:
+            break
+        time.sleep(0.1)
+
+    logger.info(f"Successfully provisioned: {newly_provisioned}")
+    return newly_provisioned
+
+
+def vu_server_check(vu_server_url=VU_SERVER_URL, api_key=API_KEY, timeout=0.5):
+    try:
+        r = requests.get(f"{vu_server_url}/api/v0/dial/list",
+                         params={"key": api_key}, timeout=timeout)
+        return r.status_code in (200, 403)
+    except requests.RequestException:
+        return False

benchlab/vu/requirements.txt

@@ -0,0 +1,24 @@
+# VU-Config
+requests>=2.31.0
+PyYAML>=6.0
+blessed>=1.20.0
+Pillow>=10.0.0
+pyserial>=3.5
+
+# VU-Server (runtime deps only -- pyinstaller and argparse dropped: pyinstaller
+# is only needed to build a standalone VU-Server binary, not to run it, and
+# argparse is a legacy PyPI shim for a module that's been in the stdlib since
+# Python 3.2. Both were pulled in verbatim from the upstream VU-Server
+# requirements.txt. Since `pip install -r` installs the whole file as one
+# atomic command, a failure building pyinstaller's native extensions on a
+# given Linux distro -- a known source of install friction for that package --
+# would silently block installing tornado/pyserial/etc. that VU-Server
+# actually needs, breaking -vu/-vuconfig with no error pointing at the real
+# cause.
+tornado
+numpy
+pillow
+requests
+pyyaml
+ruamel.yaml
+pyserial

benchlab/vu/sensors.py

@@ -0,0 +1,18 @@
+# benchlab/vu/sensors.py
+
+
+def get_available_sensors(snapshot: dict = None) -> list:
+    """Return sensor keys from a live datasource snapshot.
+
+    Falls back to an empty list if no snapshot is available yet.
+    """
+    if not snapshot:
+        return []
+    return [k for k in snapshot if k.lower() != "timestamp"]
+
+
+def get_sensor_value(snapshot: dict, sensor_name: str):
+    """Return the value of sensor_name from a telemetry snapshot dict."""
+    if not snapshot or not sensor_name:
+        return None
+    return snapshot.get(sensor_name)

benchlab/vu/vu_dial.config_template

@@ -0,0 +1,90 @@
+[
+  {
+    "dial_uid": "35002F000650564139323920",
+    "dial_name": "Dial 1",
+    "benchlab_port": "COM16",
+    "benchlab_uid": "2C003D001457435735363620",
+    "sensor": "Ambient_Temp",
+    "min": 20.0,
+    "max": 40.0,
+    "backlight": [
+      100,
+      100,
+      100
+    ],
+    "easing_dial": [
+      50,
+      5
+    ],
+    "easing_backlight": [
+      50,
+      5
+    ]
+  },
+  {
+    "dial_uid": "890024000650564139323920",
+    "dial_name": "Dial 2",
+    "benchlab_port": "COM17",
+    "benchlab_uid": "unknown",
+    "sensor": "Ambient_Temp",
+    "min": 20.0,
+    "max": 40.0,
+    "backlight": [
+      100,
+      100,
+      100
+    ],
+    "easing_dial": [
+      50,
+      5
+    ],
+    "easing_backlight": [
+      50,
+      5
+    ]
+  },
+  {
+    "dial_uid": "4A0038000650564139323920",
+    "dial_name": "Dial 3",
+    "benchlab_port": "COM17",
+    "benchlab_uid": "26001F001357435735363620",
+    "sensor": "Humidity",
+    "min": 25.0,
+    "max": 40.0,
+    "backlight": [
+      100,
+      100,
+      100
+    ],
+    "easing_dial": [
+      50,
+      5
+    ],
+    "easing_backlight": [
+      50,
+      5
+    ]
+  },
+  {
+    "dial_uid": "4A0027000650564139323920",
+    "dial_name": "Dial 4",
+    "benchlab_port": "COM17",
+    "benchlab_uid": "26001F001357435735363620",
+    "sensor": "Humidity",
+    "min": 25.0,
+    "max": 35.0,
+    "backlight": [
+      100,
+      100,
+      100
+    ],
+    "easing_dial": [
+      50,
+      5
+    ],
+    "easing_backlight": [
+      50,
+      5
+    ]
+  }
+]

benchlab/vu/vu_logo_gen.py

@@ -0,0 +1,97 @@
+# vu_logo_gen.py
+
+from pathlib import Path
+from PIL import Image, ImageDraw, ImageFont
+import hashlib
+
+
+def generate_sensor_logo(
+        template_path,
+        sensor_name,
+        min_val,
+        max_val,
+        benchlab_port=None):
+    """
+    Generate a VU sensor logo from a template, caching based on parameters.
+
+    Args:
+        template_path (Path or str): Path to the base image template.
+        sensor_name (str): Name of the sensor.
+        min_val (float): Minimum value.
+        max_val (float): Maximum value.
+        benchlab_port (str, optional): Benchlab port to display.
+
+    Returns:
+        Path: Path to the saved generated logo.
+    """
+    template_path = Path(template_path)
+    if not template_path.exists():
+        raise FileNotFoundError(f"Template not found: {template_path}")
+
+    # --- Create a unique filename based on parameters ---
+    params_str = f"{sensor_name}_{min_val}_{max_val}_{benchlab_port}"
+    # Use a hash to avoid extremely long filenames
+    hash_digest = hashlib.md5(params_str.encode("utf-8")).hexdigest()
+    safe_name = sensor_name.replace(" ", "_").replace("/", "-")
+
+    output_dir = Path(__file__).parent / "generated"
+    output_dir.mkdir(exist_ok=True)
+    output_path = output_dir / f"{safe_name}_{hash_digest}_logo.png"
+
+    # If file already exists, return cached version
+    if output_path.exists():
+        return output_path
+
+    # --- Load template and draw ---
+    img = Image.open(template_path).convert("L")
+    draw = ImageDraw.Draw(img)
+    width, height = img.size
+    header_height = 25
+
+    # Fonts
+    font_path = Path(__file__).parent / "assets/Barlow-Bold.ttf"
+    font_sensor = ImageFont.truetype(str(font_path), 20)
+    font_minmax = ImageFont.truetype(str(font_path), 12)
+
+    # Sensor name (top-center)
+    bbox = draw.textbbox((0, 0), sensor_name, font=font_sensor)
+    x = (width - (bbox[2] - bbox[0])) // 2
+    y = header_height + 10
+    draw.text((x, y), sensor_name, fill=0, font=font_sensor)
+
+    # Benchlab port (bottom-center)
+    if benchlab_port:
+        text_port = str(benchlab_port)
+        bbox_port = draw.textbbox((0, 0), text_port, font=font_minmax)
+        x_port = (width - (bbox_port[2] - bbox_port[0])) // 2
+        y_port = height - (bbox_port[3] - bbox_port[1]) - 20
+        draw.text((x_port, y_port), text_port, fill=0, font=font_minmax)
+
+    # Min (bottom-left)
+    text_min = f"Min: {min_val}"
+    bbox_min = draw.textbbox((0, 0), text_min, font=font_minmax)
+    y_min = height - (bbox_min[3] - bbox_min[1]) - 6
+    draw.text((2, y_min), text_min, fill=0, font=font_minmax)
+
+    # Max (bottom-right)
+    text_max = f"Max: {max_val}"
+    bbox_max = draw.textbbox((0, 0), text_max, font=font_minmax)
+    x_max = width - (bbox_max[2] - bbox_max[0]) - 2
+    y_max = height - (bbox_max[3] - bbox_max[1]) - 6
+    draw.text((x_max, y_max), text_max, fill=0, font=font_minmax)
+
+    # Save as 1-bit PNG
+    img.convert("1", dither=Image.NONE).save(output_path, format="PNG")
+    return output_path
+
+
+# --- Quick test ---
+if __name__ == "__main__":
+    template = Path(__file__).parent / "assets/bl_dial_144x200.png"
+    output = generate_sensor_logo(
+        template,
+        "Temp Sensor",
+        0,
+        100,
+        benchlab_port="35001")
+    print(f"Generated logo at: {output}")

benchlab/vu/vu_server.config_template

@@ -0,0 +1,5 @@
+{
+  "vu_server_url": "http://localhost:5340",
+  "api_key": "cTpAWYuRpA2zx75Yh961Cg",
+  "logo_file": "assets/bl_logo_144x200.png"
+}