/* Copyright 2021-2023 QMK * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #include "bootloader.h" #include "util.h" #include #include #include "wait.h" #ifndef STM32_BOOTLOADER_RAM_SYMBOL # define STM32_BOOTLOADER_RAM_SYMBOL __ram0_end__ #endif extern uint32_t STM32_BOOTLOADER_RAM_SYMBOL; #ifndef STM32_BOOTLOADER_DUAL_BANK # define STM32_BOOTLOADER_DUAL_BANK FALSE #endif #if STM32_BOOTLOADER_DUAL_BANK # include "gpio.h" # ifndef STM32_BOOTLOADER_DUAL_BANK_GPIO # error "No STM32_BOOTLOADER_DUAL_BANK_GPIO defined, don't know which pin to toggle" # endif # ifndef STM32_BOOTLOADER_DUAL_BANK_POLARITY # define STM32_BOOTLOADER_DUAL_BANK_POLARITY 0 # endif # ifndef STM32_BOOTLOADER_DUAL_BANK_DELAY # define STM32_BOOTLOADER_DUAL_BANK_DELAY 100 # endif __attribute__((weak)) void bootloader_jump(void) { // For STM32 MCUs with dual-bank flash, and we're incapable of jumping to the bootloader. The first valid flash // bank is executed unconditionally after a reset, so it doesn't enter DFU unless BOOT0 is high. Instead, we do // it with hardware...in this case, we pull a GPIO high/low depending on the configuration, connects 3.3V to // BOOT0's RC charging circuit, lets it charge the capacitor, and issue a system reset. See the QMK discord // #hardware channel pins for an example circuit. palSetPadMode(PAL_PORT(STM32_BOOTLOADER_DUAL_BANK_GPIO), PAL_PAD(STM32_BOOTLOADER_DUAL_BANK_GPIO), PAL_MODE_OUTPUT_PUSHPULL); # if STM32_BOOTLOADER_DUAL_BANK_POLARITY palSetPad(PAL_PORT(STM32_BOOTLOADER_DUAL_BANK_GPIO), PAL_PAD(STM32_BOOTLOADER_DUAL_BANK_GPIO)); # else palClearPad(PAL_PORT(STM32_BOOTLOADER_DUAL_BANK_GPIO), PAL_PAD(STM32_BOOTLOADER_DUAL_BANK_GPIO)); # endif // Wait for a while for the capacitor to charge wait_ms(STM32_BOOTLOADER_DUAL_BANK_DELAY); // Issue a system reset to get the ROM bootloader to execute, with BOOT0 high NVIC_SystemReset(); } __attribute__((weak)) void mcu_reset(void) { NVIC_SystemReset(); } // not needed at all, but if anybody attempts to invoke it.... void enter_bootloader_mode_if_requested(void) {} #else /* This code should be checked whether it runs correctly on platforms */ # define SYMVAL(sym) (uint32_t)(((uint8_t *)&(sym)) - ((uint8_t *)0)) # define BOOTLOADER_MAGIC 0xDEADBEEF # define MAGIC_ADDR (unsigned long *)(SYMVAL(STM32_BOOTLOADER_RAM_SYMBOL) - 4) __attribute__((weak)) void bootloader_marker_enable(void) { uint32_t *marker = (uint32_t *)MAGIC_ADDR; *marker = BOOTLOADER_MAGIC; // set magic flag => reset handler will jump into boot loader } __attribute__((weak)) bool bootloader_marker_active(void) { const uint32_t *marker = (const uint32_t *)MAGIC_ADDR; return (*marker == BOOTLOADER_MAGIC) ? true : false; } __attribute__((weak)) void bootloader_marker_disable(void) { uint32_t *marker = (uint32_t *)MAGIC_ADDR; *marker = 0; } __attribute__((weak)) void bootloader_jump(void) { bootloader_marker_enable(); NVIC_SystemReset(); } __attribute__((weak)) void mcu_reset(void) { NVIC_SystemReset(); } void enter_bootloader_mode_if_requested(void) { if (bootloader_marker_active()) { bootloader_marker_disable(); struct system_memory_vector_t { uint32_t stack_top; void (*entrypoint)(void); }; const struct system_memory_vector_t *bootloader = (const struct system_memory_vector_t *)(STM32_BOOTLOADER_ADDRESS); __disable_irq(); # if defined(QMK_MCU_ARCH_CORTEX_M7) SCB_DisableDCache(); SCB_DisableICache(); # endif # if defined(__MPU_PRESENT) && (__MPU_PRESENT == 1U) ARM_MPU_Disable(); # endif SysTick->CTRL = 0; SysTick->VAL = 0; SysTick->LOAD = 0; // Clear interrupt enable and interrupt pending registers for (int i = 0; i < ARRAY_SIZE(NVIC->ICER); i++) { NVIC->ICER[i] = 0xFFFFFFFF; NVIC->ICPR[i] = 0xFFFFFFFF; } __set_CONTROL(0); __set_MSP(bootloader->stack_top); __enable_irq(); // Jump to bootloader bootloader->entrypoint(); while (true) { } } } #endif