Download as pdf or txt
Download as pdf or txt
You are on page 1of 50

DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.

07

DIATRON COMMUNICATION PROTOCOLS


REVISION HISTORY

Revision Change Edited by Effective date


01 First revision (all protocols included) Csaba Magyar APR-14-2009
02 Null-Modem cabling diagram added Csaba Magyar AUG-24-2009
03 Instrument and protocol updates Csaba Magyar JUN-16-2010
04 Touch screen ABJ family added Csaba Magyar NOV-15-2010
05 USB + PC setup added Csaba Magyar JUN-23-2011
06 A5 relevant 3.1 protocol additions (p5,18) Csaba Magyar AUG-12-2011
07 -A5 - HL7 result message description Peter Balog JAN-24-2014
-A5 US - HL7 ‘delete from worklist’ message (according Gabor Bencsik
to Placer Order Number)
-A3CP extended with the touchscreen version
-A5 – Diatron Serial Protocol 3.1 upgrade (Extension for
sending images)

Date Name Signature


Issued by JAN-24-2014 Gabor Farkas
Revised JAN-24-2014 Peter Balog
Revised JAN-24-2014 Gabor Bencsik
Approved JAN-24-2014 Peter Balasko

1/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

2/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

CONTENTS

General Description of protocols ............................................................................................................................ 5

Format of Packages Sent by the analyzer ........................................................................................................... 6

Format of Acknowledge of the Receiver ............................................................................................................. 6

Detailed Description of Packages ........................................................................................................................ 7

INIT package .................................................................................................................................................... 7

DATA package ................................................................................................................................................. 7

RBC, WBC and PLT package ............................................................................................................................. 9

XML record descriptor package .................................................................................................................... 11

FULL record package ..................................................................................................................................... 12

Setting up the Communication Link ...................................................................................................................... 13

Serial Link .......................................................................................................................................................... 13

Setup of analyzers ......................................................................................................................................... 13

USB Link............................................................................................................................................................. 13

Setting up the Driver ..................................................................................................................................... 14

Setup of Analyzers ......................................................................................................................................... 14

ETHERNET.......................................................................................................................................................... 14

Setup of Analyzers ......................................................................................................................................... 14

Serial Protocol 1.0 ................................................................................................................................................. 15

Serial Protocol 1.7 ................................................................................................................................................. 17

Serial Protocol 2.20, 2.23 ...................................................................................................................................... 19

Serial Protocol 3.0 ................................................................................................................................................. 19

Serial Protocol 3.1 ................................................................................................................................................. 20

Introduction ...................................................................................................................................................... 20

Characters and basic structure.......................................................................................................................... 20

Details of the 3.1 protocol ................................................................................................................................ 21

Diatron serial protocol 3.1 extension for IMAGE sending (only in A5 and A5_US) ........................................... 23

HL7 Protocol (HL7v2.5) ......................................................................................................................................... 26

3/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

A3CP sending measurement data to the server ............................................................................................... 26

A3CP receiving work list from the server .......................................................................................................... 35

Bidirectional example of HL7 Messages ( A3CP ) .............................................................................................. 36

Abacus 5 sending measurement data to the server ......................................................................................... 40

Abacus 5 receiving work list from the server .................................................................................................... 46

Bidirectional example of HL7 Messages ( ABACUS 5 ) ...................................................................................... 47

4/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

GENERAL DESCRIPTION OF PROTOCOLS

Protocols Abacus Arcus ABJ ABJV ABJ5 ABJV5 ABP ABJB ABJ A3 A3CP A4 A5/
supported 30-60-80 A3CP (w/ touch A5
(w/ touch screen) US
screen)
1.0       
1.7      
2.20      
2.23      
3.0    
3.1            
HL7  

Software running on Diatron hematology analyzers is able to make serial connection link to a receiver device
(computer) by connecting to the serial port of the instrument (Abacus5 also supports Ethernet connection –
see relevant section). If Serial Communication Speed (in general: Utilities / Settings / Customize / General
Settings) Baud Rate setting is set to a valid value (other than “Offline”), the analyzer will try to initiate a
communication sequence.

The analyzer initiates serial communication, the receiver must respond to this request.

The hardware protocol is: 8 data bit, 1 stop bit, no parity. If the other side is not responding within 1 second,
the analyzer will repeat the transmission twice, but if still no response, the other side will be supposed to be
not ready to receive data, and thus the analyzer will not try to communicate any more.

From this state it can wake up by receiving an <ENQ> (ASCII code 5) character from the other side, and The
analyzer will immediately respond with an <ACK> (ASCII code 6). From this point The analyzer will send data if it
is ready for transmission.

The communication is based on packages. There are 7 package types:

- INIT package: Device identification, software version, current date and time.

- DATA package: Sample and patient information, measured parameters, and markers.

- RBC package: Sample information, RBC histogram.

- WBC package: Sample information, WBC histogram.

- PLT package: Sample information, PLT histogram.

- XML file with FULL record structure information

- FULL record transmission

The communication sequence is always started with an INIT package. If the link is successful, The analyzer will
send DATA package, and the receiver can request RBC, WBC and PLT packages at acknowledge.

If serial communication protocol is set to version 3.0 then the analyzer will send XML and FULL packages.

5/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

Special characters used in the communication:

Character ASCII code


<SOH> 1
<STX> 2
<ETX> 3
<EOT> 4
<ENQ> 5
<ACK> 6
<HT> 9
<LF> 10
<NAK> 21
<SPACE> 32

FORMAT OF PACKAGES SENT BY THE ANALYZER

The packages sent by the analyzer are always between a <SOH> and <EOT> character, and they consist of
header, data and tail. The header consists of a package identifier and a package type descriptor. The tail
includes the checksum. Typical format:

<SOH>MID CMD<STX>MESSAGE<ETX>CHKSUM<EOT>

MID: Message ID, one capital letter between ’ A’ and ’ Z’

CMD: Command, one capital letter – package type descriptor

 ’I’ for INIT;

 ’D’ for DATA;

 ’R’ for RBC;

 ’W’ for WBC;

 ’P’ for PLT.

 ‘X’ for XML descriptor

 ‘F’ for full record transmission

MESSAGE: the message consists of ASCII characters (between 32..128) CHKSUM: two hexadecimal digits of a
one-byte checksum which contains the lower byte of the sum of characters between the <SOH> and <ETX>
(incl. those, too).

FORMAT OF ACKNOWLEDGE OF THE RECEIVER

The receiver must acknowledge transmission by the following message:

<ACK>CMD MID

CMD: the type of the next package to send – this makes possible to a request for histograms. If no more
packages are required, <SPACE> should be sent.

6/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

MID: the identifier of the package that acknowledged by this message.

If receiving of the message was not successful, <NAK> should be sent, and the analyzer will repeat the last
package.

The receiver has approx. 1 second to reply. Otherwise the analyzer will repeat the last transmission, twice
automatically. But if still no response after 3 trials, the analyzer will not start to communicate any more, even if
there is data to send (see General Description).

NOTE: Protocol 3.1 when used on Abacus5, expects an acknowledgement


message. Please use the “ACK” message (composed of the following ASCII codes:
65; 67; 75). Without this acknowledge message, communication from Abacus 5
will stop, sample transmission is NOT repeated.

DETAILED DESCRIPTION OF PACKAGES

The packages sent by the analyzer are placed between a header and a tail. There are 5 main types of them:
INIT, DATA and histogram packages, XML descriptor, and FULL record. The histogram package can be: RBC,
WBC, and PLT. Format is the same, only the type descriptor differs.

INIT PACKAGE

The analyzer sends the general identifiers by this package during initiation of a communication:

DEVICE<HT>VERSION<HT>DATE<HT>TIME

DEVICE: device identifier: „analyzer model name”

VERSION: version of the software, e.g. „x.y”

DATE: date in YYYYMMDD format

TIME: time in HHMMSS format

DATA PACKAGE

This package contains sample and patient data, the measured parameters and the markers of histograms. One
data element consists of two items: name and value, which are separated by a <HT> character, and closed by
<LF>:

