Doc4AWlink. La programmazione con easywlink

Transcript

1 Doc4AWlink La programmazione con easywlink

2 WLINK consente ad un sistema wireless performances pari se non superiori ad un sistema filare convenzionale, senza l aggravio della stesura dei cavi di collegamento. Ogni componente di un sistema WLINK possiede pertanto una programmazione di elevato livello, in grado di consentire l adattamento del sistema alle più svariate esigenze di sistema. Se per una centrale la programmazione può risultare agevole già grazie al display grafico di cui è dotata, lo stesso non si può dire per gli altri componenti del sistema. Alcuni componenti sono oltremodo molto piccoli, caratteristica che rende pressoché impossibile dotarli di interfacce di programmazione convenzionali, quali tastiere o display. Per rendere la programmazione più agevole possibile, abbiamo dotato tutti i componenti WLINK del trasferimento di programmazione wireless, all interno del protocollo stesso. easywlink è il software che abbiamo realizzato per leggere e per programmare i componenti WLINK; esso comprende i form di programmazione di ogni dispositivo o componente, centrali comprese. Con easywlink è possibile programmare qualsiasi caratteristica che sia programmabile in qualsiasi componente WLINK. easywlink permette inoltre di eseguire le necessarie registrazioni tra la centrale e le varie periferiche, rendendo superflue le procedure di autoapprendimento, che rimangono comunque possibili. easywlink consente inoltre di leggere le registrazioni interne ad ogni componente WLINK, come le ore ed i giorni trascorsi dall applicazione della batteria, il numero di trasmissioni effettuate ed il numero di eventuali trasmissioni non confermate, la tensione della batteria installata, la versione firmware, il modello del dispositivo e finanche la temperatura interna. Su di una centrale imx o SOLO Lite, inoltre, è possibile leggere la memoria storica in pochi secondi ed eventualmente archiviarla su hard disk, così come per la programmazione della centrale stessa. easywlink può connettersi ai dispositivi WLINK-compatibili in svariate modalità: Via LAN (su imx Plus), sia direttamente che tramite CSIcloud Via GPRS (su tutte le centrali dotate di MULTICONNECT) Via UsbPod in connessione radio WLINK (per tutti i dispositivi WLINK) Via UsbPod in connessione cablata (su imx e Solo Lite) UsbPod è un pod di interfacciamento appositamente studiato per WLINK. Una volta dotato al suo interno di almeno un modulo RFPORT (nella sua completezza accetta sia un RFPORT4 che un RFPORT8), esso funge da interfaccia wireless tra easywlink ed il componente WLINK da programmare. UsbPod consente anche la connessione diretta (non wireless) con le centrali imx e Solo Lite, grazie ad un apposito cavo di connessione. UsbPod non necessita di alcun driver per funzionare sotto Windows; è sufficiente inserirlo in una qualsiasi porta usb del personal computer e verrà riconosciuto dal sistema come una periferica nativa. 2

3 Connessione con le centrali Selezionando il menu Connessione Setup su easywlink, è possibile visualizzare le varie modalità di connessione: 1. La Connessione diretta cablata con USBPOD. 2. La Connessione via radio con USBPOD (i dispositivi con il quale è richiesta la connessione devono essere dotati di RFPORT4 e/o RFPORT8, così come l USBPOD). 3. La connessione via GPRS (la centrale deve essere dotata di MultiConnect con inserita una scheda SIM abilitata per il traffico Internet). 4. La connessione Tcp-Ip (possibile solo con imx Plus). 5. La connessione tramite il CSIcloud (possibile sulle centrali imx serie Plus, sia via LAN che via GPRS). Connessione diretta con USBPOD Le modalità di connessione diretta sono molto semplici: 1. Partire sempre dalla condizione di centrale alimentata, anche solo a batteria. La connessione ad USBPOD a centrale NON alimentata viene interpretata dalle centrali, una volta applicata l alimentazione, come una richiesta di aggiornamento del firmware. 2. Verificare che il cavo piatto in dotazione a USBPOD sia connesso allo stesso dalla parte siglata POD. 3. Inserire USBPOD in una porta USB del PC. 4. Inserire il connettore libero nel connettore UPG della centrale. 5. Entrare in Programmazione da PC nel menu della centrale e selezionare Connessione filare. 6. Avviare easywlink. 7. Verificare che sia selezionato il parametro Connessione diretta con USBPOD nel setup di easywlink. 8. A questo punto, è possibile leggere programmazione e memoria storica, così come l orologio e riscrivere programmazioni ed impostazioni della centrale connessa. 3

