Modulo Stampanti Termiche ESC/POS¶
Il modulo Stampanti governa l'integrazione hardware tra AssegnaPosti e le stampanti termiche di ricevute ESC/POS (Epson, Custom, Bixolon, Star Micronics, Axiohm). Permette di censire stampanti sia di rete (TCP/IP porta 9100) sia locali USB/Windows, eseguire test diagnostici con taglio carta e apertura cassetto, e mappare ciascun account operatore alla stampante fisica del proprio banco cassa (/Stampanti/Assign).
1. Architettura di Stampa ESC/POS¶
AssegnaPosti invia sequenze di byte native ESC/POS direttamente alle stampanti, bypassando i lenti driver grafici di Windows e garantendo stampe istantanee in frazioni di secondo:
flowchart TD
A[Operatore Cassa Emette Scontrino] --> B{Rilevamento Stampante Utente}
B -->|UserStampante /Stampanti/Assign| C[Stampante Assegnata all'Account]
C --> D{Tipo di Collegamento}
D -- Di Rete / Ethernet / Wi-Fi --> E[Socket TCP/IP Diretto :9100]
D -- USB Locale / Windows --> F[Spooler RAW Windows / API USB-NET]
E & F --> G[Generazione Byte ESC/POS Epson Standard]
G --> H[Stampa Testata Sagra + Dati Gruppo]
G --> I[Stampa Importi e Sconti Applicati]
G --> J[Generazione QR Code Accesso Varco]
G --> K[Taglio Automatico Carta Full Cut]
G -->|Se HaCassetto=true| L[Impulso Elettrico RJ11 Pin 2 Apertura Cassetto]
2. Configurazione e Censimento Stampanti (/Stampanti/Index, /Stampanti/Create)¶
Dalla sezione Stampanti del menu principale, l'amministratore può configurare l'elenco dei dispositivi hardware disponibili nella struttura.

┌────────────────────────────────────────────────────────────────────────┐
│ AGGIUNGI STAMPANTE │
├──────────────────────────┬─────────────────────────────────────────────┤
│ Nome Dispositivo * │ Es. "Cassa 1 - Banco Centrale" │
│ Tipologia Collegamento * │ [ Rete (TCP/IP) ▼ ] │
│ Indirizzo IP / Hostname │ 192.168.1.150 (Porta 9100 predefinita) │
│ Cassetto Rendiresto │ [✓] Dotata di cassetto rendiresto RJ11 │
├──────────────────────────┴─────────────────────────────────────────────┤
│ OPZIONI DI FORMATTAZIONE CARTA │
├──────────────────────────┬─────────────────────────────────────────────┤
│ Larghezza Rotolo Termico │ 80 mm (consigliata per QR code) / 58 mm │
│ Densità / Emulazione │ EPSON Standard ESC/POS │
└──────────────────────────┴─────────────────────────────────────────────┘
Parametri di Configurazione¶
| Campo | Tipo | Descrizione |
|---|---|---|
| Nome | Testo | Nome descrittivo assegnato alla stampante (es. Cassa Principale, Cassa Bar). |
| Tipo | Enum | Rete (comunicazione diretta socket su rete LAN/Wi-Fi) oppure Windows (coda di stampa locale del sistema operativo). |
| Indirizzo | Testo | Per stampanti di rete: indirizzo IP statico (es. 192.168.1.50). Per stampanti Windows: nome esatto della coda stampante (es. POS-80). |
| HaCassetto | Booleano | Spuntare se alla stampante è collegato fisicamente un cassetto cassa metallico tramite cavetto telefonico RJ11. |
Assegnazione IP Statici
Per le stampanti termiche Ethernet/Wi-Fi si raccomanda caldamente di configurare sul router della sagra un indirizzo IP statico (o DHCP reservation sul MAC address), evitando che un riavvio del router modifichi l'indirizzo della stampante durante l'evento.
3. Assegnazione Stampante all'Operatore (/Stampanti/Assign)¶
In contesti con molteplici postazioni di cassa affiancate (es. 2 o 4 cassieri che operano in contemporanea sotto lo stesso tendone), è indispensabile che ciascun cassiere riceva gli scontrini dalla stampante fisica situata sul proprio banco.
┌────────────────────────────────────────────────────────┐
│ ASSEGNAZIONE STAMPANTE UTENTE │
├────────────────────────────────────────────────────────┤
│ Seleziona Utente: [ cassiere1@sagra.local ▼ ] │
│ Assegna a Stampante: [ Cassa 1 - Banco Sinistro ▼ ] │
│ │
│ [ 💾 Salva Associazione ] │
└────────────────────────────────────────────────────────┘
- Accedere a
/Stampanti/Assign. - Selezionare l'account dell'operatore autenticato (
IdentityUser). - Scegliere la stampante fisica corrispondente alla sua postazione.
- Cliccare su Salva Associazione:
- Il sistema memorizza l'accoppiamento nella tabella
UserStampanti. - Da quel momento in poi, ogni scontrino emesso da quel cassiere verrà indirizzato istantaneamente alla stampante corretta.
- Il sistema memorizza l'accoppiamento nella tabella
4. Test di Stampa e Apertura Cassetto (/Stampanti/Test)¶
La pagina di test permette di verificare in modo inequivocabile il funzionamento della stampante e del cassetto prima di iniziare la vendita:
┌────────────────────────────────────────────────────────┐
│ TEST STAMPANTE: Cassa 1 - Banco Centrale │
├────────────────────────────────────────────────────────┤
│ Indirizzo: 192.168.1.150:9100 | Protocollo: Rete │
│ Cassetto Rendiresto Collegato: SÌ │
│ │
│ [ 🖨️ INVIA SCONTRINO DI PROVA ] │
│ │
│ [Esito: Test di stampa inviato con successo! ✓] │
└────────────────────────────────────────────────────────┘
Cosa Esegue il Test¶
Quando si preme il pulsante Invia Scontrino di Prova:
1. Apre un socket verso la stampante sulla porta 9100.
2. Invia i comandi di inizializzazione standard EPSON.
3. Stampa un'intestazione in grassetto con nome del dispositivo, data, ora e indirizzo di rete.
4. Esegue l'avanzamento carta ed il taglio netto automatico (FullCutAfterFeed(5)).
5. Se HaCassetto = true, genera l'impulso elettrico a 24V sul pin 2 della porta RJ11 (CashDrawerOpenPin2()), facendo scattare l'apertura del cassetto portamonete.
5. Specifiche dei Formati Carta (80mm vs 58mm)¶
AssegnaPosti supporta i due standard internazionali di rotoli termici:
┌───────────────────────────────────┬───────────────────────────────────┐
│ ROTOLO 80 MM (Standard Consigliato)│ ROTOLO 58 MM (Compatto / Portatile)│
├───────────────────────────────────┼───────────────────────────────────┤
│ • Larghezza stampa: 48 caratteri │ • Larghezza stampa: 32 caratteri │
│ • QR Code grande ad alta densità │ • QR Code a dimensione ridotta │
│ • Dettaglio completo quote │ • Stampa essenziale senza grafiche│
│ • Spazio ottimale per sponsor │ • Usato su stampanti mobili Wi-Fi │
└───────────────────────────────────┴───────────────────────────────────┘
Per ottenere la massima rapidità di lettura ottica ai varchi con lo smartphone, si raccomanda l'uso di rotoli termici ad alta sensibilità da 80 mm.