Examples README's updated on peripherals, system and wifi

Updated main examples README to add missing examples folders and Getting Started links
Updated wifi/fastscan example README
Updated wifi examples README
Updated wifi main examples README
Added instructions and removed obviousness from examples README
Updates on example README in peripherals, system and wifi
Updates on example README in peripherals and added wave form pictures on wave_gen example
Updates and review on example README
Revision on unit style convention
Added the getting started link for each supported version
Readme review and recommended enhancements
Added the default note on the wave form option info
Added the ESP32-C3 support information on the temperature sensor example README
Added Getting Started information for ESP32-S2 and ESP32-C3
Issue fixed on the supported target on README
Resolved merge conflict

examples/README.md

@@ -1,31 +1,43 @@
 # Examples
 
-This directory contains a range of example ESP-IDF projects. These are intended to demonstrate parts of ESP-IDF functionality, and to provide code that you can copy and adapt into your own projects.
+This directory contains a range of example ESP-IDF projects. These examples are intended to demonstrate parts of the ESP-IDF functionality, and to provide code that you can copy and adapt into your own projects.
 
 # Example Layout
 
 The examples are grouped into subdirectories by category. Each category directory contains one or more example projects:
 
-* `bluetooth/bluedroid` contains Classic BT, BLE and coex examples using default Bluedroid host stack.
-* `bluetooth/nimble` contains BLE examples using NimBLE host stack.
-* `bluetooth/esp_ble_mesh` contains ESP BLE Mesh examples.
-* `bluetooth/hci` contains HCI transport (VHCI and HCI UART) examples
-* `ethernet` contains Ethernet examples.
-* `get-started` contains some very simple examples with minimal functionality.
-* `mesh` contains Wi-Fi Mesh examples.
-* `peripherals` contains examples showing driver functionality for the various onboard ESP32 peripherals.
-* `protocols` contains examples showing network protocol interactions.
-* `storage` contains examples showing data storage methods using SPI flash or external storage like the SD/MMC interface.
-* `system` contains examples which demonstrate some internal chip features, or debugging & development tools.
-* `wifi` contains examples of advanced Wi-Fi features. (For network protocol examples, see `protocols` instead.)
-* `build_system` contains examples of build system features
+* `bluetooth/bluedroid` Classic BT, BLE and coex examples using default Bluedroid host stack.
+* `bluetooth/nimble` BLE examples using NimBLE host stack.
+* `bluetooth/esp_ble_mesh` ESP BLE Mesh examples.
+* `bluetooth/hci` HCI transport (VHCI and HCI UART) examples.
+* `build_system` Examples of build system features.
+* `cxx` C++ language utilization examples and experimental components.
+* `ethernet` Ethernet network examples.
+* `get-started` Simple examples with minimal functionality. Good start point for beginners.
+* `mesh` Wi-Fi Mesh examples.
+* `peripherals` Examples showing driver functionality for the various onboard ESP32 peripherals.
+* `protocols` Examples showing network protocol interactions.
+* `provisioning` Wi-Fi provisioning examples.
+* `security` Examples about security features.
+* `storage` Examples showing data storage methods using SPI flash, external storage like the SD/MMC interface and flash partitioning.
+* `system` Demonstrates some internal chip features, or debugging & development tools.
+* `wifi` Advanced Wi-Fi features (For network protocol examples, see `protocols` instead.)
+
+In addition to these examples, `commmon_components` directory contains code shared by several examples.
 
 # Using Examples
 
+Before building an example, be sure to follow the Getting Started guide to ensure you have the required development environment.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
+
+
 Building an example is the same as building any other project:
 
-* Follow the Getting Started instructions which include building the "Hello World" example.
 * Change into the directory of the new example you'd like to build.
+* Run `idf.py set-target TARGET` to select the correct chip target to build before opening the project configuration menu. By default the target is `esp32` and the options are `esp32`, `esp32s2` and `esp32c3`.
 * Run `idf.py menuconfig` to open the project configuration menu. Most examples have a project-specific "Example Configuration" section here (for example, to set the WiFi SSID & password to use).
 * `idf.py build` to build the example.
 * Follow the printed instructions to flash, or run `idf.py -p PORT flash`.

examples/peripherals/gpio/generic_gpio/README.md

@@ -1,15 +1,73 @@
 # Example: GPIO
 
-This test code shows how to configure gpio and how to use gpio interrupt.
+(See the README.md file in the upper level 'examples' directory for more information about examples.)
+
+This test code shows how to configure GPIO and how to use it with interruption.
 
 ## GPIO functions:
 
- * GPIO18: output
- * GPIO19: output
- * GPIO4:  input, pulled up, interrupt from rising edge and falling edge
- * GPIO5:  input, pulled up, interrupt from rising edge.
+| GPIO     | Direction | Configuration                                          |
+| -------- | --------- | ------------------------------------------------------ |
+| GPIO18   | output    |                                                        |
+| GPIO19   | output    |                                                        |
+| GPIO4    | input     | pulled up, interrupt from rising edge and falling edge |
+| GPIO5    | input     | pulled up, interrupt from rising edge                  |
 
 ## Test:
