4. 功能块的接口设计

功能块（Function Block, FB）是PLC结构化编程的核心载体，而接口则是功能块与外部世界交互的唯一通道。接口设计的好坏，直接决定了功能块的可读性、可维护性、可复用性和可测试性。一个接口混乱的功能块，即使内部逻辑再精巧，也会因为调用者难以理解而沦为“一次性代码”。本章将深入剖析功能块三类接口参数（输入、输出、InOut）的本质区别与适用场景，并给出设计清晰、可复用接口的系统方法论。

4.1 三类接口参数的本质区别与选型依据

核心原理：PLC功能块的接口参数在IEC 61131-3标准中分为三类——VAR_INPUT（输入）、VAR_OUTPUT（输出）、VAR_IN_OUT（输入输出）。这三类参数在数据传递方式、内存占用、适用场景上存在本质差异。输入参数以值传递方式传入，功能块内部对参数的修改不会影响调用者变量；输出参数由功能块内部赋值，调用者读取结果；而InOut参数则以引用（指针）方式传递，功能块内部对该参数的读写操作会直接作用于调用者的原始变量。

选型判断方法：在实际工程中，可以依据以下决策路径进行选择：

• 纯数据输入（如设定值、使能信号、模式选择）→ 使用VAR_INPUT，保证数据安全隔离。
• 纯结果输出（如状态标志、测量值、报警代码）→ 使用VAR_OUTPUT，调用者按需读取。
• 需要修改调用者数据（如累计值累加、数组元素批量处理、结构体字段更新）→ 使用VAR_IN_OUT。
• 大型数据块传递（如配方结构体、数据日志数组）→ 优先考虑VAR_IN_OUT，避免栈空间浪费和拷贝开销。

4.2 输入参数的设计规范与实战案例

核心原理：输入参数是功能块的“控制面板”，决定了功能块的行为模式。优秀的输入设计应当遵循“最小充分原则”——只暴露调用者真正需要控制的变量，将内部计算所需的中间量封装在FB内部。同时，输入参数应具备明确的语义命名和合理的默认值，降低调用者的使用门槛。

设计操作流程：

1. 识别外部控制需求：分析调用者需要哪些信息来驱动该功能块。例如，一个电机控制FB，调用者需要给定启动/停止命令、速度设定值、加减速时间。
2. 定义数据类型：优先使用强类型（如枚举类型定义运行模式），避免使用无符号整数或BOOL组合表示多状态。
3. 设置默认值与范围检查：在FB内部对输入参数进行合理性检查（如速度不超过额定值），异常时输出诊断代码。
4. 分组与注释：在接口注释中按功能分组（如“命令”、“设定值”、“配置”），并标注单位、范围、默认值。

// 伺服定位功能块接口定义（ST语言）
FUNCTION_BLOCK FB_ServoPosition
VAR_INPUT
    eMoveMode   : ENUM_MoveMode;    // 运动模式：/相对/回原点
    rTargetPos  : REAL;             // 目标位置（mm）
    rVelocity   : REAL;             // 运行速度（mm/s），默认50
    bExecute    : BOOL;             // 上升沿触发启动
END_VAR
VAR_OUTPUT
    bDone       : BOOL;             // 定位完成
    bBusy       : BOOL;             // 正在运行
    bError      : BOOL;             // 错误标志
    wErrorCode  : WORD;             // 错误代码
END_VAR

4.3 输出参数的设计规范与状态机映射

核心原理：输出参数是功能块的“仪表盘”，向调用者报告执行结果和当前状态。设计输出参数时，要避免“裸数据”输出——即直接输出内部寄存器值或未经处理的原始信号。优秀的输出设计应当提供语义化的状态信息，并配合诊断代码帮助调用者快速定位问题。

状态输出设计方法：

