Merge branch 'feature/docs_dedicated_language_folders' into 'master'

Move docs into dedicated folders for 'en' and 'zn_CN' language versions

See merge request idf/esp-idf!1901

Implemented review comments to zh_CN version of eclipse setup and PICO-KIT get started guides. Resolved issues after rebasing on master of several commits.

CI: print document preview link in `deploy_docs`

doc: two languages support for deploy_docs stage.

Included zh_CN version of Eclipse setup and PICO-KIT get started guides

Adjusted CI configuration to handle 'en' and 'zh_CN' language versions

Adjusted Sphinx configuration to handle 'en' and 'zh_CN' language versions

Restored back original 'zh_CN' version files and updated links between versions

Moved files into separate folders per 'en' and 'zh_CN' language version and linked 'zh_CN' files back to 'en' files if translation is not yet available

Make search / include path one level deeper to prepare for moving documentation into new dedicated folders per a language version

Merge branch 'bugfix/wpa2_assert_when_suddenly_disconnect' into 'master'

Bugfix of wpa2 task assert when suddenly disconnect

See merge request idf/esp-idf!2043

Merge branch 'bugfix/docs_small_corrections' into 'master'

Bugfix/docs small corrections

See merge request idf/esp-idf!2025

Merge branch 'bugfix/docs_incremental_build' into 'master'

docs: speed up incremental builds

See merge request idf/esp-idf!2012

Merge branch 'bugfix/docs_from_github' into 'master'

Bugfix/docs from github

See merge request idf/esp-idf!2015

Bugfix of wpa2 task assert when suddenly disconnect

Exposed important information regrading the flash bus signals

fix: fatfs link

Extra links in 'Resources' section

Added / corrected README files for the SPI master / slave examples under peripherals

Merge branch 'bugfix/esp_timer_overflow' into 'master'

component/esp32: fix esp_timer bug

See merge request idf/esp-idf!1877

Merge branch 'bugfix/close_socket_when_tcp_connecting' into 'master'

Close socket request will abort tcp write/connect

See merge request idf/esp-idf!1687

Merge branch 'bugfix/btdm_clear_start_stop_adv_callback_when_complete' into 'master'

Component/bt: clear start/stop adv callback when complete

See merge request idf/esp-idf!1938

Merge branch 'bugfix/btdm_fix_set_error_channel_map_in_adv_params' into 'master'

Component/bt: fix set error params and return callback when start adv

See merge request idf/esp-idf!1943

Merge branch 'feature/btdm_blufi_add_custom_data_cmd' into 'master'

Component/bt: blufi add custom data cmd

See merge request idf/esp-idf!2017

Merge branch 'bugfix/btdm_add_param_check_in_gap_set_prefer_conn_params' into 'master'

Component/bt: add_params_check_in_prefer_conn_params()

See merge request idf/esp-idf!1944

Merge branch 'bugfix/btdm_fix_get_attr_value_error_after_prepare_write' into 'master'

Component/bt: fix get attr value error after prepare write

See merge request idf/esp-idf!1976

Component/bt: blufi add custom data cmd

Added missing link to sdkconfig

fix : esp_partition_find missing `` ``

Signed-off-by: krzychb <krzychb@gazeta.pl>

docs: speed up incremental builds

On each documentation build (‘make html’), doxygen regenerates XML
files. In addition to that, gen-dxd.py regenerates API reference
files under _build/inc/. This results in Sphinx flagging about half
of the input files as modified, and incremental builds taking long
time.

With this change, XML files generated by Doxygen are copied into
docs/xml_in directory only when they are changed. Breathe is pointed
to docs/xml_in directory instead of docs/xml. In addition to that,
gen-dxd.py is modified to only write to the output file when contents
change.

Overall, incremental build time (with no source files changed) is
reduced from ~7 minutes to ~8 seconds (on a particular OS X
computer).

Due to the way Breathe includes Doxygen XML files, there is still
going to be a massive rebuild every time functions, enums, macros,
structures are added or removed from the header files scanned
by Doxygen, but at least individual .rst files can be edited
at a much faster pace.

Merge branch 'bugfix/docs_improve_flash_bus_integrity' into 'master'

Added a note how to modify ESP-WROVER-KIT V3 hardware to improve flash bus signal's integrity

