DataCaptor Device Interface Help

Roche Diagnostics Hitachi 917

DDI name: RocheA.dll

Calling a method to store Test Selection Information

The SendCommand() method sends Test Selection Information to the DDI. The DDI stores all test selection information, so when
the Hitachi device asks for information, the DDI may reply to it if the information has been stored. Test Selection Information
indicates what tests are to be made by the device on a given sample. A sample is referenced by an identification number when the
bar-code reader is used and by sample, disk and position numbers otherwise.
NOTE: You can download a sample VB program demonstrating the use of the SendCommand() method with the Hitachi 917.

The SendCommand() method

Syntax: SendCommand DeviceHandle, Command, Parameter

DeviceHandle: String, device ID relative to the DDI you want to communicate with.
Command: Integer. Parameter: String.

Command Parameter Meaning

Clear all Test Selection list in the
0 Empty
DDI
Test Selection Send a Test Selection
1
Information (1) Information to the DDI

(1) Format of Test Selection Information:

All data fields are ended by a carriage return (ASCII value 10). Any field may be empty except ChannelCount and TestRequest,
which are mandatory.
You will only have to give values to Ident No (Hitachi in barcode read mode), or Sample No, Disk No, Position No (Hitachi not
in barcode read mode).
To cancel all tests for a particular sample, ChannelCount must be 88 and TestRequest must be Filled with 88 zeroes. For
performance and memory consumption reasons, it is better to clear the test selection list when the device has finished the tests and
the test selections do not apply anymore. When switching the device between barcode read mode and non-barcode read mode,
clear the test selection list because some test selections when applied to a given mode could be erroneously applied to the other
mode.

Max
Field Type Description
Length
Sample
Numeric 5
No
Disk No Numeric 5
Position
Numeric 3
No
Sample
Numeric 1
Cup
Ident No String 13
AAAC (C=unit: 1=day, 2=month,
Age Numeric 4
3=year). Currently not used.
0=none, 1=male, 2=female. Currently
Sex Numeric 1
not used.
Date Numeric 6 MMDDYY. Currently not used.
Time Numeric 4 HHMM. Currently not used.
Channel Number of channels in Test Request,
Numeric 3
Count max: 88. Mandatory
Test
Numeric 88 0 to 4 for each character. Mandatory
Request

Example: “1\n1\n2\n1\n\n\n\n\n\n3\n114\n”
“\n\n\n\n000480\n\n\n\n\n2\n01\n”

Retrieving data from Hitachi 917

VarIds 464 (Frame Type) and 178 (Sample Type) indicate the start of a data frame.
It is important to know the type of a data frame, since varIds variables are not specific to a particular frame, and their meaning is
sometimes determined by the frame.
Sample Type value gives the type of data that follows, except for Test Selection Information: In this case, Frame Type is character
‘;’.
The data frames for photometry assay calibration, ISE calibration, channel assignment, contains vectorized data: the same variable
is used to contain several values. Sometimes the number of values is implied, sometimes the number is given by a variable.
The 917 analyzer does not return units of values or ranges of values.

Result Data

The more important and common data frame is the Result Data frame. The Hitachi 917 returns a result for each of the 100 possible
tests applied to a given sample. Not all the tests are made, it depends on the Test Selection Information associated to a given
sample.
There is one variable for each test result, and one variable for each alarm associated to a test. Sample Type is ‘A’ to ‘E’ when a
barcode reader is used, each sample is referenced by its identification number. Sample Type is ‘N’ to ‘R’ when the barcode reader
is not used, each sample is referenced by a sample, a disk, and a position number.

Sample Sample Type

Routine sample A
Routine sample automatic rerun B
Routine sample manual rerun C
Stat sample D
Stat sample automatic rerun E
Control sample F
Routine sample (without id) N
Routine sample automatic rerun (without id) O
Routine sample manual rerun (without id) P
Stat sample (without id) Q
Stat sample automatic rerun (without id) R

VarId 185: test no1, varId 284: test no100.

VarId 285: test alarm no1, varId 384: test alarm no100.

VarId Type Label

164 Number Sample No
165 Number Disk No
166 Number Position No
167 Number Sample Cup
168 String Ident No
169 Number Age
170 Number Sex
171 String Date
172 String Time
173 String Op Id
174 Number Test Count
178 String Sample Type: one of A, B, C, D, E
397 String Comment1
398 String Comment2
399 String Comment3
400 String Comment4
401 String Comment5
464 String Frame Type: one of 1,2,3,4,5,:
185 to 284 Number Result for Test No 1 to Test Count
285 to 384 String Data alarm for Test No 1 to Test Count
F, N, O, P, Q, R

