更多内容点击：边缘智联专栏

一、功能概述

置数（人工设值）是将指定测点的值强制修改为人工指定的数值，用于仿真调试、应急置数等场景。置数操作仅在内存中修改测点值，不会下发到现场设备。

核心能力：

• 支持批量置数，一次调用可同时设置多个测点
• 支持两种操作类型：置数（覆盖当前值）和清理置数（恢复实际采集值）
• 置数后的值会打上"人工置数"标记，与正常采集值区分
• 通过通道唯一标识分段路由，支持系统模块、自定义模块、采集模块三个子模块

二、接口形式

// ===================== 置数操作接口 =====================
// 输入：一个"置数请求"对象，内含多条置数项
// 输出：每项单独返回处理结果（成功或失败原因），整体返回汇总状态
class DataSourceSetValueItem
{
public:
    //置数类型
    typedef enum {
        eSetTypeInvalid = 0,
        eSetTypeDirectSetUp,   //置数
        eSetTypeCleanValue,    //清理置数
    } eSetType;
    
    //置数处理结果
    typedef enum {
        eSetResultTypeSuccess = 0,
        eSetResultTypeFaile = -1,
        
        eSetResultTypeFindChannelIdInvalid = -10,
        eSetResultTypeFindDevIdInvalid = -11,
        eSetResultTypeFindPointIdInvalid = -12,
    } eSetResultType;

    //置数类型
    eSetType    m_eSetType;
    // 测点Id信息
    uint32_t m_uChannelId;
    uint32_t m_uDevId;
    uint32_t m_uPointId;
    
    string m_strValue;      //置数值: 字符串类型，根据变量类型进行转换
    
    // 置数结果
    eSetResultType  m_eResultType;
public:
    DataSourceSetValueItem(/* args */) {
        m_eSetType = eSetTypeInvalid; 
    
        m_uChannelId = 0;
        m_uDevId = 0;
        m_uPointId = 0;
        m_strValue = "";
    
        m_eResultType = eSetResultTypeFaile; 
    };
};

class DataSourceSetValue
{
public:

    vector<DataSourceSetValueItem>  m_vValueBlack;
public:
    DataSourceSetValue(/* args */) {};
};

三、置数项结构

每条置数项包含以下信息：

四、处理流程

上层调用
  │
  ▼
统一入口层 → 直接委托给"模块路由层"
  │
  ▼
模块路由层 → 根据通道编号分段分发：
  ├── 系统模块
  ├── 自定义模块
  └── 采集模块
        │
        ▼
      采集模块 → 按三级索引查找目标测点：
        ├── ① 遍历所有通道，按通道编号匹配
        ├── ② 在通道内遍历设备，按设备编号匹配
        ├── ③ 在设备的测点表中按测点编号查找
        └── ④ 根据操作类型执行：
              ├─ 置数：将字符串转为对应类型 → 写入测点值 → 打上人工置数标记
              └─ 清理置数：去除人工置数标记，恢复采集值

五、值类型转换

置数值以字符串传入，根据测点自身的数据类型自动转换：

若字符串无法转换为目标类型，该项返回"类型转换错误"。

六、操作类型说明

七、错误码

每个置数项操作完成后，执行结果字段会被回填为以下值之一：

八、注意事项

1. 不改变原始值：置数只修改最终对外展示的值，测点的原始采集值保持不变，清理置数后即可恢复
2. 通道编号范围：编号范围决定路由目标，不在有效范围内的编号会被直接拒绝
3. 线程安全：置数过程中驱动可能同时在更新测点值，测点内部通过标记位区分置数值与采集值
4. 批量调用：一次可传入多条置数项，每条独立处理，互不影响；某条失败不影响其他条