具身开发者社区

外观

踩坑GitHub agilexrobotics/piper_sdk12 个月前

MacOS下Piper SDK无法识别candleLight CAN适配器 ​

MacOS原生及Docker环境无法识别Piper CAN设备，目前可通过Parallels虚拟机USB透传运行Ubuntu 22.04解决。

AI 整理
  • 机型本体
  • 本体 SDK 与控制

松灵机器人松灵 PiPER

本文由 AI 根据公开内容整理，可能有误，请以原文为准：Agilex Piper CAN does not work with MacOS（GitHub agilexrobotics/piper_sdk #24）

状态：有绕过办法

问题 ​

在MacOS下连接Agilex Piper的candleLight USB-CAN适配器（VID 0x1d50），system_profiler可识别USB设备，但/dev下无对应tty/cu节点。尝试安装mac-can等工具或在Docker中运行piper_sdk均报错“The number of CAN modules detected by the system (0) does not match the expecte。

环境 ​

主机：MacOS；适配器：candleLight USB to CAN (bytewerk, VID:0x1d50, PID:0x606f)；软件：piper_sdk, python-can, Ubuntu 22.04 Docker/VM

解决办法 ​

  1. 放弃MacOS原生驱动与默认Docker配置，当前暂无稳定原生支持方案。
  2. 安装Parallels Desktop并创建Ubuntu 22.04虚拟机。
  3. 在虚拟机设置中将candleLight USB-CAN适配器通过USB透传功能直通至Guest OS。
  4. 在Ubuntu 22.04虚拟机内安装can-utils、python-can及piper_sdk，按标准Linux流程激活CAN接口即可正常控制。
  5. 若坚持使用Docker，需添加--network host --device /dev/bus/usb/:/dev/bus/usb/参数映射USB总线（此法在Ubuntu 24.04宿主机验证有效，MacOS未确认）。

讨论原作者：@cetiennec 等，版权归原作者所有。

来源

本页事实对应的公开页面，以原文为准。

  1. GitHub agilexrobotics/piper_sdk #24：Agilex Piper CAN does not work with MacOS访问 2026-10-26