RayTek LineScanner MP150 User manual

MP150
Linescanner
Protocol Manual
Rev. B4 Aug 2019
51101

Contacts
Fluke Process Instruments
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
Americas
Everett, WA USA
Tel: [phone] (USA and Canada, only)
[phone]
[e-mail]
EMEA
Berlin, Germany
Tel: [phone]
[e-mail]
China
Beijing, China
Tel: [phone]
[e-mail]
Worldwide Service
Fluke Process Instruments offers services,
including repair and calibration. For more
information, contact your local office.
www.flukeprocessinstruments.com
© Fluke Process Instruments
Specifications subject to change without notice.

Note: By using this manual, you agree to the following:
1. Not to sell competitive commercial products.
2. Not to reverse-engineer manufacturer´s linescanner.
3. Not to duplicate this manual.
4. Any disputes will be settled in courts local to the manufacturer or its subsidiaries.
5. To forfeit this manual upon the manufacturer´s request.
6. WARRANTY: The protocol manual is provided ”AS IS” without representation or warranty
of any kind. Seller makes no warranties with respect to the protocols. Seller, specifically,
disclaims any expressed implied, written, oral or statutory warranties of design arising from
dealing, trade, usage or trade practices.
Specifications subject to change without notice.

Content
CONTENT.............................................................................................................................................................5
1 INTRODUCTION ..............................................................................................................................................7
2 COMMUNICATION INTERFACES ...............................................................................................................8
2.1 ETHERNET .....................................................................................................................................................8
2.1.1 Keep Alive Time ....................................................................................................................................8
2.1.2 BootP .....................................................................................................................................................8
3 TRANSMISSION OF COMMANDS TO THE SCANNER ...........................................................................9
3.1 COMMAND STRUCTURE ................................................................................................................................9
3.2 ANSWER ......................................................................................................................................................10
3.3 REQUESTING PARAMETERS FROM THE SCANNER ......................................................................................10
3.4 ERROR HANDLING......................................................................................................................................11
4 TRANSMISSION OF TEMPERATURE LINES ............................................................................................12
4.1 STARTING AND STOPPING THE DATA TRANSMISSION ..............................................................................12
4.1.1 The Receive Mode (RM): Burst or Snapshot (Host).............................................................................12
4.2 THE DATA MODE (DM) ...............................................................................................................................13
4.2.1 Byte Mode for Temperature (DMB)......................................................................................................13
4.2.2 Word Mode 1 for Temperature (DMW) .................................................................................................13
4.2.3 Word Mode 2 for Temperature (DMWT2) ............................................................................................13
4.3 COUNT OF PIXEL (POINT MODE,PM).........................................................................................................13
4.3.1 What to do with the Surplus Pixel (PMX) ...........................................................................................14
4.4 LINE COMPOSITION,LINEMODE (LM) .......................................................................................................14
4.4.1 A Line with Frame in Burst Mode ......................................................................................................14
4.4.2 The Lines with Frame in Snapshot Mode............................................................................................14
4.4.3 The Checksum of a Line or Snapshot...................................................................................................15
4.4.4 MP40 Line Modes...............................................................................................................................15
4.4.5 MP50 Line Modes...............................................................................................................................15
4.4.6 MP150 Line Modes .............................................................................................................................15
4.4.6.1 Line Mode 11hex...........................................................................................................................................15
4.4.6.2 Line Mode 12hex...........................................................................................................................................15
4.4.6.3 Line Mode 13hex...........................................................................................................................................16
5 DEDICATED COMMANDS ..........................................................................................................................17
5.1 START-UP PARAMETER ...............................................................................................................................17
5.2 SECTORS ......................................................................................................................................................18
5.2.1 Sector Position (SL, SR) .....................................................................................................................18
5.2.2 Sector Emissivity (SE) ........................................................................................................................19
5.2.3 Sector Calculation (SC).......................................................................................................................19
5.2.3.1 Sector Calculation “Width”.......................................................................................................................19
5.2.4 The Translation of Temperature into Current ....................................................................................20
5.2.5 How the Current / Temperature gets calculated? ...............................................................................20
5.2.6 Sector Alarms......................................................................................................................................20
5.2.7 Alarm Reset.........................................................................................................................................21
5.2.8 The Whole Alarm Story in State Diagrams ........................................................................................21
5.3 ZONES .........................................................................................................................................................22
5.3.1 The Zone Story in State Diagrams .....................................................................................................23

