dji-sdk / Guidance-SDK

The official Guidance SDK package for Windows, Ubuntu and XU3.
134 stars 98 forks source link

DJI Guidance SDK

 English Version  中文版本

English Version

Official Guidance SDK package for accessing the rich categories of output data from Guidance via USB and UART, and configure your Guidance all by your demand.

Document

Structure

Also notice that, to enable fast download for ROS users, we have a separate ROS repo with much smaller size: Guidance-SDK-ROS.

Usage

Windows

Examples of USB and UART can be found in examples/usb_example, examples/uart_example, including Visual Studio projects which is ready to compile. Remember to copy the corresponding DJI_guidance.dll file to the same directory where the output binary locates.

Linux

Examples of USB and UART can be found in examples/usb_example, examples/uart_example, including Makefile which is ready to compile. Remember to copy the corresponding libDJI_guidance.so file to the same directory where the output binary locates.

Notice that, reading and writing Guidance USB port in Linux requires root authority. To save the trouble of typing sudo every time running Guidance SDK applications, it is suggested to add a rule to /etc/udev/rules.d directory, which can be found in doc/51-guidance.rules. Or typing from terminal the following line

sudo sh -c 'echo "SUBSYSTEM==\"usb\", ATTR{idVendor}==\"fff0\", ATTR{idProduct}==\"d009\", MODE=\"0666\"" > /etc/udev/rules.d/51-guidance.rules'

Learn More about DJI Products and the Guidance SDK

Please visit DJI Guidance SDK Documentation for more details.

中文版本

Guidance SDK可以让开发者通过Guidance的USB口和串口来获取丰富的传感器数据,以及按照自己的需要来灵活配置Guidance。

文档

结构

请注意,为了便于ROS用户的快速下载,我们还维护了一个独立的ROS包。它不包含任何文档和Windows下的库文件,因此具有更小的体积:Guidance-SDK-ROS.

如何使用

Windows

USB和串口的示例代码可以在 examples/usb_exampleexamples/uart_example中找到,其中包含了可直接编译运行的Visual Studio工程。需要将对应的dll文件复制到exe所在目录或Windows系统目录。

Linux

USB和串口的示例代码可以在同样的目录(examples/usb_exampleexamples/uart_example)中找到,其中包含了可直接编译的Makefile文件。

注意,在Linux下读写Guidance的USB口需要root权限。为了省去每次运行Guidance SDK程序都要输入sudo的麻烦,建议在 /etc/udev/rules.d 下添加一个规则文件,即 doc/51-guidance.rules. 或者也可以从终端输入下面的这行:

sudo sh -c 'echo "SUBSYSTEM==\"usb\", ATTR{idVendor}==\"fff0\", ATTR{idProduct}==\"d009\", MODE=\"0666\"" > /etc/udev/rules.d/51-guidance.rules'

了解更多

请访问DJI Guidance SDK Documentation以了解更多。