Added HOWTO.md
This commit is contained in:
parent
fc6d97f3a5
commit
1a30d3ec9c
1 changed files with 174 additions and 0 deletions
174
HOWTO.md
Normal file
174
HOWTO.md
Normal 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'`
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue