mirror of
https://github.com/espressif/esp-idf.git
synced 2025-12-28 21:55:59 +00:00
83 lines
3.0 KiB
ReStructuredText
83 lines
3.0 KiB
ReStructuredText
引导加载程序镜像的格式
|
||
=======================
|
||
|
||
:link_to_translation:`en:[English]`
|
||
|
||
引导加载程序镜像与应用程序镜像具有相同的结构，参见 :ref:`app-image-structures`。二者唯一的区别在于 :ref:`描述引导加载程序的结构体 <image-format-bootloader-description>` 不同。
|
||
|
||
要查看关于引导加载程序镜像的更多内容，请运行以下命令：
|
||
|
||
.. code-block::
|
||
|
||
esptool --chip {IDF_TARGET_PATH_NAME} image-info ./build/bootloader/bootloader.bin
|
||
|
||
输出结果如下形式所示：
|
||
|
||
.. code-block::
|
||
|
||
esptool v5.0.2
|
||
Image size: 26352 bytes
|
||
|
||
ESP32 Image Header
|
||
==================
|
||
Image version: 1
|
||
Entry point: 0x40080644
|
||
Segments: 3
|
||
Flash size: 2MB
|
||
Flash freq: 40m
|
||
Flash mode: DIO
|
||
|
||
ESP32 Extended Image Header
|
||
===========================
|
||
WP pin: 0xee (disabled)
|
||
Flash pins drive settings: clk_drv: 0x0, q_drv: 0x0, d_drv: 0x0, cs0_drv: 0x0, hd_drv: 0x0, wp_drv: 0x0
|
||
Chip ID: 0 (ESP32)
|
||
Minimal chip revision: v0.0, (legacy min_rev = 0)
|
||
Maximal chip revision: v3.99
|
||
|
||
Segments Information
|
||
====================
|
||
Segment Length Load addr File offs Memory types
|
||
------- ------- ---------- ---------- ------------
|
||
0 0x018e8 0x3fff0030 0x00000018 BYTE_ACCESSIBLE, DRAM, DIRAM_DRAM
|
||
1 0x03e58 0x40078000 0x00001908 CACHE_APP
|
||
2 0x00f5c 0x40080400 0x00005768 IRAM
|
||
|
||
ESP32 Image Footer
|
||
==================
|
||
Checksum: 0x6b (valid)
|
||
Validation hash: 09fdc81d436a927b5018e19073a787cd37ffce655f505ad92675edd784419034 (valid)
|
||
|
||
Bootloader Information
|
||
======================
|
||
Bootloader version: 1
|
||
ESP-IDF: v6.0-dev-1620-g15d7e41a848-dirt
|
||
Compile time: Aug 8 2025 16:22:1
|
||
|
||
|
||
.. _image-format-bootloader-description:
|
||
|
||
引导加载程序描述
|
||
----------------------
|
||
|
||
引导加载程序二进制文件的 ``DRAM0`` 段起始位置为 :cpp:type:`esp_bootloader_desc_t` 结构体，其中包含描述引导加载程序的特定字段。此结构体位置具有固定偏移量，大小为 sizeof(:cpp:type:`esp_image_header_t`) + sizeof(:cpp:type:`esp_image_segment_header_t`)。
|
||
|
||
* ``magic_byte``：esp_bootloader_desc 结构体的魔术字节
|
||
* ``reserved``：保留供 IDF 未来使用
|
||
* ``secure_version``：引导加载程序防回滚功能使用的安全版本，请参阅:ref:`CONFIG_BOOTLOADER_ANTI_ROLLBACK_ENABLE`。
|
||
* ``version``：引导加载程序版本，参见 :ref:`CONFIG_BOOTLOADER_PROJECT_VER`
|
||
* ``idf_ver``：IDF 版本。[#f1]_
|
||
* ``date`` 和 ``time``：编译日期和时间
|
||
* ``reserved2``：保留供 IDF 未来使用
|
||
|
||
.. [#f1] 最大长度为 32 个字符，包括空终止符。
|
||
|
||
如需从正在运行的引导加载程序中获取 :cpp:type:`esp_bootloader_desc_t` 结构体，请使用 :cpp:func:`esp_bootloader_get_description`。
|
||
|
||
如需从正在运行的应用程序中获取 :cpp:type:`esp_bootloader_desc_t` 结构体，请使用 :cpp:func:`esp_ota_get_bootloader_description`。
|
||
|
||
API参考
|
||
-------------
|
||
|
||
.. include-build-file:: inc/esp_bootloader_desc.inc
|