Added HOWTO.md

This commit is contained in:
jpunkt 2021-11-02 18:01:16 +01:00
parent fc6d97f3a5
commit 1a30d3ec9c

174
HOWTO.md Normal file
View file

@ -0,0 +1,174 @@
# Setup Pizzabox
## Materials:
- Raspberry Pi 3B+ with [Pimoroni On/Off SHIM](https://shop.pimoroni.com/products/onoff-shim)
- Raspberry Pi OS Lite 2021-05-07
- *(later)* Raspberry Pi Pico, connected via UART and power
- USB Soundcard
## Resources:
- [official raspberry pi](https://www.raspberrypi.org/documentation/usage/gpio/)
- [interactive pinout documentation](https://pinout.xyz/pinout/onoff_shim#)
## Initial Configuration:
### Before First Boot
- Enable ssh:
cd <media/user>/boot
touch ssh
- Set fixed fallback ip on eth0:
cd <media/user>/rootfs/etc
sudo nano dhcpcd.conf
Uncomment the following lines:
profile static_eth0
static ip_address=10.10.0.23/24
interface eth0
fallback static_eth0
### First Boot
- Hook up pi to configuration system via ethernet, screen is optional. Insert SD-card, plug in OnOff SHIM
- Connect via ssh:
ssh pi@10.10.0.23
- Use raspi-config tool to
* *(optional)* set up WiFi and connect (for updates, ...)
* enable camera
* enable serial
* change password to `pizzabox`
Apply changes and reboot.
### Install Software
- Update system
sudo apt update
sudo apt full-upgrade
- Install python libraries:
sudo apt install git python3-picamera python3-gpiozero python3-pip python3-setuptools python3-serial
- Update NumPy:
pip3 install numpy --upgrade
To fix bug with NumPy dependencies on Raspberry Pi install libatlas [source](https://numpy.org/devdocs/user/troubleshooting-importerror.html):
sudo apt-get install libatlas-base-dev
- Install dependencies for python `sounddevice` library:
sudo apt install libportaudio2
- Install `gpac` for the video convertion tool *MP4Box*:
sudo apt install gpac
- Install `pydub` python library for mp3 support:
pip3 install pydub
### Install Soundcard and Make Default
- Set external soundcard as default [how-to](https://www.raspberrypi-spy.co.uk/2019/06/using-a-usb-audio-device-with-the-raspberry-pi/)
- When hotplugged, the sound card may not be activated. If true, reboot.
- To see if the sound card was registered, run
aplay -l
Produces output similar to
**** List of PLAYBACK Hardware Devices ****
card 0: b1 [bcm2835 HDMI 1], device 0: bcm2835 HDMI 1 [bcm2835 HDMI 1]
Subdevices: 4/4
Subdevice #0: subdevice #0
Subdevice #1: subdevice #1
Subdevice #2: subdevice #2
Subdevice #3: subdevice #3
card 1: Headphones [bcm2835 Headphones], device 0: bcm2835 Headphones [bcm2835 Headphones]
Subdevices: 4/4
Subdevice #0: subdevice #0
Subdevice #1: subdevice #1
Subdevice #2: subdevice #2
Subdevice #3: subdevice #3
card 2: Device [USB PnP Sound Device], device 0: USB Audio [USB Audio]
Subdevices: 1/1
Subdevice #0: subdevice #0
`card 2` is the usb sound card.
- Edit the file `/usr/share/alsa/alsa.conf`:
Change the following lines (change the `0` to `2`)
defaults.ctl.card 2
defaults.pcm.card 2
- Test the speakers:
speaker-test -c2
Should play white noise on the left and right channel.
- Test the mic:
arecord -d 10 -f cd -t wav test.wav
aplay test.wav
- To set gain levels etc. run:
alsamixer
## Set Up Camera
- Plug in camera with ribbon cable (requires reboot)
- Test camera (with screen plugged in):
raspistill -t 1 -o test.jpg
Download test.jpg using sftp.
## Set Up OnOff Shim:
- Use the one-line installer:
curl https://get.pimoroni.com/onoffshim | bash
## Python Development on Raspi (pizzabox-main)
- clone github repository `https://git.theater.digital/johannes.payr/pizzabox-main.git`
- *(For now)* Use Pycharm. Set up remote python interpreter on raspberry pi:
SSH Server: 10.10.0.23
User Name: pi
Path: /usr/bin/python3
- install missing packages: `'click', 'sounddevice', 'soundfile', 'scipy'`