208 lines
5.4 KiB
Markdown
208 lines
5.4 KiB
Markdown
|
# 示例说明
|
|||
|
|
|
|||
|
|
## 1、介绍
|
|||
|
|
|
|||
|
|
该示例提供 RTU / TCP 主机和从机的功能演示。
|
|||
|
|
|
|||
|
|
`WSL` 或 `Linux` 下使用 `gcc` 可直接 `make all` 编译出所有示例，在电脑上运行测试程序。
|
|||
|
|
|
|||
|
|
目录结构：
|
|||
|
|
|
|||
|
|
| 名称 | 说明 |
|
|||
|
|
| ---- | ---- |
|
|||
|
|
| common | 公用源码 |
|
|||
|
|
| figures | 素材 |
|
|||
|
|
| rtu_master | RTU 主机示例 |
|
|||
|
|
| tcp_master | TCP 主机示例 |
|
|||
|
|
| slave | RTU + TCP 从机示例 |
|
|||
|
|
| rtu_p2p | RTU 点对点传输文件 |
|
|||
|
|
| rtu_broadcast | RTU 广播传输文件 (粘包处理示例) |
|
|||
|
|
|
|||
|
|
## 2、使用
|
|||
|
|
|
|||
|
|
需要准备的工具如下：
|
|||
|
|
|
|||
|
|
- 虚拟串口软件
|
|||
|
|
- Modbus Poll
|
|||
|
|
- Modbus Slave
|
|||
|
|
|
|||
|
|
命令行敲击 `make clean` 、 `make all` 。
|
|||
|
|
|
|||
|
|
### 2.1、主机
|
|||
|
|
|
|||
|
|
- RTU (rtu_master)
|
|||
|
|
|
|||
|
|
- 使用虚拟串口软件虚拟出一对串口
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
- 打开 `Modbus Slave` ，按下图设置
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
- `Modbus Slave` 连接，按下图设置
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
- 进入 `rtu_master` 目录，`./RtuMaster /dev/ttySX` 运行 `RTU` 主机示例，`ttySX` 为一对虚拟串口中的另一个
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
- TCP (tcp_master)
|
|||
|
|
|
|||
|
|
- 打开 `Modbus Slave`，`SetUp` 设置同 `RTU` 一致
|
|||
|
|
|
|||
|
|
- `Modbus Slave` 连接，按下图设置
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
- 进入 `tcp_master` 目录，`./TcpMaster 127.0.0.1 502` 运行 `TCP` 主机示例
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 2.2、从机
|
|||
|
|
|
|||
|
|
- 该示例 (slave) 同时提供 `RTU` 和 `TCP` 从机功能演示，控制的是同一片内存。`TCP` 最大可接入 5 个客户端，每个客户端无数据超时为 10s, 10s 后自动断开。
|
|||
|
|
|
|||
|
|
- 示例支持所有功能码(除了功能码 0x07)。
|
|||
|
|
|
|||
|
|
- 对 `bit`、`input_bit`、`register`、`input_register` 寄存器每个文件单独定义。
|
|||
|
|
|
|||
|
|
- 使用 `agile_modbus_slave_util_callback` 。
|
|||
|
|
|
|||
|
|
- 寄存器地址域：
|
|||
|
|
|
|||
|
|
| 寄存器 | 地址范围 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| 线圈寄存器 | 0x041A ~ 0x0423 (1050 ~ 1059) |
|
|||
|
|
| 离散量输入寄存器 | 0x041A ~ 0x0423 (1050 ~ 1059) |
|
|||
|
|
| 保持寄存器 | 0xFFF6 ~ 0xFFFF (65526 ~ 65535) |
|
|||
|
|
| 输入寄存器 | 0xFFF6 ~ 0xFFFF (65526 ~ 65535) |
|
|||
|
|
|
|||
|
|
**注意**: 读写其他地址寄存器都能成功，但值都为 0。
|
|||
|
|
|
|||
|
|
使用：
|
|||
|
|
|
|||
|
|
- 使用虚拟串口软件虚拟出一对串口
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
- 进入 `slave` 目录，`./ModbusSlave /dev/ttyS2 1025` 运行示例
|
|||
|
|
|
|||
|
|
/dev/ttySX: 虚拟串口中的一个
|
|||
|
|
|
|||
|
|
1025：监听端口号，如果不是 `root` 权限，端口号必须大于 `1024`
|
|||
|
|
|
|||
|
|
- 打开 `Modbus Poll` 按下图设置和连接 RTU
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
- 打开 5 个 `Modbus Poll` ，设置同 RTU，连接如下图
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
- 效果演示
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
- 超时断开演示
|
|||
|
|
|
|||
|
|
将 `Modbus Poll` 的 poll 界面关闭，看控制台打印可以看到 close 报文。
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 2.3、RTU 传输文件
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
使用 `0x50` 作为传输文件的特殊功能码。
|
|||
|
|
|
|||
|
|
分包传输文件数据，每包数据最大 1024 字节。
|
|||
|
|
|
|||
|
|
`Data` 字段协议定义：
|
|||
|
|
|
|||
|
|
- 主机请求
|
|||
|
|
|
|||
|
|
| 命令 | 字节数 | 数据 |
|
|||
|
|
| ---- | ---- | ---- |
|
|||
|
|
| 2 Bytes | 2 Bytes | N Bytes |
|
|||
|
|
|
|||
|
|
命令:
|
|||
|
|
|
|||
|
|
| 命令 | 说明 | 数据 |
|
|||
|
|
| ---- | ---- | ---- |
|
|||
|
|
| 0x0001 | 开始发送 | 文件大小(4 Bytes) + 文件名称(字符串) |
|
|||
|
|
| 0x0002 | 传输数据 | 标志(1 Byte) + 文件数据 |
|
|||
|
|
|
|||
|
|
标志:
|
|||
|
|
|
|||
|
|
| 状态 | 说明 |
|
|||
|
|
| ---- | ---- |
|
|||
|
|
| 0x00 | 最后一包数据 |
|
|||
|
|
| 0x01 | 不是最后一包数据 |
|
|||
|
|
|
|||
|
|
- 从机响应
|
|||
|
|
|
|||
|
|
| 命令 | 状态 |
|
|||
|
|
| ---- | ---- |
|
|||
|
|
| 2 Bytes | 1 Byte |
|
|||
|
|
|
|||
|
|
状态:
|
|||
|
|
|
|||
|
|
| 状态 | 说明 |
|
|||
|
|
| ---- | ---- |
|
|||
|
|
| 0x00 | 失败 |
|
|||
|
|
| 0x01 | 成功 |
|
|||
|
|
|
|||
|
|
- 使用虚拟串口软件虚拟出 3 个串口，组成串口群组
|
|||
|
|
|
|||
|
|
这里我使用的时 MX 虚拟串口
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
#### 2.3.1、点对点传输
|
|||
|
|
|
|||
|
|
- 进入 `rtu_p2p` 目录，打开 `Linux Shell`，演示效果如下
|
|||
|
|
|
|||
|
|
**注意**:
|
|||
|
|
|
|||
|
|
- 传输的文件必须是一般文件，像可执行文件、目录等不支持
|
|||
|
|
|
|||
|
|
- 文件路径必须是 `Linux` 环境下的路径
|
|||
|
|
|
|||
|
|
- 从机接收到数据后修改文件名称 (从机地址_原文件名) 写入在当前目录。
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
#### 2.3.2、广播传输
|
|||
|
|
|
|||
|
|
该例子主要演示 `agile_modbus_slave_handle` 中 `frame_length` 的用处。
|
|||
|
|
|
|||
|
|
`broadcast_master` 中，使用广播地址 0，周期 5ms 发送数据包。同时每包数据后都发送 100 字节的脏数据。
|
|||
|
|
|
|||
|
|
```C
|
|||
|
|
|
|||
|
|
int send_len = agile_modbus_serialize_raw_request(ctx, raw_req, raw_req_len);
|
|||
|
|
serial_send(_fd, ctx->send_buf, send_len);
|
|||
|
|
|
|||
|
|
//脏数据
|
|||
|
|
serial_send(_fd, _dirty_buf, sizeof(_dirty_buf));
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
在如此快速的数据流下，`broadcast_slave` 必须使用 `agile_modbus_slave_handle` 中 `frame_length` 参数来对粘包进行处理。
|
|||
|
|
|
|||
|
|
- 进入 `rtu_broadcast` 目录，打开 `Linux Shell`，演示效果如下
|
|||
|
|
|
|||
|
|
**注意**:
|
|||
|
|
|
|||
|
|
- 传输的文件必须是一般文件，像可执行文件、目录等不支持
|
|||
|
|
|
|||
|
|
- 文件路径必须是 `Linux` 环境下的路径
|
|||
|
|
|
|||
|
|
- 从机接收到数据后修改文件名称 (从机地址_原文件名) 写入在当前目录。
|
|||
|
|
|
|||
|
|
|