4 9. Per terminare la connessione, uscire dall area di programmazione in centrale (normalmente premendo il tasto NO, vedere il manuale di utilizzo della centrale in oggetto). Connessione via radio con USBPOD Verificare preventivamente che USBPOD sia dotato di almeno un modulo RFPORT (4 o 8) e che la centrale o il dispositivo con il quale è richiesto il collegamento possegga lo stesso modulo (o anche entrambi). Anche in questo caso le modalità di connessione sono molto semplici: 1. Inserire USBPOD in una porta USB del PC. 2. Entrare in Programmazione da PC nel menu della centrale e selezionare Connessione radio. 3. Avviare easywlink. 4. Verificare che sia selezionato il parametro Connessione via radio con USBPOD nel setup di easywlink, che l ID sistema corrisponda a quello programmato nella centrale (52428 di default) e che siano abilitati gli RFPORT presenti sia nella centrale che nell USBPOD. 5. A questo punto, è possibile leggere programmazione e memoria storica, così come l orologio e riscrivere programmazioni ed impostazioni della centrale connessa. 6. Per terminare la connessione, uscire dall area di programmazione in centrale (normalmente premendo il tasto NO, vedere il manuale di utilizzo della centrale in oggetto). Connessione via GPRS con MultiConnect Per questa modalità di connessione, occorre che la centrale sia dotata di MultiConnect e di relativa scheda SIM abilitata al traffico Internet. Per la trattazione delle modalità con le quali il pc e la centrale entrano in connessione, rimandiamo l attenzione ai manuali delle centrali; in questo manuale ci limitiamo ad occuparci genericamente della varie possibilità di connessione GPRS. Le connessioni GPRS possono essere eseguite da easywlink in due differenti modalità: 1. Modalità CLIENT: easywlink è il client della connessione e la centrale è il server. È questa ovviamente la modalità naturale di una connessione client-server, dove il client (il pc) si connette con il server (la centrale, tramite il modulo MultiConnect) per leggere e scrivere programmazioni ed altro. Per poter dare luogo a questa modalità di connessione, occorre che il server (la centrale) faccia conoscere al client (easywlink) un IP pubblico, al quale il server deve essere raggiungibile. Purtroppo, gli operatori di telefonia mobile sono soliti organizzare le loro reti wireless sotto NAT, pertanto è possibile, anzi probabile, che l IP che verrà inviato dalla centrale all operatore (vedere le procedure nel manuale della centrale) NON sia un IP pubblico, e pertanto la centrale non sia raggiungibile. 2. Modalità SERVER: easywlink è il server della connessione e la centrale è il client. È questa una modalità di connessione inversa rispetto all usuale, ma funziona molto bene con le reti wireless: l operatore invia (es.: via SMS) l IP pubblico del PC sul quale è attivo easywlink alla centrale. Quest ultima esegue tramite il MultiConnect una connessione CLIENT verso il PC sul quale sarà attivo easywlink; su quest ultimo compare un messaggio indicante che vi è una centrale in connessione ed il gioco è fatto. Naturalmente, occorre che il PC sia connesso ad una rete cablata, in grado di attribuirgli un IP pubblico. 4

5 Nel prossimo capitolo vi è una trattazione dettagliata delle due procedure dal lato applicazione (per il funzionamento dal lato centrale, e per le modalità di avvio della connessione che sono caratteristiche delle centrali stesse, rimandiamo l attenzione al manuale della centrale in oggetto). È anche richiesto un codice di accesso, codice che deve essere tra quelli programmati in centrale per le funzionalità che si intende eseguire (es: la programmazione del sistema; se il codice di accesso è programmato in imx per le sole variazioni di stato, non sarà possibile programmare la imx tramite easywlink con tale codice). Connessione via TCP-IP (solo per imx Plus) La centrale imx Plus è dotata di serie di LAN e questo la rende ovviamente raggiungibile da easywlink in TCP-IP. Essa è raggiungibile sia tramite HOST-NAME e PORT che tramite IP ADDRESS fisso e PORT. Tutti questi parametri sono programmabili selezionando nel SETUP la connessione via TCP-IP e parallelamente sono programmabili in imx Plus (vedere il relativo manuale). È anche richiesto un codice di accesso, codice che deve essere tra quelli programmati in centrale per le funzionalità che si intende eseguire (es: la programmazione del sistema; se il codice di accesso è programmato in imx per le sole variazioni di stato, non sarà possibile programmare la imx tramite easywlink con tale codice). Connessione via CSIcloud (solo per serie Plus) Le centrali serie Plus (imx Plus imx GSM Plus) hanno la possibilità di accedere automaticamente al CSIcloud, un servizio messo a disposizione da CSI SpA (previa registrazione, vedere la nota applicativa a riguardo) che consente a tali apparecchiature, ed in prospettiva a quelle che nasceranno nei prossimi anni, di connettersi a software vario ed APPs per smartphones in modo totalmente trasparente, senza conoscenze specifiche di connessioni di rete per l installatore, né la necessità che queste siano dotate di IP pubblici, statici o dinamici. La connessione tramite il CSIcloud richiede solamente due indispensabili parametri: il solito codice di accesso (con abilitazione alle operazioni che andremo ad effettuare) e l UID (Unique IDentification). Quest ultimo è un identificatore univoco, composto da una sequenza di dodici numeri, che è diverso in ogni centrale e che deve essere usato per registrare la centrale stessa presso il servizio CSIcloud; esso è la chiave per la connessione tra i dispositivi remoti (software ed apps per smartphones) e la centrale imx. Rimandiamo l attenzione alle note esplicative riguardanti il CSIcloud per maggiori informazioni circa il servizio offerto. imx Gsm Plus non possiede una LAN integrata; essa si connette al CSIcloud tramite GPRS. La modalità di connessione è descritta nel capitolo che segue. 5

