Přehled projektu
STM32F1-DFU je kompaktní USB DFU bootloader pro STM32F103 (128 kB Flash, 20 kB SRAM). Umožňuje aktualizovat firmware aplikace přes USB standardními nástroji jako dfu-util nebo ST DfuSe, bez programátoru ST-LINK. Bootloader vychází z open-source projektu dfuse bootloader Davida Guillena Fandose (GPLv3) a přidává kontrolní součet firmware a aktualizaci z externí SPI SRAM.
Hlásí se jako zařízení STM32 DFU (0483:DF11, třída DFU 1.1, podpora WinUSB, povolený upload) a jako sériové číslo USB používá unikátní ID čipu.
Rozložení paměti
Definováno v Core/Inc/flash_config.h a stm32f103.ld:
| Oblast | Adresa | Velikost |
|---|---|---|
| Bootloader | 0x08000000 |
8 kB |
| Aplikace (payload) | 0x08002000 |
120 kB |
| RAM bootloaderu | 0x20000000 |
20 kB - 4 B |
Poslední 4 bajty RAM (spodek zásobníku, _stack) zůstávají volné, aby aplikace mohla předat příkaz přes reset. Řetězec rozhraní DFU @Internal Flash /0x08000000/8*001Ka,120*001Kg říká hostiteli, že prvních 8 stránek je jen pro čtení a následujících 120 stránek lze zapisovat.
Rozhodnutí při startu
Funkce main() v Core/Src/main.c rozhoduje, zda spustit aplikaci, nebo zůstat v režimu DFU. DFU se spustí, pokud platí cokoli z následujícího:
- aplikace o to požádala zápisem magické hodnoty
0xCC00FFEEdo vyhrazeného slova RAM (reboot_into_bootloader()vreboot.h) a resetem - reset způsobil pouze reset pin (
ENABLE_PINRST_DFU_BOOT) - poslední reset vyvolal watchdog (
ENABLE_WATCHDOG) - uložená velikost obrazu je větší než oblast aplikace
- volitelný GPIO pin je při startu v log. 1 (
ENABLE_GPIO_DFU_BOOT, výchozíPA0vboard.h)
Jinak bootloader ověří, že první slovo aplikace (ukazatel zásobníku) míří do RAM, zkontroluje kontrolní součet, vymaže příznaky restartu, nastaví VTOR a ukazatel zásobníku a skočí na obsluhu resetu na APP_ADDRESS + 4. Prázdná nebo neplatná aplikace tak vždy skončí v režimu DFU.
V režimu DFU se nastaví hodiny 72 MHz z 8 MHz HSE, linka USB D+ se stáhne do nuly pro vynucení nové enumerace a main() ve smyčce obsluhuje USB. Dvě LED na PC14/PC15 střídavě blikají.
Kontrolní součet firmware
S ENABLE_CHECKSUM nese obraz aplikace svou velikost a kontrolní součet v oblasti vektorové tabulky:
- offset
0x1C: 32bitový kontrolní součet - offset
0x20: velikost obrazu ve 32bitových slovech
Kontrolní součet je XOR všech 32bitových slov obrazu s počáteční hodnotou 0xB4DC0FEE; pro platný obraz je výsledek přes celý obraz nulový. Skript Releas-PRG/checksum.py doplní binárku na násobek 4 bajtů, vyplní obě pole a soubor přepíše. Spusťte jej na každé binárce aplikace před nahráním.
Volitelné ochrany
Volí se při sestavení:
ENABLE_WRITEPROT- ochrana stránek bootloaderu proti zápisu pomocí option bytesENABLE_PROTECTIONS- zapne ochranu proti čtení a vypne JTAG/SWDENABLE_WATCHDOG- před skokem do aplikace spustí nezávislý watchdog, takže zaseknutá aplikace se restartuje do režimu DFUENABLE_SAFEWRITE- bezpečnější zápis do flash
Aktivní volby jsou uvedeny v konfiguračním řetězci USB, například Bootloader config: FW-CRC.
Aktualizace z SPI SRAM
S ENABLE_SPI_SRAM_IMAGE (verze 02.00) umí bootloader nainstalovat také firmware uložený v externí SPI SRAM (typ 23LCV, piny PB12 CS, PB13 SCK, PB14 MISO, PB15 MOSI):
- při startu přečte 12bajtovou hlavičku na offsetu 0 v SRAM (magic
0x4D414253, offset obrazu, velikost obrazu) - je-li hlavička platná, vymaže potřebné 1kB stránky flash od
0x08002000 - hlavičku vymaže, aby se aktualizace po resetu neopakovala
- obraz kopíruje po 256bajtových blocích a programuje do flash
- vymaže příznaky restartu a resetuje do nového firmware
Běžící aplikace tak může stáhnout nový obraz do SRAM a nechat jej nainstalovat bootloaderem.
Použití s dfu-util
Ověřte, že je zařízení detekováno:
dfu-util -l
Typický výstup:
Found DFU: [0483:df11] ver=0200, devnum=29, cfg=1, intf=0, path="1-1.3",
alt=0, name="@Internal Flash /0x08000000/8*001Ka,120*001Kg",
serial="54FF6C068687545516541567"
Příprava a nahrání aplikace:
py checksum.py SW_v0101_DFU.bin
dfu-util -d 0x0483:0xDF11 -D SW_v0101_DFU.bin -s 0x08002000:leave
Přípona :leave způsobí opuštění režimu DFU a spuštění nové aplikace. Varování Invalid DFU suffix signature je u čistých .bin souborů neškodné.
Požadavky na aplikaci
Aplikace musí být slinkována od adresy 0x08002000 s délkou flash 120 kB a musí přesunout vektorovou tabulku:
// linker script
FLASH (rx) : ORIGIN = 0x08002000, LENGTH = 120K
// startup / system init
#define VECT_TAB_OFFSET 0x2000
Pro vstup do režimu DFU z aplikace zapište 0xCC00FFEE do posledního slova RAM (viz reboot.h) a proveďte systémový reset.
Sestavení a první nahrání
- Otevřete projekt v STM32CubeIDE a sestavte konfiguraci Release
- Jednou nahrajte bootloader přes ST-LINK na
0x08000000(hotové obrazyDFU_v0100_PRG.binaDFU_v0200_SRAM_PRG.binjsou vReleas-PRG/) - Dále aktualizujte aplikaci přes USB
Poznámky
- Bootloader je kód pod GPLv3, při dalším použití zachovejte původní hlavičky s autorskými právy
- Pro produkci doplňte ověření podpisu a ochranu proti návratu na starší verzi; XOR součet odhalí jen náhodné poškození
- Další nástroje a dokumenty jsou v
documents/(dfu-utilpro Windows, DfuSe, aplikační poznámka ST k DFU)