e3bc260178
Add help text to the esp32h2/esp32h21/esp32h4 Kconfig.mac explaining that these chips only consume one universally administered MAC address: the IEEE 802.154 EUI-64 is derived from the base MAC and MAC_EXT, and Bluetooth reuses the base MAC as-is (no BT offset, since there is no Wi-Fi). Add a matching 1-MAC derivation table and note to misc_system_api.rst (EN and zh_CN) under a new `.. only:: esp32h2 or esp32h21 or esp32h4` block, and exclude these targets from the generic 4/2 table. Add an esp32s31-only note stating that the "Four" option may only be used with a customer-provided custom base MAC range, since ESP32-S31 only provides two universally administered MAC addresses in eFuse. Co-authored-by: Cursor <cursoragent@cursor.com>
Documentation Source Folder
This folder contains source files of ESP-IDF documentation available in English and Chinese.
The sources do not render well in GitHub and some information is not visible without building the documentation.
Use the actual documentation, which is generated within about 20 minutes of each commit:
Hosted Documentation
- English: https://docs.espressif.com/projects/esp-idf/en/latest/
- Chinese: https://docs.espressif.com/projects/esp-idf/zh_CN/latest/
After clicking any link to ESP-IDF Programming Guide, go to the top of the sidebar, then make sure you have the correct Espressif chip (target) and ESP-IDF version selected in the dropdown menus. You can also find a link at the bottom right to download the HTML version as a zip for offline reading.
Building Documentation
The documentation is built using the Python package esp-docs, which can be installed by running:
pip install esp-docs
For a summary of available options, run:
build-docs --help
For more information, see the esp-docs documentation at https://github.com/espressif/esp-docs/blob/master/README.md