Differences

This shows you the differences between two versions of the page.

--- en:software:qview:qview_6:qview60 [2015/04/28 16:06] – [3.11.2. Indexed Variables] qem207
+++ en:software:qview:qview_6:qview60 [2015/04/28 16:18] – qem202
@@ Line 1: / Line 1: @@
-PRELIMINARE/
 ====== QVIEW 6.0 =======
@@ Line 615: / Line 613: @@
   * The maximum number of steps can be set is 65534.
   * Compared to a common array, static variables can also support a Flag size data (F).
-===== - DATAGROUP variables old =====
-Datagroup variables are a special data structures. When declaring a datagroup, a part of memory is organised in a table of rows and columns. The columns are called  //programs// or //recipes//, while the rows are //steps//.\\
-Each program (column) contains two kinds of variable:
-  * Static.
-  * indexed.
-Static variables can take on different values according to their program (column) reference. In the declaration each of these variables is identified by an individual name so, to be able to refer to different values that it can take on, indexing has to be used. For example, to refer to the //dslVeMa// variable of program (column) 5, use the code:
-<code QCL>
-  dslVeMa[5]
-</code>
-Indexed variables can have different values according to their program (column) and step (row) reference. In the declaration, each of these variables is identified by the same name so, to be able to refer to its different values, indexing must be used. For example, to refer to the “ddwLuPe” variable of program (column) 5 and step (row) 3, use the code:
-<code QCL>
-  ddwLuPe[5,3]
-</code>
-The datagroup is best represented as the chart below:
-^_^Prog.1^Prog. 2^Prog. 3^Prog. 4^Prog. 5^_^
-^_|dslVeMa[1]|dslVeMa[2]|dslVeMa[3]|dslVeMa[4]|dslVeMa[5]^Static^
-^Step 1|ddwLuPe[1,1]|_|_|_|_^indexed^
-^Step 2|ddwLuPe[1,2]|_|_|_|_^:::^
-^Step 3|ddwLuPe[1,3]|_|_|_|ddwLuPe[5,3]^:::^
-^Step 4|_|_|_|_|ddwLuPe[5,4]^:::^
-^Step 5|_|_|_|_|ddwLuPe[5,5]^:::^
-In the two, static and indexed, datagroup sections several variables can be declared.
-The syntax for defining DATAGROUP variables:
-<code QCL>
-DATAGROUP
-  <DataGroup Name>
-[;Number of programs (or recipe)
-  DATAPROGRAM
-    <number of programs>
-;Static variables declaration
-    <variable name> <F/B/W/L/S>
-    <variable name> <F/B/W/L/S>
-    <variable name> <F/B/W/L/S>]
-[;Number of steps
-  STEP
-    <number of steps>
-;Indexed variables declaration
-    <variable name> <F/B/W/L/S>
-    <variable name> <F/B/W/L/S>
-    <variable name> <F/B/W/L/S>]
-</code>
-dove:
-|DATAGROUP|Keyword for defining a DataGroup.|
-|<DataGroup Name>|Name associated to the DataGroup.|
-|DATAPROGRAM|Keyword for defining the static variables in the DataGroup.|
-|<number of programs>|Number of programs (DataProgram) composing the DataGroup.|
-|<variable name>|Name of the static variable in the DataGroup.|
-|<F/B/W/L/S>|Static variable type|
-|STEP|Keyword for defining indexed variables in the DataGroup.|
-|<number of steps>|Number of steps comprising the DataGroup.|
-|<variable name>|Name of the indexed variable in the DataGroup.|
-|<F/B/W/L/S>|Indexed variable type|
-The DATAGROUP definition is made up of 3 parts:
-  * the datagroup name definition;
-  * the number of programs and static variables (starting with DATAPROGRAM);
-  * the number of program steps and indexed variables (starting with keyword STEP).
-The datagroup name follows all the general rules for variable name syntax.
-The number of programs is written in number form, or with the aid of constants and must be different to zero. The maximum number of programs is 65534.
-The number of steps is written in number form, or with the aid of constants and must be different to zero. The maximum number of steps is 65534.
-The DATAPROGRAM subsection is mandatory, while the STEP subsection is optional.
-A STEP section cannot be declared without declaring at least one indexed variable. A STEP section can be declared without declaring a DATAPROGRAM section. A DATAPROGRAM cannot be declared without declaring at least one static variable. A DATAPROGRAM section can be declared without declaring a STEP section.\\
-All static and indexed variables in a DATAGROUP are retentive (i.e. they keep their value after a shut-off).
-To calculate the total memory space of the DATAGROUP consider that each variable in the datagroup takes up 4 bytes (regardless of the variable types). So the memory space in byte is equal to:
-(N.Programs x N.Static variables x 4 ) + ( N.Programs x N.Steps x N.Indexed variables x 4).\\
-Example:
-<code QCL>
-DATAGROUP
-  dMyDataGrp            ;Datagroup name
-  DATAPROGRAM
-    DIM_PROG            ;Number of programs
-    ;--------------Static variables declaration------------------
-    dsfStat1 F          ;
-    dswStat2 W          ;
-  STEP
-    DIM_STEP            ;Number of step for each program
-    ;--------------Indexed variables declaration-------------
-    ddbDin1 B           ;
-    ddlDin2 L           ;
-</code>
-Syntax for static variables:
-<code QCL>
-< Nome variabile Static > < [ num_prog ] >
-</code>
-Syntax for indexed variables:
-<code QCL>
-< Nome variabile Index > < [ num_prog, num_step ] >
-</code>
-//num_prog// and //num_step// can be a number (not SINGLE), a constant, variable or complex expression. In the case of number or constant, the compilation controls that the index is not over the maximum size declared in the configuration unit (by number of programs and number of steps respectively); the other indexes - //num_prog and num_step// - start from one.
 ===== - BUS Section =====
 The BUS section in the configuration unit is essential to declare the QMOVE hardware model being used.\\