fanout记录使用若干转发运行链接强制多个被动记录进行扫描。当多个基类由于一个基类被运行而需要被扫描时,那个基类的转发链接可以执行一个fanout记录。fanout记录可以最多指定16个其它记录运行。如果需要比16个多,在这个fanout记录中一个转发链接(或其FLNK字段)可以指向另一个fanout记录。
注意:fanout记录不传播运行,不传播数据。另外,dfanout或数据扇出记录可以发送数据到其它记录。
参数字段:
在下面描述记录特定的字段,按功能分组:
用于扫描的参数
在fanout记录中的转发链接字段(LNK0-LNK9,LNKA-LNKF)指定要被扫描的记录。要被运行的记录必须在它们的SCAN字段中指定Passive;否则转发链接将不会使得它们运行。当为fanout记录指定数据库链接时,用户只需要指定这个记录的名称。虽然不发送或获取值,但在链接将通过通道访问时才需要一个字段名,在此中情况下,必须指名字段PROC。
SELM,SELN和SELL字段为转发链接指定运行顺序。选择机制菜单字段(SELM)有三个选项:
1) All:按数值顺序运行链接--LNK0-LNK1等。
2) Specified:在SELN和OFFS字段中值的和被用作要运行哪个链接的指示器。例如,OFFS=0和SELN=1,由LNK1指向的记录将被运行。
3) Mask:在SELN中各位被移动SHFT位(负表示左移),并且结果根据以下用于选择要运行哪些记录:
- 如果第0位(LSB)被置位,运行LNK0
- 如果第1位被置位,运行LNK1
- 如果第2位被置位,运行LNK2,等
SELN从SELL读取它的值。SELL可以是一个常数,数据库链接,或者通道访问链接。如果是常数,SELN被这个常数值初始化,并且能够通过dbPuts被修改。对于数据库/通道访问链接,记录每次被运行时,从SELL获取SELN,并且也能通过dbPuts被修改。
Fanout记录也有所有记录公有的标准扫描字段。这些字段在Scan Fields中被列出。
操作显示参数
这些参数用于向操作者显示有意义参数。有关这些字段更多信息见Fields Common to All Record Types。
警报参数
Fanout记录有所有记录类型公有的警报参数。Alarm Fields列出了与所有记录类型公有警报相关联的字段。
运行时参数
VAL字段不执行特定功能,但一个对其的通道访问写会使得这个记录运行。
记录支持例程
1) init_record
如果SELL类型是CONSTANT链接,用SELL的值初始化SELN,或者如果SELL类型是PV_LINK,创建一个通道访问链接。
2) process
见以下部分
记录运行
例程process实现以下算法:
1) PACT被设置为TRUE
2) 获取链接选择SELN。
3) 取决于选择机制,选取的转发链接被运行,并且设置UDF为FALSE
4) 检查是否应该调用monitors:
- 如果警报状态或严重性发生变化,调用alarm警报
- 重置NSEV和NSTA为0
5) 如果使用了转发链接字段FLNK,扫描它,设置PACT为FALSE,并且返回。
fanout记录支持模块:
#include <stddef.h>
#include <stdlib.h>
#include <stdarg.h>
#include <stdio.h>
#include <string.h>
#include "dbDefs.h"
#include "epicsPrint.h"
#include "alarm.h"
#include "dbAccess.h"
#include "dbEvent.h"
#include "dbFldTypes.h"
#include "errMdef.h"
#include "epicsTypes.h"
#include "recSup.h"
#include "recGbl.h"
#include "dbCommon.h"
#define GEN_SIZE_OFFSET
#include "fanoutRecord.h"
#undef GEN_SIZE_OFFSET
#include "epicsExport.h"
#define NLINKS 16
/* Create RSET - Record Support Entry Table*/
#define report NULL
#define initialize NULL
static long init_record(struct dbCommon *, int);
static long process(struct dbCommon *);
#define special NULL
#define get_value NULL
#define cvt_dbaddr NULL
#define get_array_info NULL
#define put_array_info NULL
#define get_units NULL
#define get_precision NULL
#define get_enum_str NULL
#define get_enum_strs NULL
#define put_enum_str NULL
#define get_graphic_double NULL
#define get_control_double NULL
#define get_alarm_double NULL
//定义fanout记录支持模块
rset fanoutRSET = {
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
};
//导出fanout记录支持模块
epicsExportAddress(rset,fanoutRSET);
//如果SELL是CONSTANT链接,则用SELL的值初始化SELN。
static long init_record(struct dbCommon *pcommon, int pass)
{
struct fanoutRecord *prec = (struct fanoutRecord *)pcommon;
if (pass == 0)
return 0;
recGblInitConstantLink(&prec->sell, DBF_USHORT, &prec->seln);
return 0;
}
//
static long process(struct dbCommon *pcommon)
{
struct fanoutRecord *prec = (struct fanoutRecord *)pcommon;
struct link *plink;
epicsUInt16 seln, events;
int i;
epicsUInt16 oldn = prec->seln; //存储前一次的SELN
prec->pact = TRUE;
/* 从SELL获取一个值,存入SELN */
dbGetLink(&prec->sell, DBR_USHORT, &prec->seln, 0, 0);
seln = prec->seln;
switch (prec->selm) {
case fanoutSELM_All: //LNK0-LNKF依次被运行
plink = &prec->lnk0;
for (i = 0; i < NLINKS; i++, plink++) {
dbScanFwdLink(plink);
}
break;
case fanoutSELM_Specified: //由SELN和OFFS决定运行哪一个转发链接
i = seln + prec->offs; //计算偏移量
if (i < 0 || i >= NLINKS) { // 偏移量超范围
recGblSetSevr(prec, SOFT_ALARM, INVALID_ALARM);
break;
}
plink = &prec->lnk0 + i; //通过偏移量计算出指针位置
dbScanFwdLink(plink);
break;
case fanoutSELM_Mask:
i = prec->shft;
if (i < -15 || i > 15) {
/* 移位多于数值中比特数目在C中产生未定义行为 */
recGblSetSevr(prec, SOFT_ALARM, INVALID_ALARM);
break;
}
seln = (i >= 0) ? seln >> i : seln << -i;
if (seln == 0)
break;
plink = &prec->lnk0;
// 对seln移位后,运行其比特位上置1的位对应的转发链接
for (i = 0; i < NLINKS; i++, seln >>= 1, plink++) {
if (seln & 1)
dbScanFwdLink(plink);
}
break;
default:
recGblSetSevr(prec, SOFT_ALARM, INVALID_ALARM);
}
prec->udf = FALSE;
recGblGetTimeStamp(prec);
/* post monitors */
events = recGblResetAlarms(prec);
if (events)
db_post_events(prec, &prec->val, events);
if (prec->seln != oldn)
db_post_events(prec, &prec->seln, events | DBE_VALUE | DBE_LOG);
/* finish off */
recGblFwdLink(prec);
prec->pact = FALSE;
return 0;
}
示例:
使用以下一个数据库实例文件,这个文件由5个记录实例组成:
1) $(USER):param记录实例类型是longin,用作一个对其它记录的输入源,它是被动记录,当通过通道访问向其写入一个数值时,将引发其运行,并且驱动FLNK字段指向的记录运行
2) $(USER):fanout记录类型是fanout,用作驱动连接了其LNKx的被动记录运行
3 ) $(USER):int1, $(USER):int2和$(USER):int3记录类型都是longin,当它们运行时,将从它们INP字段指向的记录获取一个输入值。
record(longin, "$(USER):param")
{
field(SCAN, "Passive")
field(INP, "1")
field(DTYP, "Soft Channel")
field(FLNK, "$(USER):fanout.PROC")
field(PINI, "YES")
}
record(fanout, "$(USER):fanout")
{
field(SELM,"All")
field(SCAN, "Passive")
field(LNK0, "$(USER):int1.PROC")
field(LNK1, "$(USER):int2.PROC")
field(LNK2, "$(USER):int3.PROC")
}
record(longin, "$(USER):int1")
{
field(SCAN, "Passive")
field(DTYP, "Soft Channel")
field(INP, "$(USER):param")
}
record(longin, "$(USER):int2")
{
field(SCAN, "Passive")
field(DTYP, "Soft Channel")
field(INP, "$(USER):param")
}
record(longin, "$(USER):int3")
{
field(SCAN, "Passive")
field(DTYP, "Soft Channel")
field(INP, "$(USER):param")
}
将这个db文件通过dbLoadRecords加载到IOC中运行,用dbl查看加载的记录:
epics> dbl
blctrl:fanout
blctrl:param
blctrl:int1
blctrl:int2
blctrl:int3
打开一个新的终端,用camonitor监视blctrl:param, blctrl:int1, blctrl:int2和blctrl:int3四个记录的值:
[root@bjAli ~]# camonitor blctrl:param blctrl:int1 blctrl:int2 blctrl:int3
blctrl:param 2022-10-09 20:34:34.656333 1
blctrl:int1 2022-10-09 20:34:34.656376 1
blctrl:int2 2022-10-09 20:34:34.656377 1
blctrl:int3 2022-10-09 20:34:34.656377 1
再开启一个命令终端,测试Fanout记录的三种选择模式:
1) SELM字段为All时,线获取当前的选择模式,再向blctrl:param写一个新值:
[root@bjAli ~]# caget blctrl:fanout.SELM
blctrl:fanout.SELM All
[root@bjAli ~]# caput blctrl:param 2
Old : blctrl:param 1
New : blctrl:param 2
监视终端中显示了blctrl:int1,blctrl:int2和blctrl:int3记录都从blctrl:param记录获取了值。
[root@bjAli ~]# camonitor blctrl:param blctrl:int1 blctrl:int2 blctrl:int3
blctrl:param 2022-10-09 20:34:34.656333 1
blctrl:int1 2022-10-09 20:34:34.656376 1
blctrl:int2 2022-10-09 20:34:34.656377 1
blctrl:int3 2022-10-09 20:34:34.656377 1
blctrl:param 2022-10-09 20:39:08.704300 2
blctrl:int1 2022-10-09 20:39:08.704313 2
blctrl:int2 2022-10-09 20:39:08.704315 2
blctrl:int3 2022-10-09 20:39:08.704316 2
2) SELM字段为Specified时,更改SELM字段为"Specified",OFFS字段为1,SELN字段为1后向blctrl:param中写入一个新值:
[root@bjAli ~]# caput blctrl:fanout.SELM "Specified"
Old : blctrl:fanout.SELM All
New : blctrl:fanout.SELM Specified
[root@bjAli ~]# caput blctrl:fanout.SELN 1
Old : blctrl:fanout.SELN 1
New : blctrl:fanout.SELN 1
[root@bjAli ~]# caput blctrl:fanout.OFFS 1
Old : blctrl:fanout.OFFS 0
New : blctrl:fanout.OFFS 1
[root@bjAli ~]# caput blctrl:param 3
Old : blctrl:param 2
New : blctrl:param 3
监视终端中显示了仅有blctrl:int3记录被blctrl:fanout记录选取运行,从blctrl:param获取了新值:
[root@bjAli ~]# camonitor blctrl:param blctrl:int1 blctrl:int2 blctrl:int3
blctrl:param 2022-10-09 20:34:34.656333 1
blctrl:int1 2022-10-09 20:34:34.656376 1
blctrl:int2 2022-10-09 20:34:34.656377 1
blctrl:int3 2022-10-09 20:34:34.656377 1
blctrl:param 2022-10-09 20:39:08.704300 2
blctrl:int1 2022-10-09 20:39:08.704313 2
blctrl:int2 2022-10-09 20:39:08.704315 2
blctrl:int3 2022-10-09 20:39:08.704316 2
blctrl:param 2022-10-09 20:45:03.403846 3
blctrl:int3 2022-10-09 20:45:03.403866 3
3) SELM字段为Mask时:更改SELM字段为"Mask",设置SELN字段值为3,SHFT字段值为-1,然后向blctrl:param记录写入一个新值:
[root@bjAli ~]# caput blctrl:fanout.SELM "Mask"
Old : blctrl:fanout.SELM Specified
New : blctrl:fanout.SELM Mask
[root@bjAli ~]# caput blctrl:fanout.SELN "3"
Old : blctrl:fanout.SELN 1
New : blctrl:fanout.SELN 3
[root@bjAli ~]# caput blctrl:fanout.SHFT -1
Old : blctrl:fanout.SHFT -1
New : blctrl:fanout.SHFT -1
[root@bjAli ~]# caput blctrl:param 5
Old : blctrl:param 3
New : blctrl:param 5
监视终端中显示了blctrl:int2和blctrl:int3被blcrl:fanout选取运行,从blctrl:param记录获取了新值:
[root@bjAli ~]# camonitor blctrl:param blctrl:int1 blctrl:int2 blctrl:int3
blctrl:param 2022-10-09 20:34:34.656333 1
blctrl:int1 2022-10-09 20:34:34.656376 1
blctrl:int2 2022-10-09 20:34:34.656377 1
blctrl:int3 2022-10-09 20:34:34.656377 1
blctrl:param 2022-10-09 20:39:08.704300 2
blctrl:int1 2022-10-09 20:39:08.704313 2
blctrl:int2 2022-10-09 20:39:08.704315 2
blctrl:int3 2022-10-09 20:39:08.704316 2
blctrl:param 2022-10-09 20:45:03.403846 3
blctrl:int3 2022-10-09 20:45:03.403866 3
blctrl:param 2022-10-09 20:50:11.545007 5
blctrl:int2 2022-10-09 20:50:11.545019 5
blctrl:int3 2022-10-09 20:50:11.545020 5