ekfsm 1.4.0a37__py3-none-any.whl → 1.4.0a42__py3-none-any.whl

ekfsm/core/utils.py

@@ -88,6 +88,7 @@ _device_structure = Schema(
         Optional("slot_coding_mask"): int,
         Optional("channel_id"): int,
         Optional("service_suffix"): str,
+        Optional("keepaliveInterval"): int,
         Optional("provides"): {
             Optional(str): [Use(provides_validator)],
         },

ekfsm/devices/button.py

@@ -4,7 +4,7 @@ from ekfsm.devices.generic import Device
 
 class Button(Device):
     """
-    Device class for handling a button array.
+    Device class for handling a single button as part on array.
     """
 
     def __init__(
@@ -35,6 +35,11 @@ class Button(Device):
     def handler(self, func: Callable | None, *args, **kwargs):
         """
         Handle button events with a callback function.
+
+        Parameters
+        ----------
+        func : Callable | None
+            The function to call on button events. If None, no function is called.
         """
         if callable(func):
             self._handler = func

ekfsm/devices/buttonArray.py

@@ -8,7 +8,13 @@ import io4edge_client.functionblock as fb
 
 class ButtonArray(Device):
     """
-    Device class for handling a button array.
+    Device class for handling an io4edge button array.
+
+    To read button events, call the `read` method in a separate thread.
+
+    Note
+    ----
+        Button handlers are called in the context of the `read` method's thread and need to be set in the Button instances.
     """
 
     def __init__(
@@ -18,6 +24,7 @@ class ButtonArray(Device):
         children: list[Device] | None = None,
         abort: bool = False,
         service_suffix: str | None = None,
+        keepaliveInterval: int = 10000,
         *args,
         **kwargs,
     ):
@@ -33,12 +40,14 @@ class ButtonArray(Device):
 
         self.service_addr = f"{parent.deviceId}-{self.service_suffix}"
 
-        self.client = binio.Client(self.service_addr)
+        self.client = binio.Client(
+            self.service_addr, command_timeout=keepaliveInterval / 1000 + 5
+        )
 
         self.subscriptionType = binio.Pb.SubscriptionType.BINARYIOTYPEB_ON_RISING_EDGE
         self.stream_cfg = fb.Pb.StreamControlStart(
             bucketSamples=1,  # 1 sample per bucket, also ein event pro bucket
-            keepaliveInterval=10000,  # rueckmeldung auch ohne events alle 10 Sekunden
+            keepaliveInterval=keepaliveInterval,
             bufferedSamples=2,  # 2 samples werden gepuffert
             low_latency_mode=True,  # schickt soweit moeglich sofort die Events
         )
@@ -46,6 +55,17 @@ class ButtonArray(Device):
     def read(self, stop_event: threading.Event | None = None, timeout: float = 0.1):
         """
         Read all button events and dispatch to handlers.
+
+        Parameters
+        ----------
+        stop_event : threading.Event, optional
+            Event to signal stopping the reading loop. If None, the loop will run indefinitely.
+        timeout : float, optional
+            Timeout for reading from the stream in seconds. Default is 0.1 seconds.
+
+        Note
+        ----
+            This method blocks and should be run in a separate thread.
         """
         self.client.start_stream(
             binio.Pb.StreamControlStart(

ekfsm/devices/colorLed.py

@@ -32,18 +32,37 @@ class ColorLED(Device):
     def get(self) -> tuple[Color, bool]:
         """
         Get color LED state.
-        @raises RuntimeError: if the command fails
-        @raises TimeoutError: if the command times out
+
+        Returns
+        -------
+            Current color and blink state.
+
+        Raises
+        ------
+        RuntimeError
+            if the command fails
+        TimeoutError
+            if the command times out
         """
         return self.client.get(self.channel_id)
 
     def set(self, color: Color, blink: bool) -> None:
         """
         Set the color of the color LED.
-        @param Color: The color to set the LED to.
-        @param blink: Whether to blink the LED.
-        @raises RuntimeError: if the command fails
-        @raises TimeoutError: if the command times out
+
+        Parameters
+        ----------
+        color : Color
+            The color to set the LED to.
+        blink : bool
+            Whether to blink the LED.
+
+        Raises
+        ------
+        RuntimeError
+            if the command fails
+        TimeoutError
+            if the command times out
         """
         self.client.set(self.channel_id, color, blink)
 

ekfsm/devices/thermal_humidity.py

@@ -32,13 +32,18 @@ class ThermalHumidity(Device):
 
         self.client = Client(self.service_addr)
 
-    def __repr__(self):
-        return f"{self.name}; Service Address: {self.service_addr}"
-
     def temperature(self) -> float:
         """
         Get the temperature in Celsius.
-        @raises RuntimeError: if the command fails
-        @raises TimeoutError: if the command times out
+
+        Raises
+        ------
+        RuntimeError
+            if the command fails
+        TimeoutError
+            if the command times out
         """
         return self.client.value()
+
+    def __repr__(self):
+        return f"{self.name}; Service Address: {self.service_addr}"

ekfsm/devices/watchdog.py

@@ -5,7 +5,7 @@ from io4edge_client.watchdog import Client
 
 class Watchdog(Device):
     """
-    Device class for handling a color LED.
+    Device class for handling an application watchdog.
     """
 
     def __init__(
@@ -38,7 +38,15 @@ class Watchdog(Device):
     def kick(self) -> None:
         """
         Kick the watchdog.
-        @raises RuntimeError: if the command fails
-        @raises TimeoutError: if the command times out
+
+        Raises
+        ------
+        RuntimeError
+            if the command fails
+        TimeoutError
+            if the command times out
         """
         self.client.kick()
+
+    def __repr__(self):
+        return f"{self.name}; Service Address: {self.service_addr}"

{ekfsm-1.4.0a37.dist-info → ekfsm-1.4.0a42.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ekfsm
-Version: 1.4.0a37
+Version: 1.4.0a42
 Summary: The EKF System Management Library (ekfsm) is a sensor monitoring suite for Compact PCI Serial devices.
 Author-email: Jan Jansen <jan@ekf.de>, Klaus Popp <klaus.popp@ci4rail.com>, Felix Päßler <fp@ekf.de>
 Requires-Python: >=3.10

{ekfsm-1.4.0a37.dist-info → ekfsm-1.4.0a42.dist-info}/RECORD

@@ -25,11 +25,11 @@ ekfsm/core/components.py,sha256=iTetqtzNjEEj6FDJNfvXxW_cNNRlLX5_WgB5z3g3zqg,3883
 ekfsm/core/probe.py,sha256=DgJvkvMjVk09n0Rzn13ybRvidrmFn_D2PD56XS-KgxU,262
 ekfsm/core/slots.py,sha256=qmxfssVitsMFZYbJRCpOOsvEGqh8JVYdRS-_5BliOF4,6580
 ekfsm/core/sysfs.py,sha256=CWH1BXlanHAFzK6KY23qLuFvBZ7Q9td3X6JLRwb3vu0,7309
-ekfsm/core/utils.py,sha256=slSgFNmSvwWL5qlDQE9WXGv9u9skojlGtUM_B-WumsY,4634
+ekfsm/core/utils.py,sha256=AjVj_QCb9umUmZZsGFPyCISdOKYlhRRSOTVjPu_gxyA,4678
 ekfsm/devices/__init__.py,sha256=EDFzBuUHt_3_6JD4cageHWZfoMn3WUIIDZk4yEOWgfg,1451
-ekfsm/devices/button.py,sha256=tPGBWi2ZxZDQX_WojQG3lKdsKcCTXRYQjRwRjcIv460,1036
-ekfsm/devices/buttonArray.py,sha256=bKNstHsmc6SM09BaQiQV09wRbgnb5I6KK7JTgCk6PnU,2910
-ekfsm/devices/colorLed.py,sha256=PrA3WsuMs-vi2DxxsW4hRIJh_ZWqs_hW2QmFeijsCxA,1410
+ekfsm/devices/button.py,sha256=z3vzpTCY4ZweUd1M9_eJvepM7A-FchapdsaMz5RCUPE,1207
+ekfsm/devices/buttonArray.py,sha256=KOI7ycLY9RxXOpalCxJz4rOqSC7vp6dihIGkvl2BdXw,3603
+ekfsm/devices/colorLed.py,sha256=H0SFl0SkMHIV5Is31XQJfisDu2nmPh0TuWrtlhsi1bI,1622
 ekfsm/devices/coretemp.py,sha256=UEsPTMYm05qNCnqnPtbAoYdIfvVGkDl9rJg3tkAP748,1992
 ekfsm/devices/eeprom.py,sha256=cwcaM2YCKrw6du8d4zT_M3e4oFJh3XNQc5cQM2vqERE,33090
 ekfsm/devices/ekf_ccu_uc.py,sha256=hjs5r7TKsrFhyyGKClgSFBpchQpFcE7fTZeuLrYiflY,15905
@@ -46,10 +46,10 @@ ekfsm/devices/pixelDisplay.py,sha256=68SANN4S15_NncuDvu0hyjjdqhpxYn14cmxjXwfGqgU
 ekfsm/devices/pmbus.py,sha256=fi_kR7TlkcqYhHuB7PA2PjANCYmo3MSPeV-B5ZI_WrQ,7004
 ekfsm/devices/smbios.py,sha256=4P-sxOW27pkzIfVlvFNyVJOcZlYgk2KCTCEUvKf5D94,1067
 ekfsm/devices/smbus.py,sha256=kbtjEnfrVI6lbfqAbojVqO5nnnpa6HanLf0X2iZjgCg,500
-ekfsm/devices/thermal_humidity.py,sha256=OVr1zaCGGutfk1WYZ3509wx6qHqjjF2nFE9QYM_bWtE,1170
+ekfsm/devices/thermal_humidity.py,sha256=HnoiR3mZxwuE74KTFiRhG4Znq21vgcyMFJizSCnULzw,1207
 ekfsm/devices/utils.py,sha256=qeDNpTpQ3bLGYERAH5lMsifmOaEcQ32FOwEt8tvmjWU,174
-ekfsm/devices/watchdog.py,sha256=-us3IMKsvTR7LzRCszHR19q0jsCGPZUIN_FWN-h8844,1060
-ekfsm-1.4.0a37.dist-info/METADATA,sha256=fz_N76MjDbeGbpB1dHKlmzLEwLb_qLPC6ov2pKLFPQ4,6717
-ekfsm-1.4.0a37.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ekfsm-1.4.0a37.dist-info/entry_points.txt,sha256=WhUR4FzuxPoGrbTOKLsNJO7NAnk2qd4T30fqzN1yLw8,45
-ekfsm-1.4.0a37.dist-info/RECORD,,
+ekfsm/devices/watchdog.py,sha256=QjzvXrXV_XRvCYiy-sr6LOMJywb84aNThuDpsWGvxZk,1202
+ekfsm-1.4.0a42.dist-info/METADATA,sha256=Vhv_XchVBp-Kx6k3PU9LOocJRPH4deC8y0ghkG4bTRc,6717
+ekfsm-1.4.0a42.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ekfsm-1.4.0a42.dist-info/entry_points.txt,sha256=WhUR4FzuxPoGrbTOKLsNJO7NAnk2qd4T30fqzN1yLw8,45
+ekfsm-1.4.0a42.dist-info/RECORD,,