You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+34-28Lines changed: 34 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,44 +4,49 @@
4
4
5
5
## Overview
6
6
7
-
**OpenBootloader** is an In-Application programming (IAP) provided in the STM32Cube MCU Packages and GitHub. It is fully compatible with STM32 System Bootloader so that they have the same supported interfaces and supported commands and they are working exactly with the same Tools such as STM32CubeProgrammer.
8
-
**OpenBootloader** is provided as an example that can be used by any customer who wants to build and customize his own Bootloader starting from a good basis. It allows to download the application program to the internal user memory (Flash, SRAM, OTP) without the need for a debugger, by using one of the available communication interfaces (USART, I2C, SPI, USB-DFU or FDCAN).
9
-
**OpenBootloader** supplies services to the Host (can be STM32CubeProgrammer or another user made host) in order to download firmware to the device via an interface link and to install this firmware in the needed user memory.
10
-
**OpenBootloader** relies on STM32Cube HAL/LL drivers for hardware system initialization such as the clocks and the communication interfaces configuration.
11
-
**OpenBootloader** code can be loaded in user Flash memory or in SRAM user memory with taking necessary precautions to avoid erasing or corrupting it by error (for example use write protection mechanism).
12
-
**OpenBootloader** is executed by Cortex-M processor on the non-secure domain, from the Flash or SRAM initial base address, and uses the following resources:
13
-
* Non secure internal flash memory/SRAM1
14
-
* Interrupts
15
-
* Clocks and power
16
-
* Communication interfaces
17
-
* GPIOs
18
-
* Systick
19
-
* IWDG
7
+
**Open Bootloader** is an In-Application programming (IAP) provided in the STM32Cube MCU Packages and GitHub. It is fully compatible with STM32 System Bootloader so that it have the same supported interfaces and commands. It's also using the same Tools such as STM32CubeProgrammer.
8
+
9
+
**Open Bootloader** is provided as an example that can be used by any customer who wants to build and customize his own Bootloader starting from a good basis. It allows all possible bootloader operations (Read, write, erase, jump...) into internal (Flash, SRAM, OTP...) or external memory using one of the available communication interfaces (USART, I2C, SPI, USB-DFU, FDCAN...).
10
+
11
+
**Open Bootloader** supplies services to the Host (can be STM32CubeProgrammer or another user made host) in order to perform all possible Bootloader operations.
12
+
13
+
**Open Bootloader** relies on STM32Cube HAL/LL drivers for hardware system initialization such as the clocks and the communication interfaces configuration.
14
+
15
+
**Open Bootloader** code can be loaded at any address of user Flash memory with taking necessary precautions to avoid erasing or corrupting it by error (for example use write protection mechanism).
16
+
17
+
**Open Bootloader** is executed by Cortex-M processor on the non-secure domain and uses the following resources:
18
+
- Non secure internal flash memory/SRAM1
19
+
- Interrupts
20
+
- Clocks and power
21
+
- Communication interfaces
22
+
- GPIOs
23
+
- Systick
24
+
- IWDG
25
+
26
+
**Open Bootloader** can be customized by changing its location (ie. load it in last user Flash sector or other sectors), its supported protocols, its supported interfaces, and its supported operations.
27
+
28
+
**Open Bootloader** applications can be found in STM32Cube MCU Packages under the directory `/Projects/<STM32xxBoardyy>/Applications/OpenBootloader/`, where `<STM32xxBoardyy>` is the reference of the used board **e.g.**, `B-U585I-IOT02A`.
20
29
21
30
## Documentation
22
31
23
-
Since OpenBootloader supports exactly same protocol interfaces as STM32 System Bootloader, following list of documents provide details of how to use each protocol:
32
+
Since Open Bootloader supports exactly same protocol interfaces as STM32 System Bootloader, following list of documents provide details of how to use each protocol:
24
33
-[AN3155](https://www.st.com/resource/en/application_note/CD00264342.pdf): USART protocol used in the STM32 Bootloader
25
34
-[AN5405](https://www.st.com/resource/en/application_note/dm00660346.pdf): FDCAN protocol used in the STM32 Bootloader
26
35
-[AN4221](https://www.st.com/resource/en/application_note/DM00072315.pdf): I2C protocol used in the STM32 Bootloader
27
36
-[AN3156](https://www.st.com/resource/en/application_note/cd00264379.pdf): USB DFU protocol used in the STM32 Bootloader
28
37
-[AN4286](https://www.st.com/resource/en/application_note/DM00081379.pdf): SPI protocol used in the STM32 Bootloader
29
38
30
-
31
-
**OpenBootloader** can be customized by changing its location (ie. load it in last user Flash sector or other sectors), its supported protocols, its supported interfaces, and its supported operations.
32
-
**OpenBootloader** applications can be found in STM32Cube MCU Packages under the directory `/Projects/<STM32xxBoardyy>/Applications/OpenBootloader/`, where `<STM32xxBoardyy>` is the reference of the used board **e.g.**, `B-U585I-IOT02A`.
33
-
34
-
A useful introductory video series, in six parts, explaining how to use OpenBootloader step by step, can be found here:
-[Part 6](https://www.youtube.com/watch?v=IZ6BpDIm6O0): Loading an application over I2C
41
46
42
47
## List of Supported Commands
43
48
44
-
All STM32 System Bootloader commands are supported by OpenBootloader, which includes:
49
+
All STM32 System Bootloader commands can be supported by Open Bootloader, which includes:
45
50
- Get Version
46
51
- Get Device ID
47
52
- Get Available Command List
@@ -52,14 +57,15 @@ All STM32 System Bootloader commands are supported by OpenBootloader, which incl
52
57
- Jump to Application
53
58
- Flash Erase
54
59
- Special Command
60
+
- Extended Special Command
55
61
56
62
## How to use
57
63
58
64
**Open Bootloader** examples showing how to use this library are available in dedicated repositories, the list of which can be found [here](https://github.com/STMicroelectronics/STM32Cube_MCU_Overall_Offer/blob/master/README.md#stm32cube-middleware-libraries).
59
65
60
66
## Description
61
67
62
-
This **stm32-mw-openbl** MCU component repository is one element **common to all** STM32Cube MCU packages, providing the **OpenBootloader MCU Middleware** part.
68
+
This **stm32-mw-openbl** MCU component repository is one element **common to all** STM32Cube MCU packages, providing the **Open Bootloader MCU Middleware** part.
63
69
64
70
## Release note
65
71
@@ -69,4 +75,4 @@ Details about the content of this release are available in the release note [her
69
75
70
76
Caution : The issues are strictly limited to submit problems or suggestions related to the software delivered in this repository.
71
77
72
-
**For any other question**related to the product, the hardware performance or characteristics, the tools, the environment, you can submit it to the **ST Community**on the STM32 MCUs related[page](https://community.st.com/s/topic/0TO0X000000BSqSWAW/stm32-mcus).
78
+
**For any other question** related to the product, the hardware performance or characteristics, the tools, the environment, you can submit it to the **ST Community** on the STM32 MCUs related [page](https://community.st.com/s/topic/0TO0X000000BSqSWAW/stm32-mcus).
0 commit comments