100% found this document useful (1 vote)
391 views

Celldyn Emerald-Interface E22AL

Uploaded by

gustavodlr
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
100% found this document useful (1 vote)
391 views

Celldyn Emerald-Interface E22AL

Uploaded by

gustavodlr
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 36

CELL-DYN EMERALD 22 AL

LABORATORY INFORMATION SYSTEM


INTERFACE SPECIFICATION

PART NO. 9159915


REVISION A

© 2018
Abbott Laboratories
Diagnostics Division
Abbott Park, IL 60064
NOTES
Table of Contents
1. OBJECTIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
2. REVISION STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
3. SCOPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
4. TERMINOLOGY AND ABBREVIATIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
5. SPECIFICATIONS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
6. TRADEMARK STATEMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
7. GENERAL SPECIFICATIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
7.0 Physical Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
7.0.1 RS232 Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
7.0.2 Ethernet connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
7.0.3 Data Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
7.0.4 Host Serial Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
7.0.5 Host Net Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
7.0.6 Communication Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
7.1 Generic Principles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
7.1.1 Frame Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
7.1.1.1 Frame Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
7.1.1.2 Frame ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
7.1.2 Data Representation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
7.1.3 Machine Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
7.1.4 Transmission Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
7.1.4.1 XON/OFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
7.1.4.2 Handshaking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
7.1.5 Connection with HOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
7.1.5.1 Connection request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
7.1.6 Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
7.1.7 Format Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
7.2 Data Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
7.2.1 Result (Sample) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
7.2.1.1 Sending Result Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
7.2.1.2 Sending Result Request Acknowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
7.2.1.3 Analysis Result Sending . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
7.2.1.4 Alarms List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
7.2.1.5 WBC Interpretive Message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
7.2.1.6 RBC Interpretive Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
7.2.1.7 PLT Interpretive Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
7.2.1.8 Lmne Matrix and Threshold Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
7.2.1.9 Result Acknowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
7.2.1.10 Error Handling in Handshake Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
7.2.1.11 Next Tube Acknowledges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
7.2.1.12 Emerald 22 AL Acknowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
7.2.2 Calibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
7.2.2.1 Sending Calibration Report Frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
7.2.2.2 Calibration Report Acknowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
7.2.2.3 Calibration Result Frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
7.2.3 QC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

CELL-DYN Emerald 22 LIS Interface Specification Page iii


9159915A—August 2018
7.2.3.1 QC Result Frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
7.2.4 Precision. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
7.2.4.1 Precision Result Frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
7.2.5 Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
7.3 Control Sum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
7.3.1 Algorithmic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
7.4 Receiving a Worklist from a LIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
7.4.1 Principles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
7.4.2 CRC Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
7.4.3 FILE Receipt ACKNOWLEDGMENT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Page iv CELL-DYN Emerald 22 LIS Interface Specification


9159915A—August 2018
1. OBJECTIVE
This document describes the data transmission format protocol between CELL-DYN Emerald 22 AL and a
host Laboratory Information System (LIS).
The functionality must match the software specifications of the CELL-DYN Emerald 22 AL.

2. REVISION STATUS
Document Control Number(s) Revision Date Section(s) Revised Pages Revised and Added

New Release August 2018 Initial release: all Initial release: all sections
9159915A sections new. new.

3. SCOPE
This document applies to the CELL-DYN Emerald 22 AL instrument. It specifies the messages and
behaviors of the initial version of the CELL-DYN Emerald 22 AL Host Computer Interface.

4. TERMINOLOGY AND ABBREVIATIONS

Table 1 — CELL-DYN Emerald 22 AL Terms

Term Description

Hand-Shake Bi-directional communication using


acknowledgment.

Frame One or more data lines.

LIS Laboratory Information System, HOST system.

Host External Computer or data collection system.

CT Close Tube mode.

OV Other Vial.

E22AL CELL-DYN Emerald 22 AL abbreviation.

CRC Cyclic Redundancy Code.

CELL-DYN Emerald 22 AL LIS Interface Specification Page 1 of 32


9159915A—August 2018
Table 2 — Format Description Symbols

Symbol Comment

[CR] 0x0d, carriage return

[LF] 0x0a, line feed

[CRLF] 0x0d, 0x0a

[TAB] 0x09, tabulation

[SPACE] 0x20, space character

[ETX] 0x03, end of text

'A' 0x41, a character is in quotes

(OPT) Optional field.


If not received, Emerald 22 AL will take a default value.

(SEND) The following frame is sent by Emerald 22 AL.

(RECEIVE) The following frame is received by Emerald 22 AL.

[MACHINE_NAME] "EMD22AL" for Emerald 22 Auto Loader

5. SPECIFICATIONS
The Host Interface for the CELL-DYN Emerald 22 AL System is a specific format designed to transfer data
to an external system. The system does not use the ASTM or CLIS (LIS-x) standards for communications
with a host system. The format is text-oriented and is compatible with CSV format used by various
Microsoft Office applications.
NOTE: The password 123 (SUPERVISOR) is necessary to access the COMMUNICATION menu.

6. TRADEMARK STATEMENTS
CELL-DYN and CELL-DYN Emerald are trademarks of Abbott Laboratories in various jurisdictions. All
other trademarks are property of their respective owners.

Page 2 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
7. GENERAL SPECIFICATIONS

7.0 Physical Interface


7.0.1 RS232 Connector
The CELL-DYN Emerald 22 AL provides a standard DB-9 female connector, labeled RS232C, mounted on
the rear of the instrument. The CELL-DYN Emerald 22 AL is a DCE device.

Figure 1 RS232C Label

Table 3 lists the pins on the DB-9 connector (standard RS-232 9-pin assignments).
Table 3 — DB-9 Connector Pins
Pin Description

Pin 1 Data Carrier Detect (DCD input)

Pin 2 (output) CELL-DYN Emerald 22 AL Data to Host (LIS, results)

Pin 3 (input) Host Data to CELL-DYN Emerald 22 AL

Pin 4 (output) Data Terminal Ready (DTR)

Pin 5 Signal Ground

Pin 6 Data Set Ready (DSR)

Pin 7 (input) Clear to Send (CTS input)


(not enabled by CELL-DYN Emerald 22 AL Software)

Pin 8 (output) Request to Send (RTS output)


(not enabled by CELL-DYN 22 AL Software)

Pin 9 (not connected)

Connector Housing Physical Ground

Figure 2 RS232 Port 1