6 Modalità di connessione via GPRS Come anticipato nel capitolo precedente, easy WLINK può effettuare connessioni GPRS con le apparecchiature WLINK-compatibili (imx, imx Lite Gsm, imx Plus, imx Gsm Plus, SOLO Lite, ecc.) che dispongano di una connessione GSM/GPRS (MultiConnect aggiuntivo od integrato). Verificare che la SIM utilizzata abbia abilitazione alle connessioni Internet e che vi sia credito sufficiente, altrimenti non sarà possibile accedere alla rete GPRS. Sono disponibili differenti modalità di connessione che di seguito andiamo ad elencare. Connessione via CSIcloud (imx Plus imx Gsm Plus) Le apparecchiature serie Plus possono utilizzare il CSIcloud e questo è sicuramente il modo migliore e più semplice per effettuare le connessioni remote. CSIcloud rende possibile effettuare connessioni remote senza complicate programmazioni di rete ed anche le apparecchiature senza LAN integrata possono sfruttare il servizio grazie alla connessione GPRS. Per utilizzare il servizio: 1. Registrare la centrale tramite il suo UID (vedere il relativo manuale per dove trovare tale identificativo sulla centrale) sul servizio CSIcloud tramite il sito istituzionale 2. Abilitare la telegestione nella programmazione del comunicatore Multiconnect (non è necessario abilitare la gestione del CSIcloud nelle programmazioni LAN; questa abilitazione è utile solamente se si desidera accedere al CSIcloud tramite LAN) 3. Abilitare un numero telefonico tra quelli presenti nella programmazione del comunicatore MultiConnect alla connessione CSIcloud; quando questo numero telefonico eseguirà una chiamata verso la centrale, la stessa effettuerà la connessione al CSIcloud. Un sistema alternativo è inviare un SMS di comando connessione al CSIcloud (vedere il manuale della centrale). 4. Attendere una trentina di secondi 5. Avviare easywlink, selezionare nel Setup connessione il servizio CSIcloud ed immettere UID e codice utente abilitato alle operazioni che andremo ad eseguire A questo punto è possibile accedere alle funzioni disponibili dalla centrale, che rimarrà disponibile per circa quattro minuti dopo l ultimo comando o richiesta. Gli accessi alla centrale vengono protetti tramite password e complessi algoritmi di cifratura variabile ad ogni connessione. Connessione diretta con centrale client (imx imx Lite Gsm imx Plus imx Gsm Plus SOLO Lite) Questa modalità di connessione non usa il CSIcloud e consente di indirizzare la centrale come client verso il pc sul quale è attivo easywlink. Sulla centrale deve essere abilitata la telegestione ed il numero telefonico dal quale verranno inviati i comandi sms deve essere registrato tra quelli del comunicatore. Per implementare una connessione: 1. Verificare l IP assegnato al pc sul quale è attivo easywlink (es.: tramite servizi quali 2. Avviare easywlink, selezionare nel Setup connessione la Gprs ed immettere il codice utente abilitato alle operazioni che andremo ad eseguire ed il numero di porta (Modalità server su porta). Confermare con OK. 3. Aprire su easywlink una pagina di programmazione vuota relativa alla centrale che stiamo contattando. 6

7 4. Inviare alla centrale il comando SMS di connessione diretta seguito dall IP del pc e dal numero porta utilizzato (vedere il manuale della centrale). Il codice utente inserito nell sms deve avere abilitazione alla telegestione. 5. Attendere che su easywlink appaia il box di conferma connessione A questo punto è possibile accedere alle funzioni disponibili dalla centrale, che rimarrà disponibile per circa quattro minuti dopo l ultimo comando o richiesta. La connessione potrà comunque essere terminata con il comando Stop GPRS. Connessione diretta con centrale server (imx imx Lite Gsm SOLO Lite) Questa modalità di connessione non usa il CSIcloud e consente al pc sul quale è attivo easywlink di connettersi come client verso la centrale server. Purtroppo questa modalità di connessione molto spesso non è disponibile perché gli operatori di telefonia mobile sempre più spesso, tramite le loro NAT, assegnano IP non pubblici ai dispositivi come il MultiConnect che utilizzano i loro servizi di rete; siccome questa modalità prevede che la centrale ci invii un SMS indicante l IP assegnato, molto spesso può accadere che tramite quell IP NON si riesca ad accedere alla centrale stessa. Sconsigliamo pertanto questa modalità di connessione, trattandola solamente per ricordarne il funzionamento per apparecchiature più datate, nelle quali le modalità precedenti non erano ancora attive (ma con un semplice upgrade è sempre possibile attivare la precedentemente trattata Connessione diretta con centrale client, per maggiori informazioni contattare CSI SpA). Sulla centrale deve essere abilitata la telegestione ed il numero telefonico dal quale verranno inviati i comandi sms deve essere registrato tra quelli del comunicatore. Per implementare una connessione: 1. Inviare alla centrale il comando SMS di connessione GPRS (vedere il manuale della centrale). Il codice utente inserito nell sms deve avere abilitazione alla telegestione. 2. La centrale effettua la connessione alla rete GPRS, quindi invia l IP assegnatole dalla rete via SMS al numero che le ha inviato il comando. 3. Nel Setup connessione di easywlink, inserire l IP ricevuto via SMS nel campo Connessione via GPRS con MultiConnect; inserire quindi il codice utente abilitato alle operazioni che andremo ad eseguire. A questo punto è possibile accedere alle funzioni disponibili dalla centrale, che rimarrà disponibile per circa quattro minuti dopo l ultimo comando o richiesta. La connessione potrà comunque essere terminata con il comando Stop GPRS. 7

8 Connessione con componenti wireless WLINK Nei confronti dei componenti radio wireless WLINK, easywlink supporta solamente la connessione radio, che è ovviamente la più semplice e veloce; alcuni di questi componenti (ad esempio un telecomando) hanno dimensioni così contenute che sarebbe un grosso problema doversi collegare fisicamente con essi. Verificare preventivamente che USBPOD sia dotato di almeno un modulo RFPORT (4 o 8) e che il componente WLINK possegga lo stesso modulo (o anche entrambi). Anche in questo caso le modalità di connessione sono molto semplici: 1. Inserire USBPOD in una porta USB del PC. 2. Entrare in attesa connessione sul componente WLINK; normalmente questo si ottiene premendo brevemente un tasto siglato PROG, ma raccomandiamo la lettura del documento di programmazione del componente stesso. Se già associato ad una centrale, è anche possibile per la maggior parte dei componenti WLINK di entrare in attesa connessione su comando della centrale, ma per queste operazioni raccomandiamo la lettura dei manuali delle centrali in oggetto. 3. Avviare easywlink. 4. Verificare che sia selezionato il parametro Connessione via radio con USBPOD nel setup di easywlink, che l ID sistema corrisponda a quello programmato nel componente (52428 di default) e che siano abilitati gli RFPORT presenti sia nel componente stesso che nell USBPOD. 5. A questo punto, è possibile leggere la programmazione ed i parametri funzionali accessibili del componente stesso, così come riscrivere la programmazione. 6. Per terminare la connessione, premere il tasto Disconnetti per liberare il componente dall attesa connessione (oppure, normalmente, ripremere il tasto PROG del componente). 8

9 9

10 Procedure easywlink è uno strumento flessibile e semplice da usare su qualsiasi sistema filare e wireless WLINK. Le modalità di utilizzo sono comuni agli strumenti software CSI ed alle modalità degli applicativi Windows; di seguito trattiamo i principali comandi disponibili. Nuovo Comando apertura nuovo file programmazione oppure eventi; selezionare la tipologia di programmazione o file eventi desiderato. Apri Apre un file già esistente avviandone la procedura relativa. Salva Salva un file di programmazione o eventi. Legge dalla centrale Legge la programmazione dalla centrale connessa (via filo, radio o Internet). Programma la centrale Invia la programmazione alla centrale connessa (via filo, radio o Internet). Regola l orologio Legge o imposta l orologio della centrale connessa (via filo, radio o Internet). Programmazione periferiche Apre il box di dialogo riguardante la programmazione delle periferiche WLINK compatibili. Setup connessione Consente di impostare la tipologia di connessione (diretta, via radio o via Internet-GPRS). Stop GPRS Quando attiva, consente di terminare una connessione tramite Internet (GPRS). Informazioni su Visiona la versione del software easywlink 10

11 N.B.: durante il trasferimento dati (lettura/programmazione) da e verso le centrali, una barra di caricamento indica lo stato del trasferimento stesso. Su alcuni PC, e con determinate versioni dei sistemi operativi, può accadere che la barra si fermi. Questo non deve destare preoccupazione in quanto il trasferimento comunque prosegue; se lo stesso si dovesse fermare, comparirebbe un messaggio d errore. 11

12 12