OctoPrint - konfiguracja i instalacja

Ten artykuł jest dostępny również w tych językach: 

W tym artykule opisujemy konfigurację własnego obrazu od zera do dowolnego Raspberry Pi (RPi). Dzięki niemu będziesz w stanie podłączyć podstawową instancję OctoPrinta, którą następnie możesz rozszerzyć. Opisujemy również konfigurację Raspberry Pi Zero podłączonego przez piny GPIO. Raspberry Pi Zero nie ma jednak wystarczającej mocy, aby obsługiwać zaawansowane funkcje OctoPrinta i bardziej rozbudowane wtyczki, jak np. strumieniowanie obrazu i nie jest zalecany przez autorów projektu OctoPrint. 

• • 1. Potrzebne części
    2. Wgranie obrazu Octoprint
    3. Połączenie z RPi
    4. Odnalezienie adresu IP
    5. Uruchomienie i konfiguracja OctoPrint
    6. Instalowanie wtyczek ("pluginów")
    7. Konfiguracja GPIO w RPi Zero W

Potrzebne części

• Raspberry Pi A, A+, B, B+, 2B, 3A+, 3B, 3B+, 4B 1/2/4GB lub Zero W/2 + zasilacz.
• Adapter USB Wi-Fi do RPi, jeśli nie ma wbudowanego modułu.
• Przewód USB:
• Original Prusa i3: Przewód USB typu A.
• Original Prusa MINI: Przewód MicroUSB.
• Karta (micro)SD do RasPi pojemności co najmniej 8GB.
• Komputer z działającym klientem SSH, np. PuTTY. Mac/osX oraz Linux mają SSH zintegrowany z terminalem.
• Czytnik kart (micro)SD, aby wgrać obraz systemu na kartę.
• Sieć Wi-Fi.

Wgranie obrazu OctoPrint

Ponieważ Raspberry Pi Foundation wypuściła swoje własne oprogramowanie do wgrywania obrazu na kartę (Raspberry Pi Imager), nie jest już potrzebne edytowanie plików konfiguracyjnych po wgraniu obrazu. Wszystko można skonfigurować przy flashowaniu karty, z menu zawierającego opcje zaawansowane (Advanced options). Raspberry Pi Imager pozwala nawet na pobieranie obrazów bezpośrednio z niego. Pokażemy Ci cały proces.

1. Pobierz i zainstaluj Raspberry Pi Imager na swoim komputerze. Znajdziesz go tutaj.

2. Kliknij przycisk "CHOOSE OS" ("wybierz system operacyjny") i przejdź do "Other specific purpose OS" -> "OctoPi" -> "stable".

3. Wejdź w opcje zaawansowane kombinacją klawiszy Ctrl + Shift + X. Zaznacz pole przy "Enable SSH", aby móc od razu wpisać nazwę hosta (nazwę RPi w sieci) i główne hasło oraz nazwę i hasło sieci Wi-Fi, dzięki którym będziemy mogli połączyć się później z Raspberry Pi.

4.  Po wpisaniu odpowiednich danych kliknij "Save" i wybierz kartę SD do zapisu, klikając przycisk "CHOOSE STORAGE". Na koniec kliknij "WRITE", co rozpocznie proces wgrywania obrazu na kartę.

Połączenie z RPi

Włóż kartę (micro)SD do RPi i podłącz płytkę do drukarki przewodem USB. Następnie włącz je. Raspberry Pi Zero W będzie podłączone do drukarki przez piny GPIO, nie USB. Zalecamy zrobienie tego przed przejściem dalej. Jednak, na potrzeby konfiguracji, możesz zasilić je 5-woltową ładowarką do telefonu, a podłączyć przez piny później.

Podłączając płytkę przez USB, wyłącz port RPi (menu LCD -> Ustawienia -> Port RPi, przełącz na "wył").

Port USB typu B w MK3S/MK2.5S	Port MicroUSB w MINI

Odnalezienie adresu IP

Po pierwszym uruchomieniu RPi będzie potrzebować kilku minut na połączenie się z siecią. Odnalezienie przypisanego adresu IP umożliwi Ci aplikacja mobilna, jak np. "Fing" lub podobny skaner IP. Adres IP będzie mieć taki sam początek, jak Twój komputer, ale inną końcówkę. Będzie widnieć pod nazwą "OctoPrint" i/lub "Raspberry Pi" lub jakąś ich wariacją. Najczęściej spotykane adresy IP to 10.0.0.XXX i 192.168.0.XXX.

