Commit 1130fb8c authored by Jakob Moser's avatar Jakob Moser
Browse files

Merge branch 'docs/display' into 'master'

Document how to set up display

See merge request moser/poolpay!21
parents aced0ea7 283971c1
Loading
Loading
Loading
Loading
+20 −3
Original line number Diff line number Diff line
@@ -4,7 +4,7 @@ Maintainer: Jakob Moser <moser@cl.uni-heidelberg.de>

## Setup

### Raspberry Pi
### Base Image

1. Use the official “Raspberry Pi Imager” to flash an SD card
   * Use “Raspberry Pi OS” (the one recommended)
@@ -23,7 +23,7 @@ Maintainer: Jakob Moser <moser@cl.uni-heidelberg.de>
     * Your computer should immediately start acting as a “wired hotspot” now and provide IP address and internet access to the Pi.
5. You can now `ssh jakob@poolpaypi.local` on your main computer and it shoud Just Work™.

#### NFC Reader
### NFC Reader

1. Open `sudo raspi-config`
2. Go to “Interface Options”
@@ -46,7 +46,7 @@ Enabling SPI will place the line `dtparam=spi=on` in the file `/boot/firmware/co
- [Instructions (en)](https://cdn-reichelt.de/documents/datenblatt/C300/SBC-RFID-RC522-MANUAL-08-07-2019.pdf)
</details>

#### Pi as a WiFi hotspot
### WiFi hotspot

1. Plug in a WiFi stick (on the Raspberry Pi 3 Model V1.2, I didn't get the internal WiFi to work as a hotspot, however, that seems to be an issue that only I with my specific Pi have)
2. Create a network manager configuration in `/etc/NetworkManager/system-connection/PoolPayPi.nmconnection`, get the following information ...
@@ -100,6 +100,23 @@ Enabling SPI will place the line `dtparam=spi=on` in the file `/boot/firmware/co

</details>

### Display

1. Connect the display by placing it on the GPIO header
2. Append the following line to `/boot/firmware/config.txt`

    ```ini
    dtoverlay=fbtft,spi0-0,ili9486,width=320,height=480,regwidth=16,reset_pin=25,dc_pin=24,rotate=270
    ```

<details>
<summary>Links</summary>

- [Raspberry Pi Forum post mentioning the line to include in the config (German)](https://forum-raspberrypi.de/forum/thread/55290-displays-mit-spi-anschluss-unter-raspberry-pi-os-bullseye-bookworm/)
- [Device tree overlays README](https://github.com/raspberrypi/firmware/blob/master/boot/overlays/README)
- [RB-TFT3.5 Manual (German)](https://joy-it.net/files/files/Produkte/RB-TFT3.5/RB-TFT-Anleitung_04082020.pdf)
</details>

### Software

Clone the repository (you can use a Project Access Token for that, Settings → Access Tokens) and cd into it.