Wiki source code of 1 Communication

Version 169.2 by Bob on 2022/11/16 10:50

Show last authors
1 = Create communication with WECON PLC =
2
3 == **LX3V Serial Protocol** ==
4
5 Supported series: Wecon LX2V/ LX2E/ LX3V/LX3VP/LX3VE/LX3VM
6
7 **1)V-BOX setting**
8
9 |**Item**|**Settings**|**Note**
10 |Protocol|WECON LX2V/ LX2E/ LX3V/LX3VP/LX3VE/LX3VM|
11 |Connection|RS422/RS485|
12 |Baud rate|9600|
13 |Data bit|7|
14 |Parity|EVEN|
15 |Stop bit|1|
16 |PLC station No.|1|
17
18 **2)Address List**
19
20
21 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
22 |(% rowspan="6" %)Bit|X|X|Xo|0~~303237|
23 |Y|Y|Y o|0~~303237|
24 |M|M|M d|0~~99999|
25 |T|T|T d|0~~99999|
26 |C|C|C d|0~~99999|
27 |S|S|S d|0~~99999|
28 |(% rowspan="8" %)Word|X|X|Xo|0~~303237|
29 |Y|Y|Y o|0~~303237|
30 |M|M|M d|0~~99999|
31 |T|T|T d|0~~99999|
32 |C|C|C d|0~~199|
33 |D|D|D d|0~~7999|
34 |S|S|S d|0~~99999|
35 |SD|SD|SD d|8000~~9999|
36
37 **3)Configure the communication protocol**
38
39 [[image:image-20220824152217-1.png||alt="图片-20220824152217-1.png"]]
40
41 **4)Cable Wiring**
42
43 * **RS422**
44
45 [[image:image-20220824120614-5.png]]
46
47 * **RS485**
48
49 [[image:image-20220824120524-3.png]]
50
51 == **LX5V Serial Protocol** ==
52
53 This example introduces the establishment of serial port communication between V-BOX and LX5V. It is introduced through three parts: PLC software configuration, V-BOX software configuration, and hardware wiring.
54
55 **Software configuration of PLC**
56
57 **1)PLC programming software**
58
59 [[image:image-20220824142722-1.png]]
60
61 **2)New PLC project**
62
63 Click New Project and select the PLC model.
64
65 [[image:image-20220822172623-2.png]]
66
67 **3)Set Serial port parameters**
68
69 Follow the steps below to configure Serial port parameters
70
71 Baud rate:115200
72
73 Data bit:8
74
75 Stop bit:1
76
77 Parity:No verification
78
79 [[image:image-20220822172657-3.png]]
80
81 **4)Registers list**
82
83 [[image:image-20220822172730-4.png]]
84
85 **V-BOX software configuration**
86
87 **1)V-BOX programming software**
88
89 [[image:image-20220824104124-1.png]]
90
91 **2)V-NET add device**
92
93 Open V-NET client software → add device. As shown in the figure below, click "+" in the order of steps, and the Add Device window will pop up, enter the access key, password and remark, to add the device.
94
95 [[image:image-20220824104909-2.png]]
96
97 **3)Set communication port parameters**
98
99 Click the communication configuration button on the left to find the communication protocol with LX5V. After selecting the protocol, configure the communication parameters of the COM port.
100
101 Baud rate:115200
102
103 Data bit:8
104
105 Stop bit:1
106
107 Parity:No verification
108
109 [[image:image-20220824142130-1.png]]
110
111 **hardware connection**
112
113 **1)Hardware wiring diagram**
114
115 [[image:image-20220824142546-2.png]]
116
117 [[image:image-20220824142643-3.png]]
118
119 The above are all the steps for establishing serial port communication between V-BOX with LX5V PLC.
120
121 == **LX5V-N Ethernet protocol** ==
122
123 This example introduces the establishment of Ethernet communication between V-BOX and LX5V-N. It is introduced through three parts: PLC software configuration, V-BOX software configuration, and hardware wiring.
124
125 **Software configuration of PLC**
126
127 **1)PLC programming software**
128
129 [[image:image-20220824142722-1.png]]
130
131 **2)New PLC project**
132
133 Click New Project and select the PLC model.
134
135 [[image:image-20220824143613-1.png]]
136
137 **3)Set Ethernet port parameters**
138
139 Follow the steps below to configure Ethernet parameters
140
141 PLC IP address:192.168.39.200
142
143 default gateway:192.168.39.1
144
145 subnet mask:255.255.255.0
146
147 [[image:image-20220824143744-2.png]]
148
149 **4)Registers list**
150
151 [[image:image-20220822172730-4.png]]
152
153 (% id="cke_bm_22473S" style="display:none" %)** **(%%)**V-BOX software configuration**
154
155 **1)V-BOX programming software**
156
157 [[image:image-20220824104124-1.png]]
158
159 **2)V-NET add device**
160
161 Open V-NET client software → add device. As shown in the figure below, click "+" in the order of steps, and the Add Device window will pop up, enter the access key, password and remark, to add the device.
162
163 [[image:image-20220824104909-2.png]]
164
165 **3)Set communication Protocol**
166
167 Click Communication to configure the LX5V plc protocol and IP address.
168
169 [[image:image-20220824144619-1.png]]
170
171 **hardware connection**
172
173 **1)Hardware wiring diagram**
174
175 [[image:image-20220824151127-2.png]]
176
177 The above are all the steps for establishing ethernet communication between V-BOX with LX5V PLC.
178
179 = Create communication with **Rockwell PLC** =
180
181 == (% id="cke_bm_5621S" style="display:none" %)** **(%%)**MicroLogix Protocol** ==
182
183 MicroLogix 1000/1100/1200/1400/1500; SLC 5/03 5/04 5/05 PLC-5
184
185 **1)V-BOX setting**
186
187 |**Item**|**Settings**|**Note**
188 |Protocol|Allen-Bradlley DF1 Advanced|
189 |Connection|RS232|
190 |Baud rate|19200|
191 |Data bit|8|
192 |Parity|None|
193 |Stop bit|1|
194 |PLC station No.|1|
195
196 **2)Address List**
197
198 |**Type**|**Device registers**|**Format**|**Range**|**Note**
199 |(% rowspan="5" %)Bit|I|I d.d|0.0~~255.15|
200 |O|O d.d|0.0~~255.15|
201 |B|B nnhh.dd|0.0~~ffff.15|nn: block number (hex)
202 |S|S d.d|0.0~~255.15|
203 |N|N nnhh.dd|0.0~~ffff.15|nn: block number (hex)
204 |(% rowspan="9" %)Word|S|S d|0~~255|
205 |TS|TS nnhh|0~~ffff|(% rowspan="8" %)nn: block number (hex)
206 |TP|TP nnhh|0~~ffff
207 |CS|CS nnhh|0~~ffff
208 |CP|CP nnhh|0~~ffff
209 |N|N nnhh|0~~ffff
210 |C|C nnhh|0~~ffff
211 |T|T nnhh|0~~ffff
212 |R|R nnhh|0~~ffff
213
214 **3)Configure the communication protocol**[[image:image-20220824152928-1.png]]
215
216 **4)Configure the communication protocol**
217
218 [[image:image-20220824110724-1.png]]
219
220 == **Micro850_FreeTag Protocol** ==
221
222 (((
223 (((
224 This example introduces the establishment of Ethernet communication between Wecon V-box and CompactLogix L1769. It is introduced through three parts: PLC software configuration, V-box software configuration, and hardware wiring.
225 )))
226 )))
227
228 (((
229 (% class="wikigeneratedid" id="HSoftwareconfigurationofPLC" %)
230 (((
231 **Software configuration of PLC**
232 )))
233
234 (% class="wikigeneratedid" id="HPLCprogrammingsoftware" %)
235 (((
236 **1)PLC programming software**
237 )))
238
239 [[image:image-20220714162600-1.png]]
240
241 (% class="wikigeneratedid" id="HNewPLCproject" %)
242 (((
243 **2)New PLC project**
244 )))
245
246 (((
247 (((
248 Click New Project and select the PLC model.
249 )))
250 )))
251
252 (((
253 [[image:image-20220714162617-2.png]]
254 )))
255
256 (((
257
258
259 [[image:image-20220714162652-4.png]]
260 )))
261
262 (((
263 (% class="wikigeneratedid" id="HSetEthernetparameters" %)
264 (((
265 **3)Set Ethernet parameters**
266 )))
267
268 (((
269 (((
270 (((
271 Follow the steps below to configure Ethernet parameters
272 )))
273 )))
274 )))
275
276 (((
277 (((
278 (((
279 PLC IP address:192.168.40.101
280 )))
281 )))
282 )))
283
284 (((
285 (((
286 (((
287 default gateway:192.168.40.1
288 )))
289 )))
290 )))
291
292 (((
293 (((
294 (((
295 subnet mask:255.255.255.0
296 )))
297 )))
298 )))
299
300 (((
301 [[image:image-20220714162713-5.png]]
302 )))
303
304 (((
305
306 )))
307
308 (((
309 (% class="wikigeneratedid" id="HV-boxsoftwareconfiguration" %)
310 (((
311 **V-box software configuration**
312 )))
313
314 (% class="wikigeneratedid" id="HV-boxprogrammingsoftware" %)
315 (((
316 **1)V-box programming software**
317 )))
318
319 (% class="wikigeneratedid" %)
320 (((
321 [[image:image-20220714162725-6.png]]
322 )))
323
324 (% class="wikigeneratedid" id="HConfiguredevicenetwork" %)
325 (((
326 **2)Configure device network**
327 )))
328
329 (((
330 (((
331 (((
332 Click the Configuration Download button[[image:image-20220714115308-8.png||height="22" width="15"]], It is used to configure the device network, update the device time, obtain the device machine code, check the device network, etc.
333 )))
334
335 (((
336 In the example below, the IP address of V-Box is configured as 192.168.40.66, and the networking method is 4G connection
337 )))
338 )))
339 )))
340
341 (((
342 (((
343 [[image:image-20220714162737-7.png]]
344
345
346 )))
347 )))
348 )))
349 )))
350
351 (% class="wikigeneratedid" id="HV-netadddevice" %)
352 (((
353 **3)V-net add device**
354 )))
355 )))
356
357 (((
358 (((
359 Open VNET client software → add device. As shown in the figure below, click "+" in the order of steps, and the Add Device window will pop up, enter the device machine code/product code, device password, and device alias to add the device.   [[image:image-20220714162752-8.png]]
360 )))
361
362
363 )))
364
365 (((
366 (% class="wikigeneratedid" id="HSetcommunicationportparameters" %)
367 (((
368 **4)Set communication port parameters**
369 )))
370
371 (((
372 In the device list on the left, find the Vbox that communicates with the L1769, click it and select configuration,communication port configuration in the main interface to add a communication protocol.
373 )))
374
375 [[image:image-20220714162805-9.png]]
376 )))
377
378 (((
379 The communication port is selected as Ethernet, the device type is selected as Allen-Bradley, the protocol is Allen-BradleyMicro850_FreeTag EthemetIP, and the IP is the internal IP address of the L1769 PLC. The port number is 44818.
380 )))
381
382 [[image:image-20220824164346-1.png]]
383
384
385 (((
386 After adding the protocol Allen-BradleyMicro850_FreeTag, click[[image:image-20220714143838-2.png]]icon add label.[[image:image-20220714162827-11.png]]
387 )))
388
389 (% class="wikigeneratedid" id="HEngineeringproduction" %)
390 (((
391 **5)Engineering production**
392 )))
393
394 (% class="wikigeneratedid" %)
395 (((
396 (((
397 According to your own needs, use the V-NET client software to edit the required data monitoring points.
398 )))
399
400 [[image:image-20220714162841-12.png]]
401
402
403 (((
404 **hardware connection**
405 )))
406 )))
407
408 (((
409 **1)Hardware wiring diagram**
410 )))
411
412 (((
413 (((
414 This example introduces Wecon V-box with Allen-Bradley L1769 PLC to establish communication through Ethernet. The connection diagram is as follows:
415 )))
416
417 [[image:image-20220714162856-13.png]]
418
419 (((
420 The above are all the steps for establishing Ethernet communication between Wecon V-box with CompactLogix L1769 PLC.
421
422
423 == **Allen-Bradley Ethernet DF1** ==
424
425 [[download link>>https://ftp.we-con.com.cn/Download/WIKI/V-BOX/Demo/%E9%80%9A%E8%AE%AF%E6%A1%88%E4%BE%8B/Allen-Bradley%20Ethernet%20DF1.zip]]
426
427
428 = Create communication with **Siemens PLC** =
429
430 == **S7-200 Smart Ethernet Protocol** ==
431
432 [[download link>>https://ftp.we-con.com.cn/Download/WIKI/V-BOX/Demo/%E9%80%9A%E8%AE%AF%E6%A1%88%E4%BE%8B/Communication%20with%20S7-200%20Smart.zip]]
433
434
435 == **S7-300 Ethernet Protocol** ==
436
437 Supported Series: Siemens S7-300 series PLC
438
439 **1)V-BOX setting**
440
441 |**Items**|**Settings**|**Note**
442 |Protocol|Simens S7-300 Ethernet|
443 |Connection|Ethernet|
444 |Port No.|102|
445 |PLC station No.|2|Need to be same as the PLC setting
446
447 **2)Address List**
448
449 |**Type**|**Device register**|**HMI register**|**Format**|**Range**|**Note**
450 |(% rowspan="4" %)Bit|I|I|I ddddd.o|0.0~~99999.7|
451 |Q|Q|Q ddddd.o|0.0~~99999.7|
452 |M|M|M ddddd.o|0.0~~99999.7|
453 |DB0.DB~~DB99.DB|DBxDBD|DBxDB nndddd.o|0.0~~99999999.7|(((
454 nn: block number;
455
456 dddd: address;
457 )))
458 |(% rowspan="8" %)Word|I|IW|IW ddddd|0~~99999|
459 |Q|QW|QW ddddd|0~~99999|
460 |(% rowspan="3" %)M|MB|MB ddddd|0~~99999|
461 |MW|MW ddddd|0~~99999|(((
462 MW0=MB(0~~1)
463
464 MW2=MB(2~~3)
465
466 Address value is a multiple of 2
467 )))
468 |MD|MD ddddd|0~~99999|(((
469 MD0=MB(0~~3)
470
471 MD4=MB(4~~7)
472
473 Address value is a multiple of 4
474 )))
475 |(% rowspan="3" %)DB0.DB~~DB99.DB|DBxDBB|DBxDBB nndddd|0~~99999999|(% rowspan="3" %)(((
476 nn: block number;
477
478 dddd: address
479 )))
480 |DBxDBW|DBxDBW nndddd|0~~99999999
481 |DBxDBD|DBxDBD nndddd|0~~99999999
482
483 **3)Configure the communication protocol**
484
485 [[image:image-20220824161345-1.png]]
486
487 **4)Cable Wiring**
488
489 [[image:image-20220824161450-2.png]]
490 )))
491 )))
492
493 == **S7-1200 Ethernet Protocol** ==
494
495 [[download link>>https://ftp.we-con.com.cn/Download/WIKI/V-BOX/Demo/%E9%80%9A%E8%AE%AF%E6%A1%88%E4%BE%8B/Communicate%20with%20S7-1200%20via%20Ehernet.zip]]
496
497 == **S7-XXX Ethernet Protocol** ==
498
499 Supported Series: Siemens S7-400, S7-1200 and S7-1500
500
501 **1)V-BOX setting**
502
503 |=**Items**|=**Settings**|=**Note**
504 |Protocol|Siemens S7-XXX|
505 |Connection|Ethernet|
506 |Port No.|102|
507 |Device No.|Slot (Default 1 for S7-1500/ 2 for S7-1200/ 3 for S7-400)|
508 |HMI No.|Rack (Default as 0)|
509
510 Slot from TIA Portal is equal to Device No. of V-net
511
512 Rack from TIA Portal is equal to HMI No. of V-net
513
514 [[image:image-20220824162459-3.png]]
515
516 [[image:image-20220824163305-2.png]]
517
518 **2)Address List**
519
520 |**Type**|**Device register**|**HMI register**|**Format**|**Range**|**Note**
521 |(% rowspan="4" %)Bit|I|I|M d.o|(((
522 d:0~-~-9999
523
524 o:0-7
525 )))|
526 |Q|Q|Q d.o|(((
527 d:0~-~-9999
528
529 o:0-7
530 )))|
531 |M|M|M d.o|(((
532 d:0~-~-9999
533
534 o:0-7
535 )))|
536 |DB0.DB-DB99.DB|DBxDB|DBxDBnndddd.o|(((
537 nn:0-9999,
538
539 dddd:0-9999,
540
541 o:0-7
542 )))|(((
543 nn:DB No.
544
545 dddd:address value
546
547 o: digit address
548 )))
549 |(% rowspan="8" %)Word|M|MB|MB d|d:0-99999|
550 |M|MW|MW d|d:0-99999|(((
551 MW0=MB(0~~1)
552
553 MW2=MB(2~~3)
554
555 Address value is a multiple of 2
556 )))
557 |M|MD|MD d|d:0-99999|(((
558 MD0=MB(0~~3)
559
560 MD4=MB(4~~7)
561
562 Address value is a multiple of 4
563 )))
564 |I|IW|IW d|d:0-99999|
565 |Q|QW|QW d|d:0-99999|
566 |DB0.DB-DB99.DB|DBxDBB|DBxDBBnndddd|(((
567 nn:0-9999
568
569 dddd:0-9999
570 )))|(((
571 nn:DB No.
572
573 dddd:address value
574 )))
575 |DB0.DB-DB99.DB|DBxDBW|DBxDBWnndddd|(((
576 nn:0-9999
577
578 dddd:0-9999
579 )))|(((
580 nn:DB No.
581
582 dddd:address value
583
584 Address value is a multiple of 2
585 )))
586 |DB0.DB-DB99.DB|DBxDBD|DBxDBDnndddd|(((
587 nn:0-9999
588
589 dddd:0-9999
590 )))|(((
591 nn:DB No.
592
593 dddd:address value
594
595 Address value is a multiple of 4
596 )))
597
598 **3)Configure the communication protocol**
599
600 [[image:image-20220824163448-3.png]]
601
602 **✎Note:**
603
604 * The S7-1200 supports simultaneous connection of three devices, so the driver supports simultaneous access to PLC by three V-BOX.
605 * V-BOX access PLC, use S7 protocol, access PLC TSAP 02.01 (s7-1200 PROFINET interface only supports three connections, the default support), detailed reference to the system manual of S7-1200.
606
607 **4)Cable Wiring**
608
609 [[image:image-20220824162342-2.png]]
610
611 = Create communication with **Mitsubishi PLC** =
612
613 == **FX1S,1N,2N Serial Protocol** ==
614
615 Supported Series: Mitsubishi FX1S, FX1N, FX2N series
616
617 **1)V-BOX Settings**
618
619 |**Item**|**Settings**|**Note**
620 |Protocol|Mitsubishi FX1S/FX1N/FX2N|
621 |Connection|RS422/RS485/RS232|
622 |Baud rate|9600~~115200|
623 |Data bit|7/8|
624 |Parity|EVEN/Odd/None|
625 |Stop bit|1/2|
626 |PLC station No.|1~~255|
627
628 **2)Address List**
629
630 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
631 |(% rowspan="7" %)Bit|X|X|Xo|0~~303237|
632 |Y|Y|Y o|0~~303237|
633 |M|M|M d|0~~99999|
634 |T|T|T d|0~~99999|
635 |C|C|C d|0~~99999|
636 |S|S|S d|0~~99999|
637 |SM|SM|SM d|8000~~9999|
638 |(% rowspan="8" %)Word|X|X|Xo|0~~303237|
639 |Y|Y|Y o|0~~303237|
640 |M|M|M d|0~~99999|
641 |T|T|T d|0~~99999|
642 |C|C|C d|0~~199|
643 |D|D|D d|0~~7999|
644 |S|S|S d|0~~99999|
645 |SD|SD|SD d|8000~~9999|
646
647 **3)Configure the communication protocol**
648
649 [[image:image-20220825102844-3.png]]
650
651 **4)Cable Wiring**
652
653 * **RS422**
654
655 [[image:image-20220825103350-4.png]]
656
657 [[image:image-20220825100845-4.png]]
658
659
660 == **FX3U,3G,3GA Serial Protocol** ==
661
662 Supported Series: Mitsubishi FX3U, FX3G, FX3GA series
663
664 **1)V-BOX Settings**
665
666 |**Item**|**Settings**|**Note**
667 |Protocol|Mitsubishi FX3U/3G/3GA|
668 |Connection|RS422/RS485/RS232|
669 |Baud rate|9600~~115200|
670 |Data bit|7/8|
671 |Parity|EVEN/Odd/None|
672 |Stop bit|1/2|
673 |PLC station No.|1~~255|
674
675 **2)Address List**
676
677 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
678 |(% rowspan="7" %)Bit|X|X|Xo|0~~303237|
679 |Y|Y|Y o|0~~303237|
680 |M|M|M d|0~~99999|
681 |T|T|T d|0~~99999|
682 |C|C|C d|0~~99999|
683 |S|S|S d|0~~99999|
684 |SM|SM|SM d|8000~~9999|
685 |(% rowspan="8" %)Word|X|X|Xo|0~~303237|
686 |Y|Y|Y o|0~~303237|
687 |M|M|M d|0~~99999|
688 |T|T|T d|0~~99999|
689 |C|C|C d|0~~199|
690 |D|D|D d|0~~7999|
691 |S|S|S d|0~~99999|
692 |SD|SD|SD d|8000~~9999|
693
694 **3)Configure the communication protocol**
695
696 [[image:image-20220825102649-2.png]]
697
698 **4)Cable Wiring**
699
700 * **RS422**
701
702 [[image:image-20220825103421-5.png]]
703
704 [[image:image-20220825100845-4.png]]
705
706
707 == **FX3U Ethernet Protocol** ==
708
709 Mitsubishi FX3U series PLC
710
711 **HMI Settings**
712
713 |Items|Settings|Note
714 |Protocol|Mitsubishi FX3U|
715 |Connection|Ethernet|
716 |Port No.|5009|Must be the same as the PLC setting
717 |PLC station No.|0|
718
719 **Address List**
720
721 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
722 |(% colspan="1" rowspan="7" %)Bit|X|X|X OOO|0~~377|
723 |Y|Y|Y OOO|0~~377|
724 |M|M|M DDDD|0~~7679|
725 |SM|SM|SM DDDD|8000~~8511|
726 |S|S|S DDDD|0~~4095|
727 |TS|TS|TS DDD|0~~511|
728 |CS|CS|CS DDD|0~~255|
729 |(% colspan="1" rowspan="9" %)Word|CN|CN|CN DDD|0~~199|
730 |TN|TN|TN DDD|0~~511|
731 |D|D|D DDDD|0~~7999|
732 |SD|SD|SD DDDD|8000~~8511|
733 |R|R|R DDDDD|0~~32767|
734
735 **Ethernet Module Settings**
736
737 FX3U-ENET-L module configuration
738 Set up the FX3U-ENET-L Ethernet module settings as follows.
739 Select the module location, which in this document is Module 0.
740
741 [[image:image-20221116094003-1.png]]
742
743
744 Select "Operational setting" to enter the following screen.
745
746 The Ethernet module IP is set to 192.168.39.254 in this document, and other options are default.
747
748 [[image:image-20221116094019-2.png]]
749
750
751 Select "Open setting" to enter the setting interface, the settings are as follows.
752
753 The third item "Protocol" selects TCP, and "Open system" selects MELSOFT connection, which allows the
754
755 Mitsubishi programming software GX works2 to communicate with the FX3U via the Ethernet module.
756
757 [[image:image-20221116094038-3.png]]
758
759
760 Click on "transter setup" - "PC side I/F setting", see the following figure.
761
762 After setting, the first download must use the programming cable, as shown in the figure; after that, can
763
764 use the IP set in the "Ethernet board" to communicate directly with the network cable.
765
766 [[image:image-20221116094122-4.png||height="422" width="707"]]
767
768
769 Read and write data from the Ethernet module
770
771 [[image:image-20221116094131-5.png||height="551" width="708"]]
772
773
774 Set "Transter setup" to COM communication, and read or write operation as shown below
775
776 [[image:image-20221116094150-6.png]]
777
778
779 **PLC Settings (GX Works 2)**
780
781 Create a blank FX5U project
782
783 Find Current Connection in the navigation
784
785 [[image:image-20221116094206-7.png||height="425" width="711"]]
786
787
788 Select Connection Channel List
789
790 Select Ethernet board communication
791
792 [[image:image-20221116094709-9.png||height="427" width="715"]]
793
794
795 Select Ethernet Module
796 Set the IP address of the PLC
797
798 [[image:image-20221116094736-11.png||height="682" width="716"]]
799
800
801 Read or write PLC data, in this document is read
802
803 [[image:image-20221116094755-12.png||height="426" width="715"]]
804
805 [[image:image-20221116094803-13.png||height="427" width="715"]]
806
807
808
809
810 == **FX5U Serial Protocol** ==
811
812 Mitsubishi FX5U series PLC
813
814 **1)V-BOX Settings**
815
816 |**Item**|**Settings**|**Note**
817 |Protocol|Mitsubishi FX5U|
818 |Connection|RS422/RS485|
819 |Baud rate|9600|
820 |Data bit|7|
821 |Parity|Odd|
822 |Stop bit|1|
823 |PLC station No.|1~~255|Need to be the same as PLC settings
824
825 **2)Address List**
826
827 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
828 |(% rowspan="15" %)Bit|X|X|X o|0~~303237|
829 |Y|Y|Y o|0~~303237|
830 |M|M|M d|0~~99999|
831 |B|B|B h|0~~7FFF|
832 |F|F|F d|0~~32767|
833 |SB|SB|SB h|0~~7FFF|
834 |TS|TS|TS d|0~~1023|
835 |TC|TC|TC d|0~~1023|
836 |STS|STS|STS d|0~~1023|
837 |STC|STC|STS d|0~~1023|
838 |CS|CS|CS d|0~~1023|
839 |CC|CC|CC d|0~~1023|
840 |SM|SM|SM d|0~~9999|
841 |L|L|L d|0~~32767|
842 |S|S|S d|0~~4095|
843 |(% rowspan="9" %)Word|W|W|W h|0~~3FF|
844 |TN|TN|TN d|0~~1023|
845 |STN|STN|STN d|0~~1023|
846 |CN|CN|CN d|0~~1023|
847 |R|R|R d|0~~32767|
848 |SW|SW|SW h|0~~7FFF|
849 |Z|Z|Z d|0~~23|
850 |D|D|D d|0~~7999|
851 |SD|SD|SD d|0~~11999|
852
853 **3)PLC Settings (GX Works 3)**
854
855 Create a blank FX5U project
856
857 Find the 485 serial port module in the system navigation bar and double click to enter the settings.
858
859 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_5c9cb13fac1e6c93.png?width=200&height=462&rev=1.1||alt="12.PLC Protocol_html_5c9cb13fac1e6c93.png" height="462" width="200"]]
860
861 Select protocol in the setting item, and set parameters.
862
863 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_de942589ca070228.png?width=600&height=324&rev=1.1||alt="12.PLC Protocol_html_de942589ca070228.png" height="324" width="600"]]
864
865 Set station number, and [Message Pattern] (Pattern 1 or Pattern 4)
866
867 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_387ec7d00b5feb59.png?width=600&height=323&rev=1.1||alt="12.PLC Protocol_html_387ec7d00b5feb59.png" height="323" width="600"]]
868
869 Click the [Apply] button to finish the setting.
870
871 Click download and select the items as below, then click [execute] to download the configuration to PLC.
872
873 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_cdef1c5ec8cc2105.png?width=600&height=434&rev=1.1||alt="12.PLC Protocol_html_cdef1c5ec8cc2105.png" height="434" width="600"]]
874
875 As soon as download is completed, connect PLC with serial port, then configure it in the [Specify Connection Destination Connection].
876
877 Done.
878
879 **4)Configure the communication protocol**
880
881 [[image:image-20220825104904-1.png]]
882
883 **5)Cable Wiring**
884
885
886 * **RS422**
887
888 [[image:image-20220825105105-2.png]]
889
890 [[image:image-20220825105533-3.png]]
891
892 == **FX5U Ethernet Protocol** ==
893
894 Mitsubishi FX5U series PLC
895
896 **1)V-BOX Settings**
897
898 |**Items**|**Settings**|**Note**
899 |Protocol|Mitsubishi FX5U|
900 |Connection|Ethernet|
901 |Port No.|5002|Must be the same as the PLC setting
902 |PLC station No.|0|
903
904 **2)Address List**
905
906 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
907 |(% rowspan="15" %)Bit|X|X|X o|0~~303237|
908 |Y|Y|Y o|0~~303237|
909 |M|M|M d|0~~99999|
910 |B|B|B h|0~~7FFF|
911 |F|F|F d|0~~32767|
912 |SB|SB|SB h|0~~7FFF|
913 |TS|TS|TS d|0~~1023|
914 |TC|TC|TC d|0~~1023|
915 |STS|STS|STS d|0~~1023|
916 |STC|STC|STS d|0~~1023|
917 |CS|CS|CS d|0~~1023|
918 |CC|CC|CC d|0~~1023|
919 |SM|SM|SM d|0~~9999|
920 |L|L|L d|0~~32767|
921 |S|S|S d|0~~4095|
922 |(% rowspan="9" %)Word|W|W|W h|0~~3FF|
923 |TN|TN|TN d|0~~1023|
924 |STN|STN|STN d|0~~1023|
925 |CN|CN|CN d|0~~1023|
926 |R|R|R d|0~~32767|
927 |SW|SW|SW h|0~~7FFF|
928 |Z|Z|Z d|0~~23|
929 |D|D|D d|0~~7999|
930 |SD|SD|SD d|0~~11999|
931
932 **3)PLC Settings (GX Works 3)**
933
934 Find the [Ethernet port] in the navigation area.
935
936 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_8e8f85ace087346c.png?width=300&height=593&rev=1.1||alt="12.PLC Protocol_html_8e8f85ace087346c.png" height="593" width="300"]]
937
938 Select [Own Node Settings] in the [Setting Item List];
939
940 Set [IP Address], [Subnet Mask], [Default Gateway];
941
942 Click [Detailed Settings] into [Ethernet Configuration (Built-in Ethernet Port)] windows;
943
944 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_5d98495052c8c10e.png?width=600&height=339&rev=1.1||alt="12.PLC Protocol_html_5d98495052c8c10e.png" height="339" width="600"]]
945
946 Select [SLMP Connection Module] and add into host station as below picture shows;
947
948 Set Port number as 5002 (this is necessary settings);
949
950 Click [Close with Reflecting the Setting] to save and close window;
951
952 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_14b489fdc6c6589d.png?width=600&height=350&rev=1.1||alt="12.PLC Protocol_html_14b489fdc6c6589d.png" height="350" width="600"]]
953
954 Click [Apply] to completed Etherenet settings;
955
956 Switch to the [On line data operation] interface as below, check the item and click [Execute] to download.
957
958 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_c93025a968a8a9e7.png?width=600&height=434&rev=1.1||alt="12.PLC Protocol_html_c93025a968a8a9e7.png" height="434" width="600"]]
959
960 **4)Configure the communication protocol**
961
962 [[image:image-20220825112403-1.png||alt="图片-20220825112403-1.png"]]
963
964 **5)电缆布线**
965
966 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_2297240b57346b2a.png?width=401&height=170&rev=1.1||alt="12.可编程逻辑控制器Protocol_html_2297240b57346b2a.png" height="170" width="401"]]
967
968
969 == **L02 Serial Protocol** ==
970
971 Mitsubishi L02 series CPU built-in serial port.
972
973 **1)V-BOX Settings**
974
975 |**Item**|**Settings**|**Note**
976 |Protocol|Mitsubishi L02|
977 |Connection|RS422|
978 |Baud rate|115200|
979 |Data bit|8|
980 |Parity|Odd|
981 |Stop bit|1|
982 |PLC station No.|1~~255|Need to be the same as PLC settings
983
984 **2)Address List**
985
986 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
987 |Bit|X|X|X h|0~~FFFF|
988 |Bit|Y|Y|Y h|0~~FFFF|
989 |Bit|M|M|M d|0~~9999|
990 |Bit|L|L|L d|0~~9999|
991 |Bit|F|F|F d|0~~9999|
992 |Bit|B|B|B h|0~~FFFF|
993 |Bit|V|V|V d|0~~2047|
994 |Bit|TC|TC|TC d|0~~9999|
995 |Bit|SS|SS|SS d|0~~9999|
996 |Bit|SC|SC|SC d|0~~9999|
997 |Bit|CS|CS|CS d|0~~9999|
998 |Bit|CC|CC|CC d|0~~9999|
999 |Bit|SB|SB|SB h|0~~FFFF|
1000 |Bit|SM|SM|SM d|0~~2047|
1001 |Bit|STS|STS|STS d|0~~1023|
1002 |Bit|S|S|S d|0~~9999|
1003 |Bit|DX|DX|DX h|0~~FFFF|
1004 |Bit|DY|DY|DY h|0~~FFFF|
1005 |Bit|TS|TS|TS d|0~~9999|
1006 |Bit|Dbit|Dbit|Dbit d.d|0~~99999.0~~15|
1007 |Word|W|W|W h|0~~FFFF|
1008 |Word|TN|TN|TN d|0~~99999|
1009 |Word|SN|SN|SN d|0~~99999|
1010 |Word|CN|CN|CN d|0~~99999|
1011 |Word|R|R|R d|0~~99999|
1012 |Word|SW|SW|SW h|0~~FFFF|
1013 |Word|Z|Z|Z d|0~~99999|
1014 |Word|ZR|ZR|ZR h|0~~FFFF|
1015 |Word|D|D|D d|0~~99999|
1016
1017 **3)Communication Settings**
1018
1019 [[image:image-20220825160648-3.png]]
1020
1021 **4)Cable Wiring**
1022
1023 * **RS422**
1024
1025 [[image:image-20220825161612-8.png]]
1026
1027 [[image:image-20220825160820-4.png]]
1028
1029 == **L02 Ethernet Protocol** ==
1030
1031 Mitsubishi L series CPU built-in Ethernet port.
1032
1033 **1)V-BOX Settings**
1034
1035 |**Items**|**Settings**|**Note**
1036 |Protocol|MIT L02 CPU MELSEC|
1037 |Connection|Ethernet|
1038 |Port No.|1025|Must be the same as the PLC setting
1039 |PLC station No.|0|Must be the same as the PLC setting
1040
1041 **2)Address List**
1042
1043 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1044 |Bit|X|X|X h|0~~FFFF|
1045 |Bit|Y|Y|Y h|0~~FFFF|
1046 |Bit|M|M|M d|0~~9999|
1047 |Bit|L|L|L d|0~~9999|
1048 |Bit|F|F|F d|0~~9999|
1049 |Bit|B|B|B h|0~~FFFF|
1050 |Bit|V|V|V d|0~~2047|
1051 |Bit|TC|TC|TC d|0~~9999|
1052 |Bit|SS|SS|SS d|0~~9999|
1053 |Bit|SC|SC|SC d|0~~9999|
1054 |Bit|CS|CS|CS d|0~~9999|
1055 |Bit|CC|CC|CC d|0~~9999|
1056 |Bit|SB|SB|SB h|0~~FFFF|
1057 |Bit|SM|SM|SM d|0~~2047|
1058 |Bit|STS|STS|STS d|0~~1023|
1059 |Bit|S|S|S d|0~~9999|
1060 |Bit|DX|DX|DX h|0~~FFFF|
1061 |Bit|DY|DY|DY h|0~~FFFF|
1062 |Bit|TS|TS|TS d|0~~9999|
1063 |Bit|Dbit|Dbit|Dbit d.d|0~~99999.0~~15|
1064 |Word|W|W|W h|0~~FFFF|
1065 |Word|TN|TN|TN d|0~~99999|
1066 |Word|SN|SN|SN d|0~~99999|
1067 |Word|CN|CN|CN d|0~~99999|
1068 |Word|R|R|R d|0~~99999|
1069 |Word|SW|SW|SW h|0~~FFFF|
1070 |Word|Z|Z|Z d|0~~99999|
1071 |Word|ZR|ZR|ZR h|0~~FFFF|
1072 |Word|D|D|D d|0~~99999|
1073
1074 **3)PLC Settings (GX Works2 )**
1075
1076 Create a project
1077
1078 Set PLC IP, subnet mask and gateway;
1079
1080 Select [Binary Code] as communication data code;
1081
1082 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_776e17505f3fc6c0.png?width=600&height=524&rev=1.1||alt="12.PLC Protocol_html_776e17505f3fc6c0.png" height="524" width="600"]]
1083
1084 Set PLC port number, for example 1025
1085
1086 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_8d0d1a22d388f70b.png?width=600&height=524&rev=1.1||alt="12.PLC Protocol_html_8d0d1a22d388f70b.png" height="524" width="600"]]
1087
1088 Save settings;
1089
1090 Download project into PLC device;
1091
1092 Restart PLC device;
1093
1094 **4)Configure the communication protocol**
1095
1096 [[image:image-20220825142659-1.png]]
1097
1098 **5)Cable Wiring**
1099
1100 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_2297240b57346b2a.png?width=401&height=170&rev=1.1||alt="12.PLC Protocol_html_2297240b57346b2a.png" height="170" width="401"]]
1101
1102 == **QJ71E71 Ethernet Protocol** ==
1103
1104 Mitsubishi QJ71E71 Ethernet communication module;
1105
1106 **1)V-BOX Settings**
1107
1108 |**Items**|**Settings**|**Note**
1109 |Protocol|MIT QJ71E71 MELSEC|
1110 |Connection|Ethernet|
1111 |Port No.|1025|Must be the same as the PLC setting
1112 |PLC station No.|0|Must be the same as the PLC setting
1113
1114 **2)Address List**
1115
1116 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1117 |(% rowspan="18" %)Bit|X|X|X h|0~~1FFF|
1118 |Y|Y|Y h|0~~1FFF|
1119 |M|M|M d|0~~99999|
1120 |L|L|L d|0~~8191|
1121 |F|F|F d|0~~2047|
1122 |B|B|B h|0~~1FFF|
1123 |V|V|V d|0~~2047|
1124 |TS|TS|TS d|0~~2047|
1125 |TC|TC|TC d|0~~2047|
1126 |SS|SS|SS d|0~~2047|
1127 |SC|SC|SC d|0~~2047|
1128 |CS|CS|CS d|0~~1023|
1129 |CC|CC|CC d|0~~1023|
1130 |SB|SB|SB h|0~~7FF|
1131 |S|S|S d|0~~8191|
1132 |DX|DX|DX h|0~~1FFF|
1133 |DY|DY|DY h|0~~1FFF|
1134 |SM|SM|SM d|8000~~9999|
1135 |(% rowspan="10" %)Word|SD|SD|SD d|0~~2047|
1136 |D|D|D d|0~~12287|
1137 |W|W|W h|0~~1FFF|
1138 |TN|TN|TN d|0~~2047|
1139 |SN|SN|SN d|0~~2047|
1140 |CN|CN|CN d|0~~1023|
1141 |R|R|R d|0~~32767|
1142 |SW|SW|SW h|0~~7FF|
1143 |Z|Z|Z d|0~~15|
1144 |ZR|ZR|ZR h|0~~FE7FF|
1145
1146 **3)PLC Settings(GX Works2)**
1147
1148 * Click [Ethernet/CC IE/MELSECNET];
1149 * Please select [Ethernet] as network type;
1150 * Set station I/O number according to situation (For example, 0000 means that the module is connected to PLC CPU in first order);
1151 * Select [Online] as Mode;
1152 * Click [Operation setting] to set IP;
1153 * Select [Binary Code] as [Communication Data Code];
1154 * Set protocol: TCP;
1155 * Set [unpassive] in [Open system];
1156 * Set [receive] in [Fixed buffer];
1157 * Set [procedure Exist] in [Fixed buffer communication];
1158 * Disable [Pairing open];
1159 * Set [No confirm] in [Existence confirmation];
1160 * Host station port number: 1025;
1161 * Save settings;
1162 * Download project into PLC and restart it
1163
1164 **4)Configure the communication protocol**
1165
1166 [[image:image-20220825143728-1.png]]
1167
1168 **5)Cable Wiring**
1169
1170 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_2297240b57346b2a.png?width=401&height=170&rev=1.1||alt="12.PLC Protocol_html_2297240b57346b2a.png"]]
1171
1172 = Create communication with **Delta PLC** =
1173
1174 == **DVP Ethernet Protocol** ==
1175
1176 [[下载链接>>https://ftp.we-con.com.cn/Download/WIKI/V-BOX/Demo/%E9%80%9A%E8%AE%AF%E6%A1%88%E4%BE%8B/Delta%20DVP%20Ethernet.zip]]
1177
1178 == **DVP serial protocol** ==
1179
1180 [[下载链接>>https://ftp.we-con.com.cn/Download/WIKI/V-BOX/Demo/%E9%80%9A%E8%AE%AF%E6%A1%88%E4%BE%8B/Delta%20DVP%20Ethernet.zip]]
1181
1182 == **AS Ethernet Protocol** ==
1183
1184 **1)V-BOX Settings**
1185
1186 |=**Items**|=**Settings**|=**Note**
1187 |Protocol|DELTA AS300 MODBUS TCP|
1188 |Connection|Ethernet|
1189 |Port No.|502|
1190 |Device No.|1|
1191 |HMI No.|0|
1192
1193 **2)Address List**
1194
1195 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1196 |Bit|X|X|X d|0~~63|
1197 |Bit|Y|Y|Y d|0~~63|
1198 |Bit|D|D|D d|0~~29999|
1199 |Bit|M|M|M d|0~~8191|
1200 |Bit|SM|SM|SM d|0~~4095|
1201 |Bit|S|S|S h|0~~2047|
1202 |Bit|T|T|T d|0~~511|
1203 |Bit|C|C|C d|0~~511|
1204 |Bit|HC|HC|HC d|0~~255|
1205 |Word|X|X|X h|0~~63|
1206 |Word|Y|Y|Y d|0~~63|
1207 |Word|SR|SR|SR d|0~~2047|
1208 |Word|D|D|D d|0~~29999|
1209 |Word|T|T|T d|0~~511|
1210 |Word|C|C|C h|0~~511|
1211 |Word|E|E|E d|0~~9|
1212
1213 **3)Configure the communication protocol**
1214
1215
1216 [[image:image-20220831160010-4.png]]
1217
1218 **4)Cable Wiring**
1219
1220 Figure
1221
1222 [[image:image-20220831155101-1.png]][[image:image-20220831160055-5.png]]
1223
1224 Pin Definition Diagram
1225
1226 [[image:image-20220831155157-3.png]]
1227
1228 = Create communication with **Omron PLC** =
1229
1230 == **CP1 Series Protocol ** ==
1231
1232 [[下载链接>>https://ftp.we-con.com.cn/Download/WIKI/V-BOX/Demo/%E9%80%9A%E8%AE%AF%E6%A1%88%E4%BE%8B/Communication%20with%20ORMON%20CP1%20Series.zip]]
1233
1234 == **CP2M Series Protocol** ==
1235
1236 [[下载链接>>https://ftp.we-con.com.cn/Download/WIKI/V-BOX/Demo/%E9%80%9A%E8%AE%AF%E6%A1%88%E4%BE%8B/Communication%20with%20ORMON%20CJ2M.zip]]
1237
1238
1239 == **EC55 Series Protocol** ==
1240
1241 Supported device: EC55 temperature instrument
1242
1243 **1)V-BOX Settings**
1244
1245 |**Items**|**Settings**|**Note**
1246 |Protocol|Omron EC55|
1247 |Connection|RS485 (9600, 2, 7, EVEN)|
1248 |Port No.|None|
1249 |PLC station No.|0|
1250
1251 **2)Address List**
1252
1253 |**Type**|**Register**|**Device range**|**HMI range**|**Function**
1254 |(% rowspan="3" %)Double word|C0|0-13 (Hex)|0-19|Set read only parameter for area 0
1255 |C1|0-4D(Hex)|0-77|Set Read/Write parameter for area 0
1256 |C3|0-CD(Hex)|0-205|Set Read/Write parameter for area 1
1257 |(% rowspan="6" %)Word|80|0-13(Hex)|0-19|Set read only parameter in area 0
1258 |81|0-4D(Hex)|0-77|Set Read/Write parameter in area 0
1259 |83|0-CD(Hex)|0-205|Set Read/Write parameter in area 1
1260 |CP|-|0-6|Read controller intrinsic property
1261 |CS|-|0-2|Read controller states
1262 |CA|-|0-17|Action command
1263
1264 **3)Device Settings**
1265
1266 Omron E5CC PLC configuration
1267
1268 After entering the Communication Settings menu, please set the parameters to the default values for the following table. Press the cycle key of the instrument to enter the next setting.
1269
1270 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_3d95e093792ba98a.png?width=550&height=229&rev=1.1||alt="12.PLC Protocol_html_3d95e093792ba98a.png" height="229" width="550"]]
1271
1272 According to PLC configuration and communication port configuration information of the HMI, provide the corresponding steps and configuration screenshots. This configuration needs to communicate properly with the above PLC configuration. The project settings are as follows
1273
1274 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_be583aa69dd6cf4c.png?width=550&height=242&rev=1.1||alt="12.PLC Protocol_html_be583aa69dd6cf4c.png" height="242" width="550"]]
1275
1276 **✎Note:** The communication settings for HMI should be consistent with this setting.
1277
1278 **4)Configure the communication protocol**
1279
1280 [[image:image-20220831161041-1.png]]
1281
1282 **5)Cable Wiring**
1283
1284 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_5e9a81a14106da9e.png?width=392&height=223&rev=1.1||alt="12.PLC Protocol_html_5e9a81a14106da9e.png" height="223" width="392"]]
1285
1286 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_1897d92be6948d58.png?width=393&height=223&rev=1.1||alt="12.PLC Protocol_html_1897d92be6948d58.png" height="223" width="393"]]
1287
1288 **✎Note:**
1289
1290 * COM3 only available in PI8000/PI9000 series.
1291 * CA address could not support continuous writing function;
1292 * Because of CP address intrinsic property: read control intrinsic property, so please place the character input part in use. Set address with CP0 and character length 10, used to display controller type. And place a number input part, set address with CP5 (cache size). Do not place other CP type address without CP0 in screen, otherwise CP type address is invalid
1293 * When set value into read & write address, it is necessary to switch the temperature instrument meter to the corresponding interface according to the menu of the instrument where the address locates, so that the value could be written, otherwise, the value could not be written; When the communication write setting of the instrument is turned off, the writing function is invalid. Writing function could be opened by using the 00 address of the CA register, which write 01 value.
1294 * When continuous writing of a value to a read-write address, please make sure all continuous writing address could be written. Otherwise, if one of these addresses could not be written, then all continuous writing commands will fail.
1295 * Because of the mechanism problem, this protocol could not support CompoWay/F function that is read-write function of variables in protocol document.
1296 * When using double-word address, set the data format to 32 bits, otherwise the read/write function is unable.
1297 * Please set the communication delay time of 10ms in setting, to avoid that the instrument may not be able to communicate in a short time due to too fast data access and too much connection requests.
1298 * [[image:image-20220831161356-1.png]]Because of the particularity of the instrument, it is necessary to write the value of the address in the menu interface corresponding to the address, and to enter the menu where the address locates, so that the value could be written.
1299
1300 = Create communication with Xinje** PLC** =
1301
1302 == **XC serial protocol** ==
1303
1304 **1)V-BOX Settings**
1305
1306 |**Item**|**Settings**|**Note**
1307 |Protocol|XINJE XC MODBUS|
1308 |Connection|RS232|
1309 |Baud rate|19200|
1310 |Data bit|8|
1311 |Parity|EVEN|
1312 |Stop bit|1|
1313 |PLC station No.|1|
1314
1315 **2)Address List**
1316
1317 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1318 |Bit|M|M|M d|0~~8511|
1319 |Bit|X|X|X o|0~~1747|
1320 |Bit|Y|Y|Y o|0~~1747|
1321 |Bit|S|S|S d|0~~1023|
1322 |Bit|T|T|T d|0~~4095|
1323 |Bit|C|C|C d|0~~634|
1324 |Word|D|D|D d|0~~8511|
1325 |Word|TD|TD|TD d|0~~618|
1326 |Word|CD|CD|CD d|0~~634|
1327 |Word|FD|FD|FD d|0~~8511|
1328
1329 **3)Configure the communication protocol**
1330
1331
1332 [[image:image-20220831163041-1.png]]
1333
1334 **4)Cable Wiring**
1335
1336 Figure
1337
1338 [[image:image-20220831163406-2.png]][[image:image-20220831163422-3.png]]
1339
1340 Pin Definition Diagram
1341
1342 [[image:image-20220831163441-4.png]]
1343
1344 == **XD serial protocol** ==
1345
1346 **1)V-BOX Settings**
1347
1348 Supported Series: Delta Xinjie XD/XE Series PLC
1349
1350 |**Item**|**Settings**|**Note**
1351 |Protocol|XINJE XD/XC MODBUS|
1352 |Connection|RS232|
1353 |Baud rate|19200|
1354 |Data bit|8|
1355 |Parity|EVEN|
1356 |Stop bit|1|
1357 |PLC station No.|1|
1358
1359 **2)Address List**
1360
1361 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1362 |Bit|M|M|M d|0~~74999|
1363 |Bit|X1xx|X1xx|X1xx o|0~~1177|
1364 |Bit|X2xx|X2xx|X2xx o|0~~277|
1365 |Bit|X|X|X o|0~~77|
1366 |Bit|Y1xx|Y1xx|Y1xx o|0~~1177|
1367 |Bit|Y2xx|Y2xx|Y2xx o|0~~277|
1368 |Bit|Y|Y|Y o|0~~4095|
1369 |Bit|SM|SM|SM d|0~~4999|(((
1370
1371 )))
1372 |Bit|T|T|T d|0~~4999|
1373 |Bit|C|C|C d|0~~4999|
1374 |Bit|ET|ET|ET d|0~~31|
1375 |Bit|SE|SE|SE d|0~~31|
1376 |Bit|HM|HM|HM d|0~~11999|
1377 |Bit|HSC|HSC|HSC d|0~~39|
1378 |Bit|HS|HS|HS d|0~~999|
1379 |Bit|HT|HT|HT d|0~~1999|
1380 |Bit|HC|HC|HC d|0~~1999|
1381 |Bit|S|S|S d|0~~7999|
1382 |Word|D|D|D d|0~~69999|
1383 |Word|ID|ID|ID d|0~~99|
1384 |Word|ID1xx|ID1xx|ID1xx d|0~~999|
1385 |Word|ID2xx|ID2xx|ID2xx d|0~~299|
1386 |Word|QD|QD|QD d|0~~99|
1387 |Word|QD1xx|QD1xx|QD1xx d|0~~999|
1388 |Word|QD2xx|QD2xx|QD2xx d|0~~299|
1389 |Word|SD|SD|SD d|0~~4999|
1390 |Word|TD|TD|TD d|0~~575|
1391 |Word|CD|CD|CD d|0~~575|
1392 |Word|ETD|ETD|ETD d|0~~31|
1393 |Word|HD|HD|HD d|0~~24999|
1394 |Word|HSD|HSD|HSD d|0~~1023|
1395 |Word|HTD|HTD|HTD d|0~~95|
1396 |Word|HCD|HCD|HCD d|0~~95|
1397 |Word|HSCD|HSCD|HSCD d|0~~31|
1398 |Word|FD|FD|FD d|0~~8191|
1399 |Word|SFD|SFD|SFD d|0~~5999|
1400 |Word|FS|FS|FS d|0~~47|
1401
1402 **3)Configure the communication protocol**
1403
1404 [[image:image-20220831163923-7.png]]
1405
1406
1407
1408 **4)Cable Wiring**
1409
1410 Figure
1411
1412 [[image:image-20220831163406-2.png]][[image:image-20220831163553-6.png]]
1413
1414 Pin Definition Diagram
1415
1416 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/image-20220830160232-3.png?rev=1.1||alt="image-20220830160232-3.png"]]
1417
1418
1419 = Create communication with **Schneider PLC** =
1420
1421 == **Schneider MODBUS RTU** ==
1422
1423 **1)V-BOX Setting**
1424
1425 |=**Parameters**|=**Recommended**|=**Notes**
1426 |**Protocol**|(% colspan="1" %)Schneider MODBUS RTU|
1427 |**Connection**|RS485|
1428 |**Baud rate**|19200|
1429 |**Data bit**|8|
1430 |**Parity**|Even|
1431 |**Stop bit**|1|
1432 |**PLC station No.**|1|
1433
1434 **2)Address List**
1435
1436 |=**Bit/Word**|=**Device type**|=**Format**|=**Range**|=**Memo**
1437 |B|IX|DDDDDo|0 ~~ 655357|Input bit (read only)
1438 |B|QX|DDDDDo|0 ~~ 655357|Write multiple coils
1439 |B|MX|DDDDDDo|0 ~~ 9999997|Output register bit (octal)
1440 |W|MW|DDDDDD|0 ~~ 999999|Output register
1441 |DW|MD|DDDDDD|0 ~~ 999999|Output register
1442
1443 **3)Configure the communication protocol**
1444
1445 [[image:image-20220902104329-1.png]]
1446
1447 **4)Cable Wiring**
1448
1449 **RS-485 2W **(RJ45 Connector): The following is the view from the soldering point of a connector.
1450
1451 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/image-20220817154212-1.jpeg?width=554&height=315&rev=1.1||alt="image-20220817154212-1.jpeg" height="315" width="554"]]
1452
1453 = Create communication with Inovance** PLC** =
1454
1455 == **H3U serial protocol** ==
1456
1457 **1)V-BOX Settings**
1458
1459 |**Item**|**Settings**|**Note**
1460 |Protocol|INOVANCE H3U PLC|
1461 |Connection|RS422|
1462 |Baud rate|9600|
1463 |Data bit|7|
1464 |Parity|EVEN|
1465 |Stop bit|1|
1466 |PLC station No.|0|
1467
1468 **2)Address List**
1469
1470 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1471 |Bit|X|X|X o|0~~303237|
1472 |Bit|Y|Y|Y o|0~~303237|
1473 |Bit|M|M|M d|0~~99999|
1474 |Bit|T|T|T d|0~~99999|
1475 |Bit|C|C|C d|0~~99999|
1476 |Bit|SM|SM|SM d|8000~~999|
1477 |Bit|S|T|S d|0~~99999|
1478 |Bit|Lamp|Lamp|Lamp d|0~~0|
1479 |Word|X|X|X o|0~~303237|
1480 |Word|Y|Y|Y o|0~~303237|
1481 |Word|M|M|M d|0~~99999|
1482 |Word|T|T|T d|0~~99999|
1483 |Word|C|C|C d|0~~199|
1484 |Word|D|D|D d|0~~7999|
1485 |Word|S|S|S d|0~~99999|
1486 |Word|SD|SD|SD d|8000~~9999|
1487 |Word|R|R|R d|0~~32767|
1488
1489 **3)Configure the communication protocol**
1490
1491 [[image:image-20220831164626-1.png]]
1492
1493
1494
1495 **4)Cable Wiring**
1496
1497 Figure
1498
1499 [[image:image-20220831164646-2.png]][[image:image-20220831164700-3.png]]
1500
1501 Pin Definition Diagram
1502
1503 [[image:image-20220831164731-4.png]]
1504
1505 = Create communication with Panasonic** PLC** =
1506
1507 == **FP serial protocol** ==
1508
1509 **1)V-BOX Settings**
1510
1511 |**Item**|**Settings**|**Note**
1512 |Protocol|Panasonic FP MFWTOCOL|
1513 |Connection|RS232|
1514 |Baud rate|9600|
1515 |Data bit|8|
1516 |Parity|ODD|
1517 |Stop bit|1|
1518 |PLC station No.|1|
1519
1520 **2)Address List**
1521
1522 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1523 |Bit|X|X|X d|0~~9999|
1524 |Bit|Y|Y|Y d|0~~9999|
1525 |Bit|R|R|R d|0~~9999|
1526 |Bit|T|T|T d|0~~9999|
1527 |Bit|C|C|C d|0~~9999|
1528 |Bit|L|L|L d|0~~9999|
1529 |Word|WX|WX|WX d|0~~9999|
1530 |Word|WY|WY|WY d|0~~9999|
1531 |Word|WR|WR|WR d|0~~9999|
1532 |Word|WL|WL|WL d|0~~9999|
1533 |Word|LD|LD|LD d|0~~9999|
1534 |Word|DT|DT|DT d|0~~65535|
1535 |Word|FL|FL|FL d|0~~9999|
1536 |Word|EV|EV|EV d|0~~9999|
1537 |Word|SV|SV|SV d|0~~9999|
1538
1539 **3)Configure the communication protocol**
1540
1541 [[image:image-20220831165238-4.png]]
1542
1543
1544
1545 **4)Cable Wiring**
1546
1547 Figure
1548
1549 [[image:image-20220831165031-3.png]][[image:image-20220831165017-2.png]]
1550
1551 Pin Definition Diagram
1552
1553 [[image:image-20220831165008-1.png]]
1554
1555 = Create communication with LS** PLC** =
1556
1557 == **XBC serial protocol** ==
1558
1559 **1)V-BOX Settings**
1560
1561 |**Item**|**Settings**|**Note**
1562 |Protocol|LS XBC CNet|
1563 |Connection|RS232|
1564 |Baud rate|115200|
1565 |Data bit|8|
1566 |Parity|NONE|
1567 |Stop bit|1|
1568 |PLC station No.|1|
1569
1570 **2)Address List**
1571
1572 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1573 |Bit|P|P|P d|0~~2047|
1574 |Bit|M|M|M d|0~~2047|
1575 |Bit|L|L|L d|0~~11263|
1576 |Bit|K|K|K d|0~~16183|
1577 |Bit|F|F|F d|0~~2047|
1578 |Bit|D|D|D d|0~~32767|
1579 |Bit|R|R|R d|0~~32767|
1580 |Bit|U|U|U d|0~~4095|
1581 |Word|P|P|P d|0~~2047|
1582 |Word|M|M|M d|0~~2047|
1583 |Word|L|L|L d|0~~11263|
1584 |Word|K|K|K d|0~~16183|
1585 |Word|F|F|F d|0~~2047|
1586 |Word|C|C|C d|0~~2047|
1587 |Word|T|T|T d|0~~2047|
1588 |Word|D|D|D d|0~~32767|
1589 |Word|N|N|N d|0~~21503|
1590 |Word|R|R|R d|0~~32767|
1591 |Word|U|U|U d|0~~4095|
1592 |Word|Z|Z|Z d|0~~127|
1593 |Word|S|S|S d|0~~127|
1594
1595 **3)Configure the communication protocol**
1596
1597 [[image:image-20220831170147-1.png]]
1598
1599 **4)Cable Wiring**
1600
1601 Figure
1602
1603 [[image:image-20220831170306-4.png]][[image:image-20220831170254-3.png]]
1604
1605 Pin Definition Diagram
1606
1607 [[image:image-20220831170215-2.png]]
1608
1609 == **XGK FEnet Ethernet protocol** ==
1610
1611 Supported Series: LS XGT series XGK CPU with XGL-EFMT Ethernet module
1612
1613 **1)V-BOX Settings**
1614
1615 |**Items**|**Settings**|**Note**
1616 |Protocol|LG XGK FEnet(Ethernet)|
1617 |Connection|Ethernet|
1618 |Port No.|2004|
1619
1620 **2)Address List**
1621
1622 |**Type**|**Register**|**Range**|**Format**|**Note**
1623 |(% rowspan="14" %)Word|P|0~~2047|P d|
1624 |M|0~~2047|M d|
1625 |K|0~~2047|K d|
1626 |F|0~~2047|F d|
1627 |T|0~~2047|T d|
1628 |C|0~~2047|C d|
1629 |Z|0~~127|Z d|
1630 |S|0~~127|S d|
1631 |L|0~~11263|L d|
1632 |N|0~~21503|N d|
1633 |D|0~~32767|D d|
1634 |R|0~~32767|R d|
1635 |ZR|0~~65535|ZR d|
1636 |UxDD|0~~6331|UxDD nndd|nn: 0~~63, dd: 0~~31
1637
1638 **✎Note:**
1639
1640 * In addition to the "UxDD" register, the others correspond to the PLC register one by one. UxDD corresponds to U in the PLC;
1641 * The [UxDD] register, defined in the PLC is Ux.dd, x represents the block, and dd represents 0-31 of each block. There are 64 blocks in the PLC;
1642 * All bit registers are in the form of bits in word, and the range is the same as the word register;
1643
1644 **3)Communication Settings**
1645
1646 [[image:image-20220831171127-1.png]]
1647
1648 **4)Cable Wiring**
1649
1650 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_2297240b57346b2a.png?width=401&height=170&rev=1.1||alt="12.可编程逻辑控制器Protocol_html_2297240b57346b2a.png" height="170" width="401"]]
1651
1652 = Create communication with **Modbus ** =
1653
1654 == **MODBUS RTU Slave (All function)** ==
1655
1656 Select the protocol "Modbus RTU Slave (All Fuction)",
1657
1658 Then set baud rate, port, stop bits, data bits, parity.
1659
1660 (% style="text-align:center" %)
1661 [[image:1624342015914-382.png||height="486" width="800" class="img-thumbnail"]]
1662
1663 == **MODBUS RTU Master** ==
1664
1665 Select the protocol "Modbus RTU Master",
1666
1667 Then set baud rate, port, stop bits, data bits, parity
1668
1669 (% style="text-align:center" %)
1670 [[image:1624348709622-711.png||queryString="width=809&height=493" height="488" width="800" class="img-thumbnail"]]
1671
1672 **address list**
1673
1674 (% class="table-bordered" %)
1675 |**type**|**register**|**Function code and description**
1676 |(% rowspan="11" %)词|(% rowspan="3" %)3|04 (Read Input Registers: Read the current binary value in one or more input registers)
1677 |06 (write single register: write a binary value to a holding register)
1678 |10 (write values to multiple addresses )
1679 |(% rowspan="3" %)4|03 (read holding register: read current binary value in one or more holding registers)
1680 |06 (write single register: write a binary value to a holding register)
1681 |10 (write values to multiple addresses )
1682 |(% rowspan="3" %)W6|03 (read holding register: read current binary value in one or more holding registers)
1683 |06 (write single register: write a binary value to a holding register)
1684 |10 (write values to multiple addresses )
1685 |(% rowspan="2" %)W16|03 (read holding register: read current binary value in one or more holding registers)
1686 |10 (write values to multiple addresses )
1687 |(% rowspan="11" %)Bit|(% rowspan="3" %)0|01 (Read coil state)
1688 |05 (Force a single coil to force the on/off state of a logic coil)
1689 |0F (Write multiple bits, ie write continuously)
1690 |(% rowspan="3" %)1|02 (Read the input state)
1691 |05 (Force a single coil to force the on/off state of a logic coil)
1692 |0F (Write multiple bits)
1693 |(% rowspan="3" %)W5|01 (Read coil state to obtain the current state of a set of logic coils)
1694 |05 (Force a single coil to force the on/off state of a logic coil)
1695 |0F (Write multiple bits)
1696 |(% rowspan="2" %)W15|01 (Read coil state to obtain the current state of a set of logic coils)
1697 |0F (Write multiple bits)
1698
1699 == **MODBUS TCP Slave (All function)** ==
1700
1701 Supported series: MODBUS TCP controller
1702
1703 V-B0X works as MODBUS TCP MASTER connecting with TCP SLAVE
1704
1705 **1)V-BOX Setting**
1706
1707 |**Items**|**Settings**|**Note**
1708 |Protocol|MODBUS TCP Slave (All function)|
1709 |Connection|Ethernet|
1710 |Port No.|502|
1711 |PLC station No.|1
1712
1713 **2)Address List**
1714
1715 |**Type**|**Register**|**Function code & Description**
1716 |(% rowspan="11" %)Word|(% rowspan="3" %)3|04 (read input register: read current binary value in one or more input registers)
1717 |06 (write single register: write a binary value to a holding register)
1718 |10 (write values to multiple addresses )
1719 |(% rowspan="3" %)4|03 (read holding register: read current binary value in one or more holding registers)
1720 |06 (write single register: write a binary value to a holding register)
1721 |10 (write values to multiple addresses )
1722 |(% rowspan="3" %)W6|03 (read holding register: read current binary value in one or more holding registers)
1723 |06 (write single register: write a binary value to a holding register)
1724 |10 (write values to multiple addresses )
1725 |(% rowspan="2" %)W16|03 (read holding register: read current binary value in one or more holding registers)
1726 |10 (write values to multiple addresses )
1727 |(% rowspan="11" %)Bit|(% rowspan="3" %)0|01 (Read coil state)
1728 |05 (Force a single coil to force the on/off state of a logic coil)
1729 |0F (Write multiple bits, ie write continuously)
1730 |(% rowspan="3" %)1|02 (Read the input state)
1731 |05 (Force a single coil to force the on/off state of a logic coil)
1732 |0F (Write multiple bits)
1733 |(% rowspan="3" %)W5|01 (Read coil state to obtain the current state of a set of logic coils)
1734 |05 (Force a single coil to force the on/off state of a logic coil)
1735 |0F (Write multiple bits)
1736 |(% rowspan="2" %)W15|01 (Read coil state to obtain the current state of a set of logic coils)
1737 |0F (Write multiple bits)
1738
1739 **3)Communication Settings**
1740
1741 Configure V-BOX Ethernet IP in Networking Settings
1742
1743 [[image:image-20220902111833-3.png]]
1744
1745
1746 Configure PLC Ethernet IP in Communication;
1747
1748 [[image:image-20220902111121-1.png]]
1749
1750 **4)Cable Wiring**
1751
1752 [[image:https://docs.we-con.com.cn/bin/download/PIStudio/12.PLC%20protocols/WebHome/12.PLC%20Protocol_html_2297240b57346b2a.png?width=401&height=170&rev=1.1||alt="12.PLC Protocol_html_2297240b57346b2a.png" height="170" width="401"]]
1753
1754 == **communicate with VB inverter** ==
1755
1756 [[download link>>url:https://ftp.we-con.com.cn/Download/WIKI/V-BOX/Demo/%E9%80%9A%E8%AE%AF%E6%A1%88%E4%BE%8B/Communicate%20with%20VB%20inverter.zip]]
1757
1758 = **User define protocol** =
1759
1760 More serial port script instruction,please refer manual:[[Lua script function>>doc:V-BOX.V-Net.Manual.04 Lua Script.01 Lua Functions.WebHome]]~-~-->[[3.Serial port operation>>url:http://docs.we-con.com.cn/wiki/vbox/view/HMI/04.Lua%20script%20%20function%20and%20operation/01.Lua%20script%20function/#H3.Serialportoperation]]
1761
1762 == **Read the temperature sensor.** ==
1763
1764 the commond format is as beliow:
1765
1766 Send commond:01 03 02 00 00 03 04 73
1767
1768 Feedback commond:01 03 06 07 F7 0E 7E B7 35
1769
1770 Temperature data:07 F7,desimal = 2039,it means temperature is 20.39℃.
1771
1772 Humidity data:0E 7E,desimal = 3710, it mean humidity is 37.10%RH.
1773
1774 Script Demo:
1775
1776 ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--
1777
1778 function com.main()
1779 ~-~-dosomething
1780 openPlc()
1781 end
1782 function openPlc()
1783 if obj then
1784 ~-~- If the serial port opened,then read/write data by timing
1785
1786 local wri = string.pack(">HHHH",0X0103,0X0200,0X0003,0X0473)
1787 local arr = reading(wri)
1788 ~-~- if arr ~~=nil then
1789 ~-~- if arr[1] ==33 and arr[2] ==v[2][2] and arr[3] ==v[2][3] then
1790 ~-~- local A = arr[4]*256
1791 ~-~- local B = A+arr[5]
1792 ~-~- addr_setword(v[1],B)
1793 ~-~- end
1794 ~-~- end
1795
1796 else
1797 ~-~-judge if there is a serial object, then initialize and open the serial port
1798 local configs = {
1799 name = 'COM1', ~-~-Select serial port COM1
1800 mode = 485, ~-~-Communication mode RS485
1801 baud_rate = 9600, ~-~-Baud rate 9600
1802 stop_bit = 1, ~-~-stop bit 1
1803 data_len = 8, ~-~-data length 8
1804 check_bit = 'NONE', ~-~-no parity
1805
1806 }
1807 obj,err = serial.open(configs) ~-~-Open serial port
1808 if not obj then
1809 print("serial open :failed", err) ~-~- Open serial port failed
1810 end
1811 end
1812 end
1813
1814 function reading(wri)
1815 obj:flush() ~-~- Clear serial port
1816 obj:write(wri) ~-~- Write serial port
1817 print(string.byte(wri,1,#wri))
1818 obj:flush() ~-~- Clear serial port 
1819 local readed =obj:read(9,1000) ~-~- Read 9 bytes, timeout 1 second
1820 if readed and readed ~~= "" then 
1821 ~-~- judge that a non-empty string is read
1822 print(string.byte(readed,1,#readed))
1823 a={string.byte(readed, 1, #readed)}
1824 if nil ~~= a[4] and nil ~~= a[5] and nil ~~= a[6] and nil ~~= a[7] then
1825 a1=a[4]*256+a[5]
1826 a2=a[6]*256+a[7]
1827 addr_setword("@HDW0",a1)
1828 addr_setword("@HDW1",a2)
1829 end
1830 return {string.byte(readed, 1, #readed)}
1831 elseif readed == nil then
1832 print("serial read err:", err or "")
1833 return nil
1834 end
1835 return nil
1836 end
1837
1838 ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-