User manual FluxTool v3.2.6

Transcription

1 User manual FluxTool v eldoled. All rights reserved. V1.6 All content contained herein is subject to change without prior notice. More product documentation and eldoled s terms and conditions are available at

2 Table of Contents 1. Introduction Compatibility Installing FluxTool FluxTool version check Connecting a TOOLbox pro Used conventions in this manual 6 2. Overview of FluxTool Menu items FluxTool Help Users Preferences (only available in Engineer and Supervisor mode) Button bar Status bar Windows HOME window SETUP window CONTROL window 9 3. Adding and editing profiles Adding a new profile Changing a profile Selecting a profile for programming Writing a profile to the connected LED driver Overview of the program tab and its messages Work order processing wizard Using label printing functionality Starting the work order processing wizard Scanning driver profile barcodes Basic testing with DALI, DMX or LEDcode Advanced settings Programming section Labels User section Flat file log selection 28 2

3 8.5. Profiles location section Close 29 Appendix A Setting up and configuring a Zebra label printer 30 Appendix B Using variables in label template 31 B.1 Label template variables 31 3

4 1. Introduction FluxTool v3.2.6 is intended for production environments where eldoled LED drivers are programmed in configuration jigs. The application allows you to create and edit profiles and write these to connected LED drivers. A profile is a set of parameters with predefined settings for a specific LED driver type, created for the purpose of quickly and efficiently configuring LED drivers Compatibility Operating system: Microsoft Windows 7, 8 or 10, Mac OS X 10.9, 10.10, and eldoled TOOLbox pro: version and higher eldoled LED drivers: all eldoled LED drivers with LEDcode and/or DMX interface 1.2. Installing FluxTool To install the application: 1. Download the latest FluxTool version from the eldoled website. 2. On Microsoft Windows, go to your download location and run FluxTool v3.2.6 WIN.exe. On Mac OS X, go to your download location and run FluxTool v3.2.6 MAC.pkg. The very first time you start FluxTool, log in as engineer (see Users) to access the FluxTool configuration parameters FluxTool version check When you start FluxTool, and a new FluxTool version has been made available, you will be notified via a pop-up, which will tell you whether it is an optional or required update. The pop-up will also include a download link. You can manually check if an update is available via the About menu item Connecting a TOOLbox pro The TOOLbox pro package contains three parts: A TOOLbox pro A USB cable A TOOLbox cable with an RJ45 connector and three driver connectors 4

5 To connect the TOOLbox pro: Connect the USB cable s mini USB connector to the TOOLbox pro and the standard USB connector to a USB port on the PC or Mac. Connect the TOOLbox programming cable s RJ45 connector to the TOOLbox pro. Connect one of the other connectors of the TOOLbox programming cable to the LED driver: o To program profiles to a DALI or 0-10V LED driver, connect the connector with the green and brown wire to the LED driver s LEDcode/NTC connector. Make sure to connect the green wire to the LEDcode + terminal, and the brown wire to the LEDcode - terminal. o To test DALI signals to the LED driver, connect the connector with the blue and blue/white wire to the DALI (DA) connector of the LED driver. This connection is polarity independent. o To program a profile to a DMX driver and to test DMX signals, connect the connector with the orange, orange/white and brown/white wire to the LED driver s DMX connectors. Polarity for this connection is important: DMX in+ : orange/white wire DMX in- : orange wire DMX in shield: brown/white wire 5

6 To provide your LED driver with power for the configuration process: When connecting the TOOLbox pro directly to the LED driver, the LED driver needs to be connected to AC power. When using a configuration jig, connect a TOOLbox adapter between the TOOLbox pro and configuration jig 1.5. Used conventions in this manual Text in italics denotes a menu item. Text in brackets [Button] represents a button in FluxTool. All other user interface items are enclosed in single quotation marks. For example: Program tab. 6

7 2. Overview of FluxTool 2.1. Menu items FluxTool This is the standard OS X application menu. About FluxTool: Shows information about the software version. Quit FluxTool: Stops FluxTool; be aware that unsaved changes are lost without warning! The other items in this menu are standard OS X commands and will not be explained further Help Check for update: lets you check if a newer version of FluxTool has been released Users The very first time you start FluxTool, log in as engineer to access the FluxTool configuration parameters. Operator, Engineer or Supervisor: Only shows the type of user currently logged in: Operator, Engineer or Supervisor. Selecting this item does nothing. 7

