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

shepherd_core/data_models/content/virtual_source.py

@@ -33,7 +33,7 @@ class VirtualSourceConfig(ContentModel, title="Config for the virtual Source"):
     The converter-stage is software defined and offers:
     - buck-boost-combinations,
     - a simple diode + resistor and
-    - an intermediate buffer capacitor.
+    - an intermediate storage capacitor.
     """
 
     # TODO: I,V,R should be in regular unit (V, A, Ohm)
@@ -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
@@ -82,6 +83,8 @@ class VirtualSourceConfig(ContentModel, title="Config for the virtual Source"):
     C_output_uF: Annotated[float, Field(ge=0, le=4.29e6)] = 1.0
     # TODO: C_output is handled internally as delta-V, but should be a I_transient
     #       that makes it visible in simulation as additional i_out_drain
+    # TODO: potential weakness, ACD lowpass is capturing transient,
+    #       but energy is LOST with this model
 
     # Extra
     V_output_log_gpio_threshold_mV: Annotated[float, Field(ge=0, le=4.29e6)] = 1_400
@@ -105,7 +108,7 @@ class VirtualSourceConfig(ContentModel, title="Config for the virtual Source"):
     # Buck Converter
     V_output_mV: Annotated[float, Field(ge=0, le=5_000)] = 2_400
     V_buck_drop_mV: Annotated[float, Field(ge=0, le=5_000)] = 0
-    # ⤷ simulate LDO min voltage differential or output-diode
+    # ⤷ simulate LDO / diode min voltage differential or output-diode
 
     LUT_output_efficiency: LUT1D = 12 * [1.00]
     # ⤷ array[12] depending on output_current

shepherd_core/data_models/content/virtual_source_fixture.yaml

@@ -93,7 +93,7 @@
   parameters:
     id: 1011
     name: diode+capacitor
-    description: Simple Converter based on diode and buffer capacitor
+    description: Simple Converter based on diode and storage capacitor
     inherit_from: neutral
     V_input_drop_mV: 300  # simulate input-diode
     C_intermediate_uF: 47  # primary storage-Cap
@@ -114,7 +114,7 @@
   parameters:
     id: 1013
     name: diode+resistor+capacitor
-    description: Simple Converter based on diode, current limiting resistor and buffer capacitor
+    description: Simple Converter based on diode, current limiting resistor and storage capacitor
     inherit_from: diode+capacitor
     R_input_mOhm: 10000
 
@@ -133,7 +133,7 @@
     enable_boost: true # if false -> v_intermediate = v_input, output-switch-hysteresis is still usable
 
     harvester:
-      name: mppt_bq_solar # harvester only active if input is "ivcurves"
+      name: mppt_bq_solar # harvester only active if input is ivsurface / curves
 
     V_input_max_mV: 3000
     I_input_max_mA: 100

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
@@ -46,21 +44,23 @@ class Experiment(ShpModel, title="Config of an Experiment"):
     # feedback
     email_results: bool = False
 
-    sys_logging: SystemLogging = SystemLogging(dmesg=True, ptp=True, shepherd=True)
+    sys_logging: SystemLogging = SystemLogging()  # = all active
 
     # 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)]
 
-    # for debug-purposes and later comp-checks
+    # debug
     lib_ver: Optional[str] = version
 
     @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,11 +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
 
@@ -22,7 +25,7 @@ class PowerTracing(ShpModel, title="Config for Power-Tracing"):
     """
 
     intermediate_voltage: bool = False
-    # ⤷ for EMU: record buffer capacitor instead of output (good for V_out = const)
+    # ⤷ for EMU: record storage capacitor instead of output (good for V_out = const)
     #            this also includes current!
 
     # time
@@ -47,21 +50,117 @@ class PowerTracing(ShpModel, title="Config for Power-Tracing"):
         if not self.calculate_power and discard_all:
             raise ValueError("Error in config -> tracing enabled, but output gets discarded")
         if self.calculate_power:
-            raise NotImplementedError("postprocessing not implemented ATM")
+            raise NotImplementedError(
+                "Feature PowerTracing.calculate_power reserved for future use."
+            )
+        if self.samplerate != 100_000:
+            raise NotImplementedError("Feature PowerTracing.samplerate reserved for future use.")
+        if self.discard_current:
+            raise NotImplementedError(
+                "Feature PowerTracing.discard_current reserved for future use."
+            )
+        if self.discard_voltage:
+            raise NotImplementedError(
+                "Feature PowerTracing.discard_voltage reserved for future use."
+            )
         return self
 
 
