Wiki source code of Features

Version 6.1 by Mark Kohlmann on 2022/10/17 17:48

version	line-number	content
6.1	1	showrunner™ is a commercial lighting control and lighting management system. showrunner™ contains a large number of features focused on the needs of the commercial lighting and hospitality markets and is adaptable to the residential market. Hardware support is extensive and growing all the time. This documents is not a complete feature list and Chief Integrations reserves the right to make modifications at any time.
1.1	2
6.1	3	{{box cssClass="floatinginfobox"}}
	4	(% class="wikigeneratedid wikigeneratedheader" id="HTableofContents" %)
	5	CONTENTS
	6
	7	{{toc start="4"/}}
	8	{{/box}}
	9
	10	==== Key Capabilities ====
	11
	12	* Configuration driven with runtime configuration support enables rapid commissioning of commercial lighting systems
	13	* Extensive feature set allows Crestron systems to comply with the majority of DIV 26s and customer requirements
	14	* Large native hardware support with the option to extend support to new hardware quickly and easily
	15	* Touchpanel and web based UIs cover users needs
	16	* Runs entirely on a Crestron processor or VC-4 eliminating the need to manage expensive servers
	17	* Floorplans with pinch, zoom, and insight!
	18	* Powerful scheduling capabilities enable set and forget scheduling of lighting and easy management to handle changes
	19
4.2	20	==== Area Features ====
1.1	21
4.2	22	* Lighting Loads
	23	* Scene recall
	24	* Master raise/lower
	25	* User configurable scene name, fade time, and load include by scene
5.1	26	* Individual scenes may be locked to prevent changing their settings
1.1	27	* Individual load control within an area
	28	* Select area from touchpanel, areas can be restricted by panel
	29	* RGB controls for applicable fixtures, saved per scene
2.1	30	* Configurable Load Grouping for load consolidation including linked/group area loads
1.1	31	* Dynamic White/Circadian Rhythm CCT Control
	32	** CCT Control per area for applicable fixtures
	33	** Global schedule for CCT, astronomical and/or fixed schedules
	34	** Manual CCT override per area
4.2	35	* Demand Response with ability to exclude area from Demand Response event
	36	* Configurable load grouping allows aggregation of loads to a single slider per group, can include linked areas
	37	* HVAC Control
	38	* Shades
	39	* Occupancy Features
	40	** Occupancy Modes
	41	*** Occupancy
	42	*** Vacancy
	43	*** Disabled
	44	*** Use Hardware Logic (if supported by edge controller)
	45	** Extend occupancy timeout by user specified seconds, can be scheduled
	46	** Configurable occupied and vacant scenes, scheduled
	47	** Configurable grace occupancy support without needing support in hardware
	48	* After Hours support for automatic shutoff after configurable timeout w/ alerting
	49	* Parent Area feature allows one area to trickle down scene recall and raise/lower (if enabled)
	50	* Last Scene Recall timestamp and triggering action recorded
5.1	51	* Organized in a node tree with multiple depths
4.2	52
	53	==== Load Features ====
	54
	55	* Dynamically assigned/unassigned at runtime to areas
	56	* Supported load types
	57	** Single Channel
	58	** Dynamic White/CCT
	59	*** Warm/Cool
	60	*** Intensity/CCT
	61	*** DALI Type 8
	62	*** Pharos Dynamic White
	63	** RGB/W/A
	64	*** Color Picker
	65	*** W/A channels can be controlled individually or mixed (Pharos)
	66	* Supported load behaviors
	67	** Dimmable
	68	** Switched
	69	** Plug Load
	70	* Dimming Curves
	71	** Unaffected
	72	** Linear
	73	** Linear No Zero Pass (support for EM lights that are not allowed to turn off i.e. Chicago 10%)
	74	** Logarithmic
	75	** Non Dim
	76	** S Curve
	77	** Soft Linear
	78	** Square
	79	** Always On
	80	** Inverse Log
	81	** Custom based on input output ranges
	82	* Min/Mix Trim, performed in hardware if supported
	83	* Override Level, performed in hardware if supported
	84	* Unoccupied Level
	85	* Demand Response Level
	86	* Enable/Disable/Override states
	87	* Option to ignore long fade times if the loads is off
