EPICS记录参考--Fanout记录(fanout)

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
  • 1
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值