0% found this document useful (0 votes)
1K views

LLT User Guide

This document provides an overview of the Local Loading Tool (LLT) software. It describes the installation process and requirements, the file structure of Telium terminals, and presents the main graphical interface of LLT. The interface includes features like browsing terminal content, viewing terminal details, transferring files, and monitoring connection status.

Uploaded by

Aleksandar
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
1K views

LLT User Guide

This document provides an overview of the Local Loading Tool (LLT) software. It describes the installation process and requirements, the file structure of Telium terminals, and presents the main graphical interface of LLT. The interface includes features like browsing terminal content, viewing terminal details, transferring files, and monitoring connection status.

Uploaded by

Aleksandar
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 29

LLT 5.

2
User guide
ICO-OPE-01834-V06

Security Tools team


2015-12-21

www.ingenico.com

28/32, boulevard de Grenelle, 75015 Paris - France / (T) +33 (0)1 58 01 80 00 / (F) +33 (0)1 58 01 91 35

Ingenico S.A. au capital de 53 086 309 / 317 218 758 RCS PARIS
Contents
1_ Global presentation ......................................................................... 3
1_1 What is new? ................................................................................................. 3
1_2 Telium file tree structure ................................................................................ 3
1_3 Declination of LLT modes .............................................................................. 4

2_ Installation ........................................................................................ 5
2_1 Configure the user language ........................................................................ 10

3_ Graphical interface presentation .................................................. 11


3_1 Definitions of terms ...................................................................................... 11
3_2 The local browser ......................................................................................... 12
3_3 The terminal browser ................................................................................... 15
3_3_1 Terminal activities ......................................................................................................... 18

3_4 Error message ............................................................................................. 18


3_5 Favorite paths .............................................................................................. 18
3_6 Plugged terminals view ................................................................................ 19
3_7 Transfer tasks view ...................................................................................... 20
3_8 Terminal observatory ................................................................................... 21
3_9 Installed components list .............................................................................. 22
3_10 File viewer ................................................................................................. 23
3_11 Actions history view ................................................................................... 24

4_ How to start a connection with the terminal ................................ 25


4_1 Perform the disconnection ........................................................................... 25

5_ Command line mode ...................................................................... 26


5_1 Command-line usage ................................................................................... 26

6_ Catalogue files format ................................................................... 29

2/29 LLT 5.2 / 2015-12-21


1_Global presentation
The Local Loading Tool (LLT) is a software application that allows exchanging information and files
between a PC and an Ingenico electronic payment terminal.

The LLT application provides the user with an access to the terminal content and details.
This tool allows to browse the terminal content, consult its characteristics, and retrieve the terminal life
counters.

The LLT can only run on Windows platforms. The following versions are compliant with LLT v5.2
(others versions are not officially supported):
32 bits 64 bits
Windows XP
Windows Vista
Windows Seven
Windows 8
Windows 8.1
Windows 10

For this LLT version, only one terminal connection is possible at a time.

1_1 What is new?


The version 5.1 of LLT was the first version which supports Telium 1, Telium 2 and Telium Tetra. It
constitutes a total renew of the previous application, including:
A fully integration into IngeDev in the form of a plugin
Offering an ergonomic standalone tool
An enhanced command-line mode, allowing easy integration with other software tools requiring
capabilities of download / upload
A new communication stack without any configuration required, that highly improves the user-
experience with a ready to connect solution

The Telium USB Jungo driver is bundled with LLT installation and is required for communication
operation.

1_2 Telium file tree structure


The Telium Tetra file tree structure is different from Telium 1 and 2. When the LLT browses the
terminal content, it works with a sand-box file system.

3/29 LLT 5.2 / 2015-12-21


/ Telium 1 and Telium 2 file tree

Directory Description
/HOST The parameters files must be downloaded into this directory.
This directory is called import in Telium Tetra terminals.
/SWAP The signed applications and components files must be downloaded into
this directory.
This directory is called package in Telium Tetra terminals.

All files downloaded in the /SWAP directory will be checked after changing the activity or after
disconnecting the LLT connection. A Bad signature error could appear if the component is not
properly signed.

/ Telium Tetra file tree

