JNIOR Series 3 A Network I/O Resource Utilizing the JAVA Platform Cinema.JNIOR Application Manual Release 2.20 NOTE: For JNIOR 310 – OS 3.5.422.1046 or greater required For JNIOR 312 – OS 4.0.324.1407 or greater required INTEG Process Group, Inc. 2919 East Hardies Rd, First Floor Gibsonia, PA 15044 PH (724) 933-9350 FAX (724) 443-3553 www.integpg.com JNIORsales@integpg.com © 2012 INTEG Process Group, Inc.
INTEG Process Group, Inc. TABLE OF CONTENTS 1 2 3 Overview ..................................................................................................................... 3 JNIOR Hardware ........................................................................................................ 5 Installation Considerations and Tools......................................................................... 6 3.1 I/O Control via Ethernet – Macro Functionality Not Required ........................... 6 3.
INTEG Process Group, Inc. 1 Overview Cinema.JNIOR is a software program that runs on the INTEG JNIOR to provide central control functionality for a theater implementing a digital cinema system. The application provides the JNIOR with the ability to communicate with a digital “Cinema Server”, an auxiliary “Client” (such as a preshow system), “Projectors” and other “Devices” via the Ethernet and/or serial ports.
INTEG Process Group, Inc. Cinema Server Client A Cinema Server Client is typically a digital cinema server. The Cinema Server Client has the ability to trigger macros on the JNIOR by sending the ‘run’ command and can also control individual relay outputs using simple ASCII commands. The Cinema Server Client can be connected via a serial port or the Ethernet. Cinema.JNIOR works with all the digital cinema servers including those from Doremi, GDC, Dolby and Qube. JNIOR A Network I/O Resource Cinema.
INTEG Process Group, Inc. 2 JNIOR Hardware The JNIOR contains a mix of digital inputs and relay outputs. The JNIOR Model 310 has 8 inputs and 8 outputs and the JNIOR Model 312 has 4 inputs and 12 outputs. An optional expansion box providing an additional 4 Relay Outputs is available. Up to two expansion boxes can be added per JNIOR 310 and one per JNIOR 312 via the Sensor Port. All 8 digital inputs and 16 relay outputs can be used with the Cinema.JNIOR macro functionality.
INTEG Process Group, Inc. 3 Installation Considerations and Tools The user must load the Cinema.JNIOR application and configure it for their digital cinema installation. These items can be done using the JNIOR Support Tool and the JNIOR Web page. The JNIOR Support Tool is briefly described in this manual. Please refer to the JNIOR Support Tool Manual for detailed instructions on its use. At a high level, there are 2 connections made to Cinema.
INTEG Process Group, Inc. 3.3 Outputs and Device Control – Macro Functionality Required If you are using the JNIOR in a cinema application and you want to run macros on the JNIOR to control relay outputs and external devices, then you must enable and configure the Cinema.JNIOR application.
INTEG Process Group, Inc. 3.5 Using the JNIOR Support Tool The JNIOR Support Tool is shown in the screen shot below. Please refer to the JNIOR Support Tool Manual for additional details on how to use the tool. The support tool has seven main functions: 1) Beacon Tab – identifies JNIORs on the Ethernet network for ease of configuration. 2) Devices Tab – allows the user to define the IP addresses and/or serial settings for devices to be controlled via the JNIOR macros and transfer the file to the JNIOR.
INTEG Process Group, Inc. 6) Logs Tab – allows the user to aggregate, view, filter and print the various logs being created on the JNIOR. 7) Snapshot Tab – allows the user to download (back-up) any or all of the files on a JNIOR. 3.6 Using the JNIOR Web Page After a proper IP address has been set for the JNIOR, you will be able to interact with the JNIOR via the Ethernet network. You can use the main JNIOR web page and/or a Telnet connection.
INTEG Process Group, Inc. Main JNIOR Model 310 Web Page – Internal I/O 4 Relay Output Expansion Module – External I/O JNIOR A Network I/O Resource Cinema.
INTEG Process Group, Inc. 3.7 Cinema.JNIOR Configuration Overview Cinema.JNIOR has a variety of items that must be set-up by the user. These items can be broken down into the following main categories: 1) Devices – this is a list of any device that will be utilized by the macros. This is an optional feature. The list must be set-up and transferred to the JNIOR using the JNIOR Support Tool. The user will ‘link’ to this file during the Macro configuration.
INTEG Process Group, Inc. 4 Devices Set-up The Cinema.JNIOR Application can communicate with a variety of devices over the Ethernet and/or via the serial ports on the JNIOR. The Devices file provides the JNIOR with important set-up information about the device being connected to. The Preshow Client, Cinema Server Client and digital cinema server are not configured or entered into the Devices file.
INTEG Process Group, Inc. 5 Macros Set-up The Cinema.JNIOR application has the ability to run macros stored on the JNIOR. The macros can control the JNIOR outputs and interact with connected devices. The following describes the functionality of the JNIOR macros and provides a brief description of how they are configured. The macros must be built using the JNIOR Support Tool. Please consult the JNIOR Support Tool manual for further details. 5.
INTEG Process Group, Inc. Action View Window The Action View window by default lists all the typical actions involving the digital inputs and the digital outputs. The Action View window contains the following information: Name – User configurable field to describe the action or output Device – A macro can utilize any of the JNIOR inputs or outputs, the JNIOR Control Panel or connect to an external device.
INTEG Process Group, Inc. Action – User selectable action to take when this Action is executed. There are a variety of types of actions based upon the device to be controlled: JNIOR I/O Outputs – Open, Close, Toggle and Pulse (pulse duration is 1 second by default) Inputs – “Soft Pulse” – the JNIOR creates the input ‘high’ (or ‘on’) message without any electrical signal wired to the input.
INTEG Process Group, Inc. Macro View Window The Macro View window displays the macros being created and is used to adjust the timing of each action. Macro Name – User configurable name for the macro that will be used to refer to the macro by triggers, the Client and Cinema Server. NOTE: The macros are also assigned a number starting at 1 based upon their order in the macro file. The number can also be used to identify the macro to run.
INTEG Process Group, Inc. Macro File Overview Window The Macro File Overview window displays the complete list of all the actions defined in the Action View window, all the macros configured, and the timing for each action in each macro. The Macro File Overview window provides the user with an easy way to view their macro file configuration. Scroll bars are provided for viewing all the information. Fields are provided to enter a Revision identifier, Date and Comment, if desired.
INTEG Process Group, Inc. 5.2 Macro Triggers The JNIOR macros can be trigged a variety of ways. 1) A predefined message (Appendix C) can be sent by the Client (i.e. preshow system) that will trigger a user configurable macro name (see the Configuration Parameters section for the default settings and how to adjust). The predefined macro name must correspond to a macro name in the macro file.
INTEG Process Group, Inc. 6 Devices and Macro File Loading and Testing After you have created your Devices file and Macro file, you will need to upload them to your JNIOR and test them. 6.1 Loading Files on the JNIOR The files must be loaded on the JNIOR using the JNIOR Support Tool so that only one copy of each file is on the JNIOR and the files are placed in the proper location. The JNIOR Support Tool will check for existing files and delete them before the new file is transferred. NEW for Cinema.
INTEG Process Group, Inc. Below is the dialogue while Cinema.JNIOR is ingesting the Macro file. The prompt will be provided when the Macro file has been completely loaded and is available for use. The dialogue is similar for a Devices file. 6.2 Macro Testing The Macros on your JNIOR can be tested using any normal triggers you plan to use, but they can also be tested using the Macro Execution function built into the JNIOR Support Tool.
INTEG Process Group, Inc. The Macro Name Sender box will display. Type the macro name (or number) that you want to execute. Your JNIOR’s IP address should already be filled-in. NOTE: The HEX String displayed is the complete string that can be used with a RAW Ethernet connection over port 9200 on the JNIOR. This connection uses the JNIOR Protocol. Click on the Connect button and after the Macro Name Sender has made a connection to your JNIOR, the Send button will be bolded.
INTEG Process Group, Inc. 7 Cinema.JNIOR Configuration Parameters The Cinema.JNIOR Application has a variety of configuration parameters that make the software very flexible. The following screen picture shows the area within the JNIOR Registry where the Cinema.JNIOR keys are located. They are all under AppData and in the Cinema folder. This section lists each registry entry, the complete key name, the default value and the acceptable values.
INTEG Process Group, Inc. 7.1 Devices and Macro Files Configuration The following configuration items affect the operation of the Devices and Macro functions. The Registry Keys are located in the Cinema – MACROS folder. Case Sensitivity (Key No Longer Available – Value is always TRUE) Whenever Cinema.JNIOR sends a string defined in a macro file, the default is for the JNIOR to send this string as all lower case text, regardless of how the user has entered the string.
INTEG Process Group, Inc. 7.2 Client Configuration Cinema.JNIOR can accept one connection from a Client and this connection can be over the serial port or the Ethernet port. The default is a serial connection via the AUX Serial Port. The Method key is used to enable or disable serial communications, while the serial port to be use is defined in the Serial Port Configuration keys (described next). The Ethernet connection is enabled by entering a valid port number in the TcpPort key.
INTEG Process Group, Inc. SendAck true false, true SendCounts false false, true SendDateStamp true false, true SerialCommandsEnabled false false, true TcpPort -1 Any valid port number UnsolicitedIoAlerts false false, true Vendor 0 0 = NCM 1 = Other (no responses sent to Client) JNIOR A Network I/O Resource Cinema.
INTEG Process Group, Inc. CLIENT – Serial Port Configuration The Client connection to one of the JNIOR serial ports has the following settings: Registry Key Default Valid Values Baud 19200 300, 600, 1200, 2400, 4800, 9600, 38400, 57600, 115200 DataBits 8 7, 8 FlowControl 0 0 = None 1 = CTS/RTS(hardware) 2 = XON/XOFF (software) PacketSize 1024 1 to 1024 bytes Parity 0 Even (2), Odd (1), None (0) SerialPort AUX AUX, RS232 StopBits 1 1, 2 AppData/Cinema/Serial/….
INTEG Process Group, Inc. CLIENT – Timers Configuration When the Client connection is enabled via a serial or Ethernet (TCP/IP) connection, the following messages will be sent to the Client indicating the status of the preshow, movie and fire alarm. NOTE: If the # of times is set to 0, then the message will be sent continuously at the interval configured until that status has changed. NOTE: These messages can be disabled by changing the Registry Key for each to -1.
INTEG Process Group, Inc. 7.3 Cinema Server Client Configuration Cinema.JNIOR can accept one or more connections from a Cinema Server Client and this connection can be over the serial port and/or the Ethernet port. The default is to have both the serial and Ethernet connections disabled. The Serial connection is enabled via the Method key, while the serial port to be use is defined in the Serial Port Configuration keys (described next).
INTEG Process Group, Inc. CINEMA SERVER CLIENT – Serial Port Configuration The Client connection to one of the JNIOR serial ports has the following settings: Registry Key Default Valid Values AppData/Cinema/CinemaServerClient/Serial/….
INTEG Process Group, Inc. JNIOR A Network I/O Resource Cinema.
INTEG Process Group, Inc. 7.4 JNIOR Digital Input Triggers The JNIOR digital inputs can be configured to trigger a macro to execute whenever a digital input transitions from low to high.
INTEG Process Group, Inc. 7.5 JNIOR Control Panel Switches The JNIOR Control Panel Switches can be configured to trigger a macro to execute whenever the switch is pressed.
INTEG Process Group, Inc. 7.6 Preshow Client Operations The JNIOR can implement preshow operations based on the commands (see Appendix C) received from the Preshow Client. Preshow Lamp Output This is the output that the Client will use to control the Lamp on the preshow projector, if a separate projector is used. The default configuration is to have a common Preshow and Feature projector and so this key is default to -1 (not used).
INTEG Process Group, Inc. Five Minute Preshow Timer Enabled This is a failsafe timer. When the Client issues a mid_preshow message, the five minute timer will be started (if enabled). If the end_preshow message is not received from the Client before the expiration of the timer, then the Feature Start Input is soft pulsed and an exception message is sent to the Client.
INTEG Process Group, Inc. Movie Status Output This is the output that the Client can use to determine the status of the movie. The default is to have this feature disabled. Registry Key Default Valid Values AppData/Cinema/IO/MovieStatusOutput -1 -1 or Any Output Number 1 - 16 PreShow Lock Output This output is high when the movie is playing to lock-out the Client commands. The output is typically turned on by the digital Cinema Server.
INTEG Process Group, Inc. 7.7 Feature Operations After the preshow is complete as determined by the JNIOR receiving the end of preshow command from the Client, the JNIOR will soft toggle the “Feature Start Input” (if configured) so that the digital Cinema Server receives the signal to start the movie. The digital cinema server will execute its own internally stored macro that will include turning on the Preshow Lock (the Cinema Server sends a JNIOR protocol command to turn on the appropriate output).
INTEG Process Group, Inc. The above Registry keys are shown in the following screen pictures. IO Related Registry Keys – In addition to the above described keys, the Flat Masking Input and Output and the Scope Masking Input and Output keys, and the Preshow Lock Invert key are custom keys for a particular user of Cinema.JNIOR. Macro Related Registry Keys - In addition to the above described keys, several other keys have been added to increase the flexibility of the message structure.
INTEG Process Group, Inc. 7.8 ‘On Boot’ Macro to Execute This is the name of the macro that will be executed automatically by the JNIOR when the JNIOR first boots up and the Cinema.JNIOR program starts. Registry Key Default Valid Values AppData/Cinema/MACROS/OnBoot None Any Macro Name 7.9 ‘Scheduled Time’ to Execute a Macro Cinema.JNIOR can execute a macro at a specific time of day each day of the week. Three Schedule Registry Keys are created by default.
INTEG Process Group, Inc. 7.10 Logic Functions Cinema.JNIOR can utilize simple logic expressions to determine when to execute a specific macro. Three Logic Registry Keys are created by default. Additional logic keys can be added by continuing the pattern (LogicRule4, etc.) and adding these keys to the AppData – Cinema – Logic folder. Below is a picture of the default Registry Keys. Multiple operands and operators can be used in a logical statement producing a complex logical decision.
INTEG Process Group, Inc. There are 4 logic categories. 1. OnIOChange This logic expression will be checked whenever the JNIOR I/O changes. The I/O that can be monitored are the internal inputs and outputs on the JNIOR as well as any outputs on a 4 relay output expansion module. Example Registry Key Value OnIOChange, din1 and din2, run test For the above example, each time either input 1 or 2 changes, the logic rule (din1 AND din2) will be evaluated and the macro (test) will execute if both inputs are ON.
INTEG Process Group, Inc. 4. OnMacro() This logic expression will be evaluated whenever the named macro has been requested to run. This logic expression can be used as a ‘lock’ to make sure certain macros can only execute when a certain I/O state exists or cannot be executed when a certain I/O state exists. To specify the macro that is bound by this logic place its name inside the parenthesis.
INTEG Process Group, Inc. 8 Fire Alarm The Cinema.JNIOR Application can handle a variety of fire alarm issues. The following Fire Alarm features can be configured. NOTE: The following Registry keys appear in various screen shots previously included in this document. Fire Alarm Input This is the input that is assigned to the fire alarm signal. The default JNIOR settings will work with an input that is normally low (off) and goes high (on) when the fire alarm is tripped.
INTEG Process Group, Inc. Fire Alarm Macro This is the name of the macro that will be executed automatically by Cinema.JNIOR when there is a fire event. Registry Key Default Valid Values AppData/Cinema/MACROS/FireAlarmMacro Fire Alarm Any Macro Name Fire Alarm Preshow Clear Macro This is the name of the macro that will be executed automatically by Cinema.JNIOR when the Fire Alarm Release Input goes high and the PreShow Lock output is low (off).
INTEG Process Group, Inc. 9 Logs The Cinema.JNIOR Application provides several logs for recording key instructions and system changes that have occurred. These files can be viewed, filtered, saved and printed using the JNIOR Support Tool. The following logs are provided: Cinema Log (cinema.log) – records general activities about the cinema application including events surrounding the initial program loading, specific connections, exceptions, etc. I/O Log (jniorio.
INTEG Process Group, Inc. Cinema Server Log (cinemaserver.log) – records the messages going between the Cinema Server Client and JNIOR. Each message includes a time stamp (date and time). Devices Log (devices.log) – records the messages being sent by the JNIOR to the digital cinema projector and/or serial devices. Each message includes a time stamp (date and time). The JNIOR has also two standard logs for generic JNIOR operations: JNIOR Boot Log (jniorboot.
INTEG Process Group, Inc. Aggregated Logs With the JNIOR Support Tool, the user can select to retrieve all or some of the above logs and aggregate them. JNIOR A Network I/O Resource Cinema.
INTEG Process Group, Inc. 10 SNMP The JNIOR operating system 4.2 and greater contains SNMP functionality. The complete description of the SNMP functionality is defined in the JNIOR SNMP Manual. The following SNMP feature can be configured for use with the Cinema.JNIOR Application. Reboot Clear Timeout Minutes An SNMP message is sent every time the Cinema.JNIOR Application is started. Under normal operations, the program will start every time the JNIOR is rebooted.
INTEG Process Group, Inc. A APPENDIX – AUX Serial Port Connection The auxiliary serial port can communicate via RS232, RS422 or RS485. The mode is configured via jumpers internal to the JNIOR. The default communication setting is RS232 and so no action should be required. However, if you are having problems, the following information is provided. To set the communication mode, you must remove the four screws on the JNIOR and remove the lid. The jumpers are located in the upper right corner.
INTEG Process Group, Inc. B APPENDIX – Serial Control Software Commands After the Cinema.JNIOR Application is properly configured to accept the serial commands, you can interact with the JNIOR via the serial port the same as with the Serial Control Program. Please see the Configuration Parameters (Registry key settings) described in Section 6 of this manual to enable the various serial commands. NOTE: When using the serial commands via Cinema.
INTEG Process Group, Inc. ::c1234 close relay outputs 1 through 4 ::c1368 close relay outputs 1, 3, 6, 8 ::o125 open relay outputs 1, 2, 5 ::c1+1p=1000 close relay outputs 1, 9 and pulse each for 1 second simultaneously Executing Multiple Commands at the Same Time You can also send different types of commands at the same time. If you do NOT separate them with a comma (,), the Cinema.JNIOR program will execute them all at the same time.
INTEG Process Group, Inc.
INTEG Process Group, Inc. Messages from the JNIOR (non case sensitive) Format MM/DD/YY hh:mm:ss.
INTEG Process Group, Inc. D APPENDIX – Available Devices The Cinema.JNIOR program works with a variety of devices that can be controlled via macros configured using the JNIOR Support Tool. Please contact INTEG for the latest list of devices supported. The following devices were available when this manual was last updated: 1. Barco Digital Projector 2. Christie Digital Projector 3. NEC Digital Projector 4. NEC VT700 Projector 5. USL JSD-100 Ethernet 6. Dolby 650 Serial 7. Dolby 650 Ethernet 8.
INTEG Process Group, Inc. 1. Barco Digital Projector Communication Method Ethernet IP Address Customer Defined Communications Port 43680 (Barco factory default) Termination String Optional (default is none required) Commands Available (For use in a JNIOR Macro) Lamp On Lamp Off Open Dowser Close Dowser Send Macro Send NOTES: A) The Send Macro command is used to send the actual name of any macro stored on the Barco projector. When this command is used, the Barco will execute the named macro.
INTEG Process Group, Inc. 3. NEC Digital Projector Communication Method Ethernet IP Address Customer Defined Communications Port 7142 (NEC Series 1) 43728 (NEC Series 2) Termination String Optional (default is none required) Commands Available (For use in a JNIOR Macro) Lamp On Lamp Off Open Dowser Close Dowser Input Switch Send NOTE: The Send command works the same as described under Barco. The Input Switch is used in conjunction with a data value in the Data column 4.
INTEG Process Group, Inc. 5. USL JSD-100 Communication Method Ethernet IP Address Customer Defined Communications Port 10001 (USL factory default) Termination String Optional (default is none required) Commands Available (For use in a JNIOR Macro) Set Fader Adjust Fader Set Input Set Mute NOTE: The Set Fader, Adjust Fader and Set Input commands are used in conjunction with a data value in the Data column 6.
INTEG Process Group, Inc. Format Button Set Mute Send NOTE: The Fader Level, Fader Setting and Format Button commands are used in conjunction with a data value in the Data column The Send command works the same as described under Barco. 8.
INTEG Process Group, Inc. 10. Dolby 3D DFC100 Ethernet Communication Method Ethernet IP Address Customer Defined Communications Port 61412 Termination String Optional (default is none required) Commands Available (For use in a JNIOR Macro) Enable Disable Send NOTE: The Send command works the same as described under Barco. 11.
INTEG Process Group, Inc. NOTE: Certain commands are used in conjunction with a data value in the Data column. The Send command works the same as described under Barco. 13. RAW Ethernet (generic Ethernet devices) Communication Method Ethernet IP Address Customer Defined Communications Port Customer Defined Termination String Optional (default is \r\n – carriage return, line feed) Commands Available (For use in a JNIOR Macro) Send NOTE: The Send command works the same as described under Barco.
INTEG Process Group, Inc. Summary Thank you for purchasing the JNIOR. Hopefully this manual made the getting-to-know process of your new JNIOR very quick and easy. The JNIOR has many more wonderful tools and features available, and are explained in detail in the supplied documents. Copyright Copyright 2011 INTEG Process Group, Inc. All rights reserved. Notice Every effort was made to make this manual as accurate and useful as practical at the time of the writing of this manual.
