Skip to content

gregoryfenton/portapack-mayhem

 
 

Repository files navigation

PortaPack Mayhem

Build Status buddy pipeline CodeScene Code Health Docker Hub Pulls

This is a fork of the Havoc firmware, which itself was a fork of the PortaPack firmware, an add-on for the HackRF. A fork is a derivate, in this case one that has extra features and fixes when compared to the older versions.

PortaPack H2 (clone) with a custom 3d printed case

FAQ

This repository expands upon the previous work by many people and aims to constantly add new features, bugfixes and generate documentation to make further development easier. In a project such as this collaboration is always welcomed and appreciated.

To clarify any basic questions, please read the following common ones:

Does it work on H1/H2 PortaPack?

Yes, both devices are the same. The one I am using to test all changes is this PortaPack H2+HackRF+battery, which is a kit that includes everything you need. Sadly, the people making the H2 never made the updated schematics available, which is not ideal (and goes against the terms of the license).

To support the people behind the hardware, please buy a genuine HackRF and PortaPack.

Where is the latest firmware?

The current stable release is on the Release page. Follow the instructions you can find in the release description. There is also nightly builds generated frequently which have the latest features but may contain incomplete or buggy functionality (at least until the bug is found!).

Is this the newest firmware for my PortaPack?

Most probably: YES. If you find new features somewhere else, please suggest them.

Which one is actually the newest?

There is a lot of confusion of which is the latest version because no old version used any actual "version number". Additionally, since the files were distributed on facebook groups, github issue links and similar temporal sources, then there was no central location for them.

This fork (Mayhem) uses major.minor.release semantic versioning, so you can always compare your current version with the latest from Releases.

What about Havoc/GridRF/jamesshao8/jboone's?

  • jboone's PortaPack: the vanilla experience
  • Havoc: It was the most popular fork of jboone's PortaPack, currrently, it is not being maintained nor updated
  • jamesshao8: He keeps his own version of the fork, while not attached as a fork to anything
  • GridRF: They sell PortaPack clones with their own firmware based on a old version, which has no sourcecode available

How can I collaborate

You can write documentation, fix bugs and answer issues or add new functionality. Please check the following guide with details.

Consider that the hardware and firmware has been created and maintain by a lot of people, so always try colaborating your time and effort first.

As a last option, if you want to send money directly to me for getting more boards, antennas and such:

paypal

What if I need help?

First, check the documentation. If you find a bug or you think the problem is related to the current repository, please open an issue.

You can reach the official community in Facebook.

What if I find incongruencies, or grammatical errors in the text?

If is on the Wiki, you can modify it directly. If is on files of the repository, you can send corrections as pull requests. As a last resource, open an issue.

About

Custom firmware for the HackRF+PortaPack H1/H2

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 61.2%
  • C++ 27.6%
  • Objective-C 4.6%
  • Makefile 2.9%
  • HTML 1.9%
  • Assembly 1.3%
  • Other 0.5%