IKON PDK TOOL PER LA CREAZIONE DI PROGETTI OFFLINE PER IKON SERVER MANUALE UTENTE RELEASE 0.6
Indice INTRODUZIONE A IKON PDK Panoramica di IKON PDK e requisiti per l utilizzo sul proprio PC UTILIZZO DI IKON PDK Guida all avvio di IKON PDK ed alla gestione di progetti sul proprio PC
3 Introduzione COSA è IKON PDK IKON PDK (Project Development Kit) è uno strumento software per la realizzazione di progetti di supervisione basati sul controller web IKON direttamente sul proprio PC, in modalità offline. Grazie a IKON PDK è possbile creare o modificare uno o più progetti di supervisione sul proprio PC senza dover essere connessi ad un controller IKON via rete. I progetti realizzati con IKON PDK sono compatibili con qualunque IKON avente la medesima versione software; un progetto può essere ad esempio esportato da un IKON, modificato in IKON PDK, ed importato nuovamente sul medesimo controller IKON oppure su un altro controller, purché dotato anch esso della medesima versione software. IKON PDK non è un software di supervisione domotica: esso non è infatti in grado di comunicare con il bus KNX o con qualunque delle tecnologie gestite da IKON, bensì solamente un editor di progetti. Per lo svolgimento di qualunque operazione di supervisione è necessario disporre di un controller IKON. REQUISITI IKON PDK può essere eseguito su qualunque PC dotato di sistema operativo WINDOWS a 32bit, in versione XP o superiore. Per l utilizzo su sistemi a 64bit, vedasi capitolo successivo relativo all uso di IKON PDK su altri sistemi operativi. IKON PDK non necessita di alcuna installazione, e non prevede il salvataggio di nessun dato sul proprio PC al di fuori delle cartelle del PDK stesso; in questo modo, è possibile: > Spostare la cartella di IKON PDK su un altro PC per avere integralmente la gestione del progetto > Duplicare la cartella di IKON PDK sul medesimo PC per poter gestire contemporaneamente più di un progetto, senza dover importare/esportare alcun file di backup CONTROLLO VERSIONE SOFTWARE Per poter scambiare progetti tra IKON PDK ed uno o più controller IKON è fondamentale la verifica della compatibilità tra le versioni software. In generale, un progetto (backup) è sempre caricabile su una versione software più recente, ma non il viceversa; per questo motivo è importante allineare IKON PDK ed i controller IKON all ultima versione disponibile. La versione software di IKON è sempre visibile nella toolbar della sezione di AMMINISTRAZIONE, come mostrato nella figura di esempio sottostante. Per aggiornare il proprio controller IKON, è sufficiente contattare il servizio clienti DOMOTICA LABS richiedendo il link per scaricare l ultima versione software. Per lavorare offline sull ultima versione software viceversa scaricare dal sito www.domoticalabs.com l ultima versione di IKON PDK, avendo cura di esportare il proprio lavoro dalla vecchia versione e di importarlo nella nuova, come riportato in seguito in questo manuale. DOCUMENTAZIONE CONSIGLIATA Prima di iniziare ad utilizzare IKON PDK si consiglia di leggere il manuale utente di IKON; le funzionalità del tool di gestione progetti offline sono infatti identiche a quelle del controller di supervisione, e si rimanda pertanto al manuale utente per ogni dettaglio. INTRODUZIONE A IKON PDK
4 Utilizzo di IKON PDK UTILIZZO DI IKON PDK CONTENUTO DELLA CARTELLA DI PDK IKON PDK è distribuito sotto forma di una cartella contenente tutti i files necessari per la sua esecuzione. Non è necessaria alcuna installazione all interno del proprio PC; tutti i dati sono contenuti all interno delle sottocartelle di IKON PDK. Per poter salvare le modifiche ai progetti gestiti da IKON PDK, è necessario che le cartelle siano scrivibili; è sufficiente copiare tutto il contenuto della cartella principale di IKON PDK sull hard-disk del proprio PC - oppure su un altra unità removibile scrivibile - per poter utilizzare il tool. Non è viceversa possibile salvare i progetti se si esegue IKON PDK da un CD-ROM o altro supporto di sola lettura. E possibile copiare più volte il contenuto di IKON PDK all interno del proprio PC in cartelle differenti, in modo da gestire contemporaneamente più di un progetto; sarà sufficiente eseguire il tool (come illustrato in seguito) dall interno della cartella specifica per gestire il progetto corrispondente. ESECUZIONE DI IKON PDK Per eseguire IKON PDK è sufficiente fare doppio click sullo script start.vbs presente nella cartella principale; viene avviato automaticamente l ambiente di esecuzione virtuale di IKON PDK. La sequenza di avvio può richiedere anche alcuni minuti, in base alle prestazioni del proprio PC; questa fase è accompagnata da una barra di avanzamento come quella riportata nella figura a lato. NOTA: alla prima esecuzione di IKON PDK, durante la fase di avvio potrebbe essere richiesta l autorizzazione allo sblocco da parte di Windows Firewall; acconsentire per permettere la corretta esecuzione del tool. Al termine della procedura di avviamento, viene mostrata la schermata riportata nella figura a lato; lasciare aperta questa finestra - contenente l ambiente virtuale di IKON PDK - e aprire un browser web al seguente indirizzo: http://127.0.0.1:8080 Viene mostrata la schermata web riportata nella figura NOTA: si consiglia l utilizzo di GOOGLE CHROME per la configurazione di IKON PDK. IKON PDK è comunque compatibile anche con MOZILLA FIREFOX e APPLE SAFARI.
5 a lato, in cui viene richiesto di inserire le credenziali di accesso. Sono disponibili i seguenti utenti predefiniti: > Amministratore di sistema Username: admin Password: admin > Configuratore di sistema Username: manager Password: manager > Utente base Username: user Password: user NOTA: come riportato nel manuale utente di IKON, è preferibile l utilizzo di GOOGLE CHROME quale browser per la configurazione e l utilizzo di IKON PDK. Importazione di un progetto Per importare un progetto all interno di IKON PDK, procedere nel modo seguente: > Esportare precedentemente il progetto mediante la pagina di gestione del database del IKON che si desidera configurare > Accedere a IKON PDK inserendo le credenziali di amministratore di sistema, quindi selezionare l icona ADMIN (in basso a destra) > Nell albero MENU identificare ed aprire la voce SETUP quindi selezionare BACKUP/RESTORE > Selezionare IMPORTA e selezionare il file di backup sul proprio PC, quindi fare click su ESEGUI per importare il progetto Una volta completata la procedura di importazione, iniziare a configurare il progetto seguendo le istruzioni contenute nel manuale utente di IKON. UTILIZZO DI IKON PDK
UTILIZZO DI IKON PDK 6 ESPORTAZIONE di un progetto Per esportare un progetto da IKON PDK, in modo da poterlo utilizzare in un secondo momento oppure copiare all interno di un IKON, procedere nel modo seguente: > Accedere a IKON PDK inserendo le credenziali di amministratore di sistema, quindi selezionare l icona ADMIN (in basso a destra) > Accedere alla sezione SETUP del MENU quindi BACKUP/RESTORE > Selezionare ESPORTA e fare click su ESEGUI per completare il salvataggio del backup sul proprio PC Una volta completata la procedura di esportazione, caricare il backup in un IKON oppure un altra copia di IKON PDK. CHIUSURA DI IKON PDK Per terminare la sessione di lavoro con IKON PDK è sufficiente chiudere la finestra relativa attraverso il consueto pulsante in alto a destra; selezionare SPEGNERE LA MACCHINA quando richiesto e confermare con il pulsante OK. ESECUZIONE MANUALE DEL PDK Qualora si verifichi un errore durante la procedura di avviamento dell ambiente virtuale di IKON PDK, è possibile provare a lanciarlo manualmente dall ambiente di virtualizzazione integrato. A tale scopo procedere come segue: > Fare doppio click sul file Portable-VirtualBox. exe ed attendere il completo caricamento > Selezionare dal menu di sinistra la voce IKON PDK e fare click su AVVIA tra i pulsanti di controllo in alto a sinistra > Procedere come illustrato in precedenza CREDITI IKON PDK è basato su VIRTUALBOX PORTABLE, una particolare versione dell ambiente di virtualizzazione VIRTUALBOX di ORACLE che non richiede l installazione sul proprio PC. Per qualunque informazione relativa a VIRTUALBOX e VIRTUALBOX portable si prega di far riferimento ai rispettivi siti internet: www.virtualbox.org www.vbox.me DOMOTICA LABS non è da considerarsi responsabile per eventuali problemi di natura software o hardware, ivi comprese perdite di dati, indotte dall utilizzo di questi software al di fuori degli scopi di IKON PDK.
UTILIZZO DI IKON PDK SU ALTRI SISTEMI OPERATIVI IKON PDK è predisposto per operare in automatico solo su sistemi MICROSOFT WINDOWS a 32 bit. Per utilizzarlo su altri sistemi operativi, o su sistemi WINDOWS a 64bit, è necessario procedere manualmente come descritto nei passaggi successivi. > Installare l ultima versione del software VIR- TUALBOX (versione 4.0 o superiore) sul proprio PC, in base alla propria versione di sistema operativo, seguendo le istruzioni riportate nel sito www.virtualbox.org > Creare una nuova macchina virtuale utilizzando l apposito pulsante; quando richiesto, indicare IKON PDK come nome della macchina virtuale, Linux come sistema operativo e Linux 2.6 come sotto-versione (opzionale). Fare click su continua > Assegnare 256MB di memoria RAM alla macchina virtuale e continuare con la procedura > Specificare usa un disco fisso esistente e fare click sul pulsante di selezione per aprire il GE- STORE SUPPORTI VIRTUALI. Fare click sul pulsante AGGIUNGI e selezionare il disco virtuale presente nella cartella di IKON PDK, ubicato nella sottocartella data\.virtualbox\harddisks\ikonpdk.vdi Confermare con il pulsante seleziona > Completare la procedura facendo click sul pulsante COMPLETATO nella finestra di riepilogo > Selezionare la macchina virtuale nell elenco di sinistra, quindi fare click sul pulsante IMPOSTA- ZIONI, quindi selezionare la voce RETE > Selezionare NAT come modalità, quindi attivare la modalità avanzata ed inserire il seguente MAC address nell apposita casella di testo: 080027C69C34 > Fare click sul pulsante INOLTRO DELLE PORTE ed aggiungere la regola seguente: - Porta host: 8080 - Porta guest: 80 > Salvare le impostazioni e avviare la macchina virtuale mediante l apposito pulsante AV- VIA. Collegarsi mediante browser all indirizzo http://127.0.0.1:8080 come illustrato in precedenza.
Domotica Labs S.r.L. Indirizzo: Via Marconi 26/A, 12040 Genola (CN) - Italy P.IVA / C.F. : 03029110040 Ufficio: +39.0172.68.90.43 Fax: +39.0172.50.31.14 Mail: amministrazione@domoticalabs.com Sito internet: www.domoticalabs.com