Skip to Content

Wiki source code of 1 Communication

Version 175.1 by Bob on 2022/11/16 11:17
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 **1)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 **2)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 **3)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-20221116105850-1.png]]
742
743 Select "Operational setting" to enter the following screen.
744
745 The Ethernet module IP is set to 192.168.39.254 in this document, and other options are default.
746
747 [[image:image-20221116105947-1.png]]
748
749 Select "Open setting" to enter the setting interface, the settings are as follows.
750
751 The third item "Protocol" selects TCP, and "Open system" selects MELSOFT connection, which allows the
752
753 Mitsubishi programming software GX works2 to communicate with the FX3U via the Ethernet module.
754
755 [[image:image-20221116110802-1.png]]
756
757 Click on "transter setup" - "PC side I/F setting", see the following figure.
758
759 After setting, the first download must use the programming cable, as shown in the figure; after that, can
760
761 use the IP set in the "Ethernet board" to communicate directly with the network cable.
762
763 [[image:image-20221116110832-2.png||height="423" width="708"]]
764
765 Read and write data from the Ethernet module
766
767 [[image:image-20221116110907-3.png]]
768
769 Set "Transter setup" to COM communication, and read or write operation as shown below
770
771 [[image:image-20221116110917-4.png]]
772
773 **4)PLC Settings (GX Works 2)**
774
775 Create a blank FX5U project
776
777 Find Current Connection in the navigation
778
779 [[image:image-20221116111427-1.png||height="421" width="705"]]
780
781 Select Connection Channel List
782
783 Select Ethernet board communication
784
785 [[image:image-20221116111451-2.png||height="421" width="705"]]
786
787 Select Ethernet Module
788 Set the IP address of the PLC
789
790 [[image:image-20221116111509-3.png||height="666" width="699"]]
791
792 Read or write PLC data, in this document is read
793
794 [[image:image-20221116111651-4.png||height="416" width="697"]]
795
796 [[image:image-20221116111727-5.png||height="416" width="697"]]
797
798 **V-BOX Communication Setting**
799
800
801
802
803 == **FX5U Serial Protocol** ==
804
805 Mitsubishi FX5U series PLC
806
807 **1）V-BOX Settings**
808
809 |**Item**|**Settings**|**Note**
810 |Protocol|Mitsubishi FX5U|
811 |Connection|RS422/RS485|
812 |Baud rate|9600|
813 |Data bit|7|
814 |Parity|Odd|
815 |Stop bit|1|
816 |PLC station No.|1~~255|Need to be the same as PLC settings
817
818 **2）Address List**
819
820 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
821 |(% rowspan="15" %)Bit|X|X|X o|0~~303237|
822 |Y|Y|Y o|0~~303237|
823 |M|M|M d|0~~99999|
824 |B|B|B h|0~~7FFF|
825 |F|F|F d|0~~32767|
826 |SB|SB|SB h|0~~7FFF|
827 |TS|TS|TS d|0~~1023|
828 |TC|TC|TC d|0~~1023|
829 |STS|STS|STS d|0~~1023|
830 |STC|STC|STS d|0~~1023|
831 |CS|CS|CS d|0~~1023|
832 |CC|CC|CC d|0~~1023|
833 |SM|SM|SM d|0~~9999|
834 |L|L|L d|0~~32767|
835 |S|S|S d|0~~4095|
836 |(% rowspan="9" %)Word|W|W|W h|0~~3FF|
837 |TN|TN|TN d|0~~1023|
838 |STN|STN|STN d|0~~1023|
839 |CN|CN|CN d|0~~1023|
840 |R|R|R d|0~~32767|
841 |SW|SW|SW h|0~~7FFF|
842 |Z|Z|Z d|0~~23|
843 |D|D|D d|0~~7999|
844 |SD|SD|SD d|0~~11999|
845
846 **3）PLC Settings (GX Works 3)**
847
848 Create a blank FX5U project
849
850 Find the 485 serial port module in the system navigation bar and double click to enter the settings.
851
852 [[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"]]
853
854 Select protocol in the setting item, and set parameters.
855
856 [[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"]]
857
858 Set station number, and [Message Pattern] (Pattern 1 or Pattern 4)
859
860 [[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"]]
861
862 Click the [Apply] button to finish the setting.
863
864 Click download and select the items as below, then click [execute] to download the configuration to PLC.
865
866 [[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"]]
867
868 As soon as download is completed, connect PLC with serial port, then configure it in the [Specify Connection Destination Connection].
869
870 Done.
871
872 **4）Configure the communication protocol**
873
874 [[image:image-20220825104904-1.png]]
875
876 **5）Cable Wiring**
877
878
879 * **RS422**
880
881 [[image:image-20220825105105-2.png]]
882
883 [[image:image-20220825105533-3.png]]
884
885 == **FX5U Ethernet Protocol** ==
886
887 Mitsubishi FX5U series PLC
888
889 **1）V-BOX Settings**
890
891 |**Items**|**Settings**|**Note**
892 |Protocol|Mitsubishi FX5U|
893 |Connection|Ethernet|
894 |Port No.|5002|Must be the same as the PLC setting
895 |PLC station No.|0|
896
897 **2）Address List**
898
899 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
900 |(% rowspan="15" %)Bit|X|X|X o|0~~303237|
901 |Y|Y|Y o|0~~303237|
902 |M|M|M d|0~~99999|
903 |B|B|B h|0~~7FFF|
904 |F|F|F d|0~~32767|
905 |SB|SB|SB h|0~~7FFF|
906 |TS|TS|TS d|0~~1023|
907 |TC|TC|TC d|0~~1023|
908 |STS|STS|STS d|0~~1023|
909 |STC|STC|STS d|0~~1023|
910 |CS|CS|CS d|0~~1023|
911 |CC|CC|CC d|0~~1023|
912 |SM|SM|SM d|0~~9999|
913 |L|L|L d|0~~32767|
914 |S|S|S d|0~~4095|
915 |(% rowspan="9" %)Word|W|W|W h|0~~3FF|
916 |TN|TN|TN d|0~~1023|
917 |STN|STN|STN d|0~~1023|
918 |CN|CN|CN d|0~~1023|
919 |R|R|R d|0~~32767|
920 |SW|SW|SW h|0~~7FFF|
921 |Z|Z|Z d|0~~23|
922 |D|D|D d|0~~7999|
923 |SD|SD|SD d|0~~11999|
924
925 **3）PLC Settings (GX Works 3)**
926
927 Find the [Ethernet port] in the navigation area.
928
929 [[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"]]
930
931 Select [Own Node Settings] in the [Setting Item List];
932
933 Set [IP Address], [Subnet Mask], [Default Gateway];
934
935 Click [Detailed Settings] into [Ethernet Configuration (Built-in Ethernet Port)] windows;
936
937 [[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"]]
938
939 Select [SLMP Connection Module] and add into host station as below picture shows;
940
941 Set Port number as 5002 (this is necessary settings);
942
943 Click [Close with Reflecting the Setting] to save and close window;
944
945 [[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"]]
946
947 Click [Apply] to completed Etherenet settings;
948
949 Switch to the [On line data operation] interface as below, check the item and click [Execute] to download.
950
951 [[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"]]
952
953 **4）Configure the communication protocol**
954
955 [[image:image-20220825112403-1.png||alt="图片-20220825112403-1.png"]]
956
957 **5）Cable Wiring**
958
959 [[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"]]
960
961 == **L02 Serial Protocol** ==
962
963 Mitsubishi L02 series CPU built-in serial port.
964
965 **1）V-BOX Settings**
966
967 |**Item**|**Settings**|**Note**
968 |Protocol|Mitsubishi L02|
969 |Connection|RS422|
970 |Baud rate|115200|
971 |Data bit|8|
972 |Parity|Odd|
973 |Stop bit|1|
974 |PLC station No.|1~~255|Need to be the same as PLC settings
975
976 **2）Address List**
977
978 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
979 |Bit|X|X|X h|0~~FFFF|
980 |Bit|Y|Y|Y h|0~~FFFF|
981 |Bit|M|M|M d|0~~9999|
982 |Bit|L|L|L d|0~~9999|
983 |Bit|F|F|F d|0~~9999|
984 |Bit|B|B|B h|0~~FFFF|
985 |Bit|V|V|V d|0~~2047|
986 |Bit|TC|TC|TC d|0~~9999|
987 |Bit|SS|SS|SS d|0~~9999|
988 |Bit|SC|SC|SC d|0~~9999|
989 |Bit|CS|CS|CS d|0~~9999|
990 |Bit|CC|CC|CC d|0~~9999|
991 |Bit|SB|SB|SB h|0~~FFFF|
992 |Bit|SM|SM|SM d|0~~2047|
993 |Bit|STS|STS|STS d|0~~1023|
994 |Bit|S|S|S d|0~~9999|
995 |Bit|DX|DX|DX h|0~~FFFF|
996 |Bit|DY|DY|DY h|0~~FFFF|
997 |Bit|TS|TS|TS d|0~~9999|
998 |Bit|Dbit|Dbit|Dbit d.d|0~~99999.0~~15|
999 |Word|W|W|W h|0~~FFFF|
1000 |Word|TN|TN|TN d|0~~99999|
1001 |Word|SN|SN|SN d|0~~99999|
1002 |Word|CN|CN|CN d|0~~99999|
1003 |Word|R|R|R d|0~~99999|
1004 |Word|SW|SW|SW h|0~~FFFF|
1005 |Word|Z|Z|Z d|0~~99999|
1006 |Word|ZR|ZR|ZR h|0~~FFFF|
1007 |Word|D|D|D d|0~~99999|
1008
1009 **3）Communication Settings**
1010
1011 [[image:image-20220825160648-3.png]]
1012
1013 **4）Cable Wiring**
1014
1015 * **RS422**
1016
1017 [[image:image-20220825161612-8.png]]
1018
1019 [[image:image-20220825160820-4.png]]
1020
1021 == **L02 Ethernet Protocol** ==
1022
1023 Mitsubishi L series CPU built-in Ethernet port.
1024
1025 **1）V-BOX Settings**
1026
1027 |**Items**|**Settings**|**Note**
1028 |Protocol|MIT L02 CPU MELSEC|
1029 |Connection|Ethernet|
1030 |Port No.|1025|Must be the same as the PLC setting
1031 |PLC station No.|0|Must be the same as the PLC setting
1032
1033 **2）Address List**
1034
1035 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1036 |Bit|X|X|X h|0~~FFFF|
1037 |Bit|Y|Y|Y h|0~~FFFF|
1038 |Bit|M|M|M d|0~~9999|
1039 |Bit|L|L|L d|0~~9999|
1040 |Bit|F|F|F d|0~~9999|
1041 |Bit|B|B|B h|0~~FFFF|
1042 |Bit|V|V|V d|0~~2047|
1043 |Bit|TC|TC|TC d|0~~9999|
1044 |Bit|SS|SS|SS d|0~~9999|
1045 |Bit|SC|SC|SC d|0~~9999|
1046 |Bit|CS|CS|CS d|0~~9999|
1047 |Bit|CC|CC|CC d|0~~9999|
1048 |Bit|SB|SB|SB h|0~~FFFF|
1049 |Bit|SM|SM|SM d|0~~2047|
1050 |Bit|STS|STS|STS d|0~~1023|
1051 |Bit|S|S|S d|0~~9999|
1052 |Bit|DX|DX|DX h|0~~FFFF|
1053 |Bit|DY|DY|DY h|0~~FFFF|
1054 |Bit|TS|TS|TS d|0~~9999|
1055 |Bit|Dbit|Dbit|Dbit d.d|0~~99999.0~~15|
1056 |Word|W|W|W h|0~~FFFF|
1057 |Word|TN|TN|TN d|0~~99999|
1058 |Word|SN|SN|SN d|0~~99999|
1059 |Word|CN|CN|CN d|0~~99999|
1060 |Word|R|R|R d|0~~99999|
1061 |Word|SW|SW|SW h|0~~FFFF|
1062 |Word|Z|Z|Z d|0~~99999|
1063 |Word|ZR|ZR|ZR h|0~~FFFF|
1064 |Word|D|D|D d|0~~99999|
1065
1066 **3）PLC Settings (GX Works2 )**
1067
1068 Create a project
1069
1070 Set PLC IP, subnet mask and gateway;
1071
1072 Select [Binary Code] as communication data code;
1073
1074 [[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"]]
1075
1076 Set PLC port number, for example 1025
1077
1078 [[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"]]
1079
1080 Save settings;
1081
1082 Download project into PLC device;
1083
1084 Restart PLC device;
1085
1086 **4）Configure the communication protocol**
1087
1088 [[image:image-20220825142659-1.png]]
1089
1090 **5）Cable Wiring**
1091
1092 [[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"]]
1093
1094 == **QJ71E71 Ethernet Protocol** ==
1095
1096 Mitsubishi QJ71E71 Ethernet communication module;
1097
1098 **1）V-BOX Settings**
1099
1100 |**Items**|**Settings**|**Note**
1101 |Protocol|MIT QJ71E71 MELSEC|
1102 |Connection|Ethernet|
1103 |Port No.|1025|Must be the same as the PLC setting
1104 |PLC station No.|0|Must be the same as the PLC setting
1105
1106 **2）Address List**
1107
1108 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1109 |(% rowspan="18" %)Bit|X|X|X h|0~~1FFF|
1110 |Y|Y|Y h|0~~1FFF|
1111 |M|M|M d|0~~99999|
1112 |L|L|L d|0~~8191|
1113 |F|F|F d|0~~2047|
1114 |B|B|B h|0~~1FFF|
1115 |V|V|V d|0~~2047|
1116 |TS|TS|TS d|0~~2047|
1117 |TC|TC|TC d|0~~2047|
1118 |SS|SS|SS d|0~~2047|
1119 |SC|SC|SC d|0~~2047|
1120 |CS|CS|CS d|0~~1023|
1121 |CC|CC|CC d|0~~1023|
1122 |SB|SB|SB h|0~~7FF|
1123 |S|S|S d|0~~8191|
1124 |DX|DX|DX h|0~~1FFF|
1125 |DY|DY|DY h|0~~1FFF|
1126 |SM|SM|SM d|8000~~9999|
1127 |(% rowspan="10" %)Word|SD|SD|SD d|0~~2047|
1128 |D|D|D d|0~~12287|
1129 |W|W|W h|0~~1FFF|
1130 |TN|TN|TN d|0~~2047|
1131 |SN|SN|SN d|0~~2047|
1132 |CN|CN|CN d|0~~1023|
1133 |R|R|R d|0~~32767|
1134 |SW|SW|SW h|0~~7FF|
1135 |Z|Z|Z d|0~~15|
1136 |ZR|ZR|ZR h|0~~FE7FF|
1137
1138 **3）PLC Settings(GX Works2)**
1139
1140 * Click [Ethernet/CC IE/MELSECNET];
1141 * Please select [Ethernet] as network type;
1142 * Set station I/O number according to situation (For example, 0000 means that the module is connected to PLC CPU in first order);
1143 * Select [Online] as Mode;
1144 * Click [Operation setting] to set IP;
1145 * Select [Binary Code] as [Communication Data Code];
1146 * Set protocol: TCP;
1147 * Set [unpassive] in [Open system];
1148 * Set [receive] in [Fixed buffer];
1149 * Set [procedure Exist] in [Fixed buffer communication];
1150 * Disable [Pairing open];
1151 * Set [No confirm] in [Existence confirmation];
1152 * Host station port number: 1025;
1153 * Save settings;
1154 * Download project into PLC and restart it
1155
1156 **4）Configure the communication protocol**
1157
1158 [[image:image-20220825143728-1.png]]
1159
1160 **5）Cable Wiring**
1161
1162 [[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"]]
1163
1164 = Create communication with **Delta PLC** =
1165
1166 == **DVP Ethernet Protocol** ==
1167
1168 [[下载链接>>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]]
1169
1170 == **DVP serial protocol** ==
1171
1172 [[下载链接>>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]]
1173
1174 == **AS Ethernet Protocol** ==
1175
1176 **1）V-BOX Settings**
1177
1178 |=**Items**|=**Settings**|=**Note**
1179 |Protocol|DELTA AS300 MODBUS TCP|
1180 |Connection|Ethernet|
1181 |Port No.|502|
1182 |Device No.|1|
1183 |HMI No.|0|
1184
1185 **2）Address List**
1186
1187 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1188 |Bit|X|X|X d|0~~63|
1189 |Bit|Y|Y|Y d|0~~63|
1190 |Bit|D|D|D d|0~~29999|
1191 |Bit|M|M|M d|0~~8191|
1192 |Bit|SM|SM|SM d|0~~4095|
1193 |Bit|S|S|S h|0~~2047|
1194 |Bit|T|T|T d|0~~511|
1195 |Bit|C|C|C d|0~~511|
1196 |Bit|HC|HC|HC d|0~~255|
1197 |Word|X|X|X h|0~~63|
1198 |Word|Y|Y|Y d|0~~63|
1199 |Word|SR|SR|SR d|0~~2047|
1200 |Word|D|D|D d|0~~29999|
1201 |Word|T|T|T d|0~~511|
1202 |Word|C|C|C h|0~~511|
1203 |Word|E|E|E d|0~~9|
1204
1205 **3）Configure the communication protocol**
1206
1207
1208 [[image:image-20220831160010-4.png]]
1209
1210 **4）Cable Wiring**
1211
1212 Figure
1213
1214 [[image:image-20220831155101-1.png]][[image:image-20220831160055-5.png]]
1215
1216 Pin Definition Diagram
1217
1218 [[image:image-20220831155157-3.png]]
1219
1220 = Create communication with **Omron PLC** =
1221
1222 == **CP1 Series Protocol ** ==
1223
1224 [[下载链接>>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]]
1225
1226 == **CP2M Series Protocol** ==
1227
1228 [[下载链接>>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]]
1229
1230
1231 == **EC55 Series Protocol** ==
1232
1233 Supported device: EC55 temperature instrument
1234
1235 **1）V-BOX Settings**
1236
1237 |**Items**|**Settings**|**Note**
1238 |Protocol|Omron EC55|
1239 |Connection|RS485 (9600, 2, 7, EVEN)|
1240 |Port No.|None|
1241 |PLC station No.|0|
1242
1243 **2）Address List**
1244
1245 |**Type**|**Register**|**Device range**|**HMI range**|**Function**
1246 |(% rowspan="3" %)Double word|C0|0-13 (Hex)|0-19|Set read only parameter for area 0
1247 |C1|0-4D(Hex)|0-77|Set Read/Write parameter for area 0
1248 |C3|0-CD(Hex)|0-205|Set Read/Write parameter for area 1
1249 |(% rowspan="6" %)Word|80|0-13(Hex)|0-19|Set read only parameter in area 0
1250 |81|0-4D(Hex)|0-77|Set Read/Write parameter in area 0
1251 |83|0-CD(Hex)|0-205|Set Read/Write parameter in area 1
1252 |CP|-|0-6|Read controller intrinsic property
1253 |CS|-|0-2|Read controller states
1254 |CA|-|0-17|Action command
1255
1256 **3）Device Settings**
1257
1258 Omron E5CC PLC configuration
1259
1260 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.
1261
1262 [[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"]]
1263
1264 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
1265
1266 [[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"]]
1267
1268 **✎Note:** The communication settings for HMI should be consistent with this setting.
1269
1270 **4）Configure the communication protocol**
1271
1272 [[image:image-20220831161041-1.png]]
1273
1274 **5）Cable Wiring**
1275
1276 [[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"]]
1277
1278 [[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"]]
1279
1280 **✎Note:**
1281
1282 * COM3 only available in PI8000/PI9000 series.
1283 * CA address could not support continuous writing function；
1284 * 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
1285 * 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.
1286 * 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.
1287 * Because of the mechanism problem, this protocol could not support CompoWay/F function that is read-write function of variables in protocol document.
1288 * When using double-word address, set the data format to 32 bits, otherwise the read/write function is unable.
1289 * 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.
1290 * [[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.
1291
1292 = Create communication with Xinje** PLC** =
1293
1294 == **XC serial protocol** ==
1295
1296 **1）V-BOX Settings**
1297
1298 |**Item**|**Settings**|**Note**
1299 |Protocol|XINJE XC MODBUS|
1300 |Connection|RS232|
1301 |Baud rate|19200|
1302 |Data bit|8|
1303 |Parity|EVEN|
1304 |Stop bit|1|
1305 |PLC station No.|1|
1306
1307 **2）Address List**
1308
1309 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1310 |Bit|M|M|M d|0~~8511|
1311 |Bit|X|X|X o|0~~1747|
1312 |Bit|Y|Y|Y o|0~~1747|
1313 |Bit|S|S|S d|0~~1023|
1314 |Bit|T|T|T d|0~~4095|
1315 |Bit|C|C|C d|0~~634|
1316 |Word|D|D|D d|0~~8511|
1317 |Word|TD|TD|TD d|0~~618|
1318 |Word|CD|CD|CD d|0~~634|
1319 |Word|FD|FD|FD d|0~~8511|
1320
1321 **3）Configure the communication protocol**
1322
1323
1324 [[image:image-20220831163041-1.png]]
1325
1326 **4）Cable Wiring**
1327
1328 Figure
1329
1330 [[image:image-20220831163406-2.png]][[image:image-20220831163422-3.png]]
1331
1332 Pin Definition Diagram
1333
1334 [[image:image-20220831163441-4.png]]
1335
1336 == **XD serial protocol** ==
1337
1338 **1）V-BOX Settings**
1339
1340 Supported Series: Delta Xinjie XD/XE Series PLC
1341
1342 |**Item**|**Settings**|**Note**
1343 |Protocol|XINJE XD/XC MODBUS|
1344 |Connection|RS232|
1345 |Baud rate|19200|
1346 |Data bit|8|
1347 |Parity|EVEN|
1348 |Stop bit|1|
1349 |PLC station No.|1|
1350
1351 **2）Address List**
1352
1353 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1354 |Bit|M|M|M d|0~~74999|
1355 |Bit|X1xx|X1xx|X1xx o|0~~1177|
1356 |Bit|X2xx|X2xx|X2xx o|0~~277|
1357 |Bit|X|X|X o|0~~77|
1358 |Bit|Y1xx|Y1xx|Y1xx o|0~~1177|
1359 |Bit|Y2xx|Y2xx|Y2xx o|0~~277|
1360 |Bit|Y|Y|Y o|0~~4095|
1361 |Bit|SM|SM|SM d|0~~4999|(((
1362
1363 )))
1364 |Bit|T|T|T d|0~~4999|
1365 |Bit|C|C|C d|0~~4999|
1366 |Bit|ET|ET|ET d|0~~31|
1367 |Bit|SE|SE|SE d|0~~31|
1368 |Bit|HM|HM|HM d|0~~11999|
1369 |Bit|HSC|HSC|HSC d|0~~39|
1370 |Bit|HS|HS|HS d|0~~999|
1371 |Bit|HT|HT|HT d|0~~1999|
1372 |Bit|HC|HC|HC d|0~~1999|
1373 |Bit|S|S|S d|0~~7999|
1374 |Word|D|D|D d|0~~69999|
1375 |Word|ID|ID|ID d|0~~99|
1376 |Word|ID1xx|ID1xx|ID1xx d|0~~999|
1377 |Word|ID2xx|ID2xx|ID2xx d|0~~299|
1378 |Word|QD|QD|QD d|0~~99|
1379 |Word|QD1xx|QD1xx|QD1xx d|0~~999|
1380 |Word|QD2xx|QD2xx|QD2xx d|0~~299|
1381 |Word|SD|SD|SD d|0~~4999|
1382 |Word|TD|TD|TD d|0~~575|
1383 |Word|CD|CD|CD d|0~~575|
1384 |Word|ETD|ETD|ETD d|0~~31|
1385 |Word|HD|HD|HD d|0~~24999|
1386 |Word|HSD|HSD|HSD d|0~~1023|
1387 |Word|HTD|HTD|HTD d|0~~95|
1388 |Word|HCD|HCD|HCD d|0~~95|
1389 |Word|HSCD|HSCD|HSCD d|0~~31|
1390 |Word|FD|FD|FD d|0~~8191|
1391 |Word|SFD|SFD|SFD d|0~~5999|
1392 |Word|FS|FS|FS d|0~~47|
1393
1394 **3）Configure the communication protocol**
1395
1396 [[image:image-20220831163923-7.png]]
1397
1398
1399
1400 **4）Cable Wiring**
1401
1402 Figure
1403
1404 [[image:image-20220831163406-2.png]][[image:image-20220831163553-6.png]]
1405
1406 Pin Definition Diagram
1407
1408 [[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"]]
1409
1410
1411 = Create communication with **Schneider PLC** =
1412
1413 == **Schneider MODBUS RTU** ==
1414
1415 **1）V-BOX Setting**
1416
1417 |=**Parameters**|=**Recommended**|=**Notes**
1418 |**Protocol**|(% colspan="1" %)Schneider MODBUS RTU|
1419 |**Connection**|RS485|
1420 |**Baud rate**|19200|
1421 |**Data bit**|8|
1422 |**Parity**|Even|
1423 |**Stop bit**|1|
1424 |**PLC station No.**|1|
1425
1426 **2）Address List**
1427
1428 |=**Bit/Word**|=**Device type**|=**Format**|=**Range**|=**Memo**
1429 |B|IX|DDDDDo|0 ~~ 655357|Input bit (read only)
1430 |B|QX|DDDDDo|0 ~~ 655357|Write multiple coils
1431 |B|MX|DDDDDDo|0 ~~ 9999997|Output register bit (octal)
1432 |W|MW|DDDDDD|0 ~~ 999999|Output register
1433 |DW|MD|DDDDDD|0 ~~ 999999|Output register
1434
1435 **3）Configure the communication protocol**
1436
1437 [[image:image-20220902104329-1.png]]
1438
1439 **4）Cable Wiring**
1440
1441 **RS-485 2W **(RJ45 Connector): The following is the view from the soldering point of a connector.
1442
1443 [[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"]]
1444
1445 = Create communication with Inovance** PLC** =
1446
1447 == **H3U serial protocol** ==
1448
1449 **1）V-BOX Settings**
1450
1451 |**Item**|**Settings**|**Note**
1452 |Protocol|INOVANCE H3U PLC|
1453 |Connection|RS422|
1454 |Baud rate|9600|
1455 |Data bit|7|
1456 |Parity|EVEN|
1457 |Stop bit|1|
1458 |PLC station No.|0|
1459
1460 **2）Address List**
1461
1462 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1463 |Bit|X|X|X o|0~~303237|
1464 |Bit|Y|Y|Y o|0~~303237|
1465 |Bit|M|M|M d|0~~99999|
1466 |Bit|T|T|T d|0~~99999|
1467 |Bit|C|C|C d|0~~99999|
1468 |Bit|SM|SM|SM d|8000~~999|
1469 |Bit|S|T|S d|0~~99999|
1470 |Bit|Lamp|Lamp|Lamp d|0~~0|
1471 |Word|X|X|X o|0~~303237|
1472 |Word|Y|Y|Y o|0~~303237|
1473 |Word|M|M|M d|0~~99999|
1474 |Word|T|T|T d|0~~99999|
1475 |Word|C|C|C d|0~~199|
1476 |Word|D|D|D d|0~~7999|
1477 |Word|S|S|S d|0~~99999|
1478 |Word|SD|SD|SD d|8000~~9999|
1479 |Word|R|R|R d|0~~32767|
1480
1481 **3）Configure the communication protocol**
1482
1483 [[image:image-20220831164626-1.png]]
1484
1485
1486
1487 **4）Cable Wiring**
1488
1489 Figure
1490
1491 [[image:image-20220831164646-2.png]][[image:image-20220831164700-3.png]]
1492
1493 Pin Definition Diagram
1494
1495 [[image:image-20220831164731-4.png]]
1496
1497 = Create communication with Panasonic** PLC** =
1498
1499 == **FP serial protocol** ==
1500
1501 **1）V-BOX Settings**
1502
1503 |**Item**|**Settings**|**Note**
1504 |Protocol|Panasonic FP MFWTOCOL|
1505 |Connection|RS232|
1506 |Baud rate|9600|
1507 |Data bit|8|
1508 |Parity|ODD|
1509 |Stop bit|1|
1510 |PLC station No.|1|
1511
1512 **2）Address List**
1513
1514 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1515 |Bit|X|X|X d|0~~9999|
1516 |Bit|Y|Y|Y d|0~~9999|
1517 |Bit|R|R|R d|0~~9999|
1518 |Bit|T|T|T d|0~~9999|
1519 |Bit|C|C|C d|0~~9999|
1520 |Bit|L|L|L d|0~~9999|
1521 |Word|WX|WX|WX d|0~~9999|
1522 |Word|WY|WY|WY d|0~~9999|
1523 |Word|WR|WR|WR d|0~~9999|
1524 |Word|WL|WL|WL d|0~~9999|
1525 |Word|LD|LD|LD d|0~~9999|
1526 |Word|DT|DT|DT d|0~~65535|
1527 |Word|FL|FL|FL d|0~~9999|
1528 |Word|EV|EV|EV d|0~~9999|
1529 |Word|SV|SV|SV d|0~~9999|
1530
1531 **3）Configure the communication protocol**
1532
1533 [[image:image-20220831165238-4.png]]
1534
1535
1536
1537 **4）Cable Wiring**
1538
1539 Figure
1540
1541 [[image:image-20220831165031-3.png]][[image:image-20220831165017-2.png]]
1542
1543 Pin Definition Diagram
1544
1545 [[image:image-20220831165008-1.png]]
1546
1547 = Create communication with LS** PLC** =
1548
1549 == **XBC serial protocol** ==
1550
1551 **1）V-BOX Settings**
1552
1553 |**Item**|**Settings**|**Note**
1554 |Protocol|LS XBC CNet|
1555 |Connection|RS232|
1556 |Baud rate|115200|
1557 |Data bit|8|
1558 |Parity|NONE|
1559 |Stop bit|1|
1560 |PLC station No.|1|
1561
1562 **2）Address List**
1563
1564 |**Type**|**Device registers**|**HMI registers**|**Format**|**Range**|**Note**
1565 |Bit|P|P|P d|0~~2047|
1566 |Bit|M|M|M d|0~~2047|
1567 |Bit|L|L|L d|0~~11263|
1568 |Bit|K|K|K d|0~~16183|
1569 |Bit|F|F|F d|0~~2047|
1570 |Bit|D|D|D d|0~~32767|
1571 |Bit|R|R|R d|0~~32767|
1572 |Bit|U|U|U d|0~~4095|
1573 |Word|P|P|P d|0~~2047|
1574 |Word|M|M|M d|0~~2047|
1575 |Word|L|L|L d|0~~11263|
1576 |Word|K|K|K d|0~~16183|
1577 |Word|F|F|F d|0~~2047|
1578 |Word|C|C|C d|0~~2047|
1579 |Word|T|T|T d|0~~2047|
1580 |Word|D|D|D d|0~~32767|
1581 |Word|N|N|N d|0~~21503|
1582 |Word|R|R|R d|0~~32767|
1583 |Word|U|U|U d|0~~4095|
1584 |Word|Z|Z|Z d|0~~127|
1585 |Word|S|S|S d|0~~127|
1586
1587 **3）Configure the communication protocol**
1588
1589 [[image:image-20220831170147-1.png]]
1590
1591 **4）Cable Wiring**
1592
1593 Figure
1594
1595 [[image:image-20220831170306-4.png]][[image:image-20220831170254-3.png]]
1596
1597 Pin Definition Diagram
1598
1599 [[image:image-20220831170215-2.png]]
1600
1601 == **XGK FEnet Ethernet protocol** ==
1602
1603 Supported Series: LS XGT series XGK CPU with XGL-EFMT Ethernet module
1604
1605 **1）V-BOX Settings**
1606
1607 |**Items**|**Settings**|**Note**
1608 |Protocol|LG XGK FEnet(Ethernet)|
1609 |Connection|Ethernet|
1610 |Port No.|2004|
1611
1612 **2）Address List**
1613
1614 |**Type**|**Register**|**Range**|**Format**|**Note**
1615 |(% rowspan="14" %)Word|P|0~~2047|P d|
1616 |M|0~~2047|M d|
1617 |K|0~~2047|K d|
1618 |F|0~~2047|F d|
1619 |T|0~~2047|T d|
1620 |C|0~~2047|C d|
1621 |Z|0~~127|Z d|
1622 |S|0~~127|S d|
1623 |L|0~~11263|L d|
1624 |N|0~~21503|N d|
1625 |D|0~~32767|D d|
1626 |R|0~~32767|R d|
1627 |ZR|0~~65535|ZR d|
1628 |UxDD|0~~6331|UxDD nndd|nn: 0~~63, dd: 0~~31
1629
1630 **✎Note:**
1631
1632 * In addition to the "UxDD" register, the others correspond to the PLC register one by one. UxDD corresponds to U in the PLC;
1633 * 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;
1634 * All bit registers are in the form of bits in word, and the range is the same as the word register;
1635
1636 **3）Communication Settings**
1637
1638 [[image:image-20220831171127-1.png]]
1639
1640 **4）Cable Wiring**
1641
1642 [[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"]]
1643
1644 = Create communication with **Modbus ** =
1645
1646 == **MODBUS RTU Slave (All function)** ==
1647
1648 Select the protocol "Modbus RTU Slave (All Fuction)",
1649
1650 Then set baud rate, port, stop bits, data bits, parity.
1651
1652 (% style="text-align:center" %)
1653 [[image:1624342015914-382.png||height="486" width="800" class="img-thumbnail"]]
1654
1655 == **MODBUS RTU Master** ==
1656
1657 Select the protocol "Modbus RTU Master",
1658
1659 Then set baud rate, port, stop bits, data bits, parity
1660
1661 (% style="text-align:center" %)
1662 [[image:1624348709622-711.png||queryString="width=809&height=493" height="488" width="800" class="img-thumbnail"]]
1663
1664 **address list**
1665
1666 (% class="table-bordered" %)
1667 |**type**|**register**|**Function code and description**
1668 |(% rowspan="11" %)词|(% rowspan="3" %)3|04 (Read Input Registers: Read the current binary value in one or more input registers)
1669 |06 (write single register: write a binary value to a holding register)
1670 |10 (write values to multiple addresses )
1671 |(% rowspan="3" %)4|03 (read holding register: read current binary value in one or more holding registers)
1672 |06 (write single register: write a binary value to a holding register)
1673 |10 (write values to multiple addresses )
1674 |(% rowspan="3" %)W6|03 (read holding register: read current binary value in one or more holding registers)
1675 |06 (write single register: write a binary value to a holding register)
1676 |10 (write values to multiple addresses )
1677 |(% rowspan="2" %)W16|03 (read holding register: read current binary value in one or more holding registers)
1678 |10 (write values to multiple addresses )
1679 |(% rowspan="11" %)Bit|(% rowspan="3" %)0|01 (Read coil state)
1680 |05 (Force a single coil to force the on/off state of a logic coil)
1681 |0F (Write multiple bits, ie write continuously)
1682 |(% rowspan="3" %)1|02 (Read the input state)
1683 |05 (Force a single coil to force the on/off state of a logic coil)
1684 |0F (Write multiple bits)
1685 |(% rowspan="3" %)W5|01 (Read coil state to obtain the current state of a set of logic coils)
1686 |05 (Force a single coil to force the on/off state of a logic coil)
1687 |0F (Write multiple bits)
1688 |(% rowspan="2" %)W15|01 (Read coil state to obtain the current state of a set of logic coils)
1689 |0F (Write multiple bits)
1690
1691 == **MODBUS TCP Slave (All function)** ==
1692
1693 Supported series: MODBUS TCP controller
1694
1695 V-B0X works as MODBUS TCP MASTER connecting with TCP SLAVE
1696
1697 **1）V-BOX Setting**
1698
1699 |**Items**|**Settings**|**Note**
1700 |Protocol|MODBUS TCP Slave (All function)|
1701 |Connection|Ethernet|
1702 |Port No.|502|
1703 |PLC station No.|1
1704
1705 **2）Address List**
1706
1707 |**Type**|**Register**|**Function code & Description**
1708 |(% rowspan="11" %)Word|(% rowspan="3" %)3|04 (read input register: read current binary value in one or more input registers)
1709 |06 (write single register: write a binary value to a holding register)
1710 |10 (write values to multiple addresses )
1711 |(% rowspan="3" %)4|03 (read holding register: read current binary value in one or more holding registers)
1712 |06 (write single register: write a binary value to a holding register)
1713 |10 (write values to multiple addresses )
1714 |(% rowspan="3" %)W6|03 (read holding register: read current binary value in one or more holding registers)
1715 |06 (write single register: write a binary value to a holding register)
1716 |10 (write values to multiple addresses )
1717 |(% rowspan="2" %)W16|03 (read holding register: read current binary value in one or more holding registers)
1718 |10 (write values to multiple addresses )
1719 |(% rowspan="11" %)Bit|(% rowspan="3" %)0|01 (Read coil state)
1720 |05 (Force a single coil to force the on/off state of a logic coil)
1721 |0F (Write multiple bits, ie write continuously)
1722 |(% rowspan="3" %)1|02 (Read the input state)
1723 |05 (Force a single coil to force the on/off state of a logic coil)
1724 |0F (Write multiple bits)
1725 |(% rowspan="3" %)W5|01 (Read coil state to obtain the current state of a set of logic coils)
1726 |05 (Force a single coil to force the on/off state of a logic coil)
1727 |0F (Write multiple bits)
1728 |(% rowspan="2" %)W15|01 (Read coil state to obtain the current state of a set of logic coils)
1729 |0F (Write multiple bits)
1730
1731 **3）Communication Settings**
1732
1733 Configure V-BOX Ethernet IP in Networking Settings
1734
1735 [[image:image-20220902111833-3.png]]
1736
1737
1738 Configure PLC Ethernet IP in Communication；
1739
1740 [[image:image-20220902111121-1.png]]
1741
1742 **4）Cable Wiring**
1743
1744 [[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"]]
1745
1746 == **communicate with VB inverter** ==
1747
1748 [[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]]
1749
1750 = **User define protocol** =
1751
1752 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]]
1753
1754 == **Read the temperature sensor.** ==
1755
1756 the commond format is as beliow:
1757
1758 Send commond:01 03 02 00 00 03 04 73
1759
1760 Feedback commond:01 03 06 07 F7 0E 7E B7 35
1761
1762 Temperature data:07 F7,desimal = 2039,it means temperature is 20.39℃.
1763
1764 Humidity data:0E 7E,desimal = 3710, it mean humidity is 37.10%RH.
1765
1766 Script Demo:
1767
1768 ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--
1769
1770 function com.main()
1771 ~-~-dosomething
1772 openPlc()
1773 end
1774 function openPlc()
1775 if obj then
1776 ~-~- If the serial port opened,then read/write data by timing
1777
1778 local wri = string.pack(">HHHH",0X0103,0X0200,0X0003,0X0473)
1779 local arr = reading(wri)
1780 ~-~- if arr ~~=nil then
1781 ~-~- if arr[1] ==33 and arr[2] ==v[2][2] and arr[3] ==v[2][3] then
1782 ~-~- local A = arr[4]*256
1783 ~-~- local B = A+arr[5]
1784 ~-~- addr_setword(v[1],B)
1785 ~-~- end
1786 ~-~- end
1787
1788 else
1789 ~-~-judge if there is a serial object, then initialize and open the serial port
1790 local configs = {
1791 name = 'COM1', ~-~-Select serial port COM1
1792 mode = 485, ~-~-Communication mode RS485
1793 baud_rate = 9600, ~-~-Baud rate 9600
1794 stop_bit = 1, ~-~-stop bit 1
1795 data_len = 8, ~-~-data length 8
1796 check_bit = 'NONE', ~-~-no parity
1797
1798 }
1799 obj,err = serial.open(configs) ~-~-Open serial port
1800 if not obj then
1801 print("serial open :failed", err) ~-~- Open serial port failed
1802 end
1803 end
1804 end
1805
1806 function reading(wri)
1807 obj:flush() ~-~- Clear serial port
1808 obj:write(wri) ~-~- Write serial port
1809 print(string.byte(wri,1,#wri))
1810 obj:flush() ~-~- Clear serial port 
1811 local readed =obj:read(9,1000) ~-~- Read 9 bytes, timeout 1 second
1812 if readed and readed ~~= "" then 
1813 ~-~- judge that a non-empty string is read
1814 print(string.byte(readed,1,#readed))
1815 a={string.byte(readed, 1, #readed)}
1816 if nil ~~= a[4] and nil ~~= a[5] and nil ~~= a[6] and nil ~~= a[7] then
1817 a1=a[4]*256+a[5]
1818 a2=a[6]*256+a[7]
1819 addr_setword("@HDW0",a1)
1820 addr_setword("@HDW1",a2)
1821 end
1822 return {string.byte(readed, 1, #readed)}
1823 elseif readed == nil then
1824 print("serial read err:", err or "")
1825 return nil
1826 end
1827 return nil
1828 end
1829
1830 ~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-