ESP Hardware Design Guidelines (中文)

Welcome to the ESP Hardware Design Guidelines repository. This repository hosts the hardware design guidelines for Espressif's system-on-chip (SoC) products. Whether you're working on schematic design, PCB layout, or RF performance optimization, these guidelines are here to help improve your product's performance, reliability, and development efficiency. Below are the guidelines for each chip series:

• ESP32 Hardware Design Guidelines
• ESP32-S2 Hardware Design Guidelines
• ESP32-S3 Hardware Design Guidelines
• ESP32-C3 Hardware Design Guidelines
• ESP32-C6 Hardware Design Guidelines
• ESP32-H2 Hardware Design Guidelines
• ESP32-C2 (ESP8684) Hardware Design Guidelines
• ESP32-C5 Hardware Design Guidelines
• ESP32-P4 Hardware Design Guidelines

Features

The key features of this repository are:

• Multi-format output

  • The Hardware Design Guidelines are available in both PDF and HTML formats.

  • To get the PDF version, click the "Download PDF" button in the top-right corner of the HTML page.

    

• Select by Chip Series

  • Use the chip selection drop-down menu in the top-left corner of the page to select a chip series and view the corresponding Hardware Design Guidelines.

    

• Chatbot Assistance (New!)

  • Need quick answers? Our AI-powered chatbot is here to help!

  • You can ask questions in any language.

  • The bot responds based exclusively on Espressif’s official documentation.

  • If the requested information is not covered, the chatbot will clearly state that—avoiding inaccurate or speculative answers.

  • Each response includes references, so you can easily verify the information.

    

Open Source Licensing

This repository is distributed under multiple open source licenses, depending on the type of content:

• Code: All code files (unless otherwise specified) are licensed under the Apache License 2.0. This allows commercial use, modification, and redistribution, provided that the original copyright notice and a description of any changes are retained.
• Documentation: All documentation content in this repository (including text, diagrams, and images) is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0).

Under the CC BY-SA 4.0 license, you are free to reuse, adapt, and share the documentation, as long as you meet the following conditions:

• Attribute the original source (e.g., link to this repository or specific documentation pages)
• Provide a link to the license
• Indicate whether any changes were made
• Distribute derivative works under the same license

Feedback and Contributing

Espressif Documentation and Hardware teams encourage contributions from the community to enhance and refine the Hardware Design Guidelines.

If you have insights, updates, or suggestions to share, feel free to

• Leave a comment using the "Provide Feedback" button at the bottom of any HTML documentation page
• Report an issue via GitHub Issues
• Submit a fix via Pull Request (PR)

  For PRs, follow the Contributing Guide.

Translations

This documentation is currently available in:

• English
• Chinese（中文）

Interested in contributing a translation in another language? You're welcome to submit a Pull Request (PR).

Let us know if you find this project useful—we appreciate your feedback and contributions!