General Information........................................................................................................................................................................ 4
Menu bar..............................................................................................................................................................................................5
General tab window......................................................................................................................................................................11
Configuration file upload to TFT...............................................................................................................................................29
IKUGRAPH is a desktop application for Windows systems. This application is a user interface design tool
to create definitions of the set of windows to use in the embedded equipment distributed by Danfoss
RCT.
This document contains the full description of the interface and functionality included in the IKUGRAPH
application. Each xml file represents one project and can contain many elements (windows, text, value,
etc). The different elements that can be used are described in the document API_Ikugraph_v14.docx
•
To launch the application, run this executable: Ikusi.Ikugraph.Desktop.exe
•
To create a new project, select File > New from the menu bar.
•
To load an existing project, select File > Open from the menu bar.
Overview
The Ikugraph user interface is made up of five primary areas: Menu and Navigation bars, Canvas, Toolbox
and Properties panels.
The Toolbox Panel is the long strip of UI controls in the left part of the window. It lists all of the UI control
types that can be used in the design.
The main goal of the Toolbox Panel is to let you add UI controls to the canvas. To add a new UI control to
the canvas, select the control type you wish to add then either drag it to the central canvas.
Navigator bar
The Toolbox panel can be toggled on and off in several ways:
•
clicking the icon X to the right of the panel (hide panel),
•
using the toggle option (minimize panel), or
•
by selecting View > Toolbox from the application menu (hide/show panel).
The navigator bar below toolbar shows the list of windows in your project.
The currently visible window is highlighted. The window with the “Visibility” property set to 1 is bordered
with a yellow square.
The + button in the right side adds a new window to the project.
This is the main working area of the designer. Once you add UI controls to it, you can move them, resize
them and tweak them until your UI design is ready.
To move items, it can be used the drag and drop option (by clicking the item to move and drag&drop it),
or select the item and move it with the scroll keys of the keyboard.
You can select an item in the canvas by clicking it, moving between items with the tab key or selecting
the item in the control list in the Window tab in properties panel.
To remove a window, use the Delete button in the Window properties panel.
The size of the window canvas is fixed, but it can be extended with a zoom option by clicking Ctrl +
The panel on the right side of the application (when shown) displays properties for the current project,
selected window or control.
General, Window and Control properties panels
Depending on which control is selected it shows different properties.
It can be hidden by de-selecting both General, Window and Control in the View menu. It can be toggled
identifier for the element or window. It must be unique in the project. The
application generates a default value, and it can be changed using the Change ID
button in the properties panel.
description name for the element or window. This property won’t be sent to the
device.
it contains the list with the project’s windows in which the element is visible. You
can add a new window with the + button.
it defines if the element is visible or not in the window.
position for the element in the window.
the element size.
background color for the window.
text color.
it defines if the text of the element can be changed in the device.
number of characters of the text.
text to show.
font to use for the text.
The Value control shows a numeric value inside a little square. Size and background and text colors are
configurable.
Value panelDescription
ObjectID
Name
Windows
Visibility
XPos – YPos
XSize – Ysize
BkColor
TextColor
Font
Reseteable
BytesPerValue
DotPosition
PromptLength
Min
Max
VariablesType
identifier for the element or window. It must be unique in the project. The
application generates a default value, and it can be changed using the
Change ID button in the properties panel.
description name for the element or window. This property won’t be sent to
the device.
it contains the list with the project’s windows in which the element is visible.
You can add a new window with the + button.
it defines if the element is visible or not in the window.
position for the element in the window.
the element size.
background color for the window.
text color for the number printed.
font to use for the text.
it defines if the text of the element can be changed in the device.
Number of bytes to represent the value data
position in the value of the dot character.
length for the printed value
minimum value
maximum value
0 = unsigned value, 1 = signed value.
The progress bar control shows a square bar with two zones with different colors, and a text in the middle
(only horizontal types). Empty and full part colors are configurable, apart from the color of the text.
There are four progress bar types:
•
Type 0: horizontal, from left to right
•
Type 1: horizontal, from right to left
•
Type 2: vertical, from down to up
•
Type 3: vertical, from up to down
ProgressBar panelDescription
ObjectID
Name
Windows
Visibility
XPos – YPos
XSize – Ysize
Type
LeftBkColor
RightBkColor
LeftTextColor
RightTextColor
Reseteable
Min
Max
Text
identifier for the element or window. It must be unique in the project. The
application generates a default value, and it can be changed using the ChangeID button in the properties panel.
description name for the element or window. This property won’t be sent to the
device.
it contains the list with the project’s windows in which the element is visible. You
can add a new window with the + button.
it defines if the window is visible by default in the device. Only one window can
set Visibility = 1 in the project.
position for the element in the window.
the element size.
a type of bar.
back color for the full part.
back color for the empty part.
text color for the full part.
text color for the empty part.
it defines if the text of the element can be changed in the device.
minimum value
maximum value
a fixed text to show instead value. It’s only visible in the horizontal bars.
identifier for the element or window. It must be unique in the project. The
application generates a default value, and it can be changed using the ChangeID button in the properties panel.
description name for the element or window. This property won’t be sent to
the device.
it contains the list with the project’s windows in which the element is visible.
You can add a new window with the + button.
it defines if the window is visible by default in the device. Only one window
can set Visibility = 1 in the project.
position for the element in the window.
the element size.
value of rotation for the image. Only value 0 is admitted.
type of image.
binary content of image. You can change the image with the Change image
button.
this button shows the explorer to select a new image.
not modifiable value, calculated from the selected image. Number of bytes for
the image.
this button change the image’s position in the XML/TMC file.
this button change the image’s position in the XML/TMC file.
identifier for the element or window. It must be unique in the project. The
application generates a default value, and it can be changed using the
Change ID button in the properties panel.
description name for the element or window. This property won’t be sent
to the device.
it contains the list with the project’s windows in which the element is
visible. You can add a new window with the + button.
it defines if the window is visible by default in the device. Only one window
can set Visibility = 1 in the project.
position for the element in the window.
the element size.
background color for the window.
text color for the number printed.
back color for the selected element.
back color if an icon acts as a disabled option.
open the icon’s configuration window. The icon’s properties are:
• XSize – Ysize – size for the icon.
• Prompt – text to show under the icon
• PromptLength – length for the text.
• Image – id for the icon.
• Size – size in bytes for the loaded image.
• NextLevelIds – windows ids for navigation on pressed icon.
To add or remove icons to/from the control, click in the button in the Icons property.
MenuItem Icons, Selected Icon properties
+click the + button to add a new element.
Image listThe element shows the configured icons that can be used.
The Input control shows a little square with up – down arrows button, and contains a numeric value.
Input panelDescription
ObjectID
Name
Windows
Visibility
XPos – YPos
XSize – Ysize
BkColor
TextColor
SelectionBkColor
Font
BytesPerValue
Min
Max
VariablesType
identifier for the element or window. It must be unique in the project. The
application generates a default value, and it can be changed using the
Change ID button in the properties panel.
description name for the element or window. This property won’t be sent
to the device.
it contains the list with the project’s windows in which the element is
visible. You can add a new window with the + button.
it defines if the element is visible or not in the window.
position for the element in the window.
the element size.
background color for the window.
text color for the number printed.
back color for the selected element.
font to use for the text.
Number of bytes to represent the value data
minimum value
maximum value
0 = unsigned value, 1 = signed value.
The IconArray element shows a group of images. In the device, it allows changing the visibility of more
than one icon in only one command. A mask will be used to hide or show icons, associating each bit to
one icon.
identifier for the element or window. It must be unique in the project. The
application generates a default value, and it can be changed using the Change ID
button in the properties panel.
description name for the element or window. This property won’t be sent to the
device.
it contains the list with the project’s windows in which the element is visible. You
can add a new window with the + button.
it defines if the element is visible or not in the window.
position for the element in the window.
the element size.
it defines if the text of the element can be changed in the device.
open the icon’s configuration window. The icon’s properties are:
• XPos – YPos – position for the icon.
• XSize – Ysize – size for the icon.
• Visibility – the icon is visible or not.
• Image – id for the icon.
• Size – size in bytes for the loaded image.
• NextLevelIds – windows ids for navigation on pressed icon.
• Icon – binary content for the icon. Can be changed with Change icon button.
• Size – size in bytes for binary data.
To change the icon configuration click in … button in the Icons property.
identifier for the element or window. It must be unique in the project. The
application generates a default value, and it can be changed using the
Change ID button in the properties panel.
description name for the element or window. This property won’t be sent to
the device.
it defines if the element is visible or not in the window.
position for the element in the window.
the element size.
background color for the window.
back color for the selected element.
parent’s menu ID.
font to use for the text.
values for menu elements. Text element’s properties are:
Prompt
Length
NextLevelId
click this button next to Texts label to edit text elements.
text to show.
number of characters of the text.
ID for next menu element.
+click the + button to add a new element.
Deleteclick this button to remove the element.
Acceptclick this button to modify the elements property.
Cancelclick this button to cancel the modifications.
identifier for the element or window. It must be unique in the project. The
application generates a default value, and it can be changed using the ChangeID button in the properties panel.
description name for the element or window. This property won’t be sent to the
device.
it contains the list with the project’s windows in which the element is visible. You
can add a new window with the + button.
it defines if the element is visible or not in the window.
position for the element in the window.
the element size.
index for the visible image between the loaded images.
loaded images in the container. You can add a new image with the + button. To
delete an image use Remove button in the image row. To edit an image, use Edit
button.
The FileText control shows the content of a text file in a square. Size and text and background colors are
configurable. All text strings will be stored in the display, and only the index of the string to be shown will
be send from the PLC.
FileText panelDescription
ObjectID
Name
Windows
Visibility
XPos – YPos
XSize – Ysize
BkColor
FColor
Font
Reseteable
Text items
identifier for the element or window. It must be unique in the project. The
application generates a default value, and it can be changed using the Change ID
button in the properties panel.
description name for the element or window. This property won’t be sent to the
device.
it contains the list with the project’s windows in which the element is visible. You
can add a new window with the + button.
it defines if the element is visible or not in the window.
position for the element in the window.
the element size.
background color for the window.
text color.
font to use for the text.
it defines if the text of the element can be changed in the device.
the list of elements to save in the file text.
You can add a new text item with the + button.
To delete a text item use Remove button in the image row.
The ImageTextCombo control shows a text area joined with an image area. It is used to build pairs of
images and text items. It stablishes a relationship between an image file and a text file, allowing the user
to define pairs of two items, one from each file.
identifier for the element or window. It must be unique in the project.
The application generates a default value, and it can be changed using
the Change ID button in the properties panel.
description name for the element or window. This property won’t be sent
to the device.
it contains the list with the project’s windows in which the element is
visible. You can add a new window with the + button.
it defines if the element is visible or not in the window.
position for the element in the window.
the element size.
font to use for the text.
it defines if the text of the element can be changed in the device.
position for the text element to show.
text element’s size.
position for the image element to show.
ID of the TextFile control to use to get the text elements.
ID of the ImageFile control to use to get the image elements.
definition for relationships between text and image. For each possibility
the properties are:
TextIndex
ImageIndex
Visibility
index for the text in the text file (row)
index for the image in the ImageFile
the element is show by default or not.
You can add a new element in the combo list by + button; use the Deletebutton to remove the element.
Background image and needle are configured or design by the user and all the management information
is included in the configuration file (variables length, range, etc.).
The speedometer control shows an element similar to this icon.
ObjectID identifier for the element or window. It must be unique in the project. The application
generates a default value, and it can be changed using the Change ID button in the
properties panel.
Namedescription name for the element or window. This property won’t be sent to the device.
Windows it contains the list with the project’s windows in which the element is visible. You can add a
new window with the + button.
Visibility it defines if the element is visible or not in the window.
Valueproperties for the value element content by the speedometer:
XPos – YPosposition for the element in the window.
XSize – Ysizethe element size.
Reseteableit defines if the text of the element can be changed in the device.
BytesPerValueNumber of bytes to represent the value data
AnalogSetPoint1, 2
DotsPosition1, 2
BkColorbackground color for the window.
FColortext color.
Lengthnumber of characters of the text.
Fontfont to use for the text.
Reseteableit defines if the text of the element can be changed in the device.
We need to know the COM port assigned to the device.
Go to More Bluetooth options > COM Ports > COM6.
Check for the Outgoing assigned COM Ports.
6. Send the configuration to the screen; the transmitter should be powered ON.
Danfoss recommends the TFT at Bluetooth screen showing the address to avoid going to power
saving mode.
Open F2B tool > Select the file (*.ik, *.xml or *.tmc) > Select the outgoing COM port (COM6 in this
example).
Check the box in order to upload images.
Do not check the box, if only modifying object properties from an already uploaded configuration
(for example: object size, value object “bytespervalue”, etc.).
After finishing the new configuration upload, restart the transmitter to allow the TFT loading the new
configuration.
If the uploaded configuration was OK, there will be a CRANE label at the screen and after linking with
the receiver, there will be a configured MAIN window.
2800 East 13th Street
Ames, IA 50010, USA
Phone: +1 515 239 6000
Danfoss
Power Solutions Trading
(Shanghai) Co., Ltd.
Building #22, No. 1000 Jin Hai Rd
Jin Qiao, Pudong New District
Shanghai, China 201206
Phone: +86 21 3418 5200
Products we offer:
Hydro-Gear
www.hydro-gear.com
Daikin-Sauer-Danfoss
www.daikin-sauer-danfoss.com
DCV directional control
•
valves
Electric converters
•
Electric machines
•
Electric motors
•
Hydrostatic motors
•
Hydrostatic pumps
•
Orbital motors
•
PLUS+1® controllers
•
PLUS+1® displays
•
PLUS+1® joysticks and
•
pedals
PLUS+1® operator
•
interfaces
PLUS+1® sensors
•
PLUS+1® software
•
PLUS+1® software services,
•
support and training
Position controls and
•
sensors
PVG proportional valves
•
Steering components and
•
systems
Telematics
•
Danfoss Power Solutions is a global manufacturer and supplier of high-quality hydraulic and
electric components. We specialize in providing state-of-the-art technology and solutions
that excel in the harsh operating conditions of the mobile off-highway market as well as the
marine sector. Building on our extensive applications expertise, we work closely with you to
ensure exceptional performance for a broad range of applications. We help you and other
customers around the world speed up system development, reduce costs and bring vehicles
and vessels to market faster.
Danfoss Power Solutions – your strongest partner in mobile hydraulics and mobile
electrification.
Go to www.danfoss.com for further product information.
We offer you expert worldwide support for ensuring the best possible solutions for
outstanding performance. And with an extensive network of Global Service Partners, we also
provide you with comprehensive global service for all of our components.
Local address:
Danfoss can accept no responsibility for possible errors in catalogues, brochures and other printed material. Danfoss reserves the right to alter its products without notice. This also applies to products
already on order provided that such alterations can be made without subsequent changes being necessary in specifications already agreed.
All trademarks in this material are property of the respective companies. Danfoss and the Danfoss logotype are trademarks of Danfoss A/S. All rights reserved.