5.2	88	* Option recall last on level
4.2	89	* Individual daylight harvesting settings, enabled/disabled by scene
	90	** Open/closed loop
	91	** Min/Max levels
	92	** Sensitivity
	93	** Fade time
	94	* Loads may track other loads
	95	* Remap channels for unusual fixture channel mappings
	96	* Raise/lower, performed with software fade engine if not supported by hardware
	97	* Dynamic White/Circadian Rhythm CCT
1.1	98	** Custom CCT curves per load or default algorithm
	99	** Min/Max CCT per load
	100	** Support for Warm/Cool or Intensity/CCT fixture types
	101	** Configurable automatic fixture shut off if outside CCT range
4.2	102	** Crestron GLS-LCCT (SolarSync™) sensor integration for daylight tracking
	103	* Load flashing for identification
	104	* Verified timestamp option
	105	* DALI (DIN-DALI-2/ZUMNET-JBOX-DALI Legacy mode)
	106	** Addressing/Grouping/Driver Replacement for DALI. DALI groups are referenced by their controlled load simplifying addressing and replacement procedures.
	107
	108	==== Scheduling Features ====
	109
	110	* Algorithm based scheduling engine ensures predictable operation year after year with no need to specifically specify each day
	111	* Area and/or Tag based schedules
	112	* Individual global events or grouped events
	113	* showrunner™ HUB UI Features
	114	** Day/Week/Month/Time Grid views display all events calculated by the scheduler engine
	115	** Tree based event/event groups
	116	** View Built-In Calendars and Groups
	117	** Create/Edit/Delete Custom Calendars and Groups
	118	* Execute last event on startup (configurable) to bring system in to correct state
	119	* Configurable Actions
	120	** Scene w/ option to override fade time
	121	** Change Keypad State (Enable/Disable/Disable Off)
	122	** Change Occupancy Mode (Occupancy/Vacancy/Disable/Last/Use Hardware)
	123	** Switch between Normal and After Hours (for Timeout)
	124	** Change CCT Mode (Auto/Manual)
	125	** Assign Manual CCT
	126	** Extend Occupancy Timeout setting
	127	** Change Scenes Recalled by Occupied/Vacant/On/Off
	128	** Shade Command (Open/Close)
	129	** Plug Load Mode (Off/On/Auto)
	130	* Copy Actions from Area to Area
	131	* AM, PM, and Relative to Astronomical (Sunrise/Sunset) Time References
	132	* Event Verification by Date in real-time with month calendar view and event description
	133	* Require a scene to be active before recalling the scheduled scene (optional)
	134	* Advanced Scheduling Feature (Licensed)
	135	** Event Include and/or Exclude by Calendar(s) and/or Calendar Group(s)
	136	** Calendar Groups consist of one or more Calendars
	137	** Calendars can be based on a Date Range or Date Pattern
	138	** Calendar Properties:
	139	*** Date Range:
	140	**** Start and End Dates
	141	**** Specific Dates selected using Date Picker
	142	**** Recur Annually Option
	143	*** Date Pattern:
	144	**** Year - Restrict to specific year or none
	145	**** Month - Restrict to specific Month(s) or none
	146	**** Week - Restrict to specific Week of the month or none
	147	**** Week Day - Restrict to specific day of the week or none
	148	**** Day - Restrict to a specific day of the month or none
	149	**** Optional: Offset - Offset date based on restrictions
	150	**** Optional: Calculate Observed Weekday Date Before, After, or BeforeOrAfter
	151	*** Enable/Disable
	152	** Pre-loaded with US Federal and common non-Federal US Holidays
5.2	153	** Support for additional algorithms available upon request
4.2	154
5.1	155	==== Circadian Rhythm/Dynamic White ====
4.2	156
5.1	157	* Global system CCT Level
	158	* Override CCT per area by scene or manually
	159	* Crestron GLS-LCCT (SolarSync™) sensor integration for daylight tracking
	160	* Time period based
	161	** Time References for start and end of period
	162	*** AM/PM
	163	*** Relative to
	164	**** Sunrise
	165	**** Sunset
	166	**** Solar Noon
	167	** Each time period can have the following setting for CCT
	168	*** Static
	169	*** Linear change over time
	170	*** Sensor with configured CCT when sensor is out of range
