The DaaS-IoT SDK for Python offers a high-level interface for integrating the DaaS protocol into Python-based applications. It exposes a native extension module (pydaasiot) that bridges Python and the precompiled libdaas.a core library using pybind11.

This SDK enables Python developers to:

• Initialize and shut down DaaS nodes
• Enable and configure network drivers (e.g., INET4, BLUETOOTH)
• Map and manage logical addresses (DINs)
• Send and receive structured data (DDOs)
• Handle asynchronous protocol events using Python callback classes

Python-Specific Enhancements

Compared to the C++ Linux SDK, the Python binding introduces productivity-focused and Python-native improvements:

Native Event Callbacks

Python classes can override all protocol events (e.g., ddoReceivedEvent, nodeStateReceivedEvent)

Ready-to-use CLI

A typer-based command-line interface is included for rapid prototyping and manual testing

Virtual Environment Support

Fully compatible with venv, pip, and typical Python development workflows

No Manual Compilation Required

Once built, the .so extension is directly importable into any Python script or shell

System Requirements

Build Environment

Dependencies

• pybind11 – Will be detected automatically if installed system-wide, or via FetchContent
• libbluetooth – Only if Bluetooth driver is used

Supported Architectures

• x86_64
• aarch64 (ARM64)

Portability and Compatibility

Supported Platforms

• Python 3.9+ compatible
• x86_64 and ARM64 architectures (e.g., Raspberry Pi 3/4)
• Virtual environments – Fully usable inside venv or pipx
• Linux-based systems – Desktop machines, edge computing devices, embedded boards

Current Limitations

• Windows and macOS – Not tested in current release
• Linux-only support in current release

Python API Architecture

Core Classes

• DaasWrapper: High-level bridge between Python applications and the underlying DaaS protocol
• IDaasApiEvent: Base class for handling asynchronous protocol events

Data Handling

• DDOs (Distributed Data Objects): Treated as bytes objects in Python
• DINs (Device ID Numbers): Integer identifiers for logical addressing

Integration Features

• Object-oriented interface mirroring the C++ API
• Python-specific improvements like dynamic typing and idiomatic error handling
• Thread-safe callback execution with Python's GIL protection
• Non-blocking asynchronous event handling

Development Workflow

Build Process

1. Build the Python extension module pydaasiot using CMake
2. C++17-compliant compiler wraps the libdaas.a static library
3. Resulting .so file is exposed to Python via pybind11

Usage Pattern

• cd build
• PYTHONPATH=. python3 ../examples/receiver.py

Integration Model

• Console-based, script-driven, or service-based integration
• No interpreter-specific frameworks (Tkinter, Qt) required
• Designed for headless operation and containerized environments