Zephyr BioHarness User manual

BioHarness Bluetooth Developer Kit
User Manual

BioHarness Bluetooth Developer Kit User Manual
Page 2
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
Contact
Contacts
Mail: Zephyr Technology Corp. 1 Annapolis St., Suite 200, Annapolis MD 21401
Email: [e-mail]
[e-mail]
[e-mail]
Web: www.zephyr-technology.com
Phone: [phone]
Fax: [phone]
Document History
Version
Date
Description
1.0 1 May 2008 Initial draft for review
1.1 7 May 2008 Data Descriptions section revised
1.2 4 June 2008 Add Troubleshoot Section
1.3 16 Sept 2008 New Test App GUI added
1.4 29 Oct 2008 BlueSoleil Version note
1.5 20 Nov 2008 Update to v1.2.0.0 of Test App grabs
1.6 23 Feb 2009 Update Test App. executable name
Added ZPNs
1.7 9 June 2009 Clarify device RF/Log configuration throughout
1.8 28 Jan 2010 Add BT Config Tool
1.9 16 Mar 2010 Add new LED behaviour. Update data descriptions.
1.10 29 April 2010 Add ROG status behaviour
1.11 27 May 2010 Add Button Worn explanation
1.12 2 June 2010 Amend Refs to BT Comms Link doc, BT Logging
Interface
Document Notes
All numbers in this document are written in decimal, except hexadecimal numbers which are
prefixed by ‘0x’. For example 5436 is decimal, while 0x5436 is hexadecimal.
The information in this document is believed to be accurate in all respects at the time of publication but is subject to
change without notice. Zephyr Technology assumes no responsibility for errors or omissions, and disclaims responsibility
for any consequences resulting from the use of information included herein. Additionally, Zephyr Technology assumes no
responsibility for the functioning of undescribed features or parameters. Zephyr Technology does not assume any liability
arising out of the application or use of any product, and specifically disclaims any and all liability, including without
limitation consequential or incidental damages.
Zephyr Technology products are not designed, intended or authorised for use in applications intended to support or
sustain life, or for any application in which the failure of the Zephyr Technology product could create a situation where
personal injury or death may occur. Should Buyer purchase or use Zephyr Technology products for any such unintended
or unauthorised application, Buyer shall indemnify and hold Zephyr Technology harmless against all claims and damages.

BioHarness Bluetooth Developer Kit User Manual
Page 3
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
Contents
1. INTRODUCTION...............................................................................................................4
1.1. References......................................................................................................................4
1.2. Abbreviations...................................................................................................................4
1.3. Product Description..........................................................................................................5
1.4. Documents ......................................................................................................................6
1.4.1.BioHarness Bluetooth API Guide..............................................................................6
1.4.2.General Comms Link Specification...........................................................................6
1.5. List of Components..........................................................................................................6
2. SETUP..............................................................................................................................7
2.1. System Diagram..............................................................................................................7
2.2. Overview .........................................................................................................................7
2.3. Zephyr Software Utilities..................................................................................................8
2.3.1.Bluetooth Test Application........................................................................................8
2.3.2.BioHarness Research Application.............................................................................8
2.3.3.BioHarness BT Config Tool......................................................................................9
2.4. Installation.....................................................................................................................10
2.4.1.Zephyr USB Driver Install.......................................................................................10
2.4.2.Zephyr Hardware Install .........................................................................................11
2.4.3.Bluetooth Device Driver & Software Install..............................................................12
2.4.4..NET 3.5 Framework Install....................................................................................14
2.4.5.Zephyr Bluetooth Test App Install...........................................................................15
2.4.6.Zephyr BioHarness Application Install.....................................................................15
3. OPERATION...................................................................................................................16
3.1. Zephyr Bluetooth Test App.............................................................................................16
3.2. Zephyr BioHarness Application......................................................................................19
3.2.1.Importing Recorded Data........................................................................................20
3.2.2.Viewing Imported Data...........................................................................................21
3.2.3.Exporting Data to an External File..........................................................................21
3.3. BioHarness Device and Strap........................................................................................22
3.3.1.Components...........................................................................................................22
3.3.2.LED Behaviour.......................................................................................................23
3.3.3.LED Error States....................................................................................................23
3.4. Care & Maintenance......................................................................................................24
3.4.1.BioHarness Device:................................................................................................24
3.4.2.BioHarness Strap:..................................................................................................24
3.5. Strap Fitting & Location..................................................................................................25
4. DATA DESCRIPTIONS...................................................................................................26
4.1. Transmitted Data...........................................................................................................26
4.2. Logged Data..................................................................................................................27
5. ROG SUBJECT STATUS INDICATION...........................................................................28
5.1. ROG Threshold and Alert State Logic ............................................................................28
5.2. ROG Default Values ......................................................................................................29
6. DEVICE WORN DETECTION..........................................................................................30