SNO<HT>152<LF> internal identifier

DATE<HT>19980715<LF> date of measurement (YYYYMMDD)

TIME<HT>114500<LF> time of measurement (HHMMSS)

PID<HT>2<LF> patient identifier (0..9999)

NAME<HT>JOE SMITH<LF> patient name (max. 32 characters)

MODE<HT>0<LF> patient type

7/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

1
WRN<HT>0<LF> warning bits (32-bit hexadecimal)
2
PM1<HT>12<LF> PLT lower marker
2
PM2<HT>204<LF> PLT upper marker
2
RM1<HT>51<LF> RBC lower marker
2
WM1<HT>23<LF> WBC upper marker
2
WM2<HT>57<LF> WBC LYM-MID marker
2
WM3<HT>92<LF> WBC MID-GRA marker

PARN<HT>22<LF> number of parameters to send


3 4
P01<HT> 6.6<HT>0<LF> first parameter ID , value and flag

P02<HT>4.29<HT>0<LF> second parameter ID, value and flag

...

P22<HT> 8.2<HT>0<LF> last parameter ID, value and flag

Remarks:
1
Position and meaning of the warning flags:

Bit Mask Letter Meaning


0 0x00001 c, q RBC/PLT clogging.
3 0x00008 m RBC/PLT Coincidence is too high. Linearity error.
6 0x00040 b RBC Blank is high, or no RBC blank.
7 0x00080 p PLT blank is high, or no PLT blank.
8 0x00100 C, Q WBC clogging.
11 0x00800 M, N WBC coincidence is too high. Linearity error.
14 0x04000 B WBC Blank is high, or no WBC blank.
15 0x08000 H HGB Blank is high, or no HGB blank.
16 0x1000 E No WBC three part.

The detailed description can be found in the relevant analyzer’s User’ s Manual

To connect the analyzer to a PC, use a so-called Null-Modem cable. Such cables are available commercially in
any computer shop. Below are 2 connection schemes of the Null-Modem cable:

8/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

OR
2
The markers are given in histogram channel between 0 and 255, where 0 means that the marker could not be
found.
3 9 12
The parameter IDs in The analyzer are: P01: WBC (10 /l); P02: RBC (10 /l); P03: HGB (g/l); P04: HCT (%);
9
P05: MCV (fl); P06: MCH (pg); P07: MCHC (g/l); P08: PLT (10 /l); P09: PCT (%); P10: MPV (fl); P11: PDWsd (fl);
9 9 9
P12: PDWcv (%); P13: RDWsd (fl); P14: RDWcv (%); P15: LYM (10 /l); P16: MID (10 /l); P17: GRA (10 /l); P18:
LYM% (%); P19: MID% (%); P20: GRA% (%); P21: RBCtime (sec); P22: WBCtime (sec).
4
The parameter value is always 4 characters wide, spaces from left added if necessary. It can be 9999, if the
value could not be displayed in 4 digits, or ---- if the value could not be calculated because of an error.

The meaning of the parameter flags:

Flag Displayed Meaning


0 Value correct.
1 + Value high(more than upper limit)
2 - Value low(less than lower limit)
3 * Value is unreliable.
4 E Value not given because of error. Value is----.
5 Value cannot be calculated. There is no value!

RBC, WBC AND PLT PACKAGE

The format of the histogram packages are the same, they differ in type descriptor only. The package contains
the sample data (to identify the package) and the histogram.

SNO<HT>152<LF> internal identifier

DATE<HT>19980715<LF> date of measurement (YYYYMMDD)

TIME<HT>114500<LF> time of measurement (HHMMSS)

PID<HT>2<LF> patient identifier (0..9999)

CHN<HT>256<LF> number of histogram channels (256)

9<HT> value of first histogram channel

...

9/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

th
1<HT> value of 255 histogram channel

0 value of the last histogram channel

10/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

XML RECORD DESCRIPTO R PACKAGE

Each time a communication is initialized, The analyzer will send an XML file in ASCII mode. A receiver
application should be aware of this, by saving this XML file for later use.

