docs: fix line endings of ULP docs

Merge branch 'bugfix/doc_generated_sections_v3.1' into 'release/v3.1'

docs: Move version-related includes to run in sphinx-build not make (backport v3.1)

See merge request idf/esp-idf!2989

docs: Add gen-version-specific-includes.py to executables list

docs: Move version-related includes to run in sphinx-build not make

Means they show up on ReadTheDocs(!)

Merge branch 'bugfix/http_client_null_auth_header_v3.1' into 'release/v3.1'

esp_http_client: Fixed exception on 401 without Www-Authenticate header (backport v3.1)

See merge request idf/esp-idf!2978

Merge branch 'bugfix/unit-test-build-fix_v3.1' into 'release/v3.1'

unit-test-app: don’t include project.mk for ut- targets (backport v3.1)

See merge request idf/esp-idf!2850

Merge branch 'bugfix/btdm_fix_get_bond_list_error_when_connection_with_no_bond_v3.1' into 'release/v3.1'

Component/bt: fix get bond list error when connection with no bond (backport v3.1)

See merge request idf/esp-idf!2981

Merge branch 'doc/versions_v3.1' into 'release/v3.1'

docs: Add version-specific include files, version documentation (backport v3.1)

See merge request idf/esp-idf!2974

Component/bt: fix get bond list error when connection with no bond

esp_http_client: Fixed exception on 401 without Www-Authenticate header
Closes https://github.com/espressif/esp-idf/issues/2246

freertos: Remove either one or two assertions from "fast path" of vPortCPUReleaseMutex()

Saves a few cycles by only testing the count validity once, and never for the common case where the
mutex was not recursively locked.

Merge branch 'bugfix/spi_flash_mmap_malloc_internal_v3.1' into 'release/v3.1'

spi_flash: allocate mmap pages array in internal memory (backport v3.1)

See merge request idf/esp-idf!2961

Merge branch 'mesh/bugfix_parent_switch_backport_v3.1' into 'release/v3.1'

mesh: modify parent switch mechanism (backport3.1)

See merge request idf/esp-idf!2977

Merge branch 'bugfix/add_mutex_for_some_touchpad_apis_v3.1' into 'release/v3.1'

fix(touch): add_mutex_for_some_touchpad_apis (backport v3.1)

See merge request idf/esp-idf!2963

mesh: modify parent switch mechanism

1. modify parent switch mechanism.
2. fix non-root doesn't clear the layer value in nvs.
3. fix retransmit the remove announcement packets.
4. add API esp_mesh_flush_upstream_packets().
5. automatically adjust passsive scan time based on the change of beacon interval.

Merge branch 'feature/nvs_version_check_v3.1' into 'release/v3.1'

nvs_flash: Version compatibility check for nvs storage (backport 3.1)

See merge request idf/esp-idf!2958

Merge branch 'bugfix/btdm_hfp_invalid_sco_param_v3.1' into 'release/v3.1'

component/bt: modify the invalid retransmission setting for SCO link in HFP(backport v3.1)

See merge request idf/esp-idf!2956

Merge branch 'bugfix/backport_several_bugfix_to_v3.1' into 'release/v3.1'

esp32: backport several WiFi bug fixes to v3.1

See merge request idf/esp-idf!2955

docs: Combine the common en/zh_CN Makefiles to one common file

docs: translate the version include script to Chinese

README: Add version-specific links

Make it clearer how the README fits in with the docs.

docs: Add version-specific include files, version documentation

* "git clone" command and a small version header are generated
  depending on git properties.
* Add Versions page with details about each version
* Make it clear using master branch is living on the "bleeding
  edge"

esp32: backport several WiFi bug fixes to v3.1

Backport following bug fixes to v3.1:

1. Bug fix of may connect to wrong AP in all channel scan

2. Station state machine change and fix ap loss

3. Add compatible to ccmp encryption

4. Update libphy.a to v3960:
   4.1 Decrease  phy_init time from 900us to 347us in sleep wakeup
   4.2 Fix RX STBC initialization
   4.3 Modify set_chan function to fix interrupt watchdog issue

