2. SDK安装和配置方法

📋 目录

1. 硬件安装方法说明
2. SDK安装和配置方法
3. 例程编译和调用方法
4. SDK接口调用说明
5. SDK打印内容说明
6. 连接状态查询与故障排查

完整手册

---

源码路径：psi-air-glove-SDK/psi-air-glove-SDK/cpp_sdk/
命名空间：psi_glove
主头文件：#include <psi_glove_sdk/psi_glove.hpp>

2.1 系统要求

项目	要求
编译器	GCC 7+ / Clang 5+（Linux 串口实现）
CMake	3.10+
C++ 标准	C++17
第三方库	无（仅标准库）
操作系统	Linux（SerialInterface 基于 POSIX termios）

WARNING

当前 C++ 串口层标注为 Linux/Unix；Windows 原生串口需自行封装 CommunicationInterface 或选用 Python / ROS2 SDK。

2.2 编译与安装

cd psi-air-glove-SDK/psi-air-glove-SDK/cpp_sdk
mkdir -p build && cd build

cmake ..
make -j$(nproc)

# 可选：安装到系统
sudo make install
sudo ldconfig

默认安装路径（Linux）：

组件	路径
头文件	/usr/local/include/psi_glove_sdk/
库文件	/usr/local/lib/libpsi_glove_sdk.so
CMake 包	/usr/local/lib/cmake/psi_glove_sdk/

CMake 选项

选项	默认	说明
BUILD_SHARED_LIBS	ON	动态库 / 静态库
BUILD_EXAMPLES	ON	编译 basic_usage、advanced_usage
SDK_VERSIONED_SHARED_LIBRARY	ON	共享库版本号与符号链接
CMAKE_INSTALL_PREFIX	/usr/local	安装前缀

自定义前缀示例：

cmake -DCMAKE_INSTALL_PREFIX=$HOME/psi_glove_sdk ..
make install

2.3 在工程中使用

find_package(psi_glove_sdk REQUIRED)
target_link_libraries(your_app psi_glove::psi_glove_sdk)

或源码树内：

add_subdirectory(path/to/cpp_sdk)
target_link_libraries(your_app psi_glove_sdk)

---