EasySet APP Android di programmazione ISM G

Transcript

1 EasySet APP Android di programmazione ISM G Ver , Febbraio DoingSecurity, all rights reserved ING. GIANNI SABATO Via S. Stefano 74, I Bologna GSM Ph Fax Web:

2 EASYSET DOINGSECURITY 2 DOINGSECURITY si riserva il diritto di apportare qualunque cambiamento al presente manuale in qualunque parte senza preavviso scritto. DoingSecurity SAS ha dedicato il massimo sforzo per assicurare che il presente documento sia preciso nelle informazioni fornite; tuttavia, DoingSecurity SAS non si assume alcuna responsabilità per eventuali errori ed omissioni, con ciò includendo qualsiasi danno risultante dall uso delle informazioni contenute nel presente manuale. Assistenza tecnica Tel.: / Tel.: : info@doingsecurity.it

3 EASYSET DOINGSECURITY 3 Indice Indice Introduzione Prerequisiti per l'installazione dell'app Funzioni dell'app EasySet Avvio Menu di Configurazione Users Administrators Intercom Inputs Outputs PIN Access Codes Temp Management Misc Device Log Salvataggio impostazioni... 24

4 EASYSET DOINGSECURITY 4 1 Introduzione L'App EasySet è un tool di programmazione e gestione del dispositivo ISM G. È disponibile sia per piattaforma Android che ios; nel presente documento viene mostrata la versione per Smartphone / Tablet Android. 1.1Prerequisiti per l'installazione dell'app Di seguito viene mostrata l'app EasySet utilizzando un ASUS 7", sistema operativo v ; ciò nonostrante l'app è utilizzabile da tutte le piattaforme Android con sistema operativo a partire dalle versioni 4.x.x. Utilizzando lo store disponibile sul dispositivo Android, effettuare la ricerca con la stringa EASYSET e autorizzare il download dell'app. Al termine del download, l'app EeasySet è immediatamente utilizzabile toccando su APRI - vd Figura 1.1.

5 EASYSET DOINGSECURITY 5 Fig Download da store e avvio dell'app EasySet NOTA. Si consiglia di effettuare sempre una prova di funzionamento del dispositivo ISM G in modalità Off-Line, cioè con programmazione via SMS: questo permette di eliminare qualunque problema derivante da segnali GSM deboli e/o malfunzionamenti dell'hardware prima di utilizzare l'app. Si faccia riferimento al documento "ISM G Guida Rapida v IT.pdf".

6 EASYSET DOINGSECURITY 6 2 Funzioni dell'app EasySet 2.1Avvio Al primo avvio, l'app EasySet sono richieste le credenziali di accesso: oltre al numero di telefono della SIM installata sul dispositivo, è necessario conoscere l APN del provider di servizi telefonici. L APN - Access Point Name - è un parametro caratteristico di ciascun provider: per esempio, l APN per una scheda SIM della TIM è ibox.tim.it. Accertarsi di essere in possesso del paramero APN per il provider della SIM da utilizzare. Le credenziali di login (in particolare USER, PASSWORD e DEVICE IP) vanno richieste a DoingSecurity prima dell utilizzo dell ISM G: deve solamente essere fornito il numero di telefono a cui l account verrà associato. È possibile utilizzare la richiesta di creazione account tramite la APP - vd. Fig. 2.1.

7 EASYSET DOINGSECURITY 7 Fig Account per l accesso via rete all'ism G Dopo aver effettuato l accesso, l'app presenta le diverse opzioni per poter programmare e gestire il dispositivo, essendo già aperto il canale di comunicazione fra il tablet Android e l'ism G - vd. Fig Il fatto che la APP sia in comunicazione con il dispositivo ISM G è sottolineato anche dal livello di potenza del segnale GSM che il dispositivo è in grado di rilevare (nell esempio sotto riportato, livello 13). Oltre all informazione precedente, la APP mostra il nome fornito al sito dove è installato l ISM G (in questo esempio, My office ) e il numero di telefono della SIM inserita al suo interno.

