Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

Link zu dieser Vergleichsansicht

project:minikrebs [2013/02/23 13:52]
78.43.159.22 [Installation]
project:minikrebs [2014/03/15 16:21] (aktuell)
93.231.148.222 [Pigtail]
Zeile 1: Zeile 1:
-====== ​minikrebs ​====== ​    +====== ​Minikrebs ​====== ​    
 {{tag> software hardware computing networking}} {{tag> software hardware computing networking}}
 In short: In short:
  
 **minikrebs is an low-interaction special-purpose firmware generator for the TP-Link WR703N.** **minikrebs is an low-interaction special-purpose firmware generator for the TP-Link WR703N.**
 +
 +official project page:
 +http://​krebsco.de/​minikrebs
  
 Longer Version: Longer Version:
 The project minikrebs is a meta-project for a number of special-purpose images for the TP-Link WR703n (or MR3020) Wireless Router. These Images are called `profiles` in the context and are build with the help of the OpenWRT Image Builder. Building the complete image is very important as the scarcest ​ resource of the wr703n is its 4MB Flash memory The project minikrebs is a meta-project for a number of special-purpose images for the TP-Link WR703n (or MR3020) Wireless Router. These Images are called `profiles` in the context and are build with the help of the OpenWRT Image Builder. Building the complete image is very important as the scarcest ​ resource of the wr703n is its 4MB Flash memory
- 
-===== TLDR ====== 
-This is how you get a cool webcam-streamer firmware for your WR703N: 
-   ​./​prepare instacam && builder/​init ​ 
-Use it to flash your minirouter, password is `minikrebs` 
- 
-===== DISCLAMER ===== 
-All code is pseudo-code and it might or might not work on your system. Copy-Paste with extreme caution. 
  
 ===== Hardware ===== ===== Hardware =====