Uruchomienie i konfiguracja OctoPrint

Otwórz przeglądarkę i wpisz "octopi.local" lub adres IP przypisany do RPi. Możliwe, że pierwszemu uruchomieniu będzie towarzyszyć powitalny Asystent. Nie pomijaj go i dodaj profil drukarki, który musimy następnie skonfigurować. 

Naciśnij ikonkę kółka zębatego (Ustawienia) w prawym górnym narożniku (purpurowa strzałka). Możesz tutaj konfigurować profil, instalować wtyczki i zmieniać inne ustawienia (zielony prostokąt).

Wybierz "Printer profiles" i kliknij ikonkę ołówka (purpurowy prostokąt z prawej strony), aby go edytować. W sekcji "Print bed & Build volume" zmień wartości na pokazane w poniższej tabelce. Cała reszta ustawień pozostaje w domyślnych. Wprowadzone tutaj zmiany mają wpływ jedynie na sposób działania OctoPrint i w żaden sposób nie wpływają na cięcie Twoich plików G-code.

Dla RPi podłączonych przez USB, możesz zostawić pola "Serial Port" oraz "Baudrate" na "AUTO" (niebieski prostokąt), następnie kliknij przycisk "Connect". Gratulacje! OctoPrint jest już gotowy do działania z Twoją drukarką. OctoPrint może wyświetlić monit o aktualizację. Zrób to od razu, przed instalacją jakichkolwiek wtyczek.

Instalowanie wtyczek ("pluginów")

Używanie Raspberry Pi z drukarką jest często nazywane "headless system" (w wolnym tłumaczeniu "system bezperyferyjny"), ponieważ nie ma ekranu podłączonego bezpośrednio do RPi. Jeśli przeniesiesz drukarkę do innej sieci (edytując plik octopi-wpa-supplicant.txt zgodnie z jej konfiguracją) lub zapomnisz adresu IP drukarki, istnieje świetna wtyczka do OctoPrinta, która wyświetla adres drukarki podczas jej uruchamiania.

Otwórz interfejs sieciowy OctoPrint, następnie wejdź w ustawienia i w lewej kolumnie odnajdź "Plugin manager", Przewiń w dół i kliknij "Get More..." (purpurowa strzałka), wyszukaj "IPonConnect" i naciśnij "Install". Po instalacji pojawi się monit o odświeżenie strony - kliknij "Refresh".

Wyłącz i włącz drukarkę przyciskiem na zasilaczu. Po kilku minutach na ekranie drukarki powinien pojawić się jej adres IP. Wejście w menu lub włożenie karty SD może spowodować zniknięcie adresu z ekranu i do jego ponownego wyświetlenia konieczny będzie restart drukarki.

Działanie

Nie jesteśmy odpowiedzialni za rozwój OctoPrint, więc też nie możemy poruszyć wszystkich aspektów jego działania. Z tego względu odsyłamy do oficjalnych zasobów OctoPrint. Polecamy jednak zapoznanie się z naszym poradnikiem:

• Wysyłanie plików do Octoprint/Duet

Poniżej lista wtyczek, które mogą Ci się przydać lub są po prostu fajne:

• Simple Emergency Stop - przycisk na wierzchu interfejsu pozwalający zatrzymać wszystko natychmiast.
• NavBar Temp - wyświetla temperatury na pasku nawigacyjnym.
• Heater Timeout - wyłącza grzałki po ustawionej bezczynności.
• OctoLapse - lepsze timelapsy (filmy poklatkowe).
• Themeify - świetne (w większości ciemne) motywy interfejsu.

Konfiguracja GPIO w RPi Zero W

Aby używać RPi Zero/2 W podłączonego do MK3/S+ przez GPIO, musisz zmienić jedno ustawienie w menu drukarki i skonfigurować obsługę połączenia szeregowego przez RPi. Domyślnie OctoPrint nie używa pinów GPIO w Raspberry Pi do komunikacji szeregowej. Konfigurujesz to przez połączenie z nim przez SSH. Dotyczy to tylko Raspberry Pi Zero/2 podłączonych do płyty głównej Einsy w MK3S/+ bezpośrednio przez GPIO.

