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
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ Customizable Bootloader for STM32 microcontrollers. This project includes demons
4
4
5
5
Each example uses the same bootloader library located in the `lib/stm32-bootloader` folder. The examples are located in the `projects` folder and they come with a separate, dedicated README file with description related to that specific implementation.
6
6
7
-
Update: the `STM32L496-Discovery` example supports compiling and building the project with the GNU Arm Embedded Toolchain (ARM GCC) out-of-the-box, in addition to IAR EWARM. Check out the project README for further information.
7
+
**Update:** the `STM32L496-Discovery` example supports compiling and building the project with the GNU Arm Embedded Toolchain (ARM GCC) out-of-the-box, in addition to IAR EWARM. Check out the project README for further information.
8
8
9
9
Please refer to <https://akospasztor.github.io/stm32-bootloader> for complete documentation of the bootloader library source code.
Copy file name to clipboardExpand all lines: projects/STM32L496-Discovery/README.md
+19-3Lines changed: 19 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -57,7 +57,9 @@ After power-up, the bootloader starts. The bootloader checks for user-interactio
57
57
*Figure 3: Bootloader sequence*
58
58
59
59
## Compile & Build
60
-
The project can be built out-of-the-box with either IAR EWARM or GNU Arm Embedded Toolchain. The `EWARM` subfolder contains the required files to compile and build the demo with the IAR EWARM toolchain. The `GCC` subfolder contains the compiler-specific files as well as a makefile to easily compile and build the project with the GNU Arm Embedded Toolchain.
60
+
The project can be built out-of-the-box with either IAR EWARM or GNU Arm Embedded Toolchain. The `EWARM` subfolder contains the required files to compile and build the demo with the IAR EWARM toolchain.
61
+
62
+
The `GCC` subfolder contains the compiler-specific files, a `Makefile` and a `SConscript` file to easily compile and build the project with the GNU Arm Embedded Toolchain.
61
63
62
64
### IAR EWARM
63
65
1. Open the `Project.eww` workspace file with IAR.
@@ -68,14 +70,28 @@ Note: The IAR EWARM project is already configured with the required parameters a
68
70
### GNU Arm Embedded Toolchain
69
71
Prerequisites:
70
72
- GNU Arm Embedded Toolchain, recommended version: 8-2019-q3-update
71
-
- GNU Make (for Windows, see: [Make for Windows](http://gnuwin32.sourceforge.net/packages/make.htm))
73
+
- At least one of the followings:
74
+
- GNU Make (for Windows, see: [Make for Windows](http://gnuwin32.sourceforge.net/packages/make.htm))
75
+
- Python with pip
76
+
77
+
#### Build with Make
78
+
Steps to compile and build with GNU Make:
72
79
73
-
Steps to compile and build:
74
80
1. If the GNU Arm Embedded Toolchain has not been added to PATH: Edit the `CUSTOMPATH` variable in the `Makefile` so that it points to the `bin` folder of the installed GNU Arm Embedded Toolchain.
75
81
2. Open up your favorite terminal and navigate to the `GCC` subfolder where the makefile is located.
76
82
3. Type `make` and hit enter.
77
83
4. The `build` subfolder should contain the binary, ELF and HEX output files, named `stm32-bootloader.bin`, `stm32-bootloader.elf` and `stm32-bootloader.hex` respectively.
78
84
85
+
#### Build with SCons
86
+
This project currently supports two build configurations: debug (default) and release. Follow these steps to compile and build the project with SCons. Please note that the recommended usage is within a virtualenv.
87
+
88
+
1. Install the requirements: `pip install -r requirements.txt`
89
+
2. If the `bin` folder of the GNU Arm Embedded Toolchain does not exist in the PATH, it can be specified in the `SConstruct` file.
90
+
3. To build the project with the default debug configuration, execute: `scons -j8`
91
+
4. To build all build configurations at once, execute: `scons --all -j8`
92
+
5. To list all supported arguments, execute: `scons --help`
93
+
6. The `build` subfolder should contain the generated outputs, organized in subfolders with the names of the build configurations.
0 commit comments