cable and reboot recommendation

README.md

@@ -13,8 +13,8 @@ Scripts and documentation for setting up a Raspberry Pi (Zero W 1 or 2) for use
    ```
 
 1. [Gadget Mode to setup a serial connection over USB](gadget.md)
-1. [Marcel's script on github to show the IP address on the OLED screen](https://github.com/mkyas/cpsy-display-ip)
+1. [Setup the OLED screen to print the IP](oled-display/README.md)
-
+   Based upon [Marcel's script on github to show the IP address on the OLED screen](https://github.com/mkyas/cpsy-display-ip)
 1. Install Blinka by following the guide [CircuitPython Libraries on Linux and Raspberry Pi](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux/installing-circuitpython-on-raspberry-pi)]
 
 ## RU student-only guides at ROB-IOT

Scripts/serial-ether-gadget.service

@@ -1,6 +1,7 @@
 [Unit]
 Description=Serial and Ethernet over OTG USB
-After=systemd-user-sessions.service
+#After=systemd-user-sessions.service
+Before=serial-getty@ttyGS0.service
 [Service]
 ExecStart=/root/rover-pi/Scripts/gadget.sh
 [Install]

gadget.md

@@ -5,8 +5,8 @@ Based upon Adafruit guide: https://learn.adafruit.com/turning-your-raspberry-pi-
 The author discovered the guide was out of date, consulted the [2025 Raspberry Pi whitepaper on OTG](https://pip-assets.raspberrypi.com/categories/685-app-notes-guides-whitepapers/documents/RP-009276-WP/Using-OTG-mode-on-Raspberry-Pi-SBCs), found additional errors, and was finally able to correct them thanks to this blog https://www.isticktoit.net/?p=1383
 
 ## Important :
-- Some of the serial cables we get from our supplier are flakey:  if wiggling the cable when plugged into your computer causes it to sometimes see the serial port and sometimes not, get a new one.
 - **Using the Gadget Mode will make the usb port unable to connect to a mouse or keyboard!!!** You will need to disable it make them work again.
+- The blue USB cables included in the kit in 2026 are flakey.  We recommend replacing them ASAP.
 - You will want to disable the serial console on RX/TX in `raspi-config` if you are trying to use that serial port for communicating with other devices.
 
 
@@ -31,15 +31,17 @@ echo "dwc2" >> /etc/modules
 modprobe libcomposite
 ```
 1. Reboot
-1. Open a new connection and become root (the superuser)
+```
+restart now
+```
+1. Become root again
 ```
 sudo su
 ```
-
 1. Put a copy of this repository in root's home directory using git
 ```
-apt install -y git
 cd /root
+apt install -y git
 git clone https://gitea.cs.ru.is/RU-V207/rover-pi.git
 ```
 1. Go to Scripts and test if the `gadget.sh` runs without errors and hopefully a Serial port appers in Device Manager or equivalent

oled-display/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Marcel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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   ```
+

oled-display/display-ip.py

@@ -0,0 +1,78 @@
+# SPDX-FileCopyrightText: 2021 ladyada for Adafruit Industries
+# SPDX-License-Identifier: MIT
+
+"""
+This demo will fill the screen with white, draw a black box on top
+and then print the device's IP address in the center of the display
+
+This example is for use on (Linux) computers that are using CPython with
+Adafruit Blinka to support CircuitPython libraries. CircuitPython does
+not support PIL/pillow (python imaging library)!
+"""
+
+import board
+import digitalio
+from PIL import Image, ImageDraw, ImageFont
+import adafruit_ssd1306
+import socket
+
+# Define the Reset Pin
+oled_reset = None
+try:
+    oled_reset = digitalio.DigitalInOut(board.D4)
+except:
+    pass
+    # No reset pin
+
+# Change these
+# to the right size for your display!
+WIDTH = 128
+HEIGHT = 64
+BORDER = 5
+
+# Use for I2C.
+i2c = board.I2C()  # uses board.SCL and board.SDA
+oled = adafruit_ssd1306.SSD1306_I2C(WIDTH, HEIGHT, i2c, addr=0x3C, reset=oled_reset)
+
+# Clear display.
+oled.fill(0)
+oled.show()
+
+# Create blank image for drawing.
+# Make sure to create image with mode '1' for 1-bit color.
+image = Image.new("1", (oled.width, oled.height))
+
+# Get drawing object to draw on image.
+draw = ImageDraw.Draw(image)
+
+# Draw a white background
+draw.rectangle((0, 0, oled.width, oled.height), outline=255, fill=255)
+
+# Draw a smaller inner rectangle
+draw.rectangle(
+    (BORDER, BORDER, oled.width - BORDER - 1, oled.height - BORDER - 1),
+    outline=0,
+    fill=0,
+)
+
+# Load default font.
+font = ImageFont.load_default()
+
+# Get the local IP address as a string.
+with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as s:
+    s.connect(("8.8.8.8", 80))
+    text = s.getsockname()[0]
+
+# Draw it into a box.
+bbox = font.getbbox(text)
+(font_width, font_height) = bbox[2] - bbox[0], bbox[3] - bbox[1]
+draw.text(
+    (oled.width // 2 - font_width // 2, oled.height // 2 - font_height // 2),
+    text,
+    font=font,
+    fill=255,
+)
+
+# Display image
+oled.image(image)
+oled.show()

oled-display/display-ip.service

@@ -0,0 +1,13 @@
+[Unit]
+Description=display-ip
+After=network-online.target
+
+[Service]
+Type=simple
+User=foley
+WorkingDirectory=/home/foley/rover-pi/oled-display
+ExecStart=/home/foley/cpsy/bin/python3 display-ip.py
+Restart=never
+
+[Install]
+WantedBy=multi-user.target