docs update

README.md

@@ -1,95 +1,72 @@
-# tinyusb #
+# tinyusb
 
-<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+tinyusb is an cross-platform open-source USB Host/Device stack for embedded system.
-<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
-**Table of Contents**
 
-- [Features](#features)
+![tinyusb](https://user-images.githubusercontent.com/249515/49858616-f60c9700-fe27-11e8-8627-e76936352ff7.png)
-	- [Host](#host)
-	- [Device](#device)
-	- [RTOS](#rtos)
-	- [Supported MCUs](#supported-mcus)
-	- [Toolchains](#toolchains)
-- [Getting Started](#getting-started)
-- [Uses](#uses)
-- [Porting](#porting)
-- [License](#license)
 
-<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+Folder  | Description
+-----   | -------------
+docs    | Documentation
+examples| Sample applications are kept with Makefile and Segger Embedded build support
+hw/bsp  | Source files of supported boards
+hw/mcu  | Low level mcu core & peripheral drivers (e.g CMSIS )
+lib     | Source files from 3rd party such as freeRTOS, fatfs etc ...
+src     | All sources files for tinyusb stack itself.
+tests   | Unit tests for the stack
+tools   | Files used internally
 
-tinyusb is an open-source (BSD-licensed) USB Host/Device/OTG stack for embedded micro-controllers, especially ARM MCUs. It is designed to be user-friendly in term of configuration and out-of-the-box running experience.
+## Device Stack
 
-In addition to running without an RTOS, tinyusb can run across multiple RTOS vendors. More documents and API reference can be found at http://docs.tinyusb.org
+- Human Interface Device (HID): Keyboard, Mouse, Generic
-
-![tinyusb diagram](http://docs.tinyusb.org/images/tinyusb_overview.png)
-
-## Features ##
-
-### Device ###
-
-- HID Mouse
-- HID Keyboard
-- HID Generic
 - Communication Class (CDC)
 - Mass Storage Class (MSC)
 
-### Host ###
+## Host Stack
 
-** Most active development is on the Device stack. The Host stack is largely untested.**
+** Most active development is on the Device stack. The Host stack is under rework and largely untested.**
 
-- HID Mouse
+- Human Interface Device (HID): Keyboard, Mouse, Generic
-- HID Keyboard
-- HID Generic (coming soon)
-- Communication Device Class (CDC)
 - Mass Storage Class (MSC)
 - Hub currently only support 1 level of hub (due to my laziness)
 
-### RTOS ###
+## OS Abtraction layer
 
-Currently the following OS are supported with tinyusb out of the box with a simple change of CFG_TUSB_OS macro.
+Currently the following OS are supported with tinyusb out of the box with a simple change of **CFG_TUSB_OS** macro.
 
-- **None OS**
+- **No OS**
 - **FreeRTOS**
-- **MyNewt**
+- **MyNewt** (work in progress)
 
-### Toolchains ###
+## Supported MCUs
-
-You can compile with any of following toolchains, however, the stack requires C99 to build with
-
-- GCC
-- lpcxpresso
-- Keil MDK
-- IAR Workbench
-
-### Supported MCUs ###
 
 The stack supports the following MCUs
 
-  - LPC11uxx
+  - **NXP:** LPC11Uxx, LPC13xx, LPC175x_6x, LPC177x_8x, LPC40xx, LPC43xx
-  - LPC13uxx (12 bit ADC)
+  - **MicroChip:** SAMD21, SAMD51 (device only)
-  - LPC175x_6x
+  - **Nordic:** nRF52840
-  - LPC43xx
-  - MicroChip SAMD21
-  - MicroChip SAMD51
-  - Nordic nRF52840
 
-[Here is the list of supported Boards](boards/readme.md) in the code base
+[Here is the list of supported Boards](hw/bsp/readme.md)
 
-## Getting Started ##
+## Compiler & IDE
 
-[Here is the details for getting started](doxygen/getting_started.md) with the stack.
+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.
 
-## Uses ##
+## 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:
 
-* [nRF52840 UF2 Bootloader](https://github.com/adafruit/Adafruit_nRF52_Bootloader)
+* [Adafruit nRF52 Arduino](https://github.com/adafruit/Adafruit_nRF52_Arduino)
 * [CircuitPython](https://github.com/adafruit/circuitpython)
+* [nRF52840 UF2 Bootloader](https://github.com/adafruit/Adafruit_nRF52_Bootloader)
 
-## Porting ##
+## Porting
 
-Want to help add TinyUSB support for a new MCU? Read [here](doxygen/porting.md) for an explanation on the low-level API needed by TinyUSB.
+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 ##
+## License
 
-BSD license for most of the code base, but each file is individually licensed especially those in *vendor* folder. Please make sure you understand all the license term for files you use in your project. [Full license is here](tinyusb/license.md)
+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.

hw/readme.md

@@ -1,3 +0,0 @@
-# Supported MCUs #
-
-Currently