Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
en:software:qview:qview_6:qview60 [2015/04/20 12:04] – [19. Appendix D: Keywords] qem207 | en:software:qview:qview_6:qview60 [2022/08/31 09:02] (current) – qem214 | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | PRELIMINARE/ | ||
- | |||
====== QVIEW 6.0 ======= | ====== QVIEW 6.0 ======= | ||
Line 522: | Line 520: | ||
===== - DATAGROUP variables ===== | ===== - DATAGROUP variables ===== | ||
- | Datagroup variables are a special data structures. When declaring a datagroup, a part of memory | + | Datagroup variables are a special data structures, |
- | Each program (column) | + | |
- | * 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: | + | |
+ | ==== - Static Variables ==== | ||
<code QCL> | <code QCL> | ||
- | dslVeMa[5] | + | DATAGROUP |
+ | < | ||
+ | DATAPROGRAM | ||
+ | <number of recipes> | ||
+ | ;Static variables declaration | ||
+ | < | ||
+ | < | ||
+ | < | ||
</ | </ | ||
- | + | Static | |
- | Indexed | + | |
<code QCL> | <code QCL> | ||
- | ddwLuPe[5,3] | + | DATAGROUP |
+ | Name | ||
+ | DATAPROGRAM | ||
+ | 100 | ||
+ | ;Static variables declaration | ||
+ | Variable1 | ||
+ | Variable2 | ||
+ | Variable3 | ||
+ | </ | ||
+ | To refer to variable // | ||
+ | <code QCL> | ||
+ | Variable3[5] | ||
</ | </ | ||
- | The datagroup is best represented | + | We can imagine the memory structure of a variable DATAGROUP, in our example with static variables, |
- | ^_^Prog.1^Prog. 2^Prog. 3^Prog. 4^Prog. 5^_^ | + | ^ ^ |
- | ^_|dslVeMa[1]|dslVeMa[2]|dslVeMa[3]|dslVeMa[4]|dslVeMa[5]^Static^ | + | ^Recipe |
- | ^Step 1|ddwLuPe[1, | + | ^Recipe |
- | ^Step 2|ddwLuPe[1, | + | ^Recipe |
- | ^Step 3|ddwLuPe[1, | + | ^...| | | | |
- | ^Step 4|_|_|_|_|ddwLuPe[5, | + | ^Recipe 100| | | | |
- | ^Step 5|_|_|_|_|ddwLuPe[5, | + | |
- | In the two, static and indexed, datagroup sections several variables can be declared. | + | |
- | The syntax for defining DATAGROUP variables: | + | ==== - Indexed Variables ==== |
<code QCL> | <code QCL> | ||
DATAGROUP | DATAGROUP | ||
< | < | ||
- | [;Number of programs (or recipe) | ||
DATAPROGRAM | DATAPROGRAM | ||
- | <number of programs> | + | <number of recipes> |
- | ;Static variables declaration | + | |
- | < | + | |
- | < | + | |
- | < | + | |
- | [;Number of steps | + | |
STEP | STEP | ||
<number of steps> | <number of steps> | ||
Line 566: | Line 569: | ||
< | < | ||
< | < | ||
- | < | + | < |
</ | </ | ||
- | dove: | + | Indexed |
- | |DATAGROUP|Keyword for defining a DataGroup.| | + | |
- | |< | + | |
- | |DATAPROGRAM|Keyword for defining the static | + | |
- | |<number of programs> | + | |
- | |< | + | |
- | |< | + | |
- | |STEP|Keyword for defining indexed variables in the DataGroup.| | + | |
- | |<number of steps> | + | |
- | |< | + | |
- | |< | + | |
- | + | ||
- | The DATAGROUP definition | + | |
- | * 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 | + | |
- | + | ||
- | The number | + | |
- | + | ||
- | The DATAPROGRAM subsection is mandatory, while the STEP subsection is optional. | + | |
- | + | ||
- | A STEP section cannot | + | |
- | All static | + | |
- | + | ||
- | To calculate | + | |
- | + | ||
- | (N.Programs x N.Static variables x 4 ) + ( N.Programs x N.Steps x N.Indexed variables x 4).\\ | + | |
- | Example: | + | |
<code QCL> | <code QCL> | ||
DATAGROUP | DATAGROUP | ||
- | | + | |
DATAPROGRAM | DATAPROGRAM | ||
- | | + | |
- | ;--------------Static variables declaration------------------ | + | ;Static variables declaration |
- | | + | |
- | | + | |
+ | Variable3 | ||
STEP | STEP | ||
- | | + | |
- | ;--------------Indexed variables declaration------------- | + | ;Indexed variables declaration |
- | | + | |
- | | + | |
</ | </ | ||
- | + | To refer to variable // | |
- | + | ||
- | Syntax for static variables: | + | |
<code QCL> | <code QCL> | ||
- | < Nome variabile Static > < [ num_prog | + | Variable4[5, 9] |
</ | </ | ||
- | Syntax for indexed variables: | + | We can imagine the memory structure of a variable DATAGROUP, in our example with static and indexed variables, |
- | <code QCL> | + | |
- | < Nome variabile Index > < [ num_prog, num_step ] > | + | |
- | </ | + | |
- | // | + | ^ ^ Variable1 |
+ | ^Recipe 1| | | | | | | | | | | | | | | ||
+ | ^::: | ||
+ | ^Recipe 2| | | | | | | | | | | | | | | ||
+ | ^::: | ||
+ | ^Recipe 3| | | | | | | | | | | | | | | ||
+ | ^::: | ||
+ | ^...| | | | | | | | | | | | | | | ||
+ | ^::: | ||
+ | ^Recipe 100| | | | | | | | | | | | | | | ||
+ | ^::: | ||
+ | Other informations: | ||
+ | * In a DATAGROUP all variables, both static and indexed, are retentive (maintain the value at power off). | ||
+ | * The Datagroup variables may be more than one, in this case it is necessary to insert more DATAGROUP keywords. | ||
+ | * The subsection DATAPROGRAM is mandatory, while the STEP is optional. | ||
+ | * The maximum number of recipes can be set is 65534. | ||
+ | * 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). | ||
===== - BUS Section ===== | ===== - BUS Section ===== | ||
Line 1215: | Line 1200: | ||
===== - Instructions for digital outputs ===== | ===== - Instructions for digital outputs ===== | ||
- | Instructions for activating or disactivating | + | Instructions for activating or deactivating |
(<output name>= 1), however dedicated instructions are faster. | (<output name>= 1), however dedicated instructions are faster. | ||
Line 1226: | Line 1211: | ||
==== - RESOUT ==== | ==== - RESOUT ==== | ||
- | Disactivate | + | Deactivate |
<code QCL> | <code QCL> | ||
RESOUT <output name> | RESOUT <output name> | ||
Line 1383: | Line 1368: | ||
</ | </ | ||
+ | ==== - Shift logical left ==== | ||
+ | Logic shifts the contents of var value to the left by //n// bits. \\ {{: | ||
+ | <code QCL> | ||
+ | SHLL(< | ||
+ | </ | ||
+ | Example: | ||
+ | <code QCL> | ||
+ | glValue = SHLL(glValue, | ||
+ | </ | ||
+ | |||
+ | ==== - Right logical left ==== | ||
+ | Logic shifts the contents of var value to the right by //n// bits. \\ {{: | ||
+ | <code QCL> | ||
+ | SHLR(< | ||
+ | </ | ||
+ | Example: | ||
+ | <code QCL> | ||
+ | glValue = SHLR(glValue, | ||
+ | </ | ||
+ | ==== - Multiplication and division ==== | ||
+ | Perform a 32 bit integer values multiplication with 64 bit result and a successive division by 32 bit integer value. Result is a 32 bit value.\\ **N.B.** If a division by zero occur, CPU state will set to " | ||
+ | <code QCL> | ||
+ | MULDIV(< | ||
+ | </ | ||
+ | Example: glValue = a * b / c | ||
+ | <code QCL> | ||
+ | glValue = MULDIV(a, b, c) | ||
+ | </ | ||
+ | |||
+ | ==== - Remainder of multiplication and division ==== | ||
+ | Perform a 32 bit integer values multiplication with 64 bit result and a successive division by 32 bit integer value. Result is the division remainder.\\ **N.B.** If a division by zero occur, CPU state will set to " | ||
+ | <code QCL> | ||
+ | RMULDIV(< | ||
+ | </ | ||
+ | Example: glValue = a * b % c | ||
+ | <code QCL> | ||
+ | glValue = RMULDIV(a, b, c) | ||
+ | </ | ||
+ | |||
+ | ==== - Nearest integer rounding ==== | ||
+ | |ROUND|Rounds to nearest integer, rounding away from zero in halfway cases.| | ||
+ | |TRUNC|Rounds to nearest integer not greater in magnitude than the given value.| | ||
+ | |FLOOR|Computes largest integer not greater than the given value.| | ||
+ | |CEIL|Computes smallest integer not less than the given value.| | ||
+ | The syntax:\\ | ||
+ | <code QCL> | ||
+ | ROUND(< | ||
+ | TRUNC(< | ||
+ | FLOOR(< | ||
+ | CEIL(< | ||
+ | </ | ||
+ | Example: | ||
+ | <code QCL> | ||
+ | gsValue = ROUND(2.7) | ||
+ | gsValue = ROUND(-2.7) | ||
+ | gsValue = TRUNC(2.7) | ||
+ | gsValue = TRUNC(-2.7) | ||
+ | gsValue = FLOOR(2.7) | ||
+ | gsValue = FLOOR(-2.7) | ||
+ | gsValue = CEIL(2.7) | ||
+ | gsValue = CEIL(-2.7) | ||
+ | </ | ||
+ | |||
+ | ==== - Classification operators ==== | ||
+ | |ISFINITE|Checks if the given number has finite value.| | ||
+ | |ISINF|Checks if the given number is infinite.| | ||
+ | |ISNAN|Checks if the given number is NaN.| | ||
+ | |ISNORMAL|Checks if the given number is normal.| | ||
+ | Syntax:\\ | ||
+ | <code QCL> | ||
+ | ISFINITE(< | ||
+ | ISINF(< | ||
+ | ISNAN(< | ||
+ | ISNORMAL(< | ||
+ | </ | ||
+ | Example: | ||
+ | <code QCL> | ||
+ | gfValue = ISFINITE(gsValue) | ||
+ | gfValue = ISINF(gsValue) | ||
+ | gfValue = ISNAN(gsValue) | ||
+ | gfValue = ISNORMAL(gsValue) | ||
+ | </ | ||
===== - Trigonometry Functions ===== | ===== - Trigonometry Functions ===== | ||
Line 3213: | Line 3280: | ||
A summary of the QCL keywords. | A summary of the QCL keywords. | ||
- | ^ ABS | absolute value | + | ^ ABS | absolute value | |
- | ^ ACOS | arc cosine | + | ^ ACOS | arc cosine |
- | ^ AND | logic AND | | + | ^ AND | logic AND |
- | ^ ANDB | bitwise logic And | | + | ^ ANDB | bitwise logic And |
- | ^ APPLICATION | + | ^ APPLICATION |
- | ^ ARRGBL | + | ^ ARRGBL |
- | ^ ARRSYS | + | ^ ARRSYS |
- | ^ ASIN | arc sine | + | ^ ASIN | arc sine | |
- | ^ ATAN | arc tangent | + | ^ ATAN | arc tangent |
- | ^ B | byte | + | ^ B | byte | |
- | ^ BEGIN | task unit code section | + | ^ BEGIN | task unit code section |
- | ^ BREAK | break | | + | ^ BREAK | break |
- | ^ BUS | configuration file section | + | ^ BUS | configuration file section |
- | ^ CALL | call to subroutine | + | ^ CALL | call to subroutine |
- | ^ CASE | SWITCH-CASE instruction | + | ^ CASE | SWITCH-CASE instruction |
- | ^ CONST | configuration file section | + | ^ CEIL | Nearest integer rounding not less than the given value |
- | ^ COS | cosine | + | ^ CONST | configuration file section |
- | ^ COT | cotangent | + | ^ COS | cosine |
- | ^ DATAGROUP | + | ^ COT | cotangent |
- | ^ DATAPROGRAM | + | ^ D | double precision |
- | ^ DEVGROUP | + | ^ DATAGROUP |
- | ^ ELSE | Else in IF instruction | + | ^ DATAPROGRAM |
- | ^ END | task end | + | ^ DEVGROUP |
- | ^ ENDDEVGROUP | + | ^ ELSE | Else in IF instruction |
- | ^ ENDIF | end of IF instruction | + | ^ END | task end | |
- | ^ ENDSUB | + | ^ ENDDEVGROUP |
- | ^ ENDSWITCH | + | ^ ENDIF | end of IF instruction |
- | ^ ENDWHILE | + | ^ ENDSUB |
- | ^ EQ | uguale | + | ^ ENDSWITCH |
- | ^ EXP | exponential | + | ^ ENDWHILE |
- | ^ EXTDEVICE | + | ^ EQ | uguale |
- | ^ F | flag | | + | ^ EXP | exponential |
- | ^ FOR | FOR instruction | + | ^ EXTDEVICE |
- | ^ FPROG | + | ^ F | flag | |
- | ^ FSTEP | + | ^ FLOOR |
- | ^ GE | greater or equal to | | + | ^ FOR |
- | ^ GLOBAL | + | ^ GE | greater or equal to |
- | ^ GT | greater | + | ^ GLOBAL |
- | ^ IF | IF instruction | + | ^ GT | greater |
- | ^ INPUT | configuration file section | + | ^ IF | IF instruction |
- | ^ INTDEVICE | + | ^ INPUT | configuration file section |
- | ^ JUMP | JUMP instruction | + | ^ INTDEVICE |
- | ^ LE | less or equal to | + | ^ ISFINITE |
- | ^ LN | natural logarhythm | + | ^ ISINF | checks if the given number is infinite |
- | ^ LT | less than | | + | ^ ISNAN | checks if the given number is NaN (Not a Number) |
- | ^ NEG | negative sign (inversion of sign or two's complement) | + | ^ ISNORMAL |
- | ^ NEQ | operatore | + | ^ JUMP | JUMP instruction |
- | ^ NEXT | NEXT instruction | + | ^ L | long |
- | ^ NOP | NOP instruction | + | ^ LE | less or equal to | |
- | ^ NOT | not | | + | ^ LN | natural logarhythm |
- | ^ NOTB | bitwise negation (one's complement) | + | ^ LT | less than | |
- | ^ OR | logic OR | + | ^ MULDIV |
- | ^ ORB | bitwise OR | + | ^ NEG | negative sign (inversion of sign or two's complement) |
- | ^ OUTPUT | + | ^ NEQ | operatore |
- | ^ POW | power of | + | ^ NEXT | NEXT instruction |
- | ^ REFERENCE | + | ^ NOP | NOP instruction |
- | ^ REFERENCE | + | ^ NOT | not |
- | ^ RESOUT | + | ^ NOTB | bitwise negation (one's complement) |
- | ^ S | single precision | + | ^ OR | logic OR | |
- | ^ SETOUT | + | ^ ORB | bitwise OR | |
- | ^ SIN | sine | + | ^ OUTPUT |
- | ^ SQRT | square root | | + | ^ POW | power of | |
- | ^ STEP | configuration file section | + | ^ REFERENCE |
- | ^ SUB | subroutine | + | ^ REFERENCES |
- | ^ SWITCH | + | ^ RESOUT |
- | ^ SYSTEM | + | ^ RESTART |
- | ^ RESTART | + | ^ RESUME |
- | ^ RESUME | + | ^ RETURN |
- | ^ RETURN | + | ^ RMULDIV |
- | ^ SUSPEND | + | ^ ROUND | Nearest integer rounding |
- | ^ TAN | tangent | + | ^ S | single precision |
- | ^ TIMER | configuration file section | + | ^ SETOUT |
- | ^ W | word | + | ^ SHLL | shift logical left | |
- | ^ WAIT | wait instruction | + | ^ SHLR | shift logical right | |
- | ^ WHILE | while instruction | + | ^ SIN | sine | |
- | ^ XORB | bitwise exclusive OR | + | ^ SQRT | square root |
+ | ^ STEP | configuration file section | ||
+ | ^ SUB | subroutine | ||
+ | ^ SUSPEND | ||
+ | ^ SWITCH | ||
+ | ^ SYSTEM | ||
+ | ^ TAN | tangent | ||
+ | ^ TIMER | configuration file section | ||
+ | ^ TRUNC | Nearest integer rounding not greater in magnitude | ||
+ | ^ W | word | | ||
+ | ^ WAIT | wait instruction | ||
+ | ^ WHILE | while instruction | ||
+ | ^ XORB | bitwise exclusive OR | | ||
Line 3301: | Line 3381: | ||
< | < | ||
- | |||
====== - Appendix E: Hotkeys ====== | ====== - Appendix E: Hotkeys ====== | ||