Browse Source

Merge pull request #13 from rootzoll/dev

Dev update from rootzoll
dev
bluecell296 6 years ago
committed by GitHub
parent
commit
e7f6cd8e74
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
  1. 109
      README.md
  2. 8
      home.admin/00mainMenu.sh
  3. 2
      home.admin/80scanLND.sh
  4. 15
      shoppinglist_au.md
  5. 17
      shoppinglist_ch.md
  6. 16
      shoppinglist_cn.md
  7. 18
      shoppinglist_cz.md
  8. 8
      shoppinglist_de.md
  9. 18
      shoppinglist_fr.md
  10. 14
      shoppinglist_uk.md
  11. 18
      shoppinglist_usa.md

109
README.md

@ -1,61 +1,45 @@
[ [Hardware](#hardware-needed-amazon-shopping-list) ] -- [ [Setup](#boot-your-raspiblitz) ] -- [ [Documentation](#documentation) ] -- [ [Development](#further-development-of-raspiblitz) ]
-----
# RaspiBlitz
Fastest and cheapest way to get your own Lightning Node running - on a RaspberryPi with a nice LCD.
*Build your own Lightning Node on a RaspberryPi with a nice Display.*
`Version 0.98 (1.0 RC1) with lnd 0.5.1 and bitcoin 0.17.0.1 & litecoin 0.16.3.`
`Version 1.0 with lnd 0.5.1-beta and bitcoin 0.17.0.1 or litecoin 0.16.3.`
![RaspiBlitz](pictures/raspiblitz.jpg)
*This tutorial is based on the RaspiBolt project - you can find in detail here: https://github.com/Stadicus/guides/blob/master/raspibolt The RaspiBlitz serves as a shortcut through this setup process with some changes and an additional LCD display so that you can quickly experiment with a Lightning node and start working on your LApps on a hacking event (or at home). This shortcut is fine for testnet usage and maybe trying some small things on mainnet. But if you choose to go full reckless afterwards … please consider taking the time and work thru the original RaspiBolt project. Don’t trust us, verify.*
## Table of Contents
* [ [Hardware](#hardware-needed-amazon-shopping-list) ] Shopping Lists and Putting all together
* [ [Setup](#boot-your-raspiblitz) ] Init and Setup your RaspiBlitz Lightning Node
* [ [Documentation](#documentation) ] Features and Usecases
* [ [Development](#further-development-of-raspiblitz) ] Lets work together on the RaspiBlitz
## Hardware Needed (Amazon Shopping List)
*The RaspiBlitz software is build and tested for the following Hardware set that you can buy cheap on GERMAN Amazon:*
*The RaspiBlitz is a all-switches-on Lightning Node based on LND running together with a Bitcoin- or Litecoin-Fullnode running on a RaspberryPi3 with a 1TB HDD and an nice Display for easy setup and monitoring. Its mainly targeted for learning how to run your own decntralized Node from home. Discover & develop the growing ecosystem of the Lightning Network by becoming a part of it.*
* RaspBerry Pi 3 (34,99 EUR) https://www.amazon.de/dp/B07BDR5PDW
* Micro SD-Card 16GB (7,99 EUR) https://www.amazon.de/gp/product/B073K14CVB/
* Power >=3A (9,91 EUR) https://www.amazon.de/dp/B01E75SB2C
* 1TB Hard Drive (44,98 EUR) https://www.amazon.de/dp/B07997KKSK?th=1
* Case (9,36 EUR) https://www.amazon.de/dp/B0173GQF8Y
* LCD-Display (16,88 EUR) https://www.amazon.de/gp/product/B06X191RX7
## Time Estimate to Setup a RaspiBlitz
**Total Price: 124,11 EUR** (thats under 150 USD)
The RaspiBlitz is optimized for being Setup during a workshop at hackdays or conference. When it comes ready assembled together with a up-to-date synced HDD containing the blockchain its possible to have it ready in about 2 to 3 hours.
Amazon shopping lists for different countries:
[ [USA](shoppinglist_usa.md) ] [ [UK](shoppinglist_uk.md) ] [ [France](shoppinglist_fr.md) ] [ [China](shoppinglist_cn.md) ] [ [Australia](shoppinglist_au.md) ] [ [Czech](shoppinglist_cz.md) ] [ [Switzerland](shoppinglist_ch.md) ]
If you start at home ordering the parts from Amazon (see shopping list below) then its a weekend project with a lot of download and syncing time where you can do other stuff while checking on the progress from time to time.
You can even pay your RaspiBlitz Amazon Shopping with Bitcoin & Lightning thru [Bitrefill](https://blog.bitrefill.com/its-here-buy-amazon-vouchers-with-bitcoin-on-bitrefill-bb2a4449724a).
## Hardware Needed
The shopping list for China refers to Taobao/T-Mall.
The RaspiBlitz is build from the following parts:
### 3D Printed Case (optional)
* RaspBerryPi 3 B+
* Micro SD-Card 16GB
* Strong USB Powersupply >=3A
* 1TB Hard Drive
* Cheap Casing
* LCD-Display
You can replace the generic case in the shopping lists above with a customized 3D printed for the RaspiBlitz called "Lightning Shell" - great work by @CryptoCloaks
**Total Price: Under 150 USD / 130 EUR ** (depending on country & shop thats around)
https://thecryptocloak.com/product/lightningshell/
## Amazon Shopping Lists
![LightningShell](pictures/lightningshell.png)
These are the community currated shopping lists based in country:
### More optional Hardware
* [Germany](shoppinglist_de.md) *(reference shopping list)*
* [USA](shoppinglist_usa.md)
* [UK](shoppinglist_uk.md)
* [Switzerland](shoppinglist_ch.md)
* [France](shoppinglist_fr.md)
* [China](shoppinglist_cn.md)
* [Australia](shoppinglist_au.md)
* [Czech](shoppinglist_cz.md)
*Some optional goodies to consider to add to your shopping list for your RaspiBlitz (Amazon DE/US):*
* SD-Card Writer https://www.amazon.de/dp/B01JWFZWUQ / http://a.co/6e03D7Z
* LAN Cable https://www.amazon.de/dp/B004SUEIE2 /http://a.co/g2IJd6i
* USB-LAN-Adapter https://www.amazon.de/dp/B00NPJV4YY / http://a.co/ccb26nF
* Transport Case https://www.amazon.de/dp/B007Y4NWSW / http://a.co/0c6wyM2
* Y-Cable https://www.amazon.de/dp/B00ZJBIHVY / http://a.co/0WTA7nz
If you organizing an educational event where you want to support people learning on and with multiple RaspiBlitz, here is a package list of useful hardware to have at that event: [ [Event Package List](shoppinglist_event.md) ]
*You can even pay your RaspiBlitz Amazon Shopping with Bitcoin & Lightning thru [Bitrefill](https://blog.bitrefill.com/its-here-buy-amazon-vouchers-with-bitcoin-on-bitrefill-bb2a4449724a).*
## Assemble your RaspiBlitz
@ -63,7 +47,7 @@ If your RaspiBlitz is not assembled yet, put the RaspberryPi board into the case
![LCD](pictures/lcdassm.png)
NOTE: Some cases from the shopping lists contain a topping for smaller displays - you can ignore that topping.
*Some cases from the shopping lists contain a topping for smaller displays - you can ignore that topping.*
Connect the HDD to one of the USB ports. In the end your RaspiBlitz should look like this:
@ -71,18 +55,11 @@ Connect the HDD to one of the USB ports. In the end your RaspiBlitz should look
## Installing the Software
*There are two ways to start:*
### Scenario 1: “At a Hackathon/Event”
If you are at an event, ask for a ready-2-go set or if you have your own hardware ask for assistance to prepare your SD-Card and HDD. Then you are all set and and you can proceed with "Setup your RaspiBlitz".
Your SD-card needs to contain the RaspiBlitz software. You can take the long road by [building the SD-card image yourself](#build-the-sd-card-image) or use the already prepared SD-Card image:
### Scenario 2 “Start at Home”
You got all the hardware of the shopping list above and you have no further assistance. Then you need to prepare your SD-Card yourself .. this scenario is still experimental, feedback needed and can take some time.
1. Download SD-Card image (version 0.99 - Release Candidate 3 for 1.0):
https://wiki.fulmo.org/downloads/raspiblitz-0.99-2019-01-22.img.gz
91ef1e5b4e55a5a90e9faf094756461be841ba02591bb41ccf481755977b191b
or [build your own SD card image](#build-the-sd-card-image)
1. Download SD-Card image (version 1.0):
https://wiki.fulmo.org/downloads/raspiblitz-1.00-2019-02-22.img.gz
SHA-256: 91ef1e5b4e55a5a90e9faf094756461be841ba02591bb41ccf481755977b191b
2. Write the SD-Card image to your SD Card - if you need details, see here:
https://www.raspberrypi.org/documentation/installation/installing-images/README.md
@ -416,3 +393,27 @@ Everybody is welcome to join, improve and extend the RaspiBlitz - its a work in
Join me on twitter [@rootzoll](https://twitter.com/rootzoll), visit us at a [#lightninghackday](https://twitter.com/hashtag/LightningHackday?src=hash) in Berlin or drop by the Bitcoin Assembly at the [#35C3](https://twitter.com/hashtag/35C3).
IRC channel on Freenode `irc://irc.freenode.net/raspiblitz` (unmoderated)
------- OLD
*This tutorial is based on the RaspiBolt project - you can find in detail here: https://github.com/Stadicus/guides/blob/master/raspibolt The RaspiBlitz serves as a shortcut through this setup process with some changes and an additional LCD display so that you can quickly experiment with a Lightning node and start working on your LApps on a hacking event (or at home). This shortcut is fine for testnet usage and maybe trying some small things on mainnet. But if you choose to go full reckless afterwards … please consider taking the time and work thru the original RaspiBolt project. Don’t trust us, verify.*
### 3D Printed Case (optional)
You can replace the generic case in the shopping lists above with a customized 3D printed for the RaspiBlitz called "Lightning Shell" - great work by @CryptoCloaks
https://thecryptocloak.com/product/lightningshell/
![LightningShell](pictures/lightningshell.png)
### More optional Hardware
*Some optional goodies to consider to add to your shopping list for your RaspiBlitz (Amazon DE/US):*
* SD-Card Writer https://www.amazon.de/dp/B01JWFZWUQ / http://a.co/6e03D7Z
* LAN Cable https://www.amazon.de/dp/B004SUEIE2 /http://a.co/g2IJd6i
* USB-LAN-Adapter https://www.amazon.de/dp/B00NPJV4YY / http://a.co/ccb26nF
* Transport Case https://www.amazon.de/dp/B007Y4NWSW / http://a.co/0c6wyM2
* Y-Cable https://www.amazon.de/dp/B00ZJBIHVY / http://a.co/0WTA7nz
If you organizing an educational event where you want to support people learning on and with multiple RaspiBlitz, here is a package list of useful hardware to have at that event: [ [Event Package List](shoppinglist_event.md) ]

8
home.admin/00mainMenu.sh

@ -200,10 +200,16 @@ if [ ${setupStep} -eq 0 ]; then
elif [ ${setupStep} -lt 100 ]; then
# see function above
if [ ${setupStep} -lt 80 ]; then
./70initLND.sh
exit 0
fi
# see function above
if [ ${setupStep} -gt 59 ]; then
waitUntilChainNetworkIsReady
fi
fi
# continue setup
BACKTITLE="${hostname} / ${network} / ${chain}"

2
home.admin/80scanLND.sh

@ -1,7 +1,7 @@
#!/bin/bash
source /home/admin/raspiblitz.info
source /mnt/hdd/raspiblitz.conf
source /mnt/hdd/raspiblitz.conf
### USER PI AUTOSTART (LCD Display)
localip=$(ip addr | grep 'state UP' -A2 | tail -n1 | awk '{print $2}' | cut -f1 -d'/')

15
shoppinglist_au.md

@ -1,8 +1,9 @@
The RaspiBlitz software is build and tested for the following Hardware set that you can buy cheap on Amazon.com.au:
* RaspBerry Pi 3 ($38.75): https://www.amazon.com/RS-Components-Raspberry-Pi-Motherboard/dp/B07BFH96M3
* Micro SD-Card 16GB ($6.23): https://www.amazon.com/SanDisk-Mobile-MicroSDHC-SDSDQM-B35A-Adapter/dp/B004ZIENBA
* Power ($21.04): https://www.amazon.com.au/Ils-Supply-Adapter-Charger-Raspberry/dp/B07F2JLSCL/
* 1TB Hard Drive($49.99): https://www.amazon.com/Toshiba-Advance-Portable-External-HDTC910XR3AA/dp/B079H7VYY6
* Case ($7.50): https://www.amazon.com/Raspberry-Model-Protective-Heatsinks-Clear/dp/B01CDVSBPO
* LCD-Display ($19.99): https://www.amazon.com/ELEGOO-Raspberry-Display-480x320-Interface/dp/B01N3JROH8
## Shopping List: Amazon Australia
* RaspBerry Pi 3: https://www.amazon.com/RS-Components-Raspberry-Pi-Motherboard/dp/B07BFH96M3
* Micro SD-Card 16GB: https://www.amazon.com/SanDisk-Mobile-MicroSDHC-SDSDQM-B35A-Adapter/dp/B004ZIENBA
* Power: https://www.amazon.com.au/Ils-Supply-Adapter-Charger-Raspberry/dp/B07F2JLSCL/
* 1TB Hard Drive: https://www.amazon.com/Toshiba-Advance-Portable-External-HDTC910XR3AA/dp/B079H7VYY6
* Case: https://www.amazon.com/Raspberry-Model-Protective-Heatsinks-Clear/dp/B01CDVSBPO
* LCD-Display: https://www.amazon.com/ELEGOO-Raspberry-Display-480x320-Interface/dp/B01N3JROH8

17
shoppinglist_ch.md

@ -1,13 +1,10 @@
The RaspiBlitz software is built and tested for the following hardware set that you can buy on [PLAY-ZONE](https://www.play-zone.ch/) and [BRACK](https://www.brack.ch/):
## Shopping List: PlayZone/Brack Czech
* Raspberry Pi3 Model B+ (CHF 57.90): https://www.play-zone.ch/de/raspberry-pi3-model-b-1-4ghz-gigabit-lan-wlan-bluetooth-64bit-inkl-16-gb-noobs-sd-karte.html
* Includes a Micro SD card with 16GB capacity
* 3.5'' TFT Display (CHF 69.90): https://www.play-zone.ch/de/3-5-tft-display-800x480-pixel-60fps-mit-acryl-gehause-fur-den-raspberry-pi.html
* Raspberry Pi3 Model B+: https://www.play-zone.ch/de/raspberry-pi3-model-b-1-4ghz-gigabit-lan-wlan-bluetooth-64bit-inkl-16-gb-noobs-sd-karte.html
* Includes a Micro SD card with 16GB capacity
* 3.5'' TFT Display: https://www.play-zone.ch/de/3-5-tft-display-800x480-pixel-60fps-mit-acryl-gehause-fur-den-raspberry-pi.html
* Includes an acryl glass case
* Power supply 3A (CHF 29.90): https://www.play-zone.ch/de/netzteil-ac-dc-adapter-5v-dc-3000ma-microusb.html
* 1TB Hard Drive (CHF 51.00): https://www.brack.ch/maxtor-externe-festplatte-421628
* Power supply >=3A: https://www.play-zone.ch/de/netzteil-ac-dc-adapter-5v-dc-3000ma-microusb.html
* 1TB Hard Drive: https://www.brack.ch/maxtor-externe-festplatte-421628
Total: CHF 208.70
**Warning**: This display is different from the one available at Amazon and needs a specific driver!
Be sure to select "No" when asked by the install script if you have the default display!
**Warning**: This display is different from the one available at Amazon and needs a specific driver! You need to build your own sd card image and select "No" when asked by the building script if you have the default display!

16
shoppinglist_cn.md

@ -1,19 +1,15 @@
## Hardware Needed (Taobao.com/T-Mall Shopping List)
## Shopping List: Taobao/T-Mall China
*The RaspiBlitz software is build and tested for the following Hardware set that you can buy cheap on taobao.com:*
Set RaspBerry Pi + accessories (¥378.00 CNY) :
Set RaspBerry Pi + accessories:
* RaspBerry Pi 3 B+
* Micro SD-Card 16GB
* Power Unit 2.5A
* Power Unit 2.5A (3A+ is remmomended)
* several items (e.g. cooling fins)
https://item.taobao.com/item.htm?spm=a1z09.2.0.0.46982e8dibAzMc&id=550270480898&_u=b110k44d3302
Single HDD (Bulk) :
* 1TB Hard Drive (¥379.00 CNY)
* 1TB Hard Drive
https://detail.tmall.com/item.htm?id=38476523976&spm=a1z09.2.0.0.46982e8dibAzMc&_u=b110k44d53f4&sku_properties=5919063:6536025
Set LCD Display + Clear case (acrylic) (¥110.00 CNY) :
https://item.taobao.com/item.htm?spm=a1z0d.6639537.1997196601.60.49a77484QE4kv4&id=577238622706
**Total Price: ¥867.00 CNY** approx. 111 EUR or 128 USD
Set LCD Display + Clear case (acrylic):
https://item.taobao.com/item.htm?spm=a1z0d.6639537.1997196601.60.49a77484QE4kv4&id=577238622706

18
shoppinglist_cz.md

@ -1,13 +1,9 @@
## Hardware Needed (Alza.cz, Amazon.com and czc.cz Shopping List)
## Shopping List: Amazon/Alza/CZC Czech
_The RaspiBlitz software is build and tested for the following Hardware set that you can buy cheap on Alza.cz, Amazon.com and czc.cz:_
- RaspBerry Pi 3 (1.129 Kč) https://www.alza.cz/raspberry-pi-3-model-b-d5284636.htm?o=1
- Micro SD-Card 16GB (379 Kč) https://www.alza.cz/EN/kingston-micro-sdhc-16gb-class-10-uhs-i-industrial-temp-sd-adapter?dq=4156874&o=2
- Power (399 Kč)https://www.alza.cz/EN/alzapower-q100-quick-charge-3-0-black-d5324257.htm?o=2
- RaspBerry Pi 3: https://www.alza.cz/raspberry-pi-3-model-b-d5284636.htm?o=1
- Micro SD-Card 16GB: https://www.alza.cz/EN/kingston-micro-sdhc-16gb-class-10-uhs-i-industrial-temp-sd-adapter?dq=4156874&o=2
- Power: https://www.alza.cz/EN/alzapower-q100-quick-charge-3-0-black-d5324257.htm?o=2
- maybe you need an micro usb cable
- 1TB Hard Drive (1.349 Kč) https://www.czc.cz/toshiba-canvio-basics-1tb-cerna/235949/produkt?gclid=EAIaIQobChMIgpLF5Mac3gIVCM53Ch3D9QWpEAQYAyABEgK-ZfD_BwE
- Case (159 Kč) https://www.alza.cz/EN/raspberry-pi-black-d3837597.htm?o=1
- LCD-Display (450.46 Kč) (delivered to Czech Republic) https://www.amazon.com/dp/B01N3JROH8/ref=cm_sw_r_cp_ep_dp_-gOuBb2Q6T0C5
**Total Price: 3.865,46 Kč**
- 1TB Hard Drive: https://www.czc.cz/toshiba-canvio-basics-1tb-cerna/235949/produkt?gclid=EAIaIQobChMIgpLF5Mac3gIVCM53Ch3D9QWpEAQYAyABEgK-ZfD_BwE
- Case: https://www.alza.cz/EN/raspberry-pi-black-d3837597.htm?o=1
- LCD-Display (delivered to Czech Republic): https://www.amazon.com/dp/B01N3JROH8/ref=cm_sw_r_cp_ep_dp_-gOuBb2Q6T0C5

8
shoppinglist_de.md

@ -0,0 +1,8 @@
## Shopping List: Amazon Germany
* RaspBerry Pi 3: https://www.amazon.de/dp/B07BDR5PDW
* Micro SD-Card 16GB: https://www.amazon.de/gp/product/B073K14CVB/
* Power >=3A: https://www.amazon.de/dp/B01E75SB2C
* 1TB Hard Drive: https://www.amazon.de/dp/B07997KKSK?th=1
* Case: https://www.amazon.de/dp/B0173GQF8Y
* LCD-Display: https://www.amazon.de/gp/product/B06X191RX7

18
shoppinglist_fr.md

@ -1,12 +1,8 @@
## Hardware Needed (Amazon.fr Shopping List)
## Shopping List: Amazon France
*The RaspiBlitz software is build and tested for the following Hardware set that you can buy cheap on Amazon.fr:*
* RaspBerry Pi 3 (38,00 EUR) https://www.amazon.fr/dp/B07BDR5PDW
* Micro SD-Card 16GB (9,53 EUR) https://www.amazon.fr/dp/B073K14CVB/
* Power (8,99 EUR) https://www.amazon.fr/dp/B01566WOAG
* 1TB Hard Drive (46,80 EUR) https://www.amazon.fr/dp/B07997KKSK
* Case (7,41 EUR) https://www.amazon.fr/dp/B0173GQF70/
* LCD-Display (16,99 EUR) https://www.amazon.fr/dp/B01N2N86HB/
**Total Price: 127,72 EUR**
* RaspBerry Pi 3: https://www.amazon.fr/dp/B07BDR5PDW
* Micro SD-Card 16GB: https://www.amazon.fr/dp/B073K14CVB/
* Power: https://www.amazon.fr/dp/B01566WOAG
* 1TB Hard Drive: https://www.amazon.fr/dp/B07997KKSK
* Case: https://www.amazon.fr/dp/B0173GQF70/
* LCD-Display: https://www.amazon.fr/dp/B01N2N86HB/

14
shoppinglist_uk.md

@ -1,8 +1,8 @@
*The RaspiBlitz software is build and tested for the following Hardware set that you can buy cheap on Amazon.co.uk:*
## Shopping List: Amazon UK
* RaspBerry Pi 3 https://www.amazon.co.uk/Raspberry-Pi-Model-64-Bit-Processor/dp/B07BDR5PDW
* Micro SD-Card 16GB https://www.amazon.co.uk/Kingston-SDC10G2-16GB-microSDHC-Included/dp/B0162YQEIE
* Power https://www.amazon.co.uk/iTrunk-Raspberry-Model-Supply-Charger/dp/B01MFFSPHE
* 1TB Hard Drive https://www.amazon.co.uk/Toshiba-Canvio-Basics-Portable-External/dp/B00KWHJY7Q
* Case https://www.amazon.co.uk/SB-Components-Transparent-Case-Raspberry/dp/B0173GQF8Y
* LCD-Display https://www.amazon.co.uk/ELEGOO-480x320-Raspberry-Monitor-Interface/dp/B01MRQTMTD
* RaspBerry Pi 3: https://www.amazon.co.uk/Raspberry-Pi-Model-64-Bit-Processor/dp/B07BDR5PDW
* Micro SD-Card 16GB: https://www.amazon.co.uk/Kingston-SDC10G2-16GB-microSDHC-Included/dp/B0162YQEIE
* Power: https://www.amazon.co.uk/iTrunk-Raspberry-Model-Supply-Charger/dp/B01MFFSPHE
* 1TB Hard Drive: https://www.amazon.co.uk/Toshiba-Canvio-Basics-Portable-External/dp/B00KWHJY7Q
* Case: https://www.amazon.co.uk/SB-Components-Transparent-Case-Raspberry/dp/B0173GQF8Y
* LCD-Display: https://www.amazon.co.uk/ELEGOO-480x320-Raspberry-Monitor-Interface/dp/B01MRQTMTD

18
shoppinglist_usa.md

@ -1,12 +1,8 @@
## Hardware Needed (Amazon.com Shopping List)
## Shopping List: Amazon USA
*The RaspiBlitz software is build and tested for the following Hardware set that you can buy cheap on Amazon.com:*
* RaspBerry Pi 3 ($39.70 USD) http://a.co/ahl7RIp
* Micro SD-Card 16GB ($5.99 USD) http://a.co/d/710f4oJ
* Power ($8.88 USD) http://a.co/d/fVVOYZZ
* 1TB Hard Drive ($49.99 USD) http://a.co/eUgVfLd
* Case ($7.99 USD) http://a.co/1774Hwl
* LCD-Display ($19.99 USD) http://a.co/65p2wu6
**Total Price: $132.54 USD**
* RaspBerry Pi 3: http://a.co/ahl7RIp
* Micro SD-Card 16GB: http://a.co/d/710f4oJ
* Power: http://a.co/d/fVVOYZZ
* 1TB Hard Drive: http://a.co/eUgVfLd
* Case: http://a.co/1774Hwl
* LCD-Display: http://a.co/65p2wu6
Loading…
Cancel
Save