portapack-mayhem/README.md

101 lines
4.1 KiB
Markdown
Raw Normal View History

2015-09-13 19:05:10 -04:00
# portapack-HAVOC
2015-07-06 19:08:57 -04:00
2016-01-29 19:39:25 -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/).
2015-09-13 19:05:10 -04:00
2016-08-26 04:05:07 -04:00
Hardware is available at [ShareBrained Technology](http://sharebrained.com/portapack).
2016-09-26 21:15:38 -04:00
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).
2016-05-11 10:49:24 -04:00
2016-09-26 21:15:38 -04:00
As its name implies, HAVOC's functionalities can be fun (or mean). You shouldn't use them. We never did.
2016-07-27 18:56:55 -04:00
2016-08-26 02:28:24 -04: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.**
2015-07-07 15:06:56 -04:00
2016-08-26 04:05:07 -04:00
# Fork features
2016-09-26 21:15:38 -04:00
* "Soundboard" wave file player from µSD (put 8-bit mono files in /wav directory)
2016-08-26 02:28:24 -04:00
* POCSAG 1200 alphanumeric receiver/decoder
2016-12-08 15:14:28 -05:00
* Simulate OOK frames from PT2262 encoders and many others (doorbells, remote outlets, some garage doors, ...)
* Scheduled numbers station (for spies on a budget, alerts, LARP scenarios, fox hunts, ...)
2016-09-23 12:29:12 -04:00
* Nuoptix DTMF sync transmit (quite specific but can be useful in some theme parks :) )
2016-12-08 15:14:28 -05:00
* RDS (Radio Data System) PSN and RadioText groups transmit
* Fully configurable AFSK transmit (Bell202...)
2016-08-26 02:28:24 -04:00
* Virtual keyboard or Unistroke "handwriting" text input
2016-08-02 22:57:40 -04:00
* LCR (Language de Commande Routier) litteral message forming and transmit
2016-07-27 23:53:09 -04:00
* Xylos transmitter, street lighting control (NFM CCIR tones)
2015-09-04 14:40:59 -04:00
* "Play Dead" in case of emergency
2016-12-08 15:14:28 -05:00
* PWM audio RSSI output (for crude direction finding)
* (Not working) Close-Call™ style scanner
* (Not working) Fully configurable jammer
2016-08-26 02:28:24 -04:00
* (Not used for now) Dynamic baseband code loading from SD card
2015-09-03 00:36:51 -04:00
2016-08-26 04:05:07 -04:00
# Screenshots
![test](pictures/ook_enc.png) ![test](pictures/pocsag.png) ![test](pictures/afsk.png)
![test](pictures/lcr.png) ![test](pictures/rds.png) ![test](pictures/xylos.png)
![test](pictures/soundboard.png) ![test](pictures/about.png) ![test](pictures/config.png)
## Todo
2016-09-23 17:10:14 -04:00
* PMR446 transmit
2016-01-29 19:39:25 -05:00
* Frequency manager
2016-08-02 22:57:40 -04:00
* Detect/decode OOK
2016-08-26 02:28:24 -04:00
* Whistle (tone generator)
* POCSAG transmitter
* AFSK receiver
2016-01-29 19:39:25 -05:00
* Make SIGFOX interceptor work with all modules
2016-08-26 02:28:24 -04:00
* Wireless microphone transmit (with squelch tones)
* EPAR transmit (old Xylos)
2016-05-29 06:12:41 -04:00
* Spectrum painter
2015-08-24 18:14:03 -04:00
2016-01-29 19:39:25 -05:00
**Visit the [wiki](https://github.com/furrtek/portapack-havoc/wiki) for more details.**
2015-07-07 15:06:56 -04:00
2016-07-28 08:01:03 -04:00
About the PWM RSSI output: Frequency is 800Hz in NFM and 500Hz in WFM. The data path is very messy, the RSSI thread running on the baseband core sends groups of values to the application RSSI widget which computes the average value, which sends it back to the baseband module for audio output (if enabled)...
2016-01-05 09:52:02 -05:00
# Thanks
2016-09-26 21:15:38 -04:00
* Sig and cLx for research on AFSK LCR, Xylos, and for lending remote-controlled outlets
* Rainer Matla for the donation :)
* Keld Norman for ideas and suggestions
2016-01-05 09:52:02 -05:00
2015-07-07 15:06:56 -04: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.
2016-01-29 19:39:25 -05:00
2016-01-03 01:48:35 -05:00
Copyright (C) 2015-2016 Furrtek
2015-07-07 15:06:56 -04:00
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
2016-01-29 19:39:25 -05:00
## Original firmware and hardware
2015-07-07 15:06:56 -04:00
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/
2016-08-15 15:41:41 -04:00
2016-08-26 02:28:24 -04:00
## HAVOC specific things
2016-08-15 15:41:41 -04:00
2016-08-26 02:28:24 -04:00
Furrtek <furrtek@gmail.com>
2016-08-15 15:41:41 -04:00
2016-08-26 02:28:24 -04:00
<http://www.furrtek.org>