157 lines
3.5 KiB
Markdown
157 lines
3.5 KiB
Markdown
|
# PLC 模拟模式使用说明
|
|||
|
|
|
|||
|
|
## 概述
|
|||
|
|
|
|||
|
|
程序现在支持两种 PLC 运行模式：
|
|||
|
|
- **真实 PLC 模式**（默认）：连接到真实的 PLC 硬件设备
|
|||
|
|
- **模拟模式**：使用软件模拟 PLC 行为，用于开发和测试
|
|||
|
|
|
|||
|
|
## 使用方法
|
|||
|
|
|
|||
|
|
### 1. 默认模式（真实 PLC）
|
|||
|
|
|
|||
|
|
直接运行程序，不带任何参数：
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
python dtmgtApp.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**输出日志**：
|
|||
|
|
```
|
|||
|
|
使用真实 PLC 设备
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 模拟模式
|
|||
|
|
|
|||
|
|
使用 `--mock` 参数启动程序：
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
python dtmgtApp.py --mock
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**输出日志**：
|
|||
|
|
```
|
|||
|
|
启用 PLC 模拟模式
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 模拟模式特性
|
|||
|
|
|
|||
|
|
在模拟模式下，程序会：
|
|||
|
|
|
|||
|
|
✅ **模拟 PLC 寄存器**：
|
|||
|
|
- 自动初始化模拟寄存器
|
|||
|
|
- 支持读写寄存器操作
|
|||
|
|
- 支持线圈（Coil）和保持寄存器（Holding Register）
|
|||
|
|
|
|||
|
|
✅ **模拟测试流程**：
|
|||
|
|
- 自动模拟通道测试过程
|
|||
|
|
- 支持多方向跌落测试
|
|||
|
|
- 自动生成测试结果数据
|
|||
|
|
|
|||
|
|
✅ **无需硬件**：
|
|||
|
|
- 不需要真实的 PLC 设备
|
|||
|
|
- 不需要串口连接
|
|||
|
|
- 适合开发和调试
|
|||
|
|
|
|||
|
|
## 其他命令行参数
|
|||
|
|
|
|||
|
|
程序支持以下命令行参数：
|
|||
|
|
|
|||
|
|
| 参数 | 类型 | 默认值 | 说明 |
|
|||
|
|
|------|------|--------|------|
|
|||
|
|
| `--mock` | flag | False | 启用 PLC 模拟模式 |
|
|||
|
|
| `--startModbusServer` | flag | True | 启动 Modbus 服务器 |
|
|||
|
|
| `--modbusServer` | string | "127.0.0.1" | Modbus 服务器地址 |
|
|||
|
|
| `--modbusServerPort` | int | 5020 | Modbus 服务器端口 |
|
|||
|
|
| `--no-ui` | flag | False | 不启动 PyQt5 前端界面 |
|
|||
|
|
| `--port` | int | 5050 | HTTP 服务端口 |
|
|||
|
|
|
|||
|
|
## 完整示例
|
|||
|
|
|
|||
|
|
### 示例 1：模拟模式 + 自定义端口
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
python dtmgtApp.py --mock --port 8080
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 示例 2：真实 PLC + 不启动 UI
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
python dtmgtApp.py --no-ui
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 示例 3：模拟模式 + 自定义 Modbus 端口
|
|||
|
|
|
|||
|
|
```powershell
|
|||
|
|
python dtmgtApp.py --mock --modbusServerPort 5021
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 代码修改说明
|
|||
|
|
|
|||
|
|
### modbus_plc.py
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
MOCK_MODE = False # 默认使用真实 PLC，通过命令行参数 --mock 启用模拟模式
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### dtmgtApp.py
|
|||
|
|
|
|||
|
|
1. **添加命令行参数**：
|
|||
|
|
```python
|
|||
|
|
parser.add_argument('--mock', action='store_true', help="启用 PLC 模拟模式")
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. **在 main() 函数中设置模式**：
|
|||
|
|
```python
|
|||
|
|
if hasattr(args, 'mock') and args.mock:
|
|||
|
|
import modbus_plc
|
|||
|
|
modbus_plc.MOCK_MODE = True
|
|||
|
|
print_with_timestamp("启用 PLC 模拟模式", color='yellow')
|
|||
|
|
else:
|
|||
|
|
print_with_timestamp("使用真实 PLC 设备", color='green')
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
⚠️ **生产环境**：
|
|||
|
|
- 生产环境必须使用真实 PLC 模式
|
|||
|
|
- 不要在生产环境中使用 `--mock` 参数
|
|||
|
|
|
|||
|
|
⚠️ **测试环境**：
|
|||
|
|
- 开发测试时可以使用模拟模式
|
|||
|
|
- 模拟模式下的数据仅供测试，不代表真实测试结果
|
|||
|
|
|
|||
|
|
⚠️ **参数检查**：
|
|||
|
|
- 程序启动时会在日志中明确显示当前使用的模式
|
|||
|
|
- 请仔细检查日志确认运行模式正确
|
|||
|
|
|
|||
|
|
## 常见问题
|
|||
|
|
|
|||
|
|
### Q1: 如何确认当前是什么模式？
|
|||
|
|
|
|||
|
|
**A**: 查看程序启动时的日志输出：
|
|||
|
|
- `启用 PLC 模拟模式` → 模拟模式
|
|||
|
|
- `使用真实 PLC 设备` → 真实模式
|
|||
|
|
|
|||
|
|
### Q2: 模拟模式下还需要 PLC 硬件吗？
|
|||
|
|
|
|||
|
|
**A**: 不需要。模拟模式完全在软件中运行，无需任何 PLC 硬件或串口连接。
|
|||
|
|
|
|||
|
|
### Q3: 如何在代码中检查当前模式？
|
|||
|
|
|
|||
|
|
**A**: 检查 `modbus_plc.MOCK_MODE` 变量：
|
|||
|
|
```python
|
|||
|
|
import modbus_plc
|
|||
|
|
if modbus_plc.MOCK_MODE:
|
|||
|
|
print("当前是模拟模式")
|
|||
|
|
else:
|
|||
|
|
print("当前是真实 PLC 模式")
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 更新历史
|
|||
|
|
|
|||
|
|
- **2025-12-08**: 初始版本
|
|||
|
|
- 将 MOCK_MODE 默认值改为 False
|
|||
|
|
- 添加 --mock 命令行参数
|
|||
|
|
- 添加模式切换日志输出
|