Zo installeer je de printagent in de keuken

Wat dit programmaatje bij het aanrecht doet

De printagent is een licht programma dat in het restaurant draait en de brug vormt tussen qmen.us, dat in de cloud staat, en de thermische printer, die in je lokale netwerk hangt. De cloud kan de printer achter de router niet bereiken. Daarom maakt de agent zelf verbinding naar buiten, vraagt af en toe of er een nieuw bonnetje is, print het en bevestigt. Je hoeft geen poort in de router open te zetten.

Er is een versie voor drie apparaten: Linux (één AppImage-bestand), Windows (één .exe-bestand) en Android (een app van het project, met een printer via Bluetooth of netwerk). Op alle drie is de instelling hetzelfde stel: het adres van de Keuken en het token dat het dashboard je geeft. qmen.us blijft gewoon in de browser draaien, zonder app uit een winkel. Alleen de agent wordt geïnstalleerd, en alleen op dat ene apparaat in de keuken.

Waarom een bonnetje op papier loont

• Het bonnetje komt vanzelf, zonder klikken. De ober stuurt vanaf de Tafel, qmen.us maakt de printopdracht en het programma pakt die bij de volgende controle, standaard om de 3 seconden.
• Een dubbel bonnetje is beter dan een verloren bestelling. Printer zonder papier, uitgeschakeld of wisselend internet: de fout wordt gemeld en de opdracht gaat terug in de wachtrij. De server biedt hem na een minuut zonder bevestiging opnieuw aan en probeert het tot tien keer voordat hij opgeeft.
• Elk station print alleen wat bij dat station hoort. Adres en token horen bij een Keuken, dus de grill krijgt het dessert niet. Heeft jouw zaak twee werkplekken en twee thermische printers, dan draaien er twee agents, elk met een eigen config.
• Hetzelfde apparaat kan printen en het scherm tonen. Met het scherm aan in de config opent het keukenscherm bij het opstarten in de browser. Wil je alleen het scherm, dan heb je dit niet nodig: open gewoon de link van het scherm.

De printagent installeren in 7 stappen

Het zijn zeven stappen, van de knop in het dashboard tot het programma dat vanzelf start als het apparaat aangaat.

1. Zet het printen van het station aan in het dashboard

   Open in het dashboard Keukens. Elk station is een kaart, met daarin het blok Printen en de knop Instellen. Er opent een venster Printen in de keuken: zet de schakelaar Bestellingen printen aan, kies de Papierbreedte (80 mm of 58 mm), hoeveel Exemplaren je wilt (van 1 tot 5) en tik op Opslaan. De kaart toont nu Aan, met de breedte en het aantal exemplaren ernaast.

2. Kopieer het adres en het token

   In hetzelfde venster staan onder Gegevens voor de printapp twee regels: het adres van de Keuken en het token, verborgen achter bolletjes. Het oogje maakt het zichtbaar en de knop ernaast kopieert het. Zie je (wordt bij opslaan gemaakt), dan heb je nog niet opgeslagen. Bewaar het token goed: het geldt als wachtwoord voor het printen. De link Nieuw token maken laat het vorige meteen vervallen.

3. Download de versie voor jouw apparaat

   Download op het apparaat in de keuken het bestand voor jouw systeem: voor Windows een .exe-bestand (Windows 7 en hoger), voor Linux een AppImage die op elke distro draait. Het is één bestand, in één map. Op een Raspberry Pi en andere ARM-apparaten maak je de AppImage op het apparaat zelf of draai je het rechtstreeks vanuit de broncode, met Python 3.9 of nieuwer.

4. Plak het adres, het token en de printer

   Naast het programma staat een config.json met base (het adres), token, printer (de printer) en poll (om de hoeveel seconden hij vraagt of er iets nieuws is). Op Windows staat dit bestand in dezelfde map als de .exe, op Linux in ~/.config/pedis-agent/config.json. Wat bij printer komt, hangt van de aansluiting af: network:192.168.0.50 voor een netwerkprinter, windows: voor de standaardwachtrij van Windows, file:/dev/usb/lp0 voor USB op Linux, serial:/dev/ttyUSB0 voor seriëel.

   Tip: Installeer de thermische printer op Windows als wachtrij Generic / Text Only: een driver die de pagina tekent, husselt de commando's door elkaar en dan komt er vies papier uit. Als /dev/usb/lp0 op Linux "toegang geweigerd" geeft, voer dan sudo usermod -aG lp $USER uit en log opnieuw in.

5. Doe een test vóór de service

   Doe voor de lunch eerst een ronde met alleen de printer dummy: het bonnetje verschijnt op het scherm, zonder papier te verbruiken. Stuur daarna een testbestelling vanaf de Tafel en kijk hoe het papier eruit komt: kop met de zaak, de tafel, het bestelnummer, de ober, het station en de tijd, en elk item in grote letters, met de aanvulling en de opmerking eronder.

6. Laat hem vanzelf starten

   In de keuken heeft niemand tijd om aan het openen van een programma te denken. Met pedis-agent --install maakt Windows een taak die bij het inloggen start en maakt Linux een gebruikersservice die zichzelf herstart als hij crasht. Op een apparaat waar niemand is ingelogd, zoals een Raspberry Pi achter de tv, voer je ook sudo loginctl enable-linger uit. Met pedis-agent --uninstall maak je het ongedaan.

7. Op een Android-tablet is het dezelfde weg

   Gebruikt de keuken een tablet, dan doet de Android-app (5.0 en hoger) hetzelfde werk en toont hij ook het keukenscherm. Op het beginscherm vul je Adres, Token en Printer in, met bt: en het MAC-adres van de al gekoppelde Bluetooth-printer of net: en het IP van de netwerkprinter, en tik je op Opslaan en starten. Geef toestemming voor Bluetooth en haal de app uit de batterijbesparing, anders stopt het printen als het scherm dooft.

Veelgestelde vragen

Begrippenlijst

Printagent

Het programmaatje dat op het apparaat in de keuken draait, de bonnetjes bij qmen.us ophaalt, op de thermische printer afdrukt en bevestigt.

Printtoken

Het wachtwoord voor het printen van een Keuken. Staat in het dashboard, gaat naar de config van de agent en kun je wijzigen wanneer je wilt.

Keuken

Het scherm waar de bestellingen verschijnen en van In bereiding naar KLAAR gaan.

ESC/POS

De taal die thermische bonprinters begrijpen. Dit is wat de agent voor elk bonnetje genereert.

Gerelateerde handleidingen