CELL-DYN Emerald 22 AL LIS Interface Specification Page 3 of 32


9159915A—August 2018
7.0.2 Ethernet connector
The CELL-DYN Emerald 22 AL provides an RJ 45 connector 10/100Base, labeled with the symbol below,
mounted on the rear of the instrument.

Figure 3 RJ 45 Label

7.0.3 Data Interface


The system can be configured to use either TCP/IP or UDP/IP over Ethernet or RS232 in the
COMMUNICATION menu by selecting HOST SERIAL (for RS 232) or HOST NET (for TCP/IP or UDP).
The default setting is no host.
7.0.4 Host Serial Configuration
The system can be configured for data transmission on the RS232 channel by using the
COMMUNICATION/SERIAL PARAM. Menu. The configurable transmission parameters include data
bits, stop bits, parity and baud rate.
• The asynchronous method of data transmission (serial by bit) is used.
• All information transmitted is in character form and is represented by 8-bit or ASCII.
• Transmitted characters consist of one (1) start bit, eight (8) data bits (least significant first), odd, even
or no parity bit, and one (1) or two (2) stop bits.
• Parity may be selected as none, odd, or even. Default parity is None.
• The transmission speed may be selected from 1200, 9600, 19,200, 57,600, or 115,200 bits per second
(bps).
• The Default setting is 115,200 bits per second.
• The number of bits per character is eight bits.
• Stop bit by default.
7.0.5 Host Net Configuration
• The system can be configured for data transmission via TCP/IP or UDP/IP over Ethernet by using the
COMMUNICATION/NET. PARAM. Menu.
• The configurable transmission parameters include protocol, host IP address, host port, Emerald IP
address, Emerald mask address, and Gateway address.
• The protocol may be set to TCP/IP in this menu. The default setting is “UDP/IP”.
• The host default IP address is 192.168.0.103. Its port is default set to 1200. Its mask is 255.255.255.0.
• The Emerald 22 AL default IP address is 192.168.0.200. The gateway default address is 192.168.0.1.
• The Emerald 22 AL port is set to 3000.

Page 4 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
7.0.6 Communication Protocol
The following are available with RS232 only.
• Transmission control is provided in one way: XOFF/XON protocol in which the Host transmits an
XOFF character (hex 13) to stop transmission from the System and an XON character (hex 11) to re-
start transmission.
• This is optional and not default-enabled. The option is available in COMMUNICATION/SERIAL
PARAM. Menu with the FLOW setting.

7.1 Generic Principles

7.1.1 Frame Format


A frame contains one or more lines. A line contains one or more fields. The exchanged frames are in ASCII
code.
All lines sent by the CELL-DYN Emerald 22 AL are terminated with [CR], even if not specified in the
examples. In receiving, the CELL-DYN Emerald 22 AL can accept: [CR], [LF], or [CRLF] as the end line.
Each frame sent by the instrument consists of the following elements:
[FRAME HEADER] [FRAME ID] [DATA SEGMENT]

7.1.1.1 Frame Header


[FRAME HEADER] is composed of: [MACHINE_NAME]; W; X; Y[CR].
Where:
• [MACHINE_NAME] is “EMD22AL.”
• W is the instrument number (2 characters maximum).
• X is the instrument serial number (13 characters), including the '-' character (for example: 312108-
000014).
• Y is the user login, UTF8-coded.
Here after is the list of instruments that exist..
Table 4 — Instruments

FRAME HEADER Instrument

EMD22AL CELL-DYN Emerald 22 Autoloader Parameters

7.1.1.2 Frame ID
Each frame sent by the host consists of the following elements:
[FRAME ID] [DATA SEGMENT]
[FRAME ID]
Composed of KEY WORD (and optional parameters) [CR].

CELL-DYN Emerald 22 AL LIS Interface Specification Page 5 of 32


9159915A—August 2018
The Frame ID allows distinguishing the type of information transmitted.
Table 5 — Frame ID

SENDER

FRAME ID HOST Information


INSTRUMENT (handshake enabled)

CONNECT X X Connection Test Request

ACK_CONNECT X Connection acknowledged

NAK_CONNECT X Connection acknowledged with


failed status

RESULT_READY X Instrument ready to send result


data

RESULT X Result data being sent

ACK_RESULT_READY X Host acknowledge: ready for result


data

ACK_RESULT X Host acknowledge: end of result


data receipt

CALIBRATION X Calibration report being sent

ACK_CALI X Host acknowledge: end of


calibration report receipt

[DATA SEGMENT]
Optional according to the type of frame.

7.1.2 Data Representation


Numeric data are transmitted in fields of variable length.
• The decimal separator is the dot.
• The field separator is the semicolon.
• The lines separator and the end of frame indicator is the carriage return.
• The atomic frames are:
– Results sending request when sending result frames.
– Sending of calibration packet when sending calibration results
All the frames’ lines have to be emitted (if there is no information, the parameter is let empty).
All the identifier key words (of frame or of parameter) are in upper-case.
The following fields (SID, PID, ID, blood type, operator, lot number) are UTF8 encoded.
The DATE format is set to DD/MM/YYYY; the time format is set to HH:MM:SS in 24-hour format.
Table 6 — Maximum Field Lengths

Field Characters

OPERATOR 10

USER 10

Page 6 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
Table 6 — Maximum Field Lengths (Continued)

Field Characters

LOT (CALI or QC) 8

SID 16

PID 16

ID 20

7.1.3 Machine Identification


In addition to the machine name, the first two serial number digits provide the machine type as illustrated in
Table 7.
Table 7 — Machine Identification

Identification Code Machine Type

03 CELL-DYN Emerald 18 Open Tube

25 CELL-DYN Emerald 22 Open Tube

31 CELL-DYN Emerald 22 Autoloader

7.1.4 Transmission Control

7.1.4.1 XON/OFF
In order to control data flow transmission, you can use the CELL-DYN Emerald 22 AL system XON/XOFF
option.
If the flow is set at XON/XOFF, the CELL-DYN Emerald 22 AL transmission suspends when the Host
transmits an XOFF character (hex 13), and re-starts with an XON character (hex 11). CTS/RTS signals are
not used.

7.1.4.2 Handshaking
Also, you can use the Handshake option. If enabled, the host must reply with an appropriate frame to the
CELL-DYN Emerald 22 AL before an adjustable delay. Otherwise, an error message appears on screen as in
Table 8.
Table 8 — Handshake Error Messages

Error Message Comment

