Come installare l'agente di stampa in cucina

Cosa fa questo programmino al banco

L'agente di stampa è un programmino leggero che gira dentro il ristorante e fa da ponte tra qmen.us, che sta nel cloud, e la stampante termica, che sta nella tua rete locale. Il cloud non raggiunge la stampante dietro il router, quindi è lui a connettersi verso l'esterno, a chiedere ogni tanto se c'è una comanda nuova, a stamparla e a confermare. Non serve aprire nessuna porta sul router.

Esiste in versione per tre dispositivi: Linux (un solo file AppImage), Windows (un solo file .exe) e Android (un'app del progetto, con stampante via Bluetooth o rete). In tutti e tre la configurazione è la stessa coppia: l'indirizzo della Cucina e il token che ti dà il pannello. qmen.us continua a funzionare nel browser, senza app da store; a installarsi è solo lui, e solo su quel dispositivo della cucina.

Perché conviene avere la comanda su carta

• La comanda esce da sola, senza che nessuno clicchi. Il cameriere invia dal Tavolo, qmen.us crea il lavoro di stampa e il programma lo prende al prossimo giro, ogni 3 secondi per impostazione predefinita.
• Un ticket ripetuto è meglio di un ordine perso. Stampante senza carta, spenta o internet instabile: il guasto viene segnalato e il lavoro torna in coda. Il server lo riofferisce dopo un minuto senza conferma e riprova fino a dieci volte prima di arrendersi.
• Ogni postazione stampa solo il suo. Indirizzo e token sono per Cucina, quindi la griglia non riceve il dessert. Un locale con due banchi e due termiche usa due agenti, ciascuno con la sua configurazione.
• Lo stesso dispositivo può stampare e mostrare il monitor. Con il monitor attivo nella configurazione, lo schermo della cucina si apre nel browser all'avvio. Se vuoi solo lo schermo, non serve nemmeno: basta aprire il link del monitor.

Come installare l'agente di stampa in 7 passi

Sono sette passi, dal pulsante nel pannello al programma che parte da solo quando il dispositivo si accende.

1. Attiva la stampa della postazione nel pannello

   Nel pannello apri Cucine. Ogni postazione è una scheda, e in essa c'è il blocco Stampa con il pulsante Configura. Si apre la finestra Stampa in cucina: attiva l'interruttore Stampa gli ordini, scegli la Larghezza della carta (80 mm o 58 mm), quante Copie vuoi (da 1 a 5) e tocca Salva. La scheda comincia a mostrare Attiva, con la larghezza e le copie accanto.

2. Copia l'indirizzo e il token

   Nella stessa finestra, in Dati per l'app di stampa, ci sono due righe: l'indirizzo della Cucina e il token, nascosto da puntini. L'occhietto lo rivela e il pulsante accanto lo copia. Se compare (generato al salvataggio), significa che non hai ancora salvato. Conserva bene il token: vale come password della stampa. Il link Genera nuovo token annulla subito il precedente.

3. Scarica la versione del tuo dispositivo

   Sul dispositivo della cucina, scarica il file del tuo sistema: su Windows un file .exe (da Windows 7 in su), su Linux un AppImage che gira su qualsiasi distro. È un solo file, in una cartella. Su Raspberry Pi e altri ARM, genera l'AppImage sul dispositivo stesso o avvialo direttamente dal codice sorgente, con Python 3.9 o più recente.

4. Incolla indirizzo, token e stampante

   Accanto al programma c'è un config.json con base (l'indirizzo), token, printer (la stampante) e poll (ogni quanti secondi chiede). Su Windows quel file sta nella stessa cartella dell'.exe; su Linux, in ~/.config/pedis-agent/config.json. Il printer dipende dal collegamento: network:192.168.0.50 per la stampante di rete, windows: per la coda predefinita di Windows, file:/dev/usb/lp0 per USB su Linux, serial:/dev/ttyUSB0 per seriale.

   Consiglio: Su Windows, installa la termica come coda Generic / Text Only: un driver che disegna la pagina rimescola i comandi e la carta esce sporca. Su Linux, se /dev/usb/lp0 dà permesso negato, esegui sudo usermod -aG lp $USER e rifai il login.

5. Fai una prova prima del servizio

   Prima di fidarti al pranzo, esegui un giro solo con la stampante dummy: il ticket compare sullo schermo, senza consumare carta. Poi manda un ordine di prova dal Tavolo e guarda uscire la carta: intestazione con il locale, il tavolo, il numero dell'ordine, il cameriere, la postazione e l'ora, e ogni voce a caratteri grandi, con l'aggiunta e la nota sotto.

6. Fallo partire da solo

   La cucina non ha tempo di ricordarsi di aprire un programma. Con pedis-agent --install, Windows crea un'attività che parte al login e Linux crea un servizio utente che si riavvia da solo se cade. Su un dispositivo senza nessuno collegato, come un Raspberry Pi dietro la TV, esegui anche sudo loginctl enable-linger. Per annullare, pedis-agent --uninstall.

7. Sul tablet Android è lo stesso percorso

   Se la cucina usa un tablet, l'app Android (dalla 5.0 in su) fa lo stesso lavoro e mostra anche lo schermo della cucina. Nella schermata iniziale compili Indirizzo, Token e Stampante (bt: e il MAC della termica Bluetooth già accoppiata, oppure net: e l'IP di quella di rete) e tocchi Salva e avvia. Concedi il permesso Bluetooth e togli l'app dal risparmio batteria, altrimenti la stampa si ferma quando lo schermo si spegne.

Domande frequenti

Glossario

Agente di stampa

Il programmino che gira sul dispositivo della cucina, recupera le comande da qmen.us, le stampa sulla termica e conferma.

Token di stampa

La password della stampa di una Cucina. Esce nel pannello, va nella configurazione dell'agente e puoi cambiarla quando vuoi.

Cucina

Il monitor dove gli ordini compaiono e avanzano da In preparazione fino a PRONTO.

ESC/POS

Il linguaggio che le stampanti termiche per comande capiscono. È ciò che l'agente genera per ogni comanda.

Risorse correlate