See merge request idf/esp-idf!2005

Merge branch 'bugfix/btdm_error_log' into 'master'

component/bt: remove some error logs which are not error

See merge request idf/esp-idf!1826

Merge branch 'bugfix/btdm_spp_lock_error' into 'master'

component/bt: Fix spp lock error

See merge request idf/esp-idf!2014

component/bt: Fix spp lock error

Fix missing 'cpp:func:'. Merges https://github.com/espressif/esp-idf/pull/1680

Update adc.rst. Merges https://github.com/espressif/esp-idf/pull/1657

component/bt: remove some error logs which are not error

Merge branch 'bugfix/btdm_update_pktLen_have_no_callback' into 'master'

component/bt: Fix bug:update pktlen have no callback

See merge request idf/esp-idf!1913

Merge branch 'bugfix/btdm_add_lock_for_spp_without_VFS' into 'master'

component/bt: Add lock for SPP slot

See merge request idf/esp-idf!2002

Added a note how to modify ESP-WROVER-KIT V3 hardware to improve flash bus signal's integrity when using 80 MHz flash frequency. Due to length of the signal lines the flash mode QIO + 80M is not stable and may cause random exceptions on the ESP-WROVER-KIT.

Merge branch 'feature/remove_tcp_perf_example' into 'master'

example: remove performance example

See merge request idf/esp-idf!1969

Merge branch 'bugfix/btdm_build_server_error_with_BT_BLE_DYNAMIC_ENV_MEMORY' into 'master'

Component/bt: fix build ble server error with BT_BLE_DYNAMIC_ENV_MEMORY option

See merge request idf/esp-idf!1993

component/bt: Add lock for SPP slot

Component/bt: fix build ble server error with BT_BLE_DYNAMIC_ENV_MEMORY option

component/esp32: fix esp_timer bug

1. fix the bug that cause esp_timer_get_time is not accuracy(the max margin may be 106s).
2. fix the bug that causes esp timer come too early.

Merge branch 'bugfix/idf_monitor_windows10' into 'master'

idf_monitor: Fix bug with Windows 10 sometimes printing a character twice

See merge request idf/esp-idf!1964

Merge branch 'feature/ignore_no_psram' into 'master'

Add option to continue running (with less ram) if psram is enabled but not detected

See merge request idf/esp-idf!1911

Merge branch 'bugfix/revisit_pthread_once' into 'master'

pthread: fix pthread_once behavior, if mux (handle) is in external PSRAM

See merge request idf/esp-idf!1972

Merge branch 'bugfix/esp_ping_ms_pr1638' into 'master'

esp_ping - Document that timeout units are in milliseconds

See merge request idf/esp-idf!1968

Merge branch 'bugfix/docs_missing_reference' into 'master'

Added missing references to the current and previous ESP32-DevKitC board versions

See merge request idf/esp-idf!1920

Merge branch 'adc_calibration_update' into 'master'

ADC Calibraiton - Support new new calibration methods and eFuse functionality

See merge request idf/esp-idf!1846

Merge branch 'feature/rtc_gpio_isolate' into 'master'

Add rtc_gpio_isolate function, use it in deep sleep examples

See merge request idf/esp-idf!1936

Merge branch 'bugfix/aws_iot_examples_stack_tune' into 'master'

examples: aws_iot: fine tune stack size for aws_iot task

See merge request idf/esp-idf!1962

Merge branch 'bugfix/config_minor_missing_deps' into 'master'

Kconfig: esp32/freertos: add some missing dependencies

See merge request idf/esp-idf!1966

Component/bt: fix get attr value error after prepare write

Merge branch 'bugfix/btdm_mem_leak_of_bt' into 'master'

component/bt: Fix mem leak of bt

See merge request idf/esp-idf!1924

pthread: fix pthread_once behavior, if mux (handle) is in external PSRAM

Signed-off-by: Mahavir Jain <mahavir@espressif.com>

Merge branch 'feature/heap_task_tracking_pr1498' into 'master'

heap: Add task tracking features (PR 1498)

See merge request idf/esp-idf!1960

Merge branch 'bugfix/partition_md5_backward_compatibility' into 'master'

partition_table: Optionally disable the MD5 checksum in partition tables

