====== π-box v2 - Step by step installation guide ======
----
===== Hardware prerequisites =====

==== REQUIRED HARDWARE ====

  * raspberry pi 3B (it works with Raspberry Pi)https://www.kubii.fr/raspberry-pi-3-2-et-b/1628-raspberry-pi-3-modele-b-1-gb-kubii-640522710850.html
  * micro SD card (SDHC class10) https://www.kubii.fr/carte-sd-et-stockage/1795-carte-microsd-64go-classe-10-sandisk-kubii-619659161507.html?search_query=sd&results=112

  * power plug 5v 2.1A, (don't use USB phone chargers, as 1A is not powerfull enough) https://www.kubii.fr/14-chargeurs-alimentations-raspberry/1631-alimentation-raspberry-pi-5v-25a-pour-raspberry-pi-3-couleur-noir-kubii-640522711000.html

  * USB sound card (built-in output sound is crapy and there is no input sound by default on Raspberry Pi)
 a good compatible USB soundcard, recommanded : https://www.sonovente.com/behringer-uca-222-p26643.html          
 Hifiberry sound card https://www.hifiberry.com/shop/boards/hifiberry-dac-adc/
 standard : https://www.kubii.fr/convertisseurs-adaptateurs-raspberry/2055-carte-son-externe-usb-vers-35mm-jack-adaptateur-audio-kubii-3272496009158.html?search_query=carte+son+usb&results=16
  * WiFi USB dongle (2 WiFi USB dongles if you have a version of Raspberry Pi < 3) to connect to internet without ethernet cable
 a compatible WiFI USB dongle : https://www.kubii.fr/claviers-et-peripheriques-usb/64-module-wi-fi-usb-wi-pi-pour-raspberry-pi-kubii-3170111000385.html

> **If you have a version of Raspberry Pi < 3**, you will need a second Wifi USB dongle to create the access point (AP):
> Dont use any WiFi USB Dongle based on a chip that is not compatible with the AP mode - bug detected,
> Check the model of your dongle's chip
> then check on this list of existing chips, on the AP colomn, if your chip model is compatible with AP mode : https://wikidevi.com/wiki/Category:Linux_driver/802dot11 .
> For any chip model, you can get the list of WiFi dongles based on it : for example, these WiFi dongles are not compatible: https://wikidevi.com/wiki/Rtl8192cu
> these are example of compatible chips : brcmfmac, or rt2800usb. Check here (compatible models) : https://wikidevi.com/wiki/Brcmfmac , https://wikidevi.com/wiki/Rt2800usb

  * Radio antenna to expand the FM broadcast

==== OPTIONAL HARDWARE ====

  * battery for mobile streams, or solar panels
    https://www.kubii.fr/14-chargeurs-alimentations-raspberry/1670-power-bank-li-polymer-15-000-mah-555-wh-kubii-3272496005013.html
  * sound recorder (type zoom H4N pro / H2N) or microphones, to broadcast soundscapes

==== Also required : ====


[[https://www.icecast.org/|icecast]] server needed for upstream !

==== REQUIRED FOR THE INSTALLATION PHASE ====

  * monitor + HDMI + keyboard
  * a computer
  * internet RJ45 cable
  * internet

===== STEP BY STEP INSTALLATION =====

==== PRELIMINARIES ====

=== Download Raspbian image ===

If you have a raspberry pi 3B then download Raspbian stretch lite : https://downloads.raspberrypi.org/raspbian_lite_latest

=== Writing Raspian image to an SD card ===


Install image disc (.img) by following carefully https://www.raspberrypi.org/documentation/installation/installing-images/README.md

You will need to use an image writing tool to burn the image you have downloaded on your SD card.

=== burn on Linux / Windows / Mac ===

Use etcher : Etcher is a graphical SD card writing tool that works on Mac OS, Linux and Windows, and is the easiest option for most users. Etcher also supports writing images directly from the zip file, without any unzipping required. To write your image with Etcher:

  * Download Etcher and install it.
  * Connect an SD card reader with the SD card inside.
  * Open Etcher and select from your hard drive the Raspberry Pi .img or .zip file you wish to write to the SD card.
  * Select the SD card you wish to write your image to
  * Review your selections and click 'Flash!' to begin writing data to the SD card.

=== an other way to burn on Linux / Mac ===

following https://www.raspberrypi.org/documentation/installation/installing-images/linux.md

get the name of the partition of the sd card

      $ df -h

eject the sd card and redo the command

      $ df -h

For example: sdd, sdb, mmcblk0

then we're ready to use dd. Be careful to indicate the exact address of the SD card, or you will lose all the data on the hard drive if you provide the wrong device name. Make sure the device name is the name of the whole SD card not just a partition.

=== export the image to the SD card with a terminal ===

      $ sudo dd if=2018-04-18-raspbian-stretch.img of=/dev/sdb status=progress bs=1M

(mac users, use a small m for the bs instruction bs=1m or bs=4m)

when done

      $ sudo sync

=== Configuration of Raspbian ===

then eject the SD card and plug it into a raspberry pi, with a keyboard and hdmi monitor

Connect a monitor and a keyboard to the Raspberry Pi. Connect the Raspberry Pi to internet with an ethernet cable.

Switch on the raspberry pi

De