README.md

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