# wasome_plc_tutorials

**Repository Path**: wasome/tutorials

## Basic Information

- **Project Name**: wasome_plc_tutorials
- **Description**: 本代码仓库包含《WasomePLC编程指南》手册中所提供的所有编程示例。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: http://www.wansheng-intelli.com
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 10
- **Created**: 2023-04-20
- **Last Updated**: 2025-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: plc, IEC61131-3, WasomePLC, Automation

## README

# WasomePLC编程指南
本代码仓库包含《WasomePLC编程指南》手册中所提供的所有编程示例。

Wasome WebIDE是一套现代的PLC编程开发IDE， 支持IEC61131-3编程语言，同时支持C、C++等多种计算机语言混合编程与调试。WasomeIDE基于最新的编程工具VSCODE开发， 提供功能丰富的编辑、编译、调试、模拟运行等功能。WasomeIDE目前支持在Ubuntu系统（18.04以上版本）上运行。

# 使用示例
本仓库的项目主要目标是帮助学习如何编写完成各种任务的代码。使用仓库中的各个项目来完成编译、调试、部署和运行目标程序，具体的操作方法请参考《WasomePLC操作手册》。
## 准备
安装好Wasome IDE，下载本代码仓库到本地：
```
git clone https://github.com/wasome-plc/tutorials.git
```

## 设置工作区
打开IDE，在IDE中设置项目工作区到刚才下载代码仓库的目录下`projects`子目录：  

![](./doc/imgs/workspace_path.png)

## 打开示例项目
从上图中点击任意项目打开

或使用另外一种方式：
- [从Ubuntu文件管理器中通过鼠标右键菜单打开PLC项目](./doc/open_project.md)

# 示例项目

## Chapter 05:使用IEC61131-3语言开发最小项目
在本章里我们将使用ST和梯形图语言开发一个最小的PLC应用，这个应用不会使用到IO内存访问。这个例子用来练习ST和梯形图语言的常用编程语法，包含4个进阶。  
### [进阶一](./projects/ch05-1)
使用一个ST文件完成：
- 程序定义
- 基本的变量类型定义
- 主要语句方法（赋值，条件转跳，数据类型转换，循环）
- 打印  

同时从IDE图形界面定义全局变量和任务

### [进阶二](./projects/ch05-2)
ST程序包含更多的语法：
-	数组变量定义
-	结构类型定义
-	函数定义
-	功能块定义
### [进阶三](./projects/ch05-3)
-	从ST程序使用`CONFIGURATION`语法定义资源与任务配置

### [进阶四](./projects/ch05-4)
-	使用梯形图LD语言开发PLC应用
### [进阶五](./projects/ch05-5)
-	使用功能块图FBD语言开发PLC应用

## Chapter 06:使用内部模块开发示例 [(进入)](./projects/ch06)

在本章里我们将使用不同语言(C, C++, Rust, ST)在项目中创建一个内部模块来开发函数与功能块，其既可以被项目内部代码调用，也可以通过模块导出给其他项目开发使用。

这个例子主要用来练习内部模块的一般步骤，包含：
-	创建模块
-	定义模块接口文件
-	自动生成C/C++头文件与框架代码
-	实现模块
-	调用模块中的POU

## Chapter 07: 控制实际设备示例

### 7.2	使用MODBUS从站控制 [(进入)](./projects/ch07-2)

### 7.3	ETHERCAT控制汇川伺服 [(进入)](./projects/ch07-3)
通过CSV的方式控制伺服启动

### 7.4	ETHERCAT控制赛雷伺服 [(进入)](./projects/ch07-4)
通过CSP的方式控制伺服启动。伺服型号为：DM3E-556 SERVO

本例子同时还展示了如何通过IO配置来获取一个EtherCAT从站的在线/离线状态。

### 7.5	使用MODBUS从站 [(进入)](./projects/ch07-5)

## Chapter 08: 开发基于PLCOpen运动控制 [(进入)](./projects/ch08-1)

在第8章中我们展示了如何在一个PLCOpen的应用中使用伺服驱动.

## Chapter 09: 开发伺服驱动 [(进入)](./projects/ch09-1)

这个例子会展示如何开发一个伺服驱动。基于Wasome PLC的驱动设计机制，使用PLCOpen运动控制库开发的PLC应用可以在不同电机类型上工作。

## Chapter 10: "上位机"程序开发 [(进入)](./projects/ch10)

Wasome PLC系统基于边缘计算平台架构，内置了物联网通讯协议支持。严格意义上并不需要上位机，这个例子会展示如何开发一个和传统“上位机”程序来读写PLC应用的内存区。