- * Connect GPIO18 with GPIO4
- * Connect GPIO19 with GPIO5
- * Generate pulses on GPIO18/19, that triggers interrupt on GPIO4/5
+ 1. Connect GPIO18 with GPIO4
+ 2. Connect GPIO19 with GPIO5
+ 3. Generate pulses on GPIO18/19, that triggers interrupt on GPIO4/5
+
+## How to use example
+
+Before project configuration and build, be sure to set the correct chip target using `idf.py set-target <chip_name>`.
+
+### Hardware Required
+
+* A development board with ESP32/ESP32-S2/ESP32-C3 SoC (e.g., ESP32-DevKitC, ESP-WROVER-KIT, etc.)
+* A USB cable for Power supply and programming
+* Some jumper wires to connect GPIOs.
+
+### Configure the project
+
+### Build and Flash
+
+Build the project and flash it to the board, then run the monitor tool to view the serial output:
+
+Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
+
+(To exit the serial monitor, type ``Ctrl-]``.)
+
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
+
+## Example Output
+
+As you run the example, you will see the following log:
+
+```
+I (317) gpio: GPIO[18]| InputEn: 0| OutputEn: 1| OpenDrain: 0| Pullup: 0| Pulldown: 0| Intr:0 
+I (327) gpio: GPIO[19]| InputEn: 0| OutputEn: 1| OpenDrain: 0| Pullup: 0| Pulldown: 0| Intr:0 
+I (337) gpio: GPIO[4]| InputEn: 1| OutputEn: 0| OpenDrain: 0| Pullup: 1| Pulldown: 0| Intr:1 
+I (347) gpio: GPIO[5]| InputEn: 1| OutputEn: 0| OpenDrain: 0| Pullup: 1| Pulldown: 0| Intr:1 
+Minimum free heap size: 289892 bytes
+cnt: 0
+cnt: 1
+cnt: 2
+cnt: 3
+cnt: 4
+cnt: 5
+cnt: 6
+cnt: 7
+cnt: 8
+cnt: 9
+cnt: 10
+...
+```
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/peripherals/rmt/ir_protocols/README.md

@@ -32,7 +32,7 @@ Example connection :
 
 Open the project configuration menu (`idf.py menuconfig`). 
 
-In the `Example Connection Configuration` menu:
+In the `Example Configuration` menu:
 
 * Select the infrared protocol used in the example under `Infrared Protocol` option.
 * Set the GPIO number used for transmitting the IR signal under `RMT TX GPIO` option.
@@ -44,7 +44,11 @@ Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
 
 (To exit the serial monitor, type ``Ctrl-]``.)
 
-See the [Getting Started Guide](https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html) for full steps to configure and use ESP-IDF to build projects.
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
 
 ## Example Output
 

examples/peripherals/rmt/morse_code/README.md

@@ -31,7 +31,7 @@ GPIO18 +----/\/\/\----+------|>|-----+ GND
 
 Open the project configuration menu (`idf.py menuconfig`). 
 
-In the `Example Connection Configuration` menu:
+In the `Example Configuration` menu:
 
 * Set the GPIO number used for transmitting the IR signal under `RMT TX GPIO` optin.
 
@@ -41,7 +41,11 @@ Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
 
 (To exit the serial monitor, type ``Ctrl-]``.)
 
-See the [Getting Started Guide](https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html) for full steps to configure and use ESP-IDF to build projects.
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
 
 
 ## Example Output
@@ -59,4 +63,4 @@ I (2814) example: Transmission complete
 
 ## Troubleshooting
 
