4.4 开发工具与示例
SDK 仓库同时提供 C++ demo、Python ctypes 封装和参数样例。它们适合验证接口映射和设备联调,不是可直接用于生产的完整装卸柜任务调度器。
C++ demo
根目录 CMakeLists.txt 为以下源码创建可执行文件:
目标 |
源文件 |
主要验证内容 |
|---|---|---|
|
|
AGV 登录、自动位移、手动速度和位姿。 |
|
|
基准点、最后一面、航向角算法。 |
|
|
ONNX 实例分割、目标信息、可视化图和全局掩膜。 |
|
|
配置读取、状态初始化、垛型数据。 |
|
|
RS080N 正解和逆解。 |
|
|
单例日志、格式化日志和急停记录。 |
|
|
PLC 初始化、取料参数、信号和状态轮询。 |
|
|
机器人运动、状态读取和抓取补偿。 |
|
|
串口倾角仪启动、读取和停止。 |
Python 封装
scripts 中可见的封装包括:
AGV_SDK/agv_sdk.py:AGVClient,支持上下文管理器和手动持续运动后自动归零;CameraSDK/camera_sdk.py:Camera3D C ABI 的 ctypes 封装;DL_SDK/dlseg_sdk.py:DlSegSDK,提供模型初始化、识别、分割与掩膜保存;DL_SDK/dlseg_sdk_img_demo.py、dlseg_sdk_cam_demo.py:图片分割与本机视频设备实时分割;JsonSDK/jsonparameter.py:配置结构体和 JSON/TXT 查询接口;RobotSDK/robot_sdk.py:机器人运动与目标位姿算法封装;SensorSDK/inclinometer.py:倾角仪创建、启动、读取、归零和关闭;PLC_SDK/plc_sdk_demo.py、LoggerSDK/logger_sdk_demo.py和运动学 demo:联调用例。
各封装的库查找路径不同。DlSegSDK 默认从 build/SDK_Demos 加载 DLL/SO;其他模块按脚本分别核对。脚本中的数据路径还与当前工作目录有关。Python ctypes 的 argtypes 和 restype 必须与对应接口一致。
DlSegSDK 的模型文件、输出格式和短示例见 深度学习箱体识别与实例分割。DL_SDK/pt_to_onnx/pt_to_onnx.py 提供 Ultralytics 模型导出工具。
参数样例
JsonSDK 样例位于 scripts/JsonSDK/data:
data/json/Hand-eye_calibration_parameters.json:手眼标定;data/json/sku_data.json:SKU 尺寸和重量;data/json/setting_parameters.json:机器人/倾角仪等设置;data/json/rd_demo_data_keba.json、rd_demo_data_kuka.json:垛型数据;data/json/robot_data.json:机器人状态;data/txt/continuation_config.txt:续码配置。
不要把现场生产参数、设备凭据或含敏感信息的日志直接提交到公共仓库。