支持的操作系统

控制器软件适用于以下系统：

• Windows 7 x64 或更高版本

• 使用 Intel CPU 的 macOS，运行 Ventura (13) 或更高版本

• 使用 Apple Silicon CPU 的 macOS，运行 Sonoma (14) 或更高版本

• 使用 x64 CPU 的 Linux，运行使用 Glibc 2.35 或更高版本的 Linux 发行版（例如 Ubuntu 22.04 或更高版本）

• 使用 aarch64 CPU（例如 Raspberry Pi 3+）的 Linux，运行使用 Glibc 2.39 或更高版本的 Linux 发行版（例如 Ubuntu 24.04 或更高版本）

• 搭载 iOS 17.6 或更高版本的 Apple iPad

• 搭载 Android 11 或更高版本、运行 ARM 32 和 64 位处理器（ARMv7a 和 ARMv8a）以及 x86_64 的 Android 设备

• 其他系统可能可通过 Python 包工作，详见 Python 包 了解更多细节。

操作系统特定说明

macOS

您可能会收到错误“Apple 无法验证‘Carvera Controller Community’是否不含可能损害您的 Mac 或危及您隐私的恶意软件。”，因为我们当前尚未为 macOS 发布签名。

您可以通过打开系统设置，然后在侧栏中点击“隐私与安全”来解决此问题。向下滚动到页面底部并点击“仍要打开”。完成此操作一次后，该应用即可正常打开。

Android

在 Controller 中使用文件浏览器时，应用会引导您到 Android 的权限页面，在那里您必须授予应用对设备文件的完全访问权限。没有该权限您将看不到任何文件。

请注意，图形渲染所用的某个库存在已知错误，可能导致启动应用后屏幕保持黑屏。 在上游库解决此问题之前，我们已实现一个变通方法以尽量避免该情况发生。如果您仍遇到此问题，则需要回到主屏幕然后再返回应用。若发生此情况，请通过以下方式反馈， GitHub 问题 我们可以一起改进针对您的设备的变通解决方案。

Linux

对于 Linux 支持，我们构建了 AppImage，这是一种包含运行该应用所需所有依赖项的自包含二进制文件。

要使用它，首先使其可执行（chmod +x carveracontroller-community-<version>-<arch>.appimage).

然后您就可以运行它。

如果您想创建快捷方式，可考虑使用 AppImageLauncher.

Arch Linux

要使 Carvera 控制器在 Arch Linux 上通过 USB 连接到机器，必须创建一条 udev 规则，在设备连接时授予用户对该 USB 设备的权限。

1. 添加一个新的 udev 文件：

sudo vim /etc/udev/rules.d/99-carverausb.rules

1. 添加以下内容：

# Carvera USB 串口设备
SUBSYSTEM=="tty", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", MODE="0666"

# 可选的摇杆挂件（Jog Pendant）USB 设备
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="10ce", ATTRS{idProduct}=="eb93", MODE="0666"

1. 保存并关闭文件后，重新加载规则：

sudo udevadm control --reload-rules
sudo udevadm trigger

iOS

Carvera Community Controller 的 iOS 版本可能因 Apple App Store 审核和开发者可用性而落后于其他发布版本。