Arduino PLC IDE入门：用五种工业语言实现计数器

1. 项目概述：当Arduino遇见工业标准

如果你是从Arduino IDE玩过来的开发者，第一次打开Arduino PLC IDE，可能会有点懵。左边是熟悉的项目树，右边却多了些“梯形图”、“功能块”的标签页，这感觉就像习惯了开手动挡轿车，突然坐进了挖掘机的驾驶室——工具更专业了，能干重活了，但操作逻辑完全不同。这个项目，就是带你从零开始，用工业自动化领域通行的IEC-61131-3标准下的五种编程语言，在Arduino Opta或Portenta Machine Control这样的工业级硬件上，实现一个最基础的计数器功能。核心目标不是让你成为PLC编程专家，而是帮你打通“单片机思维”到“工控编程思维”的任督二脉，理解如何在同一个项目里，让C语言风格的ST（结构化文本）和图形化的梯形图协同工作。

为什么这件事有价值？在传统的工业控制柜里，你可能需要为逻辑控制写梯形图，为复杂的流程写SFC（顺序功能图），为算法写ST。过去，这些往往在不同的软件甚至不同的控制器里完成。而Arduino PLC IDE试图把这些整合到一个面向Arduino硬件的环境中，让开发者，尤其是那些有嵌入式背景但想进入工控领域的朋友，能用一套熟悉的硬件平台，接触并掌握工业界的标准语言。这就像给你一套乐高，但说明书同时提供了步骤图、零件清单和3D建模软件文件，让你能从不同维度理解同一个作品。

2. 环境准备与核心概念解析

2.1 硬件选型与固件分区

工欲善其事，必先利其器。这个项目支持Arduino Opta系列（Lite, RS485, WiFi）和Portenta Machine Control。选择哪一款？如果你的应用场景只是本地逻辑控制，Opta Lite就足够了；如果需要连接多个设备组成网络，Opta RS485是首选；若要求无线监控或数据上报，那就选Opta WiFi。Portenta Machine Control则面向更复杂的机器控制，集成了更多工业接口。我手头用的是一台Opta WiFi，因为它兼顾了有线连接的稳定性和无线调试的便利性。

注意：无论你用的是全新的设备，还是之前用Arduino IDE玩过的旧设备，第一步都必须进行“内存分区”。这是很多新手容易忽略，然后导致PLC IDE无法下载程序或运行异常的关键一步。

为什么需要分区？传统的Arduino IDE将整个闪存视为一个统一的编程空间。而PLC IDE基于一个实时操作系统（RTOS）运行，它需要将闪存划分为不同的区域：一部分存放PLC运行时（Runtime）系统，一部分存放你的IEC-61131-3程序，还有一部分可能用于文件系统。不进行分区，硬件就不知道如何正确引导和运行PLC环境。操作很简单：在PLC IDE中，找到“Tools” -> “Partitioning Opta/Portenta Machine Control”，按照向导操作即可。这个过程会擦除闪存，所以请提前备份好原有程序。

2.2 PLC IDE界面初探与手册使用

打开Arduino PLC IDE，界面布局和传统的Arduino IDE差异很大。左侧是“项目资源管理器”，你的程序、变量、任务都在这棵树里。中间是编辑区域，会根据你打开的语言类型（如梯形图、ST）变化。右侧通常是“库树”或“工具箱”，存放着可拖拽的功能块。下方则可能有“监视”、“输出”等窗口。

一个极其重要但容易被忽视的宝藏是内置用户手册。你可以在顶部菜单栏点击“Help” -> “Index”打开它。我强烈建议你在开始编程前，花15分钟浏览一下手册的目录。它详细解释了项目管理、每种语言的语法、调试工具的使用。很多操作疑问，比如“如何给功能块添加一个输入引脚？”或者“任务周期怎么配置？”，都能在里面找到答案。把它当成随时可查的说明书，而不是事后补救的故障指南。

2.3 理解IEC-61131-3的编程范式

IEC-61131-3标准定义了五种语言，它们不是互斥的，而是可以混合使用的工具。理解这一点至关重要。

