mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
a79acb413e
Add the possibility to have user bootloader components. This is performed from an application/project, by creating bootloader components. To do so, it is required to create a `bootloader_component` directory containing the custom modules to be compiled with the bootloader. Thanks to this, two solutions are available to override the bootloader now: - Using hooks within a user bootloader component - Using a user defined `main` bootloader component to totally override the old implementation Please check the two new examples in `examples/custom_bootloader` * Closes https://github.com/espressif/esp-idf/issues/7043
36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
# Custom bootloader examples
|
|
|
|
The following directory contains two examples presenting the different ways
|
|
we provide in order to override the second stage bootloader or complete it
|
|
with few hooks.
|
|
|
|
## Extending the bootloader
|
|
|
|
In both cases, a project can define custom bootloader components by creating
|
|
them within a directory called `bootloader_components`.
|
|
|
|
Naming one of them `main` would let the compiler entirely override the
|
|
2nd stage bootloader with the implementation provided.
|
|
|
|
The bootloader components containing the hooks can have any name, as long
|
|
as it is part of `bootloader_components`, it will be taken into account
|
|
in the build.
|
|
|
|
## Hooks vs overriding the bootloader
|
|
|
|
In brief, using hooks will let the application add code to the bootloader.
|
|
They cannot replace the code that is already executed within bootloader.
|
|
|
|
Two hooks are available at the moment, the first one is called before the
|
|
initialization, and the second one is performed after the bootloader
|
|
initialization, before choosing and loading any partition. The
|
|
signature for these hooks can be found in `bootloader_hooks.h` file in
|
|
`components/bootloader/subproject/main/`.
|
|
|
|
|
|
On the other hand, overriding the bootloader offers the possibility to
|
|
totally or partially re-write it, in order to include, remove or modify
|
|
parts of it. Thanks to this, it will be fully customizable.
|
|
This shall only be used if heavy changes are required and they cannot
|
|
be done with hooks or within an application.
|