TRASMISSIONE DATI CON PROTOCOLLO XON-XOFF (1)

MANUALE D USO TRASMISSIONE DATI CON PROTOCOLLO XON-XOFF (1) Valid per: CUSTOM ENGINEERING: KUBE, MAX etc MWCR SAREMA: EXTRA, RECORD, SX3 SAREMA DITRON: Recrd EJ, JUMP, Grill EJ EMOTIQ : Opera e Nta COMPATIBILE WINDOWS VISTA / 7 / 8 (1): Prtcll XnXff Sarema Versine: 1.3.0.0 Manuale RTS WPOS1

INDICE MANUALE D USO...1 TRASMISSIONE DATI CON PROTOCOLLO XON-XOFF (1)...1 INDICE... 2 LEGENDA... 2 PREMESSA... 3 VERSIONI DEL PROGRAMMA... 3 COMPATIBILITA CON WINDOWS VISTA / 7 / 8...5 PROGRAMMAZIONE ECR... 5 FUNZIONALITÀ PRINCIPALI... 5 FUNZIONALITA' DEMO... 6 CONDIZIONE D'ERRORE... 6 ERRORE DI FINE CARTA SULL'ECR (cas particlare)...7 LISTA ERRORI... 7 SINCRONIZZAZIONE TRA PROGRAMMA APPLICATIVO CHIAMANTE E RTS WPOS1...7 SCHERMATA DI CONFIGURAZIONE...9 LEGENDA - RTS WPOS1: Prgramma " wpps1.exe" - PC: Persnal Cmputer - SW: Sftware su PC - FW: Firmware (SW embedded su eprm) - HW: Hardware - ECR: Registratre di cassa (Electrnic Cash Register) - SL: Sarema Language cmmunicatin prtcl 2

PREMESSA Il presente prgramma deve in gni cas essere installat sul PC direttamente cnness all'ecr e nn può quindi essere installat sl su un eventuale server. L utilizz di quest prgramma in ambiente WIN 98/2000/NT/XP/VISTA/7/8 permette di cllegare i registratri di cassa dtati di prtcll XON_XOFF, cn il PC tramite il cav il cui schema è descritt nel manuale del registratre stess. ATTENZIONE: Il cdice presente nella schermata di cnfigurazine del prgramma (dppi click sull icna in fnd a destra del mnitr) inserit nella casella di test di clre giall e cn la dicitura Matricla per Passwrd, dvrà essere cmunicat alla RTS per ttenere la passwrd da inserire nel file di START, cme illustrat nel seguit. VERSIONI DEL PROGRAMMA Il presente prgramma gestisce il cllegament da PC, per stampa di scntrini fiscali e nn fiscali, ai registratri di cassa che gestiscn il prtcll di cmunicazine denminat XnXff Sarema. 20/04/2007 : Versine 1.0.0.1 Inserita gestine Strn mancante su cmand PLUD 06/12/2007 : Versine 1.0.0.2 Inserita gestine parametr TX_FOOTER su mdelli famiglie CUSTOM MAX e KUBE (la data, ra e n. scntrin vengn riprtati sul file SR_OUT) 'Inserita gestine scntrini nn fiscali Inserita Gestine blcc / sblcc tastiera cn cdice "Y" se pagament nn ricevut su mdelli famiglie CUSTOM MAX e KUBE 09/04/2008 : Versine 1.0.0.3 Inserit cllegament, nel menu del prgramma, al manuale in frmat PDF del prgramma stess. Tale cllegament sarà attivabile sl se il lettre di tali tipi di files è già installat nel PC. Aggiunt cntrll per evitare duplicazine di sessini del prgramma stess. Attivata estensine del linguaggi SL per la gestine di prezzi cn numer di decimali superire a 2. Tale estensine, qui di seguit megli definita, è valida slamente per il cmand di vendita PLUD. 04/07/2008 : Versine 1.0.0.4 Crrett prblema presenza carattere virglette nella descrizine degli articli: il carattere viene sstituit cn l apice, nn significativ per il prtcll XnXff. 30/10/2009 : Versine 1.2.0.0 Inserita gestine cmpatibilità per Windws Vista Inserita Gestine cmand OPEN,N1; per apertura cassett 15/11/2010 : Versine 1.2.0.1 Crrezine su selezine baud-rate 57600 e 115200 Inserita gestine cmandi specifici per versine CUSTOM ENGINEERING 1. Cmand EXTL per stampa righe aggiuntive a fine scntrin 3

