BDI 2.0 Manual
BDI 2.0 Manual
0 Manual
BM800/BM850 Data Interface
Boule Medical AB Domnarvsgatan 4 SE-163 53 Spånga, Sweden Phone +46 8 744 77 00, Fax +46 8 744 77 20, E-mail: [email protected]
Contents
1. Introduction ..................................................................................................................................................................3
2. Requirements ...............................................................................................................................................................3
3. Installation ...................................................................................................................................................................3
4. Windows Environment ................................................................................................................................................3
5. Typical Configurations BM800 ...................................................................................................................................4
6. Typical Configurations BM850 ...................................................................................................................................6
7. Main Program Window................................................................................................................................................7
8. Settings Window ..........................................................................................................................................................8
9. Output Files..................................................................................................................................................................9
10. Transferred Data ..........................................................................................................................................................9
11. Parameters .................................................................................................................................................................. 10
11.1. Static Instrument Parameters ........................................................................................................................... 10
11.2. Instrument Configuration Parameters .............................................................................................................. 10
11.3. Sample Identification Parameter Values.......................................................................................................... 10
11.4. Aspiration Parameters...................................................................................................................................... 11
11.5. Differentiation – White Cells........................................................................................................................... 12
11.6. Control Blood with Reference Ranges ............................................................................................................ 12
11.7. Settings ............................................................................................................................................................ 12
11.8. Reagent statistics ............................................................................................................................................. 13
11.9. Sample Result Parameter Values ..................................................................................................................... 15
12. Limitations and Requirements ................................................................................................................................... 17
13. FAQ ........................................................................................................................................................................... 18
CENTURI 13241-3 2
1. Introduction
BM800/BM850 (BM8xx) Data Interface (BDI) is intended for transferring data from BM8xx instrument to PC or as a
sample data interface between BM8xx and LIS systems.
Features
- Transfer data from BM8xx (USB, RS232) to PC (USB, RS232)
- Parse sample data from files
- Supports multiple channels / instruments (hardware dependent)
- Selectable parameters
- Outputs data to xml, Excel (via stylesheets) and txt (TAB separated data)
- Validation of transferred data
2. Requirements
- PC with USB and/or RS232 ports
- Windows 7/8
- .NET 4.5
3. Installation
See Installation Instructions (included in the zip-file)
NOTE 1 This manual refers to version 2.0 of BDI software. Future revision changes could make this information
obsolete. Only use the manual that was included in the installed software package.
NOTE 2 Always set Serial Output Setup - Send with Ack to enabled according to section 5 in order to ensure safe data
transfer between BM8xx and PC (See section 4).
4. Windows Environment
Program Location: Setup will create a shortcut to the program in the start menu.
CENTURI 13241-3 3
5. Typical Configurations BM800
OR
A single BM800 is connected to PC via Instrument USB host – RS232/USB adapter – PC COM port (RS232)
1. Connect BM800 to an available COM port on PC (note which number this port have in the PC manual)
2. Configure BM800 communications settings as follows
CENTURI 13241-3 4
A single BM8xx is connected to PC via USB port
1. Connect BM8xx to USB device port on PC (see image above for position)
2. Install USB drivers (see Installation documentation, included in the zip file)
3. Configure both BM8xx communications settings as follows
CENTURI 13241-3 5
6. Typical Configurations BM850
1. Connect BM850 to USB device port on PC (see image above for position)
2. Install USB drivers (see Installation documentation, included in the zip file)
3. On BM850, enable “Send by USB-to-USB” in Export Target screen.
4. On BM850, enable “Send with Ack” in Export Setup screen.
CENTURI 13241-3 6
7. Main Program Window
Connection / Data Log Displays configured connections and status. This text box can also be
configured to display real-time status of parsed sample data.
File - Open File Opens a file (BM8xx data stored on USB memory) to parse data.
Tools - Restart Channel Restarts a single channel (only communication is restarted, not BM8xx).
Tools - Restart All Channels Restarts all channels (only communication is restarted, not BM8xx).
Tools - Datalog / No Datalog Select if parse information for current sample shall be displayed in the
Connection / Data Log window.
CENTURI 13241-3 7
8. Settings Window
Instrument Connection Select com port (RS232 or virtual via BM8xx driver)
Sample Data / Transferred data Select which parameters to be parsed and stored on file. This is a global
setting affecting all channels.
CENTURI 13241-3 8
9. Output Files
BDI 2 have a fixed output set containing xml, xsl (for Excel) and txt files.
XML - Format Description All transferred samples are stored in a single .xml file. A new file is
created each day.
XLS - Format Description Use this file to import xml data into Excel by dragging the xml file to
Excel and the select to import the file with the style sheet (the dialog will
be shown automatically). A new xls file is created for each sample.
TXT - Format Description Each .txt file contains a single sample in TAB separated format. One
parameter for each row.
Note: All received parameters are always included in both the xml and the txt files. This selection only affect the style
sheet that will make corresponding visible in Excel. If setting is changed and new files are generated in the same output
directory that will affect visible parameters when old files are opened in Excel! Both for added and removed
parameters”
CENTURI 13241-3 9
11. Parameters
Note 1: Non-numeric characters are allowed. Leading or trailing white space will be filtered away.
Note 2: Non-ASCII characters may be used.
Note 3: All control blood sample ID:s are a number followed by a trailing "+". (The number is normally
the digits of the lot number of the control blood.)
Note 4: Leading zero digits in ID numbers are significant.
Note 5: The maximum number of characters in ID numbers may change.
Note 1: SEQ numbers are not unique in samples from one instrument. The operator can set the sequence
number of the next sample, and sequence numbers wraps around.
Note 2: The upper limit of sequence numbers may change.
Example: 2004-05-06T07:08:09
CENTURI 13241-3 10
11.3.4 SORC – Sample or Control
SORC indicates if it is a normal sample run or a control sample run. This parameter is always present with a
value.
Note 1: More sample or control types may be added. They will all be small positive numbers.
Note: the parameter BLNK indicates if the sample actually was a blank sample.
Note: The definition of a blank is RBC < 0,50 and HGB < 2,0 (below approx 15% of a normal human blood
sample).
CENTURI 13241-3 11
11.5. Differentiation – White Cells
The BM8xx instrument has several different methods to separate the complete WBC population into three
subpopulations: LYM, MID , GRAN (in increasing size order). The instrument configuration allows or disallows
selection of the different WBC diff methods.
Note 1: more diff methods may be added. They will all be small positive numbers.
Note 1: The unique ID number is normally the digits from the control blood lot number followed by a plus
(+) sign. Example: lot number “0606-123” gets the ID number “0606123+”.
Note 2: Leading zero digits in control blood ID numbers are significant.
Note 1: This information comes from the control blood reference range assay information.
Note 2: The control blood level is also present as a name in the parameter APNA (see 9.9.2)
The value is a date, always formatted according to ISO 8601. See example below.
Note: This information comes from the control blood reference range assay information.
Example: 2005-03-09
11.7. Settings
CENTURI 13241-3 12
11.8. Reagent statistics
The BM8xx instrument has an optional reagent statistics system that keeps track of the reagents used in the
instrument.
Note: The diluent and hemolyzing regent information is exactly the same if a reagent “combo” pack is used.
The value is always formatted as “YYMM-NNN”, where YY, MM and NNN are digits. (Normally YY =
production year, MM =production month and NNN = lot sequence number.) See example below.
Example: 0606-123
The value is a date, always formatted according to ISO 8601. See example below.
Example: 2006-06-29
The value is always formatted as “YYMM-NNN”, where YY, MM and NNN are digits. (Normally YY =
production year, MM =production month and NNN = lot sequence number.) See example below.
Example: 0606-124
The value is a date, always formatted according to ISO 8601. See example below.
Example: 2006-06-29
CENTURI 13241-3 13
11.8.5 RCLI Reagent Statistics Cleaner Lot identifier
RCLI is the lot identifier of the cleaning reagent. This parameter is optional, and may be present in vet instruments.
The value is only present if the reagent statistics system is enabled.
The value is always formatted as “YYMM-NNN”, where YY, MM and NNN are digits. (Normally YY =
production year, MM =production month and NNN = lot sequence number.) See example below.
Example: 0606-125
The value is a date, always formatted according to ISO 8601. See example below.
Example: 2006-06-29
CENTURI 13241-3 14
11.9. Sample Result Parameter Values
Sample result parameter values are the measured and calculated hematology parameters from a sample run.
The parameter order below is not fixed. The parameters might be in another order. Parameter definitions may be
added or removed with new software releases.
CENTURI 13241-3 15
11.9.2 Result Parameter Format
For each parameter a set of 5 values are present
A result parameter always has a Parameter name and a normal / reference range (ParamaterName_L,
ParamaterName_H) . It could also have a value (ParamaterName) or an out-of range (ParamaterName_O)
flag, and an error flag (ParamaterName_F).
PLT 3
PLT_L 0
PLT_H 10
PLT_F
PLT_O
The value range and the number of decimals depend of the parameter.
The parameter value and out of range value are mutually exclusive. A value is either not calculated (neither "value"
nor "out of range value", calculated ("value" only), or “out-of-range " only.
The " ParameterName_O " flag can take the values "H" (value too high) or "L" (value too low).
The " ParameterName_O " and " ParameterName" values are mutually exclusive. A value is either not calculated
(neither " ParameterName " nor " ParameterName_O "), calculated ("ParameterName" only), or out-of-range
("ParameterName_O " only).
The error flag is always two upper-case letters, or one upper-case letter followed by a digit. The list of possible flags
are not included here.
Note: Only these parameters can have an error flag: RBC, MCV, PLT, HGB, WBC, LYM, MID, GRAN.
CENTURI 13241-3 16
11.9.7 Parameter Normal/Reference Range High
The "ParameterName_H" tag is always present. Its value is the high end of the normal / reference range. If the
parameter value is exactly equal to " ParameterName_H", then it is within the normal / reference range.
BM8xx ‘Send with Ack’ must be set to active for proper data transfer (NOTE! If “Send with Ack” is not set
sample data could be lost without any warnings.
If a sample have been lost and “Send with Ack” is activated, the error will be indicated by BM8xx (A beep and a
Serial Output Alarm, no further samples will be sent until the issue is acknowledged manually).
All BM8xx sample data must be deleted manually by user input on the instrument. BDI does not change any data
or settings on the instrument.
CENTURI 13241-3 17
13. FAQ
BDI validates received data. All data that fails validation will be discarded. BDI signals BM8xx if a sample has been
transferred successfully by transmitting an acknowledge message. If Send with Ack is not set on BM8xx there is no
possibility for BM8xx to acknowledge that a sample needs to be re-transmitted.
2. Ensure that the computer meets stated requirements / Ensure that no unnecessary programs/services are
running on the computer.
BM8xx will timeout within 5 seconds after a sample is sent. If the computer is too slow, it may not allow for
validation and parsing within this time frame. It is also possible to increase the timeout period, see the instrument
user manual.
Connected via RS232: You need to know which COM port connects to a physical port. One way to resolve this is to:
1. Use Settings -> Selected Port to select a COM port and click button ‘Save’.
2. If the program successfully connects to an instrument the serial number will be shown in the connection log. If
the connection fails serial number will be shown as N/A in the connection log. Retry with another COM port.
I disconnected the USB cable and now the program does not work
1. Click Tools -> Restart All Channels.
2. Remove and re insert USB cable at PC end.
3. Click Tools -> Restart All Channels.
4. Check the “Connection / Data Log” text box in main window to see if connection is on-line
If above 4 steps does not work close the application and restart.
(BM800) Ensure that the instrument is set to same VID/PID as used when installed the drivers.
(BM850) Try setting BM800 compatibility to “Enabled”
I sent the same sample twice but only one was transferred?
BDI will ignore the second sample for the xml file if two consecutive samples have the same sequence number and
Sample ID.
CENTURI 13241-3 18
CENTURI 13241-3 19