5.2	171	* Supported with 0-10V, DMX, and DALI. Additional support via APIs
5.1	172
	173	==== Supported Hardware Features ====
	174
	175	Virtually the entire Crestron lighting product line is supported along with several 3rd party products
	176
4.2	177	* Common Settings to all devices
	178	** Contractor Label
	179	** Name
	180	** GlobalId
	181	** UniqueId (GUID)
5.1	182	* HVAC
	183	** Temperature control by area
	184	** Support for some Crestron Thermostats, more can be added as needed
	185	** Support for some 3rd party systems, more can be added as needed
1.1	186	* Keypads
5.2	187	** Support for common fixed configurations, user assignable at runtime. Includes all standard Crestron SpecsBuilder types.
4.2	188	** Custom keypads with configurable actions per button at runtime
	189	*** Graphic based programming using showrunner™ HUB UI
	190	*** Master raise/lower button support allows assignment of currently selected load/shade/area/etc
	191	*** Custom button layouts w/ labels to assist with generating engravings
	192	** Flexible Templating Engine
	193	*** Create common keypad templates
	194	*** Apply keypad templates to individual keypads
	195	**** Remap hardware when template is applied
	196	**** Optionally exclude specific hardware and/or buttons
1.1	197	** User configurable area to control
4.2	198	** Enable/Disable/Disable Off states
	199	** Prevent disable option
	200	** Flip raise/lower on common keypad types
	201	** Configurable hold time support, done in software if not supported by hardware
	202	** Configurable double tap time support if supported by hardware
	203	** Simulate keypads from showrunner™ HUB UI or console
	204	** Direct load mapping for some common keypads
5.1	205	* Keyswitch/Contact Closure Inputs
4.2	206	** Supports all versiport and digital inputs
	207	** Maintained and Momentary supported
	208	** Feedback output supported
	209	** Functions
	210	*** Override
	211	*** Scene Recall for Active and Inactive States
	212	*** Demand Response
	213	*** Actions for Active and Inactive States
6.1	214	** Commonly used for FACP, override, demand response, and panic inputs
1.1	215	* Occupancy Sensors:
4.2	216	** Occupancy configuration for CN and ZUMLINK occupancy sensors
1.1	217	** 3rd Party and Non-System occupancy sensor support
4.2	218	** Occupancy/Vacancy/Disabled/Use Hardware Logic modes, user configurable
1.1	219	** Configure scenes recalled by area for occupancy and vacancy states
5.2	220	** Individual max unoccupied level by load for IECC 2018 C405.2.1.3 compliance (open office 600sqft)
1.1	221	** User configurable assignment of sensor to area(s) and load(s)
	222	** Occupancy sensors may feed data to multiple areas and loads
4.2	223	** Last occupied and vacant times recorded
5.1	224	* Output Signal
	225	** Logic object capable of triggering additional logic
	226	** Can trigger physical outputs via versiports/IOs
	227	** Supports conditional logic
	228	** Independent actions for active/inactive states
	229	** Configurable delays for active/inactive execution
1.1	230	* Partition sensors
	231	** Support for divisible areas
	232	** GLS-PART-CN with adjustable sensitivity
4.2	233	** 3rd party sensor support via hardware inputs
5.2	234	** User configurable Auto (use sensor) with manual override for Combined and Divided
4.2	235	** Filtering to ignore noisy partition sensors
5.2	236	** Change count and last change recorded help troubleshoot
5.1	237	* Photocell
	238	** Supports Open Loop, Closed Loop, Exterior, and LCCT (as SolarSync™ and exterior)
	239	** Configurable coefficient
	240	** Configurable thresholds
	241	** Assignable to individual loads for daylight harvesting
	242	* Serial Interface
6.1	243	** RS-232/422/484 depending on hardware
5.1	244	** Configurable Baud Rate and Com settings
6.1	245	** Simple ASCII API for controlling/monitoring
5.1	246	** Areas/Loads/Occupancy/Partition/Shades supported
	247	* Shades
	248	** Support for Crestron shades/drapes
	249	** Support for many 3rd party shade and drape systems
