• Il device gestisce la lettura ed elaborazione di un ingresso analogico.
• Il dato letto è una word a 16 bit con segno alla quale è possibile sommare un offset, inserire un fattore di scala ed attivare un filtro software passa basso del tipo RC.
• Le specifiche di risoluzione dell’ingresso vengono riportate nel fascicolo hardware della scheda.
• Le uscite sono programmabili per eseguire comparazioni sull’ingresso analogico

Dichiarazione del device nella unit di configurazione Nella unit di configurazione, la sezione BUS deve essere dichiarata in modo tale che siano presenti le risorse hardware necessarie all’implementazione del device ANINP2. Deve essere presente almeno un ingresso analogico con risoluzione massima di 16 bit.
Nella sezione INTDEVICE della unit di configurazione deve essere aggiunta la seguente definizione:

;---------------------------------
; Dichiarazione devices
;---------------------------------
INTDEVICE
...
<nome device>   ANINP2   Tcamp   IChn   Type     Out1 Out2

dove:

;---------------------------------
; Dichiarazione devices
;---------------------------------
INTDEVICE
Asse_X   ANINP2   2   2.AI01   1   2.OUT01   2.OUT02

All'accensione del sistema, il device controlla la corretta dichiarazione del tipo di ingresso da utilizzare, definito nella unit di configurazione (Type).
Se la diagnostica del canale si conclude con successo, viene eseguito l'aggiornamento dei dati sulla base del tempo di campionamento. Nel caso vengano riscontrati errori o imprecisioni, lo stato st_errcfg viene impostato a uno ed il valore della variabile outbit viene forzato a zero. La conversione del dato in uscita dal device (outbit), nell'unità di misura necessaria per l'applicazione, viene eseguita ricorrendo a dei fattori di scala (scaleA, scaleB e scaleC) secondo la formula:

outUm = (scaleA x outbit / scaleB) + scaleC

Oltre a questa uscita aggiornata sulla base del tempo di campionamento del device, è disponibile l'uscita outUmF, filtrata con un tempo di carica programmabile (espresso in ms).

	Questa funzionalità permette di filtrare eventuali disturbi e fluttuazioni sovrapposte al segnale utile con la possibilità di personalizzare il tempo di carica del filtro (tfilter).

Il device ha la possibilità di gestire delle comparazioni sull’ingresso analogico mediato (outUmF) e variare lo stato delle uscite programmabili in modalità one shot (singola attivazione).
Ogni uscita ha la possibilità di essere gestita nei modi seguenti:

	Attivazione al superamento del setpoint con l’ingresso che si incrementa
	Disattivazione al superamento del setpoint con l’ingresso che si incrementa
	Attivazione al superamento del setpoint con l’ingresso che si decrementa
	Disattivazione al superamento del setpoint con l’ingresso che si decrementa
	Attivazione al superamento del setpoint con l’ingresso che si incrementa e disattivazione al superamento del setpoint con l’ingresso che si decrementa
	Disattivazione al superamento del setpoint con l’ingresso che si incrementa e attivazione al superamento del setpoint con l’ingresso che si decrementa

Il device ha la possibilità di gestire le comparazioni delle uscite con un interesi.
Ogni volta che il device varia lo stato di un uscita, la comparazione viene disabilitata finché l’ingresso non si discosta dal punto del setpoint del valore di isteresi.
Nello specifico la comparazione si ri-arma quando l’ingresso assume i valori riportati negli esempi a seguito:

Se si utilizzano i modi 5 e 6, l’uscita si comporterà nel modo seguente:

La presenza di un errore nel device viene segnalato dallo stato st_error.
Quando st_error è uguale a 1, troviamo presente sulla variabile errcode il tipo di errore intervenuto (vedi tabella) e nella variabile errvalue una indicazione sulla causa dell’errore

Se il device va in errore, per poter riprendere la lavorazione bisogna cancellare lo stato st_error attraverso il comando RSERR.