+# NOTE: this was taken from pyserial (removes one dependency)
+BAUDRATES = (
+    50,
+    75,
+    110,
+    134,
+    150,
+    200,
+    300,
+    600,
+    1200,
+    1800,
+    2400,
+    4800,
+    9600,
+    19200,
+    38400,
+    57600,
+    115200,
+    230400,
+    460800,
+    500000,
+    576000,
+    921600,
+    1000000,
+    1152000,
+    1500000,
+    2000000,
+    2500000,
+    3000000,
+    3500000,
+    4000000,
+)
+
+PARITY_NONE, PARITY_EVEN, PARITY_ODD, PARITY_MARK, PARITY_SPACE = "N", "E", "O", "M", "S"
+PARITIES = (PARITY_NONE, PARITY_EVEN, PARITY_ODD, PARITY_MARK, PARITY_SPACE)
+
+STOPBITS_ONE, STOPBITS_ONE_POINT_FIVE, STOPBITS_TWO = (1, 1.5, 2)
+STOPBITS = (STOPBITS_ONE, STOPBITS_ONE_POINT_FIVE, STOPBITS_TWO)
+
+
+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
+    reaches the hardware-module of the SBC.
+    """
+
+    baudrate: Annotated[int, Field(ge=2_400, le=460_800)] = 115_200
+    # ⤷ TODO: find maximum that the system can handle
+    bytesize: Annotated[int, Field(ge=5, le=8)] = 8
+    stopbits: Annotated[float, Field(ge=1, le=2)] = 1
+    parity: str = PARITY_NONE
+
+    @model_validator(mode="after")
+    def post_validation(self) -> Self:
+        if self.baudrate not in BAUDRATES:
+            msg = f"Error in config -> baud-rate must be one of: {BAUDRATES}"
+            raise ValueError(msg)
+        if self.stopbits not in STOPBITS:
+            msg = f"Error in config -> stop-bits must be one of: {STOPBITS}"
+            raise ValueError(msg)
+        if self.parity not in PARITIES:
+            msg = f"Error in config -> parity must be one of: {PARITIES}"
+            raise ValueError(msg)
+        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)
@@ -69,22 +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=921_600)] = 115_200
-    # TODO: add a "discard_gpio" (if only uart is wanted)
+    uart_baudrate: Annotated[int, Field(ge=2_400, le=1_152_000)] = 115_200
 
     @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.uart_decode:
+            logger.error(
+                "Feature GpioTracing.uart_decode reserved for future use. "
+                "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."""
@@ -133,11 +240,15 @@ class GpioActuation(ShpModel, title="Config for GPIO-Actuation"):
 class SystemLogging(ShpModel, title="Config for System-Logging"):
     """Configuration for recording Debug-Output of the Observers System-Services."""
 
-    dmesg: bool = True
-    ptp: bool = True
-    shepherd: bool = True
-    # TODO: rename to kernel, timesync, sheep
-    # TODO: add utilization as option
+    kernel: bool = True
+    time_sync: bool = True
+    sheep: bool = True
+    sys_util: bool = True
+
+    # TODO: remove lines below in 2026
+    dmesg: Annotated[bool, deprecated("for sheep v0.9.0+, use 'kernel' instead")] = True
+    ptp: Annotated[bool, deprecated("for sheep v0.9.0+, use 'time_sync' instead")] = True
+    shepherd: Annotated[bool, deprecated("for sheep v0.9.0+, use 'sheep' instead")] = True
 
 
 # TODO: some more interaction would be good

shepherd_core/data_models/experiment/target_config.py

@@ -18,6 +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 UartLogging
 
 
 class TargetConfig(ShpModel, title="Target Config"):
@@ -38,10 +39,12 @@ class TargetConfig(ShpModel, title="Target Config"):
 
     firmware1: Firmware
     firmware2: Optional[Firmware] = None
+    # ⤷ omitted FW gets set to neutral deep-sleep
 
     power_tracing: Optional[PowerTracing] = None
     gpio_tracing: Optional[GpioTracing] = None
     gpio_actuation: Optional[GpioActuation] = None
+    uart_logging: Optional[UartLogging] = None
 
     @model_validator(mode="after")
     def post_validation(self) -> Self:
@@ -79,6 +82,8 @@ class TargetConfig(ShpModel, title="Target Config"):
             msg = f"Provided custom IDs {c_ids} not enough to cover target range {t_ids}"
             raise ValueError(msg)
         # TODO: if custom ids present, firmware must be ELF
+        if self.gpio_actuation is not None:
+            raise NotImplementedError("Feature GpioActuation reserved for future use.")
         return self
 
     def get_custom_id(self, target_id: int) -> Optional[int]:

shepherd_core/data_models/task/__init__.py

@@ -54,7 +54,8 @@ def prepare_task(config: Union[ShpModel, Path, str], observer: Optional[str] = N
             parameters=config.model_dump(),
         )
     else:
-        raise TypeError("had unknown input: %s", type(config))
+        msg = f"had unknown input: {type(config)}"
+        raise TypeError(msg)
 
     if shp_wrap.datatype == TestbedTasks.__name__:
         if observer is None:
@@ -66,7 +67,8 @@ def prepare_task(config: Union[ShpModel, Path, str], observer: Optional[str] = N
         logger.debug("Loading Testbed-Tasks %s for %s", tbt.name, observer)
         obt = tbt.get_observer_tasks(observer)
         if obt is None:
-            raise ValueError("Observer '%s' is not in TestbedTask-Set", observer)
+            msg = f"Observer '{observer}' is not in TestbedTask-Set"
+            raise ValueError(msg)
         shp_wrap = Wrapper(
             datatype=type(obt).__name__,
             parameters=obt.model_dump(),
@@ -92,6 +94,7 @@ def extract_tasks(shp_wrap: Wrapper, *, no_task_sets: bool = True) -> list[ShpMo
             raise ValueError("Model in Wrapper was TestbedTasks -> Task-Sets not allowed!")
         content = [TestbedTasks(**shp_wrap.parameters)]
     else:
-        raise ValueError("Extractor had unknown task: %s", shp_wrap.datatype)
+        msg = f"Extractor had unknown task: {shp_wrap.datatype}"
+        raise ValueError(msg)
 
     return content

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,8 +24,10 @@ 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 UartLogging
 from shepherd_core.data_models.testbed import Testbed
 from shepherd_core.data_models.testbed.cape import TargetPort
+from shepherd_core.logger import logger
 
 
 class Compression(str, Enum):
@@ -61,16 +64,16 @@ 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
     # ⤷ Use default calibration values, skip loading from EEPROM
 
-    enable_io: bool = False
+    enable_io: bool = True
     # TODO: add direction of pins! also it seems error-prone when only setting _tracing
     # ⤷ Switch the GPIO level converter to targets on/off
-    #   pre-req for sampling gpio,
+    #   pre-req for sampling gpio / uart,
     io_port: TargetPort = TargetPort.A
     # ⤷ Either Port A or B that gets connected to IO
     pwr_port: TargetPort = TargetPort.A
@@ -89,6 +92,7 @@ class EmulationTask(ShpModel):
 
     power_tracing: Optional[PowerTracing] = PowerTracing()
     gpio_tracing: Optional[GpioTracing] = GpioTracing()
+    uart_logging: Optional[UartLogging] = UartLogging()
     gpio_actuation: Optional[GpioActuation] = None
     sys_logging: Optional[SystemLogging] = SystemLogging()
 
@@ -127,6 +131,14 @@ class EmulationTask(ShpModel):
             raise ValueError("Voltage Aux must be in float (0 - 4.5) or string 'main' / 'mid'.")
         if self.gpio_actuation is not None:
             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_logging)
+        )
+        if self.enable_io and not io_requested:
+            logger.warning("Target IO enabled, but no feature requested IO")
+        if not self.enable_io and io_requested:
+            logger.warning("Target IO not enabled, but a feature requested IO")
         return self
 
     @classmethod
@@ -134,19 +146,23 @@ class EmulationTask(ShpModel):
     def from_xp(cls, xp: Experiment, tb: Testbed, tgt_id: IdInt, root_path: Path) -> Self:
         obs = tb.get_observer(tgt_id)
         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_logging)
+        )
 
         return cls(
             input_path=tgt_cfg.energy_env.data_path,
             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=(tgt_cfg.gpio_tracing is not None) or (tgt_cfg.gpio_actuation is not None),
+            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_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
 
@@ -43,7 +44,8 @@ class ProgrammingTask(ShpModel):
     def post_validation(self) -> Self:
         d_type = suffix_to_DType.get(self.firmware_file.suffix.lower())
         if d_type != FirmwareDType.base64_hex:
-            raise ValueError("Firmware is not intel-.hex ('%s')", self.firmware_file.as_posix())
+            msg = (f"Firmware is not intel-hex ({self.firmware_file.as_posix()})",)
+            raise ValueError(msg)
         return self
 
     @classmethod

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/mcu_fixture.yaml

@@ -3,17 +3,17 @@
   parameters:
     id: 1001
     name: nRF52
-    description: Panasonic PAN1780, ENW-89854A1KF, Bluetooth 5 Low Energy Module
+    description: MCU with RF, 802.15.4, Bluetooth v5.0, 2.4GHz
     platform: nRF52
     core: nRF52840
     prog_protocol: SWD
-    fw_name_default: nrf52_demo_rf
+    fw_name_default: nrf52_deep_sleep
 - datatype: mcu
   parameters:
     id: 1002
     name: MSP430FR
-    description: 16MHz Ultra-Low-Pwr MCU with 128 KB FRAM
+    description: 16MHz Ultra-Low-Pwr MCU with 256 KB FRAM
     platform: MSP430
-    core: MSP430FR5962
+    core: MSP430FR5994
     prog_protocol: SBW
     fw_name_default: msp430_deep_sleep

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