Skip to Content

Wiki source code of 06 Data Tool

Version 10.1 by Hunter on 2022/07/09 10:24
Show last authors
1 (% class="wikigeneratedid" id="H8BasicFunction" %)
2 This chapter provides information about basic functions and configuration in PIStudio.
3
4 = **Alarm** =
5
6 == **Bit alarm** ==
7
8 Click "Project"->"Bit alarm", it is displayed as the following figure.
9
10 (% style="text-align:center" %)
11 [[image:位报警 1.png||data-xwiki-image-style-alignment="center" class="img-thumbnail"]]
12
13 **(1) Group No.: **Group number of Bit alarm. The name is unique and cannot be duplicated.
14
15 **(2) Bit Address: **Bit address of alarm monitoring
16
17 (% start="1" %)
18 1. **Record bit alarm by default:**  Whether to record the alarm history data of bit alarm, if checked, it will be saved in the designated storage location.
19 1. **Not save alarm OFF:** If checked, after the alarm is dismissed, the corresponding alarm records will be deleted from the log file.
20
21 **(3) Upload to Cloud: **The data upload by "bit alarm" is stored in the Cloud and it is alarm data. (Only ig series and 8000/9000 series after system upgrade are supported)
22
23 **(4) Alarm Condition:** It sets alarm trigger condition, there are two types: alarm when ON and alarm when OFF.
24
25 **(5) Alert: **It is used to mark whether the alarm has occurred. if an alarm occurs, the address of "control bit" will be written to 1. If "clear alert when alarm OFF" is checked, the address of "control bit" will be written to 0.
26
27 **(6) Beep when alarm ON: **The beep works when the alarm is triggered. If "beep once" is checked, bit address alarm only beep once and stop.
28
29 **(7) Content: **It is used for setting alarm content (command).
30
31 **(8) Alarm Screen: **Pop-up alarm screen (it need to be sub-screen);
32
33 1. **Position: **The location of the screen alarm display.
34 1. **Pop-up Interval: **The time of reopen the alarm screen when alarm screen closed.
35 1. **Pop-up once: **Pop up alarm screen once, and the screen would not pop up again
36 1. **Close window when alarm off: **Automatically close the alarm screen when alarm off.
37
38 **✎Note:**
39
40 * If the "cloud" function is enabled and "upload to cloud" is checked, the communication port of the address in the configuration of the imported bit alarm record must be the same as that of the current project; otherwise, it cannot be used normally.
41 * The number of alarm configuration points reported to the cloud cannot exceed 20, or the sum of imported alarm records and the current alarm records cannot exceed 20. If it exceeds, please reconfigure.
42
43 **Operating Procedures of Adding One Alarm**
44
45 1. Click "Project"->"Bit Alarm" as below shows.
46
47 (% style="text-align:center" %)
48 [[image:8.Basic Function_html_5f8da20315334bac.png||data-xwiki-image-style-alignment="center" height="144" width="539" class="img-thumbnail"]]
49
50 (% start="2" %)
51 1. Click "Add" button to open "Bit Alarm" setting window.
52
53 (% style="text-align:center" %)
54 [[image:8.Basic Function_html_94a019683b506e15.png||data-xwiki-image-style-alignment="center" height="307" width="554" class="img-thumbnail"]]
55
56 (% start="3" %)
57 1. Set "Bit Address".
58 1. Set "Alarm Condition".
59 1. Set "Content".
60 1. Other settings can be set according to the actual situation".
61 1. Click "OK" button to complete settings.
62
63 == **Word Alarm** ==
64
65 Word alarm is to monitor the word address of a device. If the data meets the set conditions, an alarm will be generated.
66
67 Click "Project"->"Word alarm", it is displayed as the following figure.
68
69 (% style="text-align:center" %)
70 [[image:字报警 1.png||class="img-thumbnail"]]
71
72 **(1) Alarm Name:** You can set alarm name for it. Alarm Name can only consist of (0~~9), (a~~z), (A~~Z), ('_'), (' ') and other non-English characters.
73
74 **(2) Alarm Address: **It is used for setting word address for word alarm, such as HDW0.
75
76 **(3) Data Format: **16-bit unsigned decimal, 16-bit signed decimal, 16-bit BCD, 32-bit unsigned decimal, 32-bit signed decimal, 32-bit BCD, 32-bit float.
77
78 **(4)  Group No.: **Group number of word alarm. The name is unique and cannot be duplicated.
79
80 **(5) Upload to Cloud: **The data upload by "word alarm" is stored in the Cloud and it is alarm data. (Only ig supported)
81
82 **✎Note:**
83
84 * If the "cloud" function is enabled and "upload to cloud" is checked, the communication port of the address in the configuration of the imported word alarm record must be the same as that of the current project; otherwise, it cannot be used normally.
85 * The number of alarm configuration points reported to the cloud cannot exceed 20, or the sum of imported alarm records and the current alarm records cannot exceed 20. If it exceeds, please reconfigure.
86
87 **(6) Record alarm:**  Whether to record the alarm history data of word alarm, if checked, it will be saved in the designated storage location.
88
89 **(7) Not save alarm OFF:** If checked, after the alarm is dismissed, the corresponding alarm records will be deleted from the log file.
90
91 **(8) Alarm Condition**: Alarm is triggered when designated address meets the alarm condition, it provides four conditions;
92
93 1. **High alarm:** Alarm is triggered when it reaches high limit. It can be a constant or a variable
94 1. **Low alarm:** Alarm is triggered when it reaches low limit. It can be a constant or a variable
95 1. **Range alarm:** Alarm is triggered when it exceeds the range. It can be a constant or a variable
96 1. **Equivalent alarm: **Alarm is triggered when the value equals to the given data. It can be a constant or a variable
97
98 **(9) Alarm Info: **It is used for setting alarm content (command);
99
100 **(10) Alert: **It is used to mark whether the alarm has occurred. if an alarm occurs, the address of "control bit" will be written to 1. If "clear alert when alarm OFF" is checked, the address of "control bit" will be written to 0.
101
102 **(11) Alarm Screen: **Pop-up alarm screen (it need to be sub-screen);
103
104 1. **Position: **The location of the screen alarm display.
105 1. **Pop-up Interval: **The time of reopen the alarm screen when alarm screen closed.
106 1. **Pop-up once: **Pop up alarm screen once.
107 1. **Close window when alarm off: **Automatically close the alarm screen when alarm off.
108
109 **(12) Beep when alarm ON: **beep works when the alarm is triggered, in the default mode, the beep works until the alarm is released.
110
111 **(13) Beep once:** Beep works once, when alarm is triggered.
112
113 **(14) Alarm List**
114
115 It displays all the word alarm lists; it will show the alarm information;
116
117 **Operating Procedures of Adding One Alarm**
118
119 1. Click "Project"-> "Word Alarm" as below shows.
120
121 (% style="text-align:center" %)
122 [[image:8.Basic Function_html_1b59522c984cd7c2.png||height="144" width="492" class="img-thumbnail"]]
123
124 (% start="2" %)
125 1. Click [Add] button to open [Word Alarm] setting window.
126
127 (% style="text-align:center" %)
128 [[image:8.Basic Function_html_942107c81fc6901c.png||height="307" width="554" class="img-thumbnail"]]
129
130 (% start="3" %)
131 1. Set Basic information of word alarm.
132 1. Set "Content".
133 1. Other settings can be set according to the actual situation.
134 1. Click "OK" button to complete settings.
135
136 **HMI Alarm Demo Download Link**
137
138 [[https:~~/~~/drive.google.com/open?id=1Llq03CMISM_1mMIfU308hxFbs4rGdQGP>>url:https://drive.google.com/open?id=1Llq03CMISM_1mMIfU308hxFbs4rGdQGP]]
139
140 = **{{id name="_Toc17174"/}}{{id name="_Recipe"/}}Recipe** =
141
142 Traditional recipe is composed of multiple groups of information with the same structure and different data. Due to the similarity of these information, you could edit them into a set of recipes to facilitate the transfer of data between HMI and PLC.
143
144 Data operation
145
146 1. **Read:** Read a group of data from the recipe file and assign the group of data to the set address.
147 1. **Write: **Read a group of data from the set address and assign the group of data to the corresponding recipe file.
148
149 PI Series HMI has Recipe function, Recipe function keeps data in the HMI, used to download the data from HMI to designated device addresses, or upload the data from device addresses to HMI.
150
151 The maximum number of group in recipe is 1000, and the maximum number of member in each group is 1500.
152
153 Recipe could store the data in USB flash disk and SD card and view the recipe data by object "Recipe display". It has two mode: simple mode and advanced mode.
154
155 1. **Simple: **Only support the data operation of one recipe file, including read and write.
156 1. **Advanced:** Support the data operation of multiple recipe files, including read, write, insert and index. View and select recipe file by object "File list".
157
158 Recipe function settings will be display in "[[Recipe display>>http://docs.we-con.com.cn/wiki/pistudio/view/Helps/06.Objects/#HRecipedisplay]]" object.
159
160 **Description**
161
162 (% style="text-align:center" %)
163 [[image:8-1Recipe.png]]
164
165 **(1) Basic**
166
167 1. **Recipe Folder:** Give Recipe folder name (It can be used, when setting Recipe display object);
168
169 * **✎Note: **Recipe Folder name can only consist of (0~~9), (a~~z), (A~~Z), ('_'), (' ') and other non-English characters;
170
171 (% start="2" %)
172 1. **Group: **It sets the groups' initial number of recipe;
173 1. **Elements:** It sets members' initial number of each group;
174 1. **Data Format:** There are some formats can be supported in Recipe, like 16-bit BCD, 16-bit signed, 16-bit unsigned, 32-bit BCD, 32-bit signed, 32-bit unsigned, 32-bit floating and string. If each member requires different formats, please set it one by one in form;
175 1. **Decimal: **It sets integer and scale digits;
176
177 **(2) Mode Selection**
178
179 Users could select Simple or Advanced mode.
180
181 **(3) Function Address:**
182
183 All the operations for recipe is by this address
184
185 * =0 No operation.
186 * =1 Read data from recipe.
187 * =2 Insert a new group or write data to exist group.
188 * =4 Inserted (only advanced mode).
189 * =8 Delete.
190 * =16 Delete and Sequence.
191
192 **(4) Use Multiple File**
193
194 Check it to use more than one recipe file in HMI, but this option only valid in [Advanced mode];
195
196 **(5) Select language**
197
198 The text in HMI can be in 8 languages, user can set language in here;
199
200 **(6) Address**
201
202 1. **Group:** This address is for selecting group number;
203 1. **Start: **This is starting address is for reading and writing in recipe, PIStudio will automatically assigns addresses for each members;
204 1. **File(16 words): **This address only available when enable the Use Multiple File. This setting address is for input the recipe file's filename.
205
206 **(7) Use Index**
207
208 If the value from Group address is changed, Read address will display the new data according to new group number immediately. Relatively, if the data of write address is changed, the corresponding group from table is also changed.
209
210 **(8) Query by Element**
211
212 Enable it for querying group by specify element, select a primary key from all the elements, except the group number. This element value from all groups must be unique if want to set as primary key;
213
214 **✎Note: **When this option is enabled, Group address will be invalid.
215
216 **(9) Use Independent Write Address**
217
218 To separate Recipe read address and write address.
219
220 **(10) Use Insert**
221
222 It inserts data into the specified group, if the specified group already exists, it would not cover the original data, while it will move the original group next one after it.
223
224 **(11) Discontinuous Address**
225
226 Whether enable the non-consecutive recipe operation addresses or not. If disabled, the recipe address will recover as the continuous addresses.
227
228 **✎Note: **This function only supported in HMI+, i series, ie series, ig series.
229
230 **Operating Procedures**
231
232 1) Click "Project"->"Bit Alarm" as below shows.
233
234 (% style="text-align:center" %)
235 [[image:8.Basic Function_html_a7d1546a3a9f752f.png||height="144" width="535" class="img-thumbnail"]]
236
237 2) Click "Add" button to open "Recipe" setting window.
238
239 (% style="text-align:center" %)
240 [[image:8.Basic Function_html_8f04e01413981054.png||height="307" width="554" class="img-thumbnail"]]
241
242 3) Set basic settings for recipe.
243
244 4) Select mode according to actual condition.
245
246 5) Other settings can be set according to the actual situation.
247
248 6) Click [OK] button to complete settings.
249
250 **Recipe Demo Download Link**
251
252 [[https:~~/~~/drive.google.com/open?id=1Cjbq_tW-NIirHFBpxt47g7IKvoYaWqUR>>url:https://drive.google.com/open?id=1Cjbq_tW-NIirHFBpxt47g7IKvoYaWqUR]]
253
254 = (% style="color:inherit; font-family:inherit; font-size:29px" %)**Traditional Recipe**(%%) =
255
256 Traditional recipe is composed of multiple groups of information with the same structure and different data. Due to the similarity of these information, you could edit them into a set of recipes to facilitate the transfer of data between HMI and PLC.
257
258 Traditional recipe function is valid only when the LEVI project is converted to the PI project, and the original project uses the traditional recipe.
259
260 **✎Note**: Currently, only HMI+, i series, ie series, and ig series support the traditional recipe.
261
262 == **Simple recipe mode** ==
263
264 Click the "Traditional Recipe" [[image:8-2TraditionalRecipe.png]] in the "Data tool" bar in the upper side of the software, and the following interface will pop up:
265
266 (% style="text-align:center" %)
267 [[image:8-3TraditionalRecipeConfigScreen.png||class="img-thumbnail"]]
268
269 **✎Note**:
270
271 * The recipe folder name can only consist of (0~~9), (a~~z), (A~~Z), ('_'), ('').
272 * The element name of the recipe cannot include following 5 special characters: " **,** " , " **|** " , " **<** " , " **>** " , " **&** " .
273
274 == **Recipe display** ==
275
276 Select the file type "Traditional recipe file" in object "Recipe Display", and it is recommended to fill in the traditional recipe group number HSW1612 to the address of select line.
277
278 **✎Note**: The Recipe Display can display up to 50 groups of 100 elements, which can be to display out of range by enabled "Address Control", as following shown:
279
280 (% style="text-align:center" %)
281 [[image:8-4TraditionalRecipeDisplayConfigScreen.png||class="img-thumbnail"]]
282
283 == **Recipe transmission address** ==
284
285 The special addresses used in the Recipe are shown in the following table:
286
287 (% class="table-bordered" %)
288 |=Address|=Description|=Function
289 |HSW1611|Traditional Recipe transfer operation.|(((
290 ~=1: Recipe download.
291
292 ~=2: Recipe upload.
293 )))
294 |HSW1612|Traditional Recipe group number.|Traditional Recipe group number.
295 |(((
296 HSW242
297 )))|(((
298 Recipe operation result prompt:
299
300 Upload: Data is written to recipe file from address.
301
302 Download: Data is written to the address from recipe file.
303 )))|(((
304 ~=1: Recipe download, start.
305
306 ~=2: Recipe download, execution error.
307
308 ~=6: Recipe download, successful.
309
310 ~=7: Recipe upload, start.
311
312 ~=8: Recipe upload, execution error.
313
314 ~=11: Recipe group name does not exist.
315
316 ~=12: Recipe upload, successful.
317 )))
318
319 == **Recipe index** ==
320
321 The recipe index address RPW is mainly used for editing traditional recipes, and it is more convenient to modify the data and display of recipes. Only need to modify and display the data of the recipe file through "Numeric Input/Display" Object and "Word Switch".
322
323 The recipe index area (RPW)'s instruction as follows:
324
325 1. RPW~*~*~#~#~#~#, a total of six digits, the first two ~*~* represent the Recipe group number, ~#~#~#~# represents the element order number. For example, RPW010000 indicates the 1st element of the Recipe group No.1, and RPW110002 indicates the 3rd element of the Recipe group No.11.
326 1. If the indexed group number or element number does not exist, the value of RPW defaults to zero. For example, RPW110011 represents the 12th element of the Recipe group No.11. If it does not exist, the value returned by accessing RPW110011 is zero. The value written in RPW110011 will not be saved to the recipe file.
327
328 * **✎Note**: As long as RPW~*~*~#~#~#~# exists, any object "writes" to HPW~*~*~#~#~#~# will be saved to the recipe file. 
329
330 (% start="3" %)
331 1. The RPW register only supports word address access.
332 1. It can be known from the coding method of RPW~*~*~#~#~#~# that the range of RPW is from RPW000000-RPW990450, wherein the range of group number is 0-100, and the range of element is 0-450.
333
334 == **Recipe example** ==
335
336 The recipe index makes the modification and display of recipe data more convenient. Only need to modify and display the data of the recipe file through "Numeric Input/Display" Object and "Word Switch".
337
338 (1) Edit the recipe configuration, create three groups of recipes, 4 elements for per group: Red, green, blue, spraying time, as following shown:
339
340 (% style="text-align:center" %)
341 [[image:8-5TraditionalRecipeCaseConfig.png]]
342
343 (2) RPW 0~~3 can display the data of group for the selected line. RPW10000~~10003, RPW20000~~20003, RPW30000~~30003 each address can display the single element. Directly modify the content of the RPW address and then modify the recipe data, as following shown:
344
345 (% style="text-align:center" %)
346 [[image:8-7TraditionalRecipeCaseShowNoOpera.png]]
347
348 (3) After selecting the 2nd group, trigger the download button to download the whole group data to the corresponding element address (For this case, the data will write into HDW0~~3), or trigger the upload button to upload the content of the element address to the specified recipe group.
349
350 (% style="text-align:center" %)
351 [[image:8-6TraditionalRecipeCaseShow.png]]
352
353 = **{{id name="_Toc5565"/}}{{id name="_Trend_Chart"/}}Trend Chart** =
354
355 Trend chart function is used for displaying the real-time data in HMI as curve graph, which X axis represent as time, Y axis represent as data.
356
357 Click "Project" → "Trend chart", it will pop up the following screen. Click "Add" to creat new curve record.
358
359 (% style="text-align:center" %)
360 [[image:趋势图配置 001.png||class="img-thumbnail"]]
361
362 **Settings**
363
364 (% style="text-align:center" %)
365 [[image:趋势图设置 2.png||height="507" width="866"]]
366
367 **(1) Basic settings**
368
369 1. **Curve NO.: **It is for setting curve number,
370 1. **Curve Name:** It is for setting curve name. The length limitation is 31 bytes.
371 1. **Curve (1~~8):** It is for setting the number of curves. The default is 3.
372 1. **Dots of one curve: **It is for setting dots number of each curve. The default is 1000, but the maximum dots are 10,000 for all the curves.
373
374 **(2) Sample Type**
375
376 1. **Sample method:** There are two types, one is Cycle sample, the other is Trigger cycle sample. If you select Trigger cycle same mode, the trigger sample address is required to edit.
377 1. **Sample unit:** 100ms.
378
379 **(3) Quick Setting**
380
381 1. **Data format: **It is for setting all the curves, select the data format for all curves, and setting the reading addresses for curves. There are as follows.
382
383 (% style="text-align:center" %)
384 [[image:趋势图设置 3.png||class="img-thumbnail"]]
385
386 (% start="2" %)
387 1. **Sample address: **Fill in the start address that read the device data. If the sampl address is consecutive, check "use continuous address". For example, set HDW0 as start address, curve number is 3, then the HDW0 is for Curve 1, HDW1 is for Curve2, HDW2 is for Curve 3.
388
389 **(4) Curve Table:** The sample address you have set would display on it. Click the corresponding box to modify the content.
390
391 **✎Note: **Curve names can only consist of Chinese characters, (0~~9), (a~~z), (A~~Z), ('_') (' '), and other non-English characters.
392
393 **Trend Chart Demo Download Link**
394
395 [[https:~~/~~/drive.google.com/open?id=1smnaAvSxOWC0WQK4_uvqHXWn4vUZxGJC>>url:https://drive.google.com/open?id=1smnaAvSxOWC0WQK4_uvqHXWn4vUZxGJC]]
396
397 = **{{id name="_Toc7121"/}}{{id name="_History_XY_Plot"/}}History XY Plot** =
398
399 Different from TrendChart, uses need to set history XY curve items in project. Please click "Project"-> "History XY Plot" to open the setting screen.
400
401 Recipe function settings will be display in "[[History XY Plot>>path:http://docs.we-con.com.cn/wiki/pistudio/view/Helps/06.Objects/#HHistoryXYplot]]" object.
402
403 (% style="text-align:center" %)
404 [[image:历史XY 2.png||class="img-thumbnail"]]
405
406 (% style="text-align:center" %)
407 [[image:历史XY 3.png||class="img-thumbnail"]]
408
409 **(1) Basic settings**
410
411 1. **Curve NO.: **It is for setting curve number,
412 1. **Curve Name:** It is for setting curve name. The length limitation is 31 bytes.
413 1. **Curve (1~~8):** It is for setting the number of curves. The default is 3.
414 1. **Dots of one curve: **It is for setting dots number of each curve. The default is 1000, but the maximum dots are 10,000 for all the curves.
415
416 **(2) Sample Type**
417
418 1. **Sample method:** There are two types, one is Cycle sample, the other is Trigger cycle sample. If you select Trigger cycle same mode, the trigger sample address is required to edit.
419 1. **Sample unit:** 100ms.
420
421 **(3) Quick Setting**
422
423 1. **Data format: **It is for setting all the curves, select the data format for all curves, and setting the reading addresses for curves. There are as follows.
424
425 (% style="text-align:center" %)
426 [[image:image-20220616145435-1.png]]
427
428 (% start="2" %)
429 1. **Sample address: **Fill in the start address that read the device data. If the sample address is consecutive, check "use continuous address". For example, set HDW0 as start address, curve number is 3, then the HDW0 is for Curve 1, HDW1 is for Curve2, HDW2 is for Curve 3.
430
431 **(4) Curve Table:** The sample address you have set would display on it. Click the corresponding box to modify the content.
432
433 **✎Note: **Curve names can only consist of Chinese characters, (0~~9), (a~~z), (A~~Z), ('_') (' '), and other non-English characters.
434
435 **Operating Procedure**
436
437 1. Click "Project" -> "History XY Plot" to open the function selecting windows.
438
439 (% style="text-align:center" %)
440 [[image:8.Basic Function_html_5da6ca44bd28acbe.png||height="144" width="533" class="img-thumbnail"]]
441
442 (% start="2" %)
443 1. Click "Add" button to open [History XY Plot] setting windows.
444
445 (% style="text-align:center" %)
446 [[image:8.Basic Function_html_6345b50ea55168fa.png||height="307" width="554" class="img-thumbnail"]]
447
448 1. Setting the function of History XY Plot.
449 1. Click "OK" to save the setting.
450
451 **Download Link**
452
453 [[https:~~/~~/drive.google.com/open?id=1t4_HuRmIJJ-B5ryA2kVMadD9FywKhZ4r>>url:https://drive.google.com/open?id=1t4_HuRmIJJ-B5ryA2kVMadD9FywKhZ4r]]
454
455 = (% style="color:inherit; font-family:inherit; font-size:29px" %)**Data Record**(%%) =
456
457 The data record function is organized according to the structure below. In a project, there can be multiple record groups, each record group containing multiple channels. Different groups have different sampling times.
458
459 The topology is shown in the following figure.
460
461 (% style="text-align:center" %)
462 [[image:8.Basic Function_html_1b4bd09dafa7e049.png||height="332" width="554" class="img-thumbnail"]]
463
464 The data record stored in SD card is also organized according to the above figure.
465
466 The sample time and save time is consistent in the same record group. There are multiple channels in the group, When the sampling time is up, every channel would collect data to PLC register according to its own address.
467
468 **Sampling interval: **The interval between two consecutive samples was recorded.
469
470 As long as the project uses the data record function and supports the large-capacity storage module, the system will sample data according to the set sampling interval and save data according to the set saving interval.
471
472 For the file storage of data, see the file size configuration during data record configuration.
473
474 ✎**Note: **The record group name can only be composed of Chinese characters, (0~~9), (a~~z), (A~~Z), ('_'), ('') and other non-English characters.
475
476 (% class="wikigeneratedid" id="HSettings" %)
477 **Settings**
478
479 (% style="text-align:center" %)
480 [[image:数据记录设置 1.png||height="533" width="848" class="img-thumbnail"]]
481
482 **Operating Procedures**
483
484 1. Click "Project"->"Data record" as below shows.
485 1. Click "Add" button to open "Data record" setting window.
486 1. Enter group name, the default is "GroupName0"
487 1. Select "Trigger function" mode, such as "No trigger".
488 1. Set "Total channels", such as 3.
489 1. Click "Apply" button.
490 1. Set Sample cycle, such as 15.
491 1. Set "Start channel" in "Quick settings", such as 4 0.
492 1. Check group information in "Channel list" as below.
493 1. Click "Save" button to complete settings.
494
495 The figure above display the group of current project. The data record file would stored in "DataLogFile" folder, and the data of every  group would have a data file. The file suffix is in "db" format.
496
497 ✎**Note: **
498
499 * For HMI series 8000 and above, the size of a single file cannot exceed 300M and the total file capacity cannot exceed 1000M.
500 * For HMI series 3000, the size of a single file cannot exceed 4M and the total file capacity cannot exceed 10M.
501 * If the total amount exceeds the range, an alarm will be given during project compilation.
502
503 (% style="text-align:center" %)
504 [[image:数据记录设置 2.png||height="572" width="850" class="img-thumbnail"]]
505
506 **(1) Group name:** Set group name, and he name should be unique.
507
508 **(2) Trigger function:** There are four modes to trigger record.
509
510 1. **No trigger: **Data will be recorded in every sample time.
511 1. **Trigger to record by sample cycle: **Data will be recorded in every same time, when trigger control bit set ON.
512 1. **Trigger to record once and reset: **Data will be recorded when trigger control bit set ON, and the bit will be reset automatically.
513 1. **Trigger to record once: **Data will be recorded when trigger control bit set ON, and the bit need to be reset manually.
514 1. **Trigger address: **It is only valid when the trigger condition is selected. The monitoring cycle for trigger sampling address is 1s.
515
516 **(3) Total channels (1~~100): **Set the numbers of channels. Click "apply" to view the channel lists on the right record channel.
517
518 **(4) Sampling cycle: **If you check "collect control address", the sampling interval is the value of the address. The unit is second. For example, Sample cycle=15s. It means that records data one time every 15s.
519
520 **Timing address:** It sets address to change sample time when HMI is running;
521
522 **(5) Total records:** It sets data record number in one data record file. If the data file size is beyond the current file size. The old data will be deleted, and the new data will replace the old data. Please remember to back up the old data record file.
523
524 **Abnormal value:** It sets a value, when communication fails, data record will record this value;
525
526 **(6) Upload to Cloud**: The data uploaded by Data Record is stored in the Cloud(Only ig series). The maximum number of record is 20.
527
528 **(7) Quick Settings**
529
530 1. **Start Channel:** It sets the continuous addresses for channels.
531 1. **Data Format: **It sets the same data format for channels.
532 1. **Number of Digits:** It sets the digits’ number for channels.
533 1. **Language Settings**: The text in HMI can be in 8 languages, user can set language in here.
534
535 **(8) Channel List**: Besides quick settings, user can set channel name, address, data format, and so on one by one according to real situation.
536
537 **✎Note:**
538
539 * After enabling the Cloud function and checking the upload to the Cloud, the communication port settings of the address in the imported Data record configuration must be the same as the communication settings of the current project, otherwise it cannot be used normally.
540 * The range of upload to the Cloud from Data record configuration must not exceed 50, or the total number of imported Data records and the number of currently existing Data records must not exceed 50. If it exceeds, it will prompt you to reconfigure, should reduce the number.
541 * The channel name can only be composed of English characters, (0~~9), (a~~z), (A~~Z), ('_'), ('').
542 * The channel name does not include these 5 special characters: ", ", "| "," <", "> "," & ".
543 * The data would be overwritten automatically if the capacity exceed the maximum capacity. For 8000/9000 series, the size of single file cannot exceed 300MB, and total capacity of data records cannot exceed 1000MB. For 3000/3000i/3000ie series, the size of single file cannot exceed 4MB, and total capacity of data records cannot exceed 10MB. If the total amount exceeds the range , an error will be prompted when the project is compiled.
544
545 You could click here to jump to object "[[Data Record Display>>http://docs.we-con.com.cn/wiki/pistudio/view/Helps/06.Objects/#HDataRecordDisplay]]"
546
547 (% class="wikigeneratedid" id="H" %)
548 **PI Data Record Demo Download**
549
550 **[[Demo Link>>https://drive.google.com/open?id=1h7VUsIJqH4LIRjjtphbv9Kmzd6jUMPtE]]**
551
552 **[[Video Link>>https://drive.google.com/open?id=1h7VUsIJqH4LIRjjtphbv9Kmzd6jUMPtE]]**
553
554 = **{{id name="_Toc3497"/}}{{id name="_User_Permission"/}}User Permission** =
555
556 **Introduction**
557
558 1. User permission is one of expansion function in PI Series HMI; it provides multi-level of permission for control HMI operations.
559 1. User need to set the user and group during designing project. Different groups have different permission levels for accessing. Each user should be added into the specified group; it is possible to add the same user into different groups.
560 1. Operating record: it records user operations information, the records files are saved in HMI flash; its path is [~\~\flash~\~\UserOperationLogs.db].
561 1. When it is on simulator mode, the files are saved in C disk, its path is [C:~\~\WECON\UserMgrFile\UserOperationLogs.db].
562
563 ✎**Note: **The user name and password must be unique.
564
565 == **Settings** ==
566
567 **Open PIStudio software, then operate as the following figure.**
568
569 (% style="text-align:center" %)
570 [[image:用户权限 1.png||class="img-thumbnail"]]
571
572 1. Click "User Permission" in "Data Tool" toolbar.
573 1. Edit user name, click "User0" cell under "UserName", and then enter the user name, one project allows maximum 20 users.
574 1. Edit password, click "User0" cell under "PassWord", and then enter the user name.
575 1. Edit description, click "User0" cell under "Desc", and then enter, description is not necessary。
576 1. Check the groups for each user, there are 11 groups beside admin.
577 1. Editing groups' description, but it is not necessary.
578 1. {{id name="OLE_LINK7"/}}{{id name="OLE_LINK6"/}}Click "Save and Exit" button to complete all settings.
579
580 ✎**Note:**
581
582 * Only a maximum of one administrator permission is allowed in a profile with one user permission. If you want to use "Funtion address" to modify the user permission, you must log in the administrator account to operate.
583 * When the configured file does not have the administrator account, a new user can be added  through "Funtion address" and set as the administrator.
584 * If you select hidden fucntion when configuring user account, the account would display as "~*~*~*~*~*~*" in the list. You only need to enter the password of the corresponding hidden user to log in.
585
586 == **Object permission configuration** ==
587
588 (% style="text-align:center" %)
589 [[image:用户权限 2.png||class="img-thumbnail"]]
590
591 {{id name="OLE_LINK3"/}}{{id name="OLE_LINK4"/}}**Operation Procedure of Object Permission**
592
593 1. Open the object setting windows;
594 1. Select [Security] windows;
595 1. Check the [User Permission];
596 1. Select [Level] to set permission level;
597 1. Enter [Log Message], it is for operation records, if it was empty, the operation for this object would be not be recorded;
598 1. Select the ~[[[Access Denied Setting>>path:#_Security]]] mode;
599
600 **Log information description**
601
602 1. A combination of Chinese characters, numbers, and uppercase and lowercase letters can be entered, and the number does not exceed 63.
603 1. The format of insert variable:{variable address, data format}. e.g., {HDW100,UW2.1}.
604
605 The data format are as follows.
606
607 (% class="table-bordered" %)
608 |=Letter|=Meaning
609 |B|Binary
610 |O|Octonary
611 |U|Unsigned decimal
612 |H|Hexadecimal
613 |b|BCD
614 |F|32-bit float
615 |S|Signed decimal
616 |C|Character
617 |W|Single word
618 |D|Double word
619
620 (% start="3" %)
621 1. Examples.
622
623 * Unsigned decimal, BCD, 32-bit float and Signed decimal are as follows.
624
625 {HDW100,UW2.1}:  Indicates the variable address is HDW100. The data format are: unsigned decimal, single word, two integer bits, one decimal place.
626
627 * (((
628 Binary, Octonary and Hexadecimal are as follows.
629 )))
630
631 {HDW100,HD8}: Indicates the variable address is HDW100. The data format are: hexadecimal, double word, eight integer bits.
632
633 * (((
634 Character is as follows.
635 )))
636
637 {HDW100,C32}: Indicates the variable address is HDW100. The data format are: 32 characters.
638
639 When a record is generated, the contents of this variable are replaced by the value of your corresponding address.
640
641 == **Function address** ==
642
643 A user must first log in before performing an operation, and after the login is successful, the user can perform the required operation, and log out after completing the operation, making the operation permission invalid. User login, log out, modification of user password during operation and user management and other functions need to be configured.
644
645 HMI allows managing user accounts on screen. Including adding, deleting and editing the user account. HMI provide built-in screen for [Sign in] and [change password] (screen No. 1006 and 1007).
646
647 Functions and addresses are as follows.
648
649 (% class="table-bordered" %)
650 |=**Function**|=**Address**|=**Object type**|=**Address function**
651 |(% rowspan="3" %)Sign in|HUW1158~~1335|Drop down list|User name
652 |HUW1002|Character input object|Password
653 |HUW1000|Word Switch (Input 1)|OK (sign in)
654 |(% rowspan="5" %)Change password|HUW1158~~1335|Drop down list|User name
655 |HUW1002|Character input object|Old password
656 |HUW1006|Character input object|New password
657 |HUW1010|Character input object|Confirm password
658 |HUW1000|Word Switch (Input 2)|OK(change password)
659 |Sign out|HUW1000|Word Switch (Input 3) |Sign out
660 |(% rowspan="7" %)(((
661 New user ***1**
662 )))|HUW1014|Character input object|User name
663 |HUW1006|Character input object|password
664 |HUW1010|Character input object|Confirm password
665 |HUW1000|Word Switch (Input 4) |OK(add new user)
666 |HUW1336~~1345|Character input object|User description
667 |HUX1347.0|Bit switch|(((
668 ~=1: User hidden
669
670 ~=0: Visible (Defaults)
671 )))
672 |HUW1000|Word Switch (Input 8) |Save(add Hide features)
673 |(% rowspan="2" %)(((
674 Delete user ***2**
675 )))|HUW1158~~1335|Drop down list|User name
676 |HUW1000|Word Switch (Input 5)|OK (delete user)
677 |Delete Profile|HUW1000|Word Switch (Input 9)|OK(delete)
678 |Export Profile|HUW1000|Word Switch (Input 10)|OK(export)
679 |Import profile|HUW1000|Word Switch (Input 11)|OK(import)
680 |Export log file|HUW1000|Word Switch (Input 12)|OK(export)
681 |Delete log file|HUW1000|Word Switch (Input 13)|OK (delete)
682 |Current user name|HUW1349|Character object|32 Word
683 |System state information|HUW1030|Character input object|System state information
684 |(% rowspan="3" %)Permission settings|HUW1014|Character input object|User name
685 |HUW1348|Bit switch|(((
686 Set the user group:
687
688 HUX1348.0 = 1 administrator;
689
690 HUX1348.1 = 1 group 0 permission;
691
692 HUX1348.2 = 1 group 1 permission;
693
694 (Total group 0 - group 10)
695 )))
696 |HUW1000|Word Switch (Input 6)|Add user rights (set according to HUW1348)
697 |User login mode setting|HUW1382|Word Switch/Numeric input object|(((
698 0: Select a user name from the drop-down list
699
700 1: Use character input object (address HUW1014) to log in with a user name
701 )))
702
703 When the user performs a function operation, the operation result is displayed in the HUW1001.
704
705 (% class="table-bordered" %)
706 |=**Value (HUW1001)**|=**Meaning**
707 |1|Insufficient permissions.
708 |2|Username does not exist.
709 |3|Username already exists.
710 |4|Wrong username or password.
711 |5|Login successfully.
712 |6|Passwords are inconsistent in twice time.
713 |7|Password changed successfully.
714 |8|User added successfully.
715 |9|User deleted successfully.
716 |10|Maximum number of users exceeded.
717 |11|Admin user already exists.
718 |12|User permission modified successfully.
719 |13|File imported successfully.
720 |14|File imported failed.
721 |15|File exported successfully.
722 |16|File exported failed.
723 |17|Logout successfully.
724 |18|Profile deleted successfully.
725 |19|Log file deleted successfully.
726 |20|Hide settings modified successfully.
727 |21|Hide settings modified failed.
728 |22|(((
729 Password already occupied, please reset.
730
731 (For both username and password, it can not repetition)
732 )))
733
734 **✎Note:**
735
736 * *1: If there is an admin user account, then the new user can no longer add one more admin, that is, one project can only have one administrator account.
737 * *1: When adding new user, the password could not be duplicated with other users.
738 * *2: When deleting user, it is forbidden to delete the admin user.
739
740 **User Permission Demo Download**
741
742 [[https:~~/~~/drive.google.com/open?id=1qOiEDvo_1H1YqpoLDpS77dGaAFm8nrGq>>url:https://drive.google.com/open?id=1qOiEDvo_1H1YqpoLDpS77dGaAFm8nrGq]]
743
744 = **{{id name="_Toc29015"/}}{{id name="_MessagePrompt"/}}Message Prompt** =
745
746 A message box is a window used to show some prompts or warnings to users. For example, the application process a task in the process of pop-up message box, suggesting that "U disk has been detected", then the customer can carry out data dump function.
747
748 (% style="text-align:center" %)
749 [[image:消息提示 2.png||class="img-thumbnail"]]
750
751 (% style="text-align:center" %)
752 [[image:8.Basic Function_html_5ce2091d6f7cd732.png||height="515" width="704" class="img-thumbnail"]]
753
754 **(1) Message**
755
756 It includes system classes (u disk, SD card, and others), chart classes (alarm, data record, recipe, file list), curve classes (Trend Chart, historical XY trend Plot).
757
758 **(2) Control**
759
760 1. **Current item: **It shows selected message information.
761 1. **Use trigger address: **When the message is triggered, the trigger address would be set ON.
762
763 **For Example:**
764
765 Trigger address is 011, during inserting a USB flash disk into HMI, and 011 would be set ON, once HMI recognizes USB flash disk, and display message.
766
767 1. **Show message: **Check it to display message when HMI is running. It is checked by default.
768 1. **Show on web: **Check it to display message when remote access HMI screen, it is unchecked by default.
769
770 **(3) Message Content**
771
772 Each message has default content, but you could set different content according to the actual situation. And the same message could be displayed in 8 languages.
773
774 **(4) Reload Text: **It means discard changes.
775
776 **For Example**
777
778 User deletes default content or modifies default content, but he wants to give up modification back to original, just click "Reload text".
779
780 **✎Note:**
781
782 * If you do not want this prompt during the running of HMI, please uncheck "Show message".
783 * "Reload text" function would be invalid after clicking "save".
784 * These 5 special characters are not supported in the header Multi language settings: ",", "|", "<", ">", "&".
785
786 = **Cloud** =
787
788 **Introduction**
789
790 Cloud function is available for following models: the ig series and 8000/9000 series with -R after system upgrade
791
792 You may configure the basic settings of Cloud functions, tags, and User MQTT according to your needs. (If the device supports the Cloud function, you can use the function and configure the tags after checking the box to enable it, or upload the data to the 3rd party server.)
793
794 Click "Project"-"[[image:hh_B4H5OuNT87.png||height="29" width="30"]]Cloud" in the upper left corner of the software, as shown in the following figure.
795
796 (% style="text-align:center" %)
797 [[image:云配置1.png||height="494" width="750" class="img-thumbnail"]]
798
799 **(1) Enable**
800
801 If the HMI supports the Cloud function, check it to enable the Cloud function, and it will collect the real-time data from HMI upload to the Cloud. The number of data collection is limited, and the specific parameters are as follows:
802
803 |=Series|=Monitoring Tags|=Alarm Record|=Data Record|=OpenCloud Data
804 |8000-R|300|200|100|1000
805 |9000-R|300|200|100|1000
806 |3000ig|100|20|50|500
807 |8000ig|300|200|100|1000
808
809 For example:
810
811 ~1. In 3000ig's Cloud, the monitoring tags upload to the Cloud in real time is limited to 100.
812
813 2. For 3000ig's Alarm, the Alarm records of word alarms and bit alarms upload to Cloud is limited to 20. (See [["Alarm">>http://docs.we-con.com.cn/wiki/pistudio/view/Helps/08.Basic%20Function/#HAlarm]] for details).
814
815 3. For 3000ig's Data record, the Data records upload to Cloud is limited to 50. (For details, please refer to [["Data Record">>http://docs.we-con.com.cn/wiki/pistudio/view/Helps/08.Basic%20Function/#HDataRecord]]).
816
817 **(2) Server Selection**
818
819 **Server**: China, ASEAN, and Europe.
820
821 **Password**:
822
823 1. If the HMI is not bound, this access password will be updated and downloaded into the HMI screen simultaneously.
824 1. If the HMI is bound, this access password in the project cannot effectively change the binding password of the device, and it can only be changed through V-NET.
825
826 **(3) Upload Selection**: 
827
828 To upload the data collected by HMI to the cloud or a to the third-party server, only one upload method can be selected.
829
830 1. **to Cloud**: All the configured tags, data records, and alarm records would be pushed to V-NET.
831 1. **to User MQTT**: All the configured tags, data records, and alarm records would be pushed to to the third-party server, and the relevant Lua function calls please refer to "[[Cloud interface>>http://docs.we-con.com.cn/wiki/pistudio/view/Helps/10.Lua/#HCloudInterface]]".
832
833 After the "to User MQTT" is checked. The tags, data records, and alarms cannot be viewed on V-NET, but the device can be bound to V-NET and remote monitoring the device screen normally.
834
835 **4) Low Data Mode setting**
836
837 1. When you check the "low Data Mod" by default on new tags, the newly added tags will be enabled in Low Data Mode by default.
838 1. The longer the refresh interval, the slower the data upload, and the more traffic data will be saved. This function is only used for the control of tags.