Software Guide ITA - ENG
Wiicom Sense Cloud
Software Guide ITA - ENG
Revisione documento / Document revision: 1 Versione software / Software version: 1.2 Ultimo aggiornamento / Last update: 04/09/2015
Sense Cloud Software Guide
Condizioni di utilizzo
Le informazioni contenute nel presente documento sono confidenziali e di proprietà della WIICOM SRL. E’ vietata la riproduzione o la cessione a terze parti senza esplicita autorizzazione della WIICOM SRL. Il documento non può essere impiegato per scopi differenti da quelli per cui è fornito. Questa nota deve essere riportata in ogni copia che viene fatta del documento stesso.
1. Utilizzo non autorizzato
1.1 E' vietato l'utilizzo di prodotti WIICOM SRL in applicazioni safety-critical, qualora sia ragionevolmente prevedibile che il mancato corretto funzionamento del prodotto WIICOM SRL possa essere causa di gravi lesioni personali o di decesso. Per applicazioni safety-critical si intendono, a titolo esemplificativo e non limitativo, i dispositivi e le apparecchiature salva vita, le apparecchiature o i sistemi per la gestione di impianti nucleari e le armi. i prodotti WIICOM SRL non sono progettati né sono destinati ad essere utilizzati in applicazioni od ambienti militari od aerospaziali, né in applicazioni od ambienti automobilistici. Il cliente riconosce e conviene che l'eventuale utilizzo di prodotti WIICOM SRL nelle suddette applicazioni od ambienti avverrà a rischio esclusivo del cliente e che quest'ultimo sarà esclusivamente responsabile del rispetto di tutti i requisiti legali e normativi in relazione a tale utilizzo.
2. Conformità alle disposizioni di legge
2.1 Il cliente riconosce e conviene di avere la responsabilità esclusiva del rispetto di tutti i requisiti legali, normativi e di sicurezza relativi ai propri prodotti e ai prodotti WIICOM SRL eventualmente utilizzati nelle applicazioni del cliente, indipendentemente dal fatto che WIICOM SRL fornisca informazioni relative alle applicazioni o servizi di assistenza.
3. Indennizzi
3.1 Il cliente si impegna a tutelare, mantenere indenne e manlevare WIICOM SRL e i produttori e distributori di quest'ultima da qualsiasi perdita, danno, responsabilità e spesa incorsi da terzi e causati da: (i) una violazione effettiva da parte del cliente delle dichiarazioni e garanzie contenute nei presenti termini e condizioni, o (ii) dolo o colpa grave da parte del cliente.
4. Esclusione di danni incidentali, consequenziali e di alcuni altri danni
4.1 Entro i limiti massimi previsti dalla legge, WIICOM SRL e i produttori e distributori di quest'ultima non potranno essere ritenuti responsabili nei confronti del cliente o di terzi per danni speciali, collaterali, indiretti, punitivi, incidentali, consequenziali o esemplari (ivi inclusi, a titolo esemplificativo e non limitativo, i danni derivanti da: mancato guadagno, perdita di informazioni riservate o di altre informazioni, interruzione di attività, lesioni personali, violazione della privacy, non ottemperanza ad obblighi (inclusi la buona fede e la ragionevole diligenza), negligenza, e qualsiasi altra perdita di natura pecuniaria e non) derivanti o comunque relativi all'utilizzo o incapacità di utilizzo dei prodotti o dei servizi di assistenza, o alla fornitura o mancata fornitura dei servizi di assistenza, o comunque cagionati ai sensi di/o in relazione a qualsiasi disposizione del contratto, indipendentemente dal fatto che WIICOM SRL sia stata informata del possibile verificarsi di tali danni. Il presente paragrafo rimarrà pienamente valido ed efficace anche dopo il termine del periodo di garanzia.
5. Limitazione di responsabilità e mezzi di tutela
5.1 Anche in presenza di danni e costi, incluse le spese legali, eventualmente subiti e sostenuti dal cliente per qualsivoglia motivo (ivi incluso, a titolo esemplificativo e non limitativo, tutti i danni sopra descritti, nonché i danni diretti o generali), la responsabilità - da contratto, atto illecito o altro - di WIICOM SRL e dei produttori, distributori, amministratori, dirigenti ed impiegati di quest'ultima, derivante o comunque relativa alla consegna del prodotto, all'utilizzo o incapacità di utilizzo dei prodotti o dei servizi di assistenza, alla fornitura o mancata fornitura dei servizi di assistenza, o in qualsiasi altro modo insorta ai sensi di/o in relazione a qualsiasi disposizione del contratto, sarà esclusivamente limitata alla sostituzione del prodotto. Le limitazioni ed esclusioni sopra descritte si applicheranno entro i limiti massimi consentiti dalla legge, anche qualora il mezzo di tutela non consegua il suo fine essenziale.
INDICE
1 INTRODUZIONE 5
2 MODALITÀ DI ACCESSO A WIICOM SENSE CLOUD 5
3 WIICOM SENSE CLOUD CONFIGURAZIONE 6
3.1 Gestione Utenti - Utenti 6
3.2 Gestione Utenti - Gruppi/Aggregazioni sensori 7
3.3 Gestione sensori - Mappe sensori 8
3.4 Gestione sensori - Sensori 9
3.5 Gestione sensori - Aggregazioni sensori 10
4 WIICOM SENSE CLOUD CONSULTAZIONE MISURAZIONI 11
4.1 Stato sensori 11
4.2 Misurazione sensori 12
4.3 Log sensori 13
1 INTRODUZIONE
Il sistema Wiicom Sense Cloud è installato su una macchina virtuale Vmware con sistema operativo CentOS 7.1. Per facilitarne l'utilizzo questa è priva dei VMTools e di ogni tipo di ottimizzazione legata al processore della macchina host che la ospita.
Il sistema operativo è configurato perchè riceva in DHCP l'indirizzo IP, è possibile modificare questa impostazione direttamente da shell linux utilizzando il comando nmtui (xxxx://xxx.xxxxxx.xxx/xxxxxx/xxxxx-xxxxxxx-xxxxxx-0/).
Il server ha attivo un servizio NTP che può essere utilizzato direttamente dai sensori TH&CO2 Sensor di Wiicom semplicemente impostando nell’apposito campo l’indirizzo ip del server.
L'accesso alla shell può essere eseguito con l'utente root (unico utente di sistema presente) e utilizzando la password w11c0m!1
2 Modalità di accesso a Wiicom Sense Cloud
Per accedere alla componente software Wiicom Sense Cloud e configurare o monitorare il sistema di logging dei dati è sufficiente utilizzare un browser web ed inserire come url a cui collegarsi l'indirizzo ip della macchina virtuale.
Il software è stato pre-configurato con due tipologie di utenti (gruppi): gli amministratori (ADMIN) e gli utenti di sola consultazione (CONSULTA). Per ogni gruppo di utenti sono stati associati solo due utenti:
- admin (gruppo ADMIN) con password admin!1
- view (gruppo CONSULTA) con password view!1
Gli utenti di amministrazione possono configurare nuovi sensori e gestire gli utenti applicativi, mentre gli utenti di consultazione possono accedere solo alle funzionalità di consultazione delle misurazioni registrate.
3 Wiicom Sense Cloud configurazione
Questo gruppo di funzionalità permette la configurazione del software Wiicom Sense Cloud.
3.1 Gestione Utenti - Utenti
Questo gruppo di funzionalità consente l'inserimento, la cancellazione e la modifica degli utenti che possono accedere al sistema.
Si possono creare nuovi utenti di consultazione (gruppo CONSULTA) o di amministrazione (gruppo ADMIN). E' possibile anche cambiare la password degli utenti esistenti.
Gli utenti di amministrazione possono configurare nuovi sensori e gestire gli utenti applicativi, mentre gli utenti di consultazione possono accedere solo alle funzionalità di consultazione delle misurazioni registrate.
3.2 Gestione Utenti - Gruppi/Aggregazioni sensori
Questa funzionalità consente di specificare quali gruppi possono consultare le misurazioni registrate rispetto alle aggregazioni sensori inserite nel sistema.
3.3 Gestione sensori - Mappe sensori
Consente di inserire delle immagini relative alla planimetria del luogo nel quale verranno installati i moduli Wiicom TH&CO2. Queste immagini vengono utilizzate per agevolare la selezione del sensore per il quale si vuole consultare la misurazione.
3.4 Gestione sensori - Sensori
Questa funzionalità consente di gestire le grandezze fisiche che ogni singolo sensore è in grado di monitorare.
Nel sistema è già presente la configurazione relativa ai moduli Wiicom TH&CO2 SENSOR acquistati, nessun tipo di intervento è richiesto.
3.5 Gestione sensori - Aggregazioni sensori
Le aggregazioni sensori sono insiemi di grandezze fisiche (sensori) che il sistema è in grado di collezionare. L'aggregazione può essere di due tipi: "logica" e "sensore".
L'aggregazione "logica" può essere composta liberamente in base alle proprie esigenze (per esempio tutti i sensori di temperatura presenti in un piano di un edificio).
L'aggregazione di tipo "sensore" rappresenta fisicamente tutte le grandezze fisiche raccolte da ogni singolo modulo Wiicom TH&CO2 SENSOR.
Nel sistema è già presente la configurazione relativa ai moduli Wiicom TH&CO2 SENSOR acquistati, nessun tipo di intervento è richiesto.
4 Wiicom Sense Cloud consultazione misurazioni
Questo gruppo di funzionalità consente la consultazione dello stato e delle misurazioni catalogate dai moduli Wiicom TH&CO2 SENSOR.
4.1 Stato sensori
Questa funzionalità consente la consultazione dello stato dei moduli Wiicom TH&CO2 SENSOR e dell'ultima misurazione registrata sul sistema.
4.2 Misurazione sensori
Questa funzionalità permette di generare un grafico delle singole grandezze fisiche misurate.
4.3 Log sensori
Questa funzionalità permette di consultare ed estrarre tutte le misurazioni registrate sul sistema.
Terms of use
The information contained in this document is confidential. All materials, content and forms contained on this website are the intellectual property of WIICOM SRL and may not be copied, reproduced, distributed or displayed without WIICOM SRL’s express written permission. This document must not be used for any purpose other than stated. This legend must always be included with any copies that are made of this document.
1. Unauthorized use
1.1 It is forbidden to use WIICOM SRL products in safety-critical applications, where it is reasonably foreseeable that a not proper functioning of the product WIICOM SRL can cause serious personal injuries or death. Safety-critical applications are, for example (but not limited to) devices and life-saving equipment, equipment or systems for the management of nuclear power plants and weapons. WIICOM SRL products are not designed or intended to be used in military or aerospace applications or environments, or in applications or automotive environments. The Customer acknowledges and agrees that any use of WIICOM SRL products in such applications or environments will be at the sole risk of the customer and that the latter will be exclusively responsible for compliance with all legal and regulatory requirements in connection with such use.
2. Accordance with the provisions of law
2.1 The Customer acknowledges and agrees to take sole responsibility for compliance with all legal, regulatory and safety for its products and WIICOM SRL products might be used in customer applications, regardless of whether WIICOM SRL provides relevant information to applications or support services.
3. Compensation
3.1 The customer agrees to protect, indemnify and hold harmless WIICOM SRL, producers and distributors of the latter from any losses, damages, liabilities and expenses incurred by third parties and caused by: (i) an actual breach by the customer of the declarations and warranties contained in these terms and conditions, or (ii) willful misconduct or gross negligence on the part of the customer.
4. Exclusion of incidental, consequential and certain others damages
4.1 To the fullest extent permitted by law, WIICOM SRL, producers and distributors of the latter cannot be held liable to the customer or any third part for any special, collateral, indirect, punitive, incidental and consequential or exemplary damages ( including, by way of example and without limitation, damages resulting from : loss of profits, loss of confidential or other information, business interruption, personal injury, invasion of privacy, non-compliance with obligations (including the good faith and reasonable care ), negligence, and any other pecuniary loss or not) arising from or relating to the use or inability to use the products or services, or the provision of or failure to provide services, howsoever caused or under / or in relation to any provision of the contract, regardless of whether WIICOM SRL has been advised of the possibility of such damages. This paragraph shall remain in full force and effect even after the end of the warranty period.
5. Limitation of liability and remedies
5.1 Even in the presence of damages and costs, including attorneys' fees that may be caused and sustained by the customer for any reason (including, by way of example and without limitation, all damages described above, as well as the direct or general damages ), the responsibility - in contract, tort or otherwise - of WIICOM SRL and producers, distributors, directors, officers and employees thereof, arising out of or relating to the delivery of the product, use or inability to use the products or services, the provision of or failure to provide services, or in any way arising under / or in relation to any provision of the contract, will be limited to replacement of the product. The limitations and exclusions described above will apply to the maximum extent permitted by law, even if any remedy fails to achieve its essential purpose.
INDICE
1 INTRODUCTION 16
2 WIICOM SENSE CLOUD ACCESS 16
3 WIICOM SENSE CLOUD CONFIGURATION 17
3.1 User management - Users 17
3.2 User management - Groups/Sensor aggregations 18
3.3 Sensor management - Sensor maps 19
3.4 Sensor management - Sensors 20
3.5 Sensor management – Sensor aggregations 21
4 WIICOM SENSE CLOUD MEASUREMENTS CONSULTATION 21
4.1 Sensor state 22
4.2 Sensor measurements 23
4.3 SENSOR LOG 24
1 INTRODUCTION
Wiicom Sense Cloud system is installed on a Vmware virtual machine equipped with a CentOS 7.1 operating system. To make its usage easier the VM comes without VMTools and without any optimization linked to the CPU of the hosting machine.
The operating system is configured in order to obtain an IP address through DHCP and it is possible to modify this setting by using the nmtui command from a linux shell (xxxx://xxx.xxxxxx.xxx/xxxxxx/xxxxx-xxxxxxx-xxxxxx-0/).
The server comes with a NTP service that can be used by TH&CO2 Sensor from Wiicom by configuring the server IP address in the corresponding field.
It is possible to have access to the shell by using the root user (only user available) and using w11c0m!1
as password.
2 Wiicom Sense Cloud access
To access the Wiicom Sense Cloud software and configure or control the data logging system it is enough to open a web browser and insert the virtual machine IP address in the address bar.
The software is pre-configured with two kinds of users (groups): administrators (ADMIN) and read-only users (CONSULTA). For each group there are only two users:
- admin (ADMIN group) with admin!1 as password
- view (CONSULTA group) with view!1 as password
Administration users can configure new sensors and manage other users, while read-only users can only access to the functions allowing consultation of recorded measurements.
3 Wiicom Sense Cloud configuration
This group of functions allows the configuration of Wiicom Sense Cloud software.
3.1 User management - Users
This group of functions allows inserting, deleting and modifying users allowed to access the system. It is possible to create new consultino only users (gruppo CONSULTA) or administration ones (gruppo ADMIN). It is also possible to change the password o fan existing user.
Administration users can configure new sensors and manage other users, while read-only users can only access to the functions allowing consultation of recorded measurements.
3.2 User management - Groups/Sensor aggregations
This functionality allows to specify which groups can consult recorded measurmentsrelated to sensor aggregations stored in the system.
3.3 Sensor management - Sensor maps
It allows to insert images relative to the planimetry of the place in which Wiicom TH&CO2 modules will be placed. These images are used to make sensor selection easier when a user wants to consult measurements.
3.4 Sensor management - Sensors
It allows to manage the physical entities that every single sensor is able to control.
The system provides by default the configuration relative to the Wiicom TH&CO2 SENSOR, so no further actions are required in this case.
3.5 Sensor management – Sensor aggregations
Sensor aggregations are sets of physical entities (sensors) that the system is able to collect. The aggregation can beo f two kinds: "logical" and "sensor".
The "logical" aggregation can be freely composed depending on the requirements (for example all temperature sensors placed on a single floor).
The "sensor" aggregation represents physically all entities recorded by a single Wiicom TH&CO2 SENSOR.
The system provides by default the configuration relative to the Wiicom TH&CO2 SENSOR, so no further actions are required in this case.
4 Wiicom Sense Cloud measurements consultation
It allows to consult the state and the value of measurements recorded by Wiicom TH&CO2 SENSOR modules.
4.1 Sensor state
It allows to consult the of Wiicom TH&CO2 SENSOR modules and last measurement recorded on the server.
4.2 Sensor measurements
This functionality allows to generate a chart of single measured physical entities.
4.3 Sensor log
This functionality allows to consult and extract all the recorded measurements.