BioHarness Bluetooth Developer Kit User Manual
Page 4
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
1. Introduction
1.1. References
Ref #
ID
Description
[1]
9700.0110 BioHarness Bluetooth Comms Link Specification.
[2]
9700.0027 BioHarness Bluetooth API Guide
[3]
9700.0111 BioHarness Bluetooth Logging System Interface
1.2. Abbreviations
Abbreviation
Description
ECG
E
lectro
C
ardio
G
ram
GUI
G
raphical
U
ser Interface
PC
P
ersonal
C
omputer
ISM
I
nstrument,
S
cientific &
M
edical Band (~900MHz radio frequency band)
ROG
R
ed,
O
range,
G
reen su
bject physiological status indication

BioHarness Bluetooth Developer Kit User Manual
Page 5
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
1.3. Product Description
The Zephyr BioHarness is a physiological monitoring system. The subject wears a Smart Fabric
chest strap which incorporates sensors to monitor heart ECG signals, and respiration rate.
Attached to the strap is the BioHarness Module. This contains an infra-red temperature sensor for
monitoring skin temperature, and a 3-axis accelerometer for monitoring attitude (subject posture)
and activity (acceleration).
Raw sensor data is filtered, processed and analyzed within the device, which can operate in three
modes. These modes are software configurable. The commands required to determine and set
these modes can be found in the General Comms Link Specification document (sections 5.51 Get
Bioharness User Configuration & 5.52 Set Bioharness User Configuration).
•Transmit mode
Data is transmitted by Class I Bluetooth over a 10 meter range to a corresponding Bluetooth
receiver device. This will allow physiological data to be monitored using any suitably-
configured Bluetooth mobile device, such as a laptop, phone or PDA.
A Bluetooth Test App is provided with the Developer Kit which displays transmitted data in
real time. When the Bluetooth connection is terminated, the application generates .csv files
containing the transmitted data.
•Record Mode
Data is logged to internal memory. This data can be accessed when the device is placed in
a cradle and connected via USB to a PC. A software utility (BioHarness Application) is
provided which will allow import and display of recorded data from the device. This utility will
also export recorded data to an external .csv file.
•Transmit & Record Mode
Data is transmitted and recorded simultaneously. The two utilities mentioned above are
used separately to display and record live streaming data, and download log data
afterwards.
Note: Zephyr-supplied devices are configured to simultaneously transmit and log mode. They
must be reconfigured using the BT Config Tool to disable either of these modes

BioHarness Bluetooth Developer Kit User Manual
Page 6
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
1.4. Documents
1.4.1. BioHarness Bluetooth API Guide
This document contains detailed data descriptions, and specifies which messages apply to the
Bluetooth Device
1.4.2. BioHarness Bluetooth Comms Link Specification
This document describes all Zephyr request/response messages. This is a superset of the
messages specified in the API Guide.
1.5. List of Components
The following components are included in the Developer Kit
Component Description Part No.
Hardware
Smart Fabric Chest Strap XS/S/M/L/XL sizes available 9600.0146 (XS)
9600.0116
9600.0115
9600.0114
9600.0145 (XL)
BioHarness Module 9600.0097
Bioharness Device USB Cradle 9600.0098
USB/USB-mini connector lead 0015.0003
CNet Bluetooth V2.0 USB
Adapter Kit Includes CD with Bluetooth Drivers, BlueSoleil Software & Manual
Software
Zephyr USB Driver For connection of BioHarness Device to PC
when charging or importing recorded data 9500.0003
Zephyr Bluetooth Test App Utility to display Bluetooth transmitted data 9500.0029
BioHarness BT Config Tool Utility to read device parameters and
configure device mode
IVT BlueSoleil v1.6.4.0 release
05920 Required for Bluetooth connectivity
Windows ® Installer 3.1 Required for .NET installation 9500.0024
Microsoft ® .NET 3.5 Framework Required for Zephyr Bluetooth Test App 9500.0023
Zephyr BioHarness Application Utility to access data from BioHarness
Device internal memory 9500.0021
Documents
User Manual This Manual 9700.0026
BioHarness Bluetooth API Guide Guide to implementing an API 9700.0027
BioHarness Bluetooth Comms
Link Specification 9700.0110
BioHarness Bluetooth Logging
System Interface File and data formatting for device internal memory 9700.0029

BioHarness Bluetooth Developer Kit User Manual
Page 7
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
2. Setup
2.1. System Diagram
2.2. Overview
Do not connect the Bluetooth receiver or the BioHarness Device to a PC until the relevant
driver software has been installed.
The following steps are recommended (in order) for setup and configuration of the system:
•Install Zephyr USB Driver software
•Connect BioHarness Device and cradle to PC for battery charge
•Install & Configure CNet Bluetooth Adapter Driver & IVT BlueSoleil software
•Install Microsoft ® .NET 3.5 Framework
•Copy Zephyr Bluetooth Test App
•Copy BioHarness BT Config Tool
•Install Zephyr BioHarness Application (only if recorded data import required)
BioHarness Device & Strap
Bluetooth Test App
Bluetooth Link
Bluetooth USB
Receiver