Konfiguracja

Na początku, aby móc w ogóle używać pinów GPIO do połączenia z drukarką, musisz aktywować port RPi (menu LCD -> Ustawienia -> Port RPi i przełącz na "wł").

Używanie SSH

Wgrany obraz OctoPrint powinien mieć włączone SSH (Secure SHell). SSH jest sposobem zdalnej kontroli nad urządzeniem po wprowadzeniu nazwy hosta (czyli nazwy RPi w sieci) i hasła. Upewnij się, że RPi i Twój komputer są podłączone do tej samej sieci i użyj poniższych danych do logowania.

Windows:

Otwórz PuTTY i wpisz "nazwahosta@adres_IP" (np. '[email protected]') w polu "Host Name" (zielony prostokąt). W większości przypadków można zostawić port 22. Upewnij się, że rodzaj połączenia ("Connection type") to "SSH" i kliknij Open (purpurowa strzałka).

Mac:

Klient SSH jest wbudowany w Terminal. Otwórz Terminal i wpisz: 

ssh nazwahosta@adres_IP

W konsoli pojawi się monit o hasło. Wpisz swoje hasło. Podczas wpisywania nie będą pojawiać się żadne znaki. Wciśnij Enter i już masz możliwość kontroli nad RPi przy pomocy komend.

Linux:

Najpopularniejsze dystrybucje mają wbudowanego klienta SSH. Jednak dla wszystkich operacji edycji poza zmianą hasła super-user RPi, możesz odnaleźć i edytować wybrane pliki podłączając kartę przez czytnik kart. Wbudowane czytniki kart mogą nie działać na maszynach wirtualnych - w takim przypadku użyj czytnika USB.

W konsoli pojawi się monit o hasło. Wpisz swoje hasło. Podczas wpisywania nie będą pojawiać się żadne znaki. Wciśnij Enter i już masz możliwość kontroli nad RPi przy pomocy komend.

Zamiana portów używanych przez GPIO i Bluetooth

Musimy zmienić dwa pliki konfiguracyjne i dodać port szeregowy przez SSH. Niektóre z tych komend pochodzą z wątku na naszym forum (dzięki Scott.w12 🙂 ). 

Pierwszą rzeczą do aktywacji połączenia szeregowego jest zamiana portów używanych przez GPIO (wlutowane piny) i wewnętrzny moduł Bluetooth. Musimy dodać linię w pliku konfiguracyjnym znajdującym się w partycji "boot".

sudo nano /boot/config.txt

Przyciskiem strzałki w dół przesuń kursor na sam koniec i dopisz:

dtoverlay=pi3-miniuart-bt

Wciśnij Ctrl + X, aby wyjść z edytora tekstu Nano. Naciśnij Y, aby zapisać plik i Enter, aby potwierdzić jego nazwę.

dtoverlay=disable-bt

sudo systemctl disable hciuart.service

sudo systemctl disable bluetooth.service

Wyłączenie konsoli szeregowej

Przejdźmy do kolejnego pliku konfiguracyjnego, w którym musimy usunąć porcję kodu, aby wyłączyć konsolę szeregową.

sudo nano /boot/cmdline.txt

Poszukaj tego tekstu i usuń go.

console=serial0,115200

Restart RPi

Wprowadzenie tych wszystkich zmian wymaga zrestartowania RPi poniższą komendą.

sudo reboot

Dodanie portu szeregowego do OctoPrint

Ostatni etap konfiguracji odbywa się w przeglądarce. Otwórz przeglądarkę i wpisz "octopi.local" lub adres IP przypisany do RPi Zero W. Na początku może przywitać Cię Asystent - nie pomijaj go.

Po wyświetleniu ekranu głównego otwórz ustawienia (w prawym górnym rogu), przejdź do "Serial Connection", następnie "Additional serial ports" i wpisz następujące: (zielony prostokąt).

/dev/ttyAMA0

Zapisz zmiany i zrestartuj OctoPrint. Po ponownym uruchomieniu wybierz nowy port (purpurowa strzałka) i połącz się z drukarką (niebieski prostokąt). Dla wygody możesz zaznaczyć również pola wyboru przy "Save connection settings" oraz "Auto-connect on server startup".