Rationalize Adafruit Feather infra, update docs (#145)

Use same board.txt format as other Adafruit boards.
Add in quick note about the new USB stack to the docs.

Author: earlephilhower

README.md

@@ -7,6 +7,13 @@ This is a port of the RP2040 (Raspberry Pi Pico processor) to the Arduino ecosys
 # Documentation
 See https://arduino-pico.readthedocs.io/en/latest/ along with the examples for more detailed usage information.
 
+# Supported Boards
+* Raspberry Pi Pico
+* Adafruit Feather RP2040
+* Adafruit ItsyBitsy RP2040
+* Adafruit QTPy RP2040
+* Generic (configurable flash, I/O pins)
+
 # Installing via Arduino Boards Manager
 **Windows Users**: Please do not use the Windows Store version of the actual Arduino application
 because it has issues detecting attached Pico boards.  Use the "Windows ZIP" or plain "Windows"
@@ -15,7 +22,6 @@ drivers it suggests.  Otherwise the Pico board may not be detected.  Also, if tr
 2.0 beta Arduino please install the release 1.8 version beforehand to ensure needed device drivers
 are present.  (See #20 for more details.)
 
-
 Open up the Arduino IDE and go to File->Preferences.
 
 In the dialog that pops up, enter the following URL in the "Additional Boards Manager URLs" field:
@@ -92,24 +98,14 @@ Once Picoprobe permissions are set up properly, then select the board "Raspberry
 # Debugging with Picoprobe, OpenOCD, and GDB
 The installed tools include a version of OpenOCD (in the pqt-openocd directory) and GDB (in the pqt-gcc directory).  These may be used to run GDB in an interactive window as documented in the Pico Getting Started manuals from the Raspberry Pi Foundation.
 
-# Status of Port
-Relatively stable and very functional, but bug reports and PRs always accepted.
-* USB Keyboard and Mouse emulation
+# Features
+* Adafruit TinyUSB Arduino (USB mouse, keyboard, flash drive, generic HID, CDC Serial, MIDI, WebUSB, others)
+* Generic Arduino USB Serial, Keyboard, and Mouse emulation
+* Filesystems (LittleFS and SD/SDFS)
 * Multicore support (setup1() and loop1())
-* digitalWrite/Read
-* shiftIn/Out
-* SPI master
-* analogWrite/PWM
-* tone/noTone
-* Wire/I2C Master and Slave
-* EEPROM
-* USB Serial(ACM) w/automatic reboot-to-UF2 upload)
-* Hardware UART
-* Servo, glitchless
 * Overclocking and underclocking from the menus
-* analogRead and Pico chip temperature
-* Filesystems (LittleFS and SD/SDFS)
-* I2S audio output
+* digitalWrite/Read, shiftIn/Out, tone, analogWrite(PWM)/Read, temperature
+* Peripherals:  SPI master, Wire(I2C) master/slave, dual UART, emulated EEPROM, I2S audio output, Servo
 * printf (i.e. debug) output over USB serial 
 
 The RP2040 PIO state machines (SMs) are used to generate jitter-free:

boards.txt

@@ -31,7 +31,7 @@ For the latest version, always check https://github.com/earlephilhower/arduino-p
    SPI <spi>
    Wire(I2C) <wire>
    File Systems (SD, SDFS, LittleFS) <fs>
-   USB Keyboard/Mouse <usb>
+   USB (Arduino and Adafruit_TinyUSB) <usb>
    Multicore Processing <multicore>
 
    Ported/Optimized Libraries <libraries>

docs/index.rst

@@ -1,11 +1,32 @@
-USB Keyboard and Mouse
-======================
+USB (Arduino and Adafruit_TinyUSB)
+==================================
 
-The Arduino-Pico core includes ported versions of the standard Arduino
+Two USB stacks are present in the core.  Users can choose the simpler
+Pico-SDK version or the more powerful Adafruit TinyUSB library.
+Use the ``Tools->USB Stack`` menu to select between the two.
+
+Pico SDK USB Support
+--------------------
+This is the default mode and automatically includes a USB-based
+serial port, ``Serial`` as well as supporting automatic reset-to-upload
+from the IDE.
+
+The Arduino-Pico core includes ported versions of the basic Arduino
 ``Keyboard`` and ``Mouse`` libraries.  These libraries allow you to
 emulate a keyboard or mouse with the Pico in your sketches.
 
 See the examples and Arduino Reference at
 https://www.arduino.cc/reference/en/language/functions/usb/keyboard/
 and
 https://www.arduino.cc/reference/en/language/functions/usb/mouse
+
+Adafruit TinyUSB Arduino Support
+--------------------------------
+Examples are provided in the Adafruit_TinyUSB_Arduino for the more
+advanced USB stack.
+
+Please note that this stack requires sketches to manually call
+``Serial.begin(115200)`` to enable the USB serial port and automatic
+sketch upload from the IDE.  If a sketch is run without this command
+in ``setup()``, the user will need to use the standard "hold BOOTSEL
+and plug in USB" method to enter program upload mode.

docs/usb.rst

@@ -19,7 +19,7 @@
 
 // The normal, core0 setup
 void setup() {
-  Serial.begin();
+  Serial.begin(115200);
   delay(5000);
 }
 

libraries/rp2040/examples/Multicore/Multicore.ino

@@ -93,15 +93,12 @@ discovery.rp2040.pattern="{runtime.tools.pqt-python3.path}/python3" "{runtime.pl
 # ----------------
 
 ## Compile c files
-## Add -DBOARD_NAME="{build.board}"
 recipe.c.o.pattern="{compiler.path}{compiler.c.cmd}" {compiler.c.flags} {build.usbpid} -DF_CPU={build.f_cpu} -DARDUINO={runtime.ide.version} -DARDUINO_{build.board} -DBOARD_NAME="{build.board}" -DARDUINO_ARCH_{build.arch} {compiler.c.extra_flags} {build.extra_flags} {build.debug_port} {build.debug_level} {includes} "{source_file}" -o "{object_file}"
 
 ## Compile c++ files
-## Add -DBOARD_NAME="{build.board}"
 recipe.cpp.o.pattern="{compiler.path}{compiler.cpp.cmd}" {compiler.cpp.flags} {build.usbpid} -DF_CPU={build.f_cpu} -DARDUINO={runtime.ide.version} -DARDUINO_{build.board} -DBOARD_NAME="{build.board}" -DARDUINO_ARCH_{build.arch} {compiler.cpp.extra_flags} {build.extra_flags} {build.debug_port} {build.debug_level} {includes} "{source_file}" -o "{object_file}"
 
 ## Compile S files
-## Add -DBOARD_NAME="{build.board}"
 recipe.S.o.pattern="{compiler.path}{compiler.S.cmd}" {compiler.S.flags} {build.usbpid} -DF_CPU={build.f_cpu} -DARDUINO={runtime.ide.version} -DARDUINO_{build.board} -DBOARD_NAME="{build.board}" -DARDUINO_ARCH_{build.arch} {compiler.S.extra_flags} {build.extra_flags} {build.debug_port} {build.debug_level} {includes} "{source_file}" -o "{object_file}"
 
 ## Create archives

platform.txt

@@ -120,7 +120,7 @@ def MakeBoard(name, vendor_name, product_name, vid, pid, boarddefine, flashsizem
 
 BuildGlobalMenuList()
 MakeBoard("rpipico", "Raspberry Pi", "Pico", "0x2e8a", "0x000a", "RASPBERRY_PI_PICO", 2, "boot2_w25q080_2_padded_checksum")
-MakeBoard("adafruitfeather", "Adafruit", "Feather RP2040", "0x239a", "0x80f1", "ADAFRUIT_FEATHER_RP2040", 8, "boot2_w25x10cl_4_padded_checksum")
+MakeBoard("adafruit_feather", "Adafruit", "Feather RP2040", "0x239a", "0x80f1", "ADAFRUIT_FEATHER_RP2040", 8, "boot2_w25x10cl_4_padded_checksum")
 MakeBoard("adafruit_itsybitsy", "Adafruit", "ItsyBitsy RP2040", "0x239a", "0x80fd", "ADAFRUIT_ITSYBITSY_RP2040", 8, "boot2_w25q080_2_padded_checksum")
 MakeBoard("adafruit_qtpy", "Adafruit", "QT Py RP2040", "0x239a", "0x80f7", "ADAFRUIT_QTPY_RP2040", 8, "boot2_generic_03h_4_padded_checksum")
 MakeBoard("generic", "Generic", "RP2040", "0x2e8a", "0xf00a", "GENERIC_RP2040", 16, "boot2_generic_03h_4_padded_checksum")