summaryrefslogtreecommitdiffstats
path: root/README.md
blob: 11776797e892115c8c3b75b74d3c2a98e34ddfbe (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
<!--
SPDX-FileCopyrightText: 2013 The freestyle-hid Authors

SPDX-License-Identifier: Apache-2.0
-->

# Python library to interact with Abbott FreeStyle devices

This repository includes a library and some tools to interact with Abbott
FreeStyle devices that use their
[shared HID protocol](https://protocols.glucometers.tech/abbott/shared-hid-protocol.html).

## Tools

There are a number of tools that interact with either the devices or with
USB session captures that are installed together when selecting the `tools`
extra:

 * `freestyle-hid-console` allows sending direct text messages to a compatible
   device on the console;
 * `freestyle-extract-chatter` can produce a "chatter" file based on a capture
   of an USB session, either from Linux or Windows.
 * `freestyle-encrypted-setup-extract` is an experimental tool to extract the
   encryption parameters of devices using the encrypted protocol (e.g. Libre2).

## Development

If you want to contribute code, please note that the target language
is Python 3.7, and that the style to follow is for the most part PEP8
compatible.

To set up your development environment follow these guidelines:

```shell
$ git clone https://github.com/glucometers-tech/freestyle-hid.git
$ cd freestyle-hid
$ python3 -m venv --python=python3.7
$ . venv/bin/activate
$ pip install -e .[dev,tools]
$ pre-commit install
```