Проблеми з підключенням
Ця сторінка допомагає діагностувати та вирішити проблеми підключення Rayforge до вашої лазерної машини через послідовне з'єднання.
Швидка діагностика
Симптоми
Поширені проблеми підключення включають:
- Помилка "Порт має бути налаштований" при спробі підключення
- Підключення постійно зазнає невдачі та перепідключається
- Послідовний порт не з'являється в списку портів
- Помилки "Відмовлено в дозволі" при спробі відкрити послідовний порт
- Пристрій здається підключеним, але не відповідає на команди
Поширені проблеми та рішення
Послідовні порти не виявлено
Проблема: Випадаючий список послідовних портів порожній або не показує ваш пристрій.
Діагностика:
- Перевірте, чи ваш пристрій увімкнено та підключено через USB
- Спробуйте відключити та знову підключити USB-кабель
- Протестуйте USB-кабель з іншим пристроєм (кабелі можуть виходити з ладу)
- Спробуйте інший USB-порт на вашому комп'ютері
Рішення:
Linux:
Спочатку додайте свого користувача до групи dialout (необхідно для обох Snap
і не-Snap інсталяцій на більшості дистрибутивів на основі Debian):
sudo usermod -a -G dialout $USER
Потім вийдіть з системи та зайдіть знову, щоб зміни набрали чинності.
Якщо ви використовуєте версію Snap, вам також потрібно надати дозволи на послідовний порт:
sudo snap connect rayforge:serial-port
Див. Дозволи Snap для детального налаштування Linux.
Windows:
- Відкрийте Диспетчер пристроїв (Win+X, потім виберіть Диспетчер пристроїв)
- Шукайте під "Порти (COM та LPT)" ваш пристрій
- Якщо бачите жовтий значок попередження, оновіть або перевстановіть драйвер
- Запишіть номер COM-порту (наприклад, COM3)
- Якщо пристрій взагалі не в списку, USB-кабель або драйвер може бути несправним
macOS:
- Перевірте Системну інформацію → USB щоб переконатися, що пристрій розпізнається
- Встановіть драйвери CH340/CH341, якщо ваш контролер використовує цей чіпсет
- Шукайте пристрої
/dev/tty.usbserial*або/dev/cu.usbserial*
Помилки "Відмовлено в дозволі"
Проблема: Ви отримуєте помилки "Відмовлено в дозволі" або подібні при спробі підключення.
На Linux:
Вашому користувачу потрібно бути в групі dialout (або uucp на деяких
дистрибутивах). Це необхідно для обох Snap і не-Snap інсталяцій на
дистрибутивах на основі Debian, щоб уникнути повідомлень AppArmor DENIED:
# Додайте себе до групи dialout
sudo usermod -a -G dialout $USER
# Перевірте, що ви в групі (після виходу/входу)
groups | grep dialout
Важливо: Ви повинні вийти з системи та зайти знову (або перезавантажити) щоб зміни групи набрали чинності.
Додатково для Snap інсталяцій, надайте доступ до послідовного порту snap-пакету:
sudo snap connect rayforge:serial-port
Див. посібник Дозволи Snap для деталей.
На Windows:
Закрийте будь-які інші програми, які можуть використовувати послідовний порт, включаючи:
- Попередні екземпляри Rayforge
- Інструменти моніторингу послідовного порту
- Інше лазерне ПЗ
- Arduino IDE або подібні інструменти
Вибрано неправильний послідовний порт
Проблема: Rayforge підключається, але машина не відповідає.
Діагностика:
Ви могли вибрати неправильний порт, особливо якщо у вас підключено кілька USB-пристроїв.
Рішення:
- Відключіть усі інші USB послідовні пристрої
- Запишіть, які порти доступні в Rayforge
- Підключіть ваш лазерний контролер
- Оновіть список портів - новий порт і є вашим лазером
- На Linux лазерні контролери зазвичай з'являються як:
/dev/ttyUSB0(поширено для чіпсетів CH340)/dev/ttyACM0(поширено для нативних USB контролерів)
- На Windows запишіть COM-порт з Диспетчера пристроїв
- Уникайте портів з назвою
/dev/ttyS*на Linux - це апаратні послідовні порти, не USB
:::увага Апаратні послідовні порти
Rayforge попередить вас, якщо ви виберете порти /dev/ttyS* на Linux, оскільки вони зазвичай не є USB-пристроями GRBL. USB послідовні порти використовують /dev/ttyUSB* або /dev/ttyACM*.
:::
Неправильна швидкість передачі
Проблема: Підключення встановлюється, але команди не працюють або дають спотворені відповіді.
Рішення:
Контролери GRBL зазвичай використовують одну з цих швидкостей передачі:
- 115200 (найпоширеніша, GRBL 1.1+)
- 9600 (старіші версії GRBL)
- 250000 (менш поширена, деяка власна прошивка)
Спробуйте різні швидкості передачі в налаштуваннях пристрою Rayforge. Найпоширеніша - 115200.
Підключення постійно розривається
Проблема: Rayforge успішно підключається, але постійно відключається та перепідключається.
Можливі причини:
- Ненадійний USB-кабель - Замініть на відомий робочий кабель (бажано короткий, <2м)
- Проблеми з живленням USB - Спробуйте інший USB-порт, бажано на самому комп'ютері, а не на хабі
- EMI/Перешкоди - Тримайте USB-кабелі подалі від проводів двигунів та високовольтних блоків живлення
- Проблеми прошивки - Оновіть прошивку GRBL якщо можливо
- Конфлікти USB-портів - На Windows спробуйте різні USB-порти
Кроки усунення неполадок:
# На Linux моніторте системні логи під час підключення:
sudo dmesg -w
Шукайте повідомлення типу:
- "USB disconnect" - вказує на фізичні проблеми/проблеми з кабелем
- "device descriptor read error" - часто проблема з живленням або кабелем
Пристрій не відповідає після підключення
Проблема: Статус підключення показує "Підключено", але машина не відповідає на команди.
Діагностика:
- Перевірте, що вибрано правильний тип прошивки (GRBL або інший)
- Переконайтеся, що машина увімкнена (контролер та блок живлення)
- Перевірте, чи машина в стані аварії (потребує homing або очищення аварії)
Рішення:
Спробуйте надіслати ручну команду в Консолі:
?- Запит звіту про статус$X- Очистити аварію$H- Виконати homing машини
Якщо немає відповіді, перевірте швидкість передачі та вибір порту.
Повідомлення про статус підключення
Rayforge показує різні стани підключення:
| Статус | Значення | Дія |
|---|---|---|
| Відключено | Не підключено до жодного пристрою | Налаштуйте порт та підключіться |
| Підключення | Спроба встановити з'єднання | Чекайте, або перевірте конфігурацію якщо зависло |
| Підключено | Успішно підключено та отримується статус | Готово до використання |
| Помилка | Підключення не вдалося з помилкою | Перевірте повідомлення про помилку для деталей |
| Очікування | Очікування перед спробою перепідключення | Попереднє підключення не вдалося, повтор через 5с |
Тестування вашого підключення
Покроковий тест підключення
-
Налаштуйте машину:
- Відкрийте Налаштування Машина
- Виберіть або створіть профіль машини
- Виберіть правильний драйвер (GRBL Serial)
- Виберіть послідовний порт
- Встановіть швидкість передачі (зазвичай 115200)
-
Спробуйте підключення:
- Натисніть "Підключити" на панелі керування машиною
- Спостерігайте за індикатором статусу підключення
-
Перевірте зв'язок:
- Якщо підключено, спробуйте надіслати запит статусу
- Машина має повідомити свою позицію та стан
-
Протестуйте базові команди:
- Спробуйте homing (
$H) якщо ваша машина має кінцеві вимикачі - Або очистіть аварії (
$X) якщо потрібно
- Спробуйте homing (
Використання debug-логів
Rayforge включає детальне логування для проблем підключення. Щоб увімкнути debug-логування:
# Запустіть Rayforge з терміналу з debug-логуванням
rayforge --loglevel DEBUG
Перевірте логи на:
- Спроби підключення та невдачі
- Послідовні дані передані (TX) та отримані (RX)
- Повідомлення про помилки з трасуванням стека
Розширене усунення неполадок
Ручна перевірка доступності порту
Linux:
# Список всіх USB послідовних пристроїв
ls -l /dev/ttyUSB* /dev/ttyACM*
# Перевірте дозволи
ls -l /dev/ttyUSB0 # Замініть на ваш порт
# Має показати: crw-rw---- 1 root dialout
# Вам потрібно бути в групі 'dialout'
# Протестуйте порт вручну
sudo minicom -D /dev/ttyUSB0 -b 115200
Windows:
# Список COM-портів в PowerShell
[System.IO.Ports.SerialPort]::getportnames()
# Або використовуйте Диспетчер пристроїв:
# Win + X → Диспетчер пристроїв → Порти (COM та LPT)
Сумісність прошивки
Rayforge розроблений для прошивок, сумісних з GRBL. Переконайтеся, що ваш контролер використовує:
- GRBL 1.1 (найпоширеніша, рекомендується)
- GRBL 0.9 (старіша, може мати обмежені функції)
- grblHAL (сучасний форк GRBL, підтримується)
Інші типи прошивок (Marlin, Smoothieware) наразі не підтримуються через драйвер GRBL.
USB-до-послідовних чіпсетів
Поширені чіпсети та їхні драйвери:
| Чіпсет | Linux | Windows | macOS |
|---|---|---|---|
| CH340/CH341 | Вбудований драйвер ядра | CH341SER драйвер | Потребує драйвер |
| FTDI FT232 | Вбудований драйвер ядра | Вбудований (Windows 10+) | Вбудований |
| CP2102 (SiLabs) | Вбудований драйвер ядра | Вбудований (Windows 10+) | Вбудований |
Все ще є проблеми?
Якщо ви спробували все вище і все ще не можете підключитися:
- Перевірте GitHub issues - Хтось міг повідомити про ту саму проблему
- Створіть детальний звіт про проблему з:
- Операційна система та версія
- Версія Rayforge (Snap/Flatpak/AppImage/з вихідних кодів)
- Модель плати контролера та версія прошивки
- USB чіпсет (перевірте Диспетчер пристроїв на Windows або
lsusbна Linux) - Повні повідомлення про помилки та debug-логи
- Протестуйте з іншою програмою - Спробуйте підключитися з серійним терміналом (minicom, PuTTY, Arduino Serial Monitor) щоб перевірити, що обладнання працює
Пов'язані сторінки
- Дозволи Snap - Налаштування дозволів Linux Snap
- Режим debug - Увімкнути діагностичне логування
- Загальні налаштування - Посібник з налаштування машини
- Налаштування пристрою - Довідник конфігурації GRBL