Directory Description
/config Contains the configuration files of the terminal.
/export This directory receives the non-sensible files from applications in the
terminal. These files aim to be locally uploaded for further analysis.
/import The parameters files must be downloaded into this directory.
This directory is called HOST in Telium 1 and Telium 2 terminals.
/log Contains system and applications logs files.
/package The application package files must be downloaded into this directory.
This directory is called SWAP in Telium 1 and Telium 2 terminals.

All files downloaded in the /package directory will be checked after disconnecting the LLT
connection. An INVALID_SIGNATURE error could appear if the package is not properly signed.
Thus, this incorrect package must be manually deleted from the /package directory.

If the package check passes when the terminal is disconnected, the package is installed into the
terminal.

1_3 Declination of LLT modes


The LLT application can be used through three modes:
Standalone application
Command-line mode
Perspective and plug-in integration into IngeDev

The standalone application and the Local Loading Tool perspective in IngeDev are identical.

4/29 LLT 5.2 / 2015-12-21


2_Installation
Launch the LLT_setup.exe program and follow the installation steps.

With Windows Vista, Seven or 8, the following message could appear:

Click Yes.

Choose your language in the combo-box and click OK.

Click Next to continue.

5/29 LLT 5.2 / 2015-12-21


Accept the agreement, and click Next.

Choose the destination path for the LLT installation and click Next.

6/29 LLT 5.2 / 2015-12-21


The list of supported terminal by the Telium USB Jungo driver is displayed for information. Select the
check-box if you want to install this driver.
Click Next to continue.

Select the shortcut location in the Start menu. Then click Next.

7/29 LLT 5.2 / 2015-12-21


Select whether you want a LLT desktop icon and click Next to continue.

This screen summarizes the installation process:

Click Install to start the copy of required LLT files.

8/29 LLT 5.2 / 2015-12-21


The installer window shows the files copy
progression.

The installation of the Telium USB Jungo


driver may take a few minutes. During this
period of time, the progress bar may not be
progressing.

A report message confirms the driver is


correctly installed.

www.ingenico.com

28/32, boulevard de Grenelle, 75015 Paris - France / (T) +33 (0)1 58 01 80 00 / (F) +33 (0)1 58 01 91 35

Ingenico S.A. au capital de 53 086 309 / 317 218 758 RCS PARIS
At the end of the installation process, this installer window confirms the installation is completed, and
proposes to launch LLT. Click Finish to close the installation program.

2_1 Configure the user language


By default, the user interface is in the same language as the current operating system. There are two
ways to change to another language.

In the shortcut properties, append to the command-line -nl en (to force English) or -nl fr (for
French) as following:

In order to apply the same language for all, create a file named jllt.ini in the installation directory
of the LLT, with the following content:
-vmargs
-Duser.language=fr

10/29 LLT 5.2 / 2015-12-21


3_Graphical interface presentation
The LLT can be used as standalone application or integrated in IngeDev via the
Local Loading Tool perspective.

In order to launch the standalone mode, click on the LLT shortcut on your desktop or in the Start
menu.
If you use Windows Vista, Windows Seven or Windows 8, you may be prompted to confirm the LLT
execution (by User Account Control). Click Yes to accept.

/ LLT perspective overview

The main view of the LLT software presents 2 parts:


The left side represents the local view of the PC
The right side is mainly related to terminals: it displays the list of available terminal devices, the
terminal browser and its corresponding files transfers

3_1 Definitions of terms


In this document is mentioned local browser and the terminal browser. If the single term
browser is used, it can refer either to the local browser or the terminal browser.
An item designates a file or a directory in the browser.
A catalogue file refers a list of files to be loaded. This particular file is used to ease downloads for
Telium 1 and Telium 2 products (see 6_Catalogue files format for more details).
A container file is a file that contains files or refers a list of files. For the moment, only the
catalogue files are handled as container files.

11/29 LLT 5.2 / 2015-12-21


3_2 The local browser
The Local browser view is usually displayed on the left side. It displays the computer drives content
and eventually mapped network drives.
12 10 9

1 24
4
2

5 6 7 8

Full context menu:


12
13
14
15

24

12/29 LLT 5.2 / 2015-12-21