BioHarness Bluetooth Developer Kit User Manual
Page 8
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
2.3. Zephyr Software Utilities
2.3.1. Bluetooth Test Application
The Bluetooth Test App displays numerical values for the major transmitted data parameters as
well as Bluetooth connectivity data. The Bluetooth Test App should be run in conjunction with the
BlueSoleil Application supplied with the SDK; the Test App utilizes the BlueSoleil Driver files.
2.3.2. BioHarness Research Application
The BioHarness Application was originally designed for use with the 900MHz ISM BioHarness,
but can also be used to import recorded data from the Bluetooth Device, export it to an external
.csv file, and display a large number of parameters graphically.
The BioHarness Research application cannot be used to display live data. It can only be used to
import logged data from the device which has been set to logging mode.

BioHarness Bluetooth Developer Kit User Manual
Page 9
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
2.3.3. BioHarness BT Config Tool
This utility can be used to set a variety of parameters within the device:
Network ID: Default device serial #
MAC Address to Call: Hard code the MAC address of Bluetooth paired receiver
Visible in Inquiry: Make device discoverable (default Yes)
Link Timeout: Bluetooth link parameter
Lifesign Period: Bluetooth link parameter
Log Enable: Activate logging on button press
Button Enable When Worn: Allow the device to be switched off while still attached to strap
(default No – this prevents accidental switch off of device)
RF Enable: Activate transmitting on button press
Set Date/Time: Set internal clock to current PC time

BioHarness Bluetooth Developer Kit User Manual
Page 10
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
2.4. Installation
Do not connect the BioHarness Device to a PC until the driver software has been installed
2.4.1. Zephyr USB Driver Install
1. Browse the Bluetooth Developer CD, and locate the ZephyrDeviceInstaller.exe file, in the
Zephyr USB Driver folder.
2. Double-click the executable file to begin the installation process.
3. Follow the Wizard:
Click Install.
4. A dialogue will prompt to restart your PC to activate the changes.
Click Yes if you intend to connect any Zephyr hardware to the PC.

BioHarness Bluetooth Developer Kit User Manual
Page 11
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
2.4.2. Zephyr Hardware Install
The BioHarness Device is powered by a Lithium Polymer cell which is charged via a PC USB
Port. To install the hardware, simply connect to your PC in its charging cradle.
Two notification dialogues will display:
When the hardware is installed, the LED should illuminate as constant pale orange, to indicate
the Device is charging.
If the LED is green, the device may have a completely discharged internal cell (insufficient to
establish USB comms with the PC) – leave in the cradle for a few minutes, remove and replace.
The LED should illuminate pale orange.
There is no charge state indication. 90% charge will be reached in hour from fully discharged.
100% is achieved in 3 hours. The charging automatically circuit prevents over-charging.
Constant pale orange LED
indicates device is charging

BioHarness Bluetooth Developer Kit User Manual
Page 12
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
2.4.3. Bluetooth Device Driver & Software Install
Note that the software should be installed prior to the USB Dongle being inserted into a
USB port.
1. Insert the IVT Bluetooth Driver and Software CD which is included with the CNet USB
Adapter Kit.
Installation should start
automatically.
2. The BlueSoleil Application must be started before the Zephyr Bluetooth App.
Note that the Bluetooth Test Application is designed work with BlueSoleil v1.6.4.0 release
05920 (supplied with this SDK). It will not work with later versions of the BlueSoleil
Application
3. Windows Start>All Programs>IVT BlueSoleil
…or in the System Notification tray on the bottom right of the Windows Toolbar, double-
click on the Bluetooth icon.

BioHarness Bluetooth Developer Kit User Manual
Page 13
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
4. The main BlueSoleil window will be shown:
5. Insert the Bluetooth Adapter. A dialogue will display:
Enter Device Name and select Type – these labels will be used to identify your PC or
laptop to any other Bluetooth devices in the vicinity.
To ensure the Bluetooth dongle is functioning correctly, double-click on the sun icon in the middle
of the window. The display will change to identify all Bluetooth devices within range (this may take
30 seconds or so).
The Bluetooth comms are now fully functional.

BioHarness Bluetooth Developer Kit User Manual
Page 14
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
2.4.4. .NET 3.5 Framework Install
The .NET 3.5 Framework is required for the Zephyr Bluetooth Test App to operate. As a pre-
requisite, Windows ® Installer 3.1 must first be installed.
1. Browse the CD and locate the executable file WindowsInstaller-KB893803-v2-x86.exe.
Double-click and follow the Wizard.
2. Browse the CD and locate the executable file dotnetfx35.exe. Double-click and follow the
Wizard