This package contains the description of the FULL record format. FULL record format means transmission of a
record stored in The analyzer as is, in binary format. Data sent in an ‘F’ package should be interpreted
according to the description in the XML file below. Would an ‘F’ package arrive without an ‘X’ package received
earlier, receiver application can ask for the XML descriptor by sending a request for an ‘X’ package. (See WBC,
RBC, PLT histogram package request.

XML FILE SENT BY THE ANALYZER:


<DB_Struct_DAT>
<Header>
<Field name="Head" type="char" length="9"/>
<Field name="Modified" type="DateTime" length="1"/>
<Field name="Length" type="DWORD" length="1"/>
<Field name="Order" type="BYTE" length="1"/>
<Field name="Dummy1" type="BYTE" length="1"/>
<Field name="Dummy2" type="WORD" length="1"/>
<Field name="Capacity" type="WORD" length="1"/>
<Field name="RecLen" type="WORD" length="1"/>
<Field name="Dummy3" type="BYTE" length="7"/>
</Header>
<Record>
<Field name="RecNo" type="WORD" length="1" path="Measures/Measure" alias="RecNo"/>
<Field name="TimeStamp" type="DateTime" length="1" path="Measures/Measure" alias="Date"/>
<Field name="OperatorID" type="WORD" length="1" path="Measures/Measure" alias="OpID"/>
<Field name="SampleID" type="char" length="8" path="Measures/Measure" alias="SID"/>
<Field name="PatientID" type="char" length="20" path="Patient" alias="PID"/>
<Field name="Name" type="char" length="32" path="Patient" alias="Name"/>
<Field name="BirthDate" type="DateTime" length="1" path="Patient" alias="Birth"/>
<Field name="Sex" type="BYTE" length="1" path="Patient" alias="Sex" extID="Sex"/>
<Field name="Doctor" type="char" length="16" path="Measures/Measure" alias="Doctor"/>
<Field name="LimitsLow" type="float" length="23" path="Measures/Measure" alias="field_LimitLow" incr="1"/>
<Field name="LimitsHigh" type="float" length="23" path="Measures/Measure" alias="field_LimitHigh" incr="1"/>
<Field name="PatTypeName" type="char" length="20" path="Measures/Measure" alias="PatTypeName"/>
<Field name="VetMode" type="WORD" length="1" path="Measures/Measure" alias="field_VET" source="PatTypeName"/>
<Field name="HistoRBC" type="BYTE" length="256" path="Measures/Measure/field_RBCH" alias="D" extID="Histo"/>
<Field name="HistoPLT" type="BYTE" length="256" path="Measures/Measure/field_PLTH" alias="D" extID="Histo"/>
<Field name="HistoWBC" type="BYTE" length="256" path="Measures/Measure/field_WBCH" alias="D" extID="Histo"/>
<Field name="PLTlo" type="BYTE" length="1" path="Measures/Measure/field_PLTH" alias="PM1"/>
<Field name="PLThi" type="BYTE" length="1" path="Measures/Measure/field_PLTH" alias="PM2"/>
<Field name="RBClo" type="BYTE" length="1" path="Measures/Measure/field_RBCH" alias="RM1"/>
<Field name="WBClo" type="BYTE" length="1" path="Measures/Measure/field_WBCH" alias="WM1"/>
<Field name="LYMhi" type="BYTE" length="1" path="Measures/Measure/field_WBCH" alias="WM2"/>
<Field name="GRAlo" type="BYTE" length="1" path="Measures/Measure/field_WBCH" alias="WM3"/>
<Field name="Param" type="float" length="23" path="Measures/Measure" alias="field_P" incr="1" extID="Param"/>
<Field name="Flag" type="BYTE" length="23" path="Measures/Measure" alias="field_P" alias2="_f" incr="1" extID="Flag"/>
<Field name="Warning" type="DWORD" length="1" path="Measures/Measure" alias="field_WRN"/>
<Field name="Lyse" type="float" length="1" path="Measures/Measure" alias="field_LYSE"/>
<Field name="Lyse_2" type="float" length="1" path="Measures/Measure" alias="field_LYSE2"/>
<Field name="Options" type="WORD" length="1" path="Measures/Measure" alias="field_OPT" extID="Options"/>
<Field name="PrVMinW" type="WORD" length="1" path="Measures/Measure" alias="PrVMinW"/>
<Field name="PrVMaxW" type="WORD" length="1" path="Measures/Measure" alias="PrVMaxW"/>
<Field name="PrVMinR" type="WORD" length="1" path="Measures/Measure" alias="PrVMinR"/>
<Field name="PrVMaxR" type="WORD" length="1" path="Measures/Measure" alias="PrVMaxR"/>
<Field name="PrVMinW2" type="WORD" length="1" path="Measures/Measure" alias="PrVMinW2"/>
<Field name="PrVMaxW2" type="WORD" length="1" path="Measures/Measure" alias="PrVMaxW2"/>
<Field name="Age" type="BYTE" length="1" path="Measures/Measure" alias="field_AGE"/>
<Field name="ClogReport" type="char" length="29" path="Measures/Measure" alias="ClogReport"/>
</Record>
<Misc>
<Field path="Measures/Measure" alias="Type" value="Haematology"/>
<Field path="Measures/Measure" alias="field_PLTH" value=""/>
<Field path="Measures/Measure/field_PLTH" alias="CHN" value="256"/>
<Field path="Measures/Measure" alias="field_RBCH" value=""/>
<Field path="Measures/Measure/field_RBCH" alias="CHN" value="256"/>
<Field path="Measures/Measure" alias="field_WBCH" value=""/>
<Field path="Measures/Measure/field_WBCH" alias="CHN" value="256"/>
<Field path=".." alias="Version" value="2.22"/>
<Field path="Measures/Measure" alias="Version" value="2.22"/>
<Field path="Measures/Measure" alias="MeasureMode" value="3"/>
</Misc>
<MaxParams value="23"/>
<DB_VERSION value="2.22"/>
</DB_Struct_DAT>

11/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

EXPLANATION OF A FIELD:
< Starting tag of field descriptor
Field name="RecNo" Name of field (can be used as reference in PC application)
type="WORD" Type descriptor of field
length="1" How many bytes should be used for storing (length)
… Technical tags
/> Closing of field tag

<Field name="LimitsLow" type="float" length="23" path="Measures/Measure" alias="field_LimitLow"


incr="1"/>

This field is an array, contains 23 entries, as indicated. Interpretation of these entries is not listed in the XML file.
You will find them below:

#define PAR_WBC 0
#define PAR_RBC 1
#define PAR_HGB 2
#define PAR_HCT 3
#define PAR_MCV 4
#define PAR_MCH 5
#define PAR_MCHC 6
#define PAR_PLT 7
#define PAR_PCT 8
#define PAR_MPV 9
#define PAR_PDWsd 10
#define PAR_PDWcv 11
#define PAR_PDW 11
#define PAR_RDWsd 12
#define PAR_RDWcv 13
#define PAR_RDW 13
#define PAR_LYM 14
#define PAR_MID 15
#define PAR_GRA 16
#define PAR_LYMp 17
#define PAR_MIDp 18
#define PAR_GRAp 19
#define PAR_RBCt 20
#define PAR_WBCt 21
#define PAR_WBCt2 22

Use the above identifiers to interpret entries in the array.

Param and flag interpretation should happen accordingly.

FULL RECORD PACKAGE

This package starts with the ‘F’ package identifier, and contains a record in binary format. Interpretation of the
binary information should happen using field definitions of the XML file received in an ‘X’ package.

12/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

SETTING UP THE COMMU NICATION LINK

Analyzers by default do not have communication enabled. You have to enable this function through the user
interface of the analyzer. See the table below for availability of ports per analyzer

PORTS Abacus Arcus ABJ ABJV ABJ5 ABJV5 ABP ABJB ABJ30-60-80 A3 A4 A5
supported (touch screen) A3CP
RS232           
USB (B) * * *       
ETHERNET 

*= availability depends on hardware configuration of the analyzer

SERIAL LINK

Serial communication requires a NULL-MODEM cable between analyzer COM1 and an available serial port on
the PC. Each analyzer having a serial port offers a D-SUB9 female connector. The serial port of the PC can either
be a legacy port, or a port provided through an e.g. Serial-USB converter.

If you are using a Serial-USB converter, make sure to identify and setup the converter to allow proper reception
and processing of data. See USB/DRIVER section for explanation.

SETUP OF ANALYZERS

Analyzers by default do not have communication enabled. You have to enable it by selecting communication
port (Serial), communication speed (Baud) and protocol used. Upon selecting and confirming these parameters,
analyzers will be ready to start communication.

Protocols that require handshake will start “introducing” themselves to the host PC by sending INIT packages.
The host must reply to the INIT package. Each INIT package is sent once, and analyzer software is allowing 3
seconds for the host PC to reply. Upon the third unsuccessful attempt analyzer software will disable sending
messages.

The host PC can wake up the analyzer by sending ENQ package. Analyzer will reply with an INIT package and
will expect a reply as described in the protocol.

Protocols (3.1) that do not require handshake will also send the INIT package but do not expect a reply.

USB LINK

Before connecting the analyzer to a PC with USB cable, a specific driver must be installed. The driver is available
from Diatron’s web site or from http://www.ftdichip.com/Drivers/VCP.htm. Select the driver matching your
operating system. Download and install. Now you can connect the analyzer.

USB connection utilizes a standard USB A-B cable (not included with analyzers). The cable must be connected
to a free USB A socket on the PC and the USB B socket on the analyzer.

Upon connection, the pre-installed driver will recognize the analyzer’s built-in USB device as a Virtual Serial
Port.

13/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

SETTING UP THE DRIVER

(Windows)

When the computer has recognized the analyzer, it will enroll the (virtual) serial port as one of the COM ports
of the PC. Some applications require the serial port to be identified as a specific COM port. Please go to
Hardware setup, and check the COM port ID. Modify if necessary. (Refer to Windows HW configuration
procedures [My Computer, Properties, Hardware, Device Manager])

SETUP OF ANALYZERS

When using the USB port for communication, analyzer setup means selecting USB as communication port, and
choosing the required communication protocol. Communication speed is always set in Windows application /
hardware setup.

Protocols that require handshake will start “introducing” themselves to the host PC by sending INIT packages.
The host must reply to the INIT package. Each INIT package is sent once, and analyzer software is allowing 3
seconds for the host PC to reply. Upon the third unsuccessful attempt analyzer software will disable sending
messages.

The host PC can wake up the analyzer by sending ENQ package. Analyzer will reply with an INIT package and
will expect a reply as described in the protocol.

Protocols (3.1) that do not require handshake will also send the INIT package but do not expect a reply.

ETHERNET

Ethernet based communication is only available on Abacus 5.

SETUP OF ANALYZERS

Follow User Manual instructions of Abacus 5 to assign IP address and communication parameters to connect
A5 to the HL7 server computer.

14/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

SERIAL PROTOCOL 1.0

Requires HANDSHAKE.

Abacus Arcus ABJ ABJV ABJ5 ABJV5 ABP ABJB ABJ30-60-80 A3(CP) A4 A5
Applies to       

Receiver sends that it is ready to receive now.

<ENQ>

The analyzer sends acknowledge.

<ACK>

The analyzer sends INIT to initiate link (there is data to send):

<SOH>AI<STX>analyzer model name<HT>1.3<HT>20011005<HT>125027<ETX>30<EOT>

Receiver sends acknowledge:

<ACK><SPACE>A

The analyzer sends DATA package:

<SOH>BD<STX>SNO<HT>152<LF>DATE<HT>19980715<LF>TIME<HT>114500<LF>

PID<HT>2<LF>NAME<HT>JOE SMITH<LF>MODE<HT>0<LF>WRN<HT>0<LF>

PM1<HT>12<LF>PM2<HT>204<LF>RM1<HT>51<LF>WM1<HT>23<LF>WM2<HT>57<LF>

WM3<HT>92<LF>PARN<HT>22<LF>P01<HT> 6.6<HT>0<LF>P02<HT>4.29<HT>0<LF>

P03<HT> 167<HT>0<LF> ... P21<HT> 8.2<HT>0<LF>P22<HT> 5.3<HT>0<LF>

<ETX>7C<EOT>

Receiver acknowledges DATA transmission, and requests for RBC package:

<ACK>RB

The analyzer sends RBC package:

<SOH>CR<STX>SNO<HT>152<LF>DATE<HT>19980715<LF>TIME<HT>114500<LF>

PID<HT>2<LF>CHN<HT>256<LF>9<HT>16<HT>26<HT> ... 1<HT>0<ETX>F2<EOT>

Receiver acknowledges RBC transmission, and requests for WBC package:

<ACK>WC

15/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

The analyzer sends WBC package:

<SOH>DW<STX>SNO<HT>152<LF>DATE<HT>19980715<LF>TIME<HT>114500<LF>

PID<HT>2<LF>CHN<HT>256<LF>0<HT>15<HT>84<HT> ... 5<HT>3<ETX>69<EOT>

Receiver acknowledges WBC transmission, and closes the link.

<ACK><SPACE>D

It is possible to request for PLT histogram, but it is not shown in this example.

16/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

SERIAL PROTOCOL 1.7

Requires HANDSHAKE.

Abacus Arcus ABJ ABJV ABJ5 ABJV5 ABP ABJB ABJ30-60-80 A3(CP) A4 A5
APPLIES      
TO

Receiver sends that it is ready to receive now.

<ENQ>

The analyzer sends acknowledge.

<ACK>

The analyzer sends INIT next time to initiate link (there is data to send):

<SOH>AI<STX>analyzer model name <HT>2.22<HT>20011005<HT>135212<ETX>30<EOT>

Receiver sends acknowledge:

<ACK><SPACE>A

The analyzer sends DATA package:

<SOH>BD<STX>SNO<HT>152<LF>DATE<HT>19980715<LF>TIME<HT>114500<LF>

SID<HT>2<LF>PID<HT>26<LF>NAME<HT>JOE SMITH<LF>MODE<HT>0<LF>WRN<HT>0<LF>

PM1<HT>12<LF>PM2<HT>204<LF>RM1<HT>51<LF>WM1<HT>23<LF>WM2<HT>57<LF>

WM3<HT>92<LF>PARN<HT>22<LF>P01<HT> 6.6<HT>0<LF>P02<HT>4.29<HT>0<LF>

P03<HT> 167<HT>0<LF> ... P21<HT> 8.2<HT>0<LF>P22<HT> 5.3<HT>0<LF>

<ETX>7C<EOT>

Receiver acknowledges DATA transmission, and requests for RBC package:

<ACK>RB

The analyzer sends RBC package:

<SOH>CR<STX>SNO<HT>152<LF>DATE<HT>19980715<LF>TIME<HT>114500<LF>

SID<HT>2<LF>PID<HT>26<LF>CHN<HT>256<LF>9<HT>16<HT>26<HT> ...

1<HT>0<ETX>F2<EOT>

Receiver acknowledges RBC transmission, and requests for WBC package:

<ACK>WC

17/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

The analyzer sends WBC package:

<SOH>DW<STX>SNO<HT>152<LF>DATE<HT>19980715<LF>TIME<HT>114500<LF>

SID<HT>2<LF>PID<HT>26<LF>CHN<HT>256<LF>0<HT>15<HT>84<HT> ...

5<HT>3<ETX>69<EOT>

Receiver acknowledges WBC transmission, and closes the link.

<ACK><SPACE>D

It is possible to request for PLT histogram, but it is not shown in this example.

18/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

SERIAL PROTOCOL 2.20, 2.23

Requires HANDSHAKE.

Abacus Arcus ABJ ABJV ABJ5 ABJV5 ABP ABJB ABJ30-60-80 A3(CP) A4 A5
APPLIES      
TO

This version utilizes upgraded header information:

<SOH>BD<STX>SNO<HT>152<LF>DATE<HT>19980715<LF>TIME<HT>114500<LF>

SID<HT>2<LF>PID<HT>26<LF>NAME<HT>JOE SMITH<LF>MODE<HT>0<LF>WRN<HT>0<LF>

PM1<HT>12<LF>PM2<HT>204<LF>RM1<HT>51<LF>WM1<HT>23<LF>WM2<HT>57<LF>

WM3<HT>92<LF>PARN<HT>22<LF>P01<HT> 6.6<HT>0<LF>P02<HT>4.29<HT>0<LF>

P03<HT> 167<HT>0<LF> ... P21<HT> 8.2<HT>0<LF>P22<HT> 5.3<HT>0<LF>


AGE<HT>24<LF><ETX>7C<EOT>

A parameter called AGE is included in the header info. This represents the age of the given patient (if selected
in service menu, and defined at sample info screen).

The interpretation of this value is:

If the age value is greater than 128, then it represents months in the following way:

MONTHS = AGE – 128 (months). If it is less than 128, then it represents years.

This (AGE) parameter has been removed in version 2.23

SERIAL PROTOCOL 3.0

Requires HANDSHAKE.

Abacus Arcus ABJ ABJV ABJ5 ABJV5 ABP ABJB ABJ30-60-80 A3(CP) A4 A5
APPLIES    
TO

This version utilizes a new approach to record transmitting:

It sends the INIT package, where instrument and PC should establish the communication.

After connection is established, The analyzer will send an ‘X’ package with the XML file to give a description to
the binary data sent in the ‘F’ (FULL) package.

From then on, ‘F’ packages are sent, and receiver software must interpret the binary data using the descriptors
in the XML file.

19/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

SERIAL PROTOCOL 3.1

Requires minimal HANDSHAKE.

Abacus Arcus ABJ ABJV ABJ5 ABJV5 ABP ABJB ABJ30-60-80 A3(CP) A4 A5
APPLIES           
TO

INTRODUCTION

The new 3.1 protocol was introduced to simplify the receiving, parsing and storing of ABJV5 data records. The
byte stream is a human readable ASCII character stream, with occasional control characters. Most
programming environments are able to handle this stream as a simple ASCII string or text. The stream is line-
oriented with special characters to separate fields. The protocol has a single format for transmitting a single
measurement record. If more records are sent, they are simply chained together one after the other.

CHARACTERS AND BASIC STRUCTURE

The byte stream uses the ASCII characters in the range 1..255 ( http://en.wikipedia.org/Ascii ), or 0x01..0xFF in
hexadecimal.

A record transmission consists of three parts: a small header, a big text body, and a small footer. A single
record is never longer than 8192 bytes.

A transmission always starts with the control character „Start of Header” (<SOH>, 1, 0x01).

The second character is a counter: it will contain a single uppercase English letter in the range „A” to „Z”,
incrementing with every record. The first record will contain „A”, the second will contain „B”, etc. If the
instrument sends many records without being turned off, the counter will overflow from „Z” to „A”.

The third character is an identifier: if the instrument is an ABJV5, it will be an uppercase „A”, and in case of the
ABJV it will be an uppercase „N”.

The fourth character is the control character „Start of Text” (<STX>, 2, 0x02).

The fifth and consecutive characters form the body of the transmission. The body may contain characters from
the printable range (32..126, 0x20..0xFF), and the control characters „Horizontal tab” (<HT> or <TAB>, 9, 0x09),
„Carriage return” (<CR>,13, 0x0D), and „Line feed” (<LF>, 10, 0x0A). The body contains several lines separated
by a two-byte sequence <CR><LF>. See below for the detailed description of the contents.

The body of the transmission is closed by the control character „End of Text” (<ETX>, 3, 0x03).

The footer consists of a two-character checksum in a two-digit hexadecimal form. The checksum is calculated
by summing up the values of all characters in the message header and body, including the beginning <SOT>
character and the last <ETX> character, adding 255 (hex: 0xFF) to it, and keeping only the last two
hexadecimal(!) digits.

The last character of a record is always the single control character „End of Transmission” (<EOT>, 4, 0x04).
There is no terminating „NULL” (<NUL>, 0, 0x00) character at the end. The next record can start right after the
<EOT> character.

20/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

NOTE: Protocol 3.1 when used on Abacus5, expects an acknowledgement


message. Please use the “ACK” message (composed of the following ASCII codes:
65; 67; 75). Without this acknowledge message, communication from Abacus 5
will STOP, sample transmission is NOT repeated 3 times as it is with other
analyzers and protocols.

DETAILS OF THE 3.1 PROTOCOL

The body of a transmission is line-oriented, separated by the two-byte „Carriage Return” „Line
Feed” (<CR> <LF>, 13 10, 0x0D 0x0A) sequence. A single line might contain one or more fields, separated by the
„Horizontal tab” (<HT>, 9, 0x09) character.

The following lines are usually composed of an identifier field and one or more value fields, all separated by the
<HT> character. The characters in bold appear in the transmission exactly as written, without any variance
between records. Control characters are marked with the < and > characters, for example <HT>. {Comments}
are marked with { and }, and are not included in the actual transmission. For a more detailed discussion on the
meanings of the various parameters and histograms, please refer to the instruments’ user manuals.

header1 {header1 to header8 are the lab header lines}


header2 {these lines are defined by the user in the instrument
settings}
header3 {any or all of these lines can be empty}
header4
header5
header6
header7
header8
Serial No.:<HT>serial {serial is the 6 digit serial number of the instrument}
RecNo:<HT>recno {recno is the internal record number, at most 6 digits}
Sample ID:<HT>sampleid {sampleid is at most 8 characters long}
Patient ID:<HT>patientid {patientid is at most 20 characters long}
Patient Name:<HT>patientname {patinetname is at most 32 characters long}
Mode:<HT>mode {mode is the species name like „Dog”, max 20 characters}
Doctor:<HT>doctor {doctor is at most 16characters long}
Age:<HT>value<HT>unit {value is a number of at most 3 digits, unit is either „years”
or „months”}
Birth(ymd):<HT>birthdate {birthdate is an 8 digit number, format: yyyymmdd}
Sex:<HT>gender {gender is „Male”, „Female”, „Neutered”, „Spayed” or a
single „-” character}
Test date(ymd):<HT>date {date is an 8 digit number, format: yyyymmdd}
Test time(hm):<HT>time {time is a 6 digit number, format: hhmmss}
Param<HT>Flags<HT>Value<HT>Unit<HT>[min-max] {this is a header line, always the same}
param<HT>flag<HT>value<HT>unit<HT>[min-max] { there are 24 similar lines
param is the parameter name, at most four characters long, possible values are (in sequence): WBC,
RBC, HGB, HCT, MCV, MCH, MCHC, PLT, PCT, MPV, PDWs, PDWc, RDWs, RDWc, LYM, MON, NEU, LY%, MO%,
NE%, EOS, EO%, BAS, BA%
flag is a single character indicator, can be „ ” (space), „+”, „-”, „E” and „*”(asterisk)
value is the measured parameter value, exactly 4 characters: number with a possible decimal dot,
padded with spaces on the left side, or 4 minus signs „----”, or 4 spaces „ ”
unit is at most 4 characters long, possible values are „10^9/l”, „10^3/ul”, „10^12/l”, „10^6/ul”, „fl”,
„%”, „g/l”, „g/dl”, „mmol/l”, „pg”, „fmol”, depending on the parameter

21/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

min and max are the lower and upper bounds of the normal range, exactly 4 characters, including a
possible decimal dot, padded with spaces on the left side}
Flags:<HT>flags {flags is a series of characters indicating errors, at most 32
characters long, upper or lowercase letters „a” to „z”}
WBC graph {always the same, indicates the beginning of the WBC
histogram}
Scale(fl):<HT>wbcscale {wbcscale is maximum 3 digit number, indicating the fl
value of the last channel, value is usually 400}
Channels:<HT>wbcchannels { wbcchannels is the number of channels (columns) in the
histogram, always 256 }
WMarker1:<HT>wm1 {wm1 is the first WBC discriminator channel (RBC/WBC) }
WMarker2:<HT>wm2 {wm2 is the second WBC discriminator channel
(LYM/MON) }
WMarker3:<HT>wm3 {wm3 is the third WBC discriminator channel (MON/NEU) }
Points:<HT>ch0<HT> ………<HT>ch255 {chxx is the histogram height at a given channel (range
0..255), there are always wbcchannels values here (usually 256) }
RBC graph {always the same, indicates the beginning of the RBC
histogram}
Scale(fl):<HT>rbcscale {rbcscale is maximum 3 digit number, indicating the fl
value of the last channel, value is usually 200}
Channels:<HT>rbcchannels { rbcchannels is the number of channels (columns) in the
histogram, always 256}
RMarker1:<HT>rm1 {rm1 is the RBC discriminator channel (PLT/RBC) }
Points:<HT>ch0<HT> ………<HT>ch255 {chxx is the histogram height at a given channel (range
0..255), there are always rbcchannels values here (usually 256) }
EOS graph {always the same, indicates the beginning of the EOS
histogram}
Scale(fl):<HT>eosscale {eosscale is maximum 3 digit number, indicating the fl
value of the last channel, value is usually 400}
Channels:<HT>eoschannels {eoschannels is the number of channels (columns) in the
histogram, always 256}
EMarker1:<HT>em1 {em1 is the EOS discriminator channel (WBC/EOS) }
Points:<HT>ch0<HT> ………<HT>ch255 {chxx is the histogram height at a given channel (range
0..255), there are always eoschannels values here (usually 256) }
PLT graph {always the same, indicates the beginning of the PLT
histogram}
Scale(fl):<HT>pltscale {pltscale is maximum 3 digit number, indicating the fl value
of the last channel, value is usually 50}
Channels:<HT>pltchannels {pltchannels is the number of channels (columns) in the
histogram, always 256}
PMarker1:<HT>pm1 {pm1 is the first PLT discriminator channel (PLT start) }
PMarker2:<HT>pm2 {pm2 is the second PLT discriminator channel (PLT/RBC) }
Points:<HT>ch0<HT>ch1<HT>………<HT>ch255 {chxx is the histogram height at a given channel (range
0..255), there are always pltchannels values here (usually 256) }

As mentioned above, after the last channel value in the PLT histogram the body of the record is closed with the
control character „End of Text” (<ETX>, 3, 0x03).

22/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

DIATRON SERIAL PROTOCOL 3.1 EXTENSION FOR IMAGE SENDING (ONLY IN A5 AND A5_US)

The Diatron Serial Protocol 3.1 has been extended for image sending. The protocol is capable to send histogram
and scattergram images. Only Abacus5 and Abacus5_US software utilize this new feature of the protocol; the
following example demonstrate the four image data:

DiffImage
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

23/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

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
JRU5ErkJggg==

BasoImage
iVBORw0KGgoAAAANSUhEUgAAAQAAAAEACAYAAABccqhmAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgA
AgIQAA......QGMKABo7VAD/+I9w+FNOJVoRwN8gydCYAoDGFAC09e+//wGlW2IS0WRbdAAAAABJRU5ErkJggg==

RBCImage
iVBORw0KGgoAAAANSUh…./y+xuW/62tzotAMt9tCIA6e9b/plZhX377b+aJgCPvfssywD89t/e/D9m9m0///obn/T8
0JZtg+oAAAAASUVORK5CYII=

24/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

PLTImage
iVBORw0KGgoAAAANSU……AwAYBgAgDBBACCCQAEEwAIJgAQTAAgmABAMAGAYAIAwQQAggkABBMACCYAEE
wAIJgAQDABgGACAMEEAIIJAAQTAAgmABBMACCYAEAwAYBgAgDBBACCCQAEGyoAP97e7gPa6D4Af4

A png based image data starts whit a keyword (DiffImage, BasoImage, RBCImage, PLTImage) then following a
TAB character and finishes whit a newline character. The Diff observation is complete, Baso, Rbc and Plt
segments are not complete in this example due excess space requirements.

The data are derived from png file by Base64 encoding. Pictures can be retrieved via Base64 decoding.

25/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

HL7 PROTOCOL (HL7V2.5)

Requires specific HL7 server.

Abacus Arcus ABJ ABJV ABJ5 ABJV5 ABP ABJB ABJ A3 A3CP A A5/
30-60- (CP) (w/ 4 A5
80 touch US
screen)
APPLIES  
TO

Abacus 5 and A3CP(w/ touch) is able to send measurement results to and receive so-called work lists from a
remote computer. To activate and use this feature, the instrument needs to be connected to a HL7 capable
server directly or through a computer network.

A3CP SENDING MEASUREMENT DATA TO THE SERVER

Setup

Go to Settings / Communication/ Peer


Communication

The following data has to be provided for the EMR


server:

- EMR enabled

- EMR remote IP address of the HL7 server

- EMR remote port of the HL7 server

For sending data to PC:

- PC enabled

- PC remote IP address of the server

- PC remote port of the server

Upon setting and accepting the above


configuration, Abacus 3 CP is ready to send
measurement results to the server.

26/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

Usage

Sending data takes place at the end of each


measurement automatically, if the Settings /
Measurement / Settings / Automatic Send is
Enabled.

Available choices for the Automatic Send:

 Disabled

 PC only

 EMR(LIS) only

 PC and EMR(LIS)

 USB-Serial

The sending can also be initiated by the user


through the database by clicking the Manage
records / Send / PC or EMR button.

The following is an example of a HL7 message v. 2.5 of Abacus 3CP:

27/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

Message

MSH|$~\&|A3CPC||||20130816154927||ORU_R01|SAMPLE001|P|2.5.1||||||UNICODE UTF-8|||

PID|||PATIENT_ID001||Thomas A.||19621119000000|F

NTE|1||Dr. Smith

NTE|2||32

SPM|1|||WB|||||||P

SAC|||SAMPLE001

OBR||AWOS_ID001

OBX|1|TX|WBC||14.80|10^9/l|5.00-10.00|H

OBX|2|TX|LYM||2.35|10^9/l|1.30-4.00|N

OBX|3|TX|MID||1.09|10^9/l|0.15-0.70|H

OBX|4|TX|GRA||11.36|10^9/l|2.50-7.50|H

OBX|5|TX|LYM%||15.9|%|25.0-40.0|L

OBX|6|TX|MID%||7.4|%|3.0-7.0|H

OBX|7|TX|GRA%||76.7|%|50.0-75.0|H

OBX|8|TX|RBC||6.56|10^12/l|4.00-5.50|H

OBX|9|TX|Hb||18.7|g/dl|12.0-17.4|H

OBX|10|TX|HCT||61.67|%|36.00-52.00|H

OBX|11|TX|MCV||94|fl|76-96|N

OBX|12|TX|MCH||28.5|pg|27.0-32.0|N

OBX|13|TX|MCHC||30.3|g/dl|30.0-35.0|N

OBX|14|TX|RDW||16.1|%|0.0-0.0|N

OBX|15|TX|RDWs||63.3|fl|20.0-42.0|H

OBX|16|TX|PLT||458|10^9/l|150-400|H

OBX|17|TX|MPV||9.5|fl|8.0-15.0|N

OBX|18|TX|WBC SCALE||400|fl

OBX|19|TX|WMarker1||19

OBX|20|TX|WMarker2||66

OBX|21|TX|WMarker3||114

28/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

OBX|22|TX|WBC
HISTO||000000000000000000000082796E6153473C332D29282A2E343A4149525B656E767C8184858584807B
746C645C564F4945413F3E3D3B3834302C28262422201F1E1E1D1C1B1B1C1D1E1F202122222323232321201E
1E1D1D1D1D1C1B1B1A1B1B1D1E1E1E1E1D1D1D1E1F202223242525262728292A2B2B2B2C2E2F31343537393
C3F44484E5256595A5B5D60666B72787D818486888A8C8E9195999DA3A7ACAFB1B2B3B3B4B6B8BDC3CAD2D
9DDDFDFDFDFDFE1E3E4E6E7E7E8EAECEEF0F0F0F0F1F3F6FAFDFFFFFCF8F2ECE7E2DEDBD8D5D3D2D3D4D4D1
CDC5BDB4ACA6A29F9C9995928E8B8784807C78736D68625D59555251504F50505152514E483D2F2012

OBX|23|TX|RBC SCALE||200|fl

OBX|24|TX|RMarker1||41

OBX|25|TX|RBC
HISTO||070E192735434F575A59554E473F37302A24201B1613100D0B09080706050504040303020202020101
01010101020202020202020202020303040404050506060708090A0C0E10121416191C2024282D32373C40464
A4F555A61676F767F889199A3ACB5BEC6CED6DDE4E9EDF1F5F8FAFCFEFFFFFDFCF9F6F4F1EEECE9E6E4E0DCD7
D2CCC5BEB6AFA8A19B95908A857E79726C665F5A544F4B4744403E3B383533302D2B282523201D1B1916141
211100E0D0C0B0A09080706050505040404040404030303020202020202020101010101010101010101020202
0202020202020101010101010101010101010101010101010101010101010101000000000000

OBX|26|TX|PLT SCALE||50|fl

OBX|27|TX|PMarker1||11

OBX|28|TX|PMarker2||163

OBX|29|TX|PLT
HISTO||00000000000000000000000004040C1A2F4C4C6E93B7D6D6EDFAFFFDFDF6EEE5E5DED7D0CBCBC6C2B
FBCBCB9B5AFA9A9A0988F87877F7A746F6F6B67635F5F5D5B585555524F4B4747423E3A363633302F2E2E2C2
A272424211F1D1B1B1816141413111010100F0F0F0F0F0F0F0F0F0F0F0E0E0D0D0C0B0B0A0A0A090808080707
07070707080707070707060606050505050504040404040403020202010101010202030404050506050505040
40303030303030304040405050505050505050504040404040404040404040404040303030304040506060708
080809090808080808070707060605050506070809090B0C0D0D0D0D0D0D0D0D0E0E0F0F0F0F

29/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

Description

The descriptions of the Message Header (MSH), the Observation Request (OBR) and the Order Observation
Result (OBX) can be seen on the following images:

i.e.: MSH|$~\&|A3CPC||||20130816154927||ORU_R01|SAMPLE001|P|2.5.1||||||UNICODE UTF-8|||

1. ’|’ is the Field Separator


2. ’ $~\&’ is the Encoding Characters
3. ’A3CPC’ is the Sending Application.
4. ‘20130816154927’ is the Date/Time Of Message
5. ‘ORU_R01’ is the Message Type
6. ‘SAMPLE001’ is the Message Control ID which contains the Sample ID of the measurement
7. ‘P means preliminary which is the Processing ID
8. ‘2.5.1’ is the Version ID
9. ‘UNICODE UTF-8’ is the Character Set

30/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

i.e.: PID|||PATIENT_ID001||Thomas A.||19621119000000|F

1. ‘PATIENT_ID001’ is the ID number of the Patient Identifier List

2. ‘Thomas A.’ is the Patient Name

3. ‘19621119000000’ is the Date/Time of birth

4. ‘F’ is the Administrative Sex

i.e.:
NTE|1||Dr. Smith

NTE|2||32

1. Set ID. – This field determines the type of the NTE

ID of the NTE Type of NTE

1 Doctor Name

2 Type of sample

2. Comment field describe the Value of the ID. In case of Type of sample, the following table contains the valid
values.

ID Value

32 HUMAN

33 MALE

34 FEMALE

35 BABY

36 TODDLER

37 CHILD

31/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

i.e.: SPM|1|||WB|||||||P

1. ‘1’ is the ID of the SPM field.

2. ‘WB’ is the specimen type. Means Whole Blood.

3. ‘P’ is the Specimen Role. Means preliminary.

i.e.: SAC|||SAMPLE001

1. SAMPLE001 is the Container Identifier, which contains the SampleID.

i.e.: OBR||AWOS_ID001

1. ‘AWOS_ID001’ is a unique ID which refers to a record of the EMR.

32/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

i.e.: OBX|1|TX|WBC||14.80|10^9/l|5.00-10.00|H

1. ‘1’ is the ID of the OBX field. It is an increscent value

2. ‘TX’ is the Value Type. It means ‘text data’

3. ‘WBC’ is the Observation Identifier

4. ‘14.80’ is the Observation Value

5. ‘10^9/l’ is the Unit

6. ‘5.00-10.00’ is the Reference Range(normal range)

7. ‘H’ means High. It is the Abnormal Flag.

List of available Observation Identifiers Description

RBC, WBC, LYM, MID,GRA,LYM%,MID%,GRA%, Hb, Values of common parameters


HCT, MCV, MCH, MCHC, RDW, RDWS, PLT, MPV

WBC HISTO Contains the results of the WBC measurement, 256 x


1 bytes. Every byte represents a count of given
volume of White Blood Cells

th
WBC SCALE It shows the volume at the 256 column of the WBC
histogram.

WMarker1, WMarker2, WMarker3 Markers of the WBC histogram.

33/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

RBC HISTO Contains the results of the RBC measurement, 256 x 1


bytes.

th
RBC SCALE It shows the volume at the 256 column of the RBC
histogram.

RMarker1 Marker of the RBC histogram.

PLT HISTO Contains the results of the PLT measurement, 256 x 1


bytes.

th
PLT SCALE It shows the volume at the 256 column of the PLT
histogram.

PMarker1, PMarker2 Marker of the PLT histogram.

The last OBX lines are the histograms, scales and markers of the observation. The histogram contains 256 x 1
th
byte values. The scale parameter shows the corresponding volume of the 256 column. The scale of the X-axis
(volume of the cells) can be calculated by dividing the scale parameter (i.e. WBC/PLT/RBC SCALE) by 256. The
marker’s value specifies the index of the histogram column (not directly the volume in ‘femtoliter’). The related
Observation Identifiers can be found in the sample message.

The histogram data is encoded in Base64.

34/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

A3CP RECEIVING WORK LIST FROM THE SERVER

Setup

Go to Settings / Communication/ Peer


Communication

The following data have to be provided for the


EMR server:

- EMR enabled

- EMR remote IP address of the HL7 server

- EMR remote port of the HL7 server

Usage

Work list information can be viewed in Measure /


New Sample / EMR(LIS) screen. The screen is
displayed with sample information received from
the network. A work list measurement can be
started by pressing the Run button.

35/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

BIDIRECTIONAL EXAMPLE OF HL7 MESSAGES ( A3CP )

Send worklist item to A3CP

Figure 1 shows an example of a HL7 message v. 2.5 to be sent to A3CP as a LIS Item.

MSH|$~\&|PC_001||||20130816154927||ORM^O01|12345|P|2.5.1||||||UNICODE UTF-8|||

PID||||| Thomas^A.||19621119000000|F|||||||||||PATIENT_ID001

NTE|1||Dr. Smith

NTE|2||32

ORC|NW
Figure 1
OBR||AWOS_ID001||SAMPLE001||20130527164606
The descriptions of the Message Header (MSH), the Patient ID (PID), the Common Order (ORC) and the Order
Observation Request (OBR) can be seen on the following images:

i.e.: MSH|^~\&|PC_001||||20130816154927||ORM^O01|12345|P|2.5.1||||||UNICODE UTF-8|||

1. ’|’ is the Field Separator


2. ’ ^~\&’ is the Encoding Characters
3. ’ PC_001’ is the Sending Application.
4. ‘20130816154927’ is the Date/Time Of Message
5. ‘ORM^O01’ is the Message Type

36/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

6. ‘12345’ is the Message Control ID


7. ‘P‘ means preliminary which is the Processing ID
8. ‘2.5.1’ is the Version ID
9. ‘UNICODE UTF-8’ is the Character Set

i.e.: PID|||||Thomas^A.||19621119000000|F|||||||||||PATIENT_ID001

1. ‘Thomas A.’ is the Patient Name

2. ‘19621119000000’ is the Date/Time of birth

3. ‘F’ is the Administrative Sex

4. ‘PATIENT_ID001’ is the SSN number of the Patient. (or Patient ID)

i.e.:
NTE|1||Dr. Smith

NTE|2||32

1. Set ID. – This field determines the type of the NTE

ID of the NTE Type of NTE

37/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

1 Doctor Name

2 Type of sample

2. The Comment field describes the Value of the ID. In case of Type of sample, the following table contains the
valid values.

ID Value

32 HUMAN

33 MALE

34 FEMALE

35 BABY

36 TODDLER

37 CHILD

i.e.: ORC|NW

1. The Order Control segment can be ‘NW’ for new order, and ‘CA’ for cancel order request.

38/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

i.e.: OBR||AWOS_ID001|| SAMPLE001||20100527164606

1. ’ AWOS_ID001’ is the Place Order Number. It is the unique identifier of the measurement.

2. ‘SAMPLE001’ is the Identifier of Universal Service Identifier. It must be used for Sample ID.

3. ‘20100527164606’ is the Requested Date/Time for the EMR entry.

After Analyzer processed the request a general acknowledge is sent back, which can be seen on Figure 2.

MSH|^~\&|A3CPC||PC||20130816154513||ACK|12345|P|2.5.1||||||WINDOWS-1250|||

MSA|AA|12345

Figure 2

39/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

Figure 2 is a requested and acknowledged Work List Item. The whole list is built up on the Analyzer by receiving
the sequence of the Work List Items.

The analyzer will refuse the request (and will an AR (Application Reject) message), if the number of samples in
the Work List exceeds 255.

The first field of MSA segment in the acknowledged message is used to define whether Analyzer accepted the
Work List Item or not.

’AA’ – Application Acknowledgment,

’AR’ – Application Reject

Delete worklist item from A3CP

Figure 3 shows an example of a HL7 message v. 2.5 to be sent to A3CP as an order to delete a Work List Item.

MSH|$~\&|PC_001||||20130816154927||ORM^O01|12345|P|2.5.1||||||UNICODE UTF-8|||

PID|||||Thomas^A.||19621119000000|F|||||||||||PATIENT_ID001

NTE|1||Dr. Smith

NTE|2||32

ORC|CA Figure 3
OBR||AWOS_ID001||SAMPLE001||20130527164606
The value of the Common Order segment’s Order Control entity must be set to ‘CA’ to delete a Work List Item.

The A3CP software will delete the Work List Item based on the Observation Request segment’s Placer Order
Number (AWOS_ID001). The Placer Order Number is a unique identifier so this message will delete only one
item from the List. After Analyzer processed the request a general acknowledge is sent back, which can be seen
on Figure 2.

ABACUS 5 SENDING MEA SUREMENT DATA TO THE SERVER

40/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

Setup

Go to Main / Settings / External Devices

The following data have to be provided:

- LIS enabled

- IP address of the HL7 server

- Communication port of the HL7 server

Upon setting and saving the above settings, Abacus 5 is ready


to send measurement results to the server.

Usage

Sending data takes place at the end of each measurement automatically and can also be initiated by the user
through the database by clicking on the Manage records / Send to LIS button.

The following is an example of a HL7 message v. 2.5 of Abacus 5:

41/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

Message

MSH|$~\&|ABACUS5$ XYZ_ID||||20091202095847||ORU$R01|AS_378_A5|P|2.5|28461

OBR|1||1234$LAB|88304

OBX|1|TX|WBC||50,86|$10^3|3-15||||P

OBX|2|TX|RBC||0|$10^6|3,5-5,5||||P

OBX|3|TX|PLT||0|$10^3|50-400||||P

OBX|4|TX|HGB||0|$g/l|120-174||||P

OBX|5|TX|LYM||0|$10^3|1-3,7||||P

OBX|6|TX|MON||0|$10^3|0-0,7||||P

OBX|7|TX|NEU||0|$10^3|1,5-7||||P

OBX|8|TX|EO||0|$10^3|0-0,5||||P

OBX|9|TX|BAS||0|$10^3|0-0,15||||P

OBX|10|TX|LYM%||0|$%|21-50||||P

OBX|11|TX|MON%||0|$%|0-14||||P

OBX|12|TX|NEU%||0|$%|37-72||||P

OBX|13|TX|EO%||0|$%|0-6||||P

OBX|14|TX|BAS%||0|$%|0-1||||P

OBX|15|TX|HCT||0|$%|26-50||||P

OBX|16|TX|MCV||0|$fl|86-110||||P

OBX|17|TX|MCH||0|$pg|25-38||||P

OBX|18|TX|MCHC||0|$g/l|300-350||||P

OBX|19|TX|RDWsd||0|$fl|0-0||||P

OBX|20|TX|RDWcv||0|$%|0-16||||P

OBX|21|TX|PDWsd||0|$fl|0-0||||P

OBX|22|TX|PDWcv||0|$%|0-0||||P

OBX|23|TX|MPV||0|$fl|9-13||||P

OBX|24|TX|PCT||0|$%|0,13-0,43||||P

OBX|25|ED|Diff||$$$$iVBORw0KGgoAAAANSUhEUgAAAQAAAAEACAYAAABccqhmAAAAAXNSR0IArs4c6QAAA
ARnQU1BAACxjwv8YQUAAAAgY0hSTQAAeiYAAICEAAD6AAAAgOgAAHUwAADqYAAAOpgAABdwnLpRPAAABwt
…JREFUeF7t1gkNADAMA7GOP+h9NM5jEKeKtvZ94xEg0BR4A+ARINAUmGZsqQkQ+L9/DAQIdAUMQLd7yQn4Ab

42/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

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||||||P

OBX|26|ED|Baso||$$$$iVBORw0KGgoAAAANSUhEUgAAAQAAAAEACAYAAABccqhmAAAAAXNSR0IArs4c6QAA
AARnQU1BAACxjwv8YQ…… ||||||P

OBX|27|ED|Rbc||$$$$iVBORw0KGgoAAAANSUhEUgAAAQAAAAEACAYAAABccqhmAAAAAXNSR0IArs4c6QAAA
ARnQU1BAACxjwv8YQUAAA…… ||||||P

OBX|28|ED|Plt||$$$$iVBORw0K…… ||||||P

43/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

Description

The descriptions of the Message Header (MSH), the Observation Request (OBR) and the Order Observation
Result (OBX) can be seen on the following images:

i.e.: MSH|$~\&|ABACUS5$XYZ_ID||||20091202095847||ORU$R01|AS_378_A5|P|2.5|28461

1. ’|’ is the Field Separator


2. ’ $~\&’ is the Encoding Characters
3. ’ABACUS5$XYZ_ID’ is the ‘Sending Application’, which contains the Namespace ID and the Universal ID
4. ‘20091202095847’ is the timestamp of the sending
5. ‘ORU$R01’ is the message type
6. ‘AS_378_A5’ is the Sample ID (Message Control ID)
7. ‘P’ is the Processing ID
8. ‘2.5’ is the HL7 protocol version (Version ID)
9. ‘28461’ is the Result ID (Sequence number)

44/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

i.e.: OBR|1||1234$LAB|88304

i.e.: OBX|1|TX|WBC||50,86|$10^3|3-15||||P

The last 4 OBX are the Scattergrams and histograms of the observation. The Diff observation is complete, Baso,
Rbc and Plt segments are not complete in this example due excess space requirements.

The data are derived from png file by Base64 encoding. Pictures can be retrieved via Base64 decoding.

45/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

ABACUS 5 RECEIVING WORK LIST FROM THE SE RVER

Setup

Go to Main / Settings / External devices

The following data need to be provided:

- Bidirectional LIS: ON / OFF

Upon setting and saving the above setting Abacus 5 is ready to


receive work lists from the HL7 server.

Usage

Work list information is only relevant in Free List mode – only the sequence of the samples in the auto sampler
need to match the sequence of the work list.

When entering auto sampler menu, you need to select Free list mode.

A screen is displayed with sample information received as the work list.

Status of messages and the communication can be seen in the lower left corner.

Make sure you follow the sequence set in the work list when loading samples into the racks of the auto
sampler. After loading the samples, autoloader can be started with the Start button.

46/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

BIDIRECTIONAL EXAMPLE OF HL7 MESSAGES ( ABACUS 5 )

Send worklist item to Abacus5

Figure 1 shows an example of a HL7 message v. 2.5 to be sent to Abacus 5 as a Work List Item.

MSH|$~\&|7EDIT$XYZ_ID||||20100427163520||ORM$O01|4534|P|2.5||||||WINDOWS-1250

PID|||344||Doe$John||19970527163718|F|||||||||||123465798

ORC|NW|5465

OBR||5465||XYZ_Sample_ID||20100527164606

Figure 1

The descriptions of the Message Header (MSH), the Patient ID (PID), the Common Order (ORC) and the Order
Observation Request (OBR) can be seen on the following images:

i.e.: MSH|$~\&|7EDIT$XYZ_ID||||20100427163520||ORM$O01|4534|P|2.5||||||WINDOWS-1250

1. ’|’ is the Field Separator


2. ’ $~\&’ is the Encoding Characters
3. ’ 7EDIT$XYZ_ID’ is the Sending Application. which contains the Namespace ID and the Universal ID
4. etc.

47/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

i.e.: PID|||344||Doe$John||19970527163718|F|||||||||||123465798

1. ’334’ is the first element (ID Number) of Patient Identifier List


2. ’Doe$John’ is the Family and the Given Name of Patient Name
3. ’19970527163718’ is the Date/Time of Birth
4. ‘F’ Administrative Sex (The value can be: ‘A’ - Ambiguous, ’F’ - Female, ’M’ – Male, ’N’ – Not applicable,
’O’ - Other, ’U’ - Unknown)
5. SSN Number - Patient

48/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

i.e.: ORC|NW|5465

This segment provides information for Work List. The Entity Identifier (5465) is used to identify the Work List.

i.e.: OBR||5465||XYZ_Sample_ID||20100527164606

1. ’5465’ The Entity Identifier has to be the same as the Entity Identifier of ORC segment.

2. ’XYZ_Sample_ID’ The Identifier of Universal Service Identifier is used for Sample ID.

After Analyzer processed the request a general acknowledge is sent back, which can be seen on Figure 2.

MSH|$~\&|||7EDIT$XYZ_ID ||20100427163520||ACK|4534|P|2.5

MSA|AA|4534

Figure 2

49/50
DIATRON MI PLC – www.diatron.com Diatron Communication Protocols – Rev.07

Figure 2 is a requested and acknowledged Work List Item. The whole list is built up on the Analyzer by receiving
the sequence of the Work List Items. The Work List Items with the same Common Order (ORC) segment belong
to the same Work List.

The analyzer will refuse the request (and will an AR (Application Reject) message), if the number of samples in
the Work List exceeds 100.

The first field of MSA segment in the acknowledged message is used to define whether Analyzer accepted the
Work List Item or not.

’AA’ – Application Acknowledgment,

’AR’ – Application Reject

Delete worklist item from Abacus5 (only in Abacus5 US)

Figure 3 shows an example of a HL7 message v. 2.5 to be sent to Abacus 5 US as an order to delete a Work List
Item.

MSH|$~\&|7EDIT$XYZ_ID||||20100427163520||ORM$O01|4534|P|2.5||||||WINDOWS-1250

PID|||344||Doe$John||19970527163718|F|||||||||||123465798

ORC|CA|5465

OBR||8899||XYZ_Sample_ID||20100527164606

Figure 3

The value of the Common Order segment’s Order Control entity must be set to ‘CA’ to delete a Work List Item.
The Abacus5 US software will delete the Work List Item based on the Observation Request segment’s Placer
Order Number (8899). The Placer Order Number is a unique identifier so this message will delete only one
item from the List. After Analyzer processed the request a general acknowledge is sent back, which can be seen
on Figure 2. The Work List will be deleted when all its items are deleted.

***

50/50

You might also like