SIMULATION PRODUCTS
GALAXY WARP™
R9040320
SERIAL COMMUNICATIONS BASIC USER’S MANUAL
31032004 R5976614/00
Barco nv Simulation Products
600 Bellbrook Ave, Xenia OH 45385
Phone: +1 (937) 372 7579
Fax: +1 (937) 372 8645
E-mail: eis@barco.com
Visit us at the web: www.eis.barco.com
Barco nv Simulation Products
laan 5, B-8520 Kuurne
Noord
Phone: +32 56.36.82.11
Fax: +32 56.36.84.86
info@barco.com
E-mail:
Visit us at the web: www.barco.com
Printed in Belgium
Copyright ©
All rights reserved. No part of this document may be copied, reproduced or translated. It shall not otherwise be recorded, transmitted or
stored in a retrieval system without the prior written consent of Barco.
Changes
Barco provides this manual ’as is’ without warranty of any kind, either expressed or implied, including but not limited to the implied warranties or merchantability and fitness for a particular purpose. Barco may make improvements and/or changes to the product(s) and/or the
program(s) described in this publication at any time without notice.
This publication could contain technical inaccuracies or typographical errors. Changes are periodically made to the information in this
publication; these changes are incorporated in new editions of this publication.
Trademarks
Brand and product names mentioned in this manual may be trademarks, registered trademarks or copyrights of their respecti
All brand and product names mentioned in this manual serve as comments or examples and are not to be understood as advertising for
the products or their manufactures.
ve holders.
Table of contents
TABLE OF CONTENTS
1. Serial Communications Basics...................................................................................... 3
1.1 SerialCommunicationsProtocol...................................................................................................... 4
1.2 Data Words............................................................................................................................ 6
1.3 Communication Settings .............................................................................................................. 7
1.4 Serial Communications Hardware .................................................................................................... 8
1.5 Serial Communications Syntax ...................................................................................................... 10
2. RS232 Commands ..................................................................................................13
2.1 Dynacolor™, Read...................................................................................................................14
2.2 Dynacolor™, Write ................................................................................................................... 16
2.3 Dynacolor™, Off...................................................................................................................... 18
2.4 Dynacolor™, On...................................................................................................................... 19
2.5 Dynacolor™, Status.................................................................................................................. 20
2.6 Dynacolor™, Execute Linked........................................................................................................ 21
Index ......................................................................................................................23
R5976614 GALAXY WARP™ 31032004 1
Table of contents
2 R5976614 GALAXY WARP™ 31032004
1. SERIAL COMMUNICATIONS BASICS
Overview
• Serial Communications Protocol
• Data Words
• Communication Settings
• Serial Communications Hardware
• Serial Communications Syntax
1. Serial Communications Basics
R5976614 GALAXY WARP™ 31032004
3
1. Serial Communications Basics
1.1 Serial Communications Protocol
Communication Protocol Summary
Like every communication method the serial communication uses a particular protocol (ANSI) which must be respected in order to
allow communication to take place, following table gives a summary of the predefined communication terms.
Start byte \xfe
Projector address
Command byte(s)
Data bytes
Checksum byte
Stop byte \xff
Start Byte
The “Start byte” informs the projector (in case of transmission) or the computer (in case of reception) that a new data transfer will
take place
1
ANSI
American National Standards Institute
Projector Address
The “projector address” defines the address of the computer the projector wants to talk to (in case of transmission) or the address
of the projector that answers (in case of
The maximum number of projectors th
reception).
at can be addressed by one computer is 256.
Command Byte(s)
There is at least one command byte to define the action to be performed. Commands that are not often used or complex commands
can take more than one byte. All command bytes that are sent by the computer to get information out of the projector are repeated
in the answer-data-transf
er of the projector.
Data Bytes (Optional)
Whether the command bytes are followed by one or more data bytes depends on the contents of the command bytes.
Data which contains more than one byte is called a word and can also be signed or unsigned.
Some commands do not require a data field(s).
Checksum Byte
The “Checksum byte” is used to detect errors during transmission or reception
Checksum byte = (projectoraddress + command bytes + Data bytes) Modulo \x100
Stop Byte
The “Stop byte” informs
and that the interpretation of the command and data bytes can start.
the projector (in case of transmission) or the computer (in case of reception) that the data transfer is complete
Acknowledge
If the communication link and if the sent commands can be interpreted by the projector an “ACK” command is sent back. In case the
commands cannot be interpreted a “NACK” command is sent back.
1. optional
4 R5976614 GALAXY WARP™ 31032004
Note
Any command byte, data byte or checksum byte that equals \x80, \xfe, \xff has to be converted!
1. Transmission
- instead of \x80, send \x80 followed by \x00
- instead of \xfe, send \x80 followed by \x7e
- instead of \xff, send \x80 followed by \x7f
2. Reception
- replace \x80 followed by \x00 with \x80
- replace \x80 followed by \x7e with \xfe
- replace \x80 followed by \x7f with \xff
1. Serial Communications Basics
R5976614 GALAXY WARP™ 31032004
5
1. Serial Communications Basics
1.2 Data Words
msb
The most significant byte, is the byte with the greatest weight (value).
lsb
The less significant byte, is the byte with the smallest weight (value).
Description
A word contains more than one byte, the first byte is the msb, the last byte is the lsb.
Examples of Data Words
• The projector runtime parameter is described using an unsigned double word where 2 bytes (msb ...lsb) represent the value of
the runtime in seconds.
How to calculate the value of a word ?
Lets take the example of a double word returned by the “projector runtime, read” commando.
returned data = Data[0]....Data[3]
3
value = Data[0]*256
+ Data[1]*2562+ Data[2]*256 + Data[3].
6
R5976614 GALAXY WARP™ 31032004
1.3 Communication Settings
Baud rate
Defines the speed of the data transfer. The baud rate can be set using the menu structure.
Consult the Owner’s manual of the projector on how to change the baud rate setting.
Data Bits
Eight data bits are used for each character of the data transfer.
Parity
There is no parity bit used to perform error checking.
Stop Bits
One stop bit is used to define the end of a character.
1. Serial Communications Basics
R5976614 GALAXY WARP™ 31032004 7
1. Serial Communications Basics
1.4 Serial Communications Hardware
Overview
• Female D9–pin connector labelled “RS232 IN” used to connect the projector with the computer.
Pin out of the D9 connector:
Pin Name Full Name
1
CD Carrier Detect
2 RxD Received Data
3 TxD Transmitted Data
4 DTR Data Terminal Ready
5
6
7
8
GND Signal Ground
DSR Data Set Ready
RTS Request To Send
CTS Clear To Send
9 RI Ring Indicator
• Standard serial Cable
- order number R9827560 (cable length = 15m )
- order number R9827570 (cable length = 30m )
1
CD
2
RxD
3
TxD
1
CD
2
RxD
3
TxD
D9
female
Image 1-1
connection: IB
4
DTR
5
GND
6
DSR
7
RTS
8
CTS
9
RI
M PC or compatible → projector
4
DTR
5
GND
6
DSR
7
RTS
8
CTS
9
RI
D9
male
8 R5976614 GALAXY WARP™ 31032004
1. Serial Communications Basics
1
HSKo
2
HSKi
TxD-
4
DIN
mini 8
Image 1-2
connection: MAC → projector
GND
5
RXD-
6
TXD+
7
n.c.
8
RXD+
3
4
DTR
8
CTS
3
TxD
5
GND
2
RxD
D9
male
Signal Levels
Following table gives the signal levels corresponding to the different states:
State
Off = 1
On = 0
Voltage
-9V
+9V
R5976614 GALAXY WARP™ 31032004 9
1. Serial Communications Basics
1.5 Serial Communications Syntax
Characters
In this manual, all characters are expressed using the C-Language syntax:
decimal values ddd
hexadecimal values \xhh
2
3
Negative Values/Numbers
The 2s complement number system is used to express negative numbers
Pascal-language string
A Pascal-language string consists of one or more characters. The first character of the string contains the length of the string.
Therefore, a Pascal-language string is limited to 255 characters.
Pascal string ’Hello world”
length
’h’
’e’
’l’
’l’
’o’
”
’w’
’o’
\x0b
\x68
\x65
\x6c
\x6c
\x6f
\x20
\x77
\x6f
’r’
’l’
’d’
\x72
\x6c
\x64
C-language string
A C-language string consists of one or more characters. The last character of the string is always the NULL character \x00.Therefore, the length of a C-language string is determined by the position of the NULL character...
C string ’Hello world”
’h’
’e’
’l’
’l’
’o’
”
’w’
’o’
’r’
’l’
\x68
\x65
\x6c
\x6c
\x6f
\x20
\x77
\x6f
\x72
\x6c
2. ddd=0...255
3. hh=00...ff
10 R5976614 GALAXY WARP™ 31032004
1. Serial Communications Basics
’d’
NULL
Standard File
Predefined file stored in read-only memory
Custom File
File created by the user and stored in non-volatile read write memory
\x64
\x00
Filename
A filename is specified as a C-Language string. This string has to follow some rules:
x x x x x x x x . y z z
1. Length string = 12
2. x = character of the base name formed by max 8 characters
3. y = kind of file (= 1 character)
’s’
’c’
4. z = file index (= 2 characters: 0..9)
zz specifies the location in memory where the file is stored.
- for standard files: zz = 00...maximum standard files
- for custom files: zz = 00...63 where 00 is reserved for the file ’none .c00’ (file which is loaded when no signal is applied)
5. yzz is a unique combination. In other words, no two files can exist with the same extension yzz.
standard file
custom file
NULL
To specify more than one file you can use the question mark (?) and (*) wildcard character for x, y and z (or any other
character).
?: This wildcard character can represent any possible character on a particular location.
* : This wildcard character can represent any possible character(s) following the wildcard’s position in the string.
•”ntsc .c01”
•”svga_60v.s?7”
•”????????.???”
• ”sv*.*”
R5976614 GALAXY WARP™ 31032004
11
1. Serial Communications Basics
12 R5976614 GALAXY WARP™ 31032004
2. RS232 COMMANDS
Overview
• Dynacolor™, Read
• Dynacolor™, Write
• Dynacolor™, Off
• Dynacolor™, On
• Dynacolor™, Status
• Dynacolor™, Execute Linked
2. RS232 Commands
R5976614 GALAXY WARP™ 31032004
13
2. RS232 Commands
2.1 Dynacolor™, Read
General Information
DynaColor™ will eliminate channel-to-channel color variations. How to define color? The CIE chromaticity diagram is one way to
plot the colors the human eye can see. A projector can only reproduce a certain color gamut within this diagram. This color gamut
is defined by the triangle formed by the x, y coordinates of Red Green and Blue. These parameters are used by the DynaColor™
adjustment in the BarcoReality SIM 4. Due to the tolerance on optical components the x, y values of this color gamut of each
projector will differ. When working with a multichannel setup, these color differences between different projectors can be smooth
out by matching the color gamuts of the different projectors to a Common Color Gamut.
Description
Read the Dynacolor™ values of the projector.
Following values are available:
• Measured Points: x, y coordinates + Y (Luminance)
• Desired Points: x, y coordinates
Command
Command [0]
Command [1]
Command [2]
\xfe
\x15
\x08
Retrun Data
Data [0]
Data [1]
Data [2]
Data [3]
Data [4] Measured Red Y msb Value
Data [5] Measured Red Y lsb Value
Data [6]
Data [7]
Data [8]
Data [9]
Data [10]
Data [11]
Measured Red x msb Coordinate
Measured Red x lsb Coordinate
Measured Red y msb Coordinate
Measured Red y lsb Coordinate
Measured Green x msb Coordinate
Measured Green x lsb Coordinate
Measured Green y msb Coordinate
Measured Green y lsb Coordinate
Measured Green Y msb Value
Measured Green Y lsb Value
Data [12]
Data [13]
Data [14]
Data [15]
Data [16] Measured Blue Y msb Value
Data [17] Measured Blue Y lsb Value
Data [18]
Data [19]
Data [20]
Data [21]
Data [22] Measured White Y msb Value
14 R5976614 GALAXY WARP™ 31032004
Measured Blue x msb Coordinate
Measured Blue x lsb Coordinate
Measured Blue y msb Coordinate
Measured Blue y lsb Coordinate
Measured White x msb Coordinate
Measured White x lsb Coordinate
Measured White y msb Coordinate
Measured White y lsb Coordinate
Data [23] Measured White Y lsb Value
2. RS232 Commands
Data [24]
Data [25]
Data [26]
Data [27]
Data [28]
Data [29]
Data [30]
Data [31]
Data [32]
Data [33]
Data [34]
Data [35]
Data [36]
Data [37]
Data [38]
Data [39]
Desired Red x msb Coordinate
Desired Red x lsb Coordinate
Desired Red y msb Coordinate
Desired Red y lsb Coordinate
Desired Green x msb Coordinate
Desired Green x lsb Coordinate
Desired Green y msb Coordinate
Desired Green y lsb Coordinate
Desired Blue x msb Coordinate
Desired Blue x lsb Coordinate
Desired Blue y msb Coordinate
Desired Blue y lsb Coordinate
Desired White x msb Coordinate
Desired White x lsb Coordinate
Desired White y msb Coordinate
Desired White y lsb Coordinate
Real Coordinate Value = (msb x 256 + lsb) / 1000
Real Y Value = (msb x 256 + lsb) / 1000
R5976614 GALAXY WARP™ 31032004 15
2. RS232 Commands
2.2 Dynacolor™, Write
Description
Send the Dynacolor™ values to the projector.
Command
Command [0]
Command [1]
Command [2]
\xfe
\x15
\x06
Data
Data [0]
Data [1]
Data [2]
Data [3]
Data [4] Measured Red Y msb Value
Data [5] Measured Red Y lsb Value
Data [6]
Data [7]
Data [8]
Data [9]
Data [10]
Data [11]
Measured Red x msb Coordinate
Measured Red x lsb Coordinate
Measured Red y msb Coordinate
Measured Red y lsb Coordinate
Measured Green x msb Coordinate
Measured Green x lsb Coordinate
Measured Green y msb Coordinate
Measured Green y lsb Coordinate
Measured Green Y msb Value
Measured Green Y lsb Value
Data [12]
Data [13]
Data [14]
Data [15]
Data [16] Measured Blue Y msb Value
Data [17] Measured Blue Y lsb Value
Data [18]
Data [19]
Data [20]
Data [21]
Data [22] Measured White Y msb Value
Data [23] Measured White Y lsb Value
Data [24]
Data [25]
Data [26]
Data [27]
Measured Blue x msb Coordinate
Measured Blue x lsb Coordinate
Measured Blue y msb Coordinate
Measured Blue y lsb Coordinate
Measured White x msb Coordinate
Measured White x lsb Coordinate
Measured White y msb Coordinate
Measured White y lsb Coordinate
Desired Red x msb Coordinate
Desired Red x lsb Coordinate
Desired Red y msb Coordinate
Desired Red y lsb Coordinate
Data [28]
16 R5976614 GALAXY WARP™ 31032004
Desired Green x msb Coordinate
2. RS232 Commands
Data [29]
Data [30]
Data [31]
Data [32]
Data [33]
Data [34]
Data [35]
Data [36]
Data [37]
Data [38]
Data [39]
Desired Green x lsb Coordinate
Desired Green y msb Coordinate
Desired Green y lsb Coordinate
Desired Blue x msb Coordinate
Desired Blue x lsb Coordinate
Desired Blue y msb Coordinate
Desired Blue y lsb Coordinate
Desired White x msb Coordinate
Desired White x lsb Coordinate
Desired White y msb Coordinate
Desired White y lsb Coordinate
Real Coordinate Value = (msb x 256 + lsb) / 1000
Real Y Value = (msb x 256 + lsb) / 1000
R5976614 GALAXY WARP™ 31032004 17
2. RS232 Commands
2.3 Dynacolor™, Off
Description
Disable the Dynacolor™ adjustment.
Command
Command [0]
Command [1]
Command [2]
\xfd
\x15
\x0A
18 R5976614 GALAXY WARP™ 31032004
2.4 Dynacolor™, On
Description
Enable the Dynacolor™ adjustment.
Command
2. RS232 Commands
Command [0]
Command [1]
Command [2]
\xfd
\x15
\x09
R5976614 GALAXY WARP™ 31032004 19
2. RS232 Commands
2.5 Dynacolor™, Status
Description
Read the current status of the Dynacolor™ adjustment.
Command
Command [0]
Command [1]
Command [2]
Return Data
Data [0]
\xfd
\x15
\x10
Current Dynacolor™ Status:
• \x00 = Dynacolor™ is not active
• \x01 = Dynacolor™ is active
20 R5976614 GALAXY WARP™ 31032004
2. RS232 Commands
2.6 Dynacolor™, Execute Linked
Description
This will execute the Linked Dynacolor™ command, all projectors in the linked setup will be set to their Common Color Gamut.
Command
Command [0]
Command [1]
Command [2]
\xfd
\x15
\x0F
R5976614 GALAXY WARP™ 31032004 21
2. RS232 Commands
22 R5976614 GALAXY WARP™ 31032004
INDEX
Index
C
Communication Settings 7
D
Data 6
Words 6
Dynacolor™ 14, 16, 18–21
Execute Linked 21
Off 18
On 19
Read 14
Status 20
Write Default 16
R
RS232 Commands 13
S
Serial Communications 3–4, 8, 10
Basics 3
Hardware 8
Protocol 4
Syntax 10
R5976614 GALAXY WARP™ 31032004
23
Index
24 R5976614 GALAXY WARP™ 31032004
Revision Sheet
To:
Barco nv Simulation Products
Noordlaan 5, B-8520 Kuurne
Phone: +32 56.36.82.11, Fax: +32 56.36.84.86
E-mail: info@barco.com, Web: www.barco.com
From:
Date:
Please correct the following points in this documentation (R5976614/00):
page
wrong
correct
R5976614 GALAXY WARP™ 31032004
Loading...