Entrambe le parti precedenti la revisione Revisione precedente Prossima revisione | Revisione precedenteUltima revisioneEntrambe le parti successive la revisione |
software:devices:freq [2014/11/03 10:53] – documentazione | software:devices:freq [2014/11/05 15:05] – documentazione |
---|
~~NOCACHE~~ | |
| |
====== DEVICE FREQ ====== | ====== DEVICE FREQ ====== |
| |
* disponibilità del valore della frequenza, della misura e della misura filtrata. | * disponibilità del valore della frequenza, della misura e della misura filtrata. |
| |
<html><pagebreak /></html> | <WRAP pagebreak></WRAP> |
| |
====== - Dichiarazione del device ====== | ====== - Dichiarazione del device ====== |
|IntL|linea di interrupt associata all'ingresso digitale sul quale è applicato il segnale da monitorare| | |IntL|linea di interrupt associata all'ingresso digitale sul quale è applicato il segnale da monitorare| |
| |
<WRAP center round important 60%> | ^:todo:^Attenzione: Tutti i campi della dichiarazione sono obbligatori e devono essere presenti sulla stessa linea.\\ Impostare "X.X" oppure "X" nel caso una risorsa non sia disponibile o non venga utilizzata.\\ Disabilitare una risorsa significa disabilitare tutte le funzionalità del device che la utilizzano.^ |
Attenzione:\\ Tutti i campi della dichiarazione sono obbligatori e devono essere presenti sulla stessa linea. Impostare "X.X" oppure "X" nel caso una risorsa non sia disponibile o non venga utilizzata. Disabilitare una risorsa significa disabilitare tutte le funzionalità del device che la utilizzano. | |
</WRAP> | |
| |
<html><pagebreak /></html> | <WRAP pagebreak></WRAP> |
| |
====== - Funzionamento ====== | ====== - Funzionamento ====== |
Il blocco "filtro antiglitch" esegue un filtraggio digitale sul segnale d'ingresso per l'eliminazione dei disturbi. Esso campiona il segnale di ingresso ad intervalli di tempo regolari e determina lo stato di uscita verificando lo stato della maggioranza dei campioni. L'entità del filtro dipende da un parametro del sistema QMOVE (variabile di sistema "QMOVE:sys004"). | Il blocco "filtro antiglitch" esegue un filtraggio digitale sul segnale d'ingresso per l'eliminazione dei disturbi. Esso campiona il segnale di ingresso ad intervalli di tempo regolari e determina lo stato di uscita verificando lo stato della maggioranza dei campioni. L'entità del filtro dipende da un parametro del sistema QMOVE (variabile di sistema "QMOVE:sys004"). |
| |
<WRAP center round info 60%> | ^:info:^L'esistenza del blocco "antiglitch filter" e le sue caratteristiche dipendono dal prodotto che si sta utilizzando.\\ Consultare la documentazione relativa al prodotto stesso per uteriori informazioni.^ |
L'esistenza del blocco "antiglitch filter" e le sue caratteristiche dipendono dal prodotto che si sta utilizzando. Consultare la documentazione relativa al prodotto stesso per uteriori informazioni. | |
</WRAP> | |
| |
===== - Edge detect ===== | ===== - Edge detect ===== |
* Il device non può funzionare contemporaneamente come misuratore di frequenza e rilevatore di duty cycle perciò, quando il parametro //capture// è impostato a 5, il valore di uscita del blocco "edge detect" rappresenta il duty cycle espresso in parti per 10000 (5000 significa quindi duty del 50.00%). Il valore di uscita del blocco "edge detect" va direttamente sul parametro //outfrq// bypassando il blocco "upper limiter"; il blocco "scaling" producono delle uscite che potrebbero perdere di significato. Per utilizzare il filtro del primo ordine con il duty cycle in maniera corretta è necessario che i parametri //scaleA// e //scaleB// siano uguali a 1 ed il parametro //scaleC// sia uguale a zero. L'utilizzo del rilevatore del duty cycle funziona correttamente per segnali di frequenza bassa (inferiori a circa 150 Hz). | * Il device non può funzionare contemporaneamente come misuratore di frequenza e rilevatore di duty cycle perciò, quando il parametro //capture// è impostato a 5, il valore di uscita del blocco "edge detect" rappresenta il duty cycle espresso in parti per 10000 (5000 significa quindi duty del 50.00%). Il valore di uscita del blocco "edge detect" va direttamente sul parametro //outfrq// bypassando il blocco "upper limiter"; il blocco "scaling" producono delle uscite che potrebbero perdere di significato. Per utilizzare il filtro del primo ordine con il duty cycle in maniera corretta è necessario che i parametri //scaleA// e //scaleB// siano uguali a 1 ed il parametro //scaleC// sia uguale a zero. L'utilizzo del rilevatore del duty cycle funziona correttamente per segnali di frequenza bassa (inferiori a circa 150 Hz). |
| |
<html><pagebreak /></html> | <WRAP pagebreak></WRAP> |
| |
====== - Tabella parametri ====== | ====== - Tabella parametri ====== |
^Nome^Dimensione^Valore di default^Tipo di accesso^Unità di misura^Range valido^Condizioni di scrittura^Descrizione^ | ^Nome^Dimensione^Valore di default^Tipo di accesso^Unità di misura^Range valido^Condizioni di scrittura^Descrizione^ |
|frqmax|Long|Ritentivo|RW|Hz/100 oppure Hz/1000|0÷2147483647|-|**Frequenza massima**\\ È il massimo valore che può assumere //outfrq//. Per segnali di frequenza superiore a //frqmax//, //outfrq// viene posto pari a //frqmax//.| | |frqmax|Long|Ritentivo|RW|Hz/100 oppure Hz/1000|0÷2147483647|-|**Frequenza massima**\\ È il massimo valore che può assumere //outfrq//. Per segnali di frequenza superiore a //frqmax//, //outfrq// viene posto pari a //frqmax//.| |
|frqmin|Long|Ritentivo|RW|Hz/100 oppure Hz/1000|0÷2147483647|-|**Frequenza minima**\\ È il valore minimo di frequenza rilevabile dal device. Per frequenze inferiori, l'uscita del blocco "edge detect" vale zero. <WRAP center round important 60%> //frqmin// influenza anche il tempo massimo oltre il quale viene rilevata l'assenza di segnale in ingresso; infatti, ad esempio, impostando //frqmin// pari a 1Hz, il device rileva l'assenza di segnale e quindi pone a zero //outfrq// dopo 1 sec. Impostando, invece, //frqmin// pari a 0.01 Hz l'assenza di segnale verrà rilevata dopo 100 sec. Impostando //frqmin// uguale a 0 è come impostare 0.01Hz se //outfrq// è espresso in centesimi di hertz oppure 0.001Hz se //outfrq// è espresso in millesimi di hertz </WRAP>| | |frqmin|Long|Ritentivo|RW|Hz/100 oppure Hz/1000|0÷2147483647|-|**Frequenza minima**\\ È il valore minimo di frequenza rilevabile dal device. Per frequenze inferiori, l'uscita del blocco "edge detect" vale zero.\\ :todo:\\ **//frqmin// influenza anche il tempo massimo oltre il quale viene rilevata l'assenza di segnale in ingresso; infatti, ad esempio, impostando //frqmin// pari a 1Hz, il device rileva l'assenza di segnale e quindi pone a zero //outfrq// dopo 1 sec. Impostando, invece, //frqmin// pari a 0.01 Hz l'assenza di segnale verrà rilevata dopo 100 sec. Impostando //frqmin// uguale a 0 è come impostare 0.01Hz se //outfrq// è espresso in centesimi di hertz oppure 0.001Hz se //outfrq// è espresso in millesimi di hertz**| |
|capture|Byte|Ritentivo|RW|-|0÷5|-|**Modalità cattura segnale e risoluzione misura frequenza**\\ Definisce le modalità di cattura del segnale (fronte e frequenza/duty) e la risoluzione della misura di frequenza (centesimi o millesimi di hertz).\\ **0** i blocchi "edge detect" e "edge counter" sono disabilitati quindi il device fornisce il valore di outfrq sempre uguale a zero mentre outcnt non si incrementa più.\\ **1** il blocco "edge detect" cattura il fronte di discesa del segnale di ingresso ed il valore di outfrq è espresso in centesimi di Hertz. Il blocco "edge counter", altresì, incrementa il suo valore di uscita outcnt sul fronte di discesa del segnale di ingresso.\\ **2** il blocco "edge detect" cattura il fronte di salita del segnale di ingresso ed il valore di outfrq è espresso in centesimi di Hertz. Il blocco "edge counter", altresì, incrementa il suo valore di uscita outcnt sul fronte di salita del segnale di ingresso.\\ **3** il blocco "edge detect" cattura il fronte di discesa del segnale di ingresso ed il valore di outfrq è espresso in millesimi di Hertz. Il blocco "edge counter", altresì, incrementa il suo valore di uscita outcnt sul fronte di discesa del segnale di ingresso.\\ **4** il blocco "edge detect" cattura il fronte di salita del segnale di ingresso ed il valore di outfrq è espresso in millesimi di Hertz. Il blocco "edge counter", altresì, incrementa il suo valore di uscita outcnt sul fronte di salita del segnale di ingresso.\\ **5** il blocco "edge detect" cattura entrambi i fronti del segnale di ingresso e fornisce sul parametro outfrq il valore del duty cycle in parti per 10000 (es: 5000 indica il 50.00 %).| | |capture|Byte|Ritentivo|RW|-|0÷5|-|**Modalità cattura segnale e risoluzione misura frequenza**\\ Definisce le modalità di cattura del segnale (fronte e frequenza/duty) e la risoluzione della misura di frequenza (centesimi o millesimi di hertz).\\ **0** i blocchi "edge detect" e "edge counter" sono disabilitati quindi il device fornisce il valore di outfrq sempre uguale a zero mentre outcnt non si incrementa più.\\ **1** il blocco "edge detect" cattura il fronte di discesa del segnale di ingresso ed il valore di outfrq è espresso in centesimi di Hertz. Il blocco "edge counter", altresì, incrementa il suo valore di uscita outcnt sul fronte di discesa del segnale di ingresso.\\ **2** il blocco "edge detect" cattura il fronte di salita del segnale di ingresso ed il valore di outfrq è espresso in centesimi di Hertz. Il blocco "edge counter", altresì, incrementa il suo valore di uscita outcnt sul fronte di salita del segnale di ingresso.\\ **3** il blocco "edge detect" cattura il fronte di discesa del segnale di ingresso ed il valore di outfrq è espresso in millesimi di Hertz. Il blocco "edge counter", altresì, incrementa il suo valore di uscita outcnt sul fronte di discesa del segnale di ingresso.\\ **4** il blocco "edge detect" cattura il fronte di salita del segnale di ingresso ed il valore di outfrq è espresso in millesimi di Hertz. Il blocco "edge counter", altresì, incrementa il suo valore di uscita outcnt sul fronte di salita del segnale di ingresso.\\ **5** il blocco "edge detect" cattura entrambi i fronti del segnale di ingresso e fornisce sul parametro outfrq il valore del duty cycle in parti per 10000 (es: 5000 indica il 50.00 %).| |
|scaleA|Long|Ritentivo|RW|-|-2147483648÷2147483647|-|**Coefficiente A nella funzione di scaling**\\ È il parametro per il quale viene moltiplicato il valore della frequenza rilevato dal blocco "edge detect" nella funzione di scaling. Impostando il parametro a 0 il valore misurato avrà sempre valore 0.| | |scaleA|Long|Ritentivo|RW|-|-2147483648÷2147483647|-|**Coefficiente A nella funzione di scaling**\\ È il parametro per il quale viene moltiplicato il valore della frequenza rilevato dal blocco "edge detect" nella funzione di scaling. Impostando il parametro a 0 il valore misurato avrà sempre valore 0.| |
|scaleB|Long|Ritentivo|RW|-|-2147483648÷2147483647|-|**Coefficiente B nella funzione di scaling**\\ È il parametro per il quale viene diviso il valore della frequenza rilevato dal blocco "edge detect" nella funzione di scaling. Impostando il parametro a 0 il valore misurato avrà sempre valore 0.| | |scaleB|Long|Ritentivo|RW|-|-2147483648÷2147483647|-|**Coefficiente B nella funzione di scaling**\\ È il parametro per il quale viene diviso il valore della frequenza rilevato dal blocco "edge detect" nella funzione di scaling. Impostando il parametro a 0 il valore misurato avrà sempre valore 0.| |
|scaleC|Long|Ritentivo|RW|-|-2147483648÷2147483647|-|**Coefficiente C nella funzione di scaling**\\ È il parametro che viene sommato al risultato ottenuto moltiplicando il valore valore della frequenza rilevata dal blocco "edge detect" moltiplicato per il rapporto tra i parametri //scaleA// e //scaleB// della funzione di scaling.| | |scaleC|Long|Ritentivo|RW|-|-2147483648÷2147483647|-|**Coefficiente C nella funzione di scaling**\\ È il parametro che viene sommato al risultato ottenuto moltiplicando il valore valore della frequenza rilevata dal blocco "edge detect" moltiplicato per il rapporto tra i parametri //scaleA// e //scaleB// della funzione di scaling.| |
|tfilter|Word|Ritentivo|RW|ms|0÷32767|-|**Costante di tempo del filtro**\\ Costante di tempo.\\ <WRAP center round info 60%> nel caso in cui //tfilter// sia minore o uguale del tempo di campionamento del device viene disattivato il filtro ed il parametro //outUmF// viene aggiornato con lo stesso valore di //outUm//.</WRAP>| | |tfilter|Word|Ritentivo|RW|ms|0÷32767|-|**Costante di tempo del filtro**\\ Costante di tempo.\\ :info:\\ **nel caso in cui //tfilter// sia minore o uguale del tempo di campionamento del device viene disattivato il filtro ed il parametro //outUmF// viene aggiornato con lo stesso valore di //outUm//.**| |
|par01|Long|Ritentivo|RW|-|-2147483648÷2147483647|-|**Parametro generico**\\ Parametro disponibile per future implementazioni.| | |par01|Long|Ritentivo|RW|-|-2147483648÷2147483647|-|**Parametro generico**\\ Parametro disponibile per future implementazioni.| |
|par02|Long|Ritentivo|RW|-|-2147483648÷2147483647|-|**Parametro generico**\\ Parametro disponibile per future implementazioni.| | |par02|Long|Ritentivo|RW|-|-2147483648÷2147483647|-|**Parametro generico**\\ Parametro disponibile per future implementazioni.| |
|wrnvalue|Byte|0|R|-|-128÷127|-|**Codice di identificazione della causa del warning**\\ Indica la causa del warning intervenuto nel device. Il codice è valido solo se //st_warning// = 1. Per ulteriori informazioni consultare il capitolo dedicato| | |wrnvalue|Byte|0|R|-|-128÷127|-|**Codice di identificazione della causa del warning**\\ Indica la causa del warning intervenuto nel device. Il codice è valido solo se //st_warning// = 1. Per ulteriori informazioni consultare il capitolo dedicato| |
| |
<html><pagebreak /></html> | <WRAP pagebreak></WRAP> |
| |
====== - Tabella stati ====== | ====== - Tabella stati ====== |
|st_warning|0|**Presenza di un warning**\\ Indica lo stato di warning del device, per riconoscere il tipo di warning si deve far riferimento alle variabili //wrncode// e //wrnalue//:\\ **0**: warning non presente,\\ **1**: warning presente| | |st_warning|0|**Presenza di un warning**\\ Indica lo stato di warning del device, per riconoscere il tipo di warning si deve far riferimento alle variabili //wrncode// e //wrnalue//:\\ **0**: warning non presente,\\ **1**: warning presente| |
| |
<html><pagebreak /></html> | <WRAP pagebreak></WRAP> |
| |
====== - Tabella comandi ====== | ====== - Tabella comandi ====== |
|RSWRN|-|**Reset dello stato di warning**\\ Azzera lo stato //st_warning//.| | |RSWRN|-|**Reset dello stato di warning**\\ Azzera lo stato //st_warning//.| |
| |
<html><pagebreak /></html> | <WRAP pagebreak></WRAP> |
| |
====== - Errori e allarmi ====== | ====== - Errori e allarmi ====== |