Resources
=========

:link_to_translation:`zh_CN:[中文]`

Code Repositories and Components
--------------------------------

- `ESP-GMF GitHub Repository <https://github.com/espressif/esp-gmf>`_: The main ESP-GMF repository, containing GMF-Core, elements, packages, and example projects
- `ESP Board Manager GitHub Repository <https://github.com/espressif/esp-board-manager>`_: Espressif board management component for board-level peripheral description and initialization using ``esp_board_manager``
- `ESP-IDF GitHub Repository <https://github.com/espressif/esp-idf>`_: ESP-GMF is built on ESP-IDF; set up the ESP-IDF development environment first
- `ESP-ADF GitHub Repository <https://github.com/espressif/esp-adf>`_: Espressif Audio Development Framework; a feature-oriented repository for multimedia applications that will continue to expand with more ESP-GMF-based examples
- `Espressif Component Registry <https://components.espressif.com>`_: Search for GMF components and dependencies by name or keyword

Documentation and Examples
--------------------------

- Component READMEs: Each component directory in the repository contains a standalone ``README.md`` / ``README_CN.md`` describing the component purpose, features, and minimal usage
- Test cases: Each component's ``test_apps/`` and ``examples/`` directories provide compilable and flashable minimal examples
- Documentation center: This guide is the ESP-GMF documentation center, covering architecture, component categories, API reference, and best practices
- `ESP-IDF Programming Guide <https://docs.espressif.com/projects/esp-idf/en/latest/>`_: Understand the underlying framework ESP-GMF depends on, including the component manager and task model

Community and Support
---------------------

- `ESP-GMF GitHub Issues <https://github.com/espressif/esp-gmf/issues>`_: Report bugs or request new features; search for existing issues before submitting
- `esp32.com Forum <https://esp32.com>`_: Espressif's official community forum for general ESP32 series development questions
- To contribute code or documentation, see :doc:`contributions-guide`

Hardware Reference
------------------

Espressif chips and development boards supported by ESP-GMF can be found through the following channels:

- `Espressif Development Boards and Modules <https://www.espressif.com/en/products/devkits>`_: Official development boards with board-level adaptation for some GMF components
- `Espressif Chip Product Page <https://www.espressif.com/en/products/socs>`_: ESP32 series chip specifications and documentation
- `Espressif Official Board Components <https://github.com/espressif/esp-board-manager/tree/main/esp_boards>`_: ESP Board Manager configuration files for official Espressif development boards
- `M5Stack Board Components <https://github.com/espressif/esp-board-manager/tree/main/m5stack_boards>`_: ESP Board Manager configuration files for M5Stack series development boards
- `Get Samples <https://www.espressif.com/en/contact-us/get-sample>`_: Request samples and find distribution channels
