Merge pull request #3024 from FoamyGuy/usbhost_snespad_arduino_2

add support for Metro rp2350 USB SNES-like controller

Author: FoamyGuy

Diff for: USB_SNES_Gamepad/Arduino_Feather_RP2040_USB_Host/snes_gamepad_simpletest/snes_gamepad_simpletest.ino

@@ -48,49 +48,25 @@ hid_gamepad_report_t gp;
 bool printed_blank = false;
 
 void setup() {
-  if (!TinyUSBDevice.isInitialized()) {
-    TinyUSBDevice.begin(0);
-  }
   Serial.begin(115200);
-  // Setup HID
-  usb_hid.setPollInterval(2);
-  usb_hid.setReportDescriptor(desc_hid_report, sizeof(desc_hid_report));
-  usb_hid.begin();
-
-  // If already enumerated, additional class driver begin() e.g msc, hid, midi won't take effect until re-enumeration
-  if (TinyUSBDevice.mounted()) {
-    TinyUSBDevice.detach();
-    delay(10);
-    TinyUSBDevice.attach();
-  }
-}
-
-#if defined(ARDUINO_ARCH_RP2040)
-//--------------------------------------------------------------------+
-// For RP2040 use both core0 for device stack, core1 for host stack
-//--------------------------------------------------------------------//
-
-//------------- Core0 -------------//
-void loop() {
-}
 
-//------------- Core1 -------------//
-void setup1() {
   // configure pio-usb: defined in usbh_helper.h
   rp2040_configure_pio_usb();
 
   // run host stack on controller (rhport) 1
-  // Note: For rp2040 pico-pio-usb, calling USBHost.begin() on core1 will have most of the
-  // host bit-banging processing works done in core1 to free up core0 for other works
   USBHost.begin(1);
+  delay(3000);
+  Serial.print("USB D+ Pin:");
+  Serial.println(PIN_USB_HOST_DP);
+  Serial.print("USB 5V Pin:");
+  Serial.println(PIN_5V_EN);
 }
 
-void loop1() {
+void loop() {
   USBHost.task();
   Serial.flush();
 
 }
-#endif
 
 //--------------------------------------------------------------------+
 // HID Host Callback Functions
@@ -112,16 +88,15 @@ void tuh_hid_umount_cb(uint8_t dev_addr, uint8_t instance)
   Serial.printf("HID device unmounted (address %d, instance %d)\n", dev_addr, instance);
 }
 