5. Fix several wpa2 enterprise issues
   5.1 Fix heap corrupted bug
   5.2 Fix memory leak bug
   5.3 Make wpa2 enterprise thread-safe
   Closes https://github.com/espressif/esp-idf/issues/1569

6. Bugfix of coex wifi pm

Merge branch 'bugfix/remove_check_for_reason_assoc_expire_backport_v3.1' into 'release/v3.1'

test: remove check for REASON_ASSOC_EXPIRE (backport v3.1)

See merge request idf/esp-idf!2953

Merge branch 'feature/http_firmware_upgrade_v3.1' into 'release/v3.1'

esp_https_ota: Add esp_https_ota component (Backport v3.1)

See merge request idf/esp-idf!2954

fix(touch): add_mutex_for_some_touchpad_apis

esp_http_client: Add support for getting transport type

esp_https_ota: Add support for HTTPS based ota feature

spi_flash: allocate mmap pages array in internal memory

* spi_flash_mmap_pages needs pages array to be in internal memory.
  Document and check this.

* Fix a bug that spi_flash_mmap did not allocate pages array in
  internal memory.

* Minor style fixes: const-ify pages argument of spi_flash_mmap, add
  spaces around operators, mark output arguments with [out].

Closes https://github.com/espressif/esp-idf/issues/2229.

Merge branch 'feature/support_for_XM25QU64A_v3.1' into 'release/v3.1'

feature(flash): set QIO mode for XM25QU64A(1V8_8MB_flash) (backport v3.1)

See merge request idf/esp-idf!2950

Merge branch 'bugfix/http_chunked_read_v3.1' into 'release/v3.1'

esp_http_client: fixed http chunked encoding packet loss & add check data before read for ssl transport (backport v3.1)

See merge request idf/esp-idf!2952

esp_http_client: fixed http chunked encoding packet loss & add check data before read for ssl transport (backport v3.1)

nvs_flash: Version compatibility check for nvs storage

This change adds a check for compatibility between the nvs version
found on nvs flash and the one assumed by running code during nvs
initialization. Any mismatch is reported to the user using new error
code ESP_ERR_NVS_NEW_VERSION_FOUND.

Merge branch 'bugfix/add_queueset_critical_sections_v3.1' into 'release/v3.1'

freertos: Add critical sections to queue sets (backport v3.1)

See merge request idf/esp-idf!2789

component/bt: modify the invalid retransmission setting for SCO link in HFP

Merge branch 'bugfix/btdm_spp_crash_on_reset_v3.1' into 'release/v3.1'

component/bt: Fix bug of SPP crash on reset (backport v3.1)

See merge request idf/esp-idf!2951

test: update Wi-Fi test cases:

1. The test step for error code REASON_ASSOC_EXPIRE is not reliable. SoftAP
could also send error code WIFI_REASON_NOT_AUTHED
2. STA will be disconnected now if softAP restart DHCP server

component/bt: Fix bug of SPP crash on reset

In response to: https://github.com/espressif/esp-idf/issues/1998

feature(flash): support for QIO mode of XM25QU64A

Merge branch 'bugfix/ci_github_deploy_v31' into 'release/v3.1'

ci: Simplify github deployment (backport v3.1)

See merge request idf/esp-idf!2874

Merge branch 'bugfix/fix_crash_for_http2_request_v3.1' into 'release/v3.1'

fix the crash when http2_request example send/recv fail

See merge request idf/esp-idf!2941

fix the crash when http2_request example send/recv fail

Merge branch 'fix/sdio_speed_4bit_v3.1' into 'release/v3.1'

backport v3.1: fix(sdio): update sdio to better run in 4bit HS mode

See merge request idf/esp-idf!2759

Merge branch 'bugfix/coex_pause_v3.1' into 'release/v3.1'

fix coex pause cause bluetooth performance decrease (backport v3.1)

See merge request idf/esp-idf!2864

