Changes for page 01 Lua Functions

Last modified by Theodore Xu on 2023/10/26 10:51

From version 5.8
edited by Stone Wu
on 2022/07/12 09:25
Change comment: (Autosaved)
To version 5.5
edited by Stone Wu
on 2022/07/12 09:15
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,4 +1,4 @@
1 -= **1 Interface description** =
1 += **1 Interface Description** =
2 2  
3 3  == **Data type definition** ==
4 4  
... ... @@ -92,20 +92,24 @@
92 92  1. From the print result, the first line and the second line are successfully called and returns true; the third line fails the call, the error message is translated as: the bar student has been registered, and there is indeed an error in the code.
93 93  1. The fourth line of code uses two variables to receive the return value. The call failed, the first variable stat is nil, and the second variable err stores the error message. Then print it out using print, which is the output of the third line. This example shows how to capture and view the error message.
94 94  
95 -== **Modification of print function** ==
95 +== **Modification of the Print Function** ==
96 96  
97 -For the convenience of remote development, the print data is sent to the front end (web page) by means of network transmission, and the user can see the result of the debug output, because it consumes certain data and occupies the bandwidth of the server (or occupies server resources). So the following restrictions are made.
97 +For the convenience of remote development, the print data is sent to the front end (web page) by means of network transmission, and the user can see the result of the debug output, because it consumes certain data and occupies the bandwidth of the server (or occupies server resources). So make the following restrictions:
98 98  
99 -1. **Interval limit: **When debugging, transfer once every 2~~3 seconds;
100 -1. **Data limit: **The transfer data cannot be larger than 1.5KB in a single transmission, otherwise the extra part will be ignored;
101 -1. **Transmission limit: **The data transmission will be stopped automatically after the debugging windows is not closed normally. Only when it is in the debugging window and the switch is on, there is data transmission;
99 +**1.Interval limit: **When debugging, transfer once every 2~~3 seconds;
102 102  
101 +**2.Data limit: **The transfer data cannot be larger than 1.5KB, and the extra part will be ignored;
102 +
103 +**3.Transmission limit: **The data transmission will be stopped automatically after the debugging windows is not closed normally. Only when it is in the debugging window and the switch is on, there is data transmission;
104 +
103 103  Users should pay attention to avoid printing a lot of useless information, should minimize the debug output
104 104  
105 105  In addition, please refer to the front-end documentation for how to use view debugging.
106 106  
107 107  (((
108 -= **2 Address operation** =
110 += **2 Address Operation** =
111 +
112 +
109 109  )))
110 110  
111 111  |=16-bit data formal|=HLword|=32-bit data formal|=HLword|= 64-bit data formal|=HLword
... ... @@ -138,17 +138,20 @@
138 138  43218765
139 139  )))|10
140 140  
141 - Table 2-1
145 +* If HLword enters any other value, it will be treated as invalid.
142 142  
143 -(% class="box errormessage" %)
144 -(((
145 -**✎Note: **If HLword enters any other value, it will be treated as invalid.
146 -)))
147 + Demo:  Reads a 32-bit floating-point number at position D0 of PLC
147 147  
148 -== **addr_getshort(string addr[, number type, number hlword])** ==
149 149  
150 -**Function:** Read 16-bit signed decimal address
151 151  
151 +[[image:企业微信截图_20210506180640.png||height="301" width="600" class="img-thumbnail"]]
152 +
153 +== **2.1 addr_getshort(string addr[, number type, number hlword])** ==
154 +
155 +**Function:**
156 +
157 +Read 16-bit signed decimal address
158 +
152 152  **Parameters:**
153 153  
154 154  //addr//: address
... ... @@ -166,11 +166,13 @@
166 166  Failed: multi
167 167  
168 168  (((
169 -== **addr_setshort(string addr, number num[, number type, number hlword])** ==
176 +== **2.2 addr_setshort(string addr, number num[, number type, number hlword])** ==
170 170  )))
171 171  
172 -**Function:** Write 16-bit signed decimal address
179 +**Function:**
173 173  
181 +Write 16-bit signed decimal address
182 +
174 174  **Parameters:**
175 175  
176 176  //addr//: address
... ... @@ -188,11 +188,13 @@
188 188  Failed: multi
189 189  
190 190  (((
191 -== **addr_getword(string addr[, number type, number hlword])** ==
200 +== **2.3 addr_getword(string addr[, number type, number hlword])** ==
192 192  )))
193 193  
194 -**Function:** Read 16-bit unsigned decimal address
203 +**Function:**
195 195  
205 +Read 16-bit unsigned decimal address
206 +
196 196  **Parameters:**
197 197  
198 198  //addr//: address
... ... @@ -208,11 +208,13 @@
208 208  Failed: multi
209 209  
210 210  (((
211 -== **addr_setword(string addr, number num[, number type, number hlword])** ==
222 +== **2.4 addr_setword(string addr, number num[, number type, number hlword])** ==
212 212  )))
213 213  
214 -**Function:**Write 16-bit unsigned decimal address
225 +**Function:**
215 215  
227 +Write 16-bit unsigned decimal address
228 +
216 216  **Parameters:**
217 217  
218 218  //addr//: address
... ... @@ -230,11 +230,13 @@
230 230  Failed: multi
231 231  
232 232  (((
233 -== **addr_getint(string addr[, number type, number hlword])** ==
246 +== **2.5 addr_getint(string addr[, number type, number hlword])** ==
234 234  )))
235 235  
236 -**Function:** Read 32-bit signed decimal address
249 +**Function:**
237 237  
251 +Read 32-bit signed decimal address
252 +
238 238  **Parameters:**
239 239  
240 240  //addr//: address
... ... @@ -250,11 +250,13 @@
250 250  Failed: multi
251 251  
252 252  (((
253 -== **addr_setint(string addr, number num[, number type, number hlword])** ==
268 +== **2.6 addr_setint(string addr, number num[, number type, number hlword])** ==
254 254  )))
255 255  
256 -**Function:** Write 32-bit signed decimal address
271 +**Function:**
257 257  
273 +Write 32-bit signed decimal address
274 +
258 258  **Parameters:**
259 259  
260 260  //addr//: address
... ... @@ -272,11 +272,13 @@
272 272  Failed: multi
273 273  
274 274  (((
275 -== **addr_getdword(string addr[, number type, number hlword])** ==
292 +== **2.7 addr_getdword(string addr[, number type, number hlword])** ==
276 276  )))
277 277  
278 -**Function:** Read 32-bit unsigned decimal address
295 +**Function:**
279 279  
297 +Read 32-bit unsigned decimal address
298 +
280 280  **Parameters:**
281 281  
282 282  //addr//: address
... ... @@ -292,11 +292,13 @@
292 292  Failed: multi
293 293  
294 294  (((
295 -== **addr_setdword(string addr, number num[, number type, number hlword])** ==
314 +== **2.8 addr_setdword(string addr, number num[, number type, number hlword])** ==
296 296  )))
297 297  
298 -**Function:** Write 32-bit unsigned decimal address
317 +**Function:**
299 299  
319 +Write 32-bit unsigned decimal address
320 +
300 300  **Parameters:**
301 301  
302 302  //addr//: address
... ... @@ -314,11 +314,13 @@
314 314  Failed: multi
315 315  
316 316  (((
317 -== **addr_getbit(string addr[, number type])** ==
338 +== **2.9 addr_getbit(string addr[, number type])** ==
318 318  )))
319 319  
320 -**Function:** Read a bit of the register address
341 +**Function:**
321 321  
343 +Read a bit of the register address
344 +
322 322  **Parameters:**
323 323  
324 324  //addr//: address
... ... @@ -334,11 +334,13 @@
334 334  Failed: multi
335 335  
336 336  (((
337 -== **addr_setbit(string addr, number num[, number type])** ==
360 +== **2.10 addr_setbit(string addr, number num[, number type])** ==
338 338  )))
339 339  
340 -**Function:** Write a bit of the register address
363 +**Function:**
341 341  
365 +Write a bit of the register address
366 +
342 342  **Parameters:**
343 343  
344 344  //addr//: address
... ... @@ -356,11 +356,13 @@
356 356  Failed: multi
357 357  
358 358  (((
359 -== **addr_getfloat(string addr[, number type, number hlword])** ==
384 +== **2.11 addr_getfloat(string addr[, number type, number hlword])** ==
360 360  )))
361 361  
362 -**Function:** Read 32-bit floating address
387 +**Function:**
363 363  
389 +Read 32-bit floating address
390 +
364 364  **Parameters:**
365 365  
366 366  //addr//: address
... ... @@ -376,11 +376,13 @@
376 376  Failed: multi
377 377  
378 378  (((
379 -== **addr_setfloat(string addr, number num[, number type, number hlword])** ==
406 +== **2.12 addr_setfloat(string addr, number num[, number type, number hlword])** ==
380 380  )))
381 381  
382 -**Function:** Write 32-bit floating address
409 +**Function:**
383 383  
411 +Write 32-bit floating address
412 +
384 384  **Parameters:**
385 385  
386 386  //addr//: address
... ... @@ -398,11 +398,13 @@
398 398  Failed: multi
399 399  
400 400  (((
401 -== **addr_getdouble(string addr[, number type, number hlword])** ==
430 +== **2.13 addr_getdouble(string addr[, number type, number hlword])** ==
402 402  )))
403 403  
404 -**Function:** Read 64-bit floating address
433 +**Function:**
405 405  
435 +Read 64-bit floating address
436 +
406 406  **Parameters:**
407 407  
408 408  //addr//: address
... ... @@ -418,11 +418,13 @@
418 418  Failed: multi
419 419  
420 420  (((
421 -== **addr_setdouble(string addr, number num[, number type, number hlword])** ==
452 +== **2.14 addr_setdouble(string addr, number num[, number type, number hlword])** ==
422 422  )))
423 423  
424 -**Function:** Write 64-bit floating address
455 +**Function:**
425 425  
457 +Write 64-bit floating address
458 +
426 426  **Parameters:**
427 427  
428 428  addr: address
... ... @@ -440,11 +440,13 @@
440 440  Failed: multi
441 441  
442 442  (((
443 -== **addr_getstring(string addr, number length[, number type, number hlbyte])** ==
476 +== **2.15 addr_getstring(string addr, number length[, number type, number hlbyte])** ==
444 444  )))
445 445  
446 -**Function:** Read the specified length string from address
479 +**Function:**
447 447  
481 +Read the specified length string from address
482 +
448 448  **Parameters:**
449 449  
450 450  //addr//: address
... ... @@ -462,11 +462,13 @@
462 462  Failed: multi
463 463  
464 464  (((
465 -== **addr_setstring(string addr, string str[, number type, number hlbyte])** ==
500 +== **2.16 addr_setstring(string addr, string str[, number type, number hlbyte])** ==
466 466  )))
467 467  
468 -**Function:** Write the specified length string to address
503 +**Function:**
469 469  
505 +Write the specified length string to address
506 +
470 470  **Parameters:**
471 471  
472 472  //addr//: address
... ... @@ -484,11 +484,13 @@
484 484  Failed: multi
485 485  
486 486  (((
487 -== **addr_bmov(string dst, string src, number length)** ==
524 +== **2.17 addr_bmov(string dst, string src, number length)** ==
488 488  )))
489 489  
490 -**Function:** Copy data from source address to destination address
527 +**Function:**
491 491  
529 +Copy data from source address to destination address
530 +
492 492  **Parameters:**
493 493  
494 494  //dst//: destination address
... ... @@ -504,11 +504,13 @@
504 504  **Failed: multi**
505 505  
506 506  (((
507 -== **addr_fill(string addr, number num, number length)** ==
546 +== **2.18 addr_fill(string addr, number num, number length)** ==
508 508  )))
509 509  
510 -**Function:** Write the same value to consecutive addresses
549 +**Function:**
511 511  
551 +Write the same value to consecutive addresses
552 +
512 512  **Parameters:**
513 513  
514 514  //addr//: address
... ... @@ -524,11 +524,13 @@
524 524  Failed: multi
525 525  
526 526  (((
527 -== **addr_newnoaddr(string addr, number offset)** ==
568 +== **2.19 addr_newnoaddr(string addr, number offset)** ==
528 528  )))
529 529  
530 -**Function:** Offset address value relative to //addr//
571 +**Function:**
531 531  
573 +Offset address value relative to //addr//
574 +
532 532  **Parameters:**
533 533  
534 534  //addr//: address
... ... @@ -542,11 +542,13 @@
542 542  Failed: multi
543 543  
544 544  (((
545 -== **addr_newstataddr(string addr, number offset)** ==
588 +== **2.20 addr_newstataddr(string addr, number offset)** ==
546 546  )))
547 547  
548 -**Function:** Offset station number relative to //addr //station number
591 +**Function:**
549 549  
593 +Offset station number relative to //addr //station number
594 +
550 550  **Parameters:**
551 551  
552 552  //addr//: address
... ... @@ -559,10 +559,12 @@
559 559  
560 560  Failed: multi
561 561  
562 -== **addr_gethex64(string addr[, number type, number hlword])** ==
607 +== **2.21 addr_gethex64(string addr[, number type, number hlword])** ==
563 563  
564 -**Function:** Read 64-bit hexadecimal numbers
609 +**Function:**
565 565  
611 +Read 64-bit hexadecimal numbers
612 +
566 566  **Parameters:**
567 567  
568 568  //addr//: address
... ... @@ -577,10 +577,12 @@
577 577  
578 578  Failed: multi
579 579  
580 -== **addr_sethex64(string addr, number num[, number type, number hlword])** ==
627 +== **2.22 addr_sethex64(string addr, number num[, number type, number hlword])** ==
581 581  
582 -**Function:** Write 64-bit hexadecimal addresses
629 +**Function:**
583 583  
631 +Write 64-bit hexadecimal addresses
632 +
584 584  **Parameters:**
585 585  
586 586  //addr//: address
... ... @@ -601,11 +601,11 @@
601 601  
602 602  Operations on the serial port such as read, write, etc. must use ':' for full mode calls, ie operations on an open serial object.
603 603  
604 -**Serial port name and mode**
653 +**Serial port name and mode:**
605 605  
606 606  The serial port configured in the communication configuration window cannot be configured again using the script. RS232 and RS458 (or RS422) can be used simultaneously, but RS422 and RS485 are mutually exclusive.For example, when the communication port is configured with COM1-485, the script can only open COM1-232, but not COM1-485/422. Similarly, when the communication port is configured with COM2-485, the script can only open COM2-232, but not COM2-485.
607 607  
608 -Attempting to use a script to open a serial port in an unsupported mode will result in an error directly, as below.
657 +Attempting to use a script to open a serial port in an unsupported mode will result in an error directly, as below
609 609  
610 610  |(((
611 611  local setup = {