fdamador/openplc

OpenPLC Runtime version 3

![Build Status]([] ![Build status]([]

镜像概述和主要用途

OpenPLC是一款基于易用软件的开源可编程逻辑控制器（PLC），专注于提供低成本的工业自动化和研究解决方案。作为唯一提供完整源代码的控制器，OpenPLC已被广泛用于众多研究论文中，作为工业网络安全研究的框架。OpenPLC项目包含三个子项目：Runtime（运行时）、Programming editor（编程编辑器）和HMI builder（人机界面构建器）。

核心功能和特性

• 开源性质：提供完整源代码，支持自定义和二次开发
• 跨平台支持：可在Windows（通过Cygwin）、Debian系Linux、树莓派等多种平台运行
• 易用性：基于直观的软件设计，降低工业自动化入门门槛
• 研究适用性：作为工业网络安全研究的理想框架，支持各类实验和测试
• 设备兼容性：可通过Docker的-v参数传递外部设备，扩展硬件支持范围

使用场景和适用范围

• 工业自动化：适用于中小型工业自动化系统，替代传统昂贵PLC
• 学术研究：特别是工业网络安全、控制理论等领域的研究实验
• 教育教学：用于PLC编程和工业自动化技术的教学实践
• 原型开发：快速构建自动化系统原型，验证控制逻辑
• 低成本解决方案：为预算有限的项目提供可靠的PLC功能

使用方法和配置说明

常规安装

通过源码编译安装，支持多种平台：

bash
git clone https://github.com/thiagoralves/OpenPLC_v3.git
cd OpenPLC_v3
./install.sh [platform]

其中[platform]可取值：

• win：在Windows上通过Cygwin安装
• linux：在Debian系Linux发行版上安装
• docker：供Dockerfile使用（不调用sudo）
• rpi：在树莓派上安装
• custom：跳过特定包安装，假设系统已满足所有依赖（适用于非支持Linux平台或手动安装依赖后）

Docker部署示例

前提条件

确保已安装Docker

构建镜像

bash
# 替代上述install.sh，执行以下命令构建镜像
docker build -t openplc:v3 .

运行容器

可通过-v标志将设备传递给Docker守护进程（例如-v /dev/ttyACM0:/dev/ttyACM0）

bash
docker run -it --rm --privileged -p 8080:8080 openplc:v3

参数说明：

• -it：以交互模式运行并分配伪终端
• --rm：容器退出后自动删除
• --privileged：赋予容器特权模式，允许访问主机设备
• -p 8080:8080：将容器的8080端口映射到主机的8080端口，用于Web访问