Applicazione Android iSMA
Manuale d'uso

Introduzione

L'applicazione Android iSMA è un'app progettata per i pannelli PC industriali iSMA CONTROLLI, che consente una facile registrazione e accesso alla stazione Niagara o a qualsiasi piattaforma HTML5 webserver. Le credenziali della stazione Niagara possono essere inserite una sola volta, e ad ogni logout o riavvio del pannello del PC industriale l'utente viene automaticamente riconnesso. Il sistema operativo Android offre molte possibilità ma il dispositivo può essere gestito anche solo come interfaccia utente per tenere traccia della temperatura nelle stanze o modificare alcune impostazioni del sistema, che viene gestito tramite la modalità Kiosk dell'applicazione. La modalità Kiosk impedisce l'utilizzo di qualsiasi altra applicazione sul pannello. Può essere disattivato solo con la password.

1.1 Cronologia delle revisioni

Rev.	Data	Descrizione
4.3	1 dicembre 2022	Supporto API Rest V2.0.0
4.2	25 maggio 2022	rimarchiati
4.1	14 ottobre 2021	Aggiunta nota nella parte Autologin
4.0	22 giugno 2021	Aggiunta la funzionalità di accesso automatico della quarta edizione
3.1	4 novembre 2020	Lingue dell'applicazione aggiunte
3.0	22 lug 2020	Terza edizione
2.0	6 dicembre 2019	Seconda edizione
1.0	26 agosto 2019	Prima edizione

Tabella 1. Cronologia delle revisioni

Installazione

2.1 Prima dell'installazione

• Per installare l'applicazione sono necessari:
• PC con sistema operativo Windows (ultima versione 32 a 64 o 7 bit);
• Cavo USB A-USB A o USB C-USB A – a seconda della versione di iSMA-D-PA;
• Panel PC iSMA-D-PA7C-B1, iSMA-D-PA10C-B1 o iSMA-D-PA15C-B1.

2.2 Passaggi di installazione
Nota: Ricorda che questa applicazione è riservata esclusivamente ai Panel PC Industriali iSMA e alle stazioni Niagara.
Passaggio 1: aggiungi la cartella con l'applicazione sul desktop del tuo PC.
Passaggio 2: accendere il Panel PC.
Passaggio 3: la porta USB deve essere impostata su Modalità OTG, Debug USB su On e Configurazione USB su MTP (i passaggi da 3.1 a 3.5 sono necessari per i pannelli iSMA-D-PA con interfaccia USB A).
Passo 3.1: Vai al menu principale del Panel PC Android: un'icona bianca rotonda con punti nella parte inferiore centrale dello schermo:

Passaggio 3.2: vai alle Impostazioni:

Passaggio 3.3: vai alle opzioni sviluppatore:

Passaggio 3.4: impostare la modalità USB su modalità OTG e attivare il debug USB:Passaggio 3.5: impostare la configurazione USB su MTP:

Passaggio 4: collegare un cavo USB A al PC e al pannello (utilizzare la presa USB A accanto a RJ45 o USB C contrassegnata nelle figure seguenti):

Passaggio 5: attendere che il PC riconosca il dispositivo e installi i driver.
Passaggio 6: aprire la cartella con l'applicazione.
Passaggio 7: fare doppio clic su install.bat file–l'applicazione verrà installata automaticamente sul Panel PC collegato.
Passaggio 8: l'ultimo passaggio consiste nell'impostare l'applicazione come app Home.
Dopo aver toccato lo schermo, viene visualizzata una nuova finestra. Scegli l'applicazione Android iSMA e seleziona Sempre.Nota: L'applicazione è ora pronta per funzionare. Segui i passaggi successivi per configurare la stazione Niagara e la modalità Kiosk.

Impostazione dell'applicazione

3.1 Accesso a qualsiasi stazione
All'avvio dell'applicazione viene visualizzata la schermata principale che consente di aggiungere più stazioni. Per aggiungere una nuova stazione Niagara, toccare "+ Aggiungi". View' piastrella:Inserisci le credenziali e salvale.

L'accesso alla stazione è disponibile con due opzioni da verificare:

• Abilita la funzione di accesso automatico e
• Proteggere con spilla.

3.1.1 Accesso automatico
Selezionando la funzione Abilita accesso automatico si estendono i campi nome utente e password. Salvate, le credenziali vengono ricordate e la postazione viene loggata automaticamente dal pannello. Se l'opzione rimane deselezionata, l'accesso viene reindirizzato a un accesso esterno websito (Niagara o altro).

