luniebox/INSTALL.md

Manual installation

Manual installation of your luniebox. If you haven't read, please go back to the README for hardware requirements, prerequisites and setup. (This is basically a step-by-step guide of the luniebox.sh script.)

Software

• go to home directory

  cd /home/pi
  

• install git, python3-venv and python3-pip

  sudo apt install -y git python3-venv python3-pip
  

• clone repository https://git.bstly.de/Lurkars/luniebox.git with sources and config:

  git clone https://git.bstly.de/Lurkars/luniebox.git luniebox
  

luniebox application and daemon

• setup application by building python venv and configure systemd service

  cd /home/pi/luniebox/application
  
  python -m venv venv
  
  source venv/bin/activate
  
  export CFLAGS=-fcommon
  
  pip install -r requirements.txt
  
  deactivate
  
  mkdir /home/pi/luniebox/config
  
  cp /home/pi/luniebox/contrib/config/luniebox.cfg /home/pi/luniebox/config/luniebox.cfg
  
  sudo cp /home/pi/luniebox/contrib/service/luniebox-app.service /etc/systemd/system/
  
  sudo cp /home/pi/luniebox/contrib/service/luniebox-daemon.service /etc/systemd/system/
  
  sudo systemctl daemon-reload
  
  sudo systemctl enable luniebox-app luniebox-daemon
  

Spotify

For Spotify support, spofiyd is required.

• get spotifyd binary and configure systemd service

  mkdir /home/pi/luniebox/bin`
  
  wget -c https://github.com/Spotifyd/spotifyd/releases/download/v0.3.3/spotifyd-linux-armv6-slim.tar.gz -O - | tar -xz -C /home/pi/luniebox/bin
  
  cp /home/pi/luniebox/contrib/config/spotifyd.cfg /home/pi/luniebox/config/spotifyd.cfg
  
  sudo cp /home/pi/luniebox/contrib/service/spotifyd.service /etc/systemd/system/`
  
  sudo systemctl daemon-reload`
  
  sudo systemctl enable spotifyd
  

ℹ️ If you use other audio hardware, you may need to adjust the backend and device property in /home/pi/luniebox/config/spotifyd.cfg to your needs!

Music Player Daemon

for offline file support install Music Player Daemon (mpd)

• create library folder and install mpd

  mkdir /home/pi/luniebox/library
  
  sudo apt install -y mpd
  
  sudo cp /home/pi/luniebox/contrib/config/mpd.conf /etc/mpd.conf
  

ℹ️ If you use other audio hardware, you may need to adjust the audio_output in /etc/mpc.conf section to your needs!

ClSpotify

for Spotify offline support install ClSpotify (requires spotify and mpd!).

• get code, install pythen venv and update config

  git clone https://github.com/agent255/clspotify.git /home/pi/clspotify
  
  cd /home/pi/clspotify
  
  python -m venv venv
  
  source venv/bin/activate
  
  pip install -r requirements.txt
  
  deactivate
  
  sed -i "s/^zspotify_path =.*$/zspotify_path = \/home\/pi\/clspotify\//" /home/pi/luniebox/config/luniebox.cfg
  

Hardware

RC522 RFID Reader

• uncomment dtparam=spi=on in /boot/config.txt tp enable SPI for RC522

  sudo sed -i "/dtparam=spi=on/s/^#//g" /boot/config.txt
  

• connect RC522

  • SDA to Pin 24 [GPIO 8 / SPI0 CE0]
  • SCK to Pin 23 [GPIO 11 / SPI0 SCLK / CLK]
  • MOSI to Pin 19 [GPIO 10 / SPI0 MOSI]
  • MISO to Pin 21 [GPIO 9 / SPI0 MISO]
  • GND to Pin 20 [Ground]
  • RST to Pin 22 [GPIO 25]
  • 3.3v to Pin 1 [3v3 Power]

Pimoroni Amp or DAC

• disable onboard audio comment out dtparam=audio=on in /boot/config.txt

  sudo sed -i "/dtparam=audio=on/s/^/#/g" /boot/config.txt
  

• setup hifiberry-dac by adding following content to /boot/config.txt

  # setup hifiberry for Pimoroni Shim
  dtoverlay=hifiberry-dac
  gpio=25=op,dh
  

  printf "\n# setup hifiberry for Pimoroni Shim\ndtoverlay=hifiberry-dac\ngpio=25=op,dh\n" | sudo tee -a /boot/config.txt
  

Adafruit Speaker Bonnet for Raspberry Pi

• disable onboard audio comment out dtparam=audio=on in /boot/config.txt

  sudo sed -i "/dtparam=audio=on/s/^/#/g" /boot/config.txt
  

• setup hifiberry-dac and i2s by adding following content to /boot/config.txt

  # setup hifiberry and i2s for Adafruit Speaker Bonnet
  dtoverlay=hifiberry-dac
  dtoverlay=i2s-mmap
  

  printf "\n# setup hifiberry and i2s for Adafruit Speaker Bonnet\ndtoverlay=hifiberry-dac\ndtoverlay=i2s-mmap\n" | sudo tee -a /boot/config.txt
  

• copy contrib/config/adafruit/asound.conf to /etc/asound.conf.

  cat /home/pi/luniebox/contrib/config/adafruit/asound.conf | sudo tee /etc/asound.conf
  

• copy contrib/config/adafruit/.asoundrc to /home/pi/.asoundrc.

  cat /home/pi/luniebox/contrib/config/adafruit/.asoundrc | tee /home/pi/.asoundrc
  

MPU9250 9-axis sensor

• install i2c-tools and python3-smbus

  sudo apt install -y i2c-tools python3-smbus
  

• uncomment dtparam=i2c_arm=on in /boot/config.txt to enable I2C for MPU9250

  sudo sed -i "/dtparam=i2c_arm=on/s/^#//g" /boot/config.txt
  

• setup i2c bus 4 for MPU9250 by adding following content to /boot/config.txt

  # setup ic2 bus 4 for mpu
  dtoverlay=i2c-gpio,bus=4,i2c_gpio_delay_us=1,i2c_gpio_sda=23,i2c_gpio_scl=24
  

  printf "\n# setup i2c bus 4 for mpu\ndtoverlay=i2c-gpio,bus=4,i2c_gpio_delay_us=1,i2c_gpio_sda=23,i2c_gpio_scl=24\n" | sudo tee -a /boot/config.txt
  

Finish installation

• reboot system.

  sudo reboot