-For any technical queries, please open an [issue] (https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/peripherals/secure_element/atecc608_ecdsa/README.md

@@ -1,34 +1,54 @@
 | Supported Targets | ESP32 |
 | ----------------- | ----- |
 
-# ESP32-WROOM-32SE ECDSA sign/verify example
+# ECDSA sign/verify Example with ESP32-WROOM-32SE
+
 ## Description
-This example requires [ESP32-WROOM-32SE](https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32se_datasheet_en.pdf) which has Microchip's [ATECC608A](https://www.microchip.com/wwwproducts/en/ATECC608A) (Secure Element) integrated on the module. The example performs `ECDSA sign/verify` functions on sample data using hardware private key stored in ATECC608A chip.If you want to use bare `ATECC608A` chip (Secure Element) with `ESP32-WROOM-32` module by making external connections, please refer [this](https://github.com/espressif/esp-cryptoauthlib/blob/master/esp_cryptoauth_utility/README.md#using-atecc608a-with-esp32-wroom-32) for details.
-See the README.md file in the upper level examples directory for more information about examples.
-## Hardware
+
+(See the README.md file in the upper level 'examples' directory for more information about examples.)
+
+This example requires [ESP32-WROOM-32SE](https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32se_datasheet_en.pdf) which has Microchip's [ATECC608A](https://www.microchip.com/wwwproducts/en/ATECC608A) (Secure Element) integrated on the module.
+
+The example performs `ECDSA sign/verify` functions on sample data using hardware private key stored in ATECC608A chip. If you want to use bare `ATECC608A` chip (Secure Element) with `ESP32-WROOM-32` module by making external connections, please refer [this](https://github.com/espressif/esp-cryptoauthlib/blob/master/esp_cryptoauth_utility/README.md#using-atecc608a-with-esp32-wroom-32) for details.
+
+## How to use example
+
+Before project configuration and build, be sure to set the correct chip target using `idf.py set-target <chip_name>`.
+
+### Hardware Required
+
 To get started you will need a  `ESP32-WROOM-32SE` development board which integrates Microchip’s ATECC608A CryptoAuth chip in the module.
 
-## Configuration
+* A development board with ESP32-WROOM-32SE SoC or an custom board with the `ATECC608A` IC.
+* A USB cable for Power supply and programming
+
+### Configure the project
+
 ATECC608A chip on ESP32-WROOM-32SE should be configured to run the example, for details on configuration of ATECC608A chip, please refer [esp_cryptoauth_utility](https://github.com/espressif/esp-cryptoauthlib/blob/master/esp_cryptoauth_utility/README.md#esp_cryptoauth_utility)
 
-1) Set type of `ATECC608A` chip in menuconfig.
+Open the project configuration menu (`idf.py menuconfig`). 
 
-*   `menuconfig->Component config->esp-cryptoauthlib->Choose Type of ATECC608A chip`.
-for more details refer [Find ATECC608A chip type](https://github.com/espressif/esp-cryptoauthlib/blob/master/esp_cryptoauth_utility/README.md#find-type-of-atecc608a-chip-connected-to-esp32-wroom32-se).
+In the `Component config -> esp-cryptoauthlib` menu:
 
-2) Enable `Hardware ECDSA sign/verify` in menuconfig as by enabling following. (Enabled by default for this example)
+* Use `Choose the type of ATECC608A chip` to set the Crypto IC type [1].
+* Use `Enable Hardware ECDSA keys for mbedTLS` Enable Hardware ECDSA.
+    * Set `Enable ATECC608A sign operations in mbedTLS` to use Hardware ECDSA sign.
+    * Set `Enable ATECC608A verify operations in mbedTLS` to use Hardware ECDSA verify.
+* Set `I2C SDA pin used to communicate with the ATECC608A`.
+* Set `I2C SCL pin used to communicate with the ATECC608A`.
 
-*   `menuconfig->Component config->esp-cryptoauthlib->Enable Hardware ECDSA keys for mbedTLS`
-*   `menuconfig->Component config->esp-cryptoauthlib->Enable ATECC608A sign operations in mbedTLS`
-*   `menuconfig->Component config->esp-cryptoauthlib->Enable ATECC608A verify operations in mbedTLS`
+[1]: for more details refer [Find ATECC608A chip type](https://github.com/espressif/esp-cryptoauthlib/blob/master/esp_cryptoauth_utility/README.md#find-type-of-atecc608a-chip-connected-to-esp32-wroom32-se).
 
-## Build and Flash
+### Build and Flash
 
-Run following command to build and flash the project.
-```
-idf.py -p PORT flash monitor
-```
+Build the project and flash it to the board, then run the monitor tool to view the serial output:
+
+Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
 
 (To exit the serial monitor, type ``Ctrl-]``.)
 
-See the [Getting Started Guide](https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html) for full steps to configure and use ESP-IDF to build projects.
+See the [Getting Started Guide](https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html) for all the steps to configure and use the ESP-IDF to build projects.
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/peripherals/temp_sensor/README.md

@@ -1,9 +1,9 @@
-| Supported Targets | ESP32-S2 |
-| ----------------- | -------- |
+| Supported Targets | ESP32-S2 | ESP32-C3 |
+| ----------------- | -------- | -------- |
 
-# ESP32-S2 Temperature Sensor Example
+# Temperature Sensor Example
 
-The ESP32-S2 has a built-in temperature sensor. The temperature sensor module contains an 8-bit Sigma-Delta ADC and a temperature offset DAC.    
+The ESP32-S2 and ESP32-C3 has a built-in temperature sensor. The temperature sensor module contains an 8-bit Sigma-Delta ADC and a temperature offset DAC.    
 
 The conversion relationship is the first two columns of the table below. Among them, `offset = 0`(default) is the main measurement option, and other values are extended measurement options.  
 
@@ -15,7 +15,26 @@ The conversion relationship is the first two columns of the table below. Among t
 |     3     |   1    |     -30 ~ 50     |       < 2        |
 |     4     |   2    |     -40 ~ 20     |       < 3        |
 
-* Log output :
+## How to use example
+
+Before project configuration and build, be sure to set the correct chip target using `idf.py set-target <chip_name>`.
+
+### Hardware Required
+
+* A development board with ESP32-S2 or ESP32-C3 SoC (e.g., ESP32-S2-Saola-1, ESP32-S2-DevKitM-1, ESP32-C3-DevKitM-1, etc.)
+* A USB cable for power supply and programming
+
+### Build and Flash
+
+Build the project and flash it to the board, then run monitor tool to view serial output:
+
+Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
+
+(To exit the serial monitor, type ``Ctrl-]``.)
+
+See the [Getting Started Guide](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html) for full steps to configure and use ESP-IDF to build projects.
+
+## Example Output
 
 ```
 I (243) TempSensor: Initializing Temperature sensor
@@ -27,4 +46,8 @@ I (2253) TempSensor: Temperature out celsius 26.848801°C
 I (3253) TempSensor: Temperature out celsius 26.848801°C
 I (4253) TempSensor: Temperature out celsius 27.287399°C
 I (5253) TempSensor: Temperature out celsius 27.287399°C
-```
+```
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/peripherals/timer_group/README.md

@@ -15,7 +15,11 @@ Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
 
 (To exit the serial monitor, type ``Ctrl-]``.)
 
-See the [Getting Started Guide](https://docs.espressif.com/projects/esp-idf/en/latest/get-started/index.html) for full steps to configure and use ESP-IDF to build projects.
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
 
 ## Example Output
 
@@ -57,4 +61,4 @@ Time   : 0.00398480 s
 
 ## Troubleshooting
 
-For any technical queries, please open an [issue] (https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/peripherals/wave_gen/README.md

@@ -1,13 +1,13 @@
 | Supported Targets | ESP32 |
 | ----------------- | ----- |
 
-# Wave generator Example
+# Wave Generator Example
 
-(See the README.md file in the upper level 'examples' directory for more information about examples.)
+(See the README.md file in the upper level 'examples' directory for more information about examples)
 
 This example demonstrates how to implement a software controlled signal generator by utilizing the DAC and Timer Group drivers. All waveforms demonstrated in this example are generated by software.
 
-Users can connect DAC output channel to their devices and use it as an simple analog signal output source.
+Users can connect DAC output channel to their devices and use it as a simple analog signal output source.
 
 ## How to use this example
 
@@ -15,82 +15,76 @@ Users can connect DAC output channel to their devices and use it as an simple an
 
 * A development board with ESP32 SoC (e.g., ESP32-DevKitC, ESP-WROVER-KIT, etc.)
 * A USB cable for power supply and programming
-* A bunch of cables
-* Target device
+* Target device or oscilloscope (not required)
 
-Make sure DAC output pin which is GPIO25 if channel 1 set, GPIO26 if channel 2 set, be connected to target device correctly.
+Make sure the DAC output pin (which is the GPIO25 if channel 1 set, GPIO26 if channel 2 set) is connected to the target device correctly.
 
 ### Configure the project
-Under example folder, right click and select 'open terminal here'
 
-Execute following statements in terminal:
+Open the project configuration menu (`idf.py menuconfig`). 
 
-```
-idf.py menuconfig
-```
-
-In `Example  Configuration`, set the following options:
-
-#### DAC channel Num
+In the `Example Configuration` menu:
 
-ESP32 DAC contains two channels:
- * **DAC_CHANNEL_1 (GPIO25), selected by default.**
- * DAC_CHANNEL_2 (GPIO26)
-
-#### Wave form
-
-This example demonstrates one of the following waveforms:
-* **Sine, selected by default.**
-* Triangle
-* Sawtooth
-* Square
+* Use `DAC Channel Num` to select the DAC number.
+* Use `Waveform` to select the waveform type.
+    * Select `Sine` (*default*), `Triangle`, `Sawtooth` or `Square` wave type.
+* Select `Wave frequency` from the available range.
+* Set the `Enable output voltage log` if you want to print the log in the terminal.
 
 #### Wave frequency
 
-About this option:
-
-This signal generator has a range of frequency is 1kHz to 17kHz. **3kHz selected by default.**
+For this example, the range of frequency is from 1 kHz to 17 kHz. **3 kHz is selected by default.**
 
-Modify the frequency will change the number of DAC output points. That will affect the smoothness of curve as well. Those output points are used to calculate the raw value(0~255) of each output point. All of these raw value are stored in an array.
+If you modify the frequency, you will change the number of DAC output points. This will affect the smoothness of the curve as well.
+Each output point value is calculated by the DAC resolution of 8-bits (0~255). All of these raw values are stored in an array.
 
-Based on the given frequency, the number of DAC output points for each cycle can be caluculated by following formula:
+Based on the given frequency, the number of DAC output points for each cycle can be calculated through the following formula:
 ```num_of_output_points = 1000000(us)/(7 us * frequency)```
 
-For example, with high frequency, 20kHz will results in generating only 10 output points, the curve will be sharp and zigzag.
+For example, with high frequency, 20 kHz will generate only 10 output points; the curve will be edgy.
 
-On the contrary, 500 Hz, low frequency relatively, will results in many DAC output points and the array cannot stores so many values that it will causes array overboundary.
+On the other hand, 500 Hz, a relative low frequency, will result in many DAC output points and the array will not be able to store all of the generated data.
 
-In short, there will be less output points per cycle in higher frequency, and more points in lower frequency.
+Thus, there will be less output points per cycle in higher frequency, and more points in lower frequency.
 
-After got the raw value, the real output voltage can be calculated through following formula (VDD is 3.3V):
+After the raw value calculation, the real output voltage can be converted through the following formula (VDD is 3.3 V):
 
 ```points_voltage = (VDD * DAC_OUTPUT / 255)```
 
-The voltage is in range of 0~3300mV.
+The voltage is within the range of 0~3300 mV.
 
 #### Enable output voltage log
 
 **Disabled selected by default.**
 
-If enabled, expected voltage of each points will be shown in terminal. It's intuitive for debugging and testing. If output example is needed, read **Example Output** chapter below.
+If enabled, the expected voltage of each point will be printed on the terminal.
 
 ### Build and Flash
-After configure step is done, build project and flash it to the board:
 
-```
-$ idf.py -p PORT flash monitor
-```
+Build the project and flash it to the board, then run the monitor tool to view the serial output:
+
+Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
 
 (To exit the serial monitor, type ``Ctrl-]``.)
 
-See the `Getting Started Guide` for full steps to configure and use ESP-IDF to build projects.
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
 
 ## Example Output
-If oscilloscope is available, the target wave will show on oscilloscope after running this example.
 
-Additionally, if more specific output voltage information is needed, run menuconfig and set "Enable print output voltage" to "Enabled". Then, more information will show as log in terminal.
+If an oscilloscope is available, the target wave will be displayed in it after running this example.
 
-For example, set wave frequency, waveform to 3kHz and sine respectively, and also enable print output voltage option. The output information will show in log in terminal as following:
+#### Sine:
+![Sine](image/sine.png)
+#### Triangle:
+![Triangle](image/triangle.png)
+#### Sawtooth:
+![Sawtooth](image/sawtooth.png)
+#### Square:
+![Square](image/square.png)
+
+The output log will be shown in the terminal as the following (if `Enable output voltage log` is enabled):
 
 ```
 I (318) Wave generator: DAC output channel: 1
@@ -112,4 +106,7 @@ I (1338) Wave generator: Output voltage(mV): 3183
 ....
 
 ```
-`Output voltage` in log means real voltage, in mV, which is output through GPIO by device.
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/system/task_watchdog/README.md

@@ -1,12 +1,65 @@
-# Example: task_watchdog
+# Task Watchdog Example
 
 This test code shows how to initialize the task watchdog, add tasks to the
 watchdog task list, feeding the tasks, deleting tasks from the watchdog task
 list, and deinitializing the task watchdog.
 
+## How to use example
 
-### Test:
+Before project configuration and build, be sure to set the correct chip target using `idf.py set-target <chip_name>`.
 
-Program should run without error. Comment out "esp_task_wdt_feed()" to observe
-a watchdog timeout.
+### Hardware Required
 
+* A development board with ESP32/ESP32-S2/ESP32-C3 SoC (e.g., ESP32-DevKitC, ESP-WROVER-KIT, etc.)
+* A USB cable for Power supply and programming
+
+### Configure the project
+
+Program should run without error. Comment out `esp_task_wdt_reset()` to observe a watchdog timeout.
+
+### Build and Flash
+
+Build the project and flash it to the board, then run monitor tool to view serial output:
+
+Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
+
+(To exit the serial monitor, type ``Ctrl-]``.)
+
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
+
+## Example Output
+
+As you run the example, you will see the following log:
+
+With `esp_task_wdt_reset()`:
+
+```
+I (0) cpu_start: Starting scheduler on APP CPU.
+Initialize TWDT
+Delay for 10 seconds
+Unsubscribing and deleting tasks
+Complete
+```
+
+Without `esp_task_wdt_reset()`:
+```
+I (0) cpu_start: Starting scheduler on APP CPU.
+Initialize TWDT
+Delay for 10 seconds
+E (6316) task_wdt: Task watchdog got triggered. The following tasks did not reset the watchdog in time:
+E (6316) task_wdt:  - reset task (CPU 0)
+E (6316) task_wdt:  - reset task (CPU 1)
+E (6316) task_wdt: Tasks currently running:
+E (6316) task_wdt: CPU 0: IDLE
+E (6316) task_wdt: CPU 1: IDLE
+E (6316) task_wdt: Print CPU 0 (current core) backtrace
+
+```
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/wifi/README.md

@@ -1,48 +1,24 @@
 # Wi-Fi Examples
 
-Including some examples about wifi.
-
-## wpa2_enterprise
-
-Show how ESP32 connects to AP with wpa2 enterprise encryption.
-
-See the [README.md](./wpa2_enterprise/README.md) file in the project [wpa2_enterprise](./wpa2_enterprise/).
-
-## power_save
-
-Show how to use power save mode of wifi.
-
-See the [README.md](./power_save/README.md) file in the project [power_save](./power_save/).
-
-## wps(Wifi Protected Setup)
-
-shows how to use wps(Wifi Protected Setup).
-
-See the [README.md](./wps/README.md) file in the project [wps](./wps/).
-
-## espnow
-
-shows how to use espnow.
-
-See the [README.md](./espnow/README.md) file in the project [espnow](./espnow/).
-
-## fast_scan
-
-Show how to use fast scan while connecting to an AP.
-
-See the [README.md](./fast_scan/README.md) file in the project [fast_scan](./fast_scan/).
-
-## scan
-
-Show how to scan for all the available APs.
-
-See the [README.md](./scan/README.md) file in the project [scan](./scan/).
-
-## FTM(Fine Timing Measurement)
-
-Shows how to use FTM(Fine Timing Measurement).
-
-See the [README.md](./ftm/README.md) file in the project [ftm](./ftm/).
+This directory contains a range of examples ESP-IDF projects. These are intended to demonstrate the Wi-Fi functionality, and to provide code that you can copy and adapt into your own projects.
+
+# Example Layout
+
+The examples are grouped into sub-directories by category. Each category directory contains one or more example projects:
+
+* `espnow` is the connectionless Wi-Fi communication protocol.
+* `fast_scan` shows how to use fast scan while connecting to an AP..
+* `ftm` is a how to use FTM (Fine Timing Measurement) feature to calculate distance between devices.
+* `getting_started` contains the basic examples for using Wi-Fi in STA and AP mode.
+* `iperf` shows the common performance measurements for two ESP running this example.
+* `power_save` contains a how to use power save mode of Wi-Fi.
+* `roaming` contains a example using 802.11k and 802.11v APIs.
+* `scan` shows how to scan for all the available APs.
+* `simple_sniffer` demonstrates basic usage of WiFi sniffer mode by saving packets into SD card with pcap format.
+* `smart_config` shows how ESP connects to a target AP with ESPTOUCH.
+* `wifi_easy_connect` shows how to configure an ESP device as an enrollee using Device Provisioning Protocol (DPP).
+* `wpa2_enterprise` connects to AP with WPA2 enterprise encryption.
+* `wps` contains a how to use the Wi-Fi Protected Setup protocol.
 
 # More
 

examples/wifi/fast_scan/README.md

@@ -1,11 +1,94 @@
-# Wifi Fast Scan Example
+# Wi-Fi Fast Scan Example
 
-This example shows how to use the scan functionality of the Wi-Fi driver of ESP32 for connecting to an AP.
+(See the README.md file in the upper level 'examples' directory for more information about examples.)
+
+This example shows how to use the scan functionality of the Wi-Fi driver of ESP for connecting to an AP.
 
 Two scan methods are supported: fast scan and all channel scan.
 
-* fast scan: in this mode, scan finishes right after a matching AP is detected, even if channels are not completely scanned. You can set thresholds for signal strength, as well as select desired authentication modes provided by the AP's. The Wi-Fi driver will ignore AP's that fail to meet mentioned criteria.
+* `fast scan`: in this mode, scan finishes right after a matching AP is detected, even if channels are not completely scanned. You can set thresholds for signal strength, as well as select desired authentication modes provided by the AP's. The Wi-Fi driver will ignore AP's that fail to meet mentioned criteria.
 
-* all channel scan: scan will end only after all channels are scanned; the Wi-Fi driver will store 4 of the fully matching AP's. Sort methods for AP's include rssi and authmode. After the scan, the Wi-Fi driver selects the AP that fits best based on the sort.
+* `all channel scan`: scan will end only after all channels are scanned; the Wi-Fi driver will store 4 of the fully matching AP's. Sort methods for AP's include rssi and authmode. After the scan, the Wi-Fi driver selects the AP that fits best based on the sort.
 
 After the scan, the Wi-Fi driver will try to connect. Because it needs to to allocate precious dynamic memory to store matching AP's, and, most of the cases, connect to the AP with the strongest reception, it does not need to record all the AP's matched. The number of matches stored is limited to 4 in order to limit dynamic memory usage. Among the 4 matches,  AP's are allowed to carry the same SSID name and all possible authentication modes - Open, WEP, WPA and WPA2.
+
+## How to use example
+
+Before project configuration and build, be sure to set the correct chip target using `idf.py set-target <chip_name>`.
+
+### Hardware Required
+
+* A development board with ESP32/ESP32-S2/ESP32-C3 SoC (e.g., ESP32-DevKitC, ESP-WROVER-KIT, etc.)
+* A USB cable for Power supply and programming
+
+### Configure the project
+
+Open the project configuration menu (`idf.py menuconfig`). 
+
+In the `Example Configuration` menu:
+
+* Use `WiFi SSID` to set the SSID.
+* Use `WiFi Password` to set the password.
+
+Optional: If you need, change the other options according to your requirements.
+
+### Build and Flash
+
+Build the project and flash it to the board, then run monitor tool to view serial output:
+
+Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
+
+(To exit the serial monitor, type ``Ctrl-]``.)
+
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
+
+## Example Output
+
+As you run the example, you will see the following log:
+
+```
+I (616) wifi:wifi firmware version: 6bff005
+I (616) wifi:wifi certification version: v7.0
+I (616) wifi:config NVS flash: enabled
+I (616) wifi:config nano formating: disabled
+I (626) wifi:Init data frame dynamic rx buffer num: 32
+I (626) wifi:Init management frame dynamic rx buffer num: 32
+I (636) wifi:Init management short buffer num: 32
+I (636) wifi:Init dynamic tx buffer num: 32
+I (646) wifi:Init static rx buffer size: 1600
+I (646) wifi:Init static rx buffer num: 10
+I (646) wifi:Init dynamic rx buffer num: 32
+I (656) wifi_init: rx ba win: 6
+I (656) wifi_init: tcpip mbox: 32
+I (666) wifi_init: udp mbox: 6
+I (666) wifi_init: tcp mbox: 6
+I (666) wifi_init: tcp tx win: 5744
+I (676) wifi_init: tcp rx win: 5744
+I (676) wifi_init: tcp mss: 1440
+I (686) wifi_init: WiFi IRAM OP enabled
+I (686) wifi_init: WiFi RX IRAM OP enabled
+I (696) phy_init: phy_version 4660,0162888,Dec 23 2020
+I (796) wifi:mode : sta (xx:xx:xx:xx:xx:xx)
+I (796) wifi:enable tsf
+I (806) wifi:new:<8,1>, old:<1,0>, ap:<255,255>, sta:<8,1>, prof:1
+I (806) wifi:state: init -> auth (b0)
+I (826) wifi:state: auth -> assoc (0)
+I (836) wifi:state: assoc -> run (10)
+I (876) wifi:connected with SSID, aid = 1, channel 8, 40U, bssid = xx:xx:xx:xx:xx:xx
+I (876) wifi:security: WPA2-PSK, phy: bgn, rssi: -56
+I (886) wifi:pm start, type: 1
+
+I (966) wifi:AP's beacon interval = 102400 us, DTIM period = 1
+W (1106) wifi:<ba-add>idx:0 (ifx:0, xx:xx:xx:xx:xx:xx), tid:0, ssn:0, winSize:64
+I (2086) scan: got ip:192.168.68.110
+I (2086) esp_netif_handlers: sta ip: 192.168.68.110, mask: 255.255.255.0, gw: 192.168.68.1
+
+```
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/wifi/getting_started/softAP/README.md

@@ -1,29 +1,36 @@
-# WiFi softAP example
+# Wi-Fi SoftAP Example
 
 (See the README.md file in the upper level 'examples' directory for more information about examples.)
 
+This example shows how to use the Wi-Fi SoftAP functionality of the Wi-Fi driver of ESP for serving as an Access Point.
 
 ## How to use example
 
 ### Configure the project
 
-```
-idf.py menuconfig
-```
+Open the project configuration menu (`idf.py menuconfig`). 
+
+In the `Example Configuration` menu:
 
-* Set WiFi SSID and WiFi Password and Maximal STA connections under Example Configuration Options.
+* Set the Wi-Fi configuration.
+    * Set `WiFi SSID`.
+    * Set `WiFi Password`.
+
+Optional: If you need, change the other options according to your requirements.
 
 ### Build and Flash
 
-Build the project and flash it to the board, then run monitor tool to view serial output:
+Build the project and flash it to the board, then run the monitor tool to view the serial output:
 
-```
-idf.py -p PORT flash monitor
-```
+Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
 
 (To exit the serial monitor, type ``Ctrl-]``.)
 
-See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
 
 ## Example Output
 
@@ -38,3 +45,7 @@ I (26457) wifi: station: 70:ef:00:43:96:67 join, AID=1, bg, 20
 I (26467) wifi softAP: station:70:ef:00:43:96:67 join, AID=1
 I (27657) tcpip_adapter: softAP assign IP to station,IP is: 192.168.4.2
 ```
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/wifi/getting_started/station/README.md

@@ -1,29 +1,36 @@
-# WiFi station example
+# Wi-Fi Station Example
 
 (See the README.md file in the upper level 'examples' directory for more information about examples.)
 
+This example shows how to use the Wi-Fi Station functionality of the Wi-Fi driver of ESP for connecting to an Access Point.
 
 ## How to use example
 
 ### Configure the project
 
-```
-idf.py menuconfig
-```
+Open the project configuration menu (`idf.py menuconfig`). 
+
+In the `Example Configuration` menu:
 
-* Set WiFi SSID and WiFi Password and Maximum retry under Example Configuration Options.
+* Set the Wi-Fi configuration.
+    * Set `WiFi SSID`.
+    * Set `WiFi Password`.
+
+Optional: If you need, change the other options according to your requirements.
 
 ### Build and Flash
 
-Build the project and flash it to the board, then run monitor tool to view serial output:
+Build the project and flash it to the board, then run the monitor tool to view the serial output:
 
-```
-idf.py -p PORT flash monitor
-```
+Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
 
 (To exit the serial monitor, type ``Ctrl-]``.)
 
