portapack-mayhem/README.md

111 lines
4.4 KiB
Markdown
Raw Normal View History

2016-12-29 23:30:44 +00:00
# portapack-HAVOC
HAVOC is a fork of the PortaPack H1 firmware, a portability add-on for the [HackRF One software-defined radio](http://greatscottgadgets.com/hackrf/).
Hardware is available at [ShareBrained Technology](http://sharebrained.com/portapack).
It is build on top of [ShareBrained's firmware](https://github.com/sharebrained/portapack-hackrf/), meaning that the original functionalities are kept (except when I don't sync for 2 months).
2017-02-14 19:05:17 +00:00
**Documentation: [READ THE WIKI](https://github.com/furrtek/portapack-havoc/wiki/Home/)**
2016-12-29 23:30:44 +00:00
As its name implies, HAVOC's functionalities can be fun (or mean). You shouldn't use them. We never did.
**In most countries, radio transmissions are tightly regulated. Transmitting outside of free/public bands without a licence or authorization, even at very low power, is certainly forbidden where you live. Always bear that in mind. You're the ONLY ONE responsible for what you do with this software.**
# Fork features
2017-02-14 18:14:31 +00:00
* Frequency manager (save & load from SD card)
* "Soundboard" wave file player (put 8-bit mono files in SD card /wav directory)
2017-02-08 00:26:13 +00:00
* POCSAG 512/1200/2400 transmitter
2017-02-13 04:37:14 +00:00
* POCSAG 512/1200/2400 receiver/decoder
2017-02-08 00:26:13 +00:00
* Fully configurable jammer
2017-02-14 18:14:31 +00:00
* OOK transmitter for common remote encoders (PT2262, doorbells, remote outlets, some garage doors, ...)
* Scheduled numbers station (for spies on a budget, alerts, LARP scenarios, ...)
2016-12-29 23:30:44 +00:00
* Nuoptix DTMF sync transmit (quite specific but can be useful in some theme parks :) )
2017-02-14 18:14:31 +00:00
* Morse transmitter (FM tone and CW)
* RDS (Radio Data System) PSN, RadioText and Time groups transmitter
* AFSK transmitter (Bell202...)
2016-12-29 23:30:44 +00:00
* Virtual keyboard or Unistroke "handwriting" text input
2017-02-14 18:14:31 +00:00
* LCR (Language de Commande Routier) message generator
2016-12-29 23:30:44 +00:00
* "Xy" and "EP" transmitter, street lighting control (CCIR tones)
* "Play Dead" in case of emergency
* PWM audio RSSI output (for crude direction finding)
2017-01-09 21:08:37 +00:00
# Progress
Feature | Progress | Notes
------- | ------ | -----
2017-02-08 00:26:13 +00:00
POCSAG RX | 95% | Needs support for numeric messages
2017-02-14 18:14:31 +00:00
Morse TX | 95% | CW mode needs testing
2017-02-08 00:26:13 +00:00
RDS TX | 90% | Radiotext isn't quite right yet
Close-Call™ | 85% | Needs adjustments and optimization for wider frequency range
2017-01-09 21:08:37 +00:00
EPAR TX | 60% | Older Xy, low priority
Sigfox RX | 40% | Left aside, needs updates and testing
2017-02-08 00:26:13 +00:00
ADS-B TX | 40% | UI and frame gen stuff done
2017-01-17 07:46:42 +00:00
Wave visualizer | 30% | High priority
2017-01-09 21:08:37 +00:00
Whistle | 20% | Easy
2017-01-17 07:46:42 +00:00
IQ replay | 10% | High priority
2017-02-02 02:37:56 +00:00
Generic TXs | 5% | Raw AX.25, AFSK, FSK, CCIR, DTMF...
2017-01-09 21:08:37 +00:00
ADS-B RX | 0% | Could be fun
Search | 0% | Will be a special Close-Call mode
Scanner | 0% | Easy
2017-02-02 02:37:56 +00:00
SSB TX | 0% | Requested
2017-01-09 21:08:37 +00:00
PMR446 TX | 0% | Channel list, mic. in, PTT, CTCSS
OOK RX | 0% | Mainly for 433MHz remotes
AFSK RX | 0% | Shouldn't be too tough
Analog TV TX| 0% | Could be fun
Mic. TX | 0% | Need to find guard tones for various brands of wireless mics
Painter | 0% | Spectrum painter, low priority
2016-12-29 23:30:44 +00:00
# Screenshots
2016-12-29 23:31:50 +00:00
![HAVOC screenshots](screenshots.png)
2016-12-29 23:30:44 +00:00
# Thanks
* Sig and cLx for research on AFSK LCR, Xylos, and for lending remote-controlled outlets
2017-02-08 00:26:13 +00:00
* Rainer Matla and DC1RDB for the donations :)
2016-12-29 23:30:44 +00:00
* Keld Norman for ideas and suggestions
# License
Except where specified in subdirectories of this project, all work is offered under the following license:
Copyright (C) 2013-2015 Jared Boone, ShareBrained Technology, Inc.
Copyright (C) 2015-2016 Furrtek
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301, USA.
# Contact
## Original firmware and hardware
Jared Boone <jared@sharebrained.com>
ShareBrained Technology, Inc.
<http://www.sharebrained.com/>
The latest version of this repository can be found at
https://github.com/sharebrained/portapack-hackrf/
## HAVOC specific things
Furrtek <furrtek@gmail.com>
<http://www.furrtek.org>