Crestron D3 Pro™ Reference Guide
This document was prepared and written by the Technical Documentation department at: Crestron Electronics, Inc. 15 Volvo Drive Rockleigh, NJ 07647 1-888-CRESTRON All brand names, product names and trademarks are the property of their respective owners. 2002 Crestron Electronics. Inc.
Crestron D3 Pro™ Software Contents D3 PRO™ .........................................................................................................................1 OVERVIEW ......................................................................................................................1 System Views..............................................................................................................2 Interface View.............................................................................
Adjusting Lighting Levels in Real Time..............................................................66 Conditional Statements ........................................................................................68 Global Variables ..................................................................................................72 Global Presets ......................................................................................................74 D3 Pro Scheduler ........................................
Crestron D3 Pro™ Software D3 Pro™ Overview Crestron D3 Pro™ software offers design, development, and documentation for home automation. The current version of D3 Pro provides all the tools necessary to create a complete lighting system, with additional support for auxiliary devices such as security systems, motion detectors and shades. D3 Pro Interfaces View The design aspect of D3 Pro enables you to easily organize each lighting system into areas and rooms.
Crestron D3 Pro™ Software The development aspect allows you to determine what actions occur when the user presses a button on a keypad, remote, or touchpanel. You can program actions to occur based on time of day, or when a contact closure is detected. Programming is accomplished using a simple yet powerful series of programming screens. Finally, D3 Pro allows you to document your project by creating attractive and easy to read reports.
Crestron D3 Pro™ Software Programming View The Programming View allows you to assign functionality to button presses and other system inputs, and to adjust lighting levels in real time. You can also schedule events according to the 24-hour or astronomic clock. Finish View Allows you to synchronize learned lighting levels, set Cresnet IDs, verify system communication, and generate the control system logic program. Finally, you can upload program files to the control system and user interfaces.
Crestron D3 Pro™ Software Import/Export Archive D3 Pro can compress system files for long-term storage or transfer to another PC. The compressed files are saved in .zip format. To archive a D3 Pro system, open the system and click Export Archive on the D3 Pro File menu. Browse to the directory where you want to save the file and click Open. The archive file will have the name "Export of system filename" with a .zip extension.
Crestron D3 Pro™ Software Load Wiring Report The Modules and Enclosures report gives a graphical representation of the slots on each Crestron enclosure, with the assigned modules and control system. Modules and Enclosures Report To print a report 1. Click Documentation on the File menu, or click the Generate Documentation toolbar button. 2. Select the desired report and click Create/View to launch the default Web browser. 3. Click Print on the Web browser’s File menu. Reference Guide – DOC.
Crestron D3 Pro™ Software Live Update Crestron Live Update allows you to easily download the latest software updates via the Internet. When you launch Live Update (on the Help menu) you will see a display list of Crestron software programs and databases. Live Update will compare the versions of the Crestron software on your PC with the latest versions available at Crestron. If a newer version of a program is available, that program will be checked off and "Update Available" will appear in brackets.
Crestron D3 Pro™ Software You can clear the check box next to a dependency, meaning that the un-checked file will not be downloaded. If you find that this causes the program not to work, run Live Update again and download the necessary files. After you select or clear the dependencies click OK to go back to the Live Update screen. Click Browse to select the location where the software will be downloaded. Then click Get Update. After download, open the file and run the installation program.
Crestron D3 Pro™ Software Creating a New Lighting System Set System Properties 1. Start D3 Pro and select New on the File menu, or click the Create New System toolbar button. 2. Click the General tab and select a control system, i.e., the PAC2, Crestron's specially designed processor for lighting applications. Enter the filename of the program in the System Name field. When you save your program, a subfolder is created with the name of the program in the D3 Pro \Systems folder.
Crestron D3 Pro™ Software control processor's NVRAM disk. To set where the system will store its runtime data and XPanel pages, select the Compact Flash or NVRAM button. Note that some processors do not provide a Compact Flash slot. Here both options will be disabled and all runtime data will go to NVRAM. D3 Pro supports the use of a "virtual" keypad called the Virtual CNX-B12.
Software Crestron D3 Pro™ Vary Playback: Adds randomness to the playback. (Specifically, the light levels will be played back at the sampled time plus or minus the recorded interval divided by 2.) Recording Interval: Determines how often the light levels are sampled during the recording period, and how often they are recalled during playback. The Vacation Scheduler is only capable of learning light levels, so circuits that have non-lighting load types such as ceiling fans cannot be learned.
Crestron D3 Pro™ Software Add Areas and Rooms An area defines a collection of rooms that are usually in proximity to each other, i.e., First Floor, East Wing, or Top Floor. Your first task in building a lighting system is to define each area, and then to assign rooms to those areas. In this way, you can organize your project and more easily find rooms in a large project. Organizing rooms into areas also makes it easier to configure groups within the Module and Enclosure Wizard.
Crestron D3 Pro™ Software System Views Interfaces View The Interfaces View allows you to add user interfaces and, depending on the interface, to set engraving attributes and faceplate/trim colors. The Interfaces toolbox includes Crestron CNX and C2N keypads, CLW wall dimmers and switches, hand held remotes, and touchpanels. CLW dimmers and switches also provide two "slave" interfaces, the CLW-SLVD and CLW-SLVS, with non-programmable buttons.
Crestron D3 Pro™ Software displayed for non-engravable interfaces such as CLW dimmers. If the interface is engravable, you can right-click buttons on the interface graphic and select engraving options from the submenu. You can also add text by double-clicking engravable areas. If you select a room from the system tree on the left side of the D3 Pro screen, the program detail area lists all the interfaces that you have added to that room.
Crestron D3 Pro™ Software You can drag any interface to a different room. To select multiple interfaces, press the Shift or Ctrl key while you click each interface. If you right click an interface in the system directory, you can select from the submenu to cut and paste, rename the interface, delete it or view its properties. Interface names must be unique throughout the system. Interface Properties Use the General tab to view or change general information about an interface.
Crestron D3 Pro™ Software If the device is a Cresnet device the Network ID is referred to as a Cresnet ID, or Net ID. If the interface is an Ethernet touchpanel, such as the TPS-5000 or TPS-6000 with TPS-ENET card, then the Network ID is referred to as an IP ID. In addition to the IP ID, you should enter the IP address of the Ethernet touchpanel. With wireless interfaces, such as the MT-500C, the Network ID is an RF ID. Here the RF ID identifies the wireless receiver, such as the CNRFGWA.
Crestron D3 Pro™ Software The Advanced tab allows you to re-compile a touchpanel project, which will overwrite any changes or customization done to the project in Programming View or Finish View. Select the Rebuild interface project check box and click OK to completely rebuild the touchpanel project from the selected template.
Crestron D3 Pro™ Software CNX AND C2N KEYPADS Crestron's CNX keypads provide 2, 4, 6, 8, or 12 buttons, while the C2N keypads come in 6, 8, or 12-button configurations. Only the buttons on the keypads are engravable. The CNX keypads also provide you with the option to exclude buttons from your order. For example, if you only want to engrave six buttons for a CNX-B12 keypad, you can remove the other six buttons from your order.
Crestron D3 Pro™ Software each other (click One Horizontal Field). Choose the latter if you want to use two different fonts within the same line. D3 Pro will verify that the text will fit within the margins of the button. If the text does not fit, an error message will be generated. CNRFHT-30A The CNRFHT-30A is a hand-held transmitter with up to 30 buttons. It provides the following options: Button color - You can change the color of selected buttons as follows: 1.
Crestron D3 Pro™ Software To combine text areas 1. Verify that Show Text Area Outlines is enabled on the right-click submenu. 2. Click each text area while pressing the Ctrl key. (You can only group two text areas at a time.) 3. Right-click and choose Combine Text Areas from the submenu. 4. If you have two long text areas in one row, you can repeat steps 2 and 3 to create one text area that stretches across the entire row. 5.
Crestron D3 Pro™ Software 2. Click OK to save your settings. D3 Pro will verify that the text you entered will fit within the margins of the engravable area. If the text does not fit, an error message will be generated. 3. You can right-click and select Show Lines on the submenu to display any lines you have drawn. (You can hide the dotted lines that show engravable areas by toggling Show Text Area Outlines on the right-click submenu.
Crestron D3 Pro™ Software Load Schedule View The Load Schedule View allows you to add loads, also called controlled circuits, to your D3 Pro system.
Crestron D3 Pro™ Software You can add a generic fixture in a number of ways: • Drag the generic fixture from either library in the Fixtures toolbox to a room. • If you select a room in the system tree, you can also drag the fixture from the toolbox onto the Load Schedule area in the center of the screen. • To add multiple fixtures, hold down the Shift key while you drag the fixture from the toolbox to a room. Then select the number of fixtures you want to add.
Crestron D3 Pro™ Software You can right-click any fixture you have added to cut, copy and paste, rename or delete the fixture. You can also activate the Trace tool (see page 83).
Crestron D3 Pro™ Software Create a user-defined fixture 1. Open the desired library, Global or Project. As described earlier, global fixtures are available to any project you create on your computer, while project fixtures are available only in the current project. 2. Right-click a fixture category and select Add. 3. Enter the name of the fixture and select a load type from the list. 4. Enter the fixture wattage. This is the default, per fixture, wattage. 5.
Crestron D3 Pro™ Software Valid values for Lower Limit range from 0% - 45%. For Upper Limit, valid values range from 55% - 100%. For non-dimmed fixtures, upper and lower limit values are fixed at 100% and 0%. For 3-wire motor loads, you can select advanced motor properties. Max Time sets the maximum time that the motor can remain in the Open or Close state.
Software Crestron D3 Pro™ Valid values for Jog Time range from 0.05s to 2.00s. Lockout Time sets the minimum time that the motor must remain in the "stop" state before changing directions between "open" and "close." If the motor is commanded to move in one direction while it is moving in the opposite direction, the motor will stop for seconds before moving in the new direction.
Crestron D3 Pro™ Software Controlled Circuit Properties The Load Schedule screen displays the properties of each fixture in the form of a grid consisting of various categories and text fields. You can move from one field to another by pressing the arrow keys. If you select a room, the Load Schedule lists all the fixtures you added to that room. Similarly, you can view all the fixtures in an area or in the entire system. If you click a column header the fixtures will be sorted by that category.
Software Crestron D3 Pro™ the light levels in real time (see page 67). Note that this option is only available with lighting loads. If a controlled circuit is using a generic fixture, any field in the grid can be edited; with user-defined fixtures only the emergency, fixture wattage, fixture quantity, and total wattage and dim properties can be edited. Name – D3 Pro automatically assigns a unique name to each fixture.
Crestron D3 Pro™ Software Magnetic Low-voltage; Electronic Low-voltage; Neon Cold-cathode; and Fluorescent Dim (2-Wire). Emergency – This check box allows you to specify that a given fixture should be connected to a module supplied by an "emergency feed". An emergency feed is a feed that will still have power (via a generator) when there is a power outage. Note that you cannot connect emergency and non-emergency circuits to the same control module.
Crestron D3 Pro™ Software button has been programmed to set the level to less than the lower limit, the light will stay at the lower limit, unless the light is instructed to go to 0%, at which point it will turn off. Valid values for Lower Limit range from 0% - 45%. For Upper Limit, valid values range from 55% - 100%. Override Level specifies the lighting level to go to when the modules are put into override mode.
Crestron D3 Pro™ Software Module and Enclosure Assignment View The Module and Enclosure Assignment View allows you to set up enclosures and attach controlled circuits to CLX modules and CLW dimmers and switches (but not slaves). This View provides a Module Assignment Wizard that handles the enclosure assignments and CLX module connections automatically. Alternatively, you can operate in manual assignment mode.
Software Crestron D3 Pro™ You can tell if a room has been added to a group by the "G" icon next to the room. To remove a group from the list, click the Delete button above the Groups list. To remove a room from a group, click Delete room from group. When you’ve defined all your groups, click Next. The Enclosures screen is where you specify the room in each group where an enclosure will be located.
Crestron D3 Pro™ Software When you click Next, the Finish screen will show the module and enclosure assignments the Wizard will make. To keep these changes click Finish. Note that this will overwrite all enclosure assignments and control module connections that were previously added. Once the Wizard completes the module and enclosure assignments you can select any of the components in the system directory on the left side of the screen.
Crestron D3 Pro™ Software Manual Assignment Mode In assigning connections manually, it may be helpful to generate a Load Schedule Report, which lists all the information given in Load Schedule View. In this way, you can keep track of all fixtures and load types. Step 1: Determine the type and number of control modules your system requires Crestron's CLX and CLW control modules support different load types and provide dimmed and non-dimmed output circuits.
Crestron D3 Pro™ Software You must select an enclosure with sufficient space to accommodate the control modules and control processor. When calculating the number of spaces, keep in mind that the PAC2 control processor requires two spaces on a doublewide cabinet and one space on a singlewide cabinet. Spaces are counted from the bottom up, and left to right on doublewide enclosures; that is, "Position 1" is the first space from the bottom of the enclosure.
Crestron D3 Pro™ Software Step 3: Select the location of the PAC2 control processor In the system directory, drag the PAC2 control processor from its default location to the enclosure. This will display a graphic of the cabinet in the program detail area in the center of the screen. The PAC2 will automatically be placed in Position 1 of a singlewide cabinet; or Positions 1 and 2 of a doublewide.
Crestron D3 Pro™ Software Step 5: Assign circuits to CLW wall-mounted dimmers/switches Select the CLW interface you want to connect. This will display a single output in the program details area. Click the arrow button next to the output and select the controlled circuit from the drop-down list—if a circuit is not compatible it will be crossed out. As shown below, this will turn the light bulb icon yellow, indicating that the circuit has been successfully connected.
Software Crestron D3 Pro™ Click the arrow button next to the output you want to connect, and select the controlled circuit from the drop-down list. If a circuit is not compatible with the module, it will be crossed out. As shown below, this will turn the light bulb icon yellow, indicating that the circuit has been successfully connected. This will also display the total wattage. Use the same procedure to connect all the controlled circuits in your load schedule to compatible outputs on each module.
Crestron D3 Pro™ Software Equipment View The Equipment View operates in two modes: Controlled Devices and Auxiliary Devices. Controlled devices are entities that communicate with the control processor, excluding the loads added in the Load Schedule View. Examples of controlled devices are low-voltage-relay-controlled devices, i.e.
Crestron D3 Pro™ Software any device by dragging it to the new port. And you can double click any device to view or modify its properties. Controlled Devices Mode In Controlled Devices mode, the system directory lists areas and rooms where you can add third-party devices or set up communication with a remote processor. To add devices 1. Drag the device from the Crestron or User Databases toolbox to a room.
Crestron D3 Pro™ Software 4. As you add devices, they will be listed in the program detail area in the center of the screen. The information here includes the name and manufacturer of the device, its location and I/O assignment. Device Properties You can double click a device to view or modify its properties. Here the General tab displays the manufacturer and model of the device, as well as the driver file that controls the device.
Software Crestron D3 Pro™ Click the I/O Assignment tab to view or change the port assignment of the device. If the device is controlled via IR, you can select a different port from the list. If the device is controlled serially, you can view or change the serial settings. The Properties tab lists parameters that are contained in the Crestron module that controls the device (not all devices have a Properties tab). Each parameter consists of a property with a corresponding default value.
Crestron D3 Pro™ Software Remote System Definitions D3 Pro is designed to create a standalone lighting system; that is, the lighting system program is not combined with other lighting programs, or with programs for audio/visual control. However, D3 Pro does provide communication and control methods that allow you to export specified devices to a remote Crestron processor via Ethernet.
Software Crestron D3 Pro™ the lights in that room (but not any non-lighting devices). If you select a room, the remote system can control all devices in the room, including interfaces and non-lighting equipment. 5. Click the Communication tab and enter the IP address of the remote system. The Export to IP ID value is the IP ID of the Ethernet Intersystem Communication symbol, which has to be the same in both the lighting program and the remote system program. 6.
Crestron D3 Pro™ Software 7. Save your lighting system program. This will automatically generate the RSD file that will be saved in a subfolder called \Remote System Definition in your system directory. To import an RSD file (import devices) 1. In the Remote System Properties dialog box, go to the Import Devices tab and click the check box next to Import devices from another system. 2. Browse to the directory containing the RSD file and click Open.
Crestron D3 Pro™ Software • You can adjust lighting levels in real time. Actions and Events The programming view allows you term programming defines the act of assigning one or more actions to one or more events. An event occurs when a device’s output exhibits a certain behavior, such as, goes from low to high. Most events in a D3 Pro lighting system occur when a button on a keypad or touchpanel is pressed, released, or held for a certain time.
Crestron D3 Pro™ Software button is held down. All other events (e.g. Release, Timeout, etc.) are "momentary" and are only active for a short time. (The concept of events being active only applies to digital commands, and has no effect on other command types, such as analog commands.) By making the default behavior to maintain the command, most devices will respond as desired with no user intervention.
Crestron D3 Pro™ Software User Interfaces If a user interface in your lighting program is a keypad or touchpanel with feature buttons, a graphic of the panel will be displayed in the center of the screen when you select it. You can program the hard buttons simply by clicking the individual button. This will display programming options on the right side of the screen. If the interface is a touchpanel you can access the touch screen page layouts by clicking the Launch VTPro-e button.
Crestron D3 Pro™ Software When you open VTPro-e, you can select a button and adjust its programming using the D3 Pro Programming dialog box. Keypad buttons are identified by their position, or button number, where "Button #1" is the top left position. The button numbers increase left to right per row and top to bottom. Objects on touchpanels are identified by the object type and join number. For example a button with join number 77 will be referenced as "Button (Join #77)".
Crestron D3 Pro™ Software When you select a button model, each event will be shown as a separate tab. You assign actions to an event by double clicking inside the tabbed area. The button model shown below provides two events, and thus two “event” tabs, for Press and Press 2, in addition to a Feedback tab.
Crestron D3 Pro™ Software PRESS/RELEASE The Press/Release button model triggers one set of actions when the button is pressed, and a different set of actions when it is released. In this way, you can assign actions to both the rising edge and falling edge of the button press signal. By default, this button model generates momentary feedback. The Press/Release button model provides two events: Press and Release.
Crestron D3 Pro™ Software pressing a button on another interface, the Toggle button will recognize the current state of the light level and fade the level back to 80% the next time the button is pressed. Similarly, if the lights are turned on by some other means, then the next press will turn the lights off (by triggering the Press 2 event). By default, this button model generates Toggled feedback. Suggested feedback for lighting: ON when ALL LIGHTS are at PRESET level.
Crestron D3 Pro™ Software Suggested Feedback: ON when ANY light in the preset is ON (to indicate that the timeout is in progress). You can use the Timeout button model for: • Turning off exhaust fans after a specified delay. • Turning off a light or closing a garage door a period of time after someone leaves the house. • Activating an alarm after a delay. SINGLE PRESS + DIM The Single Press + Dim button model adds dimming capabilities to the Single Press button model.
Crestron D3 Pro™ Software from the Control Button Group list, then only the buttons in that button group will affect the behavior of the Master Raise button. For example, consider a Control Button Group called "First Floor Lights" that consists of three buttons: "Den Lights", "Living Room Lights", and "Kitchen Lights". The group is selected as the control group for the Master Raise button.
Crestron D3 Pro™ Software LOCAL TOGGLE The Local Toggle button model only pertains to 1-way RF touchpanels such as the ST-1550C. It provides two events: Press and Alt Press. A Local Toggle button alternates between the active and inactive state with each button press, just as a standard Toggle button does. That is, the first time the button is pressed, the Press event is triggered; the next time it is pressed, the Alt Press event is triggered.
Crestron D3 Pro™ Software DEFAULT FEEDBACK The default feedback is the first option, and the description of this option will change based on the button model. Some button models do not provide a default feedback type. Otherwise the default feedback option will be selected automatically. STANDARD FEEDBACK You can override a button model's default feedback by selecting one of the standard feedback choices: Always On - The button's feedback is always active (e.g. LED is always lit).
Crestron D3 Pro™ Software ADVANCED FEEDBACK Linked to a device output - This type of feedback links the button's feedback directly to another device in the program. When you select a device from the Source Device list, the Output Signal list gives the digital outputs provided by this device. Once you select the device and output signal, the button's feedback will be active for as long as that output signal is high.
Crestron D3 Pro™ Software To add a button to a button group Click the button and select the group from the Button Group list. This will assign the current button to that group. Repeat this procedure for each button that will be assigned to the group. To designate the group as the "control group" for a Master Raise or Master Lower button, select the Master Raise or Master Lower button and then select the group from the Control button group list.
Crestron D3 Pro™ Software the Press 1 (On) tab. 2. As shown below, the Target directory lists all system devices by room. Every room also has a special device called "All Room Lights" that can be used to control all the lights (but not any non-lighting devices) in that room. This special device is convenient when you need to raise or lower all the lights in the room, or set all the lights to a common level. 3.
Software Crestron D3 Pro™ 6. The nature of programming lighting scenes is such that you may need to quickly and easily change the target values and fade times for the circuits in the scene. To facilitate this, you can click the Adjust Lighting Levels button at the bottom of the programming options area to switch to a special grid. This grid will contain a list of all lights (dimmable and non-dimmable) that are being controlled in the currently selected event.
Crestron D3 Pro™ Software 8. To edit an existing command, simply double-click the command to bring up the Edit Step dialog box. Edit the command as desired and then click Apply or OK to accept the changes. (Both buttons will apply the changes to the event tab, but the OK button will close the dialog box.) 9. Once you have defined commands, you can change the position of programming steps simply by clicking and dragging.
Crestron D3 Pro™ Software However, if you had set Upper Limit and Lower Limit values in the Advanced Lighting properties of the Load Schedule View, then those Upper Limit and Lower Limit values override the Target value and affect the fade time as well. In the example below, if you had set an Upper Limit value of 80%, the lights will reach their maximum level (80%) in 4 seconds. SWITCHED DEVICES Switched devices such as pumps or fans have two commands, On and Off.
Crestron D3 Pro™ Software GLOBAL PRESETS Global presets have two commands: Run and Cancel. The Run command starts all the actions defined in the preset. The Cancel command cancels any actions that have not yet been issued, i.e., steps with delays that have not yet come due (actions such as lighting fades that have already started are not affected). Global presets are described in detail later in this section.
Software Crestron D3 Pro™ You can paste logic to another button by right-clicking the button and selecting Paste Button Logic on the submenu. To copy and paste individual steps, right-click the command and select the desired operation from the submenu. You can cut, copy and paste the command to a different event, or you can delete the command. To work with all the defined steps for an event, right-click a blank area of the event tab.
Crestron D3 Pro™ Software Learnable Lighting As described earlier, two button models, Toggle and Single Press, provide a "learnable lighting" option that allows the end user to dynamically change and resave the lighting levels programmed to the Tap 1 (or Tap) event. To enable this feature select the Learnable Lighting check box in the Button Properties area of Programming View. Before building a system that includes learnable lighting buttons, you must specify where the run-time data will be stored.
Crestron D3 Pro™ Software Program other buttons on the keypad or touchpanel to allow the end user to manually adjust lights to the desired levels during run time. To adjust/save light levels during run time 1. Build and upload the lighting system. 2. Press the button you programmed in steps 1 and 2. Verify that the lights go to their programmed levels. 3. Using the other buttons programmed in step 2, adjust the lights to the new desired levels.
Crestron D3 Pro™ Software Schedule View, Module and Enclosure Assignment View, or Programming View. To adjust lights from Load Schedule View or Module and Enclosure Assignment View 1. In Load Schedule View, select the light you want to adjust and click the light bulb icon. Alternatively, in Module and Enclosure Assignment View, select the appropriate module, right-click the fixture you want to adjust and select Realtime Control. 2. To verify the connection, click Start Flashing.
Crestron D3 Pro™ Software 3. When you are satisfied with the light level, you can click Done to exit realtime control, or else you can click the Next or Prev buttons to adjust the next or previous circuit listed in the Load Schedule. To adjust lights from the Programming View 1. Select the button that controls the lights you want to adjust and open the event tab. 2. Click the Adjust Lighting Levels button at the bottom of the screen. 3. Select the Make adjustments in real time check box. 4.
Crestron D3 Pro™ Software Expressions can consist of the following elements: Logical operators < (less than) > (greater than) = (equal to) <> (not equal to) <= (less than or equal to) >= (greater than or equal to) Global Variables e.g., FrontGateStatus Device Outputs e.g., Bedroom Downlights On; or Dining Room Pendant Level (greater than 50%) Conditional steps are not allowed within synchronized events.
Software Crestron D3 Pro™ an analog value such as Current Level. In the previous example, the target is the Downlights in the Family Room, and the value to be tested is On. Thus, this conditional statement would select a path of execution based on whether the Downlights were On. If you select Current Level, then select a logical operator and value from the drop-down lists. In the example below, the expression will test whether the current lighting level of the chandelier is greater than 50%. 4.
Crestron D3 Pro™ Software closes the Edit Step dialog.) Once you have defined the expression, you can define the actions that will be triggered if the test expression results in true. 1. Double-click the red text, which should be positioned directly below the If clause and indented. If the red text appears in any other position, click the icon to move it to the correct position. Alternatively, click the New Step button on the Edit Step dialog if you didn't close the dialog. 2.
Crestron D3 Pro™ Software 4. You can use global variables in a conditional statement. In the example below, the conditional statement selects a path of action depending on whether you set the Home/Away variable to "Away". Global Variables A global variable allows you to access and modify a specified value from any statement in the lighting program. For example, you can create a global variable called "FrontGateStatus" with two possible values (or variable states), Open and Closed.
Crestron D3 Pro™ Software 2. Press F2 to rename the variable and the variable states to meaningful terms. For example, the name of the variable might be FrontGateStatus, and the variable states could be Open and Closed. 3. You can create as many variable states as required. Simply click the New button under Variable States. For example, you could add another variable state for FrontGateStatus called Offline. You can also change the order of variable states by clicking the up and down arrows. 4.
Crestron D3 Pro™ Software 7. This will add a "Set Variable" command to the event tab, as shown below: You can use global variables in a conditional statement. In the example below, the conditional statement selects a path of action depending on whether you set the front gate variable to "Closed". Global Presets Global Presets allow you to create a set of pre-defined actions that you can assign to any event. That is, you can assign the preset to any button or other system input in your lighting program.
Crestron D3 Pro™ Software 3. Double click inside the Preset Actions tab on the right side of the screen. This will open the Edit Step dialog box where you assign actions, step delays, and conditionals just as for individual buttons. To assign a global preset to an event Expand the Global Presets device in the Target list and select the preset. You can then assign the Run or Cancel command to control the actions defined in the preset. The Run command starts all the actions defined in the preset.
Crestron D3 Pro™ Software D3 Pro Scheduler The D3 Pro Scheduler allows you to trigger events at a specific time of day and to create basic, periodic, or custom "by date" schedules. In addition, users can adjust the properties of scheduled events via a touchpanel. Before building a system that includes Scheduler programming, you must specify the location where the run-time data will be stored.
Crestron D3 Pro™ Software 3. Select the type of schedule: Basic, Periodic or By Date. 4. Select the type of clock: Standard or Astronomic. 5. If you select the Standard clock, enter the time of day you want the event to be fired. If you select the Astronomic clock, enter an offset from Sunrise or Sunset. In the example below, the event will be fired 35 minutes after Sunset. (You can click the plus/minus button to toggle the offset mode.) Reference Guide – DOC.
Software Crestron D3 Pro™ 6. For Basic and Periodic schedules, select a run option. If you select Run from start to stop date, then enter a Start Date and Stop Date in the text fields. The event will occur daily at the scheduled time, including on the start and stop dates. If you select Run forever, the Stop Date will be dimmed and the event will be fired each day at the scheduled time, starting on the Start Date.
Crestron D3 Pro™ Software 8. With Periodic Schedules you can enter the fixed period. 9. If you create a By Date schedule, the Start Date and Stop Date will be dimmed and no run options are available. Here you can create an event calendar or edit an existing event calendar. To select the dates that will pertain to a calendar, select the check box next to the calendar and click Edit. 10. Select the dates you want to include in the calendar. When you click a date, it will appear in red.
Software Crestron D3 Pro™ 11. When you are satisfied with the calendar dates, click OK. 12. Once you have defined the schedule dates, you can program events by double-clicking the red text inside the Preset Actions tab. You can define actions, conditionals statements, and set global variables as usual. 80 • Crestron D3 Pro™ Reference Guide – DOC.
Crestron D3 Pro™ Software Editing Scheduled Events D3 Pro provides Scheduler templates that allow the end user to edit the properties of a scheduled event via a touchpanel. Using these touchpanel pages, end users can press buttons to scroll through the list of scheduled events, suspend individual events, or change the time events occur. (However, they cannot add or delete scheduled events or modify what the events do.
Crestron D3 Pro™ Software Record Period: Records lighting levels for the selected period, 1 or 2 weeks. When the period is over, a new recording period begins and the new values overwrite the old values. Vary Playback: Adds randomness to the playback. Specifically, the light levels will be played back at the sampled time plus or minus the recorded interval divided by 2.
Crestron D3 Pro™ Software Trace Tool The Trace tool allows you to quickly determine where loads and other controlled devices in your project are being controlled—that is, where they are programmed. For example, you can select the Living Room Downlights circuit and immediately determine which buttons, scheduled events, global presets, etc. are being used to control this circuit.
Crestron D3 Pro™ Software Finish View The Finish View provides the final steps to building your lighting system: • Synchronizing presets (retrieving learnable light levels that were adjusted by the end user). • Compiling the control system logic program and touchpanel projects. • Setting Cresnet IDs. • Verifying valid Cresnet network connections. • Uploading program files to the control system and touchpanels.
Crestron D3 Pro™ Software Set IP Information If you intend to communicate with the control processor via Ethernet you have to set up the processor’s IP information. Once you set up a serial connection to the control system, you can click Set IP Information on the Communications menu to set the control system's IP address, IP mask and default router address. Enter the values into the text fields and click OK to reboot the control system.
Crestron D3 Pro™ Software Sync Learned Lighting If you had previously uploaded a project that included buttons enabled for learnable lighting, the end user may have made changes to certain light levels without your knowledge. If you were to modify the project and rebuild and upload, you would overwrite those changed presets with the original levels stored in the program.
Crestron D3 Pro™ Software "Setup a new system", which allows you to discard any current configuration and set new Cresnet IDs for all devices; or "Skip to advanced setup", which allows you to bypass the step-by-step approach of the first two choices and brings you directly to a graphical drag-and-drop configuration screen. (Note that the other two options will eventually bring you to this screen as well). Make your selection and click Next.
Software Crestron D3 Pro™ Click Next to view the list of all devices (including those that are not touch settable) that have been defined in your project, but have not yet been configured. The information listed here includes the Cresnet ID assigned in the project, the name and type of device, and its location. If devices have been detected on the network, then all devices of this type will be checked off. You can check any additional devices you want to configure and click Next.
Crestron D3 Pro™ Software The Assign Device Network IDs screen displays a number of windows that give information about devices in the program, as well as the devices currently detected on the network. The Unassigned devices in the program list at the top left displays all devices that have been defined in the program, including non touch-settable devices.
Software Crestron D3 Pro™ The Unassigned devices on the network list displays all the touch-settable devices that D3 Pro has detected on the network. You can click Find All Unassigned Devices to poll the network again and refresh the list. The information here includes the current internal Cresnet ID of the device, its type, the type count and serial number. As you set valid Cresnet IDs for these touch-settable devices, they will be removed from this list.
Crestron D3 Pro™ Software When you bring all the devices you want to configure to the Touch list, click Start Touch Setup to put those devices into setup mode. All touch-settable devices will indicate when they are in setup mode in some way. Most will flash one or more LEDs. Go to each device in the order that it appears on the list. Look for an indication that it is presently in setup mode.
Crestron D3 Pro™ Software Build System The Finish View system tree shows all Cresnet, Ethernet and wireless devices arranged by type (or by room, if you have selected the Sort by Room option). The system tree lists the name of each device, its type, and its Network ID. Once you have connected the control system, touchpanels and lighting modules to the network and you have established communication to the PC, click the Verify Hardware button at the bottom of the screen.
Crestron D3 Pro™ Software Click Continue to finish the compile operation and upload the system. The program will be saved as an SMW file in the \Programs subfolder, and contains all the logic that enables communication between the control system, interfaces, controlled devices and other hardware. If any errors are generated during programming, they will be displayed in the Messages field. You can double-click a message for more information.
Software Crestron D3 Pro™ With touchpanels, various connection types are possible. If the panel project should be uploaded over Cresnet (via the control system), you want to specify the connection type and address (if over TCP/IP) of the control system. If the touchpanel should be uploaded directly over TCP/IP, the select TCP/IP as the connection type and enter the IP address of the touchpanel (NOT the control system). You must also select the Send directly to touchpanel checkbox.
Crestron D3 Pro™ Software process and prompt you to select the Cresnet ID of the wireless panel. Here you should temporarily connect the wireless panel to the network as described in the unit’s documentation. The Cresnet ID is the temporary “wired” ID that is used solely for uploading, and is not used during normal program operation. 5. After transfer D3 Pro will display information about each file, including the filename and status, i.e., successful or not successful.
Crestron D3 Pro™ Software Software License Agreement This License Agreement (“Agreement”) is a legal contract between you (either an individual or a single business entity) and Crestron Electronics, Inc. (“Crestron”) for software referenced in this guide, which includes computer software and, as applicable, associated media, printed materials, and “online” or electronic documentation (the “Software”).
Crestron D3 Pro™ Software If You are a business or organization, You agree that upon request from Crestron or its authorized agent, You will within thirty (30) days fully document and certify that use of any and all Software at the time of the request is in conformity with Your valid licenses from Crestron of its authorized agent. Without prejudice to any other rights, Crestron may terminate this Agreement immediately upon notice if you fail to comply with the terms and conditions of this Agreement.
Crestron D3 Pro™ Software Return and Warranty Policies Merchandise Returns / Repair Service 1. No merchandise may be returned for credit, exchange, or service without prior authorization from CRESTRON. To obtain warranty service for CRESTRON products, contact the factory and request an RMA (Return Merchandise Authorization) number. Enclose a note specifying the nature of the problem, name and phone number of contact person, RMA number, and return address. 2.
Crestron D3 Pro™ Software This page intentionally left blank. Reference Guide – DOC.
Crestron Electronics, Inc. 15 Volvo Drive Rockleigh, NJ 07647 Tel: 888.CRESTRON Fax: 201.767.7576 www.crestron.com Reference Guide – DOC. 5998a 8.03 Specifications subject to change without notice.
