2017-04-12 21:40:09 -04:00
![HAVOC banner ](doc/banner.png )
2016-12-29 18:30:44 -05:00
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-03-18 08:41:52 -04:00
# Documentation
2017-03-23 16:32:54 -04:00
[READ THE WIKI ](https://github.com/furrtek/portapack-havoc/wiki/Home/ )
2017-03-18 08:41:52 -04:00
# Summary
2017-02-14 14:05:17 -05:00
2017-03-13 00:14:47 -04:00
As its name implies, HAVOC's functionalities can be fun (or mean). You shouldn't use them. No. Bad. Put it down.
2016-12-29 18:30:44 -05:00
**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-03-13 00:14:47 -04:00
* Microphone transmit with CTCSS
2017-02-14 13:14:31 -05:00
* Frequency manager (save & load from SD card)
* "Soundboard" wave file player (put 8-bit mono files in SD card /wav directory)
2017-02-07 19:26:13 -05:00
* POCSAG 512/1200/2400 transmitter
2017-02-12 23:37:14 -05:00
* POCSAG 512/1200/2400 receiver/decoder
2017-02-14 13:14:31 -05:00
* Morse transmitter (FM tone and CW)
2017-03-12 01:15:41 -05:00
* OOK transmitter for common remote encoders (PT2262, doorbells, remote outlets, some garage doors, ...)
2017-02-14 13:14:31 -05:00
* RDS (Radio Data System) PSN, RadioText and Time groups transmitter
2017-03-12 01:15:41 -05:00
* Fully configurable jammer
* Scheduled numbers station (for spies on a budget, alerts, LARP scenarios, ...)
* Nuoptix DTMF sync transmitter (quite specific but can be useful in some theme parks :) )
2017-02-14 13:14:31 -05:00
* AFSK transmitter (Bell202...)
2016-12-29 18:30:44 -05:00
* Virtual keyboard or Unistroke "handwriting" text input
2017-02-14 13:14:31 -05:00
* LCR (Language de Commande Routier) message generator
2016-12-29 18:30:44 -05: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 16:08:37 -05:00
# Progress
Feature | Progress | Notes
2017-04-14 05:07:25 -04:00
------- | -------- | -----
POCSAG RX | 95% | Needs support for numeric messages
Morse TX | 95% | Need testing for all symbols
Mic. TX | 95% | Carrier leak bug, need to find guard tones for various brands of wireless mics
2017-02-07 19:26:13 -05:00
RDS TX | 90% | Radiotext isn't quite right yet
Close-Call™ | 85% | Needs adjustments and optimization for wider frequency range
2017-04-14 05:07:25 -04:00
SSTV TX | 80% | Needs better bitmap file handling, support for other modes (ROBOT ?) and callsign FSK ID
2017-01-09 16:08:37 -05:00
EPAR TX | 60% | Older Xy, low priority
2017-04-14 05:07:25 -04:00
Sigfox RX | 40% | Tuning basics done, needs decoding code and testing
ADS-B TX | 40% | UI and frame gen stuff done, needs baseband module
Wave visualizer | 30% | Only the widget is ready, high priority
2017-03-23 16:32:54 -04:00
IQ replay | 30% | High priority
2017-01-09 16:08:37 -05:00
Whistle | 20% | Easy
2017-04-14 05:07:25 -04:00
Generic TXs | 5% | Raw AX.25, AFSK, FSK, CCIR, DTMF... Tonesets are ready
2017-03-14 03:27:12 -04:00
SI4032 TRX | 0% | And other sub-GHz transceiver chips
2017-03-23 10:26:28 -04:00
SSTV RX | 0% |
2017-04-14 05:07:25 -04:00
ADS-B RX | 0% | Could be fun. Is sensitivity high enough ?
Scanner | 0% | Easy, could be used with POCSAG RX to catch jumping channels
2017-03-23 16:32:54 -04:00
SSB TX | 0% | Requested but math is hard :(
2017-04-14 05:07:25 -04:00
OOK RX | 0% | See if rtl_433's author is fine with using protocol defs
AFSK RX | 0% | Shouldn't be too hard, bit-time shift and mix method ?
Analog TV TX| 0% | Enough CPU ? B& W and no sound ?
LoJack RX | 0% | Basically AFSK RX
DMR info RX | 0% | Retrieve DMR channel info. **No voice** because of vocoder complexity and possible legal issue
Tetra info? | 0% | Same
2016-12-29 18:30:44 -05:00
# Screenshots
2016-12-29 18:31:50 -05:00
![HAVOC screenshots ](screenshots.png )
2016-12-29 18:30:44 -05:00
# Thanks
* Sig and cLx for research on AFSK LCR, Xylos, and for lending remote-controlled outlets
2017-02-07 19:26:13 -05:00
* Rainer Matla and DC1RDB for the donations :)
2017-03-14 03:27:12 -04:00
* Keld Norman and Giorgio Campiotti for ideas and suggestions
2016-12-29 18:30:44 -05:00
# 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 >