-See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
 
 ## Example Output
 Note that the output, in particular the order of the output, may vary depending on the environment.
@@ -105,3 +112,7 @@ I (8249) wifi station: connect to the AP fail
 I (10299) wifi station: connect to the AP fail
 I (10299) wifi station: Failed to connect to SSID:myssid, password:mypassword
 ```
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/wifi/roaming/README.md

@@ -1,11 +1,38 @@
 # Roaming Example
 
+(See the README.md file in the upper level 'examples' directory for more information about examples.)
+
 This example demonstrate a roaming example using 11k and 11v APIs.
 
+## How to use example
+
+Before project configuration and build, be sure to set the correct chip target using `idf.py set-target <chip_name>`.
+
+### Hardware Required
+
+* A development board with ESP32/ESP32-S2/ESP32-C3 SoC (e.g., ESP32-DevKitC, ESP-WROVER-KIT, etc.)
+* A USB cable for Power supply and programming
+
+### Build and Flash
+
+Build the project and flash it to the board, then run the monitor tool to view the serial output:
+
+Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
+
+(To exit the serial monitor, type ``Ctrl-]``.)
+
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
+
+## Example Output
+
 All the logs are taken after debug enabled:
 
 Beacon request:
-
+```
 I (11125) wpa: scan issued at time=7579442263
 I (11125) wpa: BSS: Add new id 1 BSSID b6:fb:e4:4d:6e:22 SSID 'ESPTest' chan 1
 I (11135) wpa: BSS: Add new id 2 BSSID d6:fb:e4:4d:6e:22 SSID 'ESPDedicated' chan 1
