From f8dac3c07f800b669db05eedcb938923d63d2796 Mon Sep 17 00:00:00 2001 From: Joseph Timothy Foley Date: Thu, 2 Jul 2026 09:33:56 +0000 Subject: [PATCH] Testing code formatting --- gadget.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/gadget.md b/gadget.md index 999c8dc..d9a893a 100644 --- a/gadget.md +++ b/gadget.md @@ -1,11 +1,16 @@ # Gadget Mode to setup a serial connection over USB Prepare Raspberry Pi OS connection over a microUSB serial cable -Important: You will want to disable the serial console on RX/TX if you are trying to use that serial port for communicating with other devices. - Based upon Adafruit guide: https://learn.adafruit.com/turning-your-raspberry-pi-zero-into-a-usb-gadget/serial-gadget: 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 : +- **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. +- 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. + + +## Procedure + Make sure you have your USB cable plugged into the left port **USB** and not the right port marked **PWR**. 1. Open a connection to the device via ssh or Raspberry Pi Connect 1. Become root (the superuser) @@ -13,9 +18,9 @@ Make sure you have your USB cable plugged into the left port **USB** and not the 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 - ``` +``` +echo "dtoverlay=dwc2" >> /boot/firmware/config.txt +``` 1. We add the required module `dwc2` for loading at startup ``` echo "dwc2" >> /etc/modules