8 Login: log in as engineer or supervisor Engineer can create and change profiles o Select Engineer from the Login submenu o Enter your password (default password: eldoneer) o Press Enter or click [Login] Supervisor can choose predefined profiles o Select Supervisor from the Login submenu o Enter your password (default password: eldovisor) o Press Enter or click [Login] Logout: after logout the user level is Operator Change Password: set a different password for the engineer or supervisor mode Log in as the user whose password you want to change Select Change Password from the Users menu Follow the instructions in the pop-up window Click [Change] Preferences (only available in Engineer and Supervisor mode) Advanced Settings: shows the Advanced Settings window, which is described in chapter Button bar The button bar features buttons that allow you to switch between the FluxTool application s three main windows. Click [HOME], [SETUP] or [CONTROL] to go to the desired window. When a button is greyed out, you do not have access rights for that particular window. You need to log in with the correct password (see paragraph 2.1.2) Status bar The status bar shows the status of the connections of the TOOLbox pro. Green indicates a successful connection. Red means that connection has not been made (correctly) Windows HOME window The HOME window lists the connected devices. In the figure below, a TOOLbox pro, an ECOdrive 360 and a DALI broadcast device are connected. 8

9 SETUP window SETUP is the first window that will be visible when FluxTool is started in Operator mode. The SETUP window features three tabs: Program, Selection and Setup. Program here, selected profiles are written to the connected LED driver Selection is used by the supervisor to select a profile Setup in the Setup tab, new profiles can be created or existing profiles can be edited or removed CONTROL window The CONTROL window provides basic functionality to test the connected LED driver or to check the programmed address or group of the LED driver. 9

10 3. Adding and editing profiles 3.1. Adding a new profile New profiles can be added via the Setup tab in the SETUP window. The Setup tab is only available in engineer mode, so make sure you are logged in as Engineer. To create a profile: In the SETUP window, go to the Setup tab Click [New] Enter Profile name and Description Press Enter or click [Ok] The new profile will be based on the settings of the currently connected LED driver Changing a profile Profiles can be edited via the Setup tab. The Setup tab is only available in engineer mode, so make sure you are logged in as Engineer. To edit a profile: In the SETUP window, go to the Setup tab Select the profile you wish to edit Click [Edit] Click the little triangle preceding the group you want to edit to open its dialog box 10

11 Make the required changes Click [Save] To activate LightShape on a DUALdrive: In the SETUP window, go to the Setup tab Select the DUALdrive profile that must be set to LightShape Click [Edit] Check the box next to LightShape active Click [Save] To deactivate LightShape on a DUALdrive: In the SETUP window, go to the Setup tab Select the DUALdrive profile in which LightShape should be deactivated Click [Edit] Uncheck the box next to LightShape active Click [Save] To change LightShape settings: In the SETUP window, go to the Setup tab Select the profile to be changed Click [Edit] Click the little triangle in front of Light Shaper to open the Light Shaper dialog box Click [Settings] 11

12 Make the required changes Click [Done] Click [Save] To remove a profile: In the SETUP window, go to the Setup tab Select the profile you wish to remove Click [Remove] Click [Yes] 12

13 4. Selecting a profile for programming Profiles can only be selected in supervisor and engineer mode, so make sure you are logged in as Supervisor or Engineer. The supervisor selects the profile that will be programmed in the LED driver. The supervisor can also create a work order with a predefined number of LED drivers that must be programmed. To select a profile: In the SETUP window, go to the Selection tab. Click the desired profile so that it is highlighted. To view details about the selected profile, click [View]. To search for a profile, type the first couple of characters of the Profile name in the Search field. Be aware that the search function is case sensitive. Make sure to log out again to prevent unauthorized people from changing the profile. To create a work order: In Advanced Settings, select Count Down Support. In the SETUP window, go to the Selection tab. Click [Create New Order]. In the Order Amount field, enter the number of LED drivers to be programmed. 13

14 Check the reset the pass and fail counting box to set the pass and fail count to zero for the new order. To keep the number of passes and fails, uncheck it. The number of passes and fails is shown in the Program tab. Click [OK]. When an order is completed, a message is displayed and no more LED drivers can be programmed until a new order is created by the supervisor. 14

15 5. Writing a profile to the connected LED driver The Program tab is used to write profiles to the connected LED driver. No login is required for writing profiles. To write a profile to an LED driver: In the SETUP window, go to the Program tab. Connect the LED driver you wish to program to the TOOLbox pro. Wait until the green traffic light icon appears. Click [Write profile]. Wait until the green check mark (Pass) appears. Disconnect the LED driver from the TOOLbox pro Overview of the program tab and its messages The currently selected profile is shown at the top the Program tab. Make sure a profile has been selected, before trying to program the LED driver. The status of the writing process is communicated by means of the following icons: No profile selected. A supervisor should choose a profile before proceeding. LED driver is ready. Click [Write profile] to write the selected profile to the LED driver. You can also click the green traffic light icon to write the profile. Writing in progress. FluxTool is busy writing the selected profile to the LED driver. Pass. Writing successful. Disconnect LED driver and connect next LED driver to proceed. Fail. Writing failed. Disconnect LED driver and retry. 15

16 6. Work order processing wizard The work order processing wizard enables the supervisor to enter a work order in FluxTool. Any operator can configure the right number of drivers using the correct profile. Automatic label printing provides the required traceability Using label printing functionality If you intend to use the label printing functionality, proceed as follows: Create a label file with your preferred tool (e.g. Bartender) and export the label file to.zpl format. For more information on setting up a Zebra label printer and on using variables in a label template, please read Appendix A Setting up and configuring a Zebra label printer and Appendix B Using variables in label template respectively. In the label file, replace the values with $$var$$ variables using a plain text editor. Appendix B.1 Label template variables lists the available variables. Store the.zpl file to a designated label folder. Start the FluxTool application, login as Engineer, go to Preferences and enable Label Printing. In the same Preferences section, choose the folder holding the labels. PCs running Microsoft Windows have a default label template folder: C:\users\[user_name]\AppData\Local\eldoLED\Fluxtool\labels\zpl 6.2. Starting the work order processing wizard Login as Supervisor Go to the Setup tab Click the [Process Order] button 16

17 17

18 Step 1 is informational only; you may read the text and click the [Next] button. 18

19 In step 2 you have the option to enable the Touch n Go functionality ( enable auto program ). Click [Next]: 19

20 6.3. Scanning driver profile barcodes In step 3 of the work order wizard you enter the desired driver profile. You can either scan the work order number to retrieve the LED driver profile, or select the profile from the drop down menu. Either way, FluxTool will check whether the entered profile ID is a valid one: Click [Next]. 20

21 Step 4 lets the user type or scan the number of LED drivers that need to be programmed. Countdown support can be enabled optionally. Click [Next]. 21

22 In step 5, you can optionally enable label printing: Check Enable label print. This will enable other controls. Select or change the label file in the drop down menu. Fill out the value for two custom fields, if required. Empty fields are acceptable. You may make a test print of the label by clicking [Test print]. Click [Next]. You may want to use to view ZPL code as a visual label. A great tool for quickly modifying label templates. 22

23 The wizard s final step is a summary of all selected parameters. Check the summary and click [Done], or go back to previous steps to make changes. 23

24 After having completed the wizard, Go to the Selection tab and select the profile. Go to the Program tab and start programming LED drivers. If you have enabled label printing, the label will be printed after successful programming. 24

25 7. Basic testing with DALI, DMX or LEDcode In the CONTROL window, the LED output of the connected LED driver can be dimmed. Also, some DMX and DALI functionality is provided to perform basic testing. Using LEDcode: Click [LEDcode] in the status bar Use the Broadcast slider to change the dimming level You can also: o type a number between 0 and 255 in the text field and press Enter, o use the up and down arrows and press Enter. Using DALI: Click [DALI] in the status bar Use the Broadcast, Group or Short address sliders to change the dimming level o Broadcast works with any connected DALI driver, independent of the DALI group or DALI address of the connected LED driver o Use Group to check the DALI group that the connected LED driver is assigned to o Use Short address to check the DALI short address the connected LED driver has been assigned to You can also: o type a number between 0 and 255 in the text field and press Enter, o use the up and down arrows and press Enter. Note that DALI functionality in FluxTool is very limited. FluxTool is not intended to replace third-party DALI configuration software. Using DMX: Click [DMX] in the status bar Start address: first address of the DMX sliders Sliders count: number of DMX sliders available 16 bit resolution: check this box to use the full DMX resolution Use the DMX slider(s) to change the dimming level. o The numbers above the sliders refer to the respective DMX addresses Instead of using the sliders, you can also change the dimming level by: o typing a number between 0 and 255 in the text field and pressing Enter if you are using 8-bit resolution, o typing a number between 0 to in the text field and pressing Enter, if the 16 bit resolution box has been checked, o using the up and down arrows and pressing Enter. 25

