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

> 原文链接：https://robotics.hellobike.com/pitfalls/2025-11-02-piper-sdk-24
> 频道：pitfalls | 更新日期：2025-11-02 | 标签：auto, github-issue, piper_sdk
> 核心摘要：MacOS原生及Docker环境无法识别Piper CAN设备，目前可通过Parallels虚拟机USB透传运行Ubuntu 22.04解决。

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

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[Agilex Piper CAN does not work with MacOS](https://github.com/agilexrobotics/piper_sdk/issues/24)（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 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub agilexrobotics/piper_sdk #24：Agilex Piper CAN does not work with MacOS](https://github.com/agilexrobotics/piper_sdk/issues/24)