Merge remote-tracking branch 'upstream/master' into h7rs

1 files changed, 38 insertions, 38 deletions

diff --git a/docs/reference/getting_started.rst b/docs/reference/getting_started.rst
index 963420f7b..37745d6a1 100644
--- a/docs/reference/getting_started.rst
+++ b/docs/reference/getting_started.rst
@@ -7,17 +7,17 @@ Add TinyUSB to your project
 
 It is relatively simple to incorporate tinyusb to your project
 
-* Copy or ``git submodule`` this repo into your project in a subfolder. Let's say it is *your_project/tinyusb*
-* Add all the .c in the ``tinyusb/src`` folder to your project
-* Add *your_project/tinyusb/src* to your include path. Also make sure your current include path also contains the configuration file tusb_config.h.
-* Make sure all required macros are all defined properly in tusb_config.h (configure file in demo application is sufficient, but you need to add a few more such as ``CFG_TUSB_MCU``, ``CFG_TUSB_OS`` since they are passed by IDE/compiler to maintain a unique configure for all boards).
+* Copy or ``git submodule`` this repo into your project in a subfolder. Let's say it is ``your_project/tinyusb``
+* Add all the ``.c`` in the ``tinyusb/src`` folder to your project
+* Add ``your_project/tinyusb/src`` to your include path. Also make sure your current include path also contains the configuration file ``tusb_config.h``.
+* Make sure all required macros are all defined properly in ``tusb_config.h`` (configure file in demo application is sufficient, but you need to add a few more such as ``CFG_TUSB_MCU``, ``CFG_TUSB_OS`` since they are passed by IDE/compiler to maintain a unique configure for all boards).
 * If you use the device stack, make sure you have created/modified usb descriptors for your own need. Ultimately you need to implement all **tud descriptor** callbacks for the stack to work.
-* Add tusb_init(rhport, role) call to your reset initialization code.
+* Add ``tusb_init(rhport, role)`` call to your reset initialization code.
 * Call ``tusb_int_handler(rhport, in_isr)`` in your USB IRQ Handler
 * Implement all enabled classes's callbacks.
-* If you don't use any RTOSes at all, you need to continuously and/or periodically call tud_task()/tuh_task() function. All of the callbacks and functionality are handled and invoked within the call of that task runner.
+* If you don't use any RTOSes at all, you need to continuously and/or periodically call ``tud_task()``/``tuh_task()`` function. All of the callbacks and functionality are handled and invoked within the call of that task runner.
 
