CODESYS V3项目实战：从传送带分拣案例掌握PLC工程化编程

1. 从“Hello World”到项目实战：CODESYS V3编程进阶之路

上次我们聊了CODESYS V3的基础安装和界面，算是把厨房和锅碗瓢盆都准备好了。今天，咱们直接开火，炒几个硬菜。很多朋友学PLC编程，卡就卡在从“点动一个灯”到“完成一个正经项目”的这一步。中间好像隔着一片海，看着教程里的单个功能都懂，但一上手做综合项目就懵，变量乱飞，程序逻辑缠成一团毛线。这一篇，我就以一个经典的“传送带物料分拣站”模拟项目为蓝本，手把手带你走完从零搭建一个完整PLC应用程序的全过程。你会看到，一个清晰的项目是如何从无到有构建起来的，那些在单个教程里不会讲的项目架构思维、变量管理技巧和调试心法，才是真正让你从“会写代码”到“能做好项目”的关键。

2. 项目蓝图：如何为“传送带分拣站”设计PLC程序结构

在动手写第一行代码之前，我们必须先把项目的“图纸”画好。这个分拣站的功能很简单：一条主传送带运行，传感器检测到物料到达，根据预设的颜色（用另一个传感器模拟）将物料推入对应的料槽。但简单功能背后，需要严谨的结构来支撑。

2.1 功能分解与变量规划

首先，别急着在CODESYS里声明变量。拿张纸或打开思维导图，把整个系统拆解成几个独立的功能块：

1. 传送带电机控制：启停、速度设定、故障反馈。
2. 物料检测与识别：到位传感器、颜色传感器信号处理。
3. 推杆执行机构控制：对应不同料槽的推杆，动作包括伸出、缩回、到位检测。
4. 主控逻辑：协调以上所有部分，处理联锁和安全逻辑。
5. 人机界面（HMI）接口：提供手动/自动模式切换、状态显示、计数复位等按钮和显示区。

分解之后，变量的规划就清晰了。我强烈建议你建立一套自己的变量命名规范。比如，我习惯用匈牙利命名法的变体：

• b前缀表示布尔型（BOOL），如bStartBtn（启动按钮）、bMotorRunning（电机运行）。
• n前缀表示整数型（INT, DINT），如nBoxCount_A（A槽计数）。
• r前缀表示实数型（REAL），如rConveyorSpeed（传送带速度）。
• t前缀表示时间型（TIME），如tPushDelay（推杆动作延时）。
• s前缀表示字符串型（STRING），如sSystemMode（系统模式显示）。

更重要的是变量分组。在CODESYS的“设备”树中，在“应用程序”下创建多个“全局变量列表”（GVL），例如GVL_Motor、GVL_Sensor、GVL_Cylinder、GVL_HMI。把相关的变量声明在对应的列表里。这样做的好处是，当你需要修改电机相关参数时，不需要在几百个变量里翻找，直接打开GVL_Motor就行，极大提升了开发和维护效率。

2.2 程序组织单元（POU）的架构设计

CODESYS中的程序、功能块（FB）、函数（FC）统称为POU。好的架构能让逻辑一目了然。

• 主程序（MAIN）：只做调度，不做具体逻辑。它就像一个公司的总经理，只负责调用各个部门经理（功能块）。它的任务周期性地调用FB_ConveyorControl、FB_SensorProcessing、FB_SorterLogic等。
• 功能块（FB）：封装具有状态的功能单元。这是面向对象思想在PLC编程中的核心体现。例如，为推杆创建一个FB_Cylinder功能块，内部封装了伸出、缩回命令，以及前限、后限传感器信号，并包含互锁和超时报警逻辑。这个FB实例化后，可以生成Cylinder_A、Cylinder_B等多个实例，它们内部逻辑一致但数据独立，避免了重复编写相似代码。
• 函数（FC）：封装纯计算或转换逻辑，无内部状态。例如，创建一个FC_ScaleAnalogInput函数，专门用于将模拟量输入通道的原始整数值（如0-27648）转换为工程值（如0.0-10.0 m/s）。

对于我们的分拣站，我会设计以下核心POU：