See merge request idf/esp-idf!1958

Merge branch 'bugfix/fd_zero' into 'master'

FD_ZERO: Fix a compilation warning

See merge request idf/esp-idf!1967

esp_adc_cal/Remove lookup table

This commit removes the lookup table mode due to inferior performance when compared
to linear mode under attenuation 0, 1 and 2. However small portions of the lookup table
are kept for the higher voltages of atten 3 (above ADC reading 2880). That voltage range
in atten 3 has non linear characteristics making the LUT performan better than linear mode.

example: remove performance example

Remove performance example since we have iperf example
close github issue: https://github.com/espressif/esp-idf/issues/1515

FD_ZERO: Fix a compilation warning

Definition of memset is not found if string.h is not included anywhere

Signed-off-by: Piyush Shah <piyush@espressif.com>

partition_table: Optionally disable the MD5 checksum in partition tables

Merge branch 'bugfix/i2s_driver' into 'master'

i2s: add support fixed_mclk configuration

See merge request idf/esp-idf!1600

Merge branch 'bugfix/doc_spi_flash' into 'master'

spi_flash: Update docs

See merge request idf/esp-idf!1961

i2s: add support fixed_mclk configuration

Merge branch 'feature/idf_size_sort_archives' into 'master'

Feature/idf size sort on size

See merge request idf/esp-idf!1957

Merge branch 'bugfix/docs_esp_sleep_wakeup_cause_t' into 'master'

Fix esp_sleep_wakeup_cause_t docs. Merges https://github.com/espressif/esp-idf/pull/1634

See merge request idf/esp-idf!1965

spi_flash: Update docs

Merge branch 'bugfix/apptrace_down_buf_handling' into 'master'

esp32: Fixes apptrace down buffer management

See merge request idf/esp-idf!1953

esp32: Fixes apptrace down buffer management

Kconfig: esp32/freertos: add some missing dependencies

Signed-off-by: Mahavir Jain <mahavir@espressif.com>

idf_monitor: Fix bug with Windows 10 sometimes printing a character twice

Turns out when IOError is thrown by the console, the character is
also successfully displayed.

Revisits fix from https://github.com/espressif/esp-idf/issues/1136

As reported https://esp32.com/viewtopic.php?f=14&t=4766&p=20637

Fix esp_sleep_wakeup_cause_t docs. Merges https://github.com/espressif/esp-idf/pull/1634

value and description didn't match

Merge branch 'feature/openssl_cacert' into 'master'

OpenSSL API addition

See merge request idf/esp-idf!1932

examples: aws_iot: fine tune stack size for aws_iot task

Signed-off-by: Mahavir Jain <mahavir@espressif.com>

OpenSSL API addition

Merge branch 'bugfix/eclipse_setup_guide_pr1627' into 'master'

Update eclipse-setup.rst

See merge request idf/esp-idf!1955

Merge branch 'bugfix/i2s_intr_alloc_flags_pr1589' into 'master'

i2s: fix type mismatch of intr_alloc_flags

See merge request idf/esp-idf!1954

heap: Add task tracking option for heap usage monitoring

Add back a feature that was available in the old heap implementation
in release/v2.1 and earlier: keep track of which task allocates each
block from the heap. The task handle is conditionally added as
another word in the heap poisoning header under this configuration
option CONFIG_HEAP_TASK_TRACKING.

To allow custom monitoring and debugging code to be added, add helper
functions in multi_heap.c and multi_heap_poisoning.c to provide access
to information in the block headers.

Add esp_heap_debug_dump_totals() to monitor heap usage

esp_heap_debug_dump_totals() dumps into a user-provided data structure
a summary of the amound of heap memory in region type that is used by
each task.  Optionally it will also dump into another data structure
the metadata about each allocated block for a given list of tasks or
for all tasks (limited by available space).

Address change requests on PR #1498

This set of changes fixes the files in e3b702c to just add the
CONFIG_HEAP_TASK_TRACKING option without adding the new function
heap_caps_get_per_task_info() in case that is the only portion of the
PR that will be accepted.  Part of the change is to remove the new .c
and .h files containing that function and to remove the line to
compile it from components/heap/component.mk since it should not have
been included in e3b702c.  One or more additional commits to add the
new function will follow.

