Skip to content

About

Python interface for PNDbotics SDK

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

42 Commits

Folders and files

Repository files navigation

Overview

Ubuntu Python CycloneDDS

Updated At Version Supported Robot License Issues

Lightweight Python bindings for PND SDK, supporting robot state acquisition and low‑level control via DDS communication.

✨ Features

  • Pythonic interface for PND LowCmd / LowState
  • Supports request–response and topic publish/subscribe
  • Works both with real robots and simulators

📋 Table of Contents

🛠 Installation

Dependencies

  • Python ≥ 3.8
  • cyclonedds == 0.10.2
  • numpy
  • opencv-python

Install from Source

cd ~
sudo apt install python3-pip
git clone https://github.com/pndbotics/pnd_sdk_python.git
cd pnd_sdk_python
pip3 install -e .

📖 Usage Examples

The Python sdk interface maintains consistency with the pnd_sdk interface, achieving robot status acquisition and control through request-response or topic subscription/publishing.

Example programs are located in:

/example

Ensure robot networking is configured correctly:
https://wiki.pndbotics.com

Open-arm Example

cd ~/pnd_sdk_python/example/low_level/adam_lite
python3 open_arm.py 

❓ FAQ

1. Error during installation:

Could not locate cyclonedds. Try to set CYCLONEDDS_HOME or CMAKE_PREFIX_PATH

Compile and install cyclonedds:

cd ~
git clone https://github.com/eclipse-cyclonedds/cyclonedds -b releases/0.10.x 
cd cyclonedds && mkdir build install && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=../install
cmake --build . --target install

Then install pnd_sdk_python:

cd ~/pnd_sdk_python
export CYCLONEDDS_HOME=~/cyclonedds/install
pip3 install -e .

More info: https://pypi.org/project/cyclonedds/#installing-with-pre-built-binaries

🤝 Contributing

Contributions are welcome.

Feel free to open issues or pull requests.

📄 License

BSD-3 Clause © PNDbotics

📖 Reference

📞 Contact

📜 Version Log

Version Date Updates
v1.2.0 2026-01-22 DDS refactoring version
v1.0.3 2025-12-10 - Add sp and lite
- Change wireless remote
- Add ddq and motor state
v1.0.2 2025-11-20 Add pd and add hand in example
v1.0.1 2025-11-11 Add hand support
v1.0.0 2025-11-07 Initial release

Website Twitter YouTube Bilibili

⭐ Star us on GitHub — it helps!

About

Python interface for PNDbotics SDK

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages