pmd-pycore 0.2.3__tar.gz → 0.2.4__tar.gz

{pmd_pycore-0.2.3 → pmd_pycore-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pmd-pycore
-Version: 0.2.3
+Version: 0.2.4
 Summary: PMD PyCore - Python Interface for ElmorLabs PMD2/PMD2X/PMD-USB
 Home-page: https://github.com/ElmorLabs-P1/pmd-pycore
 Author: Pieter Plaisier
@@ -43,11 +43,20 @@ motherboard power cables, with an OLED display and USB connection to a PC for lo
 
 ## Install
 
+```
+pip install pmd-pycore
+```
+
+Or from a checkout:
+
 ```
 pip install -r requirements.txt
 pip install -e .
 ```
 
+This also installs the example scripts (see [Examples](#examples) below) as part of the package,
+runnable with `python -m pmd_pycore.examples.quickstart`.
+
 ## Usage
 
 ### PMD2 / PMD2X
@@ -78,7 +87,8 @@ Currently implemented are the device's read-only commands:
 Writing/action commands (continuous TX, config read/write, reset, bootloader) are not
 implemented.
 
-See `examples/read_sensors.py` — a polling/averaging loop that mirrors the original sample script.
+See `python -m pmd_pycore.examples.read_sensors` (below) — a polling/averaging loop that mirrors
+the original sample script.
 
 ### PMD-USB
 
@@ -117,12 +127,16 @@ See [KNOWN_LIMITATIONS.md](KNOWN_LIMITATIONS.md) for what's deliberately out of
 
 ## Examples
 
-- `examples/quickstart.py` — connect to the first device found, trying PMD2/PMD2X first and
-  falling back to PMD-USB, print its identity, and read sensor values once (for PMD2/PMD2X:
-  per-rail readings, firmware-computed aggregate power, chip health, and PMD2X's 12VHPWR
-  connector temperatures).
-- `examples/read_sensors.py` — a polling/averaging loop, refreshing in place, for whichever
-  device family is connected (same PMD2/PMD2X-first-then-PMD-USB detection as `quickstart.py`).
+Both examples ship as part of the installed package -- run them with `python -m` after
+`pip install pmd-pycore`, no checkout needed.
+
+- `python -m pmd_pycore.examples.quickstart` — connect to the first device found, trying
+  PMD2/PMD2X first and falling back to PMD-USB, print its identity, and read sensor values once
+  (for PMD2/PMD2X: per-rail readings, firmware-computed aggregate power, chip health, and
+  PMD2X's 12VHPWR connector temperatures).
+- `python -m pmd_pycore.examples.read_sensors` — a polling/averaging loop, refreshing in place,
+  for whichever device family is connected (same PMD2/PMD2X-first-then-PMD-USB detection as
+  `quickstart`).
 
 ## Status
 

{pmd_pycore-0.2.3 → pmd_pycore-0.2.4}/README.md

@@ -23,11 +23,20 @@ motherboard power cables, with an OLED display and USB connection to a PC for lo
 
 ## Install
 
+```
+pip install pmd-pycore
+```
+
+Or from a checkout:
+
 ```
 pip install -r requirements.txt
 pip install -e .
 ```
 
+This also installs the example scripts (see [Examples](#examples) below) as part of the package,
+runnable with `python -m pmd_pycore.examples.quickstart`.
+
 ## Usage
 
 ### PMD2 / PMD2X
@@ -58,7 +67,8 @@ Currently implemented are the device's read-only commands:
 Writing/action commands (continuous TX, config read/write, reset, bootloader) are not
 implemented.
 
-See `examples/read_sensors.py` — a polling/averaging loop that mirrors the original sample script.
+See `python -m pmd_pycore.examples.read_sensors` (below) — a polling/averaging loop that mirrors
+the original sample script.
 
 ### PMD-USB
 
@@ -97,12 +107,16 @@ See [KNOWN_LIMITATIONS.md](KNOWN_LIMITATIONS.md) for what's deliberately out of
 
 ## Examples
 
-- `examples/quickstart.py` — connect to the first device found, trying PMD2/PMD2X first and
-  falling back to PMD-USB, print its identity, and read sensor values once (for PMD2/PMD2X:
-  per-rail readings, firmware-computed aggregate power, chip health, and PMD2X's 12VHPWR
-  connector temperatures).
-- `examples/read_sensors.py` — a polling/averaging loop, refreshing in place, for whichever
-  device family is connected (same PMD2/PMD2X-first-then-PMD-USB detection as `quickstart.py`).
+Both examples ship as part of the installed package -- run them with `python -m` after
+`pip install pmd-pycore`, no checkout needed.
+
+- `python -m pmd_pycore.examples.quickstart` — connect to the first device found, trying
+  PMD2/PMD2X first and falling back to PMD-USB, print its identity, and read sensor values once
+  (for PMD2/PMD2X: per-rail readings, firmware-computed aggregate power, chip health, and
+  PMD2X's 12VHPWR connector temperatures).
+- `python -m pmd_pycore.examples.read_sensors` — a polling/averaging loop, refreshing in place,
+  for whichever device family is connected (same PMD2/PMD2X-first-then-PMD-USB detection as
+  `quickstart`).
 
 ## Status
 

pmd_pycore-0.2.4/pmd_pycore/examples/quickstart.py

@@ -0,0 +1,190 @@
+"""
+Minimal example: connect to the first supported device found -- trying
+PMD2/PMD2X first, then PMD-USB -- print its identity, and read sensors once.
+"""
+
+import time
+from contextlib import contextmanager
+from typing import Dict, Iterator, Optional
+
+import serial
+
+from pmd_pycore.core import (
+    get_pmd2_ports,
+    read_pmd2_device,
+    read_pmd2_uid,
+    read_pmd2_sensors,
+    translate_pmd2_sensor_struct,
+    translate_pmd2_aggregate_power,
+    translate_pmd2_chip_sensors,
+    translate_pmd2x_hpwr_temperatures,
+    PMD2_PRODUCT_ID,
+    PMD2X_PRODUCT_ID,
+    get_pmdusb_ports,
+    read_pmdusb_id,
+    read_pmdusb_sensors,
+    translate_pmdusb_sensors,
+    translate_pmdusb_aggregate_power,
+)
+
+PRODUCT_NAMES = {PMD2_PRODUCT_ID: "PMD2", PMD2X_PRODUCT_ID: "PMD2X"}
+
+
+# --- PMD2 / PMD2X ---
+
+@contextmanager
+def connect_pmd(port: str) -> Iterator[serial.Serial]:
+    try:
+        # rtscts/dsrdtr disabled: the device uses DTR as its "is a host listening"
+        # signal, so pyserial's automatic flow-control handling must stay out of the way.
+        with serial.Serial(
+            port, 115200, timeout=1, write_timeout=1, rtscts=False, dsrdtr=False
+        ) as ser:
+            ser.dtr = True
+            # The device pushes an unsolicited welcome string on DTR assert, but
+            # the push can arrive after this point rather than before it. Give it
+            # a moment to land, then flush -- read_pmd2_uart() also flushes before each
+            # command, so a late push can never corrupt the next real response.
+            time.sleep(0.1)
+            ser.reset_input_buffer()
+            yield ser
+    except serial.SerialException as e:
+        raise SystemExit(
+            f"Failed to open {port}: {e}\n"
+            "(is another program -- a monitoring app, another instance of this "
+            "script -- already using the port?)"
+        )
+
+
+def print_pmd_device_info(device_info: Dict[str, int], uid: Optional[str]) -> None:
+    product_name = PRODUCT_NAMES.get(device_info["ProductId"], "unknown")
+    print("--- Device ---")
+    print(f"Product:    {product_name}")
+    print(f"Vendor ID:  {hex(device_info['VendorId'])}")
+    print(f"Product ID: {hex(device_info['ProductId'])}")
+    print(f"Firmware:   {hex(device_info['FwVersion'])}")
+    print(f"UID:        {uid or 'unavailable'}")
+    print()
+
+
+def print_rail_readings(readings: Dict[str, Dict[str, float]]) -> None:
+    print("--- Rails ---")
+    print(f'{"Rail":<10}{"Voltage":>9}{"Current":>9}{"Power":>9}')
+    for rail, reading in readings.items():
+        print(
+            f'{rail:<10}{reading["voltage"]:>8.3f}V{reading["current"]:>8.3f}A'
+            f'{reading["power"]:>8.3f}W'
+        )
+    print()
+
+
+def print_aggregate_power(aggregates: Dict[str, float]) -> None:
+    print("--- Aggregate power ---")
+    print(f'EPS (CPU):       {aggregates["eps"]:>8.3f} W')
+    print(f'PCIe (GPU):      {aggregates["pcie"]:>8.3f} W')
+    print(f'Motherboard:     {aggregates["mb"]:>8.3f} W')
+    print(f'Total:           {aggregates["total"]:>8.3f} W')
+    print()
+
+
+def print_pmd_device_health(chip: Dict[str, float], hpwr_temps: Optional[Dict[str, Optional[float]]]) -> None:
+    def fmt_temp(value: Optional[float]) -> str:
+        return f"{value:>8.1f} C" if value is not None else f"{'n/c':>8} C"
+
+    print("--- Device health ---")
+    print(f'{"Supply (Vdd):":<17}{chip["vdd"]:>8.3f} V')
+    print(f'{"Chip temp:":<17}{chip["tchip"]:>8.1f} C')
+    if hpwr_temps is not None:
+        print(f'{"12VHPWR in:":<17}{fmt_temp(hpwr_temps["ts_in"])}')
+        print(f'{"12VHPWR out:":<17}{fmt_temp(hpwr_temps["ts_out"])}')
+
+
+def run_pmd(port: str) -> None:
+    with connect_pmd(port) as ser:
+        device_info = read_pmd2_device(ser)
+        if device_info is None:
+            raise SystemExit("Failed to read device info -- is this a PMD2/PMD2X device?")
+
+        product_id = device_info["ProductId"]
+        if product_id not in PRODUCT_NAMES:
+            raise SystemExit(f"Unrecognized ProductId {hex(product_id)} -- not a PMD2/PMD2X device?")
+
+        print_pmd_device_info(device_info, read_pmd2_uid(ser))
+
+        sensors = read_pmd2_sensors(ser, product_id)
+        if sensors is None:
+            raise SystemExit("Failed to read sensor values.")
+
+        print_rail_readings(translate_pmd2_sensor_struct(sensors, product_id))
+        print_aggregate_power(translate_pmd2_aggregate_power(sensors))
+        hpwr_temps = translate_pmd2x_hpwr_temperatures(sensors) if product_id == PMD2X_PRODUCT_ID else None
+        print_pmd_device_health(translate_pmd2_chip_sensors(sensors), hpwr_temps)
+
+
+# --- PMD-USB ---
+
+def print_pmdusb_device_info(device_info: Dict[str, int]) -> None:
+    print("--- Device ---")
+    print("Product:    PMD-USB")
+    print(f"Vendor ID:  {hex(device_info['VendorId'])}")
+    print(f"Product ID: {hex(device_info['ProductId'])}")
+    print(f"Firmware:   {hex(device_info['FwVersion'])}")
+    print()
+
+
+def run_pmdusb(port: str) -> None:
+    try:
+        ser = serial.Serial(port, 115200, timeout=1, write_timeout=1)
+    except serial.SerialException as e:
+        raise SystemExit(f"Failed to open {port}: {e}")
+
+    try:
+        device_info = read_pmdusb_id(ser)
+        if device_info is None:
+            raise SystemExit("Failed to read device info -- is this a PMD-USB device?")
+        print_pmdusb_device_info(device_info)
+
+        sensors = read_pmdusb_sensors(ser)
+        if sensors is None:
+            raise SystemExit("Failed to read sensor values.")
+
+        print_rail_readings(translate_pmdusb_sensors(sensors))
+
+        aggregates = translate_pmdusb_aggregate_power(sensors)
+        print("--- Aggregate power ---")
+        print(f'GPU (PCIE1+2):   {aggregates["gpu"]:>8.3f} W')
+        print(f'CPU (EPS1+2):    {aggregates["cpu"]:>8.3f} W')
+        print(f'Total:           {aggregates["total"]:>8.3f} W')
+    finally:
+        ser.close()
+
+
+# --- Entry point ---
+
+def main() -> None:
+    pmd_ports = get_pmd2_ports()
+    if pmd_ports:
+        if len(pmd_ports) > 1:
+            print(f"Found {len(pmd_ports)} PMD2/PMD2X devices, using the first: {pmd_ports[0]['port']}")
+        port = pmd_ports[0]["port"]
+        print(f"Connecting to {port} (PMD2/PMD2X)...")
+        run_pmd(port)
+        return
+
+    pmdusb_ports = get_pmdusb_ports()
+    if pmdusb_ports:
+        if len(pmdusb_ports) > 1:
+            print(f"Found {len(pmdusb_ports)} PMD-USB devices, using the first: {pmdusb_ports[0]['port']}")
+        port = pmdusb_ports[0]["port"]
+        print(f"Connecting to {port} (PMD-USB)...")
+        run_pmdusb(port)
+        return
+
+    raise SystemExit("No PMD2/PMD2X or PMD-USB device found.")
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except KeyboardInterrupt:
+        print("\nStopped.")

pmd_pycore-0.2.4/pmd_pycore/examples/read_sensors.py

@@ -0,0 +1,241 @@
+"""
+Connect to the first supported device found -- trying PMD2/PMD2X first, then
+PMD-USB -- and print averaged readings in a loop, refreshing in place.
+"""
+
+import statistics
+import time
+
+import serial
+
+from pmd_pycore.core import (
+    get_pmd2_ports,
+    read_pmd2_device,
+    read_pmd2_sensors,
+    translate_pmd2_sensor_struct,
+    translate_pmd2_aggregate_power,
+    translate_pmd2_chip_sensors,
+    translate_pmd2x_hpwr_temperatures,
+    PMD2X_PRODUCT_ID,
+    get_pmdusb_ports,
+    read_pmdusb_id,
+    read_pmdusb_sensors,
+    translate_pmdusb_sensors,
+    translate_pmdusb_aggregate_power,
+)
+
+# Number of sensor reads averaged into each displayed update.
+NUM_SAMPLES = 20
+
+# Target time between displayed updates. On PMD2/PMD2X, read_pmd2_uart()'s 5ms
+# inter-command delay dominates per-sample cost, so NUM_SAMPLES * 5ms
+# (~100ms) alone is already close to this budget -- actual cycles land
+# around 110-125ms there, not exactly 100ms. PMD-USB's 2ms delay leaves more
+# headroom. Either way this is a target to approach, not a hard cap.
+UPDATE_INTERVAL_S = 0.1
+
+CLEAR_SCREEN = "\x1b[2J\x1b[H"
+
+
+def _average_dicts(dicts, fields):
+    return {field: statistics.mean(d[field] for d in dicts) for field in fields}
+
+
+def _rail_lines(averaged_rails):
+    lines = [f'{"Rail":<10}{"Voltage":>10}{"Current":>10}{"Power":>10}']
+    for rail, reading in averaged_rails.items():
+        lines.append(
+            f'{rail:<10}{reading["voltage"]:>10.3f}'
+            f'{reading["current"]:>10.3f}{reading["power"]:>10.3f}'
+        )
+    lines.append("")
+    return lines
+
+
+# --- PMD2 / PMD2X ---
+
+def run_pmd(port):
+    try:
+        ser = serial.Serial(port, 115200, timeout=1, write_timeout=1, rtscts=False, dsrdtr=False)
+    except serial.SerialException as e:
+        print(f"Failed to open {port}: {e}")
+        return
+
+    try:
+        ser.dtr = True
+        # The device pushes an unsolicited welcome string on DTR assert, but it
+        # can arrive after this point rather than before it. Give it a moment to
+        # land, then flush -- read_pmd2_uart() also flushes before each command, so a
+        # late push can never corrupt the next real response.
+        time.sleep(0.1)
+        ser.reset_input_buffer()
+
+        print("Reading vendor data...")
+        device_info = read_pmd2_device(ser)
+        if device_info is None:
+            print("Failed to read vendor data from device.")
+            return
+        print(f"Result: {device_info}\n")
+        time.sleep(1)
+
+        product_id = device_info["ProductId"]
+        is_pmd2x = product_id == PMD2X_PRODUCT_ID
+
+        while True:
+            cycle_start = time.monotonic()
+            rail_samples = []
+            aggregate_samples = []
+            chip_samples = []
+            hpwr_temp_samples = []
+
+            for _ in range(NUM_SAMPLES):
+                sensors = None
+                while sensors is None:
+                    try:
+                        sensors = read_pmd2_sensors(ser, product_id)
+                    except serial.SerialException:
+                        time.sleep(0.1)
+                rail_samples.append(translate_pmd2_sensor_struct(sensors, product_id))
+                aggregate_samples.append(translate_pmd2_aggregate_power(sensors))
+                chip_samples.append(translate_pmd2_chip_sensors(sensors))
+                if is_pmd2x:
+                    hpwr_temp_samples.append(translate_pmd2x_hpwr_temperatures(sensors))
+
+            rail_names = rail_samples[0].keys()
+            averaged_rails = {
+                rail: _average_dicts([s[rail] for s in rail_samples], ("voltage", "current", "power"))
+                for rail in rail_names
+            }
+            averaged_aggregates = _average_dicts(aggregate_samples, ("eps", "pcie", "mb", "total"))
+            averaged_chip = _average_dicts(chip_samples, ("vdd", "tchip"))
+
+            lines = _rail_lines(averaged_rails)
+
+            lines.append("--- Aggregate power ---")
+            lines.append(f'EPS (CPU):       {averaged_aggregates["eps"]:>8.3f} W')
+            lines.append(f'PCIe (GPU):      {averaged_aggregates["pcie"]:>8.3f} W')
+            lines.append(f'Motherboard:     {averaged_aggregates["mb"]:>8.3f} W')
+            lines.append(f'Total:           {averaged_aggregates["total"]:>8.3f} W')
+            lines.append("")
+
+            lines.append("--- Device health ---")
+            lines.append(f'{"Supply (Vdd):":<17}{averaged_chip["vdd"]:>8.3f} V')
+            lines.append(f'{"Chip temp:":<17}{averaged_chip["tchip"]:>8.1f} C')
+            if is_pmd2x:
+                def fmt_temp(samples, key):
+                    values = [s[key] for s in samples if s[key] is not None]
+                    return f"{statistics.mean(values):>8.1f} C" if values else f"{'n/c':>8} C"
+
+                lines.append(f'{"12VHPWR in:":<17}{fmt_temp(hpwr_temp_samples, "ts_in")}')
+                lines.append(f'{"12VHPWR out:":<17}{fmt_temp(hpwr_temp_samples, "ts_out")}')
+
+            print(CLEAR_SCREEN + "\n".join(lines), flush=True)
+
+            elapsed = time.monotonic() - cycle_start
+            time.sleep(max(0.0, UPDATE_INTERVAL_S - elapsed))
+    finally:
+        ser.close()
+
+
+# --- PMD-USB ---
+
+def run_pmdusb(port):
+    try:
+        ser = serial.Serial(port, 115200, timeout=1, write_timeout=1)
+    except serial.SerialException as e:
+        print(f"Failed to open {port}: {e}")
+        return
+
+    try:
+        print("Reading device id...")
+        device_info = read_pmdusb_id(ser)
+        if device_info is None:
+            print("Failed to read device id.")
+            return
+        print(f"Result: {device_info}\n")
+        time.sleep(1)
+
+        while True:
+            cycle_start = time.monotonic()
+            channel_samples = []
+            aggregate_samples = []
+
+            for _ in range(NUM_SAMPLES):
+                sensors = None
+                while sensors is None:
+                    try:
+                        sensors = read_pmdusb_sensors(ser)
+                    except serial.SerialException:
+                        time.sleep(0.1)
+                channel_samples.append(translate_pmdusb_sensors(sensors))
+                aggregate_samples.append(translate_pmdusb_aggregate_power(sensors))
+
+            channel_names = channel_samples[0].keys()
+            averaged_channels = {
+                channel: _average_dicts(
+                    [s[channel] for s in channel_samples], ("voltage", "current", "power")
+                )
+                for channel in channel_names
+            }
+            averaged_aggregates = _average_dicts(aggregate_samples, ("gpu", "cpu", "total"))
+
+            lines = _rail_lines(averaged_channels)
+            lines.append("--- Aggregate power ---")
+            lines.append(f'GPU (PCIE1+2):   {averaged_aggregates["gpu"]:>8.3f} W')
+            lines.append(f'CPU (EPS1+2):    {averaged_aggregates["cpu"]:>8.3f} W')
+            lines.append(f'Total:           {averaged_aggregates["total"]:>8.3f} W')
+            print(CLEAR_SCREEN + "\n".join(lines), flush=True)
+
+            elapsed = time.monotonic() - cycle_start
+            time.sleep(max(0.0, UPDATE_INTERVAL_S - elapsed))
+    finally:
+        ser.close()
+
+
+# --- Entry point ---
+
+def main():
+    print("\nFinding potential PMD2/PMD2X Serial Ports...\n")
+    pmd_ports = get_pmd2_ports()
+    for i, p in enumerate(pmd_ports):
+        print(f"{i} - {p['port']}")
+    print()
+
+    if pmd_ports:
+        port_index = 0
+        if len(pmd_ports) > 1:
+            print("Multiple PMD2/PMD2X serial ports found. Input which port to use:")
+            port_index = int(input())
+            if port_index >= len(pmd_ports):
+                print("Invalid port index.")
+                return
+
+        port = pmd_ports[port_index]["port"]
+        print(f"Using port index {port_index} ({port})\n")
+        run_pmd(port)
+        return
+
+    print("No PMD2/PMD2X serial ports found. Checking for PMD-USB...\n")
+    pmdusb_ports = get_pmdusb_ports()
+    if not pmdusb_ports:
+        print("No PMD2/PMD2X or PMD-USB serial ports found.")
+        return
+
+    port_index = 0
+    if len(pmdusb_ports) > 1:
+        print("Multiple PMD-USB serial ports found. Input which port to use:")
+        port_index = int(input())
+        if port_index >= len(pmdusb_ports):
+            print("Invalid port index.")
+            return
+
+    port = pmdusb_ports[port_index]["port"]
+    print(f"Using port index {port_index} ({port})\n")
+    run_pmdusb(port)
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except KeyboardInterrupt:
+        print("\nStopped.")

{pmd_pycore-0.2.3 → pmd_pycore-0.2.4}/pmd_pycore/version.py

@@ -2,4 +2,4 @@
 Version information for pmd-pycore
 """
 
-__version__ = "0.2.3"
+__version__ = "0.2.4"

{pmd_pycore-0.2.3 → pmd_pycore-0.2.4}/pmd_pycore.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pmd-pycore
-Version: 0.2.3
+Version: 0.2.4
 Summary: PMD PyCore - Python Interface for ElmorLabs PMD2/PMD2X/PMD-USB
 Home-page: https://github.com/ElmorLabs-P1/pmd-pycore
 Author: Pieter Plaisier
@@ -43,11 +43,20 @@ motherboard power cables, with an OLED display and USB connection to a PC for lo
 
 ## Install
 
+```
+pip install pmd-pycore
+```
+
+Or from a checkout:
+
 ```
 pip install -r requirements.txt
 pip install -e .
 ```
 
+This also installs the example scripts (see [Examples](#examples) below) as part of the package,
+runnable with `python -m pmd_pycore.examples.quickstart`.
+
 ## Usage
 
 ### PMD2 / PMD2X
@@ -78,7 +87,8 @@ Currently implemented are the device's read-only commands:
 Writing/action commands (continuous TX, config read/write, reset, bootloader) are not
 implemented.
 
-See `examples/read_sensors.py` — a polling/averaging loop that mirrors the original sample script.
+See `python -m pmd_pycore.examples.read_sensors` (below) — a polling/averaging loop that mirrors
+the original sample script.
 
 ### PMD-USB
 
@@ -117,12 +127,16 @@ See [KNOWN_LIMITATIONS.md](KNOWN_LIMITATIONS.md) for what's deliberately out of
 
 ## Examples
 
-- `examples/quickstart.py` — connect to the first device found, trying PMD2/PMD2X first and
-  falling back to PMD-USB, print its identity, and read sensor values once (for PMD2/PMD2X:
-  per-rail readings, firmware-computed aggregate power, chip health, and PMD2X's 12VHPWR
-  connector temperatures).
-- `examples/read_sensors.py` — a polling/averaging loop, refreshing in place, for whichever
-  device family is connected (same PMD2/PMD2X-first-then-PMD-USB detection as `quickstart.py`).
+Both examples ship as part of the installed package -- run them with `python -m` after
+`pip install pmd-pycore`, no checkout needed.
+
+- `python -m pmd_pycore.examples.quickstart` — connect to the first device found, trying
+  PMD2/PMD2X first and falling back to PMD-USB, print its identity, and read sensor values once
+  (for PMD2/PMD2X: per-rail readings, firmware-computed aggregate power, chip health, and
+  PMD2X's 12VHPWR connector temperatures).
+- `python -m pmd_pycore.examples.read_sensors` — a polling/averaging loop, refreshing in place,
+  for whichever device family is connected (same PMD2/PMD2X-first-then-PMD-USB detection as
+  `quickstart`).
 
 ## Status
 

{pmd_pycore-0.2.3 → pmd_pycore-0.2.4}/pmd_pycore.egg-info/SOURCES.txt

@@ -11,5 +11,8 @@ pmd_pycore.egg-info/top_level.txt
 pmd_pycore/core/__init__.py
 pmd_pycore/core/pmd2.py
 pmd_pycore/core/pmdusb.py
+pmd_pycore/examples/__init__.py
+pmd_pycore/examples/quickstart.py
+pmd_pycore/examples/read_sensors.py
 tests/test_pmd2.py
 tests/test_pmdusb.py

{pmd_pycore-0.2.3 → pmd_pycore-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pmd-pycore"
-version = "0.2.3"
+version = "0.2.4"
 description = "PMD PyCore - Python Interface for ElmorLabs PMD2/PMD2X/PMD-USB"
 readme = "README.md"
 requires-python = ">=3.11"

{pmd_pycore-0.2.3 → pmd_pycore-0.2.4}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = pmd-pycore
-version = 0.2.3
+version = 0.2.4
 author = Pieter Plaisier
 author_email = pieter@hanweiconsulting.com
 description = PMD PyCore - Python Interface for ElmorLabs PMD2/PMD2X/PMD-USB