8 EASYSET DOINGSECURITY 8 Fig Comunicazione avviata con ISM G Toccando il pulsante INFO si ottengono tutte le informazioni riferite al dispositivo - vd. Fig. 2.3.

9 EASYSET DOINGSECURITY 9 Fig Info del dispositivo ISM G Toccando l area di schermo dove è riportato il nome mnemonico fornito all impianto (dove è scritto My office con il numero di telefono nella figura 2.2), si apre il menu principale - vd. Fig. 2.4.

10 EASYSET DOINGSECURITY 10 Fig Menu dell'app EasySet Il primo passaggio da compiere è quello di leggere i parametri memorizzati sul dispositivo: questa funzione (che effettua un Wake-on dell ISM G) si ottiene toccando lo schermo su READ configuration from device. Notare che la lettura della configurazione viene eseguita via Server senza dover scambiare messaggi SMS fra il dispositivo Android e l'ism G (tranne un messaggio SMS per il WakeOn). La lettura dei parametri può durare anche diversi minuti e dipende dalla qualità del collegamento disponibile: è possibile monitorare l avanzamento del processo con la barra di avanzamento come illustrato in Fig Fig Barra di avanzamento della lettura dei parametri dell'ism G

11 EASYSET DOINGSECURITY 11 Al termine della lettura, si è in grado di modificare la configurazione del dispositivo toccando lo schermo su Configuration : si ottiene il menu e le funzioni illustrate nei paragrafi sotto riportati. 2.2Menu di Configurazione Il menu di Configurazione mostra le diverse Tab - rispettivamente da sinistra a destra: Users - tab per l impostazione della funzione CLIP che permette di azionare gli output dell ISM G effettuando una chiamata, a costo nullo, alla SIM del dispositivo. Administrators - è la tab che serve a configurare i numeri associati agli amministratori e le attività a loro permesse. Intercom - è la tab per configurare le funzioni di interfono relative agli ingressi dell ISM G identificati con G, B, W, Y e CB1. Inputs - è la tab per configurare gli ingressi digitali dell ISM G. Outputs - questa tab configura gli output a relè dell ISM G. Pin access codes - è la tab dove definire fino a 1000 codici identificativi Wiegand (per esempio relativi a tessere RFID) da utilizzare attraverso i lettori collegabili agli ingressi locali dell ISM G. Temp management - è la tab per gestire le sonde di temperatura allo specifico ingresso disponibile sull ISM G. Misc - tab dove impostare parametri di uso generale. Device log - tab per impostare i LOG del dispositivo ISM G al fine di analizzare l uso dell impianto Users Questa Tab serve a configurare fino a 1000 utenti CLIP - vd. Fig La funzione CLIP permette di attivare - da remoto - i relè dell ISM G semplicemente effettuando una chiamata (senza risposta) al numero di SIM presente nel dispositivo. Notare che è necessario che il numero di telefono chiamante sia visibile in rete affinché la funzione CLIP sia attivata. La tab permette di: Definire su quale output la funzione CLIP deve agire (Ouput 1 o 2 rispettivamente per il relè 1 e il relè 2 dell ISM G) - vd. Fig Definire il modo con cui gli utenti CLIP possono agire sull output (notare che l opzione Always ON significa che qualsiasi numero che chiama la SIM dell ISM G attiva l output; si consiglia la scelta ON for specific users) - vd. Fig Elencare i numeri di telefono abilitati alla funzione CLIP - vd. Fig. 2.9.

12 EASYSET DOINGSECURITY 12 Fig USERS Fig USERS - Definizione Output Mode Fig USERS - Definizione Output Security Mode

13 EASYSET DOINGSECURITY 13 Fig USERS - Definizione numeri di telefono CLIP Administrators Gli Amministratori sono i possessori di massimo 5 numeri di telefono abilitati, da remoto, al accesso all ISM G per configurare i parametri di lavoro, aggiungere o eliminare utenti, ecc. Le immagini contenute in questo documento, sono state effettuate con un dispositivo Android ed il numero Administrator 1 - vd. Fig Un numero Amministratore può anche essere un numero CLIP.