-.. code-block::
+.. code-block:: c
 
    int main(void) {
      tusb_rhport_init_t dev_init = {
@@ -50,9 +50,9 @@ It is relatively simple to incorporate tinyusb to your project
 Examples
 --------
 
-For your convenience, TinyUSB contains a handful of examples for both host and device with/without RTOS to quickly test the functionality as well as demonstrate how API() should be used. Most examples will work on most of `the supported boards <boards.rst>`_. Firstly we need to ``git clone`` if not already
+For your convenience, TinyUSB contains a handful of examples for both host and device with/without RTOS to quickly test the functionality as well as demonstrate how API should be used. Most examples will work on most of `the supported boards <boards.rst>`_. Firstly we need to ``git clone`` if not already
 
-.. code-block::
+.. code-block:: bash
 
    $ git clone https://github.com/hathach/tinyusb tinyusb
    $ cd tinyusb
@@ -62,17 +62,17 @@ Some ports will also require a port-specific SDK (e.g. RP2040) or binary (e.g. S
 Dependencies
 ^^^^^^^^^^^^
 
-The hardware code is located in ``hw/bsp`` folder, and is organized by family/boards. e.g raspberry_pi_pico is located in ``hw/bsp/rp2040/boards/raspberry_pi_pico`` where FAMILY=rp2040 and BOARD=raspberry_pi_pico. Before building, we firstly need to download dependencies such as: MCU low-level peripheral driver and external libraries e.g FreeRTOS (required by some examples). We can do that by either ways:
+The hardware code is located in ``hw/bsp`` folder, and is organized by family/boards. e.g raspberry_pi_pico is located in ``hw/bsp/rp2040/boards/raspberry_pi_pico`` where ``FAMILY=rp2040`` and ``BOARD=raspberry_pi_pico``. Before building, we firstly need to download dependencies such as: MCU low-level peripheral driver and external libraries e.g FreeRTOS (required by some examples). We can do that by either ways:
 
 1. Run ``tools/get_deps.py {FAMILY}`` script to download all dependencies for a family as follow. Note: For TinyUSB developer to download all dependencies, use FAMILY=all.
 
-.. code-block::
+.. code-block:: bash
 
    $ python tools/get_deps.py rp2040
 
 2. Or run the ``get-deps`` target in one of the example folder as follow.
 
-.. code-block::
+.. code-block:: bash
 
    $ cd examples/device/cdc_msc
    $ make BOARD=raspberry_pi_pico get-deps
@@ -84,19 +84,19 @@ Build
 
 To build example, first change directory to an example folder.
 
-.. code-block::
+.. code-block:: bash
 
    $ cd examples/device/cdc_msc
 
 Then compile with ``make BOARD={board_name} all`` , for example
 
-.. code-block::
+.. code-block:: bash
 
    $ make BOARD=raspberry_pi_pico all
 
 Note: some examples especially those that uses Vendor class (e.g webUSB) may requires udev permission on Linux (and/or macOS) to access usb device. It depends on your OS distro, typically copy ``99-tinyusb.rules`` and reload your udev is good to go
 
-.. code-block::
+.. code-block:: bash
 
    $ cp examples/device/99-tinyusb.rules /etc/udev/rules.d/
    $ sudo udevadm control --reload-rules && sudo udevadm trigger
@@ -106,7 +106,7 @@ RootHub Port Selection
 
 If a board has several ports, one port is chosen by default in the individual board.mk file. Use option ``PORT=x`` To choose another port. For example to select the HS port of a STM32F746Disco board, use:
 
-.. code-block::
+.. code-block:: bash
 
    $ make BOARD=stm32f746disco PORT=1 all
 
@@ -115,16 +115,16 @@ Port Speed
 
 A MCU can support multiple operational speed. By default, the example build system will use the fastest supported on the board. Use option ``SPEED=full/high`` e.g To force F723 operate at full instead of default high speed
 
-.. code-block::
+.. code-block:: bash
 
    $ make BOARD=stm32f746disco SPEED=full all
 
 Size Analysis
 ~~~~~~~~~~~~~
 
-First install `linkermap tool <https://github.com/hathach/linkermap>`_ then ``linkermap`` target can be used to analyze code size. You may want to compile with ``NO_LTO=1`` since -flto merges code across .o files and make it difficult to analyze.
+First install `linkermap tool <https://github.com/hathach/linkermap>`_ then ``linkermap`` target can be used to analyze code size. You may want to compile with ``NO_LTO=1`` since ``-flto`` merges code across ``.o`` files and make it difficult to analyze.
 
-.. code-block::
+.. code-block:: bash
 
    $ make BOARD=feather_nrf52840_express NO_LTO=1 all linkermap
 
@@ -133,16 +133,16 @@ Debug
 
 To compile for debugging add ``DEBUG=1``\ , for example
 
-.. code-block::
+.. code-block:: bash
 
    $ make BOARD=feather_nrf52840_express DEBUG=1 all
 
 Log
 ~~~
 
-Should you have an issue running example and/or submitting an bug report. You could enable TinyUSB built-in debug logging with optional ``LOG=``. LOG=1 will only print out error message, LOG=2 print more information with on-going events. LOG=3 or higher is not used yet.
+Should you have an issue running example and/or submitting an bug report. You could enable TinyUSB built-in debug logging with optional ``LOG=``. ``LOG=1`` will only print out error message, ``LOG=2`` print more information with on-going events. ``LOG=3`` or higher is not used yet.
 
-.. code-block::
+.. code-block:: bash
 
    $ make BOARD=feather_nrf52840_express LOG=2 all
 
@@ -164,7 +164,7 @@ By default log message is printed via on-board UART which is slow and take lots
   * Pros: should be compatible with more debugger that support SWO.
   * Software viewer should be provided along with your debugger driver.
 
-.. code-block::
+.. code-block:: bash
 
    $ make BOARD=feather_nrf52840_express LOG=2 LOGGER=rtt all
    $ make BOARD=feather_nrf52840_express LOG=2 LOGGER=swo all
@@ -174,20 +174,20 @@ Flash
 
 ``flash`` target will use the default on-board debugger (jlink/cmsisdap/stlink/dfu) to flash the binary, please install those support software in advance. Some board use bootloader/DFU via serial which is required to pass to make command
 
-.. code-block::
+.. code-block:: bash
 
    $ make BOARD=feather_nrf52840_express flash
    $ make SERIAL=/dev/ttyACM0 BOARD=feather_nrf52840_express flash
 
 Since jlink can be used with most of the boards, there is also ``flash-jlink`` target for your convenience.
 
-.. code-block::
+.. code-block:: bash
 
    $ make BOARD=feather_nrf52840_express flash-jlink
 
 Some board use uf2 bootloader for drag & drop in to mass storage device, uf2 can be generated with ``uf2`` target
 
-.. code-block::
+.. code-block:: bash
 
    $ make BOARD=feather_nrf52840_express all uf2
 
@@ -199,23 +199,23 @@ Use project connection
 
 IAR Project Connection files are provided to import TinyUSB stack into your project.
 
-* A buldable project of your MCU need to be created in advance.
+* A buildable project of your MCU need to be created in advance.
 
 
   * Take example of STM32F0:
 
-    -  You need `stm32l0xx.h`, `startup_stm32f0xx.s`, `system_stm32f0xx.c`.
+    -  You need ``stm32l0xx.h``, ``startup_stm32f0xx.s``, ``system_stm32f0xx.c``.
 
-    - `STM32L0xx_HAL_Driver` is only needed to run examples, TinyUSB stack itself doesn't rely on MCU's SDKs.
+    - ``STM32L0xx_HAL_Driver`` is only needed to run examples, TinyUSB stack itself doesn't rely on MCU's SDKs.
 
-* Open ``Tools -> Configure Custom Argument Variables`` (Switch to `Global` tab if you want to do it for all your projects)
-   Click `New Group ...`, name it to `TUSB`, Click `Add Variable ...`, name it to `TUSB_DIR`, change it's value to the path of your TinyUSB stack,
-   for example `C:\\tinyusb`
+* Open ``Tools -> Configure Custom Argument Variables`` (Switch to ``Global`` tab if you want to do it for all your projects)
+   Click ``New Group ...``, name it to ``TUSB``, Click ``Add Variable ...``, name it to ``TUSB_DIR``, change it's value to the path of your TinyUSB stack,
+   for example ``C:\\tinyusb``
 
 Import stack only
 ~~~~~~~~~~~~~~~~~
 
-1. Open ``Project -> Add project Connection ...``, click `OK`, choose `tinyusb\\tools\\iar_template.ipcf`.
+1. Open ``Project -> Add project Connection ...``, click ``OK``, choose ``tinyusb\\tools\\iar_template.ipcf``.
 
 Run examples
 ~~~~~~~~~~~~
@@ -224,11 +224,11 @@ Run examples
 
    .. code-block::
 
-     cd C:\tinyusb\tools
-     python iar_gen.py
+      > cd C:\tinyusb\tools
+      > python iar_gen.py
 
-2. Open `Project -> Add project Connection ...`, click `OK`, choose `tinyusb\\examples\\(.ipcf of example)`.
-   For example `C:\\tinyusb\\examples\\device\\cdc_msc\\iar_cdc_msc.ipcf`
+2. Open ``Project -> Add project Connection ...``, click ``OK``, choose ``tinyusb\\examples\\(.ipcf of example)``.
+   For example ``C:\\tinyusb\\examples\\device\\cdc_msc\\iar_cdc_msc.ipcf``
 
 Native CMake support (9.50.1+)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -239,5 +239,5 @@ Following these steps:
 
 1. Add IAR compiler binary path to system ``PATH`` environment variable, such as ``C:\Program Files\IAR Systems\Embedded Workbench 9.2\arm\bin``.
 2. Create new project in IAR, in Tool chain dropdown menu, choose CMake for Arm then Import ``CMakeLists.txt`` from chosen example directory.
-3. Set up board option in ``Option - CMake/CMSIS-TOOLBOX - CMake``, for example :code:`-DBOARD=stm32f439nucleo -DTOOLCHAIN=iar`, **Uncheck 'Override tools in env'**.
+3. Set up board option in ``Option - CMake/CMSIS-TOOLBOX - CMake``, for example ``-DBOARD=stm32f439nucleo -DTOOLCHAIN=iar``, **Uncheck 'Override tools in env'**.
 4. (For debug only) Choose correct CPU model in ``Option - General Options - Target``, to profit register and memory view.