D E S I G N S T U D I O 1.5 MANUAL D E S I G N S T U D I O 1.5 MANUAL Ketra’s Design Studio and companion software, Tech Tool, offer a multi-faceted interface for comprehensive control of an installation. With Design Studio, you can configure settings on lamps and controllers, craft and assign scenes and shows to Ketra keypads, and perform more technical functions like establishing an emergency-lighting protocol or integrating other company’s lighting systems. For the power-user, Tech Tool offers even more advanced features. This comprehensive manual will help you get the most out of Design Studio 1.5 and Tech Tool. The writing here is intended for users of a range of skill levels and experience with lighting systems; terms can be referenced in the glossary on page 71. Note: This manual is for Design Studio 1.5 and firmware 1.9. It assumes the current software and firmware versions and is not retroactive. Additional tutorial videos are available at http://www.ketra.com/design-studio/. With any additional questions contact Ketra’s technical support staff and application engineers, available Monday through Friday, 9 AM-5 PM, Central Standard Time. Call 1-512-872-4357, or email support@ketra.com. What’s New in Design Studio 1.5 Design Studio 1.5 offers: • Greatly expanded support for integrating non-Ketra controllers into a Ketra lighting system. • An embedded protocol for sharing installations with other users. • An intuitive way to program X2 keypads. • A streamlined feature for quick creation of circadian lighting shows. • Clarified language on the difference between shows and triggers. 01 CONTENTS D e vic e S e t t ing s SECTIONS P A R T 1 : Getting Star ted..................................... pg 04 P A R T 2 : Operating an Installation.......................... pg 11 PA RT 1 : Getting Started • Installing Design Studio................................ pg 05 • Updating Design Studio............................... pg 05 Creating an Account................................... pg 06 • Logging In to an Existing Account.................. pg 06 • Modifying an Existing Account...................... pg 06 • Logging Out of Design Studio....................... pg 06 Instal l ation Man agem en t • Existing Installations List.............................. pg 07 • Sharing Installations with Other Users............ pg 07 • Existing Installations Screen: Additional Options....... pg 08 • Creating a New Installation........................... pg 08 • Editing an Existing Installation....................... pg 09 • Impor ting an Installation............................... pg 10 • Saving and Syncing.................................... pg 10 Modifying Line-Voltage Dimming Settings........ pg 17 Manual Control.......................................... pg 19 - White and Pastel................................. pg 20 - Full Gamut......................................... pg 21 • Content Library.......................................... pg 21 • User Presets............................................. pg 22 • Preview.................................................... pg 22 D e vic e C o n t ro l a nd K e y p a d s Account Manage m en t • • • P A R T 4 : Glossary............................................... pg 70 What You Need Before Installing.................... pg 05 Enabling Emergency Mode........................... pg 17 D e vic e C o n t ro l a nd G ro up s P A R T 3 : Tech Tool.............................................. pg 60 • • • Group Assignments.................................... pg 23 • Keypad Assignments.................................. pg 24 - Scenes and Shows.............................. pg 25 - Assigning a Scene............................... pg 25 - Assigning a Show................................ pg 26 • Other Keypad Assignment Features............... pg 27 • Keypad Linking.......................................... pg 28 - Mirroring Keypads............................... pg 28 - Cascading Keypads............................. pg 29 D e vic e C o n t ro l a nd I n t e g ra t io n • Configuring DMX Input................................ pg 30 • Configuring Analog I/O................................ pg 32 - Setting Up Contact-Closure Inputs......... pg 32 - Setting Up 0-10V and 0-24V Inputs........ pg 36 • - Setting Up Analog Outputs.................... pg 38 Configuring Dimmers................................... pg 40 D e vic e C o n t ro l a nd S h o w s PA RT 2 : Operating An Installation • Creating a Show........................................ pg 43 • Creating a Natural Show.............................. pg 44 • Impor ting a Show....................................... pg 45 • Configuring Shows..................................... pg 47 Organizati on - Show Control..................................... pg 48 • Discovering Devices................................... pg 12 - Run Frequency................................... pg 48 • Grouping Lamps for Control......................... pg 13 - Show Override.................................... pg 49 • Adding Keypads and Satellites for Control...... pg 14 - Enable Master Brightness Override......... pg 49 • Managing Groups....................................... pg 14 • • Managing Keypads and Satellites.................. pg 15 - Setting Triggers................................... pg 50 • Diagnostics............................................... pg 15 - Customizing Scenes for Triggers............ pg 51 02 Programming Shows................................... pg 49 CONTENTS • Published Trigger Preview............................ pg 54 • Expor ting a Show....................................... pg 54 P ubl i shing • Individual and Global Publishing.................... pg 55 • Publishing to Keypads................................. pg 55 • Problems while Publishing............................ pg 56 Installati on Setti n gs : U s er Icon an d Si debar • Renaming an Installation.............................. pg 57 • Deleting an Installation................................ pg 57 • Expor ting an Installation.............................. pg 57 • Replacing a Device..................................... pg 58 • Expor ting to CSV File.................................. pg 58 • Conver ting a Demo to a Secure Installation..... pg 58 • Changing Network Channel (Secure Installations Only) . pg 59 PA RT 3 : Tech Tool • Opening Tech Tool...................................... pg 61 • Opening an Installation in Tech Tool............... pg 61 • Toolbar: File, Tools, Help.............................. pg 62 • Running Diagnostics................................... pg 62 • Emitter Grouping........................................ pg 63 • Firmware Update........................................ pg 65 • DMX Output.............................................. pg 66 • Advanced Features..................................... pg 69 PA RT 4 : Glossary 03 PART 1 : GETTIN G STAR TED 04 P A R T 1 : GETTIN G STAR TED G E T T I N G S TA R T E D What You Need Before Installing (1) A Windows 7 or later Windows operating system. Mac users can refer to the tutorial video at http://www.ketra.com/design-studio/ on establishing a Windows virtual machine on a Mac. (2) A Ketra N1 USB device. This allows Design Studio and Tech Tool to communicate wirelessly with the products in your installation. Installing Design Studio Ketra Design Studio and Tech Tool can be downloaded for free at http://www.ketra.com/design-studio/. A straightforward install wizard will help you install Design Studio and Tech Tool on your Windows operating system. Updating Design Studio When Design Studio needs to be updated to a new release, an Update Available notification will appear in the top-right corner of the program, as in fig. 1.1. You can begin your update by clicking [Update Now], or you can update Design Studio from the website. Design Studio and Tech Tool will update together. Fig. 1.1 ACCOUNT MANAGEMENT If no N1 USB device is connected to your computer, Design Studio will ask you to insert your N1, as in fig. 1.2. Design Studio may also take a moment to update the N1’s firmware to the newest version. If you have Internet connection, Design Studio will next ask you to either create an account or log in to an existing one. Note: If you don’t have an Internet connection and can’t log in, Design Studio will take you directly to a blank Existing Installations list. Installations you create when not logged in will be saved locally and automatically linked to your account once you log in. Fig. 1.2 All of the following account management features require an Internet connection. 05 P A R T 1 : GETTIN G STAR TED Creating an Account When prompted, enter your name and a valid email address, create and verify a password, and click [Create Account]. See fig 1.3. Logging In to an Existing Account Enter your Design Studio account’s email address and password, and then click [Log In]. See fig. 1.4. Fig. 1.3 Fig. 1.4 Modifying an Existing Account You can change your account name, email, and password at http://my.goketra.com/users/edit. Shown in fig. 1.5. Note: You will need to log out of Design Studio and log back in before you can see your changes. On the same page, you can also cancel your account. Logging Out of Design Studio Fig. 1.5 (1) Open the sidebar. To do this, click the user icon in the top-left corner of the Existing Installations screen. Shown in fig. 1.6. Fig. 1.6 (2) In the sidebar, click [LOG OUT]. The [LOG OUT] button is at the bottom of the sidebar. See fig. 1.7. Ketra Note: You need Internet connection to log out. Design Studio will automatically perform a full sync of your installations. See Saving and Syncing, Page 10. Fig. 1.7 06 P A R T 1 : GETTIN G STAR TED I N S TA L L AT I O N M A N A G E M E N T Design Studio supports installations with up to 50 wireless nodes. Larger projects can be integrated using DMX. Existing Installations List After logging in to Design Studio, you will be presented with your Existing Installations List, as in fig. 1.8. If you’ve just created an account, this list will be blank. Under the listing for each installation is a brief summary that includes: • Security level (see notes on demo vs secure in Create a New Installation, page 8, or Glossary: Installation) • Sync status (see Saving and Syncing, page 10) • The time it was created Note: Right-clicking on any installation gives you the options to manually sync or to share it. Sharing Installations with Other Users Fig. 1.8 Sharing allows you to grant another Design Studio user access to an installation. There are two requisites for sharing: (1) You must be the originator of the installation. (2) You must have an Internet connection. Note: Although sharing with the Share command is preferred, it is possible to share without an Internet connection via exporting and importing. See Exporting an Installation, page 57, and Importing an Installation, page 10. There are two preferred ways of sharing an installation: (1) Right-clicking in the Existing Installations List. (i) Choose Share. You will get a prompt asking for the email address of the first user with whom you wish to share, as in fig. 1.9. (ii) Enter the email address of their Design Studio account, and click [Share]. A green “Success” message will appear below the email address field to confirm that the installation shared successfully. (iii) Enter any additional addresses—one at a time—to which you’d like the installation sent.Designated users will now have access to the installation in their Existing Installations list. 07 P A R T 1 : GETTIN G STAR TED (2) Going to the Customer Web Portal at http://www.my.goketra.com. This link can be found at the bottom of the Existing Installations screen. Note: You can also remove an installation from your account using the Customer Web Portal. However, the installation will not be removed from Design Studio until you log out and log back in. Fig. 1.9 Existing Installations Screen: Additional Options Clicking the user icon in the top-left corner of the Existing Installations screen (shown in fig. 10.) will open a sidebar with some additional options: Fig. 1.10 • Import an Installation. This reads in the exported DAT file from any previous installation, and rebuilds it assuming you have the same devices. See Importing an Installation, page 10. • Open Online Support. The link will direct you to this manual. To contact Ketra’s tech support team, see information in the introduction, page 1. • Log Out. See Logging Out of Design Studio, page 6. C re a t i n g a N e w Insta l l a ti on At the bottom of the Existing Installations menu, click the [CREATE A NEW INSTALLATION] button. Design Studio will then ask you to enter some basic information, as illustrated in fig. 1.11: (1) Name the installation. (2) Set the installation type. Design Studio offers demo and secure installations, detailed below. Design Studio automatically presents you with both choices for your first installation; for future installations, it uses your first choice as a default. Click the Change This link within the box for the installation type if you want a choice between demo and secure, as in fig. 1.12. Fig. 1.11 Secure installations: Permanent installations should be programmed as secure to protect their devices from being accessed by other users and installations. In a secure installation, all devices get set to a private network unique to that installation, meaning they cannot be discovered by other installations. Fig. 1.12 08 P A R T 1 : GETTIN G STAR TED Demo installations: Demo installations allow use of the same products for multiple installations (e.g. if you and another user both need access to the same devices). Devices in a demo installation remain discoverable to other installations even after you’ve provisioned them for your own installation. Note: Demo installations give you the complete range of control options over your lamps--however, they don’t give you exclusive control. Any nearby user who clicks [Add New Devices]--even in a totally different installation--can discover them and give them commands. (3) Set the network channel (secure installations only). Choose which channel you want to set the devices to in your secure installation. It is recommended that adjacent installations be on different channels from one another, to prevent signal interference. Editing an Existing Installation After you select the installation from the Existing Installations List, Design Studio will reestablish connection to the devices in your installation. See fig. 1.13. Note: If your installation is a demo, Design Studio will also automatically republish settings to some of your devices, in case they were discovered and commissioned by other installations since you last opened the program.It is recommended that you go to the Device Control tab in your installation and click [Global Publish] to fully restore your settings. Fig. 1.13 You can change your installation’s name, as well. From within your installation, click the user icon in the top-left corner to open the sidebar, as in fig. 1.14. Then double-click on the installation’s name, and type a new one. User icon to open sidebar Fig. 1.14 09 P A R T 1 : GETTIN G STAR TED Importing an Installation In the Existing Installations screen, click the user icon in the top-left corner, shown in fig. 1.15. This will open a sidebar with the option to import an installation. Note: Contact Ketra before importing an installation from an earlier version of Design Studio. Fig. 1.15 When you click [Import an Installation], you will see a pop-up that warns you not to use exporting and importing for sharing installations. (The reason behind this warning is discussed in detail in Exporting an Installation, page 57.) Select a .dat file to import. Design Studio will quickly restore that installation’s settings. Saving and Syncing In Design Studio, installations tied to your account are autosaved locally on your PC and also synced to the cloud, provided that you have Internet access. Design Studio autosaves when you provision lamps, publish settings, or close the installation; and it automatically syncs when you close the installation, log out, or exit the program. You can see the sync status of your installations in the Existing Installations menu, beneath each installation’s name. There are three possible statuses: • Sync successful: Your installation has successfully synced and is completely up to date. • Sync pending: Changes to your installation have been saved locally on your computer, but not pushed to Ketra’s server. This can happen if you have made changes but don’t have Internet access required to sync. Note: If your installation is marked “Sync pending,” any other computer—regardless of who is signed in—trying to access the installation will not see your changes. • Sync required: Ketra’s server has more recent configurations for your installation, and you must sync before you can access the installation. This can happen if an installation is modified on another computer. 10 P A R T 2 : O PERATIN G AN IN STALLATION 11 P A R T 2 : OPERATIN G AN IN STALLATION O R G A N I Z AT I O N The Organization tab in your installation is where you will provision devices for inclusion in your installation. This could include lamps and controllers. Lamps are organized into groups for control, whereas keypads and satellites are added individually. Discovering Devices Click [Add New Devices]. This returns any nearby devices that are on Ketra’s default channel and network (i.e. that aren’t already provisioned to a secure installation). Figs. 2.2 and 2.3 show some example results. Design Studio sorts all of the devices it discovers into three categories: lamps, keypads, and satellites. Discovered devices will be sorted between the “[X] Lamps Found,” “[X] Keypads Found,” and “[X] Satellites Found” tabs, visible directly above the space where your devices are displayed. Fig. 2.1 Tabs by catagory G2 linears appear as bulk quantity Note: The Groups, Keypads, and Satellites tabs on the left sidebar tell you how many such devices you’ve added to your installation—not how many were discovered by Design Studio. You can ignore them until you start adding devices. Group lamps here Fig. 2.2 In the “[X] Lamps Found” tab, wirelesslycommunicating lamps like S38s, A20s, and S30s display individually, whereas G2 linears display in bulk as a certain quantity connected to an N3 Satellite. If your N3 Satellite has no luminaires connected to it, it will appear on the “[X] Satellites Found” tab. Note: If a device in your installation isn’t displayed here, you can click [Refresh] to repeat discovery of available devices. Make sure you are looking in the appropriate tab and that your device is powered on. Fig. 2.3 Lamps will go to a dim blue when they are discovered by Design Studio. If you select one, as in fig. 2.4, it will identify itself by shining a bright blue. Likewise, controllers will flash their onboard LEDs when selected. (N3 Satellites’ indicator lights are beneath the hood.) Fig. 2.4 12 P A R T 2 : OPERATIN G AN IN STALLATION By default, Design Studio labels devices by their serial numbers. You can give a device a recognizable name by double-clicking on its serial number. The new name will only apply in the current installation. At any time, you can click [Refresh] to re-discover available devices. Grouping Lamps for Control This same Organization tab is where you will sort your lamps into groups. Once they’ve been grouped, you’ll be able to make them part of your installation.When you issue a command to a group, all of the lamps in it will respond in the same way. No two lamps in a single group can be configured differently from each other. Note: A group can be any size—it can even have just one lamp. If you want to control a single lamp differently from others, put it in its own group. To group lamps, follow these steps: (1) Select a lamp. The lamp will identify itself in your space by shining a bright blue. (2) Group lamps. There are three ways to do this: • To put a lamp into a new group, drag the lamp to blank space in the Lamp Groups panel. • To put a lamp into an existing group, drag the lamp to that group’s name in the Lamp Groups panel, shown in fig. 2.4. • To create an empty group, deselect the lamp and click the [+] button at the bottom of the Lamp Groups panel. Note: Groups can have multiple types of lamps. For example, a single group could contain luminaires as well as A20s. Fig. 2.5 13 P A R T 2 : OPERATIN G AN IN STALLATION Once you have successfully added lamps to a group, you will notice that the Groups tab on the left sidebar will show the number of groups in your installation, as in fig. 2.5. Your lamps will also let you know they’ve been grouped by temporarily shining green. Note: You can copy a single lamp to multiple groups, or move a lamp between groups, after you’ve finished adding devices. See Managing Groups, page 14. Adding Keypads and Satellites for Control Unlike lamps, keypads and satellites are not grouped. They operate individually. Note: If your N3 Satellite has luminaire attached, it will appear with the G2 luminaire in the “[X] Lamps Found” tab for grouping. Otherwise, it will appear in the “[X] Satellites Found” tab. Even if a satellite has lamps attached and is in a lamp group, it will be available for Integration later on. To add controllers to your installation: (1) Go to the “[X] Keypads Found” or “[X] Satellites Found” tab. These tabs are found at the top of the area where discovered devices are displayed, as shown in fig. 2.5. (2) Select a device. keypads and satellites self- identify when selected. Keypads’ scene options will flash when you’ve picked the right one, and satellites’ Status Monitor indicators will do the same. (You have to lift the hood off your satellite in order to see them.) Fig. 2.6 (3) Add the device to your installation. Drag the device to the Keypads or Satellites panel at left. Note: You will link your controller to specific groups of lamps later on (see Device Control and Keypads, page 23, and Device Control and Integration, page 30). At any time, you can click [Refresh] to discover and add more keypads or satellites. Managing Groups After clicking [Finish], you can review and modify the lamp groups you’ve created, as in fig. 2.6. By selecting a group and right-clicking on an individual lamp, you can: • Deprovision the lamp. This removes the lamp from your installation; you will be able to discover the lamp again by clicking [Add New Devices]. • Move the lamp between groups. This removes the lamp from its original group and puts it in another. • Copy the lamp between groups. The lamp will appear in multiple groups; note that once a lamp is in multiple groups, you have the option to remove it from one of its groups without deprovisioning it. 14 P A R T 2 : OPERATIN G AN IN STALLATION Groups can also be renamed here. Simply double-click on the group name and type a new one. Groups can be deleted as long as they are empty; to remove lamps from groups, either deprovision them or move them to other groups. At any time, you can click [Add New Devices] to add more lamps to a group. You can also create a new group by clicking on the [Create New Group] icon at the bottom of the Lamp Groups pane. Fig. 2.7 Managing Keypads and Satellites After you’ve provisioned and clicked [Finish], use the tabs at in the left sidebar to select which type of device you’d like to manage, as in fig. 2.7. You can then right-click on any keypad or satellite in your installation and select Deprovision to remove it from your installation. At any time, you can click [Add New Devices] to add more devices to your installation. Diagnostics In the top-right corner of the Organization tab, you’ll see the heartbeat icon to open your first-line diagnostics tool. After opening the diagnostics window shown in fig. 2.9, click [Start]. Diagnostics will display a list of every wirelessly-communicating device in your installation. (G2-family luminaires will not be listed, since they do not communicate wirelessly; instead, their parent N3 Satellite will be listed.) Clicking on any device in the list will cause that device to identify itself: a lamp will turn to a bright blue, while a controller will flash. 15 Fig. 2.8 P A R T 2 : OPERATIN G AN IN STALLATION Fig. 2.9 Using the Diagnostics tool, you can perform several important tasks: • Test wireless connectivity. The diagnostics tool will test the strength of communication between your N1 and each device, and display the results. Note: Depending on its signal strength, each device will be marked green, meaning good; yellow, meaning fair; red, meaning poor; or dark, meaning unknown. Poor connection indicates that you may need a wireless repeater. Unknown connection could mean your device is not powered on. • Check for wiring issues in luminaires. • Check for invalid line-voltage conditions. • Uncover other hardware faults. Any problems will be reported in the Alerts column; you can click on the problem’s label to open a small window with more information. DEVICE SETTINGS To access Device Settings, click on the Device Settings tab in the top bar. The Device Settings tab, shown in fig. 2.10, offers you the abilities to enable Emergency Mode and modify the Line Voltage Dimming defaults for any quantity of lamps in your installation. Your lamps have to have a recent version of firmware for these to take effect. You can update your firmware using Tech Tool; see Tech Tool: Update Firmware, page 65. Fig. 2.10 16 P A R T 2 : OPERATIN G AN IN STALLATION Note: These features may require firmware updates on your devices. See Tech Tool: Firmware, Update, page 65. Enabling Emergency Mode This only applies in buildings with emergency lighting protocols (e.g. protocols to highlight points of egress in case of a power-outage that triggers an emergency generator). An analog-input N3 Satellite configured for contact-closure will receive a signal from an emergency device; it will relay that signal—by hard-wire connection or KetraNet Mesh wireless—to all the lamps you have enabled emergency mode on. When a lamp receives a command to go into emergency mode, it reverts to its most recent published default, as if it had been power-cycled. Published defaults are set in Device Control > Groups. Even if you have changed scenes on a keypad since publishing, the default remains whatever state was last published in Device Control > Groups. See Device Control and Groups, page 18. Lamps in emergency mode will also ignore commands from Design Studio or controllers until after the emergency signal has ceased. To configure emergency mode, follow these steps: (1) Configure a contact-closure analog input on your N3 satellite to Emergency Mode. You will not be able to enable Emergency Mode until you have gone to the Integration tab and done this. Configuring contact-closure inputs is discussed in detail in Setting Up ContactClosure Inputs, page 32. Fig. 2.11 Note that whether your port should be normally open or normally closed depends on the emergency device. (2) Select lamps to configure with Emergency Mode. Select lamps individually or in bulk in the Device list. (3) Set Emergency Mode to Enabled and click [Apply to Selected]. See fig. 2.12. This will automatically publish Emergency Mode to your selected lamps. Fig. 2.12 Modifying Line-Voltage Dimming Settings Each Ketra lamp by default auto-detects whether it is on a line-voltage dimmer, and if so what kind. However, lamps may perform better if you manually set the kind (reverse-phase or forward-phase) using the dropdown at right. Note: The [Apply to Selected] button will be grayed out for devices that don’t support dimming, such as luminaires or older lamps. 17 P A R T 2 : OPERATIN G AN IN STALLATION DEVICE CONTROL AND GROUPS A general note on the Device Control tab: it is broken up into four categories to give you finer control over each. The categories are Groups, Keypads, Integration, and Shows each accessible using the tabs on the lefthand side of the screen. This section of the manual will deal with the Groups category, pictured in fig. 2.13. In Groups, you set default states for lamp groups by publishing custom configurations. Your lamps will return to their published default states when power-cycled, rather than returning to factory settings. Note: If your installation has a keypad, you will be able to configure lamp groups by scene with all of the same controls available in the Groups tab. You can skip this section and see Device Control and Keypads, page 23. Intensity Control options Select a group to configure Fig. 2.13 When working with groups, the Device Control tab offers you the ability to: • Control the parameters of your light. That includes hue, intensity, vibrancy, and other parameters. See Manual Control, page 19. • Emulate classic lighting styles. Ketra offers an easy solution for emulating natural light and common lamps. See Content Library, page 21. • Modify the warmth of your lamps’ dimming curves. Select from a library of warm dimming curves to determine what hue your lamp dims to. See Content Library, page 21. 18 P A R T 2 : OPERATIN G AN IN STALLATION In the panel on the right side of the screen in fig. 2.13, you can choose between Manual Control, Content Library, and User Presets. Each of these is discussed in detail below. Notice that above all of these options is a sliding scale that controls intensity. You can access that scale from any of the three options. Note: Ketra’s intensity slider uses an exponential model rather than linear. When the slider is at 90%, your lamps will be at approximately 50%. See graph in fig. 2.14. Fig. 2.14 Notice that in the Lamp Groups sidebar on the left side of the screen, your groups are listed. Each group can be configured differently. Click on a group when you’re ready to start configuring. Manual Control In Manual Control, Design Studio presents a CIE 1931 color diagram from which you can select color coordinates. Having the ability to control brightness as well as color gives you three-dimensional control over your lighting’s color space. 19 P A R T 2 : OPERATIN G AN IN STALLATION White and Pastel White and Pastel, shown in fig. 2.15 offers you the softer hues at the heart of a chromaticity diagram, which all Ketra lamps can match with guaranteed accuracy. The curve at center is the black body locus, representing the changing color of a theoretical black body radiator as its temperature increases in units of Kelvin. In this section, you can: • Freely set specific color coordinates within a subset of Ketra’s available coordinates (all accessible in the Full Gamut tab). In order to match warm colors below 1700 K, Design Studio may scale down your lamps’ intensity. • Enter exact x, y chromaticity coordinates. • Add user presets to save coordinates and settings. 2 • Adjust the CCT (Correlated Color Temperature, the temperature corresponding to a given point along the locus) via a sliding scale that follows the shape of the locus, or select from preset CCTs. 3 • Adjust your light’s tint via a sliding scale that follows the isotherms for a given CCT. 4 • Adjust your light’s vibrancy via a sliding scale. 1 1 5 Note: To understand vibrancy, be aware that every Ketra emitter has four LEDs: red, blue, green, and white. When you adjust the vibrancy of your light, you change the ratio of RGB to W output: at closer to 100%, output is generated more by the RGB LEDs; at closer to 0%, it’s generated more by the W LED. In either case, the color points and intensity are the same, while the SPD output and CRI change. When vibrancy is closer to 100%, illuminated objects can appear more vibrant. 2 1 3 4 5 Fig. 2.15 20 P A R T 2 : OPERATIN G AN IN STALLATION Full Gamut Full Gamut, shown in fig. 2.16, offers you coordinates in Ketra’s extended gamut of color possibilities. Note: If any lamp in your installation shipped before April 2015, it may not be able to match colors outside of the restricted gamut, i.e. the dotted lines in the center of the chromaticity diagram. If so, those dotted lines will become a hard boundary for your entire installation. 1 In this section, you can: • Set specific color coordinates across a full chromaticity diagram as well as the whites and pastels near the black body locus. 1 • Add user presets to save settings. • Adjust the hue, saturation, and red-blue-green composition of your light via sliding scales. 3 2 Note: For coordinates outside of the dashed triangle, and especially on the outer edges of the full gamut, Ketra does not guarantee 100% accuracy. You may notice some very slight variation in the color of your lamps. 2 1 3 To save the configurations to the lamp group, click [Publish This Group]. To publish all changes you’ve made so far, click [Global Publish]. For more information on publishing, see Publishing, page 55. Content Library Fig. 2.16 The Content Library displays categories of presets Ketra has saved, as well as warm dimming curve options for your lamps. As shown in fig. 2.17, hovering over a preset will give you three icons. • Bookmark a setting. This saves it to your library of user presets. You will be able to access the preset quickly in this installation or any others tied to your account. (For more on user presets, see below.) • Play a setting on your lamps. This makes the lamp group preview the setting. 21 P A R T 2 : OPERATIN G AN IN STALLATION Note: Static configurations, such as light colors, that you select in the Content Library will be visible on your lamps immediately upon selection. However warm dimming curves—i.e. The options in the Dimming Curves folder at the end of the list—will not be visible on your lamps until after you have published the group. • Read information about a setting. Each Ketra-curated preset has some brief text on the setting’s potential uses or significance. Fig. 2.17 To save the configurations to the lamp group, click [Publish This Group]. To publish all changes you’ve made so far, click [Global Publish]. For more information on publishing, see Publishing, page 54. User Presets This itemizes all the preset configurations you have stored. Your presets are accessible across installations in your account. Presets can be stored for any lighting configurations you’ve designed; just select [Add Preset] under the chromaticity diagram in Manual Control, or click the [bookmark icon] you see by hovering over any Ketra preset in the Content Library. To save the configurations to the lamp group, click [Publish This Group]. To publish all changes you’ve made so far, click [Global Publish]. For more information on publishing, see Publishing, page 54. Preview This feature lets you preview how the lamps will look turning on and off. The preview has a 3-second fade time. Lamps will come back on to whatever setting was last selected, in terms of color, but in order to see a dimming curve in action you still must publish the dimming curve before using Preview. 22 P A R T 2 : OPERATIN G AN IN STALLATION D E V I C E C O N T R O L A N D K E Y PA D S In the Device Control tab, device categories are displayed on the left-hand side of the screen. To control keypads, go to the Keypads tab, as in fig. 2.18. About keypads: • Keypads can control groups of lamps. With a single keypad, you can control multiple groups of lamps at the touch of a button. Keypads can be programmed to give detailed instructions to lamps, including color configurations and Fig. 2.18 time triggers. • Keypads can control X2 dimmers, Analog outputs, and DMX outputs. The method for each of these is discussed in Device Control and Integration, page 30. • Keypads can be independent or linked. If you have more than one keypad, you can configure each of them separately or link them with one another. See Keypad Linking, page 28. To begin configuring your keypad, select a keypad from the list of IDs (serial numbers, or names if you’ve named them) in the Keypads sidebar at left in fig. 2.17. You will see your keypad’s name appear in the center part of the window, with three small tabs underneath it: Group Assignments, Keypad Assignments, and Keypad Linking. The first two contain important configurations you have to complete, but the third (Linking) is optional. Note: At any time, you can click [Clear All Buttons] to wipe your keypad’s settings and start over. Clicking this button will not change the groups that are currently assigned to the keypad. Group Assignments In this tab, pictured in fig. 2.19, you will select which fixtures —lamp groups, DMX or Analog outputs, or X2 dimmers—you want to control with the selected keypad. Each scene or show (i.e. each button on the keypad) can control multiple fixtures. Note: Analog and DMX outputs must be configured and set before they can be found in Group Assignments. See Integration: Setting Up Analog Outputs, page 38; and Tech Tool: DMX Output, page 66. To assign fixtures to a keypad, follow these steps: (1) Check the box for the desired fixture. Fixtures you choose here will be available for you to pick from when you go to program a scene. Fig. 2.19 23 P A R T 2 : OPERATIN G AN IN STALLATION Note: A scene does not have to use every fixture assigned to the keypad; for example, if youassigned three lamp groups in Group Assignments,you could program Scene 1 to control only groups 1 and 2. However, the intensity controls on the keypad’s touch interface will raise and lower the intensity for every assigned fixture. (2) Click [Set]. Note: You can come back to this tab at any time and deselect a fixture. Keypad Assignments In this tab, pictured in fig.2.20, you will determine how your devices react to each button on the keypad. Fig. 2.20 Note: The keypad’s image on your screen will vary: depending on your model of keypad, you may have a different number of buttons, and the buttons may be labeled differently. However, the process of programing of each scene will be the same across models. If your keypad has a power button, that button does not require any configurations. It will remain blank, its only job being to turn your lamps on or off. You can rename a button by double-clicking on it. These names will reset if you deprovision the keypad. To begin programming scenes and shows for your keypad, select a button from the keypad display in the window. Choose a content type in the dropdown: scene or show. Note: You will not be able to assign a show until you have created a time trigger. See Device Control and Shows, page 42. 24 P A R T 2 : OPERATIN G AN IN STALLATION Scenes and Shows A scene is a static configuration for your lamps: when you press a keypad button, lamps in a scene will play whatever color and intensity settings you’ve configured, and they will not change until another scene or show is activated. By contrast, a show is a dynamic configuration involving time triggers: when you press a keypad button, lamps in a show will shift between settings over time, and they will continue doing so until another scene or show is activated. An example of a show would be a circadian lighting display that changes over the course of the day. Assigning a Scene Once you have selected Assign a Scene from the dropdown, click [Next] to go to Scene Settings, pictured in fig. 2.21. Then follow these steps: (1) Create a new scene, or copy from a previous scene. Note: If you have not created a scene elsewhere in this installation, you will not see the option to copy from a previous scenes. Fig. 2.21 If you are creating a new scene: Give your scene a name, and then click [Next]. Note that you cannot reuse names you have already used within one installation. If you are copying a previous scene: Select the previous scene’s name from thedropdown. Note that the dropdown only includes scenes you have used in this installation. Once you select a scene, you will have the ability to edit it or use it as it is, as in fig. 2.22. Any edits to made to the copy will not be reflected in the original. Copied scenes automatically use the same fixtures as the original. Fig. 2.22 (2) Choose fixtures for your scene to control. Earlier, you assigned groups and other fixtures to the keypad. Now, you will assign fixtures to a particular scene, as in fig. 2.23. Fixture dropdown Add or remove fixtures Fig. 2.23 25 P A R T 2 : OPERATIN G AN IN STALLATION To add a fixture for control, use the [+] button. As you can see in fig. 2.24, each new item in the list of groups will default to the first group in your installation, e.g. Group 1. (3) Configure each fixture. • Configuring a Group: For each group, the Scene Builder pane will allow you to control the lamps’ color settings, power status, and fade time. Note: The maximum fade time is 6000 seconds, or 100 minutes.. To configure a group’s color settings, first select the group in the Scene Builder pane. At right, you have full access to the Manual Control, Content Library, and User Presets options detailed in Device Control and Groups, page 18. • Configuring an X2 Dimmer: If you have an X2 dimmer in your installation, you will have the ability to determine its output intensity for a given scene; the output intensity will determine how much power goes to a non-Ketra load on the same circuit as the X2 keypad. Note: Three additional features are available in Integration: Configuring Dimmers, page 40. There you can rename your dimmer, modify its dimming curve, and set trim values. • Configuring Analog Outputs: Creating Analog outputs and configuring scenes for them are discussed in detail in Setting Up Analog Outputs, page 38. • Configuring DMX Outputs: Creating DMX outputs and configuring scenes for them are discussed in detail in Tech Tool: DMX Output, page 66. (4) Program the remaining keypad buttons. (5) Publish your settings. This saves your configurations to your keypad. Click [PUBLISH THIS KEYPAD]. For more information on publishing: Publishing to Keypads, page 55. Assigning a Show Once you have selected a button on the keypad display in Design Studio, pick Assign a Show from the Choose Content Type dropdown, as in fig. 2.25. Click [NEXT]. Note: Assigning a show requires that you have already built one and given it a Show ID. Shows consist of multiple scenes and the additional dimension of configured time. See Device Control and Shows, page 42. Fig. 2.25 26 P A R T 2 : OPERATIN G AN IN STALLATION (1) Select a Show ID and click [ASSIGN]. See fig. 2.26. Note: No further show configurations are required. Pressing the keypad button to which you’ve assigned your show will cause the trigger to play on your devices. (2) Program the remaining keypad buttons. (3) Publish your settings. This saves your configurations to your keypad. Before publishing, be sure to check the box that says Publish Time Triggers. Click [PUBLISH THIS KEYPAD]. For more information on publishing, see Publishing: Publishing to Keypads, page 55. Fig. 2.26 Other Keypad Assignment Features In addition to assigning a scene or show, you can: • Use Preview to play your settings. Selecting Preview will temporarily set lamps to the settings you’ve chosen in Scene Builder; however, Preview will not work for unpublished dimming curve settings. Preview is not a substitute for publishing; see Publishing, page 54. • Lock a keypad to prevent accidental changes. To lock a keypad, first enable locking in Design Studio using the checkbox below the keypad display in the Keypad Assignments tab. See fig. 2.27. Note: Keypad locking is only available on X1s. Once locking has been enabled, you can lock the keypad manually by holding its - button and tapping the + button. The keypad’s intensity controls will trace up and down once to confirm. When you are finished configuring your device, click [Publish This Keypad] to save your configurations to the device. For more information on publishing, see Publishing: Publishing to Keypads, page 55. Fig. 2.27 27 P A R T 2 : OPERATIN G AN IN STALLATION Keypad Linking If your installation has multiple keypads, Design Studio gives you the option to link some or all of them. Linked keypads control the same groups of lamps, so you can have multiple points from which to direct your lighting. There are two kinds of linking: mirroring and cascading. Fig. 2.28 Mirroring Keypads Mirror keypads become copies of one another. They issue the same commands to the same groups of lamps. When you press a button on one keypad, that button will light up on the others. This is useful if you have a large space and want keypads stationed at multiple points. To configure mirror keypads: (1) Select a keypad in the Keypads pane. See fig. 2.28. Whichever keypad you have selected will become the primary when you set others to mirror. Note: There is nothing special about the primary keypad except that the others will mirror it; you don’t have to interact with it any differently in the installation. (2) Go the Keypad Linking tab. See fig. 2.28. (3) Set keypads to mirror. All keypads in your installation (other than the one you have selected) are displayed in the list. Using the dropdowns, set the desired keypads to Mirrored. These mirrors will automatically assume t he configurations you set for the primary in the Keypad Assignments tab. Note: The one-to-one mapping of button configurations between primaries and mirrors has side-effects if some linked keypads have power buttons and others don’t. If a primary has a power button and a mirror does not, the mirror’s fifth button will essentially become a power button, only able to turn lamps on or off. If a primary lacks a power button and a mirror has one, the mirror’s power button will assume the scene or show assigned to the primary’s fifth button. (4) Configure leftover buttons on your mirrored keypads. This will not apply in all cases. If a mirrored keypad has more buttons than the primary, the remaining buttons will be available for you to configure. For configuring buttons, see Keypad Assignments, page 24. Note: If a mirror keypad has fewer buttons thanthe primary, as in fig. 2.29, the one-to-one mapping of buttons will stop when the mirror runs out. So if a primary had four buttons and its mirror had three, the primary’s first three buttons would map to the mirror, and the fourth would be left unmapped. 28 Fig. 2.29 P A R T 2 : OPERATIN G AN IN STALLATION (5) Publish your configurations. When you are finished configuring your device, click [Publish This Keypad] to save your configurations to the device. Note that publishing to one keypad will publish to any others linked to it as well. For more information on publishing, see Publishing: Publishing to Keypads page 55. Note: At any time, you can click [Unlink associated keypads]. This will get rid of the link between keypads, but not delete the keypads’ former configurations. Mirror keypads will return to whatever configurations they had before they were set to mirror. Cascading Keypads Cascading keypads act essentially as one interface, controlling the same lamp groups in different ways. For example, if you had two keypads, each with four scenes, cascading them would give you eight scenes for a given space. You could then use the touch-surface on the keypads to pick one of those eight scenes to play on your lamps. Pressing a button on one of the cascading keypads will cause the other keypad’s buttons to go dark. Intensity controls on one keypad will lower or raise the intensity for all assigned groups. To configure cascading keypads: (1) Select a keypad in the Keypads panel. See fig. 2.30. Whichever keypad you have selected will be come the primary when you set others to cascade. Note: When cascading keypads, the only quality differentiating the primary from the cascaded lies in the areaof group assignments. Cascading keypads don’t have to control all of the same groups, but you cannot assigngroups to the cascading keypad that are not also assigned to the primary keypad. On a practical level, in yourinstallation, you will nothave to interact any differently with the primary keypad than you would with a cascaded keypad. Fig. 2.30 (2) Go the Keypad Linking tab. See fig. 2.30. (3) Set keypads to cascade. All keypads in your installation (other than the one you have selected) are displayed in the list. Using the dropdowns, set the desired keypads to Cascading. (4) Program the cascading keypads’ buttons, if you have not done so already. Cascaded keypads can have scenes and shows, just like primaries. All buttons that you program will control at least some of the same groups of lamps as the primary keypad, but they can do so in completely different ways. 29 P A R T 2 : OPERATIN G AN IN STALLATION (5) Publish your configurations. When you are finished configuring your device, click [Publish This Keypad] to save your configurations to the device. Note that publishing to one keypad will publish to any others linked to it as well. For more information on publishing, see Publishing: Publishing to Keypads, page 55. Note: At any time, you can click [Unlink associated keypads]. This will not reset the unique button configurations of cascading keypads, merely the link between the keypads themselves. D E V I C E C O N T R O L A N D I N T E G R AT I O N In the Integration tab, you can configure N3 satellites and X2 dimmers. For dimmers, see Configuring Dimmers, page 40. Most of this section will walk you through getting the most out of the N3 Satellite, with which you can integrate other companies’ lighting systems into a universal Ketra solution. DMX settings and Analog I/O ports are covered in detail here. Note: Even if a satellite has luminaires attached, it will be available for configuration in the Integration tab. Configuring DMX Input The Ketra N3 Satellite can receive a full universe of DMX512-A from an external control, and relay that controller to fixtures—groups, Analog outputs, or dimmers—in your installation. To configure DMX inputs: (1) Select the N3 Satellite you want to configure. Your list of N3 Satellites can be found in the Devices panel. shown at left in figure 2.31. Note: At this step, satellites will not identify themselves by flashing LEDs when selected. (2) Select a fixture to patch with DMX. In the first enumerated panel, you can find your lamp groups, Analog outputs, and dimmers in the pane labeled Available Groups. Analog outputs and dimmers can only be controlled by DMX input intensity profiles, meaning the profile list in the second panel will be shorter for them. Fig. 2.31 30 P A R T 2 : OPERATIN G AN IN STALLATION (3) Select a DMX profile and start channel. In the second panel, a variety of profiles are listed, each of which is displayed with additional information. You will see the profile’s required number of channels below the profile name, as well as a description of the profile and other specific details in the third panel. Note: If using a DMX controller to perform fades on your Ketra devices, choose a profile with a Fade Rate parameter. If you don’t choose a Fade profile, then performing quick fades on the DMX controller side will result in lag time and “steps” in intensity. For more information, see Ketra’s DMX app note. Each profile has an 8-bit or 16-bit option; 16-bit takes up two channels per parameter but gives you finer control over your devices. Most applications will only require 8-bit. Also select a starting channel for your profile. Make sure your group’s starting channel lines up with the DMX controller programming. If the DMX controller is sending out an RGB 8-bit profile starting at channel 212, then your group’s starting channel should be 212. (4) Review your DMX mapping. In the third panel, your configurations are summarized for you to confirm. There are also a couple of additional options: • Enable Brightness Override: If you check this box, the N3 Satellite will give full control of your lamp group’s brightness to the external DMX controller. Brightness commands from the external controller will override any from Ketra devices, such as a keypad running a show. • Enable DMX Refresh: If you check this box, the N3 Satellite will refresh your lamp group’s settings to match the currently active DMX profile every ten seconds. (5) Click [Set]. You will see a checkmark appear next to the group, so you know the setting has been saved. (6) Set configurations for another lamp group. Select another group, choose another profile, and select the new starting channel. Click [Set] to save that setting. (7) Publish your configurations. Click [PUBLISH DMX INPUT]. Your information will be sent to your Ketra products, which will begin responding to DMX input. When valid DMX input data are coming in, your N3 Satellite’s DMX indicator light will flash. For more information on publishing, see Publishing, page 54. Note: Your configurations will take effect as soon as you publish. However, if you’ve selected a profile with Fade Rate and the fade channel is set to a very long fade, you may not see the devices respond immediately. Any number of N3 Satellites can be configured for DMX input as long as each one is controlling luminaires directly wired to it. But only one N3 Satellite in an installation can patch DMX inputs wirelessly to unattached groups of lamps. Note: If you are chaining N3 Satellites to relay a DMX signal, ensure that all N3 Satellites are set to Pass-Through instead of Terminate. This can be configured by lifting the hood and using the appropriate red toggle on the side. 31 P A R T 2 : OPERATIN G AN IN STALLATION Configuring Analog I/O Analog input and output ports on an N3 can be individually configured. Analog inputs can trigger scenes in your installation based on input from a third-party control device, while analog outputs can be controlled by keypads and relay signals to third-party devices. Setting Up Contact-Closure Inputs Ketra supports sustained and momentary contact-closure inputs. However, for momentary inputs, a pulse that is not sufficiently wide may not be detected by the N3. To set up contact-closure inputs: (1) Select the N3 Satellite you want to program. Your list of N3 Satellites can be found in the Devices panel. Note: At this step, satellites will not identify themselves by flashing LEDs when selected. (2) Next, choose the Analog I/O tab in Integration. The tab is pictured in fig. 2.32. Fig. 2.32 Note: If that tab is grayed out, it is because devices in your installation need firmware updates. See Tech Tool: Firmware Update, page 65. (3) Configure the first port. In the Select Port Type dropdown, choose Contact Closure. The resulting three dropdowns are also important for you to configure. As pictured in fig. 2.33, choose Input. Determine whether your port is normally open or normally closed. Note: Each contact-closure port has two states—open and closed—depending on its input. Determining whether the port should be normally open or normally closed should be done with consideration to the external device triggering the contact closure. Some occupancy sensors consider an occupied port to be open; others consider it to be closed. 32 P A R T 2 : OPERATIN G AN IN STALLATION Fig. 2.33 Fig. 2.34 If you are configuring your port for Emergency Mode, select Emergency Mode from the dropdown at right, and then click [Next]. Publish your configurations and return to the Device Settings tab; ignore the remaining steps in this part of the manual. (4) Decide whether to link ports. Linking ports together allows them to trigger more scenes. Each contact-closure port on its own can recall two scenes: one for the open state, and one for the closed state. Next to each port-linking option is a statement of how many scenes it can recall. You can link your contact-closure port with others using the dropdown that defaults to “1:1 Mode,” pictured in fig. 2.33. You’ll see that the linked ports are automatically and immutably configured with the same information as the port from which you established the link. Any leftover ports remain yours to configure. Note: Each kind of port (contact-closure, 0-10V, 0-24V) can only be linked with other ports of the same kind. However, it is possible to have unlinked ports configured differently from one another: for example, you could have a contact-closure input and a 0-10V input on the same N3 Satellite. Aside from linking ports, you can use this dropdown to configure a port for vacancy or occupancy mode in order to control master brightness. Occupancy mode can be used with an occupancy sensor to configure two scenes: one to be triggered when occupancy is detected, and one for when it’s not detected. Vacancy mode is similar, but only offers one scene selection. The “Master Brightness On/Off Triggers” and “Master Brightness Off Trigger” profiles will set the master brightness of the targeted groups to 0% for Off and 100% for On. If you are using these profiles in conjunction with a show, you will need to check Enable Master Brightness Override in the show’s configuration. See Configuring a Show: Enable Master Brightness Override, page 49. When you’re happy with your configurations, click [NEXT]. (5) Build the scenes to be triggered. For each trigger state, you can configure one scene using Scene Builder. 33 P A R T 2 : OPERATIN G AN IN STALLATION Triggers dropdown Configure scene Fig. 2.35 The Triggers dropdown (see fig. 2.35) allows you to select which trigger state you’re configuring. Each of the listed trigger states corresponds in binary to the contact closure port or linked ports. For example: the image above comes from a Three Port Linked Mode analog input, which gives you seven possible trigger states. 000 would represent a trigger where each of the three ports is in its normal state (open or closed) — and since 000 in binary equals 0 in decimal, Trigger 0 (Default) means all ports are normal. 111, on the other extreme, would represent a trigger where all ports are in their switched state—and since 111 in binary equals 7 in decimal, Trigger 7 means all ports are switched. Fig. 2.36 34 P A R T 2 : OPERATIN G AN IN STALLATION Fig. 2.36 After choosing one of the trigger states to configure, look in the Scene Settings panel and create a new scene or copy a previous one. Then use Scene Builder to build the scene. Building scenes is discussed in detail in Assigning a Scene, pg. 25. When you are happy with your settings, click [Next]. (6) Build scenes to be triggered by any remaining ports. Note that whichever port you are configuring will be colored blue in the display at left, as in fig. 2.37. Afterward, click [Next]. Triggers dropdown Configure scene Fig. 2.37 35 P A R T 2 : OPERATIN G AN IN STALLATION (7) Review the summary and publish your settings. Click [PUBLISH ANALOG IO] to save your configurations to your devices. Your changes will take effect as soon as they’re published. You can also click [EDIT] to return to port configuration. For more information on publishing, see Publishing, page 54. Setting Up 0-10V or 0-24V Inputs To configure your N3 Satellite for 0-10V or 0-24V inputs, follow these steps: Fig. 2.38 (1) Select the N3 Satellite you want to program. Your list of N3 Satellites can be found in the Devices panel, as in fig. 2.39. Note: At this step, satellites will not identify themselves by flashing LEDs when selected. (2) Choose the Analog I/O tab in Integration. Fig. 2.39 36 P A R T 2 : OPERATIN G AN IN STALLATION Note: If that tab is grayed out, it is because devices in your installation need firmware updates.See Tech Tool: Firmware Update, page 65. (3) Configure the first port’s voltage, input, and current. To configure the first port, use the dropdown to choose the voltage you’d like to use. In the next dropdown, choose Input. Finally, use the dropdown below to choose whether the port is Current Source or Current Sink. See fig. 2.40. (4) Select a profile for the first group, or link it to other ports. In the dropdown at right, you’ll see variety of options, including profiles and port links. Profiles control parameters for your groups, with each component of the profile requiring one port. For example, the RGB profile uses three ports; those three ports will be interpreted as red, green, and blue values based on their voltage, all adding up to determine the colorf your lamps. Other options include occupancy mode,which can be used with an occupancy sensor to configure two scenes: one to be triggered when occupancy is detected, and one for when it’s not detected. You can also set up a delay before the scenes take effect. Vacancy mode is similar, but only offers one scene selection. Instead of choosing a profile, you can link your input ports, although this is uncommon for non-contactclosure inputs. Like with a contact-closure port, a single 0-10V and 0-24V input port can recall two scenes; in combination, they can recall more. Next to each port-linking option is a statement of how many scenes it can recall. Note: For best results, configure your external device to output either 0V or 10V. This will ensure that the N3 Satellite correctly interprets the signal and triggers the scene you want. Linked ports are automatically and immutably configured with the same information as the port from which you established the link. Any leftover ports remain yours to configure. Note: Each kind of port (contact-closure, 0-10V, 0-24V) can only be linked with other ports of the same kind. However, it is possible to have unlinked ports configured differently from one another for example, you could have a contact-closure input and a 0-10V input on the same N3 Satellite. When you’re happy with your configurations, click [NEXT]. (5) Select groups to control with the profile. Each group will adopt the parameters of Fig. 2.40 your profile. (6) Optional: If you have linked ports, build a scene for each trigger state. Because linking would be an unusual application of 0-10V or 0-24V inputs, this option will not be discussed in detail here. Refer to Setting Up Contact-Closure Inputs: step 5, page 33. (7) Review the summary and publish your settings. Your changes will take effect as soon as they’re published. 37 P A R T 2 : OPERATIN G AN IN STALLATION For more information on publishing, see Publishing, page 54. Setting Up Analog Outputs On Ketra’s N3 Satellite, analog output—including contact-closure and 0-10V outputs—is controlled based on scenes; the N3 Satellite receives wireless input from a keypad and then broadcasts a signal to lamps. To configure analog output, follow these steps: (1) Select the N3 Satellite you want to program. Your list of N3 Satellites can be found in the Devices panel. Note: At this step, satellites will not identify themselves by flashing LEDs when selected. (2) Choose the Analog I/O tab in Integration. Note: If that tab is grayed out, it is because devices in your installation need firmware updates. See Tech Tool: Firmware Update, page 65. Fig. 2.41 38 P A R T 2 : OPERATIN G AN IN STALLATION (3) Configure the first port. Choose between contact-closure, 0-10V, and 0-24V; then choose Output. If you are configuring a contact-closure output, choose whether it is normally open or closed. Conversely, if you are configuring a 0-10V or 0-24V output, choose whether the port is a current sink or a current source. You now have the option to name your output. This is the name you will use when assigning settings and scenes. When you’re satisfied with your configurations, click [Next]. Note: After clicking [Next], you will see a page dedicated to configuring your port. Because you have chosen Analog output configuration, you can skip this screen by clicking [NEXT] again until you get to the summary page, pictured in fig. 2.42. (4) Review the summary and publish your settings. Your changes will take effect as soon as they’re published. (5) Return to the Keypads tab of Device Control. Your outputs will be visible in Group Assignments, as in fig. 2.43. Note: You will also be able to add your output fixtures to Scene Builder in the Device Control category “Shows”, which has a tab on the far-left side of the screen. Fig. 2.42 Fig. 2.43 39 P A R T 2 : OPERATIN G AN IN STALLATION (6) Configure scenes or shows using your outputs. In Scene Settings, pictured in fig. 2.44, create a scene or choose to edit an existing one. Fig. 2.44 Fig. 2.45 When you advance to Scene Builder, you can add your outputs along with lamp groups, as in fig. 4.45. If your output is 0-10V, you can configure fade rates and output voltage (which is on a percentage scale from 0 to 10V). If your output is contact-closure, choose whether it should be on or off. (7) Publish your settings by clicking [PUBLISH THIS KEYPAD]. Your changes will take effect as soon as they’re published. For more information on publishing, see Publishing, page 54. Configuring Dimmers Ketra X2s equipped with onboard ELV dimmers are capable of modulating the power supply to non-Ketra loads, such as fluorescent or incandescent bulbs. The Dimmer tab in Integration contains a couple of advanced and purely optional configurations. You will only need to use them if: • You want to set high or low trims for non-Ketra lights. • You want to use different dimming curves for non-Ketra lights. 40 P A R T 2 : OPERATIN G AN IN STALLATION Dimmer tab Configuration pane Fig. 2.46 To configure an ELV dimmer, follow these steps in the Dimmer Configuration pane, which is pictured in fig. 2.46: (1) Assign a new Dimmer Name. This is optional. The name is what you will refer to the dimmer by when you are building a scene or show with it later. (2) Set a Dim Curve. Three curve options are available: Ketra, Linear, and Square Law. The default is Ketra. Certain load types look better with certain curves; for example, CFL lamps look best with a linear curve, while incandescents look best with square law. Linear dimming curves match input with voltage so that a 10% increase in intensity leads to a 10% increase in voltage. Square law dimming curves enhance the visibility of intensity adjustment at low levels. Ketra’s dimming curve is exponential; see the graph on page 19. Note: Recall that any Dim Curve selected here will apply only to your non-Ketra lamps. Only incandescents can match the Ketra dimming curve. Dimmable CFLs will work with the X2, but you should not expect them to match dimming curves. (3) Set trims. Setting non-default trims will affect the fade curve of non-Ketra lamps. Dimming curves do not simply cut off at specified trim values; instead, the curve is adjusted proportionally so that the entire curve fits between the high and low trim values. If all your non-Ketra lamps have the same trim values, this adjustment ensures that they fade with the same duration; however, since their curve has been modified, it also means that they will not match the fade curve of Ketra lamps. Setting a high trim limits the maximum output of a lamp, and can therefore extend the lamp’s lifespan. 41 P A R T 2 : OPERATIN G AN IN STALLATION For some kinds of lamps, low trims are necessary because the lamp is not capable of dimming as low as a Ketra lamp; in particular, fluorescents and non-Ketra LEDs often need low trims, while incandescents usually do not. To find the proper low trim value for a lamp, start at 50% and edge down in increments of 5%. You will see the load dim as the X2 restricts its power, and at some point the lamps may turn off or start to flicker. Your low trim should be the value right above where they turned off or started to flicker. If you get all the way to 1% and the lamps have not turned off or started to flicker, the load does not need a low trim. (4) Publish your settings by clicking [PUBLISH DIMMER]. Once published, your settings will take effect. For more information on publishing, see Publishing, page 54. DEVICE CONTROL AND SHOWS Shows—also referred to as “time trigger shows”—are dynamic lighting solutions that work by triggering changes in your lighting over a period of time. You can think of shows as consisting of three layers: (1) The show. This is the term for the whole body. The show is a collection of triggers playing over a given period of time. (2) Individual triggers. These are the times at which changes in your light will take effect. (3) Scenes. These are the actual changes that take effect: each trigger makes your lamps play a certain scene. There is a 1:1 ratio of triggers to scenes; the scene is what’s being triggered at a given time. In Design Studio, you are able to determine the timing of triggers, the stretch of time over which they take effect, the shifts they prompt in your lighting, and whether there are any overrides for special occasions. To begin configuring shows, go to the Shows tab in the left sidebar of Device Control. Note: If you are programming the installation’s first show, enter your city’s name in the field pictured in fig. 2.47. Design Studio will determine your precise location within your timezone, in order to determine the exact time of sunrise and sunset at your location, by the day. After entering your city, you will be taken to the default show screen, pictured in fig. 2.48. Fig. 2.47 42 P A R T 2 : OPERATIN G AN IN STALLATION 3 layers to a show: The show (Scenes will go here after you’ve created triggers.) The triggers Fig. 2.48 To establish a show, use one of the three options at the bottom of the Shows panel at left: • Create Show: This will make a blank show that you will program in full. Because of the complicated nature of programming shows, this option is recommended for advanced installations only. • Create Natural Show: A natural show comes with built-in time triggers and is pre-designed to be circadian. You will be able to edit any of these settings. • Import Show: Import shows you’ve exported previously, or import some of Ketra’s pre-made shows. (In these pre-made shows, Ketra has already created individual triggers and set color configurations for you.) You will be able to edit any default settings.. Note: You can rename a show at any time by double-clicking on its name in the Shows panel and typing a new one. You can also delete a show at any time by right-clicking on the show in the Shows panel and selecting Delete, or clicking [ERASE] within the show’s configurations page. Creating a Show To create a new show, click [Create Show] at the bottom of the Shows panel at left. New shows are blank by default, meaning you have full rein to program them however you want. See important steps in Configuring Shows, page 47, and Programming Shows, page 49. 43 The scenes P A R T 2 : OPERATIN G AN IN STALLATION Creating a Natural Show To create a natural show, first click [Create Natural Show]. This is found at the bottom of the Shows panel at left. Creating a natural show will open a small window with basic configuration options, as in fig. 2.49. You can change any configurations you set here later on, by using the corresponding controls in the show’s configuration page. To fill out this window’s forms, follow these steps: (1) Select the settings you would like for your natural show. Here you can: • Set the poles of the spectrum your light will evolve upon over the course of the day. CCT refers to warmth of color; Intensity refers to brightness. Note: CCT stands for Correlated Color Temperature and is measured in Kelvin. As CCT rises, your light follows the curve of a black body locus. Fig. 2.49 Your lamps will peak in CCT and brightness 35 minutes after sunrise, and stay at that setting until 30 minutes before sunset. This can be changed once the show has been built. • Set Morning and Evening Transition Start Times. These can be configured as astronomical or fixed-time. Note that the time dropdown at right only applies if you pick Fixed Time. Astronomical: In the natural world, sunrise and sunset happen at unique times every day. Ketra shows on the Astronomical setting will automatically retrieve these times, and configure each day’s lighting to correspond to them: as the sun rises, the intensity of your lights will rise; at sunset, your lights will dim to match the light outside. You will notice this more as seasons change. Fixed Time: A natural show configured as fixed-time will transition at times that are constant from day to day. The show will still be circadian, but it will not always match the light outside. For example, your lamps might imitate sunset every day at 6 pm, even if sunset actually falls at 5 pm that day. (2) Name your trigger. You can name your show to help differentiate it from others. (3) Pick lamp groups to apply the natural show to. Select one or multiple from the list of all your lamp groups. (4) Click [Build Natural Show]. This creates your show with time triggers programmed for you. The result is pictured in fig. 2.49. 44 P A R T 2 : OPERATIN G AN IN STALLATION Fig. 2.50 Note: The image above came from an Astronomical natural show. If you chose Fixed Time instead, the contents of your triggers list (pictured in fig. 2.50) will look slightly different. Astronomical triggers are measured in minutes-from-sunrise or minutes-from-sunset. For example, if a trigger were set to Sunset using the event dropdown, and -4:00 using the time offset dropdown, it would take effect four hours before sunset. By contrast, Fixed Time triggers are given individual times when they will take effect. (5) Complete additional configurations. The configurations that are still necessary for you to complete are Show Control, Run Frequency, Show Override, and Enable Master Brightness Override. See Configuring Shows, page 47. (6) Optional: Edit triggers within the natural show. To edit one of your triggers, highlight it in the triggers list. In the Scene Builder pane at right, you can set color configurations for each group. The interface for this is identical to that of building a scene in the Keypad tab. See Assigning a Scene > Configure each fixture > Configuring a group, page 26. (7) Optional: Click [PUBLISH SHOWS]. If you have already completed the additional configurations outlined in step 5, you can click this button to publish all shows you’ve created. Importing a Show You can import shows that you have exported previously, or shows that Ketra has designed for you. Clicking [IMPORT SHOW] will open a small window, as in fig. 2.51. 45 P A R T 2 : OPERATIN G AN IN STALLATION (1) Select the show file you would like to import. Click [Choose File] to select the file from a list. This will direct you to a folder in which there are a number of time triggers curated by Ketra—including Fixed Time and circadian (Astronomical) shows—along with any you’ve exported in the past. (2) Name your show. (3) Select groups to assign the show to. All your lamp groups are displayed here. Select one by clicking on it. (4) Click [Import Show]. Design Studio will quickly recreate the show, as in fig. 2.52. Fig. 2.51 Fig. 2.52 (5) Complete additional configurations. The configurations that are still necessary for you to complete are Show Control, Run Frequency, Show Override, and Enable Master Brightness Override. See Configuring Shows, page 47. 46 P A R T 2 : OPERATIN G AN IN STALLATION (6) Optional: Edit individual triggers within the imported show. To edit one of your triggers, highlight it in the triggers list. In the Scene Builder pane at right, you can set color configurations for each group. The interface for this is identical to that of building a scene in the Keypad tab. See Assigning a Scene > Configure each fixture > Configuring a group, page 26. (7) Click [PUBLISH SHOWS]. If you have already completed the additional configurations outlined in step 5, you can click this button to publish all shows you’ve created. Note: A show set to Disable will be published, but it will not become active until you change its setting in Show Control and re-publish. Configuring Shows Once you have created a blank show or natural show, or imported a show, you need to give it some basic configurations. All shows need to know the three three things listed below—but note that natural shows and imported shows come with step 3 completed for you (but still available for you to edit). (1) Tell your show when to run. This needs to be done for all shows, whether they are brand new, natural, or imported. • In the Show Control section, you will determine whether your show will run at all times or only when triggered by a keypad button. See Show Control, page 48. • In the Run Frequency section, you will determine the days and times that you show will operate, as long as it is triggered. See Run Frequency, page 48. (2) Tell your show how to run. This needs to be done for all shows, whether they are brand new, natural, or imported. • In the Show Override section, you will determine whether your show can be overridden by other shows that might take priority. See Show Override, page 49. • With the Enable Master Brightness Override checkbox, you will determine whether intensity commands by DMX or a 0-10V dimming signal can override your show’s master brightness. With the box checked, for example, a 0-10V signal could set brightness to 50% so that you show would never rise above 50% brightness. (3) Tell your show what to run. This does not need to be done for natural or imported shows, as those come with the programming done for you. • Program your time triggers to determine the specific triggers your show w ill run. See Programming Shows, page 49. 47 P A R T 2 : OPERATIN G AN IN STALLATION For locations of each of the fields you should configure or program, see fig. 2.53. Show Control • Disable: This saves your show but deactivates it. It won’t run until you change its Show Control setting to something else and re- publish. This is useful if you have a show reserved for a Fig. 2.53 special occasion. • Run Always: This tells the show to run regularly. Note: Run Always shows are ideal for groups that are not also being controlled by keypad. If a group is being controlled by keypad, Select Show ID is more appropriate, since Run Always shows can’t be initiated or deactivated by a keypad button. The only way to deactivate a Run Always show is to open Design Studio, select the show, and set it to Disable. • Select Show ID: This tells the show you are going to assign it to a keypad as a show. The show will only be activated when you press the corresponding button on your keypad; if you then press a different button, the show will stop. If you choose Select Show ID, pick a Show ID to give your show. You will reference the ID when you assign your show to a keypad. Note: Selecting Show ID enables you to assign the show to a keypad button, but it doesn’t automatically assign it for you. See Assigning a Show, page 26, for instructions on assigning shows to keypads. Run Frequency Below the Show Control pane is one where you decide the default frequency of your time trigger. You can configure your show as one of the following: • Daily: Determine which days of the week your show will run. Days of the week turn blue when they’re selected, and white when they’re deselected. For example, in fig. 2.54, Monday, Wednesday, and Friday are selected. Fig. 2.54 48 P A R T 2 : OPERATIN G AN IN STALLATION • Date Range: Set a range of dates for the show to run, using the two calendars. You can also choose days of the week to run. In fig. 2.55, a show is configured to run every Monday, Wednesday, and Friday Fig. 2.55 between June 13, 2016 and June 1, 2017. • Monthly: This option lets you repeat the show in a certain week of every month. Here, too, you can pick days of the week that you want your show to run, as in fig. 2.56. Fig. 2.56 Show Override By default, shows don’t know about each other; they just run at their given times, even if it means overruling another show. If you want to make your current show take precedence over another show, check Show Override and select the other from the dropdown. Enable Master Brightness Override By default, shows control the assigned groups’ master brightness. That means a show will override brightness commands from DMX-enabled or analog-input devices. To prevent your time triggers from overriding a third party’s brightness commands, check Enable Master Brightness Override. Programming Shows In the previous section, you told your show when and how to run. In this section, you will tell your show what to run by setting the individual triggers that make up the show. Note: Programming time triggers is important for blank shows only. Natural shows and imported shows come already programmed. See fig. 2.57 for the locations of programming options: There are essentially two parts to programming a show: setting its time triggers, i.e. the times at which your show will change your lighting, and customizing the changes that will go into effect. The scenes The triggers Fig. 2.57 49 P A R T 2 : OPERATIN G AN IN STALLATION Setting Triggers You’ll notice that there are three tabs in the triggers list: Time, Astronomical, and Loops. These are the three types of trigger you can set. • Time-Based Triggers: See fig. 2.58. Each of these is a specific time at which your show will trigger lamp changes. Use the [+] button to add times; remove times by highlighting one and clicking [-]. You can change the time of a trigger using the dropdown, the increment buttons, or by clicking on the time and typing a new one. • Astronomical Triggers: Unlike time-based triggers, astronomical triggers don’t require you to give specific Fig. 2.58 times. Instead, your triggers have time offsets from sunrise and sunset; Design Studio will retrieve the exact times of sunrise and sunset in y our city every day. This is ideal for circadian shows, where you want your light to evolve in parallel to the natural light outside. In fig. 2.59, the show will trigger changes at sunrise and at four hours after sunrise, then again at four hours before sunset and at sunset. Use the [+] button to add times; remove times by highlighting one and clicking [-]. Note: For accelerated creation of an astronomical-based show, click [Create Natural Show] at the bottom of the Shows list. • Looping Triggers: Loops repeat after an amount of time Fig. 2.59 provided by you. Each loop consists of multiple triggers. You w ill add individual triggers, and then determine how they fit together in a loop. To understand loops better, you might consider that timebased and astronomical triggers are essentially also looping triggers: they take effect at given times every 24 hours. There is only one functional difference when you’re programming looping triggers: you get to decide the duration of the loop. There is an example below. Fig. 2.60 50 P A R T 2 : OPERATIN G AN IN STALLATION Each of the undefined triggers in fig. 2.60 at right has just been added using the [+] button. To define a trigger, select it and click the [Timer] button to open the small configuration window. Each trigger needs to know the runtime of the loop it’s in (Loop every), how long to wait before starting (Start offset), and the range of times to be active (Starting at and Ending at). Note: The runtime must be a factor of 60 minutes. For example, your runtime could be 6 minutes, but not 7. For example, let’s create a six-minute loop with three triggers, where each trigger lasts two minutes. The loop will run all day, repeating every six minutes. (i) Starting with undefined triggers, highlight the first trigger and click [Timer] (see fig. 2.61). Set Loop every to 6 mins. Since this is the first trigger, set Start offset to 0 mins: this means that the first trigger will become active zero minutes into the loop. Starting at and Ending at both default to 12 am, meaning theloop will run all day. (ii) Highlight the second trigger and click [Timer] (see fig. 2.62). Again, set Loop every to 6 mins; Starting at and Ending at should remain the same as well. This time, change Start offset to 2 mins: this means that the second trigger will become active two minutes into the loop—i.e., after the first trigger gets its two minutes. (iii) Highlight the third trigger and click [Timer] (see fig. 2.63). Configure Loop every as you have done in the previous two examples. For this last trigger, Start offset should be 4 mins. Fig. 2.61 Fig. 2.62 Fig. 2.63 You now have a loop that repeats three triggers every six minutes, giving each trigger two minutes to run. Customizing Scenes for Triggers Each time trigger corresponds to a certain scene. The scene is what gets triggered at a given time. Note: The following instructions are identical to the ones for customizing scenes on Keypads, since Scene Builder is the same for keypads and time triggers. 51 Fig. 2.64 P A R T 2 : OPERATIN G AN IN STALLATION Fig. 2.65 To configure your scene, follow these instructions: (1) Create a new scene, or copy from a previous scene. See fig. 2.66. Note: If you have not created a scene elsewhere in this installation, you will not see the option to copy from a previous scene. If you are creating a new scene: Give your scene a name, and then click [Next]. Note that you cannot reuse names you have already used within one installation. If you are copying a previous scene: Select the previous scene’s name from the dropdown. Note that the dropdown only includes scenes you have used in this installation. Once you select a scene, you will have the ability to edit it or use it as it is. Any edits to made to the copy will not be reflected in the original. Copied scenes automatically use the same groups as the original. (2) Choose fixtures for your scene to control. See fig. 2.67. Fig. 2.66 52 P A R T 2 : OPERATIN G AN IN STALLATION Configure scenes Fig. 2.67 To add a fixture for control, use the [+] button. Note that each new item in the list of groups here will default to the first group in your installation, e.g. Group 1. You can change the group number by using the dropdown—or select an output fixture or dimmer if you have one. You can also get rid of a group for a scene by highlighting the group and clicking the [-] button. (3) Configure each fixture. • Configuring a Group: See fig. 2.67. For each group, the Scene Builder pane will allow you to control the lamps’ color settings, power status, and fade time. Power status determines whether the group is on or off in the scene. Fade time is the amount of time required to change from one color to another when a scene button is pressed. Note: The maximum fade time is 6000 seconds, or 100 minutes. To configure a group’s color settings, first select the group in the Scene Builder pane. At right, you have full access to the Manual Control, Content Library, and User Presets options detailed in Device Control and Groups, page 18. • Configuring an X2 Dimmer: If you have an ELV-dimming-model X2 in your installation, you will have the ability here to determine its output voltage in the scene to be triggered; the output voltage will determine how much power goes to a non-Ketra load on the same circuit as the X2 keypad, thereby determining the load’s brightness. 53 P A R T 2 : OPERATIN G AN IN STALLATION Note: Three additional features are available in Configuring Dimmers, page 40. There you can rename your dimmer, modify its dimming curve, and set trim values. • Configuring Analog Outputs: Creating Analog outputs and configuring scenes for them are discussed in detail in Setting Up Analog Outputs, page 38. • Configuring DMX Outputs: Creating DMX outputs and configuring scenes for them are discussed in detail in Tech Tool: DMX Output, page 66. (4) Program the remaining triggers in the triggers list. (5) Publish your settings. This saves your configurations to your keypad. Click [PUBLISH SHOWS]. For more information on publishing, see Publishing, page 54. Published Trigger Preview Note: This step will only be effective after you’ve published your show. Published Trigger Preview is at the bottom of the Schedule tab’s screen. When you click the play button, Design Studio will quickly play all of your show’s triggers, one by one, at a consistent step rate set by you (irrespective of any schedule configuration you’ve done). This way you can get a sense for what the transitions might look like. Exporting a Show In the Export tab, Design Studio gives you the option to save shows to files. The default save location is Ketra > Time Trigger Shows, where you will find some of Ketra’s pre-made shows. After exporting a show, you will be able to open it in other installations. PUBLISHING Publishing is vital because it saves configurations to your devices as default states. When powercycled, Ketra devices return to their default states; this means that if you’ve made any configurations since last publishing, those configurations will be forgotten by your devices when power-cycled. To receive their new defaults, the devices you are publishing to must be powered on. Fig. 2.68 54 P A R T 2 : OPERATIN G AN IN STALLATION Note: If your keypad incorporates a show with time triggers, there are some special things to be aware of. See Publishing to Keypads, below. Individual and Global Publishing Publishing is performed from the Device Control tab, using either of the green Publish buttons at bottom-right. You can either: • Publish individually. This does not necessarily publish to only one device or group; instead, it publishes one set of configurations rather than all configurations. For example, clicking [Publish Analog IO] will publish your Analog I/O configurations but not DMX settings, keypad settings, etc. This can save time if you’ve made changes to one set of configurations but not the others. Note: With the exception of publishing a single lamp group, individual publishes still require that you have all your devices turned on. • Publish globally. This publishes all configurations that you’ve made in your installation, regardless of whether they’ve changed since you last published. Because global publishing requires that Design Studio communicate with every device, it can take a long time. Individual publishing is recommended when you’ve just changed one set of configurations. Publishing to Keypads Publishing to keypads is slightly different because of the Publish Time Triggers checkbox, just to the left of the publishing buttons in the Keypads tab. Checking this box and publishing will ensure that changes made in the Shows tab get saved to your keypad. If you’ve already clicked [PUBLISH SHOWS] in the Shows tab, it is not necessary to check this box republish the shows here. There are two circumstances under which you should check Publish Time Triggers: (1) You have assigned new shows to your keypad. Since all shows incorporate time triggers, publishing a new show requires you to publish time triggers. (2) You have edited a show on your keypad. If for any reason you have made changes to one of your keypad’s shows (using the controls in the Shows tab), be sure to publish the new configurations. Under any other circumstance, it’s wise to leave the box unchecked, because of the amount of time required for publishing time triggers. If you are publishing configurations to a keypad but have made no changes to its shows—e.g. you only changes scenes—you can leave the box unchecked to save yourself time. 55 P A R T 2 : OPERATIN G AN IN STALLATION Problems while Publishing Design Studio may encounter errors while attempting to publish, in which case you will see a screen saying “There was a problem with configuring your devices,” as well as a list of the specific devices that failed to publish. Below each device in the list is a brief summary of why the device failed to publish, and recommended steps for fixing the problem. For an example, see fig. 2.69. Fig. 2.69 In this screen, you have the options to Ignore, Retry, or Retry All. • [Ignore] dismisses all errors while publishing. Note that any devices that failed to publish will not have your configurations saved to them. • [Retry] allows you to redo publishing for a specific device. First highlight the device in the list, and then click [Retry]. You may need to move closer to your device. • [Retry All] allows you to retry publishing for all devices in the problem list. I N S TA L L AT I O N S E T T I N G S : USER ICON AND SIDEBAR Clicking the user icon in the top-left corner of an installation opens a sidebar, pictured in fig. 2.70, with several important options. Fig. 2.70 56 P A R T 2 : OPERATIN G AN IN STALLATION Renaming an Installation You can rename your installation by double-clicking on its name in the Installation Name box. Deleting an Installation Deleting an installation removes it from your Existing Installations list as well as that of any user with whom you’ve shared it, and from the Customer Web Portal (http://www.my.goketra.com). When you click [DELETE] in the window pictured in fig. 2.71, your devices will turn red for 30 seconds to confirm deletion, before returning to their factory default settings. They will be removed from secure networks. Fig. 2.71 Note: Design Studio requires that all your devices be powered on when you delete the installation. It has to be able to communicate with the devices in order to deprovision them. If Design Studio can’t communicate with all your devices, the deletion will fail. If you’ve lost a device or a device is malfunctioning when you intend to delete the installation, see Tech Tool: Advanced Features: Delete a Missing Device, page 69. Exporting an Installation Note: If you have Internet access, grant other users access to installations by sharing, not exporting/ importing. See Sharing Installations with Other Users, page 7. Clicking [Export this Installation] will save your installation as a DAT file. DAT files can be imported directly into Design Studio; Design Studio will read the file and reconstruct the installation. See Importing an Installation, page 10. Note: Contact Ketra before importing an installation from an earlier version of Design Studio. The only recommended use case for exporting installations is sharing when you have no Internet access and cannot sync. You can export the installation and save the resulting DAT file to a flash drive, then immediately copy it to another computer. Note: This method of sharing can lead to loss of data if done improperly. Please continue reading. • Only share by exporting when there is no Internet access. • Only share by exporting in the case of an IMMEDIATE transfer between computers. • Do not edit an installation between exporting and importing onto the new computer. • Do not use more than one computer to edit the installation after exporting/importing. The problems with sharing by exporting come from the inability to sync without Internet. When the installation is opened on the new computer, Design Studio will recognize it as the same installation, not a separate installation with the same name. However, any changes made on a computer without Internet access will only be saved locally, not synced—i.e. they will not be visible on the other computer. Therefore, the two computers’ copies of the installation can diverge. When Internet connection is restored and both versions sync at once, only the one with the most recent timestamp will sync; the other will be overwritten and permanently lose its configurations. 57 P A R T 2 : OPERATIN G AN IN STALLATION Note: If you a) changed the network channel of a secure installation between exporting and importing, or b) converted a demo to a secure installation between exporting and importing, your devices’ unique provisioning will be overwritten and you will need to use Find a Device in Tech Tool. See Tech Tool: Find a Device, page 69. Then you can return to Design Studio, click [Add New Devices], and reprovision them. Replacing a Device Use Replace a Device when one of your lamps is no longer functioning and you have received a replacement device from Ketra. Note: Replace a Device is intended only for devices that are no longer functioning. If you mean to replace a functioning device, deprovision it in the Organization tab and provision the replacement device. See Organization > Managing Groups, page 14. (1) In the installation’s sidebar, click [Replace a Device]. Fig. 2.72 (2) Input the serial numbers of the old device and the new one. As in fig. 2.72, you have to enter the serial number of the old device, even if you have renamed it in Design Studio. (For renaming devices, see Discovering Devices, page 12.) Note: Serial numbers can be found on the devices themselves; all begin with the letter ‘K’ and have two letters followed by eight digits. (3) Ensure that your replacement device is powered on. Design Studio has to be able to communicate with it in order to provision it for your installation. (4) Click [REPLACE]. Exporting to CSV File Clicking this button will create a CSV spreadsheet with information about your installation, like settings and number of devices. CSV files can only be read by Excel or another spreadsheet application; they cannot be read by Design Studio. They are useful for record-keeping, like as-built documents. Converting a Demo to a Secure Installation (1) Ensure that all your installation’s devices are powered on. (2) In the installation’s sidebar, click Convert to Secure Installation. This opens a window like the one in fig. 2.73. Fig. 2.73 58 P A R T 2 : OPERATIN G AN IN STALLATION (3) Select a channel for your secure installation. When selecting a channel, keep in mind that adjacent secure installations should be on different channels, to prevent interference. For more information on demos vs. secure installations see Creating an Installation, page 8, or reference the terms using the Glossary, page 70. Changing Network Channel (Secure Installations Only) This feature is useful if you have adjacent secure installations. Although each secure installation is on a unique communication network, adjacent secure installations using the same channel may experience interference. It is therefore recommended that adjacent installations use different channels. Fig. 2.74 Note: As explained by the message in fig. 2.74, iIf you change the network channel without all of your devices plugged in, they will become unable to communicate because they’re still on the old channel. To resolve this issue, see Tech Tool: Advanced Features: Find a Missing Device, page 69 . 59 P A R T 3 : TEC H TOOL 60 P A R T 3 : TEC H TOOL Not only a useful tool for troubleshooting, Tech Tool offers you more advanced controls over your products than Design Studio does. After opening an installation, you have the abilities to add or remove specific G2 emitters from groups, update firmware, configure DMX outputs, and perform advanced installation management functions. Note: Tech Tool only saves locally, instead of syncing. Changes made in Tech Tool will take effect on your devices, but—because they are not synced—other users will not immediately be able to see the changes in Design Studio. Changes will not be synced from your computer until you reopen Design Studio. Opening Tech Tool Opening Tech Tool requires that Design Studio be closed. Opening an Installation in Tech Tool To begin, select an installation from Tech Tool’s copy of your Existing Installations list, as in fig. 3.1. Just like in Design Studio, opening an installation will prompt Tech Tool to re-establish connection to that installation’s devices. Note: If Tech Tool fails to re-establish connection to your devices, it will give you an error message with the options to Abort, Retry, or Ignore, as in fig. 3.2. If you click [Ignore] on this message, the devices that failed to communicate will not physically reflect the changes you make, and will not be able to receive published configurations. After connection has been re-established, you will see the default page for an installation in Tech Tool. Fig. 3.1 Fig. 3.2 61 P A R T 3 : TEC H TOOL The triggers Diagnostics Diagnostics Fig. 3.3 You can return to Tech Tool’s Existing Installations list at any time by clicking [Select a Different Installation…]. Toolbar: File, Tools, and Help The toolbar at top of the page gives you a handful of options. • File: Here you have the option to exit Tech Tool. Exiting Tech Tool does not trigger a sync. However, your changes will sync as soon as you open Design Studio. • Tools: Here you can access to an install wizard that will walk you through installing new drivers for your control devices. If you don’t have up-to-date drivers, your controllers won’t be able to receive firmware properly by USB cable. • New drivers are themselves installed with a USB cable connected directly to an X1 Keypad or N3 Satellite. • Help: This gives you basic information about Tech Tool, including the version you have. Running Diagnostics To open the Diagnostics tool, click [Run Diagnostics] on Tech Tool’s default screen. 62 P A R T 3 : TEC H TOOL In the Diagnostics window, when you click [Start], Tech Tool will: • Query every device in your installation for serial numbers and firmware versions. • Double-check returned information against a database of known information for a given installation. • Tell you exactly what the problem is, if it finds one. The problem will be listed at the bottom of the output. For example output, see fig. 3.4. Note: You can use the [Copy To Clipboard] button in Tech Tool’s diagnostics window to automatically copy the data. You can then paste that into an email to Ketra’s technical support staff at support@ketra.com. Technical support is available Monday through Friday (barring national holidays) between 9 AM and 5 PM, Central Standard Time. Emitter Grouping Fig. 3.4 Fig. 3.5 Note: If, unlike in fig. 3.5, some of the checkboxes on your screen are checked, it is only because the default group has G2-family luminaires. Whereas Design Studio treats all luminaires connected to a single N3 Satellite as essentially one lamp, Tech Tool allows you to control not just each linear fixture but also each one of the six emitters per fixture. This is useful if, for example, you want every other fixture to respond to one button on a keypad, and the remainder to respond to a different button. 63 P A R T 3 : TEC H TOOL Note: While you can change group memberships in this area of Tech Tool, you must use Design Studio to change colors, intensities, and dimming curves. Checkboxes in this window represent individual emitters on G2-family luminaires. If a box is checked, it means that the emitter is part of the group you have selected. To add or remove linear fixtures or emitters from a group, use the dropdowns that come directly after Select By to determine which addresses you will apply changes to. Refer to fig. 3.4 for locations. (1) Select a group or make a new one using the [Create a New Group] button. You can either add or remove emitter addresses from this group. The group does not need to have linear fixtures already. If the group already has linear fixtures, you will notice that for each fixture attached to a given N3 Satellite, all six checkboxes will auto-check. Note: The [View Group as Published] button at bottom will help you identify which lamps in your installation are part of a certain group. All lamps in the group will temporarily turn green, while all lamps not in the group will temporarily turn red. (2) Choose whether to add or remove. This determines whether you are putting addresses into the group or subtracting them from the group. (3) Choose a range of addresses to add or remove. A “run” is all the luminaires connected to a single N3 Satellite, while a “fixture” is each individual foot of luminaire. So choosing Entire Run in this dropdown will add to or remove from the group all fixtures attached to the selected N3 Satellite, whereas choosing Odds will add or remove all odd-numbered emitters per fixture to or from the group. Note: You can also manually check or uncheck boxes to control whether those emitters are part of your group. (4) Choose a start and end fixture. This enables you to apply your addition/removal to only a specific range of luminaires attached to an N3 Satellite, rather than the entire run. 3 1 5 2 4 Each checkbox is a linear emitter 6 Fig. 3.6 64 P A R T 3 : TEC H TOOL (5) Click [Apply]. You will notice that the checkboxes become checked or unchecked depending on what you’ve selected in the dropdowns. Your installation will not change yet; this only applies the changes to the mockup display lower in the window. (6) Publish your changes. Clicking the [Publish and Save] button will confirm your settings and alter your Design Studio installation to reflect your changes. Your changes will take effect in the lamps themselves at once. Firmware Update Fig. 3.7 As shown in fig. 3.7, this feature lists all the devices in your installation and tells you whether they need a firmware update (in the Status column). The list offers a couple of important features: • You can identify lamps. To the right of each device in the list is a button that causes the lamp to identify. Lamps will turn a bright blue and controllers will flash their onboard LEDs. • You can uncheck lamps. By default, Tech Tool will update every device’s firmware. You can remove devices from this agenda by unchecking their boxes in the column labeled “Update?”, to the left of each device. You must also select an update method using the dropdown at left. Each possible method gets a brief description and estimated duration in the box below the dropdown; note that updating by USB cable is much faster than updating by wireless. You can: • Update from your PC: Tech Tool will administer wireless updates to one device at a time. Tech Tool must remain open on your computer throughout the updates. 65 P A R T 3 : TEC H TOOL Note: Wireless firmware updates will use the maximum amount of bandwidth available on a network. The amount of time required for wireless update varies from device to device: Lamp: 5-7 min X1 Keypad: 20-30 min X2 Keypad: 5-7 min N3 Satellite: 20-30 min N3 Satellite with Luminaires: 30-35 min • Update from a control device: Tech Tool will update a controller by USB connection or wireless, and that controller will then wirelessly update other devices. Note: In picking which controller to update, Tech Tool will first check for any USB connections; if none is found, Tech Tool will update the first controller it discovers by wireless communication. • Update USB connected device only: Tech Tool will update a single device by USB connection. Updating by USB cable is faster than doing it wirelessly. When you have finished planning your updates, click [Start]. Note: You may not be able to update a controller by USB if it has old drivers. You can update a controller’s drivers by clicking Tools > Install X1/N3 Driver... . For the most part, devices remain operable while they are receiving the update. Lamps and keypads will flash once as they reboot into the new application, but otherwise stay responsive to control; N3 Satellites will become unresponsive for a few minutes, but otherwise stay responsive. At any time, you can click the [Refresh] button to view the current update status of your lamps. DMX Output In the DMX Output tab pictured in fig. 3.8, you can direct your N3 Satellite to act as DMX master. Fig. 3.8 66 P A R T 3 : TEC H TOOL Follow these steps: (1) Choose an N3 Satellite to configure. To do this, use the dropdown after Satellites:, as in fig. 3.9. Fig. 3.9 (2) Decide between DMX slave and DMX master. Tech Tool’s default configuration for N3 Satellites is DMX slave, not master. If you want the device to remain a DMX slave, simply click [Save Current Configuration To Satellite], and skip to step 8. (3) Click [Add New Profile]. Adding a profile will automatically change the “DMX slave” field to “DMX master.” (4) Configure your profile. As in fig. 3.10, choose from the dropdown of supported profile types, and select a starting channel. Make sure the checkbox next to the profile dropdown is checked if you want your configurations to be saved to the N3 Satellite. Fig. 3.10 Note: Whatever channel you choose to start from, Tech Tool will reserve a certain number of the immediately following channels, based on how many channels are required for your profile. For example, an RGB 8-bit profile requires the use of three channels, so if you choose to start with channel 1, Tech Tool will reserve channels 1-3; if you choose to start with channel 510, Tech Tool will reserve channels 510-512. (5) Name your profile. (6) Optional: Add additional profiles. Click [Add New Profile]. You can then select the new profile’s type. The next available channel will be populated in the list, and any channels that you’ve already used will not appear. Note: To delete a profile or profiles, select the ones you want to delete using the checkboxes at left, and then click [Delete Selected]. You can also click [Delete All Profiles]. 67 P A R T 3 : TEC H TOOL (7) Publish your settings. When you’re happy with your configurations, click [Save Current Configurations To Satellites] at the bottom of the window. This sends your DMX settings to the device. (8) Return to Design Studio. Close Tech Tool, and open your installation in Design Studio. Your outputs will now be visible in two places: • The Group Assignments tab in Device Control > Keypads. (In fig. 3.11, they are “profile 00” and “profile 01”.) • The Scene Builder pane in Device Control > Keypads > Keypad Assignments, and Device Control > Shows. Fig. 3.11 Check the boxes for your profiles and click [SET] . (9) Assign your DMX out fixtures to scenes. In Keypad Assignments, select a scene and add your profiles to it using the [+] button in Scene Builder, as in fig.3.12. (10) Edit your scene’s DMX content. Highlight one of your profiles and click [Edit DMX Content]. The number of sliders corresponds to the number of channels for the fixture. For example, in the case of an RGB 8-bit fixture, there will be three sliders. Use each slider to select a value, or type a specific value into the box if you know what value you’d like. You can also choose a Fade Rate in seconds. Fig. 3.12 68 P A R T 3 : TEC H TOOL (11) Publish your settings. When you’re happy with your settings, click [Publish This Keypad] to save your settings and send them to your devices. After publishing, all elements of a scene—including lamp groups and DMX out fixtures—will take effect simultaneously at the push of your keypad button. You can also control DMX output features with the intensity buttons on your keypad. Advanced Features In this tab of Tech Tool, there are several more functions, including: • Delete a Device. This is intended for removing malfunctioning or uncommunicative devices from your installation. For removing a function device from your installation, read about deprovisioning in Managing Groups, page 14, and Managing Keypads and Satellites, page 15. To delete a device, select it u sing the checkboxes and click [Delete Selected Devices]. After deleting, you do not need to publish or save settings; simply close Tech Tool if you’re done. • Find a Missing Device. This tool searches private networks for any devices that has lost communication with the rest of your installation. It will find lamps that a) have been deprovisioned, or b) Design Studio has no record of. Note: Find a Missing Device should only be used if you have a secure installation, as it will be searching private networks. In demo installations, lamps are not on private networks, so Find a Missing Device will not find them. After finding your device, you can deprovision it to ensure that Design Studio will be able to discover it again. Return to Design Studio and to your installation’s Organization tab. Click [Add New Devices]. You should see the missing device. 69 P A R T 4 : GLOSSARY 70 P A R T 4 : GLOSSARY Black body locus (or Black body curve): In physics, the natural arc of colored light that a very hot object emits as it heats up. Objects heated to relatively low temperatures emit a red glow—but as they continue to heat to 10000K (see Kelvin) and above, their emission is brighter and bluer; this is why the hottest flames (like those that welders use) are blueish white, not red. Objects tend to follow the black body locus with some variation (see Correlated color temperature) as they heat. The locus itself is based on the heating of a black body, an idealized object that absorbs all electromagnetic radiation (EMR) and emits its own EMR at corresponding wavelengths. The black body locus is illustrated by the CIE 1931 color diagram, which Design Studio reproduces in its Manual Control pane in Device Control. Channel: An individual radio frequency band used for communication by KetraNet Mesh-enabled devices (see KetraNet Mesh). All KetraNet Mesh-enabled devices use a channel; the factory default is channel 25, but in a secure installation (see Secure installation in Installation) you are allowed to choose a channel. KetraNet Mesh-enabled devices are also on a communication network (see Network). Chromaticity: On a color diagram, refers to the x, y coordinates of a color. Unlike color space (see Color space), chromaticity is a two-dimensional measure because it lacks brightness. Color rendering index (or CRI): A quantitative assessment of the ability of a light source to illuminate an object without changing that object’s color. The highest possible index is 100, corresponding to natural light; Ketra lamps can illuminate objects with 90+ CRI when shining white light. Color space: A three-dimensional color configuration incorporating intensity as well as the two dimensions of chromaticity (see Chromaticity). Commission (v): To fully configure devices in an installation (see Installation). Can include programming scenes/shows (see Scene, Show), manually controlling groups (see Group), etc. Correlated color temperature (or CCT): The temperature in Kelvin (see Kelvin) approximately corresponding to a given point on or near the black body locus (see Black body locus). Since no object is a perfect black body, heated objects generally emit colors that fall close to but not on the black body locus in a color diagram; CCT is useful as a calculation of how hot the object must be given the wavelength it’s emitting. Design Studio calculates the CCT automatically for any color you choose in the Manual Control: White & Pastel section, since those colors are near the black body locus. Current sink: IEC standard 60929 Annex E, a control protocol for dimming ballasts, and the most common dimming protocol in architectural lighting. An N3 controller configured as a 0-10V output in current sink mode receives current from a ballast or driver and returns a voltage corresponding to the requested dimming level. The protocol calls for full light output when the control voltage is 10V or above. At 1 volt or less, the ballast or driver provides the minimum light level; some ballasts and drivers have a minimum light level of off, while others require a separate relay to turn off. Any voltage between 1 and 10 should correspond to a light intensity between minimum and maximum brightness. Current source: ESTA standard E1.3 Entertainment Technology-Lighting Control System - 0-10V Analog Control Protocol, Draft 9 June 1997, a control protocol for theatrical dimming consoles. An N3 controller in current source mode outputs (sources) voltage to a ballast or driver. 71 P A R T 4 : GLOSSARY The protocol calls for full light output when the control voltage is 10V or above. At 0V, the ballast or driver is off. Any voltage between 0 and 10 should correspond to a light intensity between minimum and maximum brightness. Default state: The state that Ketra lamps return to when power-cycled. Publishing (see Publish) sets new defaults for lamps. The factory default—i.e. the state that lamps return to if never published with alternate configurations—is 100% intensity, 3000K. Dimming curve (or Dim curve): Refers to the shape of the curve resulting from a graph of intensity power value vs. the perceived brightness of a light source. For example, see the model of Ketra’s exponential dimming curve on page 20. Design Studio allows for three types of dimming curve—Ketra, linear, and square law—which can be selected in the Dimmer section of the Integration tab. Linear and square law curves are commonly used by lighting designers. Linear dimming curves match input with voltage so that a 10% increase in intensity leads to a 10% increase in voltage. Square law dimming curves enhance the visibility of intensity adjustments at low levels; this is useful especially with incandescent lights, since by default much of their emission at very low intensity levels is in the infrared part of the spectrum, rather than visible. Discover (v): To search a wireless channel (see Channel) for a device or devices; to find a device or devices by wireless communication. Fixture: 1. A controllable unit in a scene or show (see Scene, Show), signifying a lamp group, Analog or DMX output, or dimmer. 2. (In Tech Tool) A luminaire (see Luminaire), as opposed to an emitter. Group (n): A collection of lamps/luminaires (see Luminaire) assembled by you in the Organization tab of Design Studio. Groups can contain any number of lamps/luminaires—including zero—as well as any mix of types. In Design Studio, you issue commands to groups, not directly to lamps/luminaires. (v): To add lamps/luminaires to a group. Installation: 1. The actual lighting solution in a given physical space. Can consist of multiple KetraNet installations (sense 2) networked together. 2. A single file in Design Studio, comprising all your devices grouped (see Group) for control as well as any configurations set to those devices. Installations are accessed from the Existing Intallations list in Design Studio. Roughly, the work flow for an installation (sense 2) goes: Discovery, Provisioning, Commissioning. (See Discover, Provision, Commission) Installations can be configured as secure or demo, and can contain up to 50 KetraNet Mesh-enabled devices (see KetraNet Mesh). Secure installation: An installation in which devices are provisioned to a unique and private network (see Network), on a channel (see Channel) specified by you. Devices will be inaccessible to other installations. Any permanent installations should be configured as secure. Demo installation: An installation in which devices are left on Ketra’s default network and channel. Other installations will be able to discover, provision, and commission the devices; if they do, you will not have exclusive control. Kelvin: The scientific standard unit for temperature measurement, where 0K = absolute zero. Ketra measures CCT (see Correlated color temperature) in Kelvin. 72 P A R T 4 : GLOSSARY KetraNet Mesh: Ketra’s system of wireless communication with Ketra devices. All Ketra devices--with the exception of luminaires (see Luminaire)--contain radio chips tuned to unique frequencies (see Channel). Luminaire: A generic term for any complete light that comes with housing, including G2 Linears, G2 Pendants, and Downlights. Some Ketra lighting devices--namely S30s, S38s, and A20s--don’t come with their own housing, and are therefore referred to as lamps instead of luminaires. Master brightness: The brightness limit of all devices in a group (see Group) or groups. Each device’s individual intensity setting changes in proportion to master brightness. For example, if you had a scene with group 1 at 50% intensity and group 2 at 100% intensity, setting master brightness to 20% would result in group 1 going to 10% intensity and group 2 going to 20% intensity. Master brightness is not set in Design Studio, but rather with a keypad intensity control, DMX master intensity profile, or 0-10V input master intensity profile. Network: A set of KetraNet Mesh-enabled devices (see KetraNet Mesh) that are able to communicate only with each other; devices on other networks will not be able to communicate with them. All KetraNet Mesh-enabled devices are on a network, just like all are on a channel (see Channel). For the difference between networks and channels, consider this example: Two installations (see Installation, sense 2), both on channel 15, each on a private network. Because they are on the same channel, their KetraNet Mesh-enabled devices are tuned to receive commands on the same radio frequency. However, because each is on a private network, each will ignore commands intended for the other installation. Node: A single KetraNet Mesh-enabled device (see KetraNet Mesh) in a network (see Network). An installation (see Installation, sense 1) can consist of 50 wireless nodes. A node may be a lamp or other device. Essentially, every KetraNet Mesh-enabled device is a wireless repeater, relaying signal to other devices on the network. An installation should have at least one wireless node per 50 ft of floor space. Provision (v): To add devices to a certain network (see Network) and channel (see Channel). Provisioning happens automatically when you group a lamp or luminaire (see Group). Publish (v): To save configurations and default states (see Default state) to your devices. Devices must be powered on to receive the data by wireless communication. From any page in the Device Control tab of an installation (see Installation, sense 2), you can publish individually or globally. Publishing individually saves one set of configurations (e.g. DMX or Analog) to the relevant devices, whereas publishing globally saves all configurations to all devices. Scene: A static configuration for your lights, activated by a control device such as a keypad or an Analog-enabled N3 Satellite. Show (or Time trigger show): A dynamic configuration for your lights involving triggers (see Triggers). Lamps shift between settings over time, and they continue doing so until another scene or show is activated. An example of a show would be a circadian lighting display that changes over the course of the day. Spectral power distribution (or SPD): A measurement of the power of a light source emitting each possible wavelength in the visible spectrum. SPD is the starting point from which other quantitative parameters of light, such as chromaticity (see Chromaticity), are calculated. Trigger: A component of a show (see Show). A trigger consists of a time and a scene; when the show is running, the scene will be triggered at the given time. A show can consist of any number of triggers. 73