"HOST: SYNCHRO ERROR" The acknowledge message from the host is not the one expected.

"HOST: ACK ERROR" The host acknowledges the message with an error (NACK … receive).
The format revision is different between CELL-DYN Emerald 22 AL and the
host.

"HOST: TIME OUT" No response from the host before the delay.

CELL-DYN Emerald 22 AL LIS Interface Specification Page 7 of 32


9159915A—August 2018
7.1.5 Connection with HOST
To communicate with a host, it is not required to establish the connection. However, an established
communication secures the communication.

7.1.5.1 Connection request

7.1.5.1.1 Initiated by the Instrument

Instrument Host

“EMD22AL;1;250207-000451;BILL”[CR]
Connection request
“CONNECT;250207-000451;5”[CR]

“ACK_CONNECT;5”[CR]
Acknowledge if
Or “NAK_CONNECT;5”[CR]
handshake is used

Figure 4 Instrument Initiated Connection Request

(SEND)
[FRAME_HEADER] = machine name; instrument number; serial number; user login [CR]
[FRAME_ID] = CONNECT; serial number; format version [CR]
(RECEIVE)
ACK_CONNECT; format version [CR] if host accepts the connection.
NACK_CONNECT; format version [CR] else if host refuses the connection.

NOTE: The format version is defined in Format Version; it is verified by CELL-DYN Emerald 22 AL if
handshaking is used.

7.1.5.1.2 Initiated by the Host

Host Instrument

“CONNECT;5”[CR]
Connection request

“EMD22AL;1;310207-000451;BILL”[CR]
“ACK_CONNECT;;250207-000451;5”[CR]

Figure 5 Host Initiated Connection Request

(RECEIVE)
[FRAME_ID] = CONNECT; C2 format version [CR]
(SEND)
[FRAME_HEADER] = machine name; machine number; serial number; login user [CR]
ACK_CONNECT; serial number; format version [CR]

Page 8 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
7.1.5.1.3 Instrument Disconnect

Instrument Host

“DISCONNECT;311215-000202”[CR]
Instrument Logout/
Switch OFF

Figure 6 Instrument Disconnect

(SEND)
[FRAME_ID] = DISCONNECT; serial number [CR]

No Handshake.

7.1.6 Unit
The parameters unit is specified by the line:
UNIT; u [CR]

Table 9 — Unit Codes

Unit Code Unit System

1 USA = standard

2 S.I.

3 S.I. MOD

4 Other (Japanese)

If the UNIT line is missing, CELL-DYN Emerald 22 AL uses the USA unit (code 1).
CELL-DYN Emerald 22 AL sends the results in the current unit (same as the displayed and printed units).

7.1.7 Format Version


Table 10 displays the format version.
Table 10 — Format Version

Version Definition of Version Content

9 Creation from E22AL format rev 09.

9 Add Frame Disconnect

CELL-DYN Emerald 22 AL LIS Interface Specification Page 9 of 32


9159915A—August 2018
7.2 Data Format

7.2.1 Result (Sample)


The CELL-DYN Emerald 22 AL sends the results after the Host acknowledge occurs. This behavior avoids
a stream to be sent with no host connected.

Instrument Host

[FRAME HEADER]
Sending result requested RESULT_READY;2470[CR]

ACK_RESULT_READY[CR] Sending result request


acknowledge
[FRAME HEADER]
RESULT[CR]
Analysis result sending
DATA SEGMENT

ACK_RESULT;OK[CR]
Result acknowledge

HOST with hand-shake mode

Figure 7 Result Sample

7.2.1.1 Sending Result Request


Used in the case of a hand-shake mode.
(SEND)
[FRAME HEADER]
[FRAME ID] = RESULT_READY; result size in bytes[CR]

7.2.1.2 Sending Result Request Acknowledge


(RECEIVE)
ACK_RESULT_READY[CR]

Page 10 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
7.2.1.3 Analysis Result Sending
NOTE: The hematologic parameters line order is subject to change between
CELL-DYN Emerald 18, CELL-DYN Emerald 22, and CELL-DYN Emerald 22 AL. Then, use the token (in
bold) to decode the parameter.

EMD22AL; 1; 250207-000451;BILL[CR] FRAME ID


RESULT [CR] FRAME HEADER
DATE;30/10/2007 [CR] DATA SEGMENT FOLLOWS

TIME;15:36:38 [CR]
MODE;NORMAL [CR]
UNIT; 1 [CR]
SEQ;352; reserved[CR]
SID;3 [CR]
PID;X28 [CR]
ID;DUPONT [CR]
TYPE;STANDARD [CR}

TEST;DIF [CR] CBC or DIF

RTYPE;1 [CR] Rack type (0 for standard RACK, 1 for Sarstedt Rack)
RACK;2 [CR] Rack ID.
POS;5 [CR] Tube pos. in rack
BIRTH;14/09/1981 [CR]
SEX;1 [CR] (0 Unknown, 1 Male, 2 Female)
PRESC; ERNESTO [CR]
LOCAT;PARIS [CR]
DRAW DATE;0 [CR] (0 for UNKNOWN or 1 for TODAY or 2 for YESTERDAY)
DRAW TIME; 12:10:00 [CR] hh:mm:ss
PATIENT COMMENT; [CR]
INFO;;;[CR] Manual association (M or blank); rerun (R or blank);

OPERATOR ; M22AL.01 [CR] operator login when analysis request occurred [CR]
PREL;CT [CR] Sampling mode (CT for Close Tube, OV for Other Vial)
CYCLE;N [CR] Cycle option (N for Normal, A for Altitude)

WBC; 11.0;A;B; 2.0; 4.0; 11.0; 15.0 [CR]( Parameter; A; B; low panic ;low ; high ;high panic )
RBC; 6.00;A;B; 2.50; 4.00; 6.20; 7.00 [CR]
HGB;15.0;A;B; 8.5;11.0;18.8;20.0 [CR]
HCT;49.0;A;B;25.0;35.0;55.0;60.0 [CR]
PLT; 320;A;B; 70; 150; 400; 500 [CR]
LYM; 3.4;A;B; 0.8; 1.0; 5.0; 5.5 [CR]
MON;13.0;A;B; 1.0; 2.0;10.0;12.0 [CR]

CELL-DYN Emerald 22 AL LIS Interface Specification Page 11 of 32