5.3.2 The Hold Commands in State Diagrams............................................................................................ 24
5.3.3 Examples............................................................................................................................................. 25
5.4 SECTOR AND ZONE .................................................................................................................................... 25
5.5 SETTING THE EMISSIVITY............................................................................................................................ 27
5.5.1 The Emissivity Vector (EMV).............................................................................................................. 27
5.6 SCAN FREQUENCY STEPS ........................................................................................................................... 28
5.7 AVERAGING,COMBINING OR CONDENSING LINES (AT, AV, AVX) ........................................................ 28
5.8 SWITCHING THE LASER .............................................................................................................................. 29
5.9 FIELD OF VIEW CONSIDERATIONS ............................................................................................................. 29
5.9.1 Why the Field of View Command does not send a NAK? .................................................................. 29
5.10 RESPONSE AND EXPOSURE TIME.............................................................................................................. 30
5.11 AMBIENT TEMPERATURE COMPENSATION.............................................................................................. 30
5.12 CUSTOMER ADJUSTMENT......................................................................................................................... 30
5.13 SERVICE COMMANDS ............................................................................................................................... 31
5.14 THE WINDOW TRANSMISSION................................................................................................................. 31
6 DIFFERENCES MP150 –MP50 ..................................................................................................................... 32
7 APPENDIX ....................................................................................................................................................... 33
7.1 LIST OF USER COMMANDS ......................................................................................................................... 33
7.2 TETRAGON-ZONES..................................................................................................................................... 39
7.3 IO-MODULES (WAGO)............................................................................................................................... 42
7.4 DOUBLING OF LINES .................................................................................................................................. 42

Introduction
MP150 Protocol Rev. B4 Aug 2019 7
1Introduction
For many applications, the scanner can be easily configured with the help of the factory distributed
software. In other applications, it would be more useful to integrate the scanner into a larger system or
customize it for specific measuring tasks.
The scanner is programmed via its serial and the Ethernet interface to configure it to specific
measurement applications.
This manual describes the structure of the different commands and their effect on the scanner functions.
With further development of the scanner, deviations from this manual may occur. However, it is the
manufacturer’s intent to maintain forward compatibility with newer versions.
As the scanner rarely checks commands, it is up to the programmer to provide proper command syntax.
Descriptions of the serial and the Ethernet interface are available through computer.
The command interface of the MP150 derives from (is compatible to) the MP50 –this might explain
some structures in the commands.
The structure of this description is as follows:
•It starts with the command structure (section 3),
•followed by the structure of interesting temperature data lines (section 4),
•followed by detailed information for dedicated commands (section 5),
•and ends with a list of all commands (section 7).

Communication Interfaces
8 Rev. B4 Aug 2019 MP150 Protocol
2Communication Interfaces
The MP150 scanner communicates via RS485 or the Ethernet interface. After scanner start-up, both
interfaces will be active and will remain active. Though two interfaces are available only one should be
used at a time. Using both interfaces at the same time may create undefined results!
For more information about the Ethernet and RS485 interface, see the MP150 manual
“Operating Instructions”!
2.1 Ethernet
2.1.1 Keep Alive Time
The scanner has built-in support for keepalive. The procedures involving keepalive use three user-
driven variables:
•tcp_keepalive_time: the interval between the last data packet sent (simple ACKs are not
considered data) and the first keepalive probe; after the connection is marked to need
keepalive, this counter is not used any further.
•tcp_keepalive_intvl: the interval between sub sequential keepalive probes, regardless
of what the connection has exchanged in the meantime.
•tcp_keepalive_probes: the number of unacknowledged probes to send before
considering the connection dead and notifying the application layer.
The default values are: 240 10 6; which mean after 240 seconds the scanner will send 6 probes with an
interval of 10 seconds, so after 5 minutes a broken connection will be closed.
2.1.2 BootP
Getting the IP-Address via BootP –the BootP Client
Since firmware version 3.43 a BootP client is “asking” for an IP-address if no connection was established.
The implantation is done following the RFC 951 Bootstrap Protocol.

