安装
Rayforge 适用于 Linux、Windows 和 macOS。选择您的平台并按照安装说明操作。
选择您的操作系统:
选择安装方式:
Snap 包
Snap 包适用于大多数 Linux 发行版,并在沙盒环境中包含所有依赖项。
安装 Rayforge
sudo snap install rayforge
将用户添加到 dialout 组
sudo usermod -a -G dialout $USER
重要: 注销并重新登录以使此更改生效。
授予权限(重要!)
USB 串口访问:
# Enable experimental hotplug support (one-time setup)
sudo snap set system experimental.hotplug=true
# Connect your laser via USB, then grant access
sudo snap connect rayforge:serial-port
摄像头访问:
sudo snap connect rayforge:camera
验证权限
snap connections rayforge
在列表中查找 serial-port。如果显示 "connected",您就可以开始了。
验证安装
启动 Rayforge
从应用程序菜单或终端启动 Rayforge。您应该能看到带有画布和工具栏的主窗口。
检查版本
检查帮助 - 关于以确认安装的版本。
连接您的机器
通过 USB 连接您的激光控制器,并验证串口是否出现在 Rayforge 的机器设置中。
故障排除
权限问题?
如果未检测到您的设备,请参阅 Snap 权限指南。 Snap 权限指南
串口仍然无法工作?
- 重新插拔 USB 设备: 拔掉您的激光控制器,等待 5 秒钟,然后重新插入。
- 重启 Rayforge 完全关闭并重新启动。
- 检查设备是否存在:ls -l /dev/ttyUSB* /dev/ttyACM*
- 如果需要,重新安装:sudo snap remove rayforgesudo snap install rayforgesudo snap connect rayforge:serial-port
需要帮助?
如需更多帮助,请在 GitHub 上报告问题或加入我们的 Discord。 GitHub | Discussions | Discord
系统要求
| 资源 | 安装占用 | 推荐 |
|---|---|---|
| 磁盘空间 | < 1 GB | 因项目而异 |
| 内存 | 1 GB | 因项目而异 |
实际的磁盘和内存需求取决于项目的复杂度。简单项目可能只需要很少的额外资源,而复杂项目可能轻松消耗 10 GB 或更多内存,并需要大量额外的磁盘空间。
Linux CPU 要求(x86-64-v2)
Linux 软件包自带 NumPy,要求 x86-64-v2 指令集级别(SSE4.2 和 POPCNT)。这适用于 Snap、Flatpak 和 AppImage 软件包,以及通过 pip 从 PyPI 安装的版本。在较旧的 x86-64 CPU(Intel Core 2 及更早、AMD Phenom 及更早)上,Rayforge 无法启动, 且通常没有任何错误提示。Intel Nehalem(2008 年)及更新、AMD Bulldozer (2011 年)及更新的 CPU 支持 x86-64-v2。
可以使用以下命令检查您的 CPU 是否满足要求:
grep -m1 flags /proc/cpuinfo | grep -o -w -E 'sse4_2|popcnt' | sort -u
如果命令没有同时输出这两个标志,请改用 Ubuntu PPA 版本或您发行版软件源中的 软件包。这些版本使用发行版自带的 NumPy,可以在较旧的 CPU 上运行。
下一步
现在 Rayforge 已安装完成,请继续首次设置以配置您的机器。