From 490097990619efd9986ef4fa40ded707257bd825 Mon Sep 17 00:00:00 2001 From: Pedro Minatel Date: Wed, 16 Feb 2022 13:43:21 +0000 Subject: [PATCH] Added documentation for the Arduino IDE tools menu (#6284) * Added the Tools Options into the docs. * Added more options * Deleted wrong file. * [Docs] Added image to show the MSC and some grammar fixes * [Docs] Added more information about the core selection * Deleted wrong file. * [Docs] Added more information about the core selection * [Docs] Changes according to the PR review --- docs/source/_static/usb_msc_drive.png | Bin 0 -> 75704 bytes docs/source/getting_started.rst | 3 + docs/source/guides/guides.rst | 10 ++ docs/source/guides/tools_menu.rst | 199 ++++++++++++++++++++++++++ docs/source/index.rst | 1 + docs/source/tutorials/tutorials.rst | 8 +- 6 files changed, 216 insertions(+), 5 deletions(-) create mode 100644 docs/source/_static/usb_msc_drive.png create mode 100644 docs/source/guides/guides.rst create mode 100644 docs/source/guides/tools_menu.rst diff --git a/docs/source/_static/usb_msc_drive.png b/docs/source/_static/usb_msc_drive.png new file mode 100644 index 0000000000000000000000000000000000000000..de0796c39805134b0f97ba2876d419209ac4267c GIT binary patch literal 75704 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 z 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 Board -> ESP32 Arduino`` and select the target board. + +If your board is not present on this list, you can select the generic ``ESP32-XX Dev Module``. + +Currently, we have one generic development module for each of the supported targets. + +If the board selected belongs to another SoC family, you will see the following information at the build output: + + ``A fatal error occurred: This chip is ESP32 not ESP32-S2. Wrong --chip argument?`` + +Upload Speed +************ + +To select the flashing speed, change the ``Tools -> Upload Speed``. This value will be used for flashing the code to the device. + +.. note:: If you have issues while flashing the device at high speed, try to decrease this value. This could be due to the external serial-to-USB chip limitations. + +CPU Frequency +************* + +On this option, you can select the CPU clock frequency. This option is critical and must be selected according to the high-frequency crystal present on the board and the radio usage (Wi-Fi and Bluetooth). + +In some application, reducing the CPU clock frequency is recommended in order to reduce the power consumption. + +If you don't know why you should change this frequency, leave the default option. + +Flash Frequency +*************** + +Use this function to select the flash memory frequency. The frequency will be dependent of the memory model. + +* **40MHz** +* **80MHz** + +If you don't know if your memory supports **80Mhz**, you can try to upload you scketch using the **80MHz** option and watch the log output via the serial monitor. + +Flash Mode +********** + +This option is used to select the SPI communication mode with the flash memory. + +Depending on the application, this mode can be changed in order to increase the flash communication speed. + +* **QIO** - Quad I/O Fast Read + * Four SPI pins are used to write to the flash and to read from flash. + +* **DIO** - Dual I/O Fast Read + * Two SPI pins are used to write to the flash and to read from flash. + +* **QOUT** - Quad Output Fast Read + * Four SPI pins are used to read the flash data. + +* **DOUT** - Dual Output Fast Read + * Two SPI pins are used to read flash data. + +If you don't know how the board flash is physically connected or the flash memory model, try the **QIO** at **80MHz** first. + +Flash Size +********** + +This option is used to select the flash size. The flash size should be selected according to the flash model used on your board. + +* **2MB** (16Mb) +* **4MB** (32Mb) +* **8MB** (64Mb) +* **16MB** (128Mb) + +If you choose the wrong size, you may have issues when selecting the partition scheme. + + + +Partition Scheme +**************** + +This option is used to select the partition model according to the flash size and the resources needed, like storage area and OTA (Over The Air updates). + +.. note:: Be careful selecting the right partition according to the flash size. If you select the wrong partition, the system will crash. + +Core Debug Level +**************** + +This option is used to select the Arduino core debugging level to be printed to the serial debug. + +* **None** - Prints nothing. +* **Error** - Only at error level. +* **Warning** - Only at warning level and above. +* **Info** - Only at info level and above. +* **Debug** - Only at debug level and above. +* **Verbose** - Prints everything. + +PSRAM +***** + +The PSRAM is an internal or external extended RAM present on some boards, modules or SoC. + +This option can be used to ``Enable`` or ``Disable`` the PSRAM. + +Arduino Runs On +*************** + +This function is used to select the core that runs the Arduino core. This is only valid if the target SoC has 2 cores. + +When you have some heavy task running, you might want to run this task on a different core then the Arduino tasks. For this reason, you have this configuration to select the core. + +Events Run On +************* + +This function is used to select the core that runs the events. This is only valid if the target SoC has 2 cores. + +The same situation on the previous configuration. + +Port +**** + +This option is used to select the serial port to be used on the flashing and monitor. + +USB Options +----------- + +Some ESP32 families have a USB peripheral. This peripheral can be used for flashing and debugging. + +To see the supported list for each SoC, see this section: `Libraries <../libraries.html>`_. + +The USB option will be available only if the correct target is selected. + +USB CDC On Boot +*************** + +The USB Communications Device Class, or USB CDC, is a class used for basic communication to be used as a regular serial controller (like RS-232). + +This class is used for flashing the device without any other external device attached to the SoC. + +This option can be used to ``Enable`` or ``Disable`` this function at the boot. If this option is ``Enabled``, once the device is connected via USB, one new serial port will appear in the list of the serial ports. +Use this new serial port for flashing the device. + +This option can be used as well for debugging via the ``Serial Monitor`` using **CDC** instead of the **UART0**. + +To use the UART as serial output, you can use ``Serial0.print("Hello World!");`` instead of ``Serial.print("Hello World!");`` which will be printed using USB CDC. + +USB Firmware MSC On Boot +************************ + +The USB Mass Storage Class, or USB MSC, is a class used for storage devices, like a USB flash drive. + +This option can be used to ``Enable`` or ``Disable`` this function at the boot. If this option is ``Enabled``, once the device is connected via USB, one new storage device will appear in the system as a storage drive. +Use this new storage drive to write or read files, or to drop a new firmware binary to flash the device. + +.. figure:: ../_static/usb_msc_drive.png + :align: center + :width: 720 + :figclass: align-center + +USB DFU On Boot +*************** + +The USB Device Firmware Upgrade is a class used for flashing the device through USB. + +This option can be used to ``Enable`` or ``Disable`` this function at the boot. If this option is ``Enabled``, once the device is connected via USB, the device will appear as a USB DFU capable device. + + +.. _Espressif Product Selector: https://products.espressif.com/ +.. _boards.txt: https://github.com/espressif/arduino-esp32/blob/master/boards.txt \ No newline at end of file diff --git a/docs/source/index.rst b/docs/source/index.rst index 02f62c30..48f30396 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -13,6 +13,7 @@ Here you will find all the relevant information about the project. Getting Started Libraries + Guides Tutorials Advanced Utilities FAQ diff --git a/docs/source/tutorials/tutorials.rst b/docs/source/tutorials/tutorials.rst index 57eead06..9fca4ac3 100644 --- a/docs/source/tutorials/tutorials.rst +++ b/docs/source/tutorials/tutorials.rst @@ -3,10 +3,8 @@ Tutorials ######### .. toctree:: - :maxdepth: 2 :caption: Tutorials: + :maxdepth: 1 + :glob: - Blink - Basic - DFU - GPIO Matrix and Pin Mux + *