Changes for page 01 Lua Functions
Last modified by Theodore Xu on 2023/10/26 10:51
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -106,6 +106,8 @@ 106 106 107 107 ((( 108 108 = **2 Address operation** = 109 + 110 + 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 - Table2-1143 +* 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 -))) 145 + 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 149 +[[image:企业微信截图_20210506180640.png||height="301" width="600" class="img-thumbnail"]] 150 + 151 +== **2.1 addr_getshort(string addr[, number type, number hlword])** == 152 + 153 +**Function:** 154 + 155 +Read 16-bit signed decimal address 156 + 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])** == 174 +== **2.2 addr_setshort(string addr, number num[, number type, number hlword])** == 170 170 ))) 171 171 172 -**Function:** Write 16-bit signed decimal address177 +**Function:** 173 173 179 +Write 16-bit signed decimal address 180 + 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])** == 198 +== **2.3 addr_getword(string addr[, number type, number hlword])** == 192 192 ))) 193 193 194 -**Function:** Read 16-bit unsigned decimal address201 +**Function:** 195 195 203 +Read 16-bit unsigned decimal address 204 + 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])** == 220 +== **2.4 addr_setword(string addr, number num[, number type, number hlword])** == 212 212 ))) 213 213 214 -**Function:** Write 16-bit unsigned decimal address223 +**Function:** 215 215 225 +Write 16-bit unsigned decimal address 226 + 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])** == 244 +== **2.5 addr_getint(string addr[, number type, number hlword])** == 234 234 ))) 235 235 236 -**Function:** Read 32-bit signed decimal address247 +**Function:** 237 237 249 +Read 32-bit signed decimal address 250 + 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])** == 266 +== **2.6 addr_setint(string addr, number num[, number type, number hlword])** == 254 254 ))) 255 255 256 -**Function:** Write 32-bit signed decimal address269 +**Function:** 257 257 271 +Write 32-bit signed decimal address 272 + 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])** == 290 +== **2.7 addr_getdword(string addr[, number type, number hlword])** == 276 276 ))) 277 277 278 -**Function:** Read 32-bit unsigned decimal address293 +**Function:** 279 279 295 +Read 32-bit unsigned decimal address 296 + 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])** == 312 +== **2.8 addr_setdword(string addr, number num[, number type, number hlword])** == 296 296 ))) 297 297 298 -**Function:** Write 32-bit unsigned decimal address315 +**Function:** 299 299 317 +Write 32-bit unsigned decimal address 318 + 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])** == 336 +== **2.9 addr_getbit(string addr[, number type])** == 318 318 ))) 319 319 320 -**Function:** Read a bit of the register address339 +**Function:** 321 321 341 +Read a bit of the register address 342 + 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])** == 358 +== **2.10 addr_setbit(string addr, number num[, number type])** == 338 338 ))) 339 339 340 -**Function:** Write a bit of the register address361 +**Function:** 341 341 363 +Write a bit of the register address 364 + 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])** == 382 +== **2.11 addr_getfloat(string addr[, number type, number hlword])** == 360 360 ))) 361 361 362 -**Function:** Read 32-bit floating address385 +**Function:** 363 363 387 +Read 32-bit floating address 388 + 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])** == 404 +== **2.12 addr_setfloat(string addr, number num[, number type, number hlword])** == 380 380 ))) 381 381 382 -**Function:** Write 32-bit floating address407 +**Function:** 383 383 409 +Write 32-bit floating address 410 + 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])** == 428 +== **2.13 addr_getdouble(string addr[, number type, number hlword])** == 402 402 ))) 403 403 404 -**Function:** Read 64-bit floating address431 +**Function:** 405 405 433 +Read 64-bit floating address 434 + 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])** == 450 +== **2.14 addr_setdouble(string addr, number num[, number type, number hlword])** == 422 422 ))) 423 423 424 -**Function:** Write 64-bit floating address453 +**Function:** 425 425 455 +Write 64-bit floating address 456 + 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])** == 474 +== **2.15 addr_getstring(string addr, number length[, number type, number hlbyte])** == 444 444 ))) 445 445 446 -**Function:** Read the specified length string from address477 +**Function:** 447 447 479 +Read the specified length string from address 480 + 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])** == 498 +== **2.16 addr_setstring(string addr, string str[, number type, number hlbyte])** == 466 466 ))) 467 467 468 -**Function:** Write the specified length string to address501 +**Function:** 469 469 503 +Write the specified length string to address 504 + 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)** == 522 +== **2.17 addr_bmov(string dst, string src, number length)** == 488 488 ))) 489 489 490 -**Function:** Copy data from source address to destination address525 +**Function:** 491 491 527 +Copy data from source address to destination address 528 + 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)** == 544 +== **2.18 addr_fill(string addr, number num, number length)** == 508 508 ))) 509 509 510 -**Function:** Write the same value to consecutive addresses547 +**Function:** 511 511 549 +Write the same value to consecutive addresses 550 + 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)** == 566 +== **2.19 addr_newnoaddr(string addr, number offset)** == 528 528 ))) 529 529 530 -**Function:** Offset address value relative to //addr//569 +**Function:** 531 531 571 +Offset address value relative to //addr// 572 + 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)** == 586 +== **2.20 addr_newstataddr(string addr, number offset)** == 546 546 ))) 547 547 548 -**Function:** Offset station number relative to //addr //station number589 +**Function:** 549 549 591 +Offset station number relative to //addr //station number 592 + 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])** == 605 +== **2.21 addr_gethex64(string addr[, number type, number hlword])** == 563 563 564 -**Function:** Read 64-bit hexadecimal numbers607 +**Function:** 565 565 609 +Read 64-bit hexadecimal numbers 610 + 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])** == 625 +== **2.22 addr_sethex64(string addr, number num[, number type, number hlword])** == 581 581 582 -**Function:** Write 64-bit hexadecimal addresses627 +**Function:** 583 583 629 +Write 64-bit hexadecimal addresses 630 + 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** 651 +**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 .655 +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 = { ... ... @@ -627,11 +627,13 @@ 627 627 1. When the data bit is 8, the maximum value of data transmission is 255 (0xFF), which supports the transmission of any character. 628 628 629 629 ((( 630 -== **serial.open(table setup)** == 677 +== **3.1 serial.open(table setup)** == 631 631 ))) 632 632 633 -**Function:** Enable one serial port680 +**Function:** 634 634 682 +Enable one serial port 683 + 635 635 **Parameters:** 636 636 637 637 //Setup// is a Lua table; it needs to contain the following fields ... ... @@ -665,13 +665,17 @@ 665 665 Failed: multi 666 666 667 667 ((( 668 -== **serial.close(serial obj)** == 717 +== **3.2 serial.close(serial obj)** == 669 669 ))) 670 670 671 -**Function:** Disable the serial port720 +**Function:** 672 672 673 - **Parameters: **//Obj //isthe objectreturnedbyserial.open722 +Disable the serial port 674 674 724 +**Parameters:** 725 + 726 +//Obj //is the object returned by serial.open 727 + 675 675 **Return:** 676 676 677 677 Succeed: true ... ... @@ -679,11 +679,13 @@ 679 679 Failed: multi 680 680 681 681 ((( 682 -== **serial:read(number bytes[, number timeout])** == 735 +== **3.3 serial:read(number bytes[, number timeout])** == 683 683 ))) 684 684 685 -**Function:** Read the specified byte length serial port data738 +**Function:** 686 686 740 +Read the specified byte length serial port data 741 + 687 687 **Parameters:** 688 688 689 689 //bytes//: number of bytes ... ... @@ -697,13 +697,15 @@ 697 697 Failed: multi 698 698 699 699 ((( 700 -== **serial:write(string data)** == 755 +== **3.4 serial:write(string data)** == 701 701 ))) 702 702 703 -**Function:** Write the specified byte length to serial port data758 +**Function:** 704 704 705 - **Parameters:**760 +Write the specified byte length to serial port data 706 706 762 +**Parameters:** 763 + 707 707 //data//: serial port data 708 708 709 709 **Return:** ... ... @@ -713,11 +713,13 @@ 713 713 Failed: multi 714 714 715 715 ((( 716 -== **serial:flush([number flag])** == 773 +== **3.5 serial:flush([number flag])** == 717 717 ))) 718 718 719 -**Function:** Clear the serial port buffer776 +**Function:** 720 720 778 +Clear the serial port buffer 779 + 721 721 **Parameters:** 722 722 723 723 //[flag=2]// clear option: 0: read, 1: write, 2: read-write ... ... @@ -729,13 +729,17 @@ 729 729 Failed: multi 730 730 731 731 ((( 732 -== **serial:close()** == 791 +== **3.6 serial:close()** == 733 733 ))) 734 734 735 -**Function:** Close the serial port object794 +**Function:** 736 736 737 - **Parameters:** None796 +Close the serial port object 738 738 798 +**Parameters:** 799 + 800 +None 801 + 739 739 **Return:** 740 740 741 741 Succeed: true