ci: Simplify github deployment

CI_COMMIT_REF_NAME lets us use a single line to git push

Merge branch 'feature/mbedtls_2_12_0_v3.1' into 'release/v3.1'

mbedtls: update to 2.12.0 (backport v3.1)

See merge request idf/esp-idf!2932

Merge branch 'bugfix/fix_uart_tx_bug_when_using_ringbuffer_for_v3.1' into 'release/v3.1'

driver(uart): Fixed uart tx_empty interrupt wdt timeout bug for release/v3.1

See merge request idf/esp-idf!2934

fix coex pause cause bluetooth performance decrease

1. it may cause BLE connection unstable
2. it may cause Classic BT connection unstable
3. it may cause BLE/BREDR scan performance decrease

Merge branch 'bugfix/btdm_fix_sc_mitm_bond_failed_in_smp_for_iphones_v3.1' into 'release/v3.1'

Component/bt:  fix SC_MITM_BOND failed in smp for iphones for v3.1

See merge request idf/esp-idf!2923

mbedtls: update to 2.12.0

Merge branch 'bugfix/ampdu_duplicate_v3.1' into 'release/v3.1'

Wifi: fix ampdu duplicate issue (backport v3.1)

See merge request idf/esp-idf!2797

Merge branch 'bugfix/btdm_a2dp_disconnect_reason_for_v3.1' into 'release/v3.1'

bugfix/btdm_a2dp_disconnect_reason(backport v3.1)

See merge request idf/esp-idf!2927

wifi: fix ampdu duplicate issue

fix ampdu duplicate issue

Merge branch 'bugfix/btdm_fix_ble_HIDD_demo_error_for_v3.1' into 'release/v3.1'

Component/bt: fix ble HID demo error for v3.1

See merge request idf/esp-idf!2922

Merge branch 'bugfix/btdm_lmp_trans_coll_state_uncleared_for_v3.1' into 'release/v3.1'

bugfix/btdm_lmp_trans_coll_state_uncleared(backport v3.1)

See merge request idf/esp-idf!2929

Component/bt:  fix SC_MITM_BOND failed in smp for iphones

component/bt: bugfix for uncleared LMP transaction collision state after rejecting sniff request from slave

component/bt: retrieve disconnection reason in AVDT when ACL-U link is disconnected

Merge branch 'bugfix/btdm_controller_deinit_v3.1' into 'release/v3.1'

bt : fix bug that bluetooth controller init/disable/enable/disable may cause exception(backport v3.1)

See merge request idf/esp-idf!2865

Component/bt: fix ble HID demo error

fix(sdmmc): disable all pulldowns used by sdmmc host

Merge branch 'bugfix/btdm_fix_queue_block_when_scanning_for_v3.1' into 'release/v3.1'

Component/bt: fix queue blocking when scanning for v3.1

See merge request idf/esp-idf!2893

driver(uart): Fixed uart tx_empty interrupt wdt timeout bug for release/v3.1

bt : fix bug that bluetooth controller init/disable/enable/disable may cause exception

1. when one task do deinit/init/disable/enable, especially different cpu
core, it may cause controller crash in ISR handler
2. fix while BLE is scanning, bluetooth controller is disabled cause BLE
scan is not abort.

Merge branch 'bugfix/spiffs_readdir_recursion_v3.1' into 'release/v3.1'

SPIFFS: fix stack overflow in readdir_r due to recursion (backport v3.1)

See merge request idf/esp-idf!2876

Merge branch 'bugfix/remove_bt_dependency_on_lwip_header_v3.1' into 'release/v3.1'

Bugfix/remove bt dependency on lwip header (backport v3.1)

See merge request idf/esp-idf!2907

heap: move get_all_caps to IRAM, used in unit test

freertos: bump limit for spinlock performance test to 300 cycles

newlib: fix unit test for psram config

heap: fix unit test for the case when less than 10k of IRAM is available

spi_master, ulp: fix aliasing errors in unit tests

unit-test-app: don’t include project.mk for ut- targets

