TestIT:Configuration
Contents
- 1 6. Configuration
- 2 6.1 Symbol handling
- 3 6.2 Application configuration
- 4 6.3 Devices
- 4.1 6.3.1 C9
- 4.2 6.3.2 Database connection (MSSQL
- 4.3 6.3.3 Folder (File)
- 4.4 6.3.4 Folder (Image
- 4.5 6.3.5 Log
- 4.6 6.3.6 RAMP
- 4.7 6.3.7 Printer
- 4.8 6.3.8 S10
- 4.9 6.3.9 S11
- 4.10 6.3.10 S9 Serial
- 4.11 6.3.11 S9 Data Log
- 4.12 6.3.12 Serial advanced
- 4.13 6.3.13 Serial
- 4.14 6.3.14 Socket
- 4.15 6.3.15 TwinCat
- 4.16 6.3.16 Unique ID
- 4.17 6.3.17 Byte
- 4.18 6.3.18 Bit
- 4.19 6.3.19 Formula
- 4.20 6.3.20 DLL
6. Configuration
The configuration service allows you to create, update, and delete symbols. It is also possible to configure devices, make application configuration, and setting up the license.
An overview of configuration:
Options
Home - go back to home screen
Application configuration - go to application configuration
Symbol handling - go to symbol handling
6.1 Symbol handling
Select the symbol handling button and the symbols will be shown. In symbol handling it is possible to edit, delete, and create symbols. Some of the symbols are special symbols.
Options:
Home - go back to home screen
Application configuration - go to application configuration
Devices - go back to devices
6.1.1 Add symbol
Add symbol:
- Press the Add symbol text in the functions window
- Fill in the required and the wanted optional information
- Press OK – or Cancel and the user will not be created
The required information:
- Symbol type
- Symbol name
The optional information is:
- Comment – A symbol description
- Unit – This type of the data etc.; Bar, pa, mm.
- Default value – It will be the value of the symbol at each program start
- Program symbol – Select if it can be used as a program symbol (Program symbols)
- Format – Depending on the symbol type. Look at Symbol formatting to see which format to select
6.1.1.1 Description of symbol types and symbol names
To see some Standard TestIT symbols, press here.
Symbol type:
| Symbol type | |
|---|---|
| INT (whole number) | Min. value: -2.147.483.648 Max. value: 2.147.483.648 Example: 2598 |
| STRING (text) | Min. value: 0 Chars Max. value: 1200 Chars Example: "Hello Nolek" |
| BOOL (true/false) | Min. value: 0 Max. value: 1 Example: 1 |
| DOUBLE (decimal number) | Min. value: -1,7976931E+308 Max. value: 1,7976931E+308 Example: 0,00235 |
Symbol name:
The allowed characters are 0-9, A-Z, $, _, no spaces, max 50 characters. See the table of defining symbol names
| Used for | Description | |
|---|---|---|
| _intSym01 | Internal program symbols | Symbol of type INT, symbol for use internal in the program |
| $SetpointVacuum | Program symbol | Used for program symbols |
6.1.1.2 Symbol formatting
| INT symbol | No formatting |
| STRING symbol | No formatting |
| BOOL symbol | 1/0 ~ True/false ~ OK/NOK ~ Yes/No |
| DOUBLE symbol | None ~ 0 ~ 0.0 – 0.000000000 ~ 1.0E+00 ~ 1.00E+00 |
6.1.2 Edit and delete symbol
Edit symbol:
- Select the Edit symbol on the line with the wanted symbol
- Make the wanted changes
- Press OK – or Cancel and the changes will not be saved
Delete symbol:
- Press the Trash symbol on the line with the wanted symbol
- A box will be shown; select Yes to accept or No if not
6.1.3 Special symbols
The special symbols are normally used together with I/O’s. The special symbols are:
- Start symbol – Works together with the START button in production
- Stop symbol – Works together with the STOP button in production
- Emergency stop symbol – Works together with the emergency stop button on the machine
- Retest symbol – Works together with the RETEST button in production
- Pause symbol – Will immediately stop the running code. When it is free again it will continue running the code
- Reset NOK symbol – Works together with the RETEST button in production
Add a special symbol (is the same for all the special symbols):
- Select the wanted special symbol and it will show a window
- Press the green Add symbol
- Select the symbol name
- Select the trigger value
- Press Save – or Cancel and the symbol will not be added
Remove a special symbol (is the same for all the special symbols):
- Select the wanted special symbol and it will show a window
- Press the red remove symbol on the line with the wanted symbol
- Press Save, and the symbol is removed
6.2 Application configuration
Press the application configuration button to setup the license. It is also possible to create more setups.
6.2.1 Production
The production functions make it possible to create some settings for
- Batch
- Icons
- System buttons
They will be explained below.
6.2.1.1 Batch
Batch is the structure of the batch number used in the production and results can be selected.\\
Create a batch: The first space named Batch example will show what the batch configuration will look like.
- Select the date format
- Select the split character, which is the split character between date and running number
- Select the counter length of the count number
- Select if it can use date as default (NB, if the mark is removed, the operator will be prompted for a batch number when a new production is starting)
- Press Save and the batch configuration will be saved
6.2.1.2 Icons
Icons is the icon to show if an object is tested as bad or good. It can be configurated.\\
Create an icon configuration:
- Select the success icon (it will show an example)
- Select the failed icon (it will show an example)
- Press Save and the icon configuration will be saved
6.2.1.3 System buttons
System buttons is where the setup of the buttons take place.
Create a system button:
- Press the New button
- Enter the button values (see the button values below)
- Press Save, and the button is saved
Button values:
- On text – When the symbol value is 1, the text “light on” will be active
- On tooltip – When the symbol value is 1, the text “turn of the light” will be active
- Off text – When the symbol value is 0, the text “light off” will be active
- Off tooltip – When the symbol value is 0, the text “turn on the light” will be active
- On color – When the symbol value is 1, the button frame color will be the selected color
- Off color – When the symbol value is 0, the button frame color will be the selected color
- Password – If the button control needs to be protected by password, type the password text. If blank, no password is needed
- Symbol name – Select the symbol name to control with the button
- Active – The button is only visible when active is marked
- Order – Set the number where the button will be placed
Edit a system button:
- Select the wanted system button to the right
- Make the wanted changes
- Press Save, and the changes will be saved
Delete a system button:
- Select the wanted system button to the right
- Press Delete, and the button is deleted
6.2.2 License
License makes it possible to insert a new license. This can be needed if the configuration needs to be changed; then a new license can be filled in.\\
NB! After this the application must be restarted.
6.2.3 Application
Application make it possible to create some settings about
- Reset layout
- Show/Hide Elements
- Documentation
- Manual
- Error log
This will be explained below
6.2.3.1 Reset layout
Reset layout makes it possible to reset the layout for pages that can be changed by the users. The areas to reset are:
- Tile View
- Production View
- Debug View
- Program editor
Reset a layout:
- Press the Reset button to the right
6.2.3.2 Show/Hide Elements
Show/hide elements makes it possible to configurate the elements which will be available in the applications.\\
Show/Hide element:
- Select to show or deselect to hide in the show area
- Press Update
6.2.3.3 Documentation
Documentation will show the path to a folder. The folder is for all the wanted documents.\\
Create documentation:
- Select the folder where the documentation is placed
- Select shows the documentation folder, and the selected folder will be shown at the main menu
- Press Save
- Press Get files, and the files placed in the selected folder will be shown
6.2.3.4 Manual
Manual makes it possible to select where the manual is placed.
6.2.3.5 Error log
In error log, the errors will be shown. For example if TestIT shows an error, it will be in error log.
6.2.4 Database
Database makes it possible to create some settings for:
- Backup
- Select database
- Delete results
- Delete SQL data log
This will be explained below
6.2.4.1 Backup
Backup makes it possible to set up a daily backup and to save the entire database on a selected disk.
Setup a backup (is the same for setup and production database):
A ‘onetime’ backup:
- Select where the database .bak file should be saved, and select whether it should be the default folder
- Select the name of the backup
- Press backup and it will create a backup
An auto backup:
- Select where the database .bak file should be saved, and select whether it should be the default folder
- Select the name of the backup
- Mark the auto backup setup database
- Select time of the backup procedure. Please consider when production had used the PC last
- Select the Save behavior of how many wanted backups
- Press Save
6.2.4.2 Select database
In select database, the options are:
- Select new setup database on next startup – If this is marked it will be possible to change setup database after a restart of TestIT
- Select new production database on next startup – If this is marked it will be possible to change production database after a restart of TestIT
After a mark, the system has to restart before the system requires a new database setup.
6.2.4.3 Delete results
Delete results makes it possible to see the results and delete them.
Filter data:
- Select the wanted filter headline
- Now it is filtered
Switch to demo results:
- Press the Demo button at the right corner
- The results will switch between demo results database (debug area) and the results database (production).
Delete results (both results and demo results):
- Select the wanted data
- Press the Delete results button in the left corner, and the results will be deleted
6.2.4.4 Delete SQL data log
Delete SQL data log make it possible to see the SQL data log and delete it. Delete SQL data log:
- Select the wanted data
- Press the Delete button at the left corner, and the data will be deleted
6.2.5 User
User makes it possible to create some settings for:
- User configuration
6.2.5.1 User configuration
In user configuration, it is possible to select the minimum length of the user name and the password.\\ Write the number of the wanted length and press Save.
6.3 Devices
Devices make it possible to setup, configure, and test the different devices. All the devices are explained below. To see a code example and the parameters of the commands, just follow the links.
Options
Create a device:
- Follow the instructions of the wanted device in the following sections
Edit a device:
- Select the wanted device
- Press the Edit symbol
- Make the wanted changes
- Press Save – or Cancel and the changes will not be saved
Delete a device:
- Select the wanted device
- Press the Trash and accept
6.3.1 C9
C9 is a Nolek instrument.
Setup fields:
- Configuration
- Test device
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- Baud rates – Serial port parameter
- Data bit - Serial port parameter
- Parity - Serial port parameter
- Stop bit - Serial port parameter
- Com port – Will show all registered COM ports on the PC. Select them
- Press Save
Test device:
To run a standard test:
- Select the text in command field
- Select the timeout in seconds
- Press Send and the received text will be shown in the read box
After the wanted tests, it is possible to clear the text at the Clear received text button. When the tests are finished, press Unlock config and save.
6.3.1.1 Commands
6.3.2 Database connection (MSSQL
A database connection will open a database and execute a stored procedure.\\
Setup fields:
- Configuration
- Connection
- Stored procedure
- Input parameters
- Output parameters & test device
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
Connection:
- Select/write the server type
- Select authentication (SQL server Authentication or Windows Authentication)
- Press Search on the databases line
- Select the database to use
- Press Connect and the control status will be shown on the left side of the connect button – Must be connected!
Stored procedure:
- Select the stored procedure name to use
- Select the timeout time in seconds. This is the max time to wait for a response from the database
- Press the Automatic button and it will generate the input parameter tab
Input parameters (a tab):
- Select the symbol to use for the device
- Press Save and it will generate the output parameters and test device.
Output parameters & test device (a tab):
- Type the input value
- Press Send and it will make a test and send it to output parameters
- Select a symbol for each received data
- Press Save and it will be possible to test more values – just type a new input value
6.3.2.1 Commands
Command in the database connection is:
Execute sample:
The stored procedure is configured like this:
| Way | Parameter | Symbol |
| Output | @parm01 | R01 |
| Output | @parm02 | R02 |
| Output | @parm03 | R03 |
| Output | @parm04 | R04 |
'Move the input parameter to the input symbol.
Misc.Move( R00,”Demo01”)
Database.Execute(MSSQLconnection,_Done)
Control is the command execute ok.
Function.If(_Done,< >,1)
'Error handling.
Function.EndIf()
'If execute ok.
'R01 values = @parm01
'R02 values = @parm02
'R03 values = @parm03
'R04 values = @parm04
6.3.2.2 SQL Data log – Example
A description of how the Database Connection (MSSWL) can be used. In the TestIT production database, we have made an area where it is possible to save 19 numbers of value and 6 of text values.\\ Before configuring the database connection, create 19 symbols and 6 string symbols in the symbol handling.
- E.g. DS01 …… DS19 numeric symbols (double)
- E.g. DS20 …… DS25 string symbols
Instructions of how to configure the database:
- Create a database connection:
- Select Create database connection (MSSQL)
- Configuration/connection/stored procedure:
- Configuration:
- Write the device name – E.g. SQLLog
- Write a device description – E.g. Sending data to Data Log Table
- Configuration:
- Connection:
- Write servers – E.g. (local)/sqlexpress
- Select authentication – E.g. Windows Authentication
- Press Search on the databases line
- Select the database – E.g. TestITProd
- Press Connect
- Stored procedure:
- Select the name – E.g. ISP_SQLdatalogInsert
- Press Automatic
- Input parameters - Setting up TestIT symbols:
- For each parameter, select a TestIT symbol.
- Output parameters – Test
- Write an input value for each parameter
- Press Save
- Now it is possible to select a symbol
- In a TestIT program
- Create the code below and it will send all the data defined to the SQL server
' 21030 - Save to SQL
Database.Execute(SQLlog,_bool01)
6.3.3 Folder (File)
This file folder can be used for reading and writing from and to text files.\\
Setup fields:
- Configuration
- Test device
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- File extension – The type of file to use
- Folder for the files – Path to the folder on the disk
- Delimiter – Which character to split texts
- If exists – Which action if the object exists
- File format – The name of the file if created. File name or File name and date time
- File encoding – Is windows specific
- Press Save
Test device:
- Select the test symbol
- Press Get files and the files in the folder will be shown
- Select the wanted file; if there is no name in the file name box then write one
- Press Read file
- To add a new element to the file, Press Add element to file
- Write a value in the value area and continue until all the needed values have been created
- Press Write file and all the values will be added to the file
6.3.3.1 Commands
Commands in file folder are:
6.3.4 Folder (Image
This image folder can be used for showing an image from a folder, with help text. \\
Setup fields:
- Configuration
- Test device
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- File extension – What type of file to use
- Folder for the files – Path to the folder on the disk
- Press Save
Test device:
- Press Get files and the files in the folder will be shown
- Press View and the actual file will be shown in a window
6.3.4.1 Commands
Image windows can e.g. be used to tell the operator how to assemble components or how to pack the objects in the box after tests. Used together with the device ImageFolder, where all the images can be placed.
Commands in image folder are:
6.3.5 Log
Log is a logging device, that will log a specified array of symbols to in an interval to a file. It will run, when started from programming, and keep running, until stopped from programming. It is possible to trigger it instant, by delay, or by a symbol.
Setup fields:
- Configuration
- How to start/stop parameters?
- Setup log
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- File extension – What type of file to use
- Folder for the files – Path to the folder on the disk
- Delimiter – Delimiter sign
- If exists – Whether to overwrite or create a new file with a timestamp
- Rate – Rate of logging, 1 or 5 per second
- Sample rate – 1, 5, 10 or 20
- Press Save
How to start/stop parameters?
- Select start method
- Select between “when started”, “with delay” or “trigger by symbol”
- Select waiting time (in MS) – Delay time
- Only applying if “with delay” is selected
- Select trigger symbol – Symbol to get trigger value from
- Only applying if “trigger by symbol” is selected.
- Select trigger validation – Type of validation.
- Select between “equal”, “not equal”, “less than or equal to”, “greater than or equal”.
- Only applying if “trigger by symbol” is selected.
- Select trigger value – Value to validate against.
- Only applying if “trigger by symbol” is selected.
Setup log:
- Press Add symbol
- Select the symbol to log
- Select highest or lowest
- If highest, the highest value is set to this symbol
- If lowest, the lowest value is set to this symbol
- Select whether to use sample functionality or not
- If marked, select the sample symbol
- Press Save
6.3.5.1 Commands
Commands in log are:
* LogStart * LogStop
6.3.6 RAMP
Ramp is a ramping device, that will ramp a symbol (usually an analog output), over a specified time and step size . It will run, when started from programming, and keep running, until stopped from programming. It is possible to trigger it instant, by delay, or by a symbol.
Setup fields:
- Configuration
- How to start?
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- Ramp method – Time or Ref
- Symbol – Symbol to ramp
- Sample rate – If using ref symbol and sample is selected, the average value of the last X will be set
- Running symbol – Symbol set to true when ramp is running
- Ref symbol – Symbol used as a reference if ramp method is ref
- Timeout – Timeout for the entire ramp in MS
- Timeout symbol – Symbol set to true, if ref point is not met
- Press Save
How to start?
- Select start method
- Select between “when started”, “with delay” or “trigger by symbol”
- Select waiting time (in MS) – Delay time
- Only applying if “with delay” is selected
- Select trigger symbol – Symbol to get trigger value from
- Only applying if “trigger by symbol” is selected.
- Select trigger validation – Type of validation.
- Select between “equal”, “not equal”, “less than or equal to”, “greater than or equal”.
- Only applying if “trigger by symbol” is selected.
- Select trigger value – Value to validate against.
- Only applying if “trigger by symbol” is selected.
6.3.6.1 Setup/view ramp
Setup: A ramp sequence is made of several steps; ramp step and wait step.
Ramp step
- Set point – Value to set within the time to point
- Time to point in seconds – Time to ramp value to setpoint in seconds
- Ref point – Time to wait in seconds
- Tolerance - +/- tolerance of the ref point in which to accept the ref point
Wait step
- Tim - Ordered List Iteme to point in seconds – Time to wait in seconds
Ramp graph:
- To see how the ramp will run, press Ramp graph
6.3.6.2 Commands
Commands in ramp are:
* RampStart * RampStop
6.3.7 Printer
Printer is to create the setup for the layout of the print.
Setup fields:
- Configuration
- Setup
- Collections
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- Printer – Select the printer to use
- Height – Enter document height
- Width – Enter document width
- Margin top, bottom, left and right – Enter document margin top, bottom, left and right
- Default front family – Select document default front family
- Default front size – Select document default front size
- Press Save
- Now the design is going to be set up. Look at “design options”
Setup: Add element:
- Press Add element
- Select the element type
- Container – A container can be the parent of all elements. (E.g. it can be used to split and arrange elements)
- Text – A static text
- Symbol – A dynamic text. Will insert the values of the selected symbol
- Image – A static image. Selected directly on the disk
- Barcode – A value configured as a barcode. Choose among many different types
- Table - A list of values from a printer collection. Specify the number of columns and row height
- Select the different setups depending on the selected element type
- ress OK – or Cancel and the element will not be added
Edit or delete element:
- Select the wanted element to the right
- Select Edit
- Make the wanted changes – or select Delete
Collections:
- This collection page is used to set up collections for the print device.
- A printer collection is a dynamic collection of values. The number of values will adjust automatically.
- The collection name is unique and is used in CollectionAdd, CollectionClear and Design
Add:
- Press New
- Write the name (required)
- Write a description
- Press Save
Delete:
- Select the delete button to the right
- A box will be shown; select Yes to accept or No if not
6.3.7.1 Commands
Commands in printer are:
6.3.8 S10
S10 is a leak test instrument.
Setup fields:
- Configuration
- Result symbols
- Recipes
- Test device
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- IP Address – Standard 192.168.1.176
- Port – Standard 2001
- Model – Version of firmware in the S10
- Recipe Handling – Where to get recipes from; TestIT or Moscura
- Log measure – Select only if to store measurement values
- Log folder path – Path of folder to store log in
- Graph Y axis min – Set a minimum for the Y axis. Auto if 0.
- Graph Y axis max – Set a minimum for the Y axis. Auto if 0.
- Graph secondary Y axis min – Set a minimum for the secondary Y axis. Auto if 0.
- Graph secondary Y axis max – Set a minimum for the secondary Y axis. Auto if 0.
- Press Save
Result symbols:
- Press the symbols tab
- Select the wanted symbols
Recipes:
- Select the test symbol and the recipes will be shown
- Add a new recipe
- Press New
- Write the recipe name (required)
- The optional spaces: Type, Fill, Stab, Measure, Vent, Misc
- Copy the recipe
- Press Copy
- Write a new recipe name
- Press Save
- Delete the recipe
- Choose the wanted recipe
- Press Delete and accept
Test device:
- Select the Open test area symbol and it will open a new tab
- To start the test, Press Connect
- To stop the test, Press Disconnect
6.3.8.1 Commands
Commands in S10 are:
6.3.9 S11
S11 is a development of S10.
Setup fields:
- Configuration
- Symbols
- Recipes
- Test device
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- IP Address – Standard 192.168.1.176
- Port – Standard 2001
- Model – Version of firmware in the S10
- Recipe Handling – Where to get recipes from; TestIT or Moscura
- Log measure – Select only to store measurement values
- Log folder path – Path of folder to store log in
- Graph Y axis min – Set a minimum for the Y axis. Auto if 0.
- Graph Y axis max – Set a minimum for the Y axis. Auto if 0.
- Graph secondary Y axis min – Set a minimum for the secondary Y axis. Auto if 0.
- Graph secondary Y axis max – Set a minimum for the secondary Y axis. Auto if 0.
- Press Save
Symbols:
- Press the symbols tab
- Select the wanted symbols
Recipes:
- Select Open test area symbol and the recipes will be shown
- Add a new recipe
- Press New
- Write the recipe name (required)
- The optional spaces: Type, Fill, Stab, Measure, Vent, Misc
- Copy the recipe
- Press Copy
- Write a new recipe name
- Press Save
- Delete the recipe
- Choose the wanted recipe
- Press Delete and accept
Test device:
- Select the test symbol and it will open a new tab
- To start the test, Press Connect
- To stop the test, Press Disconnect
6.3.9.1 Commands
Commands in S11 are:
* [[testit:5programming:5.3_functions_window#MeasureStartS11|]] * [[testit:5programming:5.3_functions_window#MeasureGetS11|]]
6.3.10 S9 Serial
S9 Serial device is the communication to Nolek S9. Recipes can be created from TestIT and send directly to the S9. \\
Setup fields:
- Configuration
- Symbols
- Recipes
- Test device
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- Baud rates – Serial port parameter
- Data bit - Serial port parameter
- Parity - Serial port parameter
- Stop bit - Serial port parameter
- Com port – Will show all registered COM ports on the PC
- Recipe Handling – Where to get recipes from; TestIT or Moscura
- Log measure – Select only to store measurement values
- Log folder path – Path of folder to store log in
- Graph Y axis min – Set a minimum for the Y axis. Auto if 0.
- Graph Y axis max – Set a minimum for the Y axis. Auto if 0.
- Graph secondary Y axis min – Set a minimum for the secondary Y axis. Auto if 0.
- Graph secondary Y axis max – Set a minimum for the secondary Y axis. Auto if 0.
- Press Save
Symbols:
- Press the symbols tab
- Select the symbols for the spaces
Recipes:
- Select Open the test are symbol and the recipes will be shown
- Add a new recipe
- Press New
- Write the recipe name (required)
- The optional spaces: Info, Recipe, Auto Control, Shock Fill, Vacuum pressure, Dosage, Volume Control, Flow, Offset Compensation, Quick Connector, Setting.
- Copy the recipe
- Press Copy
- Write a new recipe name
- Press Save
- Delete the recipe
- Choose the wanted recipe
- Press Delete and accept
Test device:
- Select the test symbol and it will open a new tab
- To start the test, Press Connect
- To stop the test, Press Disconnect
6.3.10.1 Commands
Commands in S9 serial are:
* [[testit:5programming:5.3_functions_window#Measure|]] * [[testit:5programming:5.3_functions_window#StartInstrument|]] * [[testit:5programming:5.3_functions_window#ControlLeak|]] * [[testit:5programming:5.3_functions_window#RecipeNumber|]] * [[testit:5programming:5.3_functions_window#RecipeText|]] * [[testit:5programming:5.3_functions_window#MeasureLog|]] * [[testit:5programming:5.3_functions_window#RecipeValuesAsText|]]
6.3.11 S9 Data Log
In this data log window it is logging data from an S9.
Setup fields:
- Configuration
- Test device
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- Baud rates – Serial port parameter
- Data bit - Serial port parameter
- Parity - Serial port parameter
- Stop bit - Serial port parameter
- Com port – Will show all registered COM ports on the PC. Select them
- Press Save
Test device:
- Press the test device tap
- Write a log name (optional)
- Press Start/stop, to start (the status lamp will turn green)
- Verify that the results are inserted in the grid when the S9 device is done
- To stop, press Start/ stop button again (the status lamp will be red)
- Now it is possible to export the logged data to excel or as a CSV file
- Delete: Mark the wanted data and Press Delete
6.3.12 Serial advanced
In serial advanced there is a communication with a serial port with advanced features. \\
Setup fields:
- Configuration
- Send/receive parameters
- Test device
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- Baud rates – Serial port parameter
- Data bit - Serial port parameter
- Parity - Serial port parameter
- Stop bit - Serial port parameter
- Com port – Will show all registered COM ports on the PC
- Send termination char – Where the char must send the communication
- Receive termination char - Where the char should receive the communication
- Send as – Text or byte array
- Send encoding – None or Char to Hex
- Send params – Number of sending parameters
- Receive delimiter – Which character to split the received text
- Receive params – Number of receiving parameters
- Receive as – Text or byte array
- Receive encoding – None or char to Hex
- Press Save
Send/receive parameters:
- Send parameters – Symbol values to be sent to the COM port.
- Receive parameters – Connect the received data from COM port together with symbols. Values will be separated by receive delimiter.
Test device: There are two types of tests; a standard test and one where the use the command parameters is included. After the wanted tests, it is possible to clear the text, at the clear received text button. When the tests are finished, press Unlock config and Save. \\
To run a standard test:
- Press the test device tab
- Press Lock config to open the COM port
- Insert text in the command field to send.
- If byte array is selected in send as, use a space separated structure to fill the byte array. - E.g. “15 53 24 11 01”.
- If Char to Hex is selected in send encoding, the values will be encoded.
- Press Send and the received text will be shown in the read box.
To run a test including the use of command parameters:
- Press the test device tab
- Press Lock config to open the COM port
- Insert text in the command field to send.
- If byte array is selected in send as, use a space separated structure to fill the byte array. - E.g. “15 53 24 11 01”.
- If Char to Hex is selected in send encoding, the values will be encoded.
- Select “use command parameters”.
- Write the type in the criteria.
- If the result should be received, then write the same as in the command.
- Select the criteria type as in the command.
- None; Begins with; Contains.
- Press Send and the received text will be in evaluation.
- The command response will be the same response as the result of the command. This is based on the evaluation above.
6.3.12.1 Commands
Command in serial advanced is:
* [[testit:5programming:5.3_functions_window#RS232ADV|]]
6.3.13 Serial
In serial there is a communication to and from a serial device.
Setup fields:
- Configuration
- Test device
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- Baud rates – Serial port parameter
- Data bit - Serial port parameter
- Parity - Serial port parameter
- Stop bit - Serial port parameter
- Com port – Will show all registered COM ports on the PC
- Send termination char – Where the char must send the communication
- Receive termination char - Where the char should receive the communication
- Press Save
Test device: After the wanted tests, it is possible to clear the text, at the clear received text button. When the tests are finished, press Unlock config and save. \\
To run a standard test
- Press the test device tab
- Press Lock config to open the COM port
- Insert text in the command field to send.
- If byte array is selected in send as, use a space separated structure to fill the byte array. - E.g. “15 53 24 11 01”.
- If Char to Hex is selected in send encoding, the values will be encoded.
- Press Send and the received text will be shown in the read box.
6.1.13.1 Commands
Command in serial advanced is:
* [[testit:5programming:5.3_functions_window#RS232|]]
6.3.14 Socket
Socket is a TCP/IP communication.
Setup fields:
- Configuration
- Command structure
- Test connection
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- IP address – Socket port parameter
- Port ID – Port no. and is a socket port parameter
- Send delimiter – Character to split send text
- Receive delimiter – Character to split receive text
- Log file folder – Path to the log folder
- Logging on/off – On = Logging is active; Off = Logging is inactive
- Socket type – Socket port parameter
- Protocol type – Socket port parameter
- Device status – Which character to split the received text
- Timeout – Number of received parameters
- Termination char – Receive as ‘text or byte array’
- Press Save
Command structure:
- Press New
- Write:
- Name
- Description (optional)
- Optional code - if written, this will always begin the socket command
- Select active
- Add the desired amount of send parameters
- Add the desired amount of receive parameters
- When all is done, Press Save
Test connection: To test the socket device, press the Test connection tab.
- Press Test, under commands on the command to test
- Type text in message (If any needed!)
- Type values in all the needed parameters
- Press Send
The response from socket server can be seen in the response area. \\ If any errors happen a text message over the Save and Close button will be shown.
6.3.14.1 Commands
Command in socket is:
* [[testit:5programming:5.3_functions_window#Socket_Execute|]]
6.3.15 TwinCat
TwinCat is a device which deliver the connection to physical inputs and outputs. It is only possible to have one TwinCat device. \\
Setup fields:
- Configuration
- Input and output tab
- Test device
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Select the following:
- Net ID – Extended IP address. Default is 127.0.0.1.1.1
- Main port – Main port no. Default is 300
- Server port – Server port no. Default is 301
- Press Save
- Now it is possible to connect to the TwinCat device by pressing the Connect button
Input and output tab: The options are to import the wanted symbol; just one or all the symbol on the list. To import all the symbols, press the Import all button. To import one symbol, press the Download symbol, and the symbol will be downloaded and can be added. Now press the green plus symbol to import the symbol into TestIT, and when the symbol is imported it will show a green Correct symbol. If the symbol cannot be imported it will show a yellow triangle warning, and here it is possible to check the tooltip for a description. To remove the symbol again, press the Trash, and to edit a symbol press the Edit symbol.
Test device: This area can be used to test I/O directly to and from TestIT. The input symbols will display the current value from the TwinCat symbol. The output symbols will display the current value from the TwinCat symbol, and can be set by entering a value in the textbox and selecting Enter or by selecting the button next to the textbox.
6.3.16 Unique ID
Unique ID makes it possible to create an ID. The ID can be created the way it is wanted.
Setup fields:
- Configuration
- Test area and elements
Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
Test area and elements:
- Add element: Select the wanted elements and symbols and the selected element and symbols will be shown in the window in the middle.
- Delete element: Press the red cross sign
- Change the order: Drag and drop the element
- Test: Press the Test button
6.3.16.1 Commands
Command in Unique ID is:
* [[testit:5programming:5.3_functions_window#GetUniqueID|]]
6.3.17 Byte
UNDER CONSTRUCTION
6.3.18 Bit
UNDER CONSTRUCTION
6.3.19 Formula
UNDER CONSTRUCTION
6.3.20 DLL
A DLL device can use methods from a DLL file, allowing you to test them directly or store them as “commands” for later execution. A timeout option allows the program to interrupt a non-responsive method call.
The device can receive any amount of values from a method and store them in a symbol, by dividing a return string between the desired split characters.
Setup fields:
- Device Configuration
- Command Configuration
- Test Method/Command
Device Configuration:
- Write the device name and device description (required)
- Select if the device is active or not
- Click the box next to “FilePath” and a small button “…” appears, click to browse for the .dll file you want this Device to use
- Select a Timeout in milliseconds, correlating to the time before any DLL-method execution will be interrupted and aborted. When the time set in the timeout has run out, the method will be aborted if there has been no result yet. Aborting this way is not recommended, but used in case the method itself does not handle timeouts.
- Press Save
Command Configuration:
When a valid DLL file has been selected, its classes and methods can be displayed. These can be stored as commands for future method execution:
Setup:
- Press the “Class name” dropdown under “DLL Contents” and select a Class, then select a Method from the grid
- Enter a command name, and optionally a description (MAX 50 characters)
- Input:
- If the method requires any parameter(s): Select the desired symbol that will hold these values
- If the “Required” checkbox is off, you can choose to not select a symbol, and the default value will be sent instead
- Output:
- If the method will return multiple values (received in a single string): Write the total amount of outputs in “Output Count”, then write the character(s) that separates these outputs. Example: “;”
- Select the desired symbols for each output, and optionally give the parameter(s) a name
Test of and saving the setup:
- Press “New Command” to save the method. If you want to test it before saving, look at “Test Method” below
- Verify that your command appeared under “Stored Commands” on the right
Test Method:
A method or stored command can be tested directly.
- Select a DLL-method or stored command
- Click the “Test” tab on the top, next to “Config”
- Enter values (if any) in the “Value” box of input parameters.
- Click Send.
Any return values will be put in Output and be split according to your configurations.
6.3.20.1 Commands
Command in DLL is:
* [[testit:5programming:5.3_functions_window#DLL_execute|]]
