biosignal-device-interface 0.2.2__tar.gz → 0.2.4__tar.gz

{biosignal_device_interface-0.2.2 → biosignal_device_interface-0.2.4}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: biosignal-device-interface
-Version: 0.2.2
+Version: 0.2.4
 Summary: Python communication interface to many biosignal devices manufactured by several companies to easy integration in custom PySide6 applications.
-License: CC BY-SA 4.0
+License: GPL-3.0
 License-File: LICENSE
 Author: Dominik I. Braun
 Author-email: dome.braun@fau.de
 Requires-Python: >=3.10,<3.13
-Classifier: License :: Other/Proprietary License
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -34,10 +34,15 @@ Description-Content-Type: text/markdown
 <h3 align="center">Biosignal Device Interface</h3>
 
   <p align="center">
-    Python communication interface to many biosignal devices manufactured by several companies to easy integration in custom PySide6 applications.
+    Python communication interface to many biosignal devices manufactured by several companies for easy integration in custom PySide6 applications.
     <br />
     <a href="https://nsquaredlab.github.io/Biosignal-Device-Interface/"><strong>Explore the docs »</strong></a>
   </p>
+
+[![PyPI version](https://img.shields.io/pypi/v/biosignal-device-interface.svg)](https://pypi.org/project/biosignal-device-interface/)
+[![Python versions](https://img.shields.io/pypi/pyversions/biosignal-device-interface.svg)](https://pypi.org/project/biosignal-device-interface/)
+[![License](https://img.shields.io/badge/license-GPL--3.0-blue.svg)](LICENSE)
+
 </div>
 
 
@@ -46,19 +51,18 @@ Description-Content-Type: text/markdown
 <details>
   <summary>Table of Contents</summary>
   <ol>
-    <li>
-      <a href="#about-the-project">About The Project</a>
-    </li>
-    <li><a href="#contact">Contact</a></li>
+    <li><a href="#about-the-project">About The Project</a></li>
+    <li><a href="#supported-devices">Supported Devices</a></li>
     <li>
       <a href="#getting-started">Getting Started</a>
       <ul>
+        <li><a href="#installation">Installation</a></li>
         <li><a href="#development-installation">Development Installation</a></li>
-        <li><a href="#package-installation">Package Installation</a></li>
       </ul>
     </li>
     <li><a href="#usage">Usage</a></li>
     <li><a href="#license">License</a></li>
+    <li><a href="#contact">Contact</a></li>
     <li><a href="#acknowledgments">Acknowledgments</a></li>
   </ol>
 </details>
@@ -66,64 +70,68 @@ Description-Content-Type: text/markdown
 
 ## About The Project
 
-Give a brief introduction into the project.
+Biosignal Device Interface provides a unified Python API for communicating with biosignal acquisition devices from multiple manufacturers. It includes ready-to-use PySide6 widgets for device configuration and data streaming, making it easy to integrate biosignal acquisition into custom applications.
 
-<!-- CONTACT -->
-### Contact
-
- [Dominik I. Braun](https://www.nsquared.tf.fau.de/person/dominik-braun/) - dome.braun@fau.de
+## Supported Devices
 
-Project Link: [https://github.com/NsquaredLab/Biosignal-Device-Interface](https://github.com/NsquaredLab/Biosignal-Device-Interface)
+### OT Bioelettronica
+- **Quattrocento** - 400+ channel EMG/EEG amplifier
+- **Quattrocento Light** - Compact version of Quattrocento
+- **Muovi** - Wearable EMG sensor
+- **Muovi+** - Enhanced wearable EMG sensor
+- **SyncStation** - Multi-device synchronization hub (Muovi, Muovi+, Due+)
 
+### Other Devices
+- More devices coming soon...
 
 <!-- GETTING STARTED -->
 ## Getting Started
 
-The local set up is made using [Poetry](https://python-poetry.org/). You can install Poetry using the following command.
-Note: It is recommeded to install it globally.
-```bash
-pip install poetry
-```
+### Installation
 
-Then, you can install the dependencies in your work area using the following command:
+Install from PyPI:
 ```bash
-poetry install
+pip install biosignal-device-interface
 ```
 
-### Development installation
-If you want to contribute to the project, you can install the development dependencies using the following command:
+Or with Poetry:
 ```bash
-poetry install --with dev,docs
+poetry add biosignal-device-interface
 ```
 
-### Package Installation
-Poetry
-```Bash
-poetry add git+https://github.com/NsquaredLab/Biosignal-Device-Interface.git
-```
+### Development Installation
 
-PIP
-```sh
-pip install git+https://github.com/NsquaredLab/Biosignal-Device-Interface.git
-```
+Clone the repository and install with development dependencies:
 
+```bash
+git clone https://github.com/NsquaredLab/Biosignal-Device-Interface.git
+cd Biosignal-Device-Interface
+poetry install --with dev,docs
+```
 
 <!-- USAGE EXAMPLES -->
 ## Usage
 
 Examples of how you can use this package can be found in our [examples gallery](https://nsquaredlab.github.io/Biosignal-Device-Interface/auto_examples/index.html).
 
-
 <!-- LICENSE -->
 ## License
 
-Distributed under the GPL-3.0 license License. See `LICENSE.txt` for more information.
+Distributed under the GPL-3.0 License. See `LICENSE` for more information.
+
+<!-- CONTACT -->
+## Contact
+
+- [Dominik I. Braun](https://www.nsquared.tf.fau.de/person/dominik-braun/) - dome.braun@fau.de
+- [Raul C. Sîmpetru](https://www.nsquared.tf.fau.de/person/raul-simpetru/) - raul.simpetru@fau.de
+
+Project Link: [https://github.com/NsquaredLab/Biosignal-Device-Interface](https://github.com/NsquaredLab/Biosignal-Device-Interface)
 
 <!-- ACKNOWLEDGMENTS -->
 ## Acknowledgments
-* Find available Python and Matlab implementations of OT Bioelettronica's devices on their [website](https://otbioelettronica.it/en/download/). 
+* Find available Python and Matlab implementations of OT Bioelettronica's devices on their [website](https://otbioelettronica.it/en/download/).
 <br>
-Note: The example scripts does not provide you with the same level of utility for GUI implementations.
+Note: The example scripts do not provide you with the same level of utility for GUI implementations.
 
 <p align="right">(<a href="#readme-top">back to top</a>)</p>
 

biosignal_device_interface-0.2.4/README.md

@@ -0,0 +1,112 @@
+# Biosignal-Device-Interface
+
+<!-- PROJECT LOGO -->
+<br />
+<div align="center">
+  <a href="https://github.com/NsquaredLab/Biosignal-Device-Interface">
+    <img src="images/logo.png" alt="Logo" width="80" height="80">
+  </a>
+
+<h3 align="center">Biosignal Device Interface</h3>
+
+  <p align="center">
+    Python communication interface to many biosignal devices manufactured by several companies for easy integration in custom PySide6 applications.
+    <br />
+    <a href="https://nsquaredlab.github.io/Biosignal-Device-Interface/"><strong>Explore the docs »</strong></a>
+  </p>
+
+[![PyPI version](https://img.shields.io/pypi/v/biosignal-device-interface.svg)](https://pypi.org/project/biosignal-device-interface/)
+[![Python versions](https://img.shields.io/pypi/pyversions/biosignal-device-interface.svg)](https://pypi.org/project/biosignal-device-interface/)
+[![License](https://img.shields.io/badge/license-GPL--3.0-blue.svg)](LICENSE)
+
+</div>
+
+
+
+<!-- TABLE OF CONTENTS -->
+<details>
+  <summary>Table of Contents</summary>
+  <ol>
+    <li><a href="#about-the-project">About The Project</a></li>
+    <li><a href="#supported-devices">Supported Devices</a></li>
+    <li>
+      <a href="#getting-started">Getting Started</a>
+      <ul>
+        <li><a href="#installation">Installation</a></li>
+        <li><a href="#development-installation">Development Installation</a></li>
+      </ul>
+    </li>
+    <li><a href="#usage">Usage</a></li>
+    <li><a href="#license">License</a></li>
+    <li><a href="#contact">Contact</a></li>
+    <li><a href="#acknowledgments">Acknowledgments</a></li>
+  </ol>
+</details>
+
+
+## About The Project
+
+Biosignal Device Interface provides a unified Python API for communicating with biosignal acquisition devices from multiple manufacturers. It includes ready-to-use PySide6 widgets for device configuration and data streaming, making it easy to integrate biosignal acquisition into custom applications.
+
+## Supported Devices
+
+### OT Bioelettronica
+- **Quattrocento** - 400+ channel EMG/EEG amplifier
+- **Quattrocento Light** - Compact version of Quattrocento
+- **Muovi** - Wearable EMG sensor
+- **Muovi+** - Enhanced wearable EMG sensor
+- **SyncStation** - Multi-device synchronization hub (Muovi, Muovi+, Due+)
+
+### Other Devices
+- More devices coming soon...
+
+<!-- GETTING STARTED -->
+## Getting Started
+
+### Installation
+
+Install from PyPI:
+```bash
+pip install biosignal-device-interface
+```
+
+Or with Poetry:
+```bash
+poetry add biosignal-device-interface
+```
+
+### Development Installation
+
+Clone the repository and install with development dependencies:
+
+```bash
+git clone https://github.com/NsquaredLab/Biosignal-Device-Interface.git
+cd Biosignal-Device-Interface
+poetry install --with dev,docs
+```
+
+<!-- USAGE EXAMPLES -->
+## Usage
+
+Examples of how you can use this package can be found in our [examples gallery](https://nsquaredlab.github.io/Biosignal-Device-Interface/auto_examples/index.html).
+
+<!-- LICENSE -->
+## License
+
+Distributed under the GPL-3.0 License. See `LICENSE` for more information.
+
+<!-- CONTACT -->
+## Contact
+
+- [Dominik I. Braun](https://www.nsquared.tf.fau.de/person/dominik-braun/) - dome.braun@fau.de
+- [Raul C. Sîmpetru](https://www.nsquared.tf.fau.de/person/raul-simpetru/) - raul.simpetru@fau.de
+
+Project Link: [https://github.com/NsquaredLab/Biosignal-Device-Interface](https://github.com/NsquaredLab/Biosignal-Device-Interface)
+
+<!-- ACKNOWLEDGMENTS -->
+## Acknowledgments
+* Find available Python and Matlab implementations of OT Bioelettronica's devices on their [website](https://otbioelettronica.it/en/download/).
+<br>
+Note: The example scripts do not provide you with the same level of utility for GUI implementations.
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>

{biosignal_device_interface-0.2.2 → biosignal_device_interface-0.2.4}/biosignal_device_interface/gui/device_template_widgets/core/base_multiple_devices_widget.py

@@ -50,6 +50,23 @@ class BaseMultipleDevicesWidget(QWidget):
         self.device_stacked_widget = self.ui.deviceStackedWidget
         self.device_selection_combo_box = self.ui.deviceSelectionComboBox
 
+        # Sync external scrollbar with scroll area's internal scrollbar
+        internal_scrollbar = self.ui.deviceScrollArea.verticalScrollBar()
+        external_scrollbar = self.ui.deviceScrollBar
+
+        # Sync scrollbar values bidirectionally
+        internal_scrollbar.valueChanged.connect(external_scrollbar.setValue)
+        external_scrollbar.valueChanged.connect(internal_scrollbar.setValue)
+
+        # Sync scrollbar range and visibility when content changes
+        def update_scrollbar_range(min_val: int, max_val: int):
+            external_scrollbar.setRange(min_val, max_val)
+            external_scrollbar.setVisible(max_val > min_val)
+
+        internal_scrollbar.rangeChanged.connect(update_scrollbar_range)
+        # Initialize visibility
+        external_scrollbar.setVisible(internal_scrollbar.maximum() > internal_scrollbar.minimum())
+
     def get_device_information(self) -> Dict[str, Union[str, int]]:
         return self._get_current_widget().get_device_information()
 

{biosignal_device_interface-0.2.2 → biosignal_device_interface-0.2.4}/biosignal_device_interface/gui/device_template_widgets/otb/otb_muovi_plus_widget.py

@@ -50,12 +50,15 @@ class OTBMuoviPlusWidget(BaseDeviceWidget):
             self.connect_push_button.setText("Disconnect")
             self.connect_push_button.setChecked(True)
             self.configure_push_button.setEnabled(True)
+            self.configure_push_button.setToolTip("Step 2: Configure device settings")
             self.connection_group_box.setEnabled(False)
         else:
             self.connect_push_button.setText("Connect")
             self.connect_push_button.setChecked(False)
             self.configure_push_button.setEnabled(False)
+            self.configure_push_button.setToolTip("Step 2: Configure device settings (connect first)")
             self.stream_push_button.setEnabled(False)
+            self.stream_push_button.setToolTip("Step 3: Start data streaming (configure first)")
             self.connection_group_box.setEnabled(True)
 
         self.connect_toggled.emit(is_connected)
@@ -73,6 +76,7 @@ class OTBMuoviPlusWidget(BaseDeviceWidget):
     def _configuration_toggled(self, is_configured: bool) -> None:
         if is_configured:
             self.stream_push_button.setEnabled(True)
+            self.stream_push_button.setToolTip("Step 3: Start data streaming")
 
         self.configure_toggled.emit(is_configured)
 
@@ -112,16 +116,19 @@ class OTBMuoviPlusWidget(BaseDeviceWidget):
         # Command Push Buttons
         self.connect_push_button: QPushButton = self.ui.commandConnectionPushButton
         self.connect_push_button.clicked.connect(self._toggle_connection)
+        self.connect_push_button.setToolTip("Step 1: Connect to the Muovi+ device")
         self._device.connect_toggled.connect(self._connection_toggled)
 
         self.configure_push_button: QPushButton = self.ui.commandConfigurationPushButton
         self.configure_push_button.clicked.connect(self._toggle_configuration)
         self.configure_push_button.setEnabled(False)
+        self.configure_push_button.setToolTip("Step 2: Configure device settings (connect first)")
         self._device.configure_toggled.connect(self._configuration_toggled)
 
         self.stream_push_button: QPushButton = self.ui.commandStreamPushButton
         self.stream_push_button.clicked.connect(self._toggle_stream)
         self.stream_push_button.setEnabled(False)
+        self.stream_push_button.setToolTip("Step 3: Start data streaming (configure first)")
         self._device.stream_toggled.connect(self._stream_toggled)
 
         # Connection parameters
@@ -148,9 +155,18 @@ class OTBMuoviPlusWidget(BaseDeviceWidget):
         # Input parameters
         self.input_parameters_group_box: QGroupBox = self.ui.inputGroupBox
         self.input_working_mode_combo_box: QComboBox = self.ui.inputWorkingModeComboBox
+        self.input_working_mode_combo_box.setToolTip(
+            "EMG: Electromyography for muscle signals\nEEG: Electroencephalography for brain signals"
+        )
         self.input_detection_mode_combo_box: QComboBox = (
             self.ui.inputDetectionModeComboBox
         )
+        self.input_detection_mode_combo_box.setToolTip(
+            "High Gain: Better for weak signals\nLow Gain: Better for strong signals\nImpedance Check: Verify electrode contact"
+        )
+
+        # Add tooltip for update button
+        self.connection_update_push_button.setToolTip("Refresh available device IP addresses")
 
         # Configuration parameters
         self.configuration_group_boxes: list[QGroupBox] = [

{biosignal_device_interface-0.2.2 → biosignal_device_interface-0.2.4}/biosignal_device_interface/gui/device_template_widgets/otb/otb_muovi_widget.py

@@ -50,12 +50,15 @@ class OTBMuoviWidget(BaseDeviceWidget):
             self.connect_push_button.setText("Disconnect")
             self.connect_push_button.setChecked(True)
             self.configure_push_button.setEnabled(True)
+            self.configure_push_button.setToolTip("Step 2: Configure device settings")
             self.connection_group_box.setEnabled(False)
         else:
             self.connect_push_button.setText("Connect")
             self.connect_push_button.setChecked(False)
             self.configure_push_button.setEnabled(False)
+            self.configure_push_button.setToolTip("Step 2: Configure device settings (connect first)")
             self.stream_push_button.setEnabled(False)
+            self.stream_push_button.setToolTip("Step 3: Start data streaming (configure first)")
             self.connection_group_box.setEnabled(True)
 
         self.connect_toggled.emit(is_connected)
@@ -73,6 +76,7 @@ class OTBMuoviWidget(BaseDeviceWidget):
     def _configuration_toggled(self, is_configured: bool) -> None:
         if is_configured:
             self.stream_push_button.setEnabled(True)
+            self.stream_push_button.setToolTip("Step 3: Start data streaming")
 
         self.configure_toggled.emit(is_configured)
 
@@ -112,16 +116,19 @@ class OTBMuoviWidget(BaseDeviceWidget):
         # Command Push Buttons
         self.connect_push_button: QPushButton = self.ui.commandConnectionPushButton
         self.connect_push_button.clicked.connect(self._toggle_connection)
+        self.connect_push_button.setToolTip("Step 1: Connect to the Muovi device")
         self._device.connect_toggled.connect(self._connection_toggled)
 
         self.configure_push_button: QPushButton = self.ui.commandConfigurationPushButton
         self.configure_push_button.clicked.connect(self._toggle_configuration)
         self.configure_push_button.setEnabled(False)
+        self.configure_push_button.setToolTip("Step 2: Configure device settings (connect first)")
         self._device.configure_toggled.connect(self._configuration_toggled)
 
         self.stream_push_button: QPushButton = self.ui.commandStreamPushButton
         self.stream_push_button.clicked.connect(self._toggle_stream)
         self.stream_push_button.setEnabled(False)
+        self.stream_push_button.setToolTip("Step 3: Start data streaming (configure first)")
         self._device.stream_toggled.connect(self._stream_toggled)
 
         # Connection parameters
@@ -148,9 +155,18 @@ class OTBMuoviWidget(BaseDeviceWidget):
         # Input parameters
         self.input_parameters_group_box: QGroupBox = self.ui.inputGroupBox
         self.input_working_mode_combo_box: QComboBox = self.ui.inputWorkingModeComboBox
+        self.input_working_mode_combo_box.setToolTip(
+            "EMG: Electromyography for muscle signals\nEEG: Electroencephalography for brain signals"
+        )
         self.input_detection_mode_combo_box: QComboBox = (
             self.ui.inputDetectionModeComboBox
         )
+        self.input_detection_mode_combo_box.setToolTip(
+            "High Gain: Better for weak signals\nLow Gain: Better for strong signals\nImpedance Check: Verify electrode contact"
+        )
+
+        # Add tooltip for update button
+        self.connection_update_push_button.setToolTip("Refresh available device IP addresses")
 
         # Configuration parameters
         self.configuration_group_boxes: list[QGroupBox] = [

{biosignal_device_interface-0.2.2 → biosignal_device_interface-0.2.4}/biosignal_device_interface/gui/device_template_widgets/otb/otb_quattrocento_light_widget.py

@@ -48,12 +48,15 @@ class OTBQuattrocentoLightWidget(BaseDeviceWidget):
             self._connect_push_button.setText("Disconnect")
             self._connect_push_button.setChecked(True)
             self._configure_push_button.setEnabled(True)
+            self._configure_push_button.setToolTip("Step 2: Configure device settings")
             self._connection_group_box.setEnabled(False)
         else:
             self._connect_push_button.setText("Connect")
             self._connect_push_button.setChecked(False)
             self._configure_push_button.setEnabled(False)
+            self._configure_push_button.setToolTip("Step 2: Configure device settings (connect first)")
             self._stream_push_button.setEnabled(False)
+            self._stream_push_button.setToolTip("Step 3: Start data streaming (configure first)")
             self._connection_group_box.setEnabled(True)
 
         self.connect_toggled.emit(is_connected)
@@ -81,6 +84,7 @@ class OTBQuattrocentoLightWidget(BaseDeviceWidget):
     def _configuration_toggled(self, is_configured: bool) -> None:
         if is_configured:
             self._stream_push_button.setEnabled(True)
+            self._stream_push_button.setToolTip("Step 3: Start data streaming")
 
         self.configure_toggled.emit(is_configured)
 
@@ -121,6 +125,7 @@ class OTBQuattrocentoLightWidget(BaseDeviceWidget):
         # Command Push Buttons
         self._connect_push_button: QPushButton = self.ui.commandConnectionPushButton
         self._connect_push_button.clicked.connect(self._toggle_connection)
+        self._connect_push_button.setToolTip("Step 1: Connect to the Quattrocento Light device")
         self._device.connect_toggled.connect(self._connection_toggled)
 
         self._configure_push_button: QPushButton = (
@@ -128,11 +133,13 @@ class OTBQuattrocentoLightWidget(BaseDeviceWidget):
         )
         self._configure_push_button.clicked.connect(self._toggle_configuration)
         self._configure_push_button.setEnabled(False)
+        self._configure_push_button.setToolTip("Step 2: Configure device settings (connect first)")
         self._device.configure_toggled.connect(self._configuration_toggled)
 
         self._stream_push_button: QPushButton = self.ui.commandStreamPushButton
         self._stream_push_button.clicked.connect(self._toggle_stream)
         self._stream_push_button.setEnabled(False)
+        self._stream_push_button.setToolTip("Step 3: Start data streaming (configure first)")
         self._device.stream_toggled.connect(self._stream_toggled)
 
         # Connection parameters

{biosignal_device_interface-0.2.2 → biosignal_device_interface-0.2.4}/biosignal_device_interface/gui/device_template_widgets/otb/otb_quattrocento_widget.py

@@ -70,12 +70,15 @@ class OTBQuattrocentoWidget(BaseDeviceWidget):
             self._connect_push_button.setText("Disconnect")
             self._connect_push_button.setChecked(True)
             self._configure_push_button.setEnabled(True)
+            self._configure_push_button.setToolTip("Step 2: Configure device settings")
             self._connection_group_box.setEnabled(False)
         else:
             self._connect_push_button.setText("Connect")
             self._connect_push_button.setChecked(False)
             self._configure_push_button.setEnabled(False)
+            self._configure_push_button.setToolTip("Step 2: Configure device settings (connect first)")
             self._stream_push_button.setEnabled(False)
+            self._stream_push_button.setToolTip("Step 3: Start data streaming (configure first)")
             self._connection_group_box.setEnabled(True)
 
         self.connect_toggled.emit(is_connected)
@@ -131,6 +134,7 @@ class OTBQuattrocentoWidget(BaseDeviceWidget):
     def _configuration_toggled(self, is_configured: bool) -> None:
         if is_configured:
             self._stream_push_button.setEnabled(True)
+            self._stream_push_button.setToolTip("Step 3: Start data streaming")
 
         self.configure_toggled.emit(is_configured)
 
@@ -174,6 +178,7 @@ class OTBQuattrocentoWidget(BaseDeviceWidget):
         # Command Push Buttons
         self._connect_push_button: QPushButton = self.ui.commandConnectionPushButton
         self._connect_push_button.clicked.connect(self._toggle_connection)
+        self._connect_push_button.setToolTip("Step 1: Connect to the Quattrocento device")
         self._device.connect_toggled.connect(self._connection_toggled)
 
         self._configure_push_button: QPushButton = (
@@ -181,11 +186,13 @@ class OTBQuattrocentoWidget(BaseDeviceWidget):
         )
         self._configure_push_button.clicked.connect(self._toggle_configuration)
         self._configure_push_button.setEnabled(False)
+        self._configure_push_button.setToolTip("Step 2: Configure device settings (connect first)")
         self._device.configure_toggled.connect(self._configuration_toggled)
 
         self._stream_push_button: QPushButton = self.ui.commandStreamPushButton
         self._stream_push_button.clicked.connect(self._toggle_stream)
         self._stream_push_button.setEnabled(False)
+        self._stream_push_button.setToolTip("Step 3: Start data streaming (configure first)")
         self._device.stream_toggled.connect(self._stream_toggled)
 
         # Connection parameters
@@ -214,18 +221,33 @@ class OTBQuattrocentoWidget(BaseDeviceWidget):
         self._acquisition_sampling_frequency_combo_box: QComboBox = (
             self.ui.acquisitionSamplingFrequencyComboBox
         )
+        self._acquisition_sampling_frequency_combo_box.setToolTip(
+            "Higher frequencies capture more detail but generate more data"
+        )
         self._acquisition_number_of_channels_combo_box: QComboBox = (
             self.ui.acquisitionNumberOfChannelsComboBox
         )
+        self._acquisition_number_of_channels_combo_box.setToolTip(
+            "Number of EMG channels to record from"
+        )
         self._acquisition_decimator_check_box: QCheckBox = (
             self.ui.acquisitionDecimatorCheckBox
         )
+        self._acquisition_decimator_check_box.setToolTip(
+            "Reduce sampling rate by averaging samples (reduces data size)"
+        )
         self._acquisition_recording_check_box: QCheckBox = (
             self.ui.acquisitionRecordingCheckBox
         )
+        self._acquisition_recording_check_box.setToolTip(
+            "Enable on-device recording to SD card"
+        )
 
         # Grid selection
         self._grid_selection_group_box: QGroupBox = self.ui.gridSelectionGroupBox
+        self._grid_selection_group_box.setToolTip(
+            "Select which electrode grids to use for recording"
+        )
         self._grid_selection_check_box_list: list[QCheckBox] = [
             self.ui.gridOneCheckBox,
             self.ui.gridTwoCheckBox,
@@ -244,14 +266,23 @@ class OTBQuattrocentoWidget(BaseDeviceWidget):
         self._input_group_box: QGroupBox = self.ui.inputGroupBox
         self._input_channel_combo_box: QComboBox = self.ui.inputChannelComboBox
         self._input_low_pass_filter_combo_box: QComboBox = self.ui.inputLowPassComboBox
+        self._input_low_pass_filter_combo_box.setToolTip(
+            "Low-pass filter removes high-frequency noise"
+        )
         self._input_low_pass_default = self.ui.inputLowPassComboBox.currentIndex()
         self._input_high_pass_filter_combo_box: QComboBox = (
             self.ui.inputHighPassComboBox
         )
+        self._input_high_pass_filter_combo_box.setToolTip(
+            "High-pass filter removes low-frequency drift and motion artifacts"
+        )
         self._input_high_pass_default = self.ui.inputHighPassComboBox.currentIndex()
         self._input_detection_mode_combo_box: QComboBox = (
             self.ui.inputDetectionModeComboBox
         )
+        self._input_detection_mode_combo_box.setToolTip(
+            "Monopolar: Each electrode vs reference\nDifferential: Difference between adjacent electrodes"
+        )
 
         self._configuration_group_boxes: list[QGroupBox] = [
             self._acquisition_group_box,

{biosignal_device_interface-0.2.2 → biosignal_device_interface-0.2.4}/biosignal_device_interface/gui/device_template_widgets/otb/otb_syncstation_widget.py

@@ -59,12 +59,15 @@ class OTBSyncStationWidget(BaseDeviceWidget):
             self._command_connect_push_button.setText("Disconnect")
             self._command_connect_push_button.setChecked(True)
             self._command_configure_push_button.setEnabled(True)
+            self._command_configure_push_button.setToolTip("Step 2: Configure device settings")
             self._connection_group_box.setEnabled(False)
         else:
             self._command_connect_push_button.setText("Connect")
             self._command_connect_push_button.setChecked(False)
             self._command_configure_push_button.setEnabled(False)
+            self._command_configure_push_button.setToolTip("Step 2: Configure device settings (connect first)")
             self._command_stream_push_button.setEnabled(False)
+            self._command_stream_push_button.setToolTip("Step 3: Start data streaming (configure first)")
             self._connection_group_box.setEnabled(True)
 
         self.connect_toggled.emit(is_connected)
@@ -94,6 +97,7 @@ class OTBSyncStationWidget(BaseDeviceWidget):
     def _configuration_toggled(self, is_configured: bool) -> None:
         if is_configured:
             self._command_stream_push_button.setEnabled(True)
+            self._command_stream_push_button.setToolTip("Step 3: Start data streaming")
 
         self.configure_toggled.emit(is_configured)
 
@@ -156,6 +160,7 @@ class OTBSyncStationWidget(BaseDeviceWidget):
             self.ui.commandConnectionPushButton
         )
         self._command_connect_push_button.clicked.connect(self._toggle_connection)
+        self._command_connect_push_button.setToolTip("Step 1: Connect to the SyncStation device")
         self._device.connect_toggled.connect(self._connection_toggled)
 
         self._command_configure_push_button: QPushButton = (
@@ -163,11 +168,13 @@ class OTBSyncStationWidget(BaseDeviceWidget):
         )
         self._command_configure_push_button.clicked.connect(self._toggle_configuration)
         self._command_configure_push_button.setEnabled(False)
+        self._command_configure_push_button.setToolTip("Step 2: Configure device settings (connect first)")
         self._device.configure_toggled.connect(self._configuration_toggled)
 
         self._command_stream_push_button: QPushButton = self.ui.commandStreamPushButton
         self._command_stream_push_button.clicked.connect(self._toggle_stream)
         self._command_stream_push_button.setEnabled(False)
+        self._command_stream_push_button.setToolTip("Step 3: Start data streaming (configure first)")
         self._device.stream_toggled.connect(self._stream_toggled)
 
         # Connection Paramters