6.1	250	* Zum Wired
	251	** Edge logic operation in Zum App mode
	252	*** Override occupancy logic and use showrunner™ logic
	253	** Central logic in CNET mode
	254	** Cresnet devices attached to ZUMNET-JBOXs in either Edge or Central modes
	255	* Zum Wireless
	256	** Override keypad buttons (except buttons 5-6)
	257	** Edge logic operation
	258	** Override occupancy behavior with showrunner™ logic
	259	** Direct load control
	260	** Scene save
	261	* Support for configuring hardware symbol properties on Crestron hardware
4.2	262
	263	==== Energy Efficiency ====
	264
1.1	265	* Demand Response/Load Shedding
	266	** Automatic via sensor input
5.1	267	** Manually via user input
4.2	268	* Calculated or Measured Power (Watts)
	269	* Energy Efficiency visualization on floorplan
	270
	271	==== Security ====
	272
	273	* Touchscreens: Global User and Technician Passcodes, user configurable.
	274	* showrunner™ HUB
	275	** Role Based permissions by Group
	276	** Granular Create, Edit, View, Delete, and Execute permissions by Role
	277	** Users and API Users assignable to groups
	278	** Restrict Group by area and tag
	279	** HTTPS enforced
	280	** Auto session timeout
	281	** Login via username/password or PIN code
6.1	282	** Support for Processor and internal user database with configurable priority or specify one exclusively
4.2	283	** Best practices for password handling
5.1	284	* API using AWSv4 scheme for authentication per request for maximum security
6.1	285	* Encrypted storage of all credentials and keys
4.2	286
6.1	287	==== General Features ====
4.2	288
1.1	289	* User configurable time zone, location, and current time
	290	* Addressing and Verification of Cresnet devices by serial number
	291	* Cresnet Device Serial Number capture
5.1	292	* Extensive console command interface (CLI)
6.1	293	* Simulate sensor and keypad inputs to test without hardware
	294	* DHCP server on single LAN processors allows setup of isolated networks without additional DHCP server.
	295	Note: DHCP server is not designed to be used in production and will automatically be disabled on a reboot, use for setup only.
1.1	296
6.1	297	==== Diagnostics ====
5.2	298
6.1	299	* Provides diagnostic data when supported by hardware
	300	* Diagnostics available from load controllers all the way up to Cresnet bridges
	301	* Status indications quickly assist with identifying severity of the problem: Normal, Warning, Critical, Status Only
	302
	303	==== Discovery ====
	304
	305	* Discover and automatically define Zum Wired hardware
	306	* Discover and automatically define Zum Wireless hardware
	307	* Discover Cresnet devices connected to the system, automatic addressing for configured hardware by serial number
	308	* Discover and claim select Crestron Ethernet devices connected to the local network, automatic IP Table setup when claiming
	309
	310	==== Event Log ====
	311
5.2	312	* Central logging mechanism
	313	* Messages time stamped
	314	* CSV format
	315	* Multiple logging levels: Critical, Error, Warning, Information, Debug, Trace
	316	* Filter by logging level
	317	* Filter by source object
	318	* Filter by GlobalId
	319	* Trace option allows tracking the triggering event through execution
	320	* Thread option allows tracking of the thread executing
	321	* Logging to console
	322	* Logging to file
	323	* Logging to remote syslog (via processor)
	324	* Heartbeat option with configurable interval
	325	* Debugging writes to the event log
	326	* Global Enable flag
	327
5.1	328	==== Extensibility ====
	329
	330	* Actions
	331	** Logic objects exist on showrunner™ objects
	332	** Functionality can be triggered via APIs
	333	** Used for defining the behaviors of global actions, custom keypads, and numerous other logic operations within showrunner™
	334	* Extensions
	335	** Extension model allows customization and additional functionality to be added to the showrunner™ ecosystem
	336	** [[Supported functions>>doc:SHOWRUNNER™ Integrations Guide.Integration Options.Extensions.WebHome]]
	337	* Global Actions