Photometry Assay Calibration Data

Values of varIds 179,180,181,182,177,183 are repeated several times. Number of times is given by varId 174.

VarId Type Label

173 String Op Id
Number of standards: Num x
174 Number
179,180,181,182,177,183
175 Number Channel No
177 Number Alarm
177 String Data alarm
178 String Sample Type: G
179 Number 1st absorbtion data
180 Number 1st initial abs data
181 Number 2nd absorbtion data
182 Number 2nd initial abs data
183 String Prozone value
184 Number Sd value
464 String Frame Type: one of 1,2,3,4,5,:

ISE Calibration Data

Values of varIds 387,388, 389, 390, 391, 392, 393, 394 are repeated three times.
First time for Na, second for K, third for Ca. Values of varId 177 are repeated as three series of nine values.
First series applies to Na, second to K, third to Ca.

The following table shows the meaning of each varId in the sent sequence.

VarId Type Label

173 String Op Id
177 String Data alarm Na
177 String Alarm x 8
177 String Data alarm K
177 String Alarm x 8
177 String Data alarm Ci
177 String Alarm x 8
178 String Sample Type: H
385 String ISE type
387 Number Electromotive f.int.std
387 Number Electromotive f.int.std
387 Number Electromotive f.int.std
388 Number Electromotive f.low
388 Number Electromotive f.low
388 Number Electromotive f.low
389 Number Electromotive f.high
389 Number Electromotive f.high
389 Number Electromotive f.high
390 Number Electromotive f.m
390 Number Electromotive f.m
390 Number Electromotive f.m
391 Number Slope level disp
391 Number Slope level disp
391 Number Slope level disp
392 Number Concent.int.std
392 Number Concent.int.std
392 Number Concent.int.std
393 Number Concent.M
393 Number Concent.M
393 Number Concent.M
394 Number Compens.Factor
394 Number Compens.Factor
394 Number Compens.Factor
464 String Frame Type: one of 1,2,3,4,5,:

Channel Assignment Information

Values of varId 396 are repeated several times. Number of times is given by varId 174.

VarId Type Label

178 String Sample Type: X
174 Number Channel count: Num x 396
395 Number Start channel number
396 Number Value of application code for each channel
464 String Frame Type: one of 1,2,3,4,5,:

Test Selection Information

VarId Type Label

164 Number Sample No
165 Number Disk No
166 Number Position No
167 Number Sample Cup
168 String Ident No
169 Number Age
170 Number Sex
171 String Date
172 String Time
174 Number Number of tests
178 String Sample Type: one of A,B,C,D,N,O,P
397 String Tests Request. 0 to 4 for each character
464 String Frame Type: ;

See also Unit Codes.

Wiring
The following charts and diagrams refer to the cable necessary and its connectors.

Connection with hardware handshake

HIT 917 (DTE) end Wire HOST (DCE) end

Number Number
Name Name Number (DB25)
(DB9 male) (DB9)
DCD Pin 1 to 6 DCD Pin 1 to 6 Pin 8 to 6
RxD Pin 2 TxD Pin 3 Pin 2
TxD Pin 3 RxD Pin 2 Pin 3
DTR Pin 4 DSR Pin 6 Pin 6
SG Pin 5 SG Pin 5 Pin 7
DSR Pin 6 DTR Pin 4 Pin 20
RTS Pin 7 CTS Pin 8 Pin 5
CTS Pin 8 RTS Pin 7 Pin 4

DB9 to DB9

DB9 to DB25

Connection without hardware handshake

HIT 917 (DTE) end Wire HOST (DCE) end

Number Number
Name Name Number (DB25)
(DB9 male) (DB9)
RxD Pin 2 TxD Pin 3 Pin 2
TxD Pin 3 RxD Pin 2 Pin 3
CTS Pin 8 to 7 RTS Pin 7 to 8 Pin 4 to 5
RTS Pin 7 CTS Pin 8 Pin 5
DSR Pin 6 to 4 DTR Pin 4 to 6 Pin 20 to 6
DTR Pin 4 DSR Pin 6 Pin 6
SG Pin 5 SG Pin 5 Pin 7

DB9 to DB9
DB9 to DB25

(Source: Roche)

For testing purposes the VB Hitachi App is recommended for this device.