Skip to content

Quick implementation of the Apple/Google joint contact tracing beacon specification (now known as "Exposure Notification")

License

Notifications You must be signed in to change notification settings

phooky/contact-tracing-ble

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BLE Exposure Notification daemon

This is a rough Linux implementation of the jointly developed Apple/Google bluetooth exposure notification specification, formerly known as contact tracing. The current implementation covers v1.2.

This implementation interacts directly with the HCI; it is not intended to be run in parallel with another bluetooth daemon. It's recommended that you stop the bluetoothd process and bring up the hci device manually.

Support for Bluetooth Low Energy in Linux is all over the place; for example, recent kernels seem to break it on the Intel 9560 card in my laptop. My current target and testing environment is the Raspberry Pi Zero W.

(For a quick guide to setting this code up on a Raspberry Pi, see the RPi_setup.md document.)

Official strategy guide: run it in debug mode and log to stdout to see EN packets as they come in. sudo ./ctd -d -l -

Building and running the exposure notification daemon

  1. Build the daemon.
    1. Install dependencies. sudo apt install git libbluetooth-dev libgcrypt-dev
    2. Clone repository. git clone https://github.com/phooky/contact-tracing-ble.git
    3. Build ctd. cd contact-tracing-ble && make
  2. Run the daemon.
    1. Stop the existing bluetooth daemon. sudo systemctl stop bluetooth
    2. Bring up the hci0 interface sudo hciconfig hci0 up
    3. Start the BLE exposure notification daemon. sudo ./ctd

About

Quick implementation of the Apple/Google joint contact tracing beacon specification (now known as "Exposure Notification")

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published