9159915A—August 2018
NEU;13.0;A;B; 1.0; 2.0;10.0;12.0 [CR]
LYM%;30.5;A;B;15.0;25.0;50.0;55.0 [CR]
MON%;13.0;A;B; 1.0; 2.0;10.0;12.0 [CR]
NEU%;13.0;A;B; 1.0; 2.0;10.0;12.0 [CR]
MCV; 81.7;A;B; 70.0; 80.0;100.0;120.0 [CR]
MCH; 25.0;A;B; 25.0; 26.0; 34.0; 35.0 [CR]
MCHC; 30.6;A;B; 28.0; 31.0; 35.0; 36.0 [CR]
RDW; 8.1;A;B; 7.0; 10.0; 20.0; 25.0 [CR]
MPV; 7.5;A;B; 5.0; 6.0; 10.0; 12.5 [CR]
PCT; 0.4;A;B; 0.1; 0.2; 0.5; 0.6 [CR]
PDW; 9.9;A;B; 5.0; 8.0; 18.0; 25.0 [CR]
EOS;1.0;A;B; 1.0; 2.0;10.0;12.0 [CR]
BAS;1.2;A;B; 1.0; 2.0;10.0;12.0 [CR]
EOS%;3.0;A;B; 1.0; 2.0;10.0;12.0 [CR]
BAS%;5.0;A;B; 1.0; 2.0;10.0;12.0 [CR]
WBC CURVE; channel 1 value;… ;channel 128 value [CR]
WBC THRESHOLDS;S1;S2;S3 [CR]
RBC CURVE; channel 1 value;… ;channel 128 value [CR]
RBC THRESHOLDS; S1;S2 [CR]
PLT CURVE; channel 1 value;… ;channel 128 value [CR]
PLT THRESHOLDS; S1 [CR]
ALARMS;x;x;x;x;x;x;x;x;x;x;x [CR]
INTERPRETIVE_WBC;y;y;y;y;y;y;y;y;y;y;y;y [CR]
INTERPRETIVE_RBC;y;y;y;y;y;y;y;y;y;y;y;y [CR]
INTERPRETIVE_PLT;y;y;y;y;y;y;y;y;y;y;y;y [CR]
COMMENT; PCT and PDW are for Info Only (if necessary)

LMNE MATRIX; [CR] Compressed LMNE matrix


m;m;m;m;m;m;m;m;…;m;m;m;m; [CR]
m;m;m;m;m;m;m;m;…;m;m;m;m; [CR] Variable lines number.
…………
m;m;m;m;m;m;m;m;m;m;m;T[CR]
[CR] Compressed LMNE matrix, low level
LMNE SHADE MATRIX; [CR]
m;m;m;m;m;m;m;m;…;m;m;m;m; [CR] Variable lines number.
m;m;m;m;m;m;m;m;…;m;m;m;m; [CR]
…………
m;m;m;m;m;m;m;m;m;m;m;T[CR]
[CR]
THRES 5D LMNE MATRIX; [CR] LMNE matrix thresholds x,y coordinates.
N ;S ;N ;S ;… ;S ;N ;S ;N ;S ;[CR]
N ;S ;N ;S ;… ;S ;N ;S ;N ;S ;[CR]

END_RESULT; control sum value [CR]

Page 12 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
7.2.1.3.1 Field Details
Table 11 — Sampling Mode: PREL; p
p Value Machine Type Signification

“OT” E18 / E22 (OT) Open Tube

“NO_RUN” E18 / E22 (OT) / E22 AL Unknown

“OV“ E22 AL Other vial

“CT“ E22 AL Close tube

Table 12 — Cycle Option: CYCLE; o


o Value Machine Type Signification

“N“ ALL Used cycle is standard.

“A” ALL Used cycle is optimized for high altitude.

Table 13 — INFO field: INFO; x,y


Field Value

x Nothing or M for order manually matched.

y Nothing or R for rerun.

Table 14 — Alarms and Pathological Message


Field Value

x Nothing or alarm.
y Nothing or interpretive message.

Table 15 — Histograms and Thresholds


Field Value

S1 S2 S3 Curves thresholds ([0 to127] range).

Table 16 — Matrix: Emerald 22 / Emerald 22 AL


Field Value

m compressed ASCII field, 1 to 4 characters.

N Matrix Threshold name. See below for more details.

S Matrix Threshold value. See below for more details.


NOTE: Each line size is below 250 characters. Lines number is variable.
See below for more details.

CELL-DYN Emerald 22 AL LIS Interface Specification Page 13 of 32


9159915A—August 2018
7.2.1.3.2 Hematological Parameter Format
Id ; value ; flag A ; flag B ; low panic ; low ; high ; high panic [CR]
WBC; 11.0 ; A ; B ; 2.0 ; 4.0 ; 11.0 ; 15.0 [CR]
Table 17 — Hematological Parameter Format
Rank Field Possible Values

1 Parameter id WBC, RBC, ….

2 Parameter value in the 5.84


selected unit + + + + + (5 pluses) if over range
-----(5 dashes) if invalid result

3 Flag A Nothing or ‘*’ if result is rejected (counting or


measure rejection) or invalidating fault. 's' for
different alarms (see flagging scheme).

4 Flag B Nothing
D : Higher than reportable limits (1)

‘L’ Result < panic value


‘l’ Result < normal value
‘h’ Result > normal value
‘H’ Result > panic value

5 Low panic value 2.0

6 Low value 4.0

7 High value 6.0

8 High panic value 8.0


(1) in the case field 2 is set to +++++
When IUO option is not selected, PCT and PDW parameters are not sent.

7.2.1.4 Alarms List


S-U NOT DONE
S-UP FAIL
QC NOT DONE
QC ALERT
INS_H
L1
L5
P1
P2
P3
W_CL
R_CL
O_DF
NE
MN
ML
N1

Page 14 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
N2
IC
LN
D_CL

7.2.1.5 WBC Interpretive Message


LEU>;
LEU<;
LYM>;
LYM<;
MON>
NEU>
NEU<
EOS>
BAS>
LIC
ALY
ERYB
NO_INTERPRETATION;

7.2.1.6 RBC Interpretive Message


ANE
ERY>
MICRO
MACRO
ANIS>
HYPOCR
NO_INTERPRETATION

7.2.1.7 PLT Interpretive Report


THR>
THR<
MACROP
DEBRIS
SCHIZ
MICROC
PLTAGGR
NO_INTERPRETATION

CELL-DYN Emerald 22 AL LIS Interface Specification Page 15 of 32