14 EASYSET DOINGSECURITY 14 Fig ADMINISTRATORS Gli Amministratori sono in grado di ricevere una chiamata da parte dell ISM G ogni X giorni, di effettuare un test periodico sul funzionamento del dispositivo ed inviare SMS di test. È anche possibile limitare il numero degli amministratori a meno dei 5 numeri permessi - vd. Fig Fig ADMINISTRATORS - limitazione al numero di amministratori ammessi

15 EASYSET DOINGSECURITY Intercom Qualora sia collegato un microfono, un altoparlante ed un pulsante di chiamata agli ingressi previsti dell ISM G, allora il dispositivo può comportarsi anche da citofono GSM. In questo caso, possono essere configurati i parametri mostrati in Fig Fig INTERCOM I parametri su cui agire sono: Pulsanti per i quali è configurata la funzione Intercom (notare che nell ISM G è presente un solo ingresso pulsante tale per cui il parametro Button 2 è sempre Disabled). Definire la durata massima della conversazione sulla linea GSM - per default questo valore è fissato a 60 secondi. Definire i valori di guadagno del microfono e dell altoparlante (attenzione a non impostare valori troppo elevati che potrebbero causare effetti eco non desiderati ed influire negativamente sulla qualità dell audio). Definire se e come il tono di chiamata deve agire ed essere eventualmente udibile.

16 EASYSET DOINGSECURITY Inputs Nella Tab INPUTS vengono definiti i parametri di lavoro dei due ingressi digitali disponibili nell ISM G - vd. Fig Fig INPUTS I parametri su cui agire sono: Input 1 mode (o Input 2 mode) - è la modalità con la quale si determina la logica di lavoro dell ingresso digitale - vd. Fig Input 1 SMS delay (o Input 2 SMS delay) - definisce il ritardo di invio di un SMS dal momento in cui l ingresso diventa attivo. Input 1 ID (o Input 2 ID) - definisce le stringhe dell SMS da inviare dal momento in cui l ingresso diventa attivo.

17 EASYSET DOINGSECURITY 17 Fig INPUTS - Definizione Input mode Outputs Fig OUTPUTS

18 EASYSET DOINGSECURITY 18 Nella Tab OUTPUTS vengono configurati gli output disponibili nell ISM G - vd. Fig I parametri su cui agire sono: Output generati da stati di allarme - nella prima sezione della Tab sono presenti eventi che, se selezionati, possono generare uscite di allarme. È da notare come l output possa essere abilitato o meno da parte di un input (è il caso in cui si desidera che un attivazione di un uscita avvenga in presenza di un ingresso attivo - per esempio, presenza di un veicolo su un loop che attiva un ingresso e rende possibile che un utente si identifichi per poter azionare l output). Ouput 1 (o Output 2) mode - è il modo operativo dell uscita: se configurata in modo impulsivo, allora l uscita viene attivata per il tempo indicato dal parametro Time Pulse (in secondi). L output oltre al modo impulsivo può essere configurato come bistabile o essere disabilitato. Vd. Fig Fig OUTPUTS - configurazione output NOTA. L opzione Wiegand data access serve ad abilitare / disabilitare l interfaccia Wiegand 26 bit PIN Access Codes Nella Tab PIN Access Codes vengono inseriti i codici identificativi da utilizzare con il lettore connesso in Wiegand 26 bit all ISM G - vd. Fig Possono essere registrati fino a 1000 utenti diversi, in due gruppi da 500 (il primo gruppo agisce sul primo relè, il secondo gruppo agisce sul secondo relè).

19 EASYSET DOINGSECURITY 19 Fig PIN Access Codes Toccando Show pin codes dell gruppo dove inserire nuovi codici (o eliminare codici esistenti), la tabella si espande mostrando le varie caselle di memoria (vd. Fig. 2.18). Il formato dei dati in ciascuna casella è il seguente (una virgola è usata quale separatore fra i diversi campi): Numero ID a 16 bit (oppure nel formato 8-16, se venisse incluso anche il codice sito). Uscite che l ID è in grado di attivare (massimo 4 uscite) dove 1 e 2 sono i relè dell ISM G e i numeri da 1 a 4 successivi alle lettere A, B C e D identificano i 4 relè dei moduli di espansione EXIO4 (massimo 4 moduli di espansione sul bus RS485). Parametro che abilita le notifiche all amministratore (1) e che abilita il codice al funzionamento (2).