BioHarness Bluetooth Developer Kit User Manual
Page 15
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
2.4.5. Zephyr Bluetooth Test App Install
1. Browse the CD and locate the Bluetooth Test App v1.2.0.0.exe in the Bluetooth Test
Application/Application Release Folder.
2. Copy this file to a suitable directory on your PC.
Double-click on the executable itself to run the application – there is no Installer.
2.4.6. Zephyr BioHarness Application Install
1. Browse the CD and locate the Bioharness_v2.3.0.7_setup.exe
2. Double-click and follow the Wizard to install this application.

BioHarness Bluetooth Developer Kit User Manual
Page 16
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
3. Operation
3.1. Zephyr Bluetooth Test App
Once the PC application has been copied to a suitable folder on the PC with BlueSoleil running,
double click on the executable:
The PC application has 4 main GUI components:
•Physiological and unit real-time update: provides display of the main values sent by the
BioHarness on the left of the GUI e.g. Heart Rate, Battery Voltage. Whether garment is
being worn, whether device button has been pressed. R/O/G subject status.
•Bluetooth Device List: When the “Find Devices” button is pressed, approximately 30
seconds later a list of all Bluetooth devices in range is populated.
•General Status: Gives general information on data received.
•Packet selection panel. A ticked box automatically enables the particular data packet to
be transmitted. The data will be logged as csv files which are created automatically.

BioHarness Bluetooth Developer Kit User Manual
Page 17
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
Double-click on the “Find Devices” button.
After approximately 30 seconds, all Bluetooth devices within range should be shown:
Note that for most versions of Bluetooth BioHarness the “Name” of the device will match the label
on the back of the BioHarness.
In this example, we want to connect to the unit labeled “BH ZBH001119”. Double-click on the
name:
If a request for the Passkey/Pin Code is shown, enter “1234”.

BioHarness Bluetooth Developer Kit User Manual
Page 18
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
The PC application should now start receiving data from the connected BioHarness:
While connected, the PC application writes all received data to .csv files in the same folder as the
executable so the data can be retrieved later. The files can be accessed when the PC Application
is closed using the “close” icon in the top right corner.
Close the GUI to stop communicating with the BioHarness and close the .csv files:
Note there are five files generated:
•Gen Data Packets: data with 1.008 second resolution e.g. Heart Rate, Battery Voltage.
•Br Data Packets: Breathing Waveform.
•R to R Data Packets: R to R data.
•ECG Data Packets: ECG waveform.
•Accelerometer Data Packets: X,Y & Z axis waveforms.
For more details on the data within each packet, see Section 4.

BioHarness Bluetooth Developer Kit User Manual
Page 19
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
3.2. Zephyr BioHarness Application
This application was developed for use in conjunction with the Zephyr BioHarness device which is
configured to transmit in the 900MHz ISM frequency band – not the Bluetooth device. However, it
can also be used as a utility to Import data recorded to the internal memory of a Bluetooth
BioHarness device. Some functionality, such as real-time data display, is not implemented for the
Bluetooth Device.
Note that before use the device must first be configured to logging mode – see page 6 for more
information.
Imported log data can be viewed using the application, or exported to an external .csv file. The
application will also initialize the internal RTC in the device, if it is inserted in its cradle when the
application is open.
It is included in the Developer Kit as an aid to the development process, so that recorded data
can be viewed at an early stage.
Connect the BioHarness Device to a PC using the cradle and connector provided. The LED
should show pale orange, indicating battery charge.
Use the Desktop Shortcut created by the installer, or Start>All Programs>BioHarness
An ‘Initializing’ dialogue will display. This resets the internal RTC in the device. This RTC is used
to set timestamps transmitted in the General Data Packet as described in the BioHarness
Bluetooth Comms Link Specification [1]. The RTC assigns timestamps to the data as it is
recorded into internal memory.
Device in USB cradle BioHarness Application
USB connector

BioHarness Bluetooth Developer Kit User Manual
Page 20
This document is confidential and does not constitute a public document.
Possession should only be under NDA or other relevant confidentiality agreement.
This document has been prepared by Zephyr Technology Ltd and is not to be distributed, copied or reproduced without permission.
9700.0026 © Zephyr Technology 2010 2010-06-02
3.2.1. Importing Recorded Data
1. Connect device in cradle to PC and initialise as in previous section
2. Once the device has initialised, select the File>Import option from the application menu.
A dialogue will display the recordings in the device memory.
3. Select the recording(s) required using the arrow selectors and click the Import button.
4. When import is complete, the recording(s) will show in the Explorer panel in the
application.