D: Come si avvia Shelly Scanner?

R: Per eseguire l'applicazione:

1. dopo aver scaricato il file zip dal link presente nella sezione di download;
2. scompattare il file sul disco;
3. Eseguire (doppio click) il file shellyscan-0.x.x.jar (l'estenzione "jar" potrebbe non comparire a causa delle impostazioni del sistema operativo) oppure avviare l'applicazione da terminale con la seguente riga di comando:
   java -jar <path completo>\shellyscan-x.x.x.jar
   (Per Mac - OS X vedi oltre).

D: Perchè Shelly Scanner non si avvia? (1)

R: Per eseguire Shelly Scanner è necessario che sia installata la jre Java in versione 17 o superiore.
Per scoprire se la jre è già installata sul computer e in che versione si può aprire un terminale ed eseguite il comando: java -version; se il risultato è un messaggio di errore probabilmente la jre non è installata, altrimenti sul terminale compare un messaggio nel cui contenuto è indicata la versione.
Si può scaricare java gratuitamente da:

• Oracle.com una jdk completa;
• ottenere una jre molto leggera da Eclipse Temurin jre;
• o utilizzare una qualsiasi altra jre/jdk.

D: Perchè Shelly Scanner non si avvia? (2 - Windows)

R: Shelly Scanner si dovrebe avviare con un semplice doppio click sul file con estensione "jar" shellyscan-0.x.x.jar; talvolta l'associazione tra i file di tipo jar e la jre (java runtime environment) sparisce o non viene creata (WinRAR, se installato, talvolta è il colpevole); in questo caso si può:

1. associale nuovamente l'estensione jar a java.exe: tasto destro del mouse sul file - Apri con ...;
2. tentare una nuova installazione della jre;
3. utilizzare un tool come jarfix che ripristina l'associazione corretta.

D: Perchè Shelly Scanner non si avvia? (3 - Windows)

R: Alcune jdk hanno un bug che produce un errore che inibisce il corretto avvio di Shelly Scanner con particolari configurazioni dell'interfaccia di rete; in questo caso l'avvio con il seguente comando: java -jar -Djava.net.preferIPv4Stack=true <path completo>/shellyscan-x.x.x.jar dovrebbe risolvere il problema.

D: Perchè Shelly Scanner non si avvia? (4 - OS X)

R: Per eseguire Shelly Scanner su OS X occorre creare all'interno della cartella ottenuta dopo aver scompattato il file compresso un file di testo (ASCII) contenente la seguente riga java -jar /Applications/ShellyScanApp/shellyscan-x.x.x.jar, rendere eseguibile il file eseguendo da terminale il comando chmod 755 <nome del file di testo>, spostare la cartella in Applicazioni e infine eseguire il file creato fornendo le autorizzazioni eventualmente richieste. Inoltre, in alcuni casi, è necessario autorizzare l'applicazione a scrivere sul disco: System Settings -> Privacy & Security -> Full Disk Access aggiungere shellyscan-<...> per consentire a Shelly Scanner di scivere il suo file di configurazione.

D: Java è già installato sul mio computer? In che versione?

R: Per scoprirlo si può aprire un terminale ed eseguite il comando: java -version; se il risultato è un errore probabilmente java non è installato sul computer, altrimenti sul terminale compare un messaggio nel cui contenuto è indicata la versione. Shelly Scanner richiede una versione 17 o superiore.

D: Perchè Shelly Scanner non trova i miei dispositivi (1)?

R: E' necessario fornire a java le autorizzazioni ad accedere alla rete al suo avvio (questa richiesta vi sarà fatta soltanto al primo avvio).

D: Perchè Shelly Scanner non trova i miei dispositivi (2 - Windows)?

R: Verificate che la rete sia impostata come "privata". Dopo aver eventualmente modificato questa impostazione, in qualche caso, è necessario riavviare il sistema operativo.

D: Perchè Shelly Scanner non trova i miei dispositivi (3)?

R: E' possibile che i dispositivi non si trovino esattamente sulla stessa rete alla quale è collegato il computer. In questo caso è necessario configurare l'applicazione in modo che effettui il "full scan" dal dialog di configurazione (Attenzione: questa opzione sarà valida solo al successivo riavvio dell'applicazione).
In alternativa è possibile avviare l'applicazione da terminale con la seguente riga di comando: java -jar <path completo>\shellyscan-x.x.x.jar -fullscan che ignora la configurazione correntemente impostata.

D: Perchè Shelly Scanner non trova i miei dispositivi (4)?

R: Se i dispositivi si trovano su una rete separata (è, per esempio, il caso di una sottorete dedicata ai dispositivi domotici) occorre configurare l'applicazione in modo che effettui lo "scan by IP" dal dialog di configurazione , questa modalità però non consente la ricerca di alcuni Shelly alimentati a batteria come Button 1, Flood e D&W.

D: Il codice sorgente di Shelly Scanner è consultabile?

R: Si, Shelly Scanner è distribuito sotto GNU General Public License v3.0; il codice sorgente completo è reperibile su GitHub.

D: E' possibile inviare segnalazioni di eventuali malfunzionamenti?

R: Per informazioni, commenti o segnalazioni è possibile inviare un messaggio al seguente indirizzo di posta elettronica: info@usna.it.