@@ -21,9 +48,11 @@ I (12485) wpa: BSS: Add new id 11 BSSID b4:fb:e4:4d:7c:89 SSID 'ESPIndia' chan 1
 I (12825) wpa: scan done received
 I (12845) wpa: action frame sent
 I (12845) wpa: action frame sent
+```
 
 Sta's moving from one AP to another on BTM request:
 
+```
 I (379479) wpa: WNM: RX action 7 from 50:3e:aa:26:35:42
 I (379479) wpa: WNM: BSS Transition Management Request: dialog_token=1 request_mode=0x1 disassoc_timer=0 validity_interval=1
 I (379489) wpa: WNM: Neighbor report tag 52
@@ -56,3 +85,8 @@ I (384729) wifi:pm start, type: 1
 
 I (384789) wifi:AP's beacon interval = 102400 us, DTIM period = 2
 I (385609) esp_netif_handlers: sta ip: 192.168.4.2, mask: 255.255.255.0, gw: 192.168.4.1
+```
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/wifi/scan/README.md

@@ -1,5 +1,88 @@
-# Wifi SCAN Example
+# Wi-Fi Scan Example
+
+(See the README.md file in the upper level 'examples' directory for more information about examples.)
 
 This example shows how to scan for available set of APs.
 
-* The SCAN_LIST_SIZE parameter needs to be set from the example configuration menu. It represents maximum number of scan list entries that driver can populate.
+## How to use example
+
+Before project configuration and build, be sure to set the correct chip target using `idf.py set-target <chip_name>`.
+
+### Hardware Required
+
+* A development board with ESP32/ESP32-S2/ESP32-C3 SoC (e.g., ESP32-DevKitC, ESP-WROVER-KIT, etc.).
+* A USB cable for Power supply and programming.
+
+### Configure the project
+
+Open the project configuration menu (`idf.py menuconfig`). 
+
+In the `Example Configuration` menu:
+
+* Set the Example configuration.
+    * Use `Max size of scan list` to set the maximum nunber of access points in the list.
+
+### Build and Flash
+
+Build the project and flash it to the board, then run the monitor tool to view the serial output:
+
+Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
+
+(To exit the serial monitor, type ``Ctrl-]``.)
+
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
+
+## Example Output
+
+As you run the example, you will see the following log:
+
+```
+I (443) wifi:wifi firmware version: 6bff005
+I (443) wifi:wifi certification version: v7.0
+I (443) wifi:config NVS flash: enabled
+I (443) wifi:config nano formating: disabled
+I (453) wifi:Init data frame dynamic rx buffer num: 32
+I (453) wifi:Init management frame dynamic rx buffer num: 32
+I (463) wifi:Init management short buffer num: 32
+I (463) wifi:Init dynamic tx buffer num: 32
+I (473) wifi:Init static tx FG buffer num: 2
+I (473) wifi:Init static rx buffer size: 1600
+I (473) wifi:Init static rx buffer num: 10
+I (483) wifi:Init dynamic rx buffer num: 32
+I (483) wifi_init: rx ba win: 6
+I (493) wifi_init: tcpip mbox: 32
+I (493) wifi_init: udp mbox: 6
+I (493) wifi_init: tcp mbox: 6
+I (503) wifi_init: tcp tx win: 5744
+I (503) wifi_init: tcp rx win: 5744
+I (513) wifi_init: tcp mss: 1440
+I (513) wifi_init: WiFi IRAM OP enabled
+I (513) wifi_init: WiFi RX IRAM OP enabled
+I (533) phy_init: phy_version 300,6e46ba7,Jan 25 2021
+I (683) wifi:set rx active PTI: 0, rx ack PTI: 0, and default PTI: 0
+I (683) wifi:mode : sta (7c:df:a1:40:23:84)
+I (683) wifi:enable tsf
+I (2783) scan: Total APs scanned = 17
+I (2783) scan: SSID 		IoTNetwork
+I (2783) scan: RSSI 		-50
+I (2783) scan: Authmode 	WIFI_AUTH_WPA2_PSK
+I (2783) scan: Pairwise Cipher 	WIFI_CIPHER_TYPE_CCMP
+I (2793) scan: Group Cipher 	WIFI_CIPHER_TYPE_CCMP
+I (2793) scan: Channel 		5
+
+I (2883) scan: SSID 		TP-Link_6872
+I (2883) scan: RSSI 		-70
+I (2883) scan: Authmode 	WIFI_AUTH_WPA_WPA2_PSK
+I (2893) scan: Pairwise Cipher 	WIFI_CIPHER_TYPE_CCMP
+I (2893) scan: Group Cipher 	WIFI_CIPHER_TYPE_CCMP
+I (2903) scan: Channel 		11
+...
+```
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.

examples/wifi/wps/README.md

@@ -1,11 +1,78 @@
-# Wifi WPS Example
+# Wi-Fi WPS Example
 
-This example shows how to use wps enrollee in esp32.
+(See the README.md file in the upper level 'examples' directory for more information about examples.)
 
-Now we support to use enrollee feature in STA and APSTA mode.
+This example shows how to use WPS enrollee in ESP. The WPS protocol simplifies the process of connecting to a Wi-Fi router.
 
-* PBC_MODE: Start esp32 and press the wps button on router, Then esp32 will get the ssid&password by wps PBC mode.
+## How to use example
 
-* PIN_MODE: Start esp32, It will enter wps mode and you'll see a pin code showing by COM. Enter this pin code in router and the esp32 can get ssid&password by wps PIN mode.
+Before project configuration and build, be sure to set the correct chip target using `idf.py set-target <chip_name>`.
 
-More info in the code [wps.c](./main/wps.c).
+### Hardware Required
+
+* A development board with ESP32/ESP32-S2/ESP32-C3 SoC (e.g., ESP32-DevKitC, ESP-WROVER-KIT, etc.)
+* A USB cable for Power supply and programming
+
+### Configure the project
+
+Open the project configuration menu (`idf.py menuconfig`). 
+
+In the `Example Configuration` menu:
+
+* Use `WPS mode` to select the type.
+* Select `PBC`, `PIN` or `disable`.
+
+In `PBC` mode, the ESP will wait for the WPS initialization (usually by pressing WPS button on the Wi-Fi router) and then will connect to the router.
+
+In `PIN` mode, the ESP will enter the WPS mode and you'll see a pin code on the terminal. Enter this pin code in your router and then the ESP will connect to it.
+
+(See your router manual and configuration for WPS compatibility.)
+
+### Build and Flash
+
+Build the project and flash it to the board, then run the monitor tool to view the serial output:
+
+Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
+
+(To exit the serial monitor, type ``Ctrl-]``.)
+
+See the Getting Started Guide for all the steps to configure and use the ESP-IDF to build projects.
+
+* [ESP-IDF Getting Started Guide on ESP32](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-S2](https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/get-started/index.html)
+* [ESP-IDF Getting Started Guide on ESP32-C3](https://docs.espressif.com/projects/esp-idf/en/latest/esp32c3/get-started/index.html)
+
+
+## Example Output
+
+As you run the example, you will see the following log:
+
+```
+I (814) example_wps: start wps...
+I (814) example_wps: WIFI_EVENT_STA_START
+I (7304) wifi:new:<5,1>, old:<1,0>, ap:<255,255>, sta:<5,1>, prof:1
+I (8084) wifi:state: init -> auth (b0)
+I (8094) wifi:state: auth -> assoc (0)
+I (8104) wifi:state: assoc -> run (10)
+I (8904) wifi:state: run -> init (17a0)
+I (8904) wifi:new:<5,0>, old:<5,1>, ap:<255,255>, sta:<5,1>, prof:1
+I (8914) example_wps: WIFI_EVENT_STA_DISCONNECTED
+E (8914) wifi:sta is connecting, return error
+I (9904) example_wps: WIFI_EVENT_STA_WPS_ER_SUCCESS
+I (9914) wifi:new:<5,1>, old:<5,0>, ap:<255,255>, sta:<5,1>, prof:1
+I (10654) wifi:state: init -> auth (b0)
+I (10664) wifi:state: auth -> assoc (0)
+I (10664) wifi:state: assoc -> run (10)
+I (10704) wifi:connected with ROUTER_SSID, aid = 3, channel 5, 40U, bssid = xx:xx:xx:xx:xx:xx
+I (10704) wifi:security: WPA2-PSK, phy: bgn, rssi: -58
+I (10714) wifi:pm start, type: 1
+
+I (10734) wifi:AP's beacon interval = 102400 us, DTIM period = 1
+W (11104) wifi:<ba-add>idx:0 (ifx:0, xx:xx:xx:xx:xx:xx), tid:0, ssn:0, winSize:64
+I (12094) esp_netif_handlers: sta ip: 192.168.68.113, mask: 255.255.255.0, gw: 192.168.68.1
+I (12094) example_wps: got ip: 192.168.68.113
+```
+
+## Troubleshooting
+
+For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.