1. FB_ConveyorControl：管理传送带启停、速度斜坡、急停处理。
2. FB_ColorSensor：处理颜色传感器信号，包含去抖动和信号有效性判断。
3. FB_Cylinder：通用的气缸控制块，带命令互锁、动作超时报警。
4. FB_SorterMainLogic：核心分拣逻辑，根据传感器信号和模式，协调推杆动作。
5. PRG_MAIN：主程序，实例化上述FB并顺序调用。

注意：在FB_Cylinder内部，一定要做命令互锁，即“伸出”和“缩回”命令不能同时为真，通常用互锁逻辑或使用S/R指令实现。这是防止机械机构因电气误动作而损坏的基本安全设计。

3. 核心功能块深度实现与梯形图/ST语言混合编程

CODESYS支持IEC 61131-3标准的五种语言。在实际项目中，混合编程是常态，用最适合的语言做最适合的事。

3.1 用结构化文本（ST）实现复杂逻辑功能块

FB_SorterMainLogic适合用ST语言编写，因为它逻辑条件较多，用ST更清晰。

METHOD Execute : BOOL VAR_INPUT bAutoMode : BOOL; // 自动模式 bItemPresent : BOOL; // 物料到位 eDetectedColor : E_Color; // 检测到的颜色枚举 bCylinderAReady, bCylinderBReady : BOOL; // 推杆就绪 END_VAR VAR_OUTPUT bCylinderA_Extend, bCylinderB_Extend : BOOL; // 推杆命令 nCountA, nCountB : UINT; // 计数 END_VAR VAR eCurrentState : E_SorterState := IDLE; tProcessingTimer : TON; // 处理计时器 END_VAR CASE eCurrentState OF IDLE: IF bAutoMode AND bItemPresent THEN eCurrentState := PROCESSING; tProcessingTimer(IN:=TRUE, PT:=T#500ms); // 开始500ms处理延时 END_IF PROCESSING: tProcessingTimer(IN:=TRUE); IF tProcessingTimer.Q THEN // 延时到 CASE eDetectedColor OF COLOR_RED: IF bCylinderAReady THEN bCylinderA_Extend := TRUE; nCountA := nCountA + 1; eCurrentState := WAIT_CYLINDER_RETRACT; END_IF COLOR_BLUE: IF bCylinderBReady THEN bCylinderB_Extend := TRUE; nCountB := nCountB + 1; eCurrentState := WAIT_CYLINDER_RETRACT; END_IF ELSE: // 未知颜色，不动作 eCurrentState := IDLE; END_CASE tProcessingTimer(IN:=FALSE); // 复位计时器 END_IF WAIT_CYLINDER_RETRACT: // 等待推杆缩回（通过FB_Cylinder的状态反馈判断） IF NOT bCylinderA_Extend AND NOT bCylinderB_Extend THEN eCurrentState := IDLE; END_IF END_CASE

这段ST代码定义了一个简单的状态机。使用状态机是处理顺序逻辑的黄金法则，它让程序流程一目了然，避免了复杂的标志位嵌套，调试时通过观察eCurrentState变量就能立刻知道程序卡在哪一步。

3.2 用梯形图（LD）实现直观的电机控制逻辑

对于FB_ConveyorControl中的电机启停、互锁、故障复位等逻辑，梯形图因其直观性仍是首选。在CODESYS中，你可以在一个FB里用ST写核心算法，同时用梯形图编辑其内部的一个“方法”或直接组织调用关系。

例如，在FB_ConveyorControl内部，可以创建一个LD_MotorControl的方法（Method），用梯形图实现：

[ bStart bStop bFaultReset bOverload ] [---] [--------]/[------------] [-----------]/[------( ) bMotorRunCmd ] [ ] [ bMotorRunCmd ] [---] [------------------------------------------------( ) Motor.Contactor ]

这张图清晰地显示了启动、停止、故障复位和过载保护的连锁关系。在CODESYS中，你可以将Motor.Contactor关联到一个具体的输出变量或另一个功能块的输入。

3.3 自定义功能块FB_Cylinder的封装艺术

这是展示CODESYS面向对象能力的最佳例子。我们创建一个标准气缸FB。

FUNCTION_BLOCK FB_Cylinder VAR_INPUT bExtend : BOOL; // 伸出命令 bRetract : BOOL; // 缩回命令 bExtendedLS : BOOL; // 伸出限位 bRetractedLS : BOOL; // 缩回限位 tTimeout : TIME := T#2s; // 动作超时时间 END_VAR VAR_OUTPUT bIsExtended : BOOL; // 已伸出状态 bIsRetracted : BOOL; // 已缩回状态 bBusy : BOOL; // 忙状态 bError : BOOL; // 错误状态 sErrorMsg : STRING(80); // 错误信息 END_VAR VAR fbTimerExtend : TON; fbTimerRetract : TON; eInternalState : E_CylinderState; END_VAR

