File di configurazione JSON

1. Panoramica

Il metodo consigliato per configurare TP100 è quello di utilizzare il Configuration Wizard disponibile online al seguente link.

2. Formattazione

• Nella prima riga del file andrà riportato il carattere [
• Nell’ultima riga del file andrà invece riportato il carattere ]
• Ogni set di parametri (quindi ogni registro/variabile) va incluso all’interno di due parentesi graffe { e }
• Tra una parentesi graffa di chiusura ed una di apertura andrà riportato il carattere ,. La virgola non andrà invece aggiunta dopo il 20esimo (ultimo) set, ovvero quello prima della parentesi quadra di chiusura.
• Ogni parametro andrà incluso tra doppi apici (”), dopo i quali sarà possibile definirne il valore preceduto dal carattere : (due punti) e da uno spazio
• Dopo il valore/stringa da assegnare al parametro andrà aggiunto il carattere , per separarlo dal successivo
• Nell’ultimo parametro (ovvero quello appena prima della chiusura delle graffe) non andrà aggiunta la virgola
• Anche se il numero di registri da leggere dovesse essere inferiore, è bene riportare tutti e 20 i set di parametri, lasciando i valori di default in quelli non utilizzati (o specificando 0 nel campo Enable)

[
 {
     "id": 1,
     "enable": 1,
     "name": "First_register",
     "unit": "V",
     "modbusType": 2,
     "modbusAdr": 1,
     "modbusRegister": 0,
     "modbusCmdRead": 3,
     "modbusCmdWrite": 6,
     "bitPosition": 0,
     "viewMin": 0,
     "viewMax": 0,
     "min": 0,
     "max": 0,
     "decimalNum": 0,
     "readOnly": 0,
     "alarm": 0,
     "thresholdAlarm": 0,
     "passwd": ""
 },
 {
     "id": 20,
     "enable": 1,
     "name": "Last_register",
     "unit": "mA",
     "modbusType": 2,
     "modbusAdr": 1,
     "modbusRegister": 19,
     "modbusCmdRead": 3,
     "modbusCmdWrite": 6,
     "bitPosition": 0,
     "viewMin": 0,
     "viewMax": 0,
     "min": 0,
     "max": 0,
     "decimalNum": 0,
     "readOnly": 0,
     "alarm": 0,
     "thresholdAlarm": 0,
     "passwd": ""
 }
]

In rete esistono diversi siti/tool che permettono di verificare la corretta formattazione di un file JSON, tuttavia, il metodo più rapido per ottenerne uno compatibile con TP100 è quello di collegare il dispositivo al proprio PC o di generarne uno usando il Configuration Wizard.

3. Disposizione degli elementi

ESEMPIO

• “id”: 1 corrisponde ad una variabile half (la cui tile occuperà quindi metà riga) chiamata Flow.
• “id”: 2 corrisponde ad una variabile full (la cui tile occuperà quindi una riga intera) Totalizer.

Un’eventuale terza variabile (che avrà “id”: 3) verrà visualizzata sulla terza riga, dopo la variabile Totalizer.

4. Descrizione parametri