6.1	338	** Allow manual or input triggered operations against the system
5.1	339	** Can be custom programmed at runtime
	340
	341	==== User Interfaces ====
	342
	343	* showrunner™ HUB
6.1	344	** Web based, touch and mouse friendly design
5.1	345	** Runs directly on the processor or VC-4 instance
	346	** HTTPS required
	347	** Can be run in kiosk mode on a touchscreen PC for the full touchscreen experience
	348	** Node Tree
	349	*** Organize areas in logical locations based on physical topology
	350	*** Searchable, only shows matching areas
	351	** Floorplans
	352	*** Assigned to a node, multiple floor plans are supported
	353	*** Pinch zoom/touch pan
	354	*** User provided floorplan
	355	*** Draw directly on floorplan for areas and objects
	356	**** Areas
	357	**** Loads
	358	**** Partitions
	359	**** Occupancy Sensors
	360	**** Keypads
	361	**** Photocells
	362	*** Crestron product line icons area available to match the installed sensor
	363	*** Interactive control screens depending on clicked object
	364	*** Multiple different views help visualize data
	365	**** Area View - Shows areas with user selected colors
	366	**** Tags View - Shows areas based on their assigned tag
	367	**** Occupancy View - Shows areas based on their current occupancy status and how recently that status changed
	368	**** Intensity View - Shows areas shaded based on the current overall light intensity
	369	**** Energy View - Shows areas shaded based on the areas current energy efficiency from efficient to inefficient
	370	*** Automatic navigation to area when selected from the node tree
	371	*** Fullscreen view
	372	** Schedule
	373	*** See [[Scheduling Features>>doc:\|\|anchor="Scheduling Features"]] for more info
	374	** Reports
	375	*** Interactive data
	376	**** Area Loads
	377	**** Area Scenes
	378	**** Areas
	379	**** Cresnet (Query)
	380	**** Device Status
	381	**** Events
	382	**** Keypads
	383	** Setup
	384	*** Device Diagnostic - Show Diagnostic data from supported devices
	385	*** Hardware Management - Tree view of Ethernet, Cresnet, and RF topologies
	386	*** File Management - Manage config, license, currently active config, and backup/restore operations
	387	*** Global Actions - Add/Delete/Configure
	388	*** Integrations - Manage integrations with other showrunner™ systems
	389	*** Keypad Configuration - Configure keypads
	390	*** Maps - Add floorplan images
	391	*** Network - DHCP Server (for processors without routers only)
	392	*** System Settings - Manage various system settings
	393	*** Tags - Manage tags and association of tags with areas
	394	*** User Management - Manage users/groups/API users
	395	* Crestron TS/TSWs and Crestron App (iPad/iPhone/Android)
6.1	396	** Area Control Screen
	397	*** Select Area (Can be disabled or restricted)
	398	*** Divide/Combine status, if divisible
	399	*** Occupancy/vacancy status, if has an occupancy sensor
	400	*** Individual load controls
	401	*** Dynamic white color temperature control, if supported
	402	*** RGB color picker, if load supported
	403	*** Scenes, up to 20, save with press and hold
	404	*** Master Raise/Lower
	405	*** Global Actions, if defined, can be hidden
	406	*** HVAC controls, if supported
	407	*** Shade controls, if supported
	408	*** Passcode protected, if enabled
	409	** Setup Screen
	410	*** Passcode protected, if enabled
	411	*** Area Configuration
	412	**** Area List
	413	**** Area Name, editable
	414	**** Load Configuration - Configure load control type and labeling, test fixture operation
	415	**** Occupancy Setup - Configure area occupancy behavior and occupancy settings
	416	**** Daylight Harvesting - Configure daylight harvesting settings per load/scene
	417	**** Scene Setup - Configure and add/delete scenes
	418	**** Properties - Configure area behavior settings
	419	**** Add/Delete areas
	420	*** Area Layout - Configure partition sensors and area assignments to partition sensors
	421	*** Crestron Integration - Configure EISCs
	422	*** Device Addressing - Address and verify Cresnet devices
	423	*** Keypad Configuration - Configure keypad type, area assignment, and enable status
	424	*** Load Hardware - Configure loads and load controllers
	425	*** Location and System Clock - View/Set system clock, site lat/lon, and timezone
	426	*** Occupancy Assignment - Assign occupancy sensors to loads/areas
	427	*** Scheduler / Events - Add/Edit/Delete events, configure calendars, configure actions (for non-group events)
	428	*** Security Settings - Enable/Disable/Change PIN codes
	429	*** Zum Integration - Configure export to Zum Floor Hub
	430	*** Help Screen - Support contact information, showrunner version list, and license status
	431	** Custom Logo option for splash screen
	432	** Optional floor plan area selection, zoom/pan are NOT supported, static image only
	433	** Optional partition control on floor plan screen
