espressif/arduino-esp32
GitHub: espressif/arduino-esp32
为 ESP32 系列 SoC 提供完整的 Arduino 核心,简化嵌入式开发与跨平台部署。
Stars: 16616 | Forks: 7855
# Arduino 核心(ESP32 系列 SoC)
[](https://github.com/espressif/arduino-esp32/actions/workflows/push.yml?query=branch%3Amaster+event%3Apush)
[)](https://github.com/espressif/arduino-esp32/actions/workflows/push.yml?query=branch%3Amaster+event%3Aschedule)
[](https://github.com/espressif/arduino-esp32/blob/gh-pages/LIBRARIES_TEST.md)
[](https://github.com/espressif/arduino-esp32/blob/gh-pages/runtime-test-results/RUNTIME_TEST_RESULTS.md)
### 需要帮助或有疑问?加入聊天 [Discord](https://discord.gg/8xY6e9crwv) 或 [开启新讨论](https://github.com/espressif/arduino-esp32/discussions)
[](https://discord.gg/8xY6e9crwv)
## 目录
- [开发状态](#development-status)
- [开发规划](#development-planning)
- [文档](#documentation)
- [支持的芯片](#supported-chips)
- [解码异常](#decoding-exceptions)
- [问题/错误报告模板](#issuebug-report-template)
- [贡献指南](#contributing)
### 开发状态
#### 最新稳定版本
[](https://github.com/espressif/arduino-esp32/releases/latest/)
[](https://github.com/espressif/arduino-esp32/releases/latest/)
[](https://github.com/espressif/arduino-esp32/releases/latest/)
#### 最新开发版本
[](https://github.com/espressif/arduino-esp32/releases/)
[](https://github.com/espressif/arduino-esp32/releases/)
[](https://github.com/espressif/arduino-esp32/releases/)
### 开发规划
我们的开发完全通过这个公开 **[路线图 🎉](https://github.com/orgs/espressif/projects/3)** 进行跟踪。
更多详细信息可加入我们的 **[每月社区会议 🔔](https://github.com/espressif/arduino-esp32/discussions/categories/monthly-community-meetings)。**
### 文档
你可以使用 [Arduino-ESP32 在线文档](https://docs.espressif.com/projects/arduino-esp32/en/latest/) 获取该项目的全部信息。
**从 2.x 版本迁移到 3.x 的指南** 可在 [此处](https://docs.espressif.com/projects/arduino-esp32/en/latest/migration_guides/2.x_to_3.0.html) 找到。
**与 ESP8266 和 Arduino-CORE(Arduino.cc)的 API 兼容性** 解释说明 [在此](https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html#apis)。
* [入门指南](https://docs.espressif.com/projects/arduino-esp32/en/latest/getting_started.html)
* [安装(Windows、Linux 和 macOS)](https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html)
* [库](https://docs.espressif.com/projects/arduino-esp32/en/latest/libraries.html)
* [Arduino 作为 ESP-IDF 组件](https://docs.espressif.com/projects/arduino-esp32/en/latest/esp-idf_component.html)
* [常见问题解答](https://docs.espressif.com/projects/arduino-esp32/en/latest/faq.html)
* [故障排除](https://docs.espressif.com/projects/arduino-esp32/en/latest/troubleshooting.html)
### 支持的芯片
以下是 Arduino-ESP32 项目支持的 ESP32 系列芯片:
| **SoC** | **稳定版** | **开发版** | **数据手册** |
|----------|:----------:|:----------:|:-------------------------------------------------------------------------------------------------:|
| ESP32 | 是 | 是 | [ESP32](https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf) |
| ESP32-C3 | 是 | 是 | [ESP32-C3](https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf) |
| ESP32-C5 | 是 | 是 | [ESP32-C5](https://www.espressif.com/sites/default/files/documentation/esp32-c5_datasheet_en.pdf) |
| ESP32-C6 | 是 | 是 | [ESP32-C6](https://www.espressif.com/sites/default/files/documentation/esp32-c6_datasheet_en.pdf) |
| ESP32-H2 | 是 | 是 | [ESP32-H2](https://www.espressif.com/sites/default/files/documentation/esp32-h2_datasheet_en.pdf) |
| ESP32-P4 | 是 | 是 | [ESP32-P4](https://www.espressif.com/sites/default/files/documentation/esp32-p4_datasheet_en.pdf) |
| ESP32-S2 | 是 | 是 | [ESP32-S2](https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf) |
| ESP32-S3 | 是 | 是 | [ESP32-S3](https://www.espressif.com/sites/default/files/documentation/esp32-s3_datasheet_en.pdf) |
如需更多详细信息,请访问 [支持的芯片](https://docs.espressif.com/projects/arduino-esp32/en/latest/getting_started.html#supported-soc-s) 文档页面。
### 解码异常
你可以使用 [EspExceptionDecoder](https://github.com/me-no-dev/EspExceptionDecoder) 获取有意义的调用堆栈跟踪。
### 问题/错误报告模板
在报告问题之前,请确保已搜索类似问题是否已被创建。同时请确保查阅所有标记为 [类型:参考](https://github.com/espressif/arduino-esp32/issues?q=is%3Aissue+label%3A%22Type%3A+For+reference%22+) 的问题。
最后,如果你确认没有其他用户遇到该问题,请按照 **问题模板** 或 **功能请求模板** 提交任何 [新问题](https://github.com/espressif/arduino-esp32/issues/new/choose)。
### 外部库编译测试
我们已为 ESP32 Arduino 核心设置外部库的 CI 测试。你可以查看 [LIBRARIES_TEST](https://github.com/espressif/arduino-esp32/blob/gh-pages/LIBRARIES_TEST.md) 文件中的测试结果。
如需了解更多信息以及如何将你的库添加到测试中,请参阅文档中的 [外部库测试](https://docs.espressif.com/projects/arduino-esp32/en/latest/external_libraries_test.html)。
### 贡献
我们欢迎对 Arduino ESP32 项目做出贡献!
请查阅文档中的 [贡献指南](https://docs.espressif.com/projects/arduino-esp32/en/latest/contributing.html) 了解如何参与该项目。
标签:AIoT, Arduino, C/C++, Discord, ESP32, Espressif, GitHub Actions, SoC, UML, 事务性I/O, 外部库, 嵌入式开发, 开发板, 开源框架, 开源硬件, 技术社区, 持续集成, 无线连接, 物联网, 电子工程, 硬件驱动, 编译测试, 自动笔记, 讨论区, 运行时测试