树莓派4B上OpenPLC环境搭建全流程（含常见问题解决方案）

在工业自动化领域，可编程逻辑控制器（PLC）是控制系统的核心大脑。然而，传统PLC设备往往价格不菲，且开发环境封闭，对于个人爱好者、教育机构或初创项目来说，门槛较高。有没有一种方式，既能体验标准的工业控制编程，又能享受开源硬件带来的低成本与灵活性呢？答案是肯定的。将开源PLC软件OpenPLC与树莓派4B这款性能强劲的单板计算机相结合，你就能亲手搭建一个功能完整、成本极低的工业控制实验平台。这不仅仅是简单的软件安装，更是一次从硬件选型、系统配置到编程调试的完整工程实践。无论你是自动化专业的学生，还是希望将想法快速原型化的工程师，或是热衷于家庭实验室的创客，这篇文章都将为你提供一条清晰、可落地的路径，并分享那些官方文档里可能不会提及的实战细节与“踩坑”经验。

1. 硬件准备与系统选择：为稳定运行打下基础

在开始刷写系统之前，正确的硬件准备是成功的第一步。树莓派4B虽然性能强大，但在作为工业控制运行时，其稳定性和可靠性需要我们从硬件层面给予更多关注。

首先，电源的选择至关重要。树莓派4B的官方建议是使用5V/3A的USB-C电源。许多不稳定问题，如随机重启、SD卡损坏，其根源都可能是电源功率不足或电压波动。我强烈建议使用官方电源或经过认证的优质品牌电源。一个简单的判断方法是，在树莓派满负荷运行时，使用vcgencmd get_throttled命令检查是否出现欠压警告。如果返回值不是throttled=0x0，就说明电源可能存在问题。

注意：切勿使用电脑USB口或劣质充电器为运行OpenPLC的树莓派供电，工业环境下的瞬时电流需求可能导致供电不足。

其次，关于存储介质。虽然8GB的MicroSD卡是官方最低要求，但考虑到系统日志、程序存储以及长期运行的磨损，我推荐使用至少16GB、Class 10或UHS-I及以上速度等级的高质量品牌SD卡。更进阶的选择是使用USB SSD启动树莓派，这将极大提升I/O性能和存储寿命，对于频繁读写程序的场景尤其有益。

操作系统镜像的选择同样影响后续步骤的顺畅度。树莓派OS Lite（无桌面环境）是最轻量、最稳定的选择，它将所有资源留给OpenPLC运行时。以下是获取和验证镜像的详细步骤：

  1. 下载镜像：访问树莓派官网下载页面，选择“Raspberry Pi OS (other)”，然后下载“Raspberry Pi OS Lite”的镜像文件。建议同时下载其对应的SHA-256校验文件，以确保下载完整。
    # 在Linux/macOS终端中，可以使用wget下载
wget https://downloads.raspberrypi.org/raspios_lite_armhf/images/raspios_lite_armhf-xxxx-xx-xx/xxxx-xx-xx-raspios-bullseye-armhf-lite.img.xz
wget https://downloads.raspberrypi.org/raspios_lite_armhf/images/raspios_lite_armhf-xxxx-xx-xx/xxxx-xx-xx-raspios-bullseye-armhf-lite.img.xz.sha256
  2. 验证完整性：在刷写前进行校验是好习惯。
    sha256sum -c xxxx-xx-xx-raspios-bullseye-armhf-lite.img.xz.sha256
  3. 刷写工具：BalenaEtcher因其跨平台和易用性被广泛推荐。但如果你习惯命令行，dd命令（Linux/macOS）或Win32 Disk Imager（Windows）也是可靠的选择。

完成刷写后，不要急于拔出SD卡。为了在无头（无显示器）模式下顺利启动并完成初始配置，我们需要在SD卡的boot分区预置一些配置文件。在刷写好的SD卡根目录（Windows下显示为名为boot的驱动器）创建两个文件：

  • ssh：一个空文件，用于启用SSH服务。
  • wpa_supplicant.conf：用于配置Wi-Fi网络（如果使用有线网络则无需此步骤）。
    ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=CN

network={
    ssid="你的Wi-Fi名称"
    psk="你的Wi-Fi密码"
    key_mgmt=WPA-PSK
}

至此，硬件和系统镜像的准备才算真正完成，这为后续OpenPLC的稳定运行铺平了道路。

