soc/rtc: wait for SLOW_CLK cycle when switching CPU clock

Previous implementation waited for 20us after setting
RTC_CNTL_SOC_CLK_SEL_XTL register, using ets_delay_us, assuming that
the CPU was running at XTAL frequency. In reality, clock switch happened
on the next RTC_SLOW_CLK cycle, and CPU could be running at the previous
frequency (for example, 240 MHz) until then.
ets_delay_us would wait for 20 us * 40 cycles per us = 800 CPU cycles
(assuming 40 MHz XTAL; even less with a 26 MHz XTAL).
But if CPU was running at 240 MHz, 800 cycles would pass in just 3.3us,
while SLOW_CLK cycle could happen as much as 1/150kHz = 6.7us after
RTC_CNTL_SOC_CLK_SEL_XTL was set. So the software would not actually wait
long enough for the clock switch to happen, and would disable the PLL
while CPU was still clocked from PLL, leading to a halt.

This implementation uses rtc_clk_wait_for_slow_cycle() function to wait
until the clock switch, removing the need to wait for a fixed number of
CPU cycles.

soc/rtc: add a function to wait for slow clock cycle

Some RTC features are synchronized to RTC_SLOW_CLK, so sometimes
software needs to wait for the next slow clock cycle.
This function implements waiting using Timer Group clock calibration
feature.

Merge branch 'bugfix/tcpip_stack_overflow_logging_printf' into 'master'

lwip: Increase minimum TCP/IP task stack size if log level is Debug or Verbose

See merge request !1396

Merge branch 'bugfix/btdm_fix_bonded_public_scan_issue' into 'master'

component/bt: Fix scan problem of bonded device using public address

See merge request !1305

component/bt: Fix scan problem of bonded device using public address

Merge branch 'bugfix/ioctl_declaration' into 'master'

add missing ioctl declaration

See merge request !1442

add missing ioctl declaration

Previously ioctl was declared as a macro in lwip/sockets.h.
Disabling LWIP_POSIX_SOCKETS_IO_NAMES removed that declaration.

This adds sys/ioctl.h file and the missing declaration.
Also adds missing includes in vfs.c.

Merge branch 'bugfix/optmize_ipv6_event' into 'master'

bugfix: add netif info in event message when got ipv6 address

See merge request !959

Merge branch 'feature/esp32_pico_kit_v4_getting_started_guide' into 'master'

ESP32-PICO-KIT V4 Getting Started Guide

See merge request !1418

bugfix: add netif info in event message when got ipv6 address

Merge branch 'bugfix/unit_tests_build' into 'master'

spi_flash: fix build error with profiling enabled

See merge request !1437

Merge branch 'bugfix/select_fdset' into 'master'

LWIP: Fix select() FD_SET/FD_GET/etc

See merge request !1435

Merge branch 'bugfix/i2c_hw_fsm_recover' into 'master'

bugfix(i2c): add I2C hardware reset if the hw FSM get stuck

See merge request !1272

spi_flash: fix build error with profiling enabled

Merge branch 'bugfix/i2s_bck_polariy' into 'master'

bugfix(i2s): fix bck polarity issue when using pll clock.

See merge request !1428

Merge branch 'bugfix/rmt_thresh_check' into 'master'

bugfix(rmt): fix event thresh check issue

See merge request !1423

Merge branch 'feature/dfs' into 'master'

Dynamic frequency scaling

See merge request !1189

ESP32-PICO-KIT V4 Getting Started Guide

bugfix(i2c): add I2C hardware reset if the hw FSM get stuck

Reported from different sources from github or bbs:

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

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

We tested reading several sensor or other I2C slave devices, if the power and SDA/SCL wires are in proper condition, everything works find with reading the slave.
If we remove the power supply for the slave during I2C is reading, or directly connect SDA or SCL to ground, this would  cause the I2C FSM get stuck in wrong state, all we can do is the reset the I2C hardware in this case.
After this commit, no matter whether the power supply of I2C slave is removed or SDA / SCL are shorted to ground, the driver can recover from wrong state.

We are not sure whether this the save issue with the reported one yet, but to make the driver more robust.

Further information:

1. For I2C master mode, we have tested different situations, e.g., to short the SDA/SCL directly to GND/VCC, to short the SDA to SCL, to un-plug the slave device, to power off the slave device. Under all of those situations, this version of driver can recover and keep working.
2. Some slave device will die by accident and keep the SDA in low level, in this case, master should send several clock to make the slave release the bus.
3. Slave mode of ESP32 might also get in wrong state that held the SDA low, in this case, master device could send a stop signal to make esp32 slave release the bus.

Modifications:

1. Disable I2C_MASTER_TRAN_COMP interrupt to void extra interrupt.
2. Disable un-used timeout interrupt for slave.
3. Add bus reset if error detected for master mode.
4. Add bus clear if SDA level is low when error detected.
5. Modify the argument type of i2c_set_pin.
6. add API to set timeout value
7. add parameter check for timing APIs

newlib: Disable sys/types.h implementations of FD_SET, etc.

Temporary measure, until we have VFS-level select() support.

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

