v/maiana
1
0
Fork 0
mirror of https://github.com/peterantypas/maiana.git synced 2025-05-15 23:10:11 -07:00
Code Issues Projects Releases Wiki Activity

Create README.md

Browse Source
This commit is contained in:
Peter Antypas 2022-05-30 10:59:13 -07:00 committed by GitHub
parent d6917c8df6
commit 7017ac794e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 25 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
latest/Firmware/Bootloader/README.md Normal file
View File

@ -0,0 +1,25 @@
# MAIANA Bootloader
This is a custom bootloader that installs at flash address 0x08000000. In addition to providing firmware updates, this bootloader
also performs integrity checking and can even rescue a board if a bad application firmware binary is installed.
## Installation
The bootloader must be built and flashed via SWD. An alternative is to use the ST ROM bootloader to install the binary via UART.
This will require manipulation of the BOOT0 signal though, which is only exposed via a test pad for a bed-of-nails fixture.
## Firmware update
All application firmware must be isntalled via UART. See the example script in the Python subdirectory for the protocol.
## Integrity checking
This bootloader maintains a metadata page at flash address 0x08004000. It holds the size and checksum of the installed application image (if any).
The application image must be linked for installation at address 0x08004800. If no application is present or the checksum fails, the bootloader enters
DFU mode automatically.
## Rescue mode
If the TX switch is toggled twice during the first 2.5 seconds after power-up, the bootloader enters DFU mode again, regardless of application firmware state.