2. OpenPLC Runtime 的编译安装与深度配置

将准备好的SD卡插入树莓派并上电，通过SSH连接到设备（默认用户名pi，密码raspberry）。连接成功后，第一步永远是更新系统，但这里有个小技巧：由于树莓派官方源在国内访问可能较慢，我们可以先更换为国内镜像源以加速下载。

编辑软件源配置文件：

sudo nano /etc/apt/sources.list

将文件中的 deb http://archive.raspberrypi.org/debian/ bullseye main 等行，替换为国内镜像地址，例如清华源：

deb http://mirrors.tuna.tsinghua.edu.cn/raspberrypi/ bullseye main

同时，编辑/etc/apt/sources.list.d/raspi.list文件进行类似修改。完成后，执行更新：

sudo apt update && sudo apt full-upgrade -y
sudo reboot

系统重启后，进入OpenPLC Runtime的安装环节。官方的一键安装脚本install.sh非常方便，但我们有必要了解其背后的过程，以便在出现问题时能够排查。

git clone https://github.com/thiagoralves/OpenPLC_v3.git
cd OpenPLC_v3
./install.sh rpi

这个install.sh脚本主要做了以下几件事：

  1. 安装编译依赖：包括build-essential、pkg-config、libssl-dev、python3等数十个软件包。
  2. 编译核心组件：
    • matiec：用于将IEC 61131-3标准编程语言（如ST、LD）编译成C代码。
    • glue：连接MatIEC编译器和硬件抽象层的粘合代码。
    • OpenPLC Runtime：核心运行时，负责调度周期、管理I/O、运行用户程序。
  3. 配置服务：将OpenPLC设置为系统服务（openplc.service），实现开机自启。

安装过程可能需要15-30分钟，取决于树莓派的网络和性能。如果编译过程中断，最常见的原因是内存不足。树莓派4B的物理内存虽然足够，但编译大型项目时可能触及限制。此时，可以尝试增加交换空间（swap）：

sudo dphys-swapfile swapoff
sudo nano /etc/dphys-swapfile
# 将 CONF_SWAPSIZE=100 修改为 CONF_SWAPSIZE=1024
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

安装成功后，OpenPLC的Web服务会自动启动，默认端口是6688。在浏览器中输入http://<你的树莓派IP>:6688即可访问管理界面。默认登录凭证为用户名openplc，密码openplc。首次登录后，请务必立即修改密码。

Web界面是配置Runtime的核心，几个关键设置区域如下表所示：

功能区域主要配置项说明与建议
SettingsRuntime Settings设置PLC扫描周期（Scan Cycle），默认100ms，可根据控制精度要求调整。
Start Mode选择上电后运行模式（Always ON / Always OFF / Rem. Last）。
Slave DevicesModbus Slave配置OpenPLC作为Modbus从站，被其他主站（如SCADA、HMI）读取数据。
DNP3 Slave配置DNP3协议从站（常用于电力系统）。
HardwareHardware Layer核心配置，选择与实际连接的I/O板卡对应的驱动。
Custom Layers上传或管理自定义硬件驱动。
MonitoringI/O Monitoring实时查看和强制（Force）输入/输出点的状态，用于调试。
ProgramsUpload/Download上传由OpenPLC Editor编译生成的.st文件，或下载当前运行的程序。

3. 硬件层驱动配置与物理I/O连接实战

OpenPLC的强大之处在于其硬件抽象层（HAL），它允许Runtime与各种各样的物理I/O设备通信。对于树莓派4B，最直接的方式就是使用其自身的GPIO引脚。OpenPLC内置了Raspberry Pi驱动，可以方便地映射物理引脚到PLC的%IX0.0（输入）、%QX0.0（输出）等地址。

在Web界面的 Hardware > Hardware Layer 下拉菜单中，选择“Raspberry Pi”。页面下方会出现一个引脚映射表格。你需要根据你的接线情况，将树莓派的BCM编号引脚（注意，不是物理引脚号）配置为“输入”或“输出”。例如，将BCM 17（物理引脚11）配置为“输入”，那么在PLC程序中，该点的地址就是%IX0.0（如果它是第一个被启用的输入）。

然而，树莓派的GPIO驱动能力有限（通常每个引脚~16mA），且缺乏电气隔离，直接驱动继电器或接触器存在风险。在实际工业或实验室应用中，我们通常通过中间模块来连接。

