docs: add CN translation of Windows setup guide

docs: add CN translation of Linux setup guide

docs: Add a temporary index page to get CN docs started

Merge branch 'bugfix/btdm_error_when_white_list_is_full' into 'master'

component/bt: Fix bug of adding device to white list has no callback when while list is full

See merge request !1689

Merge branch 'bugfix/btdm_disconnect_fail_during_pairing' into 'master'

component/bt: Fix bug of disconnected fail during pairing

See merge request !1672

Merge branch 'bugfix/idle_task_deletes_currently_running_task' into 'master'

freertos: prvCheckTasksWaitingTermination bugfix

See merge request !1686

Merge branch 'cherry-pick-4837f939-2' into 'master'

esp_timer:fix three bugs about timer get and timer alarm where overflow is not correct

See merge request !1695

Merge branch 'refactor/btdm_spp_client_demo' into 'master'

component/bt: refactor spp client demo

See merge request !1366

Merge branch 'bugfix/btdm_fix_memory_leak_for_SMP' into 'master'

component/bt: fix memory leak in SMP

See merge request !1690

Merge branch 'feature/docs_update_rmt_api' into 'master'

RMT API docs update, new example

See merge request !1564

Merge branch 'bugfix/blockdiag_windows_installation' into 'master'

A workaround for MSYS2 / Windows system to be able to install 'blockdiag'

See merge request !1684

Merge branch 'bugfix/iperf_example_bugfix' into 'master'

example: some modification about iperf example

See merge request !1603

Merge branch 'bugfix/add_iic_NACK' into 'master'

driver(i2c): to specify ack value for last I2C read in a transaction

See merge request !1580

add NACK for the last byte to read

freertos: prvCheckTasksWaitingTermination bugfix

Bugfix to prevent a self deleting no affinity task's memory from being freed by the
idle task of the other core before the self deleting no affinity task is able to context
switch out.  prvCheckTasksWaitingTermination now checks if the task is still on
pxCurrentTCB before freeing task memory.

component/bt: Fix bug of disconnected fail during pairing

component/bt: Fix bug of adding device to white list has no callback when while list is full

Merge branch 'bugfix/modify_bt_h' into 'master'

component/bt : change header file name bt.h to esp_bt.h in new bluetooth example

See merge request !1703

component/bt : change header file name bt.h to esp_bt.h in new bluetooth example

Merge branch 'feature/components_can_add_to_component_make_rules' into 'master'

Support Makefile.componentbuild so components can add to global component make rules

See merge request !1667

Merge branch 'feature/editorconfig' into 'master'

Add .editorconfig file

See merge request !1682

Merge branch 'bugfix/spiram_fails_after_esp_restart' into 'master'

Make psram function after an esp_restart as well.

See merge request !1694

component/bt: refactor spp client demo

 - fix the bug that before free the db pointer, the db was set to NULL

Merge branch 'feature/btdm_classic_discovery' into 'master'

component/bt: implement Classic Bluetooth GAP APIs for device and service discovery

See merge request !1576

Add support for Makefile.componentbuild files

Component/bt: fix memory leak in SMP

Merge branch 'bugfix/btdm_modify_code_format_and_comments' into 'master'

component/bt: modify code format and comments

See merge request !1631

Merge branch 'bugfix/btdm_send_data_length_req_after_read_feature_complete' into 'master'

component/bt: send data length request by host after read feature complete

See merge request !1639

esp_timer:fix three bugs about timer get and timer alarm where overflow is not correct

Fix the clock subsystem so it doesn't undo the weird condition spiram_psram.c jams the enable/reset bits of SPI3 in when 80MHz mode is selected anymore

example: some modification about iperf example

Modify default sdkconfig since some WiFi menuconfig options are changed

Merge branch 'feature/eth_set_mac_addr' into 'master'

emac:add set_eth_mac api

See merge request !1604

Merge branch 'bugfix/btdm_optimiz_adv_cb_func' into 'master'

Bugfix/btdm optimiz adv cb func

See merge request !1619

Merge branch 'bugfix/fix_some_wifi_bug' into 'master'

Fix some wifi bugs

See merge request !1680

Merge branch 'bugfix/btdm_mem_release' into 'master'

component/bt : fix btdm mem release cause 0x3ffbbb28-0x3ffbdb28 add to region but should not.

See merge request !1660

Merge branch 'bugfix/bootloader_v10_backwards_compat' into 'master'

esp32: Fix backwards compatibility for pre-v2.1 bootloaders

See merge request !1673

Merge branch 'feature/ringbuf_improvement' into 'master'

Feature/ringbuf improvement

See merge request !1571

Add .editorconfig file

remove newlinet in binary file

editorconfig style guide

correct format for rst hyperlinks

A workaround for MSYS2 / Windows system to be able to install 'blockdiag'

