PDF

Uploader Cloud Service

Overview

L'Architettura dell'Uploader Cloud Service e' composta da BOUNDARY indipendenti ed isolati che costituiscono aree accedibili con le proprie credenziali fornite dall'Amministratore di Sistema. Questi Boundary consentono all'operatore di creare le proprie Applications in qualunque numero.

Nell'ambito del Boundary l'operatore puo' definire un proprio insieme di Applications, ciascuna delle quali gestisce, a sua volta, un insieme di HOST che sono capaci di aggiornare le proprie Release da remoto (operazione di REMOTE FW UPGRADE) oppure qualunque altro tipo di file (es. file configurazioni, file script, file multimediali, ecc...).

Il portale amministrativo e' unico. A seconda delle proprie credenziali, fornite dall'AMMINISTRATORE di Sistema, si ha una vista del proprio Boundary con la gestioni delle solo Applicazions afferenti.

Releases

Selezionata l'Application si e' in grado di gestire le Releases dei propri HOST sul campo componendo WHITE e BLACK LISTS.

Con RELEASE si intende un file contraddistinto con un identificativo univoco (Versioning)

Convenzione nomi RELEASE

<application>_<versioning>.<extension>

ove
<application>  nome della Application          (3..13 caratteri massimo)
<versioning>   versione univoca della Release  (3..13 caratteri massimo)
<extension>    estensione del file             (3 caratteri)

Si parla di CURRENT RELEASE quella Release che viene notificata all`HOST 
per il download se risulta differente a quella presente sull'HOST stesso. 
L'HOST verifica la presenza di nuove Release usando il protocollo 
Universal Cloud Downloader.
L'operatore decide quale delle Release considerare come CURRENT.

Universal Cloud Downloader e' il protocollo usato dall'HOST per avere la notifica di nuove Release e effettuare il download. Vedi: http://dwloader.meshgrid.it

Portale amministrativo

L'indirizzo del portale e' il seguente:

https://uploader.meshgrid.it

Previa presentazione delle proprie credenziali il Portale consente la:

• creazione/cancellazione Applications
• upload delle Release
• rimozione delle Release
• selezione della Release corrente che sara' notificata all'HOST
• la gestione delle WHITE e BLACK LIST

White List/Black List

Un Operatore puo' crearsi le proprie politiche di aggiornamento. Esistono al riguardo i termini: ALL e NONE per generalizzare le logiche. E' possibile anche utilizzare delle liste di identificativi DeviceId preparati precedentemente in formato CSV per agevolare la determinazione degli insiemi di dispositivi abilitati al download.

Si puo' creare una campagna di aggiornamento massiva di tutti gli HOST della Applicazione afferente, oppure fare un aggiornamento mirato ad un sottinsieme, oppure unviare una Release sperimentale ad un unico HOST e addirittura effettuare downgrade delle Release selezionando opportunamente la CURRENT RELEASE.

Un dispositivo per avere l'aggiornamento di una nuova Release (Current Release) deve essere contemporaneamente: presente nella WHITE LIST e assente nella BLACK LIST.

Identificativo Dispositivo

Si intende con DISPOSITIVO l'intera macchina, composta da:

• uno o piu' HOST (raggruppati in Applications) aggiornabili ciascuno con una Release e

• un Modulo di Comunicazione CLOUD detto GATEWAY (responsabile connessione wifi e del collegamento ai servizi Universal Cloud Downloader).

Ogni dispostivo di fabbrica ha univoco DeviceID e LoginKey (per accesso ai servizi Cloud), entrambi mantenuti dal modulo GATEWAY.

Il DeviceId e' utilizzato per la composizione delle WHITE/BLACK LIST.

L'accesso ai servizi Cloud e' garantito dalla LoginKey che per qualunque motivo il Gestore Servizi puo' rigettare disattivando l'utilizzo del Cloud al dispositivo.

Il modulo GATEWAY si interfaccia all'Architettura Cloud, identificantosi con le proprie credenziali e utilizzando le API REST messe a disposizione.

Convenzione JCD suggerita per l'Identificativo del Dispositivo:

DeviceId = <SHORT_HEADER_DEVICE>-<UNIQUE-MACHINE-CODE>  (13 caratteri ASCII)

<SHORT_HEADER_DEVICE> e' costituito da 3 caratteri minuscoli, 
                      acronimo della Applicazione
<UNIQUE-MACHINE-CODE> codice univoco di 9 caratteri esedecimali 
                      NIBBLEASCII maiuscoli generato 
                      dal MAC address del modulo di comunicazione

Eg.: c2g-F33575441
     cm3-F33540615
     blu-A256357EC

Il modulo HOST, che non ha connessione Cloud, e' in genere costituito da un microcontrollore o microprocessore con scarse risorse di memoria. Esso colloquia con il modulo GATEWAY tramite il protocollo seriale: Universal Downloader Protocol attraverso il quale recupera le Release di aggiornamento.

La documentazione Universal Downloader Protocol per HOST microcontroller si trova qui:

http://dwloader.meshgrid.it

Unicast List

E' una sezione autonoma dedicata alle ECCEZIONI, cioe' alla specificazione di Release per determinati DeviceId che non sono governati dalla logica generale massiva con WHITE/BLACK LIST. I DeviceId presenti nella UNICAST LIST non sono presi in considerazione dalla logica generale. Essi hanno assegnate le Release tra quelle presenti nella lista generale. Di conseguenza, la cancellazione di Release referenziate da dispositivi nella UNICAST non e' possibile senza eliminare il riferimento.

Video tutorial

Link video esplicativo: UploaderCloudService.mp4