La presenza di un warning nel sistema camming viene segnalato dallo stato st_warning.
Essendo causato da un evento non grave ed essendo garantita in questa situazione la gestione dell’asse slave, l’asse slave continua il suo lavoro.
Quando st_warning è uguale a 1, troviamo presente sulla variabile wrncode il tipo di warning intervenuto (vedi tabella) e nella variabile wrnvalue una indicazione sulla causa che ha provocato il warning.

Per cancellare lo stato st_warning bisogna inviare il comando RSWRN.

Il nome del parametro, stato o comando viene riportato alla sinistra della tabella.

R
Indica se il relativo parametro o stato è ritentivo (al momento dell’inizializzazione del device mantiene lo stato precedentemente definito), oppure indica lo stato che assume al momento dell’inizializzazione del device.
Se il device non necessita di inizializzazione il campo “R” indica il valore che il parametro o stato assume all’accensione della scheda.
R = Ritentivo
0 = Al momento dell’inizializzazione del device il valore viene forzato a zero.
1 = Al momento dell’inizializzazione del device il valore viene forzato a uno.
- = Al momento dell’inizializzazione del device viene presentato il valore significativo.

D
Indica la dimensione del parametro.
F = Flag
B = Byte
W = Word
L = Long
S = Single Float

Vengono descritte tutte le condizioni necessarie affinché il parametro sia considerato corretto o perché il comando venga accettato.
In alcuni casi vengono specificati dei valori limite per l’accettazione del parametro: se vengono introdotti dei valori esterni ai limiti impostati, il dato viene comunque accettato; pertanto devono essere previsti opportuni controlli dell’applicativo tali da garantire il corretto funzionamento.
Per l’esecuzione di un comando, tutte le relative condizioni devono necessariamente essere soddisfatte; in caso contrario il comando non viene eseguito.

A
Indica la modalità di accesso.
R = Read (lettura).
W = Write (scrittura).
RW = Read / Write.

I comandi sono stati ordinati con priorità decrescente. Ad esempio, in caso di contemporaneità dei comandi SETCMP1 ed RESCMP1, viene acquisito per primo il comando SETCMP1.

ScaleB deve essere impostato diverso da zero, in caso contrario OutUm viene forzato a 0.

Il tempo di carica del filtro RC tfilter deve essere impostato maggiore o uguale al tempo di campionamento del device (Tcamp), in caso contrario viene disattivato il filtro ed il parametro OutUmF viene aggiornata con lo stesso valore di OutUm.

Il parametro offset viene sommato all’ingresso analogico acquisito (outbit), non viene eseguito il controllo sull‘overflow della somma.

	Nel caso che un singolo canale venga gestito da più device ANINP aventi Type diversi, il compilatore non rileva errori e il canale viene impostato con l'ultimo Type dichiarato.

Una singola risorsa hardware (ogni singolo ingresso) può essere gestita da più device ANINP contemporaneamente, a condizione che il numero identificativo dell'ingresso (Type), inserito nella dichiarazione del device (file di configurazione), sia uguale; in caso contrario l'ingresso analogico viene configurato come l'ultimo device dichiarato nel file di configurazione.

;*************************************************************************************
; Nome Modulo: Ex_Aninp2.CNF                Progetto: Ex_ANINP2
; Autore: QEM srl                           Data : 01/05/99
; Sistema: QMove1 / QCL3                    Libreria: 1LIB4001
; Funzionalità: Esempio gestione ANINP2     Release: 0
;------------------------------------- Note ------------------------------------------
; [1] - Applicativo di esempio per utilizzo device ANINP2
;*************************************************************************************
 
;-------------------------------------------------------------------------------------
; Definizione Costanti
;-------------------------------------------------------------------------------------
CONST
 
;-------------------------------------------------------------------------------------
; Definizione Variabili SYSTEM
;-------------------------------------------------------------------------------------
SYSTEM
slSet1   L                                      ;Setpoint 1
slSet2   L                                      ;Setpoint 2
 
;-------------------------------------------------------------------------------------
; Definizione Variabili GLOBAL
;-------------------------------------------------------------------------------------
GLOBAL
 