lwip: Make LWIP_SOCKET_OFFSET signed, remove need for underflow check

This reverts commit 541493d87769e0fa7fa128f7bdd0c2b5bcaa25d0.

Merge branch 'feature/FreeRTOS_Trace_Facilities' into 'master'

feature/make freertos trace facility configurable

See merge request !1420

Merge branch 'feature/i2s_built_in_adc' into 'master'

feature(I2S-ADC): add ADC mode for I2S.

See merge request !1077

freertos/make trace facility configurable

This commit makes configUSE_TRACE_FACILITY and
configUSE_STATS_FORMATTING_FUNCTIONS configurable in kconfig. Test cases fro the
functions enabled by the two configurations above have also been added.

Test cases for the following functions have been added...

- uxTaskGetSystemState()
- uxTaskGetTaskNumber()
- vTaskSetTaskNumber()

- xEventGroupClearBitsFromISR()
- xEventGroupSetBitsFromISR()
- uxEventGroupGetNumber()

- uxQueueGetQueueNumber()
- vQueueSetQueueNumber()
- ucQueueGetQueueType()

Test cases for the following functions were not required...

- prvListTaskWithinSingleList()
- prvWriteNameToBuffer()
- vTaskList()

Merge branch 'bugfix/touchpad_dac_mismatch_on_tp8_tp9' into 'master'

bugfix(touch): add workaround for touch pad DAC hardware source mismatch on tp8 and tp9.

See merge request !1288

Merge branch 'feature/unit-test-configs' into 'master'

unit-test-app: add support for testing multiple configurations

See merge request !1249

Merge branch 'feature/add_dns_api' into 'master'

tcpip_adapter/lwip: add dns api

See merge request !1405

Merge branch 'feature/heap_caps_dump' into 'master'

heap: Add heap_caps_dump() / heap_caps_dump_all() functions

See merge request !1422

heap: Add heap_caps_dump() / heap_caps_dump_all() functions

Dump the structure of the heap for debugging purposes.

Merge branch 'bugfix/init_nvs_flash_in_iperf_example' into 'master'

example: init nvs in iperf example

See merge request !1429

example: init nvs in iperf example

Need to call nvs_flash_init in iperf example

bugfix(i2s): fix bck polarity issue when using pll clock.

reported from github: https://github.com/espressif/esp-idf/issues/1119

Digital team think it is due to the decimal divider.
We can reset the i2s tx and rx when calling i2s_stop to avoid this.

unit tests: fix warnings, build with -Werror

- libsodium: silence warnings
- unit tests: fix warnings
- spiram: fix warnings
- ringbuf test: enable by default, reduce delays

build system: fix warning about undefined variable 'quote'

sleep: don't power down VDD_SDIO in light sleep if SPIRAM is enabled

update libstdc++.a built with pSRAM workaround

spi_flash: fix spi_flash_read into buffer in external RAM, add test

soc: correct values of SOC_BYTE_ACCESSIBLE_LOW, SOC_MEM_INTERNAL_LOW

Internal byte accessible memory starts with Internal ROM 1 at 0x3FF90000.
Region of RTC fast memory starting at 0x3FF80000 is not used in IDF as
it is mapped to PRO CPU only.

spi_flash_cache_enabled: report correct result in single core mode

unit test: adapt tests to single core configuration

unit-test: esp timer use same name as ets timer

We will use case name to select test cases in UT jobs.
Same case name is not allowed.

CI: support test UT with different config by CI

unit-test-app: new targets for building different configurations

Merge branch 'bugfix/malloc_failure' into 'master'

heap: Fix race condition causing malloc() to fail under some conditions

See merge request !1424

Merge branch 'bugfix/heap_check_integrity' into 'master'

heap: Fix spurious heap_caps_check_integrity() errors in Comprehensive mode

See merge request !1421

tcpip_adapter/lwip: make dhcp domain name server option configurable

Add api to configure dhcp option: domain name server

1.closes https://github.com/espressif/esp-idf/issues/162

2.closes https://github.com/espressif/esp-idf/issues/705

heap: Fix race condition causing malloc() to fail under some conditions

During a call to multi_heap_malloc(), if both these conditions were true:
- That heap only has one block large enough for the allocation
  (this is always the case if the heap is unfragmented).
- Another allocation is simultaneously occurring in the same heap.

... multi_heap_malloc() could incorrectly return NULL.

This caused IDF heap_caps_malloc() and malloc() to also fail, particularly
often if only one or two heaps had space for the allocation (otherwise
heap_caps_malloc() fails over to the next heap).

Merge branch 'docs/esp32_hooks' into 'master'

docs/Added documentation about esp32 hooks

See merge request !1417

bugfix(rmt): fix event thresh check issue

reported from: https://github.com/espressif/esp-idf/issues/1011

1. Fix event thresh check issue
2. Change IO number in example in case it conflicts with GPIO16(psram cs pin).

Merge branch 'bugfix/fix_some_wifi_bugs' into 'master'

esp32: fix some wifi bugs

See merge request !1414

heap: Fix spurious heap_caps_check_integrity() errors in Comprehensive mode

