Many right mouse click menus have been added to SIMPL Windows to increase
programming speed and usability. These include multiple device selection and
others.
Bookmarks
The bookmark feature allows programmers to bookmark a particular Detail View
setup. This can be very helpful and save time when working on larger programs.
The bookmark command will always bring you to the Detail View you bookmarked.
SIMPL+
SIMPL+ is a procedural programming language extension of SIMPL Windows. If
programmers have familiarity with procedural languages like C or BASIC, they will
be comfortable with SIMPL+.
Multiple Device Selection
SIMPL Windows now has the ability to allow programmers to specify the number of
devices with one drag and drop function (right click menu). Multiple Device
Selection is a great time saving feature when a design calls for 30 touchpanels!
ViewPort - Full Ethernet Support
ViewPort has many new features; the most notable is its full Ethernet support for
programming and diagnostics. All functions that can be performed with the
Viewport through a serial connection can now be performed with the Viewport
through Ethernet connection, with the exception of updating the TCP/IP stack.
Virtual Workspace
Virtual Workspace contains a small control pad that allows easy manipulation of the
viewable screen area. This control pad is called WorldView and shows you the
whole "program" and what part of it you are currently looking at. With a click of the
mouse you can change the view to see any other part of the program.
More Speed!
Crestron software designers are continually working to optimize SIMPL Windows
for the most speed possible.
Network Analyzer
Network Analyzer can function over the TCP/IP connection. Simply set your
communications to TCP/IP using the ViewPort or directly edit comminations from
SIMPL Windows. An automated analysis feature has also been added to the Network
Analyzer.
Improved HELP
SIMPL Windows help has been completely rewritten with the end user in mind. It is
logically written and methodically laid out with hundreds of index entries for easy
location of topics.
Crestron recommends starting a control system design by taking advantage of the
equipment lists and touchpanel layout pages in the Programming Design Kit DOC.
5277.
This kit provides the necessary tools to help develop a carefully designed system by
identifying what equipment is going to be controlled and in what manner. Design
sheets allow a programmer to list all equipment and control devices. Pages for
developing sample touchscreens are also included.
The Programming Design Kit will document the equipment to be controlled, the
control protocol, and the touch screen layout. Everything the programmer needs to
start the project is listed in the Design Kit.
VisionTools™ Pro-e
VT Pro-e allows programmers to create custom designed projects for touchpanels or
web browsers. By supplying SIMPL Windows with the VT Pro-e project name,
touchpanel designs can be brought into SIMPL Windows automatically. Each
button’s join number and text will be retained. This is a great time saving feature.
NOTE: Projects created with Crestron's older product, VisionTools™ for
Windows, are also supported.
Programming Process
Once the basic system is designed on paper using the Programming Design Kit and
the touchscreens have been created in VT Pro-e, the system programmer should
review the following process.
If you cannot locate specific information or have questions, please take advantage of
Crestron's award winning technical support team by calling:
• In the US and Canada, call Crestron’s corporate headquarters at
1.888.CRESTRON [1.888.273.7876].
• In Europe, call Crestron International at +32.15.50.99.50.
• In Asia, call Crestron Asia at +852.2341.2016.
• In Latin America, call Crestron Latin America at +5255.5093.2160.
• In Australia and New Zealand, call Crestron at +613.9480.2999.
Email Technical Support
Use the following addresses for Crestron Email technical support:
North America
• Support U.S. East – supporteast@crestron.com
• Support U.S. Central – supportcentral@crestron.com
• Support U.S. West and Canada – supportwest@crestron.com
International
• Support Outside North America – supportintl@crestron.com
Crestron on the World Wide Web
• www.crestron.com
Trademark Information
All brand names, product names, and trademarks are the sole property of their
respective owners.
SIMPL, SIMPL+, SmarTouch, and VisionTools, are trademarks of Crestron
Electronics, Inc.
Windows is a registered trademark of Microsoft Corporation.
Windows 95/98/Me/XP and Windows NT/2000 are trademarks of Microsoft
Corporation
The Crestron ControlCD is a design tool, packed full of all the latest software
technical information, and program examples. Contact Crestron to obtain a copy.
Crestron ControlCD
Insert the Crestron ControlCD into the PC's CD ROM drive and select Run…from
the Windows start menu. Type the letter for the CD-ROM drive and :\Setup.
Follow the directions provided.
Run…Dialog Box
Uninstall SIMPL™ Windows®
Follow the procedure in this section to remove SIMPL™ Windows from your hard
drive.
Users of the DOS Workshop are familiar with many of the previous symbol names.
This knowledge works to the programmer’s advantage in SIMPL Windows, in the
form of the SpeedKey feature. This option allows you a quick and easy method for
inputting symbols into your program.
Workshop users who are familiar with the names of their most-often-used symbols
can key them very quickly, hence the name SpeedKey. SpeedKey will let
programmers enter Workshop symbol names when building the program; SIMPL
Windows will then insert the new symbol name for you automatically, placing each
symbol or symbol subsystem directly into the Logic folder, as if it was manually
dragged there with the mouse. As each symbol name is typed it appears on the Status Bar. As long as the Logic folder in Program View is highlighted, you can add old or
new symbol names, with no case sensitivity.
KeyCombo Shortcut Table
The following table provides a convenient list of all keyboard and function-key
shortcuts for the SIMPL Windows Programming Manager. Each entry in the table on
the next page lists a keyboard shortcut, and the result it produces.
Bring Up Context-Sensitive Help.
Find next Symbol
Assign sequential names to highlighted Signals,
based on first Signal
Assign sequential names to highlighted Signals,
based on last Signal
Refresh window
Copy Input Signal to its Output, or vice-versa
Resize a Symbol (Detail View)
Next pane
Previous pane
Adds Inputs and/or Outputs one at a time
Removes Inputs and/or Outputs one at a time
Create new Signal name.
Add Inputs or Outputs in specified multiples
Select Inputs or Outputs in an upward direction,
from present cursor position to first Input or
Output.
Select Inputs or Outputs in a downward
direction, from present cursor position to last
Input or Output.
Select a variable range of Inputs or Outputs
Delete a Signal or Symbol
Delete a Signal, and highlight the Input or
Output below it
Add theSignalSuffix set in Prefs
Add theSignalSuffix set in Prefs
Add theSignalSuffix set in Prefs
Add theSignalSuffix set in Prefs
Add theSignalSuffix set in Prefs
Add a SignalSuffix when prompted
Communications
Cancels Edit Mode
Moves cursor between Inputs and Outputs
Result depends on particular combination of
keyboard shortcuts used.
Start
Create a new program
Create a new macro
Open a program or macro
Save a program or macro
Print
Cut
Copy
Paste
Paste Special
Undo
Find Symbol
Expand current node
Collapse current node
Close Detail View
Symbol Library
Program View
Toggle Both Views
Test Manager - Monitors digital,
analog, and serial signal activity
Easy to program, handled as part
of the TouchPanel
No limit to signal name length.
allows communication with User
Devices
Crestron SIMPL™ Windows Software
Importing Workshop Programs
Workshop programs can be imported to SIMPL Windows by turning them into a
macro, importing, and converting back into a program. This requires removing all
devices before turning the program into macro. In SIMPL Windows, import the
macro and replace the devices that were removed.
1. Make a backup copy of the Workshop program.
2. In Workshop, remove all the net devices, convert to a CNRACK, and delete all
the plug-in cards.
NOTE: If the original Workshop program contained macros, SIMPL Windows will
remove any indication of the macros and install all of the code that used to be within
the macros directly into the program. This can become a very tedious when
importing large programs. To preserve macros, import them separately into SIMPL
Windows by following steps 3-5 for each macro.
3. Install a GENERIC symbol in the Workshop program. In the comment section
type “PLACEHOLD”. This symbol will act as a placeholder for the macros
signal names.
4. Comment out the Workshop macro so it does not convert by selecting Alt+F1.
5. Transfer the signal names of the macro to the PLACEHOLD symbol. List the
signal names in the following format:
Output_1,
Output_2,
Output_3;
Input_1,
Input_2;
(Signal names are followed by a coma. The last signal either
output or input, is followed by a semicolon)
6. Install a DEFARGS symbol to make the program into a macro, then convert the
program, a ".imc" file will be produced. Workshop will remind user’s that there
are incomplete symbols and commented out symbols. This is acceptable, click
Yes.
8. Choose File | Convert To Program to complete the transfer.
9. Save the program by selecting File | Save. Replace the net devices and connect
the necessary signals.
10. In SIMPL Windows select File | Import a Workshop Macro. Import the
Workshop macro that was previously commented out. Save the macro as a User
Macro in SIMPL Windows.
11. Select the new User Macro from the SIMPL Windows Symbol Library and drag
it into the imported program.
12. In the imported program copy the signal names from PLACEHOLD symbol to
the new User Macro.
SIMPL™ Windows is an all-encompassing application. It is comprised of several
individual applications that interact to help users design, build, and program control
systems.
SIMPL Windows's main applications are Configuration Manager, Program Manager,
Test Manager and ViewPort. SIMPL Windows also integrates with Crestron’s user
interface design software, VisionTools™ Pro-e.
Each time SIMPL Windows is opened the “Quick Access Window” appears and
prompts users to select the first task.
Quick Access Window
The window asks you: "What do you want to do?" and presents four options:
1. Run SIMPL Windows Tutorial
2. Create a New Program
3. Open an Existing Program
4. Exit SIMPL Windows
Removing the QuickAccess Window
To remove the QuickAccess window, select the Don’t show this at startup box at the bottom
of the window and close the window.
Call Up the QuickAccess Window
QuickAccess Icon
Users can call up the QuickAccess window at any time during your program by clicking the
Lightning Bolt icon on the SIMPL Windows button bar, or selecting File | Start.
Set Directory Paths
The install process sets the directory paths, but it is important to make sure the paths
are correct after SIMPL Windows is loaded into your PC.
When a new program is started the "Program Header Information" window appears.
It is important to complete all the information, as it will be printed out on the
connection sheet.
"Program Header Information" Window
NOTE: Information entered into the Dealer Name and Programmer fields of the
"Program Header Information" dialog box are recalled from program to program
until SIMPL Windows is reloaded or upgraded.
After the "Program Header Information" dialog box is complete, click OK. SIMPL
Windows will ask if you want to configure the hardware for the system.
Configuration Manager is where programmers will “build” the control system by
selecting hardware from the Device Library. Configuration Manager can be opened
several different ways.
Configuration Manager
Opening Configuration Manager for a New Program
After a new program is started and the program header has been completed, SIMPL
Windows will display the “Configure?” window.
Configure? Window
Click Yes to open Configuration Manager.
Open Configuration Manager from Project Menu
To open Configuration Manager from the SIMPL Windows menus, select Projects |
Configure System.
Open Configuration Manager from Button Bar
Select the Configuration Manager button from the SIMPL Windows button bar.
The Configuration Manager consists of four separate view windows (three of which
are sub-windows of System Views).
Configuration Manager Main Window
Device Library
The Device Library is the master list of hardware components available to “build”
your control system. This list of devices allows programmers to select the hardware
and drag and drop it into the Network System View. These components, or devices,
are grouped functionally by device type. Expand the folder for the device you require
by clicking on the plus sign (collapse the folder by clicking the minus sign).
Device Library groups, with a brief explanation of each:
• Control Systems: The "brain" of each Crestron system; a Control
System contains the microprocessor, runs the operating system,
and executes the SIMPL Windows program.
• Ethernet Control Modules: This refers to the Ethernet expansion
cards.
• Expansion Module: This refers to the Crestron CNIORACK, a
device used to expand the functionality of the CNRACK by
providing for use of additional cards.
• Lighting: Various devices that make up lighting systems, all of
which connect to the Cresnet network.
• Local Control Panels: Plug-in cards that provide a button panel to
a Control System.
• Network Control Modules: Devices that connect to the Cresnet
network. Usually external devices.
• Plug-in Control Cards: Circuit boards that plug-in to an empty
card slot in a control system or other device. Cards provide
additional capability to a system.
• Plug-in Control Cards (CNX Series): Plug-in cards compatible
with Crestron generation X line of control systems.
• Plug-in DPA Modules (CNX Series): Plug-in cards provide Direct
Processor Access.
• Serial Drivers (General): General one or two-way serial devices
that require the user to provide string input and output information.
Use one of these devices if yours is not listed in the Crestron
Database.
• Power Supplies: Used to power your Cresnet network; it is
common to need multiple power supplies for a given system. It is
not necessary to add power supplies to the program. The power
supply symbols are included for documentation purposes such as
the Connection Sheet.
• Touchpanels (Wireless): RF touchpanels, one-or two-way, which
do not go on a Cresnet network, but require a wireless RF receiver
(see below).
• Wired Panels: User interface such as a button panel, that your end
user interacts with to control their Cresnet system.
• Wireless Receivers (IR): IR receiversused with IR transmitters.
• Wireless Receivers (RF): RF receivers used with RF transmitters
or RF touchpanels.
• Wireless Remotes (IR): IR transmitters.
• Wireless Remotes (RF): RF transmitters.
• User Devices: If your device is not in the Crestron or User
databases and you want to program the device yourself in detail.
• Crestron DB: Information about controlled devices Crestron
knows how to program; listed by device type, manufacturer, and
model. Crestron updates this database periodically; check your
version number to determine whether you have the latest installed.
• User DB: A place to store information about controlled devices
that have been created; and are not yet supported by Crestron. We
encourage programmers to send information on these devices to
Crestron so that they can be included in the next release of the
Crestron Database. The Database has thousands of driver files. We
want to be able to support as many devices as possible and
welcome your additions.
When Configuration Manager is opened, Network System View prompts the user to
begin by displaying the message:
"Start by dropping a Control System here…".
Network System View is where programmers start to “build” the system by dragging
over a control system from the Device Library.
Configuration Manager-Network Systems View
Network System View allows programmers a graphical representation of the entire
physical system. Programmers will see the back of the control system, including
empty card slots and built-in card slots. Network device icons (Cresnet and Ethernet)
are displayed in the space below the system. It may be necessary to use the scroll
bars to see all the network devices.
Detail System View
Detail System View offers the ability to display a graphical view of each module in
the control system. Select the module or port to display its configuration information.
Detail System View – CNXTVC-3 Module Configuration
The way systems are “built” is by dragging hardware from the Device Library and
dropping it into Network Systems View. Start with a control system and add the
necessary devices. The system devices should be identified in the design
specification or the Device List from the Programming Design Kit. Refer to the
Crestron ControlCD for compatibility and specifications.
Selecting Hardware
Locate the necessary hardware by opening the folder that contains the component.
Open the folder by clicking on the plus (+) sign. Highlight the device you want by
clicking on it. Drag it to the Network System View area by holding down the left
mouse button while dragging the device. Release the mouse button to drop the
device.
Selecting Control System
Once a control system is chosen it will always be displayed in the Network System
View. The next step is to add the other devices that comprise the system such as
network devices and additional plug-in cards. Macros for controlling hundreds of
different pieces of equipment are available in the User Devices folder under Crestron
Database. Crestron continually updates this database to include the latest macros.
SIMPL Windows guides programmers through the building process by continuously
providing feedback via the cursor. SIMPL Windows will not allow programmers to
install devices that are not compatible with the control system or other installed
components. The incompatibility is communicated to the user when the cursor turns
into a circle with a strike through it. SIMPL Windows will not allow a drop when the
cursor in this state.
Cursor Displaying an Impossible Drop
When SIMPL Windows displays the cursor as the standard pointer with an added
plus (+) sign, this is representative of a legal drop with full compatibility.
Devices are replaced by selecting a new device, dragging it into Network System
View, and dropping it on the device to be replaced.
Replace CNRACK with CNMS
SIMPL Windows will ask users to verify that a device is to be deleted. Click the
appropriate button.
Replace Device Confirmation
Configure System Control Devices
System control devices include plug-in control cards, network devices (NetDevices)
and drivers. These are system devices that control the A/V components and other
equipment.
Plug-in Control Cards
Plug-in control cards are added to a control system in the Configuration Manager.
Select the plug-in card from the Device Library and drop it into an open card slot in
the control system.
Configuration Manager will display the card in the slot it was dropped into. By
clicking the right mouse button, users can delete the card or configure. For this
example, choose Configure.
Configure Plug-in Cards
After selecting Configure, the “Device Settings” window is displayed. Several
parameters of control cards can be configured. The Name tab allows users to change
the name for easy identification (especially if multiple cards are used). The card slot
number can be changed under the Card Slot tab. The Connection Sheet tab allows
users to provide notes that will be printed on the connection report.
These devices are configured in the Configuration Manager. Select the system
control device and drag it into the control system. For this example a CT-3000
touchpanel is dropped into the NetDevices slot.
Drop Network Devices into the NetDevice Slot
Configuration Manager will display network devices as icons under the control
system. Users may have to use the scroll bars to view all the icons. Three CT-3000
touchpanels have been added for this installation.
The NetDevices can be configured or deleted by selecting the icon and clicking the
right mouse button.
Configure NetDevices
After selecting Configure, the “Device Settings” dialog box for the NetDevice will
be displayed. Several parameters of the NetDevice can be configured.
Name
The name can be changed under the Name tab (this is recommended if there is more
than one NetDevice of the same type). The Device Name tab also shows device
power consumption in watts.
The Net ID tab displays the network ID of the particular NetDevice.
Device Settings: Net ID Tab
UI Project (for touchpanels only)
The UI Project tab refers to the User Interface Project Name as given in
VisionTools™ Pro-e. Touchpanel designs from Crestron’s VT Pro-e software can be
referenced and brought into the SIMPL Windows program. Join numbers and
buttons are brought in when a UI project is specified. This feature can save an
enormous amount of typing and referring back and forth between VT Pro-e and
SIMPL Windows.
Device Settings: UI Project Tab
Chain (for touchpanels only)
NetDevices can be chained together under the Chain tab. Chaining means that
multiple touchpanels are programmed exactly the same. One touchpanel acts as a
‘master’ to which the others are chained.
Begin to chain by selecting one of the ‘slave’ touchpanels. Under the right mouse
menu click Configure and select the Chain tab. Select the Net ID of the ‘master’
panel.
After all the ‘slave’ panels have the ‘master’ Net ID set, select the ‘master’
touchpanel and view the Chain Tab. The Chain tab for the ‘master’ displays all the
Net Ids that are chained to it.
Device Settings: Chain Tab – Display Slaves
The device icons will appear with chains across them. This is the visual confirmation
that a touchpanel is chained to a ‘master’ panel.
Chained Touchpanels (04, 05) with Master (03)
Connection Sheet
The Connection Sheet tab allows free text to be entered with other helpful
descriptions. These notes are printed on the connection report.
User devices include CD players, VCRs, lighting controls and anything else the end
user interfaces with through the Crestron control system. These are usually the
devices that are being controlled.
Configuring an IR Controlled Device
Example (SONY CPC-303ES CD player)
Once installed, devices will need to be configured. For example, a device such as a
SONY CPC-303ES CD player is controlled with IR signals. The control system
specified for our design is a CNMSX-PRO which has a CNXIR-8 control card
installed from the factory. The CNXIR-8 is an IR card that has eight serial ports
available. Click on the CNXIR-8 to display the eight serial ports in Detail
SystemView.
Network View of CNMSX-PRO (top), Detail System View of CNXIR-8 (bottom)
Select the equipment to be controlled by the IR port A. In this example an IR driver
file for a SONY CCP-303ES CD player is selected from the Crestron Database. The
database is located in the User Devices folder of the Device Library. Click and drag
the SONY CCP-303ES and drop it into IR Port A of the CNXIR-8 control card.
Select Equipment to be Controlled and Drop into Appropriate Control Port
Right mouse click on the equipment to configure the device settings or delete the
device. For this example, select Configure.
Right Click to Configure or Delete
When Configure is selected the “Device Settings” window will be displayed. The
Device Settings dialog box allows the programmer to configure several parameters
of each user device, as well as record notes for the connection sheet report.
Much of the equipment in the A/V industry is controlled by serial communication
standards like RS-232, RS-422, and RS-485 for example. The control system
specified for our design is a CNMSX-PRO which has a CNXCOM-6 control card
installed from the factory. The CNXCOM-6 is a two-way serial card that supports
RS-232, RS-422, and RS-485. Click on the CNXCOM-6 to display the six serial
ports in Detail System View.
Network System View of CNMSX-PRO (top), Detail System View of CNXCOM-6 (bottom)
Some serial cards may have a default driver already installed. If this is not the
preferred drive, replace it by selecting another driver. Select the serial driver from
the Device Library. In this example a ST-COM/CNXCOM two-way serial driver is
selected. Click and drag the ST-COM/CNXCOM and drop it into Port A of the
CNXCOM-6 control card.
Select Serial Driver to be Installed and Drop into Appropriate Control Port
Right mouse click on the driver to configure the device settings or delete the device.
For this example, select Configure.
When Configure is selected the “Device Settings” window will be displayed. The
Device Settings dialog box allows the programmer to configure certain parameters of
each device, as well as record notes for the connection sheet report. Serial Devices
have an additional tab for Serial Settings. Baud Rate, Data Bits, Stop Bits, Parity,
Communication Standard, and Handshaking are all configured in the Serial Settings
tab. For the default settings simply click OK.
Devices can be deleted from Configuration Manager by selecting them and clicking
the right mouse button. Configuration Manager will display a choice box in which
you can choose either Configure or Delete.
Deleting a NetDevice
Configuration Manager will ask if you are sure that you want to delete the selected
device.
Delete Prompt
Users can also delete devices from the Configuration Manager’s System Device Tree.
SIMPL Windows displays a delete confirmation box. Select the appropriate button.
Confirming Deletion via the Device List
Automatically Configure Devices
The SIMPL Windows feature AutoFill automatically configures certain types of
devices. AutoFill automatically detects control system devices on your Cresnet
network, then configures your system, eliminating the need for programmers to
manually configure these devices in Configuration Manager.
To initiate Auto Fill, select Project | Auto Fill Rack.
It is important to remember that AutoFill cannot detect transmitters (IR nor RF) or
one-way RF wireless touchpanels such as the ST-1550 (although it will detect
two-way wireless touchpanels); nor does it detect User Devices. Therefore, after
using AutoFill, make sure to manually configure these kinds of devices in the
Configuration Manager.
NOTE: Your system must first be physically connected to your PC before initiating
AutoFill.
Importing VisionTools™ for Windows and
VisionTools™ Pro-e Projects
Select the touchpanel for which you want to import a VisionTools project. Click the
right mouse button and select Configure.
Select TouchPanel for VisionTools Project
The “Device Settings” dialog box will be displayed. Select the UI Project tab and
click the Browse button to display the VisionTools project files. SIMPL Windows
supports both .prj (VTW) and .vtp (VT Pro-e) files.
The Browse button will display a window where you can browse for a specific
project file. Select the .prj (VTW) or .vtp (VT Pro-e) file and click Open.
Select VisionTools Project
Verify that the Project path is correct and click OK.
Verify VisionTools Project Path
This process will load the VisionTools project and automatically create touchpanel
buttons, label signal names, and assign join numbers already specified in the
VisionTools project. This will become evident when the touchpanel is viewed in
Program Manager.
NOTE: This is not a “live” link to VisionTools software. The touchpanel buttons,
signal names, and join numbers are brought in when the UI project is specified. It
does not actively update.
Some driver files in the Crestron Database have a built-in logic. If one of these
drivers is selected and dropped into a card port, Configuration Manager will display
a Default Logic window.
Default Logic Window
The window asks if programmers want to load the default logic for the device.
Additionally, the window may contain notes and recommendations depending on the
particular device. Click Yes to load logic or No to load the device only.
Program Manager is where programmers will “program” the control system by
selecting symbols from the Symbol Library. Program Manager can be opened several
different ways.
Opening Program Manager for a New Program
After a new program is started and the program header has been completed, SIMPL
Windows will display the “Configure?” window.
Configure? Window
Click No to skip the configuration process and go directly to Program Manager.
NOTE: Crestron recommends that programmers new to SIMPL Windows should
begin by building the system in Configuration Manager before programming in the
Program Manager.
Open Program Manager from Project Menu
To open Configuration Manager from the SIMPL Windows menus, select Projects |
Program System.
Select the Program Manager button from the SIMPL Windows button bar.
Software Crestron SIMPL™ Windows
Screen Navigation
The Program Manager consists of three main viewing windows.
Program Manager
Due to the architecture of the
Symbol Library, it is sometimes
referred to as the Symbol Tree.
Symbol Library
The Symbol Library is a master list of every symbol and macro available for use in
creating your control system program. The symbols are grouped by symbol type
with each group is contained in its own folder. The folders are expanded by clicking
on the plus (+) sign.
The three main folders are Logic Symbols, Crestron Macros, and User Macros.
Symbol Library
Program View
Program View provides a tree type view of the program. Symbols that are selected
from the Symbol Library are dropped into the Logic folder in Program View. The
folders can be expanded/collapsed by clicking on the plus/minus (+/-) sign.
The Signal List folder does not expand. Instead, double click on the folder to open
the "Signal List" dialog box, shown below. This dialog box allows the user to search
for, sort, and obtain routing details for selected signals.
"Signal List" Dialog Box
Search for a signal by entering its name in the What to Find field. If only a portion of
the name is known, the search can be narrowed by entering the root-portion of the
name in the What to Find field and selecting either the Find First or Find Next
buttons to navigate to the desired signal.
Use the "Signal List" Dialog Box to Search for a Signal
Sort the signals in the project by type. There are five options in the Show Signals of
Type area, shown after this paragraph. A checked type results in a list of type-
specific signals. More than one type can be checked. Of course, minimizing the types
checked reduces the list of signals.
Show Signals of Type Field in the "Signal List" Dialog Box
Select a signal from the list and click on the Details button at the top right corner of
the dialog box to reveal the "Signal Detail for…" dialog box. Refer to the Signal
Routing paragraph in the Programming Features chapter for routing details.
Clicking the Details Button on the "Signal List" Dialog Box
Detail View
Detail View displays devices and symbols so the input and output signals are visible.
This is where programmers will name input/output signals.
There are several ways to display a device or symbol in Detail View. The most
common methods are:
Drag and drop the symbol from Program View
Double click on the symbol while in Program View
Detail View of Analog Ramp Symbol
Bookmark
Bookmarks are a terrific time saving way to mark certain symbols in Detail View.
When a certain cluster of symbols in Detail View is important and may have to be
referred to many times while writing the program, a bookmark should be added.
Select Bookmark | Add. SIMPL Windows will display the "Enter New Bookmark
Name" window and ask for the new bookmark name.
Enter a bookmark name and select OK. The bookmark will be added. Anytime it is
necessary to return to the Detail View that was displayed when the bookmark was
added, select Bookmark | bookmark name.
World View
Select View | World View to open a World View window. World View provides a
map or overhead view of the current symbols in Detail View. This enables
programmers to move around in Detail View very quickly even if many symbols are
open.
Click on the symbols in the World View window and Detail View will automatically
move to that section of the program. The red box in the World View window
displays what is shown in Detail View. Clicking inside of it and dragging can move
the box.
World View
World View Properties
World View properties are set by selecting Edit | Preferences | General Tab.
Clicking the check box enables the Virtual Workspace. The pages included in the
WorldView can be increased or decreased by providing the desired number to view.
Select View | Signal Tray to open a Signal Tray area. The Signal Tray is a powerful
holding tool for signals that have already been defined (named). It is a convenient
place to store signals that are currently being used repeatedly. Signals are placed into
the Signal Tray by dragging them from either the Signal List folder in Program View
or the signal itself from Detail View.
Configuration Manager button switches current program to Configuration Manager
for system building activities.
Crestron SIMPL™ Windows Software
Convert/Compile
Convert/Compile
Transfer Program
ViewPort
Test Manager
Help
Tile Vertical
Convert / Compile checks the program for errors and compiles.
Transfer Program
Transfer Program icon will transfers program to the control system.
ViewPort
The ViewPort button launches the SIMPL Windows ViewPort.
Test Manager
This button will begin Test Manager for testing and debugging of the program.
Realtime monitoring of signal activity.
Help
This button displays the SIMPL Windows help files.
Tile Vertical
Tile Vertical aligns symbols vertically.
Tile Horizontal
Tile Horizontal
This button aligns symbols horizontally.
Limited Symbol Mode
Limited Symbol Mode
This button will limit the number of symbols in Detail View. When enabled, the
current number of symbols in Detail View will be maintained.
Close All Symbol Details
Close All Symbol Details
This button will close all symbols by clearing Detail View.
Programming in SIMPL Windows
SIMPL is an object oriented programming language designed for easy
implementation of your control system requirements. The objects that are used in
SIMPL are called symbols. Each symbol has a specific set of operations that it will
perform. The lines that connect symbols are called signals. The collection of SIMPL
symbols and their interconnection to one another are the program.
SIMPL Windows combines the familiarity of Microsoft Windows and the
programming power of SIMPL. SIMPL includes a wide variety of symbols that are
constantly being expanded to support virtually every possible application. As you
become proficient at using SIMPL Windows and the SIMPL language it will become
obvious that there are many different ways to solve one control problem. This allows
for programming creativity and independent flexibility
Although each symbol serves a special purpose, all symbols share some basic
properties. These properties are inputs, outputs, and parameters.
Example: Analog Ramp Symbol
Inputs
Symbol inputs allow signals to be connected from other parts of the program.
Depending upon the symbol type, the current state of the input signal(s) may affect
one or more output signal(s). Some symbols have a fixed number of inputs, while
others can have a variable number of inputs, determined by the programmer based
upon need.
Outputs
Except for a few special cases, the ultimate purpose of a symbol is to modify the
states of its outputs. These output states will depend upon the symbol type, the
current or past states of the input signals, and the values of the parameters. Because
the symbol alone determines the states of its output signal(s), the symbol is
considered the driving source for the output signals. Similar to symbol inputs, the
number of symbol outputs is fixed for some symbols, or can be variable based on
need for other symbols.
Parameters
Some symbols also have parameters, which are constant values that help determine
how the symbol behaves. For example, a symbol that delays an action for a specified
period of time would have a parameter determining how long the delay should be.
The exact function of a parameter depends solely on the symbol type itself. For
convenience, parameters may be expressed in a variety of formats (all of which are
directly related to one another). Although they will default to one format based upon
the symbol type, this format can be altered by changing the format specifier at the
end of the value.
A List of the Format Specifiers and the Corresponding Range
Format (specifier)Range
decimal (d)0d - 65535d
percentage (%)0% - 100%
0s - 582s (single precision)
seconds (s)
hexadecimal (h)0h - FFFFh
ticks (t)
Legal String Syntax
Strings can consist of a list of printable characters. An example of a string is:
Hello, World!
A string may be enclosed in quotes ( many macro fles imported from the DOS
Workshop have quotes around the strings), such as:
“Hello, World!”
If there are quotes at the start and end of the string, the quotes are removed when the
file is compiled. Quotes anywhere else within a string are retained.
0s - 19,000,000s (double
precision)
0t - 65535t
(1 tick = 1/112.5 second)
Sometimes it is necessary for a string to contain ASCII characters that are not
printable. In order to encode any arbitary hex value, the notation \xZZ is ued, where \
signifies that the characters to follow have special meaning (i.e., do not print them
literally). The x means that the following two charaters are a hex constant and ZZ is
the hex value. For example, to encode the values Hex 05, Hex 06, it would look like
this:
\x05\x06
For example, it may be necessary to put an STX at the start of the string and an ETX
at the end. On any ASCII chart, STX corresponds to Hex 02 and ETX corresponds to
Hex 03. So to write the string for STX Hello, World! ETX, it would look like this:
\x02Hello, World!\x03
There are several other of these “escape” sequences that SIMPL Windows
understands when working with strings:
Note that \\ has special meaning, which is to print the \ character itself. For example,
to actually print the string \x05\x06 (8 characters), the string would be:
Of course, all of the above shortcuts can always be encoded with the \xZZ escape
sequence. These shortcuts are provided because they are commonly used. For
example, a common usage when sending multiple lines of text to an indirect text
field is to use a Carriage Return between lines. The following two lines are
equivalent:
This is Line 1\x0Dthis is Line 2
This is Line 1\rThis is Line 2
Symbol Categories
Symbols in SIMPL can be divided into two broad categories: device symbols and
logic symbols.
Device Symbols
Device symbols represent a number of Crestron control devices that can be included
in programming. They can be placed into or deleted from the program in the
Configuration Manger section of SIMPL Windows only. The Program Manger
allows device symbols to be connected but not added or deleted.
Device symbols are automatically placed in the program when the corresponding
devices are selected in the Configuration Manager. Select the device and drag-anddrop into the control system.
Logic Symbols
While device symbols allow you to communicate with the outside world, logic
symbols allow you to make your program perform exactly the way you want. Logic
symbols can range from the very basic ones such as the AND, OR, or NOT symbols,
to symbols designed for very special applications. A more in-depth discussion of
logic symbols can be found in the Programming with Symbols section.
Symbol Title Bar
A Program may have multiple instances of the same logic symbol. Other than the
symbol designation (eg., S-1) and the symbol's unique inputs and outputs, there is no
obvious difference. However, a comment can be added to the symbol title bar to
assist in differentiating them.
To add more decriptive symbol title bars to a program, right mouse click on the
symbol icon in the Logic folder in Program View (or the open symbol window in
Detail View) and select View/Edit Symbol Comment (alternatively, highlight the
icon or activate the window and depress Ctrl+R). The "View/Enter Symbol
Comment" window appears, as shown after this paragraph.
Enter a new descriptive name in the field at the top of the window. A check in the
Show Extended Comment check box allows for an additional comment to be entered
in the Extended Comments field. If unchecked, the Extended Comments field is
removed from the window.
When a comment is added to a symbol via the "View/Enter Symbol Comment"
window, the entered text appears in the symbol title bar between the symbol
designation and nomenclature separated by colons (:). The actual extended comment,
if used, does not appear in the symbol title bar. Instead, three periods (…) appear
after the comment in the symbol title bar to disclose that an extended comment has
been implemented.
Programming a System
After the system is built by adding all the necessary Crestron hardware in
Configuration Manager, begin programming the system by working in the
Programming Manager. Program each button function from the system touchpanels
or other user interface devices. Begin by naming the output signals from the user
interface (output signals will already have assigned names if a VisionTools project
has been brought in when configuring a touchpanel in Configuration Manager).
Select the symbol(s) needed for the program in the Symbol Library. Drag and drop
the symbols into the Program View window. Assign signal names to symbol inputs
and outputs in the Detail View window.
Define Signals from User Interface
User interface devices are usually the most convenient place to begin programming.
In a program, button presses (whether from a touchpanel, wired or wireless button
panel, or other interface) are associated with signals. When a button is pressed, the
corresponding signal name is asserted in the control system program. When the
button is released, that same signal is disserted.
The button press is the end-user’s request for a specific action. Therefore, the output
signals of the user interface have to be named or “defined”. This way, each signal
can be identified and routed properly.
NOTE: Programmers who design touchpanels in VisionTools Pro-e can reference
.vtp projects (UI Projects) when configuring touchpanels in Configuration Manager.
This will import the necessary VisionTools files and name the user interface input
and output signals automatically.
User interfaces are represented in the Network Modules folder in Program View.
Expand the Network Modules folder in Program View by clicking in the plus (+)
sign. Double click on the specific user interface to display its symbol in Detail View.
User Interface (Touchpanel) Symbol
Name the output signals. Signals should be given a descriptive name like
“power_on”, ”screen_up” or “VCR_play”, for example. Name signals by selecting
the signal with the pointer.
Selected Signal
When the signal will appears highlighted, text can be entered.
Programmers will typically use many symbols when programming in SIMPL
Windows. Logic symbols allow programmers independent flexibility by offering
many different ways to solve a control problem. Logic symbols can range from the
very basic ones such as the AND, OR, or NOT symbols, to symbols designed for
very special applications.
Crestron recommends using
Subsystems to keep the program
organized and easy to modify.
Logic symbols are brought into the program by selecting them in the Symbol Library
and dragging them into the Logic folder or a Subsystem folder in Program View.
Drag and Drop Symbols
NOTE: It is possible to drop symbols directly into Detail View. However, this will
not place the symbol in a subsystem
Although symbols are broken down into descriptive subfolders in the Symbol
Library, it may still be difficult to locate a certain symbol. To alleviate such a
problem, simply right mouse click within Symbol Library to reveal additional
commands, as shown after this paragraph.
Available Commands from a Right Mouse Click on Symbol Library
Select Find to display the "Find a Symbol/Module in the Symbol Library" dialog
box.
Available Commands from a Right Mouse Click on Symbol Library
Enter a phrase in the Search For field and check those boxes (Name, Speedkey/File
Name, Hint, and Help) for the categories to be searched. Click the Search button.
The outcome is listed in the Results box at the bottom of the dialog box.
Available Commands from a Right Mouse Click on Symbol Library
Placing a Symbol
In Program View, double click on the symbol to display it in Detail View. Once in
Detail View, the symbols signals can have names assigned and, if necessary,
parameters defined.
Double Click Symbol to Display
Naming Signals
Signal names are assigned in Detail View. The signal must be selected or highlighted
before text can be entered. By default, the top input signal (top left) is automatically
selected when a signal is first displayed. Use the pointer or arrow keys to navigate
around the symbol.
NOTE: Signals whose symbol label appears in [brackets] are optional and are not
necessary for the symbol to operate.
Subsystems
Crestron recommends using subsystems. They are a simple way to organize
programs for easy location of specific logic functions. They can be named for easy
identification making future modification easier.
To create a subsystem, select the Logic folder in Program View and choose Insert Subsystem from the right mouse menu.
Insert Subsystem
The “Enter Symbol Comment” window will be displayed. It is advantageous to use
descriptive names for each subsystem. This way future programmers can easily
navigate through and identify the various parts of the program. Enter the Subsystem
name and click Yes.
Name Subsystem
A new Subsystem will be displayed. Multiple Subsystems are displayed in numerical
order (S-1, S-2, S-3…).
The heart of any well-designed control system is the user-interface. This is the link
between the end-user and the control system itself. Crestron control systems offer an
impressive array of user-interface options, from the top-of-the-line video
touchpanels, to the cost-effective and simple wired button panels. No matter what
type of interface(s) you are using in your system, it is important to know how to
program them properly.
Feedback
Feedback lets the user know that a button press has registered with the system. This
is especially important for touchpanels, where the user cannot tell from feel alone
whether they pressed in the right spot. Another purpose feedback serves is to provide
information to the user about the current state of the system (that the VCR is
currently in PLAY mode, for example).
Visual Button Feedback
Whether a button is pressed or not is determined by the user (or the user's finger to
be exact!) but it is a signal that decides whether a button is shown in its feedback
state or not. Therefore, the signal is the driving force for the button feedback. Where
the signal comes from depends upon what type of feedback is needed. The most
basic type of feedback is called "momentary feedback". Momentary feedback causes
the button to display in its feedback state only when the button itself is pressed. This
type of feedback makes sense for functions that occur only while the button is
pressed. For example, volume up and down buttons typically receive momentary
feedback because the volume level only changes (goes up or down) while the
corresponding button is pressed. Momentary feedback can be achieved simply, by
connecting the button press signal name to the feedback signal for the same button
Programming Momentary Feedback
Certain buttons may call for more complex feedback. For example, a volume mute
button may alternately turn the mute on and off. To indicate this with feedback, the
button should display in the feedback state when the mute function is on, and turn off
when mute turns off. Clearly, momentary feedback will not do the trick here, so we
must use logic symbols to generate the desired behavior. This example shows how to
do this using the TOGGLE symbol.
Indirect text is a feature where the particular text string that appears on a touchpanel
button can change, depending on the signal state. For example, when the user
touches the button to enable it the button might read “Power ON”, and when touched
again to disable, it might read “Power OFF”.
With the introduction of SIMPL Windows, touchpanel definitions now have built in
text fields defined. These text fields will accept serial data signals directly, thus
eliminating the need for the serial to indirect text symbol in many cases.
Serial Send to Touchpanel text fields
Imported UI Projects
VisionTools UI projects can be imported into SIMPL Windows. This allows
Touchpanel designs created in VisionTools to be referenced by SIMPL Windows for
the touchpanels specified in the program. The VisionTools project will automatically
assign names to the input (fb-feedback) signals and output (press-button) signals of
the touchpanel. Additionally, the VisionTools project will assign join numbers to the
buttons!
When VisionTools UI projects are used the touchpanel signals are defined
automatically. Programmers can continue to use the definitions provided or rename
the signals.
SIMPL Windows provides programmers with a number of Crestron Macros as well
as a predefined space to store user created macros called User Macros
Things to Remember
• When importing newer macros into older programs make sure the
macro is compatible with the control systems OPS version.
• Programmers should remember that macros can not be tested
independently. They must be brought into a program and then
compiled.
Macros are brought into the program the same way as symbols. Select the macro and
drag it into the Logic Folder or a Logic Subsystem. Double click on the macro to
display it in Detail View.
To display the parameter routings of a macro, highlight the parameter, right mouse
click, and select Show Routings (alternatively depress F2). The "Parameter
Routings for" dialog box appears, example is shown after this paragraph.
Example of "Parameter Routings for" Dialog Box
Use this dialog box to determine how signals are routed through a macro. Use the
Goto button to locate signal routing for a selected signal. By default, SIMPL
Windows responds by opening the Logic folder in Program View and displaying the
location. If the Always open symbol in Detail View check box is checked, SIMPL
Windows goes one step further and opens the selected symbol (with highlighted
sugnal) in Detail View.
Crestron Macros
Crestron Macros are prepackaged logic programs. A Crestron macro is a set of prewritten and debugged logic used for controlling a particular device or performing a
function. The use of macros saves programming and debugging time since a large
portion of the symbol – signal functionality already exists inside the macro.
The internal workings of a macro
can be viewed by selecting File | Open | Macro. This enables
users to view the symbols and
signal connections that are
within the macro.
Beginner programmers can control very complex equipment by using the correct
Crestron Macro. Crestron Macros are located in a Symbol Library folder called
Crestron Macros. Expand the folder by clicking the plus (+) sign. Select the macro
and press F1 for a description.
Software Crestron SIMPL™ Windows
Crestron Macro and F1 Description
User Macros
Programmers can create their own macros and store them in the User Macros folder
in the Symbol Library. Alternatively, programmers can import Crestron Macros, edit
them to match their specific needs, and save them as a User Macro.
Writing a Macro
Create a User Macro
Create a User Macro by selecting File | New User Macro and complete the fields of
the “Program Header Information” window. Write the macro in the same fashion as
writing a program. Select symbols in the “Symbol Library” and drag them into the
Logic Folder.
Argument Definition is used by SIMPL Windows to create the macro file. It allows
you to specify the inputs, outputs, and parameters of the macro, which will be
available to the users of the macro. Only one Argument Definition is used per file.
Conceptual Representation of a Macro
The Argument Definition symbol will define how the macro’s symbol will appear in
SIMPL Windows. Name all inputs, outputs, and parameters. The names given to the
Argument Definition signals will become the signal cues in the macro symbol.
In order to let the macro user specify the parameter values, parameters are named
(instead of given values) in the Argument Definition symbol. The “internal”
parameters are then given the name #parameter name. The # tells the internal
program that the parameter value is specified by the macro user.
NOTE: Programmers must name the parameter in the Argument Definition symbol
before entering the “#parameter name” in the macro program.
Programming the Argument Definition Symbol – Detail View
Save the macro by selecting File | Save. Enter a file name and save it with a .umc
extension in the Usrmacro folder.
The macro file name is displayed
in the status bar when the macro is
highlighted in the Symbol Library.
Once saved, User Macros are available for use in other programs. They reside in the
User Macro folder in the Symbol Library. To use a macro, select and drag it into the
Logic Folder that same way any other symbol is selected.
The Macro as a Symbol
Edit a Crestron Macro and Save as a User Macro
Many Crestron Macros are available to programmers. These macros can be edited to
function in a specific manner. When a Crestron macro is imported and edited, it can
only be saved as a User Macro.
1. Select File | Import Crestron Module…
2. Select the Crestron macro that is to be edited. Crestron macros have a .cmc
file extension. Open the macro file.
3. Edit the macro to perform the specific tasks necessary. Edit signals and
add/remove symbols
4. Save the macro as a User Macro by selecting File | Save. SIMPL Windows
will display the Save As window. The Usrmacro folder is the default
location. This is the User Macro file folder. Files have a .umc extension.
The purpose of this section is to provide programming information about various
devices that can be added to a SIMPL Windows project.
Serial Driver Programming Information
Serial drivers in SIMPL Windows are used to control communications to Cresnet
communication devices (e.g., ST-COM, CEN-COM, CNXCOM-2, CNCOMH-2,
etc.)
Not all devices support all of the above options. To determine which features a
particular device supports, drop the device into a SIMPL Windos project and open
one of the ports in Program Manager’s Detail View.
[TX$]
[TX$] is a serial string (which can come from symbols like Transmit Analog
[Speedkey: TXA]). Information on the serial string attached to this input is
transmitted out of the COM port, at the COM port parameters specified for that port
in Configuration Manager. If there are no symbols driving this input, it may be left
blank
[RX$]
[RX$] is a serial string (which can be routed to symbols such as Serial to Analog
[Speedkey: OP103]). Information on the serial string attached to this input is
processed by the symbols that this string is driving. If the received data is not
processed by other symbols, this ouput may be left blank.
[BREAK]
[BREAK] generates a BREAK on the transmit pin of the associated COM port.
There are several different kinds of BREAKs. Some BREAKs are 17-20 bits of low.
Some are generated continuous logical low as long as the BREAK line is held high.
Consult the documentation for each specific device to know whick type of BREAK it
generates. Some RS-422 based devices use the BREAK for synchronization before
communicating other data. If BREAK characters are not going to be generated, this
input may be left blank.
[RTS] changes the state of the physical RTS pin on the associated COM port to high
as long as the digital signal tied to this input is high. When the digital input drops
low, the RTS line also drops low. If there is no explicit program control of RTS
required, this input my be left out.
NOTE: If explicit control is needed, the Hardware Handshake for this port must be
set to NONE in Configuration Manager.
[CTS]
[CTS] is a digital output of the symbol. The digital signal tied to this output changes
stste when the CTS pin on the associated COM port changes state. When CTSis
driven high, the digital signal tied to this output goes high. When CTS is driven low,
the digital signal tied to this output goes low. If no explicit monitoring of CTS is
required, this output may be left blank.
NOTE: If explicit monitoring is required, the Hardware Handshake for this port
must be set to NONE in Configuration Manager.
Other Lines
Other lines are labeled str1, str2, etc. Each has an associated digital input or digital
output. On the rising edge of a digital input, the data in the string field is sent out the
associated COM port. This allows constant data to be easily transmitted without the
need to code other symbols and connect them to the TX$ line. When the COM port
receives data, it attempts to match it to strings that have digital outputs associated
with them. If it finds a match, the associated digital output is driven high.
NOTE: If the same data is received twice by the COM port, the digital output for
that string drops low momentarily (a logical impulse) and then is driven high again.
In this way, all matches are seen.
NOTE: String fields may contain any valid strings. Information on strings can be
found at “Legal String Syntax” on page 53.
[enable]
[enable] is an optional digital input that only affects the transmission of the constant
strings and the matching of strings. If nothing is tied to this input, the constant
matching/transmission is enabled. If a digital signal is tied to it and is low, the
constant matching/transmission is inhibited. This does not affect the usage of the
TH$, RX$, BREAK, RTS, or CTS signals.
Signals are the elements used in your program to interconnect the various device and
logic symbols that comprise your program. Signals can be one of three types: digital, analog, or serial. In SIMPL Windows the three signal types are color-coded as
follows:
Digital = Blue
Analog = Red
Serial = Green
Other = Black
NOTE: “Other” signals are neither digital nor analog. These black signals may
indicate a combination of signals (e.g. many symbols accept either analog or serial
signals where the combination is shown as a black signal). The signal type is
displayed on the Status Bar when the signal is highlighted.
You can easily navigate a given symbol by using the arrow keys. Move from input
to output using the Tab key.
Create New Signals
Once a symbol input or output is assigned a signal name, a signal has been created.
To create a new signal, assign a name to a symbol input or output:
In Detail View
1. Double-click on an input or output arrow. A blinking cursor will
appear.
2. Enter a signal name you decide upon, or use AutoName.
AutoName's recommendation will always assure you of a unique signal
name, one that is not currently used in your program. If you select your
own signal name, instead, you will be automatically alerted if the signal
name already exists, because the input or output background will be
green in color.
Enter Signal Name – Detail View
3. Press Enter on your keyboard.
In Program View
1. Navigate through the Program Tree, and find the particular input or
The signal is created! Notice that after a signal is created, it appears in the Signal List
folder at the bottom of the Program Tree, in Program View.
Selecting Signals
Signal selection in SIMPL Windows follows two standard Windows conventions:
the SHIFT key is used to select a bloc of signals directly above or below each other
in an input or output column. The CONTROL key is used to select two or more
signals present in the same input or output column or in the same symbol, but not
necessarily directly above or below each other.
Select One Signal in Detail View
1. At least one symbol must present in Detail View, in order to select a
signal.
2. Click the desired signal once with your mouse to select it.
Select Multiple Signals in Detail View
1. Click the first signal in the bloc of signals to be selected
2. Press and hold the SHIFT key
3. Click the last signal in the bloc of signals to be selected
The entire bloc will be highlighted.
• SHIFT-END will select downward, from the signal your cursor is on, to the last
signal.
• SHIFT-HOME will select upward, from the signal your cursor is on, to the first
signal.
Edit Signal Name
In Detail View
1. Double-click on an existing signal. A blinking cursor will appear.
1. Navigate through the Program Tree until you find the signal, or locate it
in the signal List folder at the bottom of the Program Tree.
2. Double-click the signal
3. Make your signal name modifications
4. Press Enter on your keyboard
Rename Signal Globally
SIMPL Windows makes it “simple” to rename signals globally. This changes the
signal name while keeping the connections intact. The signal routings do not change
only the signal name changes.
In Detail View, select the signal that is going to be renamed. Right mouse click to
display the menu and choose Rename Signal Globally. The "Rename Signal" dialog
box is displayed. Enter the new signal name and select OK.
"Rename Signal" Dialog Box
DeletePlus allows you to Delete A
Signal while Highlighting the Input
or Output below it. Hold Ctrl
while pressing the Delete key.
Disconnect a Signal
If the signal to be deleted is connected to multiple symbols in your program, you will
see multiple instances of the signal in Program View, as well as in Detail View if the
symbols that contain it are open. Exercise caution when selecting a signal for
deletion. Make sure you find the exact instance of the signal you want deleted.
In Detail View
The symbol containing the particular instance of the signal to be deleted must be in
Detail View.
1. Check the symbol header to insure you are deleting the exact instance
of the signal.
2. If there are currently multiple symbols present in Detail View, bring the
correct symbol to the front in the view, or maximize the correct symbol
if it is currently minimized.
3. Select the instance of the signal to be deleted and press the DELETE
key.
In Program View
In the Program Tree:
1. Find the specific symbol containing the signal to be deleted.
2. If the symbol is currently collapsed, expand it by selecting the plus (+)
3. Locate the input or output folder where the signal is located.
4. Select the signal, and press the DELETE key.
Replacing a Signal
This operation is known as redefining a signal connection. It disconnects a given
signal and connects a different signal in its place (by contrast, renaming a signal
assigns a new name to a signal, while the signal itself remains the same).
Redefinition of signals can occur from one symbol to another symbol, or within the
same symbol.
In Detail View
• Drag and drop the new output signal to the input signal you wish to
redefine; this will sever the connection of the existing input signal and
replace it with the output signal.
In Program View
1. Navigate to the signal you wish to redefine.
2. Double-click on the signal, or right-click and select Rename Signal.
3. Enter the new signal name.
4. Press Enter or click OK as appropriate.
OR
1. Navigate to the signal you want.
2. Drag and drop the signal on the signal to be redefined.
Connect Signals
In Detail View:
1. Drag and Drop an existing signal to the new signal.
2. Double clicking on a signal will create a name field with a blinking
cursor. Enter the name of the signal you wish to connect to, and press
Enter.
NOTE: If an input or output will not accept a name you are trying to give it, make
sure you are not trying to connect a digital input or output to an analog input or
output, or vice-versa.
In Program View:
To connect a signal in Program View:
1. In the Signal List, drag and drop one signal to the signal to which it
should be connected.
The signals are now connected. If the symbols to which these signals are attached
happen to be present in Detail View, you will notice the newly connected status of
the signals there.
The parameter field is always at or near the bottom of the signal body.
1. Locate this field, and double-click it. This causes a blinking cursor
to appear.
2. Enter a parameter name.
3. Press Enter on the keyboard.
For example, the Sequencer Select Symbol has one parameter, called size1, and
therefore has one parameter field. By contrast, the String I/O Symbol has three
parameters, and so has three parameter fields:
Str1
Str2
Delimiter
In SIMPL we allow users to enter parameters in various forms. Previously, for
parameters where a constant number is expected, the following "type identifiers"
could be used:
d - decimal
h - hex
s - seconds
t - ticks
% - percentage (0-100%)
With the release of SIMPL Windows v1.22.0, Crestron has added another parameter
form. The new form is a single ASCII character surrounded by single quotations.
The value of this parameter is equivalent to the character's ASCII value.
For example, 'A' equals 65d, 'B' = 66d, etc. Refer to an ASCII conversion table.
Automatically Increase Inputs, Outputs, or
Parameters
"I/O Grow" is a capability, which allows symbols to increase the number of inputs,
outputs, parameters, or all three, possessed by a symbol.
The I/O Grow feature is implemented differently on different symbols; there are
variations of signal expansion that can, or must, occur. Like the Interlock, some
symbols have the capacity to add additional input/output pairs, while other can
expand only their inputs, or only their outputs. Or, like the Analog Ramp, some
symbols can expand neither their inputs nor their outputs. Additionally, sometimes
inputs and outputs are expanded together, or sometimes parameters must be
expanded with inputs or some other interdependent pairing. In such a case, when you
expand one, you will find the dependent one also expands.
If you generate a new input or output you must create a signal for it, in contrast to
certain symbols (such as the Interlock) that have optional inputs and outputs.
Behavioral information of inputs for a given symbol can also be found in its
SymbolCard.
I/O Grow requires you to manually create each new input, output, or signal you
want. By comparison, I/O Grow Special allows you to specify how many new
input/outputs you want, and they are created as a bloc, instantly and automatically.
Increase Inputs, Outputs, or Parameters with I/O Grow
In Program Manager:
1. Open the Logic Symbols folder, in the Symbol Library.
2. Open your desired specific Symbol folder.
3. Place a symbol into Detail View by dragging or double clicking.
4. Make sure input or output signal is selected.
5. Press ALT + on the keyboard (the ALT key and the plus (+) sign).
Activation of I/O Grow for certain
symbols will cause a multiple I/O
expansion. For example, the
Touchpanel symbol expands 32 I/O
airs at a time.
In most cases, you will now see one additional input/output pairs appear.
ALT- will produce the opposite effect that ALT+ does: it will reduce the number of
signals.
Increase Inputs, Outputs, or Parameters in Multiples with
I/O Grow Special
1. In Detail View, drag over your desired symbol and select any of its
signal(s).
2. On the keyboard, press SHIFT ALT+. The “Insert Multiple Signals or
Parameters” dialog box will appear, asking for the number of inputs or
outputs to add.
"Insert Multiple Signals or Parameters" Dialog Box
3. Enter the desired number of additional inputs or outputs to be added,
and click OK.
The number of signals will be added to the symbol.
Decrease Inputs, Outputs, or Input/Output Pairs
You can increase the number of inputs, outputs, and parameters, or all three
possessed by a symbol, you can also manually decrease that number. There is
currently no function equivalent to I/O Grow Special, however, that would allow you
to remove inputs, outputs, or parameters in a bloc.
To clarify: you can delete signals in a bloc (remember, a signal is an input or output,
once named), it is the actual inputs or outputs possessed by the symbol that cannot be
deleted as a bloc. You can delete them individually, however, using Alt-.
To Decrease Inputs, Outputs, or Input/Output Pairs
In Program Manager:
1. Open the Logic Symbols folder, in the Symbol Library
2. Open your desired specific symbol folder
3. Place a symbol into Detail View
4. Select the input or output or input/output pair you wish to delete.
Use the standard Windows method for selecting non-contiguous
items.
5. Press ALT - (the ALT key and the minus (-) sign) to delete the
pair. SIMPL Windows will ask if wish to perform the deletion.
NOTE: Inputs, outputs, or input/output pairs deleted this way must be done so one at
a time.
Automatically Assign Unique Signal Name(s)
The AutoName feature will automatically assign unique signal names to one or more
of your signals. This feature is best used when you need to generate a number of
signal names quickly. As the size of your program grows, it will become difficult to
recall which signal is which, and what signal does what, unless they are intelligently
and descriptively named. It is recommended that you provide your own signal
names, even in the cases where AutoName is used to quickly name a group of
signals, Crestron recommends that programmers go back when time allows and
rename those signals with unique and descriptive names.
To use AutoName
For a given signal:
• Double-click, then click elsewhere in the symbol, or
• Click once to select, then press Enter twice.
A unique signal name will appear, consisting of a combination of the symbol
Number and the Prompt for that input or output.
Examples
To quickly AutoName a column of Inputs from top to bottom:
NOTE: SIMPL Windows will not allow you to connect a digital input, output, or
signal to an analog input, output or signal, or vice-versa.
Signal Routing
The Signal Routing window displays the specific path between symbols that a signal
takes in a given logic bloc. Every symbol a signal is connected to will appear in these
two fields.
Signal Detail Window
The "Signal Detail" Window can be called up in either Program View or Detail
View:
Select a signal, and press F2.
The window that appears contains two large fields:
• Driving Sources: This field tells where the selected signal originates.
• Signal Routing: This field tells where the selected signal is routed
Signal Detail Window
Each line within a field contains the following information, in order:
• Symbol number, Symbol name, Prompt name, and Symbol comment.
Use the "Signal Detail for" dialog box to locate where a signal is used. Select the
Goto button to locate the symbol(s) for a selected signal. By default, SIMPL
Windows responds by opening the Logic folder in Program View and displaying the
location. If the Always open symbol in Detail View check box is checked, SIMPL
Windows goes one step further and opens the selected symbol (with highlighted
signal) in Detail View. Refer to the example shown after this paragraph.
An Example Implementing the "Signal Detail for" Dialog Box
Selecting the Open All Symbols button at any time while the "Signal Detail for"
dialog box is open results in the opening of all symbols (having the selected signal)
in Detail View.
Auto-Increment the First Number
If a signal name contains one or two numeric values, programmers can use AutoIncrement to increment the first number in signal names or the last number.
AutoIncrement First will automatically generate additional signal names that
follow in sequential order, based on the first numeric.
CAM1-PRESET1
In the above example, AutoIncrement would generate the following signal names:
1. Highlight a signal with a name that has a numeric component
2. Move your cursor to the signal below that signal, by pressing the down
arrow once, or clicking the lower signal once
3. Press the SHIFT-F4 key.
A new signal name will appear, identical to the first except for the first numeric,
which will be one increment higher.
Auto-Increment the Last Number
If a given signal name contains two numeric values, such as: CAM1-PRESET1
AutoIncrement Last will automatically generate additional signal names that follow
in sequential order, based on the last numeric.
In the above example, AutoIncrement would generate the following signal names:
CAM1-PRESET2
CAM1-PRESET3
CAM1-PRESET4
CAM1-PRESET5
To use Auto-Increment Last:
1. Highlight a signal with a name that has a numeric component
2. Move your cursor to the signal below that signal, by pressing the down
arrow once, or clicking the lower signal once
3. Press the F4 key.
A new signal name will appear, identical to the first except for the last numeric,
which will be one increment larger.
NOTE: To Auto-Increment both inputs and outputs, it must be done separately. First
increment the inputs, then increment the outputs.
Auto-Increment the Last Number in a Signal Name
If a given signal name contains two numeric values, such as:
CAM1-PRESET1
AutoIncrement Lastwith Highlight will automatically generate further signal
names that follow in sequential order, based on the last numeric, and will also
highlight the input or output directly below the current signal.
If you wish to AutoIncrement both your inputs and your outputs, you must do so
separately. First increment your inputs, then increment your outputs, or vice-versa.
To use AutoIncrement Last with Highlight
1. Highlight a signal with a name that has a numeric component
2. Move your cursor to the signal below that signal, by pressing the down
arrow once, or clicking the lower signal once
A new signal name will appear, identical to the first except for the last numeric,
which will be one increment larger, and the next input or output will be highlighted,
ready for editing or copying.
NOTE: To Auto-Increment both inputs and outputs, it must be done separately. First
increment the inputs, then increment the outputs.
Copying Signal Names
Copy Input to Output (or vice-versa)
This function only works with an input-output pair. If one signal already has a name,
this name is carried to its partner, and vice-versa. If both signals are already named,
the highlighted signal takes the name of the other.
1. Select a named signal or group of signals.
2. Press F6.
Copy Input to Output and Highlight Next Pair
1. Select a named signal (the selected signal will always take the name of
the unselected)
2. Press Ctrl-F6.
The newly highlighted field is ready for data entry. Just start typing!
Copy by Drag and Drop
Drag the signal you wish to duplicate to the particular input or output you want to
(re) name. The input or output dragged to will now have the same name as the
original signal, which will retain its name.
To drag multiple signals, first select them (use Shift or Ctrl), then grab any part of
the selected bloc and drag it to your desired group of inputs, outputs, or signals. The
entire bloc will be copied.
This function uses the Signal Suffix, which is a two-character suffix you can append
to any output signal(s), to facilitate such things as signal tracking.
Select Edit | Preferences and choose the General tab. Under Append Suffix Setup
there are five key combinations available for use, allowing you to set shortcuts for
five different signal suffixes; you can then track five different signals.
Programmers might want to set Alt-1 to enable a signal suffix such as "-fb", which
when appended to a particular signal would indicate the signal is used to provide
feedback, and would allow you to know the path taken by that signal.
How to Append Suffix
1. Select Edit | Preferences and choose the General tab.
2. Use the Append Suffix Setup box to set the particular suffixes you want
to append to your signal names (Crestron recommends that each suffix
consist of two or more characters, and be preceded by a minus sign.
Each should follow the format “-xx”).
3. Close the "SIMPL Windows Preferences" dialog box.
Append Suffix Setup on the "SIMPL Windows Preferences" Dialog Box
4. In Detail View, Select the signal(s) to which you want to append a
particular suffix.
5. Press the particular Alt combination required to enable the specific
suffix you wish to append to the selected signal(s).
NOTE:Append Suffix applies to all signals. However, it is usually used with output
signals to indicate that they have passed through a gate.
The SIMPL Windows ExampleBase contains example SIMPL Windows files that
support various hardware devices. The ExampleBase is available on the Crestron
ControlCD in the directory called "SMW-SMPL". The same examples are also
available from the EXAMPLES Library on the Crestron FTP site
(
www.crestron.com). New users are required to register in order to obtain access to
the FTP site.
How to Re-Synch Your Programs
It may become necessary to Re-Synch programs if the Symbol Library has been
updated or modified. For example, a programmer edits a macro. As a result, the
number of inputs/outputs to the macro has changed. Re-Synch allows the
programmer to open a previous SIMPL Windows program that contains the macro
and perform a Re-Synch Macros in Program. This will "update" the Macro to
reflect the recent changes made by the programmer.
NOTE: Performing a Re-Synch may remove some inputs/outputs of the
macro/SIMPL+ symbol if the "newer" or edited version of the symbol has fewer
inputs/outputs than the previous version.
There are three types of Re-Synch available in the SIMPL Windows Project pulldown menu.
Re-Synch Symbols in Program
This will rarely be used because symbols cannot be modified (except by Crestron).
Re-Synch Macros in Program
This feature will "update" all the macros in the program to reflect the recent changes
to the macro inputs and outputs.
Re-Synch SIMPL+ in Program
This feature will "update" all the SIMPL+ symbols in the program to reflect the
recent changes to the SIMPL+ symbol.
Prior to compiling it may be necessary to adjust the default compiler settings. In
either Configuration Manager or Programming Manager select Edit | Preferences to
open the "SIMPL Windows Preferences" dialog box. Click the Compiler Settings
tab, as shown after this paragraph, to reveal the default settings.
"SIMPL Windows Preferences" Dialog Box – Compiler Settings Tab
Generate SIMPL-C Listing
Crestron recommends that this item remains unchecked. Checking this item results in
the generation of text file (.smp extension) during compilation. This file is a syntax
listing of the program that is used by Crestron for debugging purposes.
Show Signals without Destinations as Notices
If checked, signals without destinations are reported as notices after compilation. Use
this information to debug the program. If unchecked, signals without destinations are
ignored and may be overlooked before the final compilation. These signals do no
harm, but they do take memory and processing time. They could also represent
incomplete programming; therefore Crestron recommends that the box remains
unchecked.
Report Warnings / Notices found in Crestron Macros
It is good practice to leave this checked. Crestron macros have already been
debugged, so there is no need to use resources to check for warnings and notices
within them.
Report Warnings / Notices found in User Macros
It is good practice to leave this checked. It is likely that user macros have already
been debugged separately. There is no need to use resources to check for warnings
and notices within them and report them again, if any exist.
Don't Compile with Incomplete Symbols
It is good practice to leave this checked. If checked, the program will not compile if
there are any incomplete signals found. The programmer then has the option to
rework the program and complete symbols or comment out symbols. If unchecked, a
program with incomplete symbols could compile. The resultant program could lead
to unknown problems within the system. However, it may prove useful while writing
a program as long as the program is not uploaded to the system.
Optimize Serial Strings for Touchpanels
It is good practice to leave this checked assuming the required OPS is loaded.
Checking this item saves space and makes the program more efficient.
Compiling the Program
Compile the program by selecting Project | Convert/Compile or click on the
Compile button. SIMPL Windows will display several possible message windows
and prompt the user to answer them in order to proceed with the compile process.
The Compiler will run after the information boxes are answered. While running, the
Compile Status window will be displayed.
Compile Status
When the compile process is complete, SIMPL Windows will display the "Compile
Complete" dialog box. The box prompts the use to answer if the program should be
transferred to the control system. Click the appropriate button.
If the compiler found problems in the program, it will display them in the "Program
Compilation" window along with the "Compile Complete" dialog box.
If a project containing commented out symbols are devices is compiled, the
"Commented out Symbols and/or Devices" dialog box appears, shown after this
paragraph.
"Commented out Symbols and/or Devices" Dialog Box
The user has the option to continue or cancel. It is also possible to avoid this prompt
during each compile. Simply check the box at the bottom of the dialog box.