DreamSoul研究
源码与架构 /

Doly 传感与交互 SDK 研究

固定源码 · 研究快照 2026-10-27Markdown 下载 ↓
本页为正式研究文档的网页阅读版。固定 GitHub 证据保留;本机研究底稿未发布,相关链接已改为文字说明。原文中的历史发布状态对应研究当时。

信息截止与访问日:2026-10-27。研究 Doly 作为桌面机器人开发平台的传感、表达和运动接口。已读固定仓库的公开头文件、Python 绑定、示例、构建文件、许可正文与官方 FAQ。未加载二进制库、编译 SDK、连接硬件或调用云模型。

适合作为 SDK 接口设计与产品交互研究对象,不能列为可直接商用移植的完整开源实现。 2026 年新增 C++ / Python SDK 使开发接口较新,但核心驱动以 .so 提供,而且非商业许可明确覆盖 SDK 和示例软件。

版本与商业依据

项目 固定记录
官方仓库 robotdoly/DOLY-DIY,创建于 2023-03-20 22:34:10 UTC,访问时 558 stars、97 forks
默认分支 main,提交 dc6f9c6b,2026-10-15 15:07:48 UTC,提交主题 Motor Compatibility
SDK 新进展 官方社区公告宣布随 v1.007 提供 C++ / Python SDK,检索日期元数据为 2026-02-22。当前 GitHub releases 列表为空,不把社区固件号当 GitHub release
众筹原页 Kickstarter:2024-02-13 至 03-14,CAD 301,597、747 位支持者。本次重读一致
商业证据限制 众筹支持者不是已交付销量,也不是 2026 年新增销量。未取得独立核验的累计出货数

实际实现边界

代码链路是自定义 Python 应用 → pybind11 模块 → Doly C++ 共享库 → Raspberry Pi CM4 硬件。以驱动为例,bindings.cpp将 go_distance、go_rotate、go_xy、free_drive 映射至 DriveControl 命名空间函数。CMakeLists.txt编译的是绑定,链接 /.doly/libs/sdk/lib 下的 DriveControl、MotorControl、Gpio、Helper、ImuControl。

固定树的 SDK/lib 有 23 个 .so,包括 libDriveControl.so、libEyeControl.so、libEdgeControl.so、libTtsControl.so。该目录未见 libMotorControl.so,但驱动绑定明确依赖 MotorControl,因此仍需要设备侧 SDK/系统提供相应库。公开树中未找到这些核心控制库对应的实现源文件。能读到接口和包装层,不等于能重编译整个底层 SDK。

研究模块 实际源码定位 可以学到的设计 不能从现有材料推出的能力
动作生命周期 DriveControl.h,Python 示例 init / dispose、命令 ID、异步完成/错误/状态事件。距离、旋转、XY 与单轮低层控制分层,提供 abort 0–100 速度是接口约定,未取得库内部限幅实现。防跌落、停止时延、轨迹精度没有实测
Python 回调桥接 bindings.cpp GIL 获取、互斥锁、强引用保活、移除监听器和清理回调的公开实现 可研究跨语言异步事件生命周期,但带 NC 许可,不能当不受限商用代码直接复制
边缘与触摸传感 EdgeControl.h、TouchControl.h init / enable / disable、按地面状态筛选 IR 传感器、异步触摸回调与当前状态查询 头文件标称边缘约 21 Hz、触摸约 20 Hz,这是文档陈述,不是测试结果。不能据此保证跌落拦截
眼睛表达 EyeControl.h 预设形状、颜色、图像内容、左右眼、注视坐标、动画 ID、start/complete/abort 事件与异步播放 表情名称公开不等于渲染器、全部图像资源和底层动画实现可移植
相机与音频 Camera/example.py、AI 集成 FAQ 实际示例配置照片 3280×2464、视频 1280×960 / 15 fps,读取 NumPy 帧交给 OpenCV。FAQ 允许 ALSA 麦克风及扬声器 示例中的帧率是配置值。持续帧性能、AEC、麦克风与电机并行噪声未测试,流媒体网络传输需自行实现
本地 TTS 接口 TtsControl.h 明确是 Piper 包装层,init 选模型,produce 写语音文件,调用阻塞 模型名仅 MODEL_1/2/3,实际模型映射和语音权重许可未知。未取得包装内部实现,不能将平台许可套到 Piper 与声音模型

官方 FAQ和驱动示例都要求自定义应用启动前停止标准 Doly service,避免同一硬件控制库冲突。驱动示例实际调用 helper.stop_doly_service(),随后注册回调、初始化、发送 100 mm 前进并轮询 Running,最后 dispose。

官方 FAQ 允许本地控制独立于手机 App 和云服务,也允许开发者自行接 OpenAI、Gemini 或局域网模型。这不是已经实现的 OpenAI / Gemini 对话应用。 在已读目录中,本轮核实的是传感/动作接口及普通 Linux 媒体接入,实时会话、视觉选择、模型调用、回声消除、记忆与线程同步仍需应用开发。

许可与复用判断

LICENSE.txt明确将硬件设计、机械结构、CAD、电路、固件、SDK、库、API、示例和配置统称为 Licensed Material,使用 CC BY-NC-SA 4.0。第 52 行起又单独澄清软件也受此限制,商业使用须事先取得许可方书面许可。固定递归树只找到这一份 LICENSE.txt,未找到 SDK 目录的宽松许可例外。

使用目标 本轮判断
研究接口、读示例、比较事件和媒体组织方式 值得保留为研究对象,按原许可条件使用
在商业陪伴产品中复制 SDK、绑定或示例 当前许可不足,需要另取得书面商业授权。不能因只取几段软件就忽略 NC
独立实现相似的设备抽象和事件接口 可以提出自己的设计方案,但不得把本报告当作具体代码复制授权
将 .so 搬到自家硬件 除授权外仍有 ABI、系统镜像、板级驱动、传感器和模型资产依赖。现有二进制接口不提供可移植实现
克隆完整机器人 本轮未完成制造资料完整性及供应链核查,不作可制造性结论

Doly 相较 Reachy 的价值是桌面移动机器人传感/眼睛/轮子/胳膊的接口组织。相较 StackChan 的可抽取表达代码,它更多提供现成设备 API。若选型首要目标改成“可直接商用复用的软件”,其优先级应低于 Petoi、StackChan 以及许可已确定的 Reachy 独立模块。

验证状态与后续指标

本轮只完成源码和文件树静态核验,没有将接口声明、示例配置或 .so 存在写成运行成功。后续应先取得使用授权与匹配系统镜像,再验证命令拒绝/接受语义、回调线程与重入、init/dispose 重复调用、断链或异常时停止、边缘事件到电机停止的时延,以及录音/视频/动作并行时丢帧和音频质量。SDK 文档没有给这些测试结果,本报告也未补造。

可复用记录见 doly-assets.json。固定源码材料和仓库树保存在 商业候选临时目录(研究底稿,未随本专区发布)。