;-------------------------------------------------------------------------------------
; Definizione Variabili TIMER
;-------------------------------------------------------------------------------------
TIMER
 
;-------------------------------------------------------------------------------------
; Definizione DATAGROUP
;-------------------------------------------------------------------------------------
DATAGROUP
 
;-------------------------------------------------------------------------------------
; Configurazione Bus
;-------------------------------------------------------------------------------------
BUS
   1  1CPUD   01
   2  1AI8B   00
   3  1MIXA   00
   4  .
 
;-------------------------------------------------------------------------------------
; Definizione Variabili INPUT
;-------------------------------------------------------------------------------------
INPUT
ifAbilComp   F     3.INP01                      ;Abilitazione comparazioni
 
;-------------------------------------------------------------------------------------
; Definizione Variabili OUTPUT
;-------------------------------------------------------------------------------------
OUTPUT
out301       F     3.OUT01                      ;Segnalazione setpoint 1
out302       F     3.OUT02                      ;Segnalazione setpoint 2
 
;-------------------------------------------------------------------------------------
; Dichiarazione device interni
;-------------------------------------------------------------------------------------
INTDEVICE
;Nome    Tipo    TCamp    Contatore Type
Asse     ANINP   0004     2.AI01 2  3.OUT01  3.OUT02
 
END

;*************************************************************************************
; Nome File: TASK_00.MOD
; Progetto: EX_ANINP2
; Descrizione: Gestione Posizionamento
;*************************************************************************************
 
;-------------------------------------------------------------------------------------
; Operazioni di Inizializzazione Asse
;-------------------------------------------------------------------------------------
Asse:offset = 0                                 ;Tensione di offset
 
;-------------------------------------------------------------------------------------
; Fattore di scala: (scaleA * outbit / scaleB) + scaleC
; outUm minima = (4 * 0 / 8 ) + 3 = 3
; outUm massima = (4 * 4095 / 8) + 3 = 2050
;-------------------------------------------------------------------------------------
Asse: scaleA = 4                                ;Fattore di scala A
Asse: scaleB = 8                                ;Fattore di scala B
Asse: scaleC = 3                                ;Fattore di scala C
Asse: tfilter = 10                              ;Tempo del filtro di acquisizione
Asse: hysteresis = 0                            ;Isteresi dell’uscita
 
IF   slSet1 EQ 0
 sl   Set1 = 1500
ENDIF
IF   slSet2 EQ 0
 sl   Set2 = 300
ENDIF
 
MAIN:
;-------------------------------------------------------------------------------------
; Comparazioni sul conteggio solo se ifAbilComp attivo, altrimenti le uscite
; sono disattive
; ----------------------------- variabili utilizzate --------------------------------
; slSet1: Quota di comparazione per uscita 2.OUT01
; slSet1: Quota di comparazione per uscita 2.OUT02
;-------------------------------------------------------------------------------------
 
IF ifAbilComp
     IF NOT gfApp01
       Asse: mode1 = 5                         ;Attiva out1 se posit>setpoint1
       Asse: selout1 = 0                       ;e disattiva out1 se posit<setpoint1
       Asse: setpoint1 = slSet1
       Asse: timer1 = 0
       Asse: mode2 = 6                         ;Disattiva out2 se posit<setpoint2
       Asse: selout2 = 1                       ;e attiva out2 se posit<setpoint2
       Asse: setpoint2 = slSet2
       Asse: timer2 = 0
       gfApp01 = 1
       gfApp02 = 0
     ENDIF
ELSE
     IF NOT gfApp02
       Asse:mode1 = 0
       RESOUT out201                           ;Disattiva out1
       Asse: selout1 = 0
       Asse: mode2 = 0
       RESOUT out202                           ;Disattiva out2
       Asse: selout2 = 1
       gfApp01 = 0
       gfApp02 = 1
     ENDIF
ENDIF
 
;-------------------------------------------------------------------------------------
; Operazioni finali
;-------------------------------------------------------------------------------------
  WAIT 1
  JUMP MAIN
END