Crestron e-control Vote User Manual Download Page 56

Page: 56 / 135

Crestron

e-control Vote SW-VOTE

••

Database

Installation & Reference Guide — DOC. 5822

Field Name

Data Type

Data Size

Indexed

YesVotes

Number

Integer

NoVotes

Number

Integer

Abstentions

Number

Integer

TotalVoting

Number

Integer

Excuses

Number

Integer

Absentees

Number

Integer

Field names are fixed and must appear exactly as shown above (case however is not
significant). Set

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.

Summary of Contents for e-control Vote

Page 1: ...CRESTRON e control Vote SW VOTE version 1 5 1999 2000 Crestron Electronics Inc...

Page 2: ...ver Side Setup 24 Server Configuration In Depth 26 Specifying a Configuration File 26 Creating a New Configuration File 26 Transporting a Configuration 26 Password Access 27 COM Settings Configuration...

Page 3: ...Signal Reference 74 Definition of Terms 74 String Proxies 74 Bit Patterns 74 Error Reporting 75 Signal Summary 75 Signal Reference 78 Appendix D Error Conditions 132 Appendix E System limitations 134...

Page 4: ...0 and A programming cable CNSP or equivalent A null modem cable with hardware handshaking CNSP 532 Follow the instructions in the guide precisely in the order given and you should be up and running in...

Page 5: ...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 ag...

Page 6: ...m cable from COM1 on the PC to COM A on the CNMSX PRO The programming cable may now be removed 5 Run the server application The installer sets the server to use config file demovote ini Select shortcu...

Page 7: ...NMSX PRO The programming cable may now be removed 5 Run the server application The installer sets the server to use config file demovote ini Select shortcut e control Vote Server from the Crestron fol...

Page 8: ...ote 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 C...

Page 9: ...uter interface Leading Specifications The following table lists the Crestron products required to build an application using e control Vote Specifications Details Version SWSERVER EXE included with th...

Page 10: ...ing the minimum requirements page 9 will suffice to run the server application The actual logic involved in the functions described in the previous section is not carried out by the control systems th...

Page 11: ...ut the manual these systems are referred to using the terms in the following table Also refer to the diagrams on the next page Term Explanation The system or the control system One of a number of Cres...

Page 12: ...ot necessary when using RS 232 serial communications TCP IP connections between the server and the control systems require that each side of the connection be provided with the IP address of the other...

Page 13: ...ter the bodies they represent However it should be noted that the present release only supports switching configurations when the server is halted and this operation must be carried out from the Votin...

Page 14: ...at least Yes also doubles for present during taking of attendance No Seats might also have the following additional buttons Abstain Conflict actually a Request to Speak button see next section All vot...

Page 15: ...abase includes the names in each queue in the order in which they were added to the queue and the specific states of each name Whenever a queue set is reloaded individual seat button feedbacks are inf...

Page 16: ...matically clears any dependent queues as well Clear all queues Kills mic if any active automatically clears any dependent queues as well Save queue set Saves current state of all queues for reloading...

Page 17: ...each seat or some other display plainly visible to all seats can be used to indicate who has the floor Such as a large seat number display or a public video display of the Operator s Request to Speak...

Page 18: ...com Once received Crestron Customer Support issues a Site Key which must either by typed or pasted into the Site Key field of the window Once entered click on the Update License button If the key is...

Page 19: ...irst make sure that both computers have the appropriate read write access to the drive and folder being used Step 2 After the above step has completed remove the diskette from the drive and insert it...

Page 20: ...ted Configuration Settings file If the server s title bar does not read e control Vote SW VOTE Demos use the File Configuration file command to reset it This file configures the server for both demos...

Page 21: ...igured to use RS 232 Control System Side RS 232 Serial communication requires wiring the server directly to the control system NOTE Serial communications requires neither the CNX Gateway software nor...

