Crestron SW-VOTE User Manual
  1. Manuals
  2. Brands
  3. Crestron Manuals
  4. Software
  5. SW-VOTE
  6. User manual
Crestron SW-VOTE User Manual

Crestron SW-VOTE User Manual

Crestron sw-vote software: user guide
Hide thumbs
Table of Contents

Advertisement

Quick Links

Enlarged version
CRESTRON
e-control™ Vote
(SW-VOTE)
version 1.5
© 1999, 2000 Crestron Electronics, Inc.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SW-VOTE and is the answer not in the manual?

Questions and answers

Related Manuals for Crestron SW-VOTE

Summary of Contents for Crestron SW-VOTE

  • Page 1 CRESTRON e-control™ Vote (SW-VOTE) version 1.5 © 1999, 2000 Crestron Electronics, Inc.

  • Page 2: Table Of Contents

    A word on licensing ... 4 Quick Start Guide 1: Request-to-Speak (demo1) Quick Start Guide 2: Voting (demo2) Introduction What is Crestron e-control™ Vote? ... 8 Leading Specifications ... 9 Requirements... 9 What is the Crestron Software Server?... 10 System Terminology and Topology ... 11 Feature Summary ...
  • Page 3 Crestron e-control Vote Appendix C: Signal Reference Definition of Terms ... 74 String Proxies ... 74 Bit Patterns ... 74 Error Reporting ... 75 Signal Summary ... 75 Signal Reference... 78 Appendix D: Error Conditions Appendix E: System limitations Serial Transmissions... 134 Signal Definitions...

  • Page 4: How To Use This Manual

    A word on licensing This is a licensed software product. A license “key,” obtainable from Crestron, is required to run it. However, built into the licensing mechanism is a 15-day free trial. How to Use This Manual...
  • Page 5 : The trial period of all Crestron Software Server products (SW-EMAIL, SW-DBM, SW-VOTE, etc.) all share the same trial period. That is, if you previously installed one of these products on the same computer more than 15 days ago, your free trial period for all three products has already expired, regardless of the fact that a new product has been installed.

  • Page 6: Quick Start Guide 1: Request-To-Speak (Demo1)

    Select shortcut e-control Vote Server from the Crestron folder in the Windows Start use config file Menu. If the title bar of the window does not read “e-control Vote (SW-VOTE) demovote.ini. Demos,” use the File | Configuration file… command to navigate to the demos folder and select the file demovote.ini.

  • Page 7: Quick Start Guide 2: Voting (Demo2)

    Select shortcut e-control Vote Server from the Crestron folder in the Windows Start use config file Menu. If the title bar of the window does not read “e-control Vote (SW-VOTE) demovote.ini. Demos,” use the File | Configuration file… command to navigate to the demos folder and select the file demovote.ini.

  • Page 8: Introduction

    What is Crestron e-control™ Vote? Crestron e-control Vote (SW-VOTE) uses a Crestron control system and a PC to perform both voting and request-to-speak functions. It is licensable software which runs on the PC and communicates with Crestron control system(s) to serve the voting and request-to-speak needs of a legislative body.

  • Page 9: Leading Specifications

    Voting Computer interface.) Leading Specifications The following table lists the Crestron products required to build an application using e-control Vote. Requirements The server should meet these minimum system requirements.

  • Page 10: What Is The Crestron Software Server

    The actual logic involved in the functions described in the previous section is not taken to imply a need for special- carried out by the control systems themselves, but by the freely distributed Crestron ized hardware. Any PC meeting e-control Software Server. This “server” is a software-only product which is hosted...

  • Page 11: System Terminology And Topology

    RS-232 port or an Ethernet network through a LAN port. To effect the latter type of connection, the control system relies on an intermediary, the Crestron CNX Gateway, to translate communications protocols. To aid in making this clear, the following illustrated discussion of system terminology and topology should prove useful at this point.
  • Page 12 IP address of the other. This kind of connection also requires the use of the CNX Gateway which is separately licensed software that facilitates communication between the server and the control system. The CNX Gateway is typically installed on the server (when sufficient TCP/IP sockets are available) or it can be installed on any computer visible (i.e., pingable) on...

  • Page 13: Feature Summary

    Crestron e-control Vote Feature Summary Licensing the SW-VOTE component permits the creation and activation of the following types of signal blocks (see “Signal Block Configuration and Definition,” page 30, for more information on signal blocks): Although the Voting Computer can simultaneously support multiple active Request- to-speak Consoles signal blocks, the present release only supports a single active Voting Console signal block.
  • Page 14 Crestron e-control Vote The following additional functions are only available to the PC screen or Crestron touchpanel interfaces (not available through a control panel-only interface): Vote reporting modalities include: Summary of Seat functions Each member’s seat has buttons for each kind of ballot they can cast, which normally...
  • Page 15 Crestron e-control Vote Queue sets Each RTS signal block can support an arbitrary number of queues (called a queue set), all of which can be active simultaneously. Typically a queue set will contain at least one queue for members to use to request time to speak on an item.
  • Page 16 Crestron e-control Vote Summary of Operator functions Through a touchpanel interface, working through the control system, the Operator has complete flexibility in recognizing seats in queues. Operator functions include: Speaker timer functions are not implemented in the server but are left to the control system.

  • Page 17: Installation

    To install the Software Server, first download the installer package from the Downloads page can be found at: Crestron FTP site. To do this, first go to the Crestron website and select the Downloads page. New users must register. Proceed to the ECONTROL Library.

  • Page 18: Transferring An Existing License To Another Computer

    Each package, once installed, generates a “Site Code” specific to the server on which licensed. An SW-VOTE license it is running. Upon being provided with these Site Codes, Crestron can issue the must be obtained from Crestron appropriate “Site Keys,” which, once entered into each package’s licensing window, even if other components are enables the full functionality of the software.
  • Page 19 On both the source computer (where the license is currently valid) and the destination computer (where the license is to be transferred), open the server application. Select Server | License to open the e-control Software Server – Upgrade/Transfer License window (shown above). Make sure this window is active on both computers.

  • Page 20: Basic Server Setup

    Basic Server Setup This product requires a proper physical connection between both “sides” of the system — the server and the control system. Furthermore, the software on both sides must be properly configured. As previously discussed, the connection can be either serial via RS-232 cable or Ethernet via Local Area Network (LAN).

  • Page 21: Communications Setup

    Run server application by selecting Database Manager from the Crestron folder of your Start menu. Select config file. Specify a Configuration Settings file (.ini file) by selecting File | Configuration File….
  • Page 22 CNX Gateway software.) Basic Server Setup Connect to server. Connect null-modem cables (Crestron model CNSP-532) from each control system to the server. Each connection requires its own COM port on the server side. The port to use on the control system depends on the specific model: CNMSX-PRO.
  • Page 23 Leading Specifications (page 9). To upgrade any of these files, retrieve a copy of the latest upgrade package from the Crestron website (OPSYS Library). These files have an extension of .upz which contains all three system components in one compacted file.

  • Page 24: Test Communications

    Crestron e-control Vote Test Communications At this point, test your connections. RS-232 control systems Use the Viewport to verify communications between the server and the CNX control system. Select Diagnostics | Establish Communications. If properly connected, the PC responds with the COM port and baud rate.
  • Page 25 Crestron e-control Vote Basic Server Setup All the signal blocks in the demo configuration already point to a COM Settings definition. Installation & Reference Guide — DOC. 5822 SW-VOTE...

  • Page 26: Server Configuration In Depth

    Crestron e-control Vote Server Configuration In Depth This section is a reference to all the options available in the Configuration Options window. Changes to options in this window are saved to the current Configuration Settings file when the OK or Apply buttons are actuated. Therefore, it is important to make sure you are operating on the appropriate Configuration Settings file before opening the window.

  • Page 27: Password Access

    Crestron e-control Vote Password Access Access to the server’s Configuration Options window is password-protected. This is to prevent end-user meddling with the configuration options, which can very possibly disable the server’s proper operation. Select Server | Configure. The server prompts the user for a password. Enter crestron2 which displays all tabs.

  • Page 28: Com Settings Configuration

    Crestron e-control Vote Deleting the file means that all configuration variables revert to their default values the next time the server is run. The problem with this approach, of course, is that you lose any settings already made. To reset the password only (without affecting the rest of the configuration), edit the .ini file using the Notepad application (Start | Programs | Accessories |...
  • Page 29 Crestron e-control Vote The Configuration Options window, COM Settings tab, showing the only connection defined in the demo configuration (selected). COM Settings definitions (connections) can be active or inactive. A check in the box next to the definition name indicates that the connection is activated. If not activated, it is ignored when the server protocol is started.

  • Page 30: Signal Block Configuration And Definition

    Control system generation Here you specify the type of control system. The server uses this information to take into account minor differences in the way the older generation of Crestron control systems functioned in terms of timing and data capacity.
  • Page 31 The Standard Scroller signal block has a static configuration designed to interface logic module is simply an with the included DBM Scroller Crestron logic module, found in the SIMPL Intersystem Communications Windows interface’s Program view, in the System Modules pane, Crestron Modules symbol paired with an Interlock folder, e-control Software sub-folder.
  • Page 32 Crestron e-control Vote The Configuration Options window, Signal Blocks tab, showing all the signal blocks defined in the demo configuration (in alphabetical order). As shown, all five signal blocks are active (checked); and the Voting Console signal block for demo2, VOTE, is selected.

  • Page 33: Interface Definition

    Crestron e-control Vote The highest numbered signal in the signal block’s input or output signal lists is shown in the box in the upper-right corner. This is based on the signal offset entered in the adjacent box and the current signal block definition. This value is updated synchronously as the user interacts with the window.
  • Page 34 Crestron e-control Vote Proctor window to reflect the actual chamber layout (from the Operator-operator's perspective). All such edits are saved along with other options in the configuration file. Editing the “Vote Proctor” window The Vote chamber layout window (shown below) is displayed along with the Vote Proctor window by clicking the Edit Vote Proctor Window button from the Voting Console Signal Block Definition window (see figure, p.
  • Page 35 Crestron e-control Vote The Body Tab The Body tab of the Voting Console Signal Block Definition window, showing part of the Server Configuration In Depth Loads a picture into the background. The picture will always be positioned in the upper- left corner of the window.
  • Page 36 Crestron e-control Vote The Voting Computer Interface Tab The Voting Computer Interface tab of the Voting Console Signal Block Definition window, Server Configuration In Depth Disables the Open Vote button in the Vote Proctor window until attendance has been taken. If you close and re-open the Vote Proctor window, you will have to take attendance again before being allowed to take a vote.
  • Page 37 Crestron e-control Vote The following options control the display and behavior of the Vote Proctor window: The Control System Interface Tab The Control System Interface tab of the Voting Console Signal Block Definition window, Server Configuration In Depth Enable Displays the Vote Proctor window when the signal block is enabled. Also enables the Voting | Start Voting command.
  • Page 38 Crestron e-control Vote Server Configuration In Depth Additional vote signals In addition to the always defined Yes and No Excuse signal sets. These are intended to be tied to additional seat vote buttons. Quorum & passage lights Defines the passage digital signals, TallyQuorum, TallyCarried, Tally23Majority.
  • Page 39 Crestron e-control Vote The Rules Tab The Rules tab of the Voting Console Signal Block Definition window, showing part of the The Reports Tab There are four reporting modes: Print[er], VGA [Display], Textfiles, and Database. Database is always enabled, and does not show up here at all.
  • Page 40 That is, all the information is displayed regardless of these settings. : A summary of each vote’s results is recorded in the database file’s Agenda table.
  • Page 41 Crestron e-control Vote Some notes on the textfiles: The files are named yymmddhhnnss.TXT (year-month-day-hour-minute- second). This forces the files to list in chronological order when sorted by name. Data in files consists of an identification line, a summary line, and a series of simple two-column (tab-delimited) tables.
  • Page 42 Crestron e-control Vote General options: The Request button behavior frame contains the following options: The Request-to-Speak Queue Definition frame contains a list of queues defining the queue set to be controlled by the RTS Console. See the following section , “Queue definition,”...
  • Page 43 Crestron e-control Vote Queue definition Queues are implemented as Scroller signal blocks. These can be either Standard Scrollers or Custom Scrollers. If you do not need to show more than eight lines at a time, Standard Scrollers can be used. (Demo1 shows only four lines at a time and uses Standard Scrollers.) Otherwise, you will need to use Custom Scrollers (which...
  • Page 44 Crestron e-control Vote Each RTS queue should be defined as either a Standard Scrollers or a Custom Scrollers, similar to the one pictured below: A Standard Scroller Signal Block Definition window, showing the defintiion of the QUEUE1 scroller from demo1.

  • Page 45: Software Server Windows And Menus

    Crestron e-control Vote Software Server Windows and Menus This section contains descriptions of the server’s two main windows, the Server Monitor window and the Signal Analyzer window. The Server Monitor Window While the server protocol is running, the Server | Start w/Signal Analyzer command from the Server Monitor window opens the Signal Analyzer window.
  • Page 46 File | Exit terminates the server application. If the server protocol is running, a warning message appears. Server | License… opens the e-control Software Server – Upgrade/Transfer License window for licensing and activating the various server components. Server | Configure… opens the Configuration Options window (described beginning on page 26).
  • Page 47 Crestron e-control Vote The following command is only available after the server protocol has been started: Database tables windows It is not necessary to have Microsoft Access to edit the Queries, Members, or Agenda tables; they can be edited directly from within the server application. Open...
  • Page 48 Crestron e-control Vote The Signal Analyzer Window While the server protocol is running, checking the Signal Analyzer command from the Server menu opens this window. The Signal Analyzer window, showing the all the active signal blocks defined in the demo configuration.
  • Page 49 Crestron e-control Vote Signal Simulator The top part of the window is for simulating receipt of incoming signals and transmission of outgoing signals. Signal Blocks & Connections This list contains all active signal blocks as well as all active connections that have signals defined (and hence can behave as signal blocks too).
  • Page 50 Crestron e-control Vote The File Menu The only currently implemented commands in this menu print the input and output signal lists for the currently selected signal block (File | Print Signal List | Selected), or for all active signal blocks (File | Print Signal List | All). This printout can be used to create matching Intersystem Communication symbols in SIMPL Windows.
  • Page 51 Crestron e-control Vote Server Configuration In Depth This option is also “sticky” like the Timestamps command. Log | Find… brings up the following modal window which helps locate a specific signal. Signal log search window. Searches can be performed with and without case sensitivity by checking the Match Case option.

  • Page 52: Database

    Database Tables This section discusses the database tables accessed by the various signal blocks of the SW-VOTE component of the Crestron Software Server. In the following table, for a given RTS Console: Database tables used by SW-VOTE component The Queries table can be viewed and edited with the Database | Table command;...
  • Page 53 Console signal block when it was created. different configuration files and/or different database files before the meeting begins. Another strategy for serving multiple rooms simultaneously might be to provide a separate PC for each, or, at least, a separate instance of the Software Server app. Database : The agenda scroller record in the Queries table must name Agenda in its table field.

  • Page 54: The Queries Table

    Crestron e-control Vote The Queries table Complete specifications for the Queries table can be found in the SW-DBM manual, Doc. 5823. For the present purposes it is sufficient to show how to specify queries for queue scrollers and agenda scrollers. Consider the example provided in the supplied sample database file.

  • Page 55: Queue Scroller Tables

    Crestron e-control Vote Queue scroller tables The request-to-speak queues are implemented as scrollers bound to tables with a structure as shown in the table below. The “list fields” are screenname and mark which means that these are the fields which are displayed in each row of the scroller.
  • Page 56 Crestron e-control Vote Field names are fixed and must appear exactly as shown above (case however is not significant). Set ID to be the primary key. Rather than creating an agenda table from scratch, we recommend copying the Agenda table from the supplied sample database file. Then edit its structure to suit your needs.

  • Page 57: Operations

    Crestron e-control Vote Operations This section describes the operation of the Vote Console and Request-to-Speak Console signal blocks as they process signals from the control system. All signals have names and are shown set in bold type as conjoined words with initial caps.
  • Page 58 Crestron e-control Vote If proctoring a vote from a touchpanel, before opening the floor to the vote, you must either: This checkbox is found under the Control System Interface tab of the This is only a requirement if the Auto-name an unnamed vote upon receipt of Start Voting Console Signal Block signal checkbox is not checked.

  • Page 59: Display Results

    Crestron e-control Vote The BALLOT_HIDDEN value is used in place of BALLOT_YES, BALLOT_NO, and BALLOT_ABSTAIN only during a secret ballot. (Votes are typically hidden from the control system when the Operator’s touchpanel is visible to the assembly until the floor is closed. This feature is controlled by the Tally actual ballots to control system only after floor is closed checkbox, found under the Control System Interface tab of the Voting Console Singal Block Definition window.)
  • Page 60 Crestron e-control Vote This action results in the server transmitting the following signals to the control system: Recording of vote is initiated by: This action results in the server transmitting the following signals to the control system: At this point the vote is concluded and the server is waiting for:...

  • Page 61: Request-To-Speak Console Operations

    Crestron e-control Vote State Coordination Several digital signals sent from the Voting Computer to the control system are used either for button feedback; or to coordinate the logical state of the control system with that of the Voting Computer; or both (as in demo2). The nature of these signals...
  • Page 62 Crestron e-control Vote Typical Request-to-Speak Load Page interface elements Console Page The Console Page consists of the following elements. Note that only the scrollers are absolute requirements. Typical Request-to-Speak Console Page interface elements Save Page The Save page is the normal egress from the RTS console page. On his way out, this...
  • Page 63 Crestron e-control Vote Typical Request-to-Speak Save Page interface elements Re-establishes the last known states of all queues, seat button feedbacks, and mic selection. Queues and seat request buttons are now active. Because the queues are database table-bound scrollers, the actual state of the queues is always instantly preserved in the tables.
  • Page 64 Crestron e-control Vote To enter a request to speak: Seat pulses Req signal. Seat’s screenname enters queue. (If seat already in the queue because already had the floor at least once, seat’s To cancel the request: Seat pulses Req signal again. Seat’s screenname removed from queue.
  • Page 65 Crestron e-control Vote To clear an individual queue, pulse one of the ClearQueue to a Clear This Queue button positioned near each queue). Note that queues can be configured to automatically clear whenever a seat in the first queue is recognized to speak. (See “Auto-clear,” page 43.) To clear all the queues in the queue set at once, pulse the ClearQueueSet signal (typcially tied, through an “Are you sure?”...

  • Page 66: Demos

    Crestron e-control Vote Demos Two demonstrations on the use of the Voting Computer are included with the package. Each demo is described along with an accompanying “bird’s eye view” diagram of its SIMPL program. All demos use the following three files:...
  • Page 67 Crestron e-control Vote Demo 2 VT Pro-e Program [section incomplete] [section incomplete] Demos Before proceeding to the actual demo page, start the server protocol by issuing the Server | Start command. Installation & Reference Guide — DOC. 5822 SW-VOTE...

  • Page 68: Appendix A: Theory Of Operation

    78 for in-depth information on these signals. Server Protocol Run the Crestron Software Server application, swserver.exe, to license (Server | License…) and configure (Server | Configure…) server operation. Although the server application is now running, the server protocol must be manually started (Server | Start) t o establish the communications link.
  • Page 69 Crestron e-control Vote the control system through the optional signal block that can be associated with a COM Settings definition which contains a similar set of error reporting signals.. These signals include ErrNumber, ErrString, and ErrTrigger. See the “Signal Reference,” beginning on page 78, for details.

  • Page 70: Appendix B: Intersystem Communications And Signal Space Considerations

    Appendix B: Intersystem Communications and Signal Space Considerations The Send e-Mail SIMPL Windows The following discussion applies in general to all Crestron Software Server symbol is available from the components. Keep in mind while reading this section that use of the Intersystem Crestron FTP site.
  • Page 71 Crestron e-control Vote Encoding and Decoding the Serial Data Stream Analog, serial, and digital signals to be sent from the control to the server are fed into the input (left) side of an Intersystem Communications symbol which encodes the signals into a serial data stream, available as an output labeled tx$ (for transmitter).
  • Page 72 Crestron e-control Vote to the control system. All the symbols’ rx$ and tx$ streams are tied to the same serial driver symbol. The set of signals intended for a particular Intersystem Communications symbol are distinguished from the other sets by their offset and/or their channel number.

  • Page 73: Multiple Connections

    Crestron e-control Vote Multiple channels Multiple channels apply to connections made through Virtual COM Ports only (i.e., TCP/IP connections only). Each Virtual COM Port can have up to 128 channels, where each channel can be thought of as a separate COM port. If a separate channel is used for each Intersystem Communications symbol, then all Intersystem Communications symbols can use an offset of zero (i.e., no offset).

  • Page 74: Appendix C: Signal Reference

    (b) transport buttons, and (c) an optional analog gauge object serving as a scrollbar. Also (2) the signal block which services such a construct. Server The Crestron Software Server. That is, swserver.exe running on a Windows PC. Signal Block Active component within the Server, which listens for and responds to signals from connected control systems.

  • Page 75: Error Reporting

    Crestron e-control Vote Base 16 used for notational purposes Straight base 2 notation (a long string of 0s and 1s) is considered to be too unwieldy to be useful to the human eye as it is too easily prone to misrepresentation and misinterpretation.
  • Page 76 Crestron e-control Vote listing of all the inputs and outputs. To do this, start the server using the Server | Start w/o connecting command and select the signal block you are interested in from the Signal Blocks & Connections listbox.
  • Page 77 Crestron e-control Vote Voting Console Signal Block Summary The following signals comprise a Voting Console signal block. The number and precise selection of signals varies based on the specific signal block definition. Appendices Signal Name Direction system-to-server SendNames system-to-server Yield...

  • Page 78: Signal Reference

    Crestron e-control Vote Signal Reference The alphabetical reference proper begins on the next page. Regarding references herein to a signal raising an error condition, see “Appendix D: Error ,” page 132. Appendices Signal Name Direction system-to-server SW-VOTE Type Installation & Reference Guide — DOC. 5822...
  • Page 79 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Abort Abort voting sequence Voting Computer to control system Digital Assert: Results now being recorded on Voting Computer ([Print &] Save Results button feedback ON) De-assert: Results have been recorded ([Print &] Save Results button feedback OFF)
  • Page 80 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Abstain Seat abstains control system to Voting Computer Digital Pulse None This signal is accepted by the Voting Computer while the floor is opened for voting only. Even when the floor is opened, it will be ignored §...
  • Page 81 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices AgendaEcho Agenda item description Voting Computer to control system Serial New agenda item description; may be partial Start or Abort This signal is sent when the agenda item description has changed either from the Voting Computer interface by selecting a pre-entered agenda item from the combo- box, or typing a character into same;...
  • Page 82 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices AgendaTrigger Agenda item has been set Voting Computer to control system Digital Pulse Start or Abort This signal is pulsed when a valid agenda item has been selected or entered either from the Voting Computer interface or from the Control System Interface.
  • Page 83 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Attendance Open floor to special attendance-taking “vote” Voting Computer to control system Digital Pulse Success: StateStart assert; followed by Done pulse Failure: ErrString See comments at Start.
  • Page 84 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Change Change a vote control system to Voting Computer Digital Pulse Success: Status signal with new value for this seat Done pulse Failure: ErrString These signals are generally tied directly to touchpanel buttons positioned over each seat.
  • Page 85 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices ClearFiles Clears all “save files” Control system to Voting Computer Digital Pulse Done pulse Deletes all records from all q x f “save file” tables where q is the number of queues in the queue set and f is the number of save file sets configured for this signal block.
  • Page 86 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices ClearQueue Clears a specific queue Control system to Voting Computer Digital Pulse Done Clears the scroller which implements the q table bound to the scroller is cleared, and signals are sent to the control system to clear the scroller display.
  • Page 87 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices ClearQueueSet Clears all queues at once Control system to Voting Computer Digital Pulse Done Clears all the the signal block’s queue scrollers. The tablesbound to the scrollers are cleared;...
  • Page 88 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices DateTime Sends timestamps of each “save file” Voting computer to control system Serial Timestamps for the last modification of each “save file” defined in the signal block.
  • Page 89 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Display Display vote results on Voting Computer control system to Voting Computer Digital Pulse Success: StateEnd de-assert; followed by StateDisplay assert; followed by Done pulse Failure: ErrString...
  • Page 90 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Done Server operation complete Voting Computer to control system Digital Pulse None Issued after processing most “command” signals (signals which initiate a procedure as opposed to those that simply transmit states) except for those signals which have custom response signals defined along with them.
  • Page 91 Crestron e-control Vote Description Direction Type Value Expected Reply Comments Appendices Enable This signal enables/disables the signal block. control system to Voting Computer Digital Assert to enable the signal block De-assert to disable the signal block Success: Assertion of the signal block’s Enabled signal Failure: An error condition is raised, typically Err_ENABLE Assert this signal to enable the signal block.
  • Page 92 Crestron e-control Vote SW-VOTE See Also Enabled, SendNames, Name, DateTime, MicSelect Appendices Installation & Reference Guide — DOC. 5822...
  • Page 93 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Enabled “Handshake” response to the Enable signal. Server to System Digital Asserted in response to assert of Enable signal. De-asserted in response to de-assertion of Enable signal.
  • Page 94 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Close floor to further voting control system to Voting Computer Digital Pulse Success: StateStart de-assert; followed by StateEnd assert; followed by Done pulse Failure: ErrString This signal is only valid during a vote when the floor is opened for voting (while StateStart is high).
  • Page 95 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices ErrNumber When the server encounters an error processing a request from the System, it uses this signal to send an error number. Server to System Analog New error number...
  • Page 96 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices ErrString Description of error Server to System Serial Error message for display None Although this signal can be safely ignored, it is easily hooked to indirect text fields on a touchpanel and/or on the CNMSX-PRO front panel, etc.
  • Page 97 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices ErrTrigger Trigger for ErrNumber and ErrString Server to System Digital Pulse None This signal is sent after the ErrNumber and ErrString to indicate that an error condition has occurred.
  • Page 98 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Excuse Seat excuses itself control system to Voting Computer Digital Pulse None This signal is accepted by the Voting Computer only while the floor is opened for voting only.
  • Page 99 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Hold Puts the recognized seat on hold control system to Voting Computer Digital Pulse Done pulse This signal is an automatic way for the control system to suspend debate.
  • Page 100 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Load Load “save file” f into the queue-set control system to Voting Computer Digital Pulse Success: Done pulse Failure: The Err_TABLE_NOT_FOUND error condition is raised Loads all the queues in the queue set. There must be a “save file” table for each queue.
  • Page 101 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices MicSelect Currently recognized seat Voting Computer to control system Analog Reset (set to 0): no seat recognized Other values: seat number of recognized speaker None This signal is sent out every time a seat is recognized to speak, or when the currently recognized seat becomes otherwise unrecognized (either by being put on hold;...
  • Page 102 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Name Seat names Voting Computer to control system Serial Screennames strings None Screennames from records in the Members table are sent (or resent) in response to receipt of a SendNames signal.
  • Page 103 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices NewVote Vote sequence has been reset Voting Computer to control system Digital Pulse SetAgenda, Start, or Attendance This signal is pulsed when: § The signal block is first enabled;...
  • Page 104 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Seat votes N control system to Voting Computer Digital Pulse None This signal is accepted by the Voting Computer while the floor is opened for voting only. Even when the floor is opened, it will be ignored when the seat has been excused from the vote, either by the operator prior to opening the floor, or by the seat itself via a prior pulse of its Excuse signal.
  • Page 105 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices PingSvr, PingSys, PongSvr, PongSys Request for acknowledgement PingSvr: System to Server PongSvr: Server to System to Server PingSys: Server to System PongSys: System Digital Pulse PongSvror PongSys When the Server receives a PingSvr signal, it immediately responds with a PongSvr signal pulse.

  • Page 106: Print Report

    Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices PrintReport Print displayed queue set control system to Voting Computer Digital Pulse Done pulse The printout is formatted for letter size paper (8.5” x 11”) to print up to five (5) queues, each in its own column, containing up to about 80 names each.
  • Page 107 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices PrintSave Record vote; conclude voting sequence control system to Voting Computer Digital Pulse Success: StateEnd de-assert; followed by StatePrintSave assert Failure: ErrString Recording the vote makes the vote official; after issuing this signal, the vote can no longer be cancelled.
  • Page 108 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Tied directly to the request-to-speak button for queue q at seat s control system to Voting Computer Digital Pulse (the Voting Computer responds to the trailing edge of the signal) Req-fb assert or de-assert;...
  • Page 109 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Req-fb Tied directly to the request-to-speak button feedback for queue q at seat s Voting Computer to control system Digital On: In queue and waiting to speak or speaking Off: Not in queue;...
  • Page 110 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Save Save the queue set into “save file” f control system to Voting Computer Digital Pulse Success: Done pulse Failure: The Err_TABLE_NOT_FOUND error condition is raised Saves all the queues in the queue set. There must be a “save file” table for each queue.
  • Page 111 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices SelectChair Promote a seat to the chair control system to Voting Computer Accept voting signals from the Chair position as if coming from the selected seat position.
  • Page 112 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices SendNames Request names be sent control system to Voting Computer Digital Pulse All Name serial signals; followed by Done signal pulse. (See notes at Name.) Name SW-VOTE...
  • Page 113 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices SetAgenda Set agenda item description. control system to Voting Computer Digital Pulse AgendaEcho followed by one of: § AgendaTrigger pulse; or § NewVote pulse The Control System Interface Tab” page 37.) If this option is not checked, a name will be generated for the vote comprised of the current date and time.
  • Page 114 Crestron e-control Vote SW-VOTE Appendices Installation & Reference Guide — DOC. 5822...
  • Page 115 Crestron e-control Vote Description Direction Type Value Expected Reply Comments Appendices Start Open floor to voting control system to Voting Computer Digital Pulse Success: StateStart assert; followed by Done pulse Failure: ErrString This is one of two signals that can be used to start the voting sequence; the other is the Attendance signal.
  • Page 116 Crestron e-control Vote SW-VOTE VOTE DISPLAYED: Press DISPLAY again to redisplay; SAVE RESULTS; or ABORT VOTE. See Also Attendance, End, Abort Appendices Installation & Reference Guide — DOC. 5822...
  • Page 117 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices StateDisplay Results on display Voting Computer to control system Digital Assert: Results now displayed on Voting Computer and/or need to be displayed on some device connected to control system...
  • Page 118 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices StateEnd Voting concluded Voting Computer to control system Digital Assert: Voting concluded, console ready to display or print/save (End Vote button feedback ON) De-assert: Results displayed or printed/saved...
  • Page 119 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices StatePrintSave Vote is being recorded Voting Computer to control system Digital Assert: Results now being recorded on Voting Computer ([Print &] Save Results button feedback ON) De-assert: Results have been recorded ([Print &] Save Results button feedback OFF)
  • Page 120 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices StateStart Floor is opened to voting (i.e., a vote is in progress) Voting Computer to control system Digital Assert: Floor is opened (Start Vote button feedback ON)
  • Page 121 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Status Individual seat status Voting Computer to control system Analog 0 ... A BSENT 1 ... P RESENT 2 ... Y 3 ... N 4 ... A BSTAIN 5 ...
  • Page 122 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Tally23Majority Motion has achieved a 2/3 majority Voting Computer to control system Digital Assert: Motion currently has sufficient votes to qualify for “2/3 majority” De-assert: Motion currently has insufficient votes to qualify for “2/3 majority”...
  • Page 123 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices TallyAbstain Total number of current abstentions Voting Computer to control system Analog 0 to s (where s = number of seats defined in signal block configuration) None Updated on any change to any seat at any time: §...
  • Page 124 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices TallyCarried Motion carries Voting Computer to control system Digital Assert: Motion currently has sufficient votes to carry De-assert: Motion currently has insufficient votes to carrry None The definition of “carries” is based on the signal block’s configuration. (See “The Rules Tab,”...
  • Page 125 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices TallyExcused Total number of excused voters Voting Computer to control system Analog 0 to s (where s = number of seats defined in signal block configuration) None Updated on any change to any seat at any time: §...
  • Page 126 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices TallyNo Total number of current N votes Voting Computer to control system Analog 0 to s (where s = number of seats defined in signal block configuration)
  • Page 127 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices TallyQuorum Motion is subject to a voting quorum Voting Computer to control system Digital Assert: Motion currently has sufficient votes to meet quorum requirements De-assert: Motion currently has insufficient votes to meet quorum requirements None The definition of “voting quorum”...
  • Page 128 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices TallyTotal Total number of current votes Voting Computer to control system Analog 0 to s (where s = number of seats defined in signal block configuration) None The total number of votes includes the sum of all Y abstentions.
  • Page 129 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices TallyYes Total number of current Y votes Voting Computer to control system Analog 0 to s (where s = number of seats defined in signal block configuration)
  • Page 130 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Seat votes Y control system to Voting Computer Digital Pulse None This signal is accepted by the Voting Computer while the floor is opened for voting only. Even when the floor is opened, it will be ignored when the seat has been excused from the vote, either by the operator prior to opening the floor, or by the seat itself via a prior pulse of its Excuse signal.
  • Page 131 Crestron e-control Vote Description Direction Type Value Expected Reply Comments See Also Appendices Yield Forces the recognized seat to yield the floor control system to Voting Computer Digital Pulse Done pulse This signal is an automatic way for the contorl system to force the current speaker to yield.

  • Page 132: Appendix D: Error Conditions

    Crestron e-control Vote Appendix D: Error Conditions When an error condition arises, the error number is sent via the ErrNumber analog signal through the signal block that raised the error to the control system. The error string is sent via the accompanying ErrString serial signal. Finally, the ErrTrigger digital signal is pulsed.
  • Page 133 Crestron e-control Vote Appendices Err_FIELD_NOT_WRITTEN 32011 No such record(s) Err_CANNOT_ADD_RECORD 32012 Syntax error in query Err_CANNOT_DELETE_RECORD 32013 Field could not be written Err_NO_SUCH_RECORD 32014 A new record could not be added Err_QUERY_SYNTAX 32015 The opened record could not be deleted...

  • Page 134: Appendix E: System Limitations

    The XSIG format limits the number of signals to 4096, only the first 1024 of which may be analog or serial signals. Furthermore, the older generation of Crestron control systems has a limit of 512 analog/serial signals. (This is not an issue with the newer CNMSX and CNRACKX systems which allow a full 4096 analog/serial signals.)

  • Page 135: Appendix F: Standard Scrollers Vs. Custom Scrollers

    Crestron e-control Vote Appendix F: Standard Scrollers vs. Custom Scrollers Inspection of any standard scroller signal block, or its SIMPL Windows counterpart, the DBM Scroller logic module, shows that it defines only the most essentail scroller signals. Appendices Standard scroller options...

This manual is also suitable for:

E-control vote

Table of Contents