Wiki source code of 06 Data Tool

Version 19.3 by Stone Wu on 2022/08/02 11:54

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

Wiki source code of 06 Data Tool

Navigation

Table of Contents