The other changes here:
- uint32_t get_all_caps() moves to heap_private.h
- replace "void* foo" with "void *foo"
- add braces around single-line "if" blocks
- replace tab characters with spaces

Address change requests on PR #1498, part 2

This set of changes fixes the files in cdf32aa to add the new function
heap_caps_get_per_task_info() with its new name and to add the line to
compile it in components/heap/component.mk.  This does not address all
the suggested changes because there are some needing further
discussion.

This commit does not include the suggested change to move the
declaration of the new function into esp_heap_caps.h because the new
function references TaskHandle_t so esp_heap_caps.h would have to
include freertos/FreeRTOS.h and freertos/task.h, but FreeRTOS.h
includes esp_heap_caps.h through two other header files which results
in compilation errors because not all of FreeRTOS.h has been read yet.

Change heap_caps_get_per_task_info() to take struct of params

In addition to moving the large number of function parameters into a
struct as the single parameter, the following changes were made:

- Clear out the totals for any prepopulated tasks so the app code
  doesn't have to do it.

- Rather than partitioning the per-task totals into a predetermined
  set of heap capabilities, take a list of <caps,mask> pairs to
  compare the caps to the heap capabilities as masked.  This lets the
  caller configure the desired partitioning, or none.

- Allow the totals array pointer or the blocks array pointer to be
  NULL to indicate not to collect that part of the information.

- In addition to returning the total space allocated by each task,
  return the number of blocks allocated by each task.

- Don't need to return the heap capabilities as part of the details
  for each block since the heap region (and therefore its
  capabilities) can be determined from the block address.

- Renamed heap_task_info.h to esp_heap_task_info.h to fit the naming
  convention, and renamed the structs for totals and block details to
  better fit the revised function name.

- Provide full Doxygen commenting for the function and parameter
  structs.

Add copyright header to new files

Merges https://github.com/espressif/esp-idf/pull/1498

Merge branch 'feature/easy_lookup_of_errors' into 'master'

Make it easier to look up error messages

See merge request idf/esp-idf!1929

idf_size: Sort output on total-size instead of filename

esp_ping - Document that timeout units are in milliseconds

Remove 1000 multiplier from esp_ping_set_target() parameters that define time

heap: Correct the sense of a comment

i2s: fix type mismatch of intr_alloc_flags

Merges https://github.com/espressif/esp-idf/pull/1589

Update eclipse-setup.rst

Chapter Flash from Eclipse: Changed "Select Make Targets -> ..." to "Select Build Targets -> ..."    to match the Eclipse wording. Same with "Project -> Make Target" replace Make by build to match the Eclipse wording.

Make it easier to look up error messages

tools/gen_esp_err_to_name.py generates
components/esp32/esp_err_to_name.c for lookup of the error codes from
all of the IDF project and easily identify all codes in one place

Merge branch 'example/console_task_column_name' into 'master'

example(console): print column name for tasks.

See merge request idf/esp-idf!1948

example(console): print column name for tasks.

Merge branch 'bugfix/docs_prs_from_github' into 'master'

Small documenation and API fixes from GitHub

See merge request idf/esp-idf!1952

Merge branch 'bugfix/ethernet_mdc_mdio_config' into 'master'

Ethernet: set direction of SMI pins MDC and MDIO correctly

See merge request idf/esp-idf!1939

Update index-cn.rst. Closes https://github.com/espressif/esp-idf/issue/1620

Remove the THEN keyword from IF. Closes https://github.com/espressif/esp-idf/issue/1606

Both the TinyBasicPlus and the ESP32 variant don't use the THEN keyword in a IF statement

Fix function name typo. Closes https://github.com/espressif/esp-idf/issue/1572

esp_adc_cal/Add eFuse functionality

This commit updates the esp_adc_cal ocmponent to support new calibration methods
which utilize calibratoin values stored in eFuse. This commit includes LUT mode

Component/bt: add_params_check_in_prefer_conn_params()

Component/bt: fix set error params and add callback in adv params

Add option to continue running (with less ram) if psram is enabled but not detected

Merge branch 'bugfix/btdm_fix_example_log_missing_bug' into 'master'

component/bt: Fix BLE printf missing problem

See merge request idf/esp-idf!1912