跳转至

18.dset_tag_qos2

函数声明

C
1
    BOOL py_dset_tag_qos2(const char *dev_name,const char *tag_addr,int qos,BOOL reset_value);

  • 描述：

    根据设备名称+测点寄存器地址，写入测点的质量戳。

  • 参数：

    dev_name:目标设备的名称；

    tag_addr:目标测点的寄存器地址，可传空字符串，此时设置目标设备下所有的测点；

    qos:要写入的测点的质量；

    reset_value:是否清零测点的实时值，传1则清零。

  • 返回值：

    返回TRUE(值1)为成功，返回FALSE(值0)失败，找不到目标测点。

  • 示例：

提示

使用该函数时应保证一个设备下测点的寄存器地址唯一不重复。

Python
1
2
3
4
5
6
7
8
9
    c4py.py_load_so()
    c4py.global_init()
    dev_name = "python采集设备1"
    tag_addr = "3"
    #设置 python采集设备1 下地址为 3 的测点的质量为BAD，且清零数据
    c4py.dset_tag_qos2(dev_name.encode(),tag_addr.encode(),c4py.TAG_QUALITY_BAD,1)
    #设置 python采集设备1 下所有测点的质量为BAD，但是不清零数据
    c4py.dset_tag_qos2(dev_name.encode(),b"",c4py.TAG_QUALITY_BAD,0)
    c4py.global_release()

  • qos参数取值：

    名称 说明
    c4py.TAG_QUALITY_GOOD 测点质量戳好
    c4py.TAG_QUALITY_BAD 测点质量戳坏
    c4py.TAG_QUALITY_SET 测点质量戳为人工置数
    c4py.TAG_QUALITY_INVALID 测点质量戳无效,即没有初始化过