Andrew Johnson
0abfcc9445
Replaced Dirk's fixed precision=2 and limit=10 seconds with global variables which can be set for each IOC. Also changed the upper control limit for delay fields from 10 to 100,000.
460 lines
12 KiB
C
460 lines
12 KiB
C
/*************************************************************************\
|
|
* Copyright (c) 2008 UChicago Argonne LLC, as Operator of Argonne
|
|
* National Laboratory.
|
|
* Copyright (c) 2002 The Regents of the University of California, as
|
|
* Operator of Los Alamos National Laboratory.
|
|
* EPICS BASE is distributed subject to a Software License Agreement found
|
|
* in file LICENSE that is included with this distribution.
|
|
\*************************************************************************/
|
|
|
|
/* $Revision-Id$ */
|
|
|
|
/* recHistogram.c - Record Support Routines for Histogram records */
|
|
/*
|
|
* Author: Janet Anderson
|
|
* Date: 5/20/91
|
|
*/
|
|
|
|
#include <stddef.h>
|
|
#include <stdlib.h>
|
|
#include <stdarg.h>
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
#include <math.h>
|
|
#include <limits.h>
|
|
|
|
#include "dbDefs.h"
|
|
#include "epicsPrint.h"
|
|
#include "alarm.h"
|
|
#include "callback.h"
|
|
#include "dbAccess.h"
|
|
#include "dbEvent.h"
|
|
#include "epicsPrint.h"
|
|
#include "dbFldTypes.h"
|
|
#include "devSup.h"
|
|
#include "errMdef.h"
|
|
#include "special.h"
|
|
#include "recSup.h"
|
|
#include "recGbl.h"
|
|
#include "menuYesNo.h"
|
|
#define GEN_SIZE_OFFSET
|
|
#include "histogramRecord.h"
|
|
#undef GEN_SIZE_OFFSET
|
|
#include "epicsExport.h"
|
|
|
|
/* Create RSET - Record Support Entry Table*/
|
|
#define report NULL
|
|
#define initialize NULL
|
|
static long init_record(histogramRecord *, int);
|
|
static long process(histogramRecord *);
|
|
static long special(DBADDR *, int);
|
|
#define get_value NULL
|
|
static long cvt_dbaddr(DBADDR *);
|
|
static long get_array_info(DBADDR *, long *, long *);
|
|
#define put_array_info NULL
|
|
static long get_units(DBADDR *, char *);
|
|
static long get_precision(DBADDR *paddr,long *precision);
|
|
#define get_enum_str NULL
|
|
#define get_enum_strs NULL
|
|
#define put_enum_str NULL
|
|
#define get_alarm_double NULL
|
|
static long get_graphic_double(DBADDR *paddr,struct dbr_grDouble *pgd);
|
|
static long get_control_double(DBADDR *paddr,struct dbr_ctrlDouble *pcd);
|
|
|
|
rset histogramRSET={
|
|
RSETNUMBER,
|
|
report,
|
|
initialize,
|
|
init_record,
|
|
process,
|
|
special,
|
|
get_value,
|
|
cvt_dbaddr,
|
|
get_array_info,
|
|
put_array_info,
|
|
get_units,
|
|
get_precision,
|
|
get_enum_str,
|
|
get_enum_strs,
|
|
put_enum_str,
|
|
get_graphic_double,
|
|
get_control_double,
|
|
get_alarm_double
|
|
};
|
|
epicsExportAddress(rset,histogramRSET);
|
|
|
|
int histogramSDELprecision = 2;
|
|
epicsExportAddress(int, histogramSDELprecision);
|
|
|
|
struct histogramdset { /* histogram input dset */
|
|
long number;
|
|
DEVSUPFUN dev_report;
|
|
DEVSUPFUN init;
|
|
DEVSUPFUN init_record; /*returns: (-1,0)=>(failure,success)*/
|
|
DEVSUPFUN get_ioint_info;
|
|
DEVSUPFUN read_histogram;/*(0,2)=> success and add_count, don't add_count)*/
|
|
/* if add_count then sgnl added to array */
|
|
DEVSUPFUN special_linconv;
|
|
};
|
|
|
|
/* control block for callback*/
|
|
typedef struct myCallback {
|
|
CALLBACK callback;
|
|
histogramRecord *prec;
|
|
}myCallback;
|
|
|
|
static long add_count(histogramRecord *);
|
|
static long clear_histogram(histogramRecord *);
|
|
static void monitor(histogramRecord *);
|
|
static long readValue(histogramRecord *);
|
|
|
|
static void wdogCallback(CALLBACK *arg)
|
|
{
|
|
myCallback *pcallback;
|
|
histogramRecord *prec;
|
|
|
|
callbackGetUser(pcallback,arg);
|
|
prec = pcallback->prec;
|
|
/* force post events for any count change */
|
|
if(prec->mcnt>0){
|
|
dbScanLock((struct dbCommon *)prec);
|
|
recGblGetTimeStamp(prec);
|
|
db_post_events(prec,prec->bptr,DBE_VALUE|DBE_LOG);
|
|
prec->mcnt=0;
|
|
dbScanUnlock((struct dbCommon *)prec);
|
|
}
|
|
|
|
if(prec->sdel>0) {
|
|
/* start new watchdog timer on monitor */
|
|
callbackRequestDelayed(&pcallback->callback,(double)prec->sdel);
|
|
}
|
|
|
|
return;
|
|
}
|
|
static long wdogInit(histogramRecord *prec)
|
|
{
|
|
myCallback *pcallback;
|
|
|
|
if(prec->wdog==NULL && prec->sdel>0) {
|
|
/* initialize a watchdog timer */
|
|
pcallback = (myCallback *)(calloc(1,sizeof(myCallback)));
|
|
pcallback->prec = prec;
|
|
if(!pcallback) return -1;
|
|
callbackSetCallback(wdogCallback,&pcallback->callback);
|
|
callbackSetUser(pcallback,&pcallback->callback);
|
|
callbackSetPriority(priorityLow,&pcallback->callback);
|
|
prec->wdog = (void *)pcallback;
|
|
}
|
|
|
|
if (!prec->wdog) return -1;
|
|
pcallback = (myCallback *)prec->wdog;
|
|
if(!pcallback) return -1;
|
|
if( prec->sdel>0) {
|
|
/* start new watchdog timer on monitor */
|
|
callbackRequestDelayed(&pcallback->callback,(double)prec->sdel);
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
static long init_record(histogramRecord *prec, int pass)
|
|
{
|
|
struct histogramdset *pdset;
|
|
long status;
|
|
|
|
if (pass==0){
|
|
|
|
/* allocate space for histogram array */
|
|
if(prec->bptr==NULL) {
|
|
if(prec->nelm<=0) prec->nelm=1;
|
|
prec->bptr = (epicsUInt32 *)calloc(prec->nelm,sizeof(epicsUInt32));
|
|
}
|
|
|
|
/* calulate width of array element */
|
|
prec->wdth=(prec->ulim-prec->llim)/prec->nelm;
|
|
|
|
return(0);
|
|
}
|
|
|
|
wdogInit(prec);
|
|
|
|
if (prec->siml.type == CONSTANT) {
|
|
recGblInitConstantLink(&prec->siml,DBF_USHORT,&prec->simm);
|
|
}
|
|
|
|
if (prec->siol.type == CONSTANT) {
|
|
recGblInitConstantLink(&prec->siol,DBF_DOUBLE,&prec->sval);
|
|
}
|
|
|
|
/* must have device support defined */
|
|
if(!(pdset = (struct histogramdset *)(prec->dset))) {
|
|
recGblRecordError(S_dev_noDSET,(void *)prec,"histogram: init_record");
|
|
return(S_dev_noDSET);
|
|
}
|
|
/* must have read_histogram function defined */
|
|
if( (pdset->number < 6) || (pdset->read_histogram == NULL) ) {
|
|
recGblRecordError(S_dev_missingSup,(void *)prec,"histogram: init_record");
|
|
return(S_dev_missingSup);
|
|
}
|
|
/* call device support init_record */
|
|
if( pdset->init_record ) {
|
|
if((status=(*pdset->init_record)(prec))) return(status);
|
|
}
|
|
return(0);
|
|
}
|
|
|
|
static long process(histogramRecord *prec)
|
|
{
|
|
struct histogramdset *pdset = (struct histogramdset *)(prec->dset);
|
|
long status;
|
|
unsigned char pact=prec->pact;
|
|
|
|
if( (pdset==NULL) || (pdset->read_histogram==NULL) ) {
|
|
prec->pact=TRUE;
|
|
recGblRecordError(S_dev_missingSup,(void *)prec,"read_histogram");
|
|
return(S_dev_missingSup);
|
|
}
|
|
|
|
status=readValue(prec); /* read the new value */
|
|
/* check if device support set pact */
|
|
if ( !pact && prec->pact ) return(0);
|
|
prec->pact = TRUE;
|
|
|
|
recGblGetTimeStamp(prec);
|
|
|
|
if(status==0)add_count(prec);
|
|
else if(status==2)status=0;
|
|
|
|
/* check event list */
|
|
monitor(prec);
|
|
|
|
/* process the forward scan link record */
|
|
recGblFwdLink(prec);
|
|
|
|
prec->pact=FALSE;
|
|
return(status);
|
|
}
|
|
|
|
static long special(DBADDR *paddr,int after)
|
|
{
|
|
histogramRecord *prec = (histogramRecord *)(paddr->precord);
|
|
int special_type = paddr->special;
|
|
int fieldIndex = dbGetFieldIndex(paddr);
|
|
|
|
|
|
if(!after) return(0);
|
|
switch(special_type) {
|
|
case(SPC_CALC):
|
|
if(prec->cmd <=1){
|
|
clear_histogram(prec);
|
|
prec->cmd =0;
|
|
} else if (prec->cmd ==2){
|
|
prec->csta=TRUE;
|
|
prec->cmd =0;
|
|
} else if (prec->cmd ==3){
|
|
prec->csta=FALSE;
|
|
prec->cmd =0;
|
|
}
|
|
return(0);
|
|
case(SPC_MOD):
|
|
/* increment frequency in histogram array */
|
|
add_count(prec);
|
|
return(0);
|
|
case(SPC_RESET):
|
|
if (fieldIndex == histogramRecordSDEL) {
|
|
wdogInit(prec);
|
|
} else {
|
|
prec->wdth=(prec->ulim-prec->llim)/prec->nelm;
|
|
clear_histogram(prec);
|
|
}
|
|
return(0);
|
|
default:
|
|
recGblDbaddrError(S_db_badChoice,paddr,"histogram: special");
|
|
return(S_db_badChoice);
|
|
}
|
|
}
|
|
|
|
static void monitor(histogramRecord *prec)
|
|
{
|
|
unsigned short monitor_mask;
|
|
|
|
monitor_mask = recGblResetAlarms(prec);
|
|
/* post events for count change */
|
|
if(prec->mcnt>prec->mdel){
|
|
/* post events for count change */
|
|
monitor_mask |= DBE_VALUE|DBE_LOG;
|
|
/* reset counts since monitor */
|
|
prec->mcnt = 0;
|
|
}
|
|
/* send out monitors connected to the value field */
|
|
if(monitor_mask) db_post_events(prec,prec->bptr,monitor_mask);
|
|
|
|
return;
|
|
}
|
|
|
|
static long cvt_dbaddr(DBADDR *paddr)
|
|
{
|
|
histogramRecord *prec=(histogramRecord *)paddr->precord;
|
|
|
|
paddr->pfield = (void *)(prec->bptr);
|
|
paddr->no_elements = prec->nelm;
|
|
paddr->field_type = DBF_ULONG;
|
|
paddr->field_size = sizeof(epicsUInt32);
|
|
paddr->dbr_field_type = DBF_ULONG;
|
|
return(0);
|
|
}
|
|
|
|
static long get_array_info(DBADDR *paddr, long *no_elements, long *offset)
|
|
{
|
|
histogramRecord *prec=(histogramRecord *)paddr->precord;
|
|
|
|
*no_elements = prec->nelm;
|
|
*offset = 0;
|
|
return(0);
|
|
}
|
|
|
|
static long add_count(histogramRecord *prec)
|
|
{
|
|
double temp;
|
|
epicsUInt32 *pdest;
|
|
int i;
|
|
|
|
if(prec->csta==FALSE) return(0);
|
|
|
|
if(prec->llim >= prec->ulim) {
|
|
if (prec->nsev<INVALID_ALARM) {
|
|
prec->stat = SOFT_ALARM;
|
|
prec->sevr = INVALID_ALARM;
|
|
return(-1);
|
|
}
|
|
}
|
|
if(prec->sgnl<prec->llim || prec->sgnl >= prec->ulim) return(0);
|
|
|
|
temp=prec->sgnl-prec->llim;
|
|
for (i=1;i<=prec->nelm;i++){
|
|
if (temp<=(double)i*prec->wdth) break;
|
|
}
|
|
pdest=prec->bptr+i-1;
|
|
if (*pdest == (epicsUInt32) UINT_MAX) *pdest=0;
|
|
(*pdest)++;
|
|
prec->mcnt++;
|
|
|
|
return(0);
|
|
}
|
|
|
|
static long clear_histogram(histogramRecord *prec)
|
|
{
|
|
int i;
|
|
|
|
for (i = 0; i < prec->nelm; i++)
|
|
prec->bptr[i] = 0;
|
|
prec->mcnt = prec->mdel + 1;
|
|
prec->udf = FALSE;
|
|
|
|
return(0);
|
|
}
|
|
|
|
static long readValue(histogramRecord *prec)
|
|
{
|
|
long status;
|
|
struct histogramdset *pdset = (struct histogramdset *) (prec->dset);
|
|
|
|
if (prec->pact == TRUE){
|
|
status=(*pdset->read_histogram)(prec);
|
|
return(status);
|
|
}
|
|
|
|
status=dbGetLink(&(prec->siml),DBR_USHORT,&(prec->simm),0,0);
|
|
|
|
if (status)
|
|
return(status);
|
|
|
|
if (prec->simm == menuYesNoNO){
|
|
status=(*pdset->read_histogram)(prec);
|
|
return(status);
|
|
}
|
|
if (prec->simm == menuYesNoYES){
|
|
status=dbGetLink(&(prec->siol),DBR_DOUBLE,
|
|
&(prec->sval),0,0);
|
|
|
|
if (status==0){
|
|
prec->sgnl=prec->sval;
|
|
}
|
|
} else {
|
|
status=-1;
|
|
recGblSetSevr(prec,SOFT_ALARM,INVALID_ALARM);
|
|
return(status);
|
|
}
|
|
recGblSetSevr(prec,SIMM_ALARM,prec->sims);
|
|
|
|
return(status);
|
|
}
|
|
|
|
#define indexof(field) histogramRecord##field
|
|
|
|
static long get_units(DBADDR *paddr, char *units)
|
|
{
|
|
if (dbGetFieldIndex(paddr) == indexof(SDEL)) {
|
|
strcpy(units,"s");
|
|
}
|
|
/* We should have EGU for other DOUBLE values or probably get it from input link SVL */
|
|
return(0);
|
|
}
|
|
|
|
static long get_precision(DBADDR *paddr,long *precision)
|
|
{
|
|
histogramRecord *prec=(histogramRecord *)paddr->precord;
|
|
|
|
switch (dbGetFieldIndex(paddr)) {
|
|
case indexof(ULIM):
|
|
case indexof(LLIM):
|
|
case indexof(SGNL):
|
|
case indexof(SVAL):
|
|
case indexof(WDTH):
|
|
*precision = prec->prec;
|
|
break;
|
|
case indexof(SDEL):
|
|
*precision = histogramSDELprecision;
|
|
break;
|
|
default:
|
|
recGblGetPrec(paddr,precision);
|
|
}
|
|
return(0);
|
|
}
|
|
|
|
static long get_graphic_double(DBADDR *paddr,struct dbr_grDouble *pgd)
|
|
{
|
|
histogramRecord *prec=(histogramRecord *)paddr->precord;
|
|
|
|
switch (dbGetFieldIndex(paddr)) {
|
|
case indexof(BPTR):
|
|
pgd->upper_disp_limit = prec->hopr;
|
|
pgd->lower_disp_limit = prec->lopr;
|
|
break;
|
|
case indexof(WDTH):
|
|
pgd->upper_disp_limit = prec->ulim-prec->llim;
|
|
pgd->lower_disp_limit = 0.0;
|
|
break;
|
|
default:
|
|
recGblGetGraphicDouble(paddr,pgd);
|
|
}
|
|
return(0);
|
|
}
|
|
static long get_control_double(DBADDR *paddr,struct dbr_ctrlDouble *pcd)
|
|
{
|
|
histogramRecord *prec=(histogramRecord *)paddr->precord;
|
|
|
|
switch (dbGetFieldIndex(paddr)) {
|
|
case indexof(BPTR):
|
|
pcd->upper_ctrl_limit = prec->hopr;
|
|
pcd->lower_ctrl_limit = prec->lopr;
|
|
break;
|
|
case indexof(WDTH):
|
|
pcd->upper_ctrl_limit = prec->ulim-prec->llim;
|
|
pcd->lower_ctrl_limit = 0.0;
|
|
break;
|
|
default:
|
|
recGblGetControlDouble(paddr,pcd);
|
|
}
|
|
return(0);
|
|
}
|