方案一：使用专用PLC扩展板 市面上有专为树莓派设计的PLC HAT，它们集成了数字量输入（带光耦隔离）、继电器输出、模拟量输入/输出，甚至以太网口。例如，使用这类板卡时，你需要在硬件层选择该板卡对应的专用驱动（如果OpenPLC已支持），或根据厂商提供的模板编写自定义驱动。

方案二：通过Modbus TCP/RTU连接远程I/O模块 这是更接近工业现场的做法。你可以购买一个支持Modbus协议的远程I/O模块。将模块的网口连接到树莓派所在的网络，然后在OpenPLC的 Slave Devices 中，添加一个Modbus Master设备（这里容易混淆：OpenPLC作为主站去读取/写入I/O模块）。配置好模块的IP地址、端口和寄存器映射，就可以将远程的I/O点映射到OpenPLC的内部变量上。

添加自定义驱动是应对特殊硬件的高级技能。OpenPLC的硬件驱动位于/home/pi/OpenPLC_v3/hardware_layers/目录下。每个驱动是一个独立的.cpp和.h文件。官方提供了空白模板（空白.cpp），你可以复制它并重命名（如my_driver.cpp），然后实现几个关键函数：

// 示例：在 initialize() 函数中设置GPIO方向
void initialize()
{
    printf("我的自定义驱动初始化...\n");
    // 假设使用 wiringPi 库
    pinMode(0, INPUT);  // BCM 17 作为输入
    pinMode(1, OUTPUT); // BCM 18 作为输出
}

// 在 updateInput() 函数中读取物理输入，并赋值给内部输入缓冲区
void updateInput()
{
    if (digitalRead(0) == HIGH) {
        bool_input[0][0] = true; // 对应 %IX0.0
    } else {
        bool_input[0][0] = false;
    }
}

// 在 updateOutput() 函数中，将内部输出缓冲区的值写入物理输出
void updateOutput()
{
    if (bool_output[0][0]) { // 对应 %QX0.0
        digitalWrite(1, HIGH);
    } else {
        digitalWrite(1, LOW);
    }
}

编写完成后，需要在hardware_layers.cpp文件中注册你的驱动，然后重新编译整个Runtime：

cd /home/pi/OpenPLC_v3
./install.sh rpi

这个过程将你的驱动编译并链接到运行时中。

4. OpenPLC Editor编程与项目上传调试

OpenPLC Editor是基于Qt开发的跨平台IDE，它支持IEC 61131-3标准下的五种编程语言：梯形图（LD）、功能块图（FBD）、结构化文本（ST）、指令表（IL）和顺序功能图（SFC）。你可以从项目Release页面下载预编译版本，或从源码编译。

创建一个新项目后，首先需要配置设备资源，这与你在Runtime Web界面中配置的硬件层紧密相关。在Editor中，进入“设备”配置，添加一个“板卡”，并为其分配输入/输出通道的数量和类型，这决定了你在编程时可以使用的变量地址范围。

让我们以一个经典的“启保停”电路为例，用梯形图实现：

  1. 定义变量：在“变量”表中，可以定义全局变量。但对于简单的直接映射，我们通常直接使用地址。
  2. 绘制梯形图：
    • 第一个支路：常开触点 %IX0.0（启动按钮）并联一个常开触点 %QX0.0（电机线圈的自锁触点）。
    • 串联一个常闭触点 %IX0.1（停止按钮）。
    • 最后输出到线圈 %QX0.0。
  3. 编译：点击“项目”菜单下的“编译”。如果语法和逻辑正确，会生成一个<项目名>.st文件。这个文件包含了编译后的字节码，而不是源代码，因此可以上传到任何平台的OpenPLC Runtime上运行，实现了平台无关性。

上传程序是连接Editor和Runtime的关键一步。在Editor中，点击“PLC”菜单下的“上传...”，会弹出对话框。你需要输入运行OpenPLC Runtime的树莓派的IP地址，以及端口号（默认是4680）。点击“确定”后，Editor会将编译好的.st文件通过网络发送到Runtime，并触发其重新加载程序。

提示：如果上传失败，请依次检查：1. 树莓派IP地址是否正确；2. 树莓派防火墙是否放行了4680端口（sudo ufw allow 4680）；3. Runtime的Web服务是否正常运行（6688端口可访问）。

