Phoresis Extended Minicap
Phoresis Extended Minicap
Phoresis Extended Minicap
x
March 2012
HOST MODULE
(only for Capillarys/Phoresis with SQL Engine)
PHORESISEXTENDED PROTOCOL
RS-232C/TCP-IP & FILE-TRANSFER (NETWORK)
INTRODUCTION
This manual provides all the information to interface a Capillarys system or Phoresis
scanner to a host computer or LIS (Laboratory Information System) through a RS232C
serial link, network TCP-IP connection or via file transfer over network.
It describes the communication protocols and message formats used by Phoresis in
receiving and transmitting data.
Contents
2
RS-232C SERIAL LINK AND TCP-IP CONNECTION
The RS-232C serial link and TCP-IP connection consists of message exchange between Capillarys/Phoresis
and the host computer.
Through these messages, it is possible to import either the entire worklist in one time (Worklist or Total
mode) or patient by patient (Query or Partial mode) according to the present patient ID numbers (entered
through the keyboard or scanned with the tube barcode reader) in the Phoresis worklist and to export after
running the samples the corresponding patient results.
The operator has to click on the Host icon on the main screen, and then select either Import worklist or
Import (ID query) according to the setting to import the patient data or Export results to transmit the sample
results and thus for the selected analysis program and current date.
All messages start with a STX character (ASCII 02h) and end with an ETX character (ASCII 03h).
The last patient to download to Phoresis in Worklist mode after a MSG3 request and the last patient analysis
results uploaded (MSG5) to the Host end with EOT character (ASCII 04h) instead of ETX in order to indicate
to the receiver that there are no more patients to transmit.
3
IMPORTING A WORKLIST IN WORKLIST MODE FROM
THE HOST
The Worklist or Total mode allows the operator to download the patient demography of all the patients or a
group of patients by indicating the start and end sample numbers (e.g. 1 to 50 or 51 to 51 when it is an
emergency patient) and thus for the selected analysis program and current date.
The operator has to click on the Host icon, select Import worklist, enter the start and end sample numbers
and confirm with OK as shown on the following screen before starting downloading the patient data.
Communication protocol:
Notes:
Phoresis sends a MSG1 to the Host and waits for a MSG2, then waits for the MSG3.
When Phoresis has received correctly a MSG3 from the Host, it answers with a MSG2 (ACK) and thus
for all the patients downloaded. In case of wrong reception, Phoresis answers with the MSG4 (NACK)
and consequently the Host retransmits the MSG3 for a max of 3 times then goes to the next patient.
When the Host does not have anymore samples to download to Phoresis, the last character of MSG3
becomes EOT (ASCII 04h) instead of the ETX (ASCII 03h) character transmitted after each of the
previous samples.
When the operator does not know the number of samples to download, he has to enter 9999 as the last
sample number.
This mode is highly not recommended for the use of instruments provided with a barcode reader as
Minicap, Capillrys and Assist.
4
IMPORTING A WORKLIST IN QUERY MODE FROM THE
HOST (QUERY BY PATIENT ID)
The Query or Partial mode allows the operator to download the patient data of the selected analysis
program and current date after entry of the patient ID numbers first in the worklist.
The patient ID numbers can be entered either from the keyboard or a barcode reader from Worklist by single
sheet or Worklist by table menu. Once the patient ID numbers have been entered, the operator has to click
on the Host icon, select Partial request enter the start and end sample numbers and confirm with OK as
shown on the following screen before starting downloading the corresponding patient data.
Note:
To enter the patient ID numbers with a barcode reader, select Worklist by single sheet and uncheck all the
fields except ID number from Options menu. To verify all the worklist fields once the samples have been
downloaded, select Worklist by table and View all.
Communication protocol:
Notes:
Phoresis sends a MSG6 to the Host and waits for a MSG2, then waits for the MSG3.
When Phoresis has received correctly a MSG3 from the Host, it answers with a MSG2 (ACK), and thus
for all the patients downloaded. In case of wrong reception, Phoresis answers with the MSG4 (NACK)
and consequently the Host retransmits the MSG3 for a max of 3 times then goes to the next patient.
When the Host does not have patient data for a ID, should send MSG7 instead of MSG3.
The Sample number (position in the Worklist) is not used in Query reception since it is given by
Phoresis. The Host should return 0000 for this field, if a different value is transmitted, Phoresis
will ignore it.
5
EXPORTING THE RESULTS TO THE HOST
This procedure allows the operator to upload the whole patient results of the selected analysis program for
the current date to the Host once the samples have been run and edited.
The operator has to click on the Host icon, select Export results then Phoresis asks for the start and end
sample numbers to export as shown on the following screen:
Communication protocol:
Notes:
Phoresis starts the transmission sending MSG5 (first patient) then waits for MSG2 (ACK) from the Host,
then continues with the next MSG5 (next patient) and waits again for MSG2, and thus up to the last
sample selected by the operator.
If Host answers a MSG4 (NACK), Phoresis retransmits the previous patient results and waits again for
the MSG2 (ACK) for max. 3 times then goes to the next patient results.
When Phoresis does not have anymore samples to transmit to the Host, the last character of MSG5
becomes EOT (ASCII 04h) instead of the ETX (ASCII 03h) character transmitted at the end of each
previous sample.
Every record as a fixed length
6
MESSAGE 1 DESCRIPTION (MSG1)
7
MESSAGE 5 DESCRIPTION (MSG5)
8
49 Fraction 9 conc. value 458 5 Not fixed with a decimal separator “.” (2Eh)
50 Fraction 10 conc. value 463 5 Not fixed with a decimal separator “.” (2Eh)
51 Peak 1 name 468 10 Alphanum. charact., aligned left and spaces
52 Peak 2 name 478 10 Alphanum. charact., aligned left and spaces
53 Peak 3 name 488 10 Alphanum. charact., aligned left and spaces
54 Peak 4 name 498 10 Alphanum. charact., aligned left and spaces
55 Peak 1 % value 508 5 Not fixed with a decimal separator “.” (2Eh)
56 Peak 2 % value 513 5 Not fixed with a decimal separator “.” (2Eh)
57 Peak 3 % value 518 5 Not fixed with a decimal separator “.” (2Eh)
58 Peak 4 % value 523 5 Not fixed with a decimal separator “.” (2Eh)
59 Peak 1 conc. value 528 5 Not fixed with a decimal separator “.” (2Eh)
60 Peak 2 conc. value 533 5 Not fixed with a decimal separator “.” (2Eh)
61 Peak 3 conc. value 538 5 Not fixed with a decimal separator “.” (2Eh)
62 Peak 4 conc. value 543 5 Not fixed with a decimal separator “.” (2Eh)
63 Pathological Flag 548 1 0 = Normal , 1 = Pathological
64 Ratio 1 (e.g. A/G for the proteins) 549 5 Not fixed with a decimal separator “.” (2Eh)
65 Ratio 2 554 5 Not fixed with a decimal separator “.” (2Eh)
66 Comment 559 230 Alphanum. charact., aligned left and spaces
67 Reference pattern flag 789 1 0 = Normal pattern , 1 = Reference pattern
68 QC sample flag 790 1 0 = Normal sample , 1 = QC sample
Optional fields -- --
69 Curve
82 Programmable fields + the attached card comment
124 Extended comment
69/82/124/125 ETX or EOT 791/XXX 1 ASCII 03h or 04h for the last sample
TOTAL 18 bytes
9
Optional fields for the curve
"A" = Automatic, the scale is determined by the max. (Y) Amplitude value of the curve (curve full scale).
"M" = Manual, the scale is multiplied by a percentage factor of the max. value.
Note that in the latest versions of Phoresis / Capillarys is possible to highlight up to 10 areas, but
only the first four areas will be sent to LIS.
YYY (hexadecimal value) indicating the Y amplitude of the dot (right aligned, min. = 000, max. = FFF).
The curve consists today of 300 dots, so it means that it has a total length of 1200 characters, and
the whole optional fields for the curve has a total length of 1242 bytes. In the future, the number of
dots of the curve could be increased from 300 up to 1200 dots (4800 characters).
10
Additional field transmission: 40 programmable fields + the attached card comment
No. Description Start Length Note
82 ** (2 Characters 2Ah) 791 2 Indicates the additional field transmission
83 Programmable field #1 793 15 Alphanum. charact.
84 Programmable field #2 808 15 Alphanum. charact.
85 Programmable field #3 823 15 Alphanum. charact.
86 Programmable field #4 838 15 Alphanum. charact.
87 Programmable field #5 853 15 Alphanum. charact.
88 Programmable field #6 868 15 Alphanum. charact.
89 Programmable field #7 883 15 Alphanum. charact.
90 Programmable field #8 898 15 Alphanum. charact.
-- --------- ---- --- ---
120 Programmable field #38 1348 15 Alphanum. charact.
121 Programmable field #39 1363 15 Alphanum. charact.
122 Programmable field #40 1378 15 Alphanum. charact.
123 Attached card comment 1393 256 Alphanum. charact.
TOTAL 858 bytes
The content configuration of the 40 programmable fields can be done by modification of the host.ini file (into
the Host folder) or by specific windows in configuration.
[PROTOCOLLO]
MODO=RS232
TIPO=Phoresis Extended
LETTERA=S
RX_MODE=WORKLIST
REALTIME=0
RECALL_MODE=1
[PHORESIS]
CURVA=0
COMMENTO_ESTESO=0
OPTIONAL_FIELDS=0
CRC_CHECK=0
IMAGE_IF=0
AUTOSEQUENCE=0
NUMERIC_ID=0
FILE_CARD=0
FORCE_SEQUENCE=0
OPZ_FIELD1=DO_MAX
OPZ_FIELD2=NR_CAPILLARY
OPZ_FIELD3=RACK_NR
OPZ_FIELD4=ANALYSIS_TIME
OPZ_FIELD5=MIGRATION_TIME
OPZ_FIELD6=DELAY_TIME
...
The additional instructions to transmit the programmable fields (corresponding to Capillarys here) are in bold
characters.
This optional field has a variable length from 0 to 3000 characters. All CR+LF (ASCII 0Dh+0Ah) entered in
the extended comment will be converted in RS characters (ASCII 1Eh).
11
FILE-TRANSFER (NETWORK)
The connection via File Transfer happens through read/write of files in a folder shared in network between
Phoresis and the Host.
Two files, of configurable path and name, one containing the Worklist data and the other one, the result data
are in ASCII format with a structure of record, will be read therefore from a common text editor.
This file containing the patient demography of all the samples to scan is generated by the Host.
The record has a fixed length.
The operator has 2 options to download the worklist of the selected analysis program for the current date:
Worklist (Total) mode or Query (Partial) mode
The Worklist or Total mode allows the operator to download the patient demography of all the patients or a
group of patients to run on the system by indicating the start and end sample numbers (e.g. 1 to 50 or 51 to
51 when it is an emergency patient) and thus for the selected analysis program and current date.
The operator has to click on the Host icon, select Import worklist, sets from which sequence should begin the
import of the data and confirm with OK as shown on the following screen before starting downloading the
patient data.
12
This mode is highly not recommended for the use of instruments provided with a barcode reader as
Minicap, Capillrys and Assist.
Note that changing the value 'Start from Number' implies that the received data is shifted from the
original sequence of a value equal to that indicated.
For example: if you enter 10 in 'Start from Number' and the file contains 10 records, from 1 to 10, the
samples will be imported in positions start from sequence 10 to sequence 20.
Two example records will be imported into sequence number 1 and 2 instead of sequence 2 and 3.
Note:
To enter the patient ID numbers with a barcode reader, select Worklist by single sheet and uncheck all the
fields except ID number from Options menu.
To verify all the worklist fields once the samples have been downloaded, select Worklist by table and View
all.
13
RECORD DESCRIPTION
14
EXPORTING THE RESULTS TO THE HOST
(RESULT FILE FROM PHORESIS)
This file is generated by Phoresis after selection of the patients to export by the operator.
It contains all the numerical results and demographic patient data.
It consists of a sequential ASCII record with a fixed length when the optional fields are not selected or a
variable length when they are selected.
The procedure allows the operator to upload the whole patient results of the selected analysis program for
the current date to the Host once the samples have been run and edited.
The operator has to click on the Host icon, select Export results, enter the start and end sample numbers to
upload and confirm with OK as shown on the following screen:
RECORD DESCRIPTION
15
34 Fraction 5 % value 387 5 Not fixed with a decimal separator “.” (2Eh)
35 Fraction 6 % value 392 5 Not fixed with a decimal separator “.” (2Eh)
36 Fraction 7 % value 397 5 Not fixed with a decimal separator “.” (2Eh)
37 Fraction 8 % value 402 5 Not fixed with a decimal separator “.” (2Eh)
38 Fraction 9 % value 407 5 Not fixed with a decimal separator “.” (2Eh)
39 Fraction 10 % value 412 5 Not fixed with a decimal separator “.” (2Eh)
40 Fraction 1 conc. value 417 5 Not fixed with a decimal separator “.” (2Eh)
41 Fraction 2 conc. value 422 5 Not fixed with a decimal separator “.” (2Eh)
42 Fraction 3 conc. value 427 5 Not fixed with a decimal separator “.” (2Eh)
43 Fraction 4 conc. value 432 5 Not fixed with a decimal separator “.” (2Eh)
44 Fraction 5 conc. value 437 5 Not fixed with a decimal separator “.” (2Eh)
45 Fraction 6 conc. value 442 5 Not fixed with a decimal separator “.” (2Eh)
46 Fraction 7 conc. value 447 5 Not fixed with a decimal separator “.” (2Eh)
47 Fraction 8 conc. value 452 5 Not fixed with a decimal separator “.” (2Eh)
48 Fraction 9 conc. value 457 5 Not fixed with a decimal separator “.” (2Eh)
49 Fraction 10 con. value 462 5 Not fixed with a decimal separator “.” (2Eh)
50 Area 1 name 467 10 Alphanum. charact. aligned left and spaces
51 Area 2 name 477 10 Alphanum. charact. aligned left and spaces
52 Area 3 name 487 10 Alphanum. charact. aligned left and spaces
53 Area 4 name 497 10 Alphanum. charact. aligned left and spaces
54 Area 1 value % 507 5 Not fixed with a decimal separator “.” (2Eh)
55 Area 2 value % 512 5 Not fixed with a decimal separator “.” (2Eh)
56 Area 3 value % 517 5 Not fixed with a decimal separator “.” (2Eh)
57 Area 4 value % 522 5 Not fixed with a decimal separator “.” (2Eh)
58 Area 1 conc. value 527 5 Not fixed with a decimal separator “.” (2Eh)
59 Area 2 conc. value 532 5 Not fixed with a decimal separator “.” (2Eh)
60 Area 3 conc. value 537 5 Not fixed with a decimal separator “.” (2Eh)
61 Area 4 conc. value 542 5 Not fixed with a decimal separator “.” (2Eh)
62 Pathological Flag 547 1 0 = Normal , 1 = Pathological
63 Ratio 1(e.g. A/G for the proteins) 548 5 Not fixed with a decimal separator “.” (2Eh)
64 Ratio 2 553 5 Not fixed with a decimal separator “.” (2Eh)
65 Comment 558 230 Alphanum. charact. aligned left and spaces
66 Reference pattern flag 788 1 0 = Normal pattern , 1 = reference pattern
67 QC sample flag 789 1 0 = Normal sample , 1 = QC sample
Optional fields --- ---
68 Curve
81 Programmable fields + the attached card comment
123 Extended comment
68/81/123/124 CR + LF 790/XXX 2 ASCII 0Dh or 0Ah
16
Optional fields for the curve
"A" = Automatic, the scale is determined by the max. (Y) Amplitude value of the curve (curve full scale).
"M" = Manual, the scale is multiplied by a percentage factor of the max. value.
Note that in the latest versions of Phoresis / Capillarys is possible to highlight up to 10 areas, but
only the first four areas will be sent to LIS.
A set of dots for the curve coded under the following format: XYYY.
X representing the type of dot:
YYY (hexadecimal value) indicating the Y amplitude of the dot (right aligned, min. =000, max. =FFF).
The curve consists today of 300 dots, so it means that it has a total length of 1200 characters, and
the whole optional fields for the curve has a total length of 1242 bytes. In the future, the number of
dots of the curve could be increased from 300 up to 1200 dots (4800 characters).
17
Additional field transmission: 40 programmable fields + the attached card comment
No. Description Start Length Note
81 ** (2 Characters 2Ah) 790 2 Indicates the additional field transmission
82 Programmable field #1 792 15 Alphanum. charact.
83 Programmable field #2 807 15 Alphanum. charact.
84 Programmable field #3 822 15 Alphanum. charact.
85 Programmable field #4 837 15 Alphanum. charact.
86 Programmable field #5 852 15 Alphanum. charact.
87 Programmable field #6 867 15 Alphanum. charact.
88 Programmable field #7 882 15 Alphanum. charact.
99 Programmable field #8 897 15 Alphanum. charact.
-- --------- ---- --- ---
119 Programmable field #38 1347 15 Alphanum. charact.
120 Programmable field #39 1362 15 Alphanum. charact.
121 Programmable field #40 1377 15 Alphanum. charact.
122 Attached card comment 1392 256 Alphanum. charact.
TOTAL 858 bytes
The content configuration of the 40 programmable fields can be done by modification of the host.ini file (into
the Host folder) or by specific form in configuration.
[PROTOCOLLO]
MODO=RS232
TIPO=Phoresis Extended
LETTERA=S
RX_MODE=WORKLIST
REALTIME=0
RECALL_MODE=1
[PHORESIS]
CURVA=0
COMMENTO_ESTESO=0
OPTIONAL_FIELDS=0
CRC_CHECK=0
IMAGE_IF=0
AUTOSEQUENCE=0
NUMERIC_ID=0
FILE_CARD=0
FORCE_SEQUENCE=0
OPZ_FIELD1=DO_MAX
OPZ_FIELD2=NR_CAPILLARY
OPZ_FIELD3=RACK_NR
OPZ_FIELD4=ANALYSIS_TIME
OPZ_FIELD5=MIGRATION_TIME
OPZ_FIELD6=DELAY_TIME
The additional instructions to transmit the programmable fields (Corresponding to Capillarys here) are in
bold characters.
123 Extended comment -- max3000 Alphanum. charact. With max 3000 charact.
This field has a variable length from 0 to 3000 characters. All CR+LF (ASCII 0Dh+0Ah) entered in the
extended comment will be converted in RS character (ASCII 1Eh)
18
SETTING PARAMETERS
From the main menu, click on Host icon, select successively Parameters and Host parameters,
Enter the password 4644 or free then the system displays the following screen:
Connection Method
File-transfer (Network), select the network path, enter the Worklist and result file names, confirm with OK,
and then restart Phoresis for the changes to be effective.
(Lock file is the name of semaphore files to prevent simultaneous access with LIS)
19
TCP/IP select the Remote Host Address or IP and the remote Host TCP Port, confirm with OK then restart
Phoresis for the changes to be effective.
RS232, select the COM port, set the baud rate, data bit, parity, stop bit and delays, confirm with OK then
restart Phoresis for the changes to be effective.
(Delay Answer are milliseconds of waiting time between sent and received messages and viceversa. Time
Out is a maximum time to receive a message from LIS. If not arrive in time, Host module will show an error.)
Trace ON check-box actives permanently writing of the log files into folder HOST of Phoresis.
This file logs all operations of connection with the LIS (outcomes and error of the communication).
The log files are daily and are named:
HOSTTRACEYYYYMMDD.LOG
where
Protocol Type
When clicking in the Protocol type window, the system proposes only PhoresisExtended and Preference.
Preference protocol is not described in this manual because It does not give the possibility to use all the
capabilities of Phoresis such as the capability to use the date of birth, the laboratory code, the sample
collection date, the 5 additional free fields and the operator ID for the Worklist and the capability to transmit
the monoclonal peaks and the extended comment to the host.
Import Mode
20
Query ID. Request to LIS demographic data of patients by ID/Barcode tube
Worklist with Match good for ID. Request to LIS a Worklist and it will match Sample with demographic
data by ID/Barcode tube. The position of the samples is the same as the instrument read
Worklist. Request to LIS a Worklist. Position of samples (Sequence) is the same received from LIS.
Note:
Before writing a record, the Host Module looks for a sample with correspondent ID to merge it with
the demographic data received.
If the position in which it must be written a demographic data there is a curve without ID or with ID
does not match, this last will be moved to the end of the work list.
This mode is not compatible with MiniCap because moving records causes a runtime error on the
affected records.
Moreover this mode does not allow to work with no ID / barcode on the tube, for example with
Hydrasys without sampler Assist.
[..], Add a button near of Title for setting some parameters (see Appendix 10).
Enable curve transmission, See page 10 in RS232/TCP and page 17 in File Transfer.
Enable additional field transmission, See page 11 in RS232/TCP and page 18 in File Transfer
and Appendix 9 for configuration (via gui or file INI).
Enable extended comment transmission, See page 11 in RS232/TCP and page 18 in File
Transfer.
Enable flags transmission, enabled/disabled additional option to transmission of normal range and
alarms of fractions value. See Appendix 4.
Transmit IF image, enabled/disabled transmission of image file with scanned IF. This is active only
in file transfer mode. See Appendix 5.
21
Transmit simulated ELP image, enabled/disabled transmission of image file with ELP image (is not
a real scanned image but a virtual rebuild). This is active only in file transfer mode. See Appendix 6.
Enable Check of CRC16, enable/disable check and transmission of five chars for CRC. See
Appendix 3 for CRC16 calculation)
Verify duplicated ID before transmission, enable/disable a pre transmission of results to check for
any duplicate IDs in the worklist. If there are duplicate IDs, Host module will open following window:
Curve with Albumin on the right, this option is active only when Enable curve transmission is
checked.
Import data in Card from file [File name]. enable/disable import of specific protein value from LIS
into 24 value of Attached Card. See Appendix 7
Default comment [comment text], allows to specify a default text for all records that have empty
comment.
Warning, this option should be adjusted based on the operation of the LIS:
No, after importation of demographics data the Worklist file will not be deleted.
The file size will grow, If LIS doesn’t erase it. This slows down the operations of importing data.
Yes, after importation of demographics data the Worklist file will be deleted.
If the worklist file is partially imported, demographics data not imported will be lost.
Deleting imported records, after importation will be removed only the imported records. Into the Worklist
file will remain only not imported rows.
We suggest to select this mode if you do not know how LIS manages this file and is mandatory if the LIS
handles the records in queue.
22
Specific config by program
Realtime
Three Tabs of this frame contain all settings concerning the realtime.
Enable automatic communication with HOST/LIS, enable/disable all automatic communication with LIS
for selected analysis program.
Don’t import data of Control Sample and specific ->[Id Pattern], if enable, auto import don’t request
demographic data for control sample (the QC records are identified by ID on database equal at
‘CONTROL*’). With button [Id Pattern] you can specify a text string that, if found in the ID field, disables
automatic import for that sample. For example, typing the string 'SAMPLE, ABC' all records with IDs that
start with SAMPLE or ABC will be excluded from automatic import.
Export only records with valid ID or barcode #, if enabled, only records with ID/Barcode are automatic
exported. Otherwise all samples (even with no ID) will send to LIS.
Automatic connection every [ ] sec, this text box specify waiting time in second between connection.
Warning, in earlier releases this timing was in milliseconds.
Automatic Import, kind of samples imported to LIS regarding import demographic data.
Warning, all records just exported will no longer be imported.
Automatic Export, , kind of samples exported to LIS regarding import demographic data.
Edited records are samples that they are displayed on Edit Curve (no more bold in the work list).
Identified records are samples that they have a right number of fractions (in according with Program
configuration)
Warning, all HBA1C samples are identified
23
Other setting
This checkbox will allow to write something into Free Field of demographic data after a
transmission/reception to LIS. You may specify which free field, for import and export and what to write
inside the field.
- If you leave the text box blank or ‘#T’ , it will write the time of operation (in format HH:MM:SS)
- #D it will write only the date of operation (in the default format of windows)
- #N it will write Date and Time of operation (in the default format of windows)
- #F;formatstring it will write Date and Time of operation conform to specific string (example
YYYDDMM)
- FreeText it will write a specific text (example ‘Tx to Lis’)
This button open a new windows for the setting of Free Field transmission commands (the command usable
are the same of ‘Additional field transmission’ setting).
Leave blank to send records content or OFF to send empty field.
24
APPENDIX 1
Analysis program codes
Codice_prog Intest
# ß2 Transferrine Electrophoresis
$ Protein Electrophoresis
@ HbA1c
0 Urin Electrophoresis
1 CSF ISOFOCUSING Electrophoresis
2 Hemoglobin Neonatal Electrophoresis
3 Urin Electrophoresis
4 Protein Electrophoresis
5 Protein Electrophoresis
6 Protein Electrophoresis
7 Hemoglobin Cord Bloods Electrophoresis
8 CSF Electrophoresis
9 IF Penta
A High Resolution Electrophoresis
B High Resolution Electrophoresis
C Protein Electrophoresis
D Protein Electrophoresis
E Protein Electrophoresis
F Protein Electrophoresis
H HDL Cholesterol Quantification
I ISO-LDH Electrophoresis
J Protein Electrophoresis
K High Resolution Electrophoresis
L Lipoprotein Electrophoresis
M ISO-PAL Electrophoresis
N Transferrin isoforms electrophoresis
O CSF Electrophoresis
P Urinary Protein Electrophoresis
Q ISO-CK Electrophoresis
R High Resolution Electrophoresis
S Protein Electrophoresis
T Hemoglobin Electrophoresis
U Urinary Protein Electrophoresis
V Hemoglobin Electrophoresis
W Urine Electrophoresis
X Sebia Test Pattern
Y Total Protein
Z IF/Bence Jones
25
APPENDIX 2
Connector pin assignment
The output is compatible V 24 and RS 232C from one asymmetric 9 pin male connector (db9 connector or
COM port) located at the back of the PC.
Note:
26
APPENDIX 3
CRC CALCULATION (in C language)
The CRC is calculated from the following table_CRC_16 which is a table of 256 uint (unsigned integer)
{
0x0000, 0xC1C0, 0x81C1, 0x4001, 0x01C3, 0xC003, 0x8002, 0x41C2,
0x01C6, 0xC006, 0x8007, 0x41C7, 0x0005, 0xC1C5, 0x81C4, 0x4004,
0x01CC, 0xC00C, 0x800D, 0x41CD, 0x000F, 0xC1CF, 0x81CE, 0x400E,
0x000A, 0xC1CA, 0x81CB, 0x400B, 0x01C9, 0xC009, 0x8008, 0x41C8,
0x01D8, 0xC018, 0x8019, 0x41D9, 0x001B, 0xC1DB, 0x81DA, 0x401A,
0x001E, 0xC1DE, 0x81DF, 0x401F, 0x01DD, 0xC01D, 0x801C, 0x41DC,
0x0014, 0xC1D4, 0x81D5, 0x4015, 0x01D7, 0xC017, 0x8016, 0x41D6,
0x01D2, 0xC012, 0x8013, 0x41D3, 0x0011, 0xC1D1, 0x81D0, 0x4010,
0x01F0, 0xC030, 0x8031, 0x41F1, 0x0033, 0xC1F3, 0x81F2, 0x4032,
0x0036, 0xC1F6, 0x81F7, 0x4037, 0x01F5, 0xC035, 0x8034, 0x41F4,
0x003C, 0xC1FC, 0x81FD, 0x403D, 0x01FF, 0xC03F, 0x803E, 0x41FE,
0x01FA, 0xC03A, 0x803B, 0x41FB, 0x0039, 0xC1F9, 0x81F8, 0x4038,
0x0028, 0xC1E8, 0x81E9, 0x4029, 0x01EB, 0xC02B, 0x802A, 0x41EA,
0x01EE, 0xC02E, 0x802F, 0x41EF, 0x002D, 0xC1ED, 0x81EC, 0x402C,
0x01E4, 0xC024, 0x8025, 0x41E5, 0x0027, 0xC1E7, 0x81E6, 0x4026,
0x0022, 0xC1E2, 0x81E3, 0x4023, 0x01E1, 0xC021, 0x8020, 0x41E0,
0x01A0, 0xC060, 0x8061, 0x41A1, 0x0063, 0xC1A3, 0x81A2, 0x4062,
0x0066, 0xC1A6, 0x81A7, 0x4067, 0x01A5, 0xC065, 0x8064, 0x41A4,
0x006C, 0xC1AC, 0x81AD, 0x406D, 0x01AF, 0xC06F, 0x806E, 0x41AE,
0x01AA, 0xC06A, 0x806B, 0x41AB, 0x0069, 0xC1A9, 0x81A8, 0x4068,
0x0078, 0xC1B8, 0x81B9, 0x4079, 0x01BB, 0xC07B, 0x807A, 0x41BA,
0x01BE, 0xC07E, 0x807F, 0x41BF, 0x007D, 0xC1BD, 0x81BC, 0x407C,
0x01B4, 0xC074, 0x8075, 0x41B5, 0x0077, 0xC1B7, 0x81B6, 0x4076,
0x0072, 0xC1B2, 0x81B3, 0x4073, 0x01B1, 0xC071, 0x8070, 0x41B0,
0x0050, 0xC190, 0x8191, 0x4051, 0x0193, 0xC053, 0x8052, 0x4192,
0x0196, 0xC056, 0x8057, 0x4197, 0x0055, 0xC195, 0x8194, 0x4054,
0x019C, 0xC05C, 0x805D, 0x419D, 0x005F, 0xC19F, 0x819E, 0x405E,
0x005A, 0xC19A, 0x819B, 0x405B, 0x0199, 0xC059, 0x8058, 0x4198,
0x0188, 0xC048, 0x8049, 0x4189, 0x004B, 0xC18B, 0x818A, 0x404A,
0x004E, 0xC18E, 0x818F, 0x404F, 0x018D, 0xC04D, 0x804C, 0x418C,
0x0044, 0xC184, 0x8185, 0x4045, 0x0187, 0xC047, 0x8046, 0x4186,
0x0182, 0xC042, 0x8043, 0x4183, 0x0041, 0xC181, 0x8180, 0x4040,
};
CRC=0;
for (Loop=0;Loop<NbBytes;Loop++)
CRC=( ( CRC << 8 ) ^ Table_CRC_16[ (CRC >> 8 ) ^ Buffer[Loop] ] ); return(CRC);
}
27
APPENDIX 4
Optional Flags transmission
This option allows alarm flags transmission. The optional field has fixed length of 23 chars:
1-10 chars Flag for value % of Fraction 1 to 10 (one char for fraction)
11-20 chars Flag for value concentration of Fraction 1 to 10 (one char for fraction)
21 char Flag of Total Protein concentration
22 char Flag of Rapport Rapp1 (A/G for protein EPH)
23 char Flag of Rapport Rapp2
It is possible to set-up chars of the flags by 3 values under [PHORESIS] section of HOST.INI:
FLAG_LOW= define the char used for Low (default 'L')
FLAG_NORMAL= define the char used for Normal (default 'N')
FLAG_HIGH= define the char used for High (default 'H')
Warning will be used only one char (the first) of the string
Item FLAG_MODE under [PHORESIS] section of HOST.INI is used to store the Normal Range:
FLAG_MODE=0 Normal Range from Section NORMAL in HOST.INI
FLAG_MODE=1 Normal Range from Phoresis Config (not yet available)
Note:
If you use NORMAL section in HOST.INI (see below), the normal range will search by Name of
Fraction.
Section [NORMAL], in HOST.INI is used to store the normal value of Fraction, PT and Rapport, usable by
Optional Field Flag:
Where:
P the code Program (example J for Protein(e)6)
n fraction index (1 to 10)
Name Name of fraction (example 'Albumin' or ‘Albumine’, based on the user's language)
Min low value of normal range, use . as separator (Es: 5.6)
Max high value of normal range, use . as separator (Es: 34.63)
28
APPENDIX 5
IF IMAGE TRANSMISSION
WARNING! This option is valid only for file transfer via network connections.
This option permits to transfer the IF image of the attached card. For each image stored in the attached card,
host module will create a file on the network path (same path used by result file). These files have JPEG
extension and they are created by following format:
PYYYYMMDDNNNNNID.jpg
where:
APPENDIX 6
ELP IMAGE TRANSMISSION
WARNING! This option is valid only for file transfer via network connections.
This option permit to transfer the mathematical rebuild of the ELP image calculated from points of the curve.
With [Config…] button is possible to select parameters of image rebuilding and format of file:
For each records with curve will be created a file on the network path (with the result file). Thess files have
JPEG or BMP extensions and they are created by following format:
PYYYYMMDDNNNNNID.jpg/.bmp
where:
29
APPENDIX 7
ATTACHED CARD DATA IMPORT
(Active from Rel 4.4.4 of Host Module)
WARNING! This option is valid only for file transfer via network connections.
The attached card is created to storage of IF image but also it allows you to store 24 values of specific's
protein dosage and an extended comment (32000 characters formatted RichText).
The 24 values can be entered manually. You can also customize the names of the 24 values based
on customer needs.
WARNING the 24 names are common to all programs of analysis and to all records in the database
The option to 'Import data in the card' is used to fill these 24 fields during the acquisition phase of
demographic data.
The LIS will provide a second file containing the references of the patient (Sequence Number, Analysis
Program, ID / Barcode and date of sampling) and the values of specific proteins.
30
SETTING BY HOST.INI
The configuration parameters are only HOST.INI editing in the section [PHORESIS]:
[PHORESIS]
FILE_CARD=SPEC.DAT
VAL1=IgG
VAL2=IgM
VAL3=IgK
..
VAL24=K/L
FORCE_SEQUENCE=0
FILE_CARD This entry indicates the name of the file that contains the records of specific proteins. The file
must be located in the network path (with two files of demographic data).
VAL1-VAL24 These 24 entries allow the mapping between the codes of the LIS and the values of the card.
The codes are alphanumeric for 5 chars long. It is not mandatory to configure all 24 values.
FORCE_SEQUENCE Setting it to '1' to import data by position instead of ID / Barcode. When it is set to '0',
the data are imported for ID.
RECORD STRUCTURE
This header is followed by a variable number (between 1 to 24) of couples ‘code / value’. The code is 5 chars
and the Value is 15 chars long (Warning only first 10 chars of value are imported).
Each record will have a variable length from a minimum of 30 chars (no value) and a maximum of 510 chars
(24 values).
31
APPENDIX 8
HBA1C PROGRAM DETAIL
(Active from Rel. 5.6.1 of Host Module)
Host Module exported data of HbA1c correctly only from Rel. 5.6.1 and above.
The default values transmitted by Host are:
The names of primary fractions (HbA1c%, HbA1c in mmol/mol and eAG) are forced with specific labels
The fractions in concentration are forced to zero value.
The areas in percent and the areas in concentration are forced to zero value
The names of areas are null
There is a section in HOST.INI to force the names of primary fractions and activate this mode on other
programs:
[HBA1C]
PROGRAM_CODES=@ Active mode for program code(default '@')
NAME_%CAL=HbA1c% Force Name of HbA1c % Cal (default HBA1C%)
NAME_MMOL/MOL=HbA1c# Force Name of HbA1c mmol/mol (default HBA1C#)
NAME_EAG=eAG Force Name of eAG (default AEG)
32
APPENDIX 9
Enable additional field transmission settings
(Optional field are active from Rel. 5.2.5 of Host Module, configuration windows from Rel. 5.6.9)
From Rel. 5.6.9 this optional field of PhoresisExtended have a specific windows for settings.
Each of the 40 fields are configurable by a simple dropdown list with help online.
The windows store initial setting before user editing. Button ‘OK’ save se ne setting in Host Module
configuration and close the windows, ‘Cancel’ discard all setting and close the windows, ‘Reset to original’
discard user settings and reload initial configuration.
33
Empty command disable the field (will be send to host 15 space characters), the commands list are:
VAL1/VAL24 :Send data for the specific protein (1 to 24) stored in Patient Card. Valide parameters
are:
- Value to send content of the field (example ‘trace’)
- Name to send the label of the specific protein (example ‘IgG’)
- Min and/or Max to send value of normal range (example ‘5.16’)
- Unit to send unit of value (example ‘mg/dl’)
Remember that all parameters different from ‘Value’ are stored in PHORESYS.INI files)
NFLAGRAPP1 :Send normal flags for Rapport1 (A/G), valid parameters are
‘LowFalg,NormalFlag,HighFlag’ for example: ‘+,=,-‘
NFLAGRAPP2 :Send normal flags for Rapport1 (A/G), valid parameters are
LowFalg,NormalFlag,HighFlag’ for example: ‘+,=,-‘
NFLAGPT :Send normal flags for Concentration value (TP), valid parameters are
‘NormalFlag,HighFlag’ for example: <,=,>
NFLAG# :Send normal flags for fraction in concentration, valid parameters are
‘Name Of Fraction,LowFlag,NormalFlag,HighFlag’ for example ‘Albumin,L,N,H’
NFLAG% :Send normal flags for fraction in concentration, valid parameters are
‘Name Of Fraction,LowFlag,NormalFlag,HighFlag’ for example ‘Albumin,L,N,H’
HB_FLAG :Send the Type of Pathological Profile for the HbA1c test.
EXTRAFIELD :Extract value of specific tag from 'Extrafield' in record DB, the parameter is the name of
the tag, for example 'OriginalBarcodeRack'
TEXT :Send a fix text configured in the parameter for example 'TX'
OS-ENVIRON :Send specific enviroment variable of MSWindows, the parameter is the name of the
enviroment variable for example 'COMPUTERNAME'.
#TABLENAME :Send content of the specified Field of the Database in the specified Table. The
parameter is the name of the Field, for example 'State'.
34
APPENDIX 10
PhoresisExtended advanced settings
(Advanced settings windows are active from Rel. Rel. 5.6.9)
This button open a new windows for configure advanced settings of PhoresisExtended protocol.
In this first release is possible to set command to send some additional information over Free Fields.
Empty command disable the overaid of the field (will be send the content of Free field in DB), the commands
list are:
NFLAGRAPP1 :Send normal flags for Rapport1 (A/G), valid parameters are
‘LowFalg,NormalFlag,HighFlag’ for example: ‘+,=,-‘
NFLAGRAPP2 :Send normal flags for Rapport1 (A/G), valid parameters are
LowFalg,NormalFlag,HighFlag’ for example: ‘+,=,-‘
NFLAGPT :Send normal flags for Concentration value (TP), valid parameters are
‘NormalFlag,HighFlag’ for example: <,=,>
NFLAG# :Send normal flags for fraction in concentration, valid parameters are
‘Name Of Fraction,LowFlag,NormalFlag,HighFlag’ for example ‘Albumin,L,N,H’
NFLAG% :Send normal flags for fraction in concentration, valid parameters are
‘Name Of Fraction,LowFlag,NormalFlag,HighFlag’ for example ‘Albumin,L,N,H’
HB_FLAG :Send the Type of Pathological Profile for the HbA1c test.
EXTRAFIELD :Extract value of specific tag from 'Extrafield' in record DB, the parameter is the name of
the tag, for example 'OriginalBarcodeRack'
35
TEXT :Send a fix text configured in the parameter for example 'TX'
OS-ENVIRON :Send specific enviroment variable of MSWindows, the parameter is the name of the
enviroment variable for example 'COMPUTERNAME'.
36
APPENDIX 11
HB NEONATAL DETAIL
(Active from Rel. 5.6.1 of Host Module)
Host Module can export data of Hb Neonatal but this analisys have some specific flag/data:
Segment Barcode
Punch Date
Sample Data
Hb Pattern
Interpretation of ratio.
This could be send using Additional field transmission. In the configuration windows you could set this as in
the picture:
This commads could to send a specific Field of the table ‘ANAGRAFICA’ in the database. For example
#ANAGRAFICA;SAMPLE_INFO is the field ‘Sample_Info’ of the table ‘Anagrafica’ that store the ‘sample
Data’ column in the worklist.
WARNING: Interpretation of Ratio (HBINFO field) actually are send in coded format.
37