SETUP FOR VOLUMIO | Pi 3 or 4

  1. Flash SD card with VOLUMIO image. To do this, use e.g. Balena Etcher
  2. Put SDCARD in Pi, connect USB C at back of unit, press orange button to turn on
  3. Give it a moment to do it's thing
  4. Wait for wifi Volumio-###X to appear, connect to it
  5. Wait for Captive Wi-Fi to appear. Stay close to the Pi for strong wifi
  6. If it doesn't work, format your SDCARD, and begin from start
  7. Go through Volumio set-up. If the UI becomes unresponsive after connecting to your wifi, click next, next, done, and wait a moment to let it connect to wifi
  8. Open Volumio app, click on device name, click Next Next... of quick onboarding. The UI might go gray after this, simply wait until it comes back. After another while, the Terms of Service pop up, click accept. Make a free Volumio account and log in (useful! With it you can access the Plugin store)
  9. In the Volumio UI, open Menu --> Network to see IP address. If the UI is lacking menu text, simply wait a bit, and/or go out by swiping right from left edge of screen, and go back in
  10. Go to 192.168.0.###/dev with browser, under SSH click ENABLE / feels like nothing happened. Don't worry, it did
  11. In the Volumio app, go to menu --> button with on/off icon, select Power Off, and wait until shut down is complete (green led on Pi stops blinking). Pull out the USB C cable (this is the only time you need to do it)

    TO SET-UP THE ORANGE ON-OFF BUTTON
  12. Take out SDCARD and put in PC/MAC
  13. Download userconfig.txt (save link as...) and copy to SDCARD
  14. Put SDCARD back in the Pi and press the orange button to turn on (From now on, pressing the orange button turns on the Pi when it is off and initiates shut down when its on. After shut down is complete, the power to the Pi is turned off (yes!)

    TO INSTALL FAN CONTROL
  15. Open Windows File Explorer or Mac Finder
  16. Go to \\yourplayername.local
  17. Download fan_sw_PWM (save link as...), unzip, and copy to Internal Storage

    SOFTWARE PWM
    Works fine! And it is more easy to configure the temperature limits. But for the inclined, hardware PWM is available, too. Jump to step 22 to set it up with hardware PWM.
    SSH TO PI
  18. SSH to 192.168.0.### with PuTTY or PiHelper (username: volumio, password: volumio, port 22)

    RUN THE COMMANDS
    /hint/ commands can be copied to the terminal by CTRL-C, then right mouse click into the terminal
    sudo apt update
    sudo apt install python3-rpi.gpio
    sudo cp -R /mnt/INTERNAL/fan_sw_PWM /home

    EDIT rc.local FOR AUTOSTART
    sudo nano /etc/rc.local
  19. Above "exit 0", add
    python3 /home/fan_sw_PWM/fan_control.py &
  20. CTRL-X, Y, ENTER
  21. TO SEE IF IT WORKS, TYPE
    sudo /etc/rc.local

    The fan should spin down to idle speed now.

    PARAMETER FOR SOFTWARE PWM
    TEMP, RPM: 45°, 10%
    TEMP, RPM: 70°, 100%

    The parameter can be set in the file fan_control.py, by sudo nano fan_control.py

    SET-UP BUTTON FUNCTION within Volumio app with the Plugin 'GPIO Buttons', under System Hardware
    Enable Play/Pause GPIO Pin 4
    Enable Vol+ GPIO Pin 24
    Enable Vol- GPIO Pin 23

    ALTERNATIVE FAN CONTROL: HARDWARE PWM
  22. Download fan_hw_PWM (save link as...), unzip, and copy contents to \\yourplayername.local\USB (attention: not into the folder named after the connected SSD)
  23. SSH to Pi, run commands:
    sudo apt update
    sudo apt install zip
    cd /media/fan_hw_PWM
    sudo unzip -o WiringPi-master.zip -d WiringPi
    /Must unzip from within terminal. Unzipping in windows causes fail/
    sudo apt-get install build-essential
    cd WiringPi/WiringPi-master
    sudo ./build
    sudo mkdir -p /opt/gpio/fan
    cd /media/fan_hw_PWM/raspberrypi-fan-control-main/build
    sudo cp params.conf /opt/gpio/fan
    sudo cp fan-control /opt/gpio/fan
    cd /media/fan_hw_PWM/raspberrypi-fan-control-main/service
    sudo cp fan-control.service /etc/systemd/system
    sudo apt install libsystemd-dev
    sudo systemctl enable fan-control
    sudo systemctl start fan-control

    PARAMETER FOR HARDWARE PWM
    TEMP, RPM: 40°, 1000
    TEMP, RPM: 60°, 5000
    ENJOY

SETUP FOR VOLUMIO | Pi 5

  1. Flash SD card with VOLUMIO image. To do this, use e.g. Balena Etcher
  2. Put SDCARD in Pi, connect USB C at back of unit, press orange button to turn on
  3. Give it a moment to do it's thing
  4. Wait for wifi Volumio-###X to appear, connect to it
  5. Wait for Captive Wi-Fi to appear. Stay close to the Pi for strong wifi
  6. If it doesn't work, format your SDCARD, and begin from start
  7. Go through Volumio set-up. If the UI becomes unresponsive after connecting to your wifi, click next, next, done, and wait a moment to let it connect to wifi
  8. Open Volumio app, click on device name, click Next Next... of quick onboarding. The UI may go gray after this, simply wait until it comes back. After another while, the Terms of Service pop up, click accept. Make a free Volumio account and log in (useful! With it you can access the Plugin store)
  9. In the Volumio UI, open Menu --> Network to see IP address. If the UI is lacking menu text, simply wait a bit, and/or go out by swiping right from left edge of screen, and go back in
  10. Go to 192.168.0.###/dev with browser, under SSH click ENABLE / feels like nothing happened. Don't worry, it did
  11. In the Volumio app, go to menu --> button with on/off icon, select Power Off, and wait until shut down is complete (green led on Pi stops blinking). Pull out the USB C cable (this is the only time you need to do it)

    TO SET-UP THE ORANGE ON-OFF BUTTON
  12. Take out SDCARD and put in PC/MAC
  13. Download userconfigPi5.txt (save link as...). Rename to userconfig.txt, then copy to SDCARD
  14. Put SDCARD back in the Pi and press the orange button to turn on (From now on, pressing the orange button turns on the Pi when it is off and initiates shut down when its on. After shut down is complete, the power to the Pi is turned off (yes!)

    TO INSTALL FAN CONTROL
  15. Open Windows File Explorer or Mac Finder
  16. Go to \\yourplayername.local
  17. Dowload fan_sw_PWM (save link as...), unzip, then copy to Internal Storage

    SOFTWARE PWM.
    /The Hardware PWM code for the Pi 3 or 4 does not work on the Pi 5./
    SSH TO PI
  18. SSH to 192.168.0.### with PuTTY or PiHelper (username: volumio, password: volumio, port 22)

    RUN THE COMMANDS
    /hint/ commands can be copied to the terminal by CTRL-C, then right mouse click into the terminal
    sudo apt update
    sudo apt install python3-rpi.gpio
    sudo apt install python3-pip
    sudo apt install zip
    sudo cp -R /mnt/INTERNAL/fan_sw_PWM /home

    WIZARDRY TO MAKE THE RPI.GPIO library work with the Pi5
    SSH to the Pi
    /hint/ triple mouse click on the text to mark
    sudo apt install swig python-dev python3-dev
    sudo apt install python-setuptools python3-setuptools
    wget http://abyz.me.uk/lg/lg.zip
    unzip lg.zip
    cd lg
    sudo make
    sudo make install
    sudo pip3 install rpi-lgpio

    EDIT rc.local FOR AUTOSTART
    sudo nano /etc/rc.local
  19. Above "exit 0", add
    python3 /home/fan_sw_PWM/fan_control.py &
  20. CTRL-X, Y, ENTER
  21. TO SEE IF IT WORKS, TYPE
    sudo /etc/rc.local

    The fan should spin down to idle speed now.

    PARAMETER FOR SOFTWARE PWM
    TEMP, RPM: 45°, 10%
    TEMP, RPM: 70°, 100%

    The parameter can be set in the file fan_control.py, by sudo nano fan_control.py

    INSTALL BUTTON CONTROL
    sudo nano /etc/triggerhappy/triggers.d/audio.conf
  22. PUT BELOW TEXT AT TOP OF FILE
    #PLAY PAUSE TOGGLE
    KEY_SPACE 1 /usr/local/bin/volumio toggle
    #VOLUME DOWN
    KEY_DOWN 1 /usr/local/bin/volumio volume minus
    #VOLUME UP
    KEY_UP 1 /usr/local/bin/volumio volume plus
  23. CTRL-X, Y, ENTER
    sudo systemctl restart triggerhappy
  24. TO SEE IN THE TERMINAL IF IT WORKS, TYPE
    sudo thd --dump /dev/input/event*
  25. PRESS BUTTONS AND WATCH THE MAGIC HAPPEN
    ENJOY