esp32: Fix backwards compatibility for pre-v2.1 bootloaders

Older bootloaders don't set RTC_XTAL_FREQ_REG or call rtc_clk_init(),
app needs to pick this up.

Reported at
https://esp32.com/viewtopic.php?f=2&t=3939&p=17836

Merge branch 'bugfix/log_tag_variables_static' into 'master'

log: Remove non-static TAG variables

See merge request !1674

Merge branch 'bugfix/i2c_fixes_pr1180' into 'master'

i2c: rx <-> tx typo's, NULLing free'd variable, consistent CRITICAL sects

See merge request !1551

Merge branch 'bugfix/windows_10_idf_monitor_redux' into 'master'

idf_monitor: Fix Windows 10 bug in cases where second console write also fails

See merge request !1675

Fix some wifi bugs

1. change first scanning channel to adjust different country code.

2. fix a bug that system crashes when station disconnects from AP.

component/bt: Optimized broadcast callback function, send the callback function to the application after the controller confirms receipt of the broadcast start.

1. optimiz the ble stop adv callback function.
2. added the osi_mutex_unlock in the bta_gattc_wait4_service_change_ccc_cback function when the p_timer_param == NULL ||  p_conn == NULL.

emac:add set_eth_mac api

Merge branch 'bugfix/i2c_use_queue_instead_of_eventbit' into 'master'

bugfix(i2c): use queue instead of event group for internal commands

See merge request !1616

idf_monitor: Fix Windows 10 bug in cases where second console write also fails

Although in my tests the second write always passes, people have reported
different results.

Closes https://github.com/espressif/esp-idf/issues/1136 (again)

log: Remove non-static TAG variables

Merge branch 'feature/monitor_log_toggle' into 'master'

feat(monitor): add new feature allowing disabling log display.

See merge request !1548

Merge branch 'bugfix/heap_alloc_typo' into 'master'

fix typo for heap cap free size

See merge request !1669

feat(monitor): add pause feature.

feat(monitor): add new feature allowing disabling log display.

Merge branch 'feature/doc_wroom_modules_with_ESP32-D0WD' into 'master'

The WROOM and WROVER family of modules is now extended with ESP-WROOM-32D and ESP32-WROOM-32U

See merge request !1654

Merge branch 'bugfix/uart1_console' into 'master'

Fixes for console output on UART1

See merge request !1649

Merge branch 'bugfix/sdmmc_vfs_deinit' into 'master'

SDSPI bug fixes

See merge request !1647

fix typo for heap cap free size

Merge branch 'bugfix/eclipse_warning' into 'master'

Resolves: Warning '-s option given but default rule can be matched'. Closes http…

See merge request !1658

Merge branch 'master' into 'bugfix/btdm_modify_code_format_and_comments'

# Conflicts:
#   examples/bluetooth/gatt_server_service_table/main/gatts_table_creat_demo.c

Merge branch 'feature/ulp_docs_update' into 'master'

ULP docs update

See merge request !1640

component/bt : fix btdm mem release cause 0x3ffbbb28-0x3ffbdb28 add to region but should not.

1. fix the bug. Modify the condition that esp_bt_controller_mem_release() shoud be only called before esp_bt_controller_init() or after esp_bt_controller_deinit()
2. modify the example to use esp_bt_controller_mem_release()

Merge branch 'bugfix/rtc_time' into 'master'

Fix compilation issue when using RTC time only, update Kconfig help and source code

See merge request !1650

Merge branch 'bugfix/fatfs_stat' into 'master'

Fix stat behavior for FATFS mount point

See merge request !1652

Component/bt: send data length request by host after read feature complete

Linked ESP32 datasheet and regulatory certificates

Merge branch 'feature/spiffs_mtime' into 'master'

Add optional mtime support in SPIFFS

See merge request !1579

Resolves: Warning '-s option given but default rule can be matched'. Closes https://github.com/espressif/esp-idf/issues/1338

Merge branch 'bugfix/note_about_main_xtal_frequency_selection' into 'master'

Getting Started docs: Updated information about setting the main XTAL frequency

See merge request !1645

Merge branch 'test/UT_master_slave_mode' into 'master'

unit-test-app: support multiple devices test cases

See merge request !1220

Fixed issues identified during review

1. Following https://esp32.com/viewtopic.php?f=14&t=3834 and https://github.com/espressif/esp-idf/issues/1351 updated information regarding selection of the main XTAL frequency. 2. Removed obsolete note about ': not a valid identifier...', as it does not show up anymore with the latests MSYS2 installation.

docs: add information about execution time of ULP instructions

Merge branch 'bugfix/gpio_config_block' into 'master'

driver(GPIO): use ULL for IO bit mask

See merge request !1627

Merge branch 'bugfix/minor_fixes_github' into 'master'

Minor fixes from github

See merge request !1638