Page 22: ...mation on control system TCP IP setup consult the e control Overview document overview pdf installed with the CNX Gateway software or the SIMPL Windows release notes installed with SIMPL Windows TCP I...

Page 23: ...7 Enter gateway address Still in the Viewport select Functions Setup IP Table to open the IP Table window Click on the Retrieve Current IP Table from control system button to display the current list...

Page 24: ...114 bytes 32 time 5ms TTL 60 Reply from 11 112 113 114 bytes 32 time 5ms TTL 60 Once a reliable connection is established test that the CNX control system is listening and responding properly Reconfi...

Page 25: ...Crestron e control Vote SW VOTE 25 Basic Server Setup Installation Reference Guide DOC 5822 All the signal blocks in the demo configuration already point to a COM Settings definition...

Page 26: ...w Configuration File We recommend duplicating the demo configuration file and modifying the copy as follows Locate the file and copy and paste it renaming it appropriately Point the server to the new...

Page 27: ...uration Options window The Configuration options window General tab showing all tabs correct password entered The password may be changed from the General tab Click on the Change Password button to op...

Page 28: ...ntrol systems All active signal blocks Signal Blocks tab must reference such a structure See COM Settings page 33 for instructions on defining such a reference for your signal blocks The COM Settings...

Page 29: ...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 i...

Page 30: ...described in the Server Side configuration sections for RS 232 page 21 and TCP IP page 22 System level signal definitions In this window you can also define optional system level signals by checking...

Page 31: ...sole and Request to Speak Console signal blocks communicate with Intersystem Communications XSIG symbol Both the Voting Console and Request to Speak Console signal blocks use scrollers either type in...

Page 32: ...can have any number of signal blocks defined and active simultaneously Selecting a signal block from the list in the Signal Blocks tab and clicking the Modify button or defining a new signal block wi...

Page 33: ...ttings definition by selecting it from the list Each signal block must be associated with a control system Control systems are defined separately under the COM Settings tab You may define the signal b...

Page 34: ...button saves all edits and closes the Vote Proctor window as well The Cancel button closes both windows discarding all edits The acronym WYSIWYG wizzy wig stands for What You See Is What You Get Edit...

Page 35: ...Vote Results window is not adjustable in this version and will always display at 1024 x 768 Add Seat and Delete Seat These buttons parallel the functions of the key and the Delete key shortcuts respec...

Page 36: ...perator must explicitly indicate which seat to swap with the vacant chair seat prior to taking attendance or a vote Automatically select seat When no explicit chair seat selection has yet been made th...

Page 37: ...e Vote Proctor window turn grey as they vote Actual votes are tallied to the Vote Proctor window only after the floor is closed NOTE A secret ballot is actually only secret while the floor is opened O...

Page 38: ...via this signal The description may originate from either the control system or the Voting Computer Local feedback Check this option to define the three error signals ErrString ErrNumber and ErrTrigge...

Page 39: ...alue of the TallyQuorum signal and the QUORUM indicator in the Vote Proctor window Required to CARRY Options in this frame affects how the server calculates the value of the TallyCarried signal and th...

Page 40: ...this is only a summary See Database tables windows page 47 for an illustration of this table and Agenda scroller tables page 55 for additional information Only the Print and Save reporting modes will...

Page 41: ...name tab NO and a single table for all remaining types of votes if any including abstentions ABSTAIN excused voters EXCUSED and voters who refused or neglected to vote before the Operator closed the...

Page 42: ...ses while in the WAITING state are ignored Member yields his remaining time This refers to the behavior of the RTS button if pressed when the seat is already in the queue and in fact currently has the...

Page 43: ...ndard 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 Otherwis...

Page 44: ...for each The ID numbers of these supplied records are 1 through 5 Note that demo2 uses the first two List rows r In Use Enter here the number of rows to be displayed on the touchpanel Value must not e...

Page 45: ...ntains a colorful legend above a series of small numbered rectangles representing each of the defined systems The color of a control system s rectangle indicates its connection status according to the...

