Jak zainstalować agenta drukowania w kuchni

Co ten mały program robi przy stanowisku

Agent drukowania to lekki program działający wewnątrz restauracji, który robi most między qmen.us, będącym w chmurze, a drukarką termiczną w twojej sieci lokalnej. Chmura nie dosięgnie drukarki za routerem, więc to on łączy się na zewnątrz, co jakiś czas pyta, czy jest nowe zamówienie, drukuje i potwierdza. Nie trzeba otwierać żadnego portu na routerze.

Są wersje na trzy urządzenia: Linux (jeden plik AppImage), Windows (jeden plik .exe) i Android (aplikacja projektu, z drukarką przez Bluetooth lub sieć). We wszystkich trzech konfiguracja to ta sama para: adres Kuchni i token, który daje panel. qmen.us nadal działa w przeglądarce, bez aplikacji ze sklepu; instaluje się tylko on i tylko na tym urządzeniu w kuchni.

Dlaczego warto mieć zamówienie na papierze

• Zamówienie wychodzi samo, bez klikania. Kelner wysyła ze Stolika, qmen.us tworzy zadanie drukowania, a program pobiera je przy następnym sprawdzeniu, domyślnie co 3 sekundy.
• Powtórzony wydruk jest lepszy niż zgubione zamówienie. Drukarka bez papieru, wyłączona albo niestabilny internet: błąd jest zgłaszany, a zadanie wraca do kolejki. Serwer oferuje je ponownie po minucie bez potwierdzenia i próbuje do dziesięciu razy, zanim się podda.
• Każde stanowisko drukuje tylko swoje. Adres i token są per Kuchnia, więc grill nie dostaje deseru. Lokal z dwoma stanowiskami i dwiema drukarkami termicznymi uruchamia dwóch agentów, każdego z własnym configiem.
• To samo urządzenie może drukować i pokazywać monitor. Gdy w configu włączony jest monitor, ekran kuchni otwiera się w przeglądarce przy starcie. Jeśli chcesz tylko ekran, nawet tego nie potrzebujesz: wystarczy otworzyć link do monitora.

Jak zainstalować agenta drukowania w 7 krokach

To siedem kroków: od przycisku w panelu do programu startującego samodzielnie, gdy urządzenie się włącza.

1. Włącz drukowanie stanowiska w panelu

   W panelu otwórz Kuchnie. Każde stanowisko to karta, a w niej blok Drukowanie z przyciskiem Konfiguruj. Otwiera się okno Drukowanie w kuchni: włącz przełącznik Drukuj zamówienia, wybierz Szerokość papieru (80 mm albo 58 mm), ile chcesz Liczba kopii (od 1 do 5) i dotknij Zapisz. Karta zaczyna pokazywać Włączone, ze szerokością i liczbą kopii obok.

2. Skopiuj adres i token

   W tym samym oknie, w Dane dla aplikacji do drukowania, są dwie linie: adres Kuchni i token, ukryty za kropkami. Oczko go odsłania, a przycisk obok kopiuje. Jeśli pojawia się (wygenerowany po zapisaniu), to znaczy, że jeszcze nie zapisałeś. Dobrze zachowaj token: działa jak hasło drukowania. Link Wygeneruj nowy token unieważnia poprzedni natychmiast.

3. Pobierz wersję na swoje urządzenie

   Na urządzeniu w kuchni pobierz plik dla swojego systemu: w Windows plik .exe (od Windows 7), w Linuksie AppImage, który działa na każdej dystrybucji. To jeden plik w jednym folderze. Na Raspberry Pi i innych ARM wygeneruj AppImage na samym urządzeniu albo uruchom prosto z kodu źródłowego, z Pythonem 3.9 lub nowszym.

4. Wklej adres, token i drukarkę

   Obok programu leży config.json z base (adres), token, printer (drukarka) i poll (co ile sekund pyta). W Windows ten plik leży w tym samym folderze co .exe; w Linuksie w ~/.config/pedis-agent/config.json. printer zależy od połączenia: network:192.168.0.50 dla drukarki sieciowej, windows: dla domyślnej kolejki Windows, file:/dev/usb/lp0 dla USB w Linuksie, serial:/dev/ttyUSB0 dla portu szeregowego.

   Wskazówka: W Windows zainstaluj drukarkę termiczną jako kolejkę Generic / Text Only: sterownik, który rysuje stronę, miesza polecenia i wychodzi brudny papier. W Linuksie, jeśli /dev/usb/lp0 daje odmowę dostępu, uruchom sudo usermod -aG lp $USER i zaloguj się ponownie.

5. Zrób test przed obsługą

   Zanim zaufasz lunchowi, zrób jeden przebieg tylko z drukarką dummy: wydruk pojawia się na ekranie, bez zużywania papieru. Potem wyślij zamówienie testowe ze Stolika i zobacz, jak wychodzi papier — nagłówek z lokalem, stolikiem, numerem zamówienia, kelnerem, stanowiskiem i godziną, a każda pozycja dużą czcionką, z dodatkami i uwagą pod spodem.

6. Niech startuje sam

   Kuchnia nie ma czasu pamiętać o otwieraniu programu. Z pedis-agent --install Windows tworzy zadanie startujące przy logowaniu, a Linux usługę użytkownika, która sama się restartuje, jeśli padnie. Na urządzeniu bez zalogowanej osoby, jak Raspberry Pi za telewizorem, uruchom też sudo loginctl enable-linger. Żeby cofnąć, pedis-agent --uninstall.

7. Na tablecie z Androidem jest ta sama droga

   Jeśli kuchnia używa tabletu, aplikacja na Androida (od 5.0) robi to samo i dodatkowo pokazuje ekran kuchni. Na ekranie głównym wypełniasz Adres, Token i Drukarkę — bt: i MAC sparowanej drukarki Bluetooth albo net: i IP drukarki sieciowej — i dotykasz Zapisz i uruchom. Przyznaj uprawnienie Bluetooth i wyjmij aplikację z oszczędzania baterii, bo inaczej drukowanie zatrzymuje się, gdy ekran gaśnie.

Najczęstsze pytania

Słowniczek

Agent drukowania

Mały program działający na urządzeniu w kuchni, który pobiera zamówienia z qmen.us, drukuje je na drukarce termicznej i potwierdza.

Token drukowania

Hasło do drukowania danej Kuchni. Pochodzi z panelu, trafia do konfiguracji agenta i możesz je zmienić, kiedy chcesz.

Kuchnia

Monitor, na którym zamówienia się pojawiają i przechodzą od W przygotowaniu do GOTOWE.

ESC/POS

Język, który rozumieją termiczne drukarki zamówień. To właśnie agent generuje dla każdego wydruku.

Powiązane poradniki