time: rename time source option from FRC to "high-resolution timer"

libc time function now rely on esp_timer_get_time as the source of
high-resolution time, rather than FRC1 timer. Internally, on the ESP32
esp_timer implementation uses FRC2 timer.

- Change help text and labels in Kconfig to use "high-resolution timer"
  instead of FRC1. Keep existing Kconfig option name to be backwards
  compatible.
- Change references to "FRC1" in the source code to "FRC".

ulp: document the need to wait for RTC to be ready for wakeup

ulp: mention that instructions array must be declared in local scope

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

docs: add description of ULP I2C instructions

Merge branch 'bugfix/openssl_alpn' into 'master'

openssl: add feature check for MBEDTLS_SSL_ALPN

See merge request !1648

vfs/fatfs: use structures with bit fields for FAT date/time

Replace explicit masks and shifts with bit fields when working with FATFS date and time representations. Also zero-initialize remaining members of struct tm.

Fixes https://github.com/espressif/esp-idf/issues/1369.

i2c: rx <-> tx typo's, NULLing free'd variable, consistent CRITICAL sects

A couple of typos referencing tx_ring_buf when rx_ring_buf, slv_tx_mux
instead of slv_rx_mux.

Also, I2C_ENTER_CRITICAL()/I2C_EXIT_CRITICAL() usage was not consistent.
Only some of the _set_ functions had them.  Most of the _get_ function
had them?  It is my understanding that they should be wrapped around
writes, not reads? (I think we still need the lock for reading pairs of consistent values)

Also, the ticks_to_wait timeout handling in i2c_master_cmd_begin() would
not handle integer rollover correctly.

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

fatfs: fix double free in bailout path of esp_vfs_fat_sdmmc_mount

Fixes https://github.com/espressif/esp-idf/issues/1370

sdspi: use response timeout passed from upper layer

Previously SDSPI host driver would rely on retry count when waiting for
the card to read or write data. This caused different timeout times
depending on CPU frequency and card clock frequency. In practice, card
performance does not depend on these two factors.
This change uses timeout_ms field of sdmmc_command_t introduced
previously for SDMMC host.

Fixes https://esp32.com/viewtopic.php?f=2&t=3440&p=16037 and similar
issues related to SDSPI timeouts.

fatfs: fix deinit not called for SDSPI host

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

The WROOM and WROVER family of modules is now extended with ESP-WROOM-32D and ESP32-WROOM-32U

vfs/fatfs: fix stat call failing when called for mount point

FATFS does not support f_stat call for drive root. When handling stat
for drive root, don't call f_stat and just return struct st with S_IFDIR
flag set.

Closes #984

newlib/time: fix compilation error when only RTC is used as clock source

Fixes https://github.com/espressif/esp-idf/issues/1245

driver(i2c): corrected timeout range for i2c_set_timeout.

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

Merge branch 'feature/btdm_modify_header_file_name' into 'master'

component/btdm : change bt.h name to esp_bt.h to form the name prefix

See merge request !1644

Merge branch 'bugfix/heap_trace_realloc' into 'master'

heap_trace: fix bug in realloc for copying trace record

See merge request !1643

bootloader: don't log anything before uart_console_configure is called

esp32: fix incorrect clock enable bit name for UART0

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

openssl: add feature check for MBEDTLS_SSL_ALPN

Fixes https://github.com/espressif/esp-idf/issues/1342

component/btdm : change bt.h name to esp_bt.h to form the name prefix

heap_trace: fix bug in realloc for copying trace record

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

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

freertos/ringbuf: Added an API xRingbufferCreateNoSplit()

This is a wrapper API for creating a Ring Buffer, which ensures that
the ringbuffer can hold the given number of items, each item being of the
same given length.

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

freertos/ringbuf: Add an API xRingbufferIsNextItemWrapped()

Useful to check if the next item to receive is wrapped or not.
This is valid only if the ring buffer is initialised with type
RINGBUF_TYPE_ALLOWSPLIT.

This is as per the feature request here:
https://github.com/espressif/esp-idf/issues/806

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

freertos/ringbuf: Add an API xRingbufferGetCurFreeSize() to fetch current free size available

The earlier available API (xRingbufferGetMaxItemSize())just gives
a static max entry value possible for given ring buffer.
There was a feature request for an API which could provide
a real time available buffer size. See below:

https://github.com/espressif/esp-idf/issues/806

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

unit-test-app: support multiple devices test cases:

current unit-test-app don't support test components need to communicate
with each other (like GPIO, SPI ...). Now we add multiple devices mode
to unit test app, support writing and running test with multiple DUTs.

please refer to `docs/api-guides/unit-tests.rst` for detail.

Merge branch 'bugfix/fix_i2s_doc' into 'master'

docs: fix i2s code snippet for interrupt flags setting

See merge request !1637