Ing. Radomír Turča, Ph.D.

CODELEC · ČLÁNEK

STM32F1 USB DFU bootloader

GitHub repozitář →

STM32DFUBootloaderUSB

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 0xCC00FFEE do vyhrazeného slova RAM (reboot_into_bootloader() v reboot.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í PA0 v board.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 bytes
  • ENABLE_PROTECTIONS - zapne ochranu proti čtení a vypne JTAG/SWD
  • ENABLE_WATCHDOG - před skokem do aplikace spustí nezávislý watchdog, takže zaseknutá aplikace se restartuje do režimu DFU
  • ENABLE_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):

  1. při startu přečte 12bajtovou hlavičku na offsetu 0 v SRAM (magic 0x4D414253, offset obrazu, velikost obrazu)
  2. je-li hlavička platná, vymaže potřebné 1kB stránky flash od 0x08002000
  3. hlavičku vymaže, aby se aktualizace po resetu neopakovala
  4. obraz kopíruje po 256bajtových blocích a programuje do flash
  5. 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í

  1. Otevřete projekt v STM32CubeIDE a sestavte konfiguraci Release
  2. Jednou nahrajte bootloader přes ST-LINK na 0x08000000 (hotové obrazy DFU_v0100_PRG.bin a DFU_v0200_SRAM_PRG.bin jsou v Releas-PRG/)
  3. 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-util pro Windows, DfuSe, aplikační poznámka ST k DFU)