SIMOTION 编程指南.pdf

SIMOTION 编程（一） 2013-05-16 在SCOUT光盘里，有个非常详细的编程指南（点击此处查看），非常好，只是不 知道为什么被放在这么不起眼的位置。该编程指南用来帮助用户获得一个标准、 统一的代码，并且使代码可以更容易地维护和重新使用。不仅如此，错误可以在 早期阶段（例如，由编译器）被识别和避免。 统一外观，可维护以及清晰的源代码对于工程师和工程公司具 有非常重要的意义。有些遗憾，这么个好东西是全英文的，在学习SIMOTION的过 程中，我挑选出这本手册中比较重要的编程标准，翻译出来，希望对大家有所帮 助。其中规则是原则上必须遵守的，而建议则是尽量遵守的条目。其实编程的规 范标准不仅对于SIMOTION工程师有意义，对于其他编程例如PLC也是可以借鉴的。 代码支持识别错误和bug，例如，通过使用前缀可以简单地识别类型不兼容。 目的：代码问题在早期阶段发现。 规范标准应用程序和库 目的：程序代码更容易学习和提高程序代码的可重用性 模块化 目的：增加程序透明度水平 封装子功能，使用不同的模块进行简单组合，每个模块定义清晰而独立的接口。 增加适用性使代码可以持续改进 目的：改变的各个模块的程序代码对于功能/功能块库或项目/方案影响降到最 低。不同的编程工程师应该可以在单独的模块中修改程序代码。 规则1： 每一个编程的源文件必须进行文档记录，特别是专用的FB FC 。并应该使用统一 的模板，程序模板在SCOUT光盘中有提供。 建议：不使用特殊字符，例如ä，ö，U，A等。 规则2： TAB不容许在源代码中使用。应使用四个空格的缩进。当使用SCOUT内部ST编辑器 中是自动完成的。这是为了避免不同的编译器对于TAB的解释长度差异而考虑的。 建议：为提高可读性，源代码单行长度应限制在80 个字符。 建议：各种ST代码段相关的功能应使用换行符分隔。 建议：整体的意见（描述一个函数或代码段的战略注释）：应设在相应的代码段 开始描述。局部注释（战术注释）如果可能的话，应位于代码行的同行末尾 - 否 则在相关联的代码行之前。 规则3： 在ST中注释以/ /开始。注释在斜线符号后开始，没有任何空格。出于测试目的， 完整的块可以被简单地使用（* .. *）进行屏蔽。 规则4： 每个程序单元名称需包含一个前缀。这个前缀表明当前的程序单元功能。 规则5： 使用前缀x，表明在一个单位中使用数据、功能、FB和程序，以确保少量代码的 POU的紧凑。 规则6： 前导下划线字符（ “_”）识别功能和功能块是保留给西门子系统功能的。前导 下划线字符不应该被用来在应用程序本身。 规则7： 不得使用使用大写或小写进行标识符的区分。一旦某种书写方式的标识符已被选 中，其在所有的源代码中使用。 推荐：标识符中的名称采用英文。名称表示上下文中的源代码标识符的意义和目 的。 规则8： FC / FB的输入和输出变量不使用前缀。如果结构被用于输入和输出变量，那么 该结构的元素成员应具有前缀。 规则9： 常量不包含前缀。 规则10： 使用前缀后名称以大写字母开始 举例: 局部变量：rMaxLength 规则11： 在系统中定义的名称 （例如，变量和函数的名称）是不允许再使用的。 推荐：名称的最大长度为32 个字符。 规则12： 功能，功能块和程序名称结构应根据下面的示意图 组合 ：[操作]对象[属性] 例如： 标识符：FCSwapWordBigEndian： 名称：SwapWordBigEndian 操作：Swap 对象：Word 属性：BigEndian 规则13： 前缀和标识符之间使用分隔符（下划线字符）是不允许的。 规则14： 变量前缀用来表示数据类型的内存位置。 []括号中的前缀是一种替代方法，使用哪一种需要在整个项目中保持一致。 举例: gasFeeder 全局送料器结构数组 推荐： 使用 字母 e s a 开头并且使用type 作为结尾。 SIMOTION 编程（二） 规则15： 枚举（枚举）的元素全部写大写字母。如果包括单独的单词，那么使用下划线字 符分开（常量也是）。 规则16： 前缀和标识符不使用下划线隔开。 推荐：数组范围应从0 开始到 “最大值-1”结束。 推荐：类型定义应在接口部分进行，特定的设备变量类型须具有独特、明确的定 义 推荐：类型定义并不适用于基本数据类型。 规则17： 常量的名称总是用大写字母。为