20 EASYSET DOINGSECURITY 20 Fig PIN Access Codes - edit delle caselle da 1 a 500 Nell esempio sopra riportato, il codice a 16 bit della tessera di prossimità abilita i due relè dell ISM G e il relè n.1 dell espansione EXIO4 collegata in bus RS485 all indirizzo D. Il codice è abilitato (presenza del parametro 2 nell ultimo campo dopo l ultima virgola). Se l identificativo del PIN è 0, allora significa che quella memoria è vuota. NOTA. L APP - essendo previsto che lavori in modalità remota - non è in grado di effettuare un autolettura del codice RFID di, per esempio, una tessera di prossimità: è necessario che di ciascun badge o TAG sia noto il codice ID a priori. Un autolettura del codice è ottenibile con il programma EASYSET in funzione su PC Windows e collegamento USB all ISM G. Normalmente sui badge di prossimità il codice si può trovare stampato in chiaro nel formato 8,16 bit:

21 EASYSET DOINGSECURITY Temp Management La funzione Temp Management - vd. Fig permette di ottenere allarmi dall ISM G su soglie di temperature predefinite. Per esempio, al raggiungimento della soglia 0 C potrebbe essere utile ottenere un SMS di allarme grazie al quale poter decidere se, per esempio, attivare un output da remoto (cioè attivando un riscaldatore collegato ad un relè del dispositivo). È anche possibile che, al raggiungimento di una soglia di temperatura, l ISM G esegua un attivazione dell output in automatico (vd. opzioni Alarm to Outputs). Gli SMS di allarme possono essere ricevuti solo dagli Amministratori. Fig TEMP MANAGEMENT Misc La Tab Misc - vd. Fig permette di definire parametri di uso generale.

22 EASYSET DOINGSECURITY 22 Fig MISC Possono essere definiti i parametri seguenti: Lingua - selezione della lingua utilizzata per gli SMS di testo. Restart - intervallo di tempo per il riavvio dell ISM G (se il parametro è 0, il modulo 3G non viene mai riavviato); questa funzione corrisponde ad uno spegnimento e successiva riaccensione dell ISM G senza però dover intervenire sull alimentazione. Abilitazione aggiornamento orologio - via rete, il dispositivo acquisisce automaticamente l ora corrente. Definizione del tipo di SIM utilizzata - normalmente è una prepagata, ma potrebbe anche essere una SIM di tipo M2M (offerta solo su specifica richiesta del Cliente). Parametri rilevanti per la ricarica della SIM prepagata (es. Gestione del basso credito residuo).

23 EASYSET DOINGSECURITY Device Log La Tab Device Log - vd. Fig permette di stabilire come effettuare la gestione dei Log. Questi sono normalmente memorizzati nella memoria locale dell ISM G e possono essere azzerati automaticamente qualora il flag relativo a quell opzione è settato. Fig DEVICE LOG Per poter leggere i log (che non possono essere memorizzati su dispositivo mobile Android - per tale funzione usare un PC Windows), utilizzare la funzione EVENTS che è presente nella pagina di avvio dell APP - vd. Fig Si ottiene un elenco di log come mostrato in Fig

24 EASYSET DOINGSECURITY 24 Fig EVENTS L elenco degli eventi mostra le informazioni seguenti: Numero evento - progressivo che identifica l evento in successione nella tabella. Data e ora - è il time stamp dell evento. Tipo di evento (indicato dall etichetta ACT, cioè action). Numero di telefono che ha azionato l output in modalità CLIP o numero PIN di accesso. Uscite che sono state attivate. Notare che l elenco dei log si ottiene anche toccando READ device log della pagina principale - vd. Fig Salvataggio impostazioni Qualunque modifica effettuata sull ISM G deve essere salvata inviando le nuove impostazioni al dispositivo remoto. Questo può essere fatto toccando SEND parameters to unit - vd. Fig. 2.4.