rssdk 3.19

Rugged Science SDK Python Bindings

Python SDK

This is a wrapper around the Rugged Science SDK with the only difference being that exceptions are automatically thrown. There are no getLastError or getLastErrorString functions.

Installing

The package can be installed either by compiling the sources or installing via python -m pip install rssdk.

Dio Example

from rssdk import RsDio, OutputMode

dio = RsDio()
try:
    dio.setXmlFile("ecs9000.xml")
except Exception as e:
    print(e)
    exit(1)

dio.setOutputMode(1, OutputMode.ModeNpn)

dio.digitalRead(1, 1)
dio.digitalWrite(1, 11, True)

PoE Example

from rssdk import RsPoe, PoeState

poe = RsPoe()
try:
    poe.setXmlFile("ecs9000.xml")
except Exception as e:
    print(e)
    exit(1)

poe.getPortState(3)
poe.setPortState(PoeState.StateDisabled)

Compiling

The Python bindings are built against the standard C++ SDK libraries using pybind11. There are two ways to compile them. Either using Python's build system or by using cmake directly. Both options assume you have have already cloned the repository as shown in the step below.

NOTE: It is best to enable long paths in Windows when compiling using the Python build system.

git clone https://github.com/ruggedscience/SDK
cd SDK

Python Build

Using Python's build system is the recommended way to build the bindings. It will produce a wheel that can be installed using pip and handles the installation of the required build modules. It will install all of the modules inside an isolated virtual environment that will be deleted after compilation is finished.

1. Install the Python build module.

   python -m pip install build
   

2. Build the source distribution and wheel.

   python -m build
   

3. Install the newly built wheel.

   python -m pip install ./dist/<name of wheel file>.whl
   

Cmake build

The cmake build process isn't quite as straightforward but offers more flexibility. Since multiple dependencies are required it is suggested that you create a virtual environment for the build process to use. Note that the resulting package will be installed into that virtual environment. Information on how to do this can be found in the official Python docs.

1. Install requirements

   python -m pip install pybind11 setuptools_scm mypy
   

   Note: mypy is optional and used to generate stub files. This allows IDEs to offer code completion.

2. Create build folder

   mkdir build
   cd build
   

3. Configure cmake

   cmake -DBUILD_PYTHON_BINDINGS=ON -DINSTALL_PYTHON_BINDINGS=ON -DBUILD_SHARED_LIBS=OFF -DINSTALL_XML=OFF -DINSTALL_UTILITIES=OFF -DINSTALL_SDK=OFF ..
   

   Note: On Linux the build type should be set to release using -DBUILD_TYPE=Release.

4. Build and install

   cmake --build . --target install
   

   Note: On Windows the build type should be set to release using --config Release.