9159915A—August 2018
7.2.1.8 Lmne Matrix and Threshold Details
The Lmne matrix is separated into two compressed matrices. This is to provide two levels in the third
dimension. After uncompressing (using the same owner algorithm), the matrix means:
• LMNE MATRIX = 2D image for all cellular elements, 1 bit per cell, 128 x 128 bits = 2048 bytes.
• LMNE SHADE MATRIX = only low level cells, 1 bit per cell, 128 x 128 bits = 2048 bytes.
Low level cells mean less than two cells.
Table 18 — Lmne Matrix
LMNE MATRIX, bit i LMNE SHADE MATRIX, bit i Points or Cells

0 0 none

0 1 low level

1 0 high level

1 1 Not possible case

7.2.1.8.1 Compressing Algorithm Overview


• 00 repeat bytes are coded « Zxxx », xxx = ASCII Hexadecimal counter.
• FF repeat bytes are coded « Uxxx », xxx = ASCII Hexadecimal counter.
• Other bytes are coded in ASCII Hexadecimal: « xx »,
• Matrix end is coded with « T ».
• Each item is separated by a separator ';'.
• The data are divided in line. Lower than 250 characters: a carriage return [CR] is inserted.

Page 16 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
7.2.1.8.2 Matrix Decode and Draw Example
The compressed matrix data start just after the tokens “LMNE MATRIX;” and “LMNE SHADE
MATRIX;”. Basic examples in C, C++ language to uncompress and draw lmne matrix:
1. You have to create two destination buffers as: unsigned char destMatrix[16][128]
2. For each matrix, call the UnSqueezeMatrix (dest, src) function, with two parameters:
dest = pointer on destination buffer (2Kbytes)
src = pointer on ascii compressed matrix data, (after the tokens /separator)
//======================================================================
// function name: UnSqueezeMatrix
// Description: decompress a 2D matrix, C2 format, char[16][128]
// Auteur(s): SA
// Param IN: pucDestMatrix = pointer on destination buffer, u_char [16][128]
// Param IN: pucSrcM = pointer on ascii data source
// Param OUT: int = bytes size of dest matrix
//======================================================================

int UnSqueezeMatrix(u_char *pucDestMatrix, u_char *pucSrcM)// dest, source


{
int iCnt;
u_char *pucDest, *pucSrc, ucVal; pucSrc = pucSrcM;// source
pucDest = pucDestMatrix; // dest
memset(pucDestMatrix, 0, 16 * 128);// clear dest.

// search first value


while ((*pucSrc == ';') || (*pucSrc == '\x0d') || (*pucSrc == '\x0a')) pucSrc++;

//read fields
while (true)
{
ucVal = *pucSrc;
if ((ucVal == 0) || (ucVal == 'T'))
{break;} // end of frame

switch(ucVal)
{
case '\x0d': // ignore carriage return
case '\x0a': // ignore line feed
break;

case 'Z': // value 0x00


case 'U': // value 0xFF
{
pucSrc++;
sscanf((char *)pucSrc,"%x", &iCnt);

CELL-DYN Emerald 22 AL LIS Interface Specification Page 17 of 32


9159915A—August 2018
memset(pucDest, (ucVal == 'U') ? 0xFF : 0x00 , iCnt);
pucDest+= iCnt;
break;
}
default:
{
sscanf((char *)pucSrc,"%x", &iCnt);
*pucDest++ = (u_char)iCnt;
break;
}
}

// check overflow
if (pucDest > pucDestMatrix + (16 * 128))
{
memset(pucDestMatrix, 0, 16 * 128);// clear dest
pucDest = pucDestMatrix;
break;
}

// skip next separator


while (*pucSrc++ != ';');
}
return((int)pucDest - (int)pucDestMatrix);// return uncompressed data size
}
This function needs that ";" is a separator for the scanf() function, usually true for most systems.

3. Uncompress then draw a matrix using a TImage 128x128 pixels component (Delphi or BC++).

The origin TImage component is top, left (x=y=0).

The origin matrix display is bottom left (channels=0).

The following code draws the two level lmne matrix into bitmap components. Color by population is not
managed in the example.
static u_char ucMask[] = {0x80,0x40,0x20,0x10,0x08,0x04,0x02,0x01};
UnSqueezeMatrix( pucMat, bufferM1);// dest, src uncompress
UnSqueezeMatrix( pucMatL, bufferM2);// dest, src uncompress
for (i = 0; i <(16*128); i++)// 128 x 128 pixels
{
ucVal = *(pucMat+i);// LMNE MATRIX byte
ucValL = *(pucMatL+i);// LMNE SHADE MATRIX byte iX = (i%16)*8;
iY = i/16;
for (k=0; k<8; k++)// MSB to LSB

Page 18 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
{
if ((ucMask[k] & ucValL) != 0)// low level
img->Canvas->Pixels[iX+k] [iY] = ColorLow;
else if ((ucMask[k] & ucVal) != 0)// high level
img->Canvas->Pixels[ iX+k] [iY]= ColorHigh;
}
}

FSC (Forward Scatter)

High level cells

Thresholds

Low level cells

Matrix Origin
ALL (Axial Light Losses)

Figure 8 Forward Scatter

4. Matrix thresholds
The thresholds are on two lines after the token “THRES 5D LMNE MATRIX ;”.
They are preceded by their names and provide the X, Y coordinates segment of the matrix: the origin is
left, bottom, channels 0.
Table 19 — Matrix Thresholds

Name Range Min / Max Default Value

First Line

N1X 0 / 127 15

N1Y 0 / 127 20

N2X 0 / 127 23

N2Y 0 / 127 35

LnlX 0 / 127 28

LnlY 0 / 127 50

LmnX 0 / 127 26

LmnY 0 / 127 63

LneX 0 / 127 60

LneY 0 / 127 55

CELL-DYN Emerald 22 AL LIS Interface Specification Page 19 of 32


9159915A—August 2018
Table 19 — Matrix Thresholds (Continued)

Name Range Min / Max Default Value

EosX 0 / 127 90

LmY 0 / 127 69

ICY 0 / 127 105

NmX 0 / 127 50

RneX 0 / 127 110

Second Line

BasoX1 0 / 127 25

BasoY1 0 / 127 50

BasoX2 0 / 127 33

BasoY2 0 / 127 52

BasoX3 0 / 127 29

BasoY3 0 / 127 68

BasoX4 0 / 127 22

BasoY4 0 / 127 65

Margin Around Main Threshold

NEL 0 / 127 2

