Repository Summary
Checkout URI | https://github.com/umdlife/psdk_ros2.git |
VCS Type | git |
VCS Version | main |
Last Updated | 2024-11-22 |
Dev Status | MAINTAINED |
CI status | No Continuous Integration |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Packages
Name | Version |
---|---|
psdk_interfaces | 1.3.2 |
psdk_wrapper | 1.3.2 |
README
psdk_ros2
psdk_ros2 is an open-source ROS 2 wrapper that brings DJI’s Payload-SDK libraries capabilities into the robotics ecosystem. You can find all the wrapper’s documentation at https://umdlife.github.io/psdk_ros2.
Features
The psdk_ros2
wrapper currently supports the following features:
-
Starting and Initializing PSDK Applications:
psdk_ros2
allows you to initiate and configure a PSDK application from within ROS 2. - Subscription to DJI Main Topics: You can easily subscribe to the main topics provided by DJI, getting access to essential data and information.
-
Frequency Control for Topic Subscription:
psdk_ros2
offers the capability to set the frequency of topic subscriptions, allowing you to tailor data retrieval as per your requirements. -
Copter Position and Velocity Commands: With
psdk_ros2
, you can conveniently send position and velocity commands to control a copter’s movement. -
Camera Parameters Management:
psdk_ros2
provides functionalities to retrieve and update the main parameters of a mounted camera, giving you control over the camera settings. - Gimbal Parameters Control: You can manipulate gimbal parameters, adjusting the gimbal’s orientation and behavior.
Compatibility
The current version supports PSDK v3.8.1 and it has been tested and built for ROS 2 Humble. For firmware and product compatibility, please check the page DJI Developer - PSDK.
In terms of hardware used for testing this wrapper, our primary testing platform has been the DJI M300 RTK drone, to which an external board has been connected via the OSDK expansion module. As for the payloads, H20 and H20T cameras have been tested.
Please notice that this wrapper is still a work in progress. While we aim to make it as generic as possible, compatibility with different setups may require code modifications and testing to ensure proper functionality. Before deploying this wrapper with alternative hardware or configurations, we recommend thoroughly reviewing and understanding the codebase, configuration files, and documentation.
License
psdk_ros2
wrapper is under the Mozilla Public License Version 2.0.
Please note that the DJI Payload-SDK libraries which are needed to run this wrapper use MIT License.