Elatec TWN3A1 RFID Tag Reader User Manual TH TWN3 104
Elatec GmbH RFID Tag Reader TH TWN3 104
UserManual.wiki
>
Elatec
>
TWN3A1 User Manual
User Manual
Navigation menu
Upload a User Manual
Namespaces
Wiki Guide
HTML
PDF
Info
Views
User Manual
Discussion / Help
Navigation
![Elatec GmbH Page 23 of 44 7.1.2 Comments In order to place a comment within the source code, two slashes are used. The remaining content of the line will be ignored by the compiler. 7.1.3 Case Sensitivity The TWN3 script language is sensitive to upper and lower case. Examples: byte a; // Valid Byte a; // Invalid byte Byte; // Valid(!) 7.1.4 Preprocessor Directives The preprocessor is removing comments from the source code and processing the preprocessor directives. Currently, there is one directive available. 7.1.4.1 #include Directive Include another source file and treat it as a part of the compiled source. There are two possibilities: #include <sys.twn.h> Include the given file, which is located relative to the directory, where TWNConfig.exe resides. #include “mydefs.twn.h” Include the given file, which is located relative to the current directory 7.1.5 Functions Functions may be defined (“prototype”) in order to resolve forward references, or declared directly. The prototype of a function has the following form: (byte | void) identifier([list of arguments]); The declaration of a function has the following form: (byte | void) identifier([list of arguments]) function body The function body is a block of statements. 7.1.5.1 Return Values A function either has a return value (byte) or not (void). Following form is required to return a value: return expression;](https://usermanual.wiki/Elatec/TWN3A1/User-Guide-1040095-Page-23.png)
![Elatec GmbH Page 24 of 44 7.1.5.2 Arguments If a function has no arguments, the list of arguments has to be left empty (do not write void). In order to declare arguments, write the list of arguments separated by commas. Arguments are passed by value or by reference. In order to pass an argument by reference instead of value, insert the ‘&’ before the identifier of argument. Here are some examples of valid function prototypes: void Func1(); // No arguments void Func2(byte i); // A single argument, // which is passed by value void Func3(byte in, byte &out); // Two arguments, where in is passed by // value and out is passed by reference 7.1.5.3 System Functions A system function can only be declared as prototype. Following form: (byte | void) identifier([list of arguments]) system number; The list of available system functions is contained in the file sys.twn.h. For the script programmer there is normally no need to declare system functions on his own. 7.1.5.4 Function main A TWN3 script always needs the function main to be implemented. The prototype for the function main is: void main(); After internal initialization, the TWN3 reader will start execution of the script by calling this function main. 7.1.6 Statements A single statement has the form [expression]; This means, a statement is a (optional) expression followed by a semicolon. If only a semicolon without an expression is specified, it is called an empty statement. Statements can be enclosed by braces to build a block of statements. A block statement can be used wherever a single statement can be used. 7.1.6.1 if Statement An if statement has the form: if (expression) statement Statement is executed only if the result of expression is not equal to zero.](https://usermanual.wiki/Elatec/TWN3A1/User-Guide-1040095-Page-24.png)
![Elatec GmbH Page 25 of 44 7.1.6.2 if else Statement An if else statement has the form: if (expression) statement1 else statement2 Statement1 is executed only, if the result of expression is not equal to zero. Otherwise, statement2 is executed. 7.1.6.3 while Statement A while statement has the form: while (expression) statement Statement is executed, as long as the result of expression is not equal to zero. 7.1.6.4 do while Statement A do while statement has the form: do statement while (expression); Statement is executed, until the result of expression is equal to zero. 7.1.6.5 for Statement A for statement has the form: for ([expression1]; [expression2]; [expression3] statement As first step, expression1 is evaluated. As long as expression2 is not equal to zero, statement is executed. After execution of statement, expression3 is evaluated. Therefore, a for statement can be rewritten as while statement with exactly the same behavior: expression1; while (expression2) { statement expression3; } 7.1.6.6 switch Statement A switch statement has the form: switch (expression) { [case constant expression: [case statement]] [default: [default statement]] } The script is evaluating expression. Depending on the result of the expression the appropriate case is executed. If there is no appropriate case, the default case is executed. If there is no default label, execution is continued after the switch statement.](https://usermanual.wiki/Elatec/TWN3A1/User-Guide-1040095-Page-25.png)
![Elatec GmbH Page 27 of 44 7.1.6.12 Empty Statement A statement, which is doing nothing is the semicolon. Example: for (i=0; i<10; i+=1) // Waste some time and do ten times nothing ; 7.1.7 Storage Types In the TWN3 scripting language, there is only one type of storage defined, which is the byte. A byte is an unsigned integer with a size of 8 bits. 7.1.8 Storage Classes There are following storage classes available: Standard, const and secret. Without using any modifier, the standard storage is used. A variable, which is declared in the standard storage class, is allocated in the normal data segment. Examples: byte i; // A single integer byte a[15]; // An array of 15 bytes 7.1.8.1 const An identifier, which is declared as const can be used for calculations at compile time. There is no physical memory occupied during runtime. Typically, you would use a const for defining constants, which are used throughout a script for easier understanding and adaptation for different purposes. Example: const byte c = 15; 7.1.8.2 secret The secret data space is a read-only segment. The content of this segment is written once during programming the script into the TWN3 transponder reader. Furthermore, this segment can not be read directly by the script itself. Therefore, there is no way to simply read the content of this memory and send it to the host. There are only a few system functions, which take the content of this segment as input. Typically, the secret data space is used for keys, which are necessary for authentication to a transponder. Examples: // Some well known factory default keys for transponders secret byte MifareKeyFF[6] = { 0xFF,0xFF,0xFF,0xFF,0xFF,0xFF }; secret byte MifareKeyAA[6] = { 0xA0,0xA1,0xA2,0xA3,0xA4,0xA5 }; secret byte MifareKeyBB[6] = { 0xB0,0xB1,0xB2,0xB3,0xB4,0xB5 }; secret byte Hitag2Key[4] = { 'M','I','K','R' }; secret byte EM4050Key[4] = { 0x00,0x00,0x00,0x00 };](https://usermanual.wiki/Elatec/TWN3A1/User-Guide-1040095-Page-27.png)
![Elatec GmbH Page 28 of 44 7.1.9 Operators Following operators are available: Operator Meaning Example () Parenthesis A = B * (C + D) [] Brackets A = B[C] ! Logical Not A = !B ~ Bitwise Complement A = ~B - Unary Minus A = -B + Unary Plus A = +B * Multiplication A = B * C / Division A = B / C % Modulus A = B % C + Add A = B + C - Subtract A = B – C << Shift Left A = B << C >> Shift Right A = B >> C < Lower A = B < C <= Lower or Equal A = B <= C > Greater A = B > C >= Greater or Equal A = B >= C == Equal A = B == C != Not Equal A = B!= C & Binary And A = B & C ^ Binary Exclusive Or A = B ^ C | Binary Or A = B | C && Logical And A = B && C || Logical Or A = B || C = Assignment A = B += Addition/ Assignment A += B -= Subtraction/ Assignment A -= B *= Multiplication/ Assignment A *= B /= Division/ Assignment A /= B %= Modulus/ Assignment A %= B |= Bitwise Or/ Assignment A |= B &= Bitwise And/ Assignment A &= B ^= Bitwise Exclusive Or A ^= B <<= Shift Left/ Assignment A <<= B >>= Shift Right/ Assignment A >>= B](https://usermanual.wiki/Elatec/TWN3A1/User-Guide-1040095-Page-28.png)
![Elatec GmbH Page 35 of 44 void HostSendHex(byte &Data, byte BitCnt, byte Width) Convert a number, which is given as a bit field into hexadecimal ASCII format, and send it to the host. Letters are sent in upper case. Parameters: byte &Data A reference to an array of bytes, which contains the bit field byte BitCnt The number of bits, which are valid within the array of bytes. A maximum of 128 bits can be converted. byte Width Specifies the number of digits, the output should contain. If width is 0, then at least 1 digit is sent. If Width is greater than the actual width of the number to be converted, then the number is preceded by zeros. Return: None. Example: byte ID[2]; ID[0] = 0x12; ID[1] = 0x34; HostSendHex(ID,16,0); // Result is 1234 HostSendHex(ID,8,5); // Result is 00012 HostSendHex(ID,13,5); // Result is 00246 void HostSendDec(byte &Data, byte BitCnt, byte Width) Convert a number, which is given as a bit field into decimal ASCII format, and send it to the host. Parameters: byte &Data A reference to an array of bytes, which contains the bit field byte BitCnt The number of bits, which are valid within the array of bytes. A maximum of 128 bits can be converted. byte Width Specifies the number of digits, the output should contain. If width is 0, then at least 1 digit is sent. If Width is greater than the actual width of the number to be converted, then the number is preceded by zeros. Return: None. Example: byte ID[2]; ID[0] = 0x12; ID[1] = 0x34; HostSendDec(ID,16,0); // Result is 4660 HostSendDec(ID,8,5); // Result is 00018 HostSendDec(ID,13,5); // Result is 00582](https://usermanual.wiki/Elatec/TWN3A1/User-Guide-1040095-Page-35.png)