• “id”: Da 1 a 20. Permette di indicare l’ordine in cui visualizzare i registri.
• “enable”: Impostato a 0 disabilita il registro (di cui non verrà quindi visualizzata la tile), impostato ad 1 lo abilita.
• “name”: Consente di specificare il nome da assegnare al registro, con un massimo di 31 caratteri. Sono consentiti caratteri alfanumerici, spazi e _ (underscore).
• “unit”: Unità di misura delle variabile, con un massimo di 9 caratteri. Sono consentiti caratteri alfanumerici, spazi e _ (underscore). Può essere lasciata vuota (riportando “” al posto del valore).
• “modbusType”: Permette di selezionare la tipologia di variabile Modbus (ovvero il numero di bit). Questo parametro influisce direttamente sulla dimensione delle tile. Vedere il paragrafo 4.1. modbusType per ulteriori informazioni.
• “modbusAdr”: Permette di impostare l’indirizzo Modbus del dispositivo da cui prelevare i valori. Secondo la specifica del protocollo Modbus, si può inserire un valore compreso tra 1 e 255.
• “modbusRegister”: Permette di specificare il registro Modbus da cui prelevare i valori. Sono permessi valori compresi nel range 0 - 65535.
• “modbusCmdRead”: Permette di specificare la funzione Modbus da usare per accedere al registro specificato nel campo modbusRegister. Va selezionata a seconda delle informazioni riportate nel manuale del dispositivo a cui dovrà interfacciarsi TP100. La corrispondenza tra i valori che si possono assegnare a questo parametro e la rispettiva funzione Modbus è disponibile al paragrafo 4.2. Parametro: modbusCmdRead.
• “modbusCmdWrite”: Permette di specificare la funzione Modbus da usare per modificare il valore del registro specificato nel campo modbusRegister agendo sul display touch. Questo parametro viene considerato solo se il valore di readOnly è uguale a 0. Può essere impostato a 0 se non è richiesta la possibilità di modificare il valore del registro da display. La corrispondenza tra i valori che si possono assegnare a questo parametro e la rispettiva funzione Modbus è disponibile al paragrafo 4.3. Parametro: modbusCmdWrite.
• “bitPosition”: Permette di specificare il bit a cui associare la variabile, utile solo nel caso di variabili 1 bit e 8 bit. Nel primo caso può essere specificato un valore compreso tra 0 e 15 (dove 0 rappresenta il bit meno significativo), nel secondo caso possono invece essere specificati i valori 0 (byte meno significativo) o 8 (byte più significativo). Se la variabile che si sta definendo è a 16 o 32 bit, il parametro verrà ignorato (in questo caso è consigliabile impostarlo a 0).
• “viewMin”: Assieme a viewMax permette di scalare la grandezza letta entro il range desiderato. Il valore minimo inseribile è -2147483648. Può essere lasciato a 0 (assieme a viewMax) se non si intende applicare nessuna scalatura.
• “viewMax”: Assieme a viewMin permette di scalare la grandezza letta entro il range desiderato. Il valore massimo inseribile è 2147483648. Può essere lasciato a 0 (assieme a viewMin) se non si intende applicare nessuna scalatura.
• “min”: Permette di aggiungere un’ulteriore scalatura al valore letto, qualora il dispositivo Modbus collegato a TP100 restituisse un range non standard. Si consiglia di impostare questo campo a 0 in quanto non necessario nella maggioranza dei casi.
• “max”: Permette di aggiungere un’ulteriore scalatura al valore letto, qualora il dispositivo Modbus collegato a TP100 restituisse un range non standard. Si consiglia di impostare questo campo a 0 in quanto non necessario nella maggioranza dei casi.
• “decimalNum”: Numero di cifre decimali da riportare nel valore letto. È possibile specificare un valore compreso nel range 0 e 4. Nel caso di variabili 1 bit il parametro viene ignorato (si consiglia di impostarlo comunque a 0).
• “readOnly”: Impostato ad 1 pone la variabile in sola scrittura, non sarà possibile modificare il valore del registro da display. Impostato a 0 permette invece di usare la funzione specificata nel campo modbusCmdWrite per modificarne il valore.
• “alarm”: Permette di selezionare la condizione di allarme che verrà applicata alla soglia specificata nel campo thresholdAlarm. Una volta verificatasi modificherà il colore della tile associata (che diverrà rossa). Impostare a 0 se non si intende definire nessun allarme, in quel caso il valore specificato nel campo thresholdAlarm verrà ignorato. Tutti gli altri valori impostabili verranno riportati al paragrafo 4.3. Parametro: alarm.
• “thresholdAlarm”: Permette di definire il valore della soglia di allarme. A seconda della condizione specificata nel campo alarm, quando il registro verrà considerato in allarme il bordo superiore della tile verrà evidenziato in rosso. Il valore specificato deve ricadere all’interno del range definito dai campi viewMin e viewMax.
• “passwd”: Permette di impostare un codice numerico da inserire nel caso in cui si intenda modificare il valore del registro Modbus. Il codice può avere una lunghezza compresa tra 3 e 6 cifre. Se a readOnly è stato assegnato un valore diverso da 0, il parametro non verrà considerato. Se non si intende definire alcun codice numerico, lasciare vuoto il campo (inserendo “” al posto del valore).