26 26

27 8. Advanced settings Advanced settings can only be changed in engineer or supervisor mode Programming section Auto Program: Count Down Support: Profile details: automatically downloads the selected profile when a connection is made via the LEDcode terminals (DALI and 0-10V LED drivers). FluxTool will still validate whether the proper LED driver is connected per the profile. With Count Down Support a supervisor or engineer can create orders with a predefined number of LED drivers that have to be programmed and activate a count down, which will be visible in the operator window. shows profile details in the Program tab of the SETUP window, so the operator has an extra check against the work order. The extension of the programming profiles are associated with the FluxTool application. The programming profiles data format does not allow text-based modification (e.g. via Notepad). 27

28 8.2. Labels Templates folder: desired folder location of.zpl label templates. Used by processing work order wizard to suggest location during label template selection. Print: check the box to enable label print functionality and select between single or batch printing User section Automatic log in: automatically logs in with the last user mode, without the need for re-entering the password. So if FluxTool was last used in engineer mode, it will also be in Engineer mode when restarted Flat file log selection Use flat file log: check this box to create a log file. Each profile will have its own log file. File Dir: [Select]: the file directory (or folder) where the log files will be stored click [Select] to set the folder where the log files will be stored Log with parameter detail (Yes/No): set the level of detail that is logged in the log file: Yes: all profile details are written to the log file No: only changed parameters are written to the log file Maximum File Size: the maximum file size the log file can be Enter a value between 1MB and 99MB If the file size exceeds the file size, a new file will be created Work Order #: the work order will be added to the log file (last item in each row) 28

29 8.5. Profiles location section FluxTool v3.2.6 allows users to access profiles on any network location, dependent on the Windows log-in of the programming workstation. File: [New]: [Open]: [Save As]: Shows the current file where the profiles are stored. Creates a new empty file. Opens an existing file with profiles. Saves the current file in a new location or with a new name. New profiles are always stored to the last opened or saved file Close [Close]: Closes the Advanced Settings window. 29

30 Appendix A Setting up and configuring a Zebra label printer To set up and configure a Zebra label printer: Download the Seagull Zebra Windows driver ( During the installation procedure with the Seagull Driver Wizard, install the driver as a USB device and set it as the Default Printer. Then, via your Windows settings: Go to the Zebra printer in the Devices and Printers window, right-click the printer and open Printing Preferences -> Page Setup -> Advanced Options -> Passthrough. In the Passthrough tab o select Generic/Text Only mode in Optional Passthrough Methods o enable Add CR/LF after each line in Options Go back to Printer in Devices and Printers, right-click the printer and go to Printer Properties -> Advanced In the Advanced tab, ensure if the driver is a ZPL version and check Enable advanced printing features.

31 Appendix B Using variables in label template B.1 Label template variables Make sure the variables: are enclosed in $$ symbols are case-insensitive are either alphanumeric or _ hold between 1 and 50 characters (excluding the $$ symbols) Example: $$current_cs1$$ may result in 333. The variables included in the list below may not all be available for your label, as they depend on the profile you select. For detailed information on ZPL, go to the Zebra Support and Download section which lists extensive product documentation for download. Variable Sample value Source of value current_cs1 333 selected profile current_cs2 336 selected profile minimum_level 3 selected profile dimming_curve Logarithmic selected profile ntc_throttling_temperature 40 selected profile light_shaping_active True selected profile light_shaping_cct_min 3000 selected profile light_shaping_cct_max 5000 selected profile light_shaping_cct_balance_curve Linear selected profile light_shaping_cct_output_ selected profile light_shaping_cct_output_ selected profile light_shaping_flux_output_ selected profile light_shaping_flux_output_ selected profile light_shaping_control_strategy Warm Dimming selected profile light_shaping_flux_optimization_method Maximize selected profile light_shaping_maximum_flux 1000 selected profile product DUALdrive 560 or <NO DEVICE> if not FluxTool application connected profile 1 FluxTool application custom_1 Custom field for user custom_2 Custom field for user 31

32 Sample label template, custom label fields and resulting end label: 32

33 Europe, Rest of World eldoled B.V. Science Park Eindhoven ED Son The Netherlands North America eldoled America One Lithonia Way Conyers, GA USA