Manuale SMS Machine HTTP WapPush versione 1.0.9
Contents
1. u u u u u J J J 29 Identificativo della SMS Machine I n sunan 29 Ricezione SMS nuan RO RR O I A RA 29 Ricezione SMS estesi Li ia Ra again ZE ZE apa p aa ad 30 Ricezione SMS notifica di Consegna i 30 Trasmissione SMS u u aaa o aaa A ALIENE AE ORALE RARA TERRANI RARA Ri 30 Richiesta notifica di ricezione isa eine loda loda lane ladini 31 SMS noniinviati TL RA IRE RA 31 GONfIGUrAZIONe tz i a oa iii 32 Interrogazione dello stato di funzionamento I nenea nenea nenea nenea nenea nenea 32 Interrogazione dei parametri di rete e di CONfigurazione ii 33 Simulazione di ricezione SMS i 34 Appendice esempio di integrazione con il PHP Errore Il segnalibro non definito Esempio 1 Ricezione di un SMS e replica su e mail Errore Il segnalibro non definito Esempio 2 Trasmissione di un 5 5 Errore Il segnalibro non definito SMS Machine HTTP PUSH Manuale Utente Pagina 6 SMS Machine 2009 Area SX srl Descrizione del prodotto SMS Machine HTTP PUSH un apparato di comunicazione che consente la rapida integrazione delle vostre applicazioni Web con la messaggistica SMS su rete GSM La novit di ques2. a Cau S y Asa 23 PILTPS Ia Nu D D aaa SSS Au S S Sha u a es 23 Delivery Status 23 One e cara E a a oa E aan 24 Configuration Test n a kaqa a ia et a a at a e aa a ta at 24 Send n RX simula ion ss ea uuu i huq a ai Aa ia Do at 24 Sengd Messag6 uuu ceea i cata da e a ga Lt dealer ciali apra 24 Logout ae aan alia nia da ae Dalia Ea mea ma EEG ii mru sa all Na 25 SMS Machine HTTP PUSH Manuale Utente Pagina 5 SMS Machine 2009 Area SX srl Ripristino della configurazione di fabbrica U ea u u u uu u u 26 Caratteristiche tecniche maneca u uu u u u u u u uu u 27 PrestaziOni citea a 27 Caratteristiche del modem GSM Interno aaa amana ana 27 Caratteristiche del network processor interno iii 27 Caratteristiche elettriche dell alimentatore esterno iii 27 Caratteristiche elettriche SMS Machine HTTP PUSH U na nn aaa ana nana 27 Supporto tecnico tira iii asada qasa a a ein Lit 28 SMS Machine Page iii 28 Aggiornamenti firmware t siarata iii aio fail alii 28 Appendice A Interfaccia http U U
3. Ma SE ridi TAE de EI Ca ida ae ba lie iis AE oaie sma 18 ur sata aaa a A ba a ata o o a a 18 EE ali i sea ceai ea Cas e es ua o cel i ii iu 18 New password Repeat password ui 18 Sira ie e ro ion ii ani 18 Message service center number u 18 IR I i ie a dal egale e e a 19 Destination server Address e noi lana da la ia i i a a iat ta ad 19 Destination rever u a A asal ai aaa Do ai 19 TOP Port NUMbEria wanun a PERA aa ga a aa AB ARA 19 SECUrIIVICOdE ku E aaa ella a iii e ia 19 Use HTTP HEAD for script checking ta E da a ta a ia elia 19 Send a POST when a RING is received nenea nea aaa nana aaa amana aa 20 u e eta aa e ba t aa e e Ru dt pl at a Rat bl eat i Va a Rl a cat 20 Maximum server delivery trieSs nea manea manea manea manea manea maneaua manea 20 Timeout waiting for server answer nenea nenea u 21 Incoming messages buffer length a a nea enma amana ETA 21 Nome delle variabili della COMUNICAZIONE i 21 Current Status oii ia ae sese ale lei lei i iano 22 CSR I
4. LAN configurazione di rete IP Address E il nuovo indirizzo che eventualmente intendiamo assegnare alla SMS Machine HTTP PUSH Infatti se l indirizzo di default 192 168 0 101 non adatto alla nostra rete possiamo scegliere di assegnare alla SMS Machine HTTP PUSH un qualsiasi altro indirizzo SMS Machine HTTP PUSH Manuale Utente Pagina 17 SMS Machine 2009 Area SX srl Attenzione cambiato l indirizzo o altri parametri di rete si veda anche oltre la SMS Machine HTTP PUSH notifica con un popup che sono state apportate modifiche ed effettua un reboot della interfaccia di rete Quindi non risponde pi ai comandi del men se non per quanto gi nella cache del browser Per questo occorre effettuare il logout e reindirizzare il browser al nuovo indirizzo assegnato alla SMS Machine HTTP PUSH Netmask E la netmask della rete in cui inserita la SMS Machine HTTP PUSH Per default il valore 255 255 0 0 Anche in questo caso cambiando la netmask sar necessario effettuare di nuovo il login Gateway l indirizzo IP di un server in grado di instradare su rete esterna tutti i pacchetti non indirizzati a macchine attestate sulla rete locale Questo parametro deve essere configurato solo se la SMS Machine HTTP PUSH deve raggiungere server con indirizzo IP fuori dalla rete locale ad es su Internet DNS E l indirizzo IP di un server DNS valido Questo parametro deve essere configurato solo se si intendono usar
5. E un contatore degli SMS che la SMS Machine HTTP PUSH non riesce effettivamente a consegnare alla rete GSM ad esempio per credito esaurito o Centro Servizi errato o assenza campo Questi messaggi dopo i tentativi di invio sono scartati dalla coda Other Info In questa riga indicata la versione di firmware presente nella memoria FLASH della SMS Machine HTTP PUSH Configuration Test Questa pagina consente di provare le impostazioni della SMS Machine HTTP PUSH sia per la ricezione che per l invio di SMS www areasx com This functions allows you to test your configuration parameters Advanced Use the button below to send a simulated SMS reception request to the configured server Current Status Send an RX simulation Use the form below to send an SMS from the SMS Machine SIM card Message Text Destination Number Push Destination Port Logout Send Message Release 1 01 Pagina di prova delle impostazioni Send an RX simulation Con questo tasto si forza la macchina alla simulazione della ricezione di un SMS e consente di provare la correttezza della configurazione HTTP la SMS Machine HTTP PUSH genera una transazione HTTP verso il WEB server e lo script specificati nella maschera HTTP passando dei parametri di default Send Message Con questo tasto si forza la macchina all invio immediato di un SMS e consente di provare il corretto funzionamento del mod
6. Quando la SMS Machine riceve un SMS i dati relativi al messaggio vengono passati ad uno script Web con una transazione HTTP POST In pratica la SMS Machine simula il comportamento che ha un browser Web quando invia un form HTML compilato come gi visto descrivendo l interfaccia Web di configurazione per l impostazione di tale script Ad esempio se lo script impostato http www areasx com smstest rxmsg php ad ogni SMS ricevuto la SMS Machine richiamer lo script rxmsg php presente all interno della directory smstest del server Web www areasx com passando quattro variabili e sms numero di telefono del mittente dell SMS e sms date data di trasmissione dell SMS nel formato AAAA MM GG HH MM SS GMT 00 e sms texttesto del messaggio e sms code password di accesso allo script Web se specificata nella configurazione In risposta dal Web server la SMS Machine si aspetta il messaggio standard del tipo HTTP 200 OK Negli altri casi la transazione considerata incompleta e la SMS Machine si comporter come definito nella sezione di configurazione Advanced alla quale si rimanda per dettagli SMS Machine HTTP PUSH Manuale Utente Pagina 29 SMS Machine 2009 Area SX srl Ricezione SMS estesi La nuova versione SMS Machine in grado di ricevere anche messaggi estesi o concatenati ossia contenenti pi dei 160 caratteri dello standard Tuttavia ciascun SMS esteso in realt suddiviso in tanti SMS quanti sono ne
7. 160 per SMS ordinari fino a 300 caratteri per SMS estesi o concatenati caratteri eccedenti sono ignorati Push per definire se il messaggio di tipo normale Push 0 o Wap Push Push 1 o altro valore messaggi di tipo Wap Push interagiscono direttamente col terminale di destinazione come gi descritto in precedenza In particolare con il valore Push 1 l SMS recapita un hyperlink e altri valori possono interagire con applicazioni J2ME ad esempio Si veda oltre per la descrizione della formattazione di un messaggio di tipo Wap Push Pwd la password di accesso allo script e coincide con la password di accesso usata in fase di Login Current Status Questa pagina ciccando sul tasto Refresh mostra alcune informazioni sul corrente stato di funzionamento della SMS Machine HTTP PUSH SMS Machine HTTP PUSH Manuale Utente Pagina 22 SMS Machine 2009 Area SX srl a leche O HTTP GSM Status Advanced GSM Field level E RI 87 dem Modem status Gsm Ok HTTP Status Lan status Server Connection OK O Configuration Test Delivery Status SMS Received via HTTP SMS Queued to the GSM Modem 0 SMS Received from GSM Modem SMS sent to the Server o SMS Trasmissions Failed Other Info Logout Firmware version HTTP01 03 AX x Refresh Release 1 01 Stato di funzionamento GSM Status e GSM Field Level E un indicatore del livello di
8. PUSH Nel caso non dovesse ancora accadere verificate di aver effettuato le seguenti operazioni e Disabilitato la richiesta di PIN da parte della carta SIM tramite un normale telefono cellulare e Verificato che la carta SIM abilitata e Verificato che nel punto in cui stata posizionata l antenna ci sia sufficiente campo Significato delle spie sul pannello frontale Spia gialla GSM Questa spia indica l attivit in corso del modem GSM Un lampeggio rapido indica che il modem sta tentando di registrarsi alla rete GSM Quando il lampeggio diventa pi lento significa che il modem si registrato e la SMS Machine HTTP PUSH pronta a funzionare Spia verde PWR Questa spia indica il corretto funzionamento della sezione di alimentazione Spia rossa ERR Questa spia indica una condizione d errore rilevata dal microprocessore di gestione della SMS Machine HTTP PUSH All accensione rimane accesa finch il modem non si registrato e si spegne appena la registrazione stata completata Il lampeggio contemporaneo di questa spia e della L1 segnala l invio fallito di un SMS ad esempio per credito esaurito o Centro Servizi non corretto Spia verde L 1 Questa spia indica il transito di un SMS in trasmissione nella memoria della SMS Machine HTTP PUSH La sua accensione contemporanea a quella della spia rossa ERR indica il mancato o non corretto inserimento della SIM nel modem GSM o ancora il PIN non disabilitato Spia verde L 2 L
9. accensione o il lampeggio di questa spia indica l impossibilit di raggiungere il server web cui inviare gli SMS ricevuti SMS Machine HTTP PUSH Manuale Utente Pagina 14 SMS Machine 2009 Area SX srl Configurazione della SMS Machine HTTP PUSH Configurazione di rete II primo passo da compiere per configurare la SMS Machine HTTP PUSH metterla in rete con un corretto indirizzo IP ed una corretta Netmask Per default la SMS Machine HTTP PUSH configurata per rispondere all indirizzo IP 192 168 0 101 e dispone di una netmask uguale a 255 255 0 0 Assicuratevi che la SMS Machine HTTP PUSH sia collegata in LAN con il Vostro PC tramite un Hub Switch da 10 100Mb e che l indirizzo TCP IP usato dal vostro PC sia compreso tra 192 168 1 1 e 192 168 1 254 ad esclusione ovviamente di 192 168 1 101 usato dalla SMS Machine HTTP PUSH e che la netmask sia 255 255 0 0 o 255 255 255 0 La connessione tra il Vostro PC e la SMS Machine HTTP PUSH oltre che tramite Hub Switch pu essere effettuata direttamente utilizzando un cavo di rete incrociato CROSS OVER Una volta ottenute queste condizioni la SMS Machine HTTP PUSH dovrebbe poter rispondere ad un semplice ping all indirizzo 192 168 0 101 Per effettuare un ping sulla SMS Machine HTTP PUSH sufficiente lanciare un prompt DOS di comandi e quindi digitare il comando C gt ping 192 168 0 101 Se la risposta al ping corretta potete passare alla fase di configurazione Int
10. indicati scarter il messaggio SMS corrente e passer al successivo Se invece il parametro settato a 0 valore di default allora la SMS Machine HTTP PUSH non scarter mai il messaggio e cercher sempre la trasmissione verso lo script Risulta chiaro che nel primo caso si pu velocizzare la ricezione SMS verso lo script ma si rischia la perdita dei messaggi SMS scartati per qualche tentativo fallito Nel secondo caso nessun messaggio andr perso ma la comunicazione potrebbe rallentarsi ad esempio in corrispondenza di traffico di rete Caso estremo l indisponibilit dello script che pu causare la saturazione della memoria SIM riservata agli SMS ricevuti Il Centro Servizi del gestore interromper allora nuovi recapiti in attesa che la SIM venga svuotata dalla SMS Machine HTTP PUSH e conserver i messaggi per il numero di ore di validit configurato in invio tipicamente dalle 24 alle 72 h Timeout waiting for server answer Questo parametro indica il tempo di attesa timeout appunto tra la richiesta HTTP POST effettuata dalla SMS Machine HTTP PUSH verso lo script di destinazione e la sua risposta con un 2000K Scaduto questo tempo la macchina considera la transazione fallita e intraprende le contromisure previste dalla configurazione descritta in precedenza ovvero nuova trasmissione o eliminazione dell SMS dalla memoria SIM L unit di misura il millisecondo e il valore di default fissato in 5000 msec 5 sec
11. link Il campo testo dovr essere configurato come specificato sopra Se infine la porta assume altri valori allora sar necessario sapere a priori che tali valori di porta sono proprio quelli usati dalle applicazioni residenti sui terminali di destinazione tipicamente J2ME e responsabili della gestione degli SMS inviati con questo formato Logout l uscita dalle pagine di configurazione e il ritorno alla schermata principale SMS Machine HTTP PUSH Manuale Utente Pagina 25 SMS Machine 2009 Area SX srl Ripristino della configurazione di fabbrica E possibile ripristinare in qualsiasi momento la configurazione di fabbrica della SMS Machine HTTP PUSH Questa operazione pu essere utile nel caso in cui non sia pi possibile accedere alla SMS Machine HTTP PUSH perch si dimenticata la password o l indirizzo IP Per farlo seguite questa procedura e Spegnete la SMS Machine HTTP PUSH e ldentificate il pulsante di reset sul pannello posteriore come indicato in figura e Mantenetelo premuto mentre riaccendete la SMS Machine HTTP PUSH e Attendete il pulsante premuto finch i led ERR e 12 lampeggiano contemporaneamente In questo modo la SMS Machine HTTP PUSH si riavvier con la configurazione di default di tutti i parametri in particolare sar di nuovo accessibile all indirizzo IP 192 168 0 101 netmask 255 255 0 0 e password di accesso SMS1234 Il tasto per il ripristino della configurazione di def
12. richiesta Per default configurata la porta 80 Security code E la parola chiave che la SMS Machine HTTP PUSH pu usare per autenticarsi nella comunicazione con lo script sul server web Il suo contenuto deve essere ovviamente allineato quello usato in tale script per la ricezione degli SMS Use HTTP HEAD for script checking La SMS Machine HTTP PUSH verifica la raggiungibilit dello script di destinazione degli SMS configurato come descritto sopra Infatti se lo script risultasse non raggiungibile sarebbe inutile iniziare transazioni http impegnando senza risultati l interfaccia di rete e il processore Questa verifica pu avvenire in due modi determinati dalla spunta di questo parametro SMS Machine HTTP PUSH Manuale Utente Pagina 19 SMS Machine 2009 Area SX srl Se la casella resta senza la spunta la SMS Machine HTTP PUSH effettua una verifica semplicemente instaurando e chiudendo una connessione TCP IP verso server e porta configurati come descritto sopra Se invece la casella spuntata allora il controllo pi approfondito e prevede la verifica completa dello script con una richiesta di tipo HTTP HEAD Si noti che per alcune implementazioni di Web Server la richiesta provoca la risposta della sola intestazione dello script header appunto senza la completa esecuzione del codice Per altre invece la richiesta pu provocare l esecuzione dell intero codice dello script perci necessario tenere a men
13. server before discarding If it s set to 0 the SMS transfer will be tried forever Current Status Timeout waiting for server answer millisec 5000 This parameter sets the number of milliseconds that SMS Machine will wait Configuration Test for the server to answer to the socket request Incoming messages buffer length 1 This parameter sets the maximum number of SMS messages that can be kept in the SMS Machine buffer waiting to be delivered to the server A larger number can improve the SMS troughput but you will be exposed to buffered SMS losses if the power fails If the parameter is set to 1 the troughput may be slower but you will not lose SMS s if a power failure happens Warning wrong settings of the parameters in this page may cause Logout incorrect behaviour of SMS Machine Save Release 1 01 Advanced parametri avanzati della comunicazione http Maximum server delivery tries Questo parametro indica il numero massimo di tentativi che la SMS Machine HTTP PUSH effettua nel trasmettere i dati degli SMS ricevuti verso lo script di destinazione Infatti non detto che la transazione vada a buon fine al primo tentativo ad esempio per indisponibilit temporanea del server SMS Machine HTTP PUSH Manuale Utente Pagina 20 SMS Machine 2009 Area SX srl traffico di rete o banalmente perch lo script non correttamente configurato In questi casi la macchina dopo il numero di tentativi
14. Il criterio per la scelta di questo parametro prevede la conoscenza del comportamento medio dello script di ricezione ad esempio tempi di elaborazione tempi di accesso a DB etc e del traffico di rete o dei tempi di instradamento ad esempio LAN o Internet Si noti che bassi valori del timeout possono velocizzare la trasmissione ma espongono al rischio di considerare fallita una transazione semplicemente lenta e provocare ad esempio ritrasmissioni Viceversa valori alti del timeout potrebbero rallentare le transazioni non essendo riconoscibili velocemente quelle fallite ma prevengono da inutili ritrasmissioni in caso di elaborazioni lente Incoming messages buffer length La SMS Machine HTTP PUSH pu scaricare i nuovi messaggi SMS arrivati sulla SIM uno ad uno oppure in maggior numero memorizzandoli temporaneamente in un buffer nella attesa di trasmetterli verso lo script Questo parametro determina proprio la grandezza di questo buffer e il valore di default fissato a 1 il valore massimo 10 Un buffer pi ampio velocizza le operazioni di ricezione diminuendo infatti gli accessi alla memoria della SIM ma espone a rischio perdita trattandosi di una memoria volatile se ad esempio la macchina viene spenta Di contro il buffer fissato a 1 impedisce la perdita di SMS memorizzati in SIM anche in caso di spegnimento accidentale ma rallenta potenzialmente la ricezione Appare chiaro a questo punto che le operazioni di ricezione possono e
15. SMS Machine 2009 Area SX srl a E http www areasx com SMS Machine HTTP PUSH Gateway LAN SMS con tecnologia WAP Push Manuale utente Versione Firmware 1 0 9 SMS Machine HTTP PUSH Manuale Utente Pagina 1 SMS Machine 2009 Area SX srl Congratulazioni per aver scelto SMS Machine Area SX srl Vi ringrazia per la preferenza accordataci con la scelta di un apparato della linea SMS Machine e rimane a Vostra disposizione per qualsiasi richiesta di chiarimenti tecnici e commerciali Come contattarci Informazioni aggiornate sui prodotti della linea SMS Machine e sulle ultime revisioni di software sono accessibili sul nostro sito internet all indirizzo http Avww areasx com Impostazioni ri a E o pagina gt j Strumenti gt z W GATEWAY ICT Solutions SMS lt gt HTTP Home Articoli Divulgativi Listino Prodotti Le ultime novit Carrello Elettronico Contatti e Supporto Piiuova SMS Machine HTTP PUSH i ULrIMI ARTICOLI Articoli Divulgativi 5 7 Listino Prodotti Una nuova versione per la fortunata SMS Machine HTTP perfettamente compatibile SMS Machine HTTP A ASE Tematiche con la precedente la nuova release consente anche l invio di messaggi di tipo attivo in grado di interagire direttamente con il terminale mobile che li riceve In particolare possono essere inviati messaggi contenenti link o diretti verso applicazioni Java re
16. a del pannello posteriore della SMS Machine HTTP WAP PUSH 1 Presa per l antenna GSM Per scongiurare danni al modem GSM interno evitate accuratamente di accendere la SMS Machine HTTP PUSH senza aver prima inserito il cavo d antenna in questo connettore Presa di alimentazione Utilizzare esclusivamente l alimentatore fornito in dotazione per evitare di danneggiare gli apparati interni alla SMS Machine HTTP PUSH Interruttore di accensione Presa Ethernet RJ45 per la connessione su rete locale e accesso ai led di stato del link Apertura prevista per espansioni opzionali Tasto di ripristino della configurazione di fabbrica Pannello posteriore della SMS Machine HTTP PUSH Connessione dell antenna GSM Liberate il cavo dell antenna GSM fornita in dotazione ed inserite il connettore FME alla sua estremit nella presa corrispondente sul retro della SMS Machine HTTP PUSH Il connettore dotato di una ghiera filettata che deve essere avvitata fino in fondo senza forzare Connessione antenna GSM SMS Machine HTTP PUSH Manuale Utente Pagina 12 SMS Machine 2009 Area SX srl Attenzione Evitate assolutamente di accendere la SMS Machine HTTP PUSH senza aver prima collegato l antenna In caso contrario potrebbero verificarsi irreparabili danni al modem GSM interno Connessione dell alimentazione Inserite il connettore di alimentazione sul retro della SMS Machine HTTP PUSH quindi inserite l alimentato
17. a di copertina di questo manuale Aggiornamenti firmware Il firmware della SMS Machine HTTP PUSH pu subire aggiornamenti da parte dallo staff tecnico di Area SX srl per migliorarne le prestazioni e le funzionalit La disponibilit di aggiornamenti al firmware della SMS Machine HTTP PUSH segnalata nella home page ufficiale dei prodotti della linea SMS Machine all indirizzo http www smsmachine it Per aggiornare il firmware necessario il dispositivo di programmazione opzionale R101 0542 e il relativo software di gestione ordinabili sul sito http www smsmachine it Il dispositivo si connette da un lato alla porta seriale RS232 di PC dotato di sistema operativo Windows dall altro al core module Rabbit 3700 mentre il software di gestione provveder a scaricare il nuovo firmware della SMS Machine HTTP PUSH Una seconda modalit di aggiornamento firmware attraverso la porta Ethernet quindi non prevede l uso del cavetto Basta che la macchina sia raggiungibile su LAN Internet e dal proprio PC per mezzo di un semplice tool software rilasciabile a richiesta si procede all upload del file bin Maggiori informazioni su queste procedure di aggiornamento possono essere richieste direttamente al nostro staff alla email dirtecnica areasx com Infine si ricorda che tutte le informazioni sui Network Processor Rabbit 3700 utilizzati per realizzare la SMS Machine HTTP PUSH sono disponibili sul sito ufficiale http www rabbitsemico
18. achine 2009 Area SX srl Installazione della SMS Machine HTTP PUSH Contenuto della confezione La SMS Machine HTTP PUSH viene distribuita nella sua confezione di cartone adeguatamente protetta dalle eventuali sollecitazioni meccaniche durante il trasporto Una volta aperta la confezione troverete al suo interno le seguenti parti 1 Una SMS Machine HTTP PUSH 2 Un set di viti per la chiusura del case della SMS Machine HTTP PUSH dopo l inserimento della SIM 3 4 Una antenna GSM con base magnetica dotata di un cavo schermato di 2 5 metri per consentirne La documentazione utente in formato cartaceo e su CD un pi facile posizionamento Un alimentatore a parete Contenuto della confezione SMS Machine HTTP PUSH Ogni componente stato accuratamente testato prima della spedizione come testimoniato dalla scheda tecnica che accompagna e certifica il prodotto Evitate di utilizzare componenti di terze parti che potrebbero compromettere il funzionamento dei delicati dispositivi interni alla SMS Machine HTTP PUSH SMS Machine HTTP PUSH Manuale Utente Pagina 9 SMS Machine 2009 Area SX srl Requisiti per l istallazione Per poter installare con successo la SMS Machine HTTP PUSH necessario disporre di 1 Una carta SIM di un qualunque operatore telefonico GSM 2G sia di tipo prepagato che a contratto Prima di inserire la carta SIM nella SMS Machine HTTP PUSH opportuno provarla con un normale telefono
19. ault SMS Machine HTTP PUSH Manuale Utente Pagina 26 SMS Machine 2009 Area SX srl Caratteristiche tecniche Prestazioni e Massima velocit in trasmissione 500 SMS e Massima velocit in ricezione 500 SMS l ora Caratteristiche del modem GSM Interno e Modem GSM Telit modello GM862 S1 QUAD Caratteristiche del network processor interno e Core module Rabbit Semiconductor RCM3700 a 16 bit 22Mhz e 512Kb di memoria SRAM 512Kb di memoria FLASH e Presa Ethernet RJ45 10Base T integrata Caratteristiche elettriche dell alimentatore esterno e Alimentatore a parete e Tensione di ingresso 230 volt AC 50 60Hz e Tensione d uscita 12 Volt CC DC 500mA Caratteristiche elettriche SMS Machine HTTP PUSH e Assorbimento medio 300mA e Temperatura operativa SMS Machine HTTP PUSH 0 55 SMS Machine HTTP PUSH Manuale Utente Pagina 27 SMS Machine 2009 Area SX srl Supporto tecnico SMS Machine Home Page All indirizzo http www smsmachine it troverete la home page ufficiale di tutti i prodotti della linea SMS Machine Da questa pagina possibile accedere alle seguenti informazioni e Annuncidi nuove versioni di SMS Machine e Versioni aggiornate della documentazione utente e Documentazione tecnica di dettaglio e Esempi di utilizzo PHP ASP e Visual Basic e Software di supporto Per qualsiasi problematica tecnica o commerciale inoltre possibile contattarci ai recapiti indicati nella second
20. campo GSM rilevato dal modem interno della SMS Machine HTTP PUSH Oltre al valore espresso in dBm ne anche riportata una rappresentazione grafica e Modem Status E un messaggio inviato dal modem GSM che indica il suo stato ad esempio di registrazione alla rete GSM di ricerca rete di errore etc HTTP Status e Lan Status E un messaggio sullo stato della rete rilevato dalla SMS Machine HTTP PUSH ossia sulla raggiungibilit dello script di destinazione degli SMS Delivery Status In questa sezione sono riportati una serie di contatori relativi alla ricezione ed invio SMS Sono tutti valori volatili nel senso che i contatori vengono azzerati allo spegnimento della macchina e SMS Received via HTTP E un contatore dei messaggi inviati alla SMS Machine HTTP PUSH tramite richieste HTTP POST presi in carico dal processore e messi in coda di invio e SMS Queued to GSM Modem E un contatore di SMS effettivamente accodati dalla SMS Machine HTTP PUSH verso il suo modem e inviati tramite la carta SIM in esso utilizzata e SMS Received from GSM Modem E un contatore di SMS ricevuti dalla SMS Machine HTTP PUSH tramite la carta SIM usata nel suo modem e SMS sent to the Server E un contatore dei messaggi inviati con successo dalla SMS Machine HTTP PUSH tramite richieste HTTP POST verso lo script configurato SMS Machine HTTP PUSH Manuale Utente Pagina 23 SMS Machine 2009 Area SX srl e SMS Transmissions failed
21. cellulare per verificare che sia in grado di ricevere e trasmettere SMS e che la richiesta di PIN sia disabilitata Successivamente necessario anche eliminare dalla SIM il numero del Centro Servizi dell operatore che sar determinato in fase di configurazione 2 Un livello di campo GSM sufficiente L antenna della SMS Machine HTTP PUSH pu essere posizionata fino a 2 5m di distanza per trovare una intensit di campo sufficiente ad un regolare funzionamento dell apparato Prima di inserire la carta SIM nella SMS Machine HTTP PUSH verificate inserendola in un cellulare che ci sia campo sufficiente nel punto esatto in cui verr posizionata l antenna 3 Una connessione Ethernet SMS Machine HTTP PUSH dispone di una connessione Ethernet a 10Mbit con cui collegarla ad un Hub Switch sulla Vostra rete LAN Assicuratevi che la porta dell Hub Switch utilizzato sia una 10Mbit o una 10 100Mbit Oltre alla connessione fisica alla rete necessario disporre di una serie di dati relativi alla Vostra tipologia di rete indirizzi IP server gateway ecc pu essere quindi necessario rivolgersi al vostro amministratore di rete per ottenerli in fase di configurazione 4 Una presa di corrente di rete a 220 VAC Inserimento della carta SIM Per evitare che la carta SIM possa essere estratta accidentalmente in operativit il suo alloggiamento si trova all interno del contenitore metallico della SMS Machine HTTP PUSH Per accedere a tale alloggiamento occ
22. cessari per contenere l intero testo trasmesso Quindi la SMS Machine tratta ciascuna parte come singolo messaggio eseguendo un post http per ognuno di essi Sono ovviamente necessari nuovi parametri per la ricostruzione del messaggio originale Quindi nella richiesta post http oltre ai vecchi parametri sopra riportati ci sono quelli nuovi per identificare e ricostruire l SMS concatenato a partire dalle sue componenti e sms ididentificativo dell SMS concatenato e sms totparts numero totale di parti che lo compongono e Sms thispart identificativo della parte corrente Ricezione SMS notifica di consegna La nuova versione SMS Machine pu anche inviare messaggi con richiesta di notifica di avvenuta consegna al destinatario Per questa funzione si veda la sezione successiva In questo paragrafo vediamo l aspetto di ricezione della notifica stessa La ricezione della notifica trattata come un normale SMS il cui testo sar sempre STATUS REPORT Tuttavia nuovi parametri si aggiungono anche in questo caso alla richiesta HTTP POST eseguita in particolare la Machine invia e sms idpariall indice restituito con l operazione di invio si veda la sezione successiva e sms status codice di stato restituito dalla rete GSM Il valore atteso per quest ultimo parametro 0x00 che indica lo stato di SMS consegnato Altri valori per condizioni differenti sono possibili i pi comuni sono i seguenti 0x01 inoltrato stato scono
23. d password di accesso alla SMS Machine Le possibili risposte sono errno 0 amp desc SMS queued Accodamento effettuato con successo e errno 1 amp desc Access denied Password errata SMS Machine HTTP PUSH Manuale Utente Pagina 34 SMS Machine 2009 Area SX srl SMS Machine HTTP PUSH Manuale Utente Pagina 35 SMS Machine 2009 Area SX srl SMS Machine HTTP PUSH un prodotto AREA SX SRL INFORMATICA amp MICROELETTRONICA Via Stefano Longanesi 25 00146 Roma ITALIA Tel 39 06 99 33 02 57 Fax 39 06 62 20 27 85 info areasx com http www areasx com SMS Machine HTTP PUSH Manuale Utente Pagina 36
24. dati inseriti in un form ad uno script web In pratica la macchina effettua una richiesta di tipo HTTP POST e i parametri inseriti in questa pagina servono a definire le modalit di questa comunicazione SEA ACE WWW areasx com Destination server Address O Advanced www areasx com Destination server Page O Current Status fricevi_sms php O Configuration Test TCP Port number 80 Security code Enable TCP Server checking vi Use HTTP HEAD for script checking Send a POST when a RING is received Save Logout Release 1 02 HTTP configurazione dello script di ricezione SMS Destination server Address Questo parametro deve contenere l indirizzo IP o il nome del Web Server verso cui la SMS Machine HTTP PUSH deve inviare gli SMS ricevuti Si noti che esso va inserito senza indicare il protocollo http ad esempio www areasx com o 192 168 0 1 Destination server Page Questo parametro deve contenere il percorso completo path e il nome dello script in ascolto sul Web Server verso cui la SMS Machine HTTP PUSH deve inviare gli SMS ricevuti Si noti che esso va inserito indicando uno slash iniziale e con la classica notazione delle path annidate ad esempio SMS_ricevuti rxsms php In pratica i precedenti due parametri combinati insieme formano la URL completa che la macchina richiama alla ricezione di SMS TCP Port number E il numero di porta su cui inviare la
25. de importante ricordare che il browser usato deve supportare un adeguato Flash Player Dalla home page si passa poi alla pagina per effettuare il login necessario per eseguire concretamente le operazioni di configurazione cliccando sul tasto Go to configuration page La pagina di login riportata nella figura seguente la password di default da digitare SMS1234 e poi basta cliccare sul tasto Login Teo www areasx com Insert the configuration password default SMS1234 Configuration password Login Pagina di login Se il login andato a buon fine si accede al men principale delle funzioni riportato nella figura seguente Se cosi non fosse verificare la password e le configurazioni di rete del PC descritte nel paragrafo precedente z TEA www areasx com O Advanced O Current Status O Configuration Test Machine ID Number Get ID Number Logout Release 1 01 Menu delle funzioni Da questo menu possibile accedere a tutti i parametri di configurazione della SMS Machine HTTP PUSH Per ogni maschera di configurazione disponibile un tasto SAVE per inviare effettivamente alla macchina i nuovi parametri Si noti che se questo tasto non selezionato la SMS Machine HTTP PUSH non sar aggiornata con i cambiamenti effettuati La finestra Machine ID Number consente l identificazione della SMS Machine HTTP PUSH attraverso il suo Mac Address Ve
26. diamo in dettaglio ogni funzione ed ogni parametro configurabile SMS Machine HTTP PUSH Manuale Utente Pagina 16 SMS Machine 2009 Area SX srl Get ID Number Non appena effettuato il login l identificativo della SMS Machine HTTP PUSH non ancora disponibile come segnalato nella finestra al centro della maschera Ciccando sul tasto Get ID Number esso viene recuperato interrogando la SMS Machine HTTP PUSH L identificativo coincide con il Mac Address Per tornare a questa funzione occorre fare il logout e nuovamente il login o Shine Aavanced O Current Status Configuration Test www areasx com Machine ID Number Get ID Number Logout Release 1 01 Identificativo della SMS Machine HTTP PUSH LAN Questa maschera contiene tutti i parametri relativi al funzionamento su rete locale della SMS Machine HTTP PUSH Fate molta attenzione a configurare correttamente questi parametri in caso di errore potreste non essere pi in grado raggiungere la SMS Machine HTTP PUSH sulla vostra LAN Se questo dovesse accadere seguite la procedura per il ripristino della configurazione di fabbrica illustrata pi avanti CIS www areasx com HTTP Q Advanced IP Address Netmask 192 168 0 101 255 255 0 0 O Current Status Gateway DNS 192 168 0 1 192 168 0 1 O Configuration Test New password Repeat password Logout Release 1 01
27. e i nomi dei server in luogo dei corrispondenti indirizzi IP New password Repeat password Questi due campi devono essere configurati con la stessa stringa nel caso si desideri cambiare la password di accesso alla SMS Machine HTTP PUSH Qualora si dimentichi la password occorrer effettuare la procedura per il ripristino della configurazione di fabbrica illustrata pi avanti GSM Questa pagina consente di configurare il centro servizi del gestore di appartenenza della carta SIM inserita nella SMS Machine HTTP PUSH O HTTP O Advanced Message service center number Status 393492000200 O Configuration Test Predefined Italian mobile operators service centers EA a 5 Save Release 1 01 GSM configurazione Centro Servizi Message service center number E il numero del centro servizi da utilizzare per l invio degli SMS e cambia per ogni operatore telefonico Selezionando il logo di uno dei tre principali operatori di telefonia GSM si ha il riempimento automatico del campo SMS Machine HTTP PUSH Manuale Utente Pagina 18 SMS Machine 2009 Area SX srl HTTP Alla ricezione di un SMS la SMS Machine HTTP PUSH invia i dati ad esso relativi testo numero del mittente data e ora ed opzionalmente un codice di autenticazione ad un web server e cancella il messaggio dalla memoria SIM Con questa operazione la macchina emula il funzionamento con cui un browser passa i
28. el server DNS e Fversion versione del firmware e Servicecenter numero del Centro Servizi per l invio degli SMS e ServerAddress indirizzo IP o nome del server di destinazione SMS ricevuti e ServerPortla porta per le transazioni HTTP per default la 80 SMS Machine HTTP PUSH Manuale Utente Pagina 33 SMS Machine 2009 Area SX srl e ServerPage path dello script di destinazione SMS ricevuti a partire dalla root del server e MaxFailureln massimo numero di tentativi di invio SMS ricevuti verso lo script server default 0 che indica tentativi illimitati e ServerTimeout timeout della comunicazione HTTP TCP verso lo script server in millisecondi dafault 5000ms e InBufferLen numero di SMS nel buffer per la transizione verso lo script default 1 e ServerCode codice da inviare per l autenticazione da parte dello script e ScriptCheck controllo stato del server e dello script in ricezione 1 abilita la richiesta dell header http 0 valore di default solo controllo sul socket Simulazione di ricezione SMS disponibile anche uno script per richiedere alla SMS Machine di simulare la ricezione di un SMS Questa funzione molto utile quando si desidera testare l interazione della SMS Macine con i propri script web senza essere costretti ad inviare effettivamente SMS da un telefono cellulare La URL da richiamare la seguente http indirizzo_ _smsmachine srvtest cgi La variabile da passare in modalit POST e Pw
29. em della SIM e dell impostazione del Centro Servizi del gestore e Message Text Nel caso si voglia inviare un normale SMS testuale allora in questo campo va inserito il testo del messaggio SMS da inviare limitato a 160 caratteri Il parametro Push Destination Port deve essere assente o pari a 0 si veda oltre Se si vuole inviare un SMS Push con un link al terminale di destinazione allora questo campo deve essere formattato come nell esempio seguente www areasx com Questo un link ad Area SX ossia deve essere indicato l URL di destinazione senza esprimere http e il testo visualizzato nell SMS separati senza spazi dal carattere asterisco Si noti che nel parametro Push Destination Port va inserito il valore 1 si veda oltre SMS Machine HTTP PUSH Manuale Utente Pagina 24 SMS Machine 2009 Area SX srl Se infine si vuole inviare un SMS formattato su una differente porta di destinazione allora il testo sar composto coerentemente con le specifiche dell applicazione di destinazione che dovr gestirlo e Destination number E il numero del destinatario del messaggio SMS e Push Destination Port l opzione che indica in che modalit trasmettere il messaggio SMS Se questo parametro settato a 0 o assente dato che 0 il valore di default sar inviato un normale SMS testuale Se questo parametro settato a 1 allora sar inviato un SMS PUSH che forzer sul terminale di destinazione un
30. erfaccia WEB di configurazione Per poter funzionare correttamente la SMS Machine HTTP PUSH deve essere ovviamente in primo luogo configurata Queste operazioni sono particolarmente semplici in questa nuova versione in quanto nessun software aggiuntivo necessario La macchina infatti supporta un micro web server con front end in tecnologia Macromedia Flash quindi basta utilizzare un semplice browser dal proprio PC e indirizzarlo verso di essa all indirizzo IP di default http 192 168 0 101 La pagina principale cui si accede riportata nella figura seguente Ancora nessuna operazione possibile in questa fase ma solo monitoraggio Infatti l home page sintetizza lo stato di funzionamento della SMS Machine HTTP PUSH e i parametri in essa riportati saranno analizzati nel seguito in dettaglio www areasx com ku GSM Status GSM Field level 87 dem Modem status Gsm Ok HTTP Status Lan status Cannot resolve sms domain it Delivery Status SMS Received via HTTP SMS Queued to the GSM Modem 0 0 SMS Received from GSM Modem SMS sent to the Server 10 SMS Trasmissions Failed Other Info Firmware version 1 03 Refresh Status Go to the configuration page O La home page dell interfaccia web SMS Machine SMS Machine HTTP PUSH Manuale Utente Pagina 15 SMS Machine 2009 Area SX srl In questa se
31. ii ceea coda a a aci A A 12 Pannello posteriore aa Diac E Sa aaa Oua oa 12 Connessione dell antenna GSM uuu uu nenea nenea aaa ana aaa amana nau ana ana 12 Connessione dell alimentazione eee aaa mana aaa amana ana ana 13 Connessione della rete Ethernet ii 13 Accensione della SMS Machine HTTP PUSH eee ae u u u T T 14 Pannello frontale s farai nici iii iii ia ii ii 14 Significato delle spie sul pannello frontale mean nenea L ana 14 Spia gialla GSM aaa i i el ire e aa ai i al tea 14 Spia verde PWR suma iii ti aa i lio E ali ALI ei 14 Spia jossa osit siii aid E teca Silicio hifi ve ia 14 Spia verde e ca ai a e ae ea pa o a atata ca ea 14 Spla Verde eee e aaa cal oa de catea sh p i AE ATA 14 Configurazione della SMS Machine HTTP PUSH rin 15 Configurazione dii ba a at a a Dl a 15 Interfaccia WEB di configurazione mmm eee nene enma nana ana enma enma ear 15 Get ID Numbel RR ta ea caca aa a a cada la a e ag aaa catea ca audi 17 PAN A tama mu lati o Dea i a de e e dat Dar aer da aa la te Yapuspa Aa 17 IP Address at a e i ati a a dt h Spa d uu a a a au 17 Netm askar Sana isi
32. indipendentemente dal linguaggio e dal sistema operativo in uso Per poter funzionare correttamente la SMS Machine HTTP PUSH necessita di una normale carta SIM di qualunque gestore di telefonia mobile abilitata a trasmettere e ricevere messaggi SMS In ricezione la SMS Machine HTTP PUSH riceve gli SMS al numero di telefono della carta SIM inserita al suo interno e ne ritrasmette il contenuto sotto forma di transazioni HTTP verso un qualunque script Web asp php pl cgi jsp ecc in modalit POST Un set di variabili HTTP conterranno il numero del mittente la data di invio del messaggio ed il testo ricevuto In trasmissione la SMS Machine HTTP PUSH accetta connessioni HTTP in modalit POST estrae dalle variabili HTTP il numero del destinatario ed il testo del messaggio ed effettua la trasmissione dell SMS sulla rete GSM Naturalmente tra i parametri necessari anche la porta relativa al SMS che determina se si tratta di un messaggio testuale o Wap Push SMS Machine HTTP PUSH Manuale Utente Pagina 7 SMS Machine 2009 Area SX srl Connessione tra la SMS Machine HTTP PUSH ed un Server Web Con la SMS Machine HTTP PUSH non necessario utilizzare nessun modem connesso su linea RS232 o programmi di gestione esterni al server Web ma semplicemente scrivere dei semplici script di interfaccia nello stesso linguaggio usato per gestire il resto del vostro sito Web SMS Machine HTTP PUSH Manuale Utente Pagina 8 SMS M
33. initamente in questo stato Il parametro Smsindex consente di tenere traccia di questi invii non riusciti richiamando il seguente CGI http indirizzo_smsmachine smserror cgi Tele richiesta deve essere effettuata in modalit POST per potere inviare la seguente variabile e password configurata che abilita la SMS Machine ad accettare la transazione In risposta la SMS Machine ritorna una stringa senza tag HTML ma comunque visualizzabile da browser come la seguente rrno 0 amp desc Queue Transmitted amp SmsTxErrIdx 2 0 0 0 0 Le variabili sono che compongono tale stringa sono e errno che pu assumere i valori errno 0 per richiesta accettata con successo e errno 1 amp desc Access denied per password errata e SmsTxErrldx sono gli Id separati da un punto degli ultimi cinque SMS non trasmessi SMS Machine HTTP PUSH Manuale Utente Pagina 31 SMS Machine 2009 Area SX srl Configurazione Anche per la configurazione dei parametri di funzionamento e per funzioni di supporto la SMS Machine mette a disposizione degli script richiamabili da un client HTTP sulla porta 80 Questi sono gli stessi utilizzati dall interfaccia Web sviluppata in Macromedia Flash MX che un vero e proprio client HTTP in comunicazione con la SMS Machine Si noti che lo script di configurazione pu essere utile se si desidera integrare anche le funzionalit di configurazione della SMS Machine nella propria applicazione In tutti gli al
34. ledCounter numero di SMS non trasmessi dal modem L informazione di errore di rete indicata della variabile ServerStatus segnalata dall accensione del led verde L2 sul pannello frontale L informazione di mancata registrazione alla rete GSM indicata dalla variabile LastGsmError segnalata dall accensione prolungata del led rosso ERR sul pannello frontale L informazione di fallito invio SMS indicata dalla variabile FailedCounter segnalata per ciascun messaggio dal lampeggio contemporaneo led rosso ERR e quello verde L1 sul pannello frontale per alcuni secondi Interrogazione dei parametri di rete e di configurazione E possibile ottenere il valore corrente dei parametri di configurazione con lo script http indirizzo_smsmachine getconfig cgi anche lo script che viene richiamato al momento del login per caricare tutti i parametri correnti nell interfaccia web L unica variabile da inviare in modalit POST e password di accesso alla SMS Machine In risposta la SMS Machine ritorna una stringa senza tag HTML ma comunque visualizzabile da browser formata dalla concatenazione di coppie nome variabile valore Le variabili sono e errno 0 amp desc Configuration Sent Configurazione inviata oppure errno 1 amp desc Access denied Password errata IpAddressindirizzo IP assegnato alla SMS Machine e Netmask subnet mask della SMS Machine e Gateway indirizzo IP del gateway e Nameserver indirizzo IP d
35. nductor it SMS Machine HTTP PUSH Manuale Utente Pagina 28 SMS Machine 2009 Area SX srl Appendice A Interfaccia http In questa appendice saranno descritti in dettaglio tutti gli script cgi supportati dalla SMS Machine HTTP PUSH nella sua funzione di server http ed anche il suo comportamento da client http Si noti che nel seguito la macchina sar indicata genericamente col solo nome SMS Machine Identificativo della SMS Machine La SMS Machine identificata univocamente oltre che dall indirizzo IP modificabile a piacere anche dal Mac Address che invece fisso Questo ultimo una stringa alfanumerica composta da dodici cifre esadecimali che pu essere ottenuta richiamando un CGI interno alla SMS Machine con la richiesta HTTP POST del tipo http indirizzo_smsmachine queryid cgi Inviando il parametro e valore pari alla password corrente In risposta la SMS Machine restituisce una stringa senza tag HTML ma comunque visualizzabile da browser contenente una serie di coppie di parametri nomez valore concatenati da amp come la seguente rrno 0 amp desc Machine ID Reported amp MachineId 0090C2D3505A errno il codice d errore della transazione vele 0 per transazione OK e 1 per password errata e desc descrive sinteticamente l esito della transazione e Machineld es Machineld 0090c2c68ab5 il Mac Address che individua univocamente definitivamente la SMS Machine Ricezione SMS
36. nente il codice errno e la relativa descrizione che pu assumere i seguenti valori errno 0 amp desc Configuration_Accepted Cambio configurazione OK e errno 1 amp desc Access denied Password errata Interrogazione dello stato di funzionamento La SMS Machine mette a disposizione anche uno script per richiedere il suo stato di funzionamento generale che risponde al seguente URL http indirizzo_smsmachine getstatus cgi Tele richiesta deve essere effettuata in modalit POST per potere inviare la seguente variabile SMS Machine HTTP PUSH Manuale Utente Pagina 32 SMS Machine 2009 Area SX srl e Pwd password configurata che abilita la SMS Machine ad accettare la transazione In risposta la SMS Machine ritorna una stringa senza tag HTML ma comunque visualizzabile da browser formata dalla concatenazione di coppie nome variabile valore Le variabili sono e errno 0 amp desc Configuration Sent Stato rilevato OK oppure errno 1 amp desc Access denied Password errata e GsmFieldLevel livello del campo GSM in dbm e LastGsmerror stato del modem ultimo errore segnalato e TxGsmCounter numero di SMS trasmessi dal modem e RxGsmCounter numero di SMS ricevuti dal modem e TxServerCounter numero di SMS in trasmissione ricevuti dal processore e RxServerCounter numero di SMS in ricezione inviati al server e ServerStatus stato del server o dello script di destinazione e Fversionversione del firmware e Fai
37. o essere soggette a modifiche senza preavviso Alcuni termini impiegati in questo documento possono essere marchi registrati di altre societ e sono menzionati a scopo puramente esplicativo senza alcuna intenzione di violare i diritti dei legittimi proprietari Area SX srl non potr essere ritenuta responsabile per eventuali danni o perdite derivanti da informazioni errate presenti in questo documento SMS Machine un nome registrato da Area SX srl Tutti i diritti sono riservati Informazioni per la sicurezza L impiego della SMS Machine HTTP PUSH pu disturbare o essere dannoso al funzionamento di alcune apparecchiature elettroniche se installata in prossimit di esse Si consiglia pertanto di evitare l installazione della SMS Machine HTTP PUSH vicino a e Dispositivi elettromedicali e Apparecchiature di bordo su mezzi aeromobili e Apparati di sicurezza e Apparati televisivi radio e audio Internamente la SMS Machine HTTP PUSH contiene un completo Modem GSM Quad Band Tale componente presenta delle caratteristiche praticamente identiche a quelle dei normali telefonini cellulari Quad Band per cui si raccomandano le stesse precauzioni d uso di questi ultimi In particolare si raccomanda di non accendere la SMS Machine HTTP PUSH in tutti quegli ambienti in cui esplicitamente vietato l uso di telefonini cellulari o apparati di telecomunicazione in genere SMS Machine HTTP PUSH Manuale Utente Pagina 3 SMS Machine 2009 A
38. orre svitare le quattro viti che chiudono il case della SMS Machine HTTP PUSH e quindi far scorrere in avanti la parte superiore del case come indicato in figura Apertura del case della SMS Machine HTTP PUSH Dopo aver aperto il case ed individuato il modem GSM inserite la SIM nel suo alloggiamento con i contatti dorati rivolti verso il basso e la parte sagomata in avanti come indicato sul modem stesso nonch nella figura seguente SMS Machine HTTP PUSH Manuale Utente Pagina 10 SMS Machine 2009 Area SX srl Inserimento della carta SIM Spingetela fino in fondo fino a sentire un piccolo scatto che indica il raggiungimento della posizione di blocco Quando sia necessario sbloccarla ed estrarla nuovamente sar sufficiente premere leggermente sul bordo della SIM nella stessa direzione di inserimento Una molla interna spinger fuori la SIM quanto basta per poterla afferrare Per richiudere il case spingete indietro la sua parte superiore facendo attenzione che i led di segnalazione siano correttamente allineati con i relativi fori del pannello frontale A questo punto sar necessario chiudere nuovamente le due parti del case con le quattro viti fornite come indicato nella figura seguente Chiusura e fissaggio del case della SMS Machine HTTP PUSH SMS Machine HTTP PUSH Manuale Utente Pagina 11 SMS Machine 2009 Area SX srl Connessioni Pannello posteriore Nella figura seguente viene riportata una vist
39. ppure in combinazione con sistemi pi complessi controllandolo attraverso l interfaccia seriale RS232 B uye A breve sul sito Area SX una panoramica pi estesa ed alcuni esempi di utilizzo Per un dettaglio tecnico sul prodotto vedi la scheda tecnica EZ10 Modem GSM GPRS on interprete Pythor I PRODOTTI SMS Machine HTTP Push SMS HTTP con PHP SMS HTTP con ASP SMS HTTP con VB Sistema di telecontrollo GSM GPRS GPS interprete Python Display 20x4 Bianco con keypad da sei SMS Manager Una nuova idea di telecontrollo un sistema semplice aperto e potente da poter i tasti ed interfaccia programmare senza sforzo tramite una semplice porta seriale la nuova SXPY tutto Use questo e molto altro A aio E AI Dotata di 2 ingressi optoisolati 2 uscite a rele seriale RS232 batteria di ke d di emite backup 2 connettori di espansione host per convertitore seriale e matten tasti ad Carra Fine Internet 100 http mwww areasx com Tutto il Sito E possibile inoltre contattarci ad uno dei seguenti recapiti Telefono 39 06 57 17 26 90 e 39 06 57 17 26 79 Fax 39 06 57 17 26 95 E mail infoQareasx com SMS Machine HTTP PUSH Manuale Utente Pagina 2 SMS Machine 2009 Area SX srl Avvertenze Contenuti e copyright Le informazioni contenute in questo manuale posson
40. re ad una presa di corrente Attivate l interruttore d accensione posto sul retro e verificate che il led verde PWR sul pannello frontale sia acceso Connessione dell alimentatore Connessione della rete Ethernet Con un normale cavo UTP dotato di connettori RJ45 collegate la SMS Machine HTTP PUSH ad uno Switch o Hub di rete Assicuratevi che la presa dello Switch Hub supporti dispositivi Ethernet a 10Mbit Al accensione della SMS Machine HTTP PUSH assicuratevi che il led di connessione accanto alla presa di rete si accenda Esso visibile attraverso il piccolo foro presente nel pannello posteriore adiacente a quello che accoglie la presa di rete Connessione di rete SMS Machine HTTP PUSH Manuale Utente Pagina 13 SMS Machine 2009 Area SX srl Accensione della SMS Machine HTTP PUSH Dopo aver effettuato tutte le connessioni descritte possiamo accendere la SMS Machine HTTP PUSH agendo sull interruttore posto sul pannello posteriore Pannello frontale Sul pannello frontale dovremmo poter vedere le spie nel seguente stato Spia GSM gialla Lampeggiante e Spia PWR verde Accesa Spia ERR rossa e SpiaL1eL2 verde Spente L1 j Dopo circa 30 secondi la spia rossa ERR dovrebbe spegnersi ad indicare l avvenuta registrazione del modem GSM sulla rete GSM Se questo non dovesse succedere provate a spostare l antenna e a spegnere e riaccendere la SMS Machine HTTP
41. rea SX srl Introduzione a questo manuale Questo manuale si rivolge agli utenti che devono mettere in esercizio la seguente versione di SMS Machine e SMS Machine HTTP PUSH Per la sua lettura richiesta una conoscenza di base di alcune terminologie informatiche con particolare riferimento alle reti TCP IP Versioni aggiornate di questo manuale possono essere scaricate gratuitamente dal nostro sito internet all indirizzo http www areasx com SMS Machine HTTP PUSH Manuale Utente Pagina 4 SMS Machine 2009 Area SX srl Indice generale Congratulazioni per aver scelto SMS Machine J iii 2 Come contattarei uu ui aa a ai it Dau daia aaa solu a tsa 2 AvVvertenze ZQ 3 cai atata ae cae ee e a a ian Dia d 3 Informazioni per la sicurezza iii 3 Introduzione a questo manuale U U U UU u uu u uu uu uu uu u uu uu u J 4 Descrizione del prodotto U U nana na u uuu uu uuu uu uuu uuu uu uu u 7 Installazione della SMS Machine HTTP PUSH U U 9 Contenuto della 2 u a a d a a ea E a a ai ei 9 Reduisiti per l istallazione cala alal dt ala al a a sata au ae a au kaska sta 10 Inserimento della cart SIM u i aia ceia dati ia a dai ba aia 10 Connession
42. sciuto 0x20 Congestione tentativi in corso 0x21 Destinatario occupato tentativi in corso 0x22 Nessuna risposta dal destinatario tentativi in corso 0x23 Servizio respinto tentativi in corso 0x24 Servizio non disponibile tentativi in corso 0x25 Errore al ricevente tentativi in corso 0x42 Connessione respinta 0x45 Internetworking non disponibile 0x46 Scaduto 0x48 Cancellato Trasmissione SMS In trasmissione la SMS Machine simula il comportamento di un server Web in ascolto sulla porta 80 mentre la nostra applicazione deve emulare il comportamento di un browser Web richiamando un CGI interno alla macchina stessa con una richiesta del tipo http indirizzo_smsmachine smssend cgi Questa richiesta deve essere effettuata in modalit POST per potere inviare un set di variabili relative SMS Machine HTTP PUSH Manuale Utente Pagina 30 SMS Machine 2009 Area SX srl allo SMS che sono e Pwd password configurata che abilita la SMS Machine ad accettare la transazione e Push porta di destinazione 0 SMS normale valore di default se omesso 1 SMS Wap Push altro da specificare coerentemente con l applicazione di ricezione e numero di telefono del destinatario dell SMS e text testo del messaggio da inviare Disponibili 160 per SMS ordinari fino a 300 caratteri per SMS estesi o concatenati caratteri eccedenti sono ignorati In risposta la SMS Machine ritorna una stringa senza tag HTML ma comunque
43. sidenti sul cellulare di destinazione Processori Rabbit Processori BasicX Una interfaccia sal Unitamente a queste nuove funzionalit la SMS Machine HTTP PUSH raddoppia anche operatore per le Ae le prestazioni di invio e ricezione della versione standard ed integra i pannelli di scheda SAR i configurazione direttamente nel firmware Le ultime novit Aggiornamenti sito Bookmarks Area Download Tutte le novit in SMS Machine HTTP Wap Push SM convertitore Seriale Ethernet in soli 8 cm per 5 Megapixel un modo creativo di utilizzare il dimmer Mappa del Sit tts acd Pezio GPS un modem un ricevitore GPS ed un microcontrollore n un solo prodotto L EZ10 GPS la sintesi perfetta delle esigenze attuali nel campo del telecontrollo e del posizionamento geografico un modem GSM GPRS quand band un ricevitore GPS opere a 20 canali 4 linee di ingresso uscita un microcontrollore con interprete SANZZSIO IN Python un contenitore gi pronto per le esigenze del mercato automotive il tutto con dimensioni estremamente ridotte 5 canna SMS Machine 7 completo telecontrollo via GSM con la SXPY SMS Machine Web mini SMS Machine SMS Machine HTTP SMS Machine MAIL SMS Machine XML Server Patrol Fax Sentinel Le applicazioni di questo prodotto sono innumerevoli pu essere utilizzato da solo per realizzare sistemi di tracciamento e teleallarme o
44. ssere velocizzate o rallentate e rese pi o meno affidabili in termini di perdita SMS a seconda di come vengono modulati i tre parametri appena decritti Per questo si raccomanda una loro accurata valutazione in relazione all ambiente di esercizio della SMS Machine HTTP PUSH e i requisiti di affidabilit Nome delle variabili della comunicazione Sebbene l interfaccia http di comunicazione della macchina sia descritta in appendice pu essere utile gi a questo punto descrivere con maggiore dettaglio le variabili della comunicazione http tra la macchina e le applicazioni esterne sia per l invio che per la ricezione degli SMS Tuttavia si rimanda comunque in appendice per dettagli sulle nuove funzioni di ricezione di SMS estesi altrimenti detti concatenati ossia contenenti pi di 160 caratteri dell invio SMS con richiesta di notifica di ricezione e Ricezione SMS ordinari fino a 160 caratteri SMS Machine HTTP PUSH Manuale Utente Pagina 21 SMS Machine 2009 Area SX srl Lo script richiamato dalla SMS Machine HTTP PUSH deve gestire quattro variabili inviate con il metodo Post contenenti i dati relativi agli SMS ricevuti nomi ed i significati delle variabili sono i seguenti contiene il numero di telefono del mittente sms_text contiene il testo del messaggio ricevuto sms_date contiene la data di registrazione del messaggio sulla rete GSM dovrebbe in pratica corrispondere alla data di
45. ta versione l implementazione della tecnologia WAP PUSH che consente non pi solo invio di normali messaggi SMS testuali ma anche SMS attivi La modalit Push consente infatti di inviare SMS formattati in modo da essere in grado di interagire direttamente con il terminale di destinazione In particolare il parametro porta di destinazione che determina un azione da intraprendere sul terminale Un tipico esempio quello dell invio di hyperlink Un SMS testuale contenente un link provoca sul terminale del destinatario la sola visualizzazione solo alcuni dispositivi riconoscono il link in questa modalit ma un SMS Push consente di notificare direttamente l informazione con l opzione di una immediata connessione purch tale funzionalit risulti abilitata Un secondo esempio prevede un ulteriore livello di interazione su terminali che supportano applicazioni Java J2ME In questo caso il messaggio SMS Push pu essere preso in carico direttamente dall applicazione in ascolto su una determinata porta in modo che possa intraprendersi l azione prevista in base al suo contenuto Si pensi ad applicazioni di telecontrollo chat giochi etc SMS Machine HTTP PUSH In soli 125x175x45 millimetri la SMS Machine HTTP PUSH racchiude un modem GSM Quad Band completo in grado di ricevere e trasmettere SMS dalla rete cellulare GSM ed un network processor dotato di connessione Ethernet in grado di interagire direttamente con applicazioni Web
46. te e o verificare questo aspetto quando si utilizza l opzione Enable TCP Server checking In alcuni casi pu essere utile invece disabilitare completamente questo controllo in una delle due modalit appena descritte Per far ci basta non selezionare questa casella Si noti che in questo caso la SMS Machine HTTP PUSH tenter sempre l invio dei messaggi ricevuti verso il Server Send a POST when a RING is received La SMS Machine HTTP PUSH gestisce anche una chiamata entrante se la SIM utilizzata al suo interno abilitata al traffico voce Il comportamento tenuto dalla macchina in caso di chiamata in arrivo assai simile a quanto accade in caso di ricezione di SMS Per questo si rimanda alla successiva sezione dedicata a questa funzione per ulteriori informazioni Qui basti sapere che la funzione di gestione delle chiamate entranti abilitata o disabilitata a seconda che questa casella abbia la spunta o meno Advanced Sebbene i parametri configurati come descritto nella sezione precedente siano sufficienti al funzionamento dalla SMS Machine http PUSH altri parametri avanzati sono sotto il controllo dell utente per ottimizzare la comunicazione http verso lo script di destinazione Li vediamo in questa sezione ricordando anche il loro valori di dafault WWW areasx com Maximum server delivery tries 0 This parameter sets the number of tries that will be made by SMS Machine to transfer an incoming SMS to the
47. trasmissione nel formato AAAA MM GG HH MM SS GMT 00 dove i _ AAAA MM GG la data nel formato anno mese giorno ii HH MM SS l ora nel formato ora minuti secondi iii La parte rimanente indica lo scostamento dall ora di Greenwich Quest ultima informazione non sempre gestita correttamente dagli operatori sms_code pu contenere un codice di accesso allo script configurabile si veda il Security code e Ricezione di una chiamata Come gi accennato in una precedente sezione alla ricezione di una chiamata entrante la SMS Machine HTTP PUSH la chiude ed esegue la stessa richiesta Http POST verso lo script configurato passando gli stessi parametri Qualche precisazione per necessaria contiene il numero di telefono del chiamante sms_text contiene il testo fisso INCOMING CALL RECEIVED sms_date contiene una data nulla 00 00 00 00 00 00 GMT 00 sms_code pu contenere un codice di accesso allo script configurabile si veda il Security code e Invio SMS ordinari ed estesi fino a 300 caratteri Per inviare SMS la SMS Machine HTTP PUSH si comporta come un server web Lo script interno alla SMS Machine che effettua la trasmissione smssend cgi e accetta quattro variabili inviate in modalit POST Il nome ed il significato delle variabili sono i seguenti num deve contenere il numero del destinatario text deve contenete il messaggio da trasmettere Disponibili
48. tri casi sufficiente usare l interfaccia Web Lo script di configurazione risponde al seguente URL http indirizzo_smsmachine setconfig cgi I nomi delle variabili da passare in modalit POST sono e Pwd password di accesso alla SMS Machine default SMS1234 e IpAddressindirizzo IP assegnato alla SMS Machine e Netmasksubnet mask della SMS Machine e Gateway indirizzo IP del gateway e Nameserver indirizzo IP del server DNS e NewPwd nuova password da assegnare alla SMS Machine e Servicecenter numero del Centro Servizi per l invio degli SMS e ServerAddress indirizzo IP o nome del server di destinazione SMS ricevuti e ServerPage path dello script di destinazione SMS ricevuti a partire dalla root del server e ServerPortla porta per le transazioni HTTP per default la 80 e ServerCode codice da inviare per l autenticazione da parte dello script e ScriptCheck controllo stato del server e dello script in ricezione 1 abilita la richiesta dell header http 0 valore di default solo controllo sul socket e InBufferLen numero di SMS nel buffer per la transizione verso lo script default 1 e ServerTimeout timeout della comunicazione HTTP TCP verso lo script server in millisecondi dafault 5000ms e MaxFailureln massimo numero di tentativi di invio SMS ricevuti verso lo script server default 0 che indica tentativi illimitati In risposta la SMS Machine ritorna una stringa senza tag HTML ma comunque visualizzabile da browser conte
49. visualizzabile da browser contenente due coppie di parametri mome valore concatenati da amp come la seguente rrno 0 amp desc SMS Queued amp SmsIndex 2 La prima errno seguita dalla relativa descrizione che pu assumere i seguenti valori errno 0 amp desc SMS queued Accodamento effettuato con successo e errno 1 amp desc Access denied Password errata e errno 2 amp desc Destination number missing Manca il numero di destinazione dell SMS errno 3 amp desc SMS refused Accodamento fallito per coda piena La seconda ed un indice progressivo che individua lo SMS accodato con successo per l invio Per verificare se il messaggio sia stato inviato dalla SMS Machine possibile controllare l incremento dei contatori SMS nella pagina di Status dell interfaccia Web o dei contatori TxGsmCounter TxServerCounter restituiti dallo script getstatus cgi si veda seguito Richiesta notifica di ricezione La nuova versione SMS Machine pu anche inviare messaggi con richiesta di notifica di avvenuta consegna al destinatario In questo caso la richiesta http post verso lo script smssend cgi deve essere modificata con l aggiunta del parametro opzionale notify valore para 1 per abilitare la notifica 0 omesso per SMS normale SMS non inviati La SMS Machine elimina dalla coda gli SMS che non riesce ad inviare per assenza campo numero destinatario errato etc al fine di non bloccarsi indef
Download Pdf Manuals
Related Search