FastAPI 条件式 OpenAPI：用 Pydantic 设置与环境变量按环境开关接口文档
2026/9/10 14:08:55
1. 项目背景与核心需求
水塔水位控制系统是工业自动化领域的经典应用场景，也是PLC初学者最佳练手项目之一。这个基于西门子S7-1200 PLC与MCGS7.7触摸屏的联机方案，完美展现了现代工业控制系统的典型架构。我在多个市政供水项目中实际应用过类似方案，稳定运行最长的已达5年无故障。
这个项目的核心价值在于：
- 完整呈现PLC与HMI的通信配置流程（这是现场工程师的必备技能）
- 提供可直接复用的IO表设计模板（节省50%以上的现场调试时间）
- 包含详细注释的博途V16程序（特别适合PLC初学者理解编程逻辑）
- 集成变频器控制逻辑（V20变频器是水压调节的常用设备）
2. 硬件系统架构设计
2.1 主要设备选型
| 设备类型 | 型号规格 | 功能说明 |
|---|---|---|
| PLC控制器 | S7-1214C DC/DC/DC | 带2AI/2AO的基础型号 |
| HMI人机界面 | MCGS TPC7062Ti | 7寸触摸屏，支持以太网通信 |
| 变频器 | SINAMICS V20 | 0.37kW，控制水泵电机转速 |
| 水位传感器 | 4-20mA液位变送器 | 量程0-10米，精度±0.5%FS |
| 电动阀门 | DN50智能调节阀 | 带4-20mA反馈信号 |
关键提示：S7-1214C的2个模拟量输入通道刚好满足水位+阀门反馈信号采集，若需要更多AI点应考虑1215C型号
2.2 IO地址分配表
这是经过多个项目验证的优化IO配置方案：
# 数字量输入 I0.0 - 手动/自动切换 I0.1 - 急停按钮 I0.2 - 低水位报警 I0.3 - 高水位报警 # 数字量输出 Q0.0 - 水泵启停 Q0.1 - 进水阀开关 Q0.2 - 报警指示灯 # 模拟量输入 IW64 - 水位信号(0-27648对应0-10m) IW66 - 阀门开度反馈 # 模拟量输出 QW80 - 变频器速度给定(0-27648对应0-50Hz)3. 博途V16编程详解
3.1 项目创建关键步骤
- 新建项目时务必选择"S7-1200"设备家族
- CPU型号选择与实际硬件一致的6ES7 214-1AG40-0XB0
- 在设备配置中启用PROFINET接口，设置IP地址为192.168.0.1
- 添加GSD文件支持MCGS通信（需从官网下载最新版）
常见问题：若HMI无法连接，检查防火墙是否阻止了1099端口通信
3.2 核心控制逻辑实现
水位PID控制程序段示例：
// 水位PID控制功能块 "PID_Compact_DB"(REQ := "Auto_Mode", MAN_ON := FALSE, PV_PER := "Water_Level_RAW", SP_INT := "Set_Level", // 单位：米 CYCLIC := TRUE, LMN_PER => "Pump_Speed"); // 输出到变频器 // 阀门联动控制 IF "Water_Level_RAW" < ("Set_Level" * 0.8) THEN "Inlet_Valve" := TRUE; // 开阀进水 ELSIF "Water_Level_RAW" > ("Set_Level" * 1.2) THEN "Inlet_Valve" := FALSE; // 关阀停止 END_IF;3.3 HMI通信配置要点
- 在MCGS设备窗口添加"S7-1200 TCP/IP"驱动
- 设置PLC IP地址与端口号102（默认）
- 变量连接采用绝对地址方式：
- 水位显示：4区变量，地址VW100
- 设定值修改：4区变量，地址VW104
- 添加趋势图控件，采样间隔建议设为1s
4. 变频器参数设置
4.1 V20基本参数配置
| 参数号 | 参数名称 | 设置值 | 说明 |
|---|---|---|---|
| P700 | 命令源选择 | 2 | 端子命令+模拟量给定 |
| P1000 | 频率设定选择 | 2 | 模拟量输入 |
| P1080 | 最小频率 | 5.00Hz | 防止水泵空转 |
| P1120 | 加速时间 | 10.00s | 平滑启动 |
| P2200 | PID使能 | 1 | 启用PID功能 |
4.2 与PLC的配合要点
- 模拟量输入跳线设为0-10V（与PLC输出匹配）
- 数字量输入DIN1接PLC Q0.0作为启停信号
- 故障输出接PLC I0.4实现连锁保护
- 参数P756.0设为1（模拟量输入滤波）
5. 调试经验与故障排查
5.1 现场调试六步法
- 先测试传感器信号：用标准电流源验证4-20mA对应值
- 单独测试变频器：通过面板操作确认电机转向正确
- 手动模式测试：在HMI手动启停设备验证基础功能
- 自动模式测试：设置不同水位值观察响应曲线
- 整定PID参数：先P后I，D参数通常设为0
- 异常测试：模拟断线、超限等故障验证保护逻辑
5.2 典型问题处理指南
| 故障现象 | 可能原因 | 解决方案 |
|---|---|---|
| HMI显示"通信超时" | 网线接触不良/IP冲突 | 用ping测试物理连接 |
| 水位数值跳变 | 信号线未用双绞线 | 更换屏蔽双绞线并单端接地 |
| 变频器不响应速度给定 | 模拟量输出极性设置错误 | 检查P756.1参数应为0（单向） |
| 阀门动作滞后 | PID参数过于保守 | 适当增大比例带P |
| 触摸屏按钮无响应 | 背景画面覆盖操作元件 | 检查画面层级关系 |
6. 系统优化建议
- 增加Modbus RTU通信：将多台PLC组网实现集中监控
- 添加Web服务器功能：通过网页远程查看运行状态
- 使用SCL语言重写复杂算法：提高程序执行效率
- 配置数据日志功能：记录历史数据用于分析优化
- 考虑冗余设计：关键传感器采用双路信号输入
这个项目最值得关注的是IO表的规范设计，好的地址规划能让后期维护效率提升3倍以上。实际应用中，建议将报警变量集中安排在MB20开始的字节区，这样无论是PLC程序还是HMI开发都能快速定位相关信号。