Unlock Your Data Potential: A Deep Dive into the STMicroelectronics STDATALOG-PYSDK

Harness the power of seamless data acquisition, processing, and visualization with the STDATALOG-PYSDK, a Python powerhouse designed for data scientists and embedded designers. Compatible with Windows, Linux, and macOS systems, this Software Development Kit simplifies the complexities of working with sensor data, simulated signals, and more.

What is STDATALOG-PYSDK and Why Should You Use It?

The STDATALOG-PYSDK is a comprehensive Python framework engineered to streamline data logging tasks. It empowers you to:

• Capture Data: Effortlessly pull data from sensors, algorithms, simulated signals, and actuator telemetry.
• Process & Elaborate: Transform raw data into structured datasets ready for analysis.
• Visualize Insights: Create meaningful visualizations to unlock hidden patterns and trends.

This open and modular architecture makes the SDK adaptable to various projects. Transitioning from previous iterations like HSDPython_SDK from FP-SNS-DATALOG function packs is easy.

Key Benefits for Data Scientists and Embedded Designers

• Open and Modular Architecture: Tailor the SDK to your specific needs with its flexible design.
• Compatibility: Seamlessly integrates with popular data science toolchains (Python 3.10, 3.11, and 3.12 supported).
• Simplified Development: Speeds up application development that uses data from ST system solutions.
• Reusable Datasets: Organized data is compatible for usage across many projects and workflows.
• Cross-Platform Functionality: Designed for Windows, macOS, and Linux operating systems.

Getting Started: Installation Guide

Ready to dive in? Here's how to install the STDATALOG-PYSDK on your system:

1. Clone the Repository: Use the following command, ensuring you include the --recursive option to retrieve submodules:

   git clone --recursive https://github.com/STMicroelectronics/stdatalog-pysdk.git
   

   Copy

2. Navigate to the Root Directory: Open your terminal and navigate to the STDATALOG-PYSDK folder.

3. Create a Virtual Environment: This step is highly recommended for dependency isolation:

   python -m venv .venv
   

   Copy

4. Activate the Virtual Environment:

   • Windows: .venv\Scripts\activate
   • Linux/macOS: source .venv/bin/activate

5. Run the Installer: Execute the appropriate installation script for your operating system.

   • Windows: .\STDATALOG-PYSDK_install.bat

   • Linux/macOS: ./STDATALOG-PYSDK_install.sh

   • If you need to include a proxy server during the installation, use the following command. Remember to substitute special characters with their hex representation. For example, '&' becomes '%26':

     • ./STDATALOG-PYSDK_install.sh http://usr_name:password@proxyserver_name:port

6. Linux Only: Install USB Drivers:

   • Navigate into the linux_setup folder using the cd linux_setup command in the terminal.
   • Convert the included .sh and .rules files to the proper format. To do this, run the following commands:

   sudo apt-get install dos2unix
   dos2unix 30-hsdatalog.rules linux_USB_config_setup.sh linux_USB_config_removal.sh
   chmod 777 linux_USB_config_setup.sh linux_USB_config_removal.sh
   ./linux_USB_config_setup.sh
   

   Copy
   • Reboot your PC to ensure the new USB udev rules load correctly.

7. Run an Example Script

   • Linux/macOS: Activate the virtual environment by running ./.venv/bin/activate
   • Navigate into the stdatalog_examples folder using the cd stdatalog_examples command in the terminal.
   • Run the following command from the terminal:

   python gui_applications/stdatalog/GUI/stdatalog_GUI.py
   

   Copy

8. macOS Only: Install Homebrew (Skip this step if you already have Homebrew installed):

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

   Copy

Important Notes for macOS and Linux Users

• macOS: Versions prior to v1.1.0 are not compatible with macOS.

• Linux/macOS: The SDK is built in Windows. Using dos2unix to reformat files is recommended.

  • macOS: brew install dos2unix
  • Linux sudo apt-get install dos2unix
  • To convert the files for proper usage on macOS and Linux, run these commands:

  dos2unix STDATALOG-PYSDK_install.sh STDATALOG-PYSDK_install_noGUI.sh STDATALOG-PYSDK_uninstall.sh
  chmod +x STDATALOG-PYSDK_install.sh STDATALOG-PYSDK_install_noGUI.sh STDATALOG-PYSDK_uninstall.sh
  

  Copy

Supported Hardware

The STDATALOG-PYSDK supports a wide range of STMicroelectronics devices and boards, including but not limited to:

• STEVAL-STWINBX1
• STEVAL-STWINKT1B
• STEVAL-MKBOXPRO
• B-U585I-IOT02A
• X-NUCLEO-IKS02A1 with NUCLEO-U575ZI-Q
• EVLSPIN32G4-ACT

Maximize Your Data Projects with STDATALOG-PYSDK

With its robust features and ease of use, the STDATALOG-PYSDK Python software development kit is your key to unlocking the full potential of your data-driven projects. Start exploring its capabilities today!