Page 46: ...er opens or closes the Signal Analyzer window When this item is checked the window is opened When it is unchecked the window is closed The remaining commands are always available Server Log Timestamps...

Page 47: ...ver only the one table The data grid controls in this window feature the following interactivity for editing the tables For viewing purposes only tables can be sorted by clicking on the head of each c...

Page 48: ...the window For example if the database file has been placed on a file server and has recently been edited from another computer you can display those edits by clicking this button NOTE Changes are no...

Page 49: ...at signal is received with a signal number that expects a serial signal To simulate a signal after selecting your signal block select an item from one of the signal lists You are now ready to send the...

Page 50: ...associated with the signal block is not connected has no practical effect This function is also available by clicking the tx button under the incoming signal list The Log Menu This menu contains the f...

Page 51: ...at the search algorithm disregards the upper and lower case status of the characters in the search key Also when the window opens the search direction is set to Forward to end meaning that the search...

Page 52: ...vote By scroller from control system used to select an agenda item prior to a vote Members Sent to control system upon receipt of the SendNames signal As the data source for seat names and possibly o...

Page 53: ...its own Specifically if an RTS Console has three queues and five save files you must create 3 x 5 15 additional empty tables congruent in structure to your queue tables These tables are named as follo...

Page 54: ...d tables in the table field is arbitrary We suggest keeping the names the same as those given to the scroller signal blocks implementing the queues condition Null listFields The listFields field must...

Page 55: ...ed ID AutoNumber Long Integer Yes No Duplicates Seat Number Integer No Screenname Text 16 Yes No Duplicates State Text 1 No Rank Number Byte No Field names are fixed and must appear exactly as shown a...

Page 56: ...er Integer No TotalVoting Number Integer No Excuses Number Integer No Absentees Number Integer No Field names are fixed and must appear exactly as shown above case however is not significant Set ID to...

Page 57: ...ies of seat icons arrayed in a pattern that typically reflects the actual chamber floorplan The seats icons are clickable touchable 1 Excusing Voters Operator adjustments to non absentee seats are now...

Page 58: ...following signals to control system Transmission of Agenda Item Description string via AgendaEcho serial signal Assert of StateStart see Clearing of all Tally signals see below i e analogs set to 0 d...

Page 59: ...StateStart and assert of StateEnd signal 6 Ballot Adjustments Operator adjustments to ballots are now accepted by clicking a seat in the Voting Computer or receipt of a Changei signal The Voting Compu...

Page 60: ...ve 10 Abort Vote This operation may be initiated at any time after Open Vote and before Display Results by clicking the Abort Vote button in the Voting Computer or pulse of the Abort digital signal co...

Page 61: ...r in the control system within a single logic wave This makes hiding one sub page and showing another sub pages cleaner closer together in time StateStart StateEnd StateDisplay and StatePrintSave can...

Page 62: ...of the following elements Note that only the scrollers are absolute requirements Typical Request to Speak Console Page interface elements Interface Element Signal s Notes a scroller for each queue Per...

Page 63: ...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...

Page 64: ...the mic at the old seat is switched off and the mic at the new seat is switched on 6 Put a seat on hold If a seat is recognized in error or if the recognized seat wishes to yield temporarily operator...

Page 65: ...eueSet signal typcially tied through an Are you sure dialog to a Clear All Queues button 12 Save queue set To save the queue set proceed to the Save Page and pulse one of the Save signals 13 Clear all...

Page 66: ...piled control system program file which uses serial RS 232 communications demo COM bin file derived from the above by commenting off the Virtual COM port ready to upload to such a control system A com...

Page 67: ...W VOTE 67 Demos Installation Reference Guide DOC 5822 Demo 2 VT Pro e Program section incomplete NOTE Before proceeding to the actual demo page start the server protocol by issuing the Server Start co...

Page 68: ...he number of active signal blocks of each type cannot exceed the respective limits of your license Should this happen a warning appears on the Signal Blocks tab and the server protocol does not start...

