Compare commits

...
15 Commits
7 changed files with 178 additions and 108 deletions
+31 -1
View File
@@ -12,7 +12,8 @@ Scripts and documentation for setting up a Raspberry Pi (Zero W 1 or 2) for use
sudo apt-get -y upgrade sudo apt-get -y upgrade
``` ```
1. [Gadget Mode to setup a serial connection over USB](gadget.md) 1. [Gadget Mode to setup a network connection over USB](https://github.com/raspberrypi/rpi-usb-gadget). A more explanatory version in the [Raspberry Pi Newsletter](https://www.raspberrypi.com/news/usb-gadget-mode-in-raspberry-pi-os-ssh-over-usb/)
* If you don't have Internet Connection Sharing, th pi will show up as 10.12.194.1
1. [Setup the OLED screen to print the IP](oled-display/README.md) 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) 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)] 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)]
@@ -48,3 +49,32 @@ Credit: Daníel Bjartur Guðmundsson, transcribed by Joseph T. Foley
1. Show details of "preconfigured" network: nmcli connection show preconfigured 1. Show details of "preconfigured" network: nmcli connection show preconfigured
1. Change the SSID (which wireless network you will connect to) in the "New_SSID": nmcli connection modify preconfigured wifi.ssid "New_SSID" 1. Change the SSID (which wireless network you will connect to) in the "New_SSID": nmcli connection modify preconfigured wifi.ssid "New_SSID"
1. Change the wireless access password in the "New_Password": nmcli connection modify preconfigured wifi-sec.psk "New_Password" 1. Change the wireless access password in the "New_Password": nmcli connection modify preconfigured wifi-sec.psk "New_Password"
## Wifi keeps dropping out. What do I do?
1. `sudo raspi-config`
1. Advanced Options > A12 WLAN Power Save
1. Yes to disabling
## I'd like to stop typing my password all the time
1. Copy your private key to your pi from `~/.ssh/id_*` to the Pi
1. On the Pi, start ssh-agent with
```eval $(ssh-agent)```
1. Now add your key
```ssh-add```
## I'd like to access my pi's files directly on my computer.
In linux, you can use sshfs: https://github.com/libfuse/sshfs
1. Install sshfs
```sudo apt install sshfs```
1. Make a place to mount the files on the pi
```mkdir username-rover```
1. Now we mount the pi's filesystem using sshfs
```sshfs username@host-or-ip /home/username ~/username-rover```
## How do I get the python virtual environment to start each time
1. Edit your `.bashrc` to have this at the end:
```
if [ -f ~/env/bin/activate ]; then
source ~/env/bin/activate
fi
```
+23 -7
View File
@@ -9,20 +9,36 @@ if [ $(id -u) -ne 0 ]; then
exit 1 exit 1
fi fi
if [ -f /boot/firmware/GADGET_MODE ]; then
# Is the dwc2 overlay installed? Nothing will work if it isn't. systemd-cat -t gadget.sh -p info echo "/boot/firmware/GADGET_MODE exists: GADGET mode enabled"
if lsmod | grep -q "dwc2"; then
systemd-cat -t gadget.sh -p info echo "DWC2 module loaded, setting up OTG gadget serial and ethernet"
else else
systemd-cat -t gadget.sh -p warning echo "DWC2 module missing. Aborting OTG setup." systemd-cat -t gadget.sh -p warning echo "/boot/firmware/GADGET_MODE missing: GADGET mode disabled"
systemctl disable serial-getty@ttyGS0.service systemctl disable serial-getty@ttyGS0.service
exit 1 exit 1
fi fi
sudo modprobe libcomposite # Is the dwc2 overlay installed? Nothing will work if it isn't.
<<<<<<< HEAD
if lsmod | grep -q "dwc2"; then
echo "DWC2 module loaded, setting up OTG gadget serial and ethernet" | logger -t $0 -p info
echo "DWC2 module loaded"
=======
if [ -d /sys/class/udc ] && [ -n "$(ls -A /sys/class/udc)" ]; then
systemd-cat -t gadget.sh -p info echo "DWC2 precompiled, setting up OTG gadget serial and ethernet"
elif lsmod | grep -q "dwc2"; then
systemd-cat -t gadget.sh -p info echo "Pre 6.18.39 kernel. DWC2 module loaded, setting up OTG gadget serial and ethernet"
>>>>>>> master
else
echo "DWC2 module missing. Aborting OTG setup." | logger -t $0 -p info
echo "DWC2 module missing"
systemctl disable serial-getty@ttyGS0.service
exit 1
fi
modprobe libcomposite
cd /sys/kernel/config/usb_gadget cd /sys/kernel/config/usb_gadget
if [ -d "MyGadget" ]; then if [ -d "MyGadget" ]; then
systemd-cat -t gadget.sh -p warning echo "MyGadget already exists. Aborting OTG setup." echo "MyGadget already exists. Aborting OTG setup." | logger -t $0 -p info
exit 1 exit 1
fi fi
+39 -22
View File
@@ -5,6 +5,7 @@ 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 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 : ## Important :
- **We are still working out the kinks with the gadget mode switching on the Pi Zero W 2**
- **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. - **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. - 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. - 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.
@@ -18,14 +19,6 @@ Make sure you have your USB cable plugged into the left port **USB** and not the
``` ```
sudo su sudo su
``` ```
1. Enable the DWC version 2 USB peripheral device tree overlay by appending it to the end after the `[all]` category (which is at the end)
```
echo "dtoverlay=dwc2" >> /boot/firmware/config.txt
```
1. We add the required module `dwc2` for loading at startup
```
echo "dwc2" >> /etc/modules
```
1. Check that we can load the libcomposite module 1. Check that we can load the libcomposite module
``` ```
modprobe libcomposite modprobe libcomposite
@@ -94,7 +87,44 @@ This is similar to the procedure for accessing an Arduino.
``` ```
1. Press enter and you will be prompted to log in to the Pi with default credentials. User: pi - PW: raspberry 1. Press enter and you will be prompted to log in to the Pi with default credentials. User: pi - PW: raspberry
# Disabling the OTG mode to use a keyboard and mouse again # Enabling/Disabling the OTG mode to use a keyboard and mouse again
## Disable
1. Remove the SD card and access it on your computer
1. Delete the file called `GADGET_MODE` in the boot partition/drive usually called `bootfs`.
1. If the Pi is booted, you can `sudo rm /boot/firmware/GADGET_MODE` and reboot.
## Enable
1. Remove the SD card and access it on your computer
1. Create a file called `GADGET_MODE` in the boot partition/drive called `bootfs`.
2. If the Pi is booted, you can `sudo touch /boot/firmware/GADGET_MODE` and reboot
# Connecting over the USB ethernet to ssh into your Pi
I have not tested this procedure because the serial console and normal network connection is sufficient for me --foley
https://www.raspberrypi.com/news/usb-gadget-mode-in-raspberry-pi-os-ssh-over-usb/
# Untested
Here are items that bear investigating but haven't been tested yet
- [Modify Imager manifest to install otg](https://github.com/raspberrypi/rpi-imager/tree/main/doc/local_json)
# Old DWC Instructions (for older versions)
## Setting up
1. Enable the DWC version 2 USB peripheral device tree overlay by appending it to the end after the `[all]` category (which is at the end)
```
echo "dtoverlay=dwc2" >> /boot/firmware/config.txt
```
1. We add the required module `dwc2` for loading at startup
```
echo "dwc2" >> /etc/modules
```
## Disabling the OTG mode to use a keyboard and mouse again
**WARNING: Untested** **WARNING: Untested**
1. Comment out the dwg2 line in `/boot/firmware/config.txt` using a `#` in front of the line 1. Comment out the dwg2 line in `/boot/firmware/config.txt` using a `#` in front of the line
@@ -114,16 +144,3 @@ This is similar to the procedure for accessing an Arduino.
``` ```
systemctl disable serial-getty@ttyGS0.service systemctl disable serial-getty@ttyGS0.service
``` ```
# Connecting over the USB ethernet to ssh into your Pi
I have not tested this procedure because the serial console and normal network connection is sufficient for me --foley
https://www.raspberrypi.com/news/usb-gadget-mode-in-raspberry-pi-os-ssh-over-usb/
# Untested
Here are items that bear investigating but haven't been tested yet
- [Modify Imager manifest to install otg](https://github.com/raspberrypi/rpi-imager/tree/main/doc/local_json)
-19
View File
@@ -1,19 +0,0 @@
#!/usr/bin/python
# From https://raspberry.tips/en/raspberrypi-tutorials/raspberry-pi-gpio-python
import lgpio
import time
# Open GPIO chip (0 = /dev/gpiochip0, on Pi 5 gpiochip4 also possible)
h = lgpio.gpiochip_open(0)
try:
lgpio.gpio_claim_output(h, 18) # GPIO18 (pin 12) as output (MOTA1)
for _ in range(5):
lgpio.gpio_write(h, 18, 1) # HIGH
time.sleep(0.5)
lgpio.gpio_write(h, 18, 0) # LOW
time.sleep(0.5)
finally:
lgpio.gpiochip_close(h) # Always close!
-34
View File
@@ -1,34 +0,0 @@
#!/usr/bin/python
# This test assumes you are trying to control a motor through a DRV8833 motor
# controller chip. This general approach should work for other motors as well.
import lgpio
import time
# pin assignments
gpio_pwm = 18 #MOTA1
gpio_reverse = 16 #MOTA2
gpio_notsleep = 24 #MSLEEP
# parameters
pwm_freq = 1000
h = lgpio.gpiochip_open(0)
try:
lgpio.gpio_claim_output(h, gpio_reverse)
lgpio.gpio_claim_output(h, gpio_notsleep)
lgpio.gpio_write(h, gpio_reverse, 0) # low on reverse pin to turn off h-bridge MOTA2
lgpio.gpio_write(h, gpio_notsleep, 1) # high on /sleep to enable both h-bridges
while True:
for pwm_level in range(0,100):
lgpio.tx_pwm(h, gpio_pwm, pwm_freq, pwm_level)
pwm_level += 10
time.sleep(0.05)
for pwm_level in range(100,0,-1):
lgpio.tx_pwm(h, gpio_pwm, pwm_freq, pwm_level)
pwm_level += 10
time.sleep(0.05)
finally:
lgpio.gpio_write(h, gpio_notsleep, 1) # high on /sleep to disable
lgpio.gpiochip_close(h) # Always close!
-25
View File
@@ -1,25 +0,0 @@
#!/usr/bin/python
# From https://raspberry.tips/en/raspberrypi-tutorials/raspberry-pi-gpio-python
import lgpio
import time
# Open GPIO chip (0 = /dev/gpiochip0, on Pi 5 gpiochip4 also possible)
h = lgpio.gpiochip_open(0)
# Hardware PWM on GPIO18 (pin 12) must be PWM-capable
pwm_pin = 18
pwm_freq = 1000
try:
while True:
for pwm_level in range(0,100):
lgpio.tx_pwm(h, pwm_pin, pwm_freq, pwm_level)
pwm_level += 10
time.sleep(0.05)
for pwm_level in range(100,0,-1):
lgpio.tx_pwm(h, pwm_pin, pwm_freq, pwm_level)
pwm_level += 10
time.sleep(0.05)
finally:
lgpio.tx_pwm(h, pwm_pin, 0, 0) # Stop PWM
lgpio.gpiochip_close(h) # Always close!
+85
View File
@@ -0,0 +1,85 @@
# 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 hostname and 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
import platform
# 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))
ipaddr = s.getsockname()[0]
hostname = platform.node()
text = hostname + "\n" + ipaddr
bbox = font.getbbox(ipaddr)
(font_width, font_height) = bbox[2] - bbox[0], bbox[3] - bbox[1]
draw.multiline_text(
xy=(10,10),
text=text,
fill=255,
font=font,
spacing=2, #pixel gap between lines,
align="left",
)
# Display image
oled.image(image)
oled.show()