Control4 HDL Driver

16-18 Pampisford Road Purley, Surrey CR8 2NE Office: +44 (0)20 8763 0739 Email: sales@incontrol-uk.com www.i-coders.com

Contents

Introduction .................................................................................................................................................... 2 Test before you install ................................................................................................................................. 2 Maintaining the Control4 lighting experience..................................................................................... 2 Using Control4 Keypads to control HDL lighting............................................................................... 3 Using HDL Keypads .................................................................................................................................... 3 Controlling single channels of light ..................................................................................................... 3 Setting Scenes .............................................................................................................................................. 3 Scenes in Control4 ................................................................................................................................... 4 Limitations ....................................................................................................................................................... 5 Copy the driver files ................................................................................................................................. 5 Add the cloud driver to your project.............................................................................................. 6 Adding Dimmable Lights ......................................................................................................................... 7 Adding Blind and Shades ........................................................................................................................ 8 IP Interface .................................................................................................................................................... 10 Test the Operation....................................................................................................................................... 11 Warnings ........................................................................................................................................................ 12 Troubleshooting .......................................................................................................................................... 13 Addressing ................................................................................................................................................. 13 Connections ................................................................................................................................................ 13 Activating the Driver .............................................................................................................................. 13 Purchasing a permanent license.......................................................................................................... 14 Limitations ..................................................................................................................................................... 14

Control4 HDL Lighting Interface

Introduction
The I-Coders HDL interface for Control4 allows you to control and mo nito r all single channel lighting functions of a single HDL network. In order to use this d r i v e r y o u must be competent in the i n s t a l l a t i o n and p r o g r am m ing of a HDL network. It assumes you have a good working knowledge of the HDL S-Bus Configuration Software and unde rst and the c o n c e p t s of functions and i n t e n s i t i e s. This driver i s what is known as a cloud driver. The cloud defines the HDL network to which you can a d d D i m m e d Lighting, Switched Lighting and M o t o r i z a t i o n Relays. When you add these elements to your project you have the ability to directly address them to match your functions within HDL.

Test before you install

You test deploy using this d r i v e r w i t h Control4 and HDL in your o ff ice or shop before you attempt to install on site. We strongly recommend that you follow the e x a m p l e s presented here in a demo environment to gain confidence with the s y s t e m . We will have little or no sympathy for anyone attempting to install this on a clients site without having tested it offsite first. We will provide support during UK hours: 9am to 5pm Monday to Friday. However we cannot guarantee that there will be someone for you to talk to the moment you call as we are a small company. We will attempt to answer any queries via email within 24 working hours, please create a support ticket via our website.

Maintaining the Control4 lighting experience

Our driver a l l o w s you to maintain the C o n t r o l 4 lighting experience and t r e a t s the H D L dimmers in the s a m e way as native Control4 lighting devices. All scenes of lighting are maintained within Control4 and t h e r e is no need to program the HDL system for anything other than direct control. However if you wish to define your scenes on the HDL network this is also p o s s i b l e .
Control4 HDL Lighting Interface

Using Control4 Keypads to control HDL lighting

Control4 keypads can b e used to control the H D L lighting. These can b e programmed to set levels, switch a circuit on or off or to recall a lighting scene defined within Control4. Each lighting circuit is associated with a channel. Within C o n t r o l 4 you can program a key on a Control4 keypad just as you would if you were using Control4 lighting products. Please refer t o the help included with Composer on how to program Control4 keypads to control lighting.

Using HDL Keypads

However it is more likely that the light switches in the p r o p e r t y will be HDL keypads and o ur examples later in this document assume this is the c a s e . Using t h e H D L keypads obeys the rule of using standalone subsystems wherever possible. If the Control4 system should fail for any reaso n the lighting in the p r o p e r t y should still work to a certain extent.

Controlling single channels of light

If a key on a HDL keypad is used to control a single channel of light it should be programmed in the u s u a l manner within the HDL S-Bus Configuration software. You can c h o o s e from any of the standard functions for dimming or switching the i n d i v i d u a l c h a n n e l s . As the levels on the lighting channels change they are reported to Control4. As you raise and lo we r the levels the sliders on the Control4 lighting screen will move accordingly.

Setting Scenes
You have the choice either of defining the scenes in Control4 or in HDL. The former requires some special coding for the HDL switches and w i l l also mean that scenes will only work when the C o n t r o l 4 system is installed and p r o g r a m m e d . The latter may require a D M X u n i t on the HDL system in order to store advanced s c e n e s but will ensure they are available before the C o n t r o l 4 system is commissioned.

Control4 HDL Lighting Interface

Scenes in Control4 If you want to set and maintain scenes within Control4 you can program these keys in the conventional manner. Scenes can also be programmed in S-Bus the conventional method, i.e. through the attached Dimmer, then selecting Scene Select and Area; as shown below.

Control4 HDL Lighting Interface

Limitations
1. Speed The HDL interface is not particularly high speed (even over a network connection). Large scenes can take a few seconds to send to the HDL network. Like scenes defined natively within HDL, when the levels change within a scene all the channels do not necessarily finish their changes of intensity concurrently. 2. Fade T i m i n g s HDL has fixed s p e e d s of fade. The Control4 interface shows more options than those built into HD L . The driver w i l l convert the C o n t r o l 4 fade time to the nearest available HDL fade time. 3. Popcorn Effect The HDL system is unicast. When a scene is recalled individual commands are sent out to each lighting channel. This means that channels will start fading one a f t e r a n o t h e r . This is the same behaviour that you would notice in a native HDL system.

Copy the driver files

You must copy all of the . c4i files in the z i p package to your M y Documents/Control4/drivers folder on your P C . If you fail to copy all four files the driver will not work. These drivers are the Controller this i s the m a i n clo ud part of the d r i v e r a n d t h e n the other lighting and b l i n d elements.

Control4 HDL Lighting Interface

Add the cloud driver to your project

First you need to add t he H D L cloud part of the driver t o your p r o j e c t . You only need to add o n e i n s t a n c e of this driver t o each project regardless of the number of lights, rooms or switches you may h a v e . Open Composer in System Design view find the IP I n t e r f a c e You can then find the item under: Device Type: -- others-Manufacturer: i-Coders Add the HDL UDP Cloud to your p r o j e c t For example: once added to the Home Cinema, it would appear as below.

Control4 HDL Lighting Interface

Adding Dimmable Lights

For each HDL dimmer circuit in the building that you want to control and monito r you need to add an HDL Dimmer to the c o r r e c t room in your p r o j e c t . These are found on the My Drivers tab under: Device Type: Light Manufacturer: i - Co d er s As each of these outlet lights are added to the project give them a recognizable name. This is the name that will identify the circuit on the touchscreens, OSD and r e m o t e control. When you have added the l i g h t s for a room you will end u p with a list similar to that shown on the right. Now fo r each of these circuits you need to define which channel number they are on the HDL Network. To do this, highlight the l i g h t in system design and o n the properties page. Now e n t e r the S- Bu s Su bn et ID, Dev i ce I D a nd Dev i c e C ha n nel ID to co rr espo nd to th e r el ev ant c hannel. Then p r e s s TAB and t he Set Cancel button pair will appear. Click the S e t button to associate this lighting circuit with the specified HDL lighting channel.

That completes the s e t up for a dimmable lighting circuit.

Control4 HDL Lighting Interface

Adding Switched Lights If you have lighting in the p r o p e r t y which is not dimmable (just switched on and o f f ) you can a d d t h i s as a relay. This will ensure that the c i r c u i t will appear on the lighting pages of the C o n t r o l 4 UIs but will not be shown with a dimming slider. To do this, add t he H D L Relay light interface rather than the Dimmer shown above. Then s e t the correct channel number and application to the circuit as shown above.

Adding Blind and Shades

As well as switched lighting you may a l s o be using HDL relays for other devices such as motorised blinds and shades. These elements should not appear under Lighting on the user interfaces but either under the Comfort or House pages. In order to do this we h a v e created and e l e m e n t called Blinds which can t h e n be associated with the C o n t r o l 4 motorization elements. Start by adding a HDL Curtain controller to the project. This is found under: Device Type Blinds Manufacturer - i-Coders. Double click this a n d t o add i t to the p r o j e c t .

You should now rename this t o match the device you are controlling. In this example we a r e using it to control a blind. You now need to associate this with the H D L channel address thats been assigned to this relay channel. As before simply type the c h a n n e l number in the b o x provided, press tab and t h e n click on the S e t button. 8

Control4 HDL Lighting Interface

We have now effectively created something similar t o the relay yo u would find on the b a c k of an HC300 controller. This wont appear on any of the Control4 user interfaces until we h a v e associated one o f Control4s elements with it.

To do this select one o f the e l e m e n t s from Co n t ro l4 s Motorization section under My Drivers. For this particular example we w i l l select the Blinds element from the list. Double click this and add this to your project. Then rename it to match the relay.

Switch to the Connections view and highlight the Blinds element the last item we added to the project.

You will see this has a Relay INPUT. You then need to connect this to the Relay OUTPUT of the HDL relay we defined earlier. Drag and drop the Input to the Output to make the connection. This blind will now appear in the correct part of the Control4 user interface.

Control4 HDL Lighting Interface

IP Interface
The i-Coders driver is only compatible with 1 IP interface port on the system. You will need to first confirm the S-Bus IP address and the Control4 IP address, the socket port interval is for the timed response to and from the S-Bus driver. (Using more than 1 IP interface port will cause the Controller to crash, and require a reboot.) This should not be set more than 1500 milliseconds, otherwise long delay will occur for all stacked up messages and possibly cause a controller crash.

Control4 HDL Lighting Interface

10

Test the Operation

Double click one o f the l i g h t s in your project and the Composer control window will appear. Here you can switch the light on and off. If it is a dimmer you can also set the level of the light and see this reflected on the light. You can also test items connected to HDL relays which should switch on when the level is set above zero (unless you have set a different switch on percentage for that channel within t he HDL software) You can move the dimmer slider to the desired position and when you let go the light will change to the selected intensity. Nothing happens whilst you are moving the slider. This is because Control4 only sends a light level command when the s l i d e r is released. Test all of your real HDL lighting channels before moving onto the next stage. Well test the channels that fire scenes when the scenes have been created.

Control4 HDL Lighting Interface

11

Warnings
Ensure S-Bus is connected before using Control4 for lighting If you do not have the n e t w o r k Interface connected to HDL and the Control4 controller Control4 commands will get stacked up. All the button presses, on/off level commands will be queued up by the controller until the connection is made. One of two things will happen. Either the Controller will create such a large queue of commands that it will crash, or when the HDL network is attached all of these commands will be sent to the HDL network. The client will then either think the house is haunted or the system is dangerous. If this happens then you should power-cycle the Control4 controller running Director.

Do not use more than 1 Network interface for programming You will need to first confirm the S-Bus IP address and the Control4 IP address, the socket port interval is for the timed response to and from the S-Bus driver. (Using more than 1 network port will cause the Controller to crash, and require a reboot.)

Control4 HDL Lighting Interface

12

Troubleshooting
There are three main c a u s e s of most problems with the operation of the interface.

Addressing
Make s u re that the c h a n n e l numbers you use in HDL are the same as the o n e s you associate the lights with in Control4. Ensure you have the correct Subnet ID and Device ID.

Connections
Check y o u connected the d r i v e r bo th physically and in Composer to the correct network port on your controller. Is the IP interface connected to the H D L network, is the IP interface lights flashing red and green? If not check your HD L network and reboo t the I P interface by disconnecting and r e c o n n ec t i n g the H D L cable. Now c h e c k by double clicking on one of the Outlet Lights in system design to see if it can be switched on and off. If the lights switch On and Off from the Composer interface the problem lies with the programming of the keypad. Work through the examples again. Other If other problems occur go through the process of disconnecting the HDL cable from the IP interface waiting and plugging it back in again. Then reiniti alize the interface from within Contro14.

Activating the Driver

Drivers will not work until they are activated. In order to activate a driver y o u must have a dealer account with us. You can r e g i s t e r at: www.i-coders.com

Control4 HDL Lighting Interface

13

Purchasing a permanent licence

To purchase a permanent licence login to your dealer account and m ake your purchase through our website. You will automatically receive your l ice nc e key within a few minutes of purchase. Your licence key will also appear in your dealer account.

Carefully copy and paste the Licence key into the Activation Key field and press Set.

Limitations
This driver has only been tested on the IP interface: SB-DN-1P i-Coders cannot guarantee it will work on any other variations or models.

Control4 HDL Lighting Interface

14