在FB主体中，实现状态逻辑和互锁。关键点在于：在内部处理命令的冲突。例如，当bExtend和bRetract同时为真时，应优先执行停止或安全状态，并置位错误标志。同时，利用TON定时器判断动作是否超时。这样，在主逻辑中调用这个FB时，只需要给命令和读取状态，无需关心其内部复杂的定时和互锁，实现了完美的封装。

4. 可视化、调试与模拟：让程序“活”起来

程序写完了，不等于项目完成了。调试和验证占整个开发周期一半以上的时间。CODESYS提供的工具能极大提升这个阶段的效率。

4.1 使用可视化编辑器创建简易HMI进行调试

即使项目最终会用威纶通、西门子触摸屏，在调试阶段，在CODESYS内部创建一个简单的可视化界面是最高效的。在“设备”树中添加“可视化管理器”，新建一个画面。

1. 拖拽控件：从工具箱拖入按钮、指示灯、输入框、条形图等。
2. 绑定变量：这是关键。右键点击“启动”按钮，选择“属性”-“事件”-“按下”，在“添加分配”中链接到GVL_HMI.bStartBtn变量。同样，将指示灯的“颜色”属性链接到GVL_Motor.bMotorRunning。这样，你就实现了一个无需硬件触摸屏的监控界面。
3. 模拟运行：在“在线”菜单下，选择“模拟”（Simulation）或“启动PLC仿真”（如果安装了CODESYS Control Win V3）。你的程序将在你的电脑上以软PLC方式运行。你可以在可视化界面上点击按钮，观察指示灯的变化，同时可以在“监视”窗口中查看所有变量的实时值。

4.2 断点、单步与变量监视的进阶技巧

对于复杂逻辑，光看最终结果不够，需要像调试C语言一样深入程序内部。

• 设置断点：在ST或LD编辑器的行号左侧点击，设置一个断点。当程序运行到这一行时，会暂停。你可以查看此时所有变量的快照。
• 单步执行：程序暂停后，使用“单步进入”、“单步跳过”按钮，一行一行地执行程序，观察逻辑流向和变量变化。这对于调试状态机、排查条件分支错误极其有效。
• 变量监视与强制：在“监视”表格中，添加你关心的变量。你可以实时看到它们的值。在调试时，你可以临时“强制”某个输入变量的值（比如强制一个传感器为TRUE），来测试程序的反应。但要千万小心：强制功能非常强大，在连接真实硬件时，错误的强制可能导致设备意外动作，务必在安全条件下进行。

4.3 利用“轨迹”功能记录变量历史

有些问题不是静态的，而是动态发生的。比如，一个偶发的故障可能由几个变量在特定时序下共同触发。这时，“轨迹”功能就派上用场了。

1. 在“在线”菜单下打开“轨迹”窗口。
2. 添加需要记录的变量，如bItemPresent、eDetectedColor、bCylinderA_Extend。
3. 设置触发条件，例如当bError从 FALSE 变为 TRUE 时开始记录触发前后的数据。
4. 运行程序，当错误发生时，轨迹会自动记录下相关变量在时间轴上的变化，形成一张波形图。通过分析这张图，你可以像破案一样，精准定位到是哪个信号先异常，从而找到根本原因。这是解决复杂时序问题的终极利器。

5. 项目编译、下载与真实硬件连接要点

模拟调试无误后，就要准备连接真实的PLC硬件了。这是从虚拟走向现实的关键一步，坑也最多。

5.1 设备描述与硬件配置

在CODESYS中，你需要精确告诉软件，你连接的是什么PLC。