22/11/2010: Versine 1.2.0.2 Gestine di una nuva chiave di registr legata all'utente crrente (HKEY_CURRENT_USER) per frzare, da applicativ gestinale, la cartella di scambi dati tra PC e RTS Wps1. La chiave, creata autmaticamente all'installazine di RTS Wps1 cn valre null, può essere mdificata dal gestinale stess. La psizine è la seguente: HKEY_CURRENT_USER\Sftware\RTS Engineering\RTSWps1\CustmPathDataDir Attenzine: nn inserire l slash ( \ ) finale nella Path inserita. 12/05/2011: Versine 1.2.0.3 Crrezine su lettura chiave di registr per scambi dati cn gestinale. Nn leggeva crrettamente la path se questa era vuta. Inserita nuva CmbBx per selezinare la massima lunghezza delle descrizini da stampare DATE e TIME da Fter: sstituit frmat ra da HH-MM a HH:MM 24/10/2011: Versine 1.2.0.4 L'invi del cmand Y per sblcc tastiera Custm e' stat sttmess all'abilitazine delle funzini aggiuntive Custm. Gestine DEPO e PREL sl per Custm causa nn cmpatibilità cn nrmali cmandi SL XnXff (valid cmunque sl per Cntanti) Aggiunta creazine sttcartella Trace in autmatic stt CurrentDataDir Inserita mdalità specifica Ditrn cn gestine recuper credit (simulat: la funzine nn esiste su Ditrn) 17/02/2012: Versine 1.2.0.5 Crrezine nella gestine dei cmandi Res e Strn assciati al cmand PLUD 10/08/2012: Versine 1.2.0.6 Velcizzata la rispsta del prgramma nella rilevazine dei files di input SR_START e SR_DATI. Il timer settat nrmalmente ad 1 secnd viene utilizzat sl in partenza durante la fase di esecuzine del Dump di cnfigurazine. Il messaggi di PRONTO viene scritt nella casella precedentemente utilizzata nella prgrammazine del timer. Crrezine su mancata ricezine del Fter nel cas di chiusura a Credit 23/01/2013: Versine 1.2.0.7 Inserita gestine specifica per marca 3I, cn cntrlli aggiuntivi sui cmandi DISP, DEPO, PREL (EXTL e BARC nn tradtti piche' nn gestiti da 3I) Gestine stampa barcde (sl Ean8,ean13,cde39) sia fiscale che nn fiscale. ATTENZIONE: sl per TIPO CUSTOM ENG. 4

Fix su gestine cmand SL_Disp 04/06/2013: Versine 1.2.0.8 Fix: la selezine di tip "Standard" blccava la cnversine dei dati 16/05/2014: Versine 1.2.0.9 Inserit trace anche su Dump di cnfigurazine Fix su gestine invi cmand "Y" Sstituita stringa di test da K a KK causa generazine errre su alcuni mdelli di macchine (es. SHS) 24/04/2015: Versine 1.3.0.0 Gestine stampa QR Cde sl per CUSTOM 23/06/2015: Versine 1.3.0.1 Inserita gestine del cllegament XnXff cn mdelli Emtiq: Opera e Nta COMPATIBILITA CON WINDOWS VISTA / 7 / 8 La presente versine di RTSWPOS1 è cmpatibile cn le specifiche e/ restrizini impste dal nuv sistema perativ (OS) Micrsft Windws Vista, Sette e Ott. RTSWPOS1 verifica autmaticamente il tip di OS: nel cas di OS antecedente a Vista, si cmprta esattamente cme nel passat (directry di scambi dati cincidente cn quella di installazine del prgramma), mentre cn il nuv OS Vista la directry pubblica di scambi dati cn il client (gestinale altr) accessibile sia in lettura che scrittura e la seguente: C:\PrgramData\RTSWPOS1 Tale directry sarà creata alla installazine del prgramma e visualizzata sia durante questa fase che durante il funzinament in una casella di test presente nella schermata di cnfigurazine del prgramma stess. ATTENZIONE: Si ricrda infine di installare il prgramma RTSWPOS1 cme Amministratre. PROGRAMMAZIONE ECR L ECR dvrà essere prgrammat in mdalità di cmunicazine Xn-Xff e avrà la pssibilità di gestire diverse velcità di funzinament, a secnd di quelle previste dall Ecr stess. IMPORTANTE: e necessari attivare la mdalità ECO nella attivazine della mdalità XnXff degli ECR. Mdelli Ditrn-Sarema: In tali mdelli, per attivare il prtcll XnXff eseguire la seguente sequenza (selezine cn tast SUBTOTALE e CONFERMA cn tast TOTALE): a) 4 Chiave 5