Page 69: ...22 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 Er...

Page 70: ...mbol Likewise Standard Scroller signal blocks can use the DBM Scroller SIMPL Windows logic module Each active signal block exchanges data with a particular running in a control system connected to the...

Page 71: ...ignals available However while the first 1024 signals may be of any type Analog serial or digital the remaining 3072 signals can only be used for digital signals An additional constraint imposed by th...

Page 72: ...tersystem Communications symbols using the same connection must specify a value to offset their signal numbers by a constant amount The top signals in such an Intersystem Communications symbol do not...

Page 73: ...le channel connections Do not use multiple channels if there is any possibility of needing to revert to an RS 232 connection Multiple Connections Usually all Intersystem Communications symbols from a...

Page 74: ...ard scroller signal block System A Crestron control processor along with appropriate programming String Proxies The various Echo signals keep a server side proxy of the data last sent to the system Be...

Page 75: ...69 in base 10 again we are only interested in bit patterns here not the quantities they may represent Error Reporting At this time error handling is a little haphazard with some errors being tallied b...

Page 76: ...the Systems point of view This accommodates pinging from either a Systems to the Server or b vice versa Signal Name Direction Type Done server to system D ErrNumber server to system A ErrString serve...

Page 77: ...er to system D Enable system to server D Enabled server to system D End system to server D ErrNumber server to system A ErrString server to system S ErrTrigger server to system D Names server to syste...

Page 78: ...ation Reference Guide DOC 5822 Signal Name Direction Type Yess system to server D Signal Reference The alphabetical reference proper begins on the next page Regarding references herein to a signal rai...

Page 79: ...ls are de asserted and analog tally signals are reset to 0 All Changes signals are reset to 1 present if aborting attendance taking or either 0 absent or 1 present if aborting a vote AgendaEcho with t...

Page 80: ...gnal rather than Start signal The seat may pulse its Yes No and Abstain signals at will while the floor is opened The most recently pulsed signal is considered definitive at the moment the floor is cl...

Page 81: ...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 or from the Contr...

Page 82: ...by the control system to indicate the state of the voting sequence through screen button feedback or by enabling disabling certain screen buttons An example of the use of this signal is provided in d...

Page 83: ...endance Voting Console Description Open floor to special attendance taking vote Direction Voting Computer to control system Type Digital Value Pulse Expected Reply Success StateStart assert followed b...

Page 84: ...SENT EXCUSED Attendance taking PRESENT ABSENT Regular vote PRESENT YES NO ABSTAIN EXCUSED After making all changes pulse the Display signal to redisplay the vote results on the Voting Computer Additio...

Page 85: ...ected Reply Done pulse Comments 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 bl...

Page 86: ...the scroller which implements the q th queue defined in the signal block The table bound to the scroller is cleared and signals are sent to the control system to clear the scroller display If any seat...

Page 87: ...ted Reply Done Comments Clears all the the signal block s queue scrollers The tablesbound to the scrollers are cleared and signals are sent to the control system to clear the scroller displays All sea...

Page 88: ...each save file defined in the signal block Format is short date medium time typically month day year hour minute AM or PM Expected Reply None Comments The values are sent automatically when the signal...

Page 89: ...play is high or to redisplay the results if no longer displayed StateDisplay is low Updating redisplaying is only really necessary when the vote results have been edited by the operator using either t...

Page 90: ...rver operation complete Direction Voting Computer to control system Type Digital Value Pulse Expected Reply None Comments Issued after processing most command signals signals which initiate a procedur...

Page 91: ...sent through each DateTimef signal The last known state of the queue set is re established using the appropriate signals to adjust the console display set all the seat button feedbacks and set the val...

Page 92: ...Crestron e control Vote SW VOTE 92 Appendices Installation Reference Guide DOC 5822 See Also Enabled SendNames Name DateTime MicSelect...