Zeile 21: Zeile 16:
   - [[https://​www.amazon.de/​dp/​B008UNA6FS/?​tag=krebsco-21|Amazon de]]   - [[https://​www.amazon.de/​dp/​B008UNA6FS/?​tag=krebsco-21|Amazon de]]
   - [[http://​www.amazon.com/​dp/​B0083Z54P0/?​tag=krebsco-20|Amazon com]]   - [[http://​www.amazon.com/​dp/​B0083Z54P0/?​tag=krebsco-20|Amazon com]]
 +
 +**Important**:​ you do __NOT__ want to buy the WR702N, it is cheaper but is NOT OpenWRT-compatible!
  
 Almost 100% compatible is the TP-Link MR3020 which was built for the european market and is a bit bigger, has 5 LEDs and a 3-way switch. Almost 100% compatible is the TP-Link MR3020 which was built for the european market and is a bit bigger, has 5 LEDs and a 3-way switch.
 Buy at: Buy at:
-  - [[http://​www.amazon.com/​dp/​B006DEBXD0/?​tag=krebsco-20|Amazon com]]+
   - [[https://​www.amazon.de/​dp/​B00634PLTW/?​tag=krebsco-21|Amazon de]]   - [[https://​www.amazon.de/​dp/​B00634PLTW/?​tag=krebsco-21|Amazon de]]
 +  - [[http://​www.amazon.com/​dp/​B006DEBXD0/?​tag=krebsco-20|Amazon com]]
 +
 +
 +===== TLDR ======
 +Get your own minikrebs in 3 easy steps
 +
 +**Step 1:** clone the minikrebs repository:
 +   git clone https://​github.com/​krebscode/​minikrebs && cd minikrebs
 + 
 +**Step 2:** Build a cool webcam-streamer firmware for your WR703N:
 +   ​./​prepare instacam && builder/​init ​
 +Use it to flash your minirouter, password is `minikrebs`
 +
 +For the MR3020 run:
 +   ​PLATFORM=TLMR3020 ./prepare instacam && builder/​init
 +
 +**Step 3:** Load the image to onto the WRT-Platform ​
 +   ​upload via web interface (for fresh install)
 +or with OpenWRT already installed ​
 +   # copy (via scp/wget or something) builder/​bin/​ar71xx/​openwrt-ar71xx-generic-tl-wr703n-v1-squashfs-factory.bin (or mr3020 ) to minikrebs:/​tmp
 +   (on router) ​
 +   # mtd write /​tmp/​ar71xx/​openwrt-ar71xx-generic-tl-wr703n-v1-squashfs-factory.bin firmware
 +   
 +
 +**Step 0:** Something does not work
 +
 +Join IRC: #krebs at irc.freenode.com
 +
 +===== DISCLAMER =====
 +All code is pseudo-code and it might or might not work on your system. Copy-Paste with extreme caution.
  
 ===== Installation ===== ===== Installation =====
Zeile 32: Zeile 59:
   git clone https://​github.com/​krebscode/​minikrebs   git clone https://​github.com/​krebscode/​minikrebs
   cd minikrebs   cd minikrebs
- 
  
 ===== Build Environment ===== ===== Build Environment =====
Zeile 39: Zeile 65:
   ./upgrade -- writes the created image to your minikrebs via ssh   ./upgrade -- writes the created image to your minikrebs via ssh
   ./restore -- restores custom files from builder folder   ./restore -- restores custom files from builder folder
- 
  
 ===== Profiles ===== ===== Profiles =====
Zeile 49: Zeile 74:
    - A directory of custom files to be included in the final image    - A directory of custom files to be included in the final image
  
-The Next section describes ​the currently available ​profiles - please note, profiles may change faster than this wiki page, so have a look at minikrebs/​profiles+Currently (May '13) available profiles: 
 +  dali_master 
 +  heckenkrebs 
 +  instacam 
 +  krebs 
 +  madplayer 
 +  nfc_login 
 +  overlay_krebs 
 +  rickroller_advanced 
 +  rickroller_bare 
 +  shack_bridge 
 +  shack_dali 
 +  shack_instacam 
 +  shack_streamer 
 +  superheckenkrebs 
 + 
 +The Next section describes ​some of these profiles - please note, profiles may change faster than this wiki page, so have a look at minikrebs/​profiles
  
 Also, `good` profiles will contain a doc/ folder which describes what the profiles does and what its prerequirements are. Also, `good` profiles will contain a doc/ folder which describes what the profiles does and what its prerequirements are.
  
-Default ​Password ​for all profiles ​is `minikrebs+Default ​credentials ​for all profiles ​are root/minikrebs
- +
  
  
-==== instacam ​====+====   Profile: Instacam ​====
  
 The aim of the project is to reliably push a video stream directly to the internets for The aim of the project is to reliably push a video stream directly to the internets for
Zeile 113: Zeile 152:
 ---- ----
  
-==== Lazorcam ====+====   Profile: ​Lazorcam ====
 The minikrebs is deployed inside the shackspace lazor and is powered by its power supply. The next step is to stream the webcam data to ustream via an intermediate VHOST inside the shack infrastructure network. ​ The minikrebs is deployed inside the shackspace lazor and is powered by its power supply. The next step is to stream the webcam data to ustream via an intermediate VHOST inside the shack infrastructure network. ​
  
Zeile 124: Zeile 163:
  
 For more information see [[project:​lazorcam|Lazorcam]]. For more information see [[project:​lazorcam|Lazorcam]].
 +
 +====   ​Profile:​ Airlift ====
 +The goal is to supply internet to "​external territories"​. The WR703N is modded with an external Antenna connector and fitted with a (claimed) 13 dBi yagi antenna.
 +
 +A first quick network test proved successful with the Rick-roller profile spanning a distance of more than 2.5 km.
  
  
-==== usbbridge ​====+For more information see (2come) [[project:​airlift|Airlift]]. 
 +====   Profile: Usbbridge ​====
 minikrebs will start up as usbbridge with the usbip-stack. minikrebs will start up as usbbridge with the usbip-stack.
 It will run usbipd and grab an ip-address via dhcp from the LAN interface. It will run usbipd and grab an ip-address via dhcp from the LAN interface.
Zeile 148: Zeile 193:
     usbip detach -p 0     usbip detach -p 0
  
-==== Rick-Roller ====+====   Profile: ​Rick-Roller ====
 The purpose of the profile is to create an access point where every connection The purpose of the profile is to create an access point where every connection
 is rewritten to rickroll. is rewritten to rickroll.
Zeile 188: Zeile 233:
 26.3 --> 42.6 ; ... gotta make you understand 26.3 --> 42.6 ; ... gotta make you understand
  
-==== NFC-Gate =====+====   Profile: ​NFC-Gate =====
 The NFC-Gate is part of the [[https://​github.com/​shackspace/​user_suppository|User Suppository]] infrastructure. It polls the attached nfc-connector for new cards and uses the UID of the card for trying to either log in or log out the user at the shack-infrastructure. The NFC-Gate is part of the [[https://​github.com/​shackspace/​user_suppository|User Suppository]] infrastructure. It polls the attached nfc-connector for new cards and uses the UID of the card for trying to either log in or log out the user at the shack-infrastructure.
  
Zeile 198: Zeile 243:
 For more information see: [[https://​github.com/​shackspace/​user_suppository|Github Repository]] and the source code of this profile. Direct deployment may not work as expected, even though you might haven'​t expected anything. For more information see: [[https://​github.com/​shackspace/​user_suppository|Github Repository]] and the source code of this profile. Direct deployment may not work as expected, even though you might haven'​t expected anything.
  
-==== krebs ====+====   Profile: Krebs ====
 This is the base profile for krebs nodes. Copy it to create cool krebs images. Core feature is the automatic connection to the retiolum darknet. This is the base profile for krebs nodes. Copy it to create cool krebs images. Core feature is the automatic connection to the retiolum darknet.
  
Zeile 205: Zeile 250:
     tinc     tinc
  
-==== heckenkrebs ​====+====   Profile: Heckenkrebs ​====
 Heckenkrebs is the automatic internet-establish and gateway provider for the Heckenkrebs is the automatic internet-establish and gateway provider for the
 krebs darknet. It is a fork of the original krebs image. krebs darknet. It is a fork of the original krebs image.
  
-This profile will automatically establish wireless connections to shared wireless networks. If you want the Krebs to connect to your wlan you need to add your wireless credentials to /etc/wifipw. Syntax is $SSID;$PW +This profile will automatically establish wireless connections to shared wireless networks. If you want the Krebs to connect to your wlan you need to add your wireless credentials to /etc/autowifi/​wifi_keys. Syntax is $SSID|$MAC|$KEY 
-W-Lans can be blacklisted by adding the ssid to /etc/wifiblack+W-Lans can be blacklisted by adding the mac to /etc/autowifi/​blacklist
  
 run infest on the system to get into the retiolum darknet (requires internet) run infest on the system to get into the retiolum darknet (requires internet)
 hostsfiles for tinc can be updated with tinc-update hostsfiles for tinc can be updated with tinc-update
  
-the LED will turn off after 60 seconds of working internet connection to save power+the LED will turn off after working internet connection to save power
  
 === Functionality === === Functionality ===
-The Heckenkrebs will use the aap tool to connect randomly to wireless networks +The heckenkrebs uses different profiles (located ​in /​usr/​lib/​autowifi). 
-which are unprotected ​in some ways.+Right now we only have a "​hacking"​ profile for easybox, but further profiles should follow soon.
  
-aap is patched to calculate default easybox keys in addition to try open 
-networks. It also provides a blacklist and access-point password list 
 ===== Quickstart to get your own krebs on wr703n ===== ===== Quickstart to get your own krebs on wr703n =====
 !important this is pseudo code, so please use your brains !important this is pseudo code, so please use your brains
Zeile 264: Zeile 307:
  
 ==== Pigtail ===== ==== Pigtail =====
-[[http://​blagg.tadkom.net/​2012/​09/​15/​better-wr703n-antenna-mod/​|Add a SMA female connector]] or [[https://​forum.openwrt.org/​viewtopic.php?​pid=152457#​p152457|2]] e.g. from [[http://​www.amazon.de/​BIGtec-WLAN-Adapterkabel-SMA-Buchse/​dp/​B006ANRHHU??​tag=krebsco-21|Amazon]] if you want to install an external antenna.+[[http://​blagg.tadkom.net/​2012/​09/​15/​better-wr703n-antenna-mod/​|Add a SMA female connector]] or [[https://​forum.openwrt.org/​viewtopic.php?​pid=152457#​p152457|2]] ​(the other connector is called RPSMA - as I just learned) ​e.g. from [[http://​www.amazon.de/​BIGtec-WLAN-Adapterkabel-SMA-Buchse/​dp/​B006ANRHHU??​tag=krebsco-21|Amazon]] if you want to install an external antenna.
 ==== Serial Port ==== ==== Serial Port ====
 [[http://​wiki.villagetelco.org/​index.php?​title=Building_a_Serial_Port_for_TL-WR703N|look here for serial port info]] [[http://​wiki.villagetelco.org/​index.php?​title=Building_a_Serial_Port_for_TL-WR703N|look here for serial port info]]
project/minikrebs.1361623948.txt.gz · Zuletzt geändert: 2013/02/23 13:52 von 78.43.159.22