NEH 0 / 127 2

MNL 0 / 127 2

MNH 0 / 127 2

MLL 0 / 127 2

MLR 0 / 127 3

LNL 0 / 127 2

LNH 0 / 127 2

Page 20 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
NMNL MNH NEL NEH ICY

See Baso NmX RneX


Detail

MLH

Lmn x,y

MLL

LNH
LNL

Lmy

N1 x,y N2 x,y Lnl x,y Lne x,y EosX

Origin
(0,0)
Figure 9 Matrix Thresholds

Figure 10 Baso Detail Position

CELL-DYN Emerald 22 AL LIS Interface Specification Page 21 of 32


9159915A—August 2018
Matrix and thresholds sample frame
…………..

LMNE MATRIX;
Z164;40;Z1e;1;Z13;8;Z3b;9;c0;0;20;c0;0;40;Z9;……;cc;60;40;Za;5a;80;1;
;46;c;Zb;cc;2;13;1b;e0;Zb;b9;2;27;98;70;Zb;e5;…;20;Z5;1;0;3;a2;
;5c;0;20;Z3;20;Z5;6;41;8a;53;Zc;1;40;…;Z7;23;0;58;8;
;Z3;29;68;Z7;12;82;4c;60;4;0;11;40;4;e0;Z6;…;a4;21;8a;Z4;2;0;1;
;Zf;1f;c0;Ze;3;40;Z6c;4;Z2f;4;Z1f;4;Z1f;4;Z80;T
LMNE SHADE MATRIX;
Z183;1;Z13;8;Z3c;40;0;20;Zc;10;Z2;20;Zc;1;c0;…;70;Zb;60;2;49;c8;20;
;Zb;a1;Zf;6;8;50;6;Zc;c2;8;85;9;80;Z3;1;Za;4;…;10;10;Z8;18;88;60;
;10;Z3;40;80;1;Z6;1;40;Z4;8;Za;d1;c0;Z3;8;4;…;0;c;Z5;1a;3;50;
;Z2;81;0;20;2;Z4;2;Z2;24;80;Z6;20;Z4;2;Z2;…;Ze;10;80;Zd;8;48;Ze;8;
;20;Ze;4;88;Z1f;90;Zf;20;Ze;2c;80;Ze;10;…;40;Zdc;4;Z80;T
THRES 5D LMNE MATRIX;
N1Y;20;N1X;15;N2Y;35;N2X;23;EosX;100;LneY;55;LneX;60;LnlY;50;LnlX;28;RneX;105;NmX;46;LmY;69;
Lmn
Y;63;LmnX;26;ICY;105;
BasoY1;60;BasoX1;26;BasoY2;64;BasoX2;30;BasoY3;70;BasoX3;29;BasoY4;65;BasoX4;20;NHH;2;NHL;2;RL
L;
2;RLR;3;NLH;2;NLL;2;HLH;2;HLL;2;

7.2.1.9 Result Acknowledge


ACK_RESULT;A;B[CR]
Where A: OK or error code, B: Nothing.
NOTE: No matter what the error code transmitted by the host, the error code is not interpreted by CELL-
DYN Emerald 22 AL.

7.2.1.10 Error Handling in Handshake Mode


In handshake mode, each result is tagged if no error is raised in the acknowledge process. If an error is ever
raised, then the result is not tagged.
At next login, the CELL-DYN Emerald 22 AL proposes the user to automatically emit the not sent results.
The user has then the ability to accept, to postpone or ignore (in this case the results are flagged as sent).
In non-handshake mode, the CELL-DYN Emerald 22 AL assumes that all frames were correctly sent and so
marks all samples as ‘transmitted’.

7.2.1.11 Next Tube Acknowledges


None.

7.2.1.12 Emerald 22 AL Acknowledge


(SEND)
EMD22AL X ;Y;ACK_NEXT_FOLDER [CR]

Page 22 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
7.2.2 Calibration

Emerald Host
[FRAME HEADER]
Sending calibration report
Calibration report frame

ACK_CALI;LOT;OK[CR] Calibration report


For each result, repeat acknowledge
Calibration results sending [FRAME HEADER]
Calibration result frame

ACK_RESULT;OK[CR] Calibration Result


acknowledge

HOST with hand shake mode

Figure 11 Calibration Example

NOTE: With Hand-shake mode, each Calibration result frame must be acknowledged before the timeout.

7.2.2.1 Sending Calibration Report Frame


EMD22AL W;X ;Y[CR]
CALIBRATION;Y;calibration date;calibration time;LOT;expiry date;creation date;time creation;Y;A ;B ;C ;D ;F ;number
of results [CR]
WBC; target value ; margin [CR]
RBC; target value ; tolerance [CR]
HGB; target value ; tolerance [CR]
MCV; target value ; tolerance [CR]
PLT; target value ; tolerance [CR]
END_CALI ; control sum[CR]
Where:
X : user which created the lot.
Y : user which done the calibration.
A, B, C, D and F are the calibration factors, respectively, WBC, RBC, HGB, MCV and PLT. Followed by
the number of results used for the calibration.
When a manual calibration occurred, lot information is those of the current lot in use and the number of result
is set to 0.

7.2.2.2 Calibration Report Acknowledge


Calibration acknowledge by the host id done by the following frame:
ACK_CALI ;[Calibration Lot];A [CR]

CELL-DYN Emerald 22 AL LIS Interface Specification Page 23 of 32


9159915A—August 2018
Where A : OK or Error code.

7.2.2.3 Calibration Result Frame


Calibration result follows Calibration report. Define the number of results used for calibration and to be sent
in the Calibration report.
Each result contains the following:
EMD22AL W;X;Y[CR]
RESULT [CR]
DATE;30/10/2003 [CR]
TIME;15:36:38 [CR]
MODE;CALIBRATION [CR]
UNIT; Unit [CR]
SEQ;352; 0 [CR]
TEST;DIF [CR]
OPERATOR; login when analysis request occurred [CR]
PREL;OV[CR]
CYCLE;N[CR]
WBC; 11.0; A;B;;;; [CR]
RBC; 6.00; A;B;;;; [CR]
HGB;15.0; A;B;;;; [CR]
MCV;49.0; A;B;;;; [CR]
PLT; 320; A;B;;;; [CR]
END_RESULT; control sum value [CR]

A and B equal to analysis result.

7.2.3 QC

Emerald Host

[HEADER FRAME]
Sending QC result request
RESULT_READY;1280[CR]