Transmission of Scanner Commands
MP150 Protocol Rev. B4 Aug 2019 9
3Transmission of Scanner Commands
Commands serve to setup functional modes and parameters in the scanner.
3.1 Command structure
Commands are generally transmitted from the PC to the scanner, and have the following format:
SOH Operation Code [Sector] [Parameter] EOT BCC
The [Operation Code] and [Parameter] are to be find in section 7.1 and the [Sector] is described in section
5.2.
The frame (composed of SOH, EOT and BCC) may be left out, but should be used in the RS485
connection to avoid communication errors. (The predecessor MP50 did require the frame.)
If a command was sent with the frame, then the scanner will answer with the frame. The decision
with/without frame is made at the first sign (SOH or not SOH).
These ASCII control characters used in the protocol with their associated decimal and hexadecimal
values are the following:
Control character
decimal
hexadecimal
SOH
„start of heading”
01D
01H
STX
„start of text”
02D
02H
EOT
„end of transmission”
04D
04H
ACK
„acknowledge”
06D
06H
NAK
„negative acknowledge”
21D
15H
SYN
„synchronous idle”
22D
16H
EOF
„end of file”
26D
1AH
ETB
„end of transmission block”
23D
17H
ESC
„escape”
27D
1BH
During command and parameter transmission, transmission reliability is checked with a Block
Character Checksum (BCC).
The BCC is transmitted as the last byte of the command or parameter string. The BCC is a modulo 256
sum of all previously transmitted characters and bitwise OR-ed with 80H or 128D (to set the highest bit
of the BCC).
Example (send the command AR):
SOH 01H
”A” 41H
”R” 52H
+ EOT 04H
BCC = 98H
and afterwards, bitwise OR-ed with 80H yields (which, in this case, does not change the byte’s value):
BCC = 98H

Transmission of Scanner Commands
10 Rev. B4 Aug 2019 MP150 Protocol
3.2 Answer
After transmission of the BCC, the scanner will reply with either ACK, NAK or ETB. These replies have
the following meanings:
ACK - The command contains the proper syntax and is acknowledged by the scanner.
NAK - There are syntax errors in the command, or the BCC is wrong–it will not be acknowledged. The
wrong command does not cause changes in the scanner. It has to be corrected and/or repeated.
ETB - The internal diagnosis software in the scanner has spotted an error. This error must be corrected,
and thereafter, the command must be repeated as it could not be implemented due to the
scanner error.
3.3 Requesting Parameters from the Scanner
The retrieval of previously defined functions and parameters is possible using the following format:
SOH ”G” Operation Code [Sector] EOT BCC
The method of defining the operation code for retrieval of parameters is similar to the setting of the
parameters. The operation code is prefixed by a ”G” (for ‘Get’).
For sector parameter requests, the sector number must be present after the command code.
After transmitting the BCC, the scanner will reply with ACK, NAK or ETB in the same way it does when
issuing commands (see section 3.2). These replies have the same meaning as during the transmission of
commands, and NAK / ETB have the same handling requirements.
After replying ACK, the scanner will transmit the parameter(s), using the same format as the PC does
when issuing a command. However, the scanner does not require an ACK or NAK signal from the PC.
For example, if transmission of the current line count is desired, the computer requests the parameter
by issuing:
SOH ”GLC” EOT BCC
If the transmission is correct the scanner will reply:
ACK SOH ”TR1” EOT BCC
Should any error occur in the checksum, the parameter request should be repeated.