Page 93: ...ing the signal block usually upon arrival to a certain touchpanel page the System should 1 Wait for assertion of Enabled before issuing any other Voting Consoles 2 Indicate an error condition if asser...

Page 94: ...Done pulse Failure ErrString Comments This signal is only valid during a vote when the floor is opened for voting while StateStart is high If issued at the wrong time one of the following descriptive...

Page 95: ...d Reply None Comments This signal works in conjunction with the ErrString and ErrTrigger signals which always follow immediately For an e mail scroller this and the other Err signals are always define...

Page 96: ...by the server in two ways 1 Used in conjunction with the ErrNumber and ErrTrigger signals the latter following immediately 2 Used alone for informational messages Sometimes these messages represent e...

Page 97: ...after the ErrNumber and ErrString to indicate that an error condition has occurred For an e mail scroller this and the other Err signals are always defined For a standard scroller they are optionally...

Page 98: ...by Attendance signal rather than Start signal The seat may pulse its Yes No and Abstain signals at will while the floor is opened The most recently pulsed signal is considered definitive at the moment...

Page 99: ...ed Reply Done pulse Comments This signal is an automatic way for the control system to suspend debate This function can also be provided to the Operator as a touchpanel button However note that the Op...

Page 100: ...ents Loads all the queues in the queue set There must be a save file table for each queue Each of these tables has the same structure as the queue scroller s bound table The names of these table for a...

Page 101: ...al 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 or by yielding or being forced to yield its rem...

Page 102: ...or resent in response to receipt of a SendNames signal Screennames may also be sent when either type of signal block is enabled if so configured The strings sent will be from the Screenname field of r...

Page 103: ...as been set An invalid agenda item description consists of A null string a string consisting entirely of space characters a string whose last non space character is a colon a string whose last non spa...

Page 104: ...will while the floor is opened The most recently pulsed signal is considered definitive at the moment the floor is closed However if the seat pulses its Excuse signal further pulses of any of these si...

Page 105: ...ened the way TCP IP connections are Assuming a reliable connection has been established a secondary reason to ping the Server using either communications mode is to test the communications protocol an...

Page 106: ...taken from the description field of the queue scroller s query i e a record in the Queries table The mark is printed as one of four 4 character strings shown below along with their meanings followed...

Page 107: ...ure ErrString Comments Recording the vote makes the vote official after issuing this signal the vote can no longer be cancelled This signal is only valid after a vote when the floor is closed while St...

Page 108: ...s per the configuration of the signal block See Request to Speak Console signal blocks Summary of Seat functions page 16 Current State FB Mark Next State FB Mark Not yet in queue O Placed into queue P...

Page 109: ...herNet propagation delays people often will hit the button again This is not a good thing since the request button is multi functional Therefore if you experience such delays we recommend debouncing e...

Page 110: ...queue set into save file f Direction control system to Voting Computer Type Digital Value Pulse Expected Reply Success Done pulse Failure The Err_TABLE_NOT_FOUND error condition is raised Comments Sa...

Page 111: ...le Description Promote a seat to the chair Direction control system to Voting Computer Type Value Expected Reply Comments Accept voting signals from the Chair position as if coming from the selected s...

Page 112: ...e DOC 5822 SendNames Request to Speak Console Voting Console Description Request names be sent Direction control system to Voting Computer Type Digital Value Pulse Expected Reply All Names serial sign...

Page 113: ...is option is independent of the option of the same name under the Control System Interface tab Secret Ballot During a vote seat icons displayed in the Vote Proctor window turn grey as they vote Actual...

Page 114: ...Crestron e control Vote SW VOTE 114 Appendices Installation Reference Guide DOC 5822...

Page 115: ...ed at all Auto name vote The server generates a name for the vote based on the current date and time in the form yymmdd_hhmmss Applies only to an otherwise unnamed vote and only when the vote is start...