ACK_RESULT_READY[CR] Sending QC result


request acknowledge

QC result sending [HEADER FRAME]


QC result frame

ACK_RESULT;OK[CR] QC Result
acknowledge

Host with hand shake mode


Figure 12 QC Example

Page 24 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
7.2.3.1 QC Result Frame
EMD22AL;W;X ;Y[CR]
RESULT [CR]
DATE;13/05/2008[CR] date then time of analysis
TIME;15:04:05[CR]
MODE;QC[CR] result type
UNIT;1[CR] used unit
SEQ;4[CR]
LOT;KDH95211[CR] lot name
LOT DATE;13/05/2008[CR] creation date
LOT TIME;15:03:19[CR] creation time
LEVEL;H[CR] lot level (1 character H, L or N)
EXPIRY DATE;04/06/2008[CR] expiry date
USER;123[CR] user (login) which created the lot
TEST;DIF[CR] DIF for DIFF result, CBC for CBC result.
OPERATOR;123[CR] operator login when analysis request occurred
PREL;OV[CR] sampling mode
CYCLE;N[CR] cycle option : N, A
WBC;8.0 ;;H;4.0 ;6.2[CR] parameter ID; value; Flag A; Flag B; target low; target high
RBC;4.30 ;;;3.80 ;5.42[CR]
HGB;11.0;;;11.0;13.2[CR]
HCT;40.0;;L;41.8;44.4[CR]
PLT;220 ;;;210 ;232[CR]
LYM;2.1 ;;;1.3 ;2.9[CR] Only on DIF result
MON;1.6 ;;H;0.4 ;1.2[CR] Only on DIF result
NEU;3.6 ;;H;1.0 ;2.4[CR] Only on DIF result
LYM%;26.7;;;24.0;36.2[CR] Only on DIF result
MON%;20.0;;H;4.0 ;16.2[CR] Only on DIF result
NEU%;45.6;;L;46.0;74.2[CR] Only on DIF result
MCV;93.0 ;;L;95.1 ;99.1[CR]
MCH;25.6 ;;H;20.3 ;23.9[CR]
MCHC;27.5 ;;;27.2 ;31.0[CR]
RDW;15.1 ;;;12.6 ;15.6[CR]
MPV;18.5 ;;H;7.3 ;10.9[CR]
PCT;0.680;;H;0.220;0.462[CR]
PDW;15.1 ;;H;10.0 ;14.2[CR]
EOS;0.6 ;;L;1.0 ;1.8[CR] Only on DIF result
BAS;0.0 ;;L;1.0 ;2.4[CR] Only on DIF result
EOS%;7.6 ;;H;2.2 ;3.0[CR] Only on DIF result
BAS%;0.1 ;;L;1.3 ;2.3[CR] Only on DIF result
END_RESULT;40579[CR] end of result; control sum value
(*) The SEQ field is filled out with the sequence number initialized by the
CELL-DYN Emerald 22 AL when the QC run is requested.
If the QC results are sent later, then the sequence number becomes a rank number from 0 to n.

CELL-DYN Emerald 22 AL LIS Interface Specification Page 25 of 32


9159915A—August 2018
7.2.4 Precision

Emerald Host

Sending precision [HEADER FRAME]


result request RESULT_READY;2560[CR]

ACK_RESULT_READY[CR]

[HEADER FRAME]
Precision result sending
Precision result frame

Precision result
ACK_RESULT;OK[CR]
acknowledge

Figure 13 Precision Example

Page 26 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
7.2.4.1 Precision Result Frame
[CR] are implicit for each line. The frame is similar as QC result frame, without target information.
EMD22AL;W;X ;Y[CR] [FRAME HEADER]
RESULT[CR] [FRAME ID]
DATE;13/05/2008[CR]
TIME;15:33:09[CR]
MODE;REPEATABILITY[CR] result type
UNIT;1[CR]
SEQ;7[CR] TEST;DIF[CR]
OPERATOR;123[CR] Operator login when analysis request occurred
PREL;OV[CR]
CYCLE;N[CR]
WBC;12.0 ;; [CR] parameter ID; value; Flag A; Flag B; target low; target high
RBC;4.70 ;; [CR]
HGB;11.4;; [CR]
HCT;40.4;; [CR]
PLT;220 ;; [CR]
LYM;0.6 ;; [CR]
MON;1.3 ;; [CR]
NEU;9.5 ;; [CR]
LYM%;5.4 ;; [CR]
MON%;11.1;; [CR]
NEU%;79.2;; [CR]
MCV;86.0 ;; [CR]
MCH;24.3 ;; [CR]
MCHC;28.2 ;; [CR]
RDW;16.2 ;; [CR]
MPV;10.4 ;; [CR]
PCT;0.380;; [CR]
PDW;14.5 ;; [CR]
EOS;0.5 ;; [CR]
BAS;0.0 ;; [CR]
EOS%;4.1 ;; [CR]
BAS%;0.2 ;; [CR]
END_RESULT;58621[CR] end of result; control sum value

Format parameters "WBC" to "BAS%" equal to analysis result.

CELL-DYN Emerald 22 AL LIS Interface Specification Page 27 of 32


9159915A—August 2018
7.2.5 Startup
EMD22AL; W;X;Y[CR] [FRAME HEADER]
STARTUP;[DATE];[TIME];[Status: PASSED/FAILED];[WBC Val];[RBC Val];[HGB Val];[PLT Val] [CR]

Example:
EMD22AL; 1;314011-000162;TEST
STARTUP;07/11/2016;16:22:47;FAILED;0.000000;0.120000;0.100000;847.000000

7.3 Control Sum


The control sum is a CRC code: CRC-16.
This CRC is computed from the beginning sent data (including FRAME HEADER) until the end of line
([CR] included) preceding the checksum line (identifier + value).

7.3.1 Algorithmic
The used source code is available here below (C code).
It allows generating standard CRC-16. This algorithm is mainly used in embedded systems (like hard disk
controller). For best performance, compute is done from a seek table with 16 values.
Here is the CRC computation:
CRC = 0xFFFF
For each nibble :
Work on high weight nibble :
Index = byte EXCLUSIVE OR CRC
Index = Index AND 000F
CRC = Table(Index) EXCLUSIVE OR (CRC divided by 16)
Work on low weight nibble :
Index = byte divided by 16
Index = Index EXCLUSIVE OR CRC
Index = Index AND 000F
CRC = Table(Index) EXCLUSIVE OR (CRC divided by 16)

