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 [email protected]: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