Skip to content

FaradayRF/faradayio

Repository files navigation

FaradayIO

Build Status Coverage Status Join the chat at https://gitter.im/FaradayRF/Lobby

The faradayio module provides a TUN/TAP interface which tunnels network traffic in SLIP format over a serial port. This was originally designed for the Faraday radio but the software is radio agnostic. By default this module helps create a TUN/TAP adapter on the 10.0.0.0 network and a simple command line program is also provided to automatically setup a network adapter for a Faraday radio.

Installation

Installation is simple. If you are just installing to use with a radio then the pypi installation is all you need. However, if you are looking to develop code then you should install from a GitHub repository clone in editable mode. Please note we suggest installing with a virtual environment in all cases!

PyPi

To install faradayio simply install with pip3

pip3 install faradayio

Git Repository Editable Mode

To install faradayio from a git repository in editable mode simple checkout from GitHub and use pip3 to install in editable mode.

$ git clone [email protected]:FaradayRF/faradayio.git
$ cd faradayio
$ pip3 install -e .

Usage

import serial
import threading

from faradayio.faraday import Monitor

# Setup serial port
serialPort = serial.Serial('/dev/ttyUSB0', 115200)

# Create threading event for TUN thread control
# set() causes while loop to continuously run until clear() is run
isRunning = threading.Event()
isRunning.set()

# Start TUN, will run until `cntl+c` pressed
tun = Monitor(serialPort=serialPort, name='KB1LQC-1', isRunning=isRunning)
tun.start()

For a simple but more robust implementation of faradayio please see faradayio-cli. This is the FaradayIO Command Line Client and is responsible for officially implementing faradayio for FaradayRF projects.

Wiki

Please use our faradayio wiki to find helpful tips on installation, setting up a development environment, and running unit tests.

FaradayRF

This project is provided by FaradayRF as GPLv3 software aimed at the amateur radio (ham radio) community. Please join us on our Gitter lobby if you have any questions. Send an email to [email protected] if you would like to contact us via email.