User manual AMX AXCESS CONTROL SYSTEM PROGRAM

[. . . ] instruction manual Axcess Programming Language So ftw are AMX Limited Warranty and Disclaimer AMX Corporation warrants its products to be free of defects in material and workmanship under normal use for three (3) years from the date of purchase from AMX Corporation, with the following exceptions: · · · · · Electroluminescent and LCD Control Panels are warranted for three (3) years, except for the display and touch overlay components that are warranted for a period of one (1) year. Disk drive mechanisms, pan/tilt heads, power supplies, MX Series products, and KC Series products are warranted for a period of one (1) year. Unless otherwise specified, OEM and custom products are warranted for a period of one (1) year. Batteries and incandescent lamps are not covered under the warranty. This warranty extends only to products purchased directly from AMX Corporation or an Authorized AMX Dealer. [. . . ] There are four types of operators in Axcess: arithmetic, relational, logical, and bitwise. Arithmetic Operators Arithmetic operators create a numeric value from one or more operations, such as addition, multiplication, and division. Arithmetic Operators Symbol Function Symbol Function + * Add Subtract Multiply / % Divide Modulus Here is an example of arithmetic operators in an Axcess program: X=7+5 Y=X*3 In the example above, X = 12 and Y = 36. There is an order of precedence for arithmetic operators; that is, some operations are performed first and others second. For example, multiplication operations (*) are performed before addition operations (+). Here is an example that illustrates this precedence: X=7+5*3 Reading this expression left to right, X = 36. However, since multiplication takes precedence, X = 22 (5 * 3 = 15, and 7 + 15 = 22). For detailed information on precedence, refer to the Precedence Among Operators section on page 51. Relational Operators Relational operators, compare two numeric values and produces a true or false result. Relational Operators Symbol Function < > = Less than Greater than Equal to Symbol Function <= >= <> Less than or equal to Greater than or equal to Not equal to Here is an example of these operators in practice: Axcess Programming Language 47 Operators X = 12 Y = 15 IF (X > Y) (* Statement 1 *) ELSE (* Statement 2 *) Notice that the result of the expression (X > Y) determines the path Axcess takes. Since X is less than Y, Statement 1 is bypassed and Statement 2 is executed. However, if there is no ELSE present, Axcess will skip the statement or compound statement underneath the false relational expression. True and false When a condition or expression is evaluated as true, it is given the value of 1; if the condition or expression is false, it is given the value of Ø. When Axcess encounters an IF, it continues to the next statement only when the result of the IF statement is a non-zero (true) value. Otherwise, Axcess does not execute the statement directly under the IF statement. It is possible, then, to assign a relational expression to a variable. For example: DEFINE_PROGRAM X=9 Z = (X > 5) IF (Z) { SEND_STRING Ø, "'X IS GREATER THAN 5', $ØD, $ØA" } (* X IS GREATER THAN 5 *) In this case, Z will be equal to 1 since the expression (X > 5) is true. As a result, the following IF statement is also true and Axcess executes Statement 1. Only one relational operator should appear within a set of parentheses; two or more of these operators can produce unexpected results. For example: X=5 IF (1Ø > X > 3) { SEND_STRING Ø, "'THIS STATEMENT NEVER GETS EXECUTED', $ØD, $ØA" } In the example above, 10 > X is evaluated first. Since you cannot compare X to two different values in this manner, you should use a logical operator. 48 Axcess Programming Language Operators Logical Operators Logical operators, or Boolean operators, like relational operators produce either true or false result. Instead of using greater or less than signs, logical operators use the following keywords: AND Both conditions must be true for the result to be true. OR At least one of the conditions must be true for the result to be true. XOR Only one condition can be true for the result to be true. If this condition is true, the result is false; if the condition is false, the result is true. The following example demonstrates its use. DEFINE_PROGRAM X=5 Y=1 IF ((X = 5) AND (Y = 4)) { SEND_STRING Ø, "'THIS STATEMENT NEVER GETS EXECUTED', $ØD, $ØA" } ELSE { SEND_STRING Ø, "'THIS STATEMENT DOES GET EXECUTED', $ØD, $ØA" } FIG. [. . . ] (* KEYPAD *) IF(PUSH_CHANNEL>=8Ø AND PUSH_CHANNEL<=89) { (* CODE TO EXECUTE GOES HERE *) } Axcess Keywords Keywords are certain identifiers that are reserved for Axcess commands, functions, and system variables. These are integral to the system and cannot be redefined or used as identifiers. Axcess Keywords #DEFINE #END_IF #IF_DEFINED #IF_NOT_DEFINED #WARN _ _DATE_ _ _ _FILE_ _ _ _LINE_ _ _ _NAME_ _ _ _TIME_ _ _ _VERSION_ _ ACTIVE AND ATOI BAND BNOT BOR BXOR CALL CANCEL_ALL_WAIT CANCEL_ALL_WAIT_UNTIL CANCEL_WAIT CANCEL_WAIT_UNTIL CLEAR_BUFFER CREATE_BUFFER CREATE_LEVEL CREATE_MULTI_BUFFER DATE DAY DEFINE_CALL DEFINE_COMBINE DEFINE_CONNECT_LEVEL DEFINE_CONSTANT DEFINE_DEVICE DEFINE_LATCHING DEFINE_MUTUALLY_EXCLUSIVE DEFINE_PROGRAM DEFINE_START DEFINE_TOGGLING DEFINE_VARIABLE DEVICE_ID DO_PUSH DO_RELEASE ELSE EXTERNAL_CONTROL FIND_STRING GET_BUFFER_CHAR GET_MULTI_BUFFER_STRING GET_PULSE_TIME GET_TIMER IF INCLUDE INTEGER ITOA ITOHEX LEFT_STRING LENGTH_STRING LOCAL_VAR LONG_WHILE LOWER_STRING MASTER_SLOT MEDIUM_WHILE MID_STRING MIN_TO NOT OFF ON OR PAUSE_ALL_WAIT PAUSE_WAIT PROGRAM_NAME PULSE PUSH PUSH_CHANNEL PUSH_DEVICE RANDOM_NUMBER REDIRECT_STRING RELEASE RELEASE_CHANNEL RELEASE_DEVICE REMOVE_STRING RESTART_ALL_WAIT RESTART_WAIT RIGHT_STRING SELECT SEND_COMMAND SEND_LEVEL SEND_STRING SET_LENGTH_STRING SET_PULSE_TIME SET_TIMER SYSTEM_CALL SYSTEM_CALL_NUM TIME TO TOTAL_OFF UPPER_STRING WAIT WAIT_UNTIL WHILE XOR 126 Axcess Programming Language Appendix ASCII Code Chart FIG. 32 ASCII Code Chart Axcess Programming Language 127 Appendix Hexadecimal Chart Abbreviations The following table defines the abbreviated terms in the ASCII chart. [. . . ]