Nota: In caso di problemi con l'accesso, si consiglia di lasciare deselezionata l'opzione, che reindirizza al Niagara o ad altro accesso websito e consente l'accesso lì. Tieni presente che supporta l'accesso a qualsiasi controller, che abilita la grafica HTML5.
Nota: Se ci sono problemi con l'apertura della pagina di login, aggiungi la parte “/login.html” o “/preloving” alla fine del messaggio della stazione urlo aggiungere qualsiasi altra estensione che indirizzi l'utente alla pagina di accesso. Nota: Per consentire il corretto funzionamento dell'accesso automatico, ricordarsi di aggiungere un numero di porta dopo l'indirizzo IP del pannello:

• :443 per la connessione https;
• :80 per la connessione http,

Per esempioampon: https://168.192.1.1:443.
Nota: La selezione della funzione di accesso automatico è disponibile dall'applicazione Android iSMA 4.0.
3.1.2 Protezione PIN
Selezionando l'opzione Proteggi con pin, la stazione richiede l'immissione di un numero pin dopo un determinato periodo di inattività in modalità Kiosk. Vai alle impostazioni della modalità Kiosk per ulteriori informazioni sull'accesso alla modalità Kiosk e sull'impostazione del timeout del blocco pin.Dopo aver effettuato con successo l'accesso, l'applicazione torna alla schermata principale con un elenco delle stazioni aggiunte. 3.2 Opzioni della stazione
Tre punti nell'angolo in alto a destra della stazione portano alle impostazioni della stazione:

• Stazione Home: può essere scelta solo per una stazione; la postazione prescelta verrà automaticamente loggata dopo il riavvio o l'accensione del pannello PC Industriale con Android;
• Modifica: modifica le credenziali della postazione;
• Elimina: elimina la stazione.

3.3 Menu dell'applicazione
Quando si scorre verso il basso nella parte superiore del display, è visibile il menu che consente di tornare indietro/avanti/aggiornare/home page. L'icona a nove tessere consente di tornare alla schermata principale view con tutte le stazioni aggiunte.

3.4 Modalità chiosco
Per attivare la modalità Kiosk e modificare la password rispetto a quella predefinita ("password"), fare clic su tre punti neri nell'angolo in alto a destra e scegliere le impostazioni. Appare la nuova schermata:

In questo modo è possibile modificare la password dell'amministratore view insieme all'attivazione/disattivazione della modalità Kiosk. Dopo aver attivato la modalità Kiosk, è necessaria la password per accedere alle impostazioni.
3.5 Altre impostazioni
Altre impostazioni:

• Nascondi navigazione: se selezionato, consente alla navigazione di nascondersi automaticamente dopo un tempo impostato in “Ritardo Nascondere Navigazione”;
• Ritardo di occultamento della navigazione;
• Schermo intero: apre l'applicazione in modalità schermo intero;
• Modalità Kiosk: blocca la possibilità di utilizzare applicazioni diverse dall'Applicazione Android iSMA; La Modalità Kiosk blocca la possibilità di riavviare e spegnere il Panel PC con Android;
• Password di sblocco Kiosk: consente di modificare la password per disattivare la modalità Kiosk; la password predefinita è “password”;
• Consenti la gestione delle connessioni nel chiosco multimediale: se contrassegnato, consente all'utente di aggiungere, rimuovere e modificare le connessioni mentre la modalità Kiosk è attiva;
• Blocco Pin automatico: permette di aggiungere alle credenziali una protezione PIN (può avere fino a 7 cifre); nelle Impostazioni deve essere attivato.

Nota: Il blocco automatico del PIN funziona solo quando la modalità Kiosk è attiva.

• Pin lock timeout: una stazione verrà bloccata dopo un tempo impostato; per sbloccare la postazione è necessario inserire il PIN;
• Esporta impostazioni: le impostazioni possono essere esportate in un file file;
• Importa impostazioni: le impostazioni possono essere importate da un file file;
• Abilita riavvio automatico: quando la modalità Kiosk è attivata, è possibile attivare un riavvio giornaliero del pannello Android;
• Ora di riavvio: qui è possibile impostare l'ora di riavvio.

Lingua

4.1 Modifica della lingua
C'è la possibilità di cambiare la lingua dell'applicazione. L'elenco delle traduzioni aggiunte include:

• PL;
• DE;
• Repubblica ceca;
• ESSO;
• Ungheria;
• LV.

L'applicazione Android iSMA verrà visualizzata nella lingua del sistema, a condizione che la lingua sia inclusa nell'elenco delle lingue dell'applicazione. Se l'utente imposta la lingua del sistema Android su una lingua non disponibile nell'elenco, l'applicazione verrà visualizzata in inglese. Per cambiare la lingua del sistema, seguire i passaggi seguenti:
Fase 1: Vai al menu principale del Panel PC Android: un'icona bianca rotonda con punti nella parte inferiore centrale dello schermo:Fare un passo 2: Vai alle Impostazioni:

Passaggio 3: vai su Lingua e immissione:

Fare un passo 4: Vai su Lingua, che espande l'elenco delle lingue disponibili tra cui scegliere. Tocca la lingua scelta:

Aggiornamenti

Seguire i passaggi seguenti per installare un aggiornamento:
Fase 1: Installazione fileI messaggi dovrebbero trovarsi su un'unità flash USB.
Passaggio 2: disattiva la modalità Kiosk.
Passaggio 3: inserire l'unità flash USB in una porta USB situata accanto a RJ45 (figure 6 e 7).
Passaggio 4: l'unità USB inserita può essere visibile nel menu Android nella parte superiore dello schermo (scorrere verso il basso).
Passaggio 5: fare clic su file con estensione ".apk" e seleziona Installa nella finestra popup.

Esportazione e importazione

6.1 Esportazione delle impostazioni
Seguire i passaggi seguenti per esportare le impostazioni:
Passaggio 1: seleziona le impostazioni di esportazione o l'impostazione di esportazione con views (esporta le impostazioni insieme ai dati di connessione).

Passaggio 2: viene visualizzata una nuova finestra. Un nome predefinito del file è 'iSMA Export. json' ma può essere modificato; anche a questo punto l'utente deve scegliere la posizione del file file (tocca l'icona dei tre punti nell'angolo in alto a destra dello schermo).

6.2 Importazione delle impostazioni
Seguire i passaggi seguenti per importare le impostazioni:
Passaggio 1: seleziona le impostazioni di importazione.
Nota: L'importazione delle impostazioni sovrascrive le impostazioni correnti, comprese le connessioni aggiunte.
Passaggio 2: scegli un file per importare (toccare l'icona dei tre punti nell'angolo in alto a destra dello schermo); può essere scaricato da un'e-mail, dal cloud o da un'unità flash.

API di riposo

L'applicazione Android iSMA è dotata dell'interfaccia Rest API, che fornisce un accesso remoto ad alcune funzioni dell'applicazione come la modifica delle connessioni salvate o la gestione della luminosità dello schermo e del timeout di inattività. L'API Rest, se abilitata, è disponibile sulla porta 5580.
Una documentazione funzionale completa dell'API Rest dell'applicazione Android iSMA è disponibile nel documento iSMA-Android-Application_Rest-API.html. Fornisce comandi nei seguenti linguaggi di programmazione:

• Curl;
• Giava;
• Java per Android;
• Oggetto-C;
• Italiano:
• C#;
• Italiano:
• Perl;
• Pitone.

L'API Rest per l'applicazione Android iSMA è disponibile in due versioni.
7.1 API resto V1.0.0
L'API V1.0.0 ha le seguenti funzionalità:

• gestire la modalità Kiosk;
• gestire una connessione con avvio automatico view;
• aggiunta, modifica e rimozione della connessione views.

Nota: L'API Rest non richiede un'autenticazione aggiuntiva. Assicurati di utilizzare l'API Rest V.1.0.0 solo su una rete protetta.
7.2 API resto V2.0.0
L'API V2.0.0 ha le seguenti funzionalità:

• abilita un'autenticazione HTTP di base;
• gestire la luminosità e il timeout dello schermo;
• riprodurre brani sull'altoparlante di un dispositivo;
• protezione con nome utente e password configurabili.

Nota: Prendendo in considerazione le funzionalità richieste, abilitare la versione API Rest pertinente nel menu dell'applicazione.

www.ismacontrolli.com
DMP220it | 4° numero rev.
3 | 12/2022

Documenti / Risorse

iSMA CONTROLLI Applicazione iSMA Android [pdf] Guida utente DMP220it, Applicazione Android iSMA, Applicazione Android, Applicazione

Riferimenti

• Manuale d'uso