Skip to Content

Wiki source code of 04 Library

Version 4.1 by Leo Wei on 2022/06/11 15:13
Show last authors
1 = **Shape** =
2
3 [[image:image-20220611151350-1.png]]
4
5 **It is used for storing bitmaps. The source of bitmaps are: system bitmap library and imported bitmaps.**
6
7 (% style="text-align:center" %)
8 [[image:位图库 1.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
9
10 (((
11 (% style="text-align:center" %)
12 [[image:位图库、.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
13
14 (% class="wikigeneratedid" %)
15 You could view all the bitmaps in the library, and import or export them accoridng to your own needs. You can also create multi-state bitmaps.
16
17 (% class="wikigeneratedid" %)
18 There are four kinds of galleries as follows.
19
20 1. **Project gallery: **The bitmaps added in the project and the bitmaps applied in the project are displayed in the project gallery.
21
22 * Rename: You could click one bitmap to rename. Bitmap names can be a combination of Chinese characters, numbers, and letters (case sensitive), but no special characters. The length of it cannot exceed 18 characters.
23 * When you place the mouse on the display area of bitmap, its name and resolution would be displayed.
24 * You can export the current project bitmap file, import the file in another project, and call it in the new project.
25
26 (% start="2" %)
27 1. **System gallery: **The software system gallery, including pictures and vector diagrams (svg picture).
28 1. **Gallery file: **You can import the corresponding picture file from and call it in the project library.
29
30 * You could import library files with suffixes "aa. pLb" and "aa. bLb".
31 * Select one bitmap, right click to perform three operations: Use library, Delete library, and rename library (F2).
32
33 (% start="4" %)
34 1. **Extended gallery: **The image applied in the screen style can be found in the extended gallery.
35
36 = **Font** =
37
38 You could pre-set the font and directly call the settings in the font library when editing the project.
39
40 (% style="text-align:center" %)
41 [[image:字体库 1.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
42
43 (% style="text-align:center" %)
44 [[image:7.Library_html_938f815f649f52f7.png||data-xwiki-image-style-alignment="center" height="430" width="408" class="img-thumbnail"]]
45
46 (% class="table-bordered" %)
47 |=**Items**|=**Description**
48 |Add font|Add an new font in library
49 |Delete font|Delete selected font
50 |Properties|Edit selected font
51 |Close|Close current setting window
52 |Help|Click it to open help document
53
54 **Operating procedures of create font**
55
56 (% style="text-align:center" %)
57 [[image:7.Library_html_49e9837c01071e5a.png||data-xwiki-image-style-alignment="center" height="299" width="553" class="img-thumbnail"]]
58
59 1. Click [Add font] to open setting window.
60 1. Enter font name.
61 1. Select font.
62 1. Select font size.
63 1. Select font style.
64 1. Preview font.
65
66 = **Text** =
67 )))
68
69 Text library contains commonly used text. It avoids setting the text repeatedly. HMI provides up to 8 languages in text library.
70
71 Click "Project"-"Text" to open the setting window.
72
73 (% style="text-align:center" %)
74 [[image:文本库.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
75
76 (% style="text-align:center" %)
77 [[image:7.Library_html_b8f8338b62169207.png||data-xwiki-image-style-alignment="center" height="298" width="577" class="img-thumbnail"]]
78
79 (% class="table-bordered" %)
80 |=**Items**|=**Description**
81 |ID|The identifier of the text in the list
82 |Languages|One text can be set in 8 languages
83 |New|Add an new text in list
84 |Delete|Delete selected text
85 |Edit|Edit select text
86 |Close|Close text library list
87 |Help|Open help document
88 |Export EXCEL|Export text library to PC as excel file
89 |Import EXCEL|Import text library from excel file
90 |Clear|Delete all texts in list
91
92 **Operating procedures of creating new text**
93
94 1. Click "New" button to open setting windows as below.
95 1. Set at least one language and support up to 8 languages.
96 1. Click "Save" to complete operations.
97
98 (% style="text-align:center" %)
99 [[image:7.Library_html_f78c9d8bbbd45150.png||data-xwiki-image-style-alignment="center" height="431" width="554" class="img-thumbnail"]]
100
101 **✎Note:**
102
103 Text library: Supports importing edited Excel files into projects for use. However, the following two points need to be noted:
104
105 1. When importing an Excel file, if the contents of language one to language eight in ID (ID) information is all empty, the information of the subsequent ID will not be imported.
106 1. When importing Excel files, if there is pure digital content in the imported information, you need to set the format of the table box to "text" mode. Otherwise, the text import fails or an error occurs due to incorrect information format.
107
108 **Introduction**
109
110 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.
111
112 = **Email** =
113
114 == **Email setting** ==
115
116 In "PIStudio" software, click "Project"-> "E-mail" to open email function setting screen.
117
118 (% style="text-align:center" %)
119 [[image:http://docs.we-con.com.cn/wiki/pistudio/download/Helps/11.Advanced%20Function/WebHome/%E9%82%AE%E4%BB%B6%201.png?width=597&height=780&rev=1.2||alt="邮件 1.png" data-xwiki-image-style-alignment="center" height="690" width="528" class="img-thumbnail"]]
120
121 (**1) SMTP Settings**
122
123 **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.
124
125 **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.
126
127 **3) Confirm Password: **Confirm the password or authorization code of the mailbox.
128
129 **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]].
130
131 **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.
132
133 (% class="table-bordered" %)
134 |=Email|=Email server|=Port number
135 |163 email|smtp.163.com|465
136 |126 email|smtp.126.com|465
137 |QQ email|smtp.qq.com|465
138 |Sina email|smtp.sina.com|465
139 |Sohu email|smtp.sohu.com|465
140 |Yahoo email|smtp.mail.yahoo.com.cn|465
141 |Google email|smtp.gmail.com|465
142
143 **✎Note:**
144
145 Gmail also needs to enable the [allow unsafe apps] option in the account, otherwise the mail will not be sent normally.
146
147 **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.
148
149 **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.
150
151 * 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.
152 * 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.
153 * 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.
154
155 **✎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.
156
157 **8) Error Message**
158
159 Set the error message receiving address, you could use the information to get the reasons of errors.
160
161 The error types in the mail function are divided into two types: custom rule error and server's error.
162
163 Custom rule errors are as follows.
164
165 (% class="table-bordered" %)
166 |=**Message**
167 |Email settings are incorrect
168 |Email account is incorrect
169 |Email password could not include blank
170 |the settings of SMTP server are incorrect
171 |The range of SMTP server ports number should be integer, which is between 1 and 65535.
172 |The type of encryption for SMTP is incorrect
173 |The name of sender or email address setting is incorrect.
174 |The names of Recipients or email address setting are incorrect.
175 |The names of CC recipients or email address setting are incorrect.
176 |The names of Secret delivery recipients or email address setting are incorrect.
177 |Email topic could not be blank
178 |Email content could not be blank
179 |Total size of attachments should be below 25M
180 |Attachment "xxxx" is nonexistent
181
182 Server's errors are as follows.
183
184 (% class="table-bordered" %)
185 |=**Message**
186 |smtp-server: 554 DT: SPM
187 |smtp-server: 550 RP: TRC
188 |smtp-server: 550 Limitation of connecting counts
189 |smtp-server: 535
190 |smtp-server: 550 Error: Content rejected
191 |smtp-server: 451 Internal server error
192 |smtp-server: 535 Invalid login user or password
193 |smtp-server: 550 too many sending requests today
194 |smtp-server: 452 Too many recipients received this hour.
195 |smtp-server: 535 Error: Authentication failed, system busy
196 |could not connect: Connection timed out
197 |Unexpected EOF on SMTP connection
198 |could not initiate SSL/TLS connection
199 |smtp-server: 530 Need to issue a STARTTLS command first.
200 |could not resolve host
201 |could not connect: Connection timed out
202 |could not connect: Connection refused
203 |smtp-server: 550 User not found: aaa.163.com
204
205 **9) Manual Trigger**
206
207 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.
208
209 (% class="table-bordered" %)
210 |=**Address**|=**Description**
211 |HDX100.0|Sending trigger
212 |HDX101.0 to HDX101.15|It is used for triggering recipient groups, for example, HDW101.0 set ON, and the address in group 1 will be in recipient list.
213 |HDX103.0 to HDX103.15|It is used for triggering recipient groups, for example, HDW103.0 set ON, and the address in group 1 will be in CC list.
214 |HDX105.0 to HDX105.15|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).
215 |HDW107 to HDW171|The subject length is limited to 64 words. (If it exceeds, it will intercept 64 words of content)
216 |HDW172 to HDW300|The content length is limited to 128 words. (If it exceeds, it will intercept 128 words of content)
217 |HDX301.0|Whether to send an alarm record attachment (a file named AlarmDataFile.db)
218
219 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.
220 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.
221 1. Emails that sent manually would only be sent once no matter the sending error is custom error, network or other errors.
222
223 == **Email sending settings** ==
224
225 (% style="text-align:center" %)
226 [[image:http://docs.we-con.com.cn/wiki/pistudio/download/Helps/11.Advanced%20Function/WebHome/%E9%82%AE%E4%BB%B6%202.png?rev=1.2||alt="邮件 2.png" data-xwiki-image-style-alignment="center" height="523" width="871" class="img-thumbnail"]]
227
228 1. **Add. **A maximum of 1024 email can be added.
229 1. **Modify.** Select an email to modify the content and configuration.
230 1. **Delete. **You could select an email to delete or click the "ID" column to delete in batch.
231
232 (% style="text-align:center" %)
233 [[image:http://docs.we-con.com.cn/wiki/pistudio/download/Helps/11.Advanced%20Function/WebHome/%E9%82%AE%E4%BB%B6%203.png?width=744&height=578&rev=1.1||alt="邮件 3.png" data-xwiki-image-style-alignment="center" height="507" width="653" class="img-thumbnail"]]
234
235 **(1) Email sending configuration.**
236
237 **1) Theme. **The value cannot be empty and case sensitive. The total length  cannot exceed 256 characters.
238
239 **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.
240
241 * **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.
242 * **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.
243 * **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.
244
245 **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.
246
247 **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.
248
249 * 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.
250 * 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.
251
252 **5) Recipient.** It is set in groups. You could send  multiple groups, and each group can have multiple recipients.
253
254 **6) Add CC.** Sends the current email to other recipients.
255
256 **7) Add secret delivery. ** Sends the current email to other recipients, but the recipient and cc recipients do not see the BCC recipient.
257
258 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.
259
260 **8) Recipient priority. **Set the priority order of recipients to recipient, BCC, and CC.
261
262 **✎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.
263
264 == **Recipient group setting** ==
265
266 (% style="text-align:center" %)
267 [[image:http://docs.we-con.com.cn/wiki/pistudio/download/Helps/11.Advanced%20Function/WebHome/%E9%82%AE%E4%BB%B6%204.png?rev=1.1||alt="邮件 4.png" data-xwiki-image-style-alignment="center" height="586" width="820" class="img-thumbnail"]]
268
269 1. **All Group.** The groups you added.
270 1. **Group to send. **The groups that you send the emails to.
271 1. **Open recipinet settings.** Set the information of recipients, and add and subtract groups.
272
273 == **Recipient setting** ==
274
275 (% style="text-align:center" %)
276 [[image:http://docs.we-con.com.cn/wiki/pistudio/download/Helps/11.Advanced%20Function/WebHome/%E9%82%AE%E4%BB%B6%205.png?rev=1.1||alt="邮件 5.png" data-xwiki-image-style-alignment="center" height="537" width="823" class="img-thumbnail"]]
277
278 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.
279
280 (% style="text-align:center" %)
281 [[image:http://docs.we-con.com.cn/wiki/pistudio/download/Helps/11.Advanced%20Function/WebHome/%E9%82%AE%E4%BB%B6%206.png?rev=1.1||alt="邮件 6.png" data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
282
283 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.
284 1. **Delete.** Select one recipient or multiple recipents to delete, or click the ID column to select all.
285 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.
286 1. **Description. **To decribe the group information. The total length shall not exceed 32.
287
288 == **Test sending settings** ==
289
290 (% style="text-align:center" %)
291 [[image:http://docs.we-con.com.cn/wiki/pistudio/download/Helps/11.Advanced%20Function/WebHome/%E9%82%AE%E4%BB%B6%207.png?rev=1.4||alt="邮件 7.png" data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
292
293 **✎Note: **
294
295 * You can open this after the SMTP server is set.
296 * 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.
297 * When TOM mail is sender's mail, the name of it and the recipient tested must be English, otherwise the email would be returned.
298 * When testing with Zoho mailbox, there was a delay of less than 3 minutes.
299 * The custom errors for the test error is as follows.
300
301 (% class="table-bordered" %)
302 |=Error code|=Cause of reason
303 |0|CSMTP_NO_ERROR
304 |100|WSA_STARTUP = Unable to initialize winsock2
305 |101|WSA_VER = Wrong version of the winsock2
306 |102|WSA_SEND = Function send() failed
307 |103|WSA_RECV = Function recv() failed
308 |104|WSA_CONNECT = Function connect failed
309 |105|WSA_GETHOSTBY_NAME_ADDR = Unable to determine remote server
310 |106|WSA_INVALID_SOCKET = Invalid winsock2 socket
311 |107|WSA_HOSTNAME = Function hostname() failed
312 |108|WSA_IOCTLSOCKET = Function ioctlsocket() failed
313 |109|WSA_SELECT
314 |110|BAD_IPV4_ADDR = Improper IPv4 address
315 |200|UNDEF_MSG_HEADER = Undefined message header
316 |201|UNDEF_MAIL_FROM = Undefined mail sender
317 |202|UNDEF_SUBJECT = Undefined message subject
318 |203|UNDEF_RECIPIENTS = Undefined recipient
319 |204|UNDEF_RECIPIENT_MAIL = Undefined mail recipent
320 |205|UNDEF_LOGIN = Undefined user login
321 |206|UNDEF_PASSWORD = Undefined user password
322 |207|BAD_LOGIN_PASSWORD = Invalid user login or password
323 |208|BAD_DIGEST_RESPONSE = Server returned a bad digest MD5 response
324 |209|BAD_SERVER_NAME = Unable to determine server name for digest MD5 response
325 |300|COMMAND_MAIL_FROM = Server returned error after sending MAIL FROM
326 |301|COMMAND_EHLO = Server returned error after sending EHLO
327 |302|COMMAND_AUTH_PLAIN = Server returned error after sending AUTH PLAIN
328 |303|COMMAND_AUTH_LOGIN = Server returned error after sending AUTH LOGIN
329 |304|COMMAND_AUTH_CRAMMD5 = Server returned error after sending AUTH CRAM-MD5
330 |305|COMMAND_AUTH_DIGESTMD5 = Server returned error after sending AUTH DIGEST-MD5
331 |306|COMMAND_DIGESTMD5 = Server returned error after sending MD5 DIGEST
332 |307|COMMAND_DATA = Server returned error after sending DATA
333 |308|COMMAND_QUIT = Server returned error after sending QUIT
334 |309|COMMAND_RCPT_TO = Server returned error after sending RCPT TO
335 |310|MSG_BODY_ERROR = Error in message body (邮件正文中出现错误)
336 |400|CONNECTION_CLOSED = Server has closed the connection
337 |401|SERVER_NOT_READY = Server is not ready
338 |402|SERVER_NOT_RESPONDING = Server not responding
339 |403|SELECT_TIMEOUT
340 |404|FILE_NOT_EXIST = File not exist
341 |405|MSG_TOO_BIG = Message is too big
342 |406|BAD_LOGIN_PASS = Bad login or password
343 |407|UNDEF_XYZ_RESPONSE = Undefined xyz SMTP response
344 |408|LACK_OF_MEMORY = Lack of memory
345 |409|TIME_ERROR = time() error
346 |410|RECVBUF_IS_EMPTY = RecvBuf is empty
347 |411|SENDBUF_IS_EMPTY = SendBuf is empty
348 |412|OUT_OF_MSG_RANGE = Specified line number is out of message size
349 |413|COMMAND_EHLO_STARTTLS = Server returned error after sending STARTTLS
350 |414|SSL_PROBLEM = SSL problem
351 |415|SSL_PROBLEM = SSL problem
352 |416|STARTTLS_NOT_SUPPORTED = The STARTTLS command is not supported by the server
353 |417|LOGIN_NOT_SUPPORTED = AUTH LOGIN is not supported by the server
354
355 == **Email status** ==
356
357 **(1) Network disconnection error**
358
359 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.
360
361 **(2) Custom rule error**
362
363 If the fault is determined as a custom rule error, delete the information.
364
365 **(3) Server return error**
366
367 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.
368
369 (% class="table-bordered" %)
370 |=**Server name**|=**The number of sent**|=**Consequences of exceeding the limit**
371 |126|160|No more delivery on that day
372 |163|160|No more delivery on that day
373 |we-con|800|No more delivery on that day
374 |qq|50|It can be sent again after a few minutes or a few hours
375 |sohu|160|No more delivery on that day
376 |sina|50|It can be sent again after a few minutes or a few hours, but cannont be received normally
377 |gmail|500|No more delivery on that day
378
379 **(4) Message Prompt**
380
381 1. If the email to be sent is deleted, a message will pop up.
382 1. If the email is sent successfully, a messge will pop up: "The email is sent successfully."
383 1. If the five symbols ',' , ' | ', '<', '>' and '&' appear in the fields set by the message prompt, the message prompt will display an abnormal message.
384
385 **(5) Mail attachment**
386
387 Currently, the email attachment function only supports sending the specified alarm record (AlarmDataFile.db file), and does not support selecting content to send.
388
389 = **{{id name="_Toc21437"/}}{{id name="_Address_Library"/}}Address** =
390
391 Address library contains commonly used addresses. It not only avoids setting the addresses repeatedly but also expresses the function of an address more clearly.
392
393 Click "Project"-"Address" to open the setting window.
394
395 (% style="text-align:center" %)
396 [[image:地址库 1.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
397
398 (% style="text-align:center" %)
399 [[image:地址库 2.png||data-xwiki-image-style-alignment="center" height="429" width="659" class="img-thumbnail"]]
400
401 (% class="table-bordered" %)
402 |=(% style="width: 155px;" %)**Item**|=(% style="width: 689px;" %)**Description**
403 |(% style="width:155px" %)Word Address|(% style="width:689px" %)Select [Word Address] to display word addresses in list
404 |(% style="width:155px" %)Bit Address|(% style="width:689px" %)Select [Bit Address] to display bit addresses in list
405 |(% style="width:155px" %)Add|(% style="width:689px" %)Add a set of address to display in the address library to associate addresses with identifiers
406 |(% style="width:155px" %)Insert|(% style="width:689px" %)Insert (add) an new address before selected item in list
407 |(% style="width:155px" %)Edit|(% style="width:689px" %)Edit selected item
408 |(% style="width:155px" %)Delete|(% style="width:689px" %)Delete selected item in list
409 |(% style="width:155px" %)Up|(% style="width:689px" %)Move the selected item up one line
410 |(% style="width:155px" %)Close|(% style="width:689px" %)Close current setting window
411 |(% style="width:155px" %)Export EXCEL|(% style="width:689px" %)Export address library to PC as excel file
412 |(% style="width:155px" %)Import EXCEL|(% style="width:689px" %)Import address library from excel file
413 |(% style="width:155px" %)Clear|(% style="width:689px" %)Delete all items in list
414 |(% style="width:155px" %)Down|(% style="width:689px" %)Move the selected item down one line;
415 |(% style="width:155px" %)Help|(% style="width:689px" %)Click it to open help document;
416
417 **Operating procedures of creating new address**
418
419 (% style="text-align:center" %)
420 [[image:7.Library_html_7780dffdef1ce220.png||data-xwiki-image-style-alignment="center" height="420" width="553" class="img-thumbnail"]]
421
422 1. Click "Add" to open address edit window.
423 1. Set "Address name".
424 1. Set address.
425 1. Set PLC station number (It is not necessary setting, the user sets according to the actual situation).
426
427 **✎Note:**
428
429 Address Library: it supports importing addresses information from Excel files. However, the following two points need to be noted:
430
431 1. When importing an Excel file, if the contents of a certain Name, Type, and Address are all empty, the information of the subsequent ID will not be imported.
432 1. When importing Excel files, if there is pure digital content in the imported information, you need to set the format of the table box to "text" mode. Otherwise, the text import fails or an error occurs due to incorrect information format.
433
434 = **Mapping** =
435
436 Address mapping is to build the relationship between two different addresses. Forwarding address from source address to target address, so the value in both addresses would be same according to the predefined mapping mode. Both addresses could be from different, in this way, to make HMI processing faster.
437
438 For example:
439
440 Forward "D0" to "HDW100" (length: 10), so the address D0, D1,..., D9 would be related to HDW100, HDW101, .., HDW109.
441
442 **Description**
443
444 (% style="text-align:center" %)
445 [[image:8-1AddressMapping.png||data-xwiki-image-style-alignment="center" height="673" width="659"]]
446
447 **(1) Address type**
448
449 It is used for selecting address type in address mapping.
450
451 **(2) Source address**
452
453 The origin address that need to be mapped to other addresses. If there is calculation, 2 source addresses are required, and the result would be saved in "target address".
454
455 **Data type: **Only word address need to set data type. If it is the address of 32-bit register, check "32-bit register".
456
457 **(3) Calculation**
458
459 Designated mathematical relationship between two source addresses, the result will be saved in target address.
460
461 **(4) Length**
462
463 It is used to set the length of the operation address.
464
465 **For example**
466
467 Source address is D0, target address is 40, and length is 10.
468
469 **Result**
470
471 * 40=D0
472 * 41=D1
473 * ...
474 * 48=D8
475 * 49=D8
476
477 **(5) Mode**
478
479 It provides two modes, Read-write and read only. The value of source address would not change if target value changed after read only selected.
480
481 **(6) Update frequency**
482
483 It provides two modes, general and read-through.
484
485 **General: **Read data from HMI cache (Recommended)
486
487 **Read-Through: **Read data directly from the device without going through the HMI cache
488
489 **(7) Mapping**
490
491 This is control bit for mapping one item, the default mode is mapping when OFF; If user want to change control condition, please check [Mapping when ON];
492
493 **(8) Target address:**
494
495 It is address used to store source address data;
496
497 **(9) Cont. Write:**
498
499 Write address length for single time, used for some special device addresses that need to be written continuously;
500
501 **(10) Global mapping control**
502
503 The function and mode are similar to [Mapping], but it is used to control all mapping items. The setting screen as below show;
504
505 (% style="text-align:center" %)
506 [[image:7.Library_html_a04eddcc1d2f2f14.png||data-xwiki-image-style-alignment="center" height="199" width="419" class="img-thumbnail"]]
507
508 **(11 )Buttons**
509
510 * **Clear:** Delete all settings in settings, such as [Source address], [Length] and so on.
511 * **Add:** Create a new mapping item.
512 * **Edit:** Change selected item.
513 * **Delete:** Delete selected item.
514 * **Clear list: **Delete all mapping items in list.
515 * **Close: **Close address mapping window.
516 * **Help:** Click it to open help document.
517
518 **(12) Item List**
519
520 It lists all address mapping items.
521
522 **✎Note:**
523
524 * Too many [Read-Through] items will cause HMI running slow.
525 * If there are multiple consecutive addresses, please increase the length to reduce the mapping items
526
527 **Fucntion descrition**
528
529 Address mapping is to map the source address to the destination address or the two source addresses are mapped to the destination address by some operation. The source and destination addresses can be PLC addresses or internal addresses or from different serial ports.
530
531 For example: Map D0 to HDW100, the map length is 10, then the value of D0 to D9 are mapped to HDW100 to HDW109.
532
533 There are two map methods: read and write and read-only.
534
535 1. **Read and write: **If the value of source address is changed, the value of the destination address changes accordingly. After the value of the destination address is changed, the value of the corresponding source address does not change. Four some four operations or logical operations, they can only be selected in this way.
536 1. **Read-only: **If the value of source address is changed, the value of the destination address changes accordingly. After the value of the destination address is changed, the value of the corresponding source address changes too. Four some four operations or logical operations, they can not be selected in this way.
537
538 There can be two sets of source addresses, and mapping the results to the destination address through operations (four operations or logical operations). For example: source address 1 is HDW100, source address 2 is HDW200, Map to destination address HDW300 by addition and the map length is 10.
539
540 * HDW300=HDW100+HDW200
541 * HDW301=HDW101+HDW201
542 * HDW309=HDW109+HDW209
543
544 Yon could use the bit address to control whether to enable the mapping function. There is one bit address for bits and one for words. Each mapping block also has a bit address. For bit address mapping and word address mapping, there are controlled by their own global bit addresses. Each mapping block relationship can also have its own control address, but the global control bit address has a high priority.
545
546 **✎Note:**
547
548 1. Some of four operations do not have inverse operation such as trigonometric function, shift, remainder and so on. They can only be read-only.
549
550 * For example: If HDW100 is devided by HDW200, and the value is mapping to HDW300. When the value of HDW300 changes, the vaue of HDW100 will not change. Because you can't calculate what the HDW100 value should be.
551
552 (% start="2" %)
553 1. The maximum length of each mapping block is 65535.
554 1. If there is no bit address to control the mapping, the mapping is enabled by default. If you set the bit address, the mapping is disabled when the value of the bit address is 1 and it is enabled when the value of the bit address is 0. If you select "control on closed state", the result is opposite.
555 1. Update frequency refers to the update frequency of reading device data. The default is 0.
556
557 * Normal read speed is 0, read through value is 1, fast read value is 2. There is no need to fill in the data type in address mapping. The selection of "32-bit register" is special for some PLC whose address interval is 1 in 32 bits. You don't have to choose it.