5.1	434
1.1	435	=== Integrations ===
	436
6.1	437	* AV Integration protocol via serial port, simple ASCII protocol with feedback
	438	* BACnet Support for integration of Areas, Loads (Licensed Feature, both showrunner and Crestron)
5.1	439	** Global
	440	*** Override
	441	*** Demand Response
	442	*** Device Offline Count
	443	*** Alarm
	444	*** System Normal/After Hours
	445	** Area Specific
	446	*** showrunner™ Mode
	447	**** Occupancy Status
	448	**** Occupancy Enable
	449	**** Scenes
	450	**** Loads
	451	**** Photocell Level
	452	**** Overall Intensity
	453	**** Power (watts)
	454	*** Zum Hub Emulation Mode
	455	**** Online
	456	**** On
	457	**** Scenes
	458	**** Occupied
	459	**** Occupancy Sensor Enable
6.1	460	* Crestron Fusion EM (Licensed Feature)
5.1	461	** Scenes, Recall and Save
	462	** Load Control
	463	** Occupancy Status
	464	** Photocell
6.1	465	* e-DMX Receiver
5.1	466	** SACN and/or Art-Net
	467	** Enable/Disable control for loads using e-DMX channel value
4.2	468	** Map DMX to showrunner loads
	469	* EISC Export for AV Integration, dynamic creation from the UI (3-series, classic, EISC Client, EISC Server, VC-4 Client)
5.1	470	** Configurable IP address and IP-ID, change at runtime
	471	** Configurable rooms to export, change at runtime
	472	** Changes generate new RSD file at runtime that may be provided to the AV programmer
4.2	473	* HTTP REST API w/ Authorization
6.1	474	* Lightweight API provides real-time control/feedback using CoAP
5.1	475	* TCP Interface using simple ASCII commands, subscriptions supported
	476	* UDP Receiver using simple ASCII commands
4.2	477	* Zum Floor Hub Support for integration, Export showrunner™ areas to the Floor Hub (Licensed Feature)
5.1	478	* Remote hardware support from neighbor ShowRunner System:
	479	** Allows a central ShowRunner system to integrate edge processors
	480	** AV Serial Interface
	481	** Loads
	482	** Controllers
	483	** Keypad
	484	** Keyswitches
	485	** Occupancy Sensor (including setup for Cresnet sensors)
	486	** Partition Sensors (including setup for Cresnet sensors)
	487	** Photocells
1.1	488
6.1	489	==== Reporting ====
1.1	490
	491	ShowRunner provides a website via the processor's internal webserver with the following reports. All data is live at the time of the generation of the report.
	492
	493	* Area Load Schedule - Load schedule by Area
	494	* Area Scene Schedule - Scene settings by Area
	495	* Area - Areas defined
	496	* Cresnet Discovery - Performs an auto-discovery on every attached Cresnet bus and returns the results in a table. Duplicates are identified.
	497	* Device Status - Provides Cresnet, Ethernet, and Device online status and associated devices. Cresnet devices include Serial Number [TSID] and version #.
	498	* Event Schedule - Provides configured lat/lon, timezone, sunrise and sunset for current date, scheduled events with associated actions, and Calendars (Advanced Calendaring)
	499	* Keypad Schedule - Provides a list of keypads with Model, Name, Type, Connection Details, Enabled Status, Online Status, settings, and custom actions (if defined)
	500	* Load Schedule - Provides a list of loads per module per panel with connection information and settings. Report is grouped by panel and module.
	501	* Panel Schedule - Provides a list of lighting modules by panel with module type, label, and connection information.