C language source example implementation:


Seek table declaration:
static const unsigned short ausCrcTab1[] =
{
0x0000, 0xCC01,0xD801,0x1400,0xF001,0x3C00,0x2800,
0xE401,0xA001,0x6C00,0x7800,0xB401,0x5000,0x9C01,
0x8801,0x4400,
};

Page 28 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
CRC computation:
unsigned short calc_crc(unsigned char *pucData, long lSize)
{
unsigned short usAcc1 = 0xFFFF;

while ( lSize > 0 )


{
/* Compute per 4 bits packages */
usAcc1 = ausCrcTab1[(*pucData ^ usAcc1) & 15] ^ (usAcc1 >> 4);
usAcc1 = ausCrcTab1[((*pucData >> 4) ^ usAcc1) &
15] ^ (usAcc1 >> 4);
pucData++;
lSize--;
}

return(usAcc1);
}

^ : EXCLUSIVE OR
>> : logical right shift.
& : logical and.

7.4 Receiving a Worklist from a LIS

7.4.1 Principles
A LIS may connect in HOST (either NET or RS), in order to send patient files to a CELL-DYN Emerald 22
AL. Each send is checked by the CELL-DYN Emerald 22 AL (CRC based) and acknowledged by such. If
errors occur, they are sent back to the LIS for processing.
A LIS may transmit patient files using the "ADD_NEW_ORDER" command then processed by the CELL-
DYN Emerald 22 AL, as defined below:
ADD_NEW_ORDER,KEY,RTYPE,RACK,POS,Stat,SID,PID,ID,BIRTH,SEX,TYPE,TEST,PRESC,LOCAT,PRELD,
PRELTIME,RUN,MATCH,Pat.COMMENT,CRC[CR]
The ADD_NEW_ORDER command is ASCII-based and must be carriage-return terminated.
Below the parameters to be supplied:
KEY: File number. E22AL will not take this value into account,
since it assigns a new file number for the received order. Remains at 0.
RTYPE: Rack Type number, must be : {undef, 1, .., 10 }.
For the moment only type 0 and 1 are available.
RACK: Rack number, must be : {undef, 1, .., 10 }
POS: Position number for the sample inside a rack, must be: {undef, 1, .., 5 }
Stat: Order Status. E22AL will not take this value into account since a
received order is considered to be done. Remains at 'T' for TODO.
SID: Order SID, 16 chars max, mandatory
PID: Order PID, 16 chars max.

CELL-DYN Emerald 22 AL LIS Interface Specification Page 29 of 32


9159915A—August 2018
ID: Order ID, 20 chars max.
BIRTH: Patient birthday with the following format DD/MM/YYYY
SEX: Patient Sex, must be: {0, 1, 2} respectively : 'undef', 'Male', 'Female'
TYPE: Blood Type, 10 chars max. STANDARD for instance.
TEST: Test Type, must be: {0, 1} respectively, 'CBC' , 'DIF',
PRESC: Physician Name, 20 chars max.
LOCAT: Laboratory location, 20 chars max.
PRELD: Sampling Day, must be {0,1,2} respectively 'UNKNOWN' ,
'TODAY', 'YESTERDAY'
PRELTIME: Sampling Hour with the following format HH:MM:SS
RUN: Remains blank.
MATCH: Remains blank.
Pat.COMMENT: Optional Comment, 30 chars max.
CRC: unsigned short value containing the CRC

NOTE: Only SID and CRC fields have to be provided for the order to apply, as long as commas are
provided even in case of blank fields.

Below, an example of an order supplied to a CELL-DYN Emerald 22 AL. This order concerns a sample
laid inside the second slot of the first rack of type 3. The patient was born in 1990 and the sample was
achieved by doc. House in the state of Oregon.
ADD_NEW_ORDER,0,3,1,2,T,TEST SID 1,TEST PID 1,TEST
ID,01/01/1990,1,STANDARD,1,HOUSE,OREGON,2,00:00:00,,,comment,6410\R

7.4.2 CRC Value


CRC computing (6410 in the previous example) is done from the first comma (excluded) to the last comma
(excluded). In other words, CRC is computed using the string in yellow background.
The following CRC computing is applied:
Search array for performance efficiency.
static const unsigned short ausCrcTab1[] =
{
0x0000, 0xCC01,0xD801,0x1400,0xF001,0x3C00,0x2800,0xE401,
0xA001,0x6C00,0x7800,0xB401,0x5000,0x9C01,0x8801,0x4400,
};

CRC computing:
unsigned short calc_crc(unsigned char *pucData, long lSize)
{
unsigned short usAcc1 = 0xFFFF;

while ( lSize > 0 )


{
usAcc1 = ausCrcTab1[(*pucData ^ usAcc1) & 15] ^ (usAcc1 >> 4);
usAcc1 = ausCrcTab1[((*pucData >> 4) ^ usAcc1) & 15] ^ (usAcc1 >> 4);
pucData++;
lSize--;
}
return(usAcc1);
}

Page 30 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018
7.4.3 FILE Receipt ACKNOWLEDGMENT
Receipt acknowledgment is done after CRC check. After a proper transmission and order processing,
the CELL-DYN Emerald 22 AL sends back the following line to tell the LIS that no error has occurred.
ADD_NEW_ORDER: 0, OK[CR]
In case of errors, the CELL-DYN Emerald 22 AL may send back the previous command to LIS, with the error
number followed by one of the following string:
ERR_WL_IS_FULL, Worklist is full
ERR_WL_ORDER_IS_USED, Can’t modify file because the status is not TODO.
ERR_WL_ORDER_SID_IS_BLANK, Empty SID is not allowed
ERR_WL_ORDER_RACKPOS_USED, Rack/Position already used within the worklist.
ERR_WL_ORDER_PID_IS_BLANK, Depending of the SETUP, file must contain a PID
ERR_WL_ORDER_ID_IS_BLANK Depending of the SETUP, file must contain a ID
ERR_WL_ORDER_BAD_CRC CRC error.
Those strings may be parsed to detect errors and decide whether resume order sending or not. An order
successfully sent to the CELL DYN Emerald 22 AL will not be compromised by another order that leads to
an error.

CELL-DYN Emerald 22 AL LIS Interface Specification Page 31 of 32


9159915A—August 2018
NOTES

Page 32 of 32 CELL-DYN Emerald 22 AL LIS Interface Specification


9159915A—August 2018

You might also like