Инструкция по использованию
Данное руководство предназначено для установки и настройки moon2uart в системе Raspberry Pi, чтобы дисплей Nova 3.5 мог взаимодействовать с хост-компьютером Klipper через UART.
| Пункт | Описание |
|---|---|
| Эталонная система | Raspberry Pi OS with Desktop |
| Эталонная версия | Debian GNU/Linux 12 (bookworm) |
| Предварительные условия | Установлены Klipper и Moonraker, возможен доступ к Mainsail или Fluidd через браузер |
| Способ выполнения | Требуется SSH-подключение к Raspberry Pi |
Перед началом проверьте версию системы:
cat /etc/os-release
Если вывод содержит строку, например, PRETTY_NAME="Debian GNU/Linux 12 (bookworm)", это означает, что версия системы соответствует данному руководству.
Если вы используете другую хост-систему на Linux, вы также можете воспользоваться этим руководством, но пути к файлам, имена портов или способы управления службами могут отличаться, и их необходимо корректировать в соответствии с реальной системой.
Инструкция по подключению
Перед началом полностью выключите принтер и отключите источник питания. Не подключайте и не отключайте кабели, не выравнивайте контакты и не прикасайтесь к клеммам под напряжением.
Nova 3.5 использует UART-связь. При подключении необходимо соединить контакты 5V, GND, TX, RX. Схема подключения дополняется; после подключения переходите к программной настройке ниже.
Установка компонентов
Выполните следующую команду в SSH для автоматической установки moon2uart:
curl -sSL https://cnb.cool/3dmellow/public/Moon2Uart/-/git/raw/master/scripts/install.sh | sudo bash
Редактирование конфигурации UART системы
Шаг 1: Включение UART на Raspberry Pi
Откройте файл /boot/firmware/config.txt:
sudo nano /boot/firmware/config.txt
Добавьте следующее содержимое в конец файла:
enable_uart=1
dtoverlay=miniuart-bt
force_turbo=1
dtoverlay=uart0
После добавления нажмите Ctrl + S для сохранения, затем Ctrl + X для выхода из редактора.
Шаг 2: Отключение системной консоли UART
Откройте файл /boot/firmware/cmdline.txt:
sudo nano /boot/firmware/cmdline.txt
Если в файле присутствует console=serial0,115200, удалите эту часть, чтобы системная консоль не занимала порт.
После изменения нажмите Ctrl + S для сохранения, затем Ctrl + X для выхода из редактора.
Шаг 3: Настройка прав доступа к файлу журнала
Выполните следующую команду в SSH:
sudo chmod 777 /home/pi/printer_data/logs/moon2uart.log
Отсутствие вывода обычно означает успешное выполнение. Если системный пользователь не pi, замените /home/pi/printer_data на фактический путь printer_data.
Шаг 4: Изменение конфигурации moon2uart
Откройте веб-интерфейс Klipper через браузер, например Mainsail или Fluidd, затем откройте файл moon2uart.conf.
Найдите параметр SERIAL_PORT= и измените адрес порта на:
SERIAL_PORT="/dev/ttyAMA0"
Также убедитесь, что PRINTER_DATA_PATH соответствует фактическому пути printer_data в системе, например:
PRINTER_DATA_PATH="/home/pi/printer_data"
Имя UART-устройства на Raspberry Pi может меняться в зависимости от версии системы, модели оборудования или системной конфигурации. Если /dev/ttyAMA0 не работает, попробуйте /dev/ttyS0 или измените на имя последовательного устройства в вашей системе.
Для других хост-систем используйте имя последовательного порта соответствующей системы. Например, хост-системы FLY обычно используют /dev/ttyS0.
После изменения нажмите SAVE в правом верхнем углу для сохранения конфигурации.
Шаг 5: Перезагрузка Raspberry Pi
После сохранения конфигурации перезагрузите Raspberry Pi, чтобы изменения системного порта вступили в силу:
sudo reboot