Page 116: ...Crestron e control Vote SW VOTE 116 Appendices Installation Reference Guide DOC 5822 VOTE DISPLAYED Press DISPLAY again to redisplay SAVE RESULTS or ABORT VOTE See Also Attendance End Abort...

Page 117: ...tally obscured by some other window user interaction with the Vote Proctor window on the Voting Computer Abort button only enabled during and after a vote or control system issues the Display signal a...

Page 118: ...trol system issues the End signal when the floor is opened End vote feedback goes dark when User interaction with the Vote Proctor window on the Voting Computer Display Results or Print Save Results b...

Page 119: ...uter finishes recording the vote The de assert is always followed by the following in the order given All state signals are de asserted NewVote pulse All digital tally signals are de asserted and anal...

Page 120: ...Proctor window on the Voting Computer or when control system issues the Start signal after a valid agenda item has been set if required by configuration A de assert is sent when the signal block is f...

Page 121: ...to ABSENT or PRESENT as determined by last attendance seat s status changes during a vote in response to its Yes No and Abstain signals or seat s status changes after a vote in response to Operator e...

Page 122: ...s to qualify for 2 3 majority De assert Motion currently has insufficient votes to qualify for 2 3 majority Expected Reply None Comments The definition of 2 3 majority is based on the signal block s c...

Page 123: ...oting Computer to control system Type Analog Value 0 to s where s number of seats defined in signal block configuration Expected Reply None Comments Updated on any change to any seat at any time Reset...

Page 124: ...ent votes to carry De assert Motion currently has insufficient votes to carrry Expected Reply None Comments The definition of carries is based on the signal block s configuration See The Rules Tab pag...

Page 125: ...ting Computer to control system Type Analog Value 0 to s where s number of seats defined in signal block configuration Expected Reply None Comments Updated on any change to any seat at any time Reset...

Page 126: ...ing Computer to control system Type Analog Value 0 to s where s number of seats defined in signal block configuration Expected Reply None Comments Updated on any change to any seat at any time Reset t...

Page 127: ...o meet quorum requirements De assert Motion currently has insufficient votes to meet quorum requirements Expected Reply None Comments The definition of voting quorum is based on the signal block s con...

Page 128: ...in signal block configuration Expected Reply None Comments The total number of votes includes the sum of all YES votes all NO votes all abstentions Excluded from this sum are all absentees non voters...

Page 129: ...ting Computer to control system Type Analog Value 0 to s where s number of seats defined in signal block configuration Expected Reply None Comments Updated on any change to any seat at any time Reset...

Page 130: ...t will while the floor is opened The most recently pulsed signal is considered definitive at the moment the floor is closed However if the seat pulses its Excuse signal further pulses of any of these...

Page 131: ...to the Operator as a touchpanel button to give him the ability to force a speaker to yield However note that the Operator already has this ability when needed most The current speaker is automatically...

Page 132: ...controlling Request to Speak Console signal block If the controlling signal block if any too does not define its Err____ signals the error is sent instead through the COM Settings signal block to whi...

Page 133: ...TED_FUNCTION Unimplemented function 32017 Err_MAIL_NOT_SENT Mail not sent 32018 Err_NEW_MAIL New mail received at time 32019 Err_NO_NEW_MAIL Mail last checked at time 32020 Err_POP3 Mail server error...

Page 134: ...must not exceed 255 characters Another limitation is that the current generation of touchpanels do not correctly handle strings sent to indirect text fields when such strings exceed 80 characters Sign...

Page 135: ...available through the DBM Scroller logic module Fully functional Enable and Enabled signals Maximum of 8 rows x 2 columns Any number of rows columns in displayed list Picked agenda item description i...

Search results

Summary of Contents for e-control Vote

Reviews:

Related manuals for e-control Vote

Brands by name

Popular brands

Crestron e-control Vote, User Manual

Search results

Summary of Contents for e-control Vote

Reviews:

Related manuals for e-control Vote

Brands by name

Popular brands