d385023b85
gen_crt_bundle.py only parses files ending in .pem or .der, but silently ignored anything else. A PEM certificate named e.g. ca.crt was skipped without a word, and since the build invokes the script with -q, even the "Successfully added 0 certificates" hint was suppressed. The build then succeeded and embedded a bundle without the certificate, and the problem only surfaced at runtime as a TLS verification failure. A file passed directly via --input, which is what CONFIG_MBEDTLS_CUSTOM_CERTIFICATE_BUNDLE_PATH points at, is now expected to be a certificate: an unsupported extension raises an InputError and fails the build with a message naming the file and the two accepted extensions. Files found while scanning a directory keep being skipped, as a certificate directory may legitimately contain other files, but a warning is now printed unconditionally so it is visible in the build log. Also document the requirement in the Kconfig help text and in the esp_crt_bundle documentation. Closes https://github.com/espressif/esp-idf/issues/18933
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