| Instruction | Description | Macro Syntax |
| Control Flow |
| Break | Loop command: Breaks a loop | break |
| End | Loop command: End a loop | end |
| If ... then | Loop command: If...then... | if (Conditional) then |
| else if ... then | Loop command: otherwise, if...then... | else if (Conditional) then |
| Else | Loop command: otherwise | else |
| While ... then | Loop command: continue the loop if the condition holds | while (Conditional) do |
| Goto | Force to skip to the specified line | goto (tag name) |
| For [var = start · end] | Loop command: run increment circulation for the range | for parameter = start value, end value do |
| Comment | comment | -- |
| Conditions |
| == | Determine whether A1 equals to A2 | A1==A2 |
| ~= | Determine whether A1 is not equal to A2 | A1~=A2 |
| > | Determine whether A1 is greater than A2 | A1>A2 |
| < | Determine whether A1 is less than A2 | A1<A2 |
| >= | Determine whether A1 is equal to or greater than A2 | A1>=A2 |
| <= | Determine whether A1 is equal to or less than A2 | A1<=A2 |
| Functions |
| ABS | Calculate the absolute value | A1=ABS (A2) |
| ADD | Addition | A1=ADD (A2 · A3) |
| AND | Logic AND | A1=AND (A2 · A3) |
| ASC | Convert Hex to ASCII | A1=ASC (A2) |
| BCD | Convert BIN to BCD | A1=BCD (A2) |
| BIN | Convert BCD to BIN | A1=BIN (A2) |
| BMOV | Move blocks | BMOV (A1 · A2 · A3) |
| BMOVB | Move bit blocks | BMOVB (A1 · A2 · A3 · A4 · A5) |
| COS | Trigonometric function (Cosine function) COS | A1=COS (A2) |
| COT | Trigonometric function (Cotangent function) COT | A1=COT ( A2 ) |
| CSC | Trigonometric function (Cosecant function) CSC | A1=CSC ( A2 ) |
| DELAY | Delay in milliseconds | DELAY ( A1 ) |
| DIV | Division | A1=DIV ( A2 · A3 ) |
| FG | Return the corresponding value of the coordinates | A1 = FG(A2, A3, A4) |
| FILL | Fill up the memory | FILL ( A1 · A2 · A3 ) |
| HEX | Convert ASCII to Hex | A1=HEX ( A2 ) |
| INV | Inverse the lowest bit | A1=INV ( A2 ) |
| INVB | Specify inverse bits | A1=INVB ( A2 · A3 ) |
| IRD | Indirect read | A1=IRD ( A2 · A3 ) |
| IWR | Indirect write | IWR ( A1 · A2 · A3 ) |
| LG | Find the larger value | A1=LG ( A2 · A3 ) |
| LOG | Calculate natural log of the parameter value | A1=LOG ( A2 ) |
| LOG10 | Calculate natural log with 10 as base of the parameter value | A1=LOG10 ( A2 ) |
| MAX | Find the maximum | A1=MAX ( A2 · A3 ) |
| MEAN | Calculate the average value | A1=MEAN ( A2 · A3 ) |
| MIN | Find the minimum | A1=MIN ( A2 · A3 ) |
| MMOV | Move item by item | MMOV(A1,A2,A3,A4,A5,A6,...) |
| MOD | Division and take remainder | A1=MOD ( A2 · A3 ) |
| MOVB | Move bits | MOVB (A1 · A2 · A3 · A4) |
| NEG | Take the complement of 2 for the parameter value | A1=NEG ( A2 ) |
| NOT | Logic NOT | A1=NOT ( A2 ) |
| OR | Logic OR | A1=OR ( A2 · A3 ) |
| P2R | Write PLC value to the recipe | P2R ( A1 · A2 · A3 · A4 · A5 ) |
| R2P | Write the recipe value to PLC | R2P ( A1 · A2 · A3 · A4 · A5 ) |
| R2PS | Write multiple recipe values to PLC | R2PS ( A1 · A2 · A3 · A4 · A5 · A6 ) |
| R2R | Copy the recipe | R2R(A1,A2,A3) |
| R2T | Write the data of recipe A to recipe B | R2T(A1, A2, A3, A4, A5, A6, A7 |
| RCNT | Obtain the quantity of the recipe | RCNT(A1) |
| RDB | Read the nth digit of the parameter | A1=RDB ( A2 · A3 ) |
| RN2P | Write the recipe name to a string tag | RN2P ( A1 · A2 · A3 ) |
| RNID | Search for recipe name | A3=RNID ( A1 · A2 ) |
| RST | Clear the lowest bit | A1=RST ( A2 ) |
| RSTB | Clear the specified bit | A1=RSTB ( A2 · A3 ) |
| RSTR | Clear the recipe log | A1=RSTR ( A2 · A3 ) |
| SCMP | Compare strings | A1=SCMP ( A2 · A3 · A4 ) |
| SEC | Trigonometric function (Secant function) SEC | A1=SEC ( A2 ) |
| SET | Set the lowest bit | A1=SET ( A2 ) |
| SETB | Set the specified bit | A1=SETB ( A2 · A3 ) |
| SHL | Shift the bit to the left | A1=SHL ( A2 · A3 ) |
| SHR | Shift the bit to the right | A1=SHR ( A2 · A3 ) |
| SIN | Trigonometric function (Sine function) SIN | A1=SIN ( A2 ) |
| SM | Find the smaller value | A1=SM ( A2 · A3 ) |
| SUB | Subtraction | A1=SUB ( A2 · A3 ) |
| SUM | Calculate the sum | A1=SUM ( A2 · A3 ) |
| SWAP | Swap endianness | A1=SWAP ( A2 ) |
| SYNC | Sync and update data to PLC | SYNC ( A1 ) |
| SYNCB | Sync and update all data to PLC | SYNCB ( ) |
| T2R | Send the data from the tag to recipe | T2R(A1, A2, A3, A4) |
| TAN | Trigonometric Function (Tangent Function) TAN | A1=TAN ( A2 ) |
| WRB | Determination of zero | A1=WRB ( A2 · A3 · A4 ) |
| XOR | Logic XOR | A1=XOR ( A2 · A3 ) |
| Math Operation |
| = | Equal | A1=A2 |
| + | Addition | A1=A2+A3 |
| — | Subtraction | A1=A2-A3 |
| * | Multiplication | A1=A2*A3 |
| / | Division | A1=A2/A3 |
| % | Division and take the remainder | A1=A2%A3 |
| () | Call the macro | Macro name () |
# 21.2 Macro Manager
Select 【Macro Manager】 in the item group 【General Settings】 under the tab 【Setting】
# 21.2.1 Macro Manager
D. Screen Name: display all the screens in the project.
【Global】: represents that the macro will run based on the set time condition no matter which screen it is on.
【Screen】: represents that the macro will only run based on the set time conditions when stayed on that screen.
Remark: Beside sub screens, every screen can set the condition for running macro.
E.【Open】: macro will only run once when the screen is opened. If 【Global】 is being set, then the macro will only run once when the project is being activated.
F.【Loop】: macro will run periodically when opening the screen based on the time
interval set below. If 【Global】 is being set, then macro will continue to run periodically after the project is being activated.
G. 【Close】: macro will only run once before closing the screen. If 【Global】 is being set, then macro will run once before the project is being closed.
# 21.2.2 Example of Macro Program-Default Parameter Setting
Based on the example exercises in previous chapter, such as the exercise for system control tags in chapter 3 and the exercise for alarm in chapter 13, they will create problems such as alarm messages or changing the backlight to dark when electricity was resent to HMI every time. You can ensure that start-up to be normal by using macro to initialize.
a. 【Tag Setting】: keep using the tags in the exercises of chapter 3 【System Control Tag】 and chapter 13 【Alarm Service】.
b. 【Macro Editor】: add a new macro. Set the macro name as 【Initial parameters】. The macro program is shown in the figure below:
c. 【Macro Manager】: set the screen name as【Global N/A】 and then select themacro name 【Initial parameters】 in 【Open】.
# Simulation & Verification:
When macro is not being performed, the display language on the screen will be English when HMI runs the project every time after HMI is being powered on again. Since the trigger condition for the alarm is being satisfied, so it will create sub screens for the alarm.
After running the macro, , the display language on the screen will be 繁體中文 when HMI runs the project every time after HMI is being powered on again. Since the trigger condition for the alarm is not being satisfied, so it will not create sub screens for the alarm and the backlight will be displayed as the brightest.
# 21.2.3 Example of Macro Program－Unit Conversion
Unit conversion has been commonly set as macro program. In this example, temperature in Celsius is converted to temperature in Fahrenheit.
a. In 【Tags】, add 2 tags with their names defined as 【Temperature in Celsius】 and 【Temperature in Fahrenheit】 and specify their corresponding addresses 【@70】 and 【@71】, respectively. Set type as INT (16).