mirror of
https://github.com/hak5darren/wifipineapple-wiki.git
synced 2025-10-29 16:59:29 +00:00
add build guide and blackout infusion page
This commit is contained in:
Rob Fuller
parent
6c1f50282a
commit
2e931dac75
134
build_guide.md
Normal file
134
build_guide.md
Normal file
@ -0,0 +1,134 @@
|
||||
# Build Guide
|
||||
|
||||
Below is the modified OpenWRT source on which the WiFi Pineapple software is developed. This permits building an OpenWRT image for the MKV hardware as well as cross-compile binaries architecture compatible binaries for the system.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
Building an OpenWRT image which runs on the WiFi Pineapple MKV hardware, or to cross compile packages for the WiFi Pineapple MKV, there are a few prerequisites required.
|
||||
|
||||
First of all, this guide assumes that Ubuntu is used as the host system. The following packages are needed:
|
||||
|
||||
```
|
||||
sudo apt-get install build-essential subversion git-core libncurses5-dev zlib1g-dev gawk flex quilt libssl-dev xsltproc libxml-parser-perl mercurial bzr ecj cvs unzip gcc-multilib gettext
|
||||
```
|
||||
|
||||
**It is also recommended that a [USB 3.3V UART Serial cable](https://hakshop.myshopify.com/collections/accessory/products/serial-ttl-cable) is available as it will most likely be needed when experimenting with firmwares.
|
||||
|
||||
Do **NOT** proceed unless you know what you are doing: Custom firmwares can brick (and even hard brick) your devices.
|
||||
|
||||
|
||||
## Building OpenWRT for the WiFi Pineapple MKV
|
||||
|
||||
The instructions below detail the process of generating firmware images for the WiFi Pineapple MKV hardware. The commands below are all executed in the root of the extracted directory.
|
||||
|
||||
### Download and extract source
|
||||
|
||||
```
|
||||
wget http://wiki.wifipineapple.com/uploads/source.tar.gz
|
||||
tar -zxvf source.tar.gz
|
||||
cd ./MK5
|
||||
```
|
||||
|
||||
### Adding software feeds
|
||||
|
||||
The commands below will allow for additional packages to be built into the firmware.
|
||||
|
||||
```
|
||||
./scripts/feeds update -a
|
||||
./scripts/feeds install -a
|
||||
```
|
||||
|
||||
### Adding custom files
|
||||
|
||||
To add custom files to the build, the `./files/` directory is used. It represents the root of the firmware. Creating a folder called "etc" inside of the `./files/` folder and placing a file inside will place (and overwrite) said file in the firwmare.
|
||||
|
||||
```
|
||||
mkdir -p ./files/etc/
|
||||
touch ./files/etc/custom_file
|
||||
echo "Content" > ./files/etc/custom_file
|
||||
```
|
||||
|
||||
The above will create a file called custom_file in the /etc/ folder of the final firmware image.
|
||||
|
||||
### Preparing the build
|
||||
|
||||
```
|
||||
make defconfig
|
||||
make prereq
|
||||
```
|
||||
|
||||
After following the above instructions, execute the command below. This allows the configuration of the firmware build to include / exclude any packages and kernel modules in your build. Once done, the configuration should be saved.
|
||||
|
||||
```
|
||||
make menuconfig
|
||||
```
|
||||
|
||||
### Compiling the firmware
|
||||
Once happy with the firmware configuration, execute the below command. This will build the tools, toolchain, and firmware image. This will take a long time.
|
||||
|
||||
```
|
||||
make
|
||||
```
|
||||
|
||||
After compiling the tools, toolchain, and firmware once, it is possible to build on multiple cores at the same time. **DO NOT DO THIS ON THE FIRST COMPILE**.
|
||||
|
||||
```
|
||||
make -j<number of cores+1>
|
||||
```
|
||||
|
||||
### Installing your firmware on the WiFi Pineapple MKV hardware
|
||||
|
||||
Once the firmware has been compiled, it can be located in the `./bin/ar71xx/` folder. There are two relevant files:
|
||||
|
||||
```
|
||||
openwrt-ar71xx-generic-mk5-v1-squashfs-sysupgrade.bin
|
||||
openwrt-ar71xx-generic-mk5-v1-squashfs-factory.bin
|
||||
```
|
||||
|
||||
The easiest way of installing a firmware is to boot the WiFi Pineapple MKV and transfer the *-sysupgrade.bin file over to it. This can be done via the SD card or via SSH. Then, the following command can be executed to perform the upgrade.
|
||||
|
||||
```
|
||||
sysupgrade -n /path/to/sysupgrade.bin
|
||||
```
|
||||
|
||||
Should the above not be possible, the second file comes into play. This file can be used in the WiFi Pineapple MKV's recovery interface. https://WiFiPineapple.com/?flashing (Unbricking a bricked WiFi Pineapple MKV) contains all required instructions.
|
||||
|
||||
|
||||
## Building packages for the WiFi Pineapple MKV
|
||||
|
||||
To be able to build packages and / or cross compile them for the WiFi Pineapple MKV firmware, the above instructions on building a firmware have to be followed first. Please keep in mind, binary files may not be shipped as part of WiFi Pineapple Infusions. See the WiFi Pineapple Infusion forums for more information.
|
||||
|
||||
### Example package
|
||||
|
||||
To make things simple, the modified source referenced above contains an example package found in ./package/example-package/. This package, especially the two Makefiles contained, contain all the information necessary to build custom packages.
|
||||
|
||||
### Compiling the example package
|
||||
To compile the package, you will now need to go into your build configuration. Make sure you are in the root of the source code directory.
|
||||
|
||||
```
|
||||
make menuconfig
|
||||
```
|
||||
|
||||
Now, navigate to the location of your package. The example package can be found under utilities->example-package. Select it by pressing M. Exit out and save your configuration. Then execute:
|
||||
|
||||
```
|
||||
make package/example-package/compile
|
||||
```
|
||||
|
||||
The built package can now be found in `./bin/ar71xx/packages/example-package_1_ar71xx.ipk`. You can transfer and install this file on your WiFi Pineapple using opkg.
|
||||
|
||||
### Baking the package into the firmware
|
||||
|
||||
Baking a package into the firmware is as simple as repeating the above steps on compiling the package, except that this time, the package needs to be selected differently using the `make menuconfig` command. Instead of selecting it with M, it must be selected with Y. After this is complete, the firmware can be recompiled using the following commmand. This time, the resulting firmware will have the package built in.
|
||||
|
||||
```
|
||||
make
|
||||
```
|
||||
|
||||
## Further Reading
|
||||
|
||||
+ http://wiki.openwrt.org/about/toolchain
|
||||
+ http://wiki.openwrt.org/doc/howto/buildroot.exigence
|
||||
+ http://wiki.openwrt.org/doc/howto/build
|
||||
+ http://wiki.openwrt.org/doc/devel/crosscompile
|
||||
+ http://wiki.openwrt.org/doc/howto/obtain.firmware.sdk
|
||||
61
index.md
61
index.md
@ -8,6 +8,9 @@ Getting Started!
|
||||
Guides!
|
||||
Videos!
|
||||
|
||||
## Infusion Pages
|
||||
|
||||
+ [Blackout](infusions/blackout.md)
|
||||
|
||||
- WiFi_Pineapple
|
||||
- Wiki - **Read this please.**
|
||||
@ -23,64 +26,6 @@ Videos!
|
||||
Guides
|
||||
Please note these guides are aimed to work on the Mark V Revision hardware.
|
||||
|
||||
Internet Connection Sharing
|
||||
Linux ICS
|
||||
Windows ICS
|
||||
Mac OSX ICS
|
||||
Android ICS
|
||||
Guides
|
||||
Creating Infusions
|
||||
Serial UART
|
||||
DIP Switches
|
||||
Captive Portal Setup
|
||||
Factory Reset
|
||||
Compatible_Modems
|
||||
Compatible_Wireless_Cards
|
||||
Build_guide*
|
||||
SSLsplit on WiFi Pineapple
|
||||
SSL VPN from WiFi Pineapple
|
||||
Change Pineapple Interface to SSL
|
||||
WarWalking with Kismet
|
||||
PineShock: Abusing Shellshock via a Pineapple
|
||||
*The Build guide is for compiling a custom firmware image and NOT for setting up your pineapple for the first use.
|
||||
|
||||
Video Guides
|
||||
Wardriving with Wifi Pineapple Mark V running Kismet
|
||||
Pineapple Wifi Intro and Reconnaissance View
|
||||
Writing a captive portal for the latest version of Evil Portal
|
||||
How to Unbrick
|
||||
WPS Cracking Tutorial
|
||||
Upgrade Firmware
|
||||
WiFi Pineapple, Karma, sslstrip and Captive Portals
|
||||
Infusions
|
||||
Evil Portal 2.3 - Fix all the bugs!
|
||||
Collecting Browser Data With Evil Portal and Get
|
||||
Pineapple Data Encryption
|
||||
SMSer 2.2 Overview
|
||||
ADS-B Tracker
|
||||
Pineapple Stats
|
||||
SSL Strip
|
||||
Deauth
|
||||
Pineapple Bar
|
||||
Client Mode
|
||||
Karma
|
||||
Developer Hangouts
|
||||
WiFi Pineapple 2.0.2 Firmware - PineAP
|
||||
LAUNCH EVENT - Firmware 1.4.0 for WiFi Pineapple Mark V
|
||||
Launch Event - WiFi Pineapple Firmware 1.1.0
|
||||
WiFi Pineapple 1.1.0 BETA Release Chat
|
||||
Pineapple University
|
||||
Hardware Overview
|
||||
First Boot and Firmware Flashing
|
||||
Updates and Infusions
|
||||
Connecting to a nearby AP in Client Mode
|
||||
Linux Internet Connection Sharing
|
||||
Windows Internet Connection Sharing
|
||||
Introduction to Mobile Broadband
|
||||
4G LTE Modem Tethering
|
||||
3G Managed Modems
|
||||
Tutorial: Hijacking DNS
|
||||
Tutorial: Sniffing Passwords with SSLStrip
|
||||
|
||||
## Overview
|
||||
|
||||
|
||||
15
infusions/blackout.md
Normal file
15
infusions/blackout.md
Normal file
@ -0,0 +1,15 @@
|
||||
# Blackout
|
||||
|
||||
Blackout is an infusion available on the [Pineapple Bar](../pineapple_bar.md) that provides the ability to toggle the state of the Pineapple LEDs from the [WebUI](../webui.md).
|
||||
|
||||
## Functionality
|
||||
|
||||
This infusion has a simple graphical interface that allows the user to selectively turn on or off all of the LEDs on the Pineapple, except for the power indicator which cannot be disabled.
|
||||
|
||||
### Small Tile
|
||||
|
||||
The small tile gives the user quick access to two small buttons, one to turn off all LEDs and one to turn them all on.
|
||||
|
||||
### Large Tile
|
||||
|
||||
Blackout's large tile interface is not much more complex, but it provides control over each LED individually. If for example the user was tired of seeing the flashing LED associated with wlan1, all he or she would need to do is click the button labeled 'Red Off' and it would be disabled. Once he/she started to miss it, clicking 'Red On' from within the large tile would start it again, blinking as fast and as bright as ever.
|
||||
Loading…
x
Reference in New Issue
Block a user