上传成功后，回到Runtime的Web界面。在 Programs 标签页，你会看到刚上传的程序。点击“Start PLC”按钮，程序便开始以设定的扫描周期运行。此时，切换到 Monitoring 标签页，你可以实时看到所有I/O点的状态变化。你可以手动“强制”某个输入点为ON或OFF，来模拟现场按钮动作，观察输出点的响应，这是非常有效的调试手段。

5. 进阶应用与故障排查指南

当基础功能跑通后，你可能会探索更复杂的应用。例如，使用结构化文本（ST）实现算法控制。ST语言类似于Pascal或C，非常适合复杂的数学运算和逻辑处理。在Editor中创建一个ST程序单元（POU），你可以编写如PID控制、数据滤波等高级功能。

另一个常见需求是与上层系统通信。除了之前提到的作为Modbus从站被监控，OpenPLC Runtime自身也可以作为客户端（主站）主动向数据库、MQTT服务器发送数据。这通常需要通过编写“自定义C代码”模块来实现。在Runtime的安装目录下，有一个webserver/scripts文件夹，你可以在这里放置自定义的Python或C++脚本，并在Web界面中配置它们在某些事件（如变量变化、周期触发）时被执行。

故障排查是工程实践不可或缺的部分。以下是一些常见问题及其解决思路：

  • 问题：Web界面（6688端口）无法访问。

    • 检查服务状态：sudo systemctl status openplc。查看服务是否运行（active (running)）。
    • 查看日志：sudo journalctl -u openplc -f。实时查看服务日志，通常错误信息会直接显示在这里。
    • 检查端口占用：sudo netstat -tlnp | grep 6688。确认6688端口是否被OpenPLC进程监听。

  • 问题：程序上传失败（4680端口连接超时）。

    • 确认运行时已启动并加载了硬件层。一个未正确配置硬件层的Runtime有时会无法打开4680端口。
    • 检查Editor和Runtime的版本兼容性。尽量使用相匹配的版本。
    • 在Runtime服务器上直接测试端口：在树莓派上运行sudo nc -l 4680，然后在Editor尝试上传，看树莓派终端是否有连接进来。这可以判断是网络问题还是服务问题。

  • 问题：物理I/O无反应，但Web监控界面显示状态正常。

    • 这是典型的硬件层驱动问题。首先确认在Web界面“Hardware”中是否选择了正确的驱动并点击了“Save Changes”。
    • 检查引脚映射：确认程序中使用的I/O地址与硬件层中配置的物理引脚映射关系是否正确。
    • 检查接线与电源：使用万用表或LED测试硬件电路是否导通，外部设备（如传感器、继电器线圈）的电源是否正常。
    • 检查自定义驱动代码：如果使用了自定义驱动，重点检查updateInput()和updateOutput()函数中的逻辑和引脚编号。

  • 问题：扫描周期不稳定，控制响应时快时慢。

    • 降低扫描周期：在Web界面“Settings”中适当增加扫描周期（如从50ms增加到100ms），给系统留出更多处理余量。
    • 检查树莓派负载：使用htop命令查看CPU使用率。关闭不必要的后台进程。
    • 考虑使用实时内核：对于要求严格时序的控制，可以为树莓派编译安装PREEMPT-RT实时内核补丁，但这属于高级操作，需要一定的Linux内核知识。

最后，性能优化是一个持续的过程。对于逻辑复杂的程序，尽量使用ST语言而非庞大的梯形图网络；合理组织程序结构，将不同速率的任务放在不同的程序组织单元（POU）中；定期检查Runtime的日志，关注是否有警告信息。我的一个实际项目曾因为一个调试用的、每秒向MQTT服务器发送大量数据的脚本未优化，导致扫描周期波动，去掉不必要的调试输出后系统立刻稳定下来。记住，在工业控制中，稳定性和确定性往往比绝对性能更重要。

Logo
乐奇 Rokid 开放社区

更多推荐

cover

AR巡检哪家好，和浪潮比哪家方案更成熟

avatar 乐奇 Rokid 开放社区
cover

国庆文旅安保上新！AR智能眼镜守护景区，黑科技护航假期出游

avatar 乐奇 Rokid 开放社区
cover

2027中国深圳智能穿戴产业链展览会

avatar 乐奇 Rokid 开放社区