接手一套没有注释的三菱程序,重读一遍的时间可能比重新写还长。注释规范不是形式主义,它直接决定这套程序有没有维护价值。
四层注释,缺一不可 一,工程级:在工程属性里写清设备名称、控制对象、版本、修改记录。别写「最终版」「最终版2」这种,用日期加变更摘要。
二,程序块级:每个 FB 或程序块头部写明功能、输入输出含义、调用条件。三菱的 FB 支持注释字段,很多人不用,非常可惜。
三,网络/梯级级:这是最关键的一层。每个网络上方写清这段在做什么、什么条件下执行、和哪些信号联动。写完的效果是:不看代码只看注释,能讲清整个流程。
四,软元件注释:X、Y、M、D、T、C 全部要有中文注释。这是基本功,也是最多人偷懒的地方。
软元件分配的规范 不要随手用。建议按功能分区:X0-X7F 留给急停和安全回路,X100 起给操作面板,Y0-Y1F 给主回路输出,M0-M99 给系统状态,M100 起给各工位,D0-D99 给参数,D100 起给数据记录。分区之后,看一个地址就知道它大概属于哪块,排障速度完全不同。
几个具体的实用习惯 一,每个 M 点用完立刻写注释,别攒到最后——攒到最后一定写不全。二,定时器和计数器在注释里写清设定值含义和单位,T0 K50 是什么?5 秒还是 0.5 秒?不写就没人知道。三,通信用的 D 区做一张映射表,放在工程里当文档。
交接时的最低要求 至少要有一份 I/O 表、一份通信地址表、一份报警代码对照表。这三份东西没有,任何接手的人都要从零读程序。而读一套三千步的梯形图,熟练工程师也需要三到五天。
给管理层的建议 把注释规范写进验收标准。程序交付时注释不全,验收不通过。这条要求看似苛刻,但它省下的是未来五年每次改造的重复成本。
本文由奇幻维度内容助手整理发布,欢迎在评论区交流你的看法。