Skip to content

Commit

Permalink
ADD: FIRMWARE_ORIGIN documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
r2axz committed Feb 9, 2022
1 parent 9e9f1ff commit d7f332c
Showing 1 changed file with 21 additions and 1 deletion.
22 changes: 21 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@ board works with your computer, don't bother fixing it.
* Signed _INF_ driver for _Windows XP, 7, and 8_;
* Built-in command shell for device parameters configuration;
* No external dependencies other than _CMSIS_;
* DFU Bootloaders Compartible (see the _FIRMWARE_ORIGIN_ option);

(1) _UART1_ does not support _CTS_ because it is occupied by USB (_PA11_)
and cannot be remapped. _RTS_ can still be used.
Expand Down Expand Up @@ -330,10 +331,12 @@ or similar programmer.
st-flash --format ihex write bluepill-serial-monster.hex
```

You can also flash _STM32F103C8T6_ via a built-in serial bootloader. Visit
It is also possible to flash _STM32F103C8T6_ via a built-in serial bootloader. Visit
[https://www.st.com/en/development-tools/flasher-stm32.html](https://www.st.com/en/development-tools/flasher-stm32.html)
for instructions and software.

You can also use _bluepill-serial-monster-stm32duino-0x8002000.bin_ or _bluepill-serial-monster-stm32duino-0x8005000.bin_ with [STM32duino-bootloader](https://github.com/rogerclarkmelbourne/STM32duino-bootloader) and [dfu-util](http://dfu-util.sourceforge.net).

## Windows Driver (WinXP, 7, 8)

_Windows_ versions prior to _Windows 10_ require an _INF_ file that maps
Expand Down Expand Up @@ -427,3 +430,20 @@ To remove object, dependency, and firmware files, run
```bash
make distclean
```

### Building for DFU Bootloaders

_DFU_ bootloaders generally require the firmware origin to be relocated
to a higher flash address to allow room for the bootloader itself.
The bootloader documentation should specify the firmware upload address.
By default, _bluepill-serial-monster_ firmware starts at flash origin (0x8000000).
To move the firmware to a custom address, use the **FIRMWARE_ORIGIN** Makefile variable:

```bash
make clean && make FIRMWARE_ORIGIN=<0xXXXXXXXX>
```

where 0xXXXXXXXX is the required firmware start address.

The firmware release package already includes two prebuilt binaries for use with
[STM32duino-bootloader](https://github.com/rogerclarkmelbourne/STM32duino-bootloader).

0 comments on commit d7f332c

Please # to comment.