-
 void tuh_hid_report_received_cb(uint8_t dev_addr, uint8_t instance, uint8_t const* report, uint16_t len) {
 
     if (report[BYTE_DPAD_LEFT_RIGHT] != DPAD_NEUTRAL ||
         report[BYTE_DPAD_UP_DOWN] != DPAD_NEUTRAL ||
         report[BYTE_ABXY_BUTTONS] != BUTTON_NEUTRAL ||
         report[BYTE_OTHER_BUTTONS] != BUTTON_MISC_NEUTRAL){
-      
+
       printed_blank = false;
-      
+
       //debug print report data
       // Serial.print("Report data: ");
       // for (int i = 0; i < len; i++) {

Diff for: USB_SNES_Gamepad/Arduino_Feather_RP2040_USB_Host/snes_gamepad_simpletest/usbh_helper.h

@@ -35,6 +35,26 @@
   #endif
 #endif // ARDUINO_ARCH_RP2040
 
+#ifdef ARDUINO_ARCH_RP2350
+
+  // pio-usb is required for rp2040 host
+  #include "pio_usb.h"
+
+  // Pin D+ for host, D- = D+ + 1
+  #ifndef PIN_USB_HOST_DP
+  #define PIN_USB_HOST_DP  32
+  #endif
+
+  // Pin for enabling Host VBUS. comment out if not used
+  #ifndef PIN_5V_EN
+  #define PIN_5V_EN        29
+  #endif
+
+  #ifndef PIN_5V_EN_STATE
+  #define PIN_5V_EN_STATE  1
+  #endif
+#endif // ARDUINO_ARCH_RP2350
+
 #include "Adafruit_TinyUSB.h"
 
 #if defined(CFG_TUH_MAX3421) && CFG_TUH_MAX3421
@@ -61,7 +81,7 @@
 #ifdef ARDUINO_ARCH_RP2040
 static void rp2040_configure_pio_usb(void) {
   //while ( !Serial ) delay(10);   // wait for native usb
-  Serial.println("Core1 setup to run TinyUSB host with pio-usb");
+  Serial.println("Setup to run TinyUSB host with pio-usb");
 
 #ifdef PIN_5V_EN
   pinMode(PIN_5V_EN, OUTPUT);

Diff for: USB_SNES_Gamepad/Arduino_Metro_RP2350_USB_Host/snes_gamepad_simpletest/.metro_rp2350_tinyusb.test.only

@@ -0,0 +1,36 @@
+// SPDX-FileCopyrightText: 2025 Tim Cocks for Adafruit Industries
+//
+// SPDX-License-Identifier: MIT
+
+// HID reports for USB SNES-like controller
+
+// Byte indices for the gamepad report
+#define BYTE_DPAD_LEFT_RIGHT 0   // D-Pad left and right
+#define BYTE_DPAD_UP_DOWN    1   // D-Pad up and down
+// bytes 2,3,4 unused
+#define BYTE_ABXY_BUTTONS    5   // A, B, X, Y
+#define BYTE_OTHER_BUTTONS   6   // Shoulders, start, and select
+
+
+#define DPAD_NEUTRAL         0x7F
+// D-Pad directions
+#define DPAD_UP              0x00
+#define DPAD_RIGHT           0xFF
+#define DPAD_DOWN            0xFF
+#define DPAD_LEFT            0x00
+
+
+// Face buttons (Byte[5])
+#define BUTTON_NEUTRAL       0x0F
+#define BUTTON_X             0x1F
+#define BUTTON_A             0x2F
+#define BUTTON_B             0x4F
+#define BUTTON_Y             0x8F
+
+
+// Miscellaneous buttons (Byte[6])
+#define BUTTON_MISC_NEUTRAL   0x00
+#define BUTTON_LEFT_SHOULDER  0x01
+#define BUTTON_RIGHT_SHOULDER 0x02
+#define BUTTON_SELECT         0x10
+#define BUTTON_START          0x20

Diff for: USB_SNES_Gamepad/Arduino_Metro_RP2350_USB_Host/snes_gamepad_simpletest/gamepad_reports.h

@@ -0,0 +1,157 @@
+// SPDX-FileCopyrightText: 2025 Tim Cocks for Adafruit Industries
+//
+// SPDX-License-Identifier: MIT
+
+/*********************************************************************
+ Adafruit invests time and resources providing this open source code,
+ please support Adafruit and open-source hardware by purchasing
+ products from Adafruit!
+
+ MIT license, check LICENSE for more information
+ Copyright (c) 2019 Ha Thach for Adafruit Industries
+ All text above, and the splash screen below must be included in
+ any redistribution
+*********************************************************************/
+
+/* This example demonstrates use of usb host with a SNES-like game controller
+ * - Host depends on MCU:
+ *   - rp2040: bit-banging 2 GPIOs with Pico-PIO-USB library (roothub port1)
+ *
+ * Requirements:
+ * - For rp2040:
+ *   - Pico-PIO-USB library
+ *   - 2 consecutive GPIOs: D+ is defined by PIN_USB_HOST_DP, D- = D+ +1
+ *   - Provide VBus (5v) and GND for peripheral
+ *   - CPU Speed must be either 120 or 240 MHz. Selected via "Menu -> CPU Speed"
+ */
+
+// USBHost is defined in usbh_helper.h
+#include "usbh_helper.h"
+#include "tusb.h"
+#include "Adafruit_TinyUSB.h"
+#include "gamepad_reports.h"
+
+// HID report descriptor using TinyUSB's template
+// Single Report (no ID) descriptor
+uint8_t const desc_hid_report[] = {
+    TUD_HID_REPORT_DESC_GAMEPAD()
+};
+
+// USB HID object
+Adafruit_USBD_HID usb_hid;
+
+// Report payload defined in src/class/hid/hid.h
+// - For Gamepad Button Bit Mask see  hid_gamepad_button_bm_t
+// - For Gamepad Hat    Bit Mask see  hid_gamepad_hat_t
+hid_gamepad_report_t gp;
+
+bool printed_blank = false;
+
+void setup() {
+  Serial.begin(115200);
+
+  // configure pio-usb: defined in usbh_helper.h
+  rp2040_configure_pio_usb();
+
+  // run host stack on controller (rhport) 1
+  USBHost.begin(1);
+  delay(3000);
+  Serial.print("USB D+ Pin:");
+  Serial.println(PIN_USB_HOST_DP);
+  Serial.print("USB 5V Pin:");
+  Serial.println(PIN_5V_EN);
+}
+
+void loop() {
+  USBHost.task();
+  Serial.flush();
+
+}
+
+//--------------------------------------------------------------------+
+// HID Host Callback Functions
+//--------------------------------------------------------------------+
+
+void tuh_hid_mount_cb(uint8_t dev_addr, uint8_t instance, uint8_t const* desc_report, uint16_t desc_len)
+{
+  Serial.printf("HID device mounted (address %d, instance %d)\n", dev_addr, instance);
+
+  // Start receiving HID reports
+  if (!tuh_hid_receive_report(dev_addr, instance))
+  {
+    Serial.printf("Error: cannot request to receive report\n");
+  }
+}
+
+void tuh_hid_umount_cb(uint8_t dev_addr, uint8_t instance)
+{
+  Serial.printf("HID device unmounted (address %d, instance %d)\n", dev_addr, instance);
+}
+
+void tuh_hid_report_received_cb(uint8_t dev_addr, uint8_t instance, uint8_t const* report, uint16_t len) {
+
+    if (report[BYTE_DPAD_LEFT_RIGHT] != DPAD_NEUTRAL ||
+        report[BYTE_DPAD_UP_DOWN] != DPAD_NEUTRAL ||
+        report[BYTE_ABXY_BUTTONS] != BUTTON_NEUTRAL ||
+        report[BYTE_OTHER_BUTTONS] != BUTTON_MISC_NEUTRAL){
+
+      printed_blank = false;
+
+      //debug print report data
+      // Serial.print("Report data: ");
+      // for (int i = 0; i < len; i++) {
+      //   Serial.print(report[i], HEX);
+      //   Serial.print(" ");
+      // }
+      // Serial.println();
+
+      if (report[BYTE_DPAD_LEFT_RIGHT] == DPAD_LEFT){
+        Serial.print("Left ");
+      }else  if (report[BYTE_DPAD_LEFT_RIGHT] == DPAD_RIGHT){
+        Serial.print("Right ");
+      }
+
+      if (report[BYTE_DPAD_UP_DOWN] == DPAD_UP){
+        Serial.print("Up ");
+      }else  if (report[BYTE_DPAD_UP_DOWN] == DPAD_DOWN){
+        Serial.print("Down ");
+      }
+
+      if ((report[BYTE_ABXY_BUTTONS] & BUTTON_A) == BUTTON_A){
+        Serial.print("A ");
+      }
+      if ((report[BYTE_ABXY_BUTTONS] & BUTTON_B) == BUTTON_B){
+        Serial.print("B ");
+      }
+      if ((report[BYTE_ABXY_BUTTONS] & BUTTON_X) == BUTTON_X){
+        Serial.print("X ");
+      }
+      if ((report[BYTE_ABXY_BUTTONS] & BUTTON_Y) == BUTTON_Y){
+        Serial.print("Y ");
+      }
+
+      if ((report[BYTE_OTHER_BUTTONS] & BUTTON_LEFT_SHOULDER) == BUTTON_LEFT_SHOULDER){
+        Serial.print("Left Shoulder ");
+      }
+      if ((report[BYTE_OTHER_BUTTONS] & BUTTON_RIGHT_SHOULDER) == BUTTON_RIGHT_SHOULDER){
+        Serial.print("Right Shoulder ");
+      }
+      if ((report[BYTE_OTHER_BUTTONS] & BUTTON_START) == BUTTON_START){
+        Serial.print("Start ");
+      }
+      if ((report[BYTE_OTHER_BUTTONS] & BUTTON_SELECT) == BUTTON_SELECT){
+        Serial.print("Select ");
+      }
+      Serial.println();
+    } else {
+      if (! printed_blank){
+        Serial.println("NEUTRAL");
+        printed_blank = true;
+      }
+    }
+
+  // Continue to receive the next report
+  if (!tuh_hid_receive_report(dev_addr, instance)) {
+    Serial.println("Error: cannot request to receive report");
+  }
+}