Skip to content

A library for interacting with medical devices over WebHID.

License

Notifications You must be signed in to change notification settings

Quintessential-SFT/HealthHID

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HealthHID

A library for interacting with medical devices over WebHID.


This library is primarily focused around receiving readings from health-related biometric devices.

Usage:

Due to WebHID security-related limitations, users need to explicitly grant the page permission to utilize their devices on every single page load.
As such, users of the library need to manually call ask for a device handle via Device.requestDevice().
Upon receiving access, the device will be automatically opened and ready for use.
Individual devices may then utilize said device handle to interact with the hardware device through the relevant device utils.
Besides returning the actual response, device commands typically log successful output in a text representation.
By default, said output is piped to the console, but a custom data handler may be specified via devHandle.setStrOut(dataHandler).

Example: 👨🏻‍🔬

# Retrieving the active slot's current user ID from a Microlife Blood Pressure Monitor

const userId = await HealthHid.MicrolifeBPM.getUserId(device);
console.log(userId);
> KON14

Demo Dashboard:

git clone git@github.com:Quintessential-SFT/HealthHID.git
cd HealthHID
npm ci
npm run dev

# Navigate to http://localhost:8080

Supported Devices:

Blood Pressure Monitors:

Manufacturer Device Vendor ID Product ID Namespace
Microlife * 0x4B4 0x5500 MicrolifeBPM

(*) Most Microlife BPM devices utilize the implemented BPA-100 protocol.

Blood Glucose Monitors:

Manufacturer Device Vendor ID Product ID Namespace
Microlife GlucoTeq 0x04D9 0xB564 MicrolifeGlucoTeq
OkBiotech OkMeter 0x04D9 0xB564 MicrolifeGlucoTeq

Limitations:

WebHID is currently only supported on Chromium* desktop browsers.

Acknowledgements

🐍 joergmlpts/blood-pressure-monitor