naneos-devices 1.0.62

naneos particle solutions gmbh python backend

naneos-devices

This repository contains a collection of Python scripts and utilities for our naneos particle solutions measurement devices. These scripts will provide various functionalities related to data acquisition, analysis, and visualization for your measurement devices.

Installation

You can install the naneos-devices package using pip. Make sure you have Python 3.10 or higher installed. Open a terminal and run the following command:

pip install naneos-devices

Usage

To establish a serial connection with the Partector2 device and retrieve data, you can use the following code snippet as a starting point:

import time

from naneos.partector import Partector1, Partector2, Partector2Pro, scan_for_serial_partectors

PROD_NAMES = ["P1", "P2", "P2pro"]

# Lists all available Partector devices
partectors = scan_for_serial_partectors()
# print eg.: {'P1': {}, 'P2': {8112: '/dev/cu.usbmodemDOSEMet_1'}, 'P2pro': {}, 'P2proCS': {}}
print(partectors)

for prod in PROD_NAMES:
    if len(partectors[prod]) > 0:
        for k, v in partectors[prod].items():
            print(f"Found {prod} wit serial number {k} on port {v}")
            if prod == "P1":
                dev = Partector1(serial_number=k)
            elif prod == "P2":
                dev = Partector2(serial_number=k)
            elif prod == "P2pro":
                dev = Partector2Pro(serial_number=k)
            else:
                raise ValueError(f"Unknown product name: {prod}")

            df = dev.get_data_pandas()
            max_wait_time = time.time() + 15
            while df.empty and time.time() < max_wait_time:
                time.sleep(0.5)
                df = dev.get_data_pandas()

            print(df)
            dev.close()

Make sure to modify the code according to your specific requirements. Refer to the documentation and comments within the code for detailed explanations and usage instructions.

Documentation

The documentation for the naneos-devices package can be found in the package's documentation page.

Protobuf

Use this command to create a py and pyi file from the proto file

protoc -I=. --python_out=. --pyi_out=. ./protoV1.proto 

Testing

I recommend working with uv. Testing with the local python venv in vscode GUI or with:

uv run --env-file .env pytest

Testing every supported python version:

nox -s tests

Building executables

Sometimes you want to build an executable for a customer with you custom script. The build must happen on the same OS as the target OS. For example if you want to build an executable for windows you need to build it on Windows.

pyinstaller demo/p1UploadTool.py  --console --noconfirm --clean --onefile

Ideas for future development

• P2 BLE implementation that integrates into the implementation of the serial P2
• P2 Bidirectional Implementation that allows to send commands to the P2
• Automatically activate Bluetooth or ask when BLE is used

Contributing

Contributions are welcome! If you encounter any issues or have suggestions for improvements, please submit an issue on the issue tracker.

Please make sure to adhere to the coding style and conventions used in the repository and provide appropriate tests and documentation for your changes.

License

This repository is licensed under the MIT License.

Contact

For any questions, suggestions, or collaborations, please feel free to contact the project maintainer:

• Mario Huegi
• Contact: [e-mail]
• Github