Improving the oled instructions and configuration file

oled-display/README.md

@@ -0,0 +1,38 @@
+# cpsy-display-ip
+Demonstrates the SSD1306 OLED by showing the IP address on the system boot.
+Originally at https://github.com/mkyas/cpsy-display-ip  and customized for Mechatronics 1 students.
+
+This project contains the file `display-ip.py` that displays an IP
+address on the  SSD1306 OLED screen and the file `display-ip.service`
+that executes the script on boot after the Raspberry Pi is connected
+to a network.
+
+To use the script, you first must connect the screen to the Pi's
+I2C bus.
+
+## Setup
+
+Do the following steps on your Raspberry Pi.
+
+1. Enable I2C in `raspi-config`
+1. Go to your home directory: `cd ~`
+1. Clone this repository to your raspberry pi `git clone https://gitea.cs.ru.is/RU-V207/rover-pi`
+1. Install [pillow](https://python-pillow.org/), numpy, and venv:
+   > sudo apt install python3-venv python3-pil python3-numpy
+1. Create a virtual environment, here called cpsy:
+   > python3 -m venv cpsy   
+1. Edit the generated `pyvenv.cfg` to set `include-system-site-packages = true`
+1. Activate the environment `source cpsy/bin/activate`
+1. Install the display driver: `pip install adafruit-circuitpython-ssd1306`
+1. Edit `display-ip.service`:
+   - Replace `foley` with your user name on the Pi.
+   - the `WorkingDirectory` points to the directory containing `display-ip.py`
+   - the path to python points to your virtual environment
+1. Copy the edited `display-ip.service` to `/etc/systemd/system`
+   ```sudo cp display-ip.service /etc/systemd/system/.```
+1. Enable the service `sudo systemctl enable display-ip.service`
+1. Test by starting the service `sudo systemctl start display-ip.service` which should turn on the screen.
+1. If nothing happens, check on the status with `sudo systemctl status display-ip` and look for error messages.
+1. If you make additional changes to the service file, you may have to reload the `systemd`:
+   ```sudo systemctl daemon-reload   ```
+