CovidBracelet/README.md

47 lines
2.0 KiB
Markdown
Raw Normal View History

# Covid Bracelet
2020-06-08 11:16:05 +02:00
**Contributions Welcome!**
2020-06-08 11:45:02 +02:00
## Get Started: Based on Zephyr OS and NRF52 BLE SOCs
2020-06-08 11:17:23 +02:00
We use Zepyhr master as we need a newer mbed TLS as the ones that ships with Zephyr 2.2. We are waiting for the Zepyhr 2.3 release. To build, please install Zephyr and compile via west. Note that Platform.io does not support Zephyr 2.3 rc / Zepyhr master at the current time.
## Features
2020-06-08 11:45:02 +02:00
* Code sends out and receives exposure beacons as specified by Google and Apple for Covid Contact Tracing
* Rolling, encrypted, anonymous beacons
* Compatible with Apple iOS and Android phones
2020-06-08 11:45:02 +02:00
* with rolling proximity identifiers and encrypted metadata
* proximity identifiers and BLE addresses change every 10 minutes
* stores own keys for 14 days
* stores contacts with more than 5 minute duration
* Upon infection upload keys to a public database
* Retrieve keys of infections from database
2020-06-08 11:45:02 +02:00
* computes rolling proximity identifiers
* compares to stored contacts to check for exposure
2020-06-08 11:16:05 +02:00
**Note: this is a proof of concept and not ready for production**
## Open / Possible next steps
* extensive compatibility testing with Apple iOS and Android devices
* contininous integration testing
* set device name in Flash
* fix entropy: keys are always the same on boot up
* set scanning interval to the correct value, for now we just use the default
* set advertisement interval, correct value, for now we just use the default: should be 200-270 milliseconds
* store long-term contacts in flash
* Energy efficiency
* BLE advertisements sets
* Secure GAT services
* More platforms / OS?
* time sync
* firmware of the air updates (signed)
2020-06-08 11:17:03 +02:00
## TODOs Wristband
Possible platforms for real-world deployment many, as many of the cheap fitness trackers base on NRF52 or chips with similar capabilities.
However, many would need the firmware to be shipped to manufactures.
* Watch UI
* Pine Time could be good for testing
2020-06-08 11:17:03 +02:00
## TODOs App and Basestation
* extend this beyond the simple basestation
* read keys form national databases