Definition of Done
The integration is ready when all of the following are true:Minimum Test Set
1
Happy path
Verify
connect -> start -> frames -> stop -> disconnect with mocked BLE or
bridge fixtures.2
Malformed packet handling
Feed short, corrupt, or partial packets into the decoder and confirm that
they are rejected safely.
3
Disconnect and reconnect behavior
Simulate device loss, browser disconnects, and retry behavior.
4
Firmware variants
Add fixtures for known protocol differences across supported firmware lines.
5
Metadata verification
Confirm channel names, count, sample rate, and timestamp handling.
What to Test First
CI Guidance
Real hardware is not required for CI. Use mocked Bluetooth or bridge I/O and stable packet fixtures so the tests are repeatable and easy to maintain.A good fixture set is more valuable than one manual test pass on a real
headset.
Manual Validation Pass
After automated tests are green, do one real device pass for each supported firmware line.Common Failure Patterns
Frames look valid but downstream features are wrong
Frames look valid but downstream features are wrong
Check channel order, scaling, and sample rate before looking at models.
The first stream works but reconnects fail
The first stream works but reconnects fail
Review teardown. Most reconnect bugs come from stale subscriptions or an
incomplete session release.
Streaming starts but timing is inconsistent
Streaming starts but timing is inconsistent
Revisit timestamp behavior and packet batching. Sample values can look fine
while timing metadata is still wrong.
The integration works on one firmware only
The integration works on one firmware only
Separate version-specific packet handling and add fixtures for each supported
firmware branch.
Release Readiness Checklist
Before you hand off the integration, make sure you can answer these clearly:- which devices and firmware versions were tested
- which browsers and platforms were tested
- what known limitations still exist
- what recovery behavior apps should expect
- who owns future maintenance
Related Docs
Next
Prepare the handoff
Package the tested integration for review or partner delivery.
Return to the guide index
Review the full integration flow.