shepherd-core 2025.5.2__py3-none-any.whl → 2025.5.3__py3-none-any.whl

shepherd_core/data_models/__init__.py

@@ -31,7 +31,7 @@ from .experiment.observer_features import GpioLevel
 from .experiment.observer_features import GpioTracing
 from .experiment.observer_features import PowerTracing
 from .experiment.observer_features import SystemLogging
-from .experiment.observer_features import UartTracing
+from .experiment.observer_features import UartLogging
 from .experiment.target_config import TargetConfig
 
 __all__ = [
@@ -55,7 +55,7 @@ __all__ = [
     "ShpModel",
     "SystemLogging",
     "TargetConfig",
-    "UartTracing",
+    "UartLogging",
     "VirtualHarvesterConfig",
     "VirtualSourceConfig",
     "Wrapper",

shepherd_core/data_models/base/content.py

@@ -1,21 +1,16 @@
 """Base-Model for all content."""
 
-import hashlib
 from datetime import datetime
 from typing import Annotated
 from typing import Optional
-from typing import Union
 from uuid import uuid4
 
-from pydantic import UUID4
 from pydantic import Field
 from pydantic import StringConstraints
 from pydantic import model_validator
 from typing_extensions import Self
-from typing_extensions import deprecated
 
 from .shepherd import ShpModel
-from .timezone import local_now
 
 # constr -> to_lower=True, max_length=16, regex=r"^[\w]+$"
 # ⤷ Regex = AlphaNum
@@ -26,24 +21,20 @@ SafeStr = Annotated[str, StringConstraints(pattern=r"^[ -~]+$")]
 # ⤷ Regex = All Printable ASCII-Characters with Space
 
 
-@deprecated("use UUID4 instead")
 def id_default() -> int:
     """Generate a unique ID - usable as default value.
 
-    Note: IdInt has space for 128 bit, so 128/4 = 32 hex-chars
+    Note: IdInt in mongoDB can currently handle 8 bytes (16 hex-values)
     """
-    time_stamp = str(local_now()).encode("utf-8")
-    time_hash = hashlib.sha3_224(time_stamp).hexdigest()[-32:]
-    return int(time_hash, 16)
+    return int(uuid4().hex[-15:], 16)
 
 
 class ContentModel(ShpModel):
     """Base-Model for content with generalized properties."""
 
-    # id: UUID4 = Field(  # TODO: db-migration - temp fix for documentation
-    id: Union[UUID4, int] = Field(
+    id: int = Field(
         description="Unique ID",
-        default_factory=uuid4,
+        default_factory=id_default,
     )
     name: NameStr
     description: Annotated[Optional[SafeStr], Field(description="Required when public")] = None

shepherd_core/data_models/content/_external_fixtures.yaml

@@ -1,7 +1,7 @@
 - datatype: EnergyEnvironment
   created: 2025-05-12 17:28:39.756999+02:00
   parameters:
-    id: 2639560972524229652
+    id: 263956097252422
     name: eenv_static_2000mV_10mA_3600s
     description: Artificial static Energy Environment, 2000mV, 10mA, 3600s
     comment: null
@@ -24,7 +24,7 @@
 - datatype: EnergyEnvironment
   created: 2025-05-12 17:28:39.764595+02:00
   parameters:
-    id: 9823394105967169626
+    id: 98233941059
     name: eenv_static_2000mV_1mA_3600s
     description: Artificial static Energy Environment, 2000mV, 1mA, 3600s
     comment: null
@@ -47,7 +47,7 @@
 - datatype: EnergyEnvironment
   created: 2025-05-12 17:28:39.772144+02:00
   parameters:
-    id: 3900615675169501222
+    id: 39006156751
     name: eenv_static_2000mV_50mA_3600s
     description: Artificial static Energy Environment, 2000mV, 50mA, 3600s
     comment: null
@@ -70,7 +70,7 @@
 - datatype: EnergyEnvironment
   created: 2025-05-12 17:28:39.779737+02:00
   parameters:
-    id: 14796673729431137386
+    id: 1479667372943113
     name: eenv_static_2000mV_5mA_3600s
     description: Artificial static Energy Environment, 2000mV, 5mA, 3600s
     comment: null
@@ -93,7 +93,7 @@
 - datatype: EnergyEnvironment
   created: 2025-05-12 17:28:39.787329+02:00
   parameters:
-    id: 6648482606607441403
+    id: 664848260660744
     name: eenv_static_3000mV_10mA_3600s
     description: Artificial static Energy Environment, 3000mV, 10mA, 3600s
     comment: null
@@ -116,7 +116,7 @@
 - datatype: EnergyEnvironment
   created: 2025-05-12 17:28:39.794922+02:00
   parameters:
-    id: 13566000951043177991
+    id: 1356600095104317
     name: eenv_static_3000mV_1mA_3600s
     description: Artificial static Energy Environment, 3000mV, 1mA, 3600s
     comment: null
@@ -139,7 +139,7 @@
 - datatype: EnergyEnvironment
   created: 2025-05-12 17:28:39.802410+02:00
   parameters:
-    id: 7977778327156610158
+    id: 797777832715661
     name: eenv_static_3000mV_50mA_3600s
     description: Artificial static Energy Environment, 3000mV, 50mA, 3600s
     comment: null
@@ -162,7 +162,7 @@
 - datatype: EnergyEnvironment
   created: 2025-05-12 17:28:39.810147+02:00
   parameters:
-    id: 4900162978999238419
+    id: 490016297899923
     name: eenv_static_3000mV_5mA_3600s
     description: Artificial static Energy Environment, 3000mV, 5mA, 3600s
     comment: null
@@ -269,7 +269,7 @@
 - datatype: Firmware
   created: 2025-05-12 17:28:39.851412+02:00
   parameters:
-    id: 7163917825449888392
+    id: 716391782544988
     name: nrf52_deep_sleep
     description: practically turned off MCU with the lowest possible consumption
     comment: null
@@ -325,7 +325,7 @@
 - datatype: Firmware
   created: 2025-05-12 17:28:39.868340+02:00
   parameters:
-    id: 3174430733058172825
+    id: 317443073305817
     name: nrf52_rf_survey
     description: Link Matrix Generator - TX-Unit - sends packet with every possible
       P_TX, loops until stopped
@@ -354,7 +354,7 @@
 - datatype: Firmware
   created: 2025-05-12 17:28:39.876819+02:00
   parameters:
-    id: 16381936580724580968
+    id: 1638193658072458
     name: nrf52_rf_test
     description: sends out 1 BLE-Packet per second (verify with an app like 'RaMBLE')
     comment: null

shepherd_core/data_models/content/virtual_harvester.py

@@ -23,54 +23,283 @@ from .energy_environment import EnergyDType
 class AlgorithmDType(str, Enum):
     """Options for choosing a harvesting algorithm."""
 
-    direct = disable = neutral = "neutral"  # for just using IVTrace / samples
-    isc_voc = "isc_voc"  # only recordable ATM
+    direct = disable = neutral = "neutral"
+    """
+    Reads an energy environment as is without selecting a harvesting
+    voltage.
+
+    Used to play "constant-power" energy environments or simple
+    "on-off-patterns". Generally, not useful for virtual source
+    emulation.
+
+    Not applicable to real harvesting, only emulation with IVTrace / samples.
+    """
+
+    isc_voc = "isc_voc"
+    """
+    Short Circuit Current, Open Circuit Voltage.
+
+    This is not relevant for emulation, but used to configure recording of
+    energy environments.
+
+    This mode samples the two extremes of an IV curve, which may be
+    interesting to characterize a transducer/energy environment.
+
+    Not applicable to emulation - only recordable during harvest-recording ATM.
+    """
+
     ivcurve = ivcurves = ivsurface = "ivcurve"
+    """
+    Used during harvesting to record the full IV surface.
+
+    When configuring the energy environment recording, this algorithm
+    records the IV surface by repeatedly recording voltage and current
+    while ramping the voltage.
+
+    Cannot be used as output of emulation.
+    """
+
     constant = cv = "cv"
+    """
+    Harvest energy at a fixed predefined voltage ('voltage_mV').
+
+    For harvesting, this records the IV samples at the specified voltage.
+    For emulation, this virtually harvests the IV surface at the specified voltage.
+
+    In addition to constant voltage harvesting, this can be used together
+    with the 'feedback_to_hrv' flag to implement a "Capacitor and Diode"
+    topology, where the harvesting voltage depends dynamically on the
+    capacitor voltage.
+    """
+
     # ci .. constant current -> is this desired?
+
     mppt_voc = "mppt_voc"
+    """
+    Emulate a harvester with maximum power point (MPP) tracking based on
+    open circuit voltage measurements.
+
+    This MPPT heuristic estimates the MPP as a constant ratio of the open
+    circuit voltage.
+
+    Used in conjunction with 'setpoint_n', 'interval_ms', and 'duration_ms'.
+    """
+
     mppt_po = perturb_observe = "mppt_po"
+    """
+    Emulate a harvester with perturb and observe maximum power point
+    tracking.
+
+    This MPPT heuristic adjusts the harvesting voltage by small amounts and
+    checks if the power increases. Eventually, the tracking changes the
+    direction of adjustments and oscillates around the MPP.
+    """
+
     mppt_opt = optimal = "mppt_opt"
+    """
+    A theoretical harvester that identifies the MPP by reading it from the
+    IV curve during emulation.
 
+    Note that this is not possible for real-world harvesting as the system would
+    not know the entire IV curve. In that case a very fast and detailed mppt_po is
+    used.
+    """
 
-class VirtualHarvesterConfig(ContentModel, title="Config for the Harvester"):
-    """A vHrv makes a source-characterization (i.e. ivcurve) usable for the vSrc.
 
-    Mostly used when the file-based energy environment of the virtual source
-    is not already supplied as pre-harvested ivtrace.
+class VirtualHarvesterConfig(ContentModel, title="Config for the Harvester"):
+    """The virtual harvester configuration characterizes usage of an energy environment.
+
+    It is used to both harvesting during emulation and to record
+    energy environments (sometimes referred to as "harvesting traces").
+
+    For emulation:
+
+    The virtual harvester configuration describes how energy from a recorded
+    energy environment is harvested. Typically, the energy environment provides
+    an IV-surface, which is a continuous function in three dimensions: voltage,
+    current, and time. Based on this surface, the emulation can derive the
+    available IV-curve at each point in time. The harvester looks up the current
+    that is available (according to the energy environment) from a given
+    harvesting voltage. The harvesting voltage may be dynamically chosen by the
+    harvester based on the implemented harvesting algorithm, which models
+    different real-world harvesters. For example, a maximum power point tracking
+    harvester may choose a harvesting voltage as a ratio of the open circuit
+    voltage available from the energy environment (or transducer in practice).
+
+    The energy environments are encoded not as a three-dimensional function, but
+    as IV tuples over time (sampled at a constant frequency). This originates
+    from the technical implementation when recording the IV-surface, where the
+    recorder provides the IV-curve by measuring the current for a given voltage
+    and ramping the voltage from minimal to maximum.
+
+    For harvest-recordings:
+
+    An energy environment is fully described by the IV surface, which are IV
+    curves over time. Shepherd approximates this by sampling the current at
+    equidistant steps of a voltage ramp. The VirtualHarvesterConfig is also used
+    to parameterize the recording process, typically, it should be configured to
+    record a full IV surface, as this contains the full information of the energy
+    environment. The postponed harvesting is then performed during emulation.
+
+    However, it is also possible to record a "pre-harvested" energy environment
+    by performing the harvesting during recording. This results in a recording
+    containing IV samples over time that represent the harvesting voltage
+    (chosen by the virtual harvester during recording) and the current available
+    from the energy environment for that voltage. Together, these represent the
+    power available for harvesting at the time, and during emulation, this power
+    can be converted by the input stage (boost converter) to charge the energy
+    storage.
     """
 
     # General Metadata & Ownership -> ContentModel
 
     algorithm: AlgorithmDType
-    # ⤷ used to harvest energy
+    """The algorithm determines how the harvester chooses the harvesting voltage.
+    """
 
     samples_n: Annotated[int, Field(ge=8, le=2_000)] = 8
-    # ⤷ for & of ivcurve (and more?`)
+    """How many IV samples are measured for one IV curve.
+
+    The curve is recorded by measuring the el. current available from the
+    transducer at equidistant voltage intervals. These voltages are
+    probed by ramping between `voltage_min_mV` and `voltage_max_mV` at
+    `samples_n` points equally distributed over the voltage range. After
+    setting the voltage, the recorder waits for a short period - allowing
+    the analog frontend and transducer to settle - before recording the
+    harvesting current. This wait duration is influenced by
+    `wait_cycles`.
+
+    Selecting all these parameters is a tradeoff between accuracy of the IV
+    curve (density of IV samples) and measurement duration, hence the time
+    accuracy (density of points) of the IV-surface.
+
+    Only applicable to recording, not used in emulation.
+
+    Used together with `voltage_min_mV`, `voltage_max_mV`, `rising`, and
+    `wait_cycles`.
+    """
 
     voltage_mV: Annotated[float, Field(ge=0, le=5_000)] = 2_500
-    # ⤷ starting-point for some algorithms (mppt_po)
+    """The harvesting voltage for constant voltage harvesting.
+
+    Additionally, for Perturb-and-Observe MPPT, this defines the voltage at
+    startup.
+    """
+
     voltage_min_mV: Annotated[float, Field(ge=0, le=5_000)] = 0
+    """Minimum voltage recorded for the IV curve.
+
+    See `samples_n` for further details.
+
+    In emulation, this can be used to "block" parts of the recorded IV curve
+    and not utilize them in the virtual source. However, this is generally
+    discouraged as it can result in discontinuities in the curve and is not
+    well tested.
+    For emulation, this value ideally corresponds to the value of the
+    recorded energy environment.
+    """
+
     voltage_max_mV: Annotated[float, Field(ge=0, le=5_000)] = 5_000
+    """Maximum voltage sampled for the curve.
+
+    See `voltage_min_mV` and `samples_n`.
+    """
+
     current_limit_uA: Annotated[float, Field(ge=1, le=50_000)] = 50_000
-    # ⤷ allows to keep trajectory in special region (or constant current tracking)
-    # ⤷ boundary for detecting open circuit in emulated version (working on IV-Curves)
+    """
+    For MPPT VOC, the open circuit voltage is identified as the el. current
+    crosses below this threshold.
+
+    During recording it allows to keep trajectory in special region
+    (constant current tracking).
+    """
+
     voltage_step_mV: Optional[Annotated[float, Field(ge=1, le=1_000_000)]] = None
+    """The difference between two adjacent voltage samples.
+
+    This value is implicitly derived from the other ramp parameters:
+    (voltage_max_mV - voltage_min_mV) / (samples_n - 1)
+    """
 
     setpoint_n: Annotated[float, Field(ge=0, le=1.0)] = 0.70
-    # ⤷ ie. for mppt_voc
+    """
+    The "Open Circuit Voltage Maximum Power Point Tracker" estimates the MPP
+    by taking a constant fraction defined by this parameter of the open
+    circuit voltage. For example, if the IV curve shows an open circuit
+    voltage of 2V and the setpoint is 0.75, then the harvester selects
+    1.5 volts as the harvesting voltage.
+
+    This value is only relevant when 'algorithm == mppt_voc'.
+    """
+
     interval_ms: Annotated[float, Field(ge=0.01, le=1_000_000)] = 100
-    # ⤷ between start of measurements (ie. V_OC)
+    """The MPP is repeatedly estimated at fixed intervals defined by this duration.
+
+    Note that the energy environment can still change in between MPP
+    estimations, but the harvesting voltage is not updated in between.
+
+    This value is relevant for all MPP algorithms.
+    For Perturb and Observe, this value is the wait interval between steps.
+
+    When an energy environment is recorded with `mppt_opt`, the optimal
+    harvester is approximated with a very fast Perturb-Observe algorithm,
+    where this interval should be set to a very small value.
+    When emulating with `mppt_opt`, this value is not relevant as the
+    emulation simply picks the maximum power point from the IV-curve.
+    """
+
     duration_ms: Annotated[float, Field(ge=0.01, le=1_000_000)] = 0.1
-    # ⤷ of (open voltage) measurement
+    """The duration of MPP sampling.
+
+    While performing an MPP sampling every 'interval_ms', the input is
+    disconnected to accurately measure the open circuit voltage.
+
+    This value is only relevant for `mppt_voc`.
+    """
+
     rising: bool = True
-    # ⤷ direction of sawtooth
+    """Ramp direction for sampling the IV curve.
+
+    When set to true, sampling starts at the minimum voltage and ramps up to
+    the maximum.
+
+    See `samples_n` for further details.
+    Not relevant for emulation.
+    """
+
     enable_linear_extrapolation: bool = True
-    # ⤷ improves slow cv-algo that is base of most ivcurve-harvesters
-    #   (update-freq dependent on window-size)
+    """
+    Because the IV curve is not stored fully in PRU memory but streamed
+    sequentially to the PRU, looking up any IV value at any time is not
+    possible. However, because the precision of the emulation degrades
+    until the relevant IV sample passes by, it can extrapolate the available data
+    to estimate the required IV sample.
+
+    Enabling extrapolation can yield a better numeric simulation, especially
+    if the harvesting voltage changes rapidly or the IV surface is steep in
+    relevant regions. For example, when emulating a capacitor diode
+    setup and the current falls at high voltages.
+
+    This value is only relevant for emulation.
+    """
 
     # Underlying recorder
     wait_cycles: Annotated[int, Field(ge=0, le=100)] = 1
+    """
+    The wait duration to let the analog frontend settle before taking a
+    measurement.
+
+    When recording the energy environment, the voltage is set by the
+    digital-to-analog-converter. This parameter delays the current
+    measurement performed by the analog-to-digital converter to allow the
+    harvesting transducer to settle at the defined voltage.
+
+    When recording with `IscVoc`, wait cycles should be added as the analog
+    changes are more significant.
+
+    Not relevant for emulation.
+    """
+
     # ⤷ first cycle: ADC-Sampling & DAC-Writing, further steps: waiting
 
     @model_validator(mode="before")

shepherd_core/data_models/content/virtual_source.py

@@ -70,6 +70,7 @@ class VirtualSourceConfig(ContentModel, title="Config for the virtual Source"):
     # ⤷ target gets disconnected
     interval_check_thresholds_ms: Annotated[float, Field(ge=0, le=4.29e3)] = 0
     # ⤷ some ICs (BQ) check every 64 ms if output should be disconnected
+    # TODO: add intervals for input-disable, output-disable & power-good-signal
 
     # pwr-good: target is informed on output-pin (hysteresis) -> for intermediate voltage
     V_pwr_good_enable_threshold_mV: Annotated[float, Field(ge=0, le=10_000)] = 2_800

shepherd_core/data_models/experiment/experiment.py

@@ -5,17 +5,16 @@ from datetime import datetime
 from datetime import timedelta
 from typing import Annotated
 from typing import Optional
-from typing import Union
-from uuid import uuid4
 
-from pydantic import UUID4
 from pydantic import Field
 from pydantic import model_validator
 from typing_extensions import Self
+from typing_extensions import deprecated
 
 from shepherd_core.data_models.base.content import IdInt
 from shepherd_core.data_models.base.content import NameStr
 from shepherd_core.data_models.base.content import SafeStr
+from shepherd_core.data_models.base.content import id_default
 from shepherd_core.data_models.base.shepherd import ShpModel
 from shepherd_core.data_models.testbed.target import Target
 from shepherd_core.data_models.testbed.testbed import Testbed
@@ -29,8 +28,7 @@ class Experiment(ShpModel, title="Config of an Experiment"):
     """Config for experiments on the testbed emulating energy environments for target nodes."""
 
     # General Properties
-    # id: UUID4 ... # TODO: db-migration - temp fix for documentation
-    id: Union[UUID4, int] = Field(default_factory=uuid4)
+    id: int = Field(description="Unique ID", default_factory=id_default)
     # ⤷ TODO: automatic ID is problematic for identification by hash
 
     name: NameStr
@@ -51,7 +49,7 @@ class Experiment(ShpModel, title="Config of an Experiment"):
     # schedule
     time_start: Optional[datetime] = None  # = ASAP
     duration: Optional[timedelta] = None  # = till EOF
-    abort_on_error: bool = False
+    abort_on_error: Annotated[bool, deprecated("has no effect")] = False
 
     # targets
     target_configs: Annotated[list[TargetConfig], Field(min_length=1, max_length=128)]
@@ -61,6 +59,8 @@ class Experiment(ShpModel, title="Config of an Experiment"):
 
     @model_validator(mode="after")
     def post_validation(self) -> Self:
+        # TODO: only do deep validation with active connection to TB-client
+        #       or with cached fixtures
         testbed = Testbed()  # this will query the first (and only) entry of client
         self._validate_targets(self.target_configs)
         self._validate_observers(self.target_configs, testbed)

shepherd_core/data_models/experiment/observer_features.py

@@ -6,12 +6,14 @@ from typing import Annotated
 from typing import Optional
 
 import numpy as np
+from annotated_types import Interval
 from pydantic import Field
 from pydantic import PositiveFloat
 from pydantic import model_validator
 from typing_extensions import Self
 from typing_extensions import deprecated
 
+from shepherd_core import logger
 from shepherd_core.data_models.base.shepherd import ShpModel
 from shepherd_core.data_models.testbed.gpio import GPIO
 
@@ -105,7 +107,7 @@ STOPBITS_ONE, STOPBITS_ONE_POINT_FIVE, STOPBITS_TWO = (1, 1.5, 2)
 STOPBITS = (STOPBITS_ONE, STOPBITS_ONE_POINT_FIVE, STOPBITS_TWO)
 
 
-class UartTracing(ShpModel, title="Config for UART Tracing"):
+class UartLogging(ShpModel, title="Config for UART Logging"):
     """Configuration for recording UART-Output of the Target Nodes.
 
     Note that the Communication has to be on a specific port that
@@ -132,17 +134,33 @@ class UartTracing(ShpModel, title="Config for UART Tracing"):
         return self
 
 
+GpioInt = Annotated[int, Interval(ge=0, le=17)]
+GpioList = Annotated[list[GpioInt], Field(min_length=1, max_length=18)]
+all_gpio = list(range(18))
+
+
 class GpioTracing(ShpModel, title="Config for GPIO-Tracing"):
     """Configuration for recording the GPIO-Output of the Target Nodes.
 
     TODO: postprocessing not implemented ATM
     """
 
-    # initial recording
-    mask: Annotated[int, Field(ge=0, lt=2**10)] = 0b11_1111_1111  # all
-    # ⤷ TODO: custom mask not implemented in PRU, ATM
-    gpios: Optional[Annotated[list[GPIO], Field(min_length=1, max_length=10)]] = None  # = all
-    # ⤷ TODO: list of GPIO to build mask, one of both should be internal / computed field
+    gpios: GpioList = all_gpio
+    """List of GPIO to record.
+
+    This feature allows to remove unwanted pins from recording,
+    i.e. for chatty pins with separate UART Logging enabled.
+    Numbering is based on the Target-Port and its 16x GPIO and two PwrGood-Signals.
+    See doc for nRF_FRAM_Target_v1.3+ to see mapping of target port.
+
+    Example for skipping UART (pin 0 & 1):
+    .gpio = range(2,18)
+
+    Note:
+    - Cape 2.4 (2023) and lower only has 9x GPIO + 1x PwrGood
+    - Cape 2.5 (2025) has first 12 GPIO & both PwrGood
+    - this will be mapped accordingly by the observer
+    """
 
     # time
     delay: timedelta = timedelta(seconds=0)
@@ -150,31 +168,30 @@ class GpioTracing(ShpModel, title="Config for GPIO-Tracing"):
 
     # post-processing,
     uart_decode: bool = False
-    # TODO: quickfix - uart-log currently done online in userspace
-    # NOTE: gpio-tracing currently shows rather big - but rare - "blind" windows (~1-4us)
     uart_pin: GPIO = GPIO(name="GPIO8")
     uart_baudrate: Annotated[int, Field(ge=2_400, le=1_152_000)] = 115_200
-    # TODO: add a "discard_gpio" (if only uart is wanted)
 
     @model_validator(mode="after")
     def post_validation(self) -> Self:
-        if self.mask == 0:
-            raise ValueError("Error in config -> tracing enabled but mask is 0")
         if self.delay and self.delay.total_seconds() < 0:
             raise ValueError("Delay can't be negative.")
         if self.duration and self.duration.total_seconds() < 0:
             raise ValueError("Duration can't be negative.")
-        if self.mask != 0b11_1111_1111:  # GpioTracing.mask
-            raise NotImplementedError("Feature GpioTracing.mask reserved for future use.")
-        if self.gpios is not None:
-            raise NotImplementedError("Feature GpioTracing.gpios reserved for future use.")
         if self.uart_decode:
-            raise NotImplementedError(
+            logger.error(
                 "Feature GpioTracing.uart_decode reserved for future use. "
-                "Use UartTracing or manually decode serial with the provided waveform decoder."
+                "Use UartLogging or manually decode serial with the provided waveform decoder."
             )
         return self
 
+    @property
+    def gpio_mask(self) -> int:
+        # valid for cape v2.5
+        mask = 0
+        for gpio in set(self.gpios):
+            mask |= 2**gpio
+        return mask
+
 
 class GpioLevel(str, Enum):
     """Options for setting the gpio-level or state."""

shepherd_core/data_models/experiment/target_config.py

@@ -18,7 +18,7 @@ from shepherd_core.data_models.testbed.target import Target
 from .observer_features import GpioActuation
 from .observer_features import GpioTracing
 from .observer_features import PowerTracing
-from .observer_features import UartTracing
+from .observer_features import UartLogging
 
 
 class TargetConfig(ShpModel, title="Target Config"):
@@ -43,8 +43,8 @@ class TargetConfig(ShpModel, title="Target Config"):
 
     power_tracing: Optional[PowerTracing] = None
     gpio_tracing: Optional[GpioTracing] = None
-    uart_tracing: Optional[UartTracing] = None
     gpio_actuation: Optional[GpioActuation] = None
+    uart_logging: Optional[UartLogging] = None
 
     @model_validator(mode="after")
     def post_validation(self) -> Self:

shepherd_core/data_models/task/emulation.py

@@ -13,6 +13,7 @@ from pydantic import Field
 from pydantic import model_validator
 from pydantic import validate_call
 from typing_extensions import Self
+from typing_extensions import deprecated
 
 from shepherd_core.data_models.base.content import IdInt
 from shepherd_core.data_models.base.shepherd import ShpModel
@@ -23,7 +24,7 @@ from shepherd_core.data_models.experiment.observer_features import GpioActuation
 from shepherd_core.data_models.experiment.observer_features import GpioTracing
 from shepherd_core.data_models.experiment.observer_features import PowerTracing
 from shepherd_core.data_models.experiment.observer_features import SystemLogging
-from shepherd_core.data_models.experiment.observer_features import UartTracing
+from shepherd_core.data_models.experiment.observer_features import UartLogging
 from shepherd_core.data_models.testbed import Testbed
 from shepherd_core.data_models.testbed.cape import TargetPort
 from shepherd_core.logger import logger
@@ -63,7 +64,7 @@ class EmulationTask(ShpModel):
     # timestamp or unix epoch time, None = ASAP
     duration: Optional[timedelta] = None
     # ⤷ Duration of recording in seconds, None = till EOF
-    abort_on_error: bool = False  # TODO: remove, should not exist
+    abort_on_error: Annotated[bool, deprecated("has no effect")] = False
 
     # emulation-specific
     use_cal_default: bool = False
@@ -91,7 +92,7 @@ class EmulationTask(ShpModel):
 
     power_tracing: Optional[PowerTracing] = PowerTracing()
     gpio_tracing: Optional[GpioTracing] = GpioTracing()
-    uart_tracing: Optional[UartTracing] = UartTracing()
+    uart_logging: Optional[UartLogging] = UartLogging()
     gpio_actuation: Optional[GpioActuation] = None
     sys_logging: Optional[SystemLogging] = SystemLogging()
 
@@ -132,7 +133,7 @@ class EmulationTask(ShpModel):
             raise ValueError("GPIO Actuation not yet implemented!")
 
         io_requested = any(
-            _io is not None for _io in (self.gpio_actuation, self.gpio_tracing, self.uart_tracing)
+            _io is not None for _io in (self.gpio_actuation, self.gpio_tracing, self.uart_logging)
         )
         if self.enable_io and not io_requested:
             logger.warning("Target IO enabled, but no feature requested IO")
@@ -147,7 +148,7 @@ class EmulationTask(ShpModel):
         tgt_cfg = xp.get_target_config(tgt_id)
         io_requested = any(
             _io is not None
-            for _io in (tgt_cfg.gpio_actuation, tgt_cfg.gpio_tracing, tgt_cfg.uart_tracing)
+            for _io in (tgt_cfg.gpio_actuation, tgt_cfg.gpio_tracing, tgt_cfg.uart_logging)
         )
 
         return cls(
@@ -155,14 +156,13 @@ class EmulationTask(ShpModel):
             output_path=root_path / f"emu_{obs.name}.h5",
             time_start=copy.copy(xp.time_start),
             duration=xp.duration,
-            abort_on_error=xp.abort_on_error,
             enable_io=io_requested,
             io_port=obs.get_target_port(tgt_id),
             pwr_port=obs.get_target_port(tgt_id),
             virtual_source=tgt_cfg.virtual_source,
             power_tracing=tgt_cfg.power_tracing,
             gpio_tracing=tgt_cfg.gpio_tracing,
-            uart_tracing=tgt_cfg.uart_tracing,
+            uart_logging=tgt_cfg.uart_logging,
             gpio_actuation=tgt_cfg.gpio_actuation,
             sys_logging=xp.sys_logging,
         )

shepherd_core/data_models/task/harvest.py

@@ -9,6 +9,7 @@ from typing import Optional
 from pydantic import Field
 from pydantic import model_validator
 from typing_extensions import Self
+from typing_extensions import deprecated
 
 from shepherd_core.data_models.base.shepherd import ShpModel
 from shepherd_core.data_models.base.timezone import local_tz
@@ -36,8 +37,8 @@ class HarvestTask(ShpModel):
     time_start: Optional[datetime] = None
     # timestamp or unix epoch time, None = ASAP
     duration: Optional[timedelta] = None
-    # ⤷ Duration of recording in seconds, None = till EOF
-    abort_on_error: bool = False
+    # ⤷ Duration of recording in seconds, None = till EOFSys
+    abort_on_error: Annotated[bool, deprecated("has no effect")] = False
 
     # emulation-specific
     use_cal_default: bool = False

shepherd_core/data_models/task/observer_tasks.py

@@ -3,10 +3,12 @@
 from datetime import datetime
 from datetime import timedelta
 from pathlib import Path
+from typing import Annotated
 from typing import Optional
 
 from pydantic import validate_call
 from typing_extensions import Self
+from typing_extensions import deprecated
 
 from shepherd_core.data_models.base.content import IdInt
 from shepherd_core.data_models.base.content import NameStr
@@ -28,7 +30,7 @@ class ObserverTasks(ShpModel):
     # PRE PROCESS
     time_prep: datetime  # TODO: should be optional
     root_path: Path
-    abort_on_error: bool
+    abort_on_error: Annotated[bool, deprecated("has no effect")] = False
 
     # fw mod, store as hex-file and program
     fw1_mod: Optional[FirmwareModTask] = None
@@ -70,7 +72,6 @@ class ObserverTasks(ShpModel):
             owner_id=xp.owner_id,
             time_prep=t_start - tb.prep_duration,
             root_path=root_path,
-            abort_on_error=xp.abort_on_error,
             fw1_mod=FirmwareModTask.from_xp(xp, tb, tgt_id, 1, fw_paths[0]),
             fw2_mod=FirmwareModTask.from_xp(xp, tb, tgt_id, 2, fw_paths[1]),
             fw1_prog=ProgrammingTask.from_xp(xp, tb, tgt_id, 1, fw_paths[0]),
@@ -91,8 +92,8 @@ class ObserverTasks(ShpModel):
             tasks.append(task)
         return tasks
 
-    def get_output_paths(self) -> dict:
-        values = {}
+    def get_output_paths(self) -> dict[str, Path]:
+        values: dict[str, Path] = {}
         if isinstance(self.emulation, EmulationTask):
             if self.emulation.output_path is None:
                 raise ValueError("Emu-Task should have a valid output-path")

shepherd_core/data_models/task/programming.py

@@ -33,6 +33,7 @@ class ProgrammingTask(ShpModel):
     voltage: Annotated[float, Field(ge=1, lt=5)] = 3
     datarate: Annotated[int, Field(gt=0, le=1_000_000)] = 200_000
     protocol: ProgrammerProtocol
+    # TODO: eradicate - should not exist. derive protocol from mcu_type
 
     simulate: bool = False
 

shepherd_core/data_models/task/testbed_tasks.py

@@ -1,5 +1,6 @@
 """Collection of tasks for all observers included in experiment."""
 
+from pathlib import Path
 from typing import Annotated
 from typing import Optional
 
@@ -50,11 +51,11 @@ class TestbedTasks(ShpModel):
                 return tasks
         return None
 
-    def get_output_paths(self) -> dict:
+    def get_output_paths(self) -> dict[str, Path]:
         # TODO: computed field preferred, but they don't work here, as
         #  - they are always stored in yaml despite "repr=False"
         #  - solution will shift to some kind of "result"-datatype that is combinable
-        values = {}
+        values: dict[str, Path] = {}
         for obt in self.observer_tasks:
             values = {**values, **obt.get_output_paths()}
         return values

shepherd_core/data_models/testbed/cape_fixture.yaml

@@ -92,3 +92,11 @@
     id: 1270065
     name: cape65
     comment: only 220u/440uF on 5V
+- datatype: cape
+  parameters:
+    id: 42000
+    name: unit_testing_cape
+    version: none
+    description: for unit testing
+    created: 2025-04-29
+    calibrated: 2025-04-29

shepherd_core/data_models/testbed/gpio.py

@@ -65,3 +65,10 @@ class GPIO(ShpModel, title="GPIO of Observer Node"):
 
     def user_controllable(self) -> bool:
         return ("gpio" in self.name.lower()) and (self.direction in {"IO", "OUT"})
+
+    def user_recordable(self) -> bool:
+        return (
+            ("gpio" in self.name.lower())
+            and (self.direction in {"IO", "IN"})
+            and (self.pin_pru is not None)
+        )

shepherd_core/data_models/testbed/observer_fixture.yaml

@@ -221,3 +221,20 @@
     target_a:
       name: nRF52_FRAM_1392_390
     created: 2023-09-22 12:12:12
+- datatype: observer
+  parameters:
+    id: 42
+    name: unit_testing_sheep
+    ip: 0.0.0.0
+    mac: 00:00:00:00:00:00
+    room: none
+    eth_port: none
+    description: unit testing
+    longitude: 0
+    latitude: 0
+    cape:
+      name: unit_testing_cape
+    target_a:
+      name: unit_testing_target
+    created: 2025-04-29 13:07:00
+    active: true

shepherd_core/data_models/testbed/target_fixture.yaml

@@ -161,3 +161,16 @@
       name: nRF52
     mcu2: null
     created: 2022-12-12 12:12:12
+
+- datatype: target
+  parameters:
+    id: 42
+    name: unit_testing_target
+    version: v0
+    description: for unit testing
+    comment: no comment
+    created: 2025-04-29
+    mcu1:
+      name: nRF52
+    mcu2:
+      name: MSP430FR

shepherd_core/data_models/testbed/testbed_fixture.yaml

@@ -23,3 +23,14 @@
       - name: sheep12
       - name: sheep13
       - name: sheep14
+
+- datatype: testbed
+  parameters:
+    id: 42
+    name: unit_testing_testbed
+    description: "Artificial Testbed used in unit testing"
+    shared_storage: true
+    data_on_server: /tmp/
+    data_on_observer: /tmp/
+    observers:
+      - name: unit_testing_sheep

shepherd_core/reader.py

@@ -412,19 +412,20 @@ class Reader:
                 self.file_path.name,
             )
         # same length of datasets:
-        for dset in ["current", "time"]:
+        samples_n = self.h5file["data"]["time"].shape[0]
+        for dset in ["voltage", "current"]:
             ds_size = self.h5file["data"][dset].shape[0]
-            if ds_size != self.samples_n:
+            if ds_size != samples_n:
                 self._logger.warning(
                     "[FileValidation] dataset '%s' has different size (=%d), "
-                    "compared to smallest set (=%d), in '%s'",
+                    "compared to time (=%d), in '%s'",
                     dset,
                     ds_size,
-                    self.samples_n,
+                    samples_n,
                     self.file_path.name,
                 )
         # dataset-length should be multiple of chunk-size
-        remaining_size = self.samples_n % self.CHUNK_SAMPLES_N
+        remaining_size = samples_n % self.CHUNK_SAMPLES_N
         if remaining_size != 0:
             self._logger.warning(
                 "[FileValidation] datasets are not aligned with chunk-size in '%s'",

shepherd_core/testbed_client/fixtures.py

@@ -2,6 +2,7 @@
 
 import copy
 import pickle
+from collections.abc import Iterable
 from collections.abc import Mapping
 from datetime import datetime
 from datetime import timedelta
@@ -34,11 +35,11 @@ class Fixture:
 
     def __init__(self, model_type: str) -> None:
         self.model_type: str = model_type.lower()
-        self.elements_by_name: dict[str, dict] = {}
-        self.elements_by_id: dict[int, dict] = {}
+        self.elements_by_name: dict[str, dict[str, Any]] = {}
+        self.elements_by_id: dict[int, dict[str, Any]] = {}
         # Iterator reset
         self._iter_index: int = 0
-        self._iter_list: list = list(self.elements_by_name.values())
+        self._iter_list: list[dict[str, Any]] = list(self.elements_by_name.values())
 
     def insert(self, data: Wrapper) -> None:
         # ⤷ TODO: could get easier
@@ -54,9 +55,10 @@ class Fixture:
         self.elements_by_name[name] = data_model
         self.elements_by_id[_id] = data_model
         # update iterator
-        self._iter_list = list(self.elements_by_name.values())
+        self._iter_list: list[dict[str, Any]] = list(self.elements_by_name.values())
 
-    def __getitem__(self, key: Union[str, int]) -> dict:
+    def __getitem__(self, key: Union[str, int]) -> dict[str, Any]:
+        original_key = key
         if isinstance(key, str):
             key = key.lower()
             if key in self.elements_by_name:
@@ -65,7 +67,7 @@ class Fixture:
                 key = int(key)
         if key in self.elements_by_id:
             return self.elements_by_id[int(key)]
-        msg = f"{self.model_type} '{key}' not found!"
+        msg = f"{self.model_type} '{original_key}' not found!"
         raise ValueError(msg)
 
     def __iter__(self) -> Self:
@@ -73,14 +75,14 @@ class Fixture:
         self._iter_list = list(self.elements_by_name.values())
         return self
 
-    def __next__(self) -> Any:
+    def __next__(self) -> dict[str, Any]:
         if self._iter_index < len(self._iter_list):
             member = self._iter_list[self._iter_index]
             self._iter_index += 1
             return member
         raise StopIteration
 
-    def keys(self):  # noqa: ANN201
+    def keys(self) -> Iterable[str]:
         return self.elements_by_name.keys()
 
     def refs(self) -> dict:
@@ -149,13 +151,13 @@ class Fixture:
             base[key] = value
         return base
 
-    def query_id(self, _id: int) -> dict:
+    def query_id(self, _id: int) -> dict[str, Any]:
         if isinstance(_id, int) and _id in self.elements_by_id:
             return self.elements_by_id[_id]
         msg = f"Initialization of {self.model_type} by ID failed - {_id} is unknown!"
         raise ValueError(msg)
 
-    def query_name(self, name: str) -> dict:
+    def query_name(self, name: str) -> dict[str, Any]:
         if isinstance(name, str) and name.lower() in self.elements_by_name:
             return self.elements_by_name[name.lower()]
         msg = f"Initialization of {self.model_type} by name failed - {name} is unknown!"
@@ -239,7 +241,7 @@ class Fixtures:
         msg = f"Component '{key}' not found!"
         raise ValueError(msg)
 
-    def keys(self):  # noqa: ANN201
+    def keys(self) -> Iterable[str]:
         return self.components.keys()
 
     @staticmethod

shepherd_core/testbed_client/user_model.py

@@ -5,10 +5,7 @@ from hashlib import pbkdf2_hmac
 from typing import Annotated
 from typing import Any
 from typing import Optional
-from typing import Union
-from uuid import uuid4
 
-from pydantic import UUID4
 from pydantic import EmailStr
 from pydantic import Field
 from pydantic import SecretBytes
@@ -19,6 +16,7 @@ from pydantic import validate_call
 
 from shepherd_core.data_models.base.content import NameStr
 from shepherd_core.data_models.base.content import SafeStr
+from shepherd_core.data_models.base.content import id_default
 from shepherd_core.data_models.base.shepherd import ShpModel
 
 
@@ -41,10 +39,9 @@ def hash_password(pw: Annotated[str, StringConstraints(min_length=20, max_length
 class User(ShpModel):
     """meta-data representation of a testbed-component (physical object)."""
 
-    # id: UUID4 = Field(  # TODO: db-migration - temp fix for documentation
-    id: Union[UUID4, int] = Field(
+    id: int = Field(
         description="Unique ID",
-        default_factory=uuid4,
+        default_factory=id_default,
     )
     name: NameStr
     description: Optional[SafeStr] = None

shepherd_core/version.py

@@ -1,3 +1,3 @@
 """Separated string avoids circular imports."""
 
-version: str = "2025.05.2"
+version: str = "2025.05.3"

{shepherd_core-2025.5.2.dist-info → shepherd_core-2025.5.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shepherd_core
-Version: 2025.5.2
+Version: 2025.5.3
 Summary: Programming- and CLI-Interface for the h5-dataformat of the Shepherd-Testbed
 Author-email: Ingmar Splitt <ingmar.splitt@tu-dresden.de>
 Maintainer-email: Ingmar Splitt <ingmar.splitt@tu-dresden.de>

{shepherd_core-2025.5.2.dist-info → shepherd_core-2025.5.3.dist-info}/RECORD

@@ -2,54 +2,54 @@ shepherd_core/__init__.py,sha256=fCld2mcl0y0h6kRyPal3DP-sWXnKl_0aYWYBdg4QuUk,127
 shepherd_core/calibration_hw_def.py,sha256=aL94bA1Sf14L5A3PLdVvQVYtGi28S4NUWA65wbim8bw,2895
 shepherd_core/commons.py,sha256=rTxtndtiJ4cOHYRPRbdZdqp6T90CKFFN-I-YAFzhm4Q,200
 shepherd_core/logger.py,sha256=i8j3alm8icAx_h1_IZ6SgVgC9W5J7S-bDc31mPDWl-w,1812
-shepherd_core/reader.py,sha256=EYgpL09DMrACiDHoG3LbgSJrci4pCPY3r13X0XVNVLI,29179
-shepherd_core/version.py,sha256=p9ZnvPFg9wu9KOtST8r_-f6-9CC_FMIG7IhKqfjDez4,76
+shepherd_core/reader.py,sha256=fwRGGALpw6nK4dMBznbopTRQMriHvD8u_03OcFQfQI8,29216
+shepherd_core/version.py,sha256=eD5tv5xJDDTtAuWGItss0DqfnV6QAY0bpqdT1wn4kvE,76
 shepherd_core/writer.py,sha256=_ji3X2bb4JKZZm4uz8DO9uG_WoHL5Zpg6_Na36WAF5o,14609
-shepherd_core/data_models/__init__.py,sha256=Fl9Lhdo32mrdF232ZjOnkawQYeFsUbTS4FOUrvmSzlM,1909
+shepherd_core/data_models/__init__.py,sha256=tbELRPbWx6100IHjDia85LZGb66A0ymD1bbfBWGuGJs,1909
 shepherd_core/data_models/readme.md,sha256=DHPVmkWqDksWomRHRTVWVHy9wXF9oMJrITgKs4Pnz2g,2494
 shepherd_core/data_models/virtual_source_doc.txt,sha256=OK_7zYbLvr6cEj3KaUcWwZJ9naoFB2KwAaXudbhzouQ,6076
 shepherd_core/data_models/base/__init__.py,sha256=PSJ6acWViqBm0Eiom8DIgKfFVrp5lzYr8OsDvP79vwI,94
 shepherd_core/data_models/base/cal_measurement.py,sha256=c-vjACNxsQY8LU2Msw0COrsTY-8pToJ5ZWkOztJ9tVY,3380
 shepherd_core/data_models/base/calibration.py,sha256=oUTfY6iUWUbBbOw5aMCRkdEfHzIV8aUrhwqek0QzPJM,10849
-shepherd_core/data_models/base/content.py,sha256=t3hw5Aes4-tVrWGOMSBGpcD642VM1RAWIo9jtbXifd0,2452
+shepherd_core/data_models/base/content.py,sha256=e8-UWjF7QW4mYMqnDSnbhZTY3ODxGyx50A_K4SgDnNs,2098
 shepherd_core/data_models/base/shepherd.py,sha256=P1xW10_vIbGNyQ3Ary67vyovw9kmDtXhN-yPFYR-0Is,6085
 shepherd_core/data_models/base/timezone.py,sha256=2T6E46hJ1DAvmqKfu6uIgCK3RSoAKjGXRyzYNaqKyjY,665
 shepherd_core/data_models/base/wrapper.py,sha256=7QwvI30GuORH7WmyGLnRMsZ3xkRRkXIAvZ-pYRAL-WI,755
 shepherd_core/data_models/content/__init__.py,sha256=69aiNG0h5t1OF7HsLg_ke5eaQKsKyMK8o6Kfaby5vlY,525
-shepherd_core/data_models/content/_external_fixtures.yaml,sha256=Iv0T5cN8BFVELuLtmxml2-xwcMDMZWF7LOu_TM3RIJ8,12184
+shepherd_core/data_models/content/_external_fixtures.yaml,sha256=BsHW5UP1UtrEkcI-efCHq4gFtnsuOvoCPv1ri-f6JOI,12132
 shepherd_core/data_models/content/energy_environment.py,sha256=DSTB3CE3XEBXaL16z4FVaHSyLnp0bfxUgw3SnQrUpf0,1628
 shepherd_core/data_models/content/energy_environment_fixture.yaml,sha256=UBXTdGT7MK98zx5w_RBCu-f9uNCKxRgiFBQFbmDUxPc,1301
 shepherd_core/data_models/content/firmware.py,sha256=KLByo1GuUMJ8ZbM6WccB8IJArorNetBxqOpuUb2_QIE,5926
 shepherd_core/data_models/content/firmware_datatype.py,sha256=XPU9LOoT3h5qFOlE8WU0vAkw-vymNxzor9kVFyEqsWg,255
-shepherd_core/data_models/content/virtual_harvester.py,sha256=QLyOLH0Q1E8NKWgWyMd4e65iEA13CVHmdf7kLf4SqFk,11287
+shepherd_core/data_models/content/virtual_harvester.py,sha256=_b31Ji_N2NS92FXt1UkgzesaAi2M6T8b2cZrVzM3lw0,20313
 shepherd_core/data_models/content/virtual_harvester_fixture.yaml,sha256=4eNQyFI9LozpButOTlBQ07T0MFCaPEYIxwtedMjUf3U,4575
-shepherd_core/data_models/content/virtual_source.py,sha256=4TAk7jgXCQh6MMnT0Ijw_AdE6YPgrbSwFfb8F1V6RVE,15565
+shepherd_core/data_models/content/virtual_source.py,sha256=GLMBhhp7RPoaieZTPuYVF5q0XRw8D3RzoOaJWGeIkbg,15645
 shepherd_core/data_models/content/virtual_source_fixture.yaml,sha256=tsSJ1mM4OSPSeNkqVoZlDQ8Az3N8KeTXd0oA2JKd-hk,11201
 shepherd_core/data_models/experiment/__init__.py,sha256=lorsx0M-JWPIrt_UZfexsLwaITv5slFb3krBOt0idm8,618
-shepherd_core/data_models/experiment/experiment.py,sha256=oFOpyxHmwCZmbJAejyoqAAjarA2ZgnNYEx6Qf7TPjqU,4178
-shepherd_core/data_models/experiment/observer_features.py,sha256=xCaN2wymG-ygEy19jTIvY9YyitdjPWepDH5UjXdq8Y8,8315
-shepherd_core/data_models/experiment/target_config.py,sha256=nlOZvLC5C6Pjn-ZEXLMr5WZlC1edixL_l3rWi93UPZE,4082
+shepherd_core/data_models/experiment/experiment.py,sha256=K7eENfZmUg4-Nl3jHyZfsWjgkFwLX3k6JRFbwQ3JMfY,4308
+shepherd_core/data_models/experiment/observer_features.py,sha256=i3JGXK4xGhQhuqKrnUHpA-YAoUsTY-RKZ4pPeWWkPlI,8359
+shepherd_core/data_models/experiment/target_config.py,sha256=FzKdYVO0ynN4-lwM5Is-ts9uQoCv52U-KZ--GHvl7dY,4082
 shepherd_core/data_models/task/__init__.py,sha256=m7_OK05djkoDt-XwKQ6gPT7qIcCUoyBxZgSXvD3HmzQ,3386
-shepherd_core/data_models/task/emulation.py,sha256=-JzRm-xRp421Xl4lBkT52AEhTkb8ZqH9C1Z8CeHPHF8,7380
+shepherd_core/data_models/task/emulation.py,sha256=FZOG36OZCBjS3MkWu8oHCiXv3ljPMx7h7EqMjl6f_xM,7381
 shepherd_core/data_models/task/firmware_mod.py,sha256=WLmevU9-Q5QnyANbkrSCdFbnVuSi8N8fXdQ2l_Um9e8,3034
-shepherd_core/data_models/task/harvest.py,sha256=rQ5Aq40m4WHpEFfiwn309GjLIPu4aKzF4Fvbo4j7PLs,3470
-shepherd_core/data_models/task/observer_tasks.py,sha256=icUPtoIqic8IpE0U9Fc7btMj4CpYx1PoAu_wAqqZkU8,3608
-shepherd_core/data_models/task/programming.py,sha256=jX_5biD6BGkBdIS652CajXWm0KOgY3w1Z3AOJIFgTws,2573
-shepherd_core/data_models/task/testbed_tasks.py,sha256=J3aOSVVG1KvEI_83j0TK0gc5rN_v_T-URFRhrEs8czY,2176
+shepherd_core/data_models/task/harvest.py,sha256=BrT4kcLniSS_d-5RSdiCPtojVrA5st0P0-FOHiXCOR4,3554
+shepherd_core/data_models/task/observer_tasks.py,sha256=TKGWhQ2-KU0j5wBg48U-0nVAfUL1QZeMUCrlkeLZdz8,3708
+shepherd_core/data_models/task/programming.py,sha256=Bo_q6dDmg4dnX19QblBWkMQKpUJcLYRuVRXc96POWyo,2645
+shepherd_core/data_models/task/testbed_tasks.py,sha256=hOAKEvABIeiiKk4W4IfqNMP2N95NwqyKRqOaKT-WeBg,2229
 shepherd_core/data_models/testbed/__init__.py,sha256=t9nwml5pbu7ZWghimOyZ8ujMIgnRgFkl23pNb5d_KdU,581
 shepherd_core/data_models/testbed/cape.py,sha256=vfS05D0rC1-_wMiHeLw69VE9PxXC6PHl9ndtrv219_k,1396
-shepherd_core/data_models/testbed/cape_fixture.yaml,sha256=uwZxe6hsqvofn5tzg4sffjbVtTVUkextL1GCri_z2A4,2197
-shepherd_core/data_models/testbed/gpio.py,sha256=pOY_7Zs32sRGuqJZrZDrjvr69QkFXC8iXgav7kk2heY,2334
+shepherd_core/data_models/testbed/cape_fixture.yaml,sha256=-N_iinnz-Ea_6qJ6C288XM06M53Ig7oA70cj4CdmC-c,2373
+shepherd_core/data_models/testbed/gpio.py,sha256=eYAcVbjUlECqs1caTIiN-4HdEvXxxkEXYsghIY4yOqk,2535
 shepherd_core/data_models/testbed/gpio_fixture.yaml,sha256=yXvoXAau2hancKi2yg1xIkErPWQa6gIxNUG3y8JuF9Y,3076
 shepherd_core/data_models/testbed/mcu.py,sha256=fuq2AWbVFbbzPRPCgIeMNFhJhVNCIsmpjFagnOXkjbY,1514
 shepherd_core/data_models/testbed/mcu_fixture.yaml,sha256=bOYXdQY-6JYesxOkZAT8WvuGsdUc_MW4dkAmopLL8RM,507
 shepherd_core/data_models/testbed/observer.py,sha256=RO7i9TmHcxx69P-EHN59M9MAJetoHZg5qJUD5SEtrcg,3386
-shepherd_core/data_models/testbed/observer_fixture.yaml,sha256=jqAatTebWrShXBlhqkCUQIrtVqEjl7RVDR9mosS2LJQ,4807
+shepherd_core/data_models/testbed/observer_fixture.yaml,sha256=bilVGLxo8iWkm_vwDWpIUG3DZgQ8fSZqHDdHgsN1afg,5158
 shepherd_core/data_models/testbed/target.py,sha256=W7U9nCz_xWMRCCgaGuqOV4dGi4ZeQ1SAp7W2FqCkanU,1978
 shepherd_core/data_models/testbed/target_fixture.old1,sha256=ivH9uTgC2Z4L_J4KDHAyIHZnB7iy9EUu1yM3M0s1lQQ,3675
-shepherd_core/data_models/testbed/target_fixture.yaml,sha256=LyOJa7yH17tHIGC25jlkLJ_DKnbFSoGhD-6Uh6q_HqQ,4132
+shepherd_core/data_models/testbed/target_fixture.yaml,sha256=g6BWyV38b8b2UaM98EOytZIFPPrBOUXcrOXrcCj4XWI,4364
 shepherd_core/data_models/testbed/testbed.py,sha256=K6llqMTn-AU18XXRXdhzibIx-n4CQjtrXnLwqxOQesI,3828
-shepherd_core/data_models/testbed/testbed_fixture.yaml,sha256=LaaU8mXLQboYWYNPpA3CWmMPy2w6T6cve6gLgDaA3l0,717
+shepherd_core/data_models/testbed/testbed_fixture.yaml,sha256=ca5LI-fWoc3I9m2QScVAh84Bv-ftkSGAizR3ZR0lkC8,980
 shepherd_core/decoder_waveform/__init__.py,sha256=-ohGz0fA2tKxUJk4FAQXKtI93d6YGdy0CrkdhOod1QU,120
 shepherd_core/decoder_waveform/uart.py,sha256=vuw9fKwZb_1mMtQ5fdiZN8Cr1YWSgYKar9FIMK8Bogo,11084
 shepherd_core/fw_tools/__init__.py,sha256=D9GGj9TzLWZfPjG_iV2BsF-Q1TGTYTgEzWTUI5ReVAA,2090
@@ -65,8 +65,8 @@ shepherd_core/testbed_client/__init__.py,sha256=QtbsBUzHwOoM6rk0qa21ywuz63YV7af1
 shepherd_core/testbed_client/cache_path.py,sha256=tS0er9on5fw8wddMCt1jkc2uyYOdSTvX_UmfmYJf6tY,445
 shepherd_core/testbed_client/client_abc_fix.py,sha256=xMch4y6vMMLRiqFEry2zSnYuLM6Ay-fY0dunXMz9Hws,4250
 shepherd_core/testbed_client/client_web.py,sha256=zqY4MGMWfTl2_0T1qrQl5Vz9SPjl-wMj8O5yMMQyo9I,6044
-shepherd_core/testbed_client/fixtures.py,sha256=ftPJwiOn-USroIee2Al3evR3WxsA1SxERusoZ-jbkVk,9223
-shepherd_core/testbed_client/user_model.py,sha256=f4WZ8IvSCt3s1RG_Bhi43ojiJQsZYyolJ3Ft8HNRYas,2175
+shepherd_core/testbed_client/fixtures.py,sha256=gKTRt_44u42-1OMuONho34WqRvoelDbChAGA5rdbbXQ,9397
+shepherd_core/testbed_client/user_model.py,sha256=F6ibcvqZOYp7Tw92FoWERuCMp9LFsTL-0ACWhSzZs2A,2077
 shepherd_core/vsource/__init__.py,sha256=vTvFWuJn4eurPNzEiMd15c1Rd6o3DTWzCfbhOomflZU,771
 shepherd_core/vsource/target_model.py,sha256=BjOlwX_gIOJ91e4OOLB4_OsCpuhq9vm57ERjM-iBhAM,5129
 shepherd_core/vsource/virtual_converter_model.py,sha256=jUnJwP-FFDMtXm1NCLUJfZTvImYH4_A9rc_lXVAZ33I,11628
@@ -74,8 +74,8 @@ shepherd_core/vsource/virtual_harvester_model.py,sha256=8uPTMDth4KI5XarkX9EJtMRZ
 shepherd_core/vsource/virtual_harvester_simulation.py,sha256=eK9uCn-j_8xSTa7BQhG879ep0oZDeatlnF31LeWEDiM,2547
 shepherd_core/vsource/virtual_source_model.py,sha256=-8RwBrkIdO0g4zpo7XHnqv8F_qNh_qf5hxEUJoIuAmg,3164
 shepherd_core/vsource/virtual_source_simulation.py,sha256=6voU1TAB2P0xuVu1bnyKa-xW9rwYXUC6f06gYtUDHTs,5273
-shepherd_core-2025.5.2.dist-info/METADATA,sha256=nACqRWB12RTUhFeUPiKcnw7UvP2YEV4ZNg-kKRGkWSw,7756
-shepherd_core-2025.5.2.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
-shepherd_core-2025.5.2.dist-info/top_level.txt,sha256=wy-t7HRBrKARZxa-Y8_j8d49oVHnulh-95K9ikxVhew,14
-shepherd_core-2025.5.2.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-shepherd_core-2025.5.2.dist-info/RECORD,,
+shepherd_core-2025.5.3.dist-info/METADATA,sha256=X_NXYCMWCsu8RwQX9Vm40CMQbV4eUtsKyMl9P4yJsbA,7756
+shepherd_core-2025.5.3.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+shepherd_core-2025.5.3.dist-info/top_level.txt,sha256=wy-t7HRBrKARZxa-Y8_j8d49oVHnulh-95K9ikxVhew,14
+shepherd_core-2025.5.3.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+shepherd_core-2025.5.3.dist-info/RECORD,,

{shepherd_core-2025.5.2.dist-info → shepherd_core-2025.5.3.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.4.0)
+Generator: setuptools (80.8.0)
 Root-Is-Purelib: true
 Tag: py3-none-any