1. 结构化文本（ST）： 语法类似Pascal或C，适合编写复杂的算法、数学计算和数据处理。如果你有C语言基础，上手最快的就是它。
2. 指令表（IL）： 类似汇编语言，是一种低级、基于指令的文本语言。现在直接用的比较少，但理解它有助于读懂一些老设备程序或深入理解PLC执行原理。
3. 梯形图（LD）： 源自继电器控制电路图，用触点和线圈的串联/并联来表示逻辑关系。它最直观，非常适合描述开关量逻辑（比如“当按钮A按下且传感器B未触发，则启动电机C”）。
4. 功能块图（FBD）： 用图形化的“块”和连接线来表示信号或数据的流向。每个块代表一个函数（如AND, ADD, TIMER）。它适合描述数据流和控制流程，在过程控制中常用。
5. 顺序功能图（SFC）： 类似于流程图，用于描述程序执行的顺序和步骤。它把程序分解为一系列的“步”和“转换”，非常适合编写复杂的顺序控制或状态机程序。

这五种语言可以在同一个项目中并存。一个SFC的“步”里可以调用一个用ST写的动作；一个FBD网络里可以嵌入一个LD程序段。它们通过“变量”进行通信。这就是PLC编程的模块化思想：用最合适的语言做最合适的事。

3. 项目实战：从Arduino Sketch到五种语言

我们的目标是将一个简单的Arduino计数器Sketch，用五种语言分别实现。原始Sketch逻辑很简单：一个全局变量counter，在每个循环（loop）中递增1。

// Arduino Sketch 示例 int counter = 0; void setup() { // 初始化代码 } void loop() { counter = counter + 1; delay(100); // 模拟一个周期 }

3.1 变量声明：全局与局部的舞台

在PLC IDE中，变量是程序间通信的桥梁。首先要分清全局变量和局部变量。

• 全局变量： 在“Project”标签页下，双击Global_vars（全局变量表）。在这里声明的变量，项目中的所有程序（无论哪种语言）都能访问和修改。这类似于Arduino Sketch中在顶层定义的变量。右键点击表格，选择“Insert”即可添加。你需要定义“名称”（如gCounter）、“类型”（如INT表示整数）、“初始值”和“注释”。对于计数器，我们定义一个INT类型的gCounter，初始值为0。
• 局部变量： 当你双击打开一个具体的程序（比如一个ST程序）时，编辑器顶部会有一个“局部变量表”。这里声明的变量只在该程序内部有效。这有助于封装，避免命名冲突。

实操心得：良好的命名习惯能省去大量调试时间。我习惯全局变量加g_前缀（如g_Counter），局部变量则根据功能命名（如stepTimer）。对于BOOL（布尔）类型，可以用b前缀。在团队协作或项目复杂后，这套约定会让你感激自己。

3.2 任务配置：程序执行的节拍器

在Arduino IDE里，你只有一个loop()。在PLC IDE里，你有多个“任务”，这让你能更精细地控制程序执行。

• INIT： 初始化任务，仅在上电或启动时执行一次。适合放硬件初始化、参数预加载的代码。
• FAST： 快速循环任务，默认每10ms执行一次。这个周期是可以配置的。适合放需要快速响应的逻辑，如高速计数、紧急停止。
• SLOW： 慢速循环任务，固定每100ms执行一次。适合放主控制逻辑、常规扫描。
• BACKGROUND： 后台任务，固定每500ms执行一次。适合放通信处理、非实时性计算等。

如何分配程序？在“Project”标签页，找到“Tasks”。你可以直接将编写好的程序从项目树拖拽到相应的任务（如SLOW）下。一个任务下可以挂载多个程序，它们将按照在任务列表中的从上到下的顺序依次执行。

注意事项：默认情况下，新建的MAIN程序会被挂在FAST任务下。如果你写了一个复杂的ST算法，执行一次需要15ms，而FAST任务周期是10ms，那就会导致任务超时，可能引发看门狗复位或系统不稳定。务必根据程序的实际执行时间，合理选择任务和配置周期。右键点击任务（如FAST），选择“Task configuration”，即可修改其循环时间。

3.3 核心实现：五语言编写计数器

现在，我们为每种语言创建一个新程序。在“Project”菜单选择“New object” -> “New program”，命名（如Counter_ST），并选择对应语言。

3.3.1 结构化文本（ST）实现

ST的实现最直接，几乎和C语言一样。创建一个ST程序，在局部变量表声明一个INT类型的localCounter（或者直接使用全局变量gCounter）。在代码编辑区写入：

// ST程序代码 localCounter := localCounter + 1; // 注意赋值符号是 := ，不是 = // 或者使用全局变量 gCounter := gCounter + 1;

关键点：ST中的赋值运算符是:=，相等比较是=。这是从Pascal语言沿袭来的，和C语言的=与==不同，刚开始很容易写错。

3.3.2 梯形图（LD）实现

