Skip to Content

Wiki source code of 08 Macro Script

Version 6.1 by Stone Wu on 2022/08/02 14:20
Show last authors
1 This chapter provides information about scripts in PIStudio.
2
3 = **Script type** =
4
5 Script is applied to realize complex control functions. HMI compile software provide powerful function, simple operation, reliable script system, the features of script are list as follow:
6
7 Similar to BASIC grammatical structure;
8
9 * BASIC work as the first computer language for the general public, it is easy and efficient to use.
10
11 Support all of program logic control structures;
12
13 * Software script supports three logic control structures: order, condition, loops. It could realize complexity procedures.
14
15 Powerful function; Functions of script are divided into two types: system and custom function.
16
17 * System function: the functions that system has been predefined for users.
18 * Custom function: users could define a function and apply to all scripts.
19
20 Support variety of data format;
21
22 * Script supports integer, floating, BCD code, byte, string and etc.
23
24 **Scripts Running Method**
25
26 1. **Background Script:** Run independently during start project, screen updates have no influence and valid of all scripts.
27 1. **Screen Script:** Only run under the designated screen. Screen script start running until screen is closed or switched.
28
29 And both screen and background have four modes for script
30
31 (% class="table-bordered" %)
32 |=**Property**|=**Description**
33 |Initialize|The script would be executed once during loading project.
34 |Close|The script would be run once during closing HMI project.
35 |Timing|The script would run under certain conditions after the HMI is started, until the condition ends.
36 |Bit trigger|Script would be repeat executed when meet the condition of bit trigger.
37
38 == Initialize ==
39
40 Initialize script divided into screen initialize script and background initialize script. Screen initialize script runs once during the initialization of screen; background initialize script runs during the loading of project.
41
42 **Operating procedures**
43
44 Click "Background script" in project manager to enter script editor screen, or click "Screen script" in right click menu of screen to enter script editor screen;
45
46 (% style="text-align:center" %)
47 [[image:9.Scripts_html_96fb2991c0580f0f.gif||class="img-thumbnail"]]
48
49
50 (% style="text-align:center" %)
51 [[image:9.Scripts_html_3cebb8edeabbd760.gif||class="img-thumbnail"]]
52
53 Double click "initialize" to open script edit window, as below shows;
54
55 (% style="text-align:center" %)
56 [[image:9.Scripts_html_8d93c592be893fad.gif||class="img-thumbnail"]]
57
58 Enter scripts in edit window;
59
60 == Close ==
61
62 Close script divided into screen close script and background close script. Screen close script runs once During the destroying of screen because of closing or switching; background close script runs during the closing of project (such as restart HMI, into HMI setup).
63
64 **Operating procedures**
65
66 1. Click "Background script" in project manager to enter script editor screen, or click "Screen script" in right click menu of screen to enter script editor screen;
67 1. Double click "Close" to open script edit window;
68 1. Enter scripts in edit window;
69
70 == Timing ==
71
72 The script would run for a designated time interval.
73
74 **Operating procedures of creating one**
75
76 Click "Background script" in project manager to enter script editor screen, or click "Screen script" in right click menu of screen to enter script editor screen;
77
78 Double click "Timing", it would pop-up below setting window;
79
80 (% style="text-align:center" %)
81 [[image:9.Scripts_html_ca0d08792c31539e.gif||class="img-thumbnail"]]
82
83 (% class="table-bordered" %)
84 |=**Property**|=**Description**
85 |Cycle|Script runs at designated time interval, unit is 10 ms.
86 |Ok|Script created.
87 |Cancel|Cancel the current script setting.
88
89 Enter scripts in edit window;
90
91 **Operating procedures of editing**
92
93 1. Click "Background script" in project manager to enter script editor screen, or click "Screen script" in right click menu of screen to enter script editor screen;
94 1. Select "Timing", and click [[image:9.Scripts_html_d1db672f9b0fe31.gif]] to modify the script execution interval;
95 1. Double click selected "Timing" to open editing window;
96
97 **Operating procedures of deleting**
98
99 Click "Background script" in project manager to enter script editor screen, or click "Screen script" in right click menu of screen to enter script editor screen;
100
101 (% style="text-align:center" %)
102 [[image:9.Scripts_html_f7b5302abd3000e3.gif||class="img-thumbnail"]]
103
104 Select "Timing", and click  [[image:9.Scripts_html_75dc3ed25fdbc359.gif]] to change interval of script, it pops-up above window
105
106 Select "Yes" to execute operation or select "No" to cancel operation;
107
108 (% class="box infomessage" %)
109 (((
110 **✎Note:** The maximum number of timing script for each screen or background is 32.
111 )))
112
113 == Trigger bit ==
114
115 **Introduction**
116
117 Trigger control script is that software will check whether the designated bit meet trigger condition every 20ms. Script execute once condition is met until project closed.
118
119 **Operating procedures of creating one**
120
121 Click "Background script" in project manager to enter script editor screen, or click "Screen script" in right click menu of screen to enter script editor screen;
122
123 Double click "Trigger bit", it pops-up below setting window;
124
125 (% style="text-align:center" %)
126 [[image:9.Scripts_html_5aa68df50f16cfa2.gif||class="img-thumbnail"]]
127
128 * Bit address: It sets trigger address for script;
129 * Condition: detailed information as below shows;
130
131 (% class="table-bordered" %)
132 |=**Condition**|=**Description**
133 |TRUE|Script execute once the bit value is TRUE, detects the bit every per approximately 20 ms;
134 |FALSE|Script execute once the bit value is FALSE, detects the bit every per approximately 20 ms;
135 |Bit changed|Execute once the trigger bit switches state;
136 |Rising|Script execute once the bit value from FALSE to TRUE, detects the bit every per approximately 20 ms;
137 |Falling|Script execute once the bit value from TURE to FALSE, detects the bit every per approximately 20 ms;
138
139 Set trigger bit and condition, click "OK" to open editing window.
140
141 **Operating procedures of editing**
142
143 * Click "Background script" in project manager to enter script editor screen, or click "Screen script" in right click menu of screen to enter script editor screen;
144 * Select "Trigger script", and click [[image:9.Scripts_html_d1db672f9b0fe31.gif]] to change trigger bit and condition;
145 * Double click selected "Trigger script" to open editing window.
146
147 **Operating procedures of deleting**
148
149 * Click "Background script" in project manager to enter script editor screen, or click "Screen script" in right click menu of screen to enter script editor screen;
150 * Select "Trigger script", and click [[image:9.Scripts_html_75dc3ed25fdbc359.gif]] to change interval of script, it pops-up below window
151
152 (% style="text-align:center" %)
153 [[image:9.Scripts_html_f7b5302abd3000e3.gif||class="img-thumbnail"]]
154
155 * Select "Yes" to execute operation or select "No" to cancel operation;
156
157 (% class="box infomessage" %)
158 (((
159 **✎Note:** The maximum number of trigger script for each screen or background is 32.
160 )))
161
162 == Background function ==
163
164 Global function is a collection of codes;it can be called in any script.The method reference system function;
165
166 **Operating procedures**
167
168 Double click "Background function" in project manager;
169
170 (% style="text-align:center" %)
171 [[image:9.Scripts_html_6240f0610ba63eff.gif||class="img-thumbnail"]]
172
173 Set parameters;
174
175 (% style="text-align:center" %)
176 [[image:9.Scripts_html_d196f8a817949f3e.gif||class="img-thumbnail"]]
177
178 (% class="table-bordered" %)
179 |**Property**|**Description**
180 |Function name|Function name could not be the same as existing.
181 |Return type|None, string, integer, float.
182 |Parameter 1|The name of parameter 1.
183
184 **Operating procedures of editing**
185
186 * Click "Background function" in project manager to enter script editor screen;
187 * Select Function name, and click [[image:9.Scripts_html_c653b64bc266a016.gif]] to change parameters;
188 * Double click selected "Trigger script" to open editing window;
189
190 **Operating procedures of deleting**
191
192 * Click "Background function" in project manager to enter script editor screen;
193 * Select Function name, and click  [[image:9.Scripts_html_75dc3ed25fdbc359.gif]] to change interval of script, it pops-up below window
194
195 (% style="text-align:center" %)
196 [[image:9.Scripts_html_f7b5302abd3000e3.gif||class="img-thumbnail"]]
197
198 * Select "Yes" to execute operation or select "No" to cancel operation;
199
200 (% class="box infomessage" %)
201 (((
202 **✎Note:** The maximum parameters for each function are 4, and parameter name can't be unique;
203 )))
204
205 = Script usage =
206
207 Script can make project more convenient and flexible. Script is useful in realizing complex HMI function. If the script is used improperly, it may affect the efficiency of entire project. So pay attention to the follow issues:
208
209 * Do not use too much script loops, if the script loops that execute too many times; it might influence the efficiency of HMI.
210 * In the cycle scripts, avoid using external register, due to the relatively slow serial communication, frequent access to external registers may cause the execution of scripts severely reduced, even influence the screen respond efficiently. There is fine to use internal register.
211 * The maximum script length is 512 rows.
212
213 This section describes how to edit scripts and use some of the accompanying tools and features of the script editor.
214
215 == **Script access to d evice** ==
216
217 Software script supports an efficiency way to access the device address by using symbol @.
218
219 (% class="table-bordered" %)
220 |=**Writing**|=**Meaning**|=**Examples**
221 |@B_;@b_;|Access designated bit address|(((
222 @B_I0.0:access bit address I0.0
223
224 @b_HDX0.0:access bit address HDX0.0
225 )))
226 |@W_;@w_;|(% rowspan="2" %)(((
227 Access designated word address
228
229 HMI connect more than automatic control devices, "#"stands for choosing number before the symbol,":"stands for accessing the station number before symbol.
230
231 Access the first protocol without "#",access default station number1 without":".
232 )))|(((
233 @W_IW0:access word address IW0
234
235 @b_HDW0:access word address HDW0
236 )))
237 |@B_(the number of protocol connection)#(station number):address|(((
238 @B_2#2:I0.0:access the bit address I0.0, with the connection number 2 and station number 2;
239
240 @B_I0.0:access to bit address I0.0;
241 )))
242
243 The script can access with the device though: write and read.
244
245 **For example**
246
247 {{code language="lua"}}
248 If @B_HDX0.0 = 1 then 'read the value from address HDX0.0.
249
250 @B_HDX0.0 = 0 'write 0 to address HDX0.0
251
252 Else
253
254 @B_HDX0.0 = 1 'write 1 to address HDX0.0
255
256 Endif
257
258 @W_QW0 = @W_QW0 + 1 'read data from address QW0, add 1 to this value then write to address QW0
259 {{/code}}
260
261 == **Grammar checking** ==
262
263 **Operating procedures**
264
265 1. Select [[image:9.Scripts_html_2a530bda982b4281.gif]] from script tool bar;
266 1. System does not prompt grammar error if grammar is correct, or system will list all errors;
267 1. Check error information, and modify errors;
268
269 **Error information**
270
271 ~1. Identifier ~*~** contains invalid characters
272
273 2. Attempt to redeclare sub ~*~**
274
275 3. Attempt to redeclare function ~*~**
276
277 4. Attempt to use reserved word ~*~** as identifier
278
279 5. Attempt to use type ~*~** as identifier
280
281 6. Unexpected ')' while parsing arguments for function ~*~**
282
283 7. Could not parse expression (one of the arguments of function ~*~**)
284
285 8. Could not parse arguments of ~*~**
286
287 9. Too many arguments for function ~*~**
288
289 10. Not enough arguments for function ~*~**
290
291 ~11. '(' expected after sub name ~*~**
292
293 12. Unexpected '(' while parsing arguments for sub ~*~**
294
295 13. Could not parse expression (one of the arguments of sub ~*~**)
296
297 14. Could not parse arguments of ~*~**
298
299 15. Too many arguments for sub/function ~*~**
300
301 16. Not enough arguments for sub/function ~*~**
302
303 17. Could not parse expression
304
305 18. '(' expected after function name ~*~**
306
307 19. Unexpected use of sub ~*~** as a part of expression
308
309 20. Illegal statements preceding subs/functions declaration
310
311 21. Unexpected end of file while looking for 'endsub'
312
313 22. End of line expected after 'else'.
314
315 23. End of line expected after 'endif'.
316
317 24. End of line expected after 'next'.
318
319 25. End of line expected after 'wend'.
320
321 26. 'while', 'until' or end of line expected afte r'do'.
322
323 27. Could not parse expression after 'while'
324
325 28. Could not parse expression after 'until'
326
327 29. 'do' without 'loop'
328
329 30. Sub ~*~** contains invalid character'@'
330
331 31. Sub ~*~** already declared
332
333 32. Function ~*~** already declared
334
335 33. Sub name expected after 'sub'
336
337 34. Function name expected after 'function'
338
339 35. Variable name expected
340
341 36. Argument ~*~** contains invalid character '@'
342
343 37. 'integer', 'floating' or 'string' expected
344
345 38. ''',' or ')' expected
346
347 39. 'endsub' without 'sub'
348
349 40. 'end function' without 'function'
350
351 41. End of line expected after 'beep'
352
353 42. 'dim' unexpected here
354
355 43. Variable name expected after 'dim'
356
357 44. 'as' expected after variable name
358
359 45. 'integer' 'floating' or 'string' expected after 'as'
360
361 46. ',' or end of line expected after type in dim statement
362
363 47. Could not parse expression after 'while'
364
365 48. End of line expected after' while' condition
366
367 49. 'while' without 'wend'
368
369 50. End of line expected after 'wend'
370
371 51. 'wend' without 'while'
372
373 52. Variable name expected after' for'
374
375 53. '=' expected after variable name
376
377 54. Could not parse expression after 'for'
378
379 55. 'to' expected
380
381 56. Could not parse expression after 'to'
382
383 57. Could not parse expression after 'step'
384
385 58. End of line expected
386
387 59. 'for' without 'next'
388
389 60. End of line expected after 'next'
390
391 61. 'Next' without 'for'
392
393 62. Could not parse expression after'if'
394
395 63. 'then' expected
396
397 64. Unexpected end of file while looking for 'endif'
398
399 65. Unexpected end of file while looking for 'else' or 'endif'
400
401 66. 'else' without ‘if'
402
403 67. 'end if' without 'if'
404
405 68. Label name expected after 'goto'
406
407 69. Unexpected end of line while looking for ')' in function call
408
409 70. ',' expected
410
411 71. Missing ')'
412
413 72. Unexpected end of line in expression
414
415 73. Unexpected end of file in expression
416
417 = **Script function list** =
418
419 == **Mathematical** ==
420
421 (% class="table-bordered" %)
422 |=(% style="width: 181px;" %)**Function**|=(% style="width: 1308px;" %)**Introduction**
423 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Abs__|(% style="width:1308px" %)Get absolute value
424 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Acos__|(% style="width:1308px" %)Compute the inverse cosine value
425 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Asc__|(% style="width:1308px" %)Return the first character of the string in ASCII value
426 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Asin__|(% style="width:1308px" %)Calculate the arcsine value
427 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Atan__|(% style="width:1308px" %)Return an arctangent value,the radian ranges -pi/2 to pi/2
428 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Atan2__|(% style="width:1308px" %)Return the arctangent value
429 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Cos__|(% style="width:1308px" %)Return a cosine value of an angle
430 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Exp__|(% style="width:1308px" %)Returns the power value of e (natural logarithm)
431 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Hypot__|(% style="width:1308px" %)Calculate the value of the hypotenuse of a right triangle
432 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Tan__|(% style="width:1308px" %)Implement tan calculation to computing the value
433 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Sin__|(% style="width:1308px" %)Implement sin calculation to computing the value
434 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Sqr__|(% style="width:1308px" %)Assign a square root value
435 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SignedInt16__|(% style="width:1308px" %)Assign the value to [val] from address A1 which is signed integer
436 |(% style="width:181px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SignedInt32__|(% style="width:1308px" %)Assign the value to [val] from address A1 which is signed even integer
437
438 == **Data migration** ==
439
440 (% class="table-bordered" %)
441 |=(% style="width: 178px;" %)**Function**|=(% style="width: 1311px;" %)**Introduction**
442 |(% style="width:178px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__BMOV__|(% style="width:1311px" %)Copy data with a designated length from source address
443 |(% style="width:178px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__FILL__|(% style="width:1311px" %)Write the same value to designated address constantly
444 |(% style="width:178px" %)(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SetKeyMap__|(% style="width:1311px" %)The key values of the keyboard are mapped so that multiple keyboard buttons perform the same function
445
446 == **Process control** ==
447
448 (% class="table-bordered" %)
449 |(% style="width:181px" %)**Function**|(% style="width:1308px" %)**Introduction**
450 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__GOTO__>>path:#_Goto]]|(% style="width:1308px" %)Go to the designated row unconditionally in a function body
451 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__FOR__>>path:#_For._to._step.]]|(% style="width:1308px" %)Execute a command repeatedly for designated times
452 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__END__>>path:#_End]]|(% style="width:1308px" %)End the execution of script
453 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__while__>>path:#_WHILE_..._WEND]]|(% style="width:1308px" %)If the condition is true, then all the commands before Wend in the statement will be executed and then recheck the condition, if the condition is false, the command after Wend will be executed
454
455 == **Data Conversion** ==
456
457 (% class="table-bordered" %)
458 |(% style="width:182px" %)**Function**|(% style="width:1307px" %)**Introduction**
459 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__A2H__>>path:#_A2H]]|(% style="width:1307px" %)Convert string A1 to hexadecimal number
460 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Asfloating__>>path:#_AsFloating]]|(% style="width:1307px" %)Convert parameter to a float
461 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__AsInteger__>>path:#_AsInteger]]|(% style="width:1307px" %)Convert parameter to a integer
462 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__AsString__>>path:#_AsString]]|(% style="width:1307px" %)Convert parameter to a string
463 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__B2W__>>path:#_B2W]]|(% style="width:1307px" %)Convert an array
464 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__BCD__>>path:#_BCD]]|(% style="width:1307px" %)Convert binary to BCD, save the result as return value
465 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__BIN__>>path:#_BIN]]|(% style="width:1307px" %)Convert BCDto binary, save the result in return value
466 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Chr__>>path:#_Chr]]|(% style="width:1307px" %)Convert integer parameter into correspond ASCII character,return the character string
467 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__D2F__>>path:#_D2F]]|(% style="width:1307px" %)Convert the 32 bit integer format data to float then output the result
468 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__D2Float__>>path:#_D2Float]]|(% style="width:1307px" %)Convert the designated value to floating then assign to variable
469 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__D2Int__>>path:#_D2Int]]|(% style="width:1307px" %)Output the 32-bit integer in the form of integer
470 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__DegToRad__>>path:#_DegToRad]]|(% style="width:1307px" %)Convert the angle into correspond radian, and display
471 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__F2D__>>path:#_F2D]]|(% style="width:1307px" %)Convert a 32 bit floating to integer format, and then output the result
472 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__F2S__>>path:#_F2S]]|(% style="width:1307px" %)Output a format of floating that in the type of string
473 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Float2D__>>path:#_Float2D]]|(% style="width:1307px" %)Copy floating value to the address
474 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__H2A__>>path:#_H2A]]|(% style="width:1307px" %)Convert a binary(16 bit) to hexadecimals(4 bit) of ASCII
475 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Int2D__>>path:#_Int2D]]|(% style="width:1307px" %)Write the 32-bit integer into the specified address
476 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__LCase__>>path:#_Lcase]]|(% style="width:1307px" %)Convert all parameters to lowercase strings
477 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__MAX__>>path:#_MAX]]|(% style="width:1307px" %)Compare the value of A2 and A3, assign the greater number to A1
478 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__MIN__>>path:#_MIN]]|(% style="width:1307px" %)Compare the value of A2 and A3, assign the smaller number to A1
479 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__RadToDeg__>>path:#_RadToDeg]]|(% style="width:1307px" %)Convert radiant value to degree
480 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__S2F__>>path:#_S2F]]|(% style="width:1307px" %)Convert string to floating in the specified format
481 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SWAP__>>path:#_SWAP]]|(% style="width:1307px" %)Exchange the high and low bytes of the parameter
482 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__W2B__>>path:#_W2B]]|(% style="width:1307px" %)Combine the high byte of the value of two consecutive addresses into a new value
483 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__W2D__>>path:#_W2D]]|(% style="width:1307px" %)Convert the unsigned Word to unsigned Dword and save the result
484 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__W2F__>>path:#_W2F]]|(% style="width:1307px" %)Convert a 16bit integer to a 32bit floating, and then save to the next word address
485 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__W2S__>>path:#_W2S]]|(% style="width:1307px" %)Convert integer word text as S1 format, and then save
486
487 == **String Processing** ==
488
489 (% class="table-bordered" %)
490 |(% style="width:180px" %)**Function**|(% style="width:1309px" %)**Introduction**
491 |(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__A2I__>>path:#_A2I]]|(% style="width:1309px" %)A string of length is intercepted from A1 and converted to a single/double word integer, and then this integer is assigned to A2
492 |(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__InStr__>>path:#_InStr]]|(% style="width:1309px" %)Return the position of str1 in str2
493 |(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__LEFT__>>path:#_Left]]|(% style="width:1309px" %)Return a string of the specified length from the left side of parameter
494 |(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Len__>>path:#_Len]]|(% style="width:1309px" %)Return the string length
495 |(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__LTrim__>>path:#_LTrim]]|(% style="width:1309px" %)Remove the left empty part of the string and return
496 |(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Mid__>>path:#_Mid]]|(% style="width:1309px" %)Returns a string contain a specified characters length from a string
497 |(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Right__>>path:#_Right]]|(% style="width:1309px" %)Return a string of the specified length from the right side of parameter
498 |(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__RTrim__>>path:#_RTrim]]|(% style="width:1309px" %)Clear the empty part on the right side of string [str], then assign the empty part to val
499 |(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Trim__>>path:#_Trim]]|(% style="width:1309px" %)Return a value of an address without empty string next to it
500 |(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__UCase__>>path:#_UCase]]|(% style="width:1309px" %)Capitalize the string data, and then assign the value to val
501
502 == **Fixed Constant** ==
503
504 (% class="table-bordered" %)
505 |**Function**|**Introduction**
506 |[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Pi__>>path:#_Constant]]|pi = 3.14159265358979321
507 |True|TRUE = 1
508 |False|FALSE = 0
509 |[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Operator__>>path:#_Operator]]|Operator in scripts edit window
510 |[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Variable__>>path:#_Variable]]|A variable is any factor, trait, or condition that can exist in differing amounts or types
511
512 == **Bit Control** ==
513
514 (% class="table-bordered" %)
515 |(% style="width:178px" %)**Function**|(% style="width:1311px" %)**Introduction**
516 |(% style="width:178px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__ClrB__>>path:#_Clrb]]|(% style="width:1311px" %)Set the bit of A1 as FALSE
517 |(% style="width:178px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__InvB__>>path:#_InvB]]|(% style="width:1311px" %)The state of inverse bit
518 |(% style="width:178px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SetB__>>path:#_SetB_sub]]|(% style="width:1311px" %)Set the bit A1 ON
519
520 == **File Operation** ==
521
522 (% class="table-bordered" %)
523 |(% style="width:177px" %)**Function**|(% style="width:1312px" %)**Introduction**
524 |(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__HmiRegOperator__>>path:../input/9.Scripts.odt/%5Cl%20]]|(% style="width:1312px" %)Data of Upload/ Download address
525 |(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__CopyFile__>>path:../input/9.Scripts.odt/%5Cl%20]]|(% style="width:1312px" %)Copy the A3 file from the A1 directory to the A2 directory according to the format of A4 and A5
526 |(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__DbToCsvFile__>>path:../input/9.Scripts.odt/%5Cl%20]]|(% style="width:1312px" %)Convert db (database file) file to csv format and export it
527 |(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__FileCmpDir__>>path:#HFileCmpDir]]|(% style="width:1312px" %)The filename input and the filename in the folder whether is duplicate or not
528 |(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__MyDeleteFile__>>path:#HMyDeleteFile]]|(% style="width:1312px" %)Delete the designated file
529 |(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__WriteWordToFile__>>path:#HWriteWordToFile]]|(% style="width:1312px" %)Write data with designated length to designated file
530 |(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__ReadWordFormFile__>>path:#HReadWordFormFile]]|(% style="width:1312px" %)Read data with designated length from designated file
531
532 == **Comparison** ==
533
534 (% class="table-bordered" %)
535 |(% colspan="2" style="width:389.5px" %)**Function**|(% style="width:691.5px" %)**Introduction**
536 |(% rowspan="8" style="width:255.281px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__IF... THEN GOTO..__>>path:#_IF_..._THEN]](%%).|(% style="width:148.719px" %)IF=|(% rowspan="18" style="width:691.5px" %)Execute correspond instruction when fulfill condition. Condition will be tested during executing if. it will execute the next instruction block of then, if condition is true. Otherwise, execute the later of else. Complete the two instructions, next execute the later of End if.
537 |(% style="width:148.719px" %)IF<>
538 |(% style="width:148.719px" %)IF>
539 |(% style="width:148.719px" %)IF>=
540 |(% style="width:148.719px" %)IF<
541 |(% style="width:148.719px" %)IF<=
542 |(% style="width:148.719px" %)IF AND=0
543 |(% style="width:148.719px" %)IF AND<>0
544 |(% rowspan="8" style="width:255.281px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__IF__>>path:#_IF_..._THEN]]|(% style="width:148.719px" %)IF=
545 |(% style="width:148.719px" %)IF<>
546 |(% style="width:148.719px" %)IF>
547 |(% style="width:148.719px" %)IF>=
548 |(% style="width:148.719px" %)IF<
549 |(% style="width:148.719px" %)IF<=
550 |(% style="width:148.719px" %)IF AND=0
551 |(% style="width:148.719px" %)IF AND<>0
552 |(% colspan="2" style="width:389.5px" %)ELSE
553 |(% colspan="2" style="width:389.5px" %)ENDIF
554
555 == **Application Type** ==
556
557 (% class="table-bordered" %)
558 |(% style="width:181px" %)**Function**|(% style="width:1308px" %)**Introduction**
559 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__AddrStringCompare__>>path:#_AddrStringCompare]]|(% style="width:1308px" %)Compare the designated length of two character strings
560 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__beep__>>path:#_Beep]]|(% style="width:1308px" %)Enable buzzer
561 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__IsFloating__>>path:#_IsFloating]]|(% style="width:1308px" %)whether a parameter is floating, return TRUE if it is floating, otherwise return FALSE
562 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__IsInteger__>>path:#_IsInteger]]|(% style="width:1308px" %)whether a parameter(A1) is integer, return TRUE if the parameter is integer, otherwise return FALSE
563 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Log__>>path:#_Log]]|(% style="width:1308px" %)Log function: return the natural logarithm of the value
564 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Log10__>>path:#_Log10]]|(% style="width:1308px" %)Log function: return the natural logarithm of the value
565 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__MSeconds__>>path:#_MSeconds]]|(% style="width:1308px" %)Display the current microseconds of system
566 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__NewNoAddr__>>path:#_NewNoAddr]]|(% style="width:1308px" %)At the basic of source address A2,offset designated length,obtain a new address A1
567 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__NewStatAddr__>>path:#_NewStatAddr]]|(% style="width:1308px" %)At the basic of source address A2,offset the designated length,to obtain a new station A1.
568 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__NStringCompare__>>path:#_NStringCompare]]|(% style="width:1308px" %)Compare whether the designated length of two strings is the same,return 1 to A1 if yes,otherwise return 0
569 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Power__>>path:#_Power]]|(% style="width:1308px" %)The value of [expr2] to the power of [expr1] will be assigned to Var
570 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Rand__>>path:#_RAND]]|(% style="width:1308px" %)Generate a random number
571 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__ReadAddr__>>path:#_ReadAddr]]|(% style="width:1308px" %)Assign the value in the specified address to [word]
572 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SleepA__>>path:#_SleepA]]|(% style="width:1308px" %)Wait time T(ms)
573 |(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__WriteAddr__>>path:#_WriteAddr]]|(% style="width:1308px" %)Assign the value from A2 to address A1
574
575 == **Others** ==
576
577 (% class="table-bordered" %)
578 |(% style="width:182px" %)**Function**|(% style="width:1307px" %)**Introduction**
579 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Dim...as...__>>path:#_DIM_..._AS]]|(% style="width:1307px" %)Declare a variable
580 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__do__>>path:#_DO_..._LOOP]]|(% style="width:1307px" %)Condition determent instruction
581 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Function__>>path:#_Function]]|(% style="width:1307px" %)Differ from internal function, need to declare the name, parameter, code of the function
582 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Sub__>>path:#_Sub]]|(% style="width:1307px" %)Declare the name, parameters and codes of the Sub (sub function)
583 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__PrintText__>>path:#_PrintText]]|(% style="width:1307px" %)Output the contents to the printer for printing
584 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__PI_GetTickCount__>>path:#_PI_GetTickCount]]|(% style="width:1307px" %)Write the starting time in the set address as a 32-bit integer
585 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__StAndFtChange__>>path:#_StAndFtChange]]|(% style="width:1307px" %)Calculate the number of seconds from January 1, 1970 to the current time
586 |(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__GetServerDelayInfo__>>path:#_GetServerDelayInfo]]|(% style="width:1307px" %)Convert string to hexadecimal number
587
588 = **Function Description** =
589
590 == **A2H** ==
591
592 **Function**
593
594 Val = A2H(A1)
595
596 **Description**
597
598 Convert string in the specified address to a hexadecimal number;
599
600 **Parameters**
601
602 **A1:** Source data, only convert the first four digits of string
603
604 **Val:** The value is hexadecimal number.
605
606 **Example**
607
608 //@W_HDW20=A2H(@W_HDW10) ' convert the string of HDW10 to hex then save in HDW20.//
609
610 **Input:** @W_HDW10=255
611
612 **Result:** @W_HDW20=255
613
614 **✎Note:**
615
616 A1 needs to be address (such as:@W_HDW000002).
617
618 Only [0~~1], [a~~f] can be converted, others will be converted to 0
619
620 == **A2I** ==
621
622 **Function**
623
624 A2I (A1, A2, length, S)
625
626 **Description**
627
628 Intercept a string of the specified length from A1,convert it to a single/double word integer and assign this integer to A2.
629
630 **Parameters**
631
632 **A1:** String to be intercepted
633
634 **A2:** The final integer value
635
636 **Length:** intercepts the length of the string
637
638 **S:** Control single or double words.
639
640 S=0, indicating an integer single word; S=1, indicating an integer double word.
641
642 **Return value:** none
643
644 **Example**
645
646 //A2I("@W_HDW200","@W_HDW100",4,0) 'converts a string into a 16-bit (single word) decimal integer//
647
648 //A2I("@W_HDW600","@W_HDW500",4,1)' converts a string to a 32-bit (double word) decimal integer//
649
650 **Input:**@W_HDW200="12345", **Result:** @W_HDW100=1234
651
652 **Input:**@W_HDW600="12345", **Result:** @W_HDW500=1234
653
654 **✎Note:**
655
656 A1 and A2 need to be address (such as:@W_HDW000002).
657
658 == **Abs** ==
659
660 **Function**
661
662 val = Abs(A1)
663
664 **Description**
665
666 The absolute value of A1.
667
668 **Parameters**
669
670 **A1: **the data of absolute value, need to be variable.
671
672 **Val: **it is absolute value that is address or variable.
673
674 **Example**
675
676 //Dim a as integer 'a is defined as integer//
677
678 //a = SignedInt16("@W_HDW0")'convert the data of @W_HDW0 into signed data.//
679
680 //@W_HDW1 = Abs(a) 'assign the returned absolute value to @W_HDW1//
681
682 **Input: **@W_HDW0=-6
683
684 **Result: **@W_HDW1=6
685
686 **✎Note:**
687
688 **SignedInt16** function is designed to convert unsigned to signed.
689
690 == **ACos** ==
691
692 **Function**
693
694 val = ACos(A1)
695
696 **Description**
697
698 To compute the inverse cosine value of A1.
699
700 **Parameters**
701
702 **A1: **floating value, can be an address or variable.
703
704 **Val: **return value is floating, can be an address or variable.
705
706 **Example**
707
708 //Dim a ,b as floating'define two float variable a,b//
709
710 //a = 0.5 'assign the designated value to a//
711
712 //b = ACos(a) 'the inverse cosine value of "a" is a radian which assign to variable b.//
713
714 //'to add the following sentence if needed to view the return value~://
715
716 //float2d("@W_HDW200", b)'float b written into HDW200.//
717
718 **Result:** @W_HDW200=1.047
719
720 **✎Note:**
721
722 Please call **RadToDeg** function to convert radian into angle.
723
724 == **AddrStringCompare** ==
725
726 **Function**
727
728 val = AddrStringCompare(A1, A2, length)
729
730 **Description**
731
732 It is designed to compare the designated length of two character strings. The string value is 1 when the two strings are the same.
733
734 **Parameters**
735
736 **A1, A2: **character string, need to be an address (such as:"@W_HDW000002")
737
738 **Length: **The length of character string.
739
740 **Val: **Return value, 0 or 1.
741
742 **Example**
743
744 //if AddrStringCompare("@W_HDW10","@W_HDW0",2)=1 then//
745
746 //'compare the character string of HDW10 and @W_HDW0 whether value are 1.//
747
748 //@W_HDW20=1 '@W_HDW20 display 1//
749
750 //else//
751
752 //@W_HDW20=0'@W_HDW20 display 0//
753
754 //Endif//
755
756 **Input: **@W_HDW10="1a2 ", @W_HDW0="1a2 ",
757
758 **Result:** @W_HDW20=1
759
760 **Input: **@W_HDW10="ab2 ", @W_HDW0="12a ",
761
762 **Result: **@W_HDW20=0
763
764 == **Asc** ==
765
766 **Function**
767
768 val = Asc(A1)
769
770 **Description**
771
772 Return the first character of the string in ASCII value.
773
774 **Parameters**
775
776 **A1:**character string, it can be an address (such as: @W_HDW000002)
777
778 **val:**return value,ASCII value,it could be an address or variable.
779
780 **Example**
781
782 //@W_HDW10 = Asc("A") 'return the ASCII value of A to HDW10//
783
784 //@W_HDW11 = Asc("a")'return the ASCII value of a to HDW11//
785
786 //@W_HDW12 = Asc("Apple") 'return the first character A of string Apple to HDW12//
787
788 //@W_HDW13 = Asc("123") 'return the first character ASCII value 1 of string 123 to HDW13.//
789
790 **Result: **@W_HDW10 = 65
791
792 @W_HDW11 = 97
793
794 @W_HDW12 = 65
795
796 @W_HDW13 = 49
797
798 == **AsFloating** ==
799
800 **Function**
801
802 val = AsFloating(A1)
803
804 **Description**
805
806 Convert parameter A1 to a float.
807
808 **Parameters**
809
810 A1: integer variable.
811
812 **val: **return float value, can be a variable or address.
813
814 **Example**
815
816 //Dim a as integer 'define a integer variable {a}.//
817
818 //a = @W_HDW10 'assign @W_HDW10 to a//
819
820 //b = AsFloating(a) 'convert integer a to float then assign to b.//
821
822 //b = b/1.2 'add as following sentence when need to view the return value~://
823
824 //Float 2D("@W_HDW11",b) 'float variable b written into HDW11.//
825
826 **Input: **@W_HDW10=24,
827
828 **Result: **@W_HDW11=20.00(set two decimals)
829
830 == **ASin** ==
831
832 **Function**
833
834 val = ASin(A1)
835
836 **Description**
837
838 Calculate the arcsine value of A1.
839
840 **Parameters**
841
842 **A1: **Float can be an address or variable.
843
844 **Val: **Return float value, can be an address or variable.
845
846 **Example**
847
848 //Dim a, b as floating'define two float variable a,b//
849
850 //a = 0.5'assign the designated value to a//
851
852 //b=ASin(a) 'calculate the arcsine value of a ,assign the radian to b.//
853
854 //'Add the following command if need to view the return value~://
855
856 //float2d ("@W_HDW200", b) 'float variable b written into HDW200//
857
858 **Result:**@W_HDW200=0.524
859
860 **✎Note:**
861
862 Pleasecall **RadToDeg** function to convert radian into angle.
863
864 == **AsInteger** ==
865
866 **Function**
867
868 val = AsInteger(A1)
869
870 **Description**
871
872 Convert parameter A1 to integer value.
873
874 **Parameters**
875
876 **A1: **floating need to be a variable.
877
878 **Val: **the value returned could can be a variable or address.
879
880 **Example**
881
882 //Dim a as floating 'define floating variable a//
883
884 //a = D2Float("@W_HDW0",a) 'use D2Float function to save the float date of HDW0 in a//
885
886 //b= AsInteger(a) 'convert the float a into integer, the return value assigned to b//
887
888 //@W_HDW10=b 'save b to HDW10//
889
890 **Input:** @W_HDW0=20.12,
891
892 **Result:** @W_HDW10=20
893
894 == **AsString** ==
895
896 **Function**
897
898 val = AsString(A1)
899
900 **Description**
901
902 Convert parameter A1 to a character string.
903
904 **Parameters**
905
906 A1: not string parameter, it can be a variable.
907
908 Val: return string value, variable or address.
909
910 **Example**
911
912 Script 1:
913
914 //a=123 'assign a value to a//
915
916 //b=234 'assign a value to b//
917
918 //c=AsString(a)+AsString(b) 'convert a and b to string then add up the two strings ,assign the result to c.//
919
920 //@W_HDW0=c 'assign c to HDW0//
921
922 //d=a+b 'plus a with b//
923
924 //@W_HDW100=d 'assign d to (HDW100)//
925
926 **Result: **@W_HDW0=123234
927
928 @W_HDW100=357
929
930 Script 2:
931
932 //W2S("@W_HDW200","@W_HDW300","02d")//
933
934 //W2S("@W_HDW210","@W_HDW400","02d")//
935
936 //W2S("@W_HDW220","@W_HDW500","02d")//
937
938 //@W_HDW0=AsString(@W_HDW300)+AsString(@W_HDW400)+AsString(@W_HDW500)//
939
940 **Input:**@W_HDW200=12,@W_HDW210=34,@W_HDW220=56
941
942 **Result :**@W_HDW300=12,@W_HDW400=34,@W_HDW500=56,@W_HDW0=123456
943
944 **✎Note:**
945
946 Ensure the data always is two words; otherwise occur error. reference the other chapter of W2S function
947
948 == **ATan** ==
949
950 **Function**
951
952 var = ATan(A1)
953
954 **Description**
955
956 Return an arctangent value,the radian ranges -pi/2 to pi/2.
957
958 **Parameters**
959
960 **A1:**Can be float, address or variable.
961
962 **Val:**radian of return value.
963
964 **Example**
965
966 //@W_HDW20= Atan (@W_HDW10)'save the arctangent value of (HDW10) to (HDW20)//
967
968 **Input: **@W_HDW10=1.000,@W_HDW20=0.785
969
970 **✎Note:**
971
972 Please call RadToDeg function convert radian to angle.
973
974 == **ATan2** ==
975
976 **Function**
977
978 val = ATan2(A1,A2)
979
980 **Description**
981
982 Return the arctangent value of A1/A2,radian range
983
984 **Parameters**
985
986 **A1, A2:** Address or variable.
987
988 **Val: **returned value is a radian, range -pi to pi.
989
990 **Notice: **ATan2 use sign of two parameters to define the quadrant of return value.
991
992 **Example**
993
994 //@W_HDW20= ATan2 (@W_HDW10,@W_HDW12)'save the arctangent value of (HDW10/HDW12) to (HDW20).//
995
996 **Input:**@W_HDW10=1.0,@W_HDW12=1.0,
997
998 **Result: **@W_HDW20=0.785
999
1000 **✎Note:**
1001
1002 Please call **RadToDeg** function convert radian to angle.
1003
1004 == **B2W** ==
1005
1006 **Function**
1007
1008 B2W(A1, A2, length)
1009
1010 **Description**
1011
1012 Convert an array (begins with A2, unit: byte, to another array (begins with A1, unit: word).
1013
1014 **Parameters**
1015
1016 **A1: **Saving address after converting
1017
1018 **A2: **Address of the value be converted 
1019
1020 **Length:** The length of conversion
1021
1022 **Return value:**None
1023
1024 **Example**
1025
1026 //B2W(@W_HDW100,@W_HDW10,2) 'convert (@W_HDW10) to the length of 2,save as the result that begins with @W_HDW100.//
1027
1028 **Input: **@W_HDW10=1A2B
1029
1030 **Result: **@W_HDW100=2B
1031
1032 @W_HDW101=1A
1033
1034 **✎Note:**
1035
1036 A1 and A2 need to be address(e.g.: @W_HDW000002);
1037
1038 Length could be address or variable;
1039
1040 This is a subprogram; it has no returned value.
1041
1042 == **BCD** ==
1043
1044 **Function**
1045
1046 val = BCD(A1)
1047
1048 **Description**
1049
1050 Convert A1(binary) to BCD, save the result as return value.
1051
1052 **Parameters**
1053
1054 **A1: **The binary be converted; it can be an address or variable.
1055
1056 **Val: **Return value, BCD code; it can be an address or variable.
1057
1058 **Example**
1059
1060 //@W_HDW20=BCD(@W_HDW10) 'convert HDW10 (binary) to BCD code, then save in (HDW20)//
1061
1062 **Input:** @W_HDW10=11111111(binary)
1063
1064 **Result:** @W_HDW20=255
1065
1066 **✎Note:**
1067
1068 Return value is a word; it hexadecimal corresponds to BCD code.
1069
1070 == **Beep** ==
1071
1072 **Function**
1073
1074 Beep()
1075
1076 **Description**
1077
1078 Enable buzzer
1079
1080 **Parameters**
1081
1082 None
1083
1084 **Example**
1085
1086 //if @B_HDX100.0=1 then 'beep when the bit switch HDX100.0 set ON//
1087
1088 //beep()//
1089
1090 //endif//
1091
1092 **Result: **HMI beep when bit switch HDX100.0 set ON.
1093
1094 == **BIN** ==
1095
1096 **Function**
1097
1098 Val = BIN(A1)
1099
1100 **Description**
1101
1102 Convert A1 (BCD) into binary, save the result in return value.
1103
1104 **Parameters**
1105
1106 **A1:** The BCD code is converted; it can be address or variable.
1107
1108 **Val:** Return binary value,it can be address or variable.
1109
1110 **Example**
1111
1112 //@W_HDW20=BIN(@W_HDW10) 'convert HDW10(BCD) to binary, save the result in (HDW20)//
1113
1114 **Input:** @W_HDW10=255
1115
1116 **Result:** @W_HDW20=11111111 (binary)
1117
1118 == **BMOV** ==
1119
1120 **Function**
1121
1122 BMOV(A1, A2,length)
1123
1124 **Description**
1125
1126 Copy data with a designated length from source address A2 to A1.
1127
1128 **Parameter**
1129
1130 **A1:** saving address;
1131
1132 **A2:** source address;
1133
1134 **length:** operating length;
1135
1136 **Example**
1137
1138 //@W_HDW20 = 20 'assign value to HDW20//
1139
1140 //@W_HDW21 = 21 'assign value to HDW21//
1141
1142 //@W_HDW22 = 22 'assign value to HDW22//
1143
1144 //BMOV(@W_HDW10,@W_HDW20,3) 'assign the word address of HDW20, HDW21, HDW22 to HDW10, HDW11, HDW12//
1145
1146 **Result:**
1147
1148 @W_HDW10 = 20
1149
1150 @W_HDW11 = 21
1151
1152 @W_HDW12 = 22
1153
1154 **✎Note:**
1155
1156 A1 and A2 need to be address
1157
1158 Length can be an integer variable or an address. When destAddr and srcAddr are PLC (external device) addresses, the length range is 1-2048, and the 2049th address would not be operated when the range is exceeded.
1159
1160 When destAddr and srcAddr are HMI addresses, the length range is 1-4096, and This function is invalid when out of range.
1161
1162 == **Chr** ==
1163
1164 **Function**
1165
1166 val = Chr(A1, A2, ...)
1167
1168 **Description**
1169
1170 Convert integer parameter into correspond ASCII character, return the character string.
1171
1172 **Parameters**
1173
1174 **A1, A2....:** converted integer; it can be an address or variable.
1175
1176 **Val: **returned value, can be an address or variable.
1177
1178 **Example**
1179
1180 //@W_HDW100=Chr(@W_HDW20, @W_HDW21, @W_HDW22, @W_HDW23, @W_HDW24)//
1181
1182 //'convert the value of(HDW20, HDW21 ,HDW22, HDW23, HDW24) to ASCII character, assign the value to (HDW100)//
1183
1184 **Input** 72,69,76,76,79 step by step according to HDW20, HDW21, HDW22, HDW23, HDW24,
1185
1186 **Result** returns HELLO to (@W_HDW100).
1187
1188 == **Clrb** ==
1189
1190 **Function**
1191
1192 ClrB(A1)
1193
1194 **Description**
1195
1196 Set the bit of A1 as FALSE (0).
1197
1198 **Parameters**
1199
1200 **A1:** System address(bit)
1201
1202 **✎Note:**
1203
1204 subprogram has no return value.
1205
1206 **Example**
1207
1208 //ClrB(@B_HDX100.0) 'assign 0 to (@B_HDX100.0)//
1209
1210 == **Constant** ==
1211
1212 **Description**
1213
1214 Script supported constant, users can use on script:
1215
1216 pi = 3.14159265358979321
1217
1218 TRUE = 1
1219
1220 FALSE = 0
1221
1222 **Example**
1223
1224 //Dim a as integer 'define integer a//
1225
1226 //a = RadToDeg(pi) 'convert radian pi to angle then assign to a,RadToDeg function is used to convert radian to angle.//
1227
1228 //@W_HDW11 = a 'assign a to (HDW11)//
1229
1230 **Result: **@W_HDW11=180
1231
1232 == **CopyFile** ==
1233
1234 **Function**
1235
1236 A6=CopyFile(A1,A2,A3,A4,A5)
1237
1238 **Description**
1239
1240 Copy the A3 file from the A1 directory to the A2 directory according to the format of A4 and A5, and write returned value status to A6.
1241
1242 **Parameters**
1243
1244 **A1: **the source path of the file to be copied.
1245
1246 **A2: **target path.
1247
1248 **A3:** the name of the file to be copied.
1249
1250 **A4: **copy type (0: copy file, 1: copy directory).
1251
1252 **A5: **Whether to overwrite the file with the same name when copying (0: Yes, 1: No).
1253
1254 **A6: **returned value.
1255
1256 0: copy failed
1257
1258 1: copy succeeded
1259
1260 2: Parameter error
1261
1262 3: U disk does not exist
1263
1264 4: SD card does not exist
1265
1266 5: Path error
1267
1268 **Example**
1269
1270 * Copy a single file:
1271
1272 //@W_HDW100 = " test.csv"//
1273
1274 //CopyFile("UDisk/Test","Flash/Test","test.csv",0,0) 'Copy the Test.csv file in the UDisk/Test directory to the Flash/Test directory.//
1275
1276 Can also be written as //CopyFile("UDisk/Test","Flash/Test",@W_HDW100,0,0)//
1277
1278 (2) Copy the entire directory file:
1279
1280 //CopyFile("UDisk/Test","Flash/Test","",1,0) ' Copy the files in the UDisk/Test//
1281
1282 //directory to the Flash/Test directory.//
1283
1284 **✎Note:**
1285
1286 * Both source and destination paths need to begin with UDisk or Flash or SDCard;
1287 * A1 and A2 could be string (requires double quotes) or variable, maximum character length 127 allowed in path;
1288 * A3 could be a string, such as: [FileName] (requires double quotes); or address, such as: @W_HDW100 (no need to add double quotes);
1289 * A4 and A5 could be values, addressesor variable;
1290 * A6 could be address or variable.
1291
1292 == **Cos** ==
1293
1294 **Function**
1295
1296 Val = Cos(A1)
1297
1298 **Description**
1299
1300 Return a cosine value of an angle.
1301
1302 **Parameters**
1303
1304 **A1: **a float radian of angle, it can be an address or variable.
1305
1306 **Val: **return float value, it can be an address or variable.
1307
1308 **Example**
1309
1310 //Dim a, b as floating 'define float a, b//
1311
1312 //b = pi/3 'convert the value of HDW11 to float and assign to 'b'.//
1313
1314 //a=Cos(b) 'return the cosine value of'b' and assign the result to 'a'.//
1315
1316 //'to add the following sentence if need to view the return value~://
1317
1318 //Float2D("@W_HDW20",a) 'the float value of a written into HDW13.//
1319
1320 **Result: **@W_HDW20=0.5
1321
1322 **✎Note:**
1323
1324 Please call **RadToDeg** function convert radian to angle.
1325
1326 == **D2F** ==
1327
1328 **Function**
1329
1330 D2F (A1, A2) or A1= D2F (A1, A2)
1331
1332 **Description**
1333
1334 Convert the 32-bit integer format data to float then output the result.
1335
1336 **Parameters**
1337
1338 **A1: **required data, begin with"@";
1339
1340 **A2: **source data, begin with"@";
1341
1342 **Example**
1343
1344 //D2F(@W_HDW2,@W_HDW0) 'convert the double word (HDW0) to float, save the result to (HDW2).//
1345
1346 //@W_HDW2=D2F(@W_HDW2,@W_HDW0) 'convert the double word (HDW0) to float, save the result to (HDW2).//
1347
1348 **Result: **HDW0=100, HDW2=100
1349
1350 == **D2Float** ==
1351
1352 **Function**
1353
1354 F= D2Float("A1",F)
1355
1356 **Description**
1357
1358 Convert the designated value to floating then assign to variable.
1359
1360 **Parameters**
1361
1362 **A1:** Source data;
1363
1364 **F:** User-defined floating variable
1365
1366 **Example**
1367
1368 //dim F as floating 'define F as floating//
1369
1370 //F=D2Float("@W_HDW10",F) 'assign the value of (HDW10) to F in floating//
1371
1372 //Float2D("@W_HDW12",F) 'copy the floating value of F to HDW12 register,use to display result.//
1373
1374 **Result: **HDW10=200,
1375
1376 HDW12=200.
1377
1378 **✎Note:**
1379
1380 A1 needs to be address;
1381
1382 == **D2Int** ==
1383
1384 **Function**
1385
1386 A2= D2Float("A1",A2)
1387
1388 **Description**
1389
1390 Output the 32-bit integer in the form of integer.
1391
1392 **Parameters**
1393
1394 **A1:** Source data can only be the HMI internal or external register starting with "@".
1395
1396 **A2: **Target data can only use theinteger variable defined by script.
1397
1398 **Example**
1399
1400 //dim var1 as integer 'define var1 as integer//
1401
1402 //var1=D2Int("@W_HDW0",var1) 'Read out the 32-bit integer in HDW0 and save the result in var1.//
1403
1404 //HDW0=9999999,//
1405
1406 **Result:** Var1=9999999
1407
1408 == **DbToCSVFile** ==
1409
1410 **Function**
1411
1412 A8=DbToCSVFile(A1,A2,A3,A4,A5,A6,A7)
1413
1414 **Description**
1415
1416 Convert db (database file) file to csv format and export it.
1417
1418 **Parameters**
1419
1420 **A1: **db file save path (value is integer);
1421
1422 ~=0: Alarm record file in HMI flash;
1423
1424 ~=1: Alarm record file in UDisk (USB flash disk);
1425
1426 ~=2: Alarm record file in SD card;
1427
1428 ~=3: Data record file in HMI flash;
1429
1430 ~=4: Data record file in UDisk (USB flash disk);
1431
1432 ~=5: Data record file in SD card;
1433
1434 **A2: **group numer of db file (value is integer);
1435
1436 Used during exporting data record file, the group number could be seen in the data record setting interface;
1437
1438 **A3:** csv file save path (value is integer);
1439
1440 ~=0: Save in UDisk (USB flash disk);
1441
1442 ~=1: Save in SD card;
1443
1444 **A4: **csv name;
1445
1446 **A5: **start time of data recordin db file(string), consecutive 6 word addresses (the values in the address are year, month, day, hour, minute, second);
1447
1448 **A6:** end time of data recordin db file(string), consecutive 6 word addresses (the values in the address are year, month, day, hour, minute, second);
1449
1450 **A7:** csv encoding format;
1451
1452 ~=0 UTF8 format;
1453
1454 ~=1 GBK format;
1455
1456 **A8:** returned value;
1457
1458 ~=0: Failed to export;
1459
1460 ~=1: Exported;
1461
1462 ~=2: db file path error;
1463
1464 ~=3: U disk or SD card does not exist;
1465
1466 ~=4: csv name error;
1467
1468 ~=5: db file does not exist;
1469
1470 ~=6: csv file already exists;
1471
1472 **Example**
1473
1474 @W_HDW100 = 2018
1475
1476 @W_HDW101 = 12
1477
1478 @W_HDW102 = 25
1479
1480 @W_HDW103 = 19
1481
1482 @W_HDW104 = 10
1483
1484 @W_HDW105 = 30
1485
1486 @W_HDW200 = 2018
1487
1488 @W_HDW201 = 12
1489
1490 @W_HDW202 = 25
1491
1492 @W_HDW203 = 20
1493
1494 @W_HDW204 = 10
1495
1496 @W_HDW205 = 30
1497
1498 Export data record file
1499
1500 //DbToCsvFile(3,2,0,"123.csv","@W_HDW100","@W_HDW200",0)‘In the HMI flash, the group number is 2, and the data records collected in the time of 2010.12.25 19:10:30-2018.12.25 20:10:30 are exported to the 123.csv file in the Udisk in UTF8 format.//
1501
1502 Export alarm record file
1503
1504 //DbToCsvFile(0,0,0,"456.csv","@W_HDW100","@W_HDW200",1)‘The alarm records generated in HMI Flash at 2018.12.25 19:10:30-2018.12.25 20:10:30 are exported to the 456.csv file in the Udisk in GBK format.//
1505
1506 **✎Note:**
1507
1508 A1 can be an address or a variable or a value, and the path need to start with UDisk or Flash or SDCard;
1509
1510 A2 can be an address or a variable or a value;
1511
1512 A3 can be an address or a variable or a value, and the path need to start with UDisk or Flash or SDCard;
1513
1514 A4 can be an address or variables or string, and the length of the file name (sum of values, English, Chinese) could not exceed 127;
1515
1516 A5 need to be an address;
1517
1518 A6 need to be an address;
1519
1520 A7 can be an address or a variable or a value;
1521
1522 == **DegToRad** ==
1523
1524 **Function**
1525
1526 A2 = DegToRad(A1)
1527
1528 **Description**
1529
1530 Convert the angle into correspond radian, and display.
1531
1532 **Parameters**
1533
1534 **A1:** inputting angle supports address, other variable or floating.
1535
1536 **A2: **outputting radian supports address, other variable or floating.
1537
1538 **Example**
1539
1540 Script 1
1541
1542 //@W_HDW12=DegToRad(@W_HDW10) 'input angle on (HDW10),convert to correspond redian and copy to (HDW12)//
1543
1544 **Result: **HDW10=180; HDW12=3.14159
1545
1546 Script 2
1547
1548 //dim a as floating 'set variable//
1549
1550 //dim b as floating 'set variable//
1551
1552 //b=30 'input angle//
1553
1554 //a=DegToRad(b) 'convert the length of radian and copy to variable {a}//
1555
1556 //float2d("@W_HDW0", a) 'display the value of floating on(HDW0)//
1557
1558 **Result:** HDW0=0.52360
1559
1560 == **DIM ... AS ...** ==
1561
1562 **Function**
1563
1564 Dim "variable" as "date type"
1565
1566 **Description**
1567
1568 Declare a variable, stable the type of data.
1569
1570 **Parameters**
1571
1572 **Variable: **begin with letter, other character can be letter, numbers, underscores ('_'), need to begin with '@' if it is address;
1573
1574 **Data type:**string,floating,integer;
1575
1576 **Example**
1577
1578 //dim a as integer 'define a as integer//
1579
1580 //dim @W_HDW0 as floating 'define @W_HDW0 as floating//
1581
1582 //dim hi as string 'define "hi" as string//
1583
1584 **Result:**
1585
1586 a is integer
1587
1588 @W_HDW0 is floating
1589
1590 hi is string
1591
1592 **✎Note:**
1593
1594 Use the variable of Dim during running, could not change the type, Dim will be missed if the type of variable is no difined. Variable could be declared in once.
1595
1596 == **DO ... LOOP** ==
1597
1598 **Function**
1599
1600 Do [While | Until condition]
1601
1602 [statements]
1603
1604 Loop
1605
1606 or
1607
1608 Do
1609
1610 [statements]
1611
1612 Loop [While | Until condition]
1613
1614 **Description**
1615
1616 Condition determent instruction.
1617
1618 Do while.loop executes an instruction of block repeatedly when condition is true.
1619
1620 Do until.loop executes an instruction of block repeatedly until condition is false.
1621
1622 **Parameters**
1623
1624 **Condition: **determine condition; obtain the expression of True or False.
1625
1626 **Statements: **execute one or more instructions repeatedly when condition is True or until condition is True.
1627
1628 If condition is true, all statements are executed until the Wend statement is encountered. Control then returns to the While statement and condition is again checked. If condition is still True, the process is repeated. If it is not true, execution resumes with the statement following the Wend statement.
1629
1630 **Example**
1631
1632 //dim i as integer 'end DO loop when i=100//
1633
1634 //do while i<100//
1635
1636 //i=i+1//
1637
1638 //@W_HDW0=i//
1639
1640 //loop//
1641
1642 **Result: **HDW0=100
1643
1644 == **End** ==
1645
1646 **Function**
1647
1648 Terminates the script immediately.
1649
1650 **Description**
1651
1652 End the execution of script.
1653
1654 **Parameters**
1655
1656 **Statement:** Judging condition, use with IF together. end script when meet condition.
1657
1658 **Example**
1659
1660 //If a = 10 Then End 'end script when a=10.//
1661
1662 **Result:** End the script program.
1663
1664 == **Exp** ==
1665
1666 **Function**
1667
1668 A1=Exp(A2)
1669
1670 **Description**
1671
1672 Returns the power value of e (natural logarithm), save the outputting result to A1, e=2.71828182846.
1673
1674 **Parameters**
1675
1676 **A1: **the goal date: the power floating value of returning, need to begin with '@'([[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__e.g.@W_HDW10__>>path:mailto:'@'(e.g.@W_HDW10]](%%));
1677
1678 **A2: **Source data, natural exponential function, need to be integer or variable. Could not not begin with the address of "@"(e.g.@W_HDW10)
1679
1680 **Example**
1681
1682 //dim a as integer'define a as integer//
1683
1684 //a = @W_HDW2 ' assign the value of (HDW2) to variable a//
1685
1686 //@W_HDW0= Exp(a)'exponential is the value of (HDW2),save result to(HDW0)//
1687
1688 **Result:** HDW2=2,
1689
1690 HDW0=7.38905600
1691
1692 == **F2D** ==
1693
1694 **Function**
1695
1696 F2D (A1, A2)
1697
1698 **Description**
1699
1700 Convert a 32 bit floating to integer format, then output the result.
1701
1702 **Parameters**
1703
1704 **A1: **Destination, the value can be an address(e.g.@W_HDW12).
1705
1706 **A2: **source date, it can be an address or other variable.
1707
1708 **Example**
1709
1710 //F2D(@W_HDW12,@W_HDW10) 'convert the floating of (HDW10) to integer, save in (HDW12).//
1711
1712 **Result:**
1713
1714 HDW10=200,
1715
1716 HDW12=200
1717
1718 == **F2S** ==
1719
1720 **Function**
1721
1722 F2S (A1,A2,s1)
1723
1724 **Description**
1725
1726 Output a format of floating that in the type of string.
1727
1728 **Parameters**
1729
1730 **A1:** Source address, used to store floating, the value is an address(e.g.@W_HDW200);
1731
1732 **A2:** Destination address, used to store string after converted, value is an address(e.g.@W_HDW100).
1733
1734 **S1:** the format of displaying goal data. such as the format of 03.03f,f, used for outputting a single-precision in the form of decimal.m.nf:means m column and n decimals when outputting.
1735
1736 **Example**
1737
1738 //F2S("@W_HDW200", "@W_HDW100", "03.03f") '(HDW200) is floating input,(HDW100) is text output;//
1739
1740 **Result: **HDW200=1.22365,
1741
1742 HDW100=1.224
1743
1744 == **FileCmpDir** ==
1745
1746 **Function**
1747
1748 FileCmpDir(A1, A2, A3, A4, A5, A6, A7, A8, A9)
1749
1750 **Description**
1751
1752 The filename input and the filename in the folder whether is duplicate or not.
1753
1754 **Parameters**
1755
1756 A1: file path (value is integer);
1757
1758 In HMI:
1759
1760 ~=0: Recipe folder in HMI flash;
1761
1762 ~=1: Custom folder in UDisk (USB flash disk);
1763
1764 ~=2: Custom folder in SD card.
1765
1766 ~=3: Custom folder in HMI flash;
1767
1768 In simulator:
1769
1770 ~= 0: D:/Recipe/
1771
1772 ~= 1: C:/WECON/CustomFileDir/
1773
1774 ~= 2: C:/WECON/CustomFileDir/
1775
1776 ~= 3: C:/WECON/CustomFileDir/
1777
1778 **✎Note:** A1 can be an address,variable or fixed value.
1779
1780 A2: file name (value is string);
1781
1782 The file name would be compared;
1783
1784 **✎Note: **A2 can be an address, variable or string. The length of file name cannot exceed 32 characters.
1785
1786 A3: folder name (value is integer);
1787
1788 The folder name would be compared;
1789
1790 **✎Note: **A3 can be an address, variable or string. The length of file name cannot exceed 32 characters.
1791
1792 A4:file name display address (value is a string);
1793
1794 Display the specified number of file names in the specified folder.
1795
1796 **✎Note:** Can only use address here. And the length of the file name cannot exceed 32 characters.
1797
1798 A5: Function type (value is an integer)
1799
1800 ~= 0: compare whether the file name in the folder and the file name input are duplicated or not.
1801
1802 ~= 1: return list of file names.
1803
1804 ~= 100: compare file names, without input suffix .csv
1805
1806 **✎Note: **A5 can be an address, variable or value.
1807
1808 A6: Return value (value is an integer)
1809
1810 ~= 1: Successfully opened the folder.
1811
1812 ~= 2: Failed to open the folder.
1813
1814 ~= 3: The file has duplicate names
1815
1816 **✎Note:** A6 must be an address.
1817
1818 A7: File number (value is an integer)
1819
1820 Display the number of files in the folder (up to 100)
1821
1822 **✎Note: **A7 must be an address.
1823
1824 A8: File creation time (value is a string);
1825
1826 Display the time of file creation, time occupies 32 characters
1827
1828 A9: The maximum number of files to read (value is an integer)
1829
1830 Set the maximum number of files to read (up to 100 files)
1831
1832 **✎Note:** A9 can be an address, variable or value.
1833
1834 **Example**
1835
1836 1) Read the specified number of files in the folder.
1837
1838 FileCmpDir(@W_HDW1254, @W_HDW50, "File", "", 0, "@W_HDW0", "", "", 10)'Determine whether there is a file with the same name as @W_HDW50 in the file directory of HDW1254.@W_HDW0=3 is Yes.@W_HDW0 = 1 is No.@W_HDW0=2 is comparison failed.
1839
1840 2) Compare filename input and the filename in the folder whether is duplicate or not.
1841
1842 FileCmpDir(@W_HDW1254, "", "File", "@W_HDW200", 1, "@W_HDW0", "@W_HDW300", "@W_HDW400", 10)’The file name under the directory File in the flash is written to the continuous address begin from @W_HDW200, the file creation time is written to the continuous address begin from @W_HDW400, the number of files is written to the address @W_HDW300, the maximum number of files is 10
1843
1844 3) Compare the csv file name in the folder and the csv file name input whether is duplicated or not.
1845
1846 FileCmpDir(@W_HDW1254, @W_HDW50, "File", "", 100, "@W_HDW0", "", "", 10)' Judge whether there is a file in the directory File in the flash is same with following: @W_HDW50, @W_HDW50.csv, @ W_HDW50.CSV , @W_HDW0=3 is Yes, @W_HDW0 = 1 is No ,@W_HDW0=2 is comparison failed
1847
1848 == **FILL** ==
1849
1850 **Function**
1851
1852 FILL (A1, A2, A3)
1853
1854 **Description**
1855
1856 Write the same value to designated address constantly.
1857
1858 **Parameters**
1859
1860 **A1:** The beginning address, it can be an address (e.g.@ W_ HDW25);
1861
1862 **A2:** Source data, it needs to be written in continuous value, the value can be an address, variable or constant;
1863
1864 **A3:** The number of operation, writing address number, it can be an address, variable or constant;
1865
1866 When the PLC (external device) address is used in this function, the length range is 1-2048, and only the 2048th address can be operated when the range is exceeded.
1867
1868 When the HMI internal address is used in this function, the length range is 1-4096. If the function is out of range, then the function is invalid.
1869
1870 **Example**
1871
1872 //FILL (@W_HDW25, 10, 3) 'At the beginning three address of @W_ HDW25 is 10.//
1873
1874 **Result: **At the beginning three address of @W_ HDW25 is 10, @W_ HDW25=10, @W_ HDW26=10, @W_ HDW27=10.
1875
1876 == **Float2D** ==
1877
1878 **Function**
1879
1880 Float2D (A1,A2);
1881
1882 **Description**
1883
1884 Copy floating value to the address.
1885
1886 **Parameters**
1887
1888 **A1: **Goal address, the value need to be address (e.g.@W_HDW102);
1889
1890 **A2:** Source data, it can be floating;
1891
1892 **Example**
1893
1894 //dim f as floating 'define f as floating//
1895
1896 //f=1.1 'assign a designated value to f//
1897
1898 //Float2D ("@W_HDW102",f) 'assign the value f to HDW102//
1899
1900 **Result:** HDW102=1.1
1901
1902 == **For. to. step. next** ==
1903
1904 **Function**
1905
1906 For counter = start to end Step
1907
1908 [Statements]
1909
1910 Next
1911
1912 **Description**
1913
1914 Execute a command repeatedly for designated times.
1915
1916 **Parameters**
1917
1918 **counter: **Work as a variable for loop counter;
1919
1920 **start: **The start value of counter, it could be any variable type or expression;
1921
1922 **end: **The end value of counter, it could be any variable type or expression;
1923
1924 **step: **Every loop, the changed value of counter is step value, step default if it is not designation.
1925
1926 step default as below
1927
1928 if start>end, step default is 1;
1929
1930 if start< end. It could be any variable type or expression;
1931
1932 **statements: **Between For with Next, execute instruction set of designated times;
1933
1934 Set a loop of for...Next in another loop, it can nest call the loop of for...Next. Different from a while, for only search once value from end. Empty for loop will be ignored, and could not delay time.
1935
1936 **Example**
1937
1938 //'Use HDX2.0 to trigger the loop//
1939
1940 //for i=100 to 0 step -5 ' set the start is 100,end is 0,subtract 5 every time, execute 20 times totally.//
1941
1942 //@W_HDW100=@W_HDW100+1 ' execute (HDW100+1) 21 times totally, the final result is 21.//
1943
1944 //Next//
1945
1946 //@B_HDX2.0=0//
1947
1948 **Result: **HDW100=21
1949
1950 == **Function** ==
1951
1952 **Function**
1953
1954 Function name (arglist)
1955
1956 statements
1957
1958 name = expression
1959
1960 statements
1961
1962 End Function
1963
1964 **Description**
1965
1966 Unlike internal function, it needs to declare the name, parameter, code of the function.
1967
1968 **Parameters**
1969
1970 **Name: **function name.
1971
1972 **arglist: **stands for the variable list of parameter, this parameter will be entered during calling function. use comma to separate.
1973
1974 **statements:**a set of code in running function body.
1975
1976 **Notice: **it could not define a function program at any other program body. Write name first and then follow with parameter list, when calling function. Declare function need to before be calling. in the internal function body, it could be assigned to a function name from returned value at any place. Return value is 0 if not assign function name. Functions can recursive, but it may lead to stack overflow.
1977
1978 **Example**
1979
1980 //Function sincos (angle as floating)//
1981
1982 //sincos = sin(angle) + cos(angle)//
1983
1984 //End Function<//
1985
1986 //........//
1987
1988 //@W_0002 = sincos(pi/2)//
1989
1990 //........//
1991
1992 == **GetServerDelayInfo** ==
1993
1994 **Function**
1995
1996 A3=GetSerVerDelayInfo(A1,A2)
1997
1998 **Description**
1999
2000 Convert string A1 to hexadecimal number.
2001
2002 **Parameters**
2003
2004 **A1:** The starting address, save the delay data of each server (10 consecutive addresses, the last 7 addresses are reserved), when the server testing fails, the value in the corresponding address is -1. The unit is ms (signed decimal number).
2005
2006 (% class="table-bordered" %)
2007 |**Address**|**Description**
2008 |A1|Delay data of the server configured in [Project Settings]
2009 |A1+1|Delay data of Server 1
2010 |A1+2|Delay data of Server 2
2011
2012 **A2: **Server test result address
2013
2014 (% class="table-bordered" %)
2015 |(% style="width:239px" %)**Address**|(% style="width:1250px" %)**Description**
2016 |(% style="width:239px" %)0 bit|(% style="width:1250px" %)Set ON, Server configured in [Project Settings] fails
2017 |(% style="width:239px" %)1^^st^^bit|(% style="width:1250px" %)Set ON, Server 1 fails
2018 |(% style="width:239px" %)2^^nd^^bit|(% style="width:1250px" %)Set ON, Server 2 fails
2019 |(% style="width:239px" %)3^^rd^^~~ 10^^th^^bits|(% style="width:1250px" %)Reserved
2020 |(% style="width:239px" %)11^^th^^bit|(% style="width:1250px" %)Set ON, network error, network port interface failure
2021
2022 **A3:**Returns the preferred server number or network status (automatically selects the server with the best connection network status).
2023
2024 ~=0: Server configured in [Project Settings];
2025
2026 ~=1: Server 1;
2027
2028 ~=2: Server 2;
2029
2030 ~=3~~10: Reserved;
2031
2032 ~=100: Try again later (two test intervals need to wait 30 seconds);
2033
2034 ~=101: Failed to test Server;
2035
2036 **Example**
2037
2038 //@W_HDW200 = GetServerDelayInfo("@W_HDW100", "@W_HDW50")//
2039
2040 Result:
2041
2042 HDW100: Delay data of the server configured in [Project Settings]
2043
2044 HDW101: Delay data of Server 1
2045
2046 HDW102: Delay data of Server 2
2047
2048 HDX50.0=1:Server configured in [Project Settings] fails
2049
2050 HDX50.1=1: Server 1 fails
2051
2052 HDX50.2=1:Server 2 fails;
2053
2054 HDX50.11= 1: network error, network port interface failure;
2055
2056 When the server signal is stable, the optimal server is automatically connected according to the network status @W_HDW200. When the server connection is abnormal, @W_HDW200=101, the server test fails or the test is abnormal.
2057
2058 **✎Note:**
2059
2060 The time interval between executions of this function could not be less than 30 seconds, otherwise an error will occur.
2061
2062 == **Goto** ==
2063
2064 **Function**
2065
2066 Goto label
2067
2068 **Description**
2069
2070 Go to the designated row without any condition in a function body.
2071
2072 **Parameters**
2073
2074 **Label:** target character, start with letter in row label, end with(:)of any string.row label has no sensitive to the format of letter.
2075
2076 **Example**
2077
2078 //Goto sd 'go to the row which start with "sd";//
2079
2080 **Result:** Go to sd row.
2081
2082 **✎Note:**
2083
2084 Goto only can jump into the internal function that visible row.
2085
2086 == **H2A** ==
2087
2088 **Function**
2089
2090 A1 = H2A (A2)
2091
2092 **Description**
2093
2094 Convert a binary (16-bit) to hexadecimals (4-bit) of ASCII.
2095
2096 **Parameters**
2097
2098 **A1: **Returned value, string, it could be an address or variable.
2099
2100 **A2: **Binary is needed to be converted, the value could be a address or variable.
2101
2102 **Example**
2103
2104 //@W_HDW100= H2A (@W_HDW0) ' convert the binary of (HDW0) to character and save in (HDW100).//
2105
2106 **Result:** HDW0=200,
2107
2108 HDW=100
2109
2110 == **HmiRegoperator** ==
2111
2112 **Function**
2113
2114 HmiRegoperator (A1,A2,A3,A4,A5,A6)
2115
2116 **Description**
2117
2118 Data of Upload/ Download address
2119
2120 **Parameters**
2121
2122 **A1: **The start address of target
2123
2124 **A2: **Length, address length, unit: word, range: 1~~1000
2125
2126 **A3: s**torage
2127
2128 A3=0, select USB flash disk as storage, and save files in Root directory;
2129
2130 A3=1, select SD card as storage, and save files in Root directory;
2131
2132 **A4: **File name address, itneed to be address such as"@ W_HDW2"
2133
2134 **A5**: Upload / download data
2135
2136 A5=0, save the data in the specified address as a file and store the file in the root directory;
2137
2138 A5=1, Read data from file and it woule be written into specified address;
2139
2140 **A6:** State display, it needs to be address, such as "@ W_HDW2";
2141
2142 A6=1, Normal
2143
2144 A6=2, USB flash disk/ SD card does not exist
2145
2146 A6=3, File doesn’t exist;
2147
2148 A6=4, File name error;
2149
2150 A6=5, Check error
2151
2152 A6=6, Abnormal communication;
2153
2154 A6=7, HUW register is not allowed;
2155
2156 A6=8, Address length range error (address length range: 1-1000);
2157
2158 **Example**
2159
2160 Script 1
2161
2162 //HmiRegoperator("@W_HDW0",10,0,"@W_HDW2000",0,"@W_HDW3000")’The data in HDW0-HDW10 is saved as a file, the file name is set by HDW2000 and stored in a USB flash disk.//
2163
2164 Script 2
2165
2166 //HmiRegoperator("@W_HDW0",10,1,"@W_HDW2000",1,"@W_HDW3000")//
2167
2168 //Read the values from files which stored in the SD card (files named by the HDW2000), and write these values to the HDW0-HDW10.//
2169
2170 **✎Note:**
2171
2172 * The length of the file name is less than 32 characters, and the file name consists of numbers and letters (the file name does not meet this standard; WECON does not guarantee the accuracy of the data).
2173 * The interval of download function operation should be 5s or more.
2174 * A1 need to be address such as “@W_HDW2”.
2175 * Please use “Character Input/Display” object for it, and the file name consists of numbers and letters, could not be punctuated characters, maximum character length 32 allowed.
2176
2177 == **Hypot** ==
2178
2179 **Function**
2180
2181 Var = Hypot (expr1, expr2)
2182
2183 **Description**
2184
2185 Calculate the value of the hypotenuse of a right triangle.
2186
2187 **Parameters**
2188
2189 **expr1, expr2: **Source data, the two sides of right triangle. it need to be address;
2190
2191 **Var:** Destination data,it need to be address;
2192
2193 **Example**
2194
2195 //@W_HDW200=Hypot (@W_HDW105,@W_HDW108) ' input the value of right-angle side at (HDW105) and (HDW108),and assign the result of the hypotenuse to (HDW200).//
2196
2197 **Result: **HDW105=3,
2198
2199 HDW108=4,
2200
2201 HDW200=5
2202
2203 **✎Note:**
2204
2205 hypot function could support integer and floating when the format of source data and target data are the same.
2206
2207 == **IF ... THEN ... ELSE ... END IF** ==
2208
2209 **Function**
2210
2211 If condition Then
2212
2213 Statements
2214
2215 [Else
2216
2217 else statements]
2218
2219 End If
2220
2221 **Description**
2222
2223 Conditional judgments instruction. When the [Condition] defined by [IF] is TURN, the operation following [THEN] is performed. When [Condition] is FALSE, the operation after [ELSE] is executed.
2224
2225 **Parameters**
2226
2227 **condition: **any expression, the value could be true or false.
2228
2229 **statement: **execute the instruction block when condition is true.
2230
2231 **else statement: **execute the instruction block when condition is false.
2232
2233 **Example**
2234
2235 //if @W_HDW105=200 then ' judging condition: whether the value of (HDW105) is 200//
2236
2237 //@W_HDW108=1 'the value of (HDW108) is 1 if fulfil condition//
2238
2239 //else//
2240
2241 //@W_HDW200=1 ' the value of (HDW200) is 1 if not fulfil condition.//
2242
2243 //Endif//
2244
2245 **Result:**
2246
2247 HDW105=199;
2248
2249 HDW108=0;
2250
2251 HDW200=1
2252
2253 == **InStr** ==
2254
2255 **Function**
2256
2257 var = InStr ("str1", "str2")
2258
2259 **Description**
2260
2261 Returned the position of str1 in str2(start with 0), set -1 if no result.
2262
2263 **Parameters**
2264
2265 **str1:** source string, it could only be string, not address;
2266
2267 **str2:** target string, it could only be string, not address;
2268
2269 **var:** Returned value, the format of data needs to be string;
2270
2271 **Example**
2272
2273 //dim a as floating//
2274
2275 //a = InStr ("Hello", "o") ' calculate the position of"o"in"hello".//
2276
2277 //float2d ("@W_HDW0",a) ' Returned value is 4.(start with 0)//
2278
2279 **Result:** HDW0=4
2280
2281 == **Int2D** ==
2282
2283 **Function**
2284
2285 Int2D("A1",A2)
2286
2287 **Description**
2288
2289 Write the 32-bit integer into the target address
2290
2291 **Parameters**
2292
2293 **A1: **Source data could only be the HMI internal or external register starting with "@".
2294
2295 **A2:** Target data could only use the integer variable defined by script.
2296
2297 **Example**
2298
2299 //dim var1 as integer 'define var1 as integer//
2300
2301 //Int2D("@W_HDW0", var1)    'Read out the 32-bit integer in var1 and save the result in HDW0 .//
2302
2303 //var1=9999999,//
2304
2305 **Result:** HDW0=9999999.
2306
2307 == **InvB** ==
2308
2309 **Function**
2310
2311 InvB (A1)
2312
2313 **Description**
2314
2315 The state of inverse bit, it is a sub function, no returned value. Achieve the state of switching address constantly.
2316
2317 **Parameters**
2318
2319 **A1:** it is an address.
2320
2321 **Example**
2322
2323 //InvB (@B_HDX0.1) 'switch the state if (HDX0.1).//
2324
2325 **Result: **Switch the state of (HDX0.1) constantly.
2326
2327 == **IsFloating** ==
2328
2329 **Function**
2330
2331 A2=IsFloating (A1)
2332
2333 **Description**
2334
2335 Decide whether a parameter is floating, return true if it is floating, otherwise return FALSE.
2336
2337 **Parameter**
2338
2339 **A1:** source data, variable;
2340
2341 **A2:** target data, variable;
2342
2343 **Example**
2344
2345 //dim a as integer//
2346
2347 //dim b as floating//
2348
2349 //b= D2float ("@W_HDW200",b) 'assign the value of (HDW200) to b//
2350
2351 //a = IsFloating (b) 'judge whether b is floating or not//
2352
2353 //@W_HDW300=a 'save the result to (HDW300)//
2354
2355 **Result: **HDW300=1
2356
2357 == **IsInteger** ==
2358
2359 **Function**
2360
2361 A2= IsInteger (A1)
2362
2363 **Description**
2364
2365 Determine whether a parameter(A1) is integer, return TRUE if the parameter is integer, otherwise return FALSE.
2366
2367 **Parameter**
2368
2369 **A1:** Source date, it is variable or number;
2370
2371 **A2:** Target date, need to be variable, it could not be system address ;
2372
2373 **Example**
2374
2375 //dim a as integer//
2376
2377 //a = IsInteger (20) 'determine whether 20 is integer//
2378
2379 //@W_HDW300=a ' display the result on (HDW300)//
2380
2381 **Result:** HDW300=1
2382
2383 == **IsString** ==
2384
2385 **Function**
2386
2387 val = IsString(expr)
2388
2389 **Description**
2390
2391 Determine whether a parameter is string, return TRUE if it is string, otherwise return FALSE.
2392
2393 **Parameters**
2394
2395 **Expr:** source string, it could be a variable or string, not address;
2396
2397 **Val:** target date, the result need to be variable, could not be address;
2398
2399 **Example**
2400
2401 //dim a as integer 'define variable, display the result;//
2402
2403 //a= isstring ("hello") 'determine whether"hello"is string;//
2404
2405 //@W_HDW0=a 'assign the result to (HDW0)//
2406
2407 **Result: **HDW=1
2408
2409 == **Lcase** ==
2410
2411 **Function**
2412
2413 A2 = LCase(A1)
2414
2415 **Description**
2416
2417 Convert all parameters to lowercase strings.
2418
2419 **Parameters**
2420
2421 **A1: **source string, it could be an address or variable;
2422
2423 **A2: **outputting string, it could be an address or variable;
2424
2425 **Example**
2426
2427 //@W_HDW33 = LCase (@W_HDW25) 'input source sting on (HDW25), convert it to destination string and display the result on (HDW33);//
2428
2429 **Result:** HDW25=HELLO
2430
2431 HDW33=hello
2432
2433 == **Left** ==
2434
2435 **Function**
2436
2437 Val =Left (String, Length)
2438
2439 **Description**
2440
2441 Return a string of the specified length from the left side of parameter.
2442
2443 **Parameters**
2444
2445 **String:** source string; it could be an address or string.
2446
2447 **Length: **return the number of character. It could be an address, integer or variable. Return empty string if length<1. return the whole string if length not less than the character number of string.
2448
2449 **Val: **destination string, outputting string, it could be an address or variable.
2450
2451 **Example**
2452
2453 //@W_HDW30=Left (@W_HDW36, @W_HDW40) '(HDW36) used to input source string,(HDW30) used to display the string result;//
2454
2455 Result: HDW36=hello,
2456
2457 HDW40=2,
2458
2459 HDW30=he
2460
2461 == **Len** ==
2462
2463 **Function**
2464
2465 Length=Len(String)
2466
2467 **Description**
2468
2469 Return the string length.
2470
2471 **Parameters**
2472
2473 **String:** source string, it could be a address or string;
2474
2475 **Length:** target data, return value, it could be a address, variable, integer or floating;
2476
2477 **Example**
2478
2479 //@W_HDW30=Len (@W_HDW36) 'count the character number of (HDW36), save the result to (HDW30);//
2480
2481 **Result:** HDW36=hello
2482
2483 HDW30=5
2484
2485 == **Log** ==
2486
2487 **Function**
2488
2489 a= Logn (x)=Log(x)/Log(n)
2490
2491 **Description**
2492
2493 Log function:return the natural logarithm of the value.
2494
2495 **Parameters**
2496
2497 **a: **source date,it could be a variable, but it could not be address;
2498
2499 **x, n:** source date, it could be a variable, but it could not be address;
2500
2501 **Example**
2502
2503 //Dim a as integer 'define a as integer;//
2504
2505 //Dim b as integer 'define b as integer;//
2506
2507 //Dim c as integer 'define c as integer;//
2508
2509 //b=@W_HDW10 'assigns a value to b//
2510
2511 //c=@W_HDW20 'assigns a value to c//
2512
2513 //a=Log (b)/Log(c) 'calculate logarithm//
2514
2515 //@W_HDW0//
2516
2517 //=a 'assign the result to (HDW0)//
2518
2519 **Result:** HDW10=27,
2520
2521 HDW20=3,
2522
2523 HDW0=3
2524
2525 == **Log10** ==
2526
2527 **Function**
2528
2529 a=Log10(x)= Log(x) / Log(10)
2530
2531 **Description**
2532
2533 Log function: return the natural logarithm.
2534
2535 **Parameters**
2536
2537 **A:** target data, result could be variable, could not be address;
2538
2539 **x:** source data, it could be variable that needs to be the multiples of 10, can’t be address
2540
2541 **Example**
2542
2543 //dim a as integer 'define a as integer//
2544
2545 //dim b as integer 'define b as integer//
2546
2547 //b=@W_HDW10 'assign a value to b//
2548
2549 //a= Log (b)/Log(10) 'result//
2550
2551 //@W_HDW0=a 'assign the result to (HDW0)//
2552
2553 **Result: **HDW10=100,
2554
2555 HDW0=2
2556
2557 == **LTrim** ==
2558
2559 **Function**
2560
2561 val=LTrim("string")
2562
2563 **Description**
2564
2565 Remove the left empty part of the string and return.
2566
2567 **Parameters**
2568
2569 **Val:** Destination string, it could be either a variable or address;
2570
2571 **string:** Source string, it could be either a variable or address;
2572
2573 **Example**
2574
2575 //dim a as string//
2576
2577 //a=Ltrim("hello")//
2578
2579 //@W_HDW103=a//
2580
2581 **Result:** HDW103=hello
2582
2583 == **MAX** ==
2584
2585 **Function**
2586
2587 A1=MAX(A2,A3)
2588
2589 **Description**
2590
2591 Compare the value of A2 and A3, assign the greater value to A1.
2592
2593 **Parameters**
2594
2595 **A1:** Return value (used to store the greater value between A2 with A3).
2596
2597 **A2:** The first comparison value.
2598
2599 **A3:** The second comparison value.
2600
2601 **✎Note:**
2602
2603 A1,A2,A3 should be only used in unsigned integer or unsigned address.
2604
2605 **Example**
2606
2607 //DIM A1 as integer//
2608
2609 //@W_HDW106=10 'assign the value to (@W_HDW106), unsigned decimal word.//
2610
2611 //@W_HDW107=5 'assign the value to (?@W_HDW107),unsigned decimal word.//
2612
2613 //A1 = Max(@W_HDW106,@W_HDW107)//
2614
2615 //@W_HDW105 = A1//
2616
2617 **Result: **@W_HDW105 = 10
2618
2619 **Mid**
2620
2621 **Function**
2622
2623 A1=mid(A2, start, length)
2624
2625 **Description**
2626
2627 Returns a string contain a specified characters length from a string.
2628
2629 **Parameters**
2630
2631 **A1:** string contains the selected characters, it needs to be a string
2632
2633 **A2:** string to be selected, it needs to be a variable or address
2634
2635 **Start:** the start position of string, it needs to be a variable or address, it means that count begin with 0.
2636
2637 **Length:** the designated length of string, maximum character length 127 allowed
2638
2639 **Example**
2640
2641 //DIM A1 as string//
2642
2643 //A1 = Mid("hellokitty",1,2) 'select the string of in "//
2644
2645 //@W_HDW106=A1//
2646
2647 **Result: **@W_HDW106 'display "el" on text input and output window
2648
2649 == **MIN** ==
2650
2651 **Function**
2652
2653 A1=MIN(A2,A3)
2654
2655 **Description**
2656
2657 Compare the value of A2 and A3, assign the smaller value to A1.
2658
2659 **Parameters**
2660
2661 **A1: **Return value (used to store the snaker value between A2 with A3).
2662
2663 **A2: **The first comparison value.
2664
2665 **A3: **The second comparison value.
2666
2667 **Example**
2668
2669 //DIM A1 as integer//
2670
2671 //@W_HDW106=10 'assign the value to (@W_HDW106), unsigned decimal word.//
2672
2673 //@W_HDW107=5 'assign the value to (@W_HDW107), unsigned decimal word.//
2674
2675 //A1 = Min(@W_HDW106,@W_HDW107)//
2676
2677 //@W_HDW105 = A1//
2678
2679 **Result:** @W_HDW105 = 5
2680
2681 **✎Note:**
2682
2683 A1, A2,A3 only used in unsigned integer or unsigned address.
2684
2685 == **MSeconds** ==
2686
2687 **Function**
2688
2689 A1=MSeconds( )
2690
2691 **Description**
2692
2693 A1 is used to display the current milliseconds of system.
2694
2695 **Parameters**
2696
2697 **A1: **used to store the current milliseconds of system.
2698
2699 **Example**
2700
2701 //DIM A1 as integer//
2702
2703 //@W_HDW0= 10 'assign a value to (@W_HDW0), unsigned decimal word//
2704
2705 //A1=MSeconds() 'return the current milliseconds of system to A1//
2706
2707 //@W_HDW0=A1//
2708
2709 //@W_HDW1=A1>>16 'display milliseconds on screen, (HDW0) is an 32-bit unsigned decimal integer address//
2710
2711 **Result:** @W_HDW0 will generate the time value of changing milliseconds unit.
2712
2713 **✎Note:**
2714
2715 A1 is 32-bit unsigned integer variable or unsigned integer address;
2716
2717 MSeconds() function rolls back over to zero once the maximum value has been reached (4294967295->0, 1,2,....4294967295->0, 1, 2,....4294967295->0, 1, 2);
2718
2719 == **MyDeleteFile** ==
2720
2721 **Function**
2722
2723 MyDeleteFile (A1,A2,A3,A4,A5)
2724
2725 **Description**
2726
2727 Delete the specified file
2728
2729 **Parameters**
2730
2731 A1: File location (value is an integer);
2732
2733 In HMI:
2734
2735 ~=0: Recipe folder in HMI flash;
2736
2737 ~=1: Custom folder in UDisk (USB flash disk);
2738
2739 ~= 2: Custom folder in SD card.
2740
2741 ~=3: Custom folder in HMI flash;
2742
2743 In simulator:
2744
2745 ~= 0: D:/Recipe/
2746
2747 ~= 1: C:/WECON/CustomFileDir/
2748
2749 ~= 2: C:/WECON/CustomFileDir/
2750
2751 ~= 3: C:/WECON/CustomFileDir/
2752
2753 **✎Note:** A1 can be an address, variable or value.
2754
2755 A2: filename (value is string);
2756
2757 Input the name of the file want to delete.
2758
2759 **✎Note: **A2 can be an address , variable or a character string, and the length of the file name cannot exceed 32 characters.
2760
2761 A3: folder name (value is integer);
2762
2763 Input the folder where the file want to delete.
2764
2765 **✎Note: **A3 can be an address , variable or a character string, and the length of the folder name cannot exceed 32 characters.
2766
2767 A4: Delete function type (value is integer)
2768
2769 ~= 0: Delete the specified file.
2770
2771 ~= 1: Delete all files.
2772
2773 **✎Note: **A4 can be an address , variable or value.
2774
2775 A5: Return value (value is an integer)
2776
2777 ~= 0: parameter error
2778
2779 ~= 1: Delete successfully
2780
2781 ~= 2: Delete failed
2782
2783 ~= 3: Failed to open file
2784
2785 **✎Note:** A5 must be an address.
2786
2787 **Example**
2788
2789 MyDeleteFile(@W_HDW1254,@W_HDW4200,@W_HDW4300,@W_HDW1250,"@W_HDW1252")
2790
2791 ‘According to the value of @W_HDW1250, delete the designated file @W_HDW4200 in the folder @W_HDW4300 or delete all files in the folder @W_HDW4300.
2792
2793 == **NewNoAddr** ==
2794
2795 **Function**
2796
2797 A1= NewNoAddr (A2, length)
2798
2799 **Description**
2800
2801 At the basic of source address A2, offset designated length, obtain a new address A1.
2802
2803 **Parameters**
2804
2805 **A1: **address after offsetting, it must be String type variable.
2806
2807 **A2:** source address, it must be an address(e.g.:"@W_HDW2")
2808
2809 **Length: **offset length, it must be a constant or an integer variable.
2810
2811 **Example**
2812
2813 //DIM A1 as string//
2814
2815 //A1=NewNoAddr("@W_HDW0",50) '(HDW0) offsets 50 words address (16 bit), and save the result to A1//
2816
2817 //@W_HDW1=A1 '(HDW50) save in A1//
2818
2819 **Result: **(@W_HDW1) character input/display will show @W_HDW50
2820
2821 == **NewStatAddr** ==
2822
2823 **Function**
2824
2825 A1= NewStatAddr (A2, length)
2826
2827 **Description**
2828
2829 At the basic of source address A2, offset the designated length, to obtain a new station A1.
2830
2831 **Parameters**
2832
2833 **A1: **The address after offsetting, it needs to be variable.
2834
2835 **A2:** Source station address, it needs to be address (e.g.:"@W_1:10").
2836
2837 **Length: **offset length
2838
2839 **Example**
2840
2841 //DIM A1 as string//
2842
2843 //A1=NewStatAddr("@W_1:10",2) 'address 10 of station address 1 that offset 2 station addresses, then save the result to A1//
2844
2845 //@W_HDW1=A1 'address 3:10 is saved in A1//
2846
2847 **Result: **@W_HDW1 character input/display will show @W_3:10
2848
2849 == **NStringCompare** ==
2850
2851 **Function**
2852
2853 A1= NStringCompare (A2, A3, length)
2854
2855 **Description**
2856
2857 Compare whether the designated length of two strings is the same, return 1 to A1 if yes, otherwise return 0.
2858
2859 **Parameters**
2860
2861 **A1: **Returned value (compare the designated length of two strings, display 1 when equal, else 0). It could be an address or variable.
2862
2863 **A2: **the address of string to be compared, it needs to be address.
2864
2865 **A3: **source string, it needs to be variable or constant string.
2866
2867 **Length: **string length to be compared
2868
2869 **Example**
2870
2871 //@W_HDW1= NStringCompare("@W_HDW0","87654",5)//
2872
2873 //if @W_HDW1=1 then//
2874
2875 //@B_HDX10.0=1 'result: HDX10.0 set ON 'when the two strings are the same.//
2876
2877 //endif//
2878
2879 //if @W_HDW1=0 then//
2880
2881 //@B_HDX10.0=0 'result:HDX10.0 set OFF 'when not equal.//
2882
2883 //Endif//
2884
2885 == **Operator** ==
2886
2887 (% class="table-bordered" %)
2888 |**Operation**|**Symbol**|**Example**|**Return type**
2889 |Addition|+|A1=A2+A3|Return type depending on the type of variable or address of the addition
2890 |Subtraction|-|A1=A2-A3|Return type depending on the type of variable or address of the subtraction
2891 |Multiplication|*|A1=A2*A3|Return type depending on the type of variable or address of the multiplication
2892 |Division|/|A1=A2/A3|Return type depending on the type of variable or address of the division
2893 |Remainder|Mod ~(%)|(((
2894 A1=A2 mod A3
2895
2896 A1=A2%A3
2897 )))|Returns the remainder of the division of two numbers. The type of the return value is an integer
2898 |Logical OR|Or(~|)|(((
2899 A1=A2 or A3
2900
2901 A1=A2|A3
2902 )))|Returns the result of a logical OR. The type of the return value is an integer.
2903 |Logic AND|And (&)|(((
2904 A1=A2 and A3
2905
2906 A1=A2&A3
2907 )))|Returns the result of a logical AND. The type of the return value is an integer.
2908 |Logical XOR|Xor (^)|(((
2909 A1=A2 xor A3
2910
2911 A1=A2^A3
2912 )))|Returns the result of a logical XOR. The type of the return value is an integer.
2913 |Logical reversal|Not (!)|(((
2914 A1=not A1
2915
2916 A1=A2!A3
2917 )))|Returns the result of a logical reversal. The type of the return value is an integer.
2918 |Left shift|<<|A1=A2<<A3|Shift the value of A2 to the left by A3 digits and return the displacement result. The type of the return value is an integer.
2919 |Right shift|>>|A1=A2>>A3|Shift the value of A2 to the right by A3 digits and return the displacement result. The type of the return value is an integer.
2920 |Bit reversal|~~|A1=~~A1|Perform a bit reversal on a value. The type of the return value is an integer.
2921
2922 == **PI_GetTickCount** ==
2923
2924 **Function**
2925
2926 PI_GetTickCount (A1, A2)
2927
2928 **Description**
2929
2930 Writethe startingtime tothe set address asa 32-bit integer.
2931
2932 **Parameters**
2933
2934 **A1: **Source data could only be the HMI internal or external register starting with "@".
2935
2936 **A2: **=0: Unit of time for returning 0ms;(the value will become 0 after 49.7 days and so on)
2937
2938 ~=1: Unit of time for returning 10 ms;(the value will become 0 after 497 days and so on)
2939
2940 ~=2: Unit of time for returning 100 ms;(the value will become 0 after 4970 days and so on)
2941
2942 ~=3: Unit of time for returning 1000ms;(the value will become 0 after 49700 days and so on)
2943
2944 **✎Note: **If user restarts the hmi,all value will be 0.
2945
2946 **Example**
2947
2948 //PI_GetTickCount("@W_HDW100",0)'save the starting time in HDW100 address as a 32-bit integer.//
2949
2950 **Result: **HDW100=123456(different returned data for each moment)
2951
2952 == **Power** ==
2953
2954 **Function**
2955
2956 var = power (expr1, expr2)
2957
2958 **Description**
2959
2960 The value of [expr2] to the power of [expr1] will be assigned to Var.
2961
2962 **Parameters**
2963
2964 **var:** returned value.
2965
2966 **expr 1:** base number.
2967
2968 **expr 2:** power number.
2969
2970 **Example**
2971
2972 //Dim a as floating//
2973
2974 //a=power (2, 3) 'the value of 3 to the power of 2 is assigned to a.//
2975
2976 //Float2D("@W_HDW10",a) 'assign the float value of a to @W_HDW10//
2977
2978 **Result: **@W_HDW10=8
2979
2980 == **PrintText** ==
2981
2982 **Function**
2983
2984 PrintText(A)
2985
2986 **Description**
2987
2988 Print the content of A or locates in A.
2989
2990 **Parameters**
2991
2992 **A:** source data. A could be a variable or a string ( text information),not a register address.
2993
2994 **Example**
2995
2996 * A is text information
2997
2998 //PrintText("HMI 8070”)//
2999
3000 **Result: **Printer will print out “HMI 8070”
3001
3002 * A is variable
3003
3004 //Dim a as string//
3005
3006 //a= “HMI 8070”//
3007
3008 //PrintText(a)//
3009
3010 **Result:** Printer will print out “HMI 8070”
3011
3012 **✎Note:**
3013
3014 source data length range:1-128 characters.
3015
3016 == **RadToDeg** ==
3017
3018 **Function**
3019
3020 Var= RadToDeg(expr)
3021
3022 **Description**
3023
3024 Convert radiant value to degree, then assigned to Var.
3025
3026 **Parameters**
3027
3028 **Var:** return degree value.
3029
3030 **expr:** input radiant value.
3031
3032 **Example**
3033
3034 //Dim a as floating//
3035
3036 //a = RadToDeg(pi)    'assignt the degree value of ? to a.//
3037
3038 //Float2D("@W_HDW4",a) 'assign the degree value to address "@W_HDW4".//
3039
3040 **Result:** @W_HDW4=180
3041
3042 == **RAND** ==
3043
3044 **Function**
3045
3046 Var = rand(expr1)
3047
3048 **Description**
3049
3050 Generate a random number.
3051
3052 **Parameter**
3053
3054 **Var:** generated random number.
3055
3056 **Expr1:** the base number.
3057
3058 **Example**
3059
3060 //@W_HDW0=rand(@W_HDW0) 'Set the value of address@W_HDW0 as the base number to generate random number.//
3061
3062 **Result:** @W_HDW0 random number.
3063
3064 == **ReadAddr** ==
3065
3066 **Function**
3067
3068 Word = ReadAddr(A1)
3069
3070 **Description**
3071
3072 Assigned the red value from A1 to word.
3073
3074 **Parameter**
3075
3076 **Word: **return value
3077
3078 **Example**
3079
3080 //Dim word as integer//
3081
3082 //@W_HDW100=10//
3083
3084 //word = ReadAddr("@W_HDW100") 'Read the value of address @W_HDW100 and assign to word.//
3085
3086 //@W_HDW200=word//
3087
3088 **Result:** @W_HDW200=10
3089
3090 == **ReadWordFormFile** ==
3091
3092 **Function**
3093
3094 ReadWordFormFile (A1, A2, A3, A4, A5, A6)
3095
3096 **Description**
3097
3098 Read data of specified length from specified file
3099
3100 **Parameters**
3101
3102 A1: File location (value is an integer);
3103
3104 In HMI:
3105
3106 ~=0: Recipe folder in HMI flash;
3107
3108 ~=1: Custom folder in UDisk (USB flash disk);
3109
3110 ~= 2: Custom folder in SD card.
3111
3112 ~=3: Custom folder in HMI flash;
3113
3114 In simulator:
3115
3116 ~= 0: D:/Recipe/
3117
3118 ~= 1: C:/WECON/CustomFileDir/
3119
3120 ~= 2: C:/WECON/CustomFileDir/
3121
3122 ~= 3: C:/WECON/CustomFileDir/
3123
3124 **✎Note:** A1 can be an address, variable or value.
3125
3126 A2: File name (value is a string);
3127
3128 Input the file name want to write.
3129
3130 **✎Note: **A2 must be an address, and the length of the file name cannot exceed 32 characters.
3131
3132 A3: Data start address (value is a string);
3133
3134 Input the data want to write
3135
3136 **✎Note: **A3 must be the address.
3137
3138 A4: Data length (value is an integer)
3139
3140 Set the length of the data to be written (unit:word)
3141
3142 **✎Note: **A4 can be an address , variable or value.
3143
3144 A5: Return value (value is an integer)
3145
3146 ~= 1: Successfully read
3147
3148 ~= 2: Failed to open the folder
3149
3150 ~= 3: Read address error
3151
3152 ~= 4: File reading error
3153
3154 **✎Note: **A5 must be an address.
3155
3156 A6: Folder name (value is a string);
3157
3158 Input the folder where to be written the file.
3159
3160 **✎Note:** A6 can be an address or a variable or a character string, and the length of the folder name cannot exceed 32 characters
3161
3162 **Example**
3163
3164 ReadWordFormFile(@W_HDW1254,"@W_HDW4200","@W_HDW2000",@W_HDW4000,"@W_HDW4100", @W_HDW4300)'Write the @W_HDW4000 words in the file @W_HDW4200 in the directory @W_HDW4300 into the address @W_HDW2000 specified location by @W_HDW1254
3165
3166 == **Right** ==
3167
3168 **Function**
3169
3170 val = Right (string, length)
3171
3172 **Description**
3173
3174 Return a string of the specified length from the right side of parameter.
3175
3176 **Parameter**
3177
3178 **string: **the operated string.
3179
3180 **length:** the designated number of byte required to return, count from the right side.
3181
3182 **Example**
3183
3184 //@W_HDW103= Right("Hello", 3) 'return "llo"//
3185
3186 **Result: **@W_HDW103="llo"
3187
3188 == **RTrim** ==
3189
3190 **Function**
3191
3192 val = RTrim(str)
3193
3194 **Description**
3195
3196 Clear the empty part on the right side of string [str], then assign the empty part to val
3197
3198 **Parameter**
3199
3200 **val: **returned value.
3201
3202 **str:** the string needs to be operated.
3203
3204 **Example**
3205
3206 //@W_HDW0 = RTrim("   -Hell  o-  ") 'retrun"   -Hell  o-"//
3207
3208 **Result:** @W_HDW0display "   -Hell  o-"
3209
3210 == **S2F** ==
3211
3212 **Function**
3213
3214 S2F (A1,A2,s1)
3215
3216 **Description**
3217
3218 S2F is used to translate the string stored in A1 to floating and store the floating number in A2 according to the data format shown in A2.
3219
3220 **Parameters**
3221
3222 **A1:** initial data address, used to store the string data, it should be the internal address of HMI or external address that started with “@”,like @W_HDW0
3223
3224 **A2:** destination address, used to store the floating number data. It should be the internal address of HMI or external address that started with “@”,like @W_HDW0
3225
3226 **S1:** display format of target data, for example m.nf, m means the length of string is m, n means the decimal places, f is the format used to output single precision number. (Since the floating point number is up to 7 digits, the decimal point in the string is also a bit, so it is recommended that the length should not exceed 8 bits)
3227
3228 Return value: none
3229
3230 **Example**
3231
3232 The lengTh of string is 8
3233
3234 //@W_HDW0="12345.67"//'Assign the string “12345.67" to HDW1
3235
3236 //S2F("@W_HDW0","@W_HDW100","8.2f") 'read string "12345.67 "from HDW0and convert it into a floating point with 2 decimal places, store in the HDW100 .//
3237
3238 **Result: **@W_HDW100 address displays “12345.67”.
3239
3240 The length of string is less than 8
3241
3242 //@W_HDW0="1234.5 67"‘assign the string“1234.567”to HDW1//
3243
3244 //S2F("@W_HDW0","@W_HDW100","6.2f") ' read string "1234 .5"from HDW0and convert it into a floating point with 2 decimal places, store in the HDW100 .//
3245
3246 **Result: **the floating value of @W_HDW100 is 1234.50
3247
3248 The length of string is more than 8
3249
3250 //@W_HDW0="12345.6789"’assign the string “12345.6789” to HDW1//
3251
3252 //S2F("@W_HDW0","@W_HDW100","8.2f") ' read string "12345 .67" from HDW0 and convert it into a floating point with 2 decimal places, store in the HDW100 .//
3253
3254 **Result: **the floating value of @W_HDW100 is 12345.67
3255
3256 == **SetB** ==
3257
3258 **Function**
3259
3260 SetB(A1)
3261
3262 **Description**
3263
3264 Set the bit A1 ON.
3265
3266 **Parameters**
3267
3268 **A1:**Bit address
3269
3270 **Example**
3271
3272 //SetB(@B_HDX100.0) 'Set the address {@B_HDX100.0} ON//
3273
3274 **Result: **@B_HDX100.0=1
3275
3276 == **SetKeyMap** ==
3277
3278 **Function**
3279
3280 SetKeyMap(A1,A2,A3)
3281
3282 **Description**
3283
3284 The key values of the keyboard are mapped so that multiple keyboard buttons perform the same function.
3285
3286 **Parameters**
3287
3288 **A1:** The starting address of the source key;It needs to be an address format;
3289
3290 **A2: **The starting address of the mapped value; It needs to be an address format;
3291
3292 **A3: **Mapping length (continuous length of mapped address); It needs to be a value, the maximum mapping range: 108 key values;
3293
3294 **Example**
3295
3296 //@W_HDW3000 = 3 ' The starting address of the source key//
3297
3298 //@W_HDW3001 = 5//
3299
3300 //@W_HDW3002 = 7//
3301
3302 //@W_HDW3003 = 9//
3303
3304 //@W_HDW3004 = 61//
3305
3306 //@W_HDW4100 = 103 'The starting address of the mapped value//
3307
3308 //@W_HDW4101 = 105//
3309
3310 //@W_HDW4102 = 106//
3311
3312 //@W_HDW4103 = 108//
3313
3314 //@W_HDW4104 = 28//
3315
3316 //SetKeyMap("@W_HDW3000","@W_HDW4100",5) ' Map the values of the HDW4000~~HDW4004 addresses to the HDW3000~~HDW3004 addresses.//
3317
3318 **Result**
3319
3320 Map the value of the HDW4000~~HDW4004 address (mapped to 103 105 106 108 28) to the value of the HDW3000~~HDW3004 address (source key value 3 5 7 9 61)
3321
3322 Button 2 (key value 3) is mapped to the direction key (key value is 103), button 4 (key value 5) is mapped to the left arrow key (key value is 105), and so on. When using the keyboard, the function of input 2 could be performed on both the button 2 and the direction button.
3323
3324 == **SignedInt16** ==
3325
3326 **Function**
3327
3328 val = SignedInt16(A1)
3329
3330 **Description**
3331
3332 Assign the value to {val} from address A1 which is signed integer.
3333
3334 **Parameters**
3335
3336 **A1: **contain signed integer as "@W_HDW000002"
3337
3338 **Val: **returned value
3339
3340 **Example**
3341
3342 //Dim a as integer 'Integer variable a//
3343
3344 //a = SignedInt16("@W_HDW0") 'read signed integer from HDW0 addresses and assign the value to a//
3345
3346 //@W_HDW2=a'assign the value a to HDW2//
3347
3348 **Input: **@W_HDW0=-2:
3349
3350 **Result:** @W_HDW2=-2.
3351
3352 == **SignedInt32** ==
3353
3354 **Function**
3355
3356 val = SignedInt32 (A1)
3357
3358 **Description**
3359
3360 Assign the value to {val} from address A1 which is signed even integer.
3361
3362 **Parameters**
3363
3364 **A1: **the address contains signed even integer
3365
3366 **Val:** Returned value
3367
3368 **Example**
3369
3370 //Dim a as integer 'define {a} as a integer//
3371
3372 //a = SignedInt32("@W_HDW0") 'read signed even integer from HDW0, then assign this value to a.//
3373
3374 //@W_HDW2=a 'assign the value of a to HDW2//
3375
3376 //@W_HDW3=a>>16//
3377
3378 **Input: **@W_HDW0=-2
3379
3380 **Result:** @W_HDW2=-2
3381
3382 @W_HDW13=-1
3383
3384 == **Sin** ==
3385
3386 **Function**
3387
3388 val = Sin(A1)
3389
3390 **Description**
3391
3392 Get the sine value of A1, and copy result to val.
3393
3394 **Parameters**
3395
3396 **A1: **A1 needs to be an angle.
3397
3398 **Val: **Returned value.
3399
3400 **Example**
3401
3402 //Dim a as floating 'floating variable a,b//
3403
3404 //a=sin(pi/6) 'return sinb to a//
3405
3406 //Float2D("@W_HDW13",a) 'assign the value of the floating variable a to address HDW13.//
3407
3408 **Result:** @W_HDW13=0.5
3409
3410 == **SleepA** ==
3411
3412 **Function**
3413
3414 SleepA(T)
3415
3416 **Description**
3417
3418 Wait time T(ms).
3419
3420 **Parameters**
3421
3422 **T:** wait time, the unit is [ms]
3423
3424 **Returned value:** none.
3425
3426 **Example**
3427
3428 //SleepA(10) 'wait 10ms//
3429
3430 **Result:** When the script runs to SleepA(10), it means the scripts would go running after waiting 10ms
3431
3432 == **Sqr** ==
3433
3434 **Function**
3435
3436 val = Sqr(A1)
3437
3438 **Description**
3439
3440 Assign a square root value of A1 to val.
3441
3442 **Parameters**
3443
3444 **A1: **the data need to be operated
3445
3446 **Val: **Returned value
3447
3448 **Example**
3449
3450 //@W_HDW0 = Sqr(4) 'calculate the square root of HDW0//
3451
3452 **Result:** @W_HDW0=2
3453
3454 == **StAndFtChange** ==
3455
3456 **Function**
3457
3458 StAndFtChange(A1,A2,A3)
3459
3460 **Description**
3461
3462 Calculate the number of seconds from January 1, 1970 to the current time, and also be invertible.
3463
3464 **Parameters**
3465
3466 **A1: **The start address of curren t time (Enter or output year, month, day, minute, and second); It needs to begin with address"@", and occupies 6 addresses;
3467
3468 **A2: **The number of seconds; It needs to begin with address “@", data format 32-bit unsigned.
3469
3470 **A3: **conversion method;
3471
3472 A3=0, convert time to seconds;
3473
3474 A3=1, convert seconds to time;
3475
3476 **Returned value: **none;
3477
3478 **Example**
3479
3480 Script 1
3481
3482 //StAndFtChange("@W_HDW10","@W_HDW20",0) // //‘use HDW10 as start address, and enter year, month, day, hour, minute, second. The script calculates the number of seconds from January 1, 1970 to the time of the entry, and stores the result in HDW20//
3483
3484 **Input: **HDW10 = 2017,HDW11 = 12, HDW12 = 9 , HDW13 = 15, HDW14 = 15, HDW15 = 0
3485
3486 **Output:** 1512832500
3487
3488 Script 2
3489
3490 //StAndFtChange("@W_HDW30","@W_HDW20",1) ‘read number of seconds from HDW20, and the script calculates the date time, and stores the result start from HDW30//
3491
3492 **Input:** 1512833760
3493
3494 **Output:** HDW30 = 2017, HDW31 = 12, HDW32 = 9, HDW33 = 15, HDW34 = 36, HDW35 = 0
3495
3496 == **Sub** ==
3497
3498 **Function**
3499
3500 Sub name (arglist)
3501
3502 statements
3503
3504 End Sub
3505
3506 **Description**
3507
3508 Declare the name, parameters and codes of the Sub (sub function)
3509
3510 **Parameters**
3511
3512 **Name: **naming rules refer to variable.
3513
3514 **Arglist: **variable list.
3515
3516 **Statements:** the code set of the sub function.
3517
3518 **Example**
3519
3520 //sub samesub(a,b as integer) ' samesub and integer variable a,b//
3521
3522 //c=a+b//
3523
3524 //@W_HDW0=c//
3525
3526 //endsub//
3527
3528 //samesub(1,12) 'call function samesub//
3529
3530 **Result:** @W_HDW0=13
3531
3532 == **SWAP** ==
3533
3534 **Function**
3535
3536 SWAP(A1,length)
3537
3538 **Description**
3539
3540 Swap the big-endian with the little-endian from address A1, swap length is adjustable.
3541
3542 **Parameters**
3543
3544 **A1: **the swapped high endian, need to be an address as HDW_000002.
3545
3546 **Length: **swap length.
3547
3548 **Returned value:** None.
3549
3550 **Example**
3551
3552 //@W_HDW103=0x1234 'assign value to HDW103//
3553
3554 //@W_HDW104=0x2345 'assign value to HDW104//
3555
3556 //@W_HDW105=0x2565 'assign value to HDW105//
3557
3558 //@W_HDW106=0x2675 'assign value to HDW106//
3559
3560 //SWAP(@W_HDW103,4) 'swap the high and low endian for the 4 adjacent addresses start with HDW103.//
3561
3562 **Result:**
3563
3564 @W_HDW103=0x3412
3565
3566 @W_HDW104=0x4523
3567
3568 @W_HDW105=0x6525
3569
3570 @W_HDW106=0x7526
3571
3572 == **Tan** ==
3573
3574 **Function**
3575
3576 val = Tan(A1)
3577
3578 **Description**
3579
3580 Get the returned tagent value of A1, and then assign to val.
3581
3582 **Parameters**
3583
3584 **A1: **A1 needs to be an angle.
3585
3586 **Val: **Returned value.
3587
3588 **Example**
3589
3590 //Dim a as floating 'define a floating variable a//
3591
3592 //a=TAN(pi/3) 'calculate the tangent value of pi/3 and assign to a//
3593
3594 //Float2D("@W_HDW16",a) 'assign the value of a to HDW16//
3595
3596 **Result:** @W_HDW13=1.732
3597
3598 == **Trim** ==
3599
3600 **Function**
3601
3602 val = Trim(A1)
3603
3604 **Description**
3605
3606 Return A string in A1 without empty string next to it.
3607
3608 **Parameters**
3609
3610 **A1: **The operated string
3611
3612 **val: **Returned value
3613
3614 **Example**
3615
3616 //@W_HDW1=Trim(" ab ")//
3617
3618 **Result: **@W_HDW1="ab"
3619
3620 == **UCase** ==
3621
3622 **Function**
3623
3624 val = UCase(A1)
3625
3626 **Description**
3627
3628 Capitalize the string data, and then assign the value to val.
3629
3630 **Parameters**
3631
3632 **A1: **Operated string, address or variable.
3633
3634 **Val: **Returned value
3635
3636 **Example**
3637
3638 //@W_HDW1=ucase("abcd") 'Capitalize abcd then assign the value to HDW1//
3639
3640 **Result: **@W_HDW1="ABCD"
3641
3642 == **Variable** ==
3643
3644 **Description**
3645
3646 A variable is any factor, trait, or condition that could exist in differing amounts or types.
3647
3648 **Define variable**
3649
3650 Use Dim to define variable in script. The variable could be string, floating, integer.
3651
3652 **Example:**
3653
3654 //Dim a as floating ‘define variable {a} as a floating.//
3655
3656 //Dim b,c,d as integer‘define variable {b,c,d} as integer//
3657
3658 **Naming rules**
3659
3660 The first letter needs to be English letter.
3661
3662 No symbols.
3663
3664 Maximum character length 15 allowed.
3665
3666 == **W2B** ==
3667
3668 **Function**
3669
3670 W2B(A1, A2, A3)
3671
3672 **Description**
3673
3674 Replace the high endian of [A2]+1 with the high endian of A2.
3675
3676 **Parameters**
3677
3678 **A1:** operated address.
3679
3680 **A2:** source address.
3681
3682 **A3: **the conversion length.
3683
3684 **Returned value:** none.
3685
3686 **Example**
3687
3688 //@W_HDW0 = 4660 'assign 16bit value 1234 to HDW0.//
3689
3690 //@W_HDW1=0x5678 'assign 16bit value 5678 to HDW1.//
3691
3692 //@W_HDW2 = 0x2425 'assign 16bit value 2425 to HDW1.//
3693
3694 //@W_HDW3 = 0x3536 'assign 16bit value 3536 to HDW0.//
3695
3696 //@W_HDW4 = 0x1415 'assign 16bit value 1415 to HDW0.//
3697
3698 //W2B(@W_HDW20,@W_HDW0, @W_HDW10)//
3699
3700 //@W_HDW10=1 ‘save the high endian {34} of HDW0 to HDW20.//
3701
3702 **Result:** @W_HDW20=0x34, @W_HDW21=0, @W_HDW22=0
3703
3704 == **W2D** ==
3705
3706 **Function**
3707
3708 W2D(A1, A2)
3709
3710 **Description**
3711
3712 Convert the unsigned Word to unsigned Dword and save the result in A1.
3713
3714 **Parameters**
3715
3716 **A1: **operated address .
3717
3718 **A2:** source address.
3719
3720 Returned value.
3721
3722 **Example**
3723
3724 Unsigned decimal word
3725
3726 //@W_HDW0 = 1234 'assign 1234 to HDW0.//
3727
3728 //W2D(@W_HDW2, @W_HDW0) 'convert unsigned word {1234} from HDW0 to Dword and save in HDW2//
3729
3730 **Result:** @W_HDW0=12345, @W_HDW2=12345, @W_HDW3=0
3731
3732 Signed decimal word
3733
3734 //@W_HDW0 = -12345 'assign value to HDW0: convert {-12344} to unsigned decimal word is {53191}.//
3735
3736 //W2D(@W_HDW2, @W_HDW0) 'save unsigned Dword to HDW0//
3737
3738 **Result: **@W_HDW0=-12345,@W_HDW2=53191,@W_HDW3=0
3739
3740 == **W2F** ==
3741
3742 **Function**
3743
3744 A1 = W2F (A2)
3745
3746 **Description**
3747
3748 Convert a 16bit integer to a 32bit floating, and then save to the next word of A1.
3749
3750 Parameters
3751
3752 **A1:** operated address.
3753
3754 **A2:** source address.
3755
3756 Returned value: none.
3757
3758 **Example**
3759
3760 A1, A2 are addresses
3761
3762 //@W_HDW0 = 1234 ' assign unsigned word {1234} HDW0 @W_HDW1=W 2F(@W_HDW0) ‘ Convert {1234} to a 32bit floating and then save to HDW1, HDW2.//
3763
3764 **Result: **@W_HDW1=1234'32bit floating
3765
3766 A1 is an address,A2 is variable
3767
3768 //dim a as integer//
3769
3770 //a=134 'define a integer 134 to a,//
3771
3772 //@W_HDW2=W2F (a) 'convert to 32bit floating save to HDW1, HDW2.//
3773
3774 **Result: **@W_HDW1=134' 32bit floating
3775
3776 == **W2S** ==
3777
3778 **Function**
3779
3780 W2S(A1,A2,S1)
3781
3782 **Description**
3783
3784 Convert integer word in address A1 text as S1 format, and then save to A2.
3785
3786 **Parameters**
3787
3788 **A1:** operated address.
3789
3790 **A2:** source address.
3791
3792 **S1:** saving format.
3793
3794 * d format: Decimal format.d: Real data length.Md: Designated data length. 0md: Designated data length if the length is shorter than m adds 0 at the left.
3795 * format: Unsigned octal format. Mo and 0mo is also applied.
3796 * x format: unsigned Hex integer format ?Mx and 0mx is also applied.
3797 * c format: ASCII format.
3798
3799 **Example**
3800
3801 Decimal format
3802
3803 //@W_HDW1=1456'assign value {1456} to HDW1.//
3804
3805 //W2S("@W_HDW1", "@W_HDW10", "6d") ' convert{1456} to decimal text and save to HDW10.//
3806
3807 **Result: **@W_HDW10 shown "1456"
3808
3809 0md
3810
3811 //@W_HDW1=1456 ' assign value {1456} to HDW1//
3812
3813 //W2S("@W_HDW1", "@W_HDW10", "06d") ' convert{1456} to integer decimal text and add 2 {0} on the left of the data then save to HDW10.//
3814
3815 **Result:** @W_HDW10 show text "001456"
3816
3817 == **WaitEthernetStart** ==
3818
3819 **Function**
3820
3821 WaitEthernetStart (A1)
3822
3823 **Description**
3824
3825 Waiting for Ethernet to start, it will extend the HMI start up time (only added in PI i series, Ethernet start up is earlier than HMI in other PI series)
3826
3827 **Parameters**
3828
3829 **A1: **Waiting timeout (1~~20s)
3830
3831 If A1=0, the wait timeout is 10s;
3832
3833 If A1>20, the wait timeout is 20s;
3834
3835 **Returned value:** None
3836
3837 **Example**
3838
3839 //WaitEthernetStart (15)//
3840
3841 ‘The maximum waiting time is 15 seconds. If Ethernet is not started within 15 seconds, HMI will start the system and no longer wait for ethernet.
3842
3843 == **WHILE ... WEND** ==
3844
3845 **Function**
3846
3847 While condition
3848
3849 [statements]
3850
3851 Wend
3852
3853 **Description**
3854
3855 If the condition is true, then all the commands before Wend in the statement will be executed then recheck the condition, if the condition is false, the command after Wend will be executed.
3856
3857 **Parameters**
3858
3859 **Condition: **Number or string, the result represents as True or False.
3860
3861 **Returned value:** None.
3862
3863 **Example**
3864
3865 //while @W_HDW1>50 'the condition is the value of HDW1 bigger than 50.//
3866
3867 //@W_HDW1=@W_HDW1-1 'when the condition is true, execute subtract 1 from 1HDW.//
3868
3869 //wend//
3870
3871 //@W_HDW2=@W_HDW2+1 ' when the condition is false, execute add 1 from 1HDW.//
3872
3873 **Result:** If HDW1=60, after executed; HDW1=50, if the condition is true.
3874
3875 == **WriteAddr** ==
3876
3877 **Function**
3878
3879 WriteAddr(A1,A2)
3880
3881 **Description**
3882
3883 Assign the value from A2 to address A1.
3884
3885 **Parameters**
3886
3887 **A1:** operated address
3888
3889 **A2:** source address
3890
3891 **Returned value:** None.
3892
3893 **Example**
3894
3895 //dim f as integer ' integer f//
3896
3897 //f=13 ' assign the value 13 to f//
3898
3899 //WriteAddr("@W_HDW1",f) ' write the value to HDW1.//
3900
3901 //WriteAddr("@W_HDW10",@W_HDW2) ' write the value from HDW2 to HDW10.//
3902
3903 Result:
3904
3905 HDW1=13
3906
3907 HDW10= HDW2'IF HDW2=1456,Then HDW10=1456;IF HDW2=-123,Then HDW10=-123
3908
3909 == **WriteWordToFile** ==
3910
3911 **Function**
3912
3913 WriteWordToFile (A1,A2,A3,A4,A5,A6)
3914
3915 **Description**
3916
3917 Write data of designated length to specified file
3918
3919 **Parameters**
3920
3921 A1: File location (value is an integer);
3922
3923 In HMI:
3924
3925 ~=0: Recipe folder in HMI flash;
3926
3927 ~=1: Custom folder in UDisk (USB flash disk);
3928
3929 ~= 2: Custom folder in SD card.
3930
3931 ~=3: Custom folder in HMI flash;
3932
3933 In simulator:
3934
3935 ~= 0: D:/Recipe/
3936
3937 ~= 1: C:/WECON/CustomFileDir/
3938
3939 ~= 2: C:/WECON/CustomFileDir/
3940
3941 ~= 3: C:/WECON/CustomFileDir/
3942
3943 **✎Note: **A1 can be an address, variable or value.
3944
3945 A2: File name (value is a string);
3946
3947 Input the file name want to write.
3948
3949 **✎Note: **A2 must be an address, and the length of the file name cannot exceed 32 characters.
3950
3951 A3: Data start address (value is a string);
3952
3953 Input the data want to write
3954
3955 **✎Note: **A3 must be the address.
3956
3957 A4: Data length (value is an integer)
3958
3959 Set the length of the data to be written (unit:word)
3960
3961 **✎Note: **A4 can be an address , variable or value.
3962
3963 A5: Return value (value is an integer)
3964
3965 ~= 1: Successfully written
3966
3967 ~= 2: Failed to open the folder
3968
3969 ~= 3: Read address error
3970
3971 ~= 4: File writing error
3972
3973 ~= 5: The file already exists
3974
3975 **✎Note: **A5 must be an address.
3976
3977 A6: Folder name (value is a string);
3978
3979 Input the folder where to be written the file.
3980
3981 **✎Note: **A6 can be an address or a variable or a character string, and the length of the folder name cannot exceed 32 characters
3982
3983 **Example**
3984
3985 WriteWordToFile(@W_HDW1254,"@W_HDW4200","@W_HDW1000",@W_HDW4000,"@W_HDW4100", @W_HDW4300)'Write the @W_HDW4000 words in the address @W_HDW1000 to the file @W_HDW4200 in directory @W_HDW4300 specified location by @W_HDW1254