frame/setup.md
2026-05-04 23:04:08 +01:00

47 lines
1.3 KiB
Markdown

# Pi setup
Flash an image using the [Raspberry Pi imager](https://www.raspberrypi.com/software/). I picked Raspberry Pi OS Lite (based on Debian Trixie) and set up WiFi & SSH from the Customisation settings.
## First commands
```sh
sudo raspi-config # Then select: Interface Options -> SPI -> Enable
sudo apt update && sudo apt upgrade
sudo apt install -y python3-pip python3-pil python3-smbus python3-numba
sudo systemctl mask swap.target
sudo systemctl disable --now bluetooth
sudo nmcli c modify <your-connection> 802-11-wireless.powersave 2
```
Reduce SD card writes by setting `Storage=volatile` in `/etc/systemd/journald.conf`.
## Deploying
Ensure [.env](src/.env) has the correct paths and then run:
`./sync.sh`
> That rsyncs `src/` over.
## Setting up cron
In `crontab -e`, add:
```
*/15 * * * * cd ~/frame && python3 display.py -o 90 >> ~/frame.log 2>&1
```
### Optionally, to monitor the wifi connection:
In `sudo crontab -e`, add:
```
@reboot /usr/sbin/iw wlan0 set power_save off
*/5 * * * * /home/<user>/frame/wifi-check.sh >> /home/<user>/wifi.log 2>&1
```
## Hardware notes
The driver in `src/lib/waveshare_epd/` is adapted from Waveshare's [PhotoPainter](https://www.waveshare.com/wiki/PhotoPainter) project. That wiki page has the wiring, init sequence, and 6-colour palette docs.