梯形图的核心思想是“能流”。从左边的“电源线”开始，经过一系列触点（条件），如果通路形成，则右边的线圈（输出）得电。

1. 从右侧“Library Tree”中，拖拽一个“ADD”功能块到编辑网格。
2. ADD块默认有两个输入IN1、IN2和一个输出OUT。我们需要实现counter = counter + 1。
3. 我们需要一个“自保持”的路径。通常，我们会用一个常闭触点（代表“总是导通”）作为起始条件。从库中拖拽一个“常开触点”（代表TRUE）放在ADD块左侧。
4. 连接：将gCounter变量连接到ADD块的IN1，将一个常数1（从库中拖拽“常数”块并设置为1）连接到IN2。将ADD块的OUT输出，连接回gCounter变量。
5. 但这样每个扫描周期都会加1，太快了。我们需要一个沿触发。更常见的做法是配合一个自身触点和一个上升沿检测块来构成一个每次扫描只加一次的回路，但在简单演示中，我们可以利用任务周期（如SLOW任务的100ms）来控制速度。一个更接近工业实践的计数器会使用“递增计数器”功能块（CTU），直接从库中搜索并拖拽CTU块，设置其CU端为TRUE，PV（预设值）为一个很大的数，CV（当前值）输出连接到gCounter即可。

避坑技巧：在图形化语言中连接变量时，确保数据类型匹配。试图将一个INT输出连接到BOOL输入，IDE通常会报错或显示连接线为虚线。养成连接后检查连线状态的习惯。

3.3.3 功能块图（FBD）实现

FBD和LD在思路上有相似之处，但更侧重于数据流。

1. 拖拽一个“ADD”功能块到画布。
2. 拖拽两个“变量”块（或直接从项目树拖拽全局变量gCounter和一个常数1）。
3. 将gCounter变量块连接到ADD的IN1，常数1连接到IN2。
4. 将ADD的OUT输出连接到另一个“变量”块，并将其关联到gCounter（这代表写入）。这里会出现一个“反馈”回路，PLC IDE通常能处理这种简单的代数环。但更严谨的做法是使用一个“D触发器”或“寄存器”块，在时钟边沿将新值锁存到gCounter，避免在一个扫描周期内同时读写同一变量可能引发的逻辑歧义。

3.3.4 顺序功能图（SFC）实现

SFC适合描述过程。我们的计数器过程很简单：初始步 -> 执行计数 -> 判断（总是真）-> 跳回计数步，构成循环。

1. 创建一个SFC程序。初始会有一个“初始步”（STEP0）和一个“转换”（TRANS0）。
2. 我们需要一个“动作”来执行计数。右键点击SFC程序节点，选择“New action”。新建一个动作，命名为Act_Count，语言选择ST。在这个ST动作里写入gCounter := gCounter + 1;。
3. 回到SFC编辑器。初始步（STEP0）通常用于初始化。我们右键画布，插入一个新的“步”（Step），命名为Step_Count。
4. 右键点击Step_Count，选择“关联动作”，将Act_Count关联上去。这样，当程序执行到这一步时，就会调用这个ST动作。
5. 从Step_Count引出一个“转换”（Transition）。在转换的条件里，可以写TRUE（或1），表示无条件通过。
6. 从这个转换，我们需要跳转回Step_Count以形成循环。使用“跳转”（Jump）功能，指向Step_Count。同时，也需要从初始转换连接到Step_Count作为入口。

3.3.5 指令表（IL）实现

IL是一种底层语言，这里简单展示其样貌。创建一个IL程序，代码大致如下：

LD gCounter // 将gCounter的值加载到累加器 ADD 1 // 累加器值加1 ST gCounter // 将累加器结果存回gCounter

这非常类似于汇编语言，LD是加载，ADD是加，ST是存储。对于现代编程，除非维护老旧系统，否则直接使用IL的场景很少。

4. 调试与监视：让程序运行可视化

程序写完了，怎么知道它跑得对不对？PLC IDE提供了强大的在线监视功能。

4.1 变量监视窗口

点击“View” -> “Tool windows” -> “Watch”，打开监视窗口。你可以直接从项目树的“Global_vars”或程序内的局部变量表中，将变量（如gCounter）拖拽到这个窗口。下载并运行程序到硬件后，这个窗口就会实时显示变量的当前值。你会看到gCounter的值每隔一个任务周期（例如SLOW任务的100ms）就增加1。

4.2 程序调试与状态查看

对于图形化语言（LD, FBD, SFC），在在线状态下，通过的“能流”或活动的“步”会高亮显示（通常是蓝色）。你可以清晰地看到程序的执行路径。对于SFC，当前激活的“步”会变色，让你直观地跟踪流程走到了哪一步。这是图形化语言调试的巨大优势。

4.3 库管理：扩展功能

PLC IDE的库管理与Arduino IDE不同。它更结构化。你需要手动添加库的精确名称和版本。

1. 点击“Resources”标签页，在“Sketch”下找到“Libraries”。
2. 点击“Add”，输入库名（例如Arduino_MachineControl）和所需版本（例如1.1.1）。
3. 版本信息可以从Arduino Library Reference网站查询，或者如果你在Arduino IDE里已经安装了该库，可以在本地库文件夹的library.properties文件中找到。

常见问题：添加库后编译报错“找不到库”？首先检查库名和版本号是否完全正确，包括大小写。其次，PLC IDE目前主要支持官方或广泛认可的公开库。一些非常个人化或未发布的库可能无法添加。确保你的库是兼容Arduino PLC IDE运行时的。

5. 进阶技巧与避坑指南

5.1 变量作用域与冲突解决

当你在多个程序里使用同名变量时，作用域规则是：局部变量优先于全局变量。但最佳实践是避免命名冲突。如果你在一个ST程序里声明了localCounter，又在另一个FBD程序里试图直接使用localCounter，这是不允许的，因为它是局部的。跨程序通信必须通过全局变量，或者通过程序的输入输出参数（类似于调用函数传参）来实现。

5.2 图形化编程的“代数环”问题

在FBD或LD中，如果你直接将一个功能块的输出连接回它自己的输入（就像我们之前设想的gCounter直接反馈到ADD的输入），会形成一个“代数环”。PLC的扫描周期是顺序执行的，理论上需要知道gCounter的新值才能计算gCounter+1，但新值又依赖于本次计算。大多数PLC系统（包括Arduino PLC IDE）的编译器或运行时会检测并处理这种简单环，但对于复杂环，可能导致无法编译或逻辑错误。

解决方案：引入一个扫描周期的延迟。使用一个“寄存器”或“延迟块”。将ADD的结果先存到一个中间变量Temp，然后在下一个扫描周期，再将Temp赋值给gCounter。或者，直接使用系统提供的“计数器”功能块（CTU），它内部已经处理好了时序逻辑。

5.3 任务周期与执行时间的权衡

这是工业PLC编程的核心考量。不要把所有程序都扔进FAST任务。周期越短的任务，对程序执行时间的要求越苛刻。你需要估算或实际测量每个程序的执行时间。

• 测量方法：可以在程序开始和结束处，读取一个高精度计时器的值，计算差值，并通过全局变量在监视窗口查看。
• 经验法则：一个任务的循环周期，应该至少是该任务下所有程序最坏情况执行时间总和的2-3倍。为系统留出处理中断、通信等后台事务的时间。
• 优化：如果某个ST程序计算量太大，考虑将其拆分，非实时部分移到SLOW或BACKGROUND任务；或者优化算法。

5.4 从Sketch到PLC程序的思维转换

最大的思维转换是从“顺序执行+延迟”到“循环扫描+任务调度”。

• Arduino Sketch：loop()函数从头跑到尾，遇到delay()就真的停下来等待。程序状态管理通常靠全局变量和millis()。
• PLC程序： 每个任务周期性地、从头到尾地执行其下的所有程序。没有delay()函数。如果你想让某个动作持续2秒，你需要使用“定时器”功能块（TON），并检查其输出。状态管理更适合用SFC或专门的标志位序列来实现。

例如，实现一个“按下按钮后灯亮2秒”的功能：

• Sketch思维：在loop里检测按钮按下，然后digitalWrite(HIGH); delay(2000); digitalWrite(LOW);。这会阻塞整个循环。
• PLC思维：在FAST任务中用一个LD或FBD网络。使用一个上升沿检测块触发一个TON定时器块，定时器设置PT=2s。灯的线圈由定时器的Q输出直接控制。整个逻辑在一个扫描周期内完成判断，不阻塞其他任何程序的执行。

掌握这种“非阻塞”、“基于状态和扫描”的编程思维，才是玩转工业PLC的核心。通过这个简单的计数器项目，你不仅学会了五种语言的语法，更重要的是迈出了理解这种工业控制范式第一步。接下来，尝试用SFC做一个三色灯流水灯，用FBD实现一个简单的PID温度控制模拟，把图形化和文本语言混合使用，你会对Arduino PLC IDE的强大和工业编程的乐趣有更深体会。