Scribd
Upload
16 views5 pages

Tuner4TRONIC CMD User Manual v2.4

The Tuner4TRONIC Command Line Application (T4T-CMD) allows users to program OSRAM ECGs using production files through a command line interface. The guide includes installation instructions, command usage, and error codes for troubleshooting. It emphasizes that the responsibility for testing and application remains with the luminaire manufacturer or planner.

Uploaded by

julia.krol
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
16 views5 pages

Tuner4TRONIC CMD User Manual v2.4

The Tuner4TRONIC Command Line Application (T4T-CMD) allows users to program OSRAM ECGs using production files through a command line interface. The guide includes installation instructions, command usage, and error codes for troubleshooting. It emphasizes that the responsibility for testing and application remains with the luminaire manufacturer or planner.

Uploaded by

julia.krol
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/ 5

Tuner4TRONICTM

www.osram.com

Tuner4TRONIC Command Line Application


Operating Instructions (Version 2.4)
VIII 2015

(2015-08-21)

Please note:
All information in this guide has been prepared with great care. OSRAM, however, does not accept liability
for possible errors, changes and/or omissions. Please check www.osram.com or contact your sales partner
for an updated copy of this guide. This technical application guide is for information purposes only and aims
to support you in tackling the challenges and taking full advantage of all opportunities the technology has to
offer. Please note that this guide is based on own measurements, tests, specific parameters and
assumptions. Individual applications may not be covered and need different handling. Responsibility and
testing obligations remain with the luminaire manufacturer/OEM/application planner.

Light is OSRAM

VIII 2015 1
Version 2.4
Tuner4TRONICTM

Contents
Contents ........................................................................................................................................................ 1
Introduction ................................................................................................................................................... 3
How to use? ................................................................................................................................................... 3
1. Installation ......................................................................................................................................... 3
2. Commands ......................................................................................................................................... 3
2.1. Program ECG .............................................................................................................................. 3
2.2. Options ...................................................................................................................................... 4
2.3. Get Command line/ DLL Version ............................................................................................... 4
2.4. Get Command Line Version ....................................................................................................... 4
2.5. Get the Error Number................................................................................................................ 4
3. Error Codes ........................................................................................................................................ 5

VIII 2015 2
Version 2.4
Tuner4TRONICTM

Introduction

The Tuner4TRONIC Command Line Application (T4T‐CMD) can be used to program luminaire production
files (with extension .osrtup, generated with the Tuner4TRONIC‐Development) into OSRAM ECGs by calling
a single command from any application that can execute shell commands. The application prints the status
of programming into the console window. The T4T‐CMD runs under WinXP, Win7 and Win8. The T4T‐CMD
is based on the T4T‐DLL.

How to use?

1. Installation
Copy the T4T package (zip file) to any preferred location into your system and extract the files of the T4T‐DLL‐
CMD subdirectory. The following files are needed:

2. Commands
In order to enter the commands, open a command prompt and change the directory to location where the
application was saved.

2.1. Program ECG


In order to program an ECG, run the application by entering the following command:

T4T-CMD.exe T4T "Production File"

 T4T‐CMD.exe ‐> the command line application


 T4T ‐> the command to program [Case Insensitive]
 Production File
o "File Name" if the production file is in the same path as Command Line application.
o "File Name with complete path" if the production file is in a different location than the command line
application.

VIII 2015 3
Version 2.4
Tuner4TRONICTM

Note: Use always the quotes around the "file name".

Important Note:
In case the programming of a default device was not confirmed by “DeviceProgrammedSuccess” (0) it
cannot be assumed that the parameters of the ECG still contain the default values.

2.2. Options

-verbose This option is used to get information on the progress during the
programming.

Example:

2.3. Get Command line/ DLL Version


In order to get the version of the command line enter the following command:

T4T-CMD.exe –version

2.4. Get Command Line Version

Example:

2.5. Get the Error Number


The application will print the programming success or failure reason on the console (stdout).
Additionally, an error code is returned to the system for automated processing. The Return Code can
be visualized by entering the following command:

VIII 2015 4
Version 2.4
Tuner4TRONICTM

echo %ERRORLEVEL%

Example:

3. Error Codes
The table below summarizes all the possible errors that can occur using the T4T‐CMD and what might be
the root cause behind.

Error Error Name Description of the Error and Reasons


Code printed by T4T‐CMD on the Console

0 DeviceProgrammedSuccess The ECG programming was completed successfully.


‐1 GeneralApplicationError A general application error occurred.
4 ProgrammingValidationFailed The validation after programming failed.
101 No_Invalid_ParameterPassed No production file was passed.
200 ParamFileNotExists_Readable The production file does not exist or is not readable.
201 ParamFileInvalid The production file is invalid.
202 ParamFileIsEmpty The production file is empty.
203 ParamFile_DuplicateEntries The production file has duplicate entries.
500 NoDeviceConnected No ECG is connected to the programming interface
or ECG is not powered.
501 TooManyDeviceConnected Too many ECG are connected.
502 WrongDeviceConnected A wrong ECG type is connected.
503 WrongDeviceVersionConnected The ECG type is correct but the production file was
prepared for a different ECG version (FW or HW).
Check the IC code of the device.
700 HWProgrammerNotFound_ No usable Programming Interface was found or a
CommunicationError communication error with the PI occurred. If a PI is
connected then the reason could be the wrong PI
type (e.g. DALI Magic instead of OT Programmer) or
the PI is used by another SW.
701 HWProgrammerFWVersionUnsupported Unsupported firmware version of the programming
interface (e.g. DALI Magic FW 2.18)
702 DALI_OP_HWProgrammerOverloaded The DALI output of Programming Interface is
overloaded or short‐circuited.
2005 DeviceProtected The ECG is write‐locked by an OEM Code. This error
occurs when no code is contained in the production
file or the provided code is not correct.

VIII 2015 5
Version 2.4

You might also like