• 主状态输出：使用枚举类型输出当前主状态（如IDLE/RUNNING/DONE/ERROR），调用者可通过CASE语句处理不同状态。
• 完成与错误标志：提供独立的bDone、bError布尔输出，便于调用者直接进行条件跳转。
• 诊断信息：输出wDiagCode（WORD类型），每一位或每个数值对应特定错误原因（如Bit0=过流、Bit1=过压、Bit2=通讯超时）。
• 过程值反馈：对于控制类FB，输出实际值（如实际位置、实际速度），便于调用者进行闭环监控。

4.4 InOut参数的深度应用与风险控制

核心原理：VAR_IN_OUT参数是PLC功能块中最强大也最容易被误用的接口类型。它以引用方式传递数据，功能块内部对该参数的读写操作直接作用于调用者的原始变量。这一特性使得InOut参数非常适合处理大型数据结构（如配方、数组、日志记录）和需要累积更新的变量（如总产量计数器）。

典型应用场景：

1. 结构体批量更新：将整个配方结构体作为InOut参数传入，FB内部修改多个字段后直接生效，无需逐个字段返回。
2. 数组元素处理：对数据数组进行排序、滤波、查找等操作，通过InOut参数直接修改原数组。
3. 累计器/积分器：累计值需要在多次调用间保持，使用InOut参数可避免使用静态变量（VAR）带来的作用域问题。
4. 多FB协作共享数据：多个功能块需要读写同一数据块时，通过InOut参数传递共享数据区。

// InOut参数使用示例
FUNCTION_BLOCK FB_TempControl
VAR_INPUT
    rSetpoint  : REAL;   // 目标温度
    rActual    : REAL;   // 实际温度
    bExecute   : BOOL;   // 执行使能
END_VAR
VAR_IN_OUT
    stRuntime  : ST_RunData;  // 运行数据（累计时间、超限次数）
END_VAR
VAR_OUTPUT
    rHeaterOut : REAL;   // 加热输出百分比
    bAlarm     : BOOL;   // 超温报警
END_VAR

4.5 接口设计模式与版本兼容策略

核心原理：优秀的接口设计不仅要满足当前需求，还要考虑未来的扩展和维护。采用“接口分层”和“参数分组”的设计模式，可以显著提高功能块的生命周期。同时，在PLC程序迭代过程中，接口变更不可避免，需要制定版本兼容策略。

接口设计模式：

• 参数分组模式：将功能块参数按“命令”、“设定值”、“状态反馈”、“诊断信息”分组，在接口注释中用分隔线标明，便于调用者快速定位。
• 配置与操作分离：将不常变化的配置参数（如设备地址、通讯波特率）与频繁操作的控制参数（如启停命令、设定值）分开。配置参数可通过独立的功能块或结构体传入。
• 默认值模式：为输入参数设置合理的默认值（如速度默认值、超时时间默认值），调用者只需修改需要变更的参数。
• 扩展预留模式：在输出参数中预留诊断字（如wDiagCode）和状态字（如wStatus），后续版本增加新功能时无需修改接口。

4.6 接口设计质量评估与重构方法

核心原理：接口设计质量可以通过量化指标进行评估。一个高质量的接口应当具备：参数数量适中（通常不超过7±2个）、语义清晰（无歧义命名）、类型安全（使用强类型）、无重复数据（同一数据不通过多个参数传递）、易于测试（可通过模拟输入验证输出）。

评估与重构流程：

1. 接口复杂度审计：统计每个功能块的参数总数、数据类型种类、InOut参数数量。若参数总数超过10个，或InOut参数超过3个，应触发重构评审。
2. 调用者反馈收集：检查调用代码中是否存在大量“仅为了满足接口而进行的赋值操作”（如将多个输出拼接到一个结构体）。若调用者需要编写大量胶水代码，说明接口设计不合理。
3. 重构操作：将相关参数合并为结构体、将配置参数移至独立FB、将重复数据改为InOut引用、将布尔组合改为枚举类型。
4. 回归测试：重构后必须进行功能验证，确保行为与重构前一致。建议使用PLC仿真器或测试台架进行自动化测试。