Heap was not being locked before poisoning, so heap_caps_check_integrity()
would sometimes race with checking the poison bytes and print unnecessary
errors.

Details: https://esp32.com/viewtopic.php?f=2&t=3348&p=15732#p15732

docs/Added documentation about esp32 hooks

This commit adds documentation about the esp32 Idle and Tick Hooks

Merge branch 'bugfix/cxx_exceptions' into 'master'

Full C++ Exception Support option (& reclaim memory when exceptions disabled)

See merge request !1353

esp32: fix some wifi bugs

1. Fix WiFi timer enable twice issue
2. Fix a softAP compatibility issue
3. Fix ebuf alloc counter issue
4. remove nvs_flash_init() in esp_wifi_init()
5. Fix scan only find few APs after set bssid
6. Fix can not connect to hidden SoftAP
7. Remove group key entry before connecting ot AP

examples/power_save: enable modem sleep and DFS by default

docs: add power management API reference

bt: lock APB frequency while BT controller is enabled

freertos: fix error when including xtensa-timer.h from other components

ethernet: lock APB frequency while ethernet is enabled

spi slave: lock APB frequency while driver is in use

spi master: lock APB frequency while in transaction

sdmmc: lock APB frequency while in transaction

sysview: always use TG as timestamp source

uart: add support for REF_TICK

freertos: deprecate XT_CLOCK_FREQ

- freertos: add deprecated definition for XT_CLOCK_FREQ
- flash_ops: don't use XT_CLOCK_FREQ
- unity: don't use XT_CLOCK_FREQ
- hw_random: don't use XT_CLOCK_FREQ
- core_dump: don't use XT_CLOCK_FREQ
- app_trace: don't use XT_CLOCK_FREQ
- xtensa_init: init xt_tick_divisor

esp32: add power management hooks for WiFi library

esp_timer: add support for frequency scaling

pm: support for tracing using GPIOs

freertos: add frequency switching hooks to ISR and idle task

esp32: initialize PM at startup, add Kconfig options

pm: initial implementation for ESP32

pm: initial version of power management APIs

unit tests: add test to dump esp_timer stats

unit tests: more robust esp_timer test

unit tests: fix ref_clock value obtained due to overflow

soc/rtc: add function to convert CPU frequency in MHz to rtc_cpu_freq_t

soc/rtc: add fast paths for switching between PLL and XTAL

esp_clk.h: make public, add getters for RTC time, CPU/APB freq

make esp_timer.h public

crosscore_int: add support for FREQ_SWITCH event

Merge branch 'feature/fsync' into 'master'

vfs,fat: add fsync to VFS interface, implement it for fatfs

See merge request !1412

Merge branch 'feature/update_phy362_rtc230' into 'master'

component/esp32 : update phy & rtc

See merge request !1411

component/esp32 : update phy & rtc

RTC V230
add BT AGC saturation protection, replace RTC V229.

PHY V362
Power up print: "phy_version: 362.0, 61e8d92, Sep 8 2017, 18:48:13"
1. esp_init_data_v3.bin
modify TX target power
modify WIFI & BT RX gain table
2. modify phy_close_rf()
3. add phy_set_most_tpw()
4. 26M crystal work OK
5. noise_check_loop ok

Merge branch 'bugfix/slave_dma_claim' into 'master'

fix(spi_slave): enable DMA clock when initialization.

See merge request !1385

Merge branch 'feature/reduce_min_num_of_wifi_static_tx_buffer' into 'master'

Reduce minimum number of WiFi static tx buffer

See merge request !1398

pthreads local storage: add test for unique keys

unit tests: If heap tracing is enabled in sdkconfig, leak trace each test

cxx: Add KConfig option for C++ exceptions, disable by default

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

(Additional 20KB is still used if C++ exception support is enabled in
menuconfig.)

vfs,fat: add fsync to VFS interface, implement it for fatfs

Unit tests: If a test fails due to corrupting memory, don't print a misleading source file name

idf_monitor: Demangle C++ names

cxx: Add a sanity check for C++ exception support

pthread: Add support for pthread thread local storage

Refactors LWIP to use this for the LWIP thread local semaphore

freertos: Idle task shouldn't hold xTaskQueueMutex while calling TLS destructors

If the callbacks use any blocking call (ie printf), this can otherwise trigger a deadlock.

cxx tests: Fix race condition w/ leak checker when tearing down test tasks

Merge branch 'feature/sockets_files_shared_fd_space' into 'master'

lwip & vfs: POSIX I/O functions operate on sockets and files (first stage, no select() yet)

See merge request !1352

Merge branch 'bugfix/add_mutex_for_dual_core_hooks' into 'master'

freertos/Add mutex for dual core hooks

See merge request !1406

Merge branch 'bugfix/ets_timer_iram' into 'master'

wifi/bt coexistence: Fix disabled cache access race when writing to flash

See merge request !1409

fix(spi_slave): enable DMA clock when initialization.

merging in the code updates to the SPI master code done in commit b834fcf78aa4cc16d4c3f5349286df3580d24edb.

TW#15670, Closes #1027

fix(periph_ctrl): fix reset function in `periph_ctrl.c`