Espressif ESP32-S2 User Manual

Esp test tools
Hide thumbs Also See for ESP32-S2:

Advertisement

Quick Links

ESP32-S2
User Guide of ESP Test Tools

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the ESP32-S2 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Espressif ESP32-S2

  • Page 1 ESP32-S2 User Guide of ESP Test Tools...
  • Page 2: Table Of Contents

    ........39 Espressif Production Testing Guide .
  • Page 3: Development Stage

    1 Development Stage This repository provides comprehensive resources to support the development and production of products based on Espressif chips and modules. For the development stage, it provides an RF testing tool and detailed test guidelines to ensure your product meets the necessary performance and certification standards.
  • Page 4: Rf Certifications

    RF certifications; it is primarily used to evaluate the OTA performance of devices. 2 EspRFTestTool Toolkit The EspRFTestTool toolkit is an RF test tool provided by Espressif. It contains EspRFTestTool, DownloadTool, and PowerLimitTool. • EspRFTestTool: Used to perform RF tests;...
  • Page 5 2 EspRFTestTool Toolkit Fig. 1: EspRFTestTool Espressif Systems Release master Submit Document Feedback...
  • Page 6 • COM: Select the serial port number; • BaudRate: Select the baud rate; • Open: Open the serial port; • Close: Close the serial port. After configuring the serial port, you can perform quick flashing and RF tests. Espressif Systems Release master Submit Document Feedback...
  • Page 7 • Click Select Bin to select the bin file to be flashed; • Click Load Bin to start flashing; • After flashing is completed, pull up the Boot pin and re-power the chip to enter operation mode. Espressif Systems Release master Submit Document Feedback...
  • Page 8: Downloadtool

    The Log window is used to display the status of the tool. To view the log printed via the chip serial port, please use a general serial port assistant, such as SerialPortUtility. 2.2 DownloadTool Click Tool in the toolbar and select DownloadTool to enter the DownloadTool interface. Espressif Systems Release master Submit Document Feedback...
  • Page 9 • Check whether the chip has entered download mode. If yes, click Start Load to start flashing. After flashing is completed, the SUCC sign shows up; • After flashing is completed, click Close to close the serial port. Espressif Systems Release master Submit Document Feedback...
  • Page 10: Powerlimittool

    Note: The following methods can be used to limit Wi-Fi power. If multiple methods are used together, the minimum power value will be taken: 1. Use the API (esp_wifi_set_max_tx_power) to limit the maximum output power. Espressif Systems Release master Submit Document Feedback...
  • Page 11 Fig. 7: Entry to PowerLimitTool 1. In the main interface of PowerLimitTool, click the Chip dropdown box to view the chips supported by the tool and select a chip (This section takes ESP32-C3 as an example). Espressif Systems Release master Submit Document Feedback...
  • Page 12 2 EspRFTestTool Toolkit Fig. 8: PowerLimitTool Main Interface 2. Click Select Table and select the TX Power Setting table for your chip. Espressif Systems Release master Submit Document Feedback...
  • Page 13 Fig. 9: Importing TX Power Setting Table 3. Click Open Table, modify the power value in the corresponding country code table, and select the desired country code in the Certification Code dropdown box. Espressif Systems Release master Submit Document Feedback...
  • Page 14 10. KCC_5: Power configuration of the “KCC”country code, applicable to South Korea. 11. MIC_6: Power configuration of the “MIC”country code, applicable to Japan. 12. IC_7: Power configuration of the “IC”country code, applicable to Canada. Note: How to modify power values: Espressif Systems Release master Submit Document Feedback...
  • Page 15 1. The dropdown list of Certification Code includes options for a single certification, Multiple Country, and Custom. 2. Selecting a single certification will generate a single phy_init_bin file for that certification, which contains a total of 128 bytes except the verification control information. Espressif Systems Release master Submit Document Feedback...
  • Page 16 • Flash the phy_init_bin file and corresponding RF test firmware to flash by referring to the instructions stated DownloadTool. • The flash address for phy_init_bin is 0x1fc000 and the flash address for the RF test firmware ESP32-S2 RF Non-Signaling Test Firmware is 0x1000.
  • Page 17 • The default address for flashing phy_init_bin is 0x1fc000. If the flashing address changes, update it here. • For Multiple Country, you can select the certification country codes it includes in the Certification Code. Fig. 13: RF Test Configuration Typical Average Output power of ESP32-S2 Rates Typical Average Output power (dBm) 11b 1 Mbps 19.5...
  • Page 18: Rf Test Items

    • USB-to-UART board is used to communicate between the PC and the DUT. • Device under test (DUT) refers to a product designed based on the ESP32-S2 chip or module. It is connected to the USB-to-UART board via UART and to the tester via an RF connection cable. The DUT is usually placed inside a shield box.
  • Page 19 • Some serial communication boards have already swapped RXD and TXD internally, so there is no need to reverse the connection. Adjust the wiring according to the actual situation. • ESP32-S2 has a power-on self-calibration feature. The RF connection cable must be connected to the tester before the DUT is powered on for testing.
  • Page 20 • Duty Cycle: Set the packet duty cycle in TX packet tests. The default duty cycle is around 30%. Supported values: 10%, 50%, 90%. • Certification EN: Not enabled by default. Used only when verifying Power Limit function. • Certification Code: Not enabled by default. Used only when verifying Power Limit function. Espressif Systems Release master Submit Document Feedback...
  • Page 21 RX information similar to the following: Correct:1000 Desired:1000 RSSI:-614 noise:-960 gain:0 paral:0 para2:0 freq:0 Where: • Correct: The total number of packets received this time. • Desired: The number of packets received at the corresponding rate this time. Espressif Systems Release master Submit Document Feedback...
  • Page 22 • Other parameters in the packet RX information are only used for RD debug and have no actual meaning. Fig. 18: Wi-Fi RX Performance Test Appendix This appendix is mainly used to explain the target output power of the chip’ s Wi-Fi, which is used for RF debugging or test reference. Espressif Systems Release master Submit Document Feedback...
  • Page 23: Wi-Fi Signaling Test

    Total Radiated Power (TRP) and Total Isotropic Sensitivity (TIS). Set Up Test Environment Fig. 19: UART Connection Description The Device Under Test (DUT) is a product designed based on Espressif chips or modules. The device under test is connected to the USB-to-UART adapter board via UART. Note: •...
  • Page 24 115200. After the device is powered on again, if the serial port outputs information similar to the following, you can confirm that the test status is OK: Espressif Systems Release master Submit Document Feedback...
  • Page 25 Note: The -p parameter is used to set the AP password. If the AP has no password, this parameter is not needed. After the station device is assigned an IP address, the Wi-Fi connection is successful, and the following log is printed: Espressif Systems Release master...
  • Page 26: Wi-Fi Adaptivity Test

    Note: If the power spectral density (PSD) of the Wi-Fi signal is higher than 10 dBm/MHz, the adaptivity test should choose the Listen Before Talk (LBT) mechanism based on non-hopping load. Espressif Systems Release master Submit Document Feedback...
  • Page 27 3 RF Test Items Set Up Test Environment Fig. 23: UART Connection Description The Device Under Test (DUT) is a product designed based on Espressif chips or modules. The DUT is connected to the USB-to-UART adapter board via UART. Note: •...
  • Page 28 Assistant, configure the port number, set the baud rate to 115200, if the serial port prints similar information after the device is powered on again, you can confirm that the test status is OK: Espressif Systems Release master Submit Document Feedback...
  • Page 29 Note: The -p parameter is used to set the AP password. If the AP has no password, this parameter is not needed. If the following similar information is printed in the serial port, it indicates that the traffic has been started and the Wi-Fi Adaptivity Test can be initiated. Espressif Systems Release master Submit Document Feedback...
  • Page 30 WiFi Adaptivity test interface. • In STA mode, enter AP ssid and AP pwd, and click Connect AP to connect. • After successful connection, the following log should be printed: Espressif Systems Release master Submit Document Feedback...
  • Page 31 • After the above settings are completed, click Send Data. If the log is similar to the figure below, it indicates that the traffic has been started, and the Wi-Fi Adaptivity Test can be initiated. Espressif Systems Release master Submit Document Feedback...
  • Page 32: Wi-Fi Blocking Test

    The Wi-Fi Blocking Test evaluates the device’ s reception performance in environments with strong interference. By introducing high-intensity interference signals, it measures the reception sensitivity and anti-interference capability of a device, ensuring reliable operation in complex wireless environments. Set Up Test Environment Fig. 29: UART Connection Description Espressif Systems Release master Submit Document Feedback...
  • Page 33 3 RF Test Items The Device Under Test (DUT) is a product designed based on Espressif chips or modules. The DUT is connected to the USB-to-UART adapter board via UART. Note: • The CHIP_EN pin of the DUT is pulled up by default. If it is not pulled up in the product design, you need to manually connect the CHIP_EN to the 3V3 pin.
  • Page 34 • The -p parameter is used to set the AP password. If the AP has no password, this parameter is not needed. If the following information is printed on the serial port, the connection is successful and the Wi-Fi Blocking Test can be performed. Espressif Systems Release master Submit Document Feedback...
  • Page 35 WiFi Adaptivity test interface. • In STA mode, enter AP ssid and AP pwd, and click Connect AP to connect. • After successful connection, the following log should be printed: Espressif Systems Release master Submit Document Feedback...
  • Page 36: Rf Test Certification

    CE Certification (Conformité Européene Mark) is a mandatory certification by the EU, confirming compliance with safety, health, and environmental protection standards. The CE certification of RF products requires non-signaling, adaptivity, and blocking tests: • Wi-Fi Non-Signaling Test • Wi-Fi Adaptivity Test • Wi-Fi Blocking Test Espressif Systems Release master Submit Document Feedback...
  • Page 37: Fcc Certification

    It supports multiple targets and configurations, enabling users to efficiently update firmware and debug devices. • Espressif Production Testing Guide outlines the production testing schemes available for Espressif Wi-Fi prod- ucts, thus providing reference for testing customer products during manufacturing. • Test Fixture Manufacturing Instruction provides guidelines for manufacturing test fixtures used with Espressif’...
  • Page 38: Tool Overview

    0xff. The combined firmware will be saved as ./com- bine/target.bin. Each click of this button will overwrite the previous firmware. – Default button: restores the SPI configuration to the default values. Espressif Systems Release master Submit Document Feedback...
  • Page 39 • Factory mode uses the relative path. By default, the tool loads the firmware from the bin folder of the tool directory. Whereas, Develop mode uses the absolute path. The advantage of the Factory mode is that as Espressif Systems Release master...
  • Page 40 • Device: Selects the device’s serial port number and communication baud rate. • Read Flash: Specifies the start address and size of the content to be read from the flash. This setting is only required when reading flash. Espressif Systems Release master Submit Document Feedback...
  • Page 41: Download Example

    6.3 Download Example This section takes the ESP32 series as an example to demonstrate how to perform both regular and encrypted down- load operations. At present, ESP32-S2 only supports regular download, and will support encrypted download later. Regular Download 1. Pull GPIO0 low to enter the download mode.
  • Page 42 4. Click START to start downloading. During the download process, the tool will read the flash information and the chip’s MAC address. 5. After the download is complete, the tool interface is shown in the following figure. Espressif Systems Release master Submit Document Feedback...
  • Page 43 The encrypted firmware downloading process is as follows: • Flash Download Tool downloads the plaintext firmware to the chip. • The chip uses the key in its eFuse to encrypt the firmware and write it to the flash. Espressif Systems Release master Submit Document Feedback...
  • Page 44 There will be a prompt message (shown below) when the tool is running. Check if the message is correct. The figure below shows the prompt message of enabling both flash encryption and secure boot: Espressif Systems Release master Submit Document Feedback...
  • Page 45: Espressif Production Testing Guide

    7 Espressif Production Testing Guide This guide mainly describes the production testing schemes available for Espressif Wi-Fi products (Wi-Fi mod- ule/Chip Onboard), thus providing reference for the production testing of customer products.
  • Page 46 7 Espressif Production Testing Guide RF General-purpose Tester Scheme The tester scheme is widely used for the production testing of Wi-Fi products. Espressif provides the necessary serial port commands and firmware, so the customers can easily use this scheme for testing.
  • Page 47 7 Espressif Production Testing Guide Fig. 42: Diagram of Signal Board Scheme Fig. 43: Hardware Connection for Signal Board Scheme Note: The test above must be performed in a shielded enclosure. Production Testing Process 1. Please find the followings that need to be tested, and connect the DUT accordingly to conduct the test:...
  • Page 48 The serial port board is mainly used as a USB converter. You may use other similar boards. However, considering some of them might have unstable performance, it is recommended to purchase what is shown below. If you want to purchase from Espressif, please contact...
  • Page 49 7 Espressif Production Testing Guide Fig. 44: Serial Port Board Please check the board you purchased against the following requirements to make sure the switches and shorting jumpers are in the correct positions: • Marking COM1 and Marking COM2: the serial ports used for the communication with the PC. Marking 1 and Making 2 are the two independent serial ports, corresponding to TX/RX/FRTS/FCTS.
  • Page 50 7 Espressif Production Testing Guide Fig. 45: A Typical Module Fixture The primary structure of a typical module fixture can be seen in the table below (take Espressif test fixture as an example). Table 4: The Primary Structure of a Typical Test Fixture...
  • Page 51 7 Espressif Production Testing Guide Fig. 46: A Typical ESP-BAT32 Signal Board For the purchase of Espressif signal board, please contact Note: • Only one signal board should be used within the same network coverage. Otherwise, signal interference will occur.
  • Page 52: Environment Setup

    Therefore, this guide will mainly focus on this scheme, and demonstrate it with the use of Espressif modules. Customers may follow this guide to set up the testing environment for their own Wi-Fi products.
  • Page 53 7 Espressif Production Testing Guide Table 7: Production Testing Package Production Test- Component Quan- Remark ing Package tity ESP32 / ESP32-S ESP-BAT32 ESP32 signal board ESP-FactoryTB2 UART base board ESP32-WROOM-32D Espressif modules ESP32-WROOM-32D ESP32-S2-WROOM Espressif modules ESP32-S2-WROOM Test Step Please connect your DUT to the production testing base board as shown in the following figures, depending on the product series (ESP32-C/ESP32/ESP32-S/ESP8266) your DUT belongs to;...
  • Page 54 7 Espressif Production Testing Guide Fig. 48: Wiring for ESP32-WROOM-32E 1. The DUT communicates with the signal board at a rate of around 1 to 2 M. Configure the DUT to download mode and power up the serial port board.
  • Page 55: Production Testing Tool

    7 Espressif Production Testing Guide 2. Open the production testing software tool and complete the corresponding configuration based on which prod- uct series your DUT belongs to. For details, please refer to Section Tool Configuration below. 3. Click START button to start the test. During the testing, Parameter fb_rssi in the Log must be kept at around -50.
  • Page 56 7 Espressif Production Testing Guide Fig. 49: Main Interface Interface The MainWindows of the tool, as shown in the figure above, can be divided into six main parts: 1. Menu Bar: • Config button can be used to switch between Local Mode and Cloud Mode (Cloud Mode is currently not supported);...
  • Page 57 7 Espressif Production Testing Guide Tool Configuration Fig. 50: DUT Config Interface As shown in the figure above, the DUT Config tab can be divided into three major blocks: • 1. EST CONFIG: Test-related configuration • 2. DUT: DUT-related configuration •...
  • Page 58 7 Espressif Production Testing Guide DUT CONFIG Table 9: DUT CONFIG Parameter Description Notes Port Serial port number Serial port configuration of the DUT, including the serial port for normal test and the serial port for firmware test. The con- figuration of these two serial ports can be the same or not, de- pending on the customers’actual requirements.
  • Page 59 7 Espressif Production Testing Guide • Test Steps: After the RF test is completed, a series of serial port commands are sent to perform the GPIO conductivity test. The serial port commands have been integrated in the host computer, so the customers can easily perform the GPIO Conductivity Test by enabling this function.
  • Page 60 7 Espressif Production Testing Guide Fig. 54: Flash-related Test Tool Operation Two different test modes are supported in the signal board scheme: the Single-DUT mode and the Four-DUT mode. The configuration below is applicable to both of these two test modes. The operation process is as follows: 1.
  • Page 61 7 Espressif Production Testing Guide Fig. 56: Running 3. The tool displays test results. Espressif Systems Release master Submit Document Feedback...
  • Page 62: Appendix B: Gpio Conductivity Test Configuration

    7 Espressif Production Testing Guide Fig. 57: Finish The tool displays FAIL if any test item fails. The status block lists the detailed results of each test, to help you identify the reasons. 4. Check the detailed test records. Fig. 58: Check Test Record The test results of each production test will be saved in a separated log.
  • Page 63: Appendix C: Firmware Version Verification Test

    8 Test Fixture Manufacturing Instruction 8.1 About This Instruction This document provides instructions on the manufacturing of the test fixtures for Espressif’s Wi-Fi modules, in an effort to avoid problems caused by the lack of standardized fixtures during the module production and testing.
  • Page 64: Overview

    The mounting panel should not be made of metal, and the use of metal components should be minimized around the antenna: Espressif Systems Release master Submit Document Feedback...
  • Page 65 Fig. 61: The Mounting Panel for the ESP-WROVER Test Fixture Handle • When users press the handle, they must ensure that the metal probes under the mounting panel are attached to all the pins of the module. Espressif Systems Release master Submit Document Feedback...
  • Page 66 • When users lift the handle, they must ensure that the metal probes under the mounting panel are completely detached from all the pins of the module, which can be seen in the figure below: Espressif Systems Release master Submit Document Feedback...
  • Page 67 When users press the handle, they should leave a suitable distance between the movable plate and the mounting panel. The aim is to ensure that the probes are in touch with all the pins of the module, yet without crushing the module and its shield cover. Please see the figure below: Espressif Systems Release master Submit Document Feedback...
  • Page 68 Fig. 64: The Movable Plate and the Mounting Panel Bottom Box Serial Port Board Two serial port boards (ESP_Factory Test Boards V1.3) are placed inside the bottom box, which can be seen in the figure below: Espressif Systems Release master Submit Document Feedback...
  • Page 69 To facilitate the identification of the fixtures, it is required that the logo be printed on the surface of the bottom box. The classification of such marks is shown in the table below, where V indicates the version of the fixture. Espressif Systems Release master Submit Document Feedback...
  • Page 70 2. This guide is not applicable to ESP-WROOM-02U-V3, ESP32-WROOM-32U-V3 and ESP32-WROVER-I- The Wiring of the Mounting Panel Please see the rules in the table below, and connect the red and green wires as requested, while leaving the rest of the wires unconnected. Espressif Systems Release master Submit Document Feedback...
  • Page 71 – No need to connect the – green wires to the serial port board. Switch One to one One-channel side switch – One to four four-channel side – switch that controls four circuits. Espressif Systems Release master Submit Document Feedback...
  • Page 72 Note: By default, the Automatic Mode Switching on the Tool Side is not enabled. When the Automatic Mode Switching on the Tool Side is not supported 1. ESP-WROOM-02 Fig. 67: The Wiring of the ESP-WROOM-02 Fixture 2. ESP-WROOM-32 Espressif Systems Release master Submit Document Feedback...
  • Page 73 8 Test Fixture Manufacturing Instruction Fig. 68: The Wiring of the ESP32-WROOM-32 Fixture 3. ESP-WROVER Fig. 69: The Wiring of the ESP-WROVER Fixture When the Automatic Mode Switching on the Tool Side is supported Espressif Systems Release master Submit Document Feedback...
  • Page 74 8 Test Fixture Manufacturing Instruction 1. ESP-WROOM-02 Fig. 70: The Wiring of the ESP-WROOM-02 Fixture 2. ESP32-WROOM-32 Fig. 71: The Wiring of the ESP-WROOM-32 Fixture 3. ESP-WROVER Espressif Systems Release master Submit Document Feedback...
  • Page 75: Fixture Testing

    3. Use the switch located in positions 3 and 4 and toggle it towards position 3, so that you configure the module to the operation mode. 4. Press the handle. 5. Enter the command AT+GMR, and click Send. Espressif Systems Release master Submit Document Feedback...
  • Page 76 8 Test Fixture Manufacturing Instruction Fig. 73: AT Command Test Note: Before clicking the Send button, users should press the Enter button after typing in the AT+GMR command. 6. Check the serial debugging tool window. Espressif Systems Release master Submit Document Feedback...
  • Page 77 3. Use the switch located in positions 3 and 4 and toggle it towards position 4, so that you configure the module to the operation mode. 4. Press the handle. 5. Check the serial debugging tool window. Espressif Systems Release master Submit Document Feedback...
  • Page 78 8 Test Fixture Manufacturing Instruction Fig. 75: Expected Result - ESP8266 Series Fig. 76: Expected Result - ESP32 Series Espressif Systems Release master Submit Document Feedback...
  • Page 79: Appendix

    2. The serial board is ESP_Factory_Test_board V1.3. Test Report Test reports or screenshots reflecting the results of these tests. Certification Download certificates for Espressif products from Certificates. 9 FAQ Espressif Systems Release master Submit Document Feedback...
  • Page 80: Rf Testing

    • Flash Download Tool FAQs cover common questions about the Flash Download Tool User Guide. • Espressif Production Testing Guide FAQs provide answers to common questions about the Espressif Production Testing Guide. 9.1 RF Testing 1. What should I do if the EspRFTestTool Toolkit fails to flash? The chip might not have entered download mode correctly.
  • Page 81: Flash Download Tool

    • Hardware: The module is not in download mode. • Software: The module selected in the tool isn’t the one you are using. 4. I clicked the START button and got the error shown below. Espressif Systems Release master Submit Document Feedback...
  • Page 82: Espressif Production Testing Guide

    • The eFuse is fine, but the wrong module is selected in the tool. In this case, select the correct module based on your setup. • There is a problem with the module’s eFuse. In this case, contact Espressif for esptool.exe and instructions, and send the eFuse data to Espressif for further debugging.
  • Page 83: Disclaimer And Copyright Notice

    The Wi-Fi Alliance Member logo is a trademark of the Wi-Fi Alliance. The Bluetooth logo is a registered trademark of Bluetooth SIG. All trade names, trademarks and registered trademarks mentioned in this document are property of their respective owners, and are hereby acknowledged. Espressif Systems Release master Submit Document Feedback...

Table of Contents