Перейти до основного вмісту

Встановлення

Rayforge доступний для Linux, Windows та macOS. Виберіть свою платформу нижче та дотримуйтесь інструкцій з встановлення.

Виберіть вашу операційну систему:

Виберіть метод встановлення:

Пакет Snap

Пакет Snap працює на більшості дистрибутивів Linux і включає всі залежності в ізольованому середовищі.

1
Встановити Rayforge
sudo snap install rayforge
2
Додати користувача до групи dialout
Потрібні дозволи
На дистрибутивах на основі Debian ваш користувач повинен бути в групі dialout навіть при використанні Snap, щоб уникнути повідомлень AppArmor DENIED.
sudo usermod -a -G dialout $USER

Важливо: Вийдіть з системи і увійдіть знову, щоб ця зміна набула чинності.

3
Надати дозволи (Важливо!)

Для доступу до 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
4
Перевірити дозволи
snap connections rayforge

Шукайте serial-port у списку. Якщо показує "підключено", ви готові до роботи.

Перевірити встановлення

✓
Запустити Rayforge

Запустіть Rayforge з меню програм або терміналу. Ви повинні побачити головне вікно з полотном і панеллю інструментів.

✓
Перевірити версію

Перевірте Допомога - Про програму, щоб підтвердити встановлену версію.

✓
Підключити вашу машину

Підключіть ваш лазерний контролер через USB і перевірте, що послідовний порт з'являється в налаштуваннях машини Rayforge.

порада
На Linux лазерні контролери зазвичай з'являються як /dev/ttyUSB0 або /dev/ttyACM0.

Виправлення проблем

Проблеми з дозволами?

Якщо ваш пристрій не виявлено, дивіться Керівництво з дозволів Snap. Керівництво з дозволів Snap

Послідовний порт все ще не працює?
  1. Перепідключити USB пристрій: Відключіть ваш лазерний контролер, зачекайте 5 секунд, підключіть знову.
  2. Перезапустити Rayforge: Повністю закрийте і запустіть знову.
  3. Перевірте, що пристрій існує:
    ls -l /dev/ttyUSB* /dev/ttyACM*
  4. Перевстановіть за потреби:
    sudo snap remove rayforge
    sudo snap install rayforge
    sudo snap connect rayforge:serial-port

Потрібна допомога?

Для додаткової допомоги повідомте про проблему на GitHub або приєднайтеся до нашого Discord. GitHub | Discussions | Discord


Системні вимоги​

РесурсВстановленоРекомендовано
Дисковий простір< 1 ГБЗалежить від проекту
Оперативна пам'ять1 ГБЗалежить від проекту

Фактичні вимоги до диска та пам'яті залежать від складності проекту. Прості проекти можуть потребувати небагато більше встановленого обсягу, тоді як складні проекти можуть легко спожити 10 ГБ оперативної пам'яті або більше та вимагати значного додаткового дискового простору.

Вимога до процесора в Linux (x86-64-v2)​

Пакети для Linux містять власний NumPy, який вимагає рівня набору інструкцій x86-64-v2 (SSE4.2 та POPCNT). Це стосується пакетів Snap, Flatpak та AppImage, а також встановлення через pip з PyPI. На старіших процесорах x86-64 (Intel Core 2 та старіші, AMD Phenom та старіші) Rayforge не запускається, зазвичай без повідомлення про помилку. Процесори Intel починаючи з Nehalem (2008) та AMD починаючи з Bulldozer (2011) підтримують x86-64-v2.

Перевірити, чи відповідає ваш процесор цій вимозі, можна командою:

grep -m1 flags /proc/cpuinfo | grep -o -w -E 'sse4_2|popcnt' | sort -u

Якщо команда не виводить обидва прапорці, встановіть Rayforge з PPA Ubuntu або зі сховища пакетів вашого дистрибутива. Ці версії використовують NumPy, що постачається з вашим дистрибутивом, і працюють на старіших процесорах.

Наступні кроки​

Тепер, коли Rayforge встановлено, перейдіть до Першого налаштування, щоб налаштувати вашу машину.