第三十章 宏指令说明 (2)30.1宏指令的结构 (2)30.2宏指令的语法 (4)30.2.1 常量和变量 (4)30.2.2运算符 (7)30.3语句 (10)30.3.1定义语句 (10)30.3.2赋值语句 (11)30.3.3逻辑运算语句 (11)30.3.4 循环语句 (13)30.3.4其他控制命令 (15)30.4 子函数 (16)30.5内置函数功能 (17)30.5.1 数学运算函数 (18)30.5.2 数据转换函数 (24)30.5.3 数据操作函数 (29)30.5.4 位状态转换 (34)30.5.5 通讯有关的函数 (37)30.6 怎样建立和执行宏指令 (52)30.6.1 怎样建立一个宏指令 (52)30.6.2 执行宏指令 (57)30.7 使用宏指令时的注意事项 (58)30.8 使用自由协议去控制一个设备 (59)30.9 编译错误提示信息 (67)30.10 宏指令范例程序 (78)第三十章宏指令说明宏指令提供了应用程序之外附加的你所需要的功能。
在MT8000人机界面运行时，宏指令可以自动的执行这些命令。
它可以担负执行譬如复杂的运算、字符串处理，和使用者与工程之间的交流等功能。
本章主要介绍宏指令的语法、如何使用和编程方法等功能。
希望通过本章的说明，能够使各位能够快速的掌握EB8000软件提供的强大的宏指令功能。
30.1宏指令的结构宏指令是由各种语句组成的。
这些语句包含常数、变量和各种运算符。
这些语句放置在特定的顺序位置以执行后达到一个希望的执行结果。
宏指令的结构一般为以下格式：全局变量声明-----------------------------------可选Sub Function Block Declarations(子函数声明) -----------------------------------可选局部变量声明End Sub(结束子函数)macro_command main() [主函数] ------------------------------------必须局部变量声明[各式语句]end macro_command [结束主函数] ------------------------------------必须一个宏指令必须有一个且只有一个主函数，用来开始宏指令的执行。
格式为：macro_command函数名称()end macro_command变量声明必须放在宏指令语句的前面，否则如果语句放置在变量声明的前面，将会造成宏指令无法编译通过。
局部变量一般用在宏指令主函数或者自定义的子函数中。
它的合法性只在指定的函数中有效。
全局变量一般是定义在所有宏指令函数的前面，且它在整个宏指令中均具有有效性。
当局部变量和全局变量被定义为相同的名称时，只有局部变量有效。
下面就是一个简单的宏指令，其中就包含了变量声明和功能执行。
macro_command main()short pressure = 10 // 局部变量声明SetData(pressure, "Allen-Bradley DF1", N7, 0, 1) // 功能执行macro_commandend30.2宏指令的语法30.2.1 常量和变量30.2.1.1常量常量是一个可以被各式语句直接使用的固定的数据。
有如下格式：常量类型使用说明举例十进制整型数345, -234, 0, 23456十六进制数必须以 0x开头0x3b, 0xffff, 0x237字符型字符必须使用单引号‘a’, ‘data’, ‘函数名称’false 布尔型true,下面即为一个简单的常量使用的范例。
macro_command main()short A, B // 声明A和B为短整型变量A = 1234B = 0x12 // 1234 和 0x12 即为常量end macro_command30.2.1.2 变量变量是一个代表着各种资料的名称。
在宏指令中，这些资料可以随着宏指令语句执行的结果改变而改变。
变量的命名规则1. 必须以英文字母开头2. 变量名成长度不超过32个字符3. 系统保留寄存器名称不能作为变量名称。
下面为5种不同的变量类型：变量类型描述范围1Bool 布尔型 1 bit (一个位) 0,Char 字符型8 bits (一个字节) ±127Short 短整型16 bits (一个字) ±32767Int 双整型32 bits (双字) ±2147418112Float 浮点型32 bits (双字)变量声明变量必须在使用前声明。
所以，在宏指令，所有的变量都必须在语句使用前都被声明完成。
声明变量时，先定义变量的类型，后面再跟着变量名称。
如下范例:int aswitchshort b,float pressure数组声明宏指令支持一维数组(下标从0开始)。
声明数组变量时，先定义数组变量的类型，变量名称，接着就是该数组变量的个数，变量个数必须放置在“[]”符号中。
数组变量的长度为1~4096。
一个宏指令中只支持4096个变量。
如下范例:int a[10]switch[30]short b[20],float pressure[15]数组的下标最小为0，最大下标为(数组的长度-1)如下范例:char data 100] // 数组变量的长度是100所以: 最小的数组为“data[0]”，最大的数组为“data[99]”，即100-1=99。
变量和数组初始化有两种方法可以让变量初始化：1. 使用语句中的赋值语句(=)如下范例:aintb[3]floata = 10b[0] = 12. 声明变量时直接赋值char a = ‘5’, b = 9数组变量的声明是一个特殊的情况。
一个完整的数组被初始化时，可以在数组变量声明时，将数据放置在波形括号“{}”里面，各数据使用逗号分开。
如下所示:float data[4] = {11, 22, 33, 44} //这样data[0] = 11, data[1] = 22….30.2.2运算符运算符通常被用来指定数据是如何被操作的。
在任何一个语句中，运算符左边的变量结果均依据运算符右边的条件而获得。
运算符描述举例= 赋值运算符pressure = 10数学运算符描述举例+ 加 A = B + C- 减 A = B – C* 乘 A = B * C/ 除 A = B / C% 求余(返回剩余数) A = B % 5比较运算符描述举例< 小于if A < 10 then B = 5<= 小于或者等于if A >= 10 then B = 5> 大于if A < 10 then B = 5>= 大于或者等于if A <= 10 then B = 5== 等于if A == 10 then B = 5<> 不等于if A <> 10 then B = 5逻辑运算符描述举例And 与if A < 10 and B > 5 then C = 10Or 或if A >= 10 or B > 5 then C = 10Xor 异或if A xor 256 then B = 5Not 非if not A then B = 5移位和位运算符通常被用来操作字符型变量、短整型变量和双整型变量的位。
在一个语句中，这些运算符的优先权是在从该语句的左边到右边依此执行的。
即在语句中左边位置的优先执行，依次从左到右执行。
移位运算符描述举例<< 往左移动指定的位数 A = B << 8>> 往右移动指定的位数 A = B >> 8位运算符描述举例& 位与运算 A = B & 0xf| 位或运算 A = B | C^ 位异或运算 A = B ^ C~ 位取反运算 A = ~B所有运算符的优先权上述所有运算符的优先权从高到低详细如下所述：位于圆括号里面的运算符最优先数学运算符移位和位运算符比较运算符逻辑运算符赋值运算符关键词下面的关键词为宏指令保留使用。
这些均不能用来作为变量名称、数组名称或者函数名称等。
+, -, *, /, %, >=, >, <=, <, <>, ==, and, or, xor, not, <<, >>,=, &, |, ^, ~exit, macro_command, for, to, down, step, next, return, bool, short, int, char, float, void, if, then, else, break, continue, set, sub, end, while, wend, true, falseSQRT, CUBERT, LOG, LOG10, SIN, COS, TAN, COT, SEC, CSC, ASIN, ACOS, ATAN,BIN2BCD, BCD2BIN, DEC2ASCII, FLOAT2ASCII, HEX2ASCII, ASCII2DEC, ASCII2FLOAT, ASCII2HEX, FILL, RAND, DELAY, SWAPB, SWAPW, LOBYTE, HIBYTE, LOWORD, HIWORD, GETBIT, SETBITON, SETBITOFF, INVBIT, ADDSUM, XORSUM, CRC, INPORT, OUTPORT, POW, GetError, GetData, GetDataEx, SetData, SetDataEx30.3语句30.3.1定义语句这个定义语句包含了变量和数组的声明。
正式的格式如下：类型名称当定义一个名称的类型时举例:int A //定义了变量A为双整型格式类型数组名称[数组长度] 当定义数组名称的类型时举例:B[10] 定义了一维数组变量B的长度为10，类型为双整型int30.3.2赋值语句赋值语句使用赋值运算符将赋值运算符右边表达式运算的结果放置到运算符左边的变量中。
一个运算表达式是由变量、常量和各种运算符组成，执行后产生一个新的数据。
变量 = 表达式举例A = 2 这样变量A就被赋值为230.3.3逻辑运算语句逻辑运算语句是根据逻辑(布尔)表达式的结果来执行相应的动作。
它的语句如下所示：单行格式if < Condition > then[Statements]else[Statements]end if举例:if a = = 2 then1=belseb2=end if区块格式If <Condition > then[Statements]else if < Condition- n> then[Statements]else[Statements]end if举例:if a = = 2 thenb1=else if a = = 3=2belse3=bend if语法描述:if 必须用在该语句的开始部分<Condition> 必要条件。
