s7-scl-gen
Version:
S7 PLC SCL 代码自动生成
172 lines (142 loc) • 6.93 kB
YAML
# 指示属于哪一个CPU和哪一种功能
# 下例指示CPU名字为AS1，功能为SC(串行通信 serial commnucation)
# SC 也可以写为 MB、modbusRTU
name: AS1-SC
description: |
使用 CP340 通信，必须在step7工程中加入以下库
* FB2 P_RCV
* FB3 P_SEND
使用 CP341 通信，必须在step7工程中加入以下库
* FB7 P_RCV_RK
* FB8 P_SND_RK
includes:
# 可通过指定includes，系统自动添加对应代码进 CP_Loop.scl 中。
# 如果发送接收块的FB背景块，建议将该FB的定义文件放入includes中
- A101.SCL # 该文件包含 A101L FB 的实现
- FXGasFlow.scl
symbols:
# 系统已有5个内置符号：
# - [CP340_Poll, FB340] CP340通信主处理函数
# - [CP341_Poll, FB341] CP341通信主处理函数
# - [CRC16, FC464, CRC16, modbus CRC16 check] CRC16校验函数
# - [SC_Loop, FC341] 表示主循环调用FC，将这个加入OB1中
# - [SC_polls_DB, DB880] 将用于保存轮询命令数据
# 可以在对上述内置符号的地址进行更改，只要重新定义就可以了，注意保持名称一致
# 以下为自定义符号，这里是接收块
# 建议所有的接收块都用FB定义结构，不仅减少接收块的定义工作量，还能在FB中方便地对接收后的数据进一步处理和转换。
# 如果发送数据需要动态更改，则建议发送和接收都用同一个FB背景块方便处理。
# 转换程序能对发送块接收块是FB背景块的情况自动生成FB调用代码，注意接收FB不要有参数！
# 这类FB不通用，需要另外单独写SCL代码。
- [A101L, FB802]
- [FXGasFlow, FB803, ~, 福鑫天然气流量接收块]
- [write_SC, FB811, ~, 写处理块]
- [Flow30, DB830, JS_flow]
- [GAS, DB841, FXGasFlow]
- [cmd_ret, DB+, write_SC]
# JS_Flow 已在 CPU 文档中定义
list : # CP 模块列表
# 可以在一个模块中混用 modbus 和原始串行通信
# modbus协议暂只支持 01 02 03 04 05 06 号功能码
# 列表第一层为模块配置
# 模块和下一层为poll配置
# 在poll配置项中，通常不需要指定 send_DB
# 转换程序会自动把配置里的发送数据放在SC_polls_DB中
# 否则指定 send_DB 后，配置里的发送数据将无效，由指定的send_DB send_start send_length 决定发送内容
# recv_DB recv_start 必须指定CPU中的地址，不会自动生成。
- comment: CP01 Module736 储罐液位
# 值: 字符串 指定CP通信硬件类型，默认CP341
model: CP340
# 值: 字符串 省略时默认为 polls_<module_address>
name: polls_LIT
# 值: WORD
# 类型: S7符号定义 | S7符号引用
# module 和 module_addr 必须填写一个，用于指明使用哪一个CP模块硬件
module: [CP01, IW736]
#module_addr: 736
# 值: DB
# 类型: S7符号定义 | S7符号引用
DB: [CP_01, DB881]
polls:
- comment: '液位' # 值: 字符串
# 值: 字符串 必须是一个由空格分隔的16进制字节的字符串
# send_data 定义了通用485通信的发送数据，modbus数据见第二个CP模块的poll
send_data: 31 31 30 30 0D
# 值: DB
# 类型: S7符号定义 | S7符号引用
# 注意，同一个DB符号只允许定义一次
# 如另一poll要使用相同的DB块，要在另一poll中使用S7符号引用指向这里
recv_DB: [tankLitre, DB20, A101L]
# 值: 正整数
recv_start: 0
extra_code: FB
- comment: CP02 Module752
name: polls_flow
# module 和 module_addr 必须填写一个，用于指明使用哪一个CP模块硬件
# 值: 正整数
#module: [CP02, IW752]
module_addr: 752
DB: [CP_02, DB882]
polls:
- comment: 流量计30
# 轮询模式，可省略，默认为 continuous
# 值: 字符串
# 有3种模式可供选择: continuous, periodicity, custom
mode: continuous
# 超时或周期时间，单位ms，默认 2000ms
# 值: 正整数
# continuous 或 custom 模式下，代表一个询问的最长等待时间
# periodicity 模式下，代表一个询问的周期时间
timeout: 2000
# 没有 send_DB 和 send_data 配置项时， 由以下配置项定义 modbusRTU 发送数据
# unit_ID func_code address data|length 配置项为十进制整数
# 但如果采用字符串，则表示16进制，两种类型数字都是允许的。
# 运行时会自动处理CRC校验
# 配置项 length 和 data 本质是一样的，只是名称不同
# 但在生成的SCL中只有 data 这一字段
# 采用2个配置名称是为了功能码的读写语义，建议为了配置的可阅读性
# 01 02 03 04 功能用 length，05 06 功能用 data
unit_ID: 0x1e # 16进制数用字符串形式 等同于 30
func_code: 0x4 # 16进制数用字符串形式 等同于 4
address: 12 # 10进制数用整数形式 等同于 'c'
length: 0x1c # 16进制数用字符串形式 等同于 28
# 类型: S7符号定义 | S7符号引用
recv_DB: Flow30
recv_start: 0
extra_code: FB # 将自动产生 `JS_flow.Flow30();`
- comment: 天然气3#流量计 # 非modbus发送，不要有unit_ID属性，直接在send_data属性上写16进制发送数据
# 自定义函数可通过 SC_polls_DB.poll_{序号}_data.{数据符号} 来处理发送数据
# 比如本poll的发送数据SCL符号地址为：
# `"SC_polls_DB".polls_HK[2].sendLength` 发送长度
# `"SC_polls_DB".poll_2_data.send_data` (ARRAY OF BYTE)
# 如果 send_data 要动态变化，send_data要填充0满足最大长度
send_data: 03 03 00 00 0C 8E 5D # send_data 必须是一个由空格分隔的16进制字节的字符串
recv_DB: GAS # 接收块，引用GAS符号
recv_start: 20 # 要注意开始地址不一样
mode: periodicity # 周期模式
timeout: 1000 # 指定1秒同期
extra_code: FB
- comment: 读取线圈
unit_ID: 4
func_code: 1
address: 0
length: 8
recv_DB: cmd_ret
recv_start: 0
- comment: 写线圈
mode: custom # 人工控制写，不会自动轮询
# 正常情况下，无论是不是modbus，发送的数据都是固定的。
# 固定数据时，转换程序会自动为接收块为背景块的情形自动调用接收块处理FB
# 当发送数据不固定时，比如 modbus 05 命令，建议使用指定的FB背景块作为发送数据区
send_DB: cmd_ret
send_start: 20
recv_DB: cmd_ret
recv_start: 0
extra_code: |- # 通过设置 custom_trigger 来控制发送
"write_SC"."cmd_ret"(writing := "SC_polls_DB".CP01[4].custom_trigger);
# 用户自写SCL代码，放在循环的开始和结束处。
loop_begin: |-
// 这里的代码将在 AI_Loop 循环开始时执行
loop_end: |-
// 这里的代码将在 AI_Loop 循环结束时执行
...