b) 9 SUBTOTALE c) Selezinare la prta seriale d) TIPO: selezinare : XON-XOFF e) PROTOCOLLO: selezinare 40185 (per 9600,8,n,1) (NB: l ultima cifra deve essere 5) f) TIPO XONXOFF: selezinare 0 g) OPZIONI XONXOFF: selezinare 1 h) Premere FINE due vlte i) Premere 101 TOTALE j) Premere 1 CHIAVE per trnare in psizine di lavr Mdelli CUSTOM MAX: In tali mdelli, per attivare il prtcll XnXff è necessari selezinare il menu delle PROGRAMMAZIONI PROTETTE e alla vce PROTOCOLLO-PC, selezinare XONXOFF-9600 (cn ec). FUNZIONALITÀ PRINCIPALI Il prgramma RTS WPOS1 permette di trasmettere da un PC perante stt ambiente perativ WIN-98/2000/NT/XP/VISTA/7/8 un file cntenente la rappresentazine di un scntrin fiscale in frmat SAREMA LANGUAGE (SL). L'interfacciament cn gli applicativi PC avviene esclusivamente tramite un numer limitat di files di test, che verrann descritti nel seguit. Una vlta lanciata l'esecuzine di RTS WPOS1 (WPPOS1.EXE), dp una breve schermata iniziale, si riduce autmaticamente ad icna psizinandsi accant all'ra e si predispne a ricevere gli pprtuni cmandi per ptere avviare la trasmissine di files all'ecr. Le risrse principali impegnate da RTS WPOS1 sn le seguenti: La prta di cmunicazine (COM1,2,3,4) Un timer Le fasi principali del funzinament sn le seguenti: 1. Esecuzine del cmand di "DUMP di CONFIGURAZIONE" dell'ecr cn test autmatic di cllegament. 2. Attivazine del timer (riprgrammabile) LOOP STANDARD: 3. All scadere di gni cicl del timer, RTS WPOS1 verifica l'esistenza dei seguenti files: SR_START.00x --> file generat dall'applicativ che segnala la dispnibilità dei dati da trasmettere all'ecr e cntiene la passwrd per l'attivazine del prgramma (rilasciata da RTS). SR_DATI.00x --> file generat dall'applicativ che cntiene i dati da trasmettere all'ecr 4. Se i due file suddetti sn presenti, RTS WPOS1 attiva la trasmissine del file dati all'ecr. 5. A fine trasmissine all'ecr, cancella il file di START e il file DATI, e crea un file denminat SR_OUT.xxx in cui viene memrizzat l'immagine dell scntrin stampat dal registratre di cassa, e un file FINESCO.xxx che indica che l scntrin è stat stampat crrettamente. In cas si verificasser degli errri, verrebbe creat un file denminat SR_ERR.xxx al pst del file Finesc.xxx. 6

