Wiki source code of 06 Data Tool

Last modified by Molly on 2025/05/12 11:41

Show last authors
1 (% class="wikigeneratedid" %)
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 **Group No.: **Group number of Bit alarm. The name is unique and cannot be duplicated.
14
15 **Bit Address: **Bit address of alarm monitoring
16
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.
19
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)
21
22 (% class="box infomessage" %)
23 (((
24 **✎Note:**
25
26 * 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.
27 * 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:
28
29 (% class="table-bordered" style="margin-left:auto; margin-right:auto; width:358px" %)
30 |=(% style="width: 79px;" %)Series|=(% style="width: 276px;" %)Number of Alarm upload to Cloud
31 |(% style="width:79px" %)8000-R|(% style="text-align:center; width:276px" %)200
32 |(% style="width:79px" %)9000-R|(% style="text-align:center; width:276px" %)200
33 |(% style="width:79px" %)3000ig|(% style="text-align:center; width:276px" %)20
34 |(% style="width:79px" %)8000ig|(% style="text-align:center; width:276px" %)200
35 |(% style="width:79px" %)MD|(% style="text-align:center; width:276px" %)20
36 )))
37
38 **Alarm Condition:** It sets alarm trigger condition, there are two types: alarm when ON and alarm when OFF.
39
40 **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.
41
42 **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.
43
44 **Content: **It is used for setting alarm content (command).
45
46 **Alarm Screen: **Pop-up alarm screen (it need to be sub-screen);
47
48 * **Position: **The location of the screen alarm display.
49 * **Pop-up Interval: **The time of reopen the alarm screen when alarm screen closed.
50 * **Pop-up once: **Pop up alarm screen once, and the screen would not pop up again
51 * **Close window when alarm off: **Automatically close the alarm screen when alarm off.
52
53 (% class="box infomessage" %)
54 (((
55 **✎Note:**
56
57 * 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.
58 * 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.
59 )))
60
61 **Operating Procedures of Adding One Alarm**
62
63 * Click "Project"→"Bit Alarm" as below shows.
64
65 (% style="text-align:center" %)
66 [[image:8.Basic Function_html_5f8da20315334bac.png||data-xwiki-image-style-alignment="center" height="144" width="539" class="img-thumbnail"]]
67
68 * Click "Add" button to open "Bit Alarm" setting window.
69
70 (% style="text-align:center" %)
71 [[image:8.Basic Function_html_94a019683b506e15.png||data-xwiki-image-style-alignment="center" height="307" width="554" class="img-thumbnail"]]
72
73 * Set "Bit Address".
74 * Set "Alarm Condition".
75 * Set "Content".
76 * Other settings can be set according to the actual situation".
77 * Click "OK" button to complete settings.
78
79 == Word alarm ==
80
81 Word alarm is to monitor the word address of a device. If the data meets the set conditions, an alarm will be generated.
82
83 Click "Project"→"Word alarm", it is displayed as the following figure.
84
85 (% style="text-align:center" %)
86 [[image:字报警 1.png||class="img-thumbnail"]]
87
88 **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.
89
90 **Alarm Address: **It is used for setting word address for word alarm, such as HDW0.
91
92 **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.
93
94 **Group No.: **Group number of word alarm. The name is unique and cannot be duplicated.
95
96 **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)
97
98 (% class="box infomessage" %)
99 (((
100 **✎Note:**
101
102 * 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.
103 * 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.
104
105 (% style="margin-left:auto; margin-right:auto; width:358px" %)
106 |=(% style="width: 79px;" %)Series|=(% style="width: 276px;" %)Number of Alarm upload to Cloud
107 |(% style="width:79px" %)8000-R|(% style="text-align:center; width:276px" %)200
108 |(% style="width:79px" %)9000-R|(% style="text-align:center; width:276px" %)200
109 |(% style="width:79px" %)3000ig|(% style="text-align:center; width:276px" %)20
110 |(% style="width:79px" %)8000ig|(% style="text-align:center; width:276px" %)200
111 |(% style="width:79px" %)MD|(% style="text-align:center; width:276px" %)20
112 )))
113
114 **Record alarm:**  Whether to record the alarm history data of word alarm, if checked, it will be saved in the designated storage location.
115
116 **Not save alarm OFF:** If checked, after the alarm is dismissed, the corresponding alarm records will be deleted from the log file.
117
118 **Alarm Condition**: Alarm is triggered when designated address meets the alarm condition, it provides four conditions;
119
120 1. **High alarm:** Alarm is triggered when it reaches high limit. It can be a constant or a variable
121 1. **Low alarm:** Alarm is triggered when it reaches low limit. It can be a constant or a variable
122 1. **Range alarm:** Alarm is triggered when it exceeds the range. It can be a constant or a variable
123 1. **Equivalent alarm: **Alarm is triggered when the value equals to the given data. It can be a constant or a variable
124
125 **Alarm Info: **It is used for setting alarm content (command);
126
127 **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.
128
129 **Alarm Screen: **Pop-up alarm screen (it need to be sub-screen);
130
131 1. **Position: **The location of the screen alarm display.
132 1. **Pop-up Interval: **The time of reopen the alarm screen when alarm screen closed.
133 1. **Pop-up once: **Pop up alarm screen once.
134 1. **Close window when alarm off: **Automatically close the alarm screen when alarm off.
135
136 **Beep when alarm ON: **beep works when the alarm is triggered, in the default mode, the beep works until the alarm is released.
137
138 **Beep once:** Beep works once, when alarm is triggered.
139
140 **Alarm List**
141
142 It displays all the word alarm lists; it will show the alarm information;
143
144 **Operating Procedures of Adding One Alarm**
145
146 * Click "Project"→ "Word Alarm" as below shows.
147
148 (% style="text-align:center" %)
149 [[image:8.Basic Function_html_1b59522c984cd7c2.png||height="144" width="492" class="img-thumbnail"]]
150
151 * Click "AddClick" button to open "Word Alarm" setting window.
152
153 (% style="text-align:center" %)
154 [[image:8.Basic Function_html_942107c81fc6901c.png||height="307" width="554" class="img-thumbnail"]]
155
156 * Set Basic information of word alarm.
157 * Set "Content".
158 * Other settings can be set according to the actual situation.
159 * Click "OK" button to complete settings.
160
161 == How to show the variables in alarm info? ==
162
163 We can write some codes in the alarm info and add variables to the alarm info to make the alarm info clearer.
164
165 **{Address,Data format}**
166
167 (% style="height:10px; width:250px" %)
168 |=Letter|=Mean
169 |B|Binary
170 |O|Octal
171 |U|Unsigned
172 |H|Hex
173 |b|BCD
174 |F|32-bit floating
175 |S|Signed
176 |C|String
177 |W|Word
178 |D|Dword
179 |T|Dword string
180
181 Example:
182
183 Unsigned,BCD,32-bit floating,Signed:
184
185 {HDW100,UW2.1} ~-~-- add a variables into the alarm info:address-HDW100 ,data format-unsigned,Word,2 Integer,1 Decimal.
186
187 Binary,Octal,Hex:
188
189 {HDW100,HD8} ~-~-- add a variables into the alarm info:address-HDW100 ,data format-Hex,Dword,8 Integer.
190
191 String
192
193 {HDW100,C32} ~-~-- add a variables into the alarm info:address-HDW100 ,data format-String,32 length.
194
195
196 **HMI Alarm Demo Download Link**
197
198 [[https:~~/~~/drive.google.com/open?id=1Llq03CMISM_1mMIfU308hxFbs4rGdQGP>>url:https://drive.google.com/open?id=1Llq03CMISM_1mMIfU308hxFbs4rGdQGP]]
199
200 = **Recipe** =
201
202 == Overview of recipe ==
203
204 Recipes are composed of multiple groups of information materials with the same structure and different data. Due to the sameness of these materials, users can edit them into a group of recipes to facilitate data transfer between HMI and PLC. Therefore, this function can be utilized for information that has a similar structure to achieve efficient and correct transmission.
205
206 Data operation of recipe: Upload and download. Upload refers to reading the data of [The set address] group and writing the data of this group to the corresponding recipe file. Download refers to reading a group of data from the recipe file and assigning the group of data to [The set address].
207
208 The recipe data can be stored in external equipment, such as USB flash disk and SD card. The whole recipe data can be viewed with the [Recipe record] object.
209
210 (% class="wikigeneratedid" id="HExample" %)
211 **Example**
212
213 Taking automobile paint spraying as an example, suppose that when a newly manufactured automobile needs to be painted, it needs to spray different colors (red, green and blue) on the top, bottom and outside of the automobile, and the original colors provided are only red, green and blue. At this time, to spray different colors, it needs the appropriate ratio of these three colors, and the spraying time of different parts is different. At this time, the function of recipe needs to be executed. Check Table 1 for details.
214
215 Table 1 Example recipe
216
217 |Part|Red (Kg)|Green (Kg)|Blue (Kg)|Spraying time (Seconds)
218 |Top|2|2|1|30
219 |Bottom|3|1|2|40
220 |Outside|2|3|3|20
221
222 From the above table, one group of recipes is needed when spraying different parts, and three groups of recipes can be established, and each group of recipes has four ingredients: Red, Green, Blue, Spraying time. The value of each ingredient is different in different groups of recipes.**Recipe configuration**
223
224 The recipe function needs to be used with the recipe configuration area and [Recipe record] object. Click [Recipe] in the [System configuration/Record setting] in the upper left side of the software [[image:1698393787529-717.png]]and the following interface will pop up:
225
226 (% style="text-align:center" %)
227 [[image:1.png]]
228
229 Click [Add] to pop up the recipe setting interface, as shown in the following figure:
230
231 (% style="text-align:center" %)
232 [[image:2.png]]
233
234 |Recipe configuration options|Description|Notice
235 |Recipe name|Name the current recipe|Note: Recipe name can only consist of (0~~9), (a~~z), (A~~Z), ('_'), ('') and other non-English characters.
236 |Group number|Configure the group number of the current recipe, ranging from 0 to 1000|
237 |Number of ingredients|Configure the number of the current ingredient, ranging from 0 to 1500|
238
239 |Data configuration options|Description|Notice
240 |Starting address|The data of group in the recipe file is read out and displayed in the address, which will be automatically assigned according to the set data format of each ingredient. For example, if each group has 10 ingredients, the ingredient format is 16-bit unsigned decimal number, and the starting address is HDW0, then 10 addresses (HDW0-HDW9) correspond to 10 ingredients respectively, the values in HDWO correspond to the values in ingredient 1, the values in HDW1 correspond to the values in ingredient 2, and so on.|
241 |Recipes are read and written at different addresses|When "recipe written and read address are different" is checked, the address configured by the read address is only used for recipe read data operation, and the address set in this area is used to control recipe written data operation.|
242 |Data format|Configure the data format of this recipe. There are 9 modes of data format: 16-bit BCD code, 16-bit signed decimal, 16-bit unsigned decimal, 32-bit BCD code, 32-bit signed decimal, 32-bit unsigned decimal, 32-bit (single-precision) floating points, 64-bit (double-precision) floating point, string.|(% rowspan="2" %)(% class="box infomessage" %)
243 (((
244 **✎Note:** The data format set here is for all components of the recipe, that is, the data format of all components in a recipe is consistent.
245 )))
246 |Decimal point position|Configure the selection of integer and decimal places of data.
247 |Enable discontinuous addresses|If checked, the address of the recipe list can be modified.|
248 |Language|Recipe display language is selectable.|
249 |Recipe list|The recipe list displays the configured recipe parameter information in the list according to the settings. The parameters of each ingredient in the recipe list can be modified at the same time: For example, the name of the ingredient, the data format of the ingredient, the address of the ingredient, and directly filling in the data of each ingredient in each group.|
250 |Insert group|Click [Insert group], enter the number of groups to insert, and the corresponding row will be added to the recipe list.|
251 |Delete group.|Click [Delete group] to select the group to delete|
252 |Insert ingredient|Click [Insert group], enter the number of groups to insert, and the corresponding row will be added to the recipe list.|
253 |Delete ingredient|Click [Delete ingredient] to select the ingredient to delete.|
254 |Data import|Import existing data files, supporting .xlsx .xls .csv format.|
255 |Data export|Export configured recipe data|
256
257 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.
258
259 Data operation
260
261 1. **Read:** Read a group of data from the recipe file and assign the group of data to the set address.
262 1. **Write: **Read a group of data from the set address and assign the group of data to the corresponding recipe file.
263
264 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.
265
266 The maximum number of group in recipe is 1000, and the maximum number of member in each group is 1500.
267
268 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.
269
270 1. **Simple: **Only support the data operation of one recipe file, including read and write.
271 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".
272
273 Recipe function settings will be display in "[[Recipe display>>http://docs.we-con.com.cn/wiki/pistudio/view/Helps/06.Objects/#HRecipedisplay]]" object.
274
275 **Description**
276
277 (% style="text-align:center" %)
278 [[image:8-1Recipe.png]]
279
280 **Basic**
281
282 * **Recipe Folder:** Give Recipe folder name (It can be used, when setting Recipe display object);
283 ** (% class="box infomessage" %)
284 (((
285 **✎Note: **Recipe Folder name can only consist of (0~~9), (a~~z), (A~~Z), ('_'), (' ') and other non-English characters;
286 )))
287 * **Group: **Set the recipe group number, the number of elements, the data format. The data format has 8 modes: 16-bit signed decimal, 16-bit unsigned decimal, 16-bit BCD, 32-bit signed decimal, 32-bit unsigned decimal, 16-bit BCD, 32-bit floating point number, 64-bit (double-precision) floating-point number, string, and the choice of data integer and decimal places.
288 * **Elements:** It sets members' initial number of each group;
289 * **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;
290 * **Decimal: **It sets integer and scale digits;
291
292 **Mode Selection: **Select Simple or Advanced mode. Recipe file is divided into simple mode and advanced mode. Only in advanced mode can exist multiple recipe files used at the same time. (used wiht file list onject), Simple mode can only support a recipe file; Aadvanced mode can insert group information and reordered.
293
294 Function address: all operations are done through function addresses, different operating value is as follows:
295
296 * = 0: no operation;
297 * = 1: trigger read data;
298 * = 2: new trigger or update (If there is group number, it updates.)
299 * = 4: insert (only valid in advanced mode)
300 * = 8: delete (Delete according to the writing group number. If write and read address are consistent, refer to the reading group number);
301 * = 16: delete and sorted ((Delete according to the writing group number. If write and read address are consistent, refer to the reading group number)
302 * = 64: import CSV recipe file.
303
304 **Use Multiple File**
305
306 Check it to use more than one recipe file in HMI, but this option only valid in [Advanced mode];
307
308 **Select language**
309
310 The text in HMI can be in 8 languages, user can set language in here;
311
312 **Address**
313
314 1. **Group:** This address is for selecting group number;
315 1. **Start: **This is starting address is for reading and writing in recipe, PIStudio will automatically assigns addresses for each members;
316 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.
317
318 **Use Index**
319
320 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.
321
322 **Query by Element**
323
324 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;
325
326 (% class="box infomessage" %)
327 (((
328 **✎Note: **When this option is enabled, Group address will be invalid.
329 )))
330
331 **Use Independent Write Address**
332
333 To separate Recipe read address and write address.
334
335 **Use Insert**
336
337 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.
338
339 **Discontinuous Address**
340
341 Whether enable the non-consecutive recipe operation addresses or not. If disabled, the recipe address will recover as the continuous addresses.
342
343 (% class="box infomessage" %)
344 (((
345 **✎Note: **This function only supported in HMI+, i series, ie series, ig series.
346 )))
347
348 **Description of adcanced mode**
349
350 According to the recipe configuration information in Figure 2 above. The function address is HDW70, and each function configuration corresponds to the group number address, recipe element address and recipe file name address. The recipe information configured in figure 2 can be displayed in the table in figure 3 with the "Record Display" object.
351
352 [[image:image-20220806111333-1.jpeg]]
353
354 **Read recipe**: Input 1 to the file name, when the group number addresses HDW100=1 and HDW70=1 (read), the element data of the first group (ID=1) is written to the recipe address from the recipe file. As shown in Figure 3 above: HDW105=1, HHDW106=2, HDW107=3, HDW108=4, HDW109=5.
355
356 **Write recipe**: Input 1 to the file name, when the group number addresses HDW101=4 and HDW70=2 (write), the data will be read from the recipe address and written to the corresponding group of the recipe file. As shown in figure 3 above: HDW110=20, HHDW111=21, HDW112=22, HDW113=23, HDW114=24. Write the data of this set to the elements of ID=4 in the recipe table (if there is no data of Group 4 in the recipe file, a new set of data will be added; If there is data of Group 4 in the original recipe, the original data will be overwritten and the latest data will be displayed in the recipe file).
357
358 **Index recipe**: When the file name is input 1, when the group number address HDW102=3, the data of ID=3 (Group 3) in the recipe file will be directly displayed in the component address of the index, that is, HDW115=11, HHDW116=12, HDW117=13, HDW118=14 and HDW119=15. If the data of the index component address is modified, the modified data will be automatically filled into the table of the recipe file, that is, the data of the recipe file will be automatically updated after the data is modified.
359
360 [[image:image-20220806111355-2.jpeg]]
361
362 **Insert recipe**: Input 1 to the file name, when the group number addresses HDW103=3 and HDW70=4 (insert), the data of the 3rd group will be inserted, but the data of the third group already exists in the original recipe file (see Figure 3 above), then the original data will be moved down by one group, that is, the original 3rd group will become the 4th group, and so on, and HDW120=16, HHDW121=17, HDW122=18, HDW123=19 and HDW124=20 will be written into the new 3rd group of the recipe file at the same time. The results are shown in Figure 4 above.
363
364 When the group number address HDW101=2 (**The delete function only works on the group number of the write function**), HDW70=8 (delete), the data in the recipe file with ID=2 (Group 2) will be deleted.
365
366 When the group number address HDW101=5 (**The delete function only works on the group number of the write function**), HDW70=16 (delete and sort), the data of ID=5 (Group 5) in the recipe file will be deleted, and the original ID=6 (Group 6) data will be reordered to become the new Group 5 data, the original ID=7 (Group 7) data will be reordered to become the new Group 6 data, and so on.
367
368 **Recipe Demo Download Link: **[[Download>>url:https://drive.google.com/open?id=1Cjbq_tW-NIirHFBpxt47g7IKvoYaWqUR]]
369
370 == Calling CSV recipe file ==
371
372 **Overview**
373
374 The recipe files used by the regular series HMI are in CSV format, and the recipe files used by the current series HMI are in database format. In order to be compatible with CSV format recipe files on the current series of HMI, please follow the instruction when using it.
375
376 **Operations**
377
378 Create the recipe as it is configured. The default recipe file name is “1. rcp2”, which is placed in folder 123, as shown in the following figure.
379
380 (% style="text-align:center" %)
381 (((
382 (% style="display:inline-block" %)
383 [[Figure 1>>image:image-20220806100702-2.jpeg]]
384 )))
385
386 2. Place a "Recipe Record Display" object and a "File List" object on the project screen for viewing the recipe files in the folder 123, and the address configuration in the object should be consistent with the above configuration.
387
388 (% style="text-align:center" %)
389 [[image:image-20220806100753-3.jpeg]]
390
391 By configuring the address in the table and combining the recipe function, the CSV recipe files of regular series are imported.
392
393 |=Address range|=Object type|=Address function
394 |HSW1050 to 1065|Text input object|Enter the CSV recipe file name to import
395 |HSW1066|Numerical input object|Import CSV file type:(((
396 * = 0: Custom CSV file (all data in the file is valid)
397 * = 1: Normal recipe file for regular series HMI (the data in line 1 of the file is invalid)
398 * = 2: Special recipe file for regular series HMI (the data in line 1 and 2 and column 1 of the file are invalid)
399 )))
400 |HSW1067|Numerical input object|(((
401 Where the CSV file is saved:
402
403 * = 0: In the CsvFile directory of U disk
404 * = 1: In the CsvFile directory of the SD card
405
406 **The path for offline simulation is: C:\ HMIEmulation\ CustomFileDir\ CsvFile**
407 )))
408 |HSW242|Numerical input object|Returns the results of the csv import:(((
409 * = 37: CSV file imported successfully
410 * = 38: CSV file import failed
411 )))
412
413 **Select CSV recipe file (take U disk as an example):**
414
415 Using the file list object, select the recipe file in the U disk by path, and configure the recipe file name address directly to the special address HSW1050 in the above table, which can directly detect the CSV file in the U disk; Select the recipe file in the file list, and write the selected recipe file name into the recipe file name: In HSW1050 to 1065.
416
417 Use the special address of the above table to configure the path of the CSV file: HSW106, configure recipe file name: HSW1050 to1065
418
419 Use HSW1066 address to select the corresponding CSV recipe file type.
420
421 * HSW1066 = 0: Import a user-defined CSV recipe file (all data in the custom CSV file must be valid);
422
423 (% style="text-align:center" %)
424 [[image:image-20220806101129-5.jpeg]]
425
426 * HSW1066=1: Import the normal recipe file of regular series HMI (the data in line 1 of the file is invalid);
427
428 The data in line 1 of the normal recipe file is used to define the format of the recipe and will not be imported into the recipe table as recipe information, **but you must ensure that the data in line 1 representing the elements and number of groups is correct, otherwise the CSV recipe file will fail to be imported.**
429
430 (% style="text-align:center" %)
431 [[image:image-20220806101520-6.jpeg]]
432
433 * HSW1066=2: Import the special recipe file of regular series HMI (the data in line 1, 2 and column 1 of the file are invalid);
434
435 In the special recipe file, line 1 is used to define the format of the recipe, line 2 is used to define the element name of the recipe, and column 1 is used to define the group name of the recipe, so lines 1, 2 and column 1 of the special recipe will not be imported into the recipe table as recipe information. **During use, ensure that the data such as the number of groups and elements representing the recipe format in the first line are correct, otherwise the import of the CSV recipe file will fail.**
436
437 (% style="text-align:center" %)
438 [[image:image-20220806102610-7.jpeg]]
439
440 **Perform import**
441
442 After configuring the saving path of CSV recipe file, the name of recipe file and the type of recipe according to the above steps, the method of transferring CSV file to DB file is as follows:
443
444 * Configure the DB recipe file name by text input object: HDW500 = 3 (recipe file configured in Figure 1),
445 * Set the recipe function address to: HDW1000 = 64 (the function address configured in Figure 1),
446 * Transform the CSV recipe file in U disk into DB recipe file with file name “3.rcp2”.
447
448 **DB recipe file for storing CSV data:**
449
450 Simple mode: When the recipe file is set to simple mode, the file of CSV data is saved as the DB recipe file of 1. rcp2 by default.
451
452 Advanced mode: When the recipe is enabled in advanced mode (multi-file recipe), the imported CSV file data is saved to the file recorded at the recipe file address HDW500 (the address configured in Figure 1).
453
454 **Import results:**
455
456 * HSW242 = 37: Import succeeded;
457 * HSW242 = 38: Import failed.
458
459 **Precautions:**
460
461 * Ensure that the data format of each element in the CSV file is the same as the recipe data format set in the software (DB), and ensure that the elements of each row in the valid data area is the same as the elements set in the software (DB);
462 * When the elements of a line in CSV file is more than the elements set in the software (DB), it will prompt the import failure;
463 * When the CSV file imported into the regular series HMI is a recipe file, the data representing the recipe format (elements, number of groups, whether it is a special recipe) in line 1 must be correct, otherwise the import of CSV file will fail.
464
465 == **Recipe record function** ==
466
467 **Basic setting**
468
469 (% style="text-align:center" %)
470 [[image:3.png]]
471
472 Recipe selection: Select the recipe name to be displayed. The list is all the recipes configured in the recipe. If the list is empty, add the recipe in [Recipe].
473
474 Recipe shortcut key setting:
475
476 Add data: Used to add groups.
477
478 Delete data: Used to delete the selected configuration
479
480 Upload recipe: Used to upload the address data of the selected group to the corresponding group in recipe records.
481
482 Download recipe: Used to download the address data of the selected group to the corresponding group in recipe records.
483
484 Import recipe: Used to import the existing recipe files.
485
486 Export recipe: Used to export the current recipe as a file.
487
488 **Graphic**
489
490 (% style="text-align:center" %)
491 [[image:4.png]]
492
493 Style selection: Styles can be switched or customized.
494
495 Background configuration: Set the recipe background, including background color and transparency.
496
497 Table configuration: Set the appearance of recipe table area, including row background color, row spacing color, horizontal header background color, vertical header background color, horizontal header text color, vertical header text color, text color, row selected color, name color, line color and cell style.
498
499 **Expansion**
500
501 (% style="text-align:center" %)
502 [[image:5.png]]
503
504 Object lock: With the interlock address, the object is locked and the lock icon is displayed (upper left corner of the object) when the lock address is 0, and the bit switch is operable only when the bit pointed by the interlock bit address is 1. To lock the bit switch when the interlock bit address is 1, just check "Lock in ON".
505
506 Object lock icon: Icons will not display when the [Not display “Lock” icon] option is checked. Icon display will adapt to the change of object size.
507
508 Gray level display: When the object is locked, the text message will be grayed out.
509
510 = (% style="color:inherit; font-family:inherit; font-size:29px" %)**Traditional recipe**(%%) =
511
512 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.
513
514 Traditional recipe function is valid only when the LEVI project is converted to the PI project, and the original project uses the traditional recipe.
515
516 (% class="box infomessage" %)
517 (((
518 **✎Note**: Currently, only HMI+, i series, ie series, and ig series support the traditional recipe.
519 )))
520
521 == Simple recipe mode ==
522
523 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:
524
525 (% style="text-align:center" %)
526 [[image:8-3TraditionalRecipeConfigScreen.png||class="img-thumbnail"]]
527
528 **✎Note**:
529
530 * The recipe folder name can only consist of (0~~9), (a~~z), (A~~Z), ('_'), ('').
531 * The element name of the recipe cannot include following 5 special characters: " **,** " , " **|** " , " **<** " , " **>** " , " **&** " .
532
533 == Recipe display ==
534
535 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.
536
537 (% class="box infomessage" %)
538 (((
539 **✎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:
540 )))
541
542 (% style="text-align:center" %)
543 [[image:8-4TraditionalRecipeDisplayConfigScreen.png||class="img-thumbnail"]]
544
545 == Recipe transmission address ==
546
547 The special addresses used in the Recipe are shown in the following table:
548
549 (% class="table-bordered" %)
550 |=Address|=Description|=Function
551 |HSW1611|Traditional Recipe transfer operation.|(((
552 ~=1: Recipe download.
553
554 ~=2: Recipe upload.
555 )))
556 |HSW1612|Traditional Recipe group number.|Traditional Recipe group number.
557 |(((
558 HSW242
559 )))|(((
560 Recipe operation result prompt:
561
562 Upload: Data is written to recipe file from address.
563
564 Download: Data is written to the address from recipe file.
565 )))|(((
566 ~=1: Recipe download, start.
567
568 ~=2: Recipe download, execution error.
569
570 ~=6: Recipe download, successful.
571
572 ~=7: Recipe upload, start.
573
574 ~=8: Recipe upload, execution error.
575
576 ~=11: Recipe group name does not exist.
577
578 ~=12: Recipe upload, successful.
579 )))
580
581 == **Recipe index** ==
582
583 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".
584
585 The recipe index area (RPW)'s instruction as follows:
586
587 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.
588 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.
589
590 * **✎Note**: As long as RPW~*~*~#~#~#~# exists, any object "writes" to HPW~*~*~#~#~#~# will be saved to the recipe file. 
591
592 (% start="3" %)
593 1. The RPW register only supports word address access.
594 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.
595
596 == Recipe example ==
597
598 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".
599
600 Edit the recipe configuration, create three groups of recipes, 4 elements for per group: Red, green, blue, spraying time, as following shown:
601
602 (% style="text-align:center" %)
603 [[image:8-5TraditionalRecipeCaseConfig.png]]
604
605 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:
606
607 (% style="text-align:center" %)
608 [[image:8-7TraditionalRecipeCaseShowNoOpera.png]]
609
610 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.
611
612 (% style="text-align:center" %)
613 [[image:8-6TraditionalRecipeCaseShow.png]]
614
615 = **Trend chart** =
616
617 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.
618
619 Click "Project" → "Trend chart", it will pop up the following screen. Click "Add" to creat new curve record.
620
621 (% style="text-align:center" %)
622 [[image:趋势图配置 001.png||class="img-thumbnail"]]
623
624 **Settings**
625
626 (% style="text-align:center" %)
627 [[image:趋势图设置 2.png||height="507" width="866"]]
628
629 **(1) Basic settings**
630
631 1. **Curve NO.: **It is for setting curve number,
632 1. **Curve Name:** It is for setting curve name. The length limitation is 31 bytes.
633 1. **Curve (1~~8):** It is for setting the number of curves. The default is 3.
634 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.
635
636 **(2) Sample Type**
637
638 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.
639 1. **Sample unit:** 100ms.
640
641 **(3) Quick Setting**
642
643 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.
644
645 (% style="text-align:center" %)
646 [[image:趋势图设置 3.png||class="img-thumbnail"]]
647
648 (% start="2" %)
649 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.
650
651 **(4) Curve Table:** The sample address you have set would display on it. Click the corresponding box to modify the content.
652
653 (% class="box infomessage" %)
654 (((
655 **✎Note: **Curve names can only consist of Chinese characters, (0~~9), (a~~z), (A~~Z), ('_') (' '), and other non-English characters.
656 )))
657
658 **Trend Chart Demo Download Link**
659
660 [[https:~~/~~/drive.google.com/open?id=1smnaAvSxOWC0WQK4_uvqHXWn4vUZxGJC>>url:https://drive.google.com/open?id=1smnaAvSxOWC0WQK4_uvqHXWn4vUZxGJC]]
661
662 = **History XY plot** =
663
664 Different from TrendChart, uses need to set history XY curve items in project. Please click "Project"-> "History XY Plot" to open the setting screen.
665
666 Recipe function settings will be display in "[[History XY Plot>>path:https://docs.we-con.com.cn/bin/view/PIStudio/08.Basic%20Function/#HHistoryXYplot]]" object.
667
668 (% style="text-align:center" %)
669 [[image:历史XY 2.png||class="img-thumbnail"]]
670
671 (% style="text-align:center" %)
672 [[image:历史XY 3.png||class="img-thumbnail"]]
673
674 **(1) Basic settings**
675
676 1. **Curve NO.: **It is for setting curve number,
677 1. **Curve Name:** It is for setting curve name. The length limitation is 31 bytes.
678 1. **Curve (1~~8):** It is for setting the number of curves. The default is 3.
679 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.
680
681 **(2) Sample Type**
682
683 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.
684 1. **Sample unit:** 100ms.
685
686 **(3) Quick Setting**
687
688 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.
689
690 (% style="text-align:center" %)
691 [[image:image-20220616145435-1.png]]
692
693 (% start="2" %)
694 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.
695
696 **(4) Curve Table:** The sample address you have set would display on it. Click the corresponding box to modify the content.
697
698 (% class="box infomessage" %)
699 (((
700 **✎Note: **Curve names can only consist of Chinese characters, (0~~9), (a~~z), (A~~Z), ('_') (' '), and other non-English characters.
701 )))
702
703 **Operating Procedure**
704
705 * Click "Project" → "History XY Plot" to open the function selecting windows.
706
707 (% style="text-align:center" %)
708 [[image:8.Basic Function_html_5da6ca44bd28acbe.png||height="144" width="533" class="img-thumbnail"]]
709
710 * Click "Add" button to open "History XY Plot” setting windows.
711
712 (% style="text-align:center" %)
713 [[image:8.Basic Function_html_6345b50ea55168fa.png||height="307" width="554" class="img-thumbnail"]]
714
715 * Setting the function of History XY Plot.
716 * Click "OK" to save the setting.
717
718 **Download Link**
719
720 [[https:~~/~~/drive.google.com/open?id=1t4_HuRmIJJ-B5ryA2kVMadD9FywKhZ4r>>url:https://drive.google.com/open?id=1t4_HuRmIJJ-B5ryA2kVMadD9FywKhZ4r]]
721
722 = (% style="color:inherit; font-family:inherit; font-size:29px" %)**Data record**(%%) =
723
724 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.
725
726 The topology is shown in the following figure.
727
728 (% style="text-align:center" %)
729 [[image:8.Basic Function_html_1b4bd09dafa7e049.png||height="332" width="554" class="img-thumbnail"]]
730
731 The data record stored in SD card is also organized according to the above figure.
732
733 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.
734
735 **Sampling interval: **The interval between two consecutive samples was recorded.
736
737 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.
738
739 For the file storage of data, see the file size configuration during data record configuration.
740
741 ✎**Note: **
742
743 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.
744
745 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:
746
747 (% style="margin-left:auto; margin-right:auto; width:513px" %)
748 |=(% style="width: 70px;" %)Series|=(% style="width: 442px;" %)Number of Data Record upload to Cloud
749 |(% style="width:70px" %)8000-R|(% style="text-align:center; width:442px" %)100
750 |(% style="width:70px" %)9000-R|(% style="text-align:center; width:442px" %)100
751 |(% style="width:70px" %)3000ig|(% style="text-align:center; width:442px" %)50
752 |(% style="width:70px" %)8000ig|(% style="text-align:center; width:442px" %)100
753 |(% style="width:70px" %)MD|(% style="text-align:center; width:442px" %)50
754
755 The record group name can only be composed of Chinese characters, (0~~9), (a~~z), (A~~Z), ('_'), ('') and other non-English characters.
756
757 Channel name cannot incloud following symbols: :" , ", " | ", " < ", " > ", " & ".
758
759 (% class="wikigeneratedid" id="HSettings" %)
760 **Settings**
761
762 (% style="text-align:center" %)
763 [[image:数据记录设置 1.png||height="533" width="848" class="img-thumbnail"]]
764
765 **Operating Procedures**
766
767 1. Click "Project"->"Data record" as below shows.
768 1. Click "Add" button to open "Data record" setting window.
769 1. Enter group name, the default is "GroupName0"
770 1. Select "Trigger function" mode, such as "No trigger".
771 1. Set "Total channels", such as 3.
772 1. Click "Apply" button.
773 1. Set Sample cycle, such as 15.
774 1. Set "Start channel" in "Quick settings", such as 4 0.
775 1. Check group information in "Channel list" as below.
776 1. Click "Save" button to complete settings.
777
778 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.
779
780 ✎**Note: **
781
782 * For HMI series 8000 and above, the size of a single file cannot exceed 300M and the total file capacity cannot exceed 1000M.
783 * For HMI series 3000, the size of a single file cannot exceed 4M and the total file capacity cannot exceed 10M.
784 * If the total amount exceeds the range, an alarm will be given during project compilation.
785
786 (% style="text-align:center" %)
787 [[image:数据记录设置 2.png||height="572" width="850" class="img-thumbnail"]]
788
789 **(1) Group name:** Set group name, and he name should be unique.
790
791 **(2) Trigger function:** There are four modes to trigger record.
792
793 1. **No trigger: **Data will be recorded in every sample time.
794 1. **Trigger to record by sample cycle: **Data will be recorded in every same time, when trigger control bit set ON.
795 1. **Trigger to record once and reset: **Data will be recorded when trigger control bit set ON, and the bit will be reset automatically.
796 1. **Trigger to record once: **Data will be recorded when trigger control bit set ON, and the bit need to be reset manually.
797 1. **Trigger address: **It is only valid when the trigger condition is selected. The monitoring cycle for trigger sampling address is 1s.
798
799 **(3) Total channels (1~~100): **Set the numbers of channels. Click "apply" to view the channel lists on the right record channel.
800
801 **(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.
802
803 **Timing address:** It sets address to change sample time when HMI is running;
804
805 **(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.
806
807 **Abnormal value:** It sets a value, when communication fails, data record will record this value;
808
809 **(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.
810
811 **(7) Quick Settings**
812
813 1. **Start Channel:** It sets the continuous addresses for channels.
814 1. **Data Format: **It sets the same data format for channels.
815 1. **Number of Digits:** It sets the digits’ number for channels.
816 1. **Language Settings**: The text in HMI can be in 8 languages, user can set language in here.
817
818 **(8) Channel List**: Besides quick settings, user can set channel name, address, data format, and so on one by one according to real situation.
819
820 **✎Note:**
821
822 * 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.
823 * 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.
824 * The channel name can only be composed of English characters, (0~~9), (a~~z), (A~~Z), ('_'), ('').
825 * The channel name does not include these 5 special characters: ", ", "| "," <", "> "," & ".
826 * 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.
827
828 You could click here to jump to object "[[Data Record Display>>https://docs.we-con.com.cn/bin/view/PIStudio/06.Objects/#HDatarecorddisplay]]"
829
830 = **User permission** =
831
832 **Introduction**
833
834 1. User permission is one of expansion function in PI Series HMI; it provides multi-level of permission for control HMI operations.
835 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.
836 1. Operating record: it records user operations information, the records files are saved in HMI flash; its path is [~\~\flash~\~\UserOperationLogs.db].
837 1. When it is on simulator mode, the files are saved in C disk, its path is [C:~\~\WECON\UserMgrFile\UserOperationLogs.db].
838
839 (% class="box infomessage" %)
840 (((
841 ✎**Note: **
842
843 * The user name and password must be unique. Username can be up to 32 characters, and password can be up to 8 characters.
844 * The multi language function of User permission only supported on HMI system version V2.0 or above
845 )))
846
847 == Settings ==
848
849 Open PIStudio software, then operate as the following figure.
850
851 (% style="text-align:center" %)
852 [[image:用户权限 1.png||class="img-thumbnail"]]
853
854 Click on the cell from UserName and Desc, which can support the multi language.
855
856 (% style="text-align:center" %)
857 [[image:UserPermissionMultilan.png]]
858
859 1. Click "User Permission" in "Data Tool" toolbar.
860 1. Edit user name, click "User0" cell under "UserName", and then enter the user name, one project allows maximum 20 users.
861 1. Edit password, click "User0" cell under "PassWord", and then enter the user name.
862 1. Edit description, click "User0" cell under "Desc", and then enter, description is not necessary。
863 1. Check the groups for each user, there are 11 groups beside admin.
864 1. Editing groups' description, but it is not necessary.
865 1. {{id name="OLE_LINK7"/}}{{id name="OLE_LINK6"/}}Click "Save and Exit" button to complete all settings.
866
867 (% class="box infomessage" %)
868 (((
869 ✎**Note:**
870
871 * 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.
872 * When the configured file does not have the administrator account, a new user can be added  through "Funtion address" and set as the administrator.
873 * 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.
874 * (((
875 Adding new UserName and Desc on the HMI by special addresses in the current language of the HMI, other languages will also configure the user names and user descriptions to the current language by default, i.e. switching to other languages, the new user names and user descriptions will not change with the language.
876 )))
877 )))
878
879 (((
880
881 )))
882
883 == Object permission configuration ==
884
885 (% style="text-align:center" %)
886 [[image:用户权限 2.png||class="img-thumbnail"]]
887
888 User operation logs support multi languages configuration. Click on the Log Message, the text editor of multi language will be pop up:
889
890 (% style="text-align:center" %)
891 [[image:LogMessagesMultilan.png]]
892
893 **Operation Procedure of Object Permission**
894
895 1. Open the object setting windows;
896 1. Select "Security" windows;
897 1. Check the "User Permission";
898 1. Select "Level" to set permission level;
899 1. Enter "Log Message", it is for operation records, if it was empty, the operation for this object would be not be recorded;
900 1. Select the "Access Denied Setting" mode;
901
902 **Log information description**
903
904 A combination of Chinese characters, numbers, and uppercase and lowercase letters can be entered, and the number does not exceed 63.
905
906 The format of insert variable:{variable address, data format}. e.g., {HDW100,UW2.1}.
907
908 The data format are as follows.
909
910 (% class="table-bordered" %)
911 |=Letter|=Meaning
912 |B|Binary
913 |O|Octonary
914 |U|Unsigned decimal
915 |H|Hexadecimal
916 |b|BCD
917 |F|32-bit float
918 |S|Signed decimal
919 |C|Character
920 |W|Single word
921 |D|Double word
922
923 Examples.
924
925 * Unsigned decimal, BCD, 32-bit float and Signed decimal are as follows.
926
927 {HDW100,UW2.1}:  Indicates the variable address is HDW100. The data format are: unsigned decimal, single word, two integer bits, one decimal place.
928
929 * (((
930 Binary, Octonary and Hexadecimal are as follows.
931 )))
932
933 {HDW100,HD8}: Indicates the variable address is HDW100. The data format are: hexadecimal, double word, eight integer bits.
934
935 * (((
936 Character is as follows.
937 )))
938
939 {HDW100,C32}: Indicates the variable address is HDW100. The data format are: 32 characters.
940
941 When a record is generated, the contents of this variable are replaced by the value of your corresponding address.
942
943 == **Function address** ==
944
945 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.
946
947 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).
948
949 Functions and addresses are as follows.
950
951 (% class="table-bordered" %)
952 |=**Function**|=**Address**|=**Object type**|=**Address function**
953 |(% rowspan="3" %)Sign in|HUW1158~~1335|Drop down list|User name
954 |HUW1002|Character input object|Password
955 |HUW1000|Word Switch (Input 1)|OK (sign in)
956 |(% rowspan="5" %)Change password|HUW1158~~1335|Drop down list|User name
957 |HUW1002|Character input object|Old password
958 |HUW1006|Character input object|New password
959 |HUW1010|Character input object|Confirm password
960 |HUW1000|Word Switch (Input 2)|OK(change password)
961 |Sign out|HUW1000|Word Switch (Input 3) |Sign out
962 |(% rowspan="7" %)(((
963 New user ***1**
964 )))|HUW1014|Character input object|User name
965 |HUW1006|Character input object|password
966 |HUW1010|Character input object|Confirm password
967 |HUW1000|Word Switch (Input 4) |OK(add new user)
968 |HUW1336~~1345|Character input object|User description
969 |HUX1347.0|Bit switch|(((
970 ~=1: User hidden
971
972 ~=0: Visible (Defaults)
973 )))
974 |HUW1000|Word Switch (Input 8) |Save(add Hide features)
975 |(% rowspan="2" %)(((
976 Delete user ***2**
977 )))|HUW1158~~1335|Drop down list|User name
978 |HUW1000|Word Switch (Input 5)|OK (delete user)
979 |Delete Profile|HUW1000|Word Switch (Input 9)|OK(delete)
980 |Export Profile|HUW1000|Word Switch (Input 10)|OK(export)
981 |Import profile|HUW1000|Word Switch (Input 11)|OK(import)
982 |Export log file|HUW1000|Word Switch (Input 12)|OK(export)
983 |Delete log file|HUW1000|Word Switch (Input 13)|OK (delete)
984 |Current user name|HUW1349|Character object|32 Word
985 |System state information|HUW1030|Character input object|System state information
986 |(% rowspan="3" %)Permission settings|HUW1014|Character input object|User name
987 |HUW1348|Bit switch|(((
988 Set the user group:
989
990 HUX1348.0 = 1 administrator;
991
992 HUX1348.1 = 1 group 0 permission;
993
994 HUX1348.2 = 1 group 1 permission;
995
996 (Total group 0 - group 10)
997 )))
998 |HUW1000|Word Switch (Input 6)|Add user rights (set according to HUW1348)
999 |User login mode setting|HUW1382|Word Switch/Numeric input object|(((
1000 0: Select a user name from the drop-down list
1001
1002 1: Use character input object (address HUW1014) to log in with a user name
1003 )))
1004
1005 When the user performs a function operation, the operation result is displayed in the HUW1001.
1006
1007 (% class="table-bordered" %)
1008 |=**Value (HUW1001)**|=**Meaning**
1009 |1|Insufficient permissions.
1010 |2|Username does not exist.
1011 |3|Username already exists.
1012 |4|Wrong username or password.
1013 |5|Login successfully.
1014 |6|Passwords are inconsistent in twice time.
1015 |7|Password changed successfully.
1016 |8|User added successfully.
1017 |9|User deleted successfully.
1018 |10|Maximum number of users exceeded.
1019 |11|Admin user already exists.
1020 |12|User permission modified successfully.
1021 |13|File imported successfully.
1022 |14|File imported failed.
1023 |15|File exported successfully.
1024 |16|File exported failed.
1025 |17|Logout successfully.
1026 |18|Profile deleted successfully.
1027 |19|Log file deleted successfully.
1028 |20|Hide settings modified successfully.
1029 |21|Hide settings modified failed.
1030 |22|(((
1031 Password already occupied, please reset.
1032
1033 (For both username and password, it can not repetition)
1034 )))
1035
1036 (% class="box infomessage" %)
1037 (((
1038 **✎Note:**
1039
1040 * *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.
1041 * *1: When adding new user, the password could not be duplicated with other users.
1042 * *2: When deleting user, it is forbidden to delete the admin user.
1043 )))
1044
1045 **User Permission Demo Download**
1046
1047 [[https:~~/~~/drive.google.com/open?id=1qOiEDvo_1H1YqpoLDpS77dGaAFm8nrGq>>url:https://drive.google.com/open?id=1qOiEDvo_1H1YqpoLDpS77dGaAFm8nrGq]]
1048
1049 = Message prompt =
1050
1051 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.
1052
1053 (% style="text-align:center" %)
1054 [[image:消息提示 2.png||class="img-thumbnail"]]
1055
1056 (% style="text-align:center" %)
1057 [[image:8.Basic Function_html_5ce2091d6f7cd732.png||height="515" width="704" class="img-thumbnail"]]
1058
1059 **(1) Message**
1060
1061 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).
1062
1063 **(2) Control**
1064
1065 1. **Current item: **It shows selected message information.
1066 1. **Use trigger address: **When the message is triggered, the trigger address would be set ON.
1067
1068 **For Example:**
1069
1070 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.
1071
1072 1. **Show message: **Check it to display message when HMI is running. It is checked by default.
1073 1. **Show on web: **Check it to display message when remote access HMI screen, it is unchecked by default.
1074
1075 **(3) Message Content**
1076
1077 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.
1078
1079 **(4) Reload Text: **It means discard changes.
1080
1081 **For Example**
1082
1083 User deletes default content or modifies default content, but he wants to give up modification back to original, just click "Reload text".
1084
1085 (% class="box infomessage" %)
1086 (((
1087 **✎Note:**
1088
1089 * If you do not want this prompt during the running of HMI, please uncheck "Show message".
1090 * "Reload text" function would be invalid after clicking "save".
1091 * These 5 special characters are not supported in the header Multi language settings: ",", "|", "<", ">", "&".
1092 )))
1093
1094 == **Appendix** ==
1095
1096 The following pop-up message and code only available for HMI System V1.0, to indicate some system errors:
1097
1098 |=**Message code**|=**Description**|=
1099 |=10001|Failed to delete folder directory|(% rowspan="3" %)First confirm whether the U disk SD card is read-only, or if there are other abnormalities, if it cannot handle by prevouis advises, please provide the back label and background version info.
1100 |=10002|Failed to renaming file
1101 |=10003|Failed to delete file
1102 |=10004|Inconsistent data record tables|The files in the U disk SD card may be from other projects, or the same project but the number of channels in the current project is inconsistent with the record. Please consider verifying it first.
1103 |=10009|(% rowspan="4" %)
1104 LAN monitoring error|(% rowspan="4" %)Data packet loss during the monitoring process may cause this problem. Confirm the software version. The company has updated this issue. Older versions can be updated
1105 |=10010
1106 |=10011
1107 |=10012
1108 |=10015|Failed to initialize project|It is recommended to send the project back to the company for testing
1109 |=10022|U Disk Safe Exit Failed|(% rowspan="5" %)It may be in use, data is exported, or the storage location is U disk or SD card. It is best to trigger again and wait for its successful exit.
1110 |=10023|SD card safe exit failed
1111 |=10024|U disk is busy
1112 |=10025|SD card is busy
1113 |=10026|Cannot recognize the U disk/SD card
1114 |=10027|U disk/SD card cannot be read or written|(% rowspan="3" %)Detect the format of U disk/SD card. Fat32 and ntfs can be recognized normally. If the computer can use it normally and the HMI cannot recognize it, you can only consider formatting the U disk first and then try again.
1115 |=10028|U disk/SD card unknown error
1116 |=10029|U disk/SD card format error
1117 |=11000|(% rowspan="2" %)Alarm record error|(% rowspan="29" %)(((
1118 The version before Sept. 19th considers the flash problem. Please provide the back label and the backstage version info . Make sure to ask the customer to update the version first, and the customer's similar projects must be updated even if there is no problem. After the update, the flash usage should be checked and. If the flash is on a severe status, return to the company replaces the flash with a new one.
1119
1120 When the question is returned, the text behind the prompt is as complete as possible, which can help R&D to confirm the problem faster.
1121 )))
1122 |=11001
1123 |=11002|Failed to delete Alarm record in Flash
1124 |=11006|Failed to save the Alarm records to Flash
1125 |=11007|Alarm record error
1126 |=11009|(% rowspan="2" %)Data record error
1127 |=11010
1128 |=11011|Failed to save Data records to Flash
1129 |=11012|Failed to delete Data record in Flash
1130 |=11013|Data record error
1131 |=11014|Failed to transfer Data record to U disk/SD card
1132 |=11015|Failed to copy Data record to U disk/SD card
1133 |=11016|Data record error
1134 |=11017|User permission related operation error
1135 |=11018|SQL trigger monitoring error
1136 |=11019|Data record error
1137 |=11020|Historical XY graph error
1138 |=11021|Failed to save the Historical XY graph to Flash
1139 |=11022|Failed to delete the Historical XY graph in Flash
1140 |=11023|(% rowspan="5" %)
1141 \\Installment payment error
1142 |=11024
1143 |=11025
1144 |=11026
1145 |=11027
1146 |=11028|(% rowspan="3" %)
1147 Real-time trend graph error
1148 |=11029
1149 |=11030
1150 |=11031|Failed to delete the Real-time trend graph data in the memory
1151 |=11032|Failed to save the Real-time trend graph to Flash
1152 |=11033|(% rowspan="13" %)Recipe error|(% rowspan="13" %)If it is a new project download and there is an error, first confirm the settings of the recipe, if it is abnormal after a period of use, confirm whether it is the flash problem
1153 |=11034
1154 |=11035
1155 |=11036
1156 |=11037
1157 |=11038
1158 |=11039
1159 |=11040
1160 |=11041
1161 |=11042
1162 |=11043
1163 |=11044
1164 |=11045
1165 |=11046|(% rowspan="3" %)User permission related operation error|(% rowspan="3" %)If an error occurs when downloading a new project, first confirm the permission configuration, whether the reserved configuration is checked in the download tool, etc., if it is abnormal after a period of use, confirm whether it is a flash problem
1166 |=11047
1167 |=11048
1168 |=11049|Failed to upload operation log file via Ethernet|
1169 |=11050|(% rowspan="8" %)User permission related operation error|(% rowspan="6" %)If an error occurs when downloading a new project, first confirm the permission configuration, whether the reserved configuration is checked in the download tool, etc., if it is abnormal after a period of use, confirm whether it is a flash problem
1170 |=11051
1171 |=11052
1172 |=11053
1173 |=11054
1174 |=11055
1175 |=11056|(% rowspan="2" %)
1176 |=11057
1177 |=11058|Alarm record error|(% rowspan="2" %)Same as flash problem
1178 |=11062|Installment payment error
1179 |=11063|Alarm Runbar error|Mostly, the Runbar is used without config the alarm settings.
1180 |=11069|(% rowspan="3" %)Historical trend graph error|Same as flash problem
1181 |=11070|
1182 |=11071|
1183 |=11072|SQL trigger monitoring error|
1184 |=11073|Real-time trend graph error|Same as flash problem
1185 |=11075|Error getting database table file|Same as flash problem
1186 |=11076|Error getting database table file|Same as flash problem
1187 |=11077|(% rowspan="3" %)Recipe error|(% rowspan="3" %)If it is a new project download and there is an error, first confirm the settings of the recipe, if it is abnormal after a period of use, confirm whether it is the flash problem
1188 |=11078
1189 |=11079
1190 |=11080|(% rowspan="2" %)User permission related operation error|(% rowspan="2" %)Same as 11046
1191 |=11081
1192 |=11082|Drop-down list error|
1193 |=11083|The message prompt error|
1194 |=11084|(% rowspan="2" %)Alarm record error|Same as flash problem
1195 |=11085|
1196 |=11086|(% rowspan="2" %)Data record error|Same as flash problem
1197 |=11087|
1198 |=11088|(% rowspan="2" %)Alarm record error|Same as flash problem
1199 |=11089|
1200 |=11090|Installment payment error|Same as flash problem
1201 |=11091|The message prompt error|
1202 |=11092|The database table file does not exist|
1203 |=11093|Machine code error|
1204 |=11094|Import csv file error|
1205 |=30001|Flash free space is not enough to store Data records|(% rowspan="3" %)Insufficient space, whether any file is copied into the flash
1206 |=30002|Flash free space is not enough, Historical XY trend graph is not stored
1207 |=30003|Flash free space is not enough to store real-time trend graphs
1208 |=30005|System read only|(% rowspan="2" %)Same as the flash problem, if the flash is damaged, then the system must be updated
1209 |=30006|Insufficient reserved blocks
1210
1211 = **Cloud** =
1212
1213 **Introduction**
1214
1215 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.)
1216
1217 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.
1218
1219 (% style="text-align:center" %)
1220 [[image:云配置1.png||height="494" width="750" class="img-thumbnail"]]
1221
1222 **(1) Enable**
1223
1224 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:
1225
1226 |=Series|=Monitoring Tags|=Alarm Record|=Data Record|=OpenCloud Data
1227 |8000-R (HMI V2.0 System)|300|200|100|1000
1228 |9000-R (HMI V2.0 System)|300|200|100|1000
1229 |3000ig|100|20|50|500
1230 |8000ig|300|200|100|1000
1231 |MD|100|20|50|500
1232
1233 For example:
1234
1235 * In 3000ig's Cloud, the monitoring tags upload to the Cloud in real time is limited to 100.
1236 * 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).
1237 * 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]]).
1238
1239 **(2) Server Selection**
1240
1241 **Server**: China, ASEAN, and Europe.
1242
1243 **Password**:
1244
1245 1. If the HMI is not bound, this access password will be updated and downloaded into the HMI screen simultaneously.
1246 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.
1247
1248 **(3) Upload Selection**: 
1249
1250 To upload the data collected by HMI to the cloud or a to the third-party server, only one upload method can be selected.
1251
1252 1. **to Cloud**: All the configured tags, data records, and alarm records would be pushed to V-NET.
1253 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]]".
1254
1255 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.
1256
1257 **4) Low Data Mode setting**
1258
1259 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.
1260 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.
1261
1262 = MQTT[[image:2.png]] =
1263
1264 (% class="wikigeneratedid" %)
1265 Configurable type MQTT. Users can publish message to the MQTT server or subscribe topics from the MQTT server.
1266
1267 The supported models and series are listed in the following table:
1268
1269 (% style="margin-left:auto; margin-right:auto; width:150px" %)
1270 |Support series
1271 |3000ig
1272 |8000ig
1273
1274
1275
1276 **MQTT Configuration (Common Settings/AWS IOT Settings/ALi Settings/Huawei Settings)**
1277
1278 This chapter explains how to use configurable type MQTT. Users can publish message to the MQTT server or subscribe topics from the MQTT server.
1279
1280 Click “MQTT” in “Data Tool" in the upper side bar of the software.After checking "Enable", the settings window will pop up and select different cloud services for MQTT configuration, as shown in the following figure:
1281
1282 (% style="text-align:center" %)
1283 [[image:1747021182728-276.png]]
1284
1285 **MQTT Server Settings (Common)**
1286
1287 **General**
1288
1289 (% style="text-align:center" %)
1290 [[image:3.jpg]]
1291
1292 **Description:** Enter a description or comment about the server. Maximum input length: 255 characters, cannot be empty.
1293
1294 **Cloud Service**: (Select Common)
1295
1296 ① Common (Common Platform): General MQTT publish-subscribe topic mode.
1297
1298 ② AWS IoT (Amazon): Using "AWS IoT" as the Broker, using Thing to transfer data and support Shadow function.
1299
1300 ③ ALi (Alibaba Cloud): Using "Alibaba Cloud" as Broker.
1301
1302 ④ Huawei (Huawei Cloud): Using "Huawei Cloud" as Broker.
1303
1304 **Communication protocol**: MQTTv3.1, v3.1.1 and v5 are supported.
1305
1306 **Custom Client ID length:** User can customize the length of the Client ID (optional), length range: 20 ~~128.
1307
1308 **Custom username/password length:** Customize the length of user name/password length (optional), length range: 16 ~~ 256.
1309
1310 **IP:** Set the MQTT server IP to subscribe message.
1311
1312 **Use domain name:** Support using domain name to the specify server.
1313
1314 **Domain name:** Set the domain name of the MQTT server that subscribe message. Maximum input length: 128 characters, cannot be empty, supports letters, numbers, "-", “.”. The symbol cannot be placed at the first character or last character of name.
1315
1316 **Port number:** Set the MQTT server port to subscribe message. Range: 0~~65535, cannot be empty.
1317
1318 **Client ID:** Login name. Variables can be used as login names. For example: Enter% 0 and the Client ID is the device name. (This can be set in the HMI background. If not, the default is HMI model.) **(✎Note: A Client ID can only be used for one device.)** When there is no custom Client ID length, the maximum configurable length of Client ID is 40 characters.
1319
1320 **Verification:** Choose whether to connect to the MQTT server using [User Name] and [Password].
1321
1322 **User Name:** The [User Name] connects to the MQTT server. When there is no custom username/password length, the maximum configurable length of username is 32 characters.
1323
1324 **Password:** The password for connect to the MQTT server. When there is no custom username/password length, the maximum configurable length of password is 32 characters.
1325
1326 **Timestamp:** LOCAL: Using the HMI time as the timestamp. UTC Time: Using UTC+0.
1327
1328 **Clean message cache when normal connected:** If option is enabled, when the device is disconnected, the message to be published will be cached in the cache area, and then will be published when the device is online again.
1329
1330
1331 **Address**
1332
1333 (% style="text-align:center" %)
1334 [[image:4.jpg]]
1335
1336 **Status address: (Total length: 2 words)**
1337
1338 HDWn: Display [MQTT] connection status.
1339
1340 |Value|Description
1341 |0|Disable MQTT server connection
1342 |1|Disconnected or connecting
1343 |2|Successfully connected the MQTT server
1344
1345 HDWn+1: Error prompt
1346
1347 |Value|Description
1348 |0|No error
1349 |-1|General error code of wrong operation
1350 |-3|Disconnected
1351 |-4|Exceed client data concurrency
1352 |-5|Invalid UTF-8 string
1353 |-6|Null pointer parameter
1354 |-7|Topic name is truncated
1355 |-8|Wrong protocol structure body
1356 |-9|Bad QoS, acceptable range is (0, 1, 2)
1357 |-10|Try to use a non-SSL version library for SSL connection
1358 |-11|Wrong MQTT version
1359 |-14|Wrong protocol type
1360 |-15|Option is not suitable for the current request version
1361 |-16|Call MQTT version that is not applicable to request.
1362 |-17|0 length connects topics
1363
1364 **Buffer usage address: (Total length: 1 word)**
1365
1366 Unsuccessful published message will be stored in memory as cache, with a maximum 100,000 messages or 2M. Value display as unit %, and it is carried unconditionally.
1367
1368 HDWn: Display buffer usage.
1369
1370 **Control address: (Total length: 123 words; If the domain name is not enabled, it will take up 59 words)**
1371
1372 HDWn: Control the execution or stop of [MQTT Server].
1373
1374 |Value|Description
1375 |0|Ready
1376 |1|Start
1377 |2|Stop
1378 |3|Update
1379
1380 HDWn+1: IP address of the MQTT server. (✎**Note: This address is only valid when IP is used.**)
1381
1382 HDWn+5: Port number of the MQTT server.
1383
1384 HDWn+6: Client ID of the MQTT server connection.
1385
1386 HDWn+26: Authentication is enabled or not. = 0, disabled; = 1, enabled.
1387
1388 HDWn+27: User name of MQTT server connection.
1389
1390 HDWn+43: Password of MQTT server connection.
1391
1392 HDWn+59: Domain name of the MQTT server. (**✎Note: This address is only valid if the domain name is used.**)
1393
1394
1395 **TLS/SSL Settings**
1396
1397 (% style="text-align:center" %)
1398 [[image:5.jpg]]
1399
1400 **Enable:** Enable TLS/SSL encryption. User can manually select encrypted versions of TLS 1.0, TLS 1.1, or TLS 1.2.
1401
1402 **Server authentication:**
1403
1404 Enable: Verify whether the server certificate has been certified by a Certificate Authority Certificate (CA). Server certificates are sent by the server when connection is established.
1405
1406 Import: Select CA certificate to import.
1407
1408 More: After the import is successful, clicking it will display the certificate details.
1409
1410 Reset: Reset the import information.
1411
1412 The server name must match the certificate information: Verify whether the server name or IP matches with the information in the certificate. Domain name and IP are recorded in the Subject Alternative Name from certificate.
1413
1414 **Client authentication:** The private key and client certificate are the data required for the server to authenticate the client end.
1415
1416 Certificate:
1417
1418 Import: Select certificate to import.
1419
1420 More: After the import is successful, clicking it will display the certificate details.
1421
1422 Reset: Reset the import information.
1423
1424 Key:
1425
1426 Import: Select the key to import.
1427
1428 More: After the import is successful, clicking it will display key details.
1429
1430 Reset: Reset the import information.
1431
1432
1433 **System topics**
1434
1435 (% style="text-align:center" %)
1436 [[image:6.jpg]]
1437
1438 **Birth Topic: **The message that HMI will publish when it is connected to server.
1439
1440 **Close Topic:** The last send message before HMI actively disconnects from server connection
1441
1442 **Last Will: **Subscription of Last Will receive this message when an abnormal disconnection occurs between HMI and the server. HMI synchronizes the Last Will message to the server when it initially establishes the connection.
1443
1444 **Topic List:** A list of topics in the HMI that is sent to the server after the HMI is connected to the server.
1445
1446 **Topic:** The actual topic name of the system topic. Maximum input length: 255 characters, cannot be empty.
1447
1448 **Retain message: **The MQTT server keeps the latest message.
1449
1450 **QoS: **MQTT provides three levels of reliability called service quality. The service quality of message transmission determines whether the message is guaranteed to be delivered.
1451
1452 QoS 0: Messages are sent only once, and delivery is not guaranteed.
1453
1454 QoS 1: Message must be delivered at least once.
1455
1456 QoS 2: Message is delivered just once.
1457
1458 **Content format:**
1459
1460 **JSON (Default):** Use default values, default values for each system topic (**The bold is represented as the current actual value**)
1461
1462 **Birth Topic:** 
1463 {
1464 "d": {
1465 "connected": true
1466 },
1467 "ts": " **Current time**"
1468 }**Close Topic: **
1469 {
1470 "d": {
1471 "connected": false
1472 },
1473 "ts": " **Current time**"
1474 }**Last Will: **
1475 {
1476 "d": {
1477 "connected": false
1478 }
1479 }**Topic list:** 
1480 {
1481 "d": {
1482 "topics": [
1483 {
1484 "compression": "
1485
1486
1487 ",
1488
1489 "nickname": "**Subject name**",
1490
1491 "topic": "**Theme**"
1492 },
1493 {
1494 "compression": "**Compression type**",
1495
1496 "nickname": "**Subject nam**e",
1497
1498 "topic": "**Theme**"
1499 }
1500 ]
1501 },
1502 "ts": "**Current time**"
1503 }
1504
1505 Messages within topics vary depending on the actual topic settings. The above is an example of two topics.
1506
1507 **JSON (Customized):** Use custom content.
1508
1509 **Choose the connection network card**
1510
1511 (% style="text-align:center" %)
1512 [[image:7.jpg]]
1513
1514 **Default:** According to the priority order of network adapters set in the HMI background to connect server.
1515
1516 **Ethernet 1: **Specify Ethernet 1 network card to connect to the server. When the system does not find Ethernet 1, connect to the server by “Default”. When system finds Ethernet 1 and binds it to connect to the server.
1517
1518 **Ethernet 2: **Specify Ethernet 2 network card to connect to the server. When the system does not find Ethernet 2, connect to the server by “Default”. When system finds Ethernet 2 and binds it to connect to the server.
1519
1520 **4G:** Specify 4G network card to connect to server. When the system does not find 4G, connect to the server by “Default”. When system finds 4G and binds it to connect to the server.
1521
1522 **Wi-Fi:** Specify Wi-Fi network card to connect to server. When the system does not find Wi-Fi, connect to the server by “Default”. When the system finds Wi-Fi and bind it to connect to the server.
1523
1524
1525 **MQTT Topic**
1526
1527 **MQTT topic publish**
1528
1529 Select [Topic publish], click [Add], enter [Add MQTT topic publish object], and set the general settings and address. The maximum number of MQTT published topics is 255.
1530
1531 (% style="text-align:center" %)
1532 [[image:8.jpg]]
1533
1534 **General properties**
1535
1536 (% style="text-align:center" %)
1537 [[image:9.jpg]]
1538
1539 **Alias:** Set the project name of the MQTT topic. Maximum input length: 255 characters, cannot be empty.
1540
1541 **Topic:** The topic received by the MQTT server when sending message. Maximum input length: 255 characters, cannot be empty.
1542
1543 Sending mode: (AUTO/TRIGGER)
1544
1545 **① AUTO **value change mode: When any value changes, MQTT message is published.
1546
1547 a. Minimum time interval between messages: The minimum time interval can be set between messages to avoid over-publishing MQTT messages. When the interval of value change is less than the minimum time interval between messages, the message will be put in the cache. The MQTT message will not be published until the minimum interval between messages is met. Range: 0~~3600000ms.
1548
1549 b. Periodic mode: Publish MQTT message by the fixed time. Time interval: Set the time interval for periodic publishing. The range is 1~~3600s.
1550
1551 **② TRIGGER**
1552
1553 When the specified bit is triggered, the MQTT message is published. When HDX0.0 changes from OFF to ON, an MQTT message is published, and HDX0.0 is automatically set to OFF after publishing.
1554
1555 **Compression type:** Message is compressed before it is transmitted. The compressed message needs to be decompressed before the MQTT client reads it. Zilb, Gzip, or Deflate algorithm can be chosen to compress or decompress the message.
1556
1557 **QoS:** MQTT provides three levels of reliability called service quality. The service quality of message transmission determines whether the message is guaranteed to be delivered.
1558
1559 0: Messages are sent only once, and delivery is not guaranteed.
1560
1561 1: Message must be delivered at least once.
1562
1563 2: Message is delivered just once.
1564
1565 **Retain message: **When checked, the MQTT server keeps the latest message.
1566
1567 **Content format:**
1568
1569 Raw data: Data composed of BYTE data.
1570
1571 JSON (General): Put all data in JSON format of member "d".
1572
1573 JSON (Advanced): JSON format of flexibly customizable nested structure.
1574
1575 **Include timestamps:** This function is only supported when the content format uses [JSON (General)], and whether to include the timestamp can be decided manually.
1576
1577 **Use the top "d" symbol in the message format:**
1578
1579 This function is only supported when the content format uses [JSON (General)]. When checked, the message format is as follows:
1580
1581 {
1582
1583 "d": {
1584
1585 "addressName1": ...,
1586
1587 "addressName2":...
1588
1589 },
1590
1591 "ts":...
1592
1593 }
1594
1595 When unchecked, the message format is as follows:
1596
1597 {
1598
1599 "addressName1": ...,
1600
1601 "addressName2":...,
1602
1603 "ts":...
1604
1605 }
1606
1607 As shown above, when unchecked, ts and address names are both key at the same level. Therefore, avoid taking the address name as ts.
1608
1609 **Address setting**
1610
1611 ①Address settings when content formats use [Raw Data] and [JSON (General)].
1612
1613 (% style="text-align:center" %)
1614 [[image:10.jpg]]
1615
1616 **Add:** Establish the address source of the topic. The length of each address can be set separately.
1617
1618 **Delete:** Delete the address.
1619
1620 **Settings:** Modify the address and name.
1621
1622 (% style="text-align:center" %)
1623 [[image:11.jpg]]
1624
1625 **Included in all message sent**
1626
1627 Check the options: This topic will include this address every time it publishes a message.
1628
1629 Uncheck the options: When the sending mode is value, message is published only when the value of the address changes.
1630
1631 **Remove JSON array brackets' ['and'] ':**
1632
1633 Check the options: Remove the array symbol name when using non-array bits or characters.
1634
1635 **✎Note: A topic can be configured up to 255 nodes. The name length of a node can be configured up to a maximum of 255 characters and cannot be empty.**
1636
1637 ② Address setting when the content format uses [JSON (Advanced)]. [JSON (Advanced)] supports nested structure, which can use components, arrays and other forms. Timestamps and data names can also be customized, which is a more flexible design method.
1638
1639 (% style="text-align:center" %)
1640 [[image:12.jpg]]
1641
1642 The above figure is an example. If setting like above figure, the subscription side will receive the MQTT message like following format.
1643
1644 {
1645 "object": {
1646 "value": "teststring",
1647 "value (1)": 123,
1648 "value (2)": true,
1649 "value (3)": "",
1650 "value (4)": 0,
1651 "value (5)": true
1652 },
1653 "array": [
1654 10,
1655 20,
1656 30
1657 ],
1658 "value (6)": " 2023-04-27T03: 53: 20.156271 "
1659 }
1660
1661 **New component:** Add a new data component. Components can have multiple data formats; each data format has its own Name and Value. The data of the component is included in braces {}.
1662
1663 **New value:** Add a new value, string, or timestamp. When it is a value or a string, it can be fixed value or read data from a specified address.
1664
1665 **Delete:** Delete the selected field.
1666
1667 **Settings:** Modify the selected field. If the selected fields are components and arrays, only the names can be modified. But components and arrays include values that can modify parameters.
1668
1669 **Template:** Paste the JSON text here, and the system will automatically arrange the style to conform to this JSON format, saving the time of self-definition.
1670
1671 **Preview:** Preview JSON data in an easy-to-read format.
1672
1673 **✎Note: A Topic can be up to 512 nodes (including payload), and a node name can be configured to be up to 255 characters length.**
1674
1675 **Security settings**
1676
1677 The topic is published only when the register status matches the setting. As shown in the following figure, this topic will not be published until the address HDX0.0 is set to ON.
1678
1679 (% style="text-align:center" %)
1680 [[image:13.jpg]]
1681
1682 **MQTT topic subscription**
1683
1684 Select [Topic subscription] and click [Add] to enter general property settings and address settings. The maximum number of MQTT subscription topics is 255.
1685
1686 (% style="text-align:center" %)
1687 [[image:14.jpg]]
1688
1689 **General properties**
1690
1691 (% style="text-align:center" %)
1692 [[image:15.jpg]]
1693
1694 **Alias:** Set the project name of the MQTT topic. Maximum input length: 255 characters, cannot be empty.
1695
1696 **Topic:** Topics subscribed from the MQTT server. Maximum input length: 255 characters, cannot be empty.
1697
1698 **Compression type:** The transport compression type of a subscription topic must be the same as that of a publication topic.
1699
1700 **QoS:** MQTT provides three levels of reliability called service quality. The service quality of message transmission determines whether the message is guaranteed to be delivered.
1701
1702 0: Messages are sent only once, and delivery is not guaranteed.
1703
1704 1: Message must be delivered at least once.
1705
1706 2: Message is delivered just once.
1707
1708 **Content format:**
1709
1710 Raw data: There is no original data in a specific format.
1711
1712 JSON (General): JSON format of single-layer structure.
1713
1714 JSON (Advanced): JSON format of flexibly customizable nested structure.
1715
1716 **Verify timestamp:** The user can decide whether to verify the timestamp or not. When checked, it indicates that the received data timestamp must be strictly incremented before it can be updated. Otherwise, it will be judged as outdated data and not updated.
1717
1718 **Use the top "d" symbol in the message format:**
1719
1720 This function is only supported when the content format uses [JSON (General)]. When checked, the message format is as follows:
1721
1722 {
1723
1724 "d": {
1725
1726 "addressName1": ...,
1727
1728 "addressName2":...
1729
1730 },
1731
1732 "ts":...
1733
1734 }
1735
1736 When unchecked, the message format is as follows:
1737
1738 {
1739
1740 "addressName1": ..., "addressName2":...,
1741
1742 "ts":...
1743
1744 }
1745
1746 Please select the appropriate settings according to the data source.
1747
1748 **Address settings**
1749
1750 ①Address settings when content formats use [Raw Data] and [JSON (General)].
1751
1752 (% style="text-align:center" %)
1753 [[image:16.jpg]]
1754
1755 **Add:** Establish the address where the data is stored after the topic is subscribed, and the length of each address can be set separately.
1756
1757 **Delete:** Delete the address.
1758
1759 **Settings:** Modify the address and name.
1760
1761 (% style="text-align:center" %)
1762 [[image:17.jpg]]
1763
1764 **Remove JSON array brackets' ['and'] ':**
1765
1766 When using non-array bits or characters, array symbol can manually be removed.
1767
1768 **✎Note: A topic can be configured up to 255 nodes. The name length of a node can be configured up to a maximum of 255 characters and cannot be empty.**
1769
1770 ② Address setting when the content format uses [JSON (Advanced)]. [JSON (Advanced)] supports nested structure, which can use components, arrays and other forms. Timestamps and data names can also be customized, which is a more flexible design method.
1771
1772 (% style="text-align:center" %)
1773 [[image:18.jpg]]
1774
1775 **New component:** Add a new data component. There can be multiple data formats in a component, each with a name and a value. The data of the component is included in braces {}.
1776
1777 **New Array:** Add a new data array. Arrays can have multiple data formats, but only one name. The data of the component is included in brackets [].
1778
1779 **New value:** Add a new value, string, or timestamp. When it is a value or a string, it can be fixed value or read data from a specified address.
1780
1781 **Delete:** Delete the selected field.
1782
1783 **Settings:** Modify the selected field. If the selected fields are components and arrays, only the names can be modified. But components and arrays include values that can modify parameters.
1784
1785 **Template:** Paste the JSON text here, and the system will automatically arrange the style to conform to this JSON format, saving the time of self-definition.
1786
1787 **Preview:** Preview JSON data in an easy-to-read format.
1788
1789 **✎Note: A Topic can be up to 512 nodes (including payload), and a node name can be configured to be up to 255 characters length.**
1790
1791 **(3) Security settings**
1792
1793 The topic is published only when the register status matches the setting. As shown in the following figure, this topic will not be published until the address HDX0.0 is set to ON.
1794
1795 (% style="text-align:center" %)
1796 [[image:19.jpg]]
1797
1798 **MQTT Server Settings (AWS IOT)**
1799
1800 **General**
1801
1802 (% style="text-align:center" %)
1803 [[image:20.jpg]]
1804
1805 **Description:** Enter a description or comment about the server. Maximum input length: 255 characters, cannot be empty.
1806
1807 **Cloud service description**: (Select AWS IOT)
1808
1809 ① Common (Common Platform): General MQTT publish-subscribe topic mode.
1810
1811 ② AWS IoT (Amazon): Using "AWS IoT" as the Broker, using Thing to transfer data and support Shadow function.
1812
1813 ③ ALi (Alibaba Cloud): Using "Alibaba Cloud" as Broker.
1814
1815 ④ Huawei (Huawei Cloud): Using "Huawei Cloud" as Broker.
1816
1817 **Communication protocol**: MQTT v3.1.1 is supported.
1818
1819 **Domain name:** Set the domain name of the MQTT server that receives message. (Obtained from the AWS IOT platform) Maximum input length: 128 characters, cannot be empty, supports letters, numbers, "-", “.”. The symbol cannot be placed at the first character or last character of name.
1820
1821 **Port number:** Set the MQTT server port to receive message. Range: 0~~65535, cannot be empty. (AWS IOT platform is generally 8883).
1822
1823 **Client ID:** Login name. Variables can be used as login names. For example: Enter %0 and the Client ID is the device name (This can be set in the HMI background. If not, the default is HMI model). **(✎Note: A Client ID can only be used on one device.)** The maximum configurable length is 40 characters.
1824
1825 **Timestamp:** LOCAL: Using the HMI time as the timestamp. UTC Time: Using UTC+0.
1826
1827
1828 **Address**
1829
1830 (% style="text-align:center" %)
1831 [[image:21.jpg]]
1832
1833 **Status address: (Total length: 2 words)**
1834
1835 HDWn: Display [MQTT] connection status.
1836
1837 |Value|Description
1838 |0|Disable MQTT server connection
1839 |1|Disconnected or connecting
1840 |2|Successfully connected the MQTT server
1841
1842 HDWn+1: Error prompt
1843
1844 |Value|Description
1845 |0|No error
1846 |-1|General error code of wrong operation
1847 |-3|Disconnected
1848 |-4|Exceed client data concurrency
1849 |-5|Invalid UTF-8 string
1850 |-6|Null pointer parameter
1851 |-7|Topic name is truncated
1852 |-8|Wrong protocol structure body
1853 |-9|Wrong QOS.  (0, 1, 2) is acceptable.
1854 |-10|Attempt to use a non-SSL library for SSL connection
1855 |-11|Wrong MQTT version
1856 |-14|Wrong protocol type
1857 |-15|Option is not suitable for the current request version
1858 |-16|Call MQTT version that is not applicable to request.
1859 |-17|0 length topic connection
1860
1861 **Buffer usage address:** Not available.
1862
1863 **Control address: (Total length: 90 words)**
1864
1865 HDWn: Control the execution or stop of [MQTT Server].
1866
1867 |Value|Description
1868 |0|Ready
1869 |1|Start
1870 |2|Stop
1871 |3|Update
1872
1873 HDWn+1: Reserved for use.
1874
1875 HDWn+5: Port number of the AWS IOT connection.
1876
1877 HDWn+6: Client ID of the AWS IOT connection.
1878
1879 HDWn+26: Domain name of the AWS IOT connection. 
1880
1881 **TLS/SSL Settings**
1882
1883 (% style="text-align:center" %)
1884 [[image:22.jpg]]
1885
1886 **Enable:**
1887
1888 Enabled by default. The default is TLS V1.2.
1889
1890 **Server authentication:**
1891
1892 Enabled by default: Verify whether the server certificate has been certified by a Certificate Authority Certificate (CA). Server certificates are sent by the server when connection is established.
1893
1894 Import: Select CA certificate to import.
1895
1896 More: After the import is successful, clicking it will display the certificate details.
1897
1898 Reset: Reset the import information.
1899
1900 The server name must be matched with the certificate information to verify whether the server name or IP matches the records in the certificate. Domain name and IP are recorded in the Subject Alternative Name in the certificate.
1901
1902 **(3) Client authentication:** The private key and client certificate are the data required for the server to authenticate the client end.
1903
1904 Certificate:
1905
1906 Import: Select certificate to import.
1907
1908 More: After the import is successful, clicking it will display the certificate details.
1909
1910 Reset: Reset the import information.
1911
1912 Key:
1913
1914 Import: Select the key to import.
1915
1916 More: After the import is successful, clicking it will display key details.
1917
1918 Reset: Reset the import information.
1919
1920
1921 **Device setting**
1922
1923 Select [Add] to enter [General property settings and address settings]. To delete a device, select the device and click Delete.
1924
1925 (% style="text-align:center" %)
1926 [[image:23.jpg]]
1927
1928 **General**
1929
1930 (% style="text-align:center" %)
1931 [[image:24.jpg]]
1932
1933 **Device name:** It is consistent with the item name on AWS IOT. Maximum input length: 128 characters, cannot be empty, supports letters, numbers, "-", "_".
1934
1935 **Description:** For distinguish purpose. Maximum input length: 255 characters.
1936
1937 **Minimum time interval between messages:** The minimum time interval can be set between messages to avoid over-publishing MQTT messages. That is, when the interval of value change is less than the minimum time interval between messages, the message will be put in the cache, and the MQTT message will not be released until the minimum time interval between messages is met. Range: 0~~3600000ms.
1938
1939 **QoS:** MQTT provides three levels of reliability called service quality. The service quality of message transmission determines whether the message is guaranteed to be delivered.
1940
1941 0: Messages are sent only once, and delivery is not guaranteed.
1942
1943 1: Message must be delivered at least once.
1944
1945 2: Message is delivered just once.
1946
1947 **Content format:** Not configurable. All data is in JSON format.
1948
1949 **Include timestamps:** Whether to include the timestamp can be decided manually.
1950
1951 **Use the top "d" symbol in the message format:**
1952
1953 This function is only supported when the content format uses [JSON (General)]. When checked, the message format is as follows:
1954
1955 {
1956
1957 "d": {
1958
1959 "addressName1": ...,
1960
1961 "addressName2":...
1962
1963 },
1964
1965 "ts":...
1966
1967 }
1968
1969 When unchecked, the message format is as follows:
1970
1971 {
1972
1973 "addressName1": ...,
1974
1975 "addressName2":...,
1976
1977 "ts":...
1978
1979 }
1980
1981 As shown above, when unchecked, ts and address names are both key at the same level. Therefore, avoid taking the address name as ts.
1982
1983 **Address**
1984
1985 (% style="text-align:center" %)
1986 [[image:25.jpg]]
1987
1988 **Add:** Establish the address source of the topic. The length of each address can be set separately.
1989
1990 **Delete:** Delete the address.
1991
1992 **Settings:** Modify the address and name.
1993
1994 (% style="text-align:center" %)
1995 [[image:26.jpg]]
1996
1997 **Advanced Mode:**
1998
1999 Check the options: Check to configure four “Settings/Status".
2000
2001 Uncheck the options: Check to configure two "Settings/Status".
2002
2003 **Name:** Correspond to the key value in JSON.
2004
2005 **Type:** “Bit" and “Word” are optional. “Word” configuration can choose system of numeration.
2006
2007 **Length:**
2008
2009 Length 1: General JSON format.
2010
2011 Length > 1: Enable the format of JSON array. The values of continuous address with the configuration address as the first address as the elements of the array. This length is valid to the selected "settings/status”. (For example, the length is set to 3, and 4 "settings/states" are checked, so the length of these 4 are all 3). Range: 1-255.
2012
2013 For example, configure as the following figure:
2014
2015 (% style="text-align:center" %)
2016 [[image:27.jpg]]
2017
2018 Then HDW0, HDW2 and HDW4 will be read and published to the reported key; HDW10, HDW12, HDW14 will be read and published to the desired key. For example, if HDW0=1, HDW2=2, HDW4=3, HDW10=4, HDW12=5, and HDW14=6, the subscribed message format is as follows.
2019
2020 {
2021
2022 "state": {
2023
2024 "desired": {
2025
2026 "welcome": [1, 2, 3]
2027
2028 },
2029
2030 "reported": {
2031
2032 "welcome": [4, 5, 6]
2033
2034 }
2035
2036 }
2037
2038 }
2039
2040 **Status (Device address~-~->AWS IOT "reported"):** Pass a value from the Device address to the AWS IOT “reported” in one direction, which is equivalent to publishing to "reported".
2041
2042 **Setting (Device address->AWS IOT "desired"):** Pass a value from the Device address to the AWS IOT “desired” in one direction, which is equivalent to publishing to “desired".
2043
2044 **Status (AWS IOT "reported"->Device address):** Pass a value from AWS IOT "reported" to Device address in one direction, which is equivalent to subscribing to "reported".
2045
2046 **Settings (AWS IOT "desired"->Device address):** Pass a value from the AWS IOT "desired" to the Device address in one direction, which is equivalent to subscribing to "desired".
2047
2048 **Remove JSON array brackets' ['and'] ':** Check to remove array symbols when using non-array bits or characters. (Configurable when length is 1).
2049
2050 **MQTT Server Settings (ALi)**
2051
2052 **General**
2053
2054 (% style="text-align:center" %)
2055 [[image:28.jpg]]
2056
2057 **Description:** Enter a description or comment about the server. Maximum input length: 255 characters, cannot be empty.
2058
2059 **Cloud service description**: (Select Ali)
2060
2061 ① Common (Common Platform): General MQTT publish-subscribe topic mode.
2062
2063 ② AWS IoT (Amazon): Using "AWS IoT" as the Broker, using Thing to transfer data and support Shadow function.
2064
2065 ③ ALi (Alibaba Cloud): Using "Alibaba Cloud" as Broker.
2066
2067 ④ Huawei (Huawei Cloud): Using "Huawei Cloud" as Broker.
2068
2069 **Communication protocol**: MQTTv3.1, v3.1.1 and v5 are supported.
2070
2071 **Domain name:** Set the domain name of the MQTT server that receives message. Maximum input length: 128 characters, cannot be empty, supports letters, numbers, "-", “.”. The symbol cannot be placed at the first character or last character of name.
2072
2073 **Port number:** Set the MQTT server port to subscribe message. Range: 0~~65535, cannot be empty.
2074
2075 **Client ID:** Login name. Variables can be used as login names. For example: Enter %0 and the Client ID is the device name (This can be set in the HMI background. If not, the default is HMI model). (Note: A Client ID can only be used for one device.) When there is no custom Client ID length, the maximum configurable length of a Client ID is 64 characters.
2076
2077 **ProductId:** The key of the product to which the device belongs, that is, the globally unique identifier issued by the IoT platform for the product. (Obtained from Alibaba Cloud Platform) Maximum input length: 128 characters.
2078
2079 **DeviceId:** Unique identifier of the device within the product. DeviceName is combined with ProductKey of the product to which the device belongs as the device identification, which is used for connection authentication and communication with the IoT platform. (Obtained from Alibaba Cloud Platform) Maximum input length: 64 characters.
2080
2081 **DeviceSecret:** The device key issued by the IoT platform for devices is used for authentication and encryption. It needs to be used in pairs with DeviceName. (Obtained from Alibaba Cloud Platform) Maximum input length: 128 characters.
2082
2083 **Encryption algorithm:** Alibaba Cloud's signature algorithm type supports hmacmd5 and hmacsha1.
2084
2085 **Timestamp:** LOCAL: Using the HMI time as the timestamp. UTC Time: Use UTC+0 time.
2086
2087 **Clean message cache when normal connected:** If option is enabled, when the device is disconnected, the message to be published will be cached in the cache area, and then will be published when the device is online again.
2088
2089
2090 **Address**
2091
2092 (% style="text-align:center" %)
2093 [[image:29.jpg]]
2094
2095 **Status address: (Total length: 2 words)**
2096
2097 HDWn: Display [MQTT] connection status.
2098
2099 |Value|Description
2100 |0|Disable MQTT server connection
2101 |1|Disconnected or connecting
2102 |2|Successfully connected the MQTT server
2103
2104 HDWn+1: Error prompt
2105
2106 |Value|Description
2107 |0|No error
2108 |-1|General error code of wrong operation
2109 |-3|Disconnected
2110 |-4|Exceed client data concurrency
2111 |-5|Invalid UTF-8 string
2112 |-6|Null pointer parameter
2113 |-7|Topic name is truncated
2114 |-8|Wrong protocol structure body
2115 |-9|Wrong QOS.  (0, 1, 2) is acceptable.
2116 |-10|Attempt to use a non-SSL library for SSL connection
2117 |-11|Wrong MQTT version
2118 |-14|Wrong protocol type
2119 |-15|Option is not suitable for the current request version
2120 |-16|Call MQTT version that is not applicable to request.
2121 |-17|0 length topic connection
2122
2123 **Buffer usage address: (Total length: 1 word)**
2124
2125 Unsuccessful published message will be stored in memory as cache, with a maximum 100,000 messages or 2M. Value display as unit %, and it is carried unconditionally.
2126
2127 HDWn: Display buffer usage.
2128
2129 **Control address: (Total length: 258 words)**
2130
2131 HDWn: Control the execution or stop of [MQTT Server].
2132
2133 |Value|Description
2134 |0|Ready
2135 |1|Start
2136 |2|Stop
2137 |3|Update
2138
2139 HDWn+1: Port number of the Alibaba Cloud connection.
2140
2141 HDWn+2: Domain name title of the Alibaba Cloud connection.
2142
2143 HDWn+66: Client ID of the Alibaba Cloud connection.
2144
2145 HDWn+98: ProductId of the Alibaba Cloud connection.
2146
2147 HDWn+162: DeviceId of the Alibaba Cloud connection.
2148
2149 HDWn+194: DeviceSecret of the Alibaba Cloud connection.
2150
2151 **TLS/SSL Settings**
2152
2153 (% style="text-align:center" %)
2154 [[image:30.jpg]]
2155
2156 **Enable:** Enable TLS/SSL encryption. User can manually select encrypted versions of TLS 1.0, TLS 1.1, or TLS 1.2.
2157
2158 **Server authentication:**
2159
2160 Enable: Verify whether the server certificate has been certified by a Certificate Authority Certificate (CA). Server certificates are sent by the server when connection is established.
2161
2162 Import: Select CA certificate to import.
2163
2164 More: After the import is successful, clicking it will display the certificate details.
2165
2166 Reset: Reset the import information.
2167
2168 The server name must be matched with the certificate information to verify whether the server name or IP matches the records in the certificate. Domain name and IP are recorded in the Subject Alternative Name in the certificate.
2169
2170 **(3) Client authentication:** The private key and client certificate are the data required for the server to authenticate the client end.
2171
2172 Certificate:
2173
2174 Import: Select certificate to import.
2175
2176 More: After the import is successful, clicking it will display the certificate details.
2177
2178 Reset: Reset the import information.
2179
2180 Key:
2181
2182 Import: Select the key to import.
2183
2184 More: After the import is successful, clicking it will display key details.
2185
2186 Reset: Reset the import information.
2187
2188
2189 **MQTT Topic**
2190
2191 (% class="wikigeneratedid" id="H1.MQTTtopicpublish" %)
2192 **MQTT topic publish**
2193
2194 Select [Topic publish], click [Add], enter [Add MQTT topic publish object], and set the general settings and address. The maximum number of MQTT published topics is 255.
2195
2196 (% style="text-align:center" %)
2197 [[image:31.jpg]]
2198
2199 **General properties**
2200
2201 (% style="text-align:center" %)
2202 [[image:32.jpg]]
2203
2204
2205 **Alias:** Set the project name of the MQTT theme. Maximum input length: 255 characters, cannot be empty.
2206
2207 **Topic:** The topic received by the MQTT server when sending message. Maximum input length: 255 characters, cannot be empty.
2208
2209 **Sending mode:** **(AUTO/TRIGGER)**
2210
2211 **① AUTO **value change mode: When any value changes, MQTT message is published.
2212
2213 a. Minimum time interval between messages: The minimum time interval can be set between messages to avoid over-publishing MQTT messages. When the interval of value change is less than the minimum time interval between messages, the message will be put in the cache. The MQTT message will not be published until the minimum interval between messages is met. Range: 0~~3600000ms.
2214
2215 b. Periodic mode: Publish MQTT message by the fixed time. Time interval: Set the time interval for periodic publishing, ranging from 1 to 3600s.
2216
2217 **② TRIGGER**
2218
2219 When the specified bit is triggered, the MQTT message is published. When HDX0.0 changes from OFF to ON, an MQTT message is published, and HDX0.0 is automatically set to OFF after publishing.
2220
2221 **Compression type:** Message is compressed before it is transmitted. The compressed message needs to be decompressed before the MQTT client reads it. Zlib, Gzip, or Deflate algorithm can be chosen to compress or decompress the message.
2222
2223 **QoS:** MQTT provides three levels of reliability called service quality. The service quality of message transmission determines whether the message is guaranteed to be delivered.
2224
2225 0: Messages are sent only once, and delivery is not guaranteed.
2226
2227 1: Message must be delivered at least once.
2228
2229 2: Message is delivered just once.
2230
2231 **Retain message:** When checked, the MQTT server will keep the latest message.
2232
2233 **Content format:**
2234
2235 Raw data: Data composed of BYTE data.
2236
2237 JSON (General): Put all data in JSON format of member "d".
2238
2239 JSON (Advanced): JSON format of flexibly customizable nested structure.
2240
2241 **Include timestamps:** This function is only supported when the content format uses [JSON (General)], and whether to include the timestamp can be decided manually.
2242
2243 **Use the top "d" symbol in the message format:**
2244
2245 This function is only supported when the content format uses [JSON (General)]. When checked, the message format is as follows:
2246
2247 {
2248
2249 "d": {
2250
2251 "addressName1": ...,
2252
2253 "addressName2":...
2254
2255 },
2256
2257 "ts":...
2258
2259 }
2260
2261 When unchecked, the message format is as follows:
2262
2263 {
2264
2265 "addressName1": ...,
2266
2267 "addressName2":...,
2268
2269 "ts":...
2270
2271 }
2272
2273 As shown above, when unchecked, ts and address names are both key at the same level. Therefore, avoid taking the address name as ts.
2274
2275
2276 **Address setting**
2277
2278 ①Address settings when content formats use [Raw Data] and [JSON (General)].
2279
2280 (% style="text-align:center" %)
2281 [[image:33.jpg]]
2282
2283 **Add:** Establish the address source of the topic. The length of each address can be set separately.
2284
2285 **Delete:** Delete the address.
2286
2287 **Settings:** Modify the address and name.
2288
2289 (% style="text-align:center" %)
2290 [[image:34.jpg]]
2291
2292 **Included in all message sent**
2293
2294 Check the options: This topic will include this address every time it publishes a message.
2295
2296 Uncheck the options: When the sending mode is value, message is published only when the value of the address changes.
2297
2298 **Remove JSON array brackets' ['and'] ':**
2299
2300 Check the options: Remove the array symbol name when using non-array bits or characters.
2301
2302 **✎Note: A topic can be configured up to 255 nodes. The name length of a node can be configured up to a maximum of 255 characters and cannot be empty.**
2303
2304 ② Address setting when the content format uses [JSON (Advanced)]. [JSON (Advanced)] supports nested structure, which can use components, arrays and other forms. Timestamps and data names can also be customized, which is a more flexible design method.
2305
2306 (% style="text-align:center" %)
2307 [[image:HMIEditor_Db5tLtioq7.jpg]]
2308
2309 The above figure is an example. If setting like above figure, the subscription side will receive the MQTT message like following format.
2310
2311 {
2312 "object": {
2313 "value": "teststring",
2314 "value (1)": 123,
2315 "value (2)": true,
2316 "value (3)": "",
2317 "value (4)": 0,
2318 "value (5)": true
2319 },
2320 "array": [
2321 10,
2322 20,
2323 30
2324 ],
2325 "value (6)": " 2023-04-27T03: 53: 20.156271 "
2326 }
2327
2328 **New component:** Add a new data component. Components can have multiple data formats; each data format has its own Name and Value. The data of the component is included in braces {}.
2329
2330 **New value:** Add a value, string, or timestamp. When it is a value or a string, data can be read for a fixed value or from a specified address.
2331
2332 **Delete:** Delete the selected field.
2333
2334 **Settings:** Modify the selected field. If the selected fields are components and arrays, only the names can be modified. But components and arrays include values that can modify parameters.
2335
2336 **Template:** Paste the JSON text, and the system will automatically arrange the schema to conform to this JSON format, saving the time of self-definition.
2337
2338 **Preview:** Preview JSON data in an easy-to-read format.
2339
2340 **✎Note: A Topic can be up to 512 nodes (including payload), and a node name can be configured to be up to 255 characters length.**
2341
2342
2343 **Security settings**
2344
2345 The topic is published only when the register status matches the setting. As shown in the following figure, this topic will not be published until the address HDX0.0 is set to ON.
2346
2347 (% style="text-align:center" %)
2348 [[image:35.jpg]]
2349
2350 **MQTT topic subscription**
2351
2352 Select [Topic subscription] and click [Add] to enter general property settings and address settings. The maximum number of MQTT subscription topics is 255.
2353
2354 (% style="text-align:center" %)
2355 [[image:36.jpg]]
2356
2357 **General properties**
2358
2359 (% style="text-align:center" %)
2360 [[image:37.jpg]]
2361
2362 **Alias:** Set the project name of the MQTT theme. Maximum input length: 255 characters, cannot be empty.
2363
2364 **Topic:** Topics subscribed from the MQTT server. Maximum input length: 255 characters, cannot be empty.
2365
2366 **Compression type:** The transport compression type of a subscription topic must be the same as that of a publication topic.
2367
2368 **QoS:** MQTT provides three levels of reliability called service quality. The service quality of message transmission determines whether the message is guaranteed to be delivered.
2369
2370 0: Messages are sent only once, and delivery is not guaranteed.
2371
2372 1: Message must be delivered at least once.
2373
2374 2: Message is delivered just once.
2375
2376 **Content format:**
2377
2378 Raw data: There is no original data in a specific format.
2379
2380 JSON (General): JSON format of single-layer structure.
2381
2382 JSON (Advanced): JSON format of flexibly customizable nested structure.
2383
2384 **Verify timestamp:** The user can decide whether to verify the timestamp or not. When checked, it indicates that the received data timestamp must be strictly incremented before it can be updated. Otherwise, it will be judged as outdated data and not updated.
2385
2386 **Use the top "d" symbol in the message format:**
2387
2388 This function is only supported when the content format uses [JSON (General)]. When checked, the message format is as follows:
2389
2390 {
2391
2392 "d": {
2393
2394 "addressName1": ...,
2395
2396 "addressName2":...
2397
2398 },
2399
2400 "ts":...
2401
2402 }
2403
2404 When unchecked, the message format is as follows:
2405
2406 {
2407
2408 "addressName1": ..., "addressName2":...,
2409
2410 "ts":...
2411
2412 }
2413
2414 Please select the appropriate settings according to the data source.
2415
2416 **Address setting**
2417
2418 ①Address settings when content formats use [Raw Data] and [JSON (General)].
2419
2420 (% style="text-align:center" %)
2421 [[image:38.jpg]]
2422
2423 **Add:** Establish the address where the data is placed after the topic is subscribed, and the length of each address can be set separately.
2424
2425 **Delete:** Delete the address.
2426
2427 **Settings:** Modify the address and name.
2428
2429 (% style="text-align:center" %)
2430 [[image:39.jpg]]
2431
2432 **Remove JSON array brackets' ['and'] ':**
2433
2434 When using non-array bits or characters, array symbol can manually be removed.
2435
2436 **✎Note: A topic can be configured up to 255 nodes. The name length of a node can be configured up to a maximum of 255 characters and cannot be empty.**
2437
2438 ② Address setting when the content format uses [JSON (Advanced)]. [JSON (Advanced)] supports nested structure, which can use components, arrays and other forms. Timestamps and data names can also be customized, which is a more flexible design method.
2439
2440 (% style="text-align:center" %)
2441 [[image:40.jpg]]
2442
2443 **New component:** Add a new data component. There can be multiple data formats in a component, each with a name and a value. The data of the component is included in braces {}.
2444
2445 **New Array:** Add a new data array. Arrays can have multiple data formats, but only one name. The data of the component is included in brackets [].
2446
2447 **New value:** Add a value, string, or timestamp. When it is a value or a string, data can be read for a fixed value or from a specified address.
2448
2449 **Delete:** Delete the selected field.
2450
2451 **Settings:** Modify the selected field. If the selected fields are components and arrays, only the names can be modified. But components and arrays include values that can modify parameters.
2452
2453 **Template:** Paste the JSON text, and the system will automatically arrange the schema to conform to this JSON format, saving the time of self-definition.
2454
2455 **Preview:** Preview JSON data in an easy-to-read format.
2456
2457 **✎Note: A Topic can be up to 512 nodes (including payload), and a node name can be configured to be up to 255 characters length.**
2458
2459
2460 **Security settings**
2461
2462 The topic is published only when the register status matches the setting. As shown in the following figure, this topic will not be published until the address HDX0.0 is set to ON.
2463
2464 (% style="text-align:center" %)
2465 [[image:41.jpg]]
2466
2467 **MQTT Server Settings (Huawei)**
2468
2469 **General**
2470
2471 (% style="text-align:center" %)
2472 [[image:42.jpg]]
2473
2474 **Description:** Enter a description or comment about the server. Maximum input length: 255 characters, cannot be empty.
2475
2476 **Cloud service description**: (Select Huawei)
2477
2478 ① Common (Common Platform): General MQTT publish-subscribe topic mode.
2479
2480 ② AWS IoT (Amazon): Using "AWS IoT" as the Broker, using Thing to transfer data and support Shadow function.
2481
2482 ③ ALi (Alibaba Cloud): Using "Alibaba Cloud" as Broker.
2483
2484 ④ Huawei (Huawei Cloud): Using "Huawei Cloud" as Broker.
2485
2486 **Communication protocol**: MQTTv3.1, v3.1.1 and v5 are supported.
2487
2488 **Domain name:** Set the domain name of the MQTT server that subscribe message. Maximum input length: 128 characters, cannot be empty, supports letters, numbers, "-", “.”. The symbol cannot be placed at the first character or last character of name.
2489
2490 **Port number:** Set the MQTT server port to subscribe message. Range: 0~~65535, cannot be empty.
2491
2492 **DeviceId:** **Device ID** generated when registering the device in Huawei Cloud. Maximum input length: 128 characters
2493
2494 **DeviceSecret:** Customized **password **when registering devices on Huawei Cloud Maximum input length: 128 characters.
2495
2496 **Timestamp:** LOCAL: Using the HMI time as the timestamp. UTC Time: Using UTC+0.
2497
2498 **Clean message cache when normal connected:** If option is enabled, when the device is disconnected, the message to be published will be cached in the cache area, and then will be published when the device is online again.
2499
2500
2501 **Address**
2502
2503 (% style="text-align:center" %)
2504 [[image:43.jpg]]
2505
2506 **Status address: (Total length: 2 words)**
2507
2508 HDWn: Display [MQTT] connection status.
2509
2510 |Value|Description
2511 |0|Disable MQTT server connection
2512 |1|Disconnected or connecting
2513 |2|Successfully connected the MQTT server
2514
2515 HDWn+1: Error prompt
2516
2517 |Value|Description
2518 |0|No error
2519 |-1|General error code of wrong operation
2520 |-3|Disconnected
2521 |-4|Exceed client data concurrency
2522 |-5|Invalid UTF-8 string
2523 |-6|Null pointer parameter
2524 |-7|Topic name is truncated
2525 |-8|Wrong protocol structure body
2526 |-9|Wrong QOS.  (0, 1, 2) is acceptable.
2527 |-10|Attempt to use a non-SSL library for SSL connection
2528 |-11|Wrong MQTT version
2529 |-14|Wrong protocol type
2530 |-15|Option is not suitable for the current request version
2531 |-16|Call MQTT version that is not applicable to request.
2532 |-17|0 length topic connection
2533
2534 **Buffer usage address: (Total length: 1 word)**
2535
2536 Unsuccessful published message will be stored in memory as cache, with a maximum 100,000 messages or 2M. Value display as unit %, and it is carried unconditionally.
2537
2538 HDWn: Display buffer usage.
2539
2540 **Control address: (Total length: 194 words)**
2541
2542 HDWn: Control the execution or stop of [MQTT Server].
2543
2544 |Value|Description
2545 |0|Ready
2546 |1|Start
2547 |2|Stop
2548 |3|Update
2549
2550 HDWn+1: Port number of the Huawei Cloud.
2551
2552 HDWn+2: Domain name of the Huawei Cloud.
2553
2554 HDWn+66: DeviceSecret of the Huawei Cloud.
2555
2556 HDWn+130: DeviceSecret of the Huawei Cloud.
2557
2558 **TLS/SSL Settings**
2559
2560 (% style="text-align:center" %)
2561 [[image:44.jpg]]
2562
2563 **Enable:** Enable TLS/SSL encryption. User can manually select encrypted versions of TLS 1.0, TLS 1.1, or TLS 1.2.
2564
2565 **Server authentication:**
2566
2567 Enable: Verify whether the server certificate has been certified by a Certificate Authority Certificate (CA). Server certificates are sent by the server when connection is established.
2568
2569 Import: Select CA certificate to import.
2570
2571 More: After the import is successful, clicking it will display the certificate details.
2572
2573 Reset: Reset the import information.
2574
2575 The server name must match the certificate information: Verify whether the server name or IP matches with the information in the certificate. Domain name and IP are recorded in the Subject Alternative Name from certificate.
2576
2577 **Client authentication:** The private key and client certificate are the data required for the server to authenticate the client end.
2578
2579 Certificate:
2580
2581 Import: Select certificate to import.
2582
2583 More: After the import is successful, clicking it will display the certificate details.
2584
2585 Reset: Reset the import information.
2586
2587 Key:
2588
2589 Import: Select the key to import.
2590
2591 More: After the import is successful, clicking it will display key details.
2592
2593 Reset: Reset the import information.
2594
2595 **MQTT Topic**
2596
2597 **MQTT topic publish**
2598
2599 Select [Topic publish], click [Add], enter [Add MQTT topic publish object], and set the general settings and address. The maximum number of MQTT published topics is 255.
2600
2601 (% style="text-align:center" %)
2602 [[image:45.jpg]]
2603
2604 **General properties**
2605
2606 (% style="text-align:center" %)
2607 [[image:46.jpg]]
2608
2609 **Alias:** Set the project name of the MQTT theme. Maximum input length: 255 characters, cannot be empty.
2610
2611 **Topic:** The topic received by the MQTT server when sending message. Maximum input length: 255 characters, cannot be empty.
2612
2613 **Sending mode:** **(AUTO/TRIGGER)**
2614
2615 **① AUTO **value change mode: When any value changes, MQTT message is published.
2616
2617 a. Minimum time interval between messages: The minimum time interval can be set between messages to avoid over-publishing MQTT messages. When the interval of value change is less than the minimum time interval between messages, the message will be put in the cache. The MQTT message will not be published until the minimum interval between messages is met. Range: 0~~3600000ms.
2618
2619 b. Periodic mode: Publish MQTT message by the fixed time. Time interval: Set the time interval for periodic publishing, ranging from 1 to 3600s.
2620
2621 **② TRIGGER**
2622
2623 When the specified bit is triggered, the MQTT message is published. When HDX0.0 changes from OFF to ON, an MQTT message is published, and HDX0.0 is automatically set to OFF after publishing.
2624
2625 **Compression type:** Message is compressed before it is transmitted. The compressed message needs to be decompressed before the MQTT client reads it. Zlib, Gzip, or Deflate algorithm can be chosen to compress or decompress the message.
2626
2627 **QoS:** MQTT provides three levels of reliability called service quality. The service quality of message transmission determines whether the message is guaranteed to be delivered.
2628
2629 0: Messages are sent only once, and delivery is not guaranteed.
2630
2631 1: Message must be delivered at least once.
2632
2633 2: Message is delivered just once.
2634
2635 **Retain message:** When checked, the MQTT server will keep the latest message.
2636
2637 **Content format:**
2638
2639 Raw data: Data composed of BYTE data.
2640
2641 JSON (General): Put all data in JSON format of member "d".
2642
2643 JSON (Advanced): JSON format of flexibly customizable nested structure.
2644
2645 **Include timestamps:** This function is only supported when the content format uses [JSON (General)], and whether to include the timestamp can be decided manually.
2646
2647 **Use the top "d" symbol in the message format:**
2648
2649 This function is only supported when the content format uses [JSON (General)]. When checked, the message format is as follows:
2650
2651 {
2652
2653 "d": {
2654
2655 "addressName1": ...,
2656
2657 "addressName2":...
2658
2659 },
2660
2661 "ts":...
2662
2663 }
2664
2665 When unchecked, the message format is as follows:
2666
2667 {
2668
2669 "addressName1": ...,
2670
2671 "addressName2":...,
2672
2673 "ts":...
2674
2675 }
2676
2677 As shown above, when unchecked, ts and address names are both key at the same level. Therefore, avoid taking the address name as ts.
2678
2679
2680 **Address setting**
2681
2682 ①Address settings when content formats use [Raw Data] and [JSON (General)].
2683
2684 (% style="text-align:center" %)
2685 [[image:47.jpg]]
2686
2687 **Add:** Establish the address source of the topic. The length of each address can be set separately.
2688
2689 **Delete:** Delete the address.
2690
2691 **Settings:** Modify the address and name.
2692
2693 (% style="text-align:center" %)
2694 [[image:48.jpg]]
2695
2696 **Included in all message sent**
2697
2698 Check the options: This topic will include this address every time it publishes a message.
2699
2700 Uncheck the options: When the sending mode is value, message is published only when the value of the address changes.
2701
2702 **Remove JSON array brackets' ['and'] ':**
2703
2704 Check the options: Remove the array symbol name when using non-array bits or characters.
2705
2706 **✎Note: A topic can be configured up to 255 nodes. The name length of a node can be configured up to a maximum of 255 characters and cannot be empty.**
2707
2708 ② Address setting when the content format uses [JSON (Advanced)]. [JSON (Advanced)] supports nested structure, which can use components, arrays and other forms. Timestamps and data names can also be customized, which is a more flexible design method.
2709
2710 (% style="text-align:center" %)
2711 [[image:49.jpg]]
2712
2713 The above figure is an example. If setting like above figure, the subscription side will receive the MQTT message like following format.
2714
2715 {
2716 "object": {
2717 "value": "teststring",
2718 "value (1)": 123,
2719 "value (2)": true,
2720 "value (3)": "",
2721 "value (4)": 0,
2722 "value (5)": true
2723 },
2724 "array": [
2725 10,
2726 20,
2727 30
2728 ],
2729 "value (6)": " 2023-04-27T03: 53: 20.156271 "
2730 }
2731
2732 **New component:** Add a new data component. Components can have multiple data formats; each data format has its own Name and Value. The data of the component is included in braces {}.
2733
2734 **New value:** Add a value, string, or timestamp. When it is a value or a string, data can be read for a fixed value or from a specified address.
2735
2736 **Delete:** Delete the selected field.
2737
2738 **Settings:** Modify the selected field. If the selected fields are components and arrays, only the names can be modified. But components and arrays include values that can modify parameters.
2739
2740 **Template:** Paste the JSON text, and the system will automatically arrange the schema to conform to this JSON format, saving the time of self-definition.
2741
2742 **Preview:** Preview JSON data in an easy-to-read format.
2743
2744 **✎Note: A Topic can be up to 512 nodes (including payload), and a node name can be configured to be up to 255 characters length.**
2745
2746
2747 **Security settings**
2748
2749 The topic is published only when the register status matches the setting. As shown in the following figure, this topic will not be published until the address HDX0.0 is set to ON.
2750
2751 (% style="text-align:center" %)
2752 [[image:50.jpg]]
2753
2754
2755 **MQTT topic subscription**
2756
2757 Select [Topic subscription] and click [Add] to enter general property settings and address settings. The maximum number of MQTT subscription topics is 255.
2758
2759 (% style="text-align:center" %)
2760 [[image:51.jpg]]
2761
2762 **General properties**
2763
2764 (% style="text-align:center" %)
2765 [[image:52.jpg]]
2766
2767 **Alias:** Set the project name of the MQTT theme. Maximum input length: 255 characters, cannot be empty.
2768
2769 **Topic:** Topics subscribed from the MQTT server. Maximum input length: 255 characters, cannot be empty.
2770
2771 **Compression type:** The transport compression type of a subscription topic must be the same as that of a publication topic.
2772
2773 **QoS:** MQTT provides three levels of reliability called service quality. The service quality of message transmission determines whether the message is guaranteed to be delivered.
2774
2775 0: Messages are sent only once, and delivery is not guaranteed.
2776
2777 1: Message must be delivered at least once.
2778
2779 2: Message is delivered just once.
2780
2781 **Content format:**
2782
2783 Raw data: There is no original data in a specific format.
2784
2785 JSON (General): JSON format of single-layer structure.
2786
2787 JSON (Advanced): JSON format of flexibly customizable nested structure.
2788
2789 **Verify timestamp:** The user can decide whether to verify the timestamp or not. When checked, it indicates that the received data timestamp must be strictly incremented before it can be updated. Otherwise, it will be judged as outdated data and not updated.
2790
2791 **Use the top "d" symbol in the message format:**
2792
2793 This function is only supported when the content format uses [JSON (General)]. When checked, the message format is as follows:
2794
2795 {
2796
2797 "d": {
2798
2799 "addressName1": ...,
2800
2801 "addressName2":...
2802
2803 },
2804
2805 "ts":...
2806
2807 }
2808
2809 When unchecked, the message format is as follows:
2810
2811 {
2812
2813 "addressName1": ..., "addressName2":...,
2814
2815 "ts":...
2816
2817 }
2818
2819 Please select the appropriate settings according to the data source.
2820
2821 **Address setting**
2822
2823 ①Address settings when content formats use [Raw Data] and [JSON (General)].
2824
2825 (% style="text-align:center" %)
2826 [[image:53.jpg]]
2827
2828 **Add:** Establish the address where the data is placed after the topic is subscribed. The length of each address can be set separately.
2829
2830 **Delete:** Delete the address.
2831
2832 **Settings:** Modify the address and name.
2833
2834 (% style="text-align:center" %)
2835 [[image:54.jpg]]
2836
2837 **Remove JSON array brackets' ['and'] ':**
2838
2839 When using non-array bits or characters, array symbol can manually be removed.
2840
2841 **✎Note: A topic can be configured up to 255 nodes. The name length of a node can be configured up to a maximum of 255 characters and cannot be empty.**
2842
2843 ② Address setting when the content format uses [JSON (Advanced)]. [JSON (Advanced)] supports nested structure, which can use components, arrays and other forms. Timestamps and data names can also be customized, which is a more flexible design method.
2844
2845 (% style="text-align:center" %)
2846 [[image:HMIEditor_Db5tLtioq7.jpg]]
2847
2848 **New component:** Add a new data component. There can be multiple data formats in a component, each with a name and a value. The data of the component is included in braces {}.
2849
2850 **New Array:** Add a new data array. Arrays can have multiple data formats, but only one name. The data of the component is included in brackets [].
2851
2852 **New value:** Add a value, string, or timestamp. When it is a value or a string, data can be read for a fixed value or from a specified address.
2853
2854 **Delete:** Delete the selected field.
2855
2856 **Settings:** Modify the selected field. If the selected fields are components and arrays, only the names can be modified. But components and arrays include values that can modify parameters.
2857
2858 **Template:** Paste the JSON text, and the system will automatically arrange the schema to conform to this JSON format, saving the time of self-definition.
2859
2860 **Preview:** Preview JSON data in an easy-to-read format.
2861
2862 **✎Note: A Topic can be up to 512 nodes (including payload), and a node name can be configured to be up to 255 characters length.**
2863
2864
2865 **Security settings**
2866
2867 The topic is published only when the register status matches the setting. As shown in the following figure, this topic will not be published until the address HDX0.0 is set to ON.
2868
2869 (% style="text-align:center" %)
2870 [[image:56.jpg]]
2871
2872 = OPCUA Server =
2873
2874 (% class="box infomessage" %)
2875 (((
2876 ✎Note: Only 8000ig Series support OPC UA Server.
2877 )))
2878
2879 1.Open the OPCUA server tool
2880
2881 [Project]→[OPCUA server]→[Enable]
2882
2883 (% style="text-align:center" %)
2884 [[image:QOBzq5f8HF.png]]
2885
2886 2.Set General properties
2887
2888 (% style="text-align:center" %)
2889 [[image:e9rHcIHKsj.png]]
2890
2891 **Description:**Description of OPCUA server, character length 0~~255.** **
2892
2893 **OPC TCP:**Set URL of OPCUA server.
2894
2895 **Port number:**The port used by the client for communication.Default: 4840.
2896
2897 **Server name:**Set the name of Server,character length 0~~255.
2898
2899 **Security:**OPCUA server provides four security policies and three authentication methods, and different encryption methods can be implemented through different combinations.
2900
2901 3.User authentication
2902
2903 (% style="text-align:center" %)
2904 [[image:1733132656389-393.png]]
2905
2906 **Anonymous:**When the client chooses to log in anonymously, the permissions to interact with the server include brows, read and write.
2907
2908 **User name password:**The user name and password here are equivalent to the user name and password set on the [Project Settiing\User Login] page. When the client logs in to the server by using the user name and password, the user password used has the same group level as that configured by the server and has corresponding permissions.
2909
2910 4.Main interface
2911
2912 (% style="text-align:center" %)
2913 [[image:1733133255552-776.png]]
2914
2915 **Enable:**Check to configure the relevant properties of the OPC UA server
2916
2917 **Server\Settings:**Configure OPC UA Server Properties
2918
2919 **List of tags:**Display the defined tags
2920
2921 **New group:**Add a new group to manage tags
2922
2923 **New label:**Add the address label you want to monitor, and the name cannot be empty. The length of the label name ranges from 1 to 255.
2924
2925 **Settings:**When a label is selected, click to jump to the label configuration interface.
2926
2927 When a group is selected, click to configure the group name.
2928
2929 **Cancel:**Able to delete tags or groups
2930
2931 (% class="box infomessage" %)
2932 (((
2933 ✎Note: Setting and cancel options are only for the New label and New group, and do not apply to groups that exist by default
2934 )))
2935
2936 5.Label configuration
2937
2938 (% style="text-align:center" %)
2939 [[image:1733133363652-686.png]]
2940
2941
2942 **Name:**Tag name
2943
2944 **Type:**Indicate the read and write attributes of the label. The read attributes are checked by default** **
2945
2946 **Address:**Configure the address to be monitored by the label
2947
2948 **Data Type:**Represent the data type of this label
2949
2950 **Array length:**When the set length exceeds 1, it means that the label is an array, and the array range is 1 to 255.