/ Legend
# Element Description Action / details
1 Path bar Display the path of the current Change the path bar value to directly
directory displayed in the browser. browse the input path. Validate your input
by pressing the Enter key, or leave focus
from the path bar.
The path bar is case-sensitive.
2 Tree panel The tree panel of the browser Select a directory or a container file in order
displays: to view its content, or to execute an action
Only the directory and the on it.
container files, if the detail panel is If files are present, actions on files are also
shown; available.
All files and directories, if the
detail panel is hidden.
3 Detail panel The detail panel of the browser Select one (or more) file or directory for
provide more information about files details, or to execute an action on it.
of the selected directory or container This panel can be hidden (see #9).
file (in the tree panel).
4 Filter Filter the files and directories in the The filter is applied on the text field value
detail panel. change.
In order to view a file or a directory, its
filename must contain (anywhere) the value
of the filter field. The search is not case-
sensitive.
Funnel button: filter containers Click on this icon to enable/disable the
according to the terminals product automatic filter. When enabled, catalogue
code. files are filtered according to the active
terminal connection (product code).
5 Available Display the available drive space of When the mouse pointer passes over this
disk space the selection. label, the disk space usage is shown and a
tooltip specifies the available space / total
space.
6 Number of Display the number of visible items
visible items in the current directory or container
file.
7 Selected Display the number of selected items
items in the detail panel, and the total size.
8 Last action Display the status of the last action. A double-click on this label shows the
status Errors are in red colour, warnings in Actions history view.
orange and regular messages in
black.
9 Additional Display additional commands. Additional commands of the Local browser:
commands Actions history: show the Action history
view for the local browser
Switch the details: show or hide the detail
panel (see #2 and #3)
Help contents: display the help contents
About LLT: display the current LLT
version

13/29 LLT 5.2 / 2015-12-21


10 Refresh Refresh the browser content,
particularly needed when an item
has been modified out of the LLT
software.
12 Download Download the selected item to the This action is available from the toolbar,
terminal. from the contextual menu on a selection
(right-click), or by pressing the shortcut key
Alt+T.
Arrow menu of the icon: change the Available destination modes:
download destination mode Manual destination: the destination is the
current directory, or for drag & drop the
designated directory
Automatic destination: the destination is
determined by the extension of files to
download. Using the drag & drop will
display the predicted destination(s).
13 Create Create a folder in the current This action is available from the contextual
folder directory. menu (right-click), or by pressing the
shortcut key Ctrl+Alt+N.
14 Delete Delete the selected files or This action is available from the contextual
directories. menu (right-click), or by pressing the
shortcut key Del.
15 Rename Rename the selected file or This action is available from the contextual
directory. menu (right-click), or by pressing the
shortcut key F2.
24 Add to Add and open the list of favorite At click, a popup window is displayed with
favorites paths. the list of saved paths (a left-click adds the
current path, other buttons only open it).
For more details, see 3_5 Favorite paths.

14/29 LLT 5.2 / 2015-12-21


3_3 The terminal browser
The Terminal browser view is commonly displayed on the right hand side. It shows the terminal
content.

12 11 19 25 20 21 10

22

23

1 24
4

6 7 8

16 17 18

Full context-menu:
12
13
14

24

15/29 LLT 5.2 / 2015-12-21


/ Legend
# Element Description Action / details
1 Path bar Display the path of the current Change the path bar value to directly
directory displayed in the browser. browse the input path. Validate your input
by pressing the Enter key, or leave focus
from the path bar.
The path bar is case-sensitive.
2 Tree panel The tree panel of the browser Select a directory or a container file in order
displays: to view its content, or to execute an action
Only the directory and the on it.
container files, if the detail panel is If files are present, actions on files are also
shown; available.
All files and directories, if the
detail panel is hidden.
3 Detail panel The detail panel of the browser Select one (or more) file or directory for
provides details on files of the details, or to execute an action on it.
selected directory or container file (in This panel can be hidden (see #25).
the tree panel).
4 Filter Filter the files and directories in the The filter is applied on the text field value
detail panel. change.
In order to view a file or a directory, its
filename must contain (anywhere) the value
of the filter field. The search is not case-
sensitive.
6 Number of Display the number of visible items
visible items in the current directory or container
file.
7 Selected Display the number of selected items
items in the detail panel, and the total size.
8 Last action Display the status of the last action. A double-click on this label shows the
status Errors are in red colour, warnings in Actions history view.
orange and regular messages in
black.
10 Refresh Refresh the browser content,
particularly needed when an item
has been modified out of the LLT
software.
11 Force Force uppercases of filename for When this option is selected, the filenames
uppercases download. of the downloaded files are in uppercases.
12 Upload Upload the selected item from the This action is available from the toolbar,
terminal to the selected directory in from the contextual menu on a selection
the local browser. (right-click), or by pressing the shortcut key
Alt+T.
13 Create Create a folder in the current This action is available from the contextual
folder directory. menu (right-click), or by pressing the
shortcut key Ctrl+Alt+N.
14 Delete Delete the selected files or This action is available from the contextual
directories. menu (right-click), or by pressing the
shortcut key Del.

16/29 LLT 5.2 / 2015-12-21


16 Transfer This panel establishes a list of the In the case of download:
task panel download and upload tasks. For The local file denotes the original file
each transfer task, the local file or The direction is a right direction arrow (in
directory, the direction, the terminal turquoise blue if the task is transferring,
file or directory, and the progression otherwise in grey)
are displayed. The terminal file denotes the destination
directory

In the case of upload:


The local file denotes the destination
directory
The direction is a left direction arrow (in
yellow if the task is transferring,
otherwise in grey)
The terminal file denotes the source file

For further details, see the 3_7 Transfer


tasks view section.
17 Bring on top If this option is activated, the current Clicking this button to enable or disable the
transfer transfer task is kept visible. option.
events
18 Clean Clean all terminated transfer tasks
complete and errors
transfers
19 Show the Show the Action history view for the
actions current terminal connection.
history
20 Show the Report information regarding the For more details, see the section
terminal connected terminal. 3_8 Terminal observatory.
information
21 Show the Show the list of the installed For more details, see the section
installed components in the terminal, and 3_9 Installed components list.
components allow uninstalling them.
22 Terminal tab Each terminal connection appears in Closing a terminal tab automatically commit
a dedicated tab. the transfer transaction and close the
Its icon reflects the connection state connection with this terminal.
(connected or disconnected) and the
label is the serial port name used for
the connection.
23 Terminal The terminal status bar gives A double-clicks on the terminal status bar
status information about the current will toggle its state: switching it to
terminal state, and also some connected, or disconnecting it.
identifiers of this terminal.
24 Add to Add and open the list of favorite At click, a popup window is displayed with
favorites paths. the list of saved paths (a left-click adds the
current path, other buttons only open it).
For more details, see 3_5 Favorite paths.
25 Toggle the Show or hide the detail panel (see
details #2 and #3).

17/29 LLT 5.2 / 2015-12-21


3_3_1 Terminal activities
When browsing a Telium 1 or a Telium 2 terminal, it is possible to switch from a terminal activity to
another.
The activities bring different views of the terminal content, depending on the use-case.

The activity menu is not available for Telium Tetra terminal.


Under the corresponding icon-menu, the current activity is checked. Select the desired activity to
switch the navigation mode.

3_4 Error message


If an error occurs, the error message appears in the status bar of the browser.

This error is also displayed in an error balloon message. Click on it in order to hide it.

All error messages are logged into the Actions history view (see section 3_11).

3_5 Favorite paths


Clicking the star at the right hand of the browsers path-bar (a left-click adds the current path, other
buttons only open it), or using the contextual menu Add to favorites (#24) on a directory or a
container, displays the list of favorite paths:

26
27

28

29 30

Clicking the biggest star adds or removes the current path from the list (#26).
Double-clicking on a selection in the favorites list opens a favorite path.

18/29 LLT 5.2 / 2015-12-21


/ Legend
# Element Description
26 Favorite switch Add or remove the current path from the favorites.

27 Filter Filter the paths in the list. To be listed, the path must contain the value
of the filter field. The search is not case-sensitive.
28 Saved paths list The list of favorite paths. The item - User home directory - is related
to the current user, for the local browser.
29 Remove Remove the selected path from the list of favorites.

30 Open Open and browse the selected path.

3_6 Plugged terminals view


The Plugged terminals view provides a list of the plugged terminals to the PC.

The device port identifies the plugged terminal. This device port is displayed on the terminal tab.
The connection state is illustrated by a label and/or a characteristic icon.
The Description column reveals the name of the previous connected terminal on this port, and the
Identifier gives the device or the terminal identifiers (composed by the product number and its serial
number).

A double-clicks on a terminal or pressing the Enter key (when selected) toggle its state: switching it to
connected, or disconnecting it.

At terminal connection, a new tab is opened with the terminal browser. The current directory is set on
the last accessed directory for the device port.

When a tab corresponding to this terminal is already opened, this tab is activated when the terminal is
selected in the plugged terminals list.

/ Terminal states
Icon Current state

Disconnected

Connecting

Connected

Disconnecting

19/29 LLT 5.2 / 2015-12-21


3_7 Transfer tasks view
The transfer tasks view gives an overview of all transfer tasks (downloads and uploads) of all terminal
connections.

For each transfer task the local file or directory, the direction, the terminal file or directory, the
concerned device, and the progression are displayed.

In the case of download:


The local file denotes the origin file
The direction is a right arrow (in turquoise blue if the task is transferring, otherwise in grey)
The terminal file denotes the destination directory

In the case of upload:


The local file denotes the destination directory
The direction is a left arrow (in yellow if the task is transferring, otherwise in grey)
The terminal file denotes the source file

18

/ Legend
# Element Description Action / details
18 Clean Clean all terminated transfer tasks
complete and errors
transfers

When an error occurs during a transfer, the progress-bar background is in red color, and the reason is
displayed.

Passing the mouse over the progress-bar gives the full error message:

20/29 LLT 5.2 / 2015-12-21


3_8 Terminal observatory
The terminal observatory provides a report page describing all available information about the
connected terminal.
Those data are mainly terminal identifiers details and hardware characteristics.

The Observatory of terminal view is called from the icon of the Terminal browser.

31 32

/ Legend
# Element Description
31 Filter Filter the terminal properties

32 Copy Copy to the Windows clipboard the terminal information.

21/29 LLT 5.2 / 2015-12-21


3_9 Installed components list
The Installed components view lists all installed packages and components in the terminal.
This list can be called from the icon of the Terminal browser. Its presentation slightly differs
depending on the terminal range:

/ Telium Tetra terminals


33

34

35

36
At the terminal disconnection, all selected components (including hidden ones by a filter) are marked
to be uninstalled.

You can check this operation in the Actions history view of the corresponding terminal connection (see
the section 3_11 Actions history view).
In the case of success, each selected component should trace:
"package_filename" marked for uninstallation

/ Telium 1 and Telium 2 terminals

34 33

35

The list of installed components is only available in the Download and Maintenance activities.
The uninstallation of components is impossible for Telium 1 and Telium 2 terminals.

22/29 LLT 5.2 / 2015-12-21


/ Legend
# Element Description
33 Copy Copy to the Windows clipboard the entire components list.

34 Filter the installed The filter is applied on the text field value change.
components list In order to view an installed component, its Filename, its Friendly name* or
its Full identifier must contain (anywhere) the value of the filter field.
The search is not case-sensitive.
35 List of installed Each row of this list describes the:
components Component type: only Applications, Libraries and Parameters can be
selected in order to be uninstalled*
Friendly name
Version: composed by Major, Minor and Maintenance revision* values
Domain*
Package range* known as Full identifier
Package identifier
CRC
Filename: the original filename of the component
: This component is not selected*
: This component is selected*
: This component is not selectable for uninstallation*
36 Uninstall button* This button saves the selected components list, in order to uninstall them at
the next terminal disconnection.
Clicking this button closes the Installed component list. This list can be
displayed again and can be modified before the uninstallation.
The number of selected components is indicated on the button label.
In case no item is selected, this button simply closes the list.
*: theses information are only available for Telium Tetra terminals.

3_10 File viewer


The file viewer allows consulting only the local files content.
Double-clicking on a file (or pressing the Enter key after selection) in the local browser opens a new
tab with the file content.

In some files (especially binary files), the null characters are represented by a dot sign ( . ).

23/29 LLT 5.2 / 2015-12-21


3_11 Actions history view
This view is reporting the history of past actions.
Errors are in the red colour, warnings in orange and regular messages in black.

The Action history view can be called by double-clicking in the status-bar of the file browser (#8), or
using the icon from the toolbar (#19).
37 38

39

40

/ Legend
# Element Description
37 Copy Copy the actions history in the Windows clipboard.

38 Clear logs Clear the logs list.

39 Connection selector Choose the history connection to display the actions.


The Local actions is related to the Local browser actions.
40 Events list Displays the list of past actions, within two columns: the date and
the event.

24/29 LLT 5.2 / 2015-12-21


4_How to start a connection with the terminal

LLT

Please make sure the terminal is properly plugged to the computer: the terminal is connected by the
USB cable and must be recognized by Windows in the Device manager, under COM port devices.
Launch the LLT software using the shortcut in the Start menu or from the desktop.
Before connecting the terminal with LLT, the loading session must be started on the terminal. In
order to start the LLTCLIENT application on the terminal, depending on the terminal Telium range:
o For Telium 1 and Telium 2:
restart the terminal and keep pressing (usually) the F3 (or UP) key on the terminal until the
word LLT appears on the screen
or use the graphical menu (press F key, then Telium Manager > Evolution > Load > Local)
o For Telium Tetra:
restart the terminal and keep pressing the . (dot) key on the terminal until a folder icon
appears on the screen
or use the graphical menu (Control panel > Software management > Evolution >
Local upgrade)
In the LLT software Plugged terminal view (see 3_6 Plugged terminals view), the terminal must
appear. Double-click on the terminal icon start the connection attempt. The terminal state reports
the terminal connection status. If the terminal is correctly connected, download or upload can be
performed and terminal information can be gathered.

4_1 Perform the disconnection


In order to disconnect a terminal from LLT, double-click on the terminal status label (see #23 in
3_3 The terminal browser) or the corresponding connection in the Plugged terminal view (see
3_6 Plugged terminals view).

The disconnection of LLT is required to validate and install the downloaded files into the terminal. The
terminal then restarts in order to take the changes into account.

For Telium 1 and Telium 2 terminal, the validation of downloaded components is also performed at
terminal activity change (see 3_3_1 Terminal activities).

25/29 LLT 5.2 / 2015-12-21


5_Command line mode
The command-line mode allows downloading, uploading and deleting files.
To use the command-line, use the cmdLine.bat script provided at the LLT root installation directory.

5_1 Command-line usage


The command-line usage can be consulted when typing:

/ Calling the command-line help


C:\Program Files\Ingenico\LLT>cmdLine.bat

Usage:
cmdLine [/q] [/v] [/p port] load_scenario_location [target_name]

/q: (optional) quiet mode, no pause during the script execution


/v: (optional) verbose mode, shows additional logs on error
/p port: (optional) specify the serial port name to use for the terminal
connection, if it is not specified into the scenario
load_scenario_location: the load scenario file to process
("C:\LLT\MyScripts\load.xml" for example)
target_name: (optional) the name of the target section of the scenario
file to process. If not present the default target will be executed.

Appuyez sur une touche pour continuer...

Note that the load_scenario uses the ANT standard. Hence, the commands provided with LLT can
be extended by other ANT commands and libraries.

Youll find further documentation at the following address: http://ant.apache.org/manual/index.html

/ Calling the cmdLine.bat


C:\Program Files\Ingenico\LLT>cmdLine.bat "sample.xml"

26/29 LLT 5.2 / 2015-12-21


/ Sample script of the loading scenario
<?xml version = "1.0" encoding = "ISO-8859-1"?>
<project
name = "Loader"
basedir = "."
default = "loaderT2">
<!-- For Telium TERTA terminals -->
<target name = "loaderTETRA">
<jllt.commandLineTask
action = "terminals"
target = "C:\\Terminals.txt" />
<jllt.commandLineTask
action = "connect" />
<jllt.commandLineTask
action = "query"
property = "Manufacturing code"
target = "C:\\Manufacturing code.txt" />
<jllt.commandLineTask
action = "download"
source = "C:\\FILE_TETRA.TXT" />
<jllt.commandLineTask
action = "upload"
source = "/config/HTERMINAL.INI"
target = "C:\\" />
<jllt.commandLineTask
action = "delete"
target = "/import/FILE_TETRA.TXT" />
<jllt.commandLineTask
action = "disconnect" />
</target>
<!-- For Telium 2 terminals -->
<target name = "loaderT2">
<jllt.commandLineTask
action = "connect"
device = "COM12" />
<jllt.commandLineTask
action = "terminals"
target = "C:\\Terminals.txt" />
<jllt.commandLineTask
action = "download"
source = "C:\\FILE_T2.TXT"
target = "/HOST/" />
<jllt.commandLineTask
action = "download"
source = "..\\MyApp\\8440140201.M40" />
<jllt.commandLineTask
action = "activity"
mode = "maintenance" />
<jllt.commandLineTask
action = "upload"
source = "/SWAP/APPRESET.DIA"
target = "D:\\" />
<jllt.commandLineTask
action = "disconnect" />
</target>
</project>

27/29 LLT 5.2 / 2015-12-21


/ Parameters details
action = Parameters Description
"terminals" target = "target_file" target_file is the optional full path of the file
that receives the terminals list; for example:
target="C:\\Terminals.txt"
This command produces for each plugged terminal
the following information, separated with tabulation:
Port Range Description State
This command can be called if a terminal is
connected or not.
"connect" device = "device_name" device_name is the name of the device to
connect; for example: device="COM3"
If the device isnt specified, the first plugged
terminal is used.
"download" source = "source_file" source_file is the full path with filename of the
file to download (from the local browser). It can be,
or not, a catalogue file. The path must contains
doubled slashed \ characters; for example:
source="C:\\MyDir\\FILE.TXT"
target = "target_file" target_file is the full path of the directory or the
target file that receives the downloaded file; for
example:
target="/import/"
or
target="/import/destFile.bin"
If the target isnt specified, the destination is
automatically predicted depending on the source
extension.
"upload" source = "source_file" source_file is the full path with filename of the
file to upload (from the terminal); for instance:
source="/config/HTERMINAL.INI"
target = "target_file" target_file is the full path of the directory or the
target file that receives the downloaded file. The
path must contain doubled slashed \ characters;
for example:
target="C:\\"
or
target="C:\\destFile.bin"
If the target isnt specified, the previous specified
local target is re-used.
"delete" target = "target_file" target_file is the full path of the file to delete in
the terminal, or the filename of the package to
uninstall; for example:
target="/import/FILE.TXT"
or
target="9990019010084000_MyApp.P3A"

28/29 LLT 5.2 / 2015-12-21


"query" property = "key" key is the property key to request, it is case
sensitive. Available keys are listed through the
Terminal observatory (see the section 3_8); for
instance:
property = "DISPLAY/WIDTH"
target = "target_file" target_file is the full path of the file that
receives the value of the requested property; for
instance: target = "C:\\Display.txt"
"activity" mode = "activity" activity is the requested terminal activity;
available values are (case insensitive):
download
diagnostic
maintenance
"disconnect" The download transaction is committed for the
current terminal connection. Then the terminal is
disconnected.

6_Catalogue files format


The catalogue is a file which references a list of files to be downloaded in the terminal.

A catalogue file extension form is .Mnn form, where nn represents the product code of the target
terminals (two digits). These catalogue files can be automatically filtered with the funnel button of the
Local browser (see 3_2 section, #4).
All terminals can be targeted using the .MXX catalogue file-extension.

The syntax is simple: each line points out a file in an absolute or a relative path. The comments are
preceded by a ;.

/ Sample catalogue file


; Comment of the catalogue file Comment

C:\absolute PATH\to the\File.txt Download File.txt into the current path in the
terminal
-eSWAP Change the download destination to /SWAP/

..\8440140201.AGN The file to be downloaded is in the parent


directory of the catalogue file
8440140201.PGN Download this file from the same directory of the
catalogue file
-eHOST Change the download destination to /HOST/

D:\APPCONFIG.CFG ; Custom config File given in absolute path followed by with a


comment

Generally speaking, the referenced files are downloaded in the current directory of the terminal, but it
is possible to denote a destination directory by preceding the absolute path in the terminal by -e
(see possible destinations at 1_2 Telium file tree structure).

29/29 LLT 5.2 / 2015-12-21

You might also like