6. RTS WPOS1 trna al punt 3 in attesa di una nuva cppia di files. Per terminare il prgramma è sufficiente psizinarsi sull'icna, cliccare il tast destr del muse e selezinare "TERMINA WPOS1". FUNZIONALITA' DEMO Quest prgramma, se nn viene cmunicata la passwrd necessaria per in su funzinament, può cmunque essere utilizzat in fase di test in mdalità dem. Tale funzinalità cnsente di stampare un massim di 2 riga di scntrin, in cas in file inviat ne cntesse di più il prgramma chiuderà in autmatic la cmunicazine dp averne stampate 2. Tale funzinalità si utilizza inserend nel file Sr_start.00x, al pst della passwrd la dicitura "DEMODEMO" CONDIZIONE D'ERRORE Al verificarsi di una delle seguenti cndizini di errre, il prgramma RTS WPOS1 chiude la sessine di cllegament cn l'ecr scrivend un file denminat "SR_ERR.00x" cntenente la descrizine dell'errre nel seguente frmat: Exxx: "... descrizine dell'errre..." Ove si ha: "E" : fiss "xxx" : cdice dell'errre "..." : messaggi autesplicativ dell'errre NOTA: Nel cas di errre si ha cmunque la cancellazine del file di START e RTS WPOS1 si riprta all stat 3. Nel seguit viene riprtata una lista delle cndizini di errre ad ggi dispnibili. ERRORE DI FINE CARTA SULL'ECR (cas particlare) Nel cas di errre di fine carta girnale scntrin sull'ecr, il prgramma RTS WPOS1 genera un file di errre cme spra descritt ma senza cancellare il file di START e mantenend aperta la sessine di cllegament cn l'ecr fin a che l'peratre nn rimuve la cndizine di errre sull'ecr stess. Quindi RTS WPOS1 cancella il file di ERRORE e, al termine della sessine, cancella anche il file di START e il file DATI cme nel cas di cnnessine terminata crrettamente. I messaggi riprtati sul file di ERRORE in tale cas sn i seguenti: "E096: Fine carta scntrin, sstituire il rtl e premere C sull'ecr" "E097: Fine carta girnale, sstituire il rtl e premere C sull'ecr" LISTA ERRORI "E500: Start Passwrd errata" "E501: Dump nn eseguit, verificare se Ecr in errre nn cnness" 7

"E502: Nessuna prta di cmunicazine dispnibile" "E503: Scntrin apert, chiudere e riavviare l'esecuzine" "E504: Nessun messaggi ricevut: cntrllare cnnessine cn l'ecr" "E505: Trasmissine nn avvenuta: cntrllare cnnessine cn l'ecr" "E506: Trasmissine nn avvenuta: file di input nn presente" "E507: Trasmissine interrtta: prbabile cmand errat" "E092: Chiave Ecr in psizine; spstare in REG e riavviare l'esecuzine" "Exxx: Errre generic sull'ecr; crreggere e riavviare l'esecuzine" (xxx = cdice di errre sull'ecr, errre SL) SINCRONIZZAZIONE TRA PROGRAMMA APPLICATIVO CHIAMANTE E RTS WPOS1 Per ttenere la crretta sincrnizzazine tra prgramma applicativ chiamante e RTS WPOS1, si cnsiglia di seguire la seguente prassi: Chiamata: Creare il file di DATI Creare il file di START Attesa terminazine RTS WPOS1: Viene cancellat il file di START e creat il file FINESCO in cas di transazine andata a bun fine Viene cancellat il file di START e creat il file di ERRORE in cas si verifichi una qualunque cndizine di errre Si fa infatti ntare cme la nrmale sequenza di cancellazine dei files al termine di una sessine di trasmissine senza errri da parte di RTS WPOS1 e' la seguente: Eventuale cancellazine del file di ERRORI Cancellazine del file di DATI Cancellazine del file di START Creazine del file FINESCO 8

SCHERMATA DI CONFIGURAZIONE ATTENZIONE: Il cdice presente nella schermata di cnfigurazine del prgramma (dppi click sull icna in fnd a destra del mnitr) inserit nella casella di test di clre giall e cn la dicitura Matricla per Passwrd, dvrà essere cmunicat alla RTS per ttenere la passwrd da inserire nel file di START, cme illustrat nel seguit. 9