Metadata-Version: 2.1
Name: freakble
Version: 0.1.1
Summary: A simple tool to send messages into FreakWAN over Bluetooth low energy.
Home-page: https://noa.mornie.org/eriol/freakble
Author: Daniele Tricoli
Author-email: eriol@mornie.org
Requires-Python: >=3.9,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: ble-serial (>=2.7.0,<3.0.0)
Requires-Dist: click (>=8.1.3,<9.0.0)
Project-URL: Repository, https://noa.mornie.org/eriol/freakble
Description-Content-Type: text/markdown

# freakble

A simple tool to send messages into [FreakWAN](https://github.com/antirez/sx1276-micropython-driver/)
over Bluetooth low energy.

**This is still a work in progress and it's not complete.**

## Installation

### Using pipx

The best way to install freakble is using [pipx](https://pypa.github.io/pipx/):
```console
$ pipx install freakble
```

### Using pip

```console
$ python -m pip install freakble
```

### From source

freakble uses [Poetry](https://python-poetry.org) as dependency management and
packaging tool, you need to install it first.

Then:

1. Clone this repository.
2. From the root of the repository run:
   ```console
   $ poetry build
   ```
3. Install using pipx or pip (it's better to use pipx):
   ```console
   $ pipx install dist/freakble-0.1.0-py3-none-any.whl
   ```

## Usage

At the moment only the command `send` used to send a message to the board is
implemented. You need to already know the address of the device.

For example:

```console
$ freakble send --device AA:AA:AA:AA:AA:AA Hello, there!
```

where you have to substitute `AA:AA:AA:AA:AA:AA` with your device's address.

The `--loop` flag will make freakble to send continuosly the message until
`CTRL + C` is pressed. Right now the resend interval is hardcoded and its value
is 0.1 seconds.

```console
$ freakble send --device AA:AA:AA:AA:AA:AA --loop FREAKNET
```

![A photo of a LYLIGO TTGO LoRa v2 1.6 showing the text: you> FREAKNET in multiple lines.](extras/304f4bb6-4f51-4183-95b9-c329b9bf69ab.jpg)