If project.mk is included twice in recursive invocation of Make, some
variables defined on the first pass will not be redefined on the
second pass. Rather than cleaning up these variables before calling
Make recursively, don’t include IDF project.mk at all, if one of the
ut- targets is requested.

fix(sdio_slave): improve sdio slave for high speed and 4 bit mode

fix(sdio_slave): fix minor issues like return value of send function, output arg, etc.

Component/bt: fix hci_hal_env.rx_q and xHciH4Queue blocking when scanning

freertos: Add critical sections to queue sets.

Queue sets are not SMP safe. This commit adds
critical sections to queue sets. Unit tests for
queue sets have also been added.

Merge branch 'bugfix/btdm_fix_gattc_count_invalid_for_v3.1' into 'release/v3.1'

Component/bt: fix gattc get count invalid and discover included service error for v3.1

See merge request idf/esp-idf!2894

Merge branch 'doc/wifi_update_channel_state_information_document_v3.1' into 'release/v3.1'

docs: update channel state information document (backport v3.1)

See merge request idf/esp-idf!2796

wpa_supplicant: removed unrequired header dir include from component.mk

- Also fixed license header in rtc driver

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

bluedroid: remove dependency on `arpa/inet.h` include

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

Merge branch 'bugfix/ulp_example_fix_v3.1' into 'release/v3.1'

ULP example fixes (backport v3.1)

See merge request idf/esp-idf!2818

Merge branch 'bugfix/sdmmc_auto_stop_cmd_v3.1' into 'release/v3.1'

sdmmc: enable host auto_stop only for certain commands (backport for v3.1)

See merge request idf/esp-idf!2817

Merge branch 'bugfix/btdm_sco_end_crash_on_supv_to_for_v3.1' into 'release/v3.1'

bugfix/btdm_sco_end_crash_on_supv_to_for_v3.1(backport v3.1)

See merge request idf/esp-idf!2896

Merge branch 'feat/sdio_pullup_v3.1' into 'release/v3.1'

backport v3.1: fix(sdio_slave): fix the intr_recv issue that trigger receiving too fast cause assertion failed.

See merge request idf/esp-idf!2795

fix(sdio_slave): fix the intr_recv issue that trigger receiving too fast cause assertion failed.

also fix a race risk issue when recycle receiving buffers.

Component/bt: fix gattc get count invalid

component/bt: bugfix on the crash during end of sco link resulted from link supervision timeout

Merge branch 'bugfix/unit_test_thread_local_storage_v3_1' into 'release/v3.1'

ci/esp32: Fix race in "TLS Test" where s_task can go out of scope before cleanup finishes (v3.1 backport)

See merge request idf/esp-idf!2844

spiffs: add test case for readdir_r with large number of files

Ref. https://esp32.com/viewtopic.php?f=13&t=6486

Fix stackoverflow due to recursion in vfs_spiffs_readdir_r

Merge branch 'test/backport_ci_changes_to_v3.1' into 'release/v3.1'

test: backport ci changes (backport v3.1)

See merge request idf/esp-idf!2869

CI: support test one case multiple times by @bot

ci: temp disable http client tests:

connection is not stable. need to replace with local test servers.

tiny-test-fw: support ignore test cases in CI assign test stage

tiny-test-fw: fix exception during print debug info:

DUT log is unicode, might not be able to encode

CI: erase nvs partition before test:

Latest NVS partition bin can't be parsed by old IDF revision. Need to erase before test.

esp32/test: set 60s timeout for one deep sleep case

tiny-test-fw: save DUT log in different thread:

We found some SD card on Raspberry Pi could have very bad performance.
It could take seconds to save small amount of data.
If the DUT receives data and save it as log, then it stops receiving data until log is saved.
This could lead to expect timeout. As an workaround to this issue,
``BaseDUT`` class will create a thread to save logs.
Then data will be passed to ``expect`` as soon as received.

tiny-test-fw: fix incorrect wait timeout in expect

tiny-test-fw: filter examples with test level