add Adafruit_TinyUSB_Arduino to libraries

Author: hathach

libraries/Adafruit_TinyUSB_Arduino/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Ha Thach for Adafruit Industries
+
+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.

libraries/Adafruit_TinyUSB_Arduino/README.md

@@ -0,0 +1,46 @@
+# Adafruit TinyUSB Library for Arduino
+
+[![Build Status](https://github.com/adafruit/Adafruit_TinyUSB_Arduino/workflows/Build/badge.svg)](https://github.com/adafruit/Adafruit_TinyUSB_Arduino/actions) [![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT)
+
+This library is a Arduino-friendly version of [TinyUSB](https://github.com/hathach/tinyusb) stack. It is designed with structure and APIs that are easily integrated to existing or new Arduino Core. Supported platform including: 
+
+- [Adafruit_nRF52_Arduino](https://github.com/adafruit/Adafruit_nRF52_Arduino)
+- [Adafruit/ArduinoCore-samd](https://github.com/adafruit/ArduinoCore-samd) selectable via menu`Tools->USB Stack->TinyUSB`
+- [earlephilhower/arduino-pico](https://github.com/earlephilhower/arduino-pico) selectable via menu `Tools->USB Stack->Adafruit TinyUSB`
+
+Current class drivers supported are
+
+- Communication (CDC): which is used to implement `Serial` monitor
+- Human Interface Device (HID): Generic (In & Out), Keyboard, Mouse, Gamepad etc ...
+- Mass Storage Class (MSC): with multiple LUNs
+- Musical Instrument Digital Interface (MIDI)
+- WebUSB with vendor specific class
+
+For supported ArduinoCore, to use this library, you only need to have `<Adafruit_TinyUSB.h>` in your sketch. If your ArduinoCore does not support TinyUSB library yet, it is rather simple to port.
+
+## Class Driver API
+
+More document to write ... 
+
+## Porting Guide
+
+It is rather easy if you want to integrate TinyUSB lib to your ArduinoCore.
+
+### ArduinoCore Changes
+
+1. Add this repo as submodule (or have local copy) at your ArduioCore/libraries/Adafruit_TinyUSB_Arduino (much like SPI).
+2. Since Serial as CDC is considered as part of the core, we need to have `#include "Adafruit_USBD_CDC.h"` within your `Arduino.h`. For this to work, your `platform.txt` include path need to have `"-I{runtime.platform.path}/libraries/Adafruit_TinyUSB_Arduino/src/arduino"`.
+3. In your `main.cpp` before setup() invoke the `TinyUSB_Device_Init(rhport)`. This will initialize usb device hardware and tinyusb stack and also include Serial as an instance of CDC class.
+4. `TinyUSB_Device_Task()` must be called whenever there is new USB event. Depending on your core and MCU with or without RTOS. There are many ways to run the task. For example:
+  - Use USB IRQn to set flag then invoke function later on after exiting IRQ.
+  - Just invoke function after the loop(), within yield(), and delay()
+5. `TinyUSB_Device_FlushCDC()` should also be called often to send out Serial data as well.
+6. Note: For low power platform that make use of WFI()/WFE(), extra care is required before mcu go into low power mode. Check out my PR to circuipython for reference https://github.com/adafruit/circuitpython/pull/2956
+
+### Library Changes
+
+In addition to core changes, library need to be ported to your platform. Don't worry, tinyusb stack has already done most of heavy-lifting. You only need to write a few APIs
+
+1. `TinyUSB_Port_InitDevice()` hardware specific (clock, phy) to enable usb hardware then call tud_init(). This API is called as part of TinyUSB_Device_Init() invocation.
+2. `TinyUSB_Port_EnterDFU()` which is called when device need to enter DFU mode, usually by touch1200 feature
+3. `TinyUSB_Port_GetSerialNumber()` which is called to get unique MCU Serial ID to used as Serial string descriptor.

libraries/Adafruit_TinyUSB_Arduino/changelog.md

@@ -0,0 +1,104 @@
+# Adafruit TinyUSB Arduino Library Changelog
+
+## 1.1.0 - 2021.06.21
+
+- Add support for multiple CDC ports (need to modify tusb_config.h)
+- fix #86 when calling midi API when device is not fully enumerated
+- fix Serial connection issue with nrf52 on windows
+- Update device driver of rp2040 to match tinyusb upstream
+- Added feather rp2040 to ci build (skipped the external flash example for now due to SdFat compilation error)
+- Add optional debug log for stack with Serial1 on samd core (will expand later to other core).
+- lost more bug fixes to the stack
+
+## 1.0.3 - 2021.05.26
+
+- Update tinyusb stack to latest
+- Added HID Gamepad example with Dhat support
+- Fix warnings with -Wall -Wextra
+- Fix warnings with cast function type for nrf
+
+## 1.0.1 - 2021.05.21
+
+Warn user to select TinyUSB via menu on ports where it is optional e.g SAMD and RP2040 
+
+## 1.0.0 - 2021.05.19
+
+Rework to work as independent libraries, sources from https://github.com/adafruit/Adafruit_TinyUSB_ArduinoCore is now integrated as part of this libraries. Require 
+- Adafruit SAMD core with version at least 1.7.0
+- Adafruit nRF52 core with version at least 0.22.0
+- Support [earlephilhower/arduino-pico](https://github.com/earlephilhower/arduino-pico) version released after https://github.com/earlephilhower/arduino-pico/pull/127
+
+## 0.9.0 - 2020.04.23
+
+- Fixed mouseButtonRelease() error
+- Supported multiple cables for USB MIDI (requires BSP nRF52 0.20.0 and SAMD 1.5.12 )
+- Added consumer control support to HID/hid_composite example
+- Added Adafruit_USBD_HID send report helper: sendReport8(), sendReport16(), sendReport32()
+
+**Minor Breaking Changes**
+- Removed trailing comma in hid report descriptor, this is required to use with BSP nRF52 0.20.0 and SAMD 1.5.12 e.g
+
+from 
+
+```
+uint8_t const desc_hid_report[] =
+{
+  TUD_HID_REPORT_DESC_KEYBOARD( HID_REPORT_ID(RID_KEYBOARD), ),
+  TUD_HID_REPORT_DESC_MOUSE   ( HID_REPORT_ID(RID_MOUSE   ), ),
+};
+```
+to 
+
+```
+uint8_t const desc_hid_report[] =
+{
+  TUD_HID_REPORT_DESC_KEYBOARD( HID_REPORT_ID(RID_KEYBOARD) /*, no more trailing comma */ ),
+  TUD_HID_REPORT_DESC_MOUSE   ( HID_REPORT_ID(RID_MOUSE   )  /*, no more trailing comma */ ),
+};
+```
+
+## 0.8.2 - 2020.04.06
+
+- Removed package-lock.json in hid generic inout example due to security warning from github
+
+## 0.8.1 - 2020.01.08
+
+- More CI migrating work, no function changes
+
+## 0.8.0 - 2019.12.30
+
+- Correct USB BCD version to 2.1 for webUSB
+- Migrate CI from travis to github actions
+
+## 0.7.1 - 2019.10.12
+
+- Fixed MIDI build failed since it is under development
+
+## 0.7.0 - 2019.10.09
+
+- Added MIDI virtual wires/plugs
+
+## 0.6.0 - 2019.08.05
+
+- Added webUSB support with 2 example: webusb-serial, webusb-rgb
+- Alligned mouse examples, added newer hid in/out example from main repo, added new composite example for ramdisk and hid in/out. PR #19 thanks to @PTS93
+
+## 0.5.0 - 2019.07.17
+
+- Added travis build
+- Fixed msc setID
+- Added itfnum to internal API getDescriptor() 
+- Added MIDI support
+  - Added midi_test example
+  - Added pizza box dj example for cplayground express
+- Mass Storage
+  - Added msc_sdfat, msc dual lun (external flash + sd card)  example  
+  - Updated msc example to use new SPIFlash 3.x API
+  - Update msc example to print root contents
+- HID
+  - Added hid_mouse, hid_keyboard
+  - Added hid_composite_joy_featherwing
+- Added Composite: mouse_ramdisk, mouse_external_flash example
+
+## 0.0.1 Initial Release
+

libraries/Adafruit_TinyUSB_Arduino/examples/CDC/cdc_multi/cdc_multi.ino

@@ -0,0 +1,91 @@
+/*
+    This example demonstrates the use of multiple USB CDC/ACM "Virtual
+    Serial" ports, using Ha Thach's TinyUSB library, and the port of
+    that library to the Arduino environment
+
+    https://github.com/hathach/tinyusb
+    https://github.com/adafruit/Adafruit_TinyUSB_Arduino
+
+    Written by Bill Westfield (aka WestfW), June 2021.
+    Copyright 2021 by Bill Westfield
+    MIT license, check LICENSE for more information
+
+    The example creates three virtual serial ports.  Text entered on
+    any of the ports will be echoed to the all ports.
+
+    The max number of CDC ports (CFG_TUD_CDC) has to be changed to at
+    least 2, changed in the core tusb_config.h file.
+*/
+
+#include <Adafruit_TinyUSB.h>
+
+#define LED LED_BUILTIN
+
+// Create extra USB Serial Ports.  "Serial" is already created.
+Adafruit_USBD_CDC USBSer1;
+
+void setup() {
+  pinMode(LED, OUTPUT);
+
+  // start up all of the USB Vitual ports, and wait for them to enumerate.
+  Serial.begin(115200);
+  USBSer1.begin(115200);
+
+  while (!Serial || !USBSer1) {
+    if (Serial) {
+      Serial.println("Waiting for other USB ports");
+    }
+
+    if (USBSer1) {
+      USBSer1.println("Waiting for other USB ports");
+    }
+
+    delay(1000);
+  }
+
+  Serial.print("You are port 0\n\r\n0> ");
+  USBSer1.print("You are port 1\n\r\n1> ");
+}
+
+int LEDstate = 0;
+
+void loop() {
+  int ch;
+
+  ch = Serial.read();
+  if (ch > 0) {
+    printAll(ch);
+  }
+
+  ch = USBSer1.read();
+  if (ch > 0) {
+    printAll(ch);
+  }
+
+  if (delay_without_delaying(500)) {
+    LEDstate = !LEDstate;
+    digitalWrite(LED, LEDstate);
+  }
+}
+
+// print to all CDC ports
+void printAll(int ch) {
+  // always lower case
+  Serial.write(tolower(ch));
+
+  // always upper case
+  USBSer1.write(toupper(ch));
+}
+
+// Helper: non-blocking "delay" alternative.
+boolean delay_without_delaying(unsigned long time) {
+  // return false if we're still "delaying", true if time ms has passed.
+  // this should look a lot like "blink without delay"
+  static unsigned long previousmillis = 0;
+  unsigned long currentmillis = millis();
+  if (currentmillis - previousmillis >= time) {
+    previousmillis = currentmillis;
+    return true;
+  }
+  return false;
+}

libraries/Adafruit_TinyUSB_Arduino/examples/CDC/no_serial/no_serial.ino

@@ -0,0 +1,36 @@
+/*********************************************************************
+ 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
+*********************************************************************/
+
+#include "Adafruit_TinyUSB.h"
+
+/* This sketch demonstrates USB CDC Serial can be dropped by simply
+ * call Serial.end() within setup(). This must be called before any
+ * other USB interfaces (MSC / HID) begin to have a clean configuration
+ *
+ * Note: this will cause device to loose the touch1200 and require
+ * user manual interaction to put device into bootloader/DFU mode.
+ */
+
+int led = LED_BUILTIN;
+
+void setup()
+{
+  Serial.end();
+  pinMode(led, OUTPUT);
+}
+
+void loop()
+{
+  digitalWrite(led, HIGH);
+  delay(1000);
+  digitalWrite(led, LOW);
+  delay(1000);
+}

libraries/Adafruit_TinyUSB_Arduino/examples/Composite/hid_generic_inout_ramdisk/README.md

@@ -0,0 +1 @@
+Check the example host application in `../../HID/hid_generic_inout`