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 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!
To install faradayio simply install with pip3
pip3 install faradayio
To install faradayio from a git repository in editable mode simple checkout from GitHub and use pip3 to install in editable mode.
$ git clone git@github.com:FaradayRF/faradayio.git
$ cd faradayio
$ pip3 install -e .
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.
Please use our faradayio wiki to find helpful tips on installation, setting up a development environment, and running unit tests.
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 Support@faradayrf.com if you would like to contact us via email.