What is Dreamcatcher Chat?
------------------------------------------------------------------------

Dreamcatcher Chat is an application developed for the Dreamcatcher 3
board enabling users to exchange text messages over a wide range
of radio frequencies.

The application achieves this by controlling both the mixer and radio
peripherals present on the device.
The software uses the libsoc library to control the GPIO from
userspace. The driver controlling the radio is ported from the SX1280
example provided by Semtech for the mbed platform. The driver
which controls the mixer is ported from the HackRF library.

This software was developed to explore the possibilities offered by
the Dreamcatcher hardware as well as providing a quick way to
experiment with the device.

How is Dreamcatcher Chat licenced?
------------------------------------------------------------------------

Dreamcatcher Chat is licenced under the GPLv2, please see the COPYING file for
futher details.

The libraries used (SX1280 code from semtech and RFFC driver from HackRF) and 
any local modifications to those continue to be licensed under their respective original licenses.

How do I build Dreamcatcher Chat?
------------------------------------------------------------------------

Dreamcatcher Chat requires Debian Stretch or later, kernel 4.14 or later,
This application will not work on kernel 4.10, or Debian Jessie or older. 

An Armbian image for Dreamcatcher can be found here: 
https://archive.othernet.is/Dreamcatcher3%20Armbian/

After burning the Armbian image to a microSD card, login with the following. 

Username: root
Password: 1234

Connect to a WiFi network with the command:

   sudo nmtui

You are now ready to follow the appllication installation instructions below. 

1) Install libsoc and libsoc-dev: sudo apt install libsoc2 libsoc-dev

   sudo apt update
   sudo apt install libsoc-dev libsoc2

2) get the code

git clone https://github.com/F5OEO/Dreamcatcher-Packet-Tester


3) make

or to build a static binary:

make static


4) run "chat" with superuser privileges

   sudo ./chat


How do I run chat without building it everytime?
------------------------------------------------------------------------

You have two alternatives:

1) compile a regular exeuctable as above (using make) and then copy the compiled
binary to another Dreamcatcher+Armbian system, install the required library:

sudo apt update; sudo apt install libsoc2

and then run the chat binary:

sudo ./chat

Alternatively, 

2) you can build a _static_ binary (using make static), then just copy this static binary
to another Dreamcatcher+Armbian system. No library installation is required. So just run
the chat binary:

sudo ./chat


Dependencies
------------------------------------------------------------------------

- pthreads
- libsoc

Authors
------------------------------------------------------------------------
Fausto Annicchiarico Petruzzelli < petruzzelli_dot_fausto_at_gmail_dot_com>
Luigi Zevola < luigi_dot_zevola_at_gmail_dot_com>