Skip to Content

Wiki source code of 10 Advanced Function

Version 2.1 by Leo Wei on 2022/07/29 15:02
Show last authors
1 (% class="wikigeneratedid" %)
2 This chapter provides information about advanced functions in PIStudio. **These advanced functions work only on special HMI models.**
3
4 = **Audio** =
5
6 1. Audio playing could play audio on HMI. You need to configure the relevant information, triggered by the condition, broadcast the set the mp3 audio file. The audio file can only be stored in the flash mp3 file.
7 1. Only the 9000 Series HMIs with audio modules can use this feature, and an external 3.5mm headphone head is required.
8
9 == **Configuration** ==
10
11 In PIStudio software, the setting procedue is as follow.
12
13 (% style="text-align:center" %)
14 [[image:音频 1.png||class="img-thumbnail" height="655" width="528"]]
15
16 **(1) Click "Set" to open "Audio settings" window.**
17
18 (% style="text-align:center" %)
19 [[image:11.Advanced Function_html_949272a66c003cd.png||class="img-thumbnail" height="402" width="588"]]
20
21 * Audio list: Display the audio files you added. Double click the audio to configure it.
22 * Add: Add a new audio file.
23 * Delete: Delete selected audio file.
24 * Audio set: Set the configurations of the audio, contolled by address.
25
26 **(2) Trigger configuration for audio files**
27
28 (% style="text-align:center" %)
29 [[image:音频 2.png||class="img-thumbnail"]]
30
31 **1) Audio files**
32
33 * MP3 file supported only.
34 * The audio filesize should be less than 30MB.
35 * The suffix .mp3 is necessary. The length of name should be less than 20 (including .mp3).
36 * Audio file needs to be saved into the folder named mp3 in HMI flash, if not, it would not play. User could use the ~[[[CopyFile>>path:#_CopyFile]]] script function to import audio files into the HMI flash.
37
38 **2) Trigger mode settings**
39
40 There are 3 kinds trigger mode to choose. They coulf be valid at the same time.
41
42 * **Play according to time interval: **Set the interval time. For example ,set 3 minutes, then it will play for each 3 minutes' interval.
43 * **Trigger to play: **There are three bit trigger conditions: Rising edge, Falling edge and Bit change. You could trigger one condition to play the audio file.
44 * **Play according to time: **Play the audio when the time is up.
45
46 **3) Play settings.** Set the play times and the cycle interval when it is triggered.
47
48 **(3) Audio file playback setting**
49
50 This function is to control the playback of audio file in the list by address. (It should be used with file list.)
51
52 (% style="text-align:center" %)
53 [[image:音频 3.png||class="img-thumbnail" height="429" width="620"]]
54
55 == **Control address** ==
56
57 The table below describes each bit address function (including play, pause, etc). If the audio control address is HDW120, then specific function details are as shown in the table below.
58
59 (% class="table-bordered" %)
60 |=**Function**|=(% style="width: 177px;" %)**Address**|=(% style="width: 647px;" %)**Description**
61 |(% rowspan="7" %)Play Control|(% style="width:177px" %)HDX120.0 (0(% style="font-size:10.5px" %)th(%%) bit)|(% style="width:647px" %)Play control bit: Play the audio file when this bit address is triggered
62 |(% style="width:177px" %)HDX120.1 (1(% style="font-size:10.5px" %)st(%%) bit)|(% style="width:647px" %)Pause control bit: Pause playback when this bit address is triggered, or resume playback after pause
63 |(% style="width:177px" %)HDX120.2 (2(% style="font-size:10.5px" %)nd(%%) bit)|(% style="width:647px" %)Stop control bit: Stop the play when this bit address is triggered
64 |(% style="width:177px" %)HDX120.3 (3(% style="font-size:10.5px" %)rd(%%) bit)|(% style="width:647px" %)Last audio: Play last audio when this bit address is triggered.
65 |(% style="width:177px" %)HDX120.4 (4(% style="font-size:10.5px" %)th(%%) bit)|(% style="width:647px" %)Next audio: Play next audio when this bit address is triggered.
66 |(% style="width:177px" %)HDX120.5 (5(% style="font-size:10.5px" %)th(%%) bit)|(% style="width:647px" %)Volume increase(not supported yet), increase by 10
67 |(% style="width:177px" %)HDX120.6 (6(% style="font-size:10.5px" %)th(%%) bit)|(% style="width:647px" %)Volume decrease(not supported yet), decrease by 10
68 |(% rowspan="4" %)Mode Selection|(% style="width:177px" %)HDX120.7 (7(% style="font-size:10.5px" %)th(%%) bit)|(% style="width:647px" %)once: Only play current audio file only one time
69 |(% style="width:177px" %)HDX120.8 (8(% style="font-size:10.5px" %)th(%%) bit)|(% style="width:647px" %)Single cycle: Repeat playing current audio file
70 |(% style="width:177px" %)HDX120.9 (9(% style="font-size:10.5px" %)th(%%) bit)|(% style="width:647px" %)Order: Play audio file orderly and stop as soon as the tas finished
71 |(% style="width:177px" %)HDX120.10 (10(% style="font-size:10.5px" %)th(%%) bit)|(% style="width:647px" %)Repeat in order: Repeat to play the audio file of the list
72
73 == **State address** ==
74
75 The audio play status address occupies a continuous 35 word addresses. If audio play status address is set as HDW200, the specific function allocation details are shown as below table
76
77 (% class="table-bordered" %)
78 |=(% style="width: 183px;" %)**Address**|=(% style="width: 314px;" %)**Function**|=(% style="width: 592px;" %)**Description**
79 |(% style="width:183px" %)HDW200|(% style="width:314px" %)Playback status storage address|(% style="width:592px" %)(((
80 ~=0 : stop play
81
82 ~=1 : playing
83
84 ~=2 : pause play
85 )))
86 |(% style="width:183px" %)HDW201|(% style="width:314px" %)Volume value storage address|(% style="width:592px" %)Range from 0 to 100(default value is 100, and it is not adjustable so fars
87 |(% style="width:183px" %)HDW202~~HDW234|(% style="width:314px" %)Audio file name|(% style="width:592px" %)Displays the file name of the audio currently playing
88
89 ✎**Note:**
90
91 * The audio file needs to be stored in the flash of PI9000 series HMI.
92 * Only PI9000 series HMI with audio module could support this function, and an external 3.5mm headphone is required.
93
94 = **Video** =
95
96 **Introduction**
97
98 1. Configure related information and play video files through conditional trigger.
99 1. Only HMI  9000 series support this function.
100 1. Video playing could play video on HMI project screen.
101 1. It requires "Customized Object" and "File List" objects.
102 1. Currently, the video format support by Wecon HMI are including ASF, AVI, MKV, MP4, RM, and FLV.
103
104 == **Configuration** ==
105
106 **(1) Custom object configuration**
107
108 (% style="text-align:center" %)
109 [[image:11.Advanced Function_html_4939953650efc334.png||class="img-thumbnail" height="499" width="415"]]
110
111 **1) Basic**
112
113 The function address doesn't have to be configured. DLL file name needs to be "Custom_MoviePlayer".
114
115 **2) Custom Address**
116
117 * ID1 is the address for storing the video file name (including the suffix). It could not be empty and the length is 32 words.
118 * ID2 is the address for video control, and occupies 1 word. It could not be empty. Please refer to[[ "Video control address">>http://docs.we-con.com.cn/wiki/pistudio/view/Helps/11.Advanced%20Function/#HControladdress-1]].
119 * ID3 is the address of video status, and occupies 1 word. It could not be empty. 0 indicate stop, and 1 indicates play.
120 * ID4 is the address for stroring the valume of video file, and occupies 1 word.
121 * ID5 is the address for the video file path, and occupies 1 word. It could not be empty. Please refer to [["Video file path">>http://docs.we-con.com.cn/wiki/pistudio/view/Helps/11.Advanced%20Function/#HFilepath]].
122
123 == **Control address** ==
124
125 (% class="table-bordered" %)
126 |=(% style="width: 151px;" %)**Function**|=(% colspan="2" style="width: 200px;" %)**Address**|=(% style="width: 599px;" %)**Description**
127 |(% rowspan="7" style="width:151px" %)Play Control|(% style="width:92px" %)0(% style="font-size:10.5px" %)th(%%) bit|(% style="width:107px" %)HDX102.0|(% style="width:599px" %)(((
128 Bit for playing control: Play the video file when this bit address is triggered
129 )))
130 |(% style="width:92px" %)1(% style="font-size:10.5px" %)st(%%) bit|(% style="width:107px" %)HDX102.1|(% style="width:599px" %)Bit for pause control:Pause playing when this bit address is triggered, or resume playing after pause
131 |(% style="width:92px" %)2(% style="font-size:10.5px" %)nd(%%) bit|(% style="width:107px" %)HDX102.2|(% style="width:599px" %)Bit for full screen control: Maximize the video when this bit address is triggered
132 |(% style="width:92px" %)3(% style="font-size:10.5px" %)rd(%%) bit|(% style="width:107px" %)HDX102.3|(% style="width:599px" %)Last video: Play the last video when this bit address is triggered.
133 |(% style="width:92px" %)4(% style="font-size:10.5px" %)th(%%) bit|(% style="width:107px" %)HDX102.4|(% style="width:599px" %)Next video: Play the next video when this bit address is triggered.
134 |(% style="width:92px" %)5(% style="font-size:10.5px" %)th(%%) bit|(% style="width:107px" %)HDX102.5|(% style="width:599px" %)Volume increase: Increased by 10
135 |(% style="width:92px" %)6(% style="font-size:10.5px" %)th(%%) bit|(% style="width:107px" %)HDX102.6|(% style="width:599px" %)Volume decrease: Decreased by 10
136 |(% rowspan="4" style="width:151px" %)Mode Selection|(% style="width:92px" %)7(% style="font-size:10.5px" %)th(%%) bit|(% style="width:107px" %)HDX102.7|(% style="width:599px" %)Once: Only play current video file once
137 |(% style="width:92px" %)8(% style="font-size:10.5px" %)th(%%) bit|(% style="width:107px" %)HDX102.8|(% style="width:599px" %)Single cycle: Repeat to play current video file
138 |(% style="width:92px" %)9(% style="font-size:10.5px" %)th(%%) bit|(% style="width:107px" %)HDX102.9|(% style="width:599px" %)Order: Play video file of the list and stop after done
139 |(% style="width:92px" %)10(% style="font-size:10.5px" %)th(%%) bit|(% style="width:107px" %)HDX102.10|(% style="width:599px" %)Repeat in order: Repeat to play the video file of the list
140
141 == (% style="color:inherit; font-family:inherit; font-size:23px" %)**File path**(%%) ==
142
143 (% class="table-bordered" %)
144 |=**Value**|=**Video File Path**|=**Description**
145 |0|USB flash disk|Please create a folder named mp4 in the U disk directory to store the video files to be played
146 |1|SD card|Please create a folder named mp4 in the SD card directory to store the video files to be played
147 |2|HMI flash|Copy the video files to the mp4 folder in the directory of flash
148
149 == **Case** ==
150
151 **Operating Procedures of File List Object Settings**
152
153 (% style="text-align:center" %)
154 [[image:11.Advanced Function_html_21e02c4465831a9e.png||class="img-thumbnail" height="560" width="600"]]
155
156 Configure the customized object as the above picture
157
158 Configure the file list object as below:
159
160 1. Select the directory as the MP4 folder in USB flash disk. Set the file name address as HDW150
161 1. Create a folder named MP4 in the SD card directory to store the video files to be played.
162 1. Add the video controlling address, refer to the above video controlling address table.
163 1. Compile the project and download it to HMI, trigger the bit address to play the video from the list.
164
165 = **Email** =
166
167 **Introduction**
168
169 Wecon HMI can send email with information from fields to the specified email address as soon as the conditions is triggered, but email sending is based on the network.
170
171 == **Email setting** ==
172
173 In "PIStudio" software, click "Project"-> "E-mail" to open email function setting screen.
174
175 (% style="text-align:center" %)
176 [[image:邮件 1.png||class="img-thumbnail" height="780" width="597"]]
177
178 (**1) SMTP Settings**
179
180 **1) Sender Name: **Fill the sender's name, which is composed of Chinese characters, letters (case sensitive) and numbers. But it can not contain the following special English symbols:  ',', ';', '"', '<'. Maximum character length 32 is allowed.
181
182 **2) Password:** Fill in the password or authorization code of the mailbox. If the server needs to set the authorization code, the authorization code needs to be used. If the authorization code is not used, the password is used. Please refer to the SMTP service in the mailbox for the authorization code information. It cases sensitive, maximum character length 32 allowed in password.
183
184 **3) Confirm Password: **Confirm the password or authorization code of the mailbox.
185
186 **4) Email Address: **Fill in the sender's email address, case sensitive, maximum character length 32 allowed in it.Such as [[support@we-con.com.cn>>path:mailto:support@we-con.com.cn]].
187
188 **5) SMTP Server: **Please refer to the mailbox account settings. If you enter a common mailbox, the corresponding server address will be automatically written. such as smtp.exmail.qq.com.
189
190 (% class="table-bordered" %)
191 |=Email|=Email server|=Port number
192 |163 email|smtp.163.com|465
193 |126 email|smtp.126.com|465
194 |QQ email|smtp.qq.com|465
195 |Sina email|smtp.sina.com|465
196 |Sohu email|smtp.sohu.com|465
197 |Yahoo email|smtp.mail.yahoo.com.cn|465
198 |Google email|smtp.gmail.com|465
199
200 **✎Note:**
201
202 Gmail also needs to enable the [allow unsafe apps] option in the account, otherwise the mail will not be sent normally.
203
204 **6) Encryption Type: **SSL is a security protocol that provides security and data integrity for network communications. It encrypts network connections at the transport layer; TLS (STARTTLS) upgrades connections to SSL instead of using a separate encrypted communication port.
205
206 **7) The Port Number: **Enter corresponding port number according to the SMTP serve addrress entered. You could only enter interger between 1 and 65535. Do not enter more than 6 digits in length. Common port numbers are port 25, 465 and 587.
207
208 (% style="list-style-type:disc" %)
209 * Port 25: It does not protect the original data when transmitting data. The data can be seen. Generally, port 25 must be selected as no encryption or TLS(STARTTLS) encryption mode to send data correctly.
210 * Port 465: It protect the original data when transmitting data. The data can not be seen. Generally, port 465 must be selected as SSL encryption mode to send data correctly.
211 * Port 587: The original data is protected only after the TLS(STARTTLS) command is executed. Generally, port 587 must be selected as TLS(STARTTLS) encryption mode to send data correctly.
212
213 **✎Note: **Port 25 is open to SMTP servers, mainly for sending mail. But the port has vulnerability. Hackers often use port 25 to find SMTP servers to forward spam.
214
215 **8) Error Message**
216
217 Set the error message receiving address, you could use the information to get the reasons of errors.
218
219 The error types in the mail function are divided into two types: custom rule error and server's error.
220
221 Custom rule errors are as follows.
222
223 (% class="table-bordered" %)
224 |**Message**
225 |Email settings are incorrect
226 |Email account is incorrect
227 |Email password could not include blank
228 |the settings of SMTP server are incorrect
229 |The range of SMTP server ports number should be integer, which is between 1 and 65535.
230 |The type of encryption for SMTP is incorrect
231 |The name of sender or email address setting is incorrect.
232 |The names of Recipients or email address setting are incorrect.
233 |The names of CC recipients or email address setting are incorrect.
234 |The names of Secret delivery recipients or email address setting are incorrect.
235 |Email topic could not be blank
236 |Email content could not be blank
237 |Total size of attachments should be below 25M
238 |Attachment "xxxx" is nonexistent
239
240 Server's errors are as follows.
241
242 (% class="table-bordered" %)
243 |**Message**
244 |smtp-server: 554 DT: SPM
245 |smtp-server: 550 RP: TRC
246 |smtp-server: 550 Limitation of connecting counts
247 |smtp-server: 535
248 |smtp-server: 550 Error: Content rejected
249 |smtp-server: 451 Internal server error
250 |smtp-server: 535 Invalid login user or password
251 |smtp-server: 550 too many sending requests today
252 |smtp-server: 452 Too many recipients received this hour.
253 |smtp-server: 535 Error: Authentication failed, system busy
254 |could not connect: Connection timed out
255 |Unexpected EOF on SMTP connection
256 |could not initiate SSL/TLS connection
257 |smtp-server: 530 Need to issue a STARTTLS command first.
258 |could not resolve host
259 |could not connect: Connection timed out
260 |could not connect: Connection refused
261 |smtp-server: 550 User not found: aaa.163.com
262
263 **9) Manual Trigger**
264
265 It is for modifying the email sending settings when HMI is running. According to the set manual trigger address, the address is offset backward to get the address of the corresponding function (a total of 201 words). Take HDW100 as an example.
266
267 (% class="table-bordered" %)
268 |(% style="width:201px" %)**Address**|(% style="width:586px" %)**Description**
269 |(% style="width:201px" %)HDX100.0|(% style="width:586px" %)Sending trigger
270 |(% style="width:201px" %)HDX101.0 to HDX101.15|(% style="width:586px" %)It is used for triggering recipient groups, for example, HDW101.0 set ON, and the address in group 1 will be in recipient list.
271 |(% style="width:201px" %)HDX103.0 to HDX103.15|(% style="width:586px" %)It is used for triggering recipient groups, for example, HDW103.0 set ON, and the address in group 1 will be in CC list.
272 |(% style="width:201px" %)HDX105.0 to HDX105.15|(% style="width:586px" %)It is used for triggering recipient groups, for example, HDW105.0 set ON, and the address in group 1 will be in BCC list (Secret delivery).
273 |(% style="width:201px" %)HDW107 to HDW171|(% style="width:586px" %)The subject length is limited to 64 words. (If it exceeds, it will intercept 64 words of content)
274 |(% style="width:201px" %)HDW172 to HDW300|(% style="width:586px" %)The content length is limited to 128 words. (If it exceeds, it will intercept 128 words of content)
275 |(% style="width:201px" %)HDX301.0|(% style="width:586px" %)Whether to send an alarm record attachment (a file named AlarmDataFile.db)
276
277 1. Emails that sent manually are not queued. Emails trigger by bit change, rising edge, falling edge and timing need to be sent in the sequence of triggering. The maximum value is 100, and those who are added after it is exceeded will be discarded. If an email is sending, it would send immediately after the current email is sent. If there is no email sending, it would send immediately.
278 1. If the trigger condition sent manually is the rising edge trigger, before the mail is sent, no new mail will be sent even if it is triggered again. No matter the email is sent successfully or not, the corresponding trigger would be OFF.
279 1. Emails that sent manually would only be sent once no matter the sending error is custom error, network or other errors.
280
281 == **Email sending settings** ==
282
283 (% style="text-align:center" %)
284 [[image:邮件 2.png||class="img-thumbnail"]]
285
286 1. **Add. **A maximum of 1024 email can be added.
287 1. **Modify.** Select an email to modify the content and configuration.
288 1. **Delete. **You could select an email to delete or click the "ID" column to delete in batch.
289
290 (% style="text-align:center" %)
291 [[image:邮件 3.png||class="img-thumbnail" height="578" width="744"]]
292
293 **(1) Email sending configuration.**
294
295 **1) Theme. **The value cannot be empty and case sensitive. The total length  cannot exceed 256 characters.
296
297 **2) Content of email. **The contents are divided into three combinations: text, alarm and variable. The list can contain only 32 items at most, and the total length of the preview cannot exceed 1024 items.
298
299 * **Text. **You could directly edit the text of language 1 to language 3. If you need to set multiple languages, click "edit all text" to set. You may also select "Text library". The content is case sensitive, and the total length of English/Chinese characters/numbers/symbols does not exceed 253.
300 * **Alarm. **You could select "bit alarm" or "word alarm" from the list. The content is from alarm text. if the alarm changes, the content changes with it. The content is case sensitive, and the total length of English/Chinese characters/numbers/symbols does not exceed 253.
301 * **Variable. **Set the corresponding variable address. Read value or strings according to the specified format, and the read information will be displayed in the corresponding position in the mail content.
302
303 **3) Preview. **Combine the content of current edited email and diaplay it for you to modify the content conviniently. The preview length cannot exceed 1024.
304
305 **4) Sending method. **It is divided into timed send interval and bit address trigger tranmission. The two methods cannot be used at the same time.
306
307 * timed send interval. After booting, the current system time is used to start calculating, and each time the time  is up, the information will be sent to the set recipient in the form of an email, and the minimum time should be set to 5 minutes. **Note: **The first boot is not sent.
308 * Bit address trigger tranmission. When the set trigger address meets the trigger conditon, the information will be sent to the set recipient in the form of an email. If the content select alarm, the alarm address would be written in the trigger address. There are three methods to trigger: sending on rising edge, sending on falling edge and send when the bit changes.
309
310 **5) Recipient.** It is set in groups. You could send  multiple groups, and each group can have multiple recipients.
311
312 **6) Add CC.** Sends the current email to other recipients.
313
314 **7) Add secret delivery. ** Sends the current email to other recipients, but the recipient and cc recipients do not see the BCC recipient.
315
316 when sending an email, you must set a recipient. CC recipients and BCC recipients are not to be set. The total number of recipinet, CC recipients and BCC recipients is 40.
317
318 **8) Recipient priority. **Set the priority order of recipients to recipient, BCC, and CC.
319
320 **✎Note: **If the recipient address you select exists in all three positions, it exist only in the highest priority position. For example, if the recipient of an email has aaa, the bcc has aaa, and the cc has aaa, then let aaa only be the recipient.
321
322 == **Recipient group setting** ==
323
324 (% style="text-align:center" %)
325 [[image:邮件 4.png||class="img-thumbnail"]]
326
327 1. **All Group.** The groups you added.
328 1. **Group to send. **The groups that you send the emails to.
329 1. **Open recipinet settings.** Set the information of recipients, and add and subtract groups.
330
331 == **Recipient setting** ==
332
333 (% style="text-align:center" %)
334 [[image:邮件 5.png||class="img-thumbnail"]]
335
336 1. **Add. **Add a recipient. There are non-dynamic recipient and dynamic recipient. They cannot be used at the same time. You may just fill in the  recipient's name and email address. The dynamic recipient address  is limited to 32 characters, and a maximum of 40 recipients can be added.
337
338 (% style="text-align:center" %)
339 [[image:邮件 6.png||class="img-thumbnail"]]
340
341 (% start="2" style="list-style-type:decimal" %)
342 1. **Modify. **Select one recipient and click "modify" or double click the recipient to modify. If it is non-dynamic recipient, you could modify the name and email address. The email is unique. If it is dynamic recipient, you could modify the address, and the address is unique.
343 1. **Delete.** Select one recipient or multiple recipents to delete, or click the ID column to select all.
344 1. **Nuber of group. **You could click the  up/down arrow to increase or devrease groups. The default number is 1. The maximum number is 16.
345 1. **Description. **To decribe the group information. The total length shall not exceed 32.
346
347 == **Test sending settings** ==
348
349 (% style="text-align:center" %)
350 [[image:邮件 7.png||class="img-thumbnail"]]
351
352 (% class="wikigeneratedid" %)
353 **✎Note: **
354
355 1. You can open this after the SMTP server is set.
356 1. When NetEase mail (126, 163 and yeah) occurs erros 554, it may be that the mailbox used is restricted by the anti-spam mechanism, and the performance may be that it cannot send emails in bulk or directly.
357 1. When TOM mail is sender's mail, the name of it and the recipient tested must be English, otherwise the email would be returned.
358 1. When testing with Zoho mailbox, there was a delay of less than 3 minutes.
359 1. The custom errors for the test error is as follows.
360
361 (% class="table-bordered" %)
362 |=(% style="width: 129px;" %)Error code|=(% style="width: 946px;" %)Cause of reason
363 |(% style="width:129px" %)0|(% style="width:946px" %)CSMTP_NO_ERROR
364 |(% style="width:129px" %)100|(% style="width:946px" %)WSA_STARTUP = Unable to initialize winsock2
365 |(% style="width:129px" %)101|(% style="width:946px" %)WSA_VER = Wrong version of the winsock2
366 |(% style="width:129px" %)102|(% style="width:946px" %)WSA_SEND = Function send() failed
367 |(% style="width:129px" %)103|(% style="width:946px" %)WSA_RECV = Function recv() failed
368 |(% style="width:129px" %)104|(% style="width:946px" %)WSA_CONNECT = Function connect failed
369 |(% style="width:129px" %)105|(% style="width:946px" %)WSA_GETHOSTBY_NAME_ADDR = Unable to determine remote server
370 |(% style="width:129px" %)106|(% style="width:946px" %)WSA_INVALID_SOCKET = Invalid winsock2 socket
371 |(% style="width:129px" %)107|(% style="width:946px" %)WSA_HOSTNAME = Function hostname() failed
372 |(% style="width:129px" %)108|(% style="width:946px" %)WSA_IOCTLSOCKET = Function ioctlsocket() failed
373 |(% style="width:129px" %)109|(% style="width:946px" %)WSA_SELECT
374 |(% style="width:129px" %)110|(% style="width:946px" %)BAD_IPV4_ADDR = Improper IPv4 address
375 |(% style="width:129px" %)200|(% style="width:946px" %)UNDEF_MSG_HEADER = Undefined message header
376 |(% style="width:129px" %)201|(% style="width:946px" %)UNDEF_MAIL_FROM = Undefined mail sender
377 |(% style="width:129px" %)202|(% style="width:946px" %)UNDEF_SUBJECT = Undefined message subject
378 |(% style="width:129px" %)203|(% style="width:946px" %)UNDEF_RECIPIENTS = Undefined recipient
379 |(% style="width:129px" %)204|(% style="width:946px" %)UNDEF_RECIPIENT_MAIL = Undefined mail recipent
380 |(% style="width:129px" %)205|(% style="width:946px" %)UNDEF_LOGIN = Undefined user login
381 |(% style="width:129px" %)206|(% style="width:946px" %)UNDEF_PASSWORD = Undefined user password
382 |(% style="width:129px" %)207|(% style="width:946px" %)BAD_LOGIN_PASSWORD = Invalid user login or password
383 |(% style="width:129px" %)208|(% style="width:946px" %)BAD_DIGEST_RESPONSE = Server returned a bad digest MD5 response
384 |(% style="width:129px" %)209|(% style="width:946px" %)BAD_SERVER_NAME = Unable to determine server name for digest MD5 response
385 |(% style="width:129px" %)300|(% style="width:946px" %)COMMAND_MAIL_FROM = Server returned error after sending MAIL FROM
386 |(% style="width:129px" %)301|(% style="width:946px" %)COMMAND_EHLO = Server returned error after sending EHLO
387 |(% style="width:129px" %)302|(% style="width:946px" %)COMMAND_AUTH_PLAIN = Server returned error after sending AUTH PLAIN
388 |(% style="width:129px" %)303|(% style="width:946px" %)COMMAND_AUTH_LOGIN = Server returned error after sending AUTH LOGIN
389 |(% style="width:129px" %)304|(% style="width:946px" %)COMMAND_AUTH_CRAMMD5 = Server returned error after sending AUTH CRAM-MD5
390 |(% style="width:129px" %)305|(% style="width:946px" %)COMMAND_AUTH_DIGESTMD5 = Server returned error after sending AUTH DIGEST-MD5
391 |(% style="width:129px" %)306|(% style="width:946px" %)COMMAND_DIGESTMD5 = Server returned error after sending MD5 DIGEST
392 |(% style="width:129px" %)307|(% style="width:946px" %)COMMAND_DATA = Server returned error after sending DATA
393 |(% style="width:129px" %)308|(% style="width:946px" %)COMMAND_QUIT = Server returned error after sending QUIT
394 |(% style="width:129px" %)309|(% style="width:946px" %)COMMAND_RCPT_TO = Server returned error after sending RCPT TO
395 |(% style="width:129px" %)310|(% style="width:946px" %)MSG_BODY_ERROR = Error in message body (邮件正文中出现错误)
396 |(% style="width:129px" %)400|(% style="width:946px" %)CONNECTION_CLOSED = Server has closed the connection
397 |(% style="width:129px" %)401|(% style="width:946px" %)SERVER_NOT_READY = Server is not ready
398 |(% style="width:129px" %)402|(% style="width:946px" %)SERVER_NOT_RESPONDING = Server not responding
399 |(% style="width:129px" %)403|(% style="width:946px" %)SELECT_TIMEOUT
400 |(% style="width:129px" %)404|(% style="width:946px" %)FILE_NOT_EXIST = File not exist
401 |(% style="width:129px" %)405|(% style="width:946px" %)MSG_TOO_BIG = Message is too big
402 |(% style="width:129px" %)406|(% style="width:946px" %)BAD_LOGIN_PASS = Bad login or password
403 |(% style="width:129px" %)407|(% style="width:946px" %)UNDEF_XYZ_RESPONSE = Undefined xyz SMTP response
404 |(% style="width:129px" %)408|(% style="width:946px" %)LACK_OF_MEMORY = Lack of memory
405 |(% style="width:129px" %)409|(% style="width:946px" %)TIME_ERROR = time() error
406 |(% style="width:129px" %)410|(% style="width:946px" %)RECVBUF_IS_EMPTY = RecvBuf is empty
407 |(% style="width:129px" %)411|(% style="width:946px" %)SENDBUF_IS_EMPTY = SendBuf is empty
408 |(% style="width:129px" %)412|(% style="width:946px" %)OUT_OF_MSG_RANGE = Specified line number is out of message size
409 |(% style="width:129px" %)413|(% style="width:946px" %)COMMAND_EHLO_STARTTLS = Server returned error after sending STARTTLS
410 |(% style="width:129px" %)414|(% style="width:946px" %)SSL_PROBLEM = SSL problem
411 |(% style="width:129px" %)415|(% style="width:946px" %)SSL_PROBLEM = SSL problem
412 |(% style="width:129px" %)416|(% style="width:946px" %)STARTTLS_NOT_SUPPORTED = The STARTTLS command is not supported by the server
413 |(% style="width:129px" %)417|(% style="width:946px" %)LOGIN_NOT_SUPPORTED = AUTH LOGIN is not supported by the server
414
415 == **Email status** ==
416
417 **(1) Network disconnection error**
418
419 If the fault is determined as a network disconnection error, the system does not delete the sent information and does not record the number of errors, and it would make an infinite send attempt.
420
421 **(2) Custom rule error**
422
423 If the fault is determined as a custom rule error, delete the information.
424
425 **(3) Server return error**
426
427 If the fault is determined as a server return error, then the error time add 1. It would try to send the email for 3 times. Regardless of whether the transmission is successful or not, it would delete the email to be sent. The test results are as follows.
428
429 (% class="table-bordered" %)
430 |=(% style="width: 125px;" %)**Server name**|=(% style="width: 186px;" %)**The number of sent**|=(% style="width: 765px;" %)**Consequences of exceeding the limit**
431 |(% style="width:125px" %)126|(% style="width:186px" %)160|(% style="width:765px" %)No more delivery on that day
432 |(% style="width:125px" %)163|(% style="width:186px" %)160|(% style="width:765px" %)No more delivery on that day
433 |(% style="width:125px" %)we-con|(% style="width:186px" %)800|(% style="width:765px" %)No more delivery on that day
434 |(% style="width:125px" %)qq|(% style="width:186px" %)50|(% style="width:765px" %)It can be sent again after a few minutes or a few hours
435 |(% style="width:125px" %)sohu|(% style="width:186px" %)160|(% style="width:765px" %)No more delivery on that day
436 |(% style="width:125px" %)sina|(% style="width:186px" %)50|(% style="width:765px" %)It can be sent again after a few minutes or a few hours, but cannont be received normally
437 |(% style="width:125px" %)gmail|(% style="width:186px" %)500|(% style="width:765px" %)No more delivery on that day
438
439 **(4) Message Prompt**
440
441 1. If the email to be sent is deleted, a message will pop up.
442 1. If the email is sent successfully, a messge will pop up: "The email is sent successfully."
443 1. If the five symbols ',' , ' | ', '<', '>' and '&' appear in the fields set by the message prompt, the message prompt will display an abnormal message.
444
445 **(5) Mail attachment**
446
447 Currently, the email attachment function only supports sending the specified alarm record (AlarmDataFile.db file), and does not support selecting content to send.
448
449 = **USB keyboard** =
450
451 (% class="wikigeneratedid" id="HIntroduction" %)
452 **Introduction**
453
454 1. HMI support keyboard via USB port of HMI.
455 1. When the keyboard function is enabled, the "Cursor Display" function is enabled by default. The user could move the cursor through the "up, down, left and right buttons" of the keyboard, and then press the Enter key to select the object.
456 1. Multiple devices could be connected with HMI via USB HUB (up to 4 external devices), such as: mouse, keyboard, scanner, magnetic stripe reader, etc.
457
458 == **Enable function** ==
459
460 In the software PIStudio, Click "Project" -> "Project settings"-> "Extend", and check "Enable keyboard" in "Input device" settings area as below.
461
462 (% style="text-align:center" %)
463 [[image:11.Advanced Function_html_f6cded728eedf4ce.png||class="img-thumbnail" height="567" width="501"]]
464
465 == **Configuration decription** ==
466
467 1. When the keyboard function is enabled, the "Cursor Display" function is enabled by default. The user could move the cursor through the “up, down, left and right buttons” of the keyboard, and then press the Enter key to select the object;
468 1. NumLock: When NumLock key is not lit, the keypad number is not allowed to be input (offline simulation does not allow all numeric keys to be input, including the numeric keys on the left side of the keyboard);
469 1. Key combination: (1) "Shift" + the left side of the keyboard and the special symbol button, to achieve special character input, such as: ~~ ! @ # $ % ^ & * ( ) _ + { } : "<> ? ;
470 1. Use the system special addresses "HSW1073 and HSW1074" to write custom key combinations in the script (currently only two key combinations are supported);
471 1. Caps Lock: In lowercase mode, shift+ letters, to enter uppercase; in uppercase mode, shift+ letters enter lowercase;
472
473 == **System special address** ==
474
475 In practical application, the [Enable Keyboard] function could be combined with the related "system special address" to achieve multi-key combination operation.
476
477 (% class="table-bordered" %)
478 |=**Address**|=**Description**|=**Function**
479 |HSW1073|Keyboard key value|(((
480 The currently pressed key value is displayed. The key value is shown in Table 1
481
482 (The Numeric/Character display object is not updated when it is being entered)
483 )))
484 |HSW1074|Keyboard key status|(((
485 Display current key states
486
487 ~=0: key release
488
489 ~=1: key press
490
491 ~=2: Press and hold long
492
493 (The Numeric/Character display object is not updated when it is being entered)
494 )))
495 |HSW1075|Cursor speed|Control the movement speed of the cursor, the range is 0~~100, the default is 20
496 |HSW1076|X coordinate value of cursor|The X value of the current position of the cursor, range: 0~~screen width-1
497 |HSW1077|Y coordinate value of cursor|The Y value of the current position of the cursor, range: 0~~screen height-1
498 |HSW1078|The ASCII code of keyboard key|(((
499 Only the ASCII values of letters, numbers, and symbols are displayed. The ASCII value of the function keys is not displayed, as shown in Table 2
500
501 (The Numeric/Character display object is not updated when it is being entered)
502 )))
503 |HSW1079|Enable cursor position and Enter key mode|(((
504 HSX1079.0 = 1: Set the cursor position according to HSW1076 and HSW1077 value;
505
506 HSX1079.1 = 0: When Numeric/Character display object is entered, enter key is for end input instruction. When no Numeric/Character display object is entered, enter key is for normal click;
507
508 HSX1079.1 = 1: Enter key only for normal click, not for keyboard end input instruction;
509 )))
510
511 **Key-Value Appendix Table (Decimal) (104Keys)**
512
513 (% class="table-bordered" %)
514 |=**Key**|=**Value**|=**Key**|=**Value**|=**Key**|=**Value**
515 |ESC|1|i I|23|Alt (Right)|100
516 |F1|59|o O|24|windows(Right)|126
517 |F2|60|p P|25|Menu|127
518 |F3|61|[ {|26|Right_ctrl|97
519 |F4|62|] }|27|Print Screen|99
520 |F5|63|Enter|28|ScrollLock|70
521 |F6|64|CapsLock|58|PauseBreak|119
522 |F7|65|a A|30|Insert|110
523 |F8|66|s S|31|Home|102
524 |F9|67|d D|32|PageUp|104
525 |F10|68|f F|33|Delete|111
526 |F11|87|g G|34|End|107
527 |F12|88|h H|35|PageDown|109
528 |` ~~|41|j J|36|↑|103
529 |1 !|2|k K|37|↓|108
530 |2 @|3|l L|38|←|105
531 |3 #|4|; :|39|→|106
532 |4 $|5|' "|40|NumLock (Keypad)|69
533 |5%|6|\ ~||43|/ (Keypad)|98
534 |6 ^|7|Shift (Left)|42|* (Keypad)|55
535 |7 &|8|z Z|44|-　(Keypad)|74
536 |8 *|9|x X|45|+　(Keypad)|78
537 |9 (|10|c C|46|Enter (Keypad)|96
538 |0 )|11|v V|47|. (Keypad)|83
539 |- _|12|b B|48|0 (Keypad)|82
540 |+ =|13|n N|49|1 (Keypad)|79
541 |Backspace|14|m M|50|2 (Keypad)|80
542 |Tab|15|, <|51|3 (Keypad)|81
543 |q Q|16|. >|52|4 (Keypad)|75
544 |w W|17|/ ?|53|5 (Keypad)|76
545 |e E|18|Shift (Right)|54 |6 (Keypad)|77
546 |r R|19|Ctrl (Left)|29|7 (Keypad)|71
547 |t T|20|Windows(Left)|125|8 (Keypad)|72
548 |Y y|21|Alt (Left)|56|9 (Keypad)|73
549 |u U|22|space|57| |
550
551 **ASCII Code**
552
553 (% class="table-bordered" %)
554 |**Code**|**Value**|**Code**|**Value**|**Code**|**Value**|**Code**|**Value**
555 |32|space|56|8|80|P|104|h
556 |33|!|57|9|81|Q|105|i
557 |34|"|58|:|82|R|106|j
558 |35|#|59|;|83|S|107|k
559 |36|$|60|<|84|T|108|l
560 |37| %|61|= |85|U|109|m
561 |38|&|62|>|86|V|110|n
562 |39|'|63|?|87|W|111|o
563 |40|(|64|@|88|X|112|p
564 |41|)|65|A|89|Y|113|q
565 |42|*|66|B|90|Z|114|r
566 |43|+|67|C|91|[|115|s
567 |44|,|68|D|92|\|116|t
568 |45|-|69|E|93|]|117|u
569 |46|.|70|F|94|^|118|v
570 |47|/|71|G|95|_|119|w
571 |48|0|72|H|96|`|120|x
572 |49|1|73|I|97|a|121|y
573 |50|2|74|J|98|b|122|z
574 |51|3|75|K|99|c|123|{
575 |52|4|76|L|100|d|124|~|
576 |53|5|77|M|101|e|125|}
577 |54|6|78|N|102|f|126|~~
578 |55|7|79|O|103|g| |
579
580 == **Scripts example** ==
581
582 'HSW1073 key value
583
584 'HSW1074 key states 0: released; 1: pressed; 2: Holding pressed
585
586 'HSW1078 ASCII value of key
587
588 **(1) Example 1**
589
590 if @W_HSW1073 = 29 then  'Ctrl key value is 29
591
592 if @W_HSW1074 = 1 or @W_HSW1074 = 2  'Press Ctrl key
593
594 @W_HDW1000 = 1
595
596 else  'Release Ctrl key
597
598 @W_HDW1000 = 0
599
600 endif
601
602 endif
603
604 **(2) Example 2**
605
606 if @W_HSW1073 = 59 and (@W_HSW1074 = 1 or @W_HSW1074 = 2) then  'F1 key value is 59
607
608 if @W_HDW1000 = 1 then  'Combination Ctrl + F1
609
610 @W_HDW2000 = @W_HDW2000 + 1  'Function of combination key is HDW2000 + 1
611
612 endif
613
614 endif
615
616 **(3) Example 3**
617
618 if @W_HSW1073 = 60 and (@W_HSW1074 = 1 or @W_HSW1074 = 2) then  'the value of F2 is 60
619
620 if @W_HDW1000 = 1 then  'Combination Ctrl + F2
621
622 @W_HDW2000 = @W_HDW2000 - 1  'Function of combination key is HDW2000 - 1
623
624 endif
625
626 endif
627
628 **(4) Example 4**
629
630 if AsString(@W_HSW1078) = "a" and (@W_HSW1074 = 1 or @W_HSW1074 = 2) then  'Page up
631
632 if @W_HSW13 > 0 then
633
634 @W_HSW13 = @W_HSW13 - 1
635
636 endif
637
638 endif
639
640 **(5) Example 5**
641
642 if AsString(@W_HSW1078) = "b" and (@W_HSW1074 = 1 or @W_HSW1074 = 2) then  'Page down
643
644 @W_HSW13 = @W_HSW13 + 1
645
646 if @W_HSW13 > 3 then
647
648 @W_HSW13 = 3
649
650 endif
651
652 endif
653
654 = **{{id name="_Toc29624"/}}rtsp web camera** =
655
656 **Introduction**
657
658 1. An external IP Camera (web camera) can be used to display the screen captured by the it to achieve real-time monitoring of the scene of the equipment.
659 1. ONVIF protocol and H.264 coding camera (RTSP web camera) are supported.
660
661 **~ Supported Model:**
662
663 1) Hikvision
664
665 * DS-2CD1321D-I
666 * DS-2CD3T20FD-I3W
667 * DS-2CD1221D-I3
668 * DS-2CV3Q21FD-IW
669
670 2) Dahua
671
672 * DH-IPC-HFW1025D
673 * DH-IPC-HFW1235M-I1
674
675 1. 8000 series HMI can view only **one **IP Camera monitoring screen at a time (only **one **camera object can be placed in a project).
676 1. 8000 series HMI can view only **four** IP Camera monitoring screen at a time (only **four **camera object can be placed in a project).
677
678 == **Camera search** ==
679
680 In the software PIStudio, Click "Project" -> "Project settings"-> "Extend", and check "Enable camera search module", shown as below.
681
682 (% style="text-align:center" %)
683 [[image:rtsp摄像头 1.png||class="img-thumbnail"]]
684
685 The maximum number of searches: Configure the number of online camera.  The maximum number of searches does not exceed 20, and should be greater than that of online camera.
686
687 === **Function address** ===
688
689 To configure the information of searches anf the records of search results. There are as follows.
690
691 (% class="table-bordered" %)
692 |(% style="width:109px" %)**Address**|(% style="width:468px" %)**Description**|(% style="width:240px" %)**Length**
693 |(% style="width:109px" %)HDW200|(% style="width:468px" %)Username|(% style="width:240px" %)20 words
694 |(% style="width:109px" %)HDW220|(% style="width:468px" %)Password|(% style="width:240px" %)20 words
695 |(% style="width:109px" %)HDX240.0|(% style="width:468px" %)Falling edge trigger search|(% style="width:240px" %)1 bit
696 |(% style="width:109px" %)HDX240.1|(% style="width:468px" %)(((
697 Search status
698
699 0: The search is complete.
700
701 1: It is searching.
702 )))|(% style="width:240px" %)1 bit
703 |(% colspan="2" rowspan="1" style="width:109px" %)The first search result|(% style="width:240px" %)80 words
704 |(% style="width:109px" %)HDW241|(% style="width:468px" %)IP address|(% style="width:240px" %)16 words
705 |(% style="width:109px" %)HDW257|(% style="width:468px" %)(((
706 ~=1: correct password
707
708 ~=0: wrong password
709 )))|(% style="width:240px" %)1 word
710 |(% style="width:109px" %)HDW258|(% style="width:468px" %)Device serial number|(% style="width:240px" %)43 words
711 |(% style="width:109px" %)HDW301|(% style="width:468px" %)Camera alias|(% style="width:240px" %)20 words
712 |(% colspan="2" rowspan="1" style="width:109px" %)The second search result|(% style="width:240px" %)80 words
713 |(% style="width:109px" %)HDW321|(% style="width:468px" %)IP address|(% style="width:240px" %)16 words
714 |(% style="width:109px" %)...|(% style="width:468px" %)...|(% style="width:240px" %)...
715
716 The username and password of function address need to entered manually. When searching for cameras, the username and password will be matched first, then each camera under the account will be retrieved, and the retrieved results will be stored in the response address. If the password is correct, the corresponding serial number would be displayed.
717
718 == **Camera display** ==
719
720 Add the object "camera display" to the project, click "Enable rtsp camera", as below.
721
722 (% style="text-align:center" %)
723 [[image:rtsp摄像头 2.png]]
724
725
726 3) Compile and download project, please click [Search Camera] button to get camera information in LAN The username and password here need to be entered manually. During searching camera, it will try to use this username and password to log in IP camera and store the result of login. If the password is correct, the “password correct” address will be displayed as 1 and the device serial number will be displayed. If the “password correct” address is 0, the device serial number would not be displayed.
727
728 === **Function address** ===
729
730 (% class="table-bordered" %)
731 |=(% style="width: 204px;" %)**Address**|=(% colspan="2" style="width: 702px;" %)**Description**|=(% style="width: 245px;" %)**Length**
732 |(% style="width:204px" %)HAW100|(% colspan="2" style="width:702px" %)Username|(% style="width:245px" %)20 words
733 |(% style="width:204px" %)HAW120|(% colspan="2" style="width:702px" %)password|(% style="width:245px" %)20 words
734 |(% style="width:204px" %)HAW140|(% colspan="2" style="width:702px" %)Alias|(% style="width:245px" %)20 words
735 |(% style="width:204px" %)HAW160|(% colspan="2" style="width:702px" %)Device serial number|(% style="width:245px" %)43 words
736 |(% style="width:204px" %)HAW203|(% colspan="2" style="width:702px" %)Camera ID|(% style="width:245px" %)1 word
737 |(% colspan="1" rowspan="11" style="width:204px" %)HAW204|(% colspan="2" rowspan="1" style="width:702px" %)Camera Control|(% colspan="1" style="width:245px" %)1 word
738 |(% style="width:211px" %)HAX204.0|(% style="width:787px" %)Open camera|(% colspan="1" style="width:245px" %)1 word
739 |(% style="width:211px" %)HAX204.1|(% style="width:787px" %)Close camera|(% colspan="1" style="width:245px" %)1 word
740 |(% style="width:211px" %)HAX204.2|(% style="width:787px" %)Camera up|(% colspan="1" style="width:245px" %)1 word
741 |(% style="width:211px" %)HAX204.3|(% style="width:787px" %)Camera down|(% colspan="1" style="width:245px" %)1 word
742 |(% style="width:211px" %)HAX204.4|(% style="width:787px" %)Camera left|(% colspan="1" style="width:245px" %)1 word
743 |(% style="width:211px" %)HAX204.5|(% style="width:787px" %)Camera right|(% colspan="1" style="width:245px" %)1 word
744 |(% style="width:211px" %)HAX204.6|(% style="width:787px" %)screenshot|(% colspan="1" style="width:245px" %)1 word
745 |(% style="width:211px" %)HAX204.7|(% style="width:787px" %)Binding camera|(% colspan="1" style="width:245px" %)1 word
746 |(% style="width:211px" %)HAX204.8|(% style="width:787px" %)Set Alias|(% colspan="1" style="width:245px" %)1 word
747 |(% style="width:211px" %)HAX204.9|(% style="width:787px" %)Camera stop moving|(% colspan="1" style="width:245px" %)1 word
748 |(% style="width:204px" %)HAW205|(% colspan="2" style="width:702px" %)(((
749 Camera status
750
751 ~=0: camera disconnected
752
753 ~=1: camera connected
754
755 ~=2: Camera is connecting
756 )))|(% style="width:245px" %)1 word
757 |(% style="width:204px" %)HAW206|(% colspan="2" style="width:702px" %)(((
758 Screenshot save location
759
760 ~=0: Screenshot is saved into flash
761
762 ~=1: Screenshot is saved into USB disk
763
764 ~=2: Screenshot is saved into SD card
765 )))|(% style="width:245px" %)1 word
766
767 **Operating Procedures**
768
769 1) Fill the camera ID address with the camera serial number searched by the camera search module, and trigger the binding address to fill username and password.
770
771 If the camera searching is disabled, then users need to manually enter the information of this camera, including username, password, and device serial number. Device serial number could be obtained by checking the label of camera.
772
773 (% style="text-align:center" %)
774 [[image:11.Advanced Function_html_9ba06415a43f4264.png||class="img-thumbnail" height="232" width="412"]]
775
776 2) If the IP CAMERA was triggered successfully, we could see the monitor screen and we could also set a alias for the camera and control the movement of the camera(up, down, left and right, some IP camera could not support the movement) or the screenshot. These operations could not be performed if camera off.
777
778 (% style="text-align:center" %)
779 [[image:11.Advanced Function_html_5e0967606b906db1.jpg||class="img-thumbnail" height="250" width="333"]]
780
781
782 **✎Note:**
783
784 1. Camera configuration. When you get the camera, you need to activate the camera and enable the onvif protocol for the camera according to the user manual and tools provided by the camera manufacturer. If the configuration is not correct, the camera cannot be used on the HMI.
785 1. When reading camera information, you need to configure the user name and password for the camera. When multiple cameras are enabled, you are advised to set the user names and passwords of all cameras to be the same.
786 1. When using the camera function, ensure that the camera and HMI are on the same LAN. When the HMI is directly connected to the camera through a network cable, set both HMI and camera to static IP addresses as follows.
787
788 (% class="table-bordered" %)
789 |=(% style="width: 166px;" %) |=(% style="width: 256px;" %)HMI|=(% style="width: 332px;" %)Camera
790 |(% style="width:166px" %)IP address|(% style="width:256px" %)192.168.1.1|(% style="width:332px" %)192.168.1.2
791 |(% style="width:166px" %)Gateway|(% style="width:256px" %)192.168.1.1|(% style="width:332px" %)192.168.1.1
792
793 (% start="4" %)
794 1. You could obtain the camera from the "Camera Search module" in "Project parameters" or manually fill in the address. You can obtain resources for the camera display object in the Camera Search module or manually enter the parameters.
795 1. You are advised to configure and confirm the user name and password of the camera before using it. Do not use the wrong user name (password) to search for or link to the camera. Once the wrong user name (password) is exceeded for a certain number of times, the camera will be locked. During the lock period, the camera will reject any connection for at least half an hour generally.
796 1. When monitoring HMI cameras, do not monitor the same camera at the same time. Otherwise, the monitoring screen may be lost.
797 1. When the camera is disconnected due to network reasons, the system wouyld try to reconnect the camera every 20 seconds.
798 1. The alias of the camera is saved in the user database. The alias in old project is retained when downloading new project, if [user database] is selected. Otherwise the it will be deleted.
799
800 (% style="text-align:center" %)
801 [[image:11.Advanced Function_html_804b6a35561fc436.png||class="img-thumbnail" height="367" width="600"]]
802
803 **Demo download link**
804
805 [[https:~~/~~/drive.google.com/open?id=10UR1cg8KDjcTvKJYgk1KR8z4YIApIsD8>>url:https://drive.google.com/open?id=10UR1cg8KDjcTvKJYgk1KR8z4YIApIsD8]]
806
807 = **LAN Monitoring** =
808
809 (% class="wikigeneratedid" id="H11.7.1Introduction" %)
810 **Introduction**
811
812 WECON provides [HMI Monitor System] software for user to monitor PI3000 series HMI in Local area network (LAN).
813
814 This function is only for the model with -O. For example PI3070N-O.
815
816 == **[HMI Monitor System] software** ==
817
818 (1) Device List: It displays HMIs, that connected into this monitor software;
819
820 (2) State Indicator: It shows state of HMI, green means online, gray means offline;
821
822 (3) Operation Buttons: It provides three operations for HMI device;
823
824 * Add: Click it to open add setting window;
825 * Delete: Click it to delete selected HMI device;
826 * Monitor: Click it to open monitor window for selected HMI device;
827
828 (% style="text-align:center" %)
829 [[image:11.Advanced Function_html_fdfb5186d5dd123d.png||class="img-thumbnail" height="302" width="600"]]
830
831 == **Operating Procedures** ==
832
833 (1) Click [Add] button to open setting window;
834
835 (2) Enter HMI IP and Note;
836
837 (3) Click [Connection test] button;
838
839 * If IP is correct, it will display tip as below;
840
841 (% style="text-align:center" %)
842 [[image:11.Advanced Function_html_130ed411da07f4c4.png||class="img-thumbnail" height="376" width="550"]]
843
844 If IP is incorrect, it will display tip as below
845
846 (% style="text-align:center" %)
847 [[image:11.Advanced Function_html_878d04362f1b81b6.png||class="img-thumbnail" height="122" width="150"]]
848
849 **✎Note:**
850
851 For using this function in PC, it requires the setup of LAN Monitoring Firewall, using Windows 7 system as example. **If this function works well in your PC, please ignore below content.**
852
853 **Solution 1: Disable Firmware Completely**
854
855 (1) Open [Control Panel] and select [System Security]
856
857 (% style="text-align:center" %)
858 [[image:11.Advanced Function_html_9616a538bd5b8890.png||class="img-thumbnail" height="426" width="600"]]
859
860 (2) Select [Windows Firewall];
861
862 (% style="text-align:center" %)
863 [[image:11.Advanced Function_html_4ff5d9c605179616.png||class="img-thumbnail" height="427" width="600"]]
864
865 (3) Select [turn Windows Firewall on or off]
866
867 (% style="text-align:center" %)
868 [[image:11.Advanced Function_html_8cce81685e77dd93.png||class="img-thumbnail" height="532" width="850"]]
869
870 (4) Select [Turn off Windows Firewall]
871
872 (% style="text-align:center" %)
873 [[image:11.Advanced Function_html_8e40bd24335bee5f.png||class="img-thumbnail" height="451" width="700"]]
874
875 **Solution 2: Do not close the firewall, but allow HMIUI to pass through the firewall**
876
877 (1) Open Control Panel selection [system Security]
878
879 (% style="text-align:center" %)
880 [[image:11.Advanced Function_html_4a5370b15f8344bf.png||class="img-thumbnail" height="363" width="550"]]
881
882 (2) Select [Windows Firewall]
883
884 (% style="text-align:center" %)
885 [[image:11.Advanced Function_html_3f00b4c76667d218.png||class="img-thumbnail" height="394" width="600"]]
886
887 (3) Select [run a program or function through Windows Firewall]
888
889 (% style="text-align:center" %)
890 [[image:11.Advanced Function_html_2ce833853fe2fe08.png||class="img-thumbnail" height="422" width="600"]]
891
892 (4) Select [Allow to run another program].
893
894 (% style="text-align:center" %)
895 [[image:11.Advanced Function_html_49e43fd3e9e58bc3.png||class="img-thumbnail" height="401" width="600"]]
896
897 (5) Select [browse] in the pop-up dialog box
898
899 (% style="text-align:center" %)
900 [[image:11.Advanced Function_html_714b05b4f66641fb.png||height="447" width="450"]]
901
902 (6) Locate the HMIUI.exe file in the HMIUI directory under the installation path of the monitoring software, and double-click HMIUI.exe
903
904 (% style="text-align:center" %)
905 [[image:11.Advanced Function_html_cdf52e5522e2e568.png||class="img-thumbnail" height="596" width="600"]]
906
907 (7) Select add
908
909 (% style="text-align:center" %)
910 [[image:11.Advanced Function_html_2cf5b5f0c9aa4f7a.png||class="img-thumbnail" height="467" width="535"]]
911
912 (8) Check the corresponding options
913
914
915 (% style="text-align:center" %)
916 [[image:11.Advanced Function_html_ffc611cca1a173f9.png||class="img-thumbnail" height="361" width="600"]]
917
918 (9) select OK
919
920 (% style="text-align:center" %)
921 [[image:11.Advanced Function_html_934ebd63c53af3ee.png||class="img-thumbnail" height="442" width="600"]]
922
923 = **Remote access config** =
924
925 **Introduction**
926
927 In the traditional concept, it is rather Difficult and complicated to remotely connect HMI via Ethernet. Users not only need to consider the security issue, but also need to set up complex network parameters. In addition, subject to the stage of the network environment, users have to do everything possible to think of ways through all levels of routers and switches. And an independent IP could only correspond to one HMI in tradition sense of the remote control. The WECON remote access system will solve all of those problems.
928
929 The solution of WECON HMI remote access is "Everything is possible with one network, one HMI, one cable". No matter where the HMI is, users could easily remote access HMI through the network, to achieve exclude exceptions and resolve them in the first time. In local area network or remote Internet, users could make HMI connect to Ethernet by one cable without setting any parameters. All network settings could be set by WECON remote access system.
930
931 **(1) Set the IP of HMI**
932
933 (% style="text-align:center" %)
934 [[image:远程访问 1.png||class="img-thumbnail"]]
935
936 **(2) Use mobile phones, computers, tablets, etc., open a browser, enter the IP, you could access the project in the HMI screen.**
937
938 * You are advised to use Chrome or Firefox. If you want to use Internet Explorer, use Internet Explorer 9 or later.
939 * 360, Sogou and other browsers need to use speed mode.
940 * Support the iphone's own browser, or install a latest UC browser.
941 * As long as the browser supports HTML5.
942
943 **(3) Access through the cloud**
944
945 Access through the cloud platform, enter the machine code (the machine code of each HMI is independent) and model, then monitor the HMI remotely.
946
947 **(4) Access through V-NET (ig series)**
948
949 Access through the V-NET, enter the machine code (the machine code of each HMI is independent) and the device password, bind the HMI, and monitor the HMI remotely.
950
951 **System Components**
952
953 WECON PI8000 and advanced HMI with [-R], such as PI8070-R;
954
955 1) WECON Smart APP or WECON Cloud platform
956
957 **User manual for WECON Smart and cloud platform download link**
958
959 [[https:~~/~~/drive.google.com/open?id=1hI8QI4vmJhAis2GFuCISChV9xGU0BxQ9>>url:https://drive.google.com/open?id=1hI8QI4vmJhAis2GFuCISChV9xGU0BxQ9]]
960
961 **FAQ**
962
963 1) What is the difference between the-R model and the normal model?
964
965 A: The-R model can be accessed directly and unrestricted. Normal models need to buy cloudmonitoring products before access. The number of monitoring normal model is limitedaccording to the customer's purchase of cloud monitor packages.
966
967 2) How many customers could remote access HMI at the same time?
968
969 A: It supports max. 4 customers access HMI in the same time.
970
971 = **Mulit-link** =
972
973 == **Introduction** ==
974
975 1) The main principle of Multi-link is to use the method of Master&Slave to implement the One machine-Multiple screens by ethernet port. For example, one Master HMI connect to one Slave HMI, the Slave one can write or read value from PLC which is communicated with Master.
976
977 2) In Multi-link, there is only one Master, and all the other HMIs are Slaves. The Master HMI is the only one device communicate with PLC, and the data received from the PLC is transmitted to each slave through the host HMI(Master).
978
979 (% style="text-align:center" %)
980 [[image:1652345241521-592.png||class="img-thumbnail"]]
981
982 3) At present, the Multi-link is regarded as special function. So not any model HMI support it. Need the HMI come with the special machine code. The series support Multi-link function right now: General, HMI+, i Series. Multi link doesn’t support the online simulaion. PI3000/PI3000+/PI3000i series can only have one Slave when using this function, while PI8000/9000,PI8000+/PI9000+ series can use at most 5 Slaves.
983
984 == **PIStudio Settings** ==
985
986 (1) Check to enable Multi-link, select the corresponding option. For example, if it is a slave HMI, select Slave.
987
988 (% style="text-align:center" %)
989 [[image:多机互联.png||class="img-thumbnail"]]
990
991
992 (% class="wikigeneratedid" %)
993 (2) Master IP address setting: Click "Project"- "Project settings" - "HMI IP", as below.
994
995 (% style="text-align:center" %)
996 [[image:远程访问 1.png||class="img-thumbnail" height="516" width="594"]]
997
998 == **Slave Project** ==
999
1000 In order to let the fonts in the Slave and the Master consistent with each others, so Slave project needs to add one screen that can set the IP address of Master HMI for connecting to the Master, on the original the Master project. If Master project has components that use other font styles, and Slave project If there is no component corresponding to Master project, then the default font style SimSun would be displayed when the Multi-link is enabled. To avoid the Slave device prompts communication timeout message, you can add HSW9 = 1 in the initial script of Slave device.
1001
1002 == **Address** ==
1003
1004 |Address|Address Description|Usage Method
1005 |HSW1100|(% rowspan="4" %)The IP of Master HMI|IP address high endian 1
1006 |HSW1101|IP address high endian 2
1007 |HSW1102|IP address high endian 3
1008 |HSW1103|IP address high endian 4
1009 |HSW1104|(((
1010 Control the Slave to connect to
1011
1012 the Master or not
1013 )))|(((
1014 1: Connect to Master
1015
1016 0: Disconnect
1017 )))
1018
1019 == **Notice** ==
1020
1021 1) During the connection, if the Master is downloading program, there is a highly chances that the slave screen is abnormal, and the Gallery and imported pictures cannot be displayed.
1022
1023 After the download process of Master HMI is finished, Slave needs to be restarted to monitor normally.
1024
1025 1. If the Master and Slave are operated on any screen, the screen also will follow the changes and synchronize for other side.
1026
1027 Using HSW12 = 1 on the Master, which can not affect each other.
1028
1029 1. There is no momentary delay function for buttons.
1030 1. Multi-link version bit switch has no Min. holding time.
1031 1. PI3000 series can only have one Slave when using this function, while PI8000/9000 series can use this function at most 5 Slaves.
1032 1. Only supports Multi-link connection in the LAN network (local area network), or direct connection between Master and Slave.
1033 1. The Master and Slave projects must be consistent (mainly for keeping the font style used by the Master and Slave HMI consistent), and the Slave HMI always adds the configuration of the “Master IP address".
1034 1. After the special address is enabled, Slave will remotely monitor the interfaces from Master, and the source project will not be executed.
1035
1036 ✎Note: Slave project only needs to ensure that there is "the HSW address of the Master HMI IP" and the font style used by the Master.
1037
1038 = **V-NET Access (PC Side)** =
1039
1040 == **Login Interface** ==
1041
1042 ~1. Enter the platform, as shown in Figure 1:
1043
1044 New users need to register first.
1045
1046 (1) The successfully registered account is the administrator account, which can bind the device and other operations.
1047
1048 (2) The user needs to remember the registered account and password, and able to log in simultaneously on the PC Client/APP.
1049
1050 (3) If the user forgets the password, he can click "Forgot Password" to reconfigure the password.
1051
1052 (% style="text-align:center" %)
1053 [[image:11.2-1.png||class="img-thumbnail"]]
1054
1055 Figure 1
1056
1057 2. Enter the account and password, and then click the [Login] button.
1058
1059 3. After successfully logging in, enter the "V-NET" interface, as shown in Figure 2. Add the HMI information you want to access through the "+" in the lower left corner.
1060
1061 (% style="text-align:center" %)
1062 [[image:11.Advanced Function_html_7618c4f92465545c.png||class="img-thumbnail" height="670" width="1366"]]
1063
1064 Figure 2
1065
1066 4. After the Add Device window pops up, enter the machine code and password of the device to add the device, as shown in Figure 3:   
1067
1068 (% style="text-align:center" %)
1069 [[image:11.Advanced Function_html_9b4cc907cf4a8c13.png||class="img-thumbnail" height="502" width="601"]]
1070
1071 Figure 3
1072
1073 ①Device machine code: Each HMI has a unique and independent machine code, which is used to identify every remote device.
1074
1075 (When binding multiple devices at the same time, the device passwords must be the same. Only one machine code can be entered on one line. When entering multiple machine codes, use the "Enter" key to change the line. If the format is wrong, the binding operation will fail and error will occur)
1076
1077 Method of obtain machine code:
1078
1079 1) PIStudio -[Project]-[Tool]-[Download]-Copy the machine code.        
1080
1081 2) Long press the upper right corner of HMI to enter the backstage, you can see [Machine Id] in "Machine Info".       
1082
1083 3) Obtain the machine code from the backlabel of the device.
1084
1085 ② Device password: Refers to the Cloud access password, the default is 6 digits 8 (888888). Please refer to the cloud configuration if you first time binding the device.
1086
1087 (The length is 6 digits, English and special characters in English are allowed, spaces are not allowed, and cannot be empty).
1088
1089 ③ Device alias: Refers to the name recognition of device in the menu bar of V-NET.
1090
1091 (Maximum 12 digits, except ·_-+=}]",.?,;: ""”【】—()...! these Special characters allowed others are limited to input, no spaces or blanks are allowed).
1092
1093 5. If the device is successfully bound, click OK, and it would prompt message: The device is bound successfully!
1094
1095 **✎Note: **If you bind multiple machine codes in batch, the device alias will use the input device alias as the prefix, and the system will automatically add a suffix. Example: Default group (device alias)_1 (automatically added suffix).
1096
1097 == **V-NET Module** ==
1098
1099 {{id name="_GoBack"/}}1. Remote Monitoring
1100
1101 The remote monitoring module can display the project page of the current screen in real time, and can operate the project on the web page, and the control of the screen. As shown in Figure 4:
1102
1103 (% style="text-align:center" %)
1104 [[image:11.2-4.png||class="img-thumbnail"]]
1105
1106 Figure 4
1107
1108 2. Data Viewing
1109
1110 The data viewing module is divided into Communication port, Collection point, Alarm configuration, Alarm records, Data Record configuration , Data Record, etc. As shown in Figure 5:
1111
1112 (% style="text-align:center" %)
1113 [[image:11.2-5.png||class="img-thumbnail"]]
1114
1115 Figure 5
1116
1117 The parameter configuration is as follows:
1118
1119 ①Communication port : The communication port information, includes connection method and protocol name, can only be viewed, and cannot be added or modified. This info comes from the settings from HMI.
1120
1121 ②Collect point:Data monitoring module of the device. The collection point is the monitoring data, and its read-write, write-only, and read-only permissions also come from the Tags settings from HMI.
1122
1123 Note: You cannot add or delete collection points here. The read & write permissions of the collection points in the HMI will directly restrict the modification of the read & write permissions of the collection points by V-NET.
1124
1125 ③Alarm configuration: Alarm records of the device, monitoring points cannot be added, confirming the Alarm record and exporting data can be performed.
1126
1127 ④Data Record configuration: Data Record is historical data of the device, monitoring points cannot be added, curve and list viewing method are supported, and data records can be exported.
1128
1129 3. Remote Download
1130
1131 This function allows application on the PC to download directly to PLC or HMI, as shown in Figure 6:
1132
1133 (% style="text-align:center" %)
1134 [[image:11.2-6.png||class="img-thumbnail"]]
1135
1136 Figure 6
1137
1138 **✎Note: **The pass through function of remote download is temporarily unavailable on the web page, and it can be used normally in PC client. The configuration is as follows:
1139
1140 (1) PLC download (only for Pass-through)
1141
1142 ① Click the setting (gear icon) in the upper right corner of PC Client, and a dialog will pop up. The red area is the COM port configuration when the PLC pass-through downloads. As shown in Figure 7:
1143
1144 (% style="text-align:center" %)
1145 [[image:11.Advanced Function_html_870ebc5415b1a534.png||class="img-thumbnail" height="565" width="526"]]
1146
1147 Figure 7
1148
1149 ②. After configuring the COM port, go to the remote downloaded, PLC download, to config the name, communication port, virtual serial port and other configurations as shown in Figure 6.
1150
1151 (2) HMI Download (only for Pass-through)
1152
1153 ①. Click the setting (gear icon) button in the upper right corner of PC Client, and a dialog will pop up. The red area is the configuration of the HMI download tool. As shown in Figure 8:
1154
1155 (% style="text-align:center" %)
1156 [[image:11.Advanced Function_html_64e406f9862f887e.png||class="img-thumbnail" height="565" width="526"]]
1157
1158 Figure 8
1159
1160 ②. Click the setting (gear icon) button, a dialog box will pop up, and automatically detect and find the PIStudio that has been installed in PC and conforms to the version, as shown in Figure 9:
1161
1162 Location: Display the installation path of the current PIStudio.
1163
1164 Version: Corresponding to the version of the current PIStudio.
1165
1166 Browse: Click to manually set the installation path of PIStudio.
1167
1168 [[image:11.Advanced Function_html_df9946a5a7574454.png||height="349" width="642"]]
1169
1170 Figure 9
1171
1172 4. Basic
1173
1174 In the "Basic" sub-page of Basic, HMI name, record reserved selection, password, location and remarks, etc. As shown in Figure 10:
1175
1176 [[image:11.Advanced Function_html_c76828978cb6b697.png||height="670" width="1366"]] Figure 10
1177
1178 (1) The device name is an alias of HMI, which is mainly used for easy distinction.
1179
1180 (2) Online status: You can click the refresh button to refresh the online status of the HMI.
1181
1182 (3) Machine code: Each HMI has a unique and independent machine code.
1183
1184 (4) Record reserved: Checking the corresponding options will let HMI to suspend updating the corresponding configuration after downloading a new project.
1185
1186 (5) Password:
1187
1188 Refers to the cloud access password, the default is 6 digits 8 (888888); the cloud access password can be set and modified, the specific location is:
1189
1190 ① V-NET —specified HMI—Baisc—Basic —"password”—modify and save, as shown in Figure 10.        
1191
1192 ② [Project]-[Cloud]-Basic-" Password" of PIStudio (only unbind HMI can be modified), see Cloud Configuration.
1193
1194 (6) Maximum storage of Alarm data: The maximum number of alarm data saved, with a range of 1-50000.    
1195
1196 (7) Positioning:
1197
1198 ①Use the device base station positioning to locate.        
1199
1200 ②Use manual positioning.
1201
1202 **✎Note:** After modifying the basic information of the device, you need to click Save below to save the modification successfully. If it is not saved successfully, please click Force Synchronization.