esp32-s2_dfu/README.md

# TinyUSB

[![Build Status](https://travis-ci.org/hathach/tinyusb.svg?branch=master)](https://travis-ci.org/hathach/tinyusb) [![License](https://img.shields.io/badge/License-BSD%203--Clause-brightgreen.svg)](https://opensource.org/licenses/BSD-3-Clause)

TinyUSB is an open-source cross-platform USB Host/Device stack for embedded system.

![tinyusb](https://user-images.githubusercontent.com/249515/49858616-f60c9700-fe27-11e8-8627-e76936352ff7.png)

```
.
├── docs            # Documentation
├── examples        # Sample with Makefile and Segger Embedded build support
├── hw
│   ├── bsp         # Supported boards source files
│   └── mcu         # Low level mcu core & peripheral drivers
├── lib             # Sources from 3rd party such as freeRTOS, fatfs ...
├── src             # All sources files for TinyUSB stack itself.
├── tests           # Unit tests for the stack
└── tools           # Files used internally
```

## Device Stack

- Human Interface Device (HID): Keyboard, Mouse, Generic
- Communication Class (CDC)
- Mass Storage Class (MSC)

## Host Stack

**Most active development is on the Device stack. The Host stack is under rework and largely untested.**

- Human Interface Device (HID): Keyboard, Mouse, Generic
- Mass Storage Class (MSC)
- Hub currently only support 1 level of hub (due to my laziness)

## OS Abtraction layer

Currently the following OS are supported with tinyusb out of the box with a simple change of **CFG_TUSB_OS** macro.

- **No OS**
- **FreeRTOS**
- **MyNewt** (work in progress)

## Supported MCUs

The stack supports the following MCUs

- **Nordic:** nRF52840
- **NXP:** LPC11Uxx, LPC13xx, LPC175x_6x, LPC177x_8x, LPC40xx, LPC43xx
- **MicroChip:** SAMD21, SAMD51 (device only)
- **ST:** STM32F4

[Here is the list of supported Boards](hw/bsp/readme.md)

## Compiler & IDE

The stack is developed with GCC compiler, and should be compilable with others. However, it requires C99 to build with. Folder `examples` provide Makefile and Segger Embedded Studio build support.

## Getting Started

[Here is the details for getting started](docs/getting_started.md) with the stack.

## Uses

TinyUSB is currently used by these other projects:

* [Adafruit nRF52 Arduino](https://github.com/adafruit/Adafruit_nRF52_Arduino)
* [Adafruit nRF52 Bootloader](https://github.com/adafruit/Adafruit_nRF52_Bootloader)
* [CircuitPython](https://github.com/adafruit/circuitpython)

## Porting

Want to help add TinyUSB support for a new MCU? Read [here](docs/porting.md) for an explanation on the low-level API needed by TinyUSB.

## License

BSD license for all tinyusb sources [Full license is here](tinyusb/license.md) and most of the code base. However each file/folder is individually licensed especially those in `lib` and `hw/mcu` folder. Please make sure you understand all the license term for files you use in your project.
clean up files 2018-12-13 09:20:28 +01:00			`# TinyUSB`
Initial commit 2012-11-26 07:24:01 +01:00
update readme 2018-12-29 08:29:59 +01:00			`[![Build Status](https://travis-ci.org/hathach/tinyusb.svg?branch=master)](https://travis-ci.org/hathach/tinyusb) [![License](https://img.shields.io/badge/License-BSD%203--Clause-brightgreen.svg)](https://opensource.org/licenses/BSD-3-Clause)`

minor readme update 2018-12-15 07:13:22 +01:00			`TinyUSB is an open-source cross-platform USB Host/Device stack for embedded system.`
update md 2014-03-28 11:50:30 +01:00
docs update 2018-12-12 10:35:53 +01:00			`![tinyusb](https://user-images.githubusercontent.com/249515/49858616-f60c9700-fe27-11e8-8627-e76936352ff7.png)`
update md 2014-03-28 11:50:30 +01:00
update readme 2018-12-29 08:29:59 +01:00			```
			`.`
more readme 2018-12-29 08:39:28 +01:00			`├── docs # Documentation`
			`├── examples # Sample with Makefile and Segger Embedded build support`
update readme 2018-12-29 08:29:59 +01:00			`├── hw`
more readme 2018-12-29 08:39:28 +01:00			`│ ├── bsp # Supported boards source files`
			`│ └── mcu # Low level mcu core & peripheral drivers`
			`├── lib # Sources from 3rd party such as freeRTOS, fatfs ...`
			`├── src # All sources files for TinyUSB stack itself.`
			`├── tests # Unit tests for the stack`
			`└── tools # Files used internally`
update readme 2018-12-29 08:29:59 +01:00			```

docs update 2018-12-12 10:35:53 +01:00			`## Device Stack`
adding some document to /readme.md 2013-05-07 08:36:34 +02:00
docs update 2018-12-12 10:35:53 +01:00			`- Human Interface Device (HID): Keyboard, Mouse, Generic`
Add a porting doc and make a pass over the others. Fixes #5 2018-11-28 03:07:22 +01:00			`- Communication Class (CDC)`
update project file 2014-03-25 10:42:34 +01:00			`- Mass Storage Class (MSC)`
adding some document to /readme.md 2013-05-07 08:36:34 +02:00
docs update 2018-12-12 10:35:53 +01:00			`## Host Stack`
Add a porting doc and make a pass over the others. Fixes #5 2018-11-28 03:07:22 +01:00
docs clean up 2018-12-12 10:57:10 +01:00			`Most active development is on the Device stack. The Host stack is under rework and largely untested.`
adding some document to /readme.md 2013-05-07 08:36:34 +02:00
docs update 2018-12-12 10:35:53 +01:00			`- Human Interface Device (HID): Keyboard, Mouse, Generic`
update project file 2014-03-25 10:42:34 +01:00			`- Mass Storage Class (MSC)`
Add a porting doc and make a pass over the others. Fixes #5 2018-11-28 03:07:22 +01:00			`- Hub currently only support 1 level of hub (due to my laziness)`
adding some document to /readme.md 2013-05-07 08:36:34 +02:00
docs update 2018-12-12 10:35:53 +01:00			`## OS Abtraction layer`
adding some document to /readme.md 2013-05-07 08:36:34 +02:00
docs update 2018-12-12 10:35:53 +01:00			`Currently the following OS are supported with tinyusb out of the box with a simple change of CFG_TUSB_OS macro.`
adding some document to /readme.md 2013-05-07 08:36:34 +02:00
docs update 2018-12-12 10:35:53 +01:00			`- No OS`
documenting on the way 2013-05-08 07:23:25 +02:00			`- FreeRTOS`
docs update 2018-12-12 10:35:53 +01:00			`- MyNewt (work in progress)`
doc work, comment out \subpage command in markdown result 2014-04-17 07:02:03 +02:00
docs update 2018-12-12 10:35:53 +01:00			`## Supported MCUs`
doc work, comment out \subpage command in markdown result 2014-04-17 07:02:03 +02:00
docs update 2018-12-12 10:35:53 +01:00			`The stack supports the following MCUs`
doc work, comment out \subpage command in markdown result 2014-04-17 07:02:03 +02:00
readme clean up 2019-03-19 10:51:41 +01:00			`- Nordic: nRF52840`
			`- NXP: LPC11Uxx, LPC13xx, LPC175x_6x, LPC177x_8x, LPC40xx, LPC43xx`
			`- MicroChip: SAMD21, SAMD51 (device only)`
			`- ST: STM32F4`
markdown documenting 2014-03-25 18:00:53 +01:00
docs update 2018-12-12 10:35:53 +01:00			`[Here is the list of supported Boards](hw/bsp/readme.md)`
clean up 2018-06-19 10:08:31 +02:00
docs update 2018-12-12 10:35:53 +01:00			`## Compiler & IDE`
markdown documenting 2014-03-25 18:00:53 +01:00
docs update 2018-12-12 10:35:53 +01:00			The stack is developed with GCC compiler, and should be compilable with others. However, it requires C99 to build with. Folder `examples` provide Makefile and Segger Embedded Studio build support.
documenting with markdown 2014-03-26 09:42:34 +01:00
docs update 2018-12-12 10:35:53 +01:00			`## Getting Started`
documenting with markdown 2014-03-26 09:42:34 +01:00
docs update 2018-12-12 10:35:53 +01:00			`[Here is the details for getting started](docs/getting_started.md) with the stack.`
adding some document to /readme.md 2013-05-07 08:36:34 +02:00
docs update 2018-12-12 10:35:53 +01:00			`## Uses`
Add a porting doc and make a pass over the others. Fixes #5 2018-11-28 03:07:22 +01:00
			`TinyUSB is currently used by these other projects:`

docs update 2018-12-12 10:35:53 +01:00			`* [Adafruit nRF52 Arduino](https://github.com/adafruit/Adafruit_nRF52_Arduino)`
dcd_set_address include status response, usbd control stall both control in and out 2019-03-13 17:14:48 +01:00			`* [Adafruit nRF52 Bootloader](https://github.com/adafruit/Adafruit_nRF52_Bootloader)`
Add a porting doc and make a pass over the others. Fixes #5 2018-11-28 03:07:22 +01:00			`* [CircuitPython](https://github.com/adafruit/circuitpython)`

docs update 2018-12-12 10:35:53 +01:00			`## Porting`
Add a porting doc and make a pass over the others. Fixes #5 2018-11-28 03:07:22 +01:00
docs update 2018-12-12 10:35:53 +01:00			`Want to help add TinyUSB support for a new MCU? Read [here](docs/porting.md) for an explanation on the low-level API needed by TinyUSB.`
Add a porting doc and make a pass over the others. Fixes #5 2018-11-28 03:07:22 +01:00
docs update 2018-12-12 10:35:53 +01:00			`## License`
complete double buffering for queueing xfer for lpc11u/13u requried by msc device 2013-11-14 08:12:07 +01:00
docs update 2018-12-12 10:35:53 +01:00			BSD license for all tinyusb sources [Full license is here](tinyusb/license.md) and most of the code base. However each file/folder is individually licensed especially those in `lib` and `hw/mcu` folder. Please make sure you understand all the license term for files you use in your project.