# IOC 主机上 PV 在 Target Client 的计算与引用能力分析 ## 一、问题解构 用户核心诉求是厘清：**EPICS IOC 主机定义的 PV（Process Variable），能否在 Target Client（如 CSS/OPI、BOY、Python/Java CA 客户端）端完成“输入变量的计算”和“引用”？** 需明确区分三类“计算/引用”场景： - **IOC 端计算**：由 `calc`、`subArray`、`seq` 等 record 类型在 IOC 内部执行，PV 是计算结果输出； - **Client 端计算（Target Client）**：客户端读取多个 PV 值后，在本地内存中进行算术、逻辑、字符串或时间运算，并生成新值； - **Client 端引用（非计算）**：仅将某 PV 值作为参数传入控件属性（如 `Text Update` 的 `Format` 表达式）、脚本或条件判断，不改变原始 PV。 > ✅ 结论先行：**IOC 定义的 PV 本身不可被 Target Client “写入式计算”，但可被任意 Client 读取后，在本地完成任意复杂度的计算与引用；该行为完全脱离 IOC，属客户端自主逻辑。** [ref_1] --- ## 二、核心机制对比：IOC vs Target Client 的角色边界 | 维度 | IOC 主机（Server Side） | Target Client（CSS/OPI/Python等） | |------|--------------------------|-------------------------------------| | **PV 定义权** | ✅ 唯一权威：通过 `.db` 文件声明 PV 名、类型、扫描策略、输入链接（`INP`）、计算逻辑（`CALC`） | | **PV 写入权** | ✅ 可 `caput`（本地或远程）；`ai/bi/ao/bo/stringout` 等 record 支持写入 | | **PV 计算权** | ✅ `calc`、`transform`、`seq` record 在 IOC 内实时计算，输出新 PV | | **PV 引用权（读）** | ✅ `INP = "xxx"` 实现 record 间引用（如 `ai1` → `calc1.INPA`） | | **PV 引用权（Client 端）** | ❌ IOC 不感知 Client 如何使用其 PV；Client 可自由读取任意 PV 并组合 | | **Client 端计算能力** | — | ✅ 完全开放：CSS 支持 JavaScript 表达式、Python 脚本；Java/Python CA 客户端可调用任意库 | | **计算结果持久化** | ❌ Client 计算值无法自动注册为 EPICS PV（除非显式 `caput` 到一个可写 PV） | ✅ 可 `caput` 到 IOC 中预定义的 `ao`/`stringout`/`calc` 输入域，实现“Client 驱动 IOC 计算” | > 🔑 关键认知：EPICS 是**数据分发总线**，而非计算调度中心。Client 对 PV 的“计算”本质是**消费侧数据加工**，与 IOC 的“生产侧计算”正交共存 [ref_1]。 --- ## 三、Target Client 端计算与引用的四大实现路径 ### 路径 1：CSS/OPI 内置表达式引擎（轻量级实时计算） CSS 支持在控件属性中嵌入 JavaScript 表达式，实时响应 PV 变化： ```javascript // 示例：温度报警状态计算（假设 PV: temp:read, temp:setpoint, temp:alarm_en） // 在 LED 控件的 "Value Expression" 属性中填写： ${temp:read > temp:setpoint + 5 && temp:alarm_en === 1 ? 1 : 0} ``` | 特性 | 说明 | |------|------| | **触发时机** | 所有依赖 PV 更新时自动重算（CA monitor 回调驱动） | | **支持操作** | `+ - * / % && || ! == != > < >= <= ? :`，数学函数 `Math.*`，字符串方法 | | **限制** | 无循环、无副作用（不能 `caput`）、无外部 I/O；仅用于 UI 状态映射 | > ✅ 此为最常用、零部署成本的 Client 端计算方式，适用于阈值判断、单位换算、状态合成 [ref_1]。 --- ### 路径 2：CSS 脚本控件（中等复杂度逻辑） CSS 提供 `Script` 控件，支持完整 JavaScript（ECMAScript 5.1），可访问所有已绑定 PV： ```javascript // Script 控件代码（绑定 PV: pv_a, pv_b, pv_result） var a = pv_a.value; var b = pv_b.value; var sum = a + b; var avg = (a + b) / 2; // 写回 IOC 的可写 PV（需提前定义 ao/stringout record） caput("calc:result_sum", sum); caput("calc:result_avg", avg); // 同时更新本地 UI 文本 widget.setPropertyValue("text", `Sum=${sum}, Avg=${avg.toFixed(2)}`); ``` | 特性 | 说明 | |------|------| | **执行模型** | 每秒轮询（可配置）或由 PV change event 触发 | | **能力边界** | ✅ 调用 `caput`/`caget`；✅ 访问 DOM/widget；✅ 使用 `Date`/`Array` 等原生对象 | | **典型用途** | 多 PV 聚合统计、报警抑制逻辑、自定义 PID 参数计算 | > ⚠️ 注意：脚本运行于 SWT UI 线程，阻塞型操作（如 `sleep`）将导致界面卡顿，须用异步模式 [ref_3]。 --- ### 路径 3：Python/Java CA 客户端（高自由度计算） 使用 `pyepics` 或 `jca` 库，在独立进程中完成任意计算： ```python # python_client_calculator.py from epics import PV import numpy as np import time # 监听多个 PV pvs = { 'voltage': PV('adc:volt'), 'current': PV('adc:curr'), 'temp': PV('sensor:temp') } result_pv = PV('calc:power') # 可写 PV，对应 IOC 中 ao record def on_value_change(pv_name, value, **kwargs): v = pvs['voltage'].value i = pvs['current'].value t = pvs['temp'].value if all(x is not None for x in [v, i, t]): # 复杂计算：功率 = V*I * 温度补偿系数 comp_factor = 1.0 + 0.00393 * (t - 25) # Cu 电阻温度系数 power = v * i * comp_factor result_pv.put(power) print(f"[{time.strftime('%H:%M:%S')}] P={power:.2f}W (T={t}°C)") # 绑定回调（CA monitor） for pv in pvs.values(): pv.add_callback(on_value_change) while True: time.sleep(1) ``` | 特性 | 说明 | |------|------| | **技术栈** | `pyepics`（Python）、`jca`（Java）、`p4p`（Python 新一代） | | **优势** | ✅ 无 UI 线程限制；✅ 集成 SciPy/TensorFlow 等库；✅ 可连接数据库/HTTP API | | **部署模式** | 独立进程，与 CSS 无关；可部署在 IOC 主机或边缘网关 | > ✅ 此路径将 Target Client 升级为“边缘计算节点”，实现 IOC 无法承担的 ML 推理、频谱分析等任务 [ref_1]。 --- ### 路径 4：IOC 与 Client 协同计算（推荐架构） 最佳实践是**分层计算**：简单、实时、安全逻辑放 IOC；复杂、非实时、需外部数据逻辑放 Client，并通过专用 PV 交互： ```text # IOC DB 片段：定义协同接口 record(ao, "$(P)$(R)ClientCmd") { # Client 发送指令 field(DESC, "Command from client (e.g., 'CALC_PID')") } record(ai, "$(P)$(R)ClientResult") { # Client 回传结果 field(DESC, "Computed result from client") } record(calc, "$(P)$(R)FinalOutput") { # IOC 最终融合 field(CALC, "A+B") field(INPA, "$(P)$(R)SensorRaw") field(INPB, "$(P)$(R)ClientResult") # 引用 Client 计算值 } ``` Client 端逻辑： ```javascript // CSS Script 控件 if (pv_cmd.value === "CALC_PID") { const kp = caget("pid:kp"); const ki = caget("pid:ki"); const setpoint = caget("ctrl:setpoint"); const procval = caget("sensor:procval"); const output = kp*(setpoint-procval) + ki*integral_error; caput("calc:client_result", output); // 写入 IOC 的输入 PV } ``` > 🌟 该模式兼顾安全性（IOC 保底控制）、灵活性（Client 扩展算法）、可观测性（所有中间值均为 PV），是大型控制系统标准范式 [ref_1]。 --- ## 四、关键限制与规避清单 | 限制 | 根本原因 | 规避方案 | |------|----------|-----------| | **Client 计算无法替代 IOC 安全逻辑** | IOC 是唯一具备硬件级看门狗、断电保持、硬接线联锁的可信执行环境 | 将急停、超限保护等关键逻辑固化在 IOC `logic`/`mbbiDirect` record 中 | | **高频率 PV 计算导致 Client CPU 过载** | JavaScript 引擎或 Python GIL 无法并行处理数千 PV 的毫秒级更新 | 启用 CSS 的 `Update Rate` 限流；对非关键 PV 使用 `On Change` 而非 `100ms`；聚合 PV（如 waveform）减少事件数 | | **Client 计算结果未持久化** | 内存计算值随 Client 退出丢失 | 将关键结果 `caput` 到 IOC 的 `waveform` 或 `subArray` record，启用 autosave | | **跨平台编码/时区不一致** | Client JVM/Python locale 与 IOC EPICS_HOST_ARCH 不匹配 | 统一使用 UTC 时间戳；字符串传输强制 UTF-8 编码；数值一律用 double/int，避免 string 解析 | --- ## 五、验证案例：CSS 实现双 PV 差值报警器 **需求**：当 `tank:level_a` 与 `tank:level_b` 差值超过 10cm 时，点亮红色 LED。 **步骤**： 1. IOC 端确保存在两个 `ai` record：`tank:level_a`, `tank:level_b` 2. CSS OPI 中添加 `LED` 控件 3. 设置 `Value Expression`： ```javascript Math.abs(${tank:level_a} - ${tank:level_b}) > 10 ? 1 : 0 ``` 4. 设置 `Color` 属性：`True Color=red`, `False Color=green` **效果**：无需修改 IOC 一行代码，Client 端实时完成差值计算与状态判定，完全满足功能需求 [ref_1]。