(User Manual)
V 1.0
CAUTION:
Dixell S.r.l. reserves the right to amend this manual without prior notice. The latest
Please read this manual carefully before installing and starting Visoprog and follow all the instructions
contained in it. The manual also serves as a reference guide, which is why we recommend you always
ensure it is within easy reach.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 2/88
INDEX
1. MINIMUM SYSTEM REQUIREMENTS VISOPROG...................................................................... 6
2. HOW TO INSTALL ................................................................................................................... 7
3. VISOPROG............................................................................................................................ 11
3.1 SPLASH SCREEN .............................................................................................................................11
3.2 CREATE A NEW PROJECT ................................................................................................................11
3.3 OPEN A PROJECT ...........................................................................................................................12
3.4 LAYOUT.........................................................................................................................................12
Toolbar ...................................................................................................................................................... 12
Windows ................................................................................................................................................... 13
3.4.2.1 Stage Preview Window ......................................................................................................................... 14
3.4.2.2 Variables & Vocabulary Window .......................................................................................................... 14
3.4.2.3 Layers Window. ..................................................................................................................................... 14
3.4.2.4 Object Data + Buttons (Visograph) ....................................................................................................... 15
3.4.2.5 Object Data + Remote Buttons (Visotouch). ......................................................................................... 15
3.5 Convert/import a project ...............................................................................................................16
4. PRELIMINARY OPERATIONS .................................................................................................. 17
4.1 VOCABULARY MANAGEMENT ........................................................................................................17
4.2 PROJECT TO LINK ...........................................................................................................................18
4.3 GENERAL INFORMATION ...............................................................................................................18
4.4 DEVICE SET-UP ..............................................................................................................................19
4.5 FONTS MANAGEMENT...................................................................................................................19
4.6 COMPILER .....................................................................................................................................20
5. VARIABLES, VOCABULARY, IMAGES AND STATES .................................................................. 21
5.1 VARIABLES ....................................................................................................................................21
Variables Editor ......................................................................................................................................... 21
Import Variables ....................................................................................................................................... 22
5.1.2.1 Import From Excel File .......................................................................................................................... 23
5.1.2.2 Import From ISaGRAF Project ............................................................................................................... 25
Export Variables ........................................................................................................................................ 26
System Variables ....................................................................................................................................... 28
5.1.4.1 Others ................................................................................................................................................... 29
5.2 VOCABULARY ................................................................................................................................30
Vocabulary Editor...................................................................................................................................... 30
Import Vocabulary .................................................................................................................................... 31
Export Vocabulary ..................................................................................................................................... 33
5.3 IMAGES .........................................................................................................................................34
5.4 STATES ..........................................................................................................................................35
5.5 SHOW REFERENCE .........................................................................................................................37
6. VISOGRAPH STAGE............................................................................................................... 39
6.1 STAGE PROPERTY ..........................................................................................................................39
6.2 STAGE LIST, TREEVIEW AND SEQUENCE .........................................................................................40
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 3/88
6.3 TOOLBAR ......................................................................................................................................40
6.4 ELEMENTS .....................................................................................................................................41
VarLabel .................................................................................................................................................... 41
6.4.1.1 Properties Page ..................................................................................................................................... 41
6.4.1.2 Conditions Page .................................................................................................................................... 42
DxLabel...................................................................................................................................................... 43
6.4.2.1 Properties Page ..................................................................................................................................... 43
6.4.2.2 Conditions Page .................................................................................................................................... 44
DXImage .................................................................................................................................................... 45
6.4.3.1 Properties Page ..................................................................................................................................... 45
6.4.3.2 Conditions Page .................................................................................................................................... 46
DxAnimImage ............................................................................................................................................ 46
6.4.4.1 Properties Page ..................................................................................................................................... 47
6.4.4.2 Conditions Page .................................................................................................................................... 47
DxSwitchVarLabel ..................................................................................................................................... 48
6.4.5.1 Properties Page ..................................................................................................................................... 48
6.4.5.2 Switch Sequence Page .......................................................................................................................... 49
6.4.5.3 Conditions Page .................................................................................................................................... 50
DxSwitchVarImage .................................................................................................................................... 51
6.4.6.1 Properties Page ..................................................................................................................................... 51
6.4.6.2 Switch Sequence Page .......................................................................................................................... 52
6.4.6.3 Conditions Page .................................................................................................................................... 52
6.5 KEYS..............................................................................................................................................53
6.5.1.1 Virtual Buttons ...................................................................................................................................... 54
6.5.1.2 Properties Page ..................................................................................................................................... 54
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 4/88
7.4.8.2 Conditions Page .................................................................................................................................... 78
DXTCButton ............................................................................................................................................... 79
7.4.9.1 Properties Page ..................................................................................................................................... 79
7.4.9.2 Image Page ............................................................................................................................................ 80
7.4.9.3 Conditions Page .................................................................................................................................... 80
7.4.9.4 Actions Page .......................................................................................................................................... 81
7.5 REMOTE BUTTON ..........................................................................................................................84
8. COMPILING AND DOWNLOADING PROJECT .......................................................................... 86
8.1 COMPILING ...................................................................................................................................86
Visotouch Limits ........................................................................................................................................ 86
8.2 DOWNLOADING PROJECT ..............................................................................................................87
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 5/88
1. MINIMUM SYSTEM REQUIREMENTS VISOPROG
The following Windows platforms are supported:
Microsoft Windows 8 /8.1
Microsoft Windows 7
Microsoft Windows VistaTM (SP1)
The latest service packs and security updates are recommended for all platforms
Microsoft Internet Explorer 6.0 SP1 or later
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 6/88
2. HOW TO INSTALL
Insert the CD in the CD drive and click the Visoprog5.exe file to start the guided process; press Next
button:
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 7/88
Enter User name and Company name, then press Next button to continue:
Select the path where you want to install the Wizmate; default path is C:\Programs\Dixell\Wizmate; press
Next button:
BQT
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 8/88
Press the Next button:
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 9/88
To exit the installation press Finish button.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 10/88
3. VISOPROG
Visoprog5 is the new integrated development environment for programming and debugging Visograph and
Visotouch devices.
The tool helps the user in the creation of User Interface by signaling syntax errors, in addition to a whole
range of tools and features to support the development and debugging.
Visoprog 5 can also migrate applications developed for keyboards Visograph on Visotouch devices.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 11/88
3.3 OPEN A PROJECT
3.4 LAYOUT
Toolbar
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 12/88
Windows
Here is an example to show the layout of the standard window. It is also possible to customize and save your
own layout by clicking the button.
(1) Stage list + TreeView + Sequence window. List all the stages and elements.
(2) Images database window.
(3) Editor window. User development area. Most of the development job is done here.
(4) Stage preview + Variables + Vocabulary window.
(5) Layers window.
(6) Object data + Remote buttons.
(7) Compiler window. Show all the information generated during compiling.
(8) Statistical information window. Show the percentage of resources used by current project
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 13/88
3.4.2.1 Stage Preview Window
In the Stage preview window, it shows the preview of selected page according to the given variables
values. Use can change the variables to simulate different display.
Click buttons can zoom in/out the view.
Click button can take a screen short of the page. It will be saved as a document in stage list and allows
exporting.
In the Variables window, it shows all the variables and states (if activated states visualization in project
option). In the Vocabulary window, it shows all the vocabularies defined.
User can assign different sorts of elements to different layers for easy viewing. Layer has meaning only
during development; it has no meaning for real display. For example, you can create a layer named images
where to include all image elements. And then create another layer named labels where to include all label
elements.
Double click the button can hide/unhide all the elements in the layer. Double click the button can
lock/unlock the elements in the layer. Once locked, the element cant be selected by mouse.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 14/88
3.4.2.4 Object Data + Buttons (Visograph)
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 15/88
3.5 CONVERT/IMPORT A PROJECT
With visoprog 5 is possible to import and convert applications developed for earlier versions of the software.
The conversion is irreversible, so please remember to save your original project before start conversion.
After Visoprog 4 to Visotouch conversion completed, the layout maybe changed, you need to check and
adjust the layout again.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 16/88
4. PRELIMINARY OPERATIONS
Set the language used for the Visoprog.
From the menu bar, select language and set the desired language.
Languages Language
Select the language used for the Visoprog.
N.B. Not to be confused with the language used in the project. This option makes reference only to Visoprog
and not to the project to be downloaded into the Visotouch.
Go to the options menu and set Project options and configurations Project Project Options
In this section we define languages used in the project vocabulary. It is multiple choices.
Grey is default active language (ENGLISH) and checked in boldface is optional.
You can select one language to be active in the project editor. This only means to the Visoprog not means to
the Visotouch.
E.g. if English selected, in your Visoprog editor, you will see all elements are displayed with English
vocabulary.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 17/88
4.2 PROJECT TO LINK
Here you can select the ISaGRAF project to link. It can be used for importing variables from target ISaGRAF
project to Visoprog project.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 18/88
4.4 DEVICE SET-UP
The Device download, Visotouch Address lan and Ipro Address lan options are left for future using.
At the moment, keep the default setting.
The Baudrate option is used to define the speed of communication between the Visoprog and the keyboard.
The available baud rates are 38400 and 19200.
If checked the box Touch calibrate on startup, every time when the screen startup, it will enter in
calibration process automatically. Please click on the red points on the screen to complete the calibration,
after that the application can start to work.
In this section there is the management of fonts used in the project. Up to 4 fonts are available.
Double click on the Fonts can enter in Fonts editor menu.
Here you can select Font, style, size, effects, and script. The color will not be respected because each
element will set its own color in the properties menu.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 19/88
4.6 COMPILER
In this section, you can select the destination for the final compiled files.
Click button , it will locate to the current project folder automatically.
Then select which languages of vocabulary you want to include in the compiled files.
E.g. if you dont check Italian, even if you had selected it in Vocabulary management menu, it will not be
included in the final compiled files.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 20/88
5. VARIABLES, VOCABULARY, IMAGES AND STATES
If start from a new project, you can add new variables, vocabulary and images in Variables editor,
Vocabulary editor and Image Database.
If start from an existing project, you should perform an export of variables, States, vocabulary and existing
images to have both an update to apply the changes, and also a security backup.
5.1 VARIABLES
Variables Editor
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 21/88
The meaning of each column:
Description: Comment of the variable (only for the user information).
Name: Name of the variable.
Group: Group which the variable belongs to (only for the user information).
Address: Variable modbus register address. The most important identifying the variable.
It can be decimal number (e.g. 28672) or hexadecimal number (e.g. x7000).
Signed: Determines whether the variable is loaded with or without sign -.
0: unsigned;
1: signed.
Read from Excel: Determin if the variables properties are defined by Visoprog or defined by
controller (ipro).
0: by controller;
1: by Visoprog.
Import Variables
Except define new variables one by one manually, it is also possible to import variables from excel file or
from ISaGRAF project.
Click Import button to start the importing.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 22/88
5.1.2.1 Import From Excel File
This excel file could be a file exported from another Visoprog project. If you want change or add some
variables, you can open and edit this excel file and then import the new excel file.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 23/88
Note: The importing will delete all the previous variables. If you dont want the coverage, please export the
variables firstly.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 24/88
5.1.2.2 Import From ISaGRAF Project
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 25/88
Export Variables
You can also export in xls the entire variables library by following steps:
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 26/88
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 27/88
System Variables
SYS_LEDG Set SYS_LEDR=1, the green LED on the screen will be ON. 0xFFFE
Set SYS_LEDR=0, the green LED on the screen will be OFF.
SYS_VKEY Virtual key command. Write command to SYS_VKEY, then the 0xFFF4
corresponding command defined in Remote Buttons will be executed.
SYS_VER Show firmware project version. 0xFFF6
STAGE_PAGE Currently active page index. (The index is start from 1). 0xFFF3
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 28/88
ADR_VARSYS_BUZZ : Description
Contains the status of the 3 resources: Buzzer, Led1, Led2
Each resource has 4 operating statuses:
OFF (not active)
ON (active)
FLASHING
UNALTERED.
The operating statuses of the resources are mapped inside a 16-bit variable in the format below:
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
5.1.4.1 Others
0xFFF5
A system variable is read with the keyboard start up. This variable contains the address of the first stage to
display. The value ranges from 0 to N, where N is the maximum number of Stages -1 in the interface. If N is
greater or equal to the number of stages present, then stage 0 is taken as the entry stage. If the base does
not correspond to this variable within (approximately) 90 seconds, stage 0 is taken as the default option.
PS
There is a subject line for the visibility of the pages.
Enter LABEL in the subject line. The content or location is not important because it is not displayed (we
recommend using one character to not use up too much space).
In the visibility conditions enter an expression like
PS(Var,arg1,arg2,arg3,argN)
Where Var is the variable to use in the mathematical formula, arg1 ... argN are the visibility conditions of the
pages from 0 to N, respectively.
Example:
PS($1,T,Var1=-21,T,Ar2=-123,Var3>432)
Note: In a stage there must be as many tops as pages, otherwise the switch from one page to the next will
not be carried out correctly.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 29/88
5.2 VOCABULARY
Vocabulary Editor
In the editor, all the languages selected in Project option -> Vocabulary management will be shown.
You can add new items here. After changed the vocabulary, please click button to update changes.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 30/88
Import Vocabulary
Except define new vocabulary one by one manually, it is also possible to import vocabulary from excel file.
The format of the excel file is like below:
First row must have this structure: IDVoc Language1 Language2 . (Up to 5);
Starting from second row of the first column we insert a progressive index;
Then for each text inserted, you have to translate into the other languages you want.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 31/88
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 32/88
Export Vocabulary
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 33/88
5.3 IMAGES
The B/W image has only black and white color. It will be marked with a red point. Colorful image has no red
point marked.
Add (*)
Move image to
Move image down
Expand window
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 34/88
Visograph
(*) The three options allow you to add an
image to the database from a
previously created file, create one
using the editor, or you can import an
entire database of images to the
project.
(**) Since the maximum number of images in the database is 256 (0-255) if the database is full and
you have to insert a new image it is possible to sotituirne an existing one with another new one.
Visotouch
(*) The four options allow you to add an
image to the database from a
previously created file, create one
using the editor, or you can import an
entire database of images to the
project.
B/W image has only black and white
color. It will be marked with a red point.
COLOR image are colorful images. It
has no red point marked.
With new image editor, you can draw a
new COLOR image.
(**) Since the maximum number of images in the database is 614 (2 MB), if the database is full and
you have to insert a new image it is possible to replace an existing one with another new one.
5.4 STATES
The States could be very useful when display a variable value as labels.
For example: Variable Unit_Status is defined as 0 means OFF, 1 means ON. Instead of show number 0 or
1 on the touch screen, it can show label OFF when Unit_Status=0, show label ON when Unit_Status=1.
In this way, we can obtain a friendlier user interface.
To use States, you must active States visualization in Project Options menu.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 35/88
States cant be edit in Visoprog, it must be edit in excel file and then imported to Visoprog. Here is an
example to show the excel file format.
Note: The maximum length of a state is 6 characters. No multi-language supported.
In Variables editor, click button to import variables. Then select Import States in the next window.
After importing finish, the States will be shown in the Variables area on the right side of the window.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 36/88
Then, in the Variables editor, define the variable which you want to display as states. The column Flag
State must be set to 1, and the column Mask set as the starting index (Mask must > 0).
With Show reference function, it is very easy to know where each variable, vocabulary or image is used in
the whole project.
Click button can open the XReference window. Then select the concerned variable / vocabulary / image
from the list. It will list down all the stages and elements where this variable / vocabulary / image have been
used.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 37/88
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 38/88
6. VISOGRAPH STAGE
The internships are the various sections into which it is divided by the visoprog project.
Each stage can be composed of several pages that in turn contain objects.
Doing right in the box named List Stage opens the menu that allows you to create new stage, delete, copy,
move and import them from other projects or export them.
Add automatic stage allows you to pre-configure a new stage with the chosen objects and properties.
Click Stage properties can change the background color and edit other settings.
Exit mod:
Infinite: No automatic exit from this stage (only with keys)
Timeout: After seconds jump to a target stage (timeout is multiple of 5 seconds: 1=5sec)
Compressed: (only for visograph) The check on compressed flag is used when one needs to have an
internship that can adapt to multi-page items it contains.
We as an example that in one stage needing to display at most 8 rows of items (example 8 sensors with
its values) but which, for mathematical terms, when there are only 4 of assets. Normally the stage, with
all active elements, should be composed of two pages. To prevent the stage shows the 4 Active probes
on the first page and, below, a blank page is compressed function ability. This makes it possible to
resize the stage "according to active elements it contains.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 39/88
6.2 STAGE LIST, TREEVIEW AND SEQUENCE
StageList window lists all the stages inside the project. Switch to TreeView window can show all elements
involved in current stage. Switch to Sequence window can show all activated elements in current stage. The
Sequence is the cursor moving sequence. When user presses button defined as Prev Element or Next
Element on the touch screen, he will see the cursor moves to another element. The cursor location is
marked with dash line border. To change the defined element sequence, you can use button .
6.3 TOOLBAR
Visoprog provides some toolbars for easy using. They are available on the top of Editor Window.
(1) Zoom in +
(2) Zoom out -
(3) Add new page
(4) Move page down
(5) Move page up
These buttons could be very helpful for arranging the elements to obtain a good visual sense. For example,
in the screen below, if you want to make the 3 images space equally, you can keep press Shift key on the
PC keyboard, and use mouse to select these 3 images. And then click , you will see the images are put
to right position automatically.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 40/88
6.4 ELEMENTS
Visoprog provides 9 categories of elements to display variables, strings and images. Be familiar with every
elements property can help you to select the right element for your requirement.
(1) VarLabel
(2) DxLabel
(3) DxImage
(4) DxAnimImage
(5) DxSwitchVarLabel
(6) DxSwitchVarImage
(7) Not used
VarLabel
VarLabel element is used to display a variables value. To add a VarLabel element, click on the VarLabel
button and then click on the stage editor area. Double click the element can open and edit its properties.
Locked on Scroll If checked, this element will display in every page of current stage
with the same position.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 41/88
action such as write value to a variable.
Select Variable Select the variable to be shown from Variables list. You can type the
variable name to find the variable easily. See the graph below. The
next line is used for preview. For example, it can be written as -
10.10.
If the selected variable is defined as State in the variables editor, use
this VarLabel element can show the variable value as strings.
Font Allows selecting the font from the font list defined in the project option.
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 42/88
DxLabel
DXLabel element is used to display a label. This label can be a normal string or string from vocabulary.
Double click the element can open and edit its properties.
Locked on If checked, this Label will display in every page of current stage with the same position.
Scroll
Disabled It is checked by default. If unchecked, means this label is enabled, it is available for cursor
locating. User can click this label and do extra action such as jump to another stage or write
value to a variable.
Caption Here allows typing in the string directly. It is also possible to use vocabulary.
The advantages for using vocabulary are:
It is easy for batch processing. Once the vocabulary item updated, all the referred
elements will be changed too.
Easy to manage multi-language.
Font Allows selecting the font from the font list defined in the project option.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 43/88
6.4.2.2 Conditions Page
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 44/88
DXImage
This element can be used to show a fixed image. The image could be only a black & white image. Double
click the element can open and edit its properties.
Locked on Scroll If checked, this image will display in every page of current stage with the same
position.
Disabled It is checked by default. If unchecked, means this image is enabled, it is available for
cursor locating. User can click this image and do extra action such as jump to another
stage or write value to a variable.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 45/88
6.4.3.2 Conditions Page
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.
DxAnimImage
This element can be used to show an animated image. E.g. a blowing fan, a shaking bell. The image could
be either a black & white image or a colored image. Double click the element can open and edit its
properties.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 46/88
6.4.4.1 Properties Page
Select an image in the right window, and then click button can add it to the Image Sequence. Click
button can remove it from the Image Sequence. Then in the preview area, you will see the how will the
images animating.
Note: In the Image Sequence, the images can be all B/W images.
Locked on Scroll If checked, this image will display in every page of current stage with the same
position.
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 47/88
DxSwitchVarLabel
This element can be used to show a switchable variable or switchable vocabulary. Double click the element
can open and edit its properties.
Locked on Scroll If checked, this image will display in every page of current stage with the same
position.
Switch Mode Select the switch mode. It can be switch between variables or switch between
vocabularies.
Select Variable Select the variable for switching. Then select the variable needed. The next line
is used for preview. For example, it can be written as -10.10 or Unit ON.
Font Allows selecting the font from the font list defined in the project option.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 48/88
6.4.5.2 Switch Sequence Page
This page will be shown differently depending on the switch mode, see the two graphs below:
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 49/88
6.4.5.3 Conditions Page
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.
Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 50/88
DxSwitchVarImage
This element can be used to show a switchable image. Double click the element can open and edit its
properties.
Locked on Scroll If checked, this image will display in every page of current stage with the
same position.
Select Variable Select the variable for switching. Click button can open the Variables list.
Then select the variable needed. The next line is used for preview.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 51/88
6.4.6.2 Switch Sequence Page
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.
Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 52/88
6.5 KEYS
The list of buttons on the stage is selected next to the list of properties in the lower right-hand corner of the
screen.
Copy
Paste
Add
Delete
Move DOWN
Move Up
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 53/88
6.5.1.1 Virtual Buttons
There is a system variable that manages the virtual keys of Visograph. When the value of this variable is
other than 0, ensure the keyboard performs the associated keys function.
Here are the associated values:
Note: the combination of keys you want to perform must be implemented as part of the stage(s).
Timeout Only if user keeps press this button for the seconds written in Timeout, then the
button action will be take effect actually.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 54/88
In addition to the name of the key, it can be associated with the following functions:
Jumps to stage
Press passes to the stage selected
Active input
When pressing the button activates
the selected object.
Page UP
Press passes to the previous page
of the stage.
Page DOWN
Press passes to the next stage.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 55/88
Next Element/DOWN Value
When pressing the button allows
you to switch between the active
elements of the stage and when the
item was enabled with the Enable
button, allows you to decrement the
value of the variable.
Set Variables
Press enables writing the value of a
variable.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 56/88
Fast increment value
Press enables increase the value of
a variable. The new value will be
applied immediately without press
Active input button to confirm.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 57/88
7. VISOTOUCH STAGE
Visoprog5 is organized as sequence of stages. Stage can be SINGLE PAGE or MULTIPLE PAGES.
When Visotouch starts, the first stage shown is the first stage defined on Visoprog5 project.
Each stage is the container for the elements (controls) that you decided to show.
When a new project is created, one stage exists by default. Right click on the stage, pop out a menu which
allows adding new stage and cut/copy stage. By click Import stage/Export stage, it is possible to
import/export a stage to/from another project. The stage is saved as .STG5 file. Click Move stage
down/Move stage up can change the stages sequence.
Click Stage properties can change the background color and edit other settings.
Exit mod:
Infinite: No automatic exit from this stage (only with keys)
Timeout: After seconds jump to a target stage (timeout is multiple of 5 seconds: 1=5sec)
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 58/88
7.2 STAGE LIST, TREEVIEW AND SEQUENCE
StageList window lists all the stages inside the project. Switch to TreeView window can show all elements
involved in current stage. Switch to Sequence window can show all activated elements in current stage. The
Sequence is the cursor moving sequence. When user presses button defined as Prev Element or Next
Element on the touch screen, he will see the cursor moves to another element. The cursor location is
marked with dash line border. To change the defined element sequence, you can use button .
In Visotouch, if user put cursor on an activated element, the system variable STAGE_CURSOR will change
to the elements sequence number. This could be very useful when display some information dynamically
according to the cursor position.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 59/88
7.3 TOOLBAR
Visoprog provides some toolbars for easy using. They are available on the top of Editor Window.
(6) Zoom in +
(7) Zoom out -
(8) Add new page
(9) Move page down
(10) Move page up
These buttons could be very helpful for arranging the elements to obtain a good visual sense. For example,
in the screen below, if you want to make the 3 images space equally, you can keep press Shift key on the
PC keyboard, and use mouse to select these 3 images. And then click , you will see the images are put
to right position automatically.
Some buttons function also can be done by right click on the Stage editor area. In the menu pops out, you
can see many optional items. Click the first one Page can set the visibility of pages except the first page,
because the first page cant be hidden.
See the example below, in the Page properties, it writes: the Element visible IF AND($Test1>0,1). It means
this page only visible when variable Test1 > 0. Otherwise, this page will be hidden.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 60/88
7.4 ELEMENTS
Visoprog provides 9 categories of elements to display variables, strings and images. Be familiar with every
elements property can help you to select the right element for your requirement.
(1) TCVarLabel
(2) DXTCLabel
(3) DXTCDateLabel
(4) DxTCImage
(5) DxTCAnimImage
(6) DxTCSwitchVarlabel
(7) DxTCSwitchVarImage
(8) DxTCShape
(9) DxTCButton
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 61/88
TCVarLabel
TCVarLabel element is used to display a variables value. To add a TCVarLabel element, click on the
TCVarLabel button and then click on the stage editor area. Double click the element can open and edit its
properties.
Locked on Scroll If checked, this element will display in every page of current stage
with the same position.
Alignment Select alignment type. Can be Left Justify, Right Justify or Center
Justify.
Select Variable Select the variable to be shown from Variables list. You can type the
variable name to find the variable easily. See the graph below. The
next line is used for preview. For example, it can be written as -
10.10.
If the selected variable is defined as State in the variables editor, use
this TCVarLabel element can show the variable value as strings.
Font Color & Background Color Allows setting the font color and the background color. If Disabled box
is unchecked, here can also set the Font Color pressed and
Background Color pressed. In this way, when user clicks this label, he
can see the labels color changed.
Font Allows selecting the font from the font list defined in the project option.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 62/88
7.4.1.2 Conditions Page
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.
Element blink IF Here can set a logic function to make the element blinks. In case of element visible, if
the logic function is TRUE, the element blinks; if the logic function is FALSE, the
element displays as fix label.
Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 63/88
7.4.1.3 The Math Editor
The Math Editor is used to edit the logic function for elements visibility, blinking, etc.
Function List Here list all the functions available. Double click on one row, the function will be added to
the window above.
For example: TOG($Var) means toggle the variable value. If Var=0, after execute
TOG($Var), Var change to 1. If Var=1, after execute TOG($Var), Var change to 0.
Var List In this list, you can select the required variable to replace the $Var in the function.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 64/88
DXTCLabel
TCVarLabel element is used to display a label. This label can be a normal string or string from vocabulary.
Double click the element can open and edit its properties.
Locked on If checked, this Label will display in every page of current stage with the same position.
Scroll
Disabled It is checked by default. If unchecked, means this label is enabled, it is available for cursor
locating. User can click this label and do extra action such as jump to another stage or write
value to a variable.
Alignment Select alignment type. Can be Left Justify, Right Justify or Center Justify.
Caption Here allows typing in the string directly. It is also possible to use vocabulary.
The advantages for using vocabulary are:
It is easy for batch processing. Once the vocabulary item updated, all the referred
elements will be changed too.
Easy to manage multi-language.
Font Color & Allows setting the font color and the background color. If Disabled box is unchecked, here
Background can also set the Font Color pressed and Background Color pressed. In this way, when user
Color clicks this label, he can see the labels color changed.
Font Allows selecting the font from the font list defined in the project option.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 65/88
Stage Show font preview.
preview
Switch Variable Click to select a variable from the list to determine which stage to jump to when user
click on this Label.
On the right side, it lists all the stages in the project. Put mouse on a stage, then click
button can add this stage to the switch list. On the contrary, click button can
remove a stage from the switch list.
On the left side, it indicates the variable range for stage jumping. For example:
Min = 1, Max = 2, Value = Stage1. Means if 1 <= Test1 <= 2, it will jump to Stage1
when user click this label on the touch screen.
Jump to Stage If checked, when jumped to the appointed stage, the cursor will stay in the position
and back where it had been.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 66/88
7.4.2.3 Conditions Page
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.
Element blink IF Here can set a logic function to make the element blinks. In case of element visible, if
the logic function is TRUE, the element blinks; if the logic function is FALSE, the
element displays as fix label.
Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 67/88
DXTCDateLabel
This element is very helpful for displaying the date and time. It provides 8 kinds of format. User can select
one format as he prefer. Double click the element can open and edit its properties.
Locked on Scroll If checked, this element will display in every page of current stage with
the same position.
Date time format Here allows selecting the date time format.
dd, mm, yyyy/yy variable Here can select the variables to show the date value.
Font Color & Background Color Allows setting the font color and the background color.
Font Allows selecting the font from the font list defined in the project option.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 68/88
DXTCImage
This element can be used to show a fixed image. The image could be either a black & white image or a
colored image. Double click the element can open and edit its properties.
Locked on Scroll If checked, this image will display in every page of current stage with the same
position.
Disabled It is checked by default. If unchecked, means this image is enabled, it is available for
cursor locating. User can click this image and do extra action such as jump to another
stage or write value to a variable.
Black Color/White Double click on one B/W image (marked with a red point on the left top corner) in the
Color right window. The color setting boxes will change to visible.
For colored images, it is not possible to configure the Black Color and White Color.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 69/88
7.4.4.2 Condition Stage Jump
Switch Variable Click to select a variable from the list to determine which stage to jump to
when user click on this Label.
On the right side, it lists all the stages in the project. Put mouse on a stage,
then click button can add this stage to the switch list. On the contrary, click
button can remove a stage from the switch list.
On the left side, it indicates the variable range for stage jumping.
For example:
Min = 1, Max = 2, Value = Stage1. Means if 1 <= Test1 <= 2, it will jump to
Stage1 when user click this label on the touch screen.
Jump to Stage and back If checked, when jumped to the appointed stage, the cursor will stay in the
position where it had been.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 70/88
7.4.4.3 Conditions Page
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.
Element blink IF Here can set a logic function to make the element blinks. In case of element visible,
if the logic function is TRUE, the element blinks; if the logic function is FALSE, the
element displays as fix label.
Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 71/88
DXTCAnimImage
This element can be used to show an animated image. E.g. a blowing fan, a shaking bell. The image could
be either a black & white image or a colored image. Double click the element can open and edit its
properties.
Select an image in the right window, and then click button can add it to the Image Sequence. Click
button can remove it from the Image Sequence. Then in the preview area, you will see the how will the
images animating.
Note: In the Image Sequence, the images can be all B/W images or all colored images, not possible for
mixture.
Locked on Scroll If checked, this image will display in every page of current stage with the same
position.
Black Color/White The color setting boxes are only visible when B/W image (marked with a red point
Color on the left top corner) selected.
For colored images, it is not possible to configure the Black Color and White Color.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 72/88
7.4.5.2 Conditions Page
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.
Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 73/88
DXTCSwitchVarLabel
This element can be used to show a switchable variable or switchable vocabulary. Double click the element
can open and edit its properties.
Locked on Scroll If checked, this image will display in every page of current stage with the same
position.
Alignment Select alignment type. Can be Left Justify, Right Justify or Center Justify.
Switch Mode Select the switch mode. It can be switch between variables or switch between
vocabularies.
Select Variable Select the variable for switching. Click button can open the Variables list.
Then select the variable needed. The next line is used for preview. For example,
it can be written as -10.10 or Unit ON.
Font Color & Allows setting the font color and the background color. If Disabled box is
Background Color unchecked, here can also set the Font Color pressed and Background Color
pressed. In this way, when user clicks this label, he can see the labels color
changed.
Font Allows selecting the font from the font list defined in the project option.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 74/88
7.4.6.2 Switch Sequence Page
This page will be shown differently depending on the switch mode, see the two graphs below:
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.
Element blink IF Here can set a logic function to make the element blinks. In case of element
visible, if the logic function is TRUE, the element blinks; if the logic function is
FALSE, the element displays as fix label.
Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 75/88
DXTCSwitchVarImage
This element can be used to show a switchable image. Double click the element can open and edit its
properties.
Locked on Scroll If checked, this image will display in every page of current stage with the
same position.
Select Variable Select the variable for switching. Click button can open the Variables list.
Then select the variable needed. The next line is used for preview.
Black Color & White Color Allows setting the color of B/W (Black/White) images. It is only visible when
B/W images are selected. If using colored images, this setting has no sense.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 76/88
7.4.7.2 Switch Sequence Page
On the right side of the window, it show all the images defined in image database.
Select an image, and click can add it to the switch sequence. Click can remove it from switch
sequence.
Once a B/W image selected, all the other images in the switch sequence should also be B/W images.
Once a colored image selected, all the other images in the switch sequence should also be colored images.
No mixture is allowed.
For example: Min = 1, Max = 2, Value = 4. Means if 1 <= Test1 <= 2, this element will show the image which
ID=4.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 77/88
DXTCShape
This element can be used to show a basic shape with specified color and type. Double click the element can
open and edit its properties.
Locked on Scroll If checked, this image will display in every page of current stage with the same
position.
Shape type Set the type of the shape. The available types are: Rectangle, Circle, Line Vertical,
Line Horizontal, Line Top Bottom, Line right left and Rectangle Rounded.
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.
Element blink IF Here can set a logic function to make the element blinks. In case of element visible,
if the logic function is TRUE, the element blinks; if the logic function is FALSE, the
element displays as fix label.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 78/88
DXTCButton
When needs to place a button on the screen, you can use this element. Double click the element can open
and edit its properties.
Locked on Scroll If checked, this button will display in every page of current stage with the same
position.
Caption The string typed here will be shown as the caption of the button. In addition, use
vocabulary could be another option. Note: If you want to select a B/W image for this
button display, the Caption must keep empty.
Font Allows selecting the font from the font list defined in the project option.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 79/88
7.4.9.2 Image Page
On the right side of this window, list all the images defined in the image database. Double click on one image
can set it display in the front of the button. Click Reset button can clean the selected image.
Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 80/88
7.4.9.4 Actions Page
Beep on pressed If checked, every time press this button, it will make a beep response.
Timeout Only if user keeps press this button for the seconds written in Timeout, then the
button action will be take effect actually.
In addition to the name of the key, it can be associated with the following functions:
Jumps to stage
Press passes to the stage selected
Active input
When pressing the button activates
the selected object.
Page UP
Press passes to the previous page
of the stage.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 81/88
Page DOWN
Press passes to the next stage.
Set Variables
Press enables writing the value of a
variable.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 82/88
Fast increment value
Press enables increase the value of
a variable. The new value will be
applied immediately without press
Active input button to confirm.
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 83/88
7.5 REMOTE BUTTON
There is a system variable SYS_VKEY at the address 0xFFF4 that manages the remote keys of Visotouch.
When the value of this variable is other than 0, ensure the keyboard performs the associated keys function.
Note: the remote key you want to perform must be implemented as part of the stage(s).
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 84/88
Execute/Set before Press enables writing the value of a variable.
jump
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 85/88
8. COMPILING AND DOWNLOADING PROJECT
8.1 COMPILING
Once you have completed the necessary changes to your project, you must run a build of the latter to find
any error or inconsistencies.
Filling is via the button in the toolbar and the debug log is visible in the actions list at the bottom.
Compile project
Hotkey: F9
If the compilation is successful, you will see all green check icons on the left of the actions list, otherwise you
will see the error jotifiche. To run the fixes just double click on the error and fix the bug.
At the end an entry will give us a run down on the number of warnings/errors in the project.
See the window below, on the left side, it shows the size of compiled items, including 4 Fonts size, images
size, variables size, vocabulary size and stages size.
On the right side, it shows the percentage of space used. If the percentage reaches 100%, means the
project is overloaded, it cant display properly.
Visotouch Limits
Dimensions:
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 86/88
Stage (1024 Kb)
The Viso works using pages, not stages.
If a stage has only 1 page stage and page are the same.
If a stage has e.g. 3 pages a stage is considered as 3 pages.
Etc.
A page can have max 200 elements and 300 variables.
Max 100 pages if every page has 200 elements and 300 variables.
If the number of elements per page decreases or/and if the number of variables per page decreases the
total number of page is > 100.
When the project is compiled, the generated files are visocor.hex and visores.hex. There are two ways to
download the project to the controller.
Hotkey: F10
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 87/88
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 88/88