1. 添加设备：在“设备”树中，右键“设备”，选择“添加设备”。如果你的PLC是倍福（Beckhoff）的CX系列，就选择对应的“TwinCAT PLC”设备；如果是汇川、雷赛等支持CODESYS Runtime的国产PLC，通常需要先安装设备描述文件（.device文件），然后从“其他设备”或供应商特定分类中找到它。
2. 配置硬件：添加设备后，会生成一个代表PLC的节点。在其下添加“硬件”，这对应于PLC的背板和模块。你需要根据实际的硬件排列，依次添加CPU、电源模块、数字量输入/输出模块、模拟量模块等。每个模块都需要设置正确的参数，比如DI模块的滤波时间，AI模块的量程和工程单位。这里的配置必须与物理硬件完全一致，否则会导致I/O点错乱，这是最常见的下载后无反应的问题根源。

5.2 编译与下载前的终极检查

点击“编译”按钮（F11），CODESYS会检查所有语法和配置错误。确保输出窗口显示“0个错误，0个警告”（有时警告可以忽略，但最好逐一审查）。 在下载前，做最后一遍检查：

1. 变量地址映射：确认所有直接控制硬件的变量（如%IX0.0,%QX0.1）或通过“PLC_PRG”关联的变量，其物理地址是否正确。在硬件配置中，每个模块的通道都有默认的地址分配，务必核对。
2. 任务配置：检查“设备”下的“任务配置”。这里定义了程序循环执行的周期。通常主程序（MAIN）被关联到一个循环任务上，周期设置为20ms、50ms等。周期太短可能CPU负载过高，太长则响应慢。根据控制要求合理设置。
3. 启动模式：在PLC的属性中，设置下载后的启动模式，通常是“暖启动”或“运行”。

5.3 连接、下载与在线调试

1. 物理连接：通过网线将电脑与PLC的以太网口连接。确保电脑IP与PLC IP在同一网段。PLC的默认IP通常在设备手册中写明。
2. 设置通信路径：在CODESYS的“在线”菜单，“通信设置”中，选择正确的网卡，并输入PLC的IP地址。点击“登录”。
3. 下载：登录成功后，点击“下载”按钮（Ctrl+F7）。软件会将编译后的程序、硬件配置等信息全部传输到PLC中。
4. 切换运行模式：下载完成后，PLC通常处于“停止”状态。需要在软件中将其切换到“运行”模式。此时，你的程序就开始在真实的PLC中执行了。

踩坑实录：第一次连接硬件，最常见的现象是“变量无反应”。别慌，按这个顺序排查：① 电脑和PLC的IP地址是否在同一子网，防火墙是否关闭？② CODESYS中设置的PLC型号和IP地址是否正确？③ 硬件配置中的模块型号、顺序是否与实际完全一致？④ 程序中使用的I/O地址，是否与硬件配置中模块的起始地址匹配？⑤ PLC本身的运行/停止开关是否拨到了运行位？一步步下来，99%的问题都能解决。

6. 从项目实践中提炼的工程化思维与习惯

完成一个项目后，收获的不仅仅是代码，更是一套工程方法。分享几个让我受益匪浅的习惯：

第一，版本管理。CODESYS项目文件夹可以用Git进行版本控制。每次实现一个稳定功能后就提交一次，写清楚注释。当某次修改导致系统崩溃时，你能轻松回退到上一个稳定版本，而不是从头开始。

第二，文档即注释。在程序开头，用注释写明项目名称、作者、修改日期、主要功能。在每个重要的功能块前，用注释说明其功能、输入输出参数的含义、重要的逻辑约束。三个月后，你自己也会感谢当初写了注释的自己。

第三，标准化与复用。像FB_Cylinder这样的功能块，经过充分测试后，就可以放入你自己的“标准库”中。下一个项目遇到气缸控制，直接拖过来实例化即可，大幅提升开发效率和质量一致性。

第四，测试用例思维。对于核心逻辑块，在脑海里或纸上设计测试用例：正常流程、传感器故障、命令冲突、电源抖动等情况，程序应该如何反应？在模拟阶段就主动去测试这些边界情况，能提前发现很多潜在隐患。

通过这个完整的“传送带分拣站”项目演练，我希望你掌握的不仅仅是CODESYS的某个按钮怎么点，而是如何像一个真正的工程师那样去思考、设计和实现一个PLC控制系统。从顶层的项目分解，到中层的模块封装，再到底层的语言选择和调试技巧，这是一条环环相扣的链条。编程本身并不难，难的是构建清晰、健壮、可维护的系统架构。这套方法论，适用于从简单的单机设备到复杂的生产线控制。当你下次面对一个新的控制任务时，试着先抛开软件，拿起笔，从画下第一个功能方块图开始。