OSRAM T4T - Simple Current Programming User Manual
Brand: OSRAM
Product Type: LED Driver Programming Software Tool
Introduction
This document is a user manual for the OSRAM Tuner4TRONIC (T4T) Simple Current Programming Tool. It provides detailed information on how to use the software to configure and program OSRAM LED drivers, enhancing efficiency in luminaire manufacturing and maintenance.
Please note: All information in this guide has been prepared with great care. OSRAM does not accept liability for possible errors, changes, or omissions. Please check www.osram.com or contact your sales partner for an updated copy. This technical application guide is for information purposes only and aims to support users in tackling challenges and taking full advantage of the technology. Individual applications may require different handling, and responsibility remains with the luminaire manufacturer/OEM/application planner.
1. About Tuner4TRONIC – Simple Current Programming Tool
1.1 Purpose and Application
The Tuner4TRONIC Simple Current Programming Tool (T4T-S) enables setting the output current for a wide range of OSRAM LED drivers via NFC, as an alternative to LEDset. It allows sticking to default settings or applying other functionalities provided by OSRAM drivers. T4T-S can operate without a permanent internet connection, though updating the driver database manually is recommended if offline. It does not require creating production files, as it reads data from a sample driver and applies settings to drivers of the same type.
The tool applies no validation rules beyond checking min/max limits, so users must ensure output current values do not interfere with other driver settings (e.g., DALI settings, CLO, Tuning Factor). Therefore, using T4T-S with blank drivers and default settings is recommended. Programming via DALI interface is not supported by T4T-S. PW (Password) setting with T4T-S is advised to prevent unauthorized reprogramming, as exceeding the rated current of the light engine can damage the luminaire.
For full LED driver functionality, explore the T4T tool chain, including T4T-Configurator, T4T-Production, and the T4T Field app. These tools can be downloaded from www.osram.com/T4T.
The Tuner4TRONIC (T4T) software suite allows luminaire manufacturers to program OSRAM drivers via DALI and/or NFC simply, quickly, reliably, and cost-effectively, speeding up the production process.
A short video overview of Tuner4TRONIC is available via a link in the original document.
T4T Software Modules
The T4T software suite consists of different modules tailored for various environments: This web-based browser application allows luminaire designers to configure LED drivers by setting parameters such as output current, dimming levels, constant lumen output, and operating modes. Its multi-level password system, "Configuration Lock," protects drivers from unauthorized changes, while service technicians can still be granted access to selected features. Once configured, settings are exported as an encrypted, read-only production file for the production line. Access via www.tuner4TRONIC.com. Factory workers can use this module to load encrypted production files for automatic programming during high-volume LED driver production. It provides a multilingual user interface. DLL and command-line tools that enable the integration of OSRAM LED driver programming into automated programming stations on the production line. While Configurator, Development, and Production versions offer graphical interfaces, the API (Application Programming Interface) provides software developers with functions and tools to automate luminaire configuration creation. It's typically used to generate luminaire files from ERP systems. The API is based on modern REST standards and conventions, includes comprehensive documentation, and requires integration by a software developer (OSRAM does not provide ERP system integrations). T4T-Field is a smartphone app for programming OSRAM outdoor OT 1DIM and OT 4DIM, as well as indoor OTi DALI Compact LED drivers via NFC, wirelessly and without mains voltage. The app allows changing light output and dimming levels, and copying driver configurations to other drivers easily. Download links are provided for Google Play (Android) and the App Store (iPhone). A dedicated manual for T4T-Field is also available. This PC-based tool allows programming driver output current without creating production files. Users can read driver data, edit output current, and upload settings to similar drivers. The tool also supports password protection.Tuner4TRONIC Configurator
Tuner4TRONIC Production
Tuner4TRONIC Machine
Tuner4TRONIC REST API
Tuner4TRONIC Field
Tuner4TRONIC Simple Current Programming
1.2 File Types
Tuner4TRONIC Development uses the following file types:
- Tuner4TRONIC production file:
.osrtup
- Driver description file:
.osrtud
- Driver data (raw format):
.osrtur
- Password file:
*.osrpwd
- Tuner4TRONIC luminaire project file:
.osrtul
(phased out)
1.3 Workflow between the different T4T Versions
The luminaire product manager/designer creates the desired configuration (e.g., operating current, CLO, dimming) using T4T Configurator. The optional T4T API can automate the creation of luminaire and production files directly from an ERP system. Once configuration is complete, a read-only .osrtup
production file is exported to the assembly line. At the assembly line, T4T Production loads this file to start mass programming. Alternatively, T4T Machine (DLL and command-line tools) can integrate with automatic programming and testing stations.
1.4 System Requirements
The minimum system requirements for Tuner4TRONIC are:
- 1 GB main memory
- Windows 7 (32/64-bit), Windows 8/8.1 (32/64-bit), or Windows 10 (32/64-bit) with the latest SP installed
- 100 MB hard disk memory
- Monitor with a resolution of 1024x768 pixels; recommended zoom factor is 100%
- One free USB 2.0 port for Programming Interface
1.5 Programming Interfaces
To program a luminaire containing an OSRAM driver, a suitable programming interface is required: Interface: DALI magic Interfaces:[1] Driver with DALI interface (multi and/or single programming)
[2] Driver with NFC interface (only single programming)
[3] Antennas for NFC interfaces
The Tuner4TRONIC is capable of handling multiple programming interfaces connected to the same PC.
1.6 Preparing a driver with DALI interface for programming
Follow these steps to prepare a driver with a DALI interface:
- Connect DALI magic and PC using the enclosed USB cable.
- Connect the external 6V DC power supply to the DALI magic.
Note: Using an external power supply is mandatory for more than 4 drivers on the DALI line and strongly recommended for improved DALI communication stability. - Connect the driver to mains power and PE (Protective Earth) if the related terminal is available on the driver.
- Connect the DALI terminals of the DALI magic with the DALI inputs of the driver(s).
1.7 Preparing a driver with NFC interface for programming
Follow these steps to prepare a driver with an NFC interface:
- Connect a Programming Interface (FEIG PRH101, FEIG CPR30, or FEIG MR102) to the PC using the enclosed USB cable.
- Place the programming interface close to the NFC area of the driver (indicated by a logo) and keep them in position until the process is completed.
Important Information: Keep the driver powered OFF during NFC programming unless the driver's documentation specifies otherwise. Ensure the programming interface antenna and the driver with NFC are in close contact throughout the process.
1.8 Software Installation
NOTE: Always read the "Release Notes" in the zip file before installing the software.
To install the file, you must have Windows administrator rights.
Extract the Tuner4TRONIC zip file to your local hard drive and run "Install T4T.exe" from that folder. Running the installer from within the zip file will result in a faulty installation!
Tuner4TRONIC Production can be launched from "Start" => "All Programs" => "OSRAM" => "Tuner4TRONIC" or by double-clicking the desktop icons.
2. Using T4T – Simple Current Programming Tool
2.1 Start Page
The T4T Simple Programming Tool opens to a start page. The primary action available is "Read ECG" (ECG refers to the LED driver in this context).
Key Actions on Start Page:
- Read ECG: Reads data from a driver connected via a programming interface (NFC or DALI). After successful reading, the user is directed to the programming page.
- Tools: Opens the tools page for advanced settings.
- Help: Opens help and about pages.
2.2 Programming Page: Configuration
After reading data from a driver, the driver name, EAN, and IC base code are displayed in the header. Users can enter any value within the min/max limits in the "Output current" tab. By default, the output current value read from the driver is used. When programming the driver, LEDset mode is deactivated, and the current setting mode switches to "Fixed Current Mode".
Configuration Lock
The driver can be protected with a master key password by ticking the "Configuration Lock" checkbox. If the checkbox is not ticked, the driver remains unprotected. A 4-digit password can be entered manually or imported from an encrypted *.osrpwd
file. The Tools/Create PW file option can be used for creating these encrypted files. Imported passwords will be displayed as "*". Programming of protected drivers will be rejected if "Configuration Lock" is not ticked or if the entered password does not match the driver's password. Password protection becomes effective after the first power cycle of the driver.
2.3 Programming Page: Programming
This page is used to program the drivers.
- Header: Displays driver data. Programming drivers other than the type specified in the header will be rejected.
- Configuration: Shows data to be programmed, such as output current (mandatory) and password setting (optional).
- Interface: Displays the selected programming interface.
- Box Programming: Select this option to program drivers in a box via NFC. This is only available after selecting a suitable programming interface. If the driver supports box programming, the "Box size" will be greater than "1". Default settings are loaded from the production file and can be edited.
- Detected Devices: Shows the number of detected drivers after pressing programming buttons.
Start Programming
Programming is initiated by pressing either:
- Manual: Programs drivers in a single luminaire or one box.
- Auto: Starts programming drivers automatically once connected to the programming interface. Auto mode continues until the batch size is reached. In box programming mode, programming begins when the number of identified drivers matches the box size.
Status
Programming status is indicated by a symbol (see Programming Status Indicators below), a completion bar, and a text message.
Results
The number of passed and failed programming attempts is displayed. A driver may be programmed multiple times, but only the last pass/fail is counted and logged. The programming log is accessible in the "Report" tab.
- Press the delete icon [?️] to delete the programming report and reset the counter.
- Press the edit icon [✏️] to edit the batch size.
Programming Status Indicators
- ▶️ Waiting for Luminaire: Connect a luminaire/driver(s) to start/continue programming.
- ⬇️ Programming in progress: Do not remove connected luminaire/drivers(s) until the process is complete.
- ✔️ PASS: Programming process completed successfully. Remove luminaire/drivers(s).
- ❌ FAIL: Programming process stopped due to user action or errors. Fix the problem and restart programming. Check the screen for further details.
2.4 Report Page
For displaying a list of parameters in the production file, select "Report" on the navigation bar.
- Export: Press export to create an HTML reporting file. Each line represents the programming result for one driver, luminaire, or box.
- Print: Press Print to print the report.
2.5 Tools Page
Press "Tools" and select from the drop-down list.
Tools / Settings
- Select "Programming" to set the programming interface, verify options, and antenna power.
- Select "General" to set language, sound, and log options.
Tools / Create PW file
Encrypt password and save it in an encrypted file. This allows users to create a password and forward it to the production department for programming drivers without disclosing the password.
Tools / Log
Display log entries for debugging purposes.
Tools / Check for updates
Updates the driver database file and software by connecting to T4T cloud services. If the application is not connected to the internet, ensure the driver database file is updated manually by replacing "SimpleDatabase.dat" in the AppData folder (typically located at C:\Users\<username>\AppData\Local\Tuner4TRONIC\T4TProduction4 software).
Save
Saves options locally and in the production file where applicable. If settings are not saved, changes will be ignored upon restarting T4T-P.
Load Saved
Loads options from the local computer and from the production file where applicable.
Reset
Resets options to factory settings and to data from the production file where applicable.
OSRAM GmbH Headquarters
Marcel-Breuer-Strasse 6
80807 Munich, Germany
Phone: +49 89 6213-0
Fax: